claude-mpm 4.2.18__tar.gz → 4.2.22__tar.gz

claude_mpm-4.2.22/BUILD_NUMBER

@@ -0,0 +1 @@
+348

{claude_mpm-4.2.18 → claude_mpm-4.2.22}/MANIFEST.in

@@ -38,6 +38,10 @@ recursive-include src/claude_mpm/dashboard *.html *.css *.js *.json
 recursive-include src/claude_mpm/dashboard/templates *.html
 recursive-include src/claude_mpm/dashboard/static *.css *.js *.json
 
+# Include monitor service files
+recursive-include src/claude_mpm/services/monitor *.py
+recursive-include src/claude_mpm/services/communication *.py
+
 # Exclude test and cache files
 global-exclude __pycache__
 global-exclude *.py[co]

{claude_mpm-4.2.18 → claude_mpm-4.2.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.2.18
+Version: 4.2.22
 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
@@ -71,6 +71,12 @@ 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"
@@ -143,11 +149,18 @@ pip install claude-mpm
 
 Or with pipx (recommended for isolated installation):
 ```bash
+# Install with monitor support (recommended)
+pipx install "claude-mpm[monitor]"
+
+# Basic installation without monitor
 pipx install claude-mpm
+
 # 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.
+
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
 - ✅ Commands directory access (fixed) 

{claude_mpm-4.2.18 → claude_mpm-4.2.22}/README.md

@@ -25,11 +25,18 @@ pip install claude-mpm
 
 Or with pipx (recommended for isolated installation):
 ```bash
+# Install with monitor support (recommended)
+pipx install "claude-mpm[monitor]"
+
+# Basic installation without monitor
 pipx install claude-mpm
+
 # 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.
+
 **🎉 Pipx Support Now Fully Functional!** Recent improvements ensure complete compatibility:
 - ✅ Socket.IO daemon script path resolution (fixed)
 - ✅ Commands directory access (fixed) 

claude_mpm-4.2.22/VERSION

@@ -0,0 +1 @@
+4.2.22

{claude_mpm-4.2.18 → claude_mpm-4.2.22}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.2.18"
+version = "4.2.22"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -30,7 +30,7 @@ Documentation = "https://github.com/bobmatnyc/claude-mpm/blob/main/README.md"
 [project.optional-dependencies]
 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 = []
+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",]
 
 [project.scripts]
@@ -78,7 +78,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.2.18"
+version = "4.2.22"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-4.2.22/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.2.22

{claude_mpm-4.2.18 → claude_mpm-4.2.22}/src/claude_mpm/cli/commands/monitor.py

@@ -105,12 +105,44 @@ class MonitorCommand(BaseCommand):
 
         # Start the daemon
         if self.daemon.start():
-            mode_info = " in background" if daemon_mode else " in foreground"
+            # For daemon mode, verify it actually started
+            if daemon_mode:
+                # Give it a moment to fully initialize
+                import time
+                time.sleep(0.5)
+                
+                # Check if it's actually running
+                if not self.daemon.lifecycle.is_running():
+                    return CommandResult.error_result(
+                        "Monitor daemon failed to start. Check ~/.claude-mpm/monitor-daemon.log for details."
+                    )
+                
+                # Get the actual PID
+                actual_pid = self.daemon.lifecycle.get_pid()
+                mode_info = f" in background (PID: {actual_pid})"
+            else:
+                mode_info = " in foreground"
+            
             return CommandResult.success_result(
                 f"Unified monitor daemon started on {host}:{port}{mode_info}",
                 data={"url": f"http://{host}:{port}", "port": port, "mode": mode_str},
             )
-        return CommandResult.error_result("Failed to start unified monitor daemon")
+        
+        # Check if error was due to port already in use
+        import socket
+        try:
+            test_sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            test_sock.connect((host, port))
+            test_sock.close()
+            return CommandResult.error_result(
+                f"Port {port} is already in use. Try 'claude-mpm monitor stop' first or use a different port."
+            )
+        except:
+            pass
+        
+        return CommandResult.error_result(
+            "Failed to start unified monitor daemon. Check ~/.claude-mpm/monitor-daemon.log for details."
+        )
 
     def _stop_monitor(self, args) -> CommandResult:
         """Stop the unified monitor daemon."""

claude_mpm-4.2.22/src/claude_mpm/scripts/launch_monitor.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""
+Launch Monitor Script for Claude MPM.
+
+This script provides the entry point for launching the Claude MPM monitor
+dashboard, which includes both the Socket.IO server and web interface.
+
+WHY: Provides a simple command to start the monitoring dashboard that tracks
+Claude MPM events and agent activity in real-time.
+"""
+
+import argparse
+import sys
+import webbrowser
+
+from claude_mpm.core.logging_config import get_logger
+from claude_mpm.services.monitor.daemon import UnifiedMonitorDaemon
+from claude_mpm.services.port_manager import PortManager
+
+DEFAULT_PORT = 8765
+logger = get_logger(__name__)
+
+
+def main():
+    """Main entry point for monitor launcher."""
+    parser = argparse.ArgumentParser(
+        description="Launch Claude MPM monitoring dashboard"
+    )
+
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=DEFAULT_PORT,
+        help=f"Port to run on (default: {DEFAULT_PORT})",
+    )
+
+    parser.add_argument(
+        "--host", default="localhost", help="Host to bind to (default: localhost)"
+    )
+
+    parser.add_argument(
+        "--no-browser", action="store_true", help="Do not open browser automatically"
+    )
+
+    parser.add_argument(
+        "--background", action="store_true", help="Run in background daemon mode"
+    )
+
+    args = parser.parse_args()
+
+    # Find available port
+    port_manager = PortManager()
+    actual_port = port_manager.find_available_port(preferred_port=args.port)
+
+    if actual_port != args.port:
+        logger.info(f"Port {args.port} is in use, using port {actual_port} instead")
+
+    # Start the monitor daemon
+    logger.info(f"Starting Claude MPM monitor on {args.host}:{actual_port}")
+
+    daemon = UnifiedMonitorDaemon(
+        host=args.host, port=actual_port, daemon_mode=args.background
+    )
+
+    success = daemon.start()
+
+    if success:
+        # Open browser if requested
+        if not args.no_browser:
+            url = f"http://{args.host}:{actual_port}"
+            logger.info(f"Opening browser to {url}")
+            webbrowser.open(url)
+
+        if args.background:
+            logger.info(f"Monitor daemon started in background on port {actual_port}")
+        else:
+            logger.info(f"Monitor running on port {actual_port}")
+            logger.info("Press Ctrl+C to stop")
+    else:
+        logger.error("Failed to start monitor")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

claude_mpm-4.2.22/src/claude_mpm/scripts/socketio_daemon.py

@@ -0,0 +1,218 @@
+#!/usr/bin/env python3
+"""
+SocketIO Daemon Script for Claude MPM.
+
+This script provides a command-line interface to the unified monitor daemon
+that runs the Socket.IO server for event broadcasting and dashboard functionality.
+
+WHY: The pyproject.toml references this as an entry point for claude-mpm-socketio,
+providing a dedicated command for managing the Socket.IO daemon process.
+"""
+
+import argparse
+import os
+import signal
+import sys
+import time
+from pathlib import Path
+
+# Add parent directory to path for imports
+sys.path.insert(0, str(Path(__file__).parent.parent.parent.parent))
+
+from claude_mpm.core.logging_config import get_logger
+from claude_mpm.services.monitor.daemon import UnifiedMonitorDaemon
+from claude_mpm.services.port_manager import PortManager
+
+# Default paths
+DEFAULT_PID_FILE = Path.home() / ".claude-mpm" / "socketio-server.pid"
+DEFAULT_LOG_FILE = Path.home() / ".claude-mpm" / "logs" / "socketio" / "daemon.log"
+DEFAULT_PORT = 8765
+
+logger = get_logger(__name__)
+
+
+def is_running(pid_file: Path) -> bool:
+    """Check if daemon is running."""
+    if not pid_file.exists():
+        return False
+
+    try:
+        with open(pid_file) as f:
+            pid = int(f.read().strip())
+
+        # Check if process exists
+        os.kill(pid, 0)
+        return True
+    except (OSError, ValueError):
+        # Process doesn't exist or invalid PID
+        if pid_file.exists():
+            pid_file.unlink()
+        return False
+
+
+def start_server(port: int = DEFAULT_PORT, daemon: bool = True) -> bool:
+    """Start the Socket.IO server."""
+    pid_file = DEFAULT_PID_FILE
+    log_file = DEFAULT_LOG_FILE
+
+    # Ensure directories exist
+    pid_file.parent.mkdir(parents=True, exist_ok=True)
+    log_file.parent.mkdir(parents=True, exist_ok=True)
+
+    if is_running(pid_file):
+        logger.info("Socket.IO daemon is already running")
+        return False
+
+    # Use PortManager to find available port
+    port_manager = PortManager()
+    actual_port = port_manager.find_available_port(preferred_port=port)
+
+    if actual_port != port:
+        logger.info(f"Port {port} is in use, using port {actual_port} instead")
+
+    # Create and start daemon
+    monitor_daemon = UnifiedMonitorDaemon(
+        host="localhost",
+        port=actual_port,
+        daemon_mode=daemon,
+        pid_file=str(pid_file),
+        log_file=str(log_file),
+    )
+
+    success = monitor_daemon.start()
+
+    if success:
+        logger.info(f"Socket.IO daemon started on port {actual_port}")
+        # Save the port for clients to discover
+        port_file = pid_file.parent / "socketio-port"
+        with open(port_file, "w") as f:
+            f.write(str(actual_port))
+    else:
+        logger.error("Failed to start Socket.IO daemon")
+
+    return success
+
+
+def stop_server() -> bool:
+    """Stop the Socket.IO server."""
+    pid_file = DEFAULT_PID_FILE
+
+    if not is_running(pid_file):
+        logger.info("Socket.IO daemon is not running")
+        return False
+
+    try:
+        with open(pid_file) as f:
+            pid = int(f.read().strip())
+
+        # Send SIGTERM for graceful shutdown
+        os.kill(pid, signal.SIGTERM)
+
+        # Wait for process to terminate
+        for _ in range(10):
+            if not is_running(pid_file):
+                break
+            time.sleep(0.5)
+
+        # Force kill if still running
+        if is_running(pid_file):
+            os.kill(pid, signal.SIGKILL)
+            time.sleep(0.5)
+
+        # Clean up files
+        if pid_file.exists():
+            pid_file.unlink()
+
+        port_file = pid_file.parent / "socketio-port"
+        if port_file.exists():
+            port_file.unlink()
+
+        logger.info("Socket.IO daemon stopped")
+        return True
+
+    except Exception as e:
+        logger.error(f"Error stopping daemon: {e}")
+        return False
+
+
+def restart_server(port: int = DEFAULT_PORT) -> bool:
+    """Restart the Socket.IO server."""
+    logger.info("Restarting Socket.IO daemon...")
+
+    # Stop if running
+    if is_running(DEFAULT_PID_FILE):
+        stop_server()
+        time.sleep(1)  # Brief pause between stop and start
+
+    # Start again
+    return start_server(port=port)
+
+
+def status_server() -> bool:
+    """Check status of Socket.IO server."""
+    pid_file = DEFAULT_PID_FILE
+    port_file = pid_file.parent / "socketio-port"
+
+    if is_running(pid_file):
+        try:
+            with open(pid_file) as f:
+                pid = int(f.read().strip())
+
+            port = DEFAULT_PORT
+            if port_file.exists():
+                with open(port_file) as f:
+                    port = int(f.read().strip())
+
+            print(f"Socket.IO daemon is running (PID: {pid}, Port: {port})")
+            return True
+        except Exception as e:
+            print(f"Socket.IO daemon status unknown: {e}")
+            return False
+    else:
+        print("Socket.IO daemon is not running")
+        return False
+
+
+def main():
+    """Main entry point for socketio daemon management."""
+    parser = argparse.ArgumentParser(description="Manage Claude MPM Socket.IO daemon")
+
+    parser.add_argument(
+        "command", choices=["start", "stop", "restart", "status"], help="Daemon command"
+    )
+
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=DEFAULT_PORT,
+        help=f"Port to run on (default: {DEFAULT_PORT})",
+    )
+
+    parser.add_argument(
+        "--foreground",
+        action="store_true",
+        help="Run in foreground instead of daemon mode",
+    )
+
+    args = parser.parse_args()
+
+    # Execute command
+    if args.command == "start":
+        success = start_server(port=args.port, daemon=not args.foreground)
+        sys.exit(0 if success else 1)
+
+    elif args.command == "stop":
+        success = stop_server()
+        sys.exit(0 if success else 1)
+
+    elif args.command == "restart":
+        success = restart_server(port=args.port)
+        sys.exit(0 if success else 1)
+
+    elif args.command == "status":
+        success = status_server()
+        sys.exit(0 if success else 1)
+
+
+if __name__ == "__main__":
+    main()

{claude_mpm-4.2.18 → claude_mpm-4.2.22}/src/claude_mpm/services/monitor/daemon.py

@@ -57,9 +57,11 @@ class UnifiedMonitorDaemon:
         self.daemon_mode = daemon_mode
         self.logger = get_logger(__name__)
 
-        # Daemon management
+        # Daemon management with port for verification
         self.lifecycle = DaemonLifecycle(
-            pid_file=pid_file or self._get_default_pid_file(), log_file=log_file
+            pid_file=pid_file or self._get_default_pid_file(), 
+            log_file=log_file,
+            port=port
         )
 
         # Core server
@@ -102,6 +104,13 @@ class UnifiedMonitorDaemon:
             existing_pid = self.lifecycle.get_pid()
             self.logger.warning(f"Daemon already running with PID {existing_pid}")
             return False
+        
+        # Verify port is available before forking
+        port_available, error_msg = self.lifecycle.verify_port_available(self.host)
+        if not port_available:
+            self.logger.error(error_msg)
+            print(f"Error: {error_msg}", file=sys.stderr)
+            return False
 
         # Wait for any pre-warming threads to complete before forking
         self._wait_for_prewarm_completion()
@@ -112,7 +121,17 @@ class UnifiedMonitorDaemon:
             return False
 
         # Start the server in daemon mode
-        return self._run_server()
+        # This will run in the child process
+        try:
+            result = self._run_server()
+            if not result:
+                # Report failure before exiting
+                self.lifecycle._report_startup_error("Failed to start server")
+            return result
+        except Exception as e:
+            # Report any exceptions during startup
+            self.lifecycle._report_startup_error(f"Server startup exception: {e}")
+            raise
 
     def _start_foreground(self) -> bool:
         """Start in foreground mode."""
@@ -140,11 +159,17 @@ class UnifiedMonitorDaemon:
         try:
             # Ensure components exist before starting
             if not self.health_monitor:
-                self.logger.error("Health monitor not initialized")
+                error_msg = "Health monitor not initialized"
+                self.logger.error(error_msg)
+                if self.daemon_mode:
+                    self.lifecycle._report_startup_error(error_msg)
                 return False
 
             if not self.server:
-                self.logger.error("Server not initialized")
+                error_msg = "Server not initialized"
+                self.logger.error(error_msg)
+                if self.daemon_mode:
+                    self.lifecycle._report_startup_error(error_msg)
                 return False
 
             # Start health monitoring
@@ -153,11 +178,18 @@ class UnifiedMonitorDaemon:
             # Start the unified server
             success = self.server.start()
             if not success:
-                self.logger.error("Failed to start unified monitor server")
+                error_msg = "Failed to start unified monitor server"
+                self.logger.error(error_msg)
+                if self.daemon_mode:
+                    self.lifecycle._report_startup_error(error_msg)
                 return False
 
             self.running = True
             self.logger.info("Unified monitor daemon started successfully")
+            
+            # Report successful startup to parent (for daemon mode)
+            if self.daemon_mode:
+                self.lifecycle._report_startup_success()
 
             # Keep running until shutdown
             if self.daemon_mode: