claude-mpm 5.0.9__py3-none-any.whl → 5.6.23__py3-none-any.whl

claude_mpm/cli/parsers/auto_configure_parser.py

@@ -88,6 +88,19 @@ Examples:
         help="Skip confirmation prompts and deploy automatically",
     )
 
+    # Scope selection
+    scope_group = auto_configure_parser.add_mutually_exclusive_group()
+    scope_group.add_argument(
+        "--agents-only",
+        action="store_true",
+        help="Configure agents only (skip skills)",
+    )
+    scope_group.add_argument(
+        "--skills-only",
+        action="store_true",
+        help="Configure skills only (skip agents)",
+    )
+
     # Configuration options
     auto_configure_parser.add_argument(
         "--min-confidence",
@@ -105,141 +118,3 @@ Examples:
     )
 
     return auto_configure_parser
-
-
-def add_agents_detect_subparser(agents_subparsers) -> argparse.ArgumentParser:
-    """
-    Add the agents detect subparser for toolchain detection.
-
-    WHY: Allows users to see what toolchain is detected without making changes,
-    useful for debugging and verification.
-
-    Args:
-        agents_subparsers: The agents subparsers object
-
-    Returns:
-        The configured detect subparser
-    """
-    detect_parser = agents_subparsers.add_parser(
-        "detect",
-        help="Detect project toolchain without deploying",
-        description="""
-Detect and display project toolchain without making any changes.
-
-This command analyzes your project to detect:
-  • Programming languages and versions
-  • Frameworks and libraries
-  • Deployment targets and platforms
-
-Useful for debugging toolchain detection and verifying what would be
-detected before running auto-configure.
-        """,
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  # Detect toolchain in current directory
-  claude-mpm agents detect
-
-  # Detect with verbose output showing evidence
-  claude-mpm agents detect --verbose
-
-  # JSON output for scripting
-  claude-mpm agents detect --json
-
-  # Detect specific project
-  claude-mpm agents detect --project-path /path/to/project
-        """,
-    )
-    add_common_arguments(detect_parser)
-
-    detect_parser.add_argument(
-        "--project-path",
-        type=Path,
-        metavar="PATH",
-        help="Project path to analyze (default: current directory)",
-    )
-
-    return detect_parser
-
-
-def add_agents_recommend_subparser(
-    agents_subparsers,
-) -> argparse.ArgumentParser:
-    """
-    Add the agents recommend subparser for agent recommendations.
-
-    WHY: Allows users to see what agents would be recommended without deploying,
-    useful for reviewing recommendations before committing to deployment.
-
-    Args:
-        agents_subparsers: The agents subparsers object
-
-    Returns:
-        The configured recommend subparser
-    """
-    recommend_parser = agents_subparsers.add_parser(
-        "recommend",
-        help="Show recommended agents without deploying",
-        description="""
-Show recommended agents based on project toolchain without deploying.
-
-This command analyzes your project toolchain and recommends appropriate
-agents with detailed reasoning for each recommendation. No changes are
-made to your project.
-
-Useful for:
-  • Reviewing recommendations before deployment
-  • Understanding why agents are recommended
-  • Adjusting confidence thresholds
-        """,
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  # Show recommendations with reasoning
-  claude-mpm agents recommend
-
-  # Require 90% confidence for recommendations
-  claude-mpm agents recommend --min-confidence 0.9
-
-  # JSON output for scripting
-  claude-mpm agents recommend --json
-
-  # Hide detailed reasoning
-  claude-mpm agents recommend --no-reasoning
-
-  # Recommend for specific project
-  claude-mpm agents recommend --project-path /path/to/project
-        """,
-    )
-    add_common_arguments(recommend_parser)
-
-    recommend_parser.add_argument(
-        "--project-path",
-        type=Path,
-        metavar="PATH",
-        help="Project path to analyze (default: current directory)",
-    )
-
-    recommend_parser.add_argument(
-        "--min-confidence",
-        type=float,
-        default=0.8,
-        metavar="FLOAT",
-        help="Minimum confidence threshold for recommendations (0.0-1.0, default: 0.8)",
-    )
-
-    recommend_parser.add_argument(
-        "--show-reasoning",
-        action="store_true",
-        default=True,
-        help="Show detailed reasoning for recommendations (default)",
-    )
-
-    recommend_parser.add_argument(
-        "--no-reasoning",
-        dest="show_reasoning",
-        action="store_false",
-        help="Hide detailed reasoning for recommendations",
-    )
-
-    return recommend_parser

claude_mpm/cli/parsers/base_parser.py

@@ -125,7 +125,7 @@ def _get_enhanced_version(base_version: str) -> str:
 
         if enhanced and enhanced != base_version:
             return enhanced
-    except Exception:
+    except Exception:  # nosec B110
         # If anything fails, fall back to base version
         pass
 
@@ -292,6 +292,21 @@ def add_top_level_run_arguments(parser: argparse.ArgumentParser) -> None:
         action="store_true",
         help="Force rebuild of all system agents by deleting local claude-mpm agents",
     )
+    run_group.add_argument(
+        "--force-sync",
+        action="store_true",
+        help="Force refresh agents and skills from remote repos, bypassing ETag cache",
+    )
+    run_group.add_argument(
+        "--chrome",
+        action="store_true",
+        help="Enable Claude in Chrome integration (passed to Claude Code)",
+    )
+    run_group.add_argument(
+        "--no-chrome",
+        action="store_true",
+        help="Disable Claude in Chrome integration (passed to Claude Code)",
+    )
 
     # Dependency checking options (for backward compatibility at top level)
     dep_group_top = parser.add_argument_group(
@@ -438,6 +453,13 @@ def create_parser(
     except ImportError:
         pass
 
+    try:
+        from .profile_parser import add_profile_subparser
+
+        add_profile_subparser(subparsers)
+    except ImportError:
+        pass
+
     try:
         from .monitor_parser import add_monitor_subparser
 
@@ -480,6 +502,13 @@ def create_parser(
     except ImportError:
         pass
 
+    try:
+        from .commander_parser import add_commander_subparser
+
+        add_commander_subparser(subparsers)
+    except ImportError:
+        pass
+
     # Add uninstall command parser
     try:
         from ..commands.uninstall import add_uninstall_parser
@@ -594,6 +623,64 @@ def create_parser(
             action="store_true",
             help="Skip confirmation prompts",
         )
+
+        # Add autotodos command for auto-generating todos from hook errors
+        autotodos_parser = subparsers.add_parser(
+            "autotodos",
+            help="Auto-generate todos from hook errors and delegation patterns",
+        )
+        autotodos_parser.add_argument(
+            "autotodos_command",
+            nargs="?",
+            choices=["list", "inject", "clear", "status", "scan", "violations"],
+            help="AutoTodos subcommand",
+        )
+        autotodos_parser.add_argument(
+            "text",
+            nargs="?",
+            help="Text to scan for delegation patterns (scan command only)",
+        )
+        autotodos_parser.add_argument(
+            "--format",
+            choices=["table", "json"],
+            default="table",
+            help="Output format for list/scan commands",
+        )
+        autotodos_parser.add_argument(
+            "--output",
+            help="Output file path for inject command",
+        )
+        autotodos_parser.add_argument(
+            "--error-key",
+            help="Specific error key to clear",
+        )
+        autotodos_parser.add_argument(
+            "--event-type",
+            choices=["error", "violation", "all"],
+            default="all",
+            help="Type of events to clear (clear command only)",
+        )
+        autotodos_parser.add_argument(
+            "--file",
+            "-f",
+            help="Scan text from file (scan command only)",
+        )
+        autotodos_parser.add_argument(
+            "--save",
+            action="store_true",
+            help="Save detections to event log (scan command only)",
+        )
+        autotodos_parser.add_argument(
+            "-y",
+            "--yes",
+            action="store_true",
+            help="Skip confirmation prompts",
+        )
+
+        # Add summarize command
+        from ..commands.summarize import add_summarize_parser
+
+        add_summarize_parser(subparsers)
     except ImportError:
         # Commands module may not be available during testing or refactoring
         pass

claude_mpm/cli/parsers/commander_parser.py

@@ -0,0 +1,116 @@
+"""
+Commander parser module for claude-mpm CLI.
+
+WHY: This module provides the commander subcommand for interactive instance management
+and chat interface.
+
+DESIGN DECISION: Uses subparser pattern consistent with other commands (run, agents, etc.)
+to provide a clean interface for Commander mode.
+"""
+
+import argparse
+from pathlib import Path
+
+
+def add_commander_subparser(subparsers: argparse._SubParsersAction) -> None:
+    """
+    Add commander subcommand parser.
+
+    WHY: Provides interactive mode for managing and chatting with multiple Claude instances.
+
+    Args:
+        subparsers: The subparsers object to add the commander parser to
+    """
+    commander_parser = subparsers.add_parser(
+        "commander",
+        help="Launch Commander multi-project orchestration (ALPHA)",
+        description="""
+Commander Mode - Multi-Project Orchestration (ALPHA)
+
+The commander subcommand auto-starts the Commander daemon (if not already running)
+and launches an interactive REPL for managing multiple Claude Code instances.
+
+Commander provides:
+- Auto-starting daemon that manages project lifecycles
+- Interactive REPL for controlling instances
+- Tmux-based session management
+- Real-time output monitoring
+- REST API for external control (http://127.0.0.1:8765)
+
+REPL Commands:
+  list, ls, instances   List active instances
+  start <path>          Start new instance at path
+    --framework <cc|mpm>  Specify framework (default: cc)
+    --name <name>         Specify instance name (default: dir name)
+  stop <name>           Stop an instance
+  connect <name>        Connect to an instance
+  disconnect            Disconnect from current instance
+  status                Show current session status
+  help                  Show help message
+  exit, quit, q         Exit Commander
+
+Natural Language:
+  When connected to an instance, any input that is not a built-in
+  command will be sent to the connected instance as a message.
+
+Examples:
+  # Start daemon and launch interactive chat
+  claude-mpm commander
+
+  # Start daemon only (no chat interface)
+  claude-mpm commander --daemon-only
+
+  # Use custom port
+  claude-mpm commander --port 9000
+
+  # In REPL:
+  > start ~/myproject --framework cc --name myapp
+  > connect myapp
+  > Fix the authentication bug in login.py
+  > disconnect
+  > exit
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+
+    # Optional: Port for internal services
+    commander_parser.add_argument(
+        "--port",
+        type=int,
+        default=8766,  # NetworkPorts.COMMANDER_DEFAULT
+        help="Port for internal services (default: 8766)",
+    )
+
+    # Optional: State directory
+    commander_parser.add_argument(
+        "--state-dir",
+        type=Path,
+        help="Directory for state persistence (optional)",
+    )
+
+    # Debug mode
+    commander_parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Enable debug logging",
+    )
+
+    # Daemon auto-start options
+    commander_parser.add_argument(
+        "--host",
+        type=str,
+        default="127.0.0.1",
+        help="Daemon host (default: 127.0.0.1)",
+    )
+
+    commander_parser.add_argument(
+        "--no-chat",
+        action="store_true",
+        help="Start daemon only without interactive chat",
+    )
+
+    commander_parser.add_argument(
+        "--daemon-only",
+        action="store_true",
+        help="Alias for --no-chat (start daemon only)",
+    )

claude_mpm/cli/parsers/config_parser.py

@@ -1,14 +1,15 @@
 """
 Config command parser for claude-mpm CLI.
 
-WHY: This module provides the config command which is synonymous with configure.
-Both launch the interactive configuration TUI.
+WHY: This module provides the unified config command with subcommands for
+auto-configuration, viewing, validation, and status checks.
 
-DESIGN DECISION: 'config' and 'configure' are aliases - both commands provide
-identical functionality through the interactive configuration interface.
+DESIGN DECISION: 'config' provides both auto-configuration (default) and
+manual configuration management through subcommands.
 """
 
 import argparse
+from pathlib import Path
 
 from ...constants import CLICommands
 from .base_parser import add_common_arguments
@@ -16,11 +17,10 @@ from .base_parser import add_common_arguments
 
 def add_config_subparser(subparsers) -> argparse.ArgumentParser:
     """
-    Add the config subparser (alias for configure).
+    Add the unified config subparser with all configuration subcommands.
 
-    WHY: 'config' and 'configure' are synonymous commands that both launch
-    the interactive configuration interface. This provides a consistent
-    parser setup matching the configure command.
+    WHY: 'config' provides comprehensive configuration management including
+    auto-detection, manual viewing, validation, and status checks.
 
     Args:
         subparsers: The subparsers object from the main parser
@@ -28,111 +28,181 @@ def add_config_subparser(subparsers) -> argparse.ArgumentParser:
     Returns:
         The configured config subparser
     """
-    # Config command - alias for configure (interactive configuration)
+    # Config command with subcommands
     config_parser = subparsers.add_parser(
         CLICommands.CONFIG.value,
-        help="Interactive configuration interface for managing agents and behaviors (alias for 'configure')",
-        description="Launch an interactive Rich-based menu for configuring claude-mpm agents, templates, and behavior files",
-    )
+        help="Unified configuration management with auto-detection and manual viewing",
+        description="""
+Unified configuration management for Claude MPM.
 
-    # Add common arguments
-    add_common_arguments(config_parser)
+Available commands:
+  auto        Auto-configure agents and skills based on detected toolchain (default)
+  view        View current configuration settings
+  validate    Validate configuration files
+  status      Show configuration health and status
 
-    # Configuration scope options
-    scope_group = config_parser.add_argument_group("configuration scope")
-    scope_group.add_argument(
-        "--scope",
-        choices=["project", "user"],
-        default="project",
-        help="Configuration scope to manage (default: project)",
+Running 'config' with no subcommand defaults to 'auto' in preview mode.
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
     )
+    add_common_arguments(config_parser)
 
-    # Direct navigation options (skip main menu)
-    nav_group = config_parser.add_argument_group("direct navigation")
-    nav_group.add_argument(
-        "--agents", action="store_true", help="Jump directly to agent management"
+    # Add subcommands
+    config_subparsers = config_parser.add_subparsers(
+        dest="config_command", help="Configuration commands", metavar="SUBCOMMAND"
+    )
+
+    # Auto-configure subcommand (default)
+    auto_parser = config_subparsers.add_parser(
+        "auto",
+        help="Auto-configure agents and skills based on detected toolchain",
+        description="""
+Auto-configure agents and skills for your project based on detected toolchain.
+
+This command analyzes your project to detect languages, frameworks, and
+deployment targets, then recommends and deploys appropriate specialized
+agents and skills automatically.
+
+The command provides safety features including:
+  • Preview mode to see changes before applying
+  • Confidence thresholds to ensure quality matches
+  • Validation gates to block invalid configurations
+  • Rollback on failure to maintain consistency
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(auto_parser)
+
+    # Configuration mode
+    mode_group = auto_parser.add_mutually_exclusive_group()
+    mode_group.add_argument(
+        "--preview",
+        "--dry-run",
+        dest="preview",
+        action="store_true",
+        help="Show what would be configured without deploying (preview mode)",
     )
-    nav_group.add_argument(
-        "--templates", action="store_true", help="Jump directly to template editing"
+    mode_group.add_argument(
+        "--yes",
+        "-y",
+        action="store_true",
+        help="Skip confirmation prompts and deploy automatically",
     )
-    nav_group.add_argument(
-        "--behaviors",
+
+    # Scope selection
+    scope_group = auto_parser.add_mutually_exclusive_group()
+    scope_group.add_argument(
+        "--agents-only",
         action="store_true",
-        help="Jump directly to behavior file management",
+        help="Configure agents only (skip skills)",
     )
-    nav_group.add_argument(
-        "--startup",
+    scope_group.add_argument(
+        "--skills-only",
         action="store_true",
-        help="Configure startup services and agents",
+        help="Configure skills only (skip agents)",
+    )
+
+    # Configuration options
+    auto_parser.add_argument(
+        "--min-confidence",
+        type=float,
+        default=0.8,
+        metavar="FLOAT",
+        help="Minimum confidence threshold for recommendations (0.0-1.0, default: 0.8)",
+    )
+
+    auto_parser.add_argument(
+        "--project-path",
+        type=Path,
+        metavar="PATH",
+        help="Project path to analyze (default: current directory)",
     )
-    nav_group.add_argument(
-        "--version-info",
+
+    auto_parser.add_argument(
+        "--json",
         action="store_true",
-        help="Display version information and exit",
+        help="Output results in JSON format",
     )
 
-    # Non-interactive options
-    noninteractive_group = config_parser.add_argument_group("non-interactive options")
-    noninteractive_group.add_argument(
-        "--list-agents", action="store_true", help="List all available agents and exit"
+    # View subcommand
+    view_parser = config_subparsers.add_parser(
+        "view",
+        help="View current configuration settings",
     )
-    noninteractive_group.add_argument(
-        "--enable-agent",
+    add_common_arguments(view_parser)
+
+    view_parser.add_argument(
+        "--section",
         type=str,
-        metavar="AGENT_NAME",
-        help="Enable a specific agent and exit",
+        metavar="SECTION",
+        help="Specific configuration section to view (agents, memory, websocket, etc.)",
     )
-    noninteractive_group.add_argument(
-        "--disable-agent",
-        type=str,
-        metavar="AGENT_NAME",
-        help="Disable a specific agent and exit",
+    view_parser.add_argument(
+        "--format",
+        choices=["yaml", "json", "table", "text"],
+        default="table",
+        help="Output format (default: table)",
     )
-    noninteractive_group.add_argument(
-        "--export-config",
-        type=str,
-        metavar="FILE",
-        help="Export current configuration to a file",
+    view_parser.add_argument(
+        "--show-defaults",
+        action="store_true",
+        help="Include default values in output",
     )
-    noninteractive_group.add_argument(
-        "--import-config",
-        type=str,
-        metavar="FILE",
-        help="Import configuration from a file",
+    view_parser.add_argument(
+        "--config-file",
+        type=Path,
+        metavar="PATH",
+        help="Specific config file to view (default: all)",
     )
 
-    # Hook management options
-    hooks_group = config_parser.add_argument_group("hook management")
-    hooks_group.add_argument(
-        "--install-hooks",
-        action="store_true",
-        help="Install Claude MPM hooks for Claude Code integration",
+    # Validate subcommand
+    validate_parser = config_subparsers.add_parser(
+        "validate",
+        help="Validate configuration files for correctness",
     )
-    hooks_group.add_argument(
-        "--verify-hooks",
-        action="store_true",
-        help="Verify that Claude MPM hooks are properly installed",
+    add_common_arguments(validate_parser)
+
+    validate_parser.add_argument(
+        "--config-file",
+        type=Path,
+        metavar="PATH",
+        help="Validate specific config file (default: all)",
     )
-    hooks_group.add_argument(
-        "--uninstall-hooks",
+    validate_parser.add_argument(
+        "--strict",
         action="store_true",
-        help="Uninstall Claude MPM hooks",
+        help="Use strict validation rules",
     )
-    hooks_group.add_argument(
-        "--force",
+    validate_parser.add_argument(
+        "--fix",
         action="store_true",
-        help="Force reinstallation of hooks even if they already exist",
+        help="Attempt to fix validation errors automatically",
     )
 
-    # Display options
-    display_group = config_parser.add_argument_group("display options")
-    display_group.add_argument(
-        "--no-colors",
-        action="store_true",
-        help="Disable colored output in the interface",
+    # Status subcommand
+    status_parser = config_subparsers.add_parser(
+        "status",
+        help="Show configuration health and status",
     )
-    display_group.add_argument(
-        "--compact", action="store_true", help="Use compact display mode"
+    add_common_arguments(status_parser)
+
+    # Note: --verbose is provided by add_common_arguments()
+    status_parser.add_argument(
+        "--check-response-logging",
+        action="store_true",
+        help="Check response logging configuration",
+    )
+    status_parser.add_argument(
+        "--format",
+        choices=["yaml", "json", "text"],
+        default="text",
+        help="Output format (default: text)",
+    )
+    status_parser.add_argument(
+        "--config-file",
+        type=Path,
+        metavar="PATH",
+        help="Specific config file to check (default: all)",
     )
 
     return config_parser