claude-mpm 4.1.8__py3-none-any.whl → 4.1.11__py3-none-any.whl

claude_mpm/cli/parsers/analyze_parser.py

@@ -0,0 +1,135 @@
+"""
+Parser configuration for analyze command.
+
+WHY: This module adds the analyze subcommand to the CLI for code analysis
+with mermaid diagram generation capabilities.
+
+DESIGN DECISIONS:
+- Support mermaid diagram generation via flags
+- Allow specification of diagram types
+- Enable target directory/file selection
+- Follow existing parser patterns
+"""
+
+from pathlib import Path
+
+from .base_parser import add_common_arguments
+
+
+def add_analyze_subparser(subparsers):
+    """Add analyze command parser.
+
+    WHY: Provides CLI interface for code analysis with mermaid diagram
+    generation, allowing users to visualize their codebase architecture.
+
+    Args:
+        subparsers: The subparsers object from argparse
+    """
+    parser = subparsers.add_parser(
+        "analyze",
+        aliases=["analysis", "code-analyze"],
+        help="Analyze code and generate mermaid diagrams",
+        description="Run code analysis with optional mermaid diagram generation",
+    )
+
+    # Add common arguments
+    add_common_arguments(parser)
+
+    # Analysis target options
+    parser.add_argument(
+        "--target",
+        type=Path,
+        default=Path.cwd(),
+        help="Directory or file to analyze (default: current directory)",
+    )
+
+    parser.add_argument(
+        "--recursive",
+        action="store_true",
+        default=True,
+        help="Recursively analyze subdirectories (default: True)",
+    )
+
+    # Mermaid diagram options
+    mermaid_group = parser.add_argument_group("mermaid diagram options")
+    mermaid_group.add_argument(
+        "--mermaid", action="store_true", help="Enable mermaid diagram generation"
+    )
+
+    mermaid_group.add_argument(
+        "--mermaid-types",
+        nargs="+",
+        choices=[
+            "entry_points",
+            "class_diagram",
+            "sequence",
+            "flowchart",
+            "state",
+            "entity_relationship",
+            "component",
+            "dependency_graph",
+            "call_graph",
+            "architecture",
+        ],
+        default=["entry_points"],
+        help="Types of mermaid diagrams to generate (default: entry_points)",
+    )
+
+    mermaid_group.add_argument(
+        "--save-diagrams", action="store_true", help="Save generated diagrams to files"
+    )
+
+    mermaid_group.add_argument(
+        "--diagram-output",
+        type=Path,
+        help="Directory to save diagrams (default: ./diagrams/)",
+    )
+
+    # Analysis options
+    analysis_group = parser.add_argument_group("analysis options")
+    analysis_group.add_argument(
+        "--agent",
+        default="code-analyzer",
+        help="Agent to use for analysis (default: code-analyzer)",
+    )
+
+    analysis_group.add_argument(
+        "--prompt", type=str, help="Additional prompt/instructions for the analysis"
+    )
+
+    analysis_group.add_argument(
+        "--focus",
+        nargs="+",
+        choices=["security", "performance", "architecture", "quality", "documentation"],
+        help="Focus areas for analysis",
+    )
+
+    # Session options
+    session_group = parser.add_argument_group("session options")
+    session_group.add_argument(
+        "--session-id", type=str, help="Use specific session ID for analysis"
+    )
+
+    session_group.add_argument(
+        "--no-session", action="store_true", help="Run without session management"
+    )
+
+    # Output options
+    output_group = parser.add_argument_group("output options")
+    output_group.add_argument(
+        "--format",
+        choices=["text", "json", "markdown"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    output_group.add_argument(
+        "--output", "-o", type=Path, help="Save analysis output to file"
+    )
+
+    # Note: --verbose/-v is already defined in base_parser, so removed to avoid conflict
+
+    # Import the command function
+    from ..commands.analyze import analyze_command
+
+    parser.set_defaults(func=analyze_command)

claude_mpm/cli/parsers/base_parser.py

@@ -317,6 +317,13 @@ def create_parser(
     except ImportError:
         pass
 
+    try:
+        from .dashboard_parser import add_dashboard_subparser
+
+        add_dashboard_subparser(subparsers)
+    except ImportError:
+        pass
+
     try:
         from .mcp_parser import add_mcp_subparser
 
@@ -338,6 +345,43 @@ def create_parser(
     except ImportError:
         pass
 
+    # Add debug command parser
+    try:
+        from .debug_parser import add_debug_subparser
+
+        add_debug_subparser(subparsers)
+    except ImportError:
+        pass
+
+    # Add analyze command parser
+    try:
+        from .analyze_parser import add_analyze_subparser
+
+        add_analyze_subparser(subparsers)
+    except ImportError:
+        pass
+
+    # Add analyze-code command parser
+    try:
+        from .analyze_code_parser import AnalyzeCodeParser
+
+        parser_obj = AnalyzeCodeParser()
+        analyze_code_parser = subparsers.add_parser(
+            "analyze-code", help=parser_obj.help_text
+        )
+        parser_obj.add_arguments(analyze_code_parser)
+        analyze_code_parser.set_defaults(command="analyze-code")
+    except ImportError:
+        pass
+
+    # Add mpm-init command parser
+    try:
+        from .mpm_init_parser import add_mpm_init_subparser
+
+        add_mpm_init_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/dashboard_parser.py

@@ -0,0 +1,113 @@
+"""
+Dashboard command parser for claude-mpm CLI.
+
+WHY: This module contains all arguments specific to dashboard management,
+providing a clean interface for starting, stopping, and managing the web dashboard.
+
+DESIGN DECISION: Dashboard commands handle web interface management and
+have their own subcommand structure similar to monitor commands.
+"""
+
+import argparse
+
+from ...constants import CLICommands, DashboardCommands
+from .base_parser import add_common_arguments
+
+
+def add_dashboard_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the dashboard subparser with all dashboard management commands.
+
+    WHY: Dashboard management has multiple subcommands for starting, stopping,
+    checking status, and opening the web interface in a browser.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured dashboard subparser
+    """
+    # Dashboard command with subcommands
+    dashboard_parser = subparsers.add_parser(
+        CLICommands.DASHBOARD.value,
+        help="Manage the web dashboard interface for monitoring and analysis",
+    )
+    add_common_arguments(dashboard_parser)
+
+    dashboard_subparsers = dashboard_parser.add_subparsers(
+        dest="dashboard_command", help="Dashboard commands", metavar="SUBCOMMAND"
+    )
+
+    # Start dashboard
+    start_dashboard_parser = dashboard_subparsers.add_parser(
+        DashboardCommands.START.value,
+        help="Start the web dashboard server",
+    )
+    start_dashboard_parser.add_argument(
+        "--port",
+        type=int,
+        default=8765,
+        help="Port to start dashboard on (default: 8765)",
+    )
+    start_dashboard_parser.add_argument(
+        "--host",
+        default="localhost",
+        help="Host to bind to (default: localhost)",
+    )
+    start_dashboard_parser.add_argument(
+        "--background",
+        action="store_true",
+        help="Run dashboard server in background",
+    )
+    start_dashboard_parser.add_argument(
+        "--no-browser",
+        action="store_true",
+        help="Don't open browser automatically",
+    )
+
+    # Stop dashboard
+    stop_dashboard_parser = dashboard_subparsers.add_parser(
+        DashboardCommands.STOP.value,
+        help="Stop the web dashboard server",
+    )
+    stop_dashboard_parser.add_argument(
+        "--port",
+        type=int,
+        default=8765,
+        help="Port of dashboard to stop (default: 8765)",
+    )
+    stop_dashboard_parser.add_argument(
+        "--all",
+        action="store_true",
+        help="Stop all running dashboard instances",
+    )
+
+    # Status dashboard
+    status_dashboard_parser = dashboard_subparsers.add_parser(
+        DashboardCommands.STATUS.value,
+        help="Check dashboard server status",
+    )
+    status_dashboard_parser.add_argument(
+        "--verbose",
+        action="store_true",
+        help="Show detailed status information",
+    )
+    status_dashboard_parser.add_argument(
+        "--show-ports",
+        action="store_true",
+        help="Show status of all ports in the range (8765-8785)",
+    )
+
+    # Open dashboard
+    open_dashboard_parser = dashboard_subparsers.add_parser(
+        DashboardCommands.OPEN.value,
+        help="Open the dashboard in a web browser (starts if not running)",
+    )
+    open_dashboard_parser.add_argument(
+        "--port",
+        type=int,
+        default=8765,
+        help="Port of dashboard to open (default: 8765)",
+    )
+
+    return dashboard_parser

claude_mpm/cli/parsers/debug_parser.py

@@ -0,0 +1,319 @@
+"""
+Debug command parser for claude-mpm CLI.
+
+This module contains all arguments specific to debugging tools,
+providing developer-focused commands for monitoring and analysis.
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_debug_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the debug subparser with all debugging commands.
+
+    This provides professional debugging tools for developers working
+    on claude-mpm, particularly for dashboard and event monitoring.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured debug subparser
+    """
+    # Main debug parser
+    debug_parser = subparsers.add_parser(
+        "debug",
+        help="Development debugging tools",
+        description="Professional debugging tools for claude-mpm developers",
+    )
+
+    # Add common arguments (logging, etc.)
+    add_common_arguments(debug_parser)
+
+    # Create subparsers for debug commands
+    debug_subparsers = debug_parser.add_subparsers(
+        dest="debug_command", help="Debug commands", metavar="SUBCOMMAND", required=True
+    )
+
+    # SocketIO event debugging
+    _add_socketio_parser(debug_subparsers)
+
+    # Connection debugging
+    _add_connections_parser(debug_subparsers)
+
+    # Services debugging
+    _add_services_parser(debug_subparsers)
+
+    # Agents debugging
+    _add_agents_parser(debug_subparsers)
+
+    # Hooks debugging
+    _add_hooks_parser(debug_subparsers)
+
+    # Cache debugging
+    _add_cache_parser(debug_subparsers)
+
+    # Performance debugging
+    _add_performance_parser(debug_subparsers)
+
+    return debug_parser
+
+
+def _add_socketio_parser(subparsers):
+    """Add SocketIO debugging subcommand."""
+    socketio_parser = subparsers.add_parser(
+        "socketio",
+        help="Monitor and debug SocketIO events in real-time",
+        aliases=["events", "socket"],
+        description="""
+Professional SocketIO event monitoring tool for dashboard development.
+
+This tool provides real-time monitoring of all SocketIO events with:
+- Live event streaming with formatted output
+- Event statistics and aggregation
+- Tool usage tracking
+- Session monitoring
+- Connection health checks
+- Event filtering and export capabilities
+
+Examples:
+  # Monitor all events in real-time
+  claude-mpm debug socketio
+
+  # Show event summary statistics
+  claude-mpm debug socketio --summary
+
+  # Filter specific event types
+  claude-mpm debug socketio --filter PreToolUse PostToolUse
+
+  # Save events to file for analysis
+  claude-mpm debug socketio --output events.jsonl
+
+  # Connect to specific server
+  claude-mpm debug socketio --host localhost --port 8765
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+
+    # Connection settings
+    conn_group = socketio_parser.add_argument_group("connection settings")
+    conn_group.add_argument(
+        "--host", default="localhost", help="SocketIO server host (default: localhost)"
+    )
+    conn_group.add_argument(
+        "--port", type=int, default=8765, help="SocketIO server port (default: 8765)"
+    )
+    conn_group.add_argument(
+        "--max-reconnect",
+        type=int,
+        default=10,
+        help="Maximum reconnection attempts (default: 10)",
+    )
+    conn_group.add_argument(
+        "--reconnect-delay",
+        type=float,
+        default=1.0,
+        help="Reconnection delay in seconds (default: 1.0)",
+    )
+
+    # Display modes (mutually exclusive)
+    display_group = socketio_parser.add_argument_group("display modes")
+    mode_group = display_group.add_mutually_exclusive_group()
+    mode_group.add_argument(
+        "--live",
+        action="store_true",
+        help="Live event monitoring with formatted output (default)",
+    )
+    mode_group.add_argument(
+        "--summary",
+        action="store_true",
+        help="Show aggregated event statistics and summary",
+    )
+    mode_group.add_argument(
+        "--raw", action="store_true", help="Display raw JSON output for each event"
+    )
+    mode_group.add_argument(
+        "--pretty",
+        action="store_true",
+        help="Enhanced formatted output with colors and icons",
+    )
+
+    # Filtering and output
+    filter_group = socketio_parser.add_argument_group("filtering and output")
+    filter_group.add_argument(
+        "--filter",
+        nargs="+",
+        dest="filter_types",
+        metavar="TYPE",
+        help="Filter specific event types (e.g., PreToolUse PostToolUse)",
+    )
+    filter_group.add_argument(
+        "--output", "-o", metavar="FILE", help="Save events to file in JSONL format"
+    )
+    filter_group.add_argument(
+        "--quiet",
+        "-q",
+        action="store_true",
+        help="Suppress output except errors (useful with --output)",
+    )
+
+
+def _add_connections_parser(subparsers):
+    """Add connections debugging subcommand."""
+    connections_parser = subparsers.add_parser(
+        "connections",
+        help="Show active SocketIO server connections",
+        aliases=["conn", "servers"],
+        description="""
+Display information about active SocketIO servers and their status.
+
+This command shows:
+- All running SocketIO server instances
+- Port numbers and process IDs
+- Connection health status
+- Server start times
+
+Examples:
+  # Show all active servers
+  claude-mpm debug connections
+
+  # Show detailed information
+  claude-mpm debug connections --verbose
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+
+    connections_parser.add_argument(
+        "--verbose",
+        "-v",
+        action="store_true",
+        help="Show detailed connection information in JSON format",
+    )
+    connections_parser.add_argument(
+        "--check-health",
+        action="store_true",
+        help="Perform health checks on each server",
+    )
+    connections_parser.add_argument(
+        "--cleanup", action="store_true", help="Clean up stale server entries"
+    )
+
+
+def _add_services_parser(subparsers):
+    """Add services debugging subcommand."""
+    services_parser = subparsers.add_parser(
+        "services",
+        help="Debug service container and dependencies",
+        description="Inspect services, dependencies, and health status",
+    )
+
+    services_group = services_parser.add_mutually_exclusive_group()
+    services_group.add_argument(
+        "--list", action="store_true", help="List all registered services"
+    )
+    services_group.add_argument(
+        "--status", action="store_true", help="Show service health status"
+    )
+    services_group.add_argument(
+        "--dependencies", action="store_true", help="Show service dependency graph"
+    )
+    services_group.add_argument(
+        "--trace",
+        metavar="SERVICE",
+        help="Trace service resolution for specific service",
+    )
+
+
+def _add_agents_parser(subparsers):
+    """Add agents debugging subcommand."""
+    agents_parser = subparsers.add_parser(
+        "agents",
+        help="Debug deployed agents and memory",
+        description="Inspect deployed agents, memory, and traces",
+    )
+
+    agents_group = agents_parser.add_mutually_exclusive_group()
+    agents_group.add_argument(
+        "--deployed", action="store_true", help="List all deployed agents"
+    )
+    agents_group.add_argument(
+        "--memory", action="store_true", help="Show agent memory status"
+    )
+    agents_group.add_argument(
+        "--trace", metavar="AGENT", help="Trace specific agent execution"
+    )
+    agents_parser.add_argument(
+        "--verbose", "-v", action="store_true", help="Show detailed information"
+    )
+
+
+def _add_hooks_parser(subparsers):
+    """Add hooks debugging subcommand."""
+    hooks_parser = subparsers.add_parser(
+        "hooks",
+        help="Debug hook system",
+        description="List hooks, trace execution, analyze performance",
+    )
+
+    hooks_group = hooks_parser.add_mutually_exclusive_group()
+    hooks_group.add_argument(
+        "--list", action="store_true", help="List all registered hooks"
+    )
+    hooks_group.add_argument(
+        "--trace", metavar="HOOK", help="Trace specific hook execution"
+    )
+    hooks_group.add_argument(
+        "--performance", action="store_true", help="Analyze hook performance"
+    )
+    hooks_parser.add_argument(
+        "--test", action="store_true", help="Run test execution when tracing"
+    )
+
+
+def _add_cache_parser(subparsers):
+    """Add cache debugging subcommand."""
+    cache_parser = subparsers.add_parser(
+        "cache",
+        help="Debug cache system",
+        description="Inspect, clear, and analyze cache",
+    )
+
+    cache_group = cache_parser.add_mutually_exclusive_group()
+    cache_group.add_argument(
+        "--inspect", action="store_true", help="Inspect cache contents"
+    )
+    cache_group.add_argument("--clear", action="store_true", help="Clear all cache")
+    cache_group.add_argument(
+        "--stats", action="store_true", help="Show cache performance statistics"
+    )
+    cache_parser.add_argument(
+        "--verbose", "-v", action="store_true", help="Show detailed cache information"
+    )
+    cache_parser.add_argument(
+        "--confirm",
+        "-y",
+        action="store_true",
+        help="Skip confirmation for clear operation",
+    )
+
+
+def _add_performance_parser(subparsers):
+    """Add performance debugging subcommand."""
+    performance_parser = subparsers.add_parser(
+        "performance",
+        help="Performance profiling and analysis",
+        description="Profile operations and analyze bottlenecks",
+    )
+
+    perf_group = performance_parser.add_mutually_exclusive_group()
+    perf_group.add_argument(
+        "--profile",
+        metavar="OPERATION",
+        help="Profile specific operation (agent_load, service_init, cache_ops, memory_ops)",
+    )
+    perf_group.add_argument(
+        "--benchmark", action="store_true", help="Run performance benchmarks"
+    )