claude-mpm 3.4.10__py3-none-any.whl → 5.4.55__py3-none-any.whl

claude_mpm/cli/parsers/__init__.py

@@ -0,0 +1,35 @@
+"""
+CLI parsers package for claude-mpm.
+
+This package contains modular parser components that were extracted from the
+monolithic parser.py file to improve maintainability and organization.
+
+WHY: The original parser.py was 1,166 lines with a single 961-line function.
+Breaking it into focused modules makes it easier to maintain and test.
+
+DESIGN DECISION: Each parser module handles a specific command domain:
+- base_parser.py: Common arguments and main parser setup
+- run_parser.py: Run command arguments
+- agent_parser.py: Agent management commands
+- memory_parser.py: Memory management commands
+- tickets_parser.py: Ticket management commands
+- config_parser.py: Configuration commands
+- monitor_parser.py: Monitoring commands
+- mcp_parser.py: MCP Gateway commands
+"""
+
+from .base_parser import (
+    SuggestingArgumentParser,
+    add_common_arguments,
+    create_parser,
+    preprocess_args,
+)
+from .run_parser import add_run_arguments
+
+__all__ = [
+    "SuggestingArgumentParser",
+    "add_common_arguments",
+    "add_run_arguments",
+    "create_parser",
+    "preprocess_args",
+]

claude_mpm/cli/parsers/agent_manager_parser.py

@@ -0,0 +1,393 @@
+"""
+Agent Manager parser module for claude-mpm CLI.
+
+This module defines the argument parser for the agent-manager command,
+which provides comprehensive agent lifecycle management capabilities.
+"""
+
+import argparse
+
+
+def add_agent_manager_subparser(subparsers: argparse._SubParsersAction) -> None:
+    """
+    Add the agent-manager subcommand to the parser.
+
+    Args:
+        subparsers: The subparsers object to add to
+    """
+    # Create the agent-manager parser
+    agent_manager_parser = subparsers.add_parser(
+        "agent-manager",
+        help="Manage agent creation, customization, and deployment",
+        description="Comprehensive agent lifecycle management for Claude MPM",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Standard Commands:
+  claude-mpm agent-manager list                          # List all agents across tiers
+  claude-mpm agent-manager create                        # Interactive agent creation
+  claude-mpm agent-manager create --id my-agent          # Create agent with ID
+  claude-mpm agent-manager variant --base research       # Create research variant
+  claude-mpm agent-manager deploy --id my-agent --tier user  # Deploy to user tier
+  claude-mpm agent-manager customize-pm --level project  # Edit .claude-mpm/INSTRUCTIONS.md
+  claude-mpm agent-manager show --id engineer            # Show agent details
+  claude-mpm agent-manager test --id my-agent            # Test agent configuration
+  claude-mpm agent-manager templates                     # List available templates
+  claude-mpm agent-manager reset --dry-run               # Preview agent cleanup
+  claude-mpm agent-manager reset --force                 # Remove all claude-mpm agents
+  claude-mpm agent-manager reset --project-only          # Clean only project agents
+
+Local Agent Commands:
+  claude-mpm agent-manager create-local --agent-id my-custom  # Create local template
+  claude-mpm agent-manager deploy-local --agent-id my-custom  # Deploy local template
+  claude-mpm agent-manager list-local                         # List local templates
+  claude-mpm agent-manager sync-local                         # Sync templates with deployment
+  claude-mpm agent-manager export-local --output ./agents     # Export templates
+  claude-mpm agent-manager import-local --input ./agents      # Import templates
+  claude-mpm agent-manager delete-local --agent-id my-custom  # Delete single agent
+  claude-mpm agent-manager delete-local --all --backup        # Delete all with backup
+""",
+    )
+
+    # Create subcommands for agent-manager
+    agent_subparsers = agent_manager_parser.add_subparsers(
+        dest="agent_manager_command",
+        help="Agent management operations",
+        metavar="OPERATION",
+    )
+
+    # List command
+    list_parser = agent_subparsers.add_parser(
+        "list", help="List all agents across tiers with hierarchy"
+    )
+    list_parser.add_argument(
+        "--format",
+        choices=["text", "json", "yaml"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Create command
+    create_parser = agent_subparsers.add_parser(
+        "create", help="Create a new agent (interactive or with arguments)"
+    )
+    create_parser.add_argument(
+        "--id", dest="agent_id", help="Agent ID (lowercase, hyphens only)"
+    )
+    create_parser.add_argument("--name", help="Display name for the agent")
+    create_parser.add_argument("--description", help="Agent purpose and capabilities")
+    create_parser.add_argument(
+        "--model",
+        choices=["sonnet", "opus", "haiku"],
+        default="sonnet",
+        help="LLM model to use (default: sonnet)",
+    )
+    create_parser.add_argument(
+        "--tool-choice",
+        choices=["auto", "required", "any", "none"],
+        default="auto",
+        help="Tool selection strategy (default: auto)",
+    )
+    create_parser.add_argument("--template", help="Base template to extend from")
+    create_parser.add_argument(
+        "--format",
+        choices=["text", "json"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Variant command
+    variant_parser = agent_subparsers.add_parser(
+        "variant", help="Create an agent variant based on existing agent"
+    )
+    variant_parser.add_argument(
+        "--base",
+        dest="base_agent",
+        required=True,
+        help="Base agent ID to create variant from",
+    )
+    variant_parser.add_argument(
+        "--id", dest="variant_id", required=True, help="Variant agent ID"
+    )
+    variant_parser.add_argument("--name", help="Display name for the variant")
+    variant_parser.add_argument(
+        "--model",
+        choices=["sonnet", "opus", "haiku"],
+        help="Override model for variant",
+    )
+    variant_parser.add_argument(
+        "--tool-choice",
+        choices=["auto", "required", "any", "none"],
+        help="Override tool choice for variant",
+    )
+    variant_parser.add_argument(
+        "--instructions", help="Additional instructions to append for variant"
+    )
+    variant_parser.add_argument(
+        "--format",
+        choices=["text", "json"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Deploy command
+    deploy_parser = agent_subparsers.add_parser(
+        "deploy", help="Deploy agent to specified tier"
+    )
+    deploy_parser.add_argument(
+        "--id", dest="agent_id", required=True, help="Agent ID to deploy"
+    )
+    deploy_parser.add_argument(
+        "--tier",
+        choices=["project", "user"],
+        default="user",
+        help="Deployment tier (default: user)",
+    )
+    deploy_parser.add_argument(
+        "--force", action="store_true", help="Force deployment even if agent exists"
+    )
+    deploy_parser.add_argument(
+        "--format",
+        choices=["text", "json"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Customize PM command
+    pm_parser = agent_subparsers.add_parser(
+        "customize-pm", help="Customize PM instructions via .claude-mpm/INSTRUCTIONS.md"
+    )
+    pm_parser.add_argument(
+        "--level",
+        choices=["user", "project"],
+        default="user",
+        help="PM instruction level - user (~/.claude-mpm) or project (./.claude-mpm) (default: user)",
+    )
+    pm_parser.add_argument("--template", help="Use predefined PM template")
+    pm_parser.add_argument("--patterns", nargs="+", help="Custom delegation patterns")
+    pm_parser.add_argument("--rules", nargs="+", help="Additional PM rules")
+    pm_parser.add_argument(
+        "--format",
+        choices=["text", "json"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Show command
+    show_parser = agent_subparsers.add_parser(
+        "show", help="Display detailed agent information"
+    )
+    show_parser.add_argument(
+        "--id", dest="agent_id", required=True, help="Agent ID to show"
+    )
+    show_parser.add_argument(
+        "--format",
+        choices=["text", "json", "yaml"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Test command
+    test_parser = agent_subparsers.add_parser(
+        "test", help="Test and validate agent configuration"
+    )
+    test_parser.add_argument(
+        "--id", dest="agent_id", required=True, help="Agent ID to test"
+    )
+    test_parser.add_argument(
+        "--format",
+        choices=["text", "json"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Templates command
+    templates_parser = agent_subparsers.add_parser(
+        "templates", help="List available agent templates"
+    )
+    templates_parser.add_argument(
+        "--format",
+        choices=["text", "json", "yaml"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Reset command
+    reset_parser = agent_subparsers.add_parser(
+        "reset", help="Remove claude-mpm authored agents for clean install"
+    )
+    reset_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Execute cleanup immediately without confirmation",
+    )
+    reset_parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Preview what would be removed without making changes",
+    )
+    reset_parser.add_argument(
+        "--project-only",
+        action="store_true",
+        help="Only clean project-level agents (.claude/agents)",
+    )
+    reset_parser.add_argument(
+        "--user-only",
+        action="store_true",
+        help="Only clean user-level agents (~/.claude/agents)",
+    )
+    reset_parser.add_argument(
+        "--format",
+        choices=["text", "json"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # === Interactive Commands ===
+
+    # Create interactive command
+    agent_subparsers.add_parser(
+        "create-interactive", help="🧙‍♂️ Launch step-by-step agent creation wizard"
+    )
+
+    # Manage local interactive command
+    agent_subparsers.add_parser(
+        "manage-local", help="🔧 Interactive menu for managing local agents"
+    )
+
+    # Edit interactive command
+    edit_interactive_parser = agent_subparsers.add_parser(
+        "edit-interactive", help="✏️ Edit agent configuration interactively"
+    )
+    edit_interactive_parser.add_argument(
+        "--agent-id", required=True, help="Agent ID to edit"
+    )
+
+    # Test local command
+    test_local_parser = agent_subparsers.add_parser(
+        "test-local", help="🧪 Test local agent with validation and deployment"
+    )
+    test_local_parser.add_argument("--agent-id", required=True, help="Agent ID to test")
+
+    # === Local Agent Commands ===
+
+    # Create local command
+    create_local_parser = agent_subparsers.add_parser(
+        "create-local", help="Create a local JSON agent template"
+    )
+    create_local_parser.add_argument(
+        "--agent-id", required=True, help="Unique agent identifier"
+    )
+    create_local_parser.add_argument("--name", help="Human-readable agent name")
+    create_local_parser.add_argument("--description", help="Agent description")
+    create_local_parser.add_argument("--instructions", help="Agent instructions")
+    create_local_parser.add_argument(
+        "--model",
+        choices=["sonnet", "opus", "haiku"],
+        default="sonnet",
+        help="Model to use (default: sonnet)",
+    )
+    create_local_parser.add_argument(
+        "--tools", help="Tools available to agent (default: *)"
+    )
+    create_local_parser.add_argument("--parent", help="Parent agent to inherit from")
+    create_local_parser.add_argument(
+        "--tier",
+        choices=["project", "user"],
+        default="project",
+        help="Tier level (default: project)",
+    )
+
+    # Deploy local command
+    deploy_local_parser = agent_subparsers.add_parser(
+        "deploy-local", help="Deploy local JSON templates to Claude Code"
+    )
+    deploy_local_parser.add_argument(
+        "--agent-id", help="Specific agent to deploy (deploy all if not specified)"
+    )
+    deploy_local_parser.add_argument(
+        "--force", action="store_true", help="Force deployment even if file exists"
+    )
+    deploy_local_parser.add_argument(
+        "--tier", choices=["project", "user"], help="Filter by tier for bulk deployment"
+    )
+
+    # List local command
+    list_local_parser = agent_subparsers.add_parser(
+        "list-local", help="List all local agent templates"
+    )
+    list_local_parser.add_argument(
+        "--tier", choices=["project", "user"], help="Filter by tier"
+    )
+    list_local_parser.add_argument(
+        "--format",
+        choices=["text", "json"],
+        default="text",
+        help="Output format (default: text)",
+    )
+
+    # Sync local command
+    agent_subparsers.add_parser(
+        "sync-local", help="Synchronize local templates with deployed agents"
+    )
+
+    # Export local command
+    export_local_parser = agent_subparsers.add_parser(
+        "export-local", help="Export local templates to a directory"
+    )
+    export_local_parser.add_argument(
+        "--output",
+        default="./exported-agents",
+        help="Output directory (default: ./exported-agents)",
+    )
+
+    # Import local command
+    import_local_parser = agent_subparsers.add_parser(
+        "import-local", help="Import templates from a directory"
+    )
+    import_local_parser.add_argument(
+        "--input", required=True, help="Input directory containing templates"
+    )
+    import_local_parser.add_argument(
+        "--tier",
+        choices=["project", "user"],
+        default="project",
+        help="Tier to import into (default: project)",
+    )
+
+    # Delete local command
+    delete_local_parser = agent_subparsers.add_parser(
+        "delete-local", help="Delete local agent templates with safety checks"
+    )
+    delete_local_parser.add_argument(
+        "--agent-id",
+        nargs="+",
+        dest="agent_id",
+        help="Agent ID(s) to delete (space-separated for multiple)",
+    )
+    delete_local_parser.add_argument(
+        "--all",
+        action="store_true",
+        help="Delete all local agents (requires confirmation)",
+    )
+    delete_local_parser.add_argument(
+        "--force",
+        "-f",
+        action="store_true",
+        help="Skip confirmation prompts",
+    )
+    delete_local_parser.add_argument(
+        "--keep-deployment",
+        action="store_true",
+        help="Keep Claude Code deployment, only delete template",
+    )
+    delete_local_parser.add_argument(
+        "--backup",
+        action="store_true",
+        help="Create backup before deletion",
+    )
+    delete_local_parser.add_argument(
+        "--tier",
+        choices=["project", "user", "all"],
+        default="project",
+        help="Tier to delete from (default: project)",
+    )

claude_mpm/cli/parsers/agent_source_parser.py

@@ -0,0 +1,171 @@
+"""Agent source command parser for agent repository management.
+
+WHY: This module provides CLI commands for managing agent source repositories
+(Git repositories containing agent markdown files). Parallel to skill source management
+but for the agent deployment system (multi-tier Git-based agents).
+
+DESIGN DECISION: Agent source management is separate from agent deployment to
+maintain clear separation of concerns:
+- agent-source commands: Manage repository configuration
+- agents commands: View and interact with agents themselves
+
+IMPLEMENTATION NOTE: This module is adapted from skill_source_parser.py, following
+the same proven patterns but for agent repositories instead of skills.
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_agent_source_subparser(subparsers) -> argparse.ArgumentParser:
+    """Add the agent-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 agent-source subparser
+    """
+    # Agent source command with subcommands
+    agent_source_parser = subparsers.add_parser(
+        "agent-source",
+        help="Manage agent source repositories",
+    )
+    add_common_arguments(agent_source_parser)
+
+    agent_source_subparsers = agent_source_parser.add_subparsers(
+        dest="agent_source_command",
+        help="Agent source repository commands",
+        metavar="SUBCOMMAND",
+    )
+
+    # Add repository
+    add_parser = agent_source_subparsers.add_parser(
+        "add",
+        help="Add a new agent source repository",
+    )
+    add_parser.add_argument(
+        "url",
+        help="Git repository URL (e.g., https://github.com/owner/repo)",
+    )
+    add_parser.add_argument(
+        "--subdirectory",
+        help="Subdirectory within repository containing agents (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",
+    )
+    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 = agent_source_subparsers.add_parser(
+        "remove",
+        help="Remove an agent source repository",
+    )
+    remove_parser.add_argument(
+        "source_id",
+        help="Source identifier (e.g., 'owner/repo' or 'owner/repo/subdirectory')",
+    )
+    remove_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Skip confirmation prompt",
+    )
+
+    # List repositories
+    list_parser = agent_source_subparsers.add_parser(
+        "list",
+        help="List configured agent 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 = agent_source_subparsers.add_parser(
+        "update",
+        help="Update (sync) agent 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 = agent_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 = agent_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 = agent_source_subparsers.add_parser(
+        "show",
+        help="Show details for an agent source",
+    )
+    show_parser.add_argument(
+        "source_id",
+        help="Source identifier to show",
+    )
+    show_parser.add_argument(
+        "--agents",
+        action="store_true",
+        help="Also list agents from this source",
+    )
+
+    return agent_source_parser