claude-mpm 4.20.3__py3-none-any.whl → 4.25.10__py3-none-any.whl

{claude_mpm-4.20.3.dist-info → claude_mpm-4.25.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.20.3
+Version: 4.25.10
 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
@@ -59,12 +59,7 @@ 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: ruff>=0.8.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"
@@ -82,48 +77,80 @@ 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: alembic>=1.13.0; extra == "agents"
+Requires-Dist: astroid>=3.0.0; extra == "agents"
+Requires-Dist: axe-selenium-python>=2.1.0; extra == "agents"
 Requires-Dist: bandit>=1.7.5; extra == "agents"
-Requires-Dist: black>=23.0.0; extra == "agents"
+Requires-Dist: beautifulsoup4>=4.12.0; extra == "agents"
+Requires-Dist: black>=24.0.0; extra == "agents"
+Requires-Dist: click>=8.1.0; extra == "agents"
 Requires-Dist: commitizen>=3.13.0; extra == "agents"
+Requires-Dist: coverage>=7.0.0; extra == "agents"
+Requires-Dist: csvkit>=1.3.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: flake8>=7.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: google-auth>=2.0.0; extra == "agents"
+Requires-Dist: google-cloud-core>=2.0.0; extra == "agents"
+Requires-Dist: hypothesis>=6.98.0; extra == "agents"
+Requires-Dist: isort>=5.13.0; extra == "agents"
+Requires-Dist: jinja2>=3.1.0; extra == "agents"
+Requires-Dist: jsonschema>=4.19.0; extra == "agents"
+Requires-Dist: libcst>=1.1.0; extra == "agents"
 Requires-Dist: lizard>=1.17.0; extra == "agents"
+Requires-Dist: lxml>=4.9.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: numpy>=1.24.0; extra == "agents"
+Requires-Dist: openpyxl>=3.1.0; extra == "agents"
 Requires-Dist: pandas>=2.1.0; extra == "agents"
+Requires-Dist: pathlib; extra == "agents"
+Requires-Dist: pillow>=9.0.0; extra == "agents"
+Requires-Dist: playwright>=1.40.0; extra == "agents"
+Requires-Dist: polars>=0.19.0; extra == "agents"
 Requires-Dist: pre-commit>=3.5.0; extra == "agents"
 Requires-Dist: prometheus-client>=0.19.0; extra == "agents"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "agents"
+Requires-Dist: pyarrow>=14.0.0; extra == "agents"
+Requires-Dist: pydantic>=2.6.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: pyjwt>=2.8.0; extra == "agents"
+Requires-Dist: pylint>=3.0.0; extra == "agents"
+Requires-Dist: pymongo>=4.5.0; extra == "agents"
+Requires-Dist: pymysql>=1.1.0; extra == "agents"
+Requires-Dist: pytest>=8.0.0; extra == "agents"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "agents"
 Requires-Dist: pytest-benchmark>=4.0.0; extra == "agents"
 Requires-Dist: pytest-cov>=4.1.0; extra == "agents"
+Requires-Dist: python-dateutil>=2.8.0; extra == "agents"
+Requires-Dist: pyyaml>=6.0; extra == "agents"
 Requires-Dist: radon>=6.0.0; extra == "agents"
+Requires-Dist: redis>=5.0.0; extra == "agents"
+Requires-Dist: requests>=2.31.0; extra == "agents"
+Requires-Dist: rich>=13.0.0; extra == "agents"
 Requires-Dist: rope>=1.11.0; extra == "agents"
+Requires-Dist: safety>=3.0.0; extra == "agents"
+Requires-Dist: semantic-version>=2.10.0; extra == "agents"
+Requires-Dist: semgrep>=1.45.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: tabulate>=0.9.0; 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"
+Requires-Dist: vaex>=4.17.0; extra == "agents"
+Requires-Dist: validators>=0.20.0; extra == "agents"
+Requires-Dist: xlrd>=2.0.0; extra == "agents"
+Requires-Dist: xlsxwriter>=3.1.0; extra == "agents"
+Requires-Dist: xlwt>=1.3.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"
@@ -144,20 +171,28 @@ 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"
+Provides-Extra: agents-load-testing
+Requires-Dist: locust>=2.15.0; extra == "agents-load-testing"
 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.
+> **⚠️ Important**: Claude MPM **requires Claude Code CLI** (v1.0.92+), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
+>
+> **Don't have Claude Code?** Install from: https://docs.anthropic.com/en/docs/claude-code
+>
+> **Version Requirements:**
+> - Minimum: v1.0.92 (hooks support)
+> - Recommended: v2.0.30+ (latest features)
 
-> **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
+> **Quick Start**: See [docs/user/getting-started.md](docs/user/getting-started.md) to get running in 5 minutes!
 
 ## Features
 
-- 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
-- 🎯 **Skills System**: 20 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
+- 🤖 **Multi-Agent System**: 37 specialized agents for comprehensive project management
+- 🎯 **Skills System**: 21 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📋 **Resume Log System**: Proactive context management with automatic 10k-token session logs at 70%/85%/95% thresholds
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
@@ -170,6 +205,23 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 
 ## Quick Installation
 
+### Prerequisites
+
+**Before installing Claude MPM**, ensure you have:
+
+1. **Python 3.8+** (3.11+ recommended)
+2. **Claude Code CLI v1.0.92+** (required!)
+
+```bash
+# Verify Claude Code is installed
+claude --version
+
+# If not installed, get it from:
+# https://docs.anthropic.com/en/docs/claude-code
+```
+
+### Install Claude MPM
+
 ```bash
 # Basic installation
 pip install claude-mpm
@@ -187,6 +239,17 @@ pipx install claude-mpm
 pipx install "claude-mpm[monitor]"
 ```
 
+### Verify Installation
+
+```bash
+# Check versions
+claude-mpm --version
+claude --version
+
+# Run diagnostics (checks Claude Code compatibility)
+claude-mpm doctor
+```
+
 **💡 Optional Dependencies**:
 - `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
 - `[mcp]` - Additional MCP services (mcp-browser, mcp-ticketer) - most users won't need this
@@ -264,7 +327,7 @@ claude-mpm verify
 
 **That's it!** These tools integrate automatically with Claude MPM once installed. No additional configuration needed.
 
-**That's it!** See [QUICKSTART.md](QUICKSTART.md) for immediate usage or [docs/user/installation.md](docs/user/installation.md) for advanced options.
+**That's it!** See [docs/user/getting-started.md](docs/user/getting-started.md) for immediate usage.
 
 ## Quick Usage
 
@@ -309,10 +372,134 @@ claude-mpm verify --json
 
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
+
+# Check for updates (including Claude Code compatibility)
+claude-mpm doctor --checks updates
+```
+
+**💡 Update Checking**: Claude MPM automatically checks for updates and verifies Claude Code compatibility on startup. Configure in `~/.claude-mpm/configuration.yaml` or see [docs/update-checking.md](docs/update-checking.md).
+
+See [docs/user/getting-started.md](docs/user/getting-started.md) for complete usage examples.
+
+## Skills Deployment
+
+Claude MPM includes intelligent skills deployment with **multi-collection support**:
+
+- **Multiple Sources**: Add skills from different GitHub repositories
+- **Automatic Detection**: Analyzes your project's technology stack
+- **Smart Recommendations**: Research agent suggests relevant skills
+- **Git-Based Updates**: Clone on first install, pull on updates
+- **Easy Management**: Simple CLI commands for all operations
+
+### Quick Start
+
+```bash
+# Deploy from default collection
+claude-mpm skills deploy-github --toolchain python
+
+# Add new collection
+claude-mpm skills collection-add obra-superpowers https://github.com/obra/superpowers
+
+# Deploy from specific collection
+claude-mpm skills deploy-github --collection obra-superpowers
+
+# List all collections
+claude-mpm skills collection-list
 ```
 
-See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
+### Multi-Collection Management
+
+**Add Collections**:
+```bash
+# Add obra's superpowers collection
+claude-mpm skills collection-add obra-superpowers https://github.com/obra/superpowers --priority 2
+
+# Add company internal skills
+claude-mpm skills collection-add internal https://github.com/yourcompany/internal-skills
+```
+
+**Deploy from Collections**:
+```bash
+# Deploy from specific collection
+claude-mpm skills deploy-github --collection obra-superpowers --toolchain python
+
+# Deploy from default collection
+claude-mpm skills deploy-github --categories testing
+```
+
+**Manage Collections**:
+```bash
+# List all collections (shows priority, status, last update)
+claude-mpm skills collection-list
+
+# Enable/disable collections
+claude-mpm skills collection-disable claude-mpm
+claude-mpm skills collection-enable claude-mpm
+
+# Set default collection
+claude-mpm skills collection-set-default obra-superpowers
+```
+
+### Git-Based Deployment
+
+Collections are managed as git repositories:
+- **First install**: Runs `git clone` to `~/.claude/skills/<collection-name>/`
+- **Updates**: Runs `git pull` in existing repository
+- **Benefits**: Version history, rollback capability, always latest skills
+
+### How It Works
+
+1. **Research Agent Analyzes Project**
+   - Scans configuration files (package.json, pyproject.toml, etc.)
+   - Detects frameworks (FastAPI, React, Next.js, etc.)
+   - Identifies testing tools (pytest, Playwright, Jest, etc.)
+   - Discovers infrastructure patterns (Docker, GitHub Actions, etc.)
+
+2. **Skill Gap Detection**
+   - Compares detected technologies to deployed skills
+   - Identifies missing skills that would improve workflow
+   - Prioritizes recommendations (high/medium/low)
+
+3. **Proactive Recommendations**
+   - During project initialization
+   - When new technologies are added
+   - When specific work types begin (testing, debugging, deployment)
+   - When quality issues are detected
+
+### Example: Python FastAPI Project
+
+```markdown
+Research Agent Analysis:
+Technology Stack Detected: Python 3.11, FastAPI, pytest, Docker, GitHub Actions
+
+Recommended Skills:
+- test-driven-development (high priority) - TDD workflow enforcement
+- backend-engineer (high priority) - API design patterns
+- docker-workflow (medium priority) - Container best practices
+- ci-cd-pipeline-builder (medium priority) - GitHub Actions optimization
+
+Deploy with:
+claude-mpm skills deploy-github --toolchain python
+```
+
+### Technology → Skills Mapping
+
+| Your Technology | Recommended Skills |
+|-----------------|-------------------|
+| Python + pytest | test-driven-development, python-style |
+| FastAPI/Flask | backend-engineer |
+| React/Next.js | frontend-development, web-frameworks |
+| Docker | docker-workflow |
+| GitHub Actions | ci-cd-pipeline-builder |
+| Playwright | webapp-testing |
+
+### Important Notes
 
+- Skills load at Claude Code STARTUP ONLY - restart required after deployment
+- Batch deploy related skills to minimize restarts
+- Research agent automatically recommends skills during analysis
+- See [Skills Deployment Guide](docs/guides/skills-deployment-guide.md) for comprehensive details
+- See [Skills Quick Reference](docs/reference/skills-quick-reference.md) for command reference
 
 ## Architecture (v4.4.1)
 
@@ -502,7 +689,7 @@ See [docs/user/resume-logs.md](docs/user/resume-logs.md) for complete documentat
 ### 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.
+See [docs/reference/MEMORY.md](docs/reference/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
 ## 📚 Documentation
@@ -515,7 +702,7 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 - **[🚀 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
+- **[❓ FAQ](docs/guides/FAQ.md)** - Common questions answered
 
 #### 💻 For Developers
 - **[🏗️ Architecture Overview](docs/developer/ARCHITECTURE.md)** - Service-oriented system design
@@ -582,7 +769,7 @@ The project uses automated code formatting and quality checks:
 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.
+Contributions are welcome! Please see our [project structure guide](docs/reference/STRUCTURE.md) and follow the established patterns.
 
 **Development Workflow**:
 1. Run `make dev-complete` to set up your environment
@@ -590,7 +777,7 @@ Contributions are welcome! Please see our [project structure guide](docs/STRUCTU
 3. All code must pass quality checks before merging
 
 ### Project Structure
-See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
+See [docs/reference/STRUCTURE.md](docs/reference/STRUCTURE.md) for codebase organization.
 
 ### License
 MIT License - see [LICENSE](LICENSE) file.