v1.8.0 - Workspace Paradigm Implementation

MCP Task Orchestrator v1.8.0 Release Notes

🚀 Workspace Paradigm Implementation

Version 1.8.0 introduces a major architectural enhancement: the Workspace Paradigm. This transformative update automatically detects your project context and intelligently organizes task artifacts within your development workspace.

What's New

Smart Workspace Detection

• Automatic Project Recognition: Detects common project markers including:

  • package.json (Node.js/JavaScript projects)
  • pyproject.toml, setup.py (Python projects)
  • Cargo.toml (Rust projects)
  • go.mod (Go projects)
  • pom.xml (Maven/Java projects)
  • .git directories (Git repositories)
  • And many more...

• Intelligent Artifact Organization: Tasks and their outputs are now automatically saved to your project's root directory, keeping your work organized and accessible.

Database Architecture Evolution

• Workspace-Aware Storage: All database tables now include workspace_id columns for proper workspace isolation
• Automatic Migration: Seamless upgrade from session-based to workspace-based storage
• Backward Compatibility: Existing tasks and data are preserved during the upgrade

Critical Bug Fixes

Database Migration System

• ✅ Fixed SQLAlchemy 2.0+ Compatibility: Resolved 'RootTransaction' object has no attribute 'execute' errors
• ✅ Enhanced Transaction Handling: Proper connection management with engine.connect() patterns
• ✅ Raw SQL Wrapping: All SQL executions now use text() wrapper for safety

Server Architecture

• ✅ Import Conflict Resolution: Eliminated server.py vs server/ package naming conflicts
• ✅ Package Restructuring: Renamed conflicting directories for cleaner imports
• ✅ Enhanced Reliability: Improved server startup and MCP client communication

Logging System

• ✅ Claude Code Compatibility: Fixed false error messages in debug logs
• ✅ Stream Separation: INFO messages to stdout, warnings/errors to stderr
• ✅ Cleaner Output: Eliminated confusing error labels on successful operations

Enhanced User Experience

For Developers

• Zero Configuration: Workspace detection works automatically
• Better Organization: Artifacts appear in logical project locations
• Improved Debugging: Cleaner log output with proper error classification

For AI Assistants

• Context Awareness: Better understanding of project structure
• Efficient Workflows: Tasks naturally align with development workspace
• Enhanced Persistence: Workspace-based task recovery and continuation

Migration Guide

Automatic Upgrade

The upgrade to v1.8.0 is fully automatic:

1. Database schema migrates seamlessly on first startup
2. Existing tasks are preserved and accessible
3. New workspace detection activates immediately
4. No configuration changes required

What Happens

• First Startup: Database migration adds workspace support (~ 1 second)
• Task Recovery: All existing tasks remain available
• New Behavior: Future tasks use workspace-aware organization
• Compatibility: Full backward compatibility maintained

Installation

# Update existing installation
pipx upgrade mcp-task-orchestrator

# Or fresh installation
pipx install mcp-task-orchestrator

Performance Improvements

• Migration System: Enhanced reliability with comprehensive error handling
• Database Operations: Optimized workspace-aware queries
• Memory Management: Improved resource utilization during startup
• Error Recovery: Better handling of edge cases and unexpected conditions

Testing & Quality

• ✅ Comprehensive Testing: All workspace detection scenarios validated
• ✅ Migration Testing: Database upgrade paths thoroughly tested
• ✅ Integration Testing: MCP client compatibility verified
• ✅ Backward Compatibility: Legacy functionality preserved

Next Steps

With the workspace paradigm in place, future releases will focus on:

• Enhanced workspace-aware features
• Advanced project context understanding
• Intelligent artifact management
• Cross-workspace task coordination

---

Support

• Documentation: Full documentation
• Issues: GitHub Issues
• PyPI Package: mcp-task-orchestrator

Thank you for using MCP Task Orchestrator! The workspace paradigm represents a significant step forward in AI-assisted development workflows.

v1.7.0 - PyPI Release Automation

Version 1.7.0 - PyPI Release Automation (2025-06-07)

✨ New Features

• Automated PyPI Release System: Comprehensive automation for PyPI package releases

  • Single-command release process with safety checks
  • Version management across all package files (setup.py, pyproject.toml, init.py)
  • Test suite execution before release
  • Automated git tagging and GitHub release creation
  • Support for patch/minor/major version increments
  • TestPyPI testing capability for pre-release validation

• Simple Release Script: Non-interactive release option for CI/CD pipelines

  • Streamlined release process without confirmation prompts
  • Ideal for automated deployment workflows
  • Complete safety validation maintained

🔧 Improvements

• Release Safety: Multiple validation layers prevent accidental releases
  • Branch validation (must be on main)
  • Uncommitted changes detection
  • Upstream synchronization verification
  • Build verification before upload
• Developer Experience: Simplified release workflow reduces manual steps
• Package Management: Automated cleanup of build artifacts

📋 Migration Notes

• Existing manual release process remains available as fallback
• New automation scripts located in \
• No breaking changes to existing functionality

🎯 Who Should Use

• Project Maintainers: Streamlined release management
• CI/CD Teams: Automated deployment pipeline integration
• Contributors: Simplified contribution to release process

📚 Documentation

• PyPI Release Automation Guide
• Workflow Integration

v1.6.1 - Professional Repository Organization & Critical Package Fix

MCP Task Orchestrator Release Notes

Version 1.6.1 - Professional Repository Organization & Critical Fix (2025-06-07)

🏆 Major Achievement: Professional-Grade Repository

• Health Score: 10/100 → 100/100 (+900% improvement)
• Root Files: 61 → 11 (-82% reduction)
• Virtual Environments: 6 → 1 (-83% reduction)
• Documentation Organization: 217 files professionally structured
• Script Organization: 76 scripts categorized by purpose

🐛 Critical Bug Fix

• FIXED: Task orchestrator package loading issue preventing MCP client connections
  • Problem: Console script entry point failed when installed as package via pip
  • Solution: Added main_sync() wrapper in server/__init__.py for proper entry point
  • Impact: Resolves "task orchestrator won't connect" issues for all users
  • Technical: Dynamic import rewriting to handle package vs development contexts

🎯 Repository Transformation

• Script Organization: All scripts moved to purpose-based directories

  • scripts/build/ - Package building and release automation (11 files)
  • scripts/testing/ - Test execution and validation (13 files)
  • scripts/diagnostics/ - Health monitoring and analysis (23 files)
  • scripts/deployment/ - Installation and deployment (3 files)

• Documentation Architecture: Professional information design

  • docs/releases/ - Version and release management
  • docs/testing/ - Quality assurance documentation
  • docs/development/ - Implementation and contribution guides
  • docs/user-guide/ - End-user documentation
  • docs/troubleshooting/ - Problem resolution guides

✨ New Features

• Health Monitoring System: Real-time repository health scoring

  • Automatic tracking with trend analysis
  • Threshold-based alerting (< 85 triggers warning)
  • Historical data visualization

• Automated Maintenance: Self-sustaining quality preservation

  • Build artifact cleanup
  • Cache management
  • GitIgnore optimization
  • Scheduled maintenance tasks (daily/weekly/bi-weekly)

🔧 Developer Experience

• Claude Code Integration: Session templates and optimized workflows
• Enhanced Testing: Reliable test runners preventing output truncation
• Professional Standards: Industry-standard organization patterns
• CI/CD Ready: Prepared for automated deployment pipelines

📋 Migration Notes

• All functionality preserved (100% import success rate)
• Scripts have moved but maintain backward compatibility via imports
• Documentation reorganized but all content preserved and enhanced
• Virtual environments consolidated to single venv_mcp

🎯 Who Should Upgrade

• All Users: Critical fix for package installation issues
• Development Teams: Massive improvement in developer experience
• New Contributors: Clear, organized structure for easier onboarding

Version 1.5.1 - Critical Artifact Path Fix (2025-06-06)

🚨 IMMEDIATE ACTION REQUIRED

• Upgrade Immediately: This release fixes a critical bug that prevents access to generated artifacts
• All Users Affected: Previous versions store artifacts in inaccessible server directories

🐛 Critical Bug Fixes

• FIXED: Artifact path resolution issue causing artifacts to be written to MCP server directory
  • Problem: Artifacts were stored in server's working directory instead of user's project directory
  • Solution: Artifacts now correctly stored in .task_orchestrator/artifacts/ within user's current working directory
  • Impact: Resolves functionality issues for users experiencing artifact access problems
  • User Experience: Users can now access all generated documentation, analysis, and code artifacts

🔧 Infrastructure Improvements

• Synchronized version numbers across all package files (resolved 1.5.0/1.4.0 mismatch)
• Enhanced artifact storage system reliability

🎯 Who Should Upgrade

• All Users: This bug affects every user attempting to use artifact generation features
• Development Teams: Critical for teams relying on task orchestrator for documentation and analysis
• Production Deployments: Essential update for any production usage

📋 Migration Notes

• No breaking changes to API or configuration
• Existing artifacts may remain in old server locations (can be safely deleted)
• New artifacts will be correctly placed in project directories after upgrade

---

Version 1.3.1 - Critical Bug Fix Release (2025-05-30)

🐛 Critical Bug Fixes

• CRITICAL: Fixed orchestrator_initialize_session failure preventing tool entry
  • Corrected method name mismatch: _get_parent_task_id_from_persistence → _get_parent_task_id
  • Resolves initialization issues for new users attempting to use the orchestrator
  • Enables parent task progress tracking and interrupted task detection

📚 Documentation Improvements

• NEW: QUICK_START.md - Streamlined 5-minute setup guide
• NEW: TROUBLESHOOTING.md - Comprehensive error resolution guide
• NEW: README_STREAMLINED.md - Simplified project overview
• Addresses major UX pain point of information overload in documentation

🎯 Impact

• Restores orchestrator entry point functionality
• Eliminates critical barrier preventing new user adoption
• Provides clear troubleshooting path for common setup issues
• Reduces cognitive load for first-time users

---

Version 1.3.0 - Database Persistence Complete (2025-05-29)

🎯 Major Features

• Database Persistence: Full SQLite-based task and subtask persistence
• Professional Directory Structure: Comprehensive project reorganization
• Enhanced Testing Suite: Organized test categories (unit/integration/performance)
• Diagnostic Tools: Comprehensive system health and maintenance utilities

✨ New Features

• SQLite database backend for all task data
• Lock tracking and cleanup mechanisms
• Comprehensive diagnostic and maintenance scripts
• Professional directory organization following Python best practices
• Enhanced documentation structure

🔧 Improvements

• Organized test suite with clear categories
• Better script organization (diagnostics/maintenance/deployment)
• Comprehensive documentation restructure
• Enhanced configuration management
• Better cross-platform compatibility

🐛 Bug Fixes

• Fixed critical StateManager get_parent_task_id method issue
• Improved Unicode compatibility for console output
• Enhanced error handling and recovery
• Better database connection management

📁 Directory Structure

MCP Task Orchestrator/
├── tests/
│   ├── integration/     # End-to-end workflow tests
│   ├── unit/           # Component-level tests  
│   ├── performance/    # Performance benchmarks
│   └── fixtures/       # Test utilities
├── scripts/
│   ├── diagnostics/    # System diagnostic tools
│   ├── maintenance/    # Maintenance utilities
│   ├── migrations/     # Data migration scripts
│   └── deployment/     # Installation scripts
├── docs/
│   ├── development/    # Technical implementation guides
│   ├── testing/        # Test procedures and reports
│   └── troubleshooting/ # Diagnostic guides
├── data/              # Database and backup files
└── logs/              # Log files

🛠️ New Utilities

• scripts/maintenance/run_tests.py - Comprehensive test runner
• scripts/maintenance/cleanup_database.py - Database cleanup and maintenance
• scripts/diagnostics/simple_health_check.py - System health validation
• scripts/maintenance/setup_project.py - Project setup and validation

📚 Enhanced Documentation

• Complete testing guides and procedures
• Troubleshooting and diagnostic documentation
• Development implementation guides
• Comprehensive API and usage documentation

⚠️ Breaking Changes

None - Fully backward compatible

🔄 Migration Notes

• Database files automatically created on first use
• Old task data preserved during upgrade
• New directory structure is optional but recommended
• All existing functionality maintained

📋 Known Issues

• None - All critical issues resolved in this release

🚀 Next Steps

• Implement parallel task execution capabilities
• Enhanced progress visualization
• Advanced orchestration features

Version 1.1 (May 27, 2025)

Major Enhancements

LLM-Powered Task Orchestration

• Introduced a new approach that leverages the calling LLM's intelligence for task breakdown
• Added initialize_session method to provide guidance to the LLM
• Modified plan_task method to accept JSON-formatted subtasks directly from the LLM
• Removed pattern-matching approach in favor of more flexible LLM-driven task analysis

Documentation Updates

• Updated README.md to reflect the new LLM-powered approach
• Enhanced usage.md with comprehensive instructions for the new workflow
• Updated DEVELOPER.md with architecture documentation for the new system
• Updated usage_examples.md with examples of the new workflow
• Fixed markdown linting issues across documentation files

API Changes

• Added new tool: orchestrator_initialize_session - Provides context and guidance to the LLM
• Modified orchestrator_plan_task tool to accept JSON-formatted subtasks

Compatibility

• Maintains backward compatibility with existing task orchestration features
• All existing specialist types and state management remain functional

Version 1.0 (Initial Release)

Features

• Unified installation system for all supported MCP clients
• Auto-detection of installed clients
• Task decomposition with pattern matching
• Specialist modes (Architect, Implementer, Debugger, Documenter)
• State management for tracking task progress
• Support for Claude Desktop, Cursor IDE, Windsurf, and VS Code with Cline

v1.6.0

Release v1.6.0: Comprehensive Testing Infrastructure & Release Preparation

🚀 Major Features:

• Comprehensive testing infrastructure with migration and server reboot validation
• Complete PyPI release pipeline with automated build and validation systems
• Database migration system with automatic schema evolution and rollback support
• Zero-downtime server reboot capabilities for seamless development
• Enhanced documentation with complete testing guides and release workflows

📊 Stats: 28 files changed, 8,534+ lines added
🧪 Testing: Database migration, server reboot, PyPI package validation
📚 Documentation: Comprehensive reports, workflow guides, and troubleshooting

This release establishes robust testing infrastructure and standardized release processes for reliable future development.

What's Changed

• feat: Automatic Database Migration System by @EchoingVesper in #27
• feat: In-Context Server Reboot System by @EchoingVesper in #28

Full Changelog: v1.5.2...v1.6.0