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

claude_mpm/cli/parsers/agent_manager_parser.py

@@ -22,7 +22,7 @@ def add_agent_manager_subparser(subparsers: argparse._SubParsersAction) -> None:
         description="Comprehensive agent lifecycle management for Claude MPM",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
-Examples:
+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
@@ -35,6 +35,16 @@ Examples:
   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
 """,
     )
 
@@ -231,3 +241,153 @@ Examples:
         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/agents_parser.py

@@ -68,6 +68,113 @@ def add_agents_subparser(subparsers) -> argparse.ArgumentParser:
         "--show-config", action="store_true", help="Show agent configuration"
     )
 
+    # Create local agent
+    create_agent_parser = agents_subparsers.add_parser(
+        "create", help="Create a new local agent template"
+    )
+    create_agent_parser.add_argument(
+        "--interactive",
+        "-i",
+        action="store_true",
+        help="Launch interactive agent creation wizard",
+    )
+    create_agent_parser.add_argument("--agent-id", help="Agent ID (lowercase, hyphens)")
+    create_agent_parser.add_argument("--name", help="Agent display name")
+    create_agent_parser.add_argument(
+        "--model",
+        choices=["sonnet", "opus", "haiku"],
+        default="sonnet",
+        help="Model to use",
+    )
+    create_agent_parser.add_argument(
+        "--inherit-from", help="System agent to inherit from"
+    )
+
+    # Edit local agent
+    edit_agent_parser = agents_subparsers.add_parser(
+        "edit", help="Edit a local agent template"
+    )
+    edit_agent_parser.add_argument("agent_id", help="Agent ID to edit")
+    edit_agent_parser.add_argument(
+        "--interactive", "-i", action="store_true", help="Use interactive editor"
+    )
+    edit_agent_parser.add_argument(
+        "--editor", help="Editor to use (default: $EDITOR or nano)"
+    )
+
+    # Delete local agent
+    delete_agent_parser = agents_subparsers.add_parser(
+        "delete", help="Delete a local agent template"
+    )
+    delete_agent_parser.add_argument(
+        "agent_ids", nargs="+", help="Agent ID(s) to delete"
+    )
+    delete_agent_parser.add_argument(
+        "--force", "-f", action="store_true", help="Skip confirmation prompts"
+    )
+    delete_agent_parser.add_argument(
+        "--keep-deployment",
+        action="store_true",
+        help="Keep Claude Code deployment, only delete template",
+    )
+    delete_agent_parser.add_argument(
+        "--backup", action="store_true", help="Create backup before deletion"
+    )
+
+    # Manage local agents (interactive menu)
+    agents_subparsers.add_parser(
+        "manage", help="Interactive menu for managing local agents"
+    )
+
+    # Configure agent deployment settings
+    configure_agents_parser = agents_subparsers.add_parser(
+        "configure", help="Configure which agents are deployed"
+    )
+    configure_agents_parser.add_argument(
+        "--enable",
+        nargs="+",
+        metavar="AGENT_ID",
+        help="Enable specific agents for deployment",
+    )
+    configure_agents_parser.add_argument(
+        "--disable",
+        nargs="+",
+        metavar="AGENT_ID",
+        help="Disable specific agents from deployment",
+    )
+    configure_agents_parser.add_argument(
+        "--enable-all", action="store_true", help="Enable all agents for deployment"
+    )
+    configure_agents_parser.add_argument(
+        "--disable-system",
+        action="store_true",
+        help="Disable all system agents from deployment",
+    )
+    configure_agents_parser.add_argument(
+        "--enable-system",
+        action="store_true",
+        help="Enable system agents for deployment",
+    )
+    configure_agents_parser.add_argument(
+        "--disable-local",
+        action="store_true",
+        help="Disable local project agents from deployment",
+    )
+    configure_agents_parser.add_argument(
+        "--enable-local",
+        action="store_true",
+        help="Enable local project agents for deployment",
+    )
+    configure_agents_parser.add_argument(
+        "--show", action="store_true", help="Show current deployment configuration"
+    )
+    configure_agents_parser.add_argument(
+        "--interactive",
+        "-i",
+        action="store_true",
+        help="Interactive configuration mode",
+    )
+
     # Deploy agents
     deploy_agents_parser = agents_subparsers.add_parser(
         AgentCommands.DEPLOY.value, help="Deploy agents to target directory"
@@ -159,4 +266,13 @@ def add_agents_subparser(subparsers) -> argparse.ArgumentParser:
         help="Only show summary, not individual agents",
     )
 
+    # Auto-configuration commands (TSK-0054 Phase 5)
+    from .auto_configure_parser import (
+        add_agents_detect_subparser,
+        add_agents_recommend_subparser,
+    )
+
+    add_agents_detect_subparser(agents_subparsers)
+    add_agents_recommend_subparser(agents_subparsers)
+
     return agents_parser

claude_mpm/cli/parsers/auto_configure_parser.py

@@ -0,0 +1,245 @@
+"""
+Auto-Configuration Parser for Claude MPM CLI
+============================================
+
+WHY: This module provides argument parsing for auto-configuration commands,
+enabling users to customize detection, recommendation, and deployment behavior.
+
+DESIGN DECISION: Follows existing parser patterns in the codebase, using
+add_common_arguments for consistency. Provides sensible defaults while
+allowing full customization.
+
+Part of TSK-0054: Auto-Configuration Feature - Phase 5
+"""
+
+import argparse
+from pathlib import Path
+
+from .base_parser import add_common_arguments
+
+
+def add_auto_configure_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the auto-configure subparser for automated agent configuration.
+
+    WHY: Auto-configuration simplifies onboarding by detecting project toolchain
+    and deploying appropriate agents automatically.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured auto-configure subparser
+    """
+    # Auto-configure command
+    auto_configure_parser = subparsers.add_parser(
+        "auto-configure",
+        help="Auto-configure agents based on project toolchain detection",
+        description="""
+Auto-configure agents 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 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,
+        epilog="""
+Examples:
+  # Interactive configuration with confirmation
+  claude-mpm auto-configure
+
+  # Preview configuration without deploying
+  claude-mpm auto-configure --preview
+
+  # Auto-approve deployment (for scripts)
+  claude-mpm auto-configure --yes
+
+  # Require 90% confidence for recommendations
+  claude-mpm auto-configure --min-confidence 0.9
+
+  # JSON output for scripting
+  claude-mpm auto-configure --json
+
+  # Configure specific project directory
+  claude-mpm auto-configure --project-path /path/to/project
+        """,
+    )
+    add_common_arguments(auto_configure_parser)
+
+    # Configuration mode
+    mode_group = auto_configure_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",
+    )
+
+    # Configuration options
+    auto_configure_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_configure_parser.add_argument(
+        "--project-path",
+        type=Path,
+        metavar="PATH",
+        help="Project path to analyze (default: current directory)",
+    )
+
+    return auto_configure_parser
+
+
+def add_agents_detect_subparser(agents_subparsers) -> argparse.ArgumentParser:
+    """
+    Add the agents detect subparser for toolchain detection.
+
+    WHY: Allows users to see what toolchain is detected without making changes,
+    useful for debugging and verification.
+
+    Args:
+        agents_subparsers: The agents subparsers object
+
+    Returns:
+        The configured detect subparser
+    """
+    detect_parser = agents_subparsers.add_parser(
+        "detect",
+        help="Detect project toolchain without deploying",
+        description="""
+Detect and display project toolchain without making any changes.
+
+This command analyzes your project to detect:
+  • Programming languages and versions
+  • Frameworks and libraries
+  • Deployment targets and platforms
+
+Useful for debugging toolchain detection and verifying what would be
+detected before running auto-configure.
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Detect toolchain in current directory
+  claude-mpm agents detect
+
+  # Detect with verbose output showing evidence
+  claude-mpm agents detect --verbose
+
+  # JSON output for scripting
+  claude-mpm agents detect --json
+
+  # Detect specific project
+  claude-mpm agents detect --project-path /path/to/project
+        """,
+    )
+    add_common_arguments(detect_parser)
+
+    detect_parser.add_argument(
+        "--project-path",
+        type=Path,
+        metavar="PATH",
+        help="Project path to analyze (default: current directory)",
+    )
+
+    return detect_parser
+
+
+def add_agents_recommend_subparser(
+    agents_subparsers,
+) -> argparse.ArgumentParser:
+    """
+    Add the agents recommend subparser for agent recommendations.
+
+    WHY: Allows users to see what agents would be recommended without deploying,
+    useful for reviewing recommendations before committing to deployment.
+
+    Args:
+        agents_subparsers: The agents subparsers object
+
+    Returns:
+        The configured recommend subparser
+    """
+    recommend_parser = agents_subparsers.add_parser(
+        "recommend",
+        help="Show recommended agents without deploying",
+        description="""
+Show recommended agents based on project toolchain without deploying.
+
+This command analyzes your project toolchain and recommends appropriate
+agents with detailed reasoning for each recommendation. No changes are
+made to your project.
+
+Useful for:
+  • Reviewing recommendations before deployment
+  • Understanding why agents are recommended
+  • Adjusting confidence thresholds
+        """,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Show recommendations with reasoning
+  claude-mpm agents recommend
+
+  # Require 90% confidence for recommendations
+  claude-mpm agents recommend --min-confidence 0.9
+
+  # JSON output for scripting
+  claude-mpm agents recommend --json
+
+  # Hide detailed reasoning
+  claude-mpm agents recommend --no-reasoning
+
+  # Recommend for specific project
+  claude-mpm agents recommend --project-path /path/to/project
+        """,
+    )
+    add_common_arguments(recommend_parser)
+
+    recommend_parser.add_argument(
+        "--project-path",
+        type=Path,
+        metavar="PATH",
+        help="Project path to analyze (default: current directory)",
+    )
+
+    recommend_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)",
+    )
+
+    recommend_parser.add_argument(
+        "--show-reasoning",
+        action="store_true",
+        default=True,
+        help="Show detailed reasoning for recommendations (default)",
+    )
+
+    recommend_parser.add_argument(
+        "--no-reasoning",
+        dest="show_reasoning",
+        action="store_false",
+        help="Hide detailed reasoning for recommendations",
+    )
+
+    return recommend_parser