claude-mpm 5.1.9__py3-none-any.whl → 5.4.22__py3-none-any.whl

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

claude_mpm/cli/parsers/skills_parser.py

@@ -168,9 +168,10 @@ def add_skills_subparser(subparsers) -> argparse.ArgumentParser:
         help="Force redeployment of already deployed skills",
     )
     deploy_github_parser.add_argument(
-        "--all",
+        "--all-skills",
         action="store_true",
-        help="Deploy all available skills (no filtering)",
+        dest="all_skills",
+        help="Deploy ALL available skills (not just agent-referenced). By default, only skills referenced in agent frontmatter are deployed.",
     )
 
     # List available GitHub skills