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

claude_mpm/cli/parsers/local_deploy_parser.py

@@ -0,0 +1,227 @@
+"""
+Local Deploy parser module for claude-mpm CLI.
+
+WHY: Provides argument parsing for local deployment management commands.
+Extracted from the monolithic parser.py for better organization.
+
+DESIGN DECISION: Supports multiple subcommands (start, stop, restart, status, etc.)
+with command-specific arguments for comprehensive process management.
+"""
+
+from pathlib import Path
+
+
+def add_local_deploy_arguments(subparsers) -> None:
+    """
+    Add local-deploy command and its subcommands to the parser.
+
+    WHY: Provides a comprehensive CLI for managing local development deployments
+    with process monitoring, health checks, and auto-restart capabilities.
+
+    Args:
+        subparsers: The subparsers object to add commands to
+    """
+    # Main local-deploy command
+    local_deploy_parser = subparsers.add_parser(
+        "local-deploy",
+        help="Manage local development deployments with process monitoring",
+        description=(
+            "Manage local development deployments with comprehensive process management, "
+            "health monitoring, and auto-restart capabilities."
+        ),
+    )
+
+    # Create subparsers for local-deploy subcommands
+    local_deploy_subparsers = local_deploy_parser.add_subparsers(
+        dest="local_deploy_command",
+        help="Local deployment commands",
+    )
+
+    # ===== START command =====
+    start_parser = local_deploy_subparsers.add_parser(
+        "start",
+        help="Start a new local deployment",
+        description="Start a new local deployment with process monitoring and optional auto-restart",
+    )
+    start_parser.add_argument(
+        "--command",
+        "-c",
+        required=True,
+        help="Command to execute (e.g., 'npm run dev' or 'python manage.py runserver')",
+    )
+    start_parser.add_argument(
+        "--working-directory",
+        "-d",
+        type=Path,
+        help="Working directory for the process (default: current directory)",
+    )
+    start_parser.add_argument(
+        "--port",
+        "-p",
+        type=int,
+        help="Port number for the deployment",
+    )
+    start_parser.add_argument(
+        "--auto-find-port",
+        action="store_true",
+        default=True,
+        help="Automatically find alternative port if specified port is unavailable (default: enabled)",
+    )
+    start_parser.add_argument(
+        "--no-auto-find-port",
+        action="store_false",
+        dest="auto_find_port",
+        help="Disable automatic port finding",
+    )
+    start_parser.add_argument(
+        "--auto-restart",
+        action="store_true",
+        help="Enable automatic restart on crashes",
+    )
+    start_parser.add_argument(
+        "--log-file",
+        type=Path,
+        help="Path to log file for monitoring error patterns",
+    )
+    start_parser.add_argument(
+        "--env",
+        "-e",
+        action="append",
+        help="Environment variables in KEY=VALUE format (can be specified multiple times)",
+    )
+
+    # ===== STOP command =====
+    stop_parser = local_deploy_subparsers.add_parser(
+        "stop",
+        help="Stop a running deployment",
+        description="Stop a running deployment with graceful shutdown",
+    )
+    stop_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to stop",
+    )
+    stop_parser.add_argument(
+        "--timeout",
+        "-t",
+        type=int,
+        default=10,
+        help="Timeout in seconds for graceful shutdown (default: 10)",
+    )
+    stop_parser.add_argument(
+        "--force",
+        "-f",
+        action="store_true",
+        help="Force kill immediately without graceful shutdown",
+    )
+
+    # ===== RESTART command =====
+    restart_parser = local_deploy_subparsers.add_parser(
+        "restart",
+        help="Restart a deployment",
+        description="Restart a deployment with the same configuration",
+    )
+    restart_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to restart",
+    )
+    restart_parser.add_argument(
+        "--timeout",
+        "-t",
+        type=int,
+        default=10,
+        help="Timeout in seconds for graceful shutdown (default: 10)",
+    )
+
+    # ===== STATUS command =====
+    status_parser = local_deploy_subparsers.add_parser(
+        "status",
+        help="Show comprehensive deployment status",
+        description="Show comprehensive status including process info, health, and restart history",
+    )
+    status_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to check",
+    )
+    status_parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output status in JSON format",
+    )
+
+    # ===== HEALTH command =====
+    health_parser = local_deploy_subparsers.add_parser(
+        "health",
+        help="Show health status",
+        description="Show health check status including HTTP, process, and resource checks",
+    )
+    health_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to check",
+    )
+
+    # ===== LIST command =====
+    list_parser = local_deploy_subparsers.add_parser(
+        "list",
+        help="List all deployments",
+        description="List all local deployments with their status",
+    )
+    list_parser.add_argument(
+        "--status",
+        "-s",
+        choices=["running", "stopped", "crashed", "stopping"],
+        help="Filter deployments by status",
+    )
+
+    # ===== MONITOR command =====
+    monitor_parser = local_deploy_subparsers.add_parser(
+        "monitor",
+        help="Live monitoring dashboard",
+        description="Display live monitoring dashboard for a deployment",
+    )
+    monitor_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to monitor",
+    )
+    monitor_parser.add_argument(
+        "--refresh",
+        "-r",
+        type=int,
+        default=2,
+        help="Refresh interval in seconds (default: 2)",
+    )
+
+    # ===== HISTORY command =====
+    history_parser = local_deploy_subparsers.add_parser(
+        "history",
+        help="Show restart history",
+        description="Show restart history and statistics for a deployment",
+    )
+    history_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to check",
+    )
+
+    # ===== ENABLE-AUTO-RESTART command =====
+    enable_auto_restart_parser = local_deploy_subparsers.add_parser(
+        "enable-auto-restart",
+        help="Enable auto-restart for a deployment",
+        description="Enable automatic restart on crashes for a deployment",
+    )
+    enable_auto_restart_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to enable auto-restart for",
+    )
+
+    # ===== DISABLE-AUTO-RESTART command =====
+    disable_auto_restart_parser = local_deploy_subparsers.add_parser(
+        "disable-auto-restart",
+        help="Disable auto-restart for a deployment",
+        description="Disable automatic restart on crashes for a deployment",
+    )
+    disable_auto_restart_parser.add_argument(
+        "deployment_id",
+        help="Deployment ID to disable auto-restart for",
+    )
+
+
+__all__ = ["add_local_deploy_arguments"]

claude_mpm/cli/parsers/mcp_parser.py

@@ -177,4 +177,19 @@ def add_mcp_subparser(subparsers) -> argparse.ArgumentParser:
         help="Show setup instructions for Claude Code",
     )
 
+    # External MCP services management
+    external_mcp_parser = mcp_subparsers.add_parser(
+        MCPCommands.EXTERNAL.value, help="Manage external MCP services"
+    )
+    external_mcp_parser.add_argument(
+        "external_action",
+        nargs="?",
+        choices=["setup", "list", "check", "fix-browser", "detect"],
+        default="list",
+        help="External service action (default: list)",
+    )
+    external_mcp_parser.add_argument(
+        "--force", action="store_true", help="Force overwrite existing configuration"
+    )
+
     return mcp_parser

claude_mpm/cli/parsers/monitor_parser.py

@@ -58,8 +58,18 @@ def add_monitor_subparser(subparsers) -> argparse.ArgumentParser:
         default=8766,
         help="Dashboard port (default: 8766)",
     )
-    start_monitor_parser.add_argument(
-        "--background", action="store_true", help="Run server in background"
+    # Add mutually exclusive group for foreground/background modes
+    mode_group = start_monitor_parser.add_mutually_exclusive_group()
+    mode_group.add_argument(
+        "--foreground",
+        action="store_true",
+        help="Run server in foreground mode (blocks terminal)",
+    )
+    mode_group.add_argument(
+        "--background",
+        action="store_true",
+        default=None,  # None allows us to detect when not specified
+        help="Run server in background/daemon mode (default behavior)",
     )
     start_monitor_parser.add_argument(
         "--force",

claude_mpm/cli/parsers/mpm_init_parser.py

@@ -30,10 +30,19 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         ),
         epilog=(
             "Examples:\n"
-            "  claude-mpm mpm-init                          # Initialize current directory\n"
-            "  claude-mpm mpm-init --project-type web       # Initialize as web project\n"
-            "  claude-mpm mpm-init --framework react        # Initialize with React framework\n"
-            "  claude-mpm mpm-init /path/to/project --force # Force reinitialize project"
+            "  claude-mpm mpm-init                                    # Initialize/update current directory\n"
+            "  claude-mpm mpm-init --catchup                          # Show recent git history for context\n"
+            "  claude-mpm mpm-init --review                           # Review project state without changes\n"
+            "  claude-mpm mpm-init --update                           # Update existing CLAUDE.md\n"
+            "  claude-mpm mpm-init --quick-update                     # Quick update based on recent git activity\n"
+            "  claude-mpm mpm-init --quick-update --non-interactive   # View activity report only\n"
+            "  claude-mpm mpm-init --quick-update --days 7            # Analyze last 7 days\n"
+            "  claude-mpm mpm-init --quick-update --export            # Export report to default location\n"
+            "  claude-mpm mpm-init --quick-update --export report.md  # Export to specific file\n"
+            "  claude-mpm mpm-init --organize                         # Organize project structure\n"
+            "  claude-mpm mpm-init --project-type web                 # Initialize as web project\n"
+            "  claude-mpm mpm-init --framework react                  # Initialize with React framework\n"
+            "  claude-mpm mpm-init /path/to/project --force           # Force reinitialize project"
         ),
         formatter_class=argparse.RawDescriptionHelpFormatter,
     )
@@ -73,6 +82,46 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         action="store_true",
         help="Force reinitialization even if project is already configured",
     )
+    init_group.add_argument(
+        "--update",
+        action="store_true",
+        help="Update existing CLAUDE.md instead of recreating (smart merge)",
+    )
+    init_group.add_argument(
+        "--quick-update",
+        action="store_true",
+        help="Perform lightweight update based on recent git activity (default: 30 days)",
+    )
+    init_group.add_argument(
+        "--catchup",
+        action="store_true",
+        help="Show recent commit history from all branches for PM context",
+    )
+    init_group.add_argument(
+        "--non-interactive",
+        action="store_true",
+        help="Non-interactive mode - display report only without prompting for changes (use with --quick-update)",
+    )
+    init_group.add_argument(
+        "--days",
+        type=int,
+        default=30,
+        choices=[7, 14, 30, 60, 90],
+        help="Number of days for git history analysis in quick update mode (default: 30)",
+    )
+    init_group.add_argument(
+        "--export",
+        type=str,
+        nargs="?",
+        const="auto",
+        metavar="PATH",
+        help="Export activity report to file (default: docs/reports/activity-report-{timestamp}.md)",
+    )
+    init_group.add_argument(
+        "--review",
+        action="store_true",
+        help="Review project state without making changes (analysis only)",
+    )
     init_group.add_argument(
         "--minimal",
         action="store_true",
@@ -83,11 +132,6 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         action="store_true",
         help="Create comprehensive setup including CI/CD, testing, and deployment configs",
     )
-    init_group.add_argument(
-        "--use-venv",
-        action="store_true",
-        help="Use traditional Python venv instead of mamba/conda environment",
-    )
     init_group.add_argument(
         "--ast-analysis",
         action="store_true",
@@ -113,6 +157,31 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         "--list-templates", action="store_true", help="List available project templates"
     )
 
+    # Project organization options
+    org_group = mpm_init_parser.add_argument_group("organization options")
+    org_group.add_argument(
+        "--organize",
+        action="store_true",
+        help="Organize misplaced files into proper directories",
+    )
+    org_group.add_argument(
+        "--preserve-custom/--no-preserve-custom",
+        default=True,
+        dest="preserve_custom",
+        help="Preserve custom sections when updating (default: preserve)",
+    )
+    org_group.add_argument(
+        "--skip-archive",
+        action="store_true",
+        help="Skip archiving existing files before updating",
+    )
+    org_group.add_argument(
+        "--archive-dir",
+        type=str,
+        default="docs/_archive",
+        help="Directory for archiving old documentation (default: docs/_archive)",
+    )
+
     # Output options
     output_group = mpm_init_parser.add_argument_group("output options")
     output_group.add_argument(
@@ -137,5 +206,106 @@ def add_mpm_init_subparser(subparsers: Any) -> None:
         help="Path to project directory (default: current directory)",
     )
 
+    # Add subparsers for context commands
+    subcommands = mpm_init_parser.add_subparsers(
+        dest="subcommand",
+        title="context management",
+        description="Commands for managing project context",
+    )
+
+    # Context subcommand (primary name)
+    context_parser = subcommands.add_parser(
+        "context",
+        help="Provide intelligent context for resuming work",
+        description="Analyze git history to provide context for resuming work",
+        epilog="Note: 'resume' is deprecated, use 'context' instead",
+    )
+    context_parser.add_argument(
+        "--session-id",
+        "-i",
+        type=str,
+        help="Unused (for compatibility) - will be removed in future version",
+    )
+    context_parser.add_argument(
+        "--days",
+        type=int,
+        default=7,
+        help="Number of days of git history to analyze (default: 7)",
+    )
+    context_parser.add_argument(
+        "project_path",
+        nargs="?",
+        default=".",
+        help="Path to project directory (default: current directory)",
+    )
+
+    # Resume subcommand (deprecated alias for backward compatibility)
+    resume_parser = subcommands.add_parser(
+        "resume",
+        help="[DEPRECATED] Use 'context' instead",
+        description="[DEPRECATED] This command is deprecated. Use 'context' instead.\n\n"
+        "Analyze git history to provide context for resuming work",
+    )
+    resume_parser.add_argument(
+        "--session-id",
+        "-i",
+        type=str,
+        help="Unused (for compatibility) - will be removed in future version",
+    )
+    resume_parser.add_argument(
+        "--days",
+        type=int,
+        default=7,
+        help="Number of days of git history to analyze (default: 7)",
+    )
+    resume_parser.add_argument(
+        "project_path",
+        nargs="?",
+        default=".",
+        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/run_parser.py

@@ -68,6 +68,11 @@ def add_run_arguments(parser: argparse.ArgumentParser) -> None:
         action="store_true",
         help="Force operations even with warnings (e.g., large .claude.json file)",
     )
+    run_group.add_argument(
+        "--reload-agents",
+        action="store_true",
+        help="Force rebuild of all system agents by deleting local claude-mpm agents",
+    )
     run_group.add_argument(
         "--mpm-resume",
         type=str,