claude-mpm 4.24.0__py3-none-any.whl → 5.4.41__py3-none-any.whl

claude_mpm/cli/parsers/base_parser.py

@@ -389,6 +389,27 @@ def create_parser(
     except ImportError:
         pass
 
+    try:
+        from .source_parser import add_source_subparser
+
+        add_source_subparser(subparsers)
+    except ImportError:
+        pass
+
+    try:
+        from .skill_source_parser import add_skill_source_subparser
+
+        add_skill_source_subparser(subparsers)
+    except ImportError:
+        pass
+
+    try:
+        from .agent_source_parser import add_agent_source_subparser
+
+        add_agent_source_subparser(subparsers)
+    except ImportError:
+        pass
+
     try:
         from .auto_configure_parser import add_auto_configure_subparser
 
@@ -417,6 +438,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
 
@@ -532,6 +560,10 @@ def create_parser(
 
         add_doctor_parser(subparsers)
 
+        from ..commands.postmortem import add_postmortem_parser
+
+        add_postmortem_parser(subparsers)
+
         # Add upgrade command
         from ..commands.upgrade import add_upgrade_parser
 
@@ -541,6 +573,39 @@ def create_parser(
         from ..commands.verify import add_parser as add_verify_parser
 
         add_verify_parser(subparsers)
+
+        # Add hook-errors command for managing hook error memory
+        hook_errors_parser = subparsers.add_parser(
+            "hook-errors",
+            help="Manage hook error memory and diagnostics",
+        )
+        hook_errors_parser.add_argument(
+            "hook_errors_command",
+            nargs="?",
+            choices=["list", "summary", "clear", "diagnose", "status"],
+            help="Hook errors subcommand",
+        )
+        hook_errors_parser.add_argument(
+            "--format",
+            choices=["table", "json"],
+            default="table",
+            help="Output format for list command",
+        )
+        hook_errors_parser.add_argument(
+            "--hook-type",
+            help="Filter by specific hook type",
+        )
+        hook_errors_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/config_parser.py

@@ -1,27 +1,26 @@
-from pathlib import Path
-
 """
 Config command parser for claude-mpm CLI.
 
-WHY: This module contains all arguments specific to configuration management,
-extracted from the monolithic parser.py for better organization.
+WHY: This module provides the unified config command with subcommands for
+auto-configuration, viewing, validation, and status checks.
 
-DESIGN DECISION: Configuration commands handle validation and management
-of claude-mpm settings and warrant their own module.
+DESIGN DECISION: 'config' provides both auto-configuration (default) and
+manual configuration management through subcommands.
 """
 
 import argparse
+from pathlib import Path
 
-from ...constants import CLICommands, ConfigCommands
+from ...constants import CLICommands
 from .base_parser import add_common_arguments
 
 
 def add_config_subparser(subparsers) -> argparse.ArgumentParser:
     """
-    Add the config subparser with all configuration management commands.
+    Add the unified config subparser with all configuration subcommands.
 
-    WHY: Configuration management has multiple subcommands for validation,
-    viewing, and editing that need their own argument structures.
+    WHY: 'config' provides comprehensive configuration management including
+    auto-detection, manual viewing, validation, and status checks.
 
     Args:
         subparsers: The subparsers object from the main parser
@@ -31,55 +30,179 @@ def add_config_subparser(subparsers) -> argparse.ArgumentParser:
     """
     # Config command with subcommands
     config_parser = subparsers.add_parser(
-        CLICommands.CONFIG.value, help="Validate and manage configuration"
+        CLICommands.CONFIG.value,
+        help="Unified configuration management with auto-detection and manual viewing",
+        description="""
+Unified configuration management for Claude MPM.
+
+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
+
+Running 'config' with no subcommand defaults to 'auto' in preview mode.
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
     )
     add_common_arguments(config_parser)
 
+    # Add subcommands
     config_subparsers = config_parser.add_subparsers(
-        dest="config_command", help="Config commands", metavar="SUBCOMMAND"
+        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)",
+    )
+    mode_group.add_argument(
+        "--yes",
+        "-y",
+        action="store_true",
+        help="Skip confirmation prompts and deploy automatically",
+    )
+
+    # Scope selection
+    scope_group = auto_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_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)",
     )
 
-    # Validate config
-    validate_config_parser = config_subparsers.add_parser(
-        ConfigCommands.VALIDATE.value, help="Validate configuration files"
+    auto_parser.add_argument(
+        "--project-path",
+        type=Path,
+        metavar="PATH",
+        help="Project path to analyze (default: current directory)",
     )
-    validate_config_parser.add_argument(
+
+    auto_parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output results in JSON format",
+    )
+
+    # View subcommand
+    view_parser = config_subparsers.add_parser(
+        "view",
+        help="View current configuration settings",
+    )
+    add_common_arguments(view_parser)
+
+    view_parser.add_argument(
+        "--section",
+        type=str,
+        metavar="SECTION",
+        help="Specific configuration section to view (agents, memory, websocket, etc.)",
+    )
+    view_parser.add_argument(
+        "--format",
+        choices=["yaml", "json", "table", "text"],
+        default="table",
+        help="Output format (default: table)",
+    )
+    view_parser.add_argument(
+        "--show-defaults",
+        action="store_true",
+        help="Include default values in output",
+    )
+    view_parser.add_argument(
         "--config-file",
         type=Path,
-        help="Specific config file to validate (default: all)",
+        metavar="PATH",
+        help="Specific config file to view (default: all)",
     )
-    validate_config_parser.add_argument(
-        "--strict", action="store_true", help="Use strict validation rules"
+
+    # Validate subcommand
+    validate_parser = config_subparsers.add_parser(
+        "validate",
+        help="Validate configuration files for correctness",
     )
-    validate_config_parser.add_argument(
+    add_common_arguments(validate_parser)
+
+    validate_parser.add_argument(
+        "--config-file",
+        type=Path,
+        metavar="PATH",
+        help="Validate specific config file (default: all)",
+    )
+    validate_parser.add_argument(
+        "--strict",
+        action="store_true",
+        help="Use strict validation rules",
+    )
+    validate_parser.add_argument(
         "--fix",
         action="store_true",
         help="Attempt to fix validation errors automatically",
     )
 
-    # View config
-    view_config_parser = config_subparsers.add_parser(
-        ConfigCommands.VIEW.value, help="View current configuration"
+    # Status subcommand
+    status_parser = config_subparsers.add_parser(
+        "status",
+        help="Show configuration health and status",
     )
-    view_config_parser.add_argument(
-        "--section", help="Specific configuration section to view"
+    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",
     )
-    view_config_parser.add_argument(
+    status_parser.add_argument(
         "--format",
-        choices=["yaml", "json", "table"],
-        default="yaml",
-        help="Output format (default: yaml)",
+        choices=["yaml", "json", "text"],
+        default="text",
+        help="Output format (default: text)",
     )
-    view_config_parser.add_argument(
-        "--show-defaults", action="store_true", help="Include default values in output"
-    )
-
-    # Status config
-    status_config_parser = config_subparsers.add_parser(
-        ConfigCommands.STATUS.value, help="Show configuration status"
-    )
-    status_config_parser.add_argument(
-        "--verbose", action="store_true", help="Show detailed status information"
+    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/skill_source_parser.py

@@ -0,0 +1,169 @@
+"""Skill source command parser for skill repository management.
+
+WHY: This module provides CLI commands for managing skill source repositories
+(Git repositories containing skill JSON files). Parallel to agent source management
+but for the Skills feature (single-tier Git-based skills system).
+
+DESIGN DECISION: Skill source management is separate from skill deployment to
+maintain clear separation of concerns:
+- skill-source commands: Manage repository configuration
+- skills commands: View and interact with skills themselves
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_skill_source_subparser(subparsers) -> argparse.ArgumentParser:
+    """Add the skill-source subparser with all repository management commands.
+
+    WHY: Skill sources (Git repositories) need their own command group
+    for managing repository configuration, priorities, and synchronization.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured skill-source subparser
+    """
+    # Skill source command with subcommands
+    skill_source_parser = subparsers.add_parser(
+        "skill-source",
+        help="Manage skill source repositories",
+    )
+    add_common_arguments(skill_source_parser)
+
+    skill_source_subparsers = skill_source_parser.add_subparsers(
+        dest="skill_source_command",
+        help="Skill source repository commands",
+        metavar="SUBCOMMAND",
+    )
+
+    # Add repository
+    add_parser = skill_source_subparsers.add_parser(
+        "add",
+        help="Add a new skill source repository",
+    )
+    add_parser.add_argument(
+        "url",
+        help="Git repository URL (e.g., https://github.com/owner/repo)",
+    )
+    add_parser.add_argument(
+        "--branch",
+        default="main",
+        help="Git branch to use (default: main)",
+    )
+    add_parser.add_argument(
+        "--priority",
+        type=int,
+        default=100,
+        help="Priority for conflict resolution (lower = higher precedence, default: 100)",
+    )
+    add_parser.add_argument(
+        "--disabled",
+        action="store_true",
+        help="Add repository but keep it disabled",
+    )
+    add_parser.add_argument(
+        "--test",
+        action="store_true",
+        help="Test repository access without saving to configuration",
+    )
+    add_parser.add_argument(
+        "--no-test",
+        action="store_true",
+        dest="skip_test",
+        help="Skip immediate testing (not recommended)",
+    )
+
+    # Remove repository
+    remove_parser = skill_source_subparsers.add_parser(
+        "remove",
+        help="Remove a skill source repository",
+    )
+    remove_parser.add_argument(
+        "source_id",
+        help="Source identifier (e.g., repository name)",
+    )
+    remove_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Skip confirmation prompt",
+    )
+
+    # List repositories
+    list_parser = skill_source_subparsers.add_parser(
+        "list",
+        help="List configured skill source repositories",
+    )
+    list_parser.add_argument(
+        "--by-priority",
+        action="store_true",
+        dest="by_priority",
+        help="Sort by priority (lowest first)",
+    )
+    list_parser.add_argument(
+        "--enabled-only",
+        action="store_true",
+        dest="enabled_only",
+        help="Show only enabled repositories",
+    )
+    list_parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output as JSON",
+    )
+
+    # Update/sync repositories
+    update_parser = skill_source_subparsers.add_parser(
+        "update",
+        help="Update (sync) skill sources from Git",
+    )
+    update_parser.add_argument(
+        "source_id",
+        nargs="?",
+        help="Optional: Update only this repository (default: update all)",
+    )
+    update_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force update even if cache is fresh",
+    )
+
+    # Enable repository
+    enable_parser = skill_source_subparsers.add_parser(
+        "enable",
+        help="Enable a disabled repository",
+    )
+    enable_parser.add_argument(
+        "source_id",
+        help="Source identifier to enable",
+    )
+
+    # Disable repository
+    disable_parser = skill_source_subparsers.add_parser(
+        "disable",
+        help="Disable a repository",
+    )
+    disable_parser.add_argument(
+        "source_id",
+        help="Source identifier to disable",
+    )
+
+    # Show repository details
+    show_parser = skill_source_subparsers.add_parser(
+        "show",
+        help="Show details for a skill source",
+    )
+    show_parser.add_argument(
+        "source_id",
+        help="Source identifier to show",
+    )
+    show_parser.add_argument(
+        "--skills",
+        action="store_true",
+        help="Also list skills from this source",
+    )
+
+    return skill_source_parser