claude-mpm 4.1.5__py3-none-any.whl → 4.1.7__py3-none-any.whl

claude_mpm/cli/parsers/base_parser.py

@@ -331,6 +331,13 @@ def create_parser(
     except ImportError:
         pass
 
+    try:
+        from .configure_parser import add_configure_subparser
+
+        add_configure_subparser(subparsers)
+    except ImportError:
+        pass
+
     # Import and add additional command parsers from commands module
     try:
         from ..commands.aggregate import add_aggregate_parser

claude_mpm/cli/parsers/configure_parser.py

@@ -0,0 +1,119 @@
+"""
+Configure command parser for claude-mpm CLI.
+
+WHY: This module contains all arguments specific to the interactive configuration
+management interface, allowing users to enable/disable agents, edit templates,
+and manage behavior files.
+"""
+
+import argparse
+
+from ...constants import CLICommands
+from .base_parser import add_common_arguments
+
+
+def add_configure_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the configure subparser for interactive configuration management.
+
+    WHY: Users need an interactive way to manage agent configurations,
+    templates, and behavior files through a terminal-based interface.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured configure subparser
+    """
+    # Configure command - interactive TUI configuration
+    configure_parser = subparsers.add_parser(
+        CLICommands.CONFIGURE.value,
+        help="Interactive terminal-based configuration interface for managing agents and behaviors",
+        description="Launch an interactive Rich-based TUI for configuring claude-mpm agents, templates, and behavior files",
+    )
+
+    # Add common arguments
+    add_common_arguments(configure_parser)
+
+    # Configuration scope options
+    scope_group = configure_parser.add_argument_group("configuration scope")
+    scope_group.add_argument(
+        "--scope",
+        choices=["project", "user"],
+        default="project",
+        help="Configuration scope to manage (default: project)",
+    )
+    # Note: --project-dir is already defined in base_parser.py
+
+    # Direct navigation options (skip main menu)
+    nav_group = configure_parser.add_argument_group("direct navigation")
+    nav_group.add_argument(
+        "--agents", action="store_true", help="Jump directly to agent management"
+    )
+    nav_group.add_argument(
+        "--templates", action="store_true", help="Jump directly to template editing"
+    )
+    nav_group.add_argument(
+        "--behaviors",
+        action="store_true",
+        help="Jump directly to behavior file management",
+    )
+    nav_group.add_argument(
+        "--version-info",
+        action="store_true",
+        help="Display version information and exit",
+    )
+
+    # Non-interactive options
+    noninteractive_group = configure_parser.add_argument_group(
+        "non-interactive options"
+    )
+    noninteractive_group.add_argument(
+        "--list-agents", action="store_true", help="List all available agents and exit"
+    )
+    noninteractive_group.add_argument(
+        "--enable-agent",
+        type=str,
+        metavar="AGENT_NAME",
+        help="Enable a specific agent and exit",
+    )
+    noninteractive_group.add_argument(
+        "--disable-agent",
+        type=str,
+        metavar="AGENT_NAME",
+        help="Disable a specific agent and exit",
+    )
+    noninteractive_group.add_argument(
+        "--export-config",
+        type=str,
+        metavar="FILE",
+        help="Export current configuration to a file",
+    )
+    noninteractive_group.add_argument(
+        "--import-config",
+        type=str,
+        metavar="FILE",
+        help="Import configuration from a file",
+    )
+
+    # Display options
+    display_group = configure_parser.add_argument_group("display options")
+    display_group.add_argument(
+        "--no-colors", action="store_true", help="Disable colored output in the TUI"
+    )
+    display_group.add_argument(
+        "--compact", action="store_true", help="Use compact display mode"
+    )
+    display_group.add_argument(
+        "--force-rich",
+        action="store_true",
+        help="Force use of Rich menu interface instead of full-screen Textual TUI",
+    )
+    display_group.add_argument(
+        "--no-textual",
+        dest="use_textual",
+        action="store_false",
+        help="Disable Textual TUI and use Rich menu interface",
+    )
+
+    return configure_parser

claude_mpm/cli/startup_logging.py

@@ -57,17 +57,34 @@ def log_memory_stats(logger=None, prefix="Memory Usage"):
         rss_mb = memory_info.rss / (1024 * 1024)
         vms_mb = memory_info.vms / (1024 * 1024)
 
-        # Get percentage of system memory if available
-        try:
-            memory_percent = process.memory_percent()
-            logger.info(
-                f"{prefix}: RSS={rss_mb:.1f}MB, VMS={vms_mb:.1f}MB, "
-                f"System={memory_percent:.1f}%"
-            )
-            return {"rss_mb": rss_mb, "vms_mb": vms_mb, "percent": memory_percent}
-        except:
-            logger.info(f"{prefix}: RSS={rss_mb:.1f}MB, VMS={vms_mb:.1f}MB")
-            return {"rss_mb": rss_mb, "vms_mb": vms_mb, "percent": None}
+        # On macOS, VMS can report misleading values (400+ TB)
+        # Skip VMS reporting if it's unreasonably large
+        import platform
+
+        if platform.system() == "Darwin" and vms_mb > 100000:  # > 100GB is suspicious
+            # Get percentage of system memory if available
+            try:
+                memory_percent = process.memory_percent()
+                logger.info(
+                    f"{prefix}: RSS={rss_mb:.1f}MB, System={memory_percent:.1f}%"
+                )
+                return {"rss_mb": rss_mb, "vms_mb": None, "percent": memory_percent}
+            except:
+                logger.info(f"{prefix}: RSS={rss_mb:.1f}MB")
+                return {"rss_mb": rss_mb, "vms_mb": None, "percent": None}
+        else:
+            # Normal VMS reporting for non-macOS or reasonable values
+            # Get percentage of system memory if available
+            try:
+                memory_percent = process.memory_percent()
+                logger.info(
+                    f"{prefix}: RSS={rss_mb:.1f}MB, VMS={vms_mb:.1f}MB, "
+                    f"System={memory_percent:.1f}%"
+                )
+                return {"rss_mb": rss_mb, "vms_mb": vms_mb, "percent": memory_percent}
+            except:
+                logger.info(f"{prefix}: RSS={rss_mb:.1f}MB, VMS={vms_mb:.1f}MB")
+                return {"rss_mb": rss_mb, "vms_mb": vms_mb, "percent": None}
 
     except Exception as e:
         logger.debug(f"Failed to get memory info: {e}")
@@ -512,11 +529,21 @@ def setup_startup_logging(project_root: Optional[Path] = None) -> Path:
     # Log initial memory usage
     if PSUTIL_AVAILABLE:
         try:
+            import platform
+
             process = psutil.Process()
             memory_info = process.memory_info()
             rss_mb = memory_info.rss / (1024 * 1024)
             vms_mb = memory_info.vms / (1024 * 1024)
-            logger.info(f"Initial Memory: RSS={rss_mb:.1f}MB, VMS={vms_mb:.1f}MB")
+
+            # On macOS, VMS can report misleading values (400+ TB)
+            # Skip VMS reporting if it's unreasonably large
+            if (
+                platform.system() == "Darwin" and vms_mb > 100000
+            ):  # > 100GB is suspicious
+                logger.info(f"Initial Memory: RSS={rss_mb:.1f}MB")
+            else:
+                logger.info(f"Initial Memory: RSS={rss_mb:.1f}MB, VMS={vms_mb:.1f}MB")
         except Exception as e:
             logger.debug(f"Failed to get initial memory info: {e}")
 

claude_mpm/config/socketio_config.py

@@ -10,6 +10,8 @@ WHY configuration management:
 - Supports multiple deployment scenarios (local, PyPI, Docker, etc.)
 - Provides environment-specific defaults
 - Allows runtime configuration overrides
+
+CRITICAL: Ping/pong settings MUST match between client and server to prevent disconnections!
 """
 
 import os
@@ -19,6 +21,33 @@ from typing import Any, Dict, List, Optional
 # Import constants for default values
 from claude_mpm.core.constants import NetworkConfig, RetryConfig, SystemLimits
 
+# Connection stability settings - MUST be consistent between client and server
+CONNECTION_CONFIG = {
+    # Ping/pong intervals (milliseconds for client, seconds for server)
+    'ping_interval_ms': 45000,     # 45 seconds (for client JavaScript)
+    'ping_interval': 45,            # 45 seconds (for server Python)
+    'ping_timeout_ms': 20000,       # 20 seconds (for client JavaScript)  
+    'ping_timeout': 20,             # 20 seconds (for server Python)
+    
+    # Connection management
+    'stale_timeout': 180,           # 3 minutes before considering connection stale
+    'health_check_interval': 30,    # Health check every 30 seconds
+    'event_ttl': 300,              # Keep events for 5 minutes for replay
+    
+    # Client reconnection settings
+    'reconnection_attempts': 5,     # Number of reconnection attempts
+    'reconnection_delay': 1000,     # Initial delay in ms
+    'reconnection_delay_max': 5000, # Maximum delay in ms
+    
+    # Feature flags
+    'enable_extra_heartbeat': False,  # Disable redundant heartbeats
+    'enable_health_monitoring': True,  # Enable connection health monitoring
+    
+    # Buffer settings
+    'max_events_buffer': 1000,      # Maximum events to buffer per client
+    'max_http_buffer_size': 1e8,    # 100MB max buffer for large payloads
+}
+
 
 @dataclass
 class SocketIOConfig:
@@ -29,11 +58,11 @@ class SocketIOConfig:
     port: int = NetworkConfig.DEFAULT_DASHBOARD_PORT
     server_id: Optional[str] = None
 
-    # Connection settings
+    # Connection settings - Use centralized config for consistency
     cors_allowed_origins: str = "*"  # Configure properly for production
-    ping_timeout: int = NetworkConfig.PING_TIMEOUT_STANDARD
-    ping_interval: int = NetworkConfig.PING_INTERVAL_STANDARD
-    max_http_buffer_size: int = 1000000
+    ping_timeout: int = CONNECTION_CONFIG['ping_timeout']  # 20 seconds
+    ping_interval: int = CONNECTION_CONFIG['ping_interval']  # 45 seconds
+    max_http_buffer_size: int = int(CONNECTION_CONFIG['max_http_buffer_size'])
 
     # Compatibility settings
     min_client_version: str = "0.7.0"

claude_mpm/constants.py

@@ -36,6 +36,7 @@ class CLICommands(str, Enum):
     MEMORY = "memory"
     MONITOR = "monitor"
     CONFIG = "config"
+    CONFIGURE = "configure"
     AGGREGATE = "aggregate"
     CLEANUP = "cleanup-memory"
     MCP = "mcp"

claude_mpm/core/socketio_pool.py

@@ -592,7 +592,7 @@ class SocketIOConnectionPool:
 
             # 2-second timeout for connection
             await asyncio.wait_for(
-                client.connect(self.server_url, auth={"token": "dev-token"}, wait=True),
+                client.connect(self.server_url, wait=True),
                 timeout=2.0,
             )
 
@@ -734,8 +734,8 @@ class SocketIOConnectionPool:
     def emit(self, event: str, data: Dict[str, Any]) -> bool:
         """Emit an event through the connection pool.
 
-        This method provides compatibility for the legacy emit() interface
-        by mapping to the modern emit_event() method with appropriate defaults.
+        This method provides compatibility for the legacy emit() interface.
+        For critical hook events, we use direct emission to avoid batching delays.
 
         Args:
             event: Event name (e.g., "claude_event")
@@ -747,10 +747,42 @@ class SocketIOConnectionPool:
         if not SOCKETIO_AVAILABLE or not self._running:
             return False
 
+        # For critical claude_event, use direct emission to avoid batching delays
+        if event == "claude_event":
+            return self._emit_direct(event, data)
+
         # Map to the modern emit_event method using default namespace
         self.emit_event("/", event, data)
         return True
 
+    def _emit_direct(self, event: str, data: Dict[str, Any]) -> bool:
+        """Emit an event directly without batching.
+
+        This is used for critical events that need immediate delivery.
+        """
+        try:
+            # Create a synchronous client for direct emission
+            import socketio
+
+            client = socketio.Client(logger=False, engineio_logger=False)
+
+            # Quick connect, emit, and disconnect
+            client.connect(self.server_url, wait=True, wait_timeout=1.0)
+            client.emit(event, data)
+            client.disconnect()
+
+            # Update stats
+            for stats in self.connection_stats.values():
+                stats.events_sent += 1
+                break
+
+            return True
+        except Exception as e:
+            self.logger.debug(f"Direct emit failed: {e}")
+            # Fall back to batched emission
+            self.emit_event("/", event, data)
+            return True
+
     def get_stats(self) -> Dict[str, Any]:
         """Get connection pool statistics."""
         with self.pool_lock:

claude_mpm/dashboard/static/css/connection-status.css

@@ -0,0 +1,370 @@
+/**
+ * Enhanced Connection Status Styles
+ * Provides visual feedback for connection state and quality
+ */
+
+/* Connection Status Badge Enhancements */
+.status-badge {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    padding: 6px 12px;
+    border-radius: 20px;
+    font-size: 13px;
+    font-weight: 600;
+    transition: all 0.3s ease;
+    position: relative;
+    overflow: hidden;
+}
+
+.status-badge span {
+    display: inline-block;
+    animation: pulse 2s infinite;
+}
+
+/* Connection States */
+.status-connecting {
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    color: white;
+}
+
+.status-connecting span {
+    animation: spin 1s linear infinite;
+}
+
+.status-connected {
+    background: linear-gradient(135deg, #667eea 0%, #4299e1 100%);
+    color: white;
+    box-shadow: 0 2px 10px rgba(66, 153, 225, 0.3);
+}
+
+.status-connected span {
+    color: #68d391;
+    animation: pulse-connected 2s infinite;
+}
+
+.status-reconnecting {
+    background: linear-gradient(135deg, #f6d365 0%, #fda085 100%);
+    color: #744210;
+}
+
+.status-reconnecting span {
+    animation: spin 1s linear infinite;
+}
+
+.status-disconnected {
+    background: linear-gradient(135deg, #e3e3e3 0%, #b8b8b8 100%);
+    color: #4a5568;
+}
+
+.status-stale {
+    background: linear-gradient(135deg, #ffeaa7 0%, #fdcb6e 100%);
+    color: #744210;
+}
+
+.status-stale::after {
+    content: '';
+    position: absolute;
+    top: 0;
+    left: -100%;
+    width: 100%;
+    height: 100%;
+    background: linear-gradient(90deg, transparent, rgba(255,255,255,0.3), transparent);
+    animation: shimmer 2s infinite;
+}
+
+.status-failed {
+    background: linear-gradient(135deg, #fc5c7d 0%, #fc5c7d 100%);
+    color: white;
+}
+
+/* Connection Quality Indicator */
+.connection-quality {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 4px 8px;
+    background: #f7fafc;
+    border-radius: 8px;
+    font-size: 12px;
+}
+
+.quality-bar {
+    width: 60px;
+    height: 6px;
+    background: #e2e8f0;
+    border-radius: 3px;
+    overflow: hidden;
+    position: relative;
+}
+
+.quality-fill {
+    height: 100%;
+    transition: width 0.3s ease, background 0.3s ease;
+    border-radius: 3px;
+}
+
+.quality-good .quality-fill {
+    background: linear-gradient(90deg, #68d391, #48bb78);
+}
+
+.quality-moderate .quality-fill {
+    background: linear-gradient(90deg, #f6d365, #fda085);
+}
+
+.quality-poor .quality-fill {
+    background: linear-gradient(90deg, #fc5c7d, #fc5c7d);
+}
+
+.quality-text {
+    color: #4a5568;
+    font-weight: 500;
+}
+
+/* Latency Display */
+.connection-latency {
+    display: inline-flex;
+    align-items: center;
+    padding: 2px 6px;
+    border-radius: 4px;
+    font-size: 11px;
+    font-weight: 600;
+    font-family: 'SF Mono', Monaco, monospace;
+}
+
+.latency-good {
+    background: #c6f6d5;
+    color: #22543d;
+}
+
+.latency-moderate {
+    background: #fed7aa;
+    color: #7c2d12;
+}
+
+.latency-poor {
+    background: #fed7d7;
+    color: #742a2a;
+}
+
+/* Connection Metrics Panel */
+.connection-metrics {
+    background: white;
+    border-radius: 12px;
+    padding: 16px;
+    box-shadow: 0 2px 8px rgba(0,0,0,0.08);
+    margin-top: 16px;
+}
+
+.metrics-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
+    gap: 12px;
+}
+
+.metric-item {
+    text-align: center;
+    padding: 8px;
+    background: #f7fafc;
+    border-radius: 8px;
+}
+
+.metric-value {
+    font-size: 20px;
+    font-weight: 700;
+    color: #2d3748;
+    display: block;
+}
+
+.metric-label {
+    font-size: 11px;
+    color: #718096;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+    margin-top: 4px;
+}
+
+/* Notification Area */
+.connection-notifications {
+    position: fixed;
+    top: 20px;
+    right: 20px;
+    z-index: 1000;
+    max-width: 320px;
+}
+
+.notification {
+    background: white;
+    padding: 12px 16px;
+    border-radius: 8px;
+    box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+    margin-bottom: 8px;
+    font-size: 14px;
+    opacity: 1;
+    transition: opacity 0.3s ease, transform 0.3s ease;
+    animation: slideIn 0.3s ease;
+    border-left: 4px solid;
+}
+
+.notification-info {
+    border-left-color: #4299e1;
+}
+
+.notification-success {
+    border-left-color: #48bb78;
+    background: #f0fff4;
+}
+
+.notification-warning {
+    border-left-color: #ed8936;
+    background: #fffdf7;
+}
+
+.notification-error {
+    border-left-color: #f56565;
+    background: #fff5f5;
+}
+
+/* Connection Health Badge */
+.connection-health {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    padding: 4px 8px;
+    background: #f7fafc;
+    border-radius: 6px;
+    font-size: 12px;
+}
+
+.health-indicator {
+    width: 8px;
+    height: 8px;
+    border-radius: 50%;
+    animation: pulse 2s infinite;
+}
+
+.health-excellent {
+    background: #48bb78;
+    box-shadow: 0 0 0 2px rgba(72, 187, 120, 0.3);
+}
+
+.health-good {
+    background: #38b2ac;
+    box-shadow: 0 0 0 2px rgba(56, 178, 172, 0.3);
+}
+
+.health-fair {
+    background: #ed8936;
+    box-shadow: 0 0 0 2px rgba(237, 137, 54, 0.3);
+}
+
+.health-poor {
+    background: #f56565;
+    box-shadow: 0 0 0 2px rgba(245, 101, 101, 0.3);
+}
+
+/* Animations */
+@keyframes pulse {
+    0%, 100% {
+        opacity: 1;
+    }
+    50% {
+        opacity: 0.5;
+    }
+}
+
+@keyframes pulse-connected {
+    0%, 100% {
+        transform: scale(1);
+        opacity: 1;
+    }
+    50% {
+        transform: scale(1.2);
+        opacity: 0.8;
+    }
+}
+
+@keyframes spin {
+    from {
+        transform: rotate(0deg);
+    }
+    to {
+        transform: rotate(360deg);
+    }
+}
+
+@keyframes shimmer {
+    to {
+        left: 100%;
+    }
+}
+
+@keyframes slideIn {
+    from {
+        transform: translateX(100%);
+        opacity: 0;
+    }
+    to {
+        transform: translateX(0);
+        opacity: 1;
+    }
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+    .connection-notifications {
+        right: 10px;
+        left: 10px;
+        max-width: none;
+    }
+    
+    .connection-metrics {
+        padding: 12px;
+    }
+    
+    .metrics-grid {
+        grid-template-columns: repeat(2, 1fr);
+    }
+}
+
+/* Dark Mode Support */
+@media (prefers-color-scheme: dark) {
+    .connection-quality {
+        background: #2d3748;
+    }
+    
+    .quality-bar {
+        background: #4a5568;
+    }
+    
+    .quality-text {
+        color: #cbd5e0;
+    }
+    
+    .connection-metrics {
+        background: #2d3748;
+        box-shadow: 0 2px 8px rgba(0,0,0,0.3);
+    }
+    
+    .metric-item {
+        background: #1a202c;
+    }
+    
+    .metric-value {
+        color: #e2e8f0;
+    }
+    
+    .metric-label {
+        color: #a0aec0;
+    }
+    
+    .notification {
+        background: #2d3748;
+        color: #e2e8f0;
+        box-shadow: 0 4px 12px rgba(0,0,0,0.3);
+    }
+    
+    .connection-health {
+        background: #2d3748;
+    }
+}