claude-mpm 4.2.7__py3-none-any.whl → 4.2.11__py3-none-any.whl

claude_mpm/cli/commands/run.py

@@ -21,10 +21,11 @@ from typing import Optional
 from ...constants import LogLevel
 from ...core.logger import get_logger
 from ...core.unified_paths import get_scripts_dir
-from ...services.cli.dashboard_launcher import DashboardLauncher
 from ...services.cli.session_manager import SessionManager
-from ...services.cli.socketio_manager import SocketIOManager
+
+# SocketIOManager functionality now provided by UnifiedDashboardManager
 from ...services.cli.startup_checker import StartupCheckerService
+from ...services.cli.unified_dashboard_manager import UnifiedDashboardManager
 from ..shared import BaseCommand, CommandResult
 from ..startup_logging import (
     cleanup_old_startup_logs,
@@ -423,16 +424,16 @@ class RunCommand(BaseCommand):
                 self.logger.warning(f"Dependency check failed: {e}")
 
     def _setup_monitoring(self, args):
-        """Setup monitoring configuration using SocketIOManager."""
+        """Setup monitoring configuration using UnifiedDashboardManager."""
         monitor_mode = getattr(args, "monitor", False)
         websocket_port = 8765  # Default port
 
         if monitor_mode:
-            # Use SocketIOManager for server management
-            socketio_manager = SocketIOManager(self.logger)
+            # Use UnifiedDashboardManager for server management
+            dashboard_manager = UnifiedDashboardManager(self.logger)
 
             # Check dependencies
-            deps_ok, error_msg = socketio_manager.ensure_dependencies()
+            deps_ok, error_msg = dashboard_manager.ensure_dependencies()
             if not deps_ok:
                 self.logger.warning(
                     f"Socket.IO dependencies not available: {error_msg}, disabling monitor mode"
@@ -440,8 +441,8 @@ class RunCommand(BaseCommand):
                 monitor_mode = False
             else:
                 # Find available port and start server
-                websocket_port = socketio_manager.find_available_port(8765)
-                success, server_info = socketio_manager.start_server(
+                websocket_port = dashboard_manager.find_available_port(8765)
+                success, server_info = dashboard_manager.start_server(
                     port=websocket_port
                 )
 
@@ -451,12 +452,12 @@ class RunCommand(BaseCommand):
                     )
                     monitor_mode = False
                 else:
-                    # Use DashboardLauncher for browser opening only
-                    dashboard_launcher = DashboardLauncher(self.logger)
-                    monitor_url = dashboard_launcher.get_dashboard_url(websocket_port)
+                    # Use UnifiedDashboardManager for browser opening only
+                    dashboard_manager = UnifiedDashboardManager(self.logger)
+                    monitor_url = dashboard_manager.get_dashboard_url(websocket_port)
 
                     # Try to open browser
-                    browser_opened = dashboard_launcher._open_browser(monitor_url)
+                    browser_opened = dashboard_manager.open_browser(monitor_url)
                     args._browser_opened_by_cli = browser_opened
 
                     if not browser_opened:
@@ -855,12 +856,12 @@ def run_session_legacy(args):
 
     # Display Socket.IO server info if enabled
     if enable_websocket:
-        # Use SocketIOManager for server management
-        socketio_manager = SocketIOManager(logger)
+        # Use UnifiedDashboardManager for server management
+        dashboard_manager = UnifiedDashboardManager(logger)
 
         # Check dependencies
         print("🔧 Checking Socket.IO dependencies...")
-        deps_ok, error_msg = socketio_manager.ensure_dependencies()
+        deps_ok, error_msg = dashboard_manager.ensure_dependencies()
 
         if not deps_ok:
             print(f"❌ Failed to install Socket.IO dependencies: {error_msg}")
@@ -874,8 +875,8 @@ def run_session_legacy(args):
 
             # Find available port and start server if in monitor mode
             if monitor_mode:
-                websocket_port = socketio_manager.find_available_port(websocket_port)
-                success, server_info = socketio_manager.start_server(
+                websocket_port = dashboard_manager.find_available_port(websocket_port)
+                success, server_info = dashboard_manager.start_server(
                     port=websocket_port
                 )
 
@@ -886,10 +887,10 @@ def run_session_legacy(args):
                             "  Note: Socket.IO monitoring using exec mode with Claude Code hooks"
                         )
 
-                    # Use DashboardLauncher for browser opening
-                    dashboard_launcher = DashboardLauncher(logger)
-                    monitor_url = dashboard_launcher.get_dashboard_url(websocket_port)
-                    browser_opened = dashboard_launcher._open_browser(monitor_url)
+                    # Use UnifiedDashboardManager for browser opening
+                    dashboard_manager = UnifiedDashboardManager(logger)
+                    monitor_url = dashboard_manager.get_dashboard_url(websocket_port)
+                    browser_opened = dashboard_manager.open_browser(monitor_url)
                     args._browser_opened_by_cli = browser_opened
 
                     if not browser_opened:
@@ -971,16 +972,15 @@ def run_session_legacy(args):
         runner.run_interactive(context)
 
 
-# Legacy helper functions - now delegating to SocketIOManager
+# Legacy helper functions - now delegating to UnifiedDashboardManager
 def launch_socketio_monitor(port, logger):
     """Launch the Socket.IO monitoring dashboard (legacy compatibility)."""
-    socketio_manager = SocketIOManager(logger)
-    success, server_info = socketio_manager.start_server(port=port)
+    dashboard_manager = UnifiedDashboardManager(logger)
+    success, server_info = dashboard_manager.start_server(port=port)
 
     if success:
-        # Open browser using DashboardLauncher
-        launcher = DashboardLauncher(logger)
-        browser_opened = launcher._open_browser(server_info.url)
+        # Open browser using UnifiedDashboardManager
+        browser_opened = dashboard_manager.open_browser(server_info.url)
         return success, browser_opened
 
     return False, False
@@ -988,21 +988,21 @@ def launch_socketio_monitor(port, logger):
 
 def _check_socketio_server_running(port, logger):
     """Check if a Socket.IO server is running on the specified port (legacy compatibility)."""
-    socketio_manager = SocketIOManager(logger)
-    return socketio_manager.is_server_running(port)
+    dashboard_manager = UnifiedDashboardManager(logger)
+    return dashboard_manager.is_server_running(port)
 
 
 def _start_standalone_socketio_server(port, logger):
     """Start a standalone Socket.IO server (legacy compatibility)."""
-    socketio_manager = SocketIOManager(logger)
-    success, _ = socketio_manager.start_server(port=port)
+    dashboard_manager = UnifiedDashboardManager(logger)
+    success, _ = dashboard_manager.start_server(port=port)
     return success
 
 
 def open_in_browser_tab(url, logger):
     """Open URL in browser, attempting to reuse existing tabs when possible."""
-    launcher = DashboardLauncher(logger)
-    return launcher._open_browser(url)
+    manager = UnifiedDashboardManager(logger)
+    return manager.open_browser(url)
 
 
 def _check_claude_json_memory(args, logger):

claude_mpm/cli/parser.py

@@ -19,8 +19,85 @@ REFACTORING NOTE: The original 961-line create_parser function has been split in
 - parsers/mcp_parser.py: MCP Gateway commands
 """
 
-# Import from the new modular structure
-from .parsers import add_common_arguments, create_parser, preprocess_args
+import argparse
+import sys
+from typing import List, Optional
+
+# Try to import from the new modular structure with helpful error handling
+try:
+    from .parsers import add_common_arguments, create_parser, preprocess_args
+except ImportError as e:
+    # Provide a helpful error message for users with outdated installations
+    error_msg = f"""
+╔══════════════════════════════════════════════════════════════════╗
+║                    Claude MPM Import Error                       ║
+╠══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║  Unable to import required modules: {e!s}                     ║
+║                                                                   ║
+║  This typically happens when:                                    ║
+║  • The installation is outdated or incomplete                    ║
+║  • Files are missing from your installation                      ║
+║  • You're using an old cached version from pipx                  ║
+║                                                                   ║
+║  ┌─────────────────────────────────────────────────────────┐    ║
+║  │ To fix this issue, please try one of these solutions:   │    ║
+║  └─────────────────────────────────────────────────────────┘    ║
+║                                                                   ║
+║  1. If installed with pipx (recommended):                        ║
+║     ➜ pipx reinstall claude-mpm                                  ║
+║                                                                   ║
+║  2. If installed with pip:                                       ║
+║     ➜ pip install --upgrade --force-reinstall claude-mpm        ║
+║                                                                   ║
+║  3. For development installations:                               ║
+║     ➜ pip install -e . --force-reinstall                        ║
+║                                                                   ║
+║  4. Clear pipx cache and reinstall (if pipx issues persist):    ║
+║     ➜ pipx uninstall claude-mpm                                  ║
+║     ➜ pipx install claude-mpm                                    ║
+║                                                                   ║
+╚══════════════════════════════════════════════════════════════════╝
+"""
+    print(error_msg, file=sys.stderr)
+
+    # Provide minimal fallback functionality to at least show help
+    def create_parser(version: str = "Unknown") -> argparse.ArgumentParser:
+        """Emergency fallback parser that shows reinstallation instructions."""
+        parser = argparse.ArgumentParser(
+            prog="claude-mpm",
+            description="Claude Multi-Agent Project Manager (Installation Error - Please Reinstall)",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+            epilog="""
+This installation appears to be incomplete or outdated.
+Please reinstall using one of the methods shown above.
+            """,
+        )
+        parser.add_argument(
+            "--version",
+            action="version",
+            version=f"{version} (installation error - please reinstall)",
+        )
+        return parser
+
+    def add_common_arguments(parser: argparse.ArgumentParser) -> None:
+        """Emergency fallback - no common arguments available."""
+
+    def preprocess_args(args: Optional[List[str]] = None) -> List[str]:
+        """Emergency fallback - return args unchanged."""
+        return args if args is not None else sys.argv[1:]
+
+    # Exit with error code to indicate the problem
+    # Don't exit immediately - let the user see --help if requested
+    import atexit
+
+    atexit.register(
+        lambda: (
+            sys.exit(1)
+            if "--help" not in sys.argv and "--version" not in sys.argv
+            else None
+        )
+    )
 
 # Re-export for backward compatibility
 __all__ = ["add_common_arguments", "create_parser", "preprocess_args"]

claude_mpm/cli/parsers/__init__.py

@@ -0,0 +1,29 @@
+"""
+CLI parsers package for claude-mpm.
+
+This package contains modular parser components that were extracted from the
+monolithic parser.py file to improve maintainability and organization.
+
+WHY: The original parser.py was 1,166 lines with a single 961-line function.
+Breaking it into focused modules makes it easier to maintain and test.
+
+DESIGN DECISION: Each parser module handles a specific command domain:
+- base_parser.py: Common arguments and main parser setup
+- run_parser.py: Run command arguments
+- agent_parser.py: Agent management commands
+- memory_parser.py: Memory management commands
+- tickets_parser.py: Ticket management commands
+- config_parser.py: Configuration commands
+- monitor_parser.py: Monitoring commands
+- mcp_parser.py: MCP Gateway commands
+"""
+
+from .base_parser import add_common_arguments, create_parser, preprocess_args
+from .run_parser import add_run_arguments
+
+__all__ = [
+    "add_common_arguments",
+    "add_run_arguments",
+    "create_parser",
+    "preprocess_args",
+]

claude_mpm/dashboard/static/css/code-tree.css

@@ -7,6 +7,14 @@
     background: #f8f9fa;
 }
 
+/* Container for Code Tree - Now full width */
+.code-split-container {
+    display: flex;
+    flex: 1;
+    padding: 10px;
+    overflow: hidden;
+}
+
 /* Advanced Options - Always Visible */
 .code-advanced-options-visible {
     background: white;
@@ -452,22 +460,26 @@
     color: #2d3748;
 }
 
-/* Code Tree Container */
+/* Code Tree Container - Full Width */
 .code-tree-container {
     flex: 1;
     background: white;
     border-radius: 8px;
     padding: 20px;
     position: relative;
-    overflow: hidden;
+    overflow: auto;
     box-shadow: 0 2px 4px rgba(0, 0, 0, 0.05);
-    border-left: 1px solid #e2e8f0;
+    border: 1px solid #e2e8f0;
 }
 
+/* Code Content Area - DEPRECATED (Removed duplicate pane) */
+/* Content now displayed in main Structured Data section */
+/* .code-module-data-content class removed */
+
 /* Visual hierarchy improvements */
 .code-tree-container:focus-within {
     box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
-    border-left-color: #3b82f6;
+    border-color: #3b82f6;
 }
 
 /* Loading indicator */

claude_mpm/dashboard/static/css/dashboard.css

@@ -2814,7 +2814,8 @@ button:disabled:hover {
     color: #f1fa8c;
 }
 
-.file-content-code .number {
+.file-content-code .number,
+.source-line .number {
     color: #bd93f9;
 }
 
@@ -2826,6 +2827,19 @@ button:disabled:hover {
     color: #8be9fd;
 }
 
+/* JSON-specific syntax highlighting */
+.file-content-code .json-key,
+.source-line .json-key {
+    color: #8be9fd;
+    font-weight: 600;
+}
+
+.file-content-code .literal,
+.source-line .literal {
+    color: #ff79c6;
+    font-weight: 600;
+}
+
 .file-content-code .selector {
     color: #ff79c6;
 }