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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.4.4
+Version: 4.4.5
 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
@@ -41,11 +41,6 @@ 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: kuzu-memory>=1.1.1
-Requires-Dist: mcp>=0.1.0
-Requires-Dist: mcp-vector-search>=0.1.0
-Requires-Dist: mcp-browser>=0.1.0
-Requires-Dist: mcp-ticketer>=0.1.0
 Requires-Dist: toml>=0.10.2
 Requires-Dist: packaging>=21.0
 Requires-Dist: pydantic>=2.0.0
@@ -54,6 +49,12 @@ 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.1; extra == "mcp"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
@@ -157,7 +158,7 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 - 🧠 **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
-- 🔌 **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory automatically installed via pipx
+- 🔌 **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
@@ -167,22 +168,32 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 ## 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
-# Install with monitor support (recommended)
-pipx install "claude-mpm[monitor]"
-
-# Basic installation without monitor
+# 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
 ```
 
-**💡 Pipx Tip**: Use `"claude-mpm[monitor]"` to get full monitoring dashboard functionality! The `[monitor]` optional dependency includes Socket.IO and async web server components needed for real-time agent monitoring.
+**💡 Optional Dependencies**:
+- `[mcp]` - Include MCP services (mcp-vector-search, kuzu-memory) as dependencies
+- `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
+- Without optional dependencies, 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)
@@ -207,11 +218,14 @@ claude-mpm mcp
 # Run comprehensive health diagnostics
 claude-mpm doctor
 
-# Generate detailed diagnostic report
+# Generate detailed diagnostic report with MCP service analysis
 claude-mpm doctor --verbose --output-file doctor-report.md
 
-# Run specific diagnostic checks
-claude-mpm doctor --checks installation configuration agents
+# 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
 
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
@@ -225,7 +239,7 @@ See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 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
-- **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory install automatically via pipx
+- **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

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

@@ -10,7 +10,7 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 - 🧠 **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
-- 🔌 **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory automatically installed via pipx
+- 🔌 **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
@@ -20,22 +20,32 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 ## 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
-# Install with monitor support (recommended)
-pipx install "claude-mpm[monitor]"
-
-# Basic installation without monitor
+# 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
 ```
 
-**💡 Pipx Tip**: Use `"claude-mpm[monitor]"` to get full monitoring dashboard functionality! The `[monitor]` optional dependency includes Socket.IO and async web server components needed for real-time agent monitoring.
+**💡 Optional Dependencies**:
+- `[mcp]` - Include MCP services (mcp-vector-search, kuzu-memory) as dependencies
+- `[monitor]` - Full monitoring dashboard with Socket.IO and async web server components
+- Without optional dependencies, 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)
@@ -60,11 +70,14 @@ claude-mpm mcp
 # Run comprehensive health diagnostics
 claude-mpm doctor
 
-# Generate detailed diagnostic report
+# Generate detailed diagnostic report with MCP service analysis
 claude-mpm doctor --verbose --output-file doctor-report.md
 
-# Run specific diagnostic checks
-claude-mpm doctor --checks installation configuration agents
+# 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
 
 # Manage memory for large conversation histories
 claude-mpm cleanup-memory
@@ -78,7 +91,7 @@ See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
 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
-- **Auto-Installing MCP Services**: mcp-vector-search and kuzu-memory install automatically via pipx
+- **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

claude_mpm-4.4.5/VERSION

@@ -0,0 +1 @@
+4.4.5

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

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.4.4"
+version = "4.4.5"
 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", "kuzu-memory>=1.1.1", "mcp>=0.1.0", "mcp-vector-search>=0.1.0", "mcp-browser>=0.1.0", "mcp-ticketer>=0.1.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",]
+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"
@@ -28,6 +28,7 @@ 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.1",]
 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",]
@@ -79,7 +80,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.4.4"
+version = "4.4.5"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.4.5/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.4.5

{claude_mpm-4.4.4 → claude_mpm-4.4.5}/src/claude_mpm/services/diagnostics/checks/mcp_services_check.py

@@ -21,30 +21,35 @@ class MCPServicesCheck(BaseDiagnosticCheck):
     MCP_SERVICES = {
         "mcp-vector-search": {
             "package": "mcp-vector-search",
-            "command": ["mcp-vector-search", "--help"],
+            "command": ["mcp-vector-search", "--version"],  # Use --version for proper check
             "description": "Vector search for semantic code navigation",
             "check_health": True,
             "health_command": ["mcp-vector-search", "--version"],
+            "pipx_run_command": ["pipx", "run", "mcp-vector-search", "--version"],
         },
         "mcp-browser": {
             "package": "mcp-browser",
-            "command": ["mcp-browser", "--help"],
+            "command": ["mcp-browser", "--version"],  # Use --version for proper check
             "description": "Browser automation and web interaction",
             "check_health": True,
             "health_command": ["mcp-browser", "--version"],
+            "pipx_run_command": ["pipx", "run", "mcp-browser", "--version"],
         },
         "mcp-ticketer": {
             "package": "mcp-ticketer",
-            "command": ["mcp-ticketer", "--help"],
+            "command": ["mcp-ticketer", "--version"],  # Use --version for proper check
             "description": "Ticket and task management",
             "check_health": True,
             "health_command": ["mcp-ticketer", "--version"],
+            "pipx_run_command": ["pipx", "run", "mcp-ticketer", "--version"],
         },
         "kuzu-memory": {
             "package": "kuzu-memory",
-            "command": ["kuzu-memory", "--help"],
+            "command": ["kuzu-memory", "--version"],  # Use --version for proper check
             "description": "Graph-based memory system",
-            "check_health": False,  # May not have version command
+            "check_health": True,  # v1.1.0+ has version command
+            "health_command": ["kuzu-memory", "--version"],
+            "pipx_run_command": ["pipx", "run", "kuzu-memory", "--version"],
         },
     }
 
@@ -143,6 +148,13 @@ class MCPServicesCheck(BaseDiagnosticCheck):
         if command_path:
             details["command_path"] = command_path
 
+        # If not directly accessible, try pipx run command
+        if not accessible and "pipx_run_command" in config:
+            if self._verify_command_works(config["pipx_run_command"]):
+                accessible = True
+                details["accessible_via_pipx_run"] = True
+                details["pipx_run_available"] = True
+
         # Check for installation in various locations
         if not pipx_installed and not accessible:
             # Try common installation locations
@@ -157,11 +169,19 @@ class MCPServicesCheck(BaseDiagnosticCheck):
 
         # Check service health/version if accessible
         if accessible and config.get("check_health"):
-            version = self._get_service_version(
-                config.get("health_command", config["command"])
-            )
-            if version:
-                details["version"] = version
+            # Try different version commands in order of preference
+            version_commands = []
+            if details.get("accessible_via_pipx_run") and "pipx_run_command" in config:
+                version_commands.append(config["pipx_run_command"])
+            if "health_command" in config:
+                version_commands.append(config["health_command"])
+            version_commands.append(config["command"])
+
+            for cmd in version_commands:
+                version = self._get_service_version(cmd)
+                if version:
+                    details["version"] = version
+                    break
 
         # Determine status
         if not (pipx_installed or accessible):
@@ -175,6 +195,14 @@ class MCPServicesCheck(BaseDiagnosticCheck):
             )
 
         if pipx_installed and not accessible:
+            # Check if pipx run works
+            if details.get("pipx_run_available"):
+                return DiagnosticResult(
+                    category=f"MCP Service: {service_name}",
+                    status=DiagnosticStatus.OK,
+                    message="Installed via pipx (use 'pipx run' to execute)",
+                    details=details,
+                )
             return DiagnosticResult(
                 category=f"MCP Service: {service_name}",
                 status=DiagnosticStatus.WARNING,
@@ -247,29 +275,53 @@ class MCPServicesCheck(BaseDiagnosticCheck):
 
             if result.returncode == 0:
                 path = result.stdout.strip()
-                return True, path
+                # Verify the command actually works with --version
+                if self._verify_command_works(command):
+                    return True, path
+                return False, path
         except (subprocess.SubprocessError, FileNotFoundError):
             pass
 
-        # Try direct execution
+        # Try direct execution with --version
+        if self._verify_command_works(command):
+            return True, None
+
+        return False, None
+
+    def _verify_command_works(self, command: List[str]) -> bool:
+        """Verify a command actually works by checking its --version output."""
         try:
             result = subprocess.run(
                 command,
                 capture_output=True,
                 text=True,
-                timeout=2,
+                timeout=5,
                 check=False,
             )
-            if (
-                result.returncode == 0
-                or "help" in result.stdout.lower()
-                or "usage" in result.stdout.lower()
-            ):
-                return True, None
-        except (subprocess.SubprocessError, FileNotFoundError):
+
+            # Check for successful execution or version output
+            # Don't accept error messages containing "help" or "usage" as success
+            if result.returncode == 0:
+                # Look for actual version information
+                output = (result.stdout + result.stderr).lower()
+                # Check for version indicators
+                if any(keyword in output for keyword in ["version", "v1.", "v0.", "1.", "0."]):
+                    # But reject if it's an error message
+                    if not any(error in output for error in ["error", "not found", "no such", "command not found"]):
+                        return True
+
+            # For some tools, non-zero return code is OK if version is shown
+            elif "--version" in command or "--help" in command:
+                output = (result.stdout + result.stderr).lower()
+                # Must have version info and no error indicators
+                if ("version" in output or "v1." in output or "v0." in output):
+                    if not any(error in output for error in ["error", "not found", "no such", "command not found", "traceback"]):
+                        return True
+
+        except (subprocess.SubprocessError, FileNotFoundError, OSError):
             pass
 
-        return False, None
+        return False
 
     def _check_alternative_installations(
         self, service_name: str