Skip to content

RELEASE_NOTES.md

Latest commit

 

History

History
774 lines (585 loc) · 37.7 KB

RELEASE_NOTES.md

File metadata and controls

774 lines (585 loc) · 37.7 KB

Release Notes

v0.13.0 (2026-03-18)

🎉 New Features

Dot-Notation Namespace System (MDT-138)

  • Filename-Based Grouping: Organize related documents using dot notation without creating folders
  • Example: architecture.md + architecture.api.md + architecture.testing.md shows as grouped tabs
  • Mixed Approach: Combine folder-based and dot-notation systems in the same project
  • Nested Dots Preserved: a.b.c.md becomes [a >] [b.c] (first segment = namespace)

🐛 Bug Fixes

Document Configuration (MDT-109, MDT-140)

  • Path Parsing: Fixed project.document.paths configuration not being read correctly
  • maxDepth Respected: Document tree depth now honors project.document.maxDepth setting
  • No More Silent Failures: Configuration values are now properly applied instead of being ignored

Real-Time Updates (MDT-142)

  • Subdocument SSE Events: Changes to docs/CRs/MDT-XXX/*.md files now trigger targeted UI updates
  • Worktree Support: Subdocument changes in git worktrees emit events with proper source attribution
  • No Duplicate Events: Fixed duplicate SSE events when files exist in both main and worktree

🚀 Improvements

Git Worktree Infrastructure (MDT-096)

  • Multi-Path Watching: FileWatcherService can now monitor multiple directory paths simultaneously
  • Worktree-Aware Events: SSE events correctly identify which path (main or worktree) triggered changes
  • Cleaner Architecture: Decomposed file watching into focused modules for better maintainability

TOML Configuration (MDT-098)

  • Full Read/Write Support: New smol-toml library supports both parsing and stringifying
  • Preserve Comments: Configuration edits maintain file structure and comments
  • Single Library: Consolidated from multiple TOML implementations to one

Code Quality

  • Mermaid Module Refactored (MDT-139): Extracted magic numbers to constants, reduced complexity
  • Legacy Code Removed (MDT-141): Deleted unused FileSystemService and legacy ticket routes
  • Badge Styling Unified (MDT-135): Consistent badge appearance across all views
  • Domain Contracts Package (MDT-101): Zod schema validation package for shared type safety (in progress)

v0.12.2 (2026-03-10)

🎉 New Features

Quick Search (MDT-136)

  • Cmd+K Shortcut: Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) to open quick search
  • Instant Ticket Access: Search by title or ticket key (e.g., "MDT-123")
  • Keyboard Navigation: Use arrow keys to navigate results, Enter to select

🚀 Improvements

Project Selector (MDT-129)

  • Hover Cards: Hover over inactive project chips to see full project details
  • Active Card Click: Click the active project card to open the full project browser

Badge Components (MDT-135)

  • Clickable Links Restored: Relationship badges (Related, Depends On, Blocks) now properly link to referenced tickets

v0.12.1 (2026-03-09)

🎉 New Features

Enhanced List View (MDT-134)

  • shadcn/ui Table: Modern table component with sorting and responsive design
  • Better Visual Hierarchy: Cleaner column layout for ticket attributes

Sub-Document Tabs (MDT-093)

  • Sticky Tabs: Open related documents in tabs within ticket detail view
  • Performance: Cached subdocument content prevents redundant API calls
  • Mobile Fix: Fixed modal collapse and content overflow on mobile

🚀 Improvements

Project Selector (MDT-129)

  • Consistent data-testid: Fixed selector chip for reliable E2E testing

Badge Components (MDT-135)

  • Unified Styling: Consolidated ticket badge styles across all views
  • data-testid Forwarding: All badge components now pass test IDs correctly

Test Infrastructure

  • Fixed flaky E2E tests to match actual implementation behavior
  • Fixed responsive list view test assertions

v0.12.0 (2026-03-09)

🎉 New Features

Mobile-First Kanban Board (MDT-131, MDT-132)

  • Mobile Column Switcher: On mobile viewports, see one full-width column at a time with dropdown navigation
  • Responsive Navigation: Board/List toggle merged with hover overlay, optimized for touch
  • System Theme Toggle: Floating theme button on mobile for quick dark/light switching
  • Desktop Unchanged: Full multi-column layout preserved on larger screens

Project Selector Redesign (MDT-129)

  • Rail Navigation: Active project shown as prominent card, others as compact chips
  • Quick Access Panel: Launcher button opens full project list for switching
  • State Persistence: Last selected project remembered across sessions
  • Favorites Support: Star projects to prioritize them in the rail

Sub-Document Support (MDT-093)

  • Sticky Tabs: Open related documents in tabs within ticket detail view
  • Path-Based Routing: Direct URLs to specific sub-documents
  • Worktree Integration: Sub-documents work correctly in git worktrees

🐛 Bug Fixes

Project Discovery (MDT-123)

  • Fixed duplicate project codes appearing in registry when projects share the same code
  • Improved validation to prevent configuration conflicts

🚀 Improvements

E2E Testing Infrastructure (MDT-092, MDT-128, MDT-130)

  • Isolated test environments prevent interference with user projects
  • Comprehensive smoke tests for critical UI paths
  • Markdown rendering coverage for nested lists, Mermaid diagrams, tables, and code blocks

API Optimization (MDT-094)

  • Reduced CR listing payload size by removing content from list responses
  • Faster board loading for projects with many tickets

v0.11.0 (2026-02-22)

🎉 New Features

Git Worktree Support (MDT-095)

  • Isolated Development: Work on tickets in separate Git worktrees without conflicts
  • Auto-Detection: System detects when a ticket exists in a worktree and routes operations there
  • UI Indication: "🌿 Worktree" badge shows when viewing a ticket in a worktree
  • MCP Path Awareness: Tools return correct worktree paths for ticket files
  • Configurable: Enable/disable at global or project level via .mdt-config.toml

Universal AI Assistant Support

  • Cursor, Copilot, Gemini CLI, and more: SDD workflow commands now work with popular AI assistants
  • Easy Installation: ./prompts/install-agents-skill.sh sets up everything
  • Global or Per-Project: Install once globally or configure per project
  • Full Command Access: All /mdt:* commands available in your preferred AI tool

README Refresh

  • SDD-First Positioning: Spec-Driven Development framework is now the primary value proposition
  • Streamlined Quick Start: Install SDD commands is now Step 1
  • Visual Workflow Diagrams: See how Spec→Code and RED→GREEN flows work
  • Better Resource Links: Direct links to QUICKREF, WORKFLOWS, CONCEPTS docs

🚀 SDD Workflow Enhancements

Architecture & Planning

  • Architecture Invariants: Single owner per behavior, canonical flows, test/runtime separation
  • Milestone Planning: BDD-driven vertical slices with checkpoint commands
  • Coverage Enforcement: Numeric gap table blocks if architecture files are orphaned
  • Requirements Ambiguity Controls: Semantic conflict resolution before output

🐛 Bug Fixes

Project Discovery (MDT-127)

  • Refactored validation logic to eliminate duplication
  • Centralized Project construction in dedicated Factory
  • Clearer separation of concerns between Scanner and Discovery Service

v0.10.0 (2026-02-15)

🎉 New Features

Single-Project Mode for MCP Server (MDT-121)

  • Auto-detection: Start MCP server from any project directory - no need to specify project parameter
  • Numeric Shorthand: Use 5 instead of MDT-005 for quicker ticket references
  • Configurable Depth: Adjust how far up the directory tree to search for project config
  • Backward Compatible: All existing workflows continue to work unchanged

Research Ticket Type (MDT-120)

  • New CR Type: "Research" for hypothesis-driven technical validation work
  • Dedicated Template: Research Objective, Research Questions table, Validation Approach sections
  • Workflow Routing: /mdt:suggest now correctly routes research tickets through appropriate workflows
  • Use Cases: POC investigations, feasibility studies, technical experiments

🚀 Improvements

Event History Developer Tool (MDT-061)

  • Debug Menu: Event History toggle added to hamburger menu
  • Real-time Tracking: Monitor SSE events and listener management
  • Development Aid: Helps diagnose event flow issues during development

🐛 Bug Fixes

macOS Case-Insensitivity (MDT-126)

  • Fixed Project Discovery: Projects now correctly detected regardless of directory case variations
  • Example: ~/home/MArkdown-TIcket now matches config project.id = "markdown-ticket"
  • No User Impact: Fix is transparent - projects work regardless of how you navigate to them

Test Suite Fixes (MDT-125)

  • Server Tests: Fixed 53 failures across API test suites (TypeScript compilation + runtime)
  • MCP Tests: Resolved ~15 E2E test timeouts for projects created after server startup
  • Shared Tests: Fixed git worktree matcher failures expecting undefined values
  • CI/CD Restored: All test suites now pass reliably for continuous integration

v0.9.0 (2026-01-17)

🎉 New Features

Enhanced UI Styling (MDT-118)

  • Modern Gradients: Column headers and badges now display with beautiful gradient backgrounds
  • Smooth Animations: Drag-and-drop interactions feature scale, rotate, and shadow transitions
  • Skeleton Loading: Loading states show animated skeleton cards instead of basic spinners
  • Better Scrollbars: Project selector now handles overflow with hover-visible horizontal scrollbars
  • Improved Visual Hierarchy: Header sizes and spacing optimized for better content organization

Code Complexity Metrics (MDT-112)

  • Metrics Script: Run scripts/metrics/run.sh to analyze code complexity for changed files
  • LLM-Friendly Output: JSON format for automated analysis by AI assistants
  • Industry Standards: Maintainability Index, Cyclomatic Complexity, and Cognitive Complexity metrics
  • Threshold Filtering: Shows only problematic files (yellow/red zones) by default
  • Customizable Analysis: Analyze specific files, directories, or all changed files

🚀 Improvements

Comprehensive Testing Coverage (MDT-091, MDT-106)

  • MCP Server E2E Tests: 221 tests covering all 10 MCP tools with positive and negative scenarios
  • API Endpoint E2E Tests: 223 tests across 6 test files for server API coverage
  • Test Isolation: All tests run in isolated environments using temporary directories
  • CI/CD Ready: Tests can run automatically in continuous integration pipelines

Test Infrastructure Refactoring (MDT-113)

  • Reduced Complexity: Test utilities refactored from RED to YELLOW/GREEN zones
  • Better Maintainability: Extracted single-responsibility classes for easier maintenance
  • Behavior Preservation: All existing tests pass without modification
  • Improved Code Quality: Higher maintainability index across test framework

Docker Production Enhancements (MDT-055)

  • Three-Container Architecture: Frontend, backend, and MCP services in separate containers
  • Convenience Wrapper: bin/dc script simplifies Docker Compose commands
  • Flexible Volume Mounting: Support for multiple project mounting strategies
  • Docker-Only Configuration: Container-specific config system isolated from host

🐛 Bug Fixes

Auto-Discovered Projects (MDT-115)

  • Configure Documents Fixed: Auto-discovered projects can now configure document paths
  • No More 500 Errors: /api/documents/configure works for all project types
  • Unified Project Access: Projects found from both registry and auto-discovery

Environment Variable Fixes (MDT-091)

  • Removed Hardcoded Values: E2E test scripts now respect environment variables
  • Docker Compatibility: Fixed MCP_HTTP_ENABLED hardcoded value that broke Docker deployments

🔧 Technical Improvements

Developer Experience

  • TypeScript Path Mapping: Clean @shared/* imports work in both host and Docker
  • Code Quality Tools: Automated metrics collection identifies complex code
  • Test Infrastructure: Isolated test environments prevent interference with user projects
  • ESLint Cleanup: Fixed 278 ESLint errors across server codebase

Docker Deployment

  • Tailwind CSS Fix: Frontend styling displays correctly in Docker containers
  • Port Mapping: Avoids conflicts (5174→5173 for frontend, 3012→3002 for MCP)
  • Health Checks: All services include health check endpoints
  • Network Communication: Services communicate via Docker network names

Code Quality

  • Dead Code Removal: Cleaned up unused files, exports, and dependencies
  • Simplified Validation: Streamlined PathResolver validation logic
  • Type Checking: Enabled for test files in MCP server
  • Configuration Refactoring: Simplified TypeScript config structure

📚 Documentation

Internal Improvements

  • Dead Code Detection: Added tools comparison for code quality analysis
  • Git Hooks: Pre-commit hooks to block Co-Authored-By and enforce path alias usage
  • Documentation Restructuring: Three-tier system for better organization
  • MCP Integration: Enhanced documentation for HTTP transport setup

Development Guides

  • E2E Testing: Comprehensive guides for API and MCP server testing
  • Docker Deployment: Updated guides with new wrapper script usage
  • Code Metrics: Documentation for complexity analysis tool

v0.8.0 (2025-12-29)

🎉 New Features

Interactive API Documentation (MDT-085)

  • Redoc UI: Browse and test all 43 API endpoints at /api-docs
  • OpenAPI 3.0 Spec: Machine-readable API specification with swagger-jsdoc
  • Developer Friendly: Try endpoints directly from your browser with live validation
  • Always Up-to-Date: Auto-generated from JSDoc comments in route files

Enhanced Status Buttons (MDT-086)

  • On Hold Toggle: Set tickets to On Hold status with single click from any column
  • Reject Button: Reject tickets with proper state management and visual feedback
  • Better UX: Clearer error handling and status change confirmations

🚀 Improvements

TOML Configuration (MDT-098)

  • Better Library: Replaced TOML parser with full parse/stringify support
  • Preserve Formatting: Configuration changes maintain file structure and comments
  • More Reliable: Improved parsing of complex nested configurations

Test Infrastructure (MDT-104)

  • Test Isolation: Enhanced test-lib with isolated test environments
  • CONFIG_DIR Support: Config-cli respects CONFIG_DIR environment variable
  • Integration Tests: Comprehensive tests for shared test library

🐛 Bug Fixes

Drag-and-Drop Updates (MDT-088, MDT-089)

  • PATCH Endpoint: New dedicated endpoint for partial ticket updates via drag-and-drop
  • Fixed Status Updates: On Hold and Reject buttons now work correctly
  • Better Error Handling: Proper HTTP status codes and error messages
  • Missing Endpoints: Implemented missing CRUD endpoints for full ticket management

Frontend Build (MDT-110)

  • Browser Compatibility: Removed Node.js modules from browser bundle
  • Conditional Exports: ProjectValidator now works in both browser and Node.js
  • Build Success: Frontend builds without "fs" module errors

Docker Production (MDT-055)

  • Fixed ENTRYPOINT: Backend production stage now properly configured
  • Auto-Config Creation: Default config.toml created on container startup
  • ESM Imports: Fixed Node.js ES module compatibility in Docker builds
  • Build Reliability: Resolved ERR_MODULE_NOT_FOUND errors

🔄 Migration Guide

Breaking Change: .mdt-config.toml schema updated - document paths moved to nested [project.document] section.

# Migrate all projects automatically
./scripts/migrate-all-projects-v0.7.2-to-v0.8.0.sh

# Preview first with --dry-run
./scripts/migrate-all-projects-v0.7.2-to-v0.8.0.sh --dry-run

Old: document_paths, exclude_folders, max_depth → New: [project.document] with paths, excludeFolders, maxDepth

🔧 Technical Improvements

Developer Experience

  • TypeScript Validation: Post-commit validation scripts for type safety (MDT-103)
  • ESLint & Prettier: Unified code formatting across all packages (MDT-103)
  • LSP Configuration: Better TypeScript and Python language server support

Testing Infrastructure

  • E2E Framework: Comprehensive testing for MCP server tools (MDT-091)
  • Shared Test Utilities: Consolidated testing patterns across projects

Code Quality

  • Refactored ProjectFactory: Extracted single-responsibility classes (MDT-097)
  • Consolidated File I/O: Shared services for file operations (MDT-102)
  • Domain Contracts: Zod schema validation package (MDT-101)

📚 Documentation

Workflow Enhancements

  • Proof of Concept Workflow: Validate technical uncertainty before implementation
  • SessionStart Hook: Auto-inject project variables into AI sessions
  • Improved Prompts: CR-type-aware formatting and behavioral requirements

Internal Improvements

  • MCP Tool Registry: Centralized tool configuration management
  • Import Organization: Standardized imports with path aliases
  • Code Structure: Improved component organization with consistent naming

v0.7.2 (2025-12-03)

🚀 Improvements

Enhanced Project Management UI (MDT-041)

  • Dark Theme Support: Complete dark mode compatibility for AddProjectModal components
  • Auto-Discovery Indicators: Visual feedback showing automatic project detection status
  • Real Directory Validation: Validates directory existence with graceful fallback handling
  • Improved Scrolling: Fixed modal scrolling issues with ScrollArea component implementation
  • Enhanced Path Resolution: Better handling of project paths with tilde expansion support

Consolidated Ticket Management (MDT-082)

  • Unified Service Layer: Consolidated duplicate ticket CRUD operations into shared services
  • ProjectManager Integration: Added ProjectManager to server for centralized ticket handling
  • Eliminated Duplication: Removed redundant ticket management code across frontend and backend
  • Improved Performance: Reduced overhead through shared service architecture

UI Components (MDT-076)

  • Reusable Alert Component: New consistent alert system for user feedback across the application
  • Standardized Error Messages: Uniform error display with proper styling and accessibility

🐛 Bug Fixes

Project Configuration

  • Registry Management: Enhanced registry file reference handling and project ID consistency
  • Path Validation: Fixed missing getSystemDirectories method in path selector functionality
  • Active Project Filtering: Properly filter inactive projects from API responses

YAML Frontmatter

  • Title Attribute: Fixed removal of title attribute from YAML frontmatter to prevent conflicts
  • Header Duplication: Prevented doubled headers when sections are renamed

CLI Tool (MDT-077)

  • Enhanced UX: Improved delete operations with visual feedback
  • Path Management: Added enhanced flags for better path handling
  • Validation: Comprehensive project validation utilities

📚 Documentation

Architecture Documentation

  • Technical Debt: Documented critical technical debt in server project management
  • Refactoring Guides: Added comprehensive refactoring documentation for MDT-082
  • CLI Guides: Enhanced CLI project management documentation

Internal Improvements

  • Import Organization: Standardized imports with path aliases and fixed symlink issues
  • Code Structure: Improved component organization with consistent naming conventions

v0.7.1 (2025-11-14)

🎉 New Features

CLI Project Management Tool (MDT-077)

  • Command-line Interface: Comprehensive CLI for project CRUD operations
  • Interactive Mode: Guided project creation with template support
  • Non-Interactive Mode: Automation-friendly commands for CI/CD pipelines
  • Template Operations: Import and export project configurations
  • Integration Ready: Works seamlessly with existing ProjectService architecture

Flexible Section Matching (MDT-052)

  • User-Friendly Format: MCP tools now accept section names like "Description" or "1. Description"
  • No Exact Syntax Required: Eliminates need for precise "## 1. Description" markdown format
  • Improved AI Integration: Makes it easier for AI assistants to work with ticket sections
  • Backwards Compatible: Still supports exact markdown heading syntax
  • Helpful Error Messages: Provides section suggestions when section not found

🚀 Improvements

Enhanced Ticket Creation Workflow

  • Comprehensive Prompt Template: Updated prompts/mdt-ticket-creation.md with detailed guidelines
  • Critical Rules: Clear rules to avoid common mistakes when creating tickets
  • MCP Tool Examples: Practical examples for using MCP tools effectively
  • Quality Checklist: Before-submitting checklist ensures high-quality tickets
  • Diagram Guidelines: Best practices for including technical diagrams

Project Rebranding

  • Consistent Naming: Updated from 'md-ticket-board' to 'markdown-ticket' throughout
  • Portable Scripts: Changed shebang to #!/usr/bin/env bash for better compatibility
  • Port Configuration: Production frontend moved from port 5173 to 4173
  • Package Naming: Consistent project/package ID across all components

Docker Configuration

  • MCP Stdio-only Option: New docker-compose.mcp-stdio-only.yml for traditional stdio transport
  • Flexible Transport: Choose between HTTP and stdio MCP transports in Docker

🐛 Bug Fixes

Ticket Numbering in Subdirectories (MDT-071)

  • Critical Fix: Resolved duplicate ticket numbers when .mdt-next file is missing
  • Subdirectory Support: Now correctly handles CRs in subdirectories like docs/CRs/
  • Path Resolution: Uses getCRPath() to find correct CR directory before scanning
  • Verified Fix: Tested with both root-level and subdirectory CR paths

📚 Documentation

Streamlined README

  • 41% Reduction: Reduced from 423 to 250 lines for better readability
  • Improved Quick Start: MCP setup integrated directly into Quick Start section
  • AI-First Focus: Clearer positioning as AI-powered development tool
  • Visual Workflow: Added Mermaid diagram showing AI-human collaboration phases
  • Better Organization: Moved Quick Start after value proposition for immediate clarity

Enhanced Docker Guide

  • 71% Reduction: Streamlined from 578 to 166 lines
  • bin/dc Documentation: Added comprehensive guide for Docker wrapper script
  • Configuration Focus: Practical usage patterns for CONFIG_DIR and CONFIG_DISCOVER_PATH
  • Quick Reference: Problem-solution pairs for common troubleshooting scenarios

Improved Ticket Templates

  • Artifact-Specification Format: Better structure for ADR-style tickets
  • Tables and Lists: Replaced prose with scannable tables and bullet points
  • Specific File Paths: All changes include exact file paths and line numbers
  • Measurable Criteria: Clear acceptance criteria with specific test cases

🔧 Technical Details

Start Script Improvements

  • Portable Shebang: All scripts use #!/usr/bin/env bash for cross-platform support
  • Better Package Detection: Improved patterns for detecting package.json files
  • Production Fixes: Corrected frontend startup to use bun run preview

Section Validation

  • Flexible Matching: SimpleSectionValidator now includes normalizeForMatching() function
  • Smart Normalization: Strips markdown syntax and numbering for comparison
  • Error Messaging: Provides helpful suggestions when sections don't match

v0.7.0 (2025-11-12)

🎉 Major New Features

Complete Docker Containerization

  • Full Docker Architecture: Production-ready container deployment with multi-environment support
  • Simplified Docker Scripts: bin/dc wrapper script for easy Docker Compose management
  • Multi-Stage Builds: Optimized containers with proper dependency management
  • Volume Mounting: Flexible project mounting with custom configurations
  • Health Checks: Built-in container health monitoring and endpoints

Advanced Configuration Management (MDT-073)

  • CLI Configuration Tool: Runtime configuration management via command-line interface
  • Environment Variable Support: Dynamic path configuration through environment variables
  • Centralized Config Handling: Robust fallback logic for configuration discovery
  • Production Config Management: Persistent configuration in Docker environments

Enhanced Project Discovery UI (MDT-076)

  • "No Projects Found" Interface: Comprehensive UI when no projects are configured
  • Configuration-Driven Discovery: Step-by-step guidance for project setup
  • Smart Path Suggestions: Intelligent recommendations for project paths

🚀 MCP Server Enhancements

HTTP Transport Improvements

  • Phase 2 Features: Advanced MCP HTTP transport with session management
  • Streamable HTTP Support: Implementation of 2025-06-18 MCP specification
  • Container Optimization: HTTP transport eliminates docker-exec overhead
  • Enhanced Security: Rate limiting, origin validation, and authentication options

Tool Consolidation

  • 40% Token Reduction: Continued optimization of MCP tools for efficiency
  • Section-Based Operations: 84-94% more efficient than full document updates
  • Quiet Mode: Reduced output for cleaner integration with AI assistants

🛠 Development Infrastructure

Production Deployment

  • Deployment Scripts: Comprehensive npm scripts for production environments
  • Workspace Management: npm workspaces for shared dependency resolution
  • Multi-Environment Support: Development, staging, and production configurations
  • Build Optimization: Improved build processes with proper TypeScript compilation

Code Organization

  • Shared Package Migration: Consolidated shared code under @mdt/shared package
  • TypeScript Path Mapping: Clean import structure across frontend and backend
  • Module Resolution: Fixed ES module compatibility issues

🐛 Bug Fixes

Docker Environment

  • Permission Issues: Resolved nginx and nodejs user permissions in containers
  • Module Import Fixes: Fixed backend module resolution in Docker environments
  • Build Compatibility: Resolved npm ci workspace compatibility issues
  • Production Dependencies: Fixed dependency management for production builds

Configuration System

  • Hardcoded Path Elimination: Replaced all hardcoded paths with configurable constants
  • Environment Variable Support: Added robust fallback logic for configuration paths
  • CLI Production Fixes: Ensured configuration CLI works in production environments

📚 Documentation

Docker Guide: Comprehensive Docker deployment documentation with examples

  • Architecture overview and container configuration
  • Development and production deployment patterns
  • Troubleshooting common Docker issues
  • Volume mounting and project configuration examples

Configuration Documentation: Complete guide for MDT-073 configuration management

  • CLI tool usage and examples
  • Environment variable configuration
  • Production deployment configuration patterns

🔧 Technical Improvements

Build System

  • npm Workspaces: Proper workspace configuration for monorepo management
  • TypeScript Compilation: Complete server migration to TypeScript
  • Shared Dependencies: Optimized shared package management
  • Production Builds: Streamlined build processes for deployment

Development Experience

  • Auto-Discovery: Improved project auto-discovery mechanisms
  • Development Scripts: Enhanced npm scripts for development workflows
  • Environment Detection: Better development vs production environment handling

v0.6.0 (2025-10-18)

Bug Fixes

  • Smart Link URL Duplication: Fixed critical bug where ticket links would show duplicated base URLs (e.g., http://localhost:5173http://localhost:5173/...).
  • Project Creation SSE Events: Resolved event ID mismatch issues when creating new projects that could cause UI inconsistencies.
  • Stale Closure in Ticket Updates: Fixed state update prevention that could stop board view updates when tickets were modified.
  • API Endpoint Consistency: Updated AddProjectModal to use correct /api/directories endpoint for directory discovery.
  • Navigation Race Conditions: Resolved race conditions in smart link navigation that could cause broken links.

Improvements

  • Smart Links Reliability: Comprehensive fixes for URL duplication issues, ensuring ticket references display correctly without duplicated base URLs.
  • Project Management: Enhanced project ID validation and duplicate detection to prevent configuration conflicts.
  • MCP Tool Optimization: Finalized 40% token reduction improvements through tool consolidation and efficient section-based operations.
  • Link Classification: Improved absolute URL recognition for ticket links, preventing conflicts with regular web URLs.
  • Automatic Git Worktree Exclusion: Project discovery now automatically excludes git worktrees to prevent duplicate project detection and confusion.
  • File Watcher-based Project Lifecycle: Improved automatic detection of project creation, deletion, and configuration changes without requiring manual refresh.

Planning & Architecture

  • MCP Transport Requirements: Created requirements for future MCP Streamable HTTP transport implementation (MDT-071 - declined).
  • Server TypeScript Migration: Planned migration of server architecture to TypeScript for better type safety (MDT-072).
  • Docker Infrastructure: Planned simplification of Docker containerization architecture (MDT-055).
  • Content Sanitization: Planned MCP content sanitization with conservative security approach (MDT-068).

v0.5.0 (2025-10-14)

New Features

  • Smart Links: Automatic conversion of ticket references (MDT-001) to clickable links with hover previews. Navigate between related tickets instantly.
  • Table of Contents: Auto-generated ToC for all markdown documents with persistent button state. Quickly jump to any section within long tickets.
  • H1 Title Management: Automatic standardization and management of H1 headers in tickets to maintain consistent formatting across projects.
  • Enhanced MCP Tools: New update_cr_section tool for updating specific ticket sections (98% more efficient than full document updates).
  • Event History Dev Tool: Advanced development tool for tracking and debugging real-time events and listener management.

Improvements

  • Document View Enhancement: Clickable labels and persistent sorting preferences in the documents view for better navigation.
  • Path Selector Logic: Improved project switching logic with immediate ticket clearing to prevent cross-project data errors.
  • Cross-Project Operations: Enhanced drag-and-drop between projects with proper view mode preservation.
  • Layered Architecture: Complete backend refactoring to clean layered architecture improving maintainability and scalability.
  • Real-time Updates: Enhanced file system change detection for more reliable markdown updates across all views.
  • Security Improvements: Strengthened path validation and access controls for multi-project environments.

Bug Fixes

  • Cross-Project Errors: Fixed critical bugs causing data corruption when switching between projects rapidly.
  • Drag-and-Drop Issues: Resolved stale closure problems that caused 404 errors during cross-project ticket operations.
  • Build Process: Fixed ES module import issues and TypeScript compilation problems in shared libraries.
  • Mermaid Rendering: Fixed diagram rendering and placeholder corruption issues.
  • Event Management: Complete resolution of stale closure bugs throughout the application using useRef patterns.

Technical Improvements

  • Component Architecture: Applied useRef pattern consistently across all components to prevent React stale closure bugs
  • TypeScript Configuration: Replaced ES module workarounds with proper TypeScript configuration
  • Build Optimization: Removed tracked compiled JS files and improved shared library compilation
  • Event System: Enhanced SSE event handling with better error prevention and cleanup

v0.4.0 (2025-10-02)

New Features

  • URL-based Routing: Navigate directly to specific tickets and views using URLs. Share links to tickets or open them directly from the address bar.
  • Mermaid Diagram Support: Render Mermaid diagrams in markdown documents with fullscreen viewing, adaptive scaling, and intuitive zoom controls.
  • Document Filtering: Filter documents and tickets by multiple criteria for easier navigation in large projects.
  • Collapsible Directories: Organize document view with collapsible directory trees for better navigation.
  • Section-based MCP Updates: Efficient CR updates through MCP tools that modify specific sections instead of entire documents, saving up to 98% of tokens.

Improvements

  • Document Sorting: Added date display and sorting functionality for documents in the document view.
  • Frontend Logging: Implemented autostart feature for early log capture during development.
  • MCP Documentation: Comprehensive updates to MCP tools documentation with section-based operations.
  • Ticket Interface: Consolidated description and rationale fields into unified Ticket interface.

Bug Fixes

  • Date Sorting: Fixed broken date sorting for ISO strings and missing lastModified fields.
  • Drag-and-Drop: Resolved drag-and-drop issues with optimistic UI updates.
  • Event System: Fixed bugs in event handling and project creation.
  • MCP Server: Resolved ES modules import issues and stdout contamination.
  • Counter API: Fixed syntax errors in counter API implementation.

Technical Improvements

  • Rate-limiting for status endpoint to improve performance
  • Enhanced frontend logger with better debugging capabilities
  • Upgraded dependencies and configurations
  • TypeScript ES modules compilation fixes

v0.3.0 (2025-09-11)

New Features

  • Badge Components: Enhanced visual display of ticket attributes with styled badges
  • Project Editing: Added capability to edit project names and document paths
  • Backlog Management: Hide/show functionality for backlog tickets in board view
  • MCP Development Tools: New MCP server for real-time development log access
  • Shared Core Architecture: Unified architecture across frontend and backend components

Improvements

  • ScrollArea Enhancement: Implemented auto-hide scrollbars with improved UX
  • Project Selector: Enhanced hover effects and improved layout design
  • Sorting Fixes: Resolved sorting issues for newly created tickets
  • On Hold Status: Fixed drag-and-drop functionality and UI improvements for On Hold tickets
  • Documentation: Updated ticket creation guides for better consistency

Bug Fixes

  • Fixed Rejected tickets appearing in wrong Kanban column
  • Resolved On Hold ticket visibility issues in board view
  • Improved drag-and-drop behavior for On Hold status tickets
  • Removed non-functional cache clear button

v0.2.1 (2025-09-09)

Bug Fixes

  • On Hold Status: Fixed visibility of tickets with "On Hold" status in the board view
  • Documentation: Updated ticket creation guide for better clarity and consistency

Known Issues

  • Cache Clean Button: Currently non-functional, will be addressed in future release

v0.2.0 (2025-09-09)

New Features

  • Enhanced Ticket Viewer: Comprehensive attribute display with structured block layout showing all ticket details
  • Relationship Attributes: Full support for ticket relationships (depends on, blocks, related tickets)
  • Status Toggle Buttons: Quick status changes directly from Kanban columns
  • Real-time Updates: SSE-based live updates with optimistic UI
  • Improved Sorting: Fixed list view sorting with proper date field handling

Improvements

  • TicketCode Component: Better ticket identifier formatting and display
  • MCP Documentation: Comprehensive API documentation and browser console integration guide
  • Attribute Simplification: Streamlined CR attributes for better usability
  • Markdown Compatibility: Fixed ToC anchor compatibility with GitHub

Bug Fixes

  • Fixed frontend compilation errors after attribute changes
  • Resolved Board component state synchronization issues
  • Fixed list view sorting not working properly
  • Fixed markdown anchor compatibility issues

v0.1.0 (2025-09-07)

Core Features

  • Kanban Board Interface: Visual drag-and-drop ticket management
  • Multi-Project Support: Manage multiple projects from single dashboard
  • Document Viewer: Tree navigation with markdown rendering
  • MCP Server Integration: Model Context Protocol for AI assistant integration
  • Project Configuration: Dual-configuration system (global registry + local config)

User Interface

  • Board/List/Docs Switcher: Toggle between different view modes
  • Add Project Modal: Complete project creation workflow
  • Duplicate Detection: Smart ticket numbering with conflict resolution
  • Responsive Design: Dark/light theme support

Technical Infrastructure

  • File System Integration: Real-time file watching and updates
  • Configuration Management: TOML-based project and user settings
  • Markdown Storage: All tickets stored as markdown with YAML frontmatter
  • TypeScript: Full type safety throughout the application

Documentation

  • Comprehensive README with setup instructions
  • MCP integration guides for AI assistants
  • Project management documentation
  • Development and testing guides