claude-mpm 3.9.11__tar.gz → 4.0.4__tar.gz

{claude_mpm-3.9.11 → claude_mpm-4.0.4}/LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

{claude_mpm-3.9.11 → claude_mpm-4.0.4}/MANIFEST.in

@@ -41,4 +41,4 @@ global-exclude __pycache__
 global-exclude *.py[co]
 global-exclude .DS_Store
 recursive-exclude tests *
-recursive-exclude docs *
+recursive-exclude docs *

{claude_mpm-3.9.11/src/claude_mpm.egg-info → claude_mpm-4.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.9.11
+Version: 4.0.4
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -46,6 +46,7 @@ Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: sphinx>=7.2.0; extra == "docs"
 Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
@@ -107,14 +108,16 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 
 ## Features
 
-- 🤖 **Multi-Agent System**: Automatically delegates tasks to specialized agents (PM, Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, Version Control)
+- 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
 - 🧠 **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
-- 🛡️ **Memory Guardian (Experimental)**: Automatic memory monitoring and intelligent restarts to prevent crashes
+- 🔌 **MCP Gateway**: Model Context Protocol integration for extensible tool capabilities
 - 📁 **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
+- ⚡ **50-80% Performance Improvement**: Through intelligent caching and lazy loading
+- 🔒 **Enhanced Security**: Comprehensive input validation and sanitization framework
 
 ## Quick Installation
 
@@ -133,46 +136,88 @@ claude-mpm
 # Start with monitoring dashboard
 claude-mpm run --monitor
 
-# Start with memory protection (prevents crashes from large conversations)
-claude-mpm run-guarded
+# Use MCP Gateway for external tool integration
+claude-mpm mcp
+
+# Manage memory for large conversation histories
+claude-mpm cleanup-memory
 ```
 
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
 
-## Architecture
+## Architecture (v3.8.2+)
+
+Following the TSK-0053 refactoring, Claude MPM features:
 
-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.
+- **Service-Oriented Architecture**: Five specialized service domains
+- **Interface-Based Contracts**: All services implement explicit interfaces
+- **Dependency Injection**: Service container with automatic resolution
+- **50-80% Performance Improvement**: Through lazy loading and intelligent caching
+- **Enhanced Security**: Comprehensive input validation and sanitization framework
 
 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.
+
+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
+- **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 and remember insights across sessions. Initialize with `claude-mpm memory init`.
 
-### Memory Guardian System (Experimental)
-**⚠️ Beta Feature** - Prevents memory-related crashes through intelligent monitoring and automatic restarts with state preservation.
+### MCP Gateway (Model Context Protocol)
 
-```bash
-# Start with memory protection (recommended for long sessions)
-claude-mpm run-guarded --accept-experimental
+Claude MPM includes a powerful MCP Gateway that enables:
+- Integration with external tools and services
+- Custom tool development
+- Protocol-based communication
+- Extensible architecture
 
-# Custom memory threshold for your system
-claude-mpm run-guarded --memory-threshold 16000 --accept-experimental  # 16GB
-```
+See [MCP Gateway Documentation](docs/developer/13-mcp-gateway/README.md) for details.
 
-**Why Memory Guardian?** Large conversation histories can consume 2GB+ of memory, causing system instability. The Memory Guardian monitors memory usage and performs controlled restarts while preserving your conversation context and work progress.
+### Memory Management
 
-**Note:** This is an experimental feature in beta. Use `--accept-experimental` to suppress warnings.
+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), [docs/USER_GUIDE_MEMORY_GUARDIAN.md](docs/USER_GUIDE_MEMORY_GUARDIAN.md), and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
+See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
 ## Documentation
@@ -182,15 +227,13 @@ See [docs/MEMORY.md](docs/MEMORY.md), [docs/USER_GUIDE_MEMORY_GUARDIAN.md](docs/
 - **[Installation Guide](docs/user/installation.md)** - Complete installation options
 - **[User Guide](docs/user/)** - Detailed usage documentation
 - **[Memory System](docs/MEMORY.md)** - Agent memory documentation
-- **[Memory Guardian Guide](docs/USER_GUIDE_MEMORY_GUARDIAN.md)** - Comprehensive memory protection 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
-- **[Memory Guardian Technical](docs/MEMORY_GUARDIAN_TECHNICAL.md)** - Technical architecture and implementation details
-- **[Memory Guardian Configuration](docs/MEMORY_GUARDIAN_CONFIG.md)** - Complete configuration reference
+- **[MCP Gateway Guide](docs/developer/13-mcp-gateway/README.md)** - Model Context Protocol integration
 - **[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
@@ -210,9 +253,34 @@ See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/M
 
 ## 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.
 

{claude_mpm-3.9.11 → claude_mpm-4.0.4}/README.md

@@ -6,14 +6,16 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 
 ## Features
 
-- 🤖 **Multi-Agent System**: Automatically delegates tasks to specialized agents (PM, Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, Version Control)
+- 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
 - 🧠 **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
-- 🛡️ **Memory Guardian (Experimental)**: Automatic memory monitoring and intelligent restarts to prevent crashes
+- 🔌 **MCP Gateway**: Model Context Protocol integration for extensible tool capabilities
 - 📁 **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
+- ⚡ **50-80% Performance Improvement**: Through intelligent caching and lazy loading
+- 🔒 **Enhanced Security**: Comprehensive input validation and sanitization framework
 
 ## Quick Installation
 
@@ -32,46 +34,88 @@ claude-mpm
 # Start with monitoring dashboard
 claude-mpm run --monitor
 
-# Start with memory protection (prevents crashes from large conversations)
-claude-mpm run-guarded
+# Use MCP Gateway for external tool integration
+claude-mpm mcp
+
+# Manage memory for large conversation histories
+claude-mpm cleanup-memory
 ```
 
 See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 
 
-## Architecture
+## Architecture (v3.8.2+)
+
+Following the TSK-0053 refactoring, Claude MPM features:
 
-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.
+- **Service-Oriented Architecture**: Five specialized service domains
+- **Interface-Based Contracts**: All services implement explicit interfaces
+- **Dependency Injection**: Service container with automatic resolution
+- **50-80% Performance Improvement**: Through lazy loading and intelligent caching
+- **Enhanced Security**: Comprehensive input validation and sanitization framework
 
 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.
+
+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
+- **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 and remember insights across sessions. Initialize with `claude-mpm memory init`.
 
-### Memory Guardian System (Experimental)
-**⚠️ Beta Feature** - Prevents memory-related crashes through intelligent monitoring and automatic restarts with state preservation.
+### MCP Gateway (Model Context Protocol)
 
-```bash
-# Start with memory protection (recommended for long sessions)
-claude-mpm run-guarded --accept-experimental
+Claude MPM includes a powerful MCP Gateway that enables:
+- Integration with external tools and services
+- Custom tool development
+- Protocol-based communication
+- Extensible architecture
 
-# Custom memory threshold for your system
-claude-mpm run-guarded --memory-threshold 16000 --accept-experimental  # 16GB
-```
+See [MCP Gateway Documentation](docs/developer/13-mcp-gateway/README.md) for details.
 
-**Why Memory Guardian?** Large conversation histories can consume 2GB+ of memory, causing system instability. The Memory Guardian monitors memory usage and performs controlled restarts while preserving your conversation context and work progress.
+### Memory Management
 
-**Note:** This is an experimental feature in beta. Use `--accept-experimental` to suppress warnings.
+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), [docs/USER_GUIDE_MEMORY_GUARDIAN.md](docs/USER_GUIDE_MEMORY_GUARDIAN.md), and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
+See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
 
 
 ## Documentation
@@ -81,15 +125,13 @@ See [docs/MEMORY.md](docs/MEMORY.md), [docs/USER_GUIDE_MEMORY_GUARDIAN.md](docs/
 - **[Installation Guide](docs/user/installation.md)** - Complete installation options
 - **[User Guide](docs/user/)** - Detailed usage documentation
 - **[Memory System](docs/MEMORY.md)** - Agent memory documentation
-- **[Memory Guardian Guide](docs/USER_GUIDE_MEMORY_GUARDIAN.md)** - Comprehensive memory protection 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
-- **[Memory Guardian Technical](docs/MEMORY_GUARDIAN_TECHNICAL.md)** - Technical architecture and implementation details
-- **[Memory Guardian Configuration](docs/MEMORY_GUARDIAN_CONFIG.md)** - Complete configuration reference
+- **[MCP Gateway Guide](docs/developer/13-mcp-gateway/README.md)** - Model Context Protocol integration
 - **[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
@@ -109,9 +151,34 @@ See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/M
 
 ## 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.
 

claude_mpm-4.0.4/VERSION

@@ -0,0 +1 @@
+4.0.4

{claude_mpm-3.9.11 → claude_mpm-4.0.4}/claude-mpm

@@ -26,7 +26,7 @@ elif command -v claude-mpm &> /dev/null; then
     FOUND_CLAUDE_MPM=$(command -v claude-mpm)
     RESOLVED_CLAUDE_MPM=$(readlink -f "$FOUND_CLAUDE_MPM" 2>/dev/null || echo "$FOUND_CLAUDE_MPM")
     THIS_SCRIPT=$(readlink -f "$0" 2>/dev/null || echo "$0")
-    
+
     if [ "$RESOLVED_CLAUDE_MPM" = "$THIS_SCRIPT" ]; then
         # The found claude-mpm is actually this script, use the scripts version
         if [ -f "$SCRIPT_DIR/scripts/claude-mpm" ]; then
@@ -42,4 +42,4 @@ elif command -v claude-mpm &> /dev/null; then
 else
     echo "Error: claude-mpm not found. Please run ./install.sh"
     exit 1
-fi
+fi

{claude_mpm-3.9.11 → claude_mpm-4.0.4}/pyproject.toml

@@ -18,7 +18,7 @@ name = "Claude MPM Team"
 text = "MIT"
 
 [project.optional-dependencies]
-dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy",]
+dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy", "pre-commit",]
 docs = [ "sphinx>=7.2.0", "sphinx-rtd-theme>=1.3.0", "sphinx-autobuild>=2021.3.14",]
 monitor = []
 # Pure Python agent dependencies - no compilation required
@@ -31,6 +31,7 @@ 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"
 
 [tool.uv]
 dev-dependencies = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy",]
@@ -54,3 +55,36 @@ claude_mpm = [ "VERSION", "scripts/*", "dashboard/*.html", "dashboard/templates/
 
 [tool.setuptools.packages.find]
 where = [ "src",]
+
+[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.commitizen]
+name = "cz_conventional_commits"
+version = "4.0.4"
+version_files = [
+    "VERSION",
+    "package.json:version"
+]
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_incremental = true

{claude_mpm-3.9.11 → claude_mpm-4.0.4}/requirements.txt

@@ -12,7 +12,14 @@ watchdog>=3.0.0
 websockets>=12.0
 python-frontmatter>=1.0.0
 mistune>=3.0.0
+pydantic>=2.0.0
+pydantic-settings>=2.0.0
 
 # Build and dependency management dependencies
 toml>=0.10.2
-packaging>=21.0
+packaging>=21.0
+
+# Development and type checking dependencies
+mypy>=1.0.0
+types-PyYAML>=6.0.0
+types-requests>=2.25.0

{claude_mpm-3.9.11 → claude_mpm-4.0.4}/scripts/ticket

@@ -35,4 +35,4 @@ if [ $# -eq 0 ] || [ "$1" = "help" ] || [ "$1" = "--help" ] || [ "$1" = "-h" ];
 else
     # Pass all arguments to claude-mpm tickets
     exec "$CLAUDE_MPM" tickets "$@"
-fi
+fi