claude-mpm 4.5.8__tar.gz → 4.5.12__tar.gz

claude_mpm-4.5.12/BUILD_NUMBER

@@ -0,0 +1 @@
+419

claude_mpm-4.5.12/PKG-INFO

@@ -0,0 +1,416 @@
+Metadata-Version: 2.4
+Name: claude-mpm
+Version: 4.5.12
+Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
+Author-email: Bob Matsuoka <bob@matsuoka.com>
+Maintainer: Claude MPM Team
+License: MIT
+Project-URL: Homepage, https://github.com/bobmatnyc/claude-mpm
+Project-URL: Repository, https://github.com/bobmatnyc/claude-mpm.git
+Project-URL: Issues, https://github.com/bobmatnyc/claude-mpm/issues
+Project-URL: Documentation, https://github.com/bobmatnyc/claude-mpm/blob/main/README.md
+Keywords: claude,orchestration,multi-agent,ticket-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ai-trackdown-pytools>=1.4.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: pexpect>=4.8.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: flask>=3.0.0
+Requires-Dist: flask-cors>=4.0.0
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: python-socketio>=5.11.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: aiohttp-cors<0.8.0,>=0.7.0
+Requires-Dist: python-engineio>=4.8.0
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: mistune>=3.0.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: ijson>=3.2.0
+Requires-Dist: toml>=0.10.2
+Requires-Dist: packaging>=21.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pyee>=13.0.0
+Requires-Dist: importlib-resources>=5.0; python_version < "3.9"
+Requires-Dist: pathspec>=0.11.0
+Provides-Extra: mcp
+Requires-Dist: mcp>=0.1.0; extra == "mcp"
+Requires-Dist: mcp-vector-search>=0.1.0; extra == "mcp"
+Requires-Dist: mcp-browser>=0.1.0; extra == "mcp"
+Requires-Dist: mcp-ticketer>=0.1.0; extra == "mcp"
+Requires-Dist: kuzu-memory>=1.1.5; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: flake8-import-order; extra == "dev"
+Requires-Dist: flake8-tidy-imports; extra == "dev"
+Requires-Dist: flake8-bugbear; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: pylint>=3.0.0; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Requires-Dist: types-requests>=2.25.0; 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
+Requires-Dist: python-socketio>=5.11.0; extra == "monitor"
+Requires-Dist: aiohttp>=3.9.0; extra == "monitor"
+Requires-Dist: aiohttp-cors<0.8.0,>=0.7.0; extra == "monitor"
+Requires-Dist: python-engineio>=4.8.0; extra == "monitor"
+Requires-Dist: aiofiles>=23.0.0; extra == "monitor"
+Requires-Dist: websockets>=12.0; extra == "monitor"
+Provides-Extra: agents
+Requires-Dist: bandit>=1.7.5; extra == "agents"
+Requires-Dist: black>=23.0.0; extra == "agents"
+Requires-Dist: commitizen>=3.13.0; extra == "agents"
+Requires-Dist: dask>=2023.12.0; extra == "agents"
+Requires-Dist: detect-secrets>=1.4.0; extra == "agents"
+Requires-Dist: diagrams>=0.23.0; extra == "agents"
+Requires-Dist: docstring-parser>=0.15.0; extra == "agents"
+Requires-Dist: faker>=20.0.0; extra == "agents"
+Requires-Dist: gitlint>=0.19.0; extra == "agents"
+Requires-Dist: gitpython>=3.1.40; extra == "agents"
+Requires-Dist: hypothesis>=6.92.0; extra == "agents"
+Requires-Dist: isort>=5.12.0; extra == "agents"
+Requires-Dist: lizard>=1.17.0; extra == "agents"
+Requires-Dist: mermaid-py>=0.2.0; extra == "agents"
+Requires-Dist: mkdocs>=1.5.0; extra == "agents"
+Requires-Dist: mutmut>=2.4.0; extra == "agents"
+Requires-Dist: mypy>=1.8.0; extra == "agents"
+Requires-Dist: pandas>=2.1.0; extra == "agents"
+Requires-Dist: pre-commit>=3.5.0; extra == "agents"
+Requires-Dist: prometheus-client>=0.19.0; extra == "agents"
+Requires-Dist: pydoc-markdown>=4.8.0; extra == "agents"
+Requires-Dist: pydriller>=2.5.0; extra == "agents"
+Requires-Dist: pygments>=2.17.0; extra == "agents"
+Requires-Dist: pytest>=7.4.0; extra == "agents"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "agents"
+Requires-Dist: pytest-cov>=4.1.0; extra == "agents"
+Requires-Dist: radon>=6.0.0; extra == "agents"
+Requires-Dist: rope>=1.11.0; extra == "agents"
+Requires-Dist: sphinx>=7.2.0; extra == "agents"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "agents"
+Requires-Dist: sqlparse>=0.4.4; extra == "agents"
+Requires-Dist: tree-sitter>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-python>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-javascript>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-typescript>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-go>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-rust>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-java>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-cpp>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-c>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-ruby>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-php>=0.21.0; extra == "agents"
+Provides-Extra: data-processing
+Requires-Dist: pandas>=2.1.0; extra == "data-processing"
+Requires-Dist: openpyxl>=3.1.0; extra == "data-processing"
+Requires-Dist: xlsxwriter>=3.1.0; extra == "data-processing"
+Requires-Dist: numpy>=1.24.0; extra == "data-processing"
+Requires-Dist: pyarrow>=14.0.0; extra == "data-processing"
+Requires-Dist: dask>=2023.12.0; extra == "data-processing"
+Requires-Dist: polars>=0.19.0; extra == "data-processing"
+Requires-Dist: xlrd>=2.0.0; extra == "data-processing"
+Requires-Dist: xlwt>=1.3.0; extra == "data-processing"
+Requires-Dist: csvkit>=1.3.0; extra == "data-processing"
+Requires-Dist: tabulate>=0.9.0; extra == "data-processing"
+Requires-Dist: python-dateutil>=2.8.0; extra == "data-processing"
+Requires-Dist: lxml>=4.9.0; extra == "data-processing"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "data-processing"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "data-processing"
+Requires-Dist: pymongo>=4.5.0; extra == "data-processing"
+Requires-Dist: redis>=5.0.0; extra == "data-processing"
+Requires-Dist: beautifulsoup4>=4.12.0; extra == "data-processing"
+Requires-Dist: jsonschema>=4.19.0; extra == "data-processing"
+Dynamic: license-file
+
+# Claude MPM - Multi-Agent Project Manager
+
+A powerful orchestration framework for **Claude Code (CLI)** that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
+
+> **⚠️ Important**: Claude MPM extends **Claude Code (CLI)**, not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
+
+> **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
+
+## Features
+
+- 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
+- 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
+- 🔄 **Session Management**: Resume previous sessions with `--resume`
+- 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
+- 🔌 **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
+- 📁 **Multi-Project Support**: Per-session working directories with persistent knowledge graphs
+- 🔍 **Git Integration**: View diffs and track changes across projects
+- 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
+- ⚡ **Simplified Architecture**: ~3,700 lines removed for better performance and maintainability
+- 🔒 **Enhanced Security**: Comprehensive input validation and sanitization framework
+
+## Quick Installation
+
+```bash
+# Basic installation
+pip install claude-mpm
+
+# Install with optional MCP services (recommended)
+pip install "claude-mpm[mcp]"
+```
+
+Or with pipx (recommended for isolated installation):
+```bash
+# Basic installation
+pipx install claude-mpm
+
+# Install with optional MCP services (recommended)
+pipx install "claude-mpm[mcp]"
+
+# Install with all features
+pipx install "claude-mpm[mcp,monitor]"
+
+# Configure MCP for pipx users:
+claude-mpm mcp-pipx-config
+```
+
+**💡 Optional Dependencies**:
+- `[mcp]` - Include MCP services (mcp-vector-search, mcp-browser, mcp-ticketer, kuzu-memory)
+- `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
+- **Combine both**: Use `"claude-mpm[mcp,monitor]"` to install all features
+- Without optional dependencies, MCP services auto-install on first use via pipx
+
+**🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
+- ✅ Socket.IO daemon script path resolution (fixed)
+- ✅ Commands directory access (fixed) 
+- ✅ Resource files properly packaged for pipx environments
+- ✅ Python 3.13+ fully supported
+
+**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
+
+# Use MCP Gateway for external tool integration
+claude-mpm mcp
+
+# Run comprehensive health diagnostics
+claude-mpm doctor
+
+# Generate detailed diagnostic report with MCP service analysis
+claude-mpm doctor --verbose --output-file doctor-report.md
+
+# Run specific diagnostic checks including MCP services
+claude-mpm doctor --checks installation configuration agents mcp
+
+# Check MCP service status specifically
+claude-mpm doctor --checks mcp --verbose
+
+# Verify MCP services installation and configuration
+claude-mpm verify
+
+# Auto-fix MCP service issues
+claude-mpm verify --fix
+
+# Verify specific service
+claude-mpm verify --service kuzu-memory
+
+# Get JSON output for automation
+claude-mpm verify --json
+
+# Manage memory for large conversation histories
+claude-mpm cleanup-memory
+```
+
+See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
+
+
+## Architecture (v4.4.1)
+
+Following Phase 3 architectural simplification in v4.4.1, Claude MPM features:
+
+- **Streamlined Rich Interface**: Removed complex TUI system (~2,500 lines) for cleaner user experience
+- **Optional MCP Services**: mcp-vector-search and kuzu-memory with automatic fallback installation
+- **Persistent Knowledge System**: Project-specific kuzu-memory databases with intelligent prompt enrichment
+- **Service-Oriented Architecture**: Simplified five specialized service domains
+- **Interface-Based Contracts**: All services implement explicit interfaces
+- **Enhanced Performance**: ~3,700 lines removed for better startup time and maintainability
+- **Enhanced Security**: Comprehensive input validation and sanitization framework
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed architecture information.
+
+## Key Capabilities
+
+### Multi-Agent Orchestration
+
+Claude MPM includes 15 specialized agents:
+
+#### Core Development
+- **Engineer** - Software development and implementation
+- **Research** - Code analysis and research  
+- **Documentation** - Documentation creation and maintenance
+- **QA** - Testing and quality assurance
+- **Security** - Security analysis and implementation
+
+#### Operations & Infrastructure
+- **Ops** - Operations and deployment with advanced git commit authority and security verification (v2.2.2+)
+- **Version Control** - Git and version management
+- **Data Engineer** - Data pipeline and ETL development
+
+#### Web Development
+- **Web UI** - Frontend and UI development
+- **Web QA** - Web testing and E2E validation
+
+#### Project Management
+- **Ticketing** - Issue tracking and management
+- **Project Organizer** - File organization and structure
+- **Memory Manager** - Project memory and context management
+
+#### Code Quality
+- **Refactoring Engineer** - Code refactoring and optimization
+- **Code Analyzer** - Static code analysis with AST and tree-sitter
+
+### Agent Memory System
+Agents learn project-specific patterns using a simple list format and can update memories via JSON response fields (`remember` for incremental updates, `MEMORIES` for complete replacement). Initialize with `claude-mpm memory init`.
+
+### MCP Gateway (Model Context Protocol)
+
+Claude MPM includes a powerful MCP Gateway that enables:
+- Integration with external tools and services
+- Custom tool development
+- Protocol-based communication
+- Extensible architecture
+
+See [MCP Gateway Documentation](docs/developer/13-mcp-gateway/README.md) for details.
+
+### Memory Management
+
+Large conversation histories can consume 2GB+ of memory. Use the `cleanup-memory` command to manage Claude conversation history:
+
+```bash
+# Clean up old conversation history
+claude-mpm cleanup-memory
+
+# Keep only recent conversations
+claude-mpm cleanup-memory --days 7
+```
+
+### 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
+
+**👉 [Complete Documentation Hub](docs/README.md)** - Start here for all documentation!
+
+### Quick Links by User Type
+
+#### 👥 For Users
+- **[🚀 5-Minute Quick Start](docs/user/quickstart.md)** - Get running immediately
+- **[📦 Installation Guide](docs/user/installation.md)** - All installation methods
+- **[📖 User Guide](docs/user/README.md)** - Complete user documentation
+- **[❓ FAQ](docs/user/faq.md)** - Common questions answered
+
+#### 💻 For Developers
+- **[🏗️ Architecture Overview](docs/developer/ARCHITECTURE.md)** - Service-oriented system design
+- **[💻 Developer Guide](docs/developer/README.md)** - Complete development documentation
+- **[🧪 Contributing](docs/developer/03-development/README.md)** - How to contribute
+- **[📊 API Reference](docs/API.md)** - Complete API documentation
+
+#### 🤖 For Agent Creators
+- **[🤖 Agent System](docs/AGENTS.md)** - Complete agent development guide
+- **[📝 Creation Guide](docs/developer/07-agent-system/creation-guide.md)** - Step-by-step tutorials
+- **[📋 Schema Reference](docs/developer/10-schemas/agent_schema_documentation.md)** - Agent format specifications
+
+#### 🚀 For Operations
+- **[🚀 Deployment](docs/DEPLOYMENT.md)** - Release management & versioning
+- **[📊 Monitoring](docs/MONITOR.md)** - Real-time dashboard & metrics
+- **[🐛 Troubleshooting](docs/TROUBLESHOOTING.md)** - Enhanced `doctor` command with detailed reports and auto-fix capabilities
+
+### 🎯 Documentation Features
+- **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub
+- **Clear User Paths**: Organized by user type and experience level
+- **Cross-Referenced**: Links between related topics and sections
+- **Up-to-Date**: Version 4.3.3 with current information
+
+## Recent Updates (v4.3.3)
+
+**Enhanced PM Instructions**: PM2 deployment support and mandatory web-qa verification for quality assurance.
+
+**Improved Version Management**: Better version comparison logic and agent override warnings for smoother operations.
+
+**Code Quality Improvements**: Auto-fix code formatting and import management with enhanced standard tools recognition.
+
+**Documentation Overhaul**: Unified documentation architecture with single entry point and clear navigation paths.
+
+**Performance Enhancements**: Continued 50-80% performance improvements through intelligent caching and lazy loading.
+
+See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/user/MIGRATION.md](docs/user/MIGRATION.md) for upgrade instructions.
+
+## Development
+
+### Quick Development Setup
+```bash
+# Complete development setup with code formatting and quality tools
+make dev-complete
+
+# Or step by step:
+make setup-dev          # Install in development mode
+make setup-pre-commit    # Set up automated code formatting
+```
+
+### Code Quality & Formatting
+The project uses automated code formatting and quality checks:
+- **Black** for code formatting
+- **isort** for import sorting
+- **flake8** for linting
+- **mypy** for type checking
+- **Pre-commit hooks** for automatic enforcement
+
+See [docs/developer/CODE_FORMATTING.md](docs/developer/CODE_FORMATTING.md) for details.
+
+### Contributing
+Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
+
+**Development Workflow**:
+1. Run `make dev-complete` to set up your environment
+2. Code formatting happens automatically on commit
+3. All code must pass quality checks before merging
+
+### 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 (CLI)](https://docs.anthropic.com/en/docs/claude-code) integration
+- Built with ❤️ by the Claude MPM community

claude_mpm-4.5.12/VERSION

@@ -0,0 +1 @@
+4.5.12

claude_mpm-4.5.12/pyproject.toml

@@ -0,0 +1,110 @@
+[build-system]
+requires = [ "setuptools>=61.0", "wheel",]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude-mpm"
+version = "4.5.12"
+description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
+readme = "README.md"
+requires-python = ">=3.8"
+keywords = [ "claude", "orchestration", "multi-agent", "ticket-management",]
+classifiers = [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "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", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "aiofiles>=23.0.0", "websockets>=12.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "tree-sitter>=0.21.0", "ijson>=3.2.0", "toml>=0.10.2", "packaging>=21.0", "pydantic>=2.0.0", "pydantic-settings>=2.0.0", "rich>=13.0.0", "pyee>=13.0.0", "importlib-resources>=5.0; python_version < '3.9'", "pathspec>=0.11.0",]
+[[project.authors]]
+name = "Bob Matsuoka"
+email = "bob@matsuoka.com"
+
+[[project.maintainers]]
+name = "Claude MPM Team"
+
+[project.license]
+text = "MIT"
+
+[project.urls]
+Homepage = "https://github.com/bobmatnyc/claude-mpm"
+Repository = "https://github.com/bobmatnyc/claude-mpm.git"
+Issues = "https://github.com/bobmatnyc/claude-mpm/issues"
+Documentation = "https://github.com/bobmatnyc/claude-mpm/blob/main/README.md"
+
+[project.optional-dependencies]
+mcp = [ "mcp>=0.1.0", "mcp-vector-search>=0.1.0", "mcp-browser>=0.1.0", "mcp-ticketer>=0.1.0", "kuzu-memory>=1.1.5",]  # 1.1.5+ required for MCP server stdout fix (redirects startup messages to stderr)
+dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "flake8-import-order", "flake8-tidy-imports", "flake8-bugbear", "ruff>=0.1.0", "pylint>=3.0.0", "pre-commit", "mypy>=1.0.0", "types-PyYAML>=6.0.0", "types-requests>=2.25.0",]
+docs = [ "sphinx>=7.2.0", "sphinx-rtd-theme>=1.3.0", "sphinx-autobuild>=2021.3.14",]
+monitor = [ "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "aiofiles>=23.0.0", "websockets>=12.0",]
+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",]
+data-processing = [ "pandas>=2.1.0", "openpyxl>=3.1.0", "xlsxwriter>=3.1.0", "numpy>=1.24.0", "pyarrow>=14.0.0", "dask>=2023.12.0", "polars>=0.19.0", "xlrd>=2.0.0", "xlwt>=1.3.0", "csvkit>=1.3.0", "tabulate>=0.9.0", "python-dateutil>=2.8.0", "lxml>=4.9.0", "sqlalchemy>=2.0.0", "psycopg2-binary>=2.9.0", "pymongo>=4.5.0", "redis>=5.0.0", "beautifulsoup4>=4.12.0", "jsonschema>=4.19.0",]
+
+[project.scripts]
+claude-mpm = "claude_mpm.cli:main"
+claude-mpm-ticket = "claude_mpm.cli.ticket_cli:main"
+ticket = "claude_mpm.cli.ticket_cli:main"
+claude-mpm-version = "claude_mpm.scripts.manage_version:main"
+claude-mpm-monitor = "claude_mpm.scripts.launch_monitor:main"
+claude-mpm-socketio = "claude_mpm.scripts.socketio_daemon:main"
+claude-mpm-mcp = "claude_mpm.services.mcp_gateway.server.stdio_server:main_sync"
+claude-mpm-mcp-wrapper = "claude_mpm.scripts.mcp_wrapper:entry_point"
+claude-mpm-doctor = "claude_mpm.scripts.mpm_doctor:main"
+
+[tool.uv]
+dev-dependencies = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy>=1.0.0", "types-PyYAML>=6.0.0", "types-requests>=2.25.0",]
+
+[tool.black]
+line-length = 88
+target-version = [ "py38",]
+
+[tool.isort]
+profile = "black"
+line_length = 88
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[tool.ruff]
+line-length = 88
+target-version = "py38"
+select = [ "F", "E", "W", "I", "F401", "F811", "F821", "F823",]
+ignore = [ "E203", "E501",]
+exclude = [ ".git", "__pycache__", ".venv", "venv", "build", "dist", "*.egg-info", ".pytest_cache", ".mypy_cache", "node_modules",]
+
+[tool.pylint]
+max-line-length = 88
+disable = [ "C0111", "C0103", "R0903", "R0913", "W0212",]
+enable = [ "duplicate-code", "reimported", "import-self", "cyclic-import", "wrong-import-order", "ungrouped-imports", "wrong-import-position",]
+min-similarity-lines = 4
+ignore-comments = true
+ignore-docstrings = true
+ignore-imports = false
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "4.5.12"
+version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_incremental = true
+
+[tool.ruff.per-file-ignores]
+"__init__.py" = [ "F401", "F403",]
+"tests/*" = [ "F403", "F405",]
+
+[tool.setuptools.package-data]
+claude_mpm = [ "VERSION", "BUILD_NUMBER", "scripts/*", "scripts/*.sh", "commands/*.md", "dashboard/*.html", "dashboard/templates/*.html", "dashboard/static/*.css", "dashboard/static/*.js", "dashboard/static/css/*.css", "dashboard/static/js/*.js", "dashboard/static/js/components/*.js", "agents/*.md", "agents/*.json", "agents/*.yaml", "agents/templates/*.json", "agents/schema/*.json", "hooks/**/*.py", "hooks/**/*.sh", "hooks/claude_hooks/*", "hooks/claude_hooks/**/*",]
+
+[tool.pytest.ini_options]
+testpaths = [ "tests",]
+python_files = [ "test_*.py", "*_test.py",]
+python_classes = [ "Test*",]
+python_functions = [ "test_*",]
+addopts = [ "-v", "--tb=short", "--strict-markers", "--disable-warnings", "--asyncio-mode=auto",]
+markers = [ "unit: Unit tests", "integration: Integration tests", "e2e: End-to-end tests", "regression: Regression tests", "socketio: Socket.IO related tests", "hook: Hook system tests",]
+asyncio_mode = "auto"
+
+[tool.setuptools.packages.find]
+where = [ "src",]
+
+[tool.setuptools.dynamic.version]
+file = "VERSION"

claude_mpm-4.5.12/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.5.12

claude_mpm-4.5.12/src/claude_mpm/__init__.py

@@ -0,0 +1,60 @@
+"""Claude MPM - Multi-Agent Project Manager."""
+
+from pathlib import Path
+
+# Get version from VERSION file - single source of truth
+# Try package VERSION file first (for installed packages)
+package_version_file = Path(__file__).parent / "VERSION"
+if package_version_file.exists():
+    __version__ = package_version_file.read_text().strip()
+else:
+    # Fall back to project root VERSION file (for development)
+    root_version_file = Path(__file__).parent.parent.parent / "VERSION"
+    if root_version_file.exists():
+        __version__ = root_version_file.read_text().strip()
+    else:
+        # Default version if VERSION file is missing
+        __version__ = "0.0.0"
+
+# For development builds, append build number if available (PEP 440 format)
+# This creates versions like "3.9.5+build.275" for local development
+try:
+    build_file = Path(__file__).parent.parent.parent / "BUILD_NUMBER"
+    if build_file.exists():
+        build_number = build_file.read_text().strip()
+        if build_number.isdigit():
+            # Use PEP 440 local version identifier format for development
+            __version__ = f"{__version__}+build.{build_number}"
+except Exception:
+    # Ignore any errors reading build number
+    pass
+
+__author__ = "Claude MPM Team"
+
+
+# Lazy imports for main components to avoid loading heavy dependencies
+# when only importing from submodules (e.g., core.logging_utils)
+# This significantly improves hook handler performance
+def __getattr__(name):
+    """Lazy load main components only when accessed."""
+    if name == "ClaudeRunner":
+        from .core.claude_runner import ClaudeRunner
+
+        return ClaudeRunner
+    if name == "MPMOrchestrator":
+        # For backwards compatibility
+        from .core.claude_runner import ClaudeRunner
+
+        return ClaudeRunner
+    if name == "TicketManager":
+        from .services.ticket_manager import TicketManager
+
+        return TicketManager
+    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+
+__all__ = [
+    "ClaudeRunner",
+    "MPMOrchestrator",
+    "TicketManager",
+]