claude-mpm 4.1.0__py3-none-any.whl → 4.1.2__py3-none-any.whl

claude_mpm/cli/parsers/agent_manager_parser.py

@@ -11,7 +11,7 @@ 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
     """
@@ -32,216 +32,168 @@ Examples:
   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
-"""
+""",
     )
-    
+
     # Create subcommands for agent-manager
     agent_subparsers = agent_manager_parser.add_subparsers(
         dest="agent_manager_command",
         help="Agent management operations",
-        metavar="OPERATION"
+        metavar="OPERATION",
     )
-    
+
     # List command
     list_parser = agent_subparsers.add_parser(
-        "list",
-        help="List all agents across tiers with hierarchy"
+        "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)"
+        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", help="Create a new agent (interactive or with arguments)"
     )
     create_parser.add_argument(
-        "--name",
-        help="Display name for the agent"
-    )
-    create_parser.add_argument(
-        "--description",
-        help="Agent purpose and capabilities"
+        "--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)"
+        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"
+        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)"
+        help="Output format (default: text)",
     )
-    
+
     # Variant command
     variant_parser = agent_subparsers.add_parser(
-        "variant",
-        help="Create an agent variant based on existing agent"
+        "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"
+        help="Base agent ID to create variant from",
     )
     variant_parser.add_argument(
-        "--name",
-        help="Display name for the variant"
+        "--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"
+        help="Override model for variant",
     )
     variant_parser.add_argument(
         "--tool-choice",
         choices=["auto", "required", "any", "none"],
-        help="Override tool choice for variant"
+        help="Override tool choice for variant",
     )
     variant_parser.add_argument(
-        "--instructions",
-        help="Additional instructions to append for variant"
+        "--instructions", help="Additional instructions to append for variant"
     )
     variant_parser.add_argument(
         "--format",
         choices=["text", "json"],
         default="text",
-        help="Output format (default: text)"
+        help="Output format (default: text)",
     )
-    
+
     # Deploy command
     deploy_parser = agent_subparsers.add_parser(
-        "deploy",
-        help="Deploy agent to specified tier"
+        "deploy", help="Deploy agent to specified tier"
     )
     deploy_parser.add_argument(
-        "--id",
-        dest="agent_id",
-        required=True,
-        help="Agent ID to deploy"
+        "--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)"
+        help="Deployment tier (default: user)",
     )
     deploy_parser.add_argument(
-        "--force",
-        action="store_true",
-        help="Force deployment even if agent exists"
+        "--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)"
+        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"
+        "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"
+        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)"
+        help="Output format (default: text)",
     )
-    
+
     # Show command
     show_parser = agent_subparsers.add_parser(
-        "show",
-        help="Display detailed agent information"
+        "show", help="Display detailed agent information"
     )
     show_parser.add_argument(
-        "--id",
-        dest="agent_id",
-        required=True,
-        help="Agent ID to show"
+        "--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)"
+        help="Output format (default: text)",
     )
-    
+
     # Test command
     test_parser = agent_subparsers.add_parser(
-        "test",
-        help="Test and validate agent configuration"
+        "test", help="Test and validate agent configuration"
     )
     test_parser.add_argument(
-        "--id",
-        dest="agent_id",
-        required=True,
-        help="Agent ID to test"
+        "--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)"
+        help="Output format (default: text)",
     )
-    
+
     # Templates command
     templates_parser = agent_subparsers.add_parser(
-        "templates",
-        help="List available agent templates"
+        "templates", help="List available agent templates"
     )
     templates_parser.add_argument(
         "--format",
         choices=["text", "json", "yaml"],
         default="text",
-        help="Output format (default: text)"
-    )
+        help="Output format (default: text)",
+    )

claude_mpm/cli/parsers/agents_parser.py

@@ -132,11 +132,10 @@ def add_agents_subparser(subparsers) -> argparse.ArgumentParser:
         default=3,
         help="Maximum retry attempts per package (default: 3)",
     )
-    
+
     # Cleanup orphaned agents
     cleanup_orphaned_parser = agents_subparsers.add_parser(
-        "cleanup-orphaned",
-        help="Clean up orphaned agents that don't have templates"
+        "cleanup-orphaned", help="Clean up orphaned agents that don't have templates"
     )
     cleanup_orphaned_parser.add_argument(
         "--agents-dir",

claude_mpm/cli/parsers/base_parser.py

@@ -35,7 +35,7 @@ def _get_enhanced_version(base_version: str) -> str:
 
         # If we got an enhanced version (with build number), use it
         # Remove the 'v' prefix since argparse will add the program name
-        if enhanced and enhanced.startswith('v'):
+        if enhanced and enhanced.startswith("v"):
             enhanced = enhanced[1:]  # Remove 'v' prefix
 
         if enhanced and enhanced != base_version:
@@ -47,7 +47,9 @@ def _get_enhanced_version(base_version: str) -> str:
     return base_version
 
 
-def add_common_arguments(parser: argparse.ArgumentParser, version: str = None) -> None:
+def add_common_arguments(
+    parser: argparse.ArgumentParser, version: Optional[str] = None
+) -> None:
     """
     Add common arguments that apply to all commands.
 
@@ -342,11 +344,11 @@ def create_parser(
         # MCP pipx configuration command
         if hasattr(CLICommands, "MCP_PIPX_CONFIG") or True:  # Always add for now
             from ..commands.mcp_pipx_config import add_parser as add_mcp_pipx_parser
-            
+
             add_mcp_pipx_parser(subparsers)
-        
+
         from ..commands.doctor import add_doctor_parser
-        
+
         add_doctor_parser(subparsers)
     except ImportError:
         # Commands module may not be available during testing or refactoring

claude_mpm/cli/parsers/mcp_parser.py

@@ -79,7 +79,7 @@ def add_mcp_subparser(subparsers) -> argparse.ArgumentParser:
     )
 
     # Stop MCP server
-    stop_mcp_parser = mcp_subparsers.add_parser(
+    mcp_subparsers.add_parser(
         MCPCommands.STOP.value, help="Stop the MCP Gateway server"
     )
 
@@ -172,7 +172,9 @@ def add_mcp_subparser(subparsers) -> argparse.ArgumentParser:
         "--test", action="store_true", help="Run in test mode with debug output"
     )
     server_mcp_parser.add_argument(
-        "--instructions", action="store_true", help="Show setup instructions for Claude Code"
+        "--instructions",
+        action="store_true",
+        help="Show setup instructions for Claude Code",
     )
 
     return mcp_parser

claude_mpm/cli/parsers/monitor_parser.py

@@ -42,7 +42,9 @@ def add_monitor_subparser(subparsers) -> argparse.ArgumentParser:
         MonitorCommands.START.value, help="Start Socket.IO monitoring server"
     )
     start_monitor_parser.add_argument(
-        "--port", type=int, help="Port to start server on (auto-select if not specified)"
+        "--port",
+        type=int,
+        help="Port to start server on (auto-select if not specified)",
     )
     start_monitor_parser.add_argument(
         "--host", default="localhost", help="Host to bind to (default: localhost)"
@@ -60,12 +62,16 @@ def add_monitor_subparser(subparsers) -> argparse.ArgumentParser:
         "--background", action="store_true", help="Run server in background"
     )
     start_monitor_parser.add_argument(
-        "--force", action="store_true", 
-        help="Force kill daemon processes to reclaim ports (use with caution)"
+        "--force",
+        action="store_true",
+        help="Force kill daemon processes to reclaim ports (use with caution)",
     )
     start_monitor_parser.add_argument(
-        "--no-reclaim", dest="reclaim", action="store_false", default=True,
-        help="Don't automatically reclaim ports from debug scripts"
+        "--no-reclaim",
+        dest="reclaim",
+        action="store_false",
+        default=True,
+        help="Don't automatically reclaim ports from debug scripts",
     )
 
     # Stop monitor
@@ -83,9 +89,7 @@ def add_monitor_subparser(subparsers) -> argparse.ArgumentParser:
     restart_monitor_parser = monitor_subparsers.add_parser(
         MonitorCommands.RESTART.value, help="Restart Socket.IO monitoring server"
     )
-    restart_monitor_parser.add_argument(
-        "--port", type=int, help="Port to restart on"
-    )
+    restart_monitor_parser.add_argument("--port", type=int, help="Port to restart on")
     restart_monitor_parser.add_argument(
         "--host", default="localhost", help="Host to bind to (default: localhost)"
     )
@@ -98,27 +102,31 @@ def add_monitor_subparser(subparsers) -> argparse.ArgumentParser:
         "--verbose", action="store_true", help="Show detailed status information"
     )
     status_monitor_parser.add_argument(
-        "--show-ports", action="store_true", 
-        help="Show status of all ports in the range (8765-8785)"
+        "--show-ports",
+        action="store_true",
+        help="Show status of all ports in the range (8765-8785)",
     )
 
     # Port monitor (start/restart on specific port)
     port_monitor_parser = monitor_subparsers.add_parser(
-        MonitorCommands.PORT.value, help="Start/restart monitoring server on specific port"
-    )
-    port_monitor_parser.add_argument(
-        "port", type=int, help="Port number to use"
+        MonitorCommands.PORT.value,
+        help="Start/restart monitoring server on specific port",
     )
+    port_monitor_parser.add_argument("port", type=int, help="Port number to use")
     port_monitor_parser.add_argument(
         "--host", default="localhost", help="Host to bind to (default: localhost)"
     )
     port_monitor_parser.add_argument(
-        "--force", action="store_true", 
-        help="Force kill daemon processes to reclaim port (use with caution)"
+        "--force",
+        action="store_true",
+        help="Force kill daemon processes to reclaim port (use with caution)",
     )
     port_monitor_parser.add_argument(
-        "--no-reclaim", dest="reclaim", action="store_false", default=True,
-        help="Don't automatically reclaim port from debug scripts"
+        "--no-reclaim",
+        dest="reclaim",
+        action="store_false",
+        default=True,
+        help="Don't automatically reclaim port from debug scripts",
     )
 
     return monitor_parser

claude_mpm/cli/shared/__init__.py

@@ -18,23 +18,23 @@ from .error_handling import CLIErrorHandler, handle_cli_errors
 from .output_formatters import OutputFormatter, format_output
 
 __all__ = [
+    # Command base
+    "AgentCommand",
+    "BaseCommand",
+    # Error handling
+    "CLIErrorHandler",
+    "CommandResult",
     # Argument patterns
     "CommonArguments",
+    "MemoryCommand",
+    # Output formatting
+    "OutputFormatter",
     "add_agent_arguments",
     "add_common_arguments",
     "add_config_arguments",
     "add_logging_arguments",
     "add_memory_arguments",
     "add_output_arguments",
-    # Command base
-    "AgentCommand",
-    "BaseCommand",
-    "CommandResult",
-    "MemoryCommand",
-    # Error handling
-    "CLIErrorHandler",
-    "handle_cli_errors",
-    # Output formatting
-    "OutputFormatter",
     "format_output",
+    "handle_cli_errors",
 ]