claude-mpm 4.20.3__py3-none-any.whl → 5.1.8__py3-none-any.whl

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 config command which is synonymous with configure.
+Both launch the interactive configuration TUI.
 
-DESIGN DECISION: Configuration commands handle validation and management
-of claude-mpm settings and warrant their own module.
+DESIGN DECISION: 'config' and 'configure' are aliases - both commands provide
+identical functionality through the interactive configuration interface.
 """
 
 import argparse
 
-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 config subparser (alias for configure).
 
-    WHY: Configuration management has multiple subcommands for validation,
-    viewing, and editing that need their own argument structures.
+    WHY: 'config' and 'configure' are synonymous commands that both launch
+    the interactive configuration interface. This provides a consistent
+    parser setup matching the configure command.
 
     Args:
         subparsers: The subparsers object from the main parser
@@ -29,57 +28,111 @@ def add_config_subparser(subparsers) -> argparse.ArgumentParser:
     Returns:
         The configured config subparser
     """
-    # Config command with subcommands
+    # Config command - alias for configure (interactive configuration)
     config_parser = subparsers.add_parser(
-        CLICommands.CONFIG.value, help="Validate and manage configuration"
+        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",
     )
+
+    # Add common arguments
     add_common_arguments(config_parser)
 
-    config_subparsers = config_parser.add_subparsers(
-        dest="config_command", help="Config commands", metavar="SUBCOMMAND"
+    # 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)",
     )
 
-    # Validate config
-    validate_config_parser = config_subparsers.add_parser(
-        ConfigCommands.VALIDATE.value, help="Validate configuration files"
+    # 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"
     )
-    validate_config_parser.add_argument(
-        "--config-file",
-        type=Path,
-        help="Specific config file to validate (default: all)",
+    nav_group.add_argument(
+        "--templates", action="store_true", help="Jump directly to template editing"
+    )
+    nav_group.add_argument(
+        "--behaviors",
+        action="store_true",
+        help="Jump directly to behavior file management",
     )
-    validate_config_parser.add_argument(
-        "--strict", action="store_true", help="Use strict validation rules"
+    nav_group.add_argument(
+        "--startup",
+        action="store_true",
+        help="Configure startup services and agents",
     )
-    validate_config_parser.add_argument(
-        "--fix",
+    nav_group.add_argument(
+        "--version-info",
         action="store_true",
-        help="Attempt to fix validation errors automatically",
+        help="Display version information and exit",
+    )
+
+    # 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"
+    )
+    noninteractive_group.add_argument(
+        "--enable-agent",
+        type=str,
+        metavar="AGENT_NAME",
+        help="Enable a specific agent and exit",
+    )
+    noninteractive_group.add_argument(
+        "--disable-agent",
+        type=str,
+        metavar="AGENT_NAME",
+        help="Disable a specific agent and exit",
+    )
+    noninteractive_group.add_argument(
+        "--export-config",
+        type=str,
+        metavar="FILE",
+        help="Export current configuration to a file",
+    )
+    noninteractive_group.add_argument(
+        "--import-config",
+        type=str,
+        metavar="FILE",
+        help="Import configuration from a file",
     )
 
-    # View config
-    view_config_parser = config_subparsers.add_parser(
-        ConfigCommands.VIEW.value, help="View current configuration"
+    # 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",
     )
-    view_config_parser.add_argument(
-        "--section", help="Specific configuration section to view"
+    hooks_group.add_argument(
+        "--verify-hooks",
+        action="store_true",
+        help="Verify that Claude MPM hooks are properly installed",
     )
-    view_config_parser.add_argument(
-        "--format",
-        choices=["yaml", "json", "table"],
-        default="yaml",
-        help="Output format (default: yaml)",
+    hooks_group.add_argument(
+        "--uninstall-hooks",
+        action="store_true",
+        help="Uninstall Claude MPM hooks",
     )
-    view_config_parser.add_argument(
-        "--show-defaults", action="store_true", help="Include default values in output"
+    hooks_group.add_argument(
+        "--force",
+        action="store_true",
+        help="Force reinstallation of hooks even if they already exist",
     )
 
-    # Status config
-    status_config_parser = config_subparsers.add_parser(
-        ConfigCommands.STATUS.value, help="Show configuration status"
+    # 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_config_parser.add_argument(
-        "--verbose", action="store_true", help="Show detailed status information"
+    display_group.add_argument(
+        "--compact", action="store_true", help="Use compact display mode"
     )
 
     return config_parser

claude_mpm/cli/parsers/mpm_init_parser.py

@@ -265,5 +265,47 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         help="Path to project directory (default: current directory)",
     )
 
+    # Pause subcommand - Create session pause documents
+    pause_parser = subcommands.add_parser(
+        "pause",
+        help="Pause current session and save state",
+        description="Create session pause documents for later resume. Captures git context, "
+        "conversation state, todos, and working directory state.\n\n"
+        "Creates three file formats:\n"
+        "  - JSON: Machine-readable structured data\n"
+        "  - YAML: Human-readable configuration style\n"
+        "  - Markdown: Full documentation format",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="Examples:\n"
+        "  claude-mpm mpm-init pause                          # Basic pause\n"
+        "  claude-mpm mpm-init pause -m 'End of day'         # With message\n"
+        "  claude-mpm mpm-init pause --no-commit             # Skip git commit\n"
+        "  claude-mpm mpm-init pause --export session.json   # Export copy",
+    )
+    pause_parser.add_argument(
+        "--message",
+        "-m",
+        type=str,
+        default=None,
+        help="Optional message describing pause reason or context",
+    )
+    pause_parser.add_argument(
+        "--no-commit",
+        action="store_true",
+        help="Skip git commit of session state",
+    )
+    pause_parser.add_argument(
+        "--export",
+        type=str,
+        default=None,
+        help="Export session state to custom location",
+    )
+    pause_parser.add_argument(
+        "project_path",
+        nargs="?",
+        default=".",
+        help="Path to project directory (default: current directory)",
+    )
+
     # Set the command handler
     mpm_init_parser.set_defaults(command="mpm-init")

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

claude_mpm/cli/parsers/skills_parser.py

@@ -134,4 +134,149 @@ def add_skills_subparser(subparsers) -> argparse.ArgumentParser:
         help="Show configuration file path",
     )
 
+    # Configure command (interactive skills selection)
+    skills_subparsers.add_parser(
+        SkillsCommands.CONFIGURE.value,
+        help="Interactive skills configuration with checkbox selection (like agents configure)",
+    )
+    # No additional arguments needed - purely interactive
+
+    # GitHub deployment commands
+    # Deploy from GitHub command
+    deploy_github_parser = skills_subparsers.add_parser(
+        SkillsCommands.DEPLOY_FROM_GITHUB.value,
+        help="Deploy skills from GitHub to ~/.claude/skills/ for Claude Code",
+    )
+    deploy_github_parser.add_argument(
+        "--collection",
+        "-c",
+        help="Collection to deploy from (default: uses default collection)",
+    )
+    deploy_github_parser.add_argument(
+        "--toolchain",
+        nargs="+",
+        help="Filter by toolchain/language (e.g., python javascript rust)",
+    )
+    deploy_github_parser.add_argument(
+        "--categories",
+        nargs="+",
+        help="Filter by categories (e.g., testing debugging web)",
+    )
+    deploy_github_parser.add_argument(
+        "--force",
+        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(
+        SkillsCommands.LIST_AVAILABLE.value,
+        help="List all available skills from GitHub repository",
+    )
+    list_available_parser.add_argument(
+        "--collection",
+        "-c",
+        help="Collection to list from (default: uses default collection)",
+    )
+    list_available_parser.add_argument(
+        "--verbose",
+        "-v",
+        action="store_true",
+        help="Show detailed skill information including names",
+    )
+
+    # Check deployed skills
+    skills_subparsers.add_parser(
+        SkillsCommands.CHECK_DEPLOYED.value,
+        help="Check which skills are currently deployed in ~/.claude/skills/",
+    )
+
+    # Remove skills
+    remove_parser = skills_subparsers.add_parser(
+        SkillsCommands.REMOVE.value,
+        help="Remove deployed skills from ~/.claude/skills/",
+    )
+    remove_parser.add_argument(
+        "skill_names",
+        nargs="*",
+        help="Specific skills to remove",
+    )
+    remove_parser.add_argument(
+        "--all",
+        action="store_true",
+        help="Remove all deployed skills",
+    )
+
+    # Collection management commands
+    # List collections
+    skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_LIST.value,
+        help="List all configured skill collections",
+    )
+
+    # Add collection
+    collection_add_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_ADD.value,
+        help="Add a new skill collection from GitHub",
+    )
+    collection_add_parser.add_argument(
+        "collection_name",
+        help="Name for the collection (e.g., obra-superpowers)",
+    )
+    collection_add_parser.add_argument(
+        "collection_url",
+        help="GitHub repository URL (e.g., https://github.com/obra/superpowers)",
+    )
+    collection_add_parser.add_argument(
+        "--priority",
+        type=int,
+        default=99,
+        help="Collection priority (lower = higher priority, default: 99)",
+    )
+
+    # Remove collection
+    collection_remove_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_REMOVE.value,
+        help="Remove a skill collection",
+    )
+    collection_remove_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to remove",
+    )
+
+    # Enable collection
+    collection_enable_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_ENABLE.value,
+        help="Enable a disabled collection",
+    )
+    collection_enable_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to enable",
+    )
+
+    # Disable collection
+    collection_disable_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_DISABLE.value,
+        help="Disable a collection without removing it",
+    )
+    collection_disable_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to disable",
+    )
+
+    # Set default collection
+    collection_set_default_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_SET_DEFAULT.value,
+        help="Set the default collection for deployments",
+    )
+    collection_set_default_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to set as default",
+    )
+
     return skills_parser

claude_mpm/cli/parsers/source_parser.py

@@ -0,0 +1,138 @@
+"""Source command parser for agent repository management.
+
+WHY: This module provides CLI commands for managing agent source repositories
+(Git repositories containing agent markdown files). Extracted into its own
+module to support the single-tier deployment migration (Phase 2).
+
+DESIGN DECISION: Source management is separate from agent deployment to
+maintain clear separation of concerns:
+- source commands: Manage repository configuration
+- agents commands: Deploy and manage agents themselves
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_source_subparser(subparsers) -> argparse.ArgumentParser:
+    """Add the source subparser with all repository management commands.
+
+    WHY: Agent 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 source subparser
+    """
+    # Source command with subcommands
+    source_parser = subparsers.add_parser(
+        "source",
+        help="Manage agent source repositories",
+    )
+    add_common_arguments(source_parser)
+
+    source_subparsers = source_parser.add_subparsers(
+        dest="source_command",
+        help="Source repository commands",
+        metavar="SUBCOMMAND",
+    )
+
+    # Add repository
+    add_parser = source_subparsers.add_parser(
+        "add",
+        help="Add a new agent source repository",
+    )
+    add_parser.add_argument(
+        "url",
+        help="GitHub repository URL (e.g., https://github.com/owner/repo)",
+    )
+    add_parser.add_argument(
+        "--subdirectory",
+        "--subdir",
+        help="Subdirectory path within repository (e.g., 'agents')",
+    )
+    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",
+    )
+
+    # Remove repository
+    remove_parser = source_subparsers.add_parser(
+        "remove",
+        help="Remove an agent source repository",
+    )
+    remove_parser.add_argument(
+        "identifier",
+        help="Repository identifier (e.g., 'owner/repo' or 'owner/repo/subdirectory')",
+    )
+
+    # List repositories
+    list_parser = source_subparsers.add_parser(
+        "list",
+        help="List configured agent source repositories",
+    )
+    list_parser.add_argument(
+        "--all",
+        action="store_true",
+        dest="show_all",
+        help="Show disabled repositories (default: only enabled)",
+    )
+
+    # Enable repository
+    enable_parser = source_subparsers.add_parser(
+        "enable",
+        help="Enable a disabled repository",
+    )
+    enable_parser.add_argument(
+        "identifier",
+        help="Repository identifier to enable",
+    )
+
+    # Disable repository
+    disable_parser = source_subparsers.add_parser(
+        "disable",
+        help="Disable a repository",
+    )
+    disable_parser.add_argument(
+        "identifier",
+        help="Repository identifier to disable",
+    )
+
+    # Disable system repository
+    disable_system_parser = source_subparsers.add_parser(
+        "disable-system",
+        help="Disable or enable the default system repository",
+    )
+    disable_system_parser.add_argument(
+        "--enable",
+        action="store_true",
+        help="Re-enable system repository instead of disabling",
+    )
+
+    # Sync repositories
+    sync_parser = source_subparsers.add_parser(
+        "sync",
+        help="Sync agent sources from Git",
+    )
+    sync_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force sync even if cache is fresh (ignore ETags)",
+    )
+    sync_parser.add_argument(
+        "identifier",
+        nargs="?",
+        help="Optional: Sync only this repository (default: sync all)",
+    )
+
+    return source_parser