claude-mpm 3.7.8__tar.gz → 3.9.0__tar.gz

claude_mpm-3.9.0/CLAUDE.md

@@ -0,0 +1,257 @@
+# Claude MPM Development Guidelines
+
+This document provides development guidelines for the claude-mpm project codebase.
+
+## Project Overview
+
+Claude MPM (Multi-Agent Project Manager) is a framework that extends Claude Desktop with multi-agent orchestration capabilities, featuring a modern service-oriented architecture with interface-based contracts and dependency injection.
+
+## Architecture (v3.8.2+)
+
+Following the TSK-0053 refactoring, Claude MPM features:
+
+- **Service-Oriented Architecture**: Five specialized service domains
+- **Interface-Based Contracts**: All services implement explicit interfaces  
+- **Dependency Injection**: Service container with automatic resolution
+- **Performance Optimizations**: Lazy loading, multi-level caching, connection pooling
+- **Security Framework**: Input validation, path traversal prevention, secure operations
+- **Backward Compatibility**: Lazy imports maintain existing import paths
+
+## Key Documentation
+
+### Architecture and Development
+- 🏗️ **Architecture Overview**: See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for service-oriented architecture
+- 📁 **Project Structure**: See [docs/STRUCTURE.md](docs/STRUCTURE.md) for file organization
+- 🔧 **Service Layer Guide**: See [docs/developer/SERVICES.md](docs/developer/SERVICES.md) for service development
+- ⚡ **Performance Guide**: See [docs/PERFORMANCE.md](docs/PERFORMANCE.md) for optimization patterns
+- 🔒 **Security Guide**: See [docs/SECURITY.md](docs/SECURITY.md) for security framework
+- 🧪 **Testing Guide**: See [docs/TESTING.md](docs/TESTING.md) for testing strategies
+- 📚 **Migration Guide**: See [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions
+
+### Operations and Quality
+- 🧪 **Quality Assurance**: See [docs/QA.md](docs/QA.md) for testing guidelines
+- 🚀 **Deployment**: See [docs/DEPLOY.md](docs/DEPLOY.md) for versioning and deployment
+- 📊 **Logging**: See [docs/RESPONSE_LOGGING_CONFIG.md](docs/RESPONSE_LOGGING_CONFIG.md) for response logging configuration
+- 🔢 **Versioning**: See [docs/VERSIONING.md](docs/VERSIONING.md) for version management
+- 🧠 **Memory System**: See [docs/MEMORY.md](docs/MEMORY.md) for agent memory management
+
+## Development Guidelines
+
+### Critical Principles
+
+**🔴 NEVER ASSUME - ALWAYS VERIFY**
+- **NEVER assume** file locations, configurations, or implementations
+- **ALWAYS verify** by reading actual files and checking current state
+- **ALWAYS check** existing code patterns before implementing
+- **NEVER guess** at directory structures or file contents
+- **ALWAYS confirm** dependencies and imports exist before using them
+
+### Project Structure Requirements
+
+1. **File Organization**: Always refer to `docs/STRUCTURE.md` when creating new files
+   - **Scripts**: ALL scripts go in `/scripts/`, NEVER in project root
+   - **Tests**: ALL tests go in `/tests/`, NEVER in project root
+   - **Python modules**: Always under `/src/claude_mpm/`
+   
+2. **Import Conventions**: 
+   - Use full package names: `from claude_mpm.module import ...`
+   - Never use relative imports in main code
+   - Check existing patterns before adding new imports
+
+### Testing Requirements
+
+**After significant changes, always run:**
+```bash
+# Quick E2E tests
+./scripts/run_e2e_tests.sh
+
+# Full test suite
+./scripts/run_all_tests.sh
+
+# Lint and type checks
+./scripts/run_lint.sh
+```
+
+See [docs/QA.md](docs/QA.md) for detailed testing procedures.
+
+### Key System Components
+
+When modifying the codebase, understand these core systems:
+
+1. **Framework Loader** (`src/claude_mpm/core/framework_loader.py`)
+   - Loads PM instructions from `src/claude_mpm/agents/INSTRUCTIONS.md`
+   - Manages agent discovery and capabilities
+   - DO NOT duplicate CLAUDE.md content here
+
+2. **Hook System** (`src/claude_mpm/hooks/`)
+   - Extensibility through pre/post hooks
+   - Response logging via `SubagentStop` and `Stop` events
+   - Structured JSON responses for proper logging
+
+3. **Services Layer** (`src/claude_mpm/services/`)
+   - **Core Services**: Foundation interfaces and base classes
+   - **Agent Services**: Agent lifecycle, deployment, and management
+   - **Communication Services**: Real-time WebSocket and SocketIO
+   - **Project Services**: Project analysis and workspace management
+   - **Infrastructure Services**: Logging, monitoring, and error handling
+   - **Legacy Structure**: Maintained for backward compatibility
+
+4. **CLI System** (`src/claude_mpm/cli/`)
+   - Modular command structure
+   - See [CLI Architecture](src/claude_mpm/cli/README.md) for adding new commands
+
+### Common Development Tasks
+
+#### Adding a New Service
+1. **Create Interface**: Define service contract in `src/claude_mpm/services/core/interfaces.py`
+2. **Implement Service**: Create implementation in appropriate service domain
+3. **Register Service**: Add to service container if using dependency injection
+4. **Add Tests**: Create unit, integration, and interface compliance tests
+5. **Update Documentation**: Document service in [docs/developer/SERVICES.md](docs/developer/SERVICES.md)
+
+#### Service Development Patterns
+```python
+# 1. Define interface
+class IMyService(ABC):
+    @abstractmethod
+    def my_operation(self, param: str) -> bool:
+        pass
+
+# 2. Implement service
+class MyService(BaseService, IMyService):
+    def __init__(self, dependency: IDependency):
+        super().__init__("MyService")
+        self.dependency = dependency
+    
+    async def initialize(self) -> bool:
+        # Initialize service
+        return True
+    
+    def my_operation(self, param: str) -> bool:
+        # Implementation
+        return True
+
+# 3. Register in container
+container.register(IMyService, MyService, singleton=True)
+
+# 4. Test interface compliance
+def test_service_implements_interface():
+    service = MyService(mock_dependency)
+    assert isinstance(service, IMyService)
+```
+
+#### Modifying PM Instructions
+1. Edit `src/claude_mpm/agents/INSTRUCTIONS.md` for PM behavior
+2. Edit `src/claude_mpm/agents/BASE_PM.md` for framework requirements
+3. Test with `./claude-mpm run` in interactive mode
+4. Update tests for PM behavior changes
+
+#### Adding CLI Commands
+1. Create command module in `src/claude_mpm/cli/commands/`
+2. Register in `src/claude_mpm/cli/parser.py`
+3. Follow existing command patterns
+4. Use dependency injection for service access
+5. Add comprehensive tests and documentation
+
+#### Performance Optimization
+1. **Identify Bottlenecks**: Use profiling tools and performance tests
+2. **Implement Caching**: Add appropriate caching layers
+3. **Lazy Loading**: Defer expensive operations until needed
+4. **Connection Pooling**: Reuse expensive connections
+5. **Monitor Metrics**: Track performance over time
+
+## Common Issues and Solutions
+
+### Architecture-Related Issues
+1. **Service Resolution Errors**: Ensure services are registered in container before resolving
+2. **Interface Compliance**: Verify services implement all required interface methods
+3. **Circular Dependencies**: Use dependency injection and avoid circular imports
+4. **Cache Performance**: Monitor cache hit rates and adjust TTL settings
+
+### Legacy Compatibility Issues
+1. **Import Errors**: Use new service paths or rely on lazy import compatibility
+2. **Service Instantiation**: Use service container instead of direct instantiation
+3. **Configuration Schema**: Update config files to new structure
+
+### Performance Issues
+1. **Slow Startup**: Check lazy loading implementation and cache warming
+2. **Memory Usage**: Monitor service memory consumption and optimization
+3. **Cache Misses**: Verify cache configuration and invalidation strategies
+
+### Traditional Issues
+1. **Import Errors**: Ensure virtual environment is activated and PYTHONPATH includes `src/`
+2. **Hook Service Errors**: Check port availability (8080-8099)
+3. **Version Errors**: Run `pip install -e .` to ensure proper installation
+4. **Agent Loading**: Check `.claude/agents/` for deployed agents
+
+## Contributing
+
+### Code Quality Standards
+1. **Follow Architecture**: Use service-oriented patterns and interface-based design
+2. **Structure Compliance**: Follow the structure in `docs/STRUCTURE.md`
+3. **Interface Design**: Define clear contracts for all services
+4. **Dependency Injection**: Use service container for loose coupling
+5. **Performance**: Implement caching and lazy loading where appropriate
+6. **Security**: Follow security guidelines in `docs/SECURITY.md`
+
+### Testing Requirements
+1. **Unit Tests**: Test individual services and components (85%+ coverage)
+2. **Integration Tests**: Test service interactions and interfaces
+3. **Performance Tests**: Verify caching and optimization features
+4. **Security Tests**: Validate input validation and security measures
+5. **E2E Tests**: Test complete user workflows
+
+### Documentation Standards
+1. **Service Documentation**: Document all interfaces and implementations
+2. **Architecture Updates**: Keep architecture docs current
+3. **Migration Guides**: Document breaking changes and upgrade paths
+4. **Performance Metrics**: Document performance expectations and benchmarks
+
+### Version Management
+Use [Conventional Commits](https://www.conventionalcommits.org/) for automatic versioning:
+- `feat:` for new features (minor version bump)
+- `fix:` for bug fixes (patch version bump)
+- `feat!:` or `BREAKING CHANGE:` for breaking changes (major version bump)
+- `perf:` for performance improvements
+- `refactor:` for code refactoring
+- `docs:` for documentation updates
+
+## Deployment Process
+
+See [docs/DEPLOY.md](docs/DEPLOY.md) for the complete deployment process:
+- Version management with `./scripts/manage_version.py`
+- Building and publishing to PyPI
+- Creating GitHub releases
+- Post-deployment verification
+
+## TSK-0053 Refactoring Achievements
+
+The service layer architecture refactoring delivered:
+
+### Technical Achievements
+- **Service-Oriented Architecture**: Complete redesign with five specialized service domains
+- **Interface-Based Contracts**: All major services implement explicit interfaces
+- **Dependency Injection**: Service container with automatic dependency resolution
+- **50-80% Performance Improvement**: Through lazy loading and intelligent caching
+- **Enhanced Security**: Comprehensive input validation and sanitization framework
+- **Backward Compatibility**: Lazy imports maintain existing import paths
+
+### Quality Improvements
+- **Better Testability**: Interface-based architecture enables easy mocking and testing
+- **Improved Maintainability**: Clear separation of concerns and service boundaries
+- **Enhanced Reliability**: Comprehensive testing with 85%+ coverage target
+- **Developer Experience**: Rich documentation and migration guides
+
+### Future-Proofing
+- **Scalability**: Service-oriented design supports future growth
+- **Extensibility**: Plugin architecture through interfaces and hooks
+- **Modularity**: Clear service boundaries enable independent development
+- **Performance**: Intelligent caching and resource optimization foundations
+
+## Important Notes
+
+- This file (CLAUDE.md) contains ONLY development guidelines for this project
+- Framework features and usage are documented in the framework itself
+- Claude Desktop automatically reads this file - keep it focused on development tasks
+- Do not include end-user documentation or framework features here
+- The refactored architecture enables faster development and better code quality

{claude_mpm-3.7.8/src/claude_mpm.egg-info → claude_mpm-3.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.7.8
+Version: 3.9.0
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -32,7 +32,7 @@ Requires-Dist: watchdog>=3.0.0
 Requires-Dist: tree-sitter>=0.21.0
 Requires-Dist: python-socketio>=5.11.0
 Requires-Dist: aiohttp>=3.9.0
-Requires-Dist: aiohttp-cors>=0.8.0
+Requires-Dist: aiohttp-cors<0.8.0,>=0.7.0
 Requires-Dist: python-engineio>=4.8.0
 Requires-Dist: python-frontmatter>=1.0.0
 Requires-Dist: mistune>=3.0.0
@@ -44,6 +44,10 @@ Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.2.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
+Requires-Dist: sphinx-autobuild>=2021.3.14; extra == "docs"
 Provides-Extra: monitor
 Provides-Extra: agents
 Requires-Dist: bandit>=1.7.5; extra == "agents"
@@ -109,168 +113,74 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 - 🔍 **Git Integration**: View diffs and track changes across projects
 - 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
 
-## Installation
+## Quick Installation
 
 ```bash
-# Basic installation - pure Python, no compilation required
 pip install claude-mpm
-
-# Install with development dependencies
-pip install "claude-mpm[dev]"
-
-# Install with agent dependencies - pure Python tools
-pip install "claude-mpm[agents]"
-
-# Install with all optional dependencies
-pip install "claude-mpm[agents,dev]"
 ```
 
-All dependencies are pure Python - no Rust or compilation required. The `agents` dependency group includes tools for testing, code analysis, documentation, and development workflows.
+**That's it!** See [QUICKSTART.md](QUICKSTART.md) for immediate usage or [docs/user/installation.md](docs/user/installation.md) for advanced options.
 
-## Basic Usage
+## Quick Usage
 
 ```bash
-# Interactive mode (recommended)
+# Start interactive mode (recommended)
 claude-mpm
 
-# Non-interactive with task
-claude-mpm run -i "analyze this codebase" --non-interactive
-
-# With monitoring dashboard
+# Start with monitoring dashboard
 claude-mpm run --monitor
-
-# Resume last session
-claude-mpm run --resume
 ```
 
-### Agent Management
-
-```bash
-# View agent hierarchy and precedence
-claude-mpm agents list --by-tier
-
-# Inspect specific agent configuration
-claude-mpm agents view engineer
-
-# Fix agent configuration issues
-claude-mpm agents fix --all --dry-run
-```
-
-For detailed usage, see [QUICKSTART.md](QUICKSTART.md)
-
-### Agent Dependencies
-
-Claude MPM automatically manages Python dependencies required by agents. All dependencies are pure Python packages that don't require compilation. Agents can declare their dependencies in their configuration files, and the system aggregates them for easy installation.
-
-```bash
-# Install all agent dependencies (pure Python)
-pip install "claude-mpm[agents]"
-
-# View current agent dependencies
-python scripts/aggregate_agent_dependencies.py --dry-run
-
-# Update pyproject.toml with latest agent dependencies
-python scripts/aggregate_agent_dependencies.py
-```
+See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
-**Agent developers** can declare dependencies in their agent configurations:
 
-```json
-{
-  "agent_id": "my_agent",
-  "dependencies": {
-    "python": ["pandas>=2.0.0", "numpy>=1.24.0"],
-    "system": ["ripgrep", "git"]
-  }
-}
-```
+## Architecture
 
-Dependencies are automatically aggregated from all agent sources (PROJECT > USER > SYSTEM) during the build process, with intelligent version conflict resolution taking the highest compatible version.
+Claude MPM v3.8.2+ features a **modern service-oriented architecture** with interface-based design, dependency injection, and intelligent caching for 50-80% performance improvements.
 
-For comprehensive documentation, see [docs/AGENT_DEPENDENCIES.md](docs/AGENT_DEPENDENCIES.md).
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed architecture information.
 
 ## Key Capabilities
 
 ### Multi-Agent Orchestration
-The PM agent automatically delegates work to specialized agents:
-- **Research**: Codebase analysis and investigation
-- **Engineer**: Implementation and coding
-- **QA**: Testing and validation
-- **Documentation**: Docs and guides
-- **Security**: Security analysis
-- **Ops**: Deployment and infrastructure
-- **Data Engineer**: Data pipelines and AI integrations
-- **Test Integration**: E2E testing and cross-system validation
-- **Version Control**: Git workflows and release management
-
-**Three-Tier Agent System**: PROJECT > USER > SYSTEM precedence allows project-specific agent customization while maintaining fallbacks. Use `claude-mpm agents list --by-tier` to see the active agent hierarchy.
-
-### Session Management
-- All work is tracked in persistent sessions
-- Resume any session with `--resume`
-- Switch between projects with per-session directories
-- View session history and activity
+The PM agent automatically delegates work to specialized agents including Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, and Version Control.
 
 ### Agent Memory System
-Agents learn and improve over time with persistent memory:
-- **Project-Specific Knowledge**: Automatically analyzes your codebase to understand patterns
-- **Continuous Learning**: Agents remember insights across sessions
-- **Memory Management**: Initialize, optimize, and manage agent memories
-- **Quick Initialization**: Use `/mpm memory init` to scan project and create memories
-
-```bash
-# Initialize project-specific memories
-claude-mpm memory init
-
-# View memory status
-claude-mpm memory status
-
-# Add specific learning
-claude-mpm memory add engineer pattern "Always use async/await for I/O"
-
-# Start with monitoring dashboard
-claude-mpm run --monitor
-```
-
-See [docs/MEMORY.md](docs/MEMORY.md) for comprehensive memory system documentation.
+Agents learn project-specific patterns and remember insights across sessions. Initialize with `claude-mpm memory init`.
 
 ### Real-Time Monitoring
-The `--monitor` flag opens a web dashboard showing:
-- Live agent activity and delegations
-- File operations with git diff viewer
-- Tool usage and results
-- Session management UI
+The `--monitor` flag opens a web dashboard showing live agent activity, file operations, and session management.
 
-See [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for full monitoring guide.
+See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
 ## Documentation
 
+### User Documentation
 - **[Quick Start Guide](QUICKSTART.md)** - Get running in 5 minutes
-- **[Agent Memory System](docs/MEMORY.md)** - Comprehensive memory documentation
-- **[Monitoring Dashboard](docs/developer/11-dashboard/README.md)** - Real-time monitoring features
-- **[Project Structure](docs/STRUCTURE.md)** - Codebase organization
-- **[Deployment Guide](docs/DEPLOY.md)** - Publishing and versioning
+- **[Installation Guide](docs/user/installation.md)** - Complete installation options
 - **[User Guide](docs/user/)** - Detailed usage documentation
-- **[Developer Guide](docs/developer/)** - Architecture and API reference
+- **[Memory System](docs/MEMORY.md)** - Agent memory documentation
+- **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
+
+### Developer Documentation
+- **[Architecture Overview](docs/ARCHITECTURE.md)** - Service-oriented architecture and design
+- **[API Reference](docs/api/)** - Complete API documentation with Sphinx
+- **[Service Layer Guide](docs/developer/SERVICES.md)** - Service interfaces and implementations
+- **[Performance Guide](docs/PERFORMANCE.md)** - Optimization and caching strategies
+- **[Security Guide](docs/SECURITY.md)** - Security framework and best practices
+- **[Testing Guide](docs/TESTING.md)** - Testing patterns and strategies
+- **[Migration Guide](docs/MIGRATION.md)** - Upgrading from previous versions
+- **[Developer Guide](docs/developer/)** - Comprehensive development documentation
 
-## Recent Updates (v3.4.27)
+### API Documentation
+Comprehensive API documentation is available at [docs/api/](docs/api/) - build with `make html` in that directory.
 
-### Core System Enhancements
-- **Project Structure Reorganization**: Centralized path management with ClaudeMPMPaths enum
-- **Agent Services Hierarchy**: Reorganized agent and memory services into hierarchical structures  
-- **Response Logging Improvements**: Flat structure logging without session_ prefix
-- **Memory System Expansion**: Added data_engineer and test_integration agents with specialized keywords
-- **Path Management System**: Implemented centralized configuration path handling
+## Recent Updates (v3.8.2)
 
-### Project Cleanup & Organization
-- **Test File Migration**: Moved 66 test files from scripts/ to tests/ directory
-- **Documentation Archives**: Archived 35+ QA reports to docs/archive/
-- **Obsolete Directory Removal**: Cleaned up orchestration, docker, security, and terminal_wrapper directories
-- **Agent Registry Caching**: Enhanced performance with intelligent caching mechanisms
-- **Improved TodoWrite Integration**: Enhanced agent prefix guidelines across all agent templates
+**Major Architecture Refactoring (TSK-0053)**: Complete service-oriented redesign with 50-80% performance improvements, enhanced security, and interface-based design.
 
-See [CHANGELOG.md](CHANGELOG.md) for full history.
+See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
 
 ## Development
 

claude_mpm-3.9.0/README.md

@@ -0,0 +1,101 @@
+# Claude MPM - Multi-Agent Project Manager
+
+A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through an intuitive interface.
+
+> **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
+
+## Features
+
+- 🤖 **Multi-Agent System**: Automatically delegates tasks to specialized agents (PM, Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, Version Control)
+- 🧠 **Agent Memory System**: Persistent learning with project-specific knowledge retention
+- 🔄 **Session Management**: Resume previous sessions with `--resume` 
+- 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
+- 📁 **Multi-Project Support**: Per-session working directories
+- 🔍 **Git Integration**: View diffs and track changes across projects
+- 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
+
+## Quick Installation
+
+```bash
+pip install claude-mpm
+```
+
+**That's it!** See [QUICKSTART.md](QUICKSTART.md) for immediate usage or [docs/user/installation.md](docs/user/installation.md) for advanced options.
+
+## Quick Usage
+
+```bash
+# Start interactive mode (recommended)
+claude-mpm
+
+# Start with monitoring dashboard
+claude-mpm run --monitor
+```
+
+See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
+
+
+## Architecture
+
+Claude MPM v3.8.2+ features a **modern service-oriented architecture** with interface-based design, dependency injection, and intelligent caching for 50-80% performance improvements.
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed architecture information.
+
+## Key Capabilities
+
+### Multi-Agent Orchestration
+The PM agent automatically delegates work to specialized agents including Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, and Version Control.
+
+### Agent Memory System
+Agents learn project-specific patterns and remember insights across sessions. Initialize with `claude-mpm memory init`.
+
+### Real-Time Monitoring
+The `--monitor` flag opens a web dashboard showing live agent activity, file operations, and session management.
+
+See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
+
+
+## Documentation
+
+### User Documentation
+- **[Quick Start Guide](QUICKSTART.md)** - Get running in 5 minutes
+- **[Installation Guide](docs/user/installation.md)** - Complete installation options
+- **[User Guide](docs/user/)** - Detailed usage documentation
+- **[Memory System](docs/MEMORY.md)** - Agent memory documentation
+- **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
+
+### Developer Documentation
+- **[Architecture Overview](docs/ARCHITECTURE.md)** - Service-oriented architecture and design
+- **[API Reference](docs/api/)** - Complete API documentation with Sphinx
+- **[Service Layer Guide](docs/developer/SERVICES.md)** - Service interfaces and implementations
+- **[Performance Guide](docs/PERFORMANCE.md)** - Optimization and caching strategies
+- **[Security Guide](docs/SECURITY.md)** - Security framework and best practices
+- **[Testing Guide](docs/TESTING.md)** - Testing patterns and strategies
+- **[Migration Guide](docs/MIGRATION.md)** - Upgrading from previous versions
+- **[Developer Guide](docs/developer/)** - Comprehensive development documentation
+
+### API Documentation
+Comprehensive API documentation is available at [docs/api/](docs/api/) - build with `make html` in that directory.
+
+## Recent Updates (v3.8.2)
+
+**Major Architecture Refactoring (TSK-0053)**: Complete service-oriented redesign with 50-80% performance improvements, enhanced security, and interface-based design.
+
+See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
+
+## Development
+
+### Contributing
+Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
+
+### Project Structure
+See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
+
+### License
+MIT License - see [LICENSE](LICENSE) file.
+
+## Credits
+
+- Based on [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm)
+- Enhanced for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) integration
+- Built with ❤️ by the Claude MPM community

claude_mpm-3.9.0/VERSION

@@ -0,0 +1 @@
+3.9.0

{claude_mpm-3.7.8 → claude_mpm-3.9.0}/pyproject.toml

@@ -10,7 +10,7 @@ readme = "README.md"
 requires-python = ">=3.8"
 keywords = [ "claude", "orchestration", "multi-agent", "ticket-management",]
 classifiers = [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12",]
-dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "tree-sitter>=0.21.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.8.0", "python-engineio>=4.8.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "aiofiles>=23.0.0",]
+dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "tree-sitter>=0.21.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "aiofiles>=23.0.0",]
 [[project.authors]]
 name = "Claude MPM Team"
 
@@ -19,6 +19,7 @@ text = "MIT"
 
 [project.optional-dependencies]
 dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy",]
+docs = [ "sphinx>=7.2.0", "sphinx-rtd-theme>=1.3.0", "sphinx-autobuild>=2021.3.14",]
 monitor = []
 # Pure Python agent dependencies - no compilation required
 agents = [ "bandit>=1.7.5", "black>=23.0.0", "commitizen>=3.13.0", "dask>=2023.12.0", "detect-secrets>=1.4.0", "diagrams>=0.23.0", "docstring-parser>=0.15.0", "faker>=20.0.0", "gitlint>=0.19.0", "gitpython>=3.1.40", "hypothesis>=6.92.0", "isort>=5.12.0", "lizard>=1.17.0", "mermaid-py>=0.2.0", "mkdocs>=1.5.0", "mutmut>=2.4.0", "mypy>=1.8.0", "pandas>=2.1.0", "pre-commit>=3.5.0", "prometheus-client>=0.19.0", "pydoc-markdown>=4.8.0", "pydriller>=2.5.0", "pygments>=2.17.0", "pytest>=7.4.0", "pytest-benchmark>=4.0.0", "pytest-cov>=4.1.0", "radon>=6.0.0", "rope>=1.11.0", "sphinx>=7.2.0", "sqlalchemy>=2.0.0", "sqlparse>=0.4.4", "tree-sitter>=0.21.0", "tree-sitter-python>=0.21.0", "tree-sitter-javascript>=0.21.0", "tree-sitter-typescript>=0.21.0", "tree-sitter-go>=0.21.0", "tree-sitter-rust>=0.21.0", "tree-sitter-java>=0.21.0", "tree-sitter-cpp>=0.21.0", "tree-sitter-c>=0.21.0", "tree-sitter-ruby>=0.21.0", "tree-sitter-php>=0.21.0",]

claude_mpm-3.9.0/scripts/ticket

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Ticket Management Shell Wrapper for claude-mpm
+#
+# WHY: This shell script provides backward compatibility for users who use the
+# 'ticket' command directly from the shell. It delegates all operations to the
+# integrated claude-mpm tickets command.
+#
+# DESIGN DECISION: This thin wrapper maintains the existing shell interface while
+# delegating to the new claude-mpm tickets subcommands for consistency.
+
+# Find the project root
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+PROJECT_ROOT="$( cd "$SCRIPT_DIR/.." && pwd )"
+
+# Check if we should use local claude-mpm or installed version
+if [ -f "$PROJECT_ROOT/claude-mpm" ] && [ -d "$PROJECT_ROOT/src/claude_mpm" ]; then
+    # Use local development version
+    CLAUDE_MPM="$PROJECT_ROOT/claude-mpm"
+else
+    # Use installed version
+    CLAUDE_MPM="claude-mpm"
+fi
+
+# Check if claude-mpm is available
+if ! command -v "$CLAUDE_MPM" &> /dev/null && [ "$CLAUDE_MPM" = "claude-mpm" ]; then
+    echo "Error: claude-mpm not found. Please ensure it's installed and in your PATH."
+    echo "Install with: pip install claude-mpm"
+    exit 1
+fi
+
+# Delegate to claude-mpm tickets command
+# If no arguments or help requested, show help
+if [ $# -eq 0 ] || [ "$1" = "help" ] || [ "$1" = "--help" ] || [ "$1" = "-h" ]; then
+    exec "$CLAUDE_MPM" tickets --help
+else
+    # Pass all arguments to claude-mpm tickets
+    exec "$CLAUDE_MPM" tickets "$@"
+fi

claude_mpm-3.9.0/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+3.9.0