claude-mpm 4.4.5__tar.gz → 4.4.7__tar.gz

{claude_mpm-4.4.5 → claude_mpm-4.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.4.5
+Version: 4.4.7
 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
@@ -148,7 +148,9 @@ Dynamic: license-file
 
 # 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 a streamlined Rich-based interface.
+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!
 
@@ -191,9 +193,10 @@ claude-mpm mcp-pipx-config
 ```
 
 **💡 Optional Dependencies**:
-- `[mcp]` - Include MCP services (mcp-vector-search, kuzu-memory) as 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
-- Without optional dependencies, services auto-install on first use via pipx
+- **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)
@@ -227,6 +230,18 @@ 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
 ```
@@ -397,5 +412,5 @@ 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
+- Enhanced for [Claude Code (CLI)](https://docs.anthropic.com/en/docs/claude-code) integration
 - Built with ❤️ by the Claude MPM community

{claude_mpm-4.4.5 → claude_mpm-4.4.7}/README.md

@@ -1,6 +1,8 @@
 # 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 a streamlined Rich-based interface.
+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!
 
@@ -43,9 +45,10 @@ claude-mpm mcp-pipx-config
 ```
 
 **💡 Optional Dependencies**:
-- `[mcp]` - Include MCP services (mcp-vector-search, kuzu-memory) as 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
-- Without optional dependencies, services auto-install on first use via pipx
+- **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)
@@ -79,6 +82,18 @@ 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
 ```
@@ -249,5 +264,5 @@ 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
+- Enhanced for [Claude Code (CLI)](https://docs.anthropic.com/en/docs/claude-code) integration
 - Built with ❤️ by the Claude MPM community

claude_mpm-4.4.7/VERSION

@@ -0,0 +1 @@
+4.4.7

{claude_mpm-4.4.5 → claude_mpm-4.4.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.4.5"
+version = "4.4.7"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -80,7 +80,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.4.5"
+version = "4.4.7"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.4.7/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.4.7

claude_mpm-4.4.7/src/claude_mpm/agents/templates/local_ops_agent.json

@@ -0,0 +1,273 @@
+{
+  "name": "local-ops",
+  "display_name": "Local Operations Agent",
+  "description": "Specialized agent for managing local development deployments with authority over PM2, Docker, and native processes",
+  "version": "1.0.0",
+  "author": "Claude MPM",
+  "authority": {
+    "level": "deployment_manager",
+    "domains": [
+      "local_deployments",
+      "process_management",
+      "port_allocation",
+      "resource_monitoring",
+      "log_management"
+    ]
+  },
+  "capabilities": {
+    "frameworks": {
+      "javascript": ["next.js", "react", "vue", "angular", "svelte", "nuxt", "gatsby", "vite"],
+      "python": ["django", "flask", "fastapi", "streamlit", "gradio"],
+      "ruby": ["rails", "sinatra"],
+      "php": ["laravel", "symfony"],
+      "static": ["hugo", "jekyll", "eleventy"]
+    },
+    "deployment_methods": {
+      "pm2": {
+        "description": "Node.js process manager for production deployments",
+        "commands": ["start", "stop", "restart", "status", "logs", "monit"],
+        "features": ["auto-restart", "clustering", "log-rotation", "monitoring"]
+      },
+      "docker": {
+        "description": "Container-based deployment for isolation",
+        "commands": ["build", "run", "stop", "logs", "exec"],
+        "features": ["isolation", "reproducibility", "multi-service"]
+      },
+      "native": {
+        "description": "Direct process management for simple cases",
+        "commands": ["start", "stop", "status"],
+        "features": ["lightweight", "direct-control"]
+      },
+      "systemd": {
+        "description": "Linux system service management",
+        "commands": ["start", "stop", "enable", "status"],
+        "features": ["boot-persistence", "system-integration"]
+      }
+    },
+    "monitoring": {
+      "health_checks": ["http", "tcp", "process"],
+      "metrics": ["cpu", "memory", "response_time", "error_rate"],
+      "alerts": ["crash", "high_memory", "port_conflict", "unhealthy"]
+    }
+  },
+  "metadata": {
+    "category": "operations",
+    "tags": ["deployment", "devops", "local", "process-management", "monitoring"],
+    "requirements": {
+      "optional": ["pm2", "docker", "nginx"],
+      "auto_install": ["pm2"]
+    }
+  },
+  "configuration": {
+    "default_port_range": [3000, 9999],
+    "deployment_directory": ".claude-mpm/deployments",
+    "log_directory": ".claude-mpm/logs",
+    "state_file": ".claude-mpm/deployment-state.json",
+    "health_check_interval": 30,
+    "auto_restart_attempts": 3,
+    "cleanup_on_exit": false
+  },
+  "commands": {
+    "deploy": {
+      "description": "Deploy application with optimal method",
+      "examples": [
+        "Deploy this Next.js app in production mode",
+        "Start the development server with hot reload",
+        "Deploy with PM2 for stability"
+      ],
+      "workflow": [
+        "detect_framework",
+        "check_existing_deployments",
+        "allocate_port",
+        "build_if_needed",
+        "start_process",
+        "monitor_health",
+        "report_status"
+      ]
+    },
+    "status": {
+      "description": "Check deployment status",
+      "provides": ["process_info", "port_mapping", "health_status", "resource_usage"]
+    },
+    "logs": {
+      "description": "Stream or fetch deployment logs",
+      "options": ["tail", "follow", "filter", "since"]
+    },
+    "stop": {
+      "description": "Gracefully stop deployments",
+      "options": ["force", "timeout", "cleanup"]
+    },
+    "scale": {
+      "description": "Scale deployments (PM2 cluster mode)",
+      "options": ["instances", "auto"]
+    }
+  },
+  "detection_patterns": {
+    "nextjs": {
+      "files": ["next.config.js", "next.config.mjs", "next.config.ts"],
+      "package_json": ["next"],
+      "commands": {
+        "dev": "next dev",
+        "build": "next build",
+        "start": "next start",
+        "export": "next export"
+      }
+    },
+    "react": {
+      "files": ["react-scripts", "vite.config.js", "webpack.config.js"],
+      "package_json": ["react", "react-dom"],
+      "commands": {
+        "dev": "npm start",
+        "build": "npm run build",
+        "serve": "serve -s build"
+      }
+    },
+    "vue": {
+      "files": ["vue.config.js", "vite.config.js"],
+      "package_json": ["vue", "@vue/cli-service"],
+      "commands": {
+        "dev": "npm run serve",
+        "build": "npm run build",
+        "preview": "npm run preview"
+      }
+    },
+    "python_django": {
+      "files": ["manage.py", "wsgi.py"],
+      "requirements": ["django"],
+      "commands": {
+        "dev": "python manage.py runserver",
+        "prod": "gunicorn wsgi:application"
+      }
+    },
+    "python_flask": {
+      "files": ["app.py", "wsgi.py"],
+      "requirements": ["flask"],
+      "commands": {
+        "dev": "flask run",
+        "prod": "gunicorn app:app"
+      }
+    }
+  },
+  "deployment_strategies": {
+    "production": {
+      "nextjs": {
+        "method": "pm2",
+        "steps": [
+          "npm install --production",
+          "npm run build",
+          "pm2 start npm --name '{app_name}' -- start"
+        ],
+        "health_check": "http://localhost:{port}",
+        "environment": {
+          "NODE_ENV": "production"
+        }
+      },
+      "react": {
+        "method": "static",
+        "steps": [
+          "npm install",
+          "npm run build",
+          "pm2 serve build {port} --name '{app_name}'"
+        ],
+        "health_check": "http://localhost:{port}"
+      },
+      "python": {
+        "method": "pm2",
+        "steps": [
+          "pip install -r requirements.txt",
+          "pm2 start gunicorn --name '{app_name}' -- app:app --bind 0.0.0.0:{port}"
+        ],
+        "health_check": "http://localhost:{port}/health"
+      }
+    },
+    "development": {
+      "nextjs": {
+        "method": "pm2",
+        "steps": [
+          "npm install",
+          "pm2 start npm --name '{app_name}-dev' -- run dev"
+        ],
+        "environment": {
+          "NODE_ENV": "development"
+        }
+      },
+      "react": {
+        "method": "pm2",
+        "steps": [
+          "npm install",
+          "pm2 start npm --name '{app_name}-dev' -- start"
+        ]
+      }
+    },
+    "docker": {
+      "default": {
+        "method": "docker",
+        "steps": [
+          "docker build -t {app_name} .",
+          "docker run -d -p {port}:{container_port} --name {app_name} {app_name}"
+        ],
+        "health_check": "docker exec {app_name} echo 'OK'"
+      }
+    }
+  },
+  "error_recovery": {
+    "port_conflict": {
+      "detection": "EADDRINUSE",
+      "action": "allocate_next_available_port"
+    },
+    "build_failure": {
+      "detection": "npm ERR!|ERROR|Failed",
+      "action": "report_error_and_suggest_fixes"
+    },
+    "crash_loop": {
+      "detection": "restart_count > 5",
+      "action": "stop_and_investigate_logs"
+    },
+    "out_of_memory": {
+      "detection": "JavaScript heap out of memory",
+      "action": "increase_memory_limit"
+    }
+  },
+  "security": {
+    "port_exposure": "localhost_only",
+    "process_isolation": "user_level",
+    "log_sanitization": true,
+    "secrets_handling": "environment_variables"
+  },
+  "integration": {
+    "hooks": {
+      "pre_deploy": "validate_requirements",
+      "post_deploy": "notify_status",
+      "pre_stop": "graceful_shutdown",
+      "on_crash": "auto_restart_with_backoff"
+    },
+    "monitoring": {
+      "export_metrics": true,
+      "prometheus_endpoint": "/metrics",
+      "health_endpoint": "/health"
+    }
+  },
+  "tools": [
+    "Bash",
+    "Read",
+    "Write",
+    "Edit"
+  ],
+  "examples": [
+    {
+      "user": "Deploy my Next.js app",
+      "response": "I'll deploy your Next.js application using PM2 for stability. Let me detect your configuration and set it up...",
+      "actions": ["detect_framework", "build_production", "deploy_with_pm2", "monitor_health"]
+    },
+    {
+      "user": "Show me the status of all deployments",
+      "response": "Here's the status of all active deployments...",
+      "actions": ["list_pm2_processes", "check_docker_containers", "aggregate_status"]
+    },
+    {
+      "user": "The app keeps crashing, help me debug",
+      "response": "Let me check the logs and identify the issue...",
+      "actions": ["fetch_error_logs", "analyze_crash_pattern", "suggest_fixes"]
+    }
+  ]
+}

{claude_mpm-4.4.5 → claude_mpm-4.4.7}/src/claude_mpm/cli/__init__.py

@@ -234,6 +234,19 @@ def _verify_mcp_gateway_startup():
     DESIGN DECISION: This is non-blocking - failures are logged but don't prevent
     startup to ensure claude-mpm remains functional even if MCP gateway has issues.
     """
+    # Quick verification of MCP services installation
+    try:
+        from ..services.mcp_service_verifier import verify_mcp_services_on_startup
+        from ..core.logger import get_logger
+
+        logger = get_logger("mcp_verify")
+        all_ok, message = verify_mcp_services_on_startup()
+        if not all_ok:
+            logger.warning(message)
+    except Exception:
+        # Non-critical - continue with startup
+        pass
+
     try:
         import asyncio
         import time
@@ -449,6 +462,14 @@ def _execute_command(command: str, args) -> int:
         # Convert CommandResult to exit code
         return result.exit_code if result else 0
 
+    # Handle verify command with lazy import
+    if command == "verify":
+        # Lazy import to avoid loading unless needed
+        from .commands.verify import handle_verify
+
+        result = handle_verify(args)
+        return result if result is not None else 0
+
     # Map stable commands to their implementations
     command_map = {
         CLICommands.RUN.value: run_session,

{claude_mpm-4.4.5 → claude_mpm-4.4.7}/src/claude_mpm/cli/commands/mcp_external_commands.py

@@ -45,7 +45,7 @@ class MCPExternalCommands:
         return 1
 
     def _setup_external(self, args):
-        """Setup external MCP services in Claude Desktop.
+        """Setup external MCP services in Claude Code.
 
         Args:
             args: Command line arguments
@@ -67,13 +67,13 @@ class MCPExternalCommands:
             print("   You may need to install them manually:")
             print("   pip install mcp-vector-search mcp-browser")
 
-        # Then configure in Claude Desktop
-        print("\n2️⃣  Configuring Claude Desktop...")
+        # Then configure in Claude Code
+        print("\n2️⃣  Configuring Claude Code...")
         force = getattr(args, "force", False)
         if setup.setup_external_services(force=force):
             print("\n✅ External services setup completed successfully!")
             print("\nNext steps:")
-            print("1. Restart Claude Desktop to load the new services")
+            print("1. Restart Claude Code to load the new services")
             print("2. Check status with: claude-mpm mcp external list")
             print("3. The services will be available in Claude as separate MCP servers")
             return 0
@@ -111,7 +111,7 @@ class MCPExternalCommands:
         import json
         from pathlib import Path
 
-        # Check Claude Desktop configuration
+        # Check Claude Code configuration
         config_paths = [
             Path.home()
             / "Library"
@@ -157,7 +157,7 @@ class MCPExternalCommands:
                 break
 
         if not config_found:
-            print("❌ No Claude Desktop configuration found")
+            print("❌ No Claude Code configuration found")
             print("   Please run: claude-mpm mcp install")
 
         # Check Python packages
@@ -215,7 +215,7 @@ class MCPExternalCommands:
             print("\n✅ Configuration updated successfully!")
             print("\nNext steps:")
             print("1. Review the .mcp.json file to verify the configuration")
-            print("2. Restart Claude Desktop to load the updated services")
+            print("2. Restart Claude Code to load the updated services")
             return 0
         print("\n❌ Failed to update configuration")
         return 1

{claude_mpm-4.4.5 → claude_mpm-4.4.7}/src/claude_mpm/cli/commands/mcp_install_commands.py

@@ -46,8 +46,8 @@ class MCPInstallCommands:
                 print("\nPlease install manually with: pip install mcp")
                 return 1
 
-        # Step 2: Configure Claude Desktop with the new CLI command
-        print("\n2️⃣  Configuring Claude Desktop...")
+        # Step 2: Configure Claude Code with the new CLI command
+        print("\n2️⃣  Configuring Claude Code...")
         try:
             success = self._configure_claude_desktop(args.force)
             if not success:
@@ -72,7 +72,7 @@ class MCPInstallCommands:
                 # Install Python packages for external services
                 external_setup.check_and_install_pip_packages()
 
-                # Setup external services in Claude Desktop config
+                # Setup external services in Claude Code config
                 if external_setup.setup_external_services(force=args.force):
                     print("✅ External services configured successfully")
                 else:
@@ -86,7 +86,7 @@ class MCPInstallCommands:
             print("\n✅ Configuration completed successfully")
             print("\n🎉 MCP Gateway is ready to use!")
             print("\nNext steps:")
-            print("1. Restart Claude Desktop (if running)")
+            print("1. Restart Claude Code (if running)")
             print("2. Test the server: claude-mpm mcp server --test")
             print("3. Check status: claude-mpm mcp status")
             print("4. List external services: claude-mpm mcp external list")
@@ -97,9 +97,9 @@ class MCPInstallCommands:
             return 1
 
     def _configure_claude_desktop(self, force=False):
-        """Configure Claude Desktop to use the MCP gateway via CLI command.
+        """Configure Claude Code to use the MCP gateway via CLI command.
 
-        WHY: Claude Desktop reads MCP server configurations from a platform-specific
+        WHY: Claude Code reads MCP server configurations from a platform-specific
         configuration file. This method updates that file to include the claude-mpm-gateway
         server configuration.
 
@@ -166,14 +166,14 @@ class MCPInstallCommands:
         return self._save_config(config, config_path)
 
     def _get_claude_config_path(self):
-        """Get the Claude Desktop configuration file path.
+        """Get the Claude Code configuration file path.
 
         Returns:
-            Path or None: Path to Claude Desktop config file
+            Path or None: Path to Claude Code config file
         """
         import platform
 
-        # Try multiple possible locations for Claude Desktop config
+        # Try multiple possible locations for Claude Code config
         possible_paths = [
             Path.home()
             / "Library"

{claude_mpm-4.4.5 → claude_mpm-4.4.7}/src/claude_mpm/cli/commands/mcp_setup_external.py

@@ -1,7 +1,7 @@
 """MCP external services setup module.
 
 This module handles the registration of external MCP services
-(mcp-vector-search, mcp-browser) as separate MCP servers in Claude Desktop.
+(mcp-vector-search, mcp-browser) as separate MCP servers in Claude Code.
 """
 
 import json
@@ -13,7 +13,7 @@ from typing import Dict, Optional, Tuple
 
 
 class MCPExternalServicesSetup:
-    """Handles setup of external MCP services in Claude Desktop configuration."""
+    """Handles setup of external MCP services in Claude Code configuration."""
 
     def get_project_services(self, project_path: Path) -> Dict:
         """Get external services configuration for the current project.
@@ -472,9 +472,9 @@ class MCPExternalServicesSetup:
                     f"\n✅ Successfully configured {success_count} external services in .mcp.json"
                 )
                 print(
-                    "\n📌 Note: Claude Desktop will automatically load these services"
+                    "\n📌 Note: Claude Code will automatically load these services"
                 )
-                print("   when you open this project directory in Claude Desktop.")
+                print("   when you open this project directory in Claude Code.")
                 return True
             print("❌ Failed to save configuration")
             return False
@@ -487,7 +487,7 @@ class MCPExternalServicesSetup:
         """Setup a single external MCP service.
 
         Args:
-            config: The Claude Desktop configuration
+            config: The Claude Code configuration
             service_name: Name of the service to setup
             service_info: Service configuration information
             force: Whether to overwrite existing configuration
@@ -814,7 +814,7 @@ class MCPExternalServicesSetup:
             print("✅ Successfully updated mcp-browser configuration in .mcp.json")
             print(f"   Command: {browser_config['command']}")
             print(f"   Args: {browser_config['args']}")
-            print("\n📌 Note: Claude Desktop will automatically use this configuration")
+            print("\n📌 Note: Claude Code will automatically use this configuration")
             print("   when you open this project directory.")
             return True
         print("❌ Failed to save configuration")