claude-mpm 5.1.9__py3-none-any.whl → 5.4.48__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/profile_parser.py

@@ -0,0 +1,148 @@
+"""
+Profile command parser for claude-mpm CLI.
+
+WHY: This module provides the profile command for managing deployment profiles
+that control which agents and skills are deployed.
+
+DESIGN DECISION: Provides intuitive subcommands for listing, activating,
+and inspecting profiles to reduce context usage by limiting deployed components.
+"""
+
+import argparse
+
+from ...constants import CLICommands
+from .base_parser import add_common_arguments
+
+
+def add_profile_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the profile subparser for deployment profile management.
+
+    WHY: Users need to manage which agents and skills are deployed to reduce
+    context usage and improve performance. Profiles define enabled/disabled
+    agents and skills for specific workflows.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured profile subparser
+    """
+    # Profile command with subcommands
+    profile_parser = subparsers.add_parser(
+        "profile",
+        help="Manage deployment profiles for agents and skills",
+        description="""
+Deployment profile management for Claude MPM.
+
+Profiles control which agents and skills are deployed, reducing context usage
+by limiting available agents to only what's needed for your workflow.
+
+Available commands:
+  list      List all available profiles
+  set       Set the active profile
+  status    Show current active profile and filtering summary
+  show      Show detailed configuration of a profile
+
+Example workflows:
+  # List available profiles
+  claude-mpm profile list
+
+  # Activate a profile
+  claude-mpm profile set framework-development
+
+  # Check current profile status
+  claude-mpm profile status
+
+  # View profile details
+  claude-mpm profile show framework-development
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(profile_parser)
+
+    # Add subcommands
+    profile_subparsers = profile_parser.add_subparsers(
+        dest="profile_command",
+        help="Profile management commands",
+        metavar="SUBCOMMAND",
+    )
+
+    # List subcommand
+    list_parser = profile_subparsers.add_parser(
+        "list",
+        help="List all available deployment profiles",
+        description="""
+List all profiles found in .claude-mpm/profiles/ directory.
+
+Shows profile names, descriptions, and indicates which profile is currently active.
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(list_parser)
+
+    # Set subcommand
+    set_parser = profile_subparsers.add_parser(
+        "set",
+        help="Set the active deployment profile",
+        description="""
+Set the active deployment profile.
+
+This updates configuration.yaml with the selected profile, which will be
+applied on next startup or when running 'claude-mpm init'.
+
+Examples:
+  # Activate framework development profile
+  claude-mpm profile set framework-development
+
+  # Activate minimal profile for focused work
+  claude-mpm profile set minimal
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(set_parser)
+    set_parser.add_argument(
+        "profile_name",
+        help="Name of profile to activate (without .yaml extension)",
+    )
+
+    # Status subcommand
+    status_parser = profile_subparsers.add_parser(
+        "status",
+        help="Show current active profile and filtering summary",
+        description="""
+Display current active profile with filtering summary.
+
+Shows:
+- Active profile name
+- Number of agents enabled/disabled
+- Number of skills enabled/disabled
+- Disabled skill patterns
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(status_parser)
+
+    # Show subcommand
+    show_parser = profile_subparsers.add_parser(
+        "show",
+        help="Show detailed configuration of a profile",
+        description="""
+Display detailed configuration of a specific profile.
+
+Shows complete lists of enabled/disabled agents and skills, including
+glob patterns for skill filtering.
+
+Examples:
+  # Show framework development profile details
+  claude-mpm profile show framework-development
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    add_common_arguments(show_parser)
+    show_parser.add_argument(
+        "profile_name",
+        help="Name of profile to display (without .yaml extension)",
+    )
+
+    return profile_parser

claude_mpm/cli/parsers/skills_parser.py

@@ -167,11 +167,6 @@ def add_skills_subparser(subparsers) -> argparse.ArgumentParser:
         action="store_true",
         help="Force redeployment of already deployed skills",
     )
-    deploy_github_parser.add_argument(
-        "--all",
-        action="store_true",
-        help="Deploy all available skills (no filtering)",
-    )
 
     # List available GitHub skills
     list_available_parser = skills_subparsers.add_parser(