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

claude_mpm/cli/parsers/mpm_init_parser.py

@@ -0,0 +1,311 @@
+"""
+MPM-Init parser module for claude-mpm CLI.
+
+WHY: This module handles the mpm-init command parser configuration,
+providing a clean interface for initializing projects with optimal
+Claude Code and Claude MPM standards.
+"""
+
+import argparse
+from typing import Any
+
+
+def add_mpm_init_subparser(subparsers: Any) -> None:
+    """
+    Add the mpm-init subparser to the main parser.
+
+    WHY: The mpm-init command sets up projects for optimal use with
+    Claude Code and Claude MPM by delegating to the Agentic Coder Optimizer.
+
+    Args:
+        subparsers: The subparsers object to add the mpm-init command to
+    """
+    mpm_init_parser = subparsers.add_parser(
+        "mpm-init",
+        help="Initialize project for optimal Claude Code and Claude MPM usage",
+        description=(
+            "Initialize a project with comprehensive documentation, single-path workflows, "
+            "and optimized structure for AI agent understanding. Uses the Agentic Coder "
+            "Optimizer agent to establish clear standards and remove ambiguity."
+        ),
+        epilog=(
+            "Examples:\n"
+            "  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,
+    )
+
+    # Project configuration options
+    config_group = mpm_init_parser.add_argument_group("project configuration")
+    config_group.add_argument(
+        "--project-type",
+        choices=[
+            "web",
+            "api",
+            "cli",
+            "library",
+            "mobile",
+            "desktop",
+            "fullstack",
+            "data",
+            "ml",
+        ],
+        help="Type of project to initialize (auto-detected if not specified)",
+    )
+    config_group.add_argument(
+        "--framework",
+        type=str,
+        help="Specific framework to configure (e.g., react, vue, django, fastapi, express)",
+    )
+    config_group.add_argument(
+        "--language",
+        choices=["python", "javascript", "typescript", "go", "rust", "java", "cpp"],
+        help="Primary programming language (auto-detected if not specified)",
+    )
+
+    # Initialization options
+    init_group = mpm_init_parser.add_argument_group("initialization options")
+    init_group.add_argument(
+        "--force",
+        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",
+        help="Create minimal configuration (CLAUDE.md only, no additional setup)",
+    )
+    init_group.add_argument(
+        "--comprehensive",
+        action="store_true",
+        help="Create comprehensive setup including CI/CD, testing, and deployment configs",
+    )
+    init_group.add_argument(
+        "--ast-analysis",
+        action="store_true",
+        default=True,
+        dest="ast_analysis",
+        help="Enable AST analysis for enhanced developer documentation (default: enabled)",
+    )
+    init_group.add_argument(
+        "--no-ast-analysis",
+        action="store_false",
+        dest="ast_analysis",
+        help="Disable AST analysis for documentation generation",
+    )
+
+    # Template options
+    template_group = mpm_init_parser.add_argument_group("template options")
+    template_group.add_argument(
+        "--template",
+        type=str,
+        help="Use a specific template from claude-mpm templates library",
+    )
+    template_group.add_argument(
+        "--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(
+        "--dry-run",
+        action="store_true",
+        help="Show what would be done without making changes",
+    )
+    output_group.add_argument(
+        "--json", action="store_true", help="Output results in JSON format"
+    )
+    output_group.add_argument(
+        "--verbose",
+        action="store_true",
+        help="Show detailed output during initialization",
+    )
+
+    # Path argument
+    mpm_init_parser.add_argument(
+        "project_path",
+        nargs="?",
+        default=".",
+        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,

claude_mpm/cli/parsers/search_parser.py

@@ -0,0 +1,245 @@
+"""
+Search command parser for mcp-vector-search integration.
+
+This module provides argument parsing for the /mpm-search command.
+"""
+
+import argparse
+from typing import Optional
+
+
+def add_search_subparser(
+    subparsers: argparse._SubParsersAction,
+) -> argparse.ArgumentParser:
+    """
+    Add the search command parser.
+
+    Args:
+        subparsers: The subparsers action to add the search parser to.
+
+    Returns:
+        The created search parser.
+    """
+    search_parser = subparsers.add_parser(
+        "mpm-search",
+        aliases=["search"],
+        help="Search codebase using semantic search",
+        description=(
+            "Search the codebase using semantic search powered by mcp-vector-search. "
+            "Can search by query, find similar code, search by context, or manage the search index."
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  # Search for code by query
+  claude-mpm mpm-search "authentication logic"
+
+  # Find code similar to a file
+  claude-mpm mpm-search --similar src/auth.py
+
+  # Search by contextual description
+  claude-mpm mpm-search --context "find all API endpoints"
+
+  # Index the project (required before searching)
+  claude-mpm mpm-search --index
+
+  # Force reindex the project
+  claude-mpm mpm-search --index --force
+
+  # Check index status
+  claude-mpm mpm-search --status
+
+  # Search with filters
+  claude-mpm mpm-search "database" --language python --limit 20
+
+  # Search with multiple file extensions
+  claude-mpm mpm-search "test" --extensions .py --extensions .js
+
+  # Find similar code to a specific function
+  claude-mpm mpm-search --similar src/auth.py --function authenticate_user
+
+  # Search with context and focus areas
+  claude-mpm mpm-search --context "security vulnerabilities" --focus authentication --focus encryption
+
+  # Output as JSON for processing
+  claude-mpm mpm-search "api" --json
+""",
+    )
+
+    # Primary search modes (mutually exclusive)
+    search_mode = search_parser.add_mutually_exclusive_group()
+
+    search_mode.add_argument(
+        "query",
+        nargs="?",
+        help="Search query for semantic code search",
+    )
+
+    search_mode.add_argument(
+        "--similar",
+        "-s",
+        metavar="FILE",
+        help="Find code similar to the specified file",
+    )
+
+    search_mode.add_argument(
+        "--context",
+        "-c",
+        metavar="DESCRIPTION",
+        help="Search by contextual description of what you're looking for",
+    )
+
+    # Index management options
+    search_parser.add_argument(
+        "--index",
+        action="store_true",
+        help="Index or reindex the project codebase",
+    )
+
+    search_parser.add_argument(
+        "--status",
+        action="store_true",
+        help="Check project indexing status and statistics",
+    )
+
+    # Search filters and options
+    search_parser.add_argument(
+        "--limit",
+        "-l",
+        type=int,
+        default=10,
+        metavar="N",
+        help="Maximum number of results to return (default: 10, max: 50)",
+    )
+
+    search_parser.add_argument(
+        "--threshold",
+        "-t",
+        type=float,
+        default=0.3,
+        metavar="SCORE",
+        help="Similarity threshold between 0.0 and 1.0 (default: 0.3)",
+    )
+
+    search_parser.add_argument(
+        "--language",
+        metavar="LANG",
+        help="Filter by programming language (e.g., python, javascript, go)",
+    )
+
+    search_parser.add_argument(
+        "--extensions",
+        action="append",
+        metavar="EXT",
+        help="Filter by file extensions (e.g., .py, .js). Can be specified multiple times",
+    )
+
+    # Options for --similar mode
+    search_parser.add_argument(
+        "--function",
+        "-f",
+        metavar="NAME",
+        help="Function name within the file (used with --similar)",
+    )
+
+    # Options for --context mode
+    search_parser.add_argument(
+        "--focus",
+        action="append",
+        metavar="AREA",
+        help="Focus areas for contextual search (e.g., security, performance). Can be specified multiple times",
+    )
+
+    # Options for --index mode
+    search_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force reindexing even if index already exists (used with --index)",
+    )
+
+    # Output options
+    search_parser.add_argument(
+        "--json",
+        action="store_true",
+        dest="output_json",
+        help="Output results as JSON instead of formatted text",
+    )
+
+    # Additional filters
+    search_parser.add_argument(
+        "--class",
+        dest="class_name",
+        metavar="NAME",
+        help="Filter by class name",
+    )
+
+    search_parser.add_argument(
+        "--files",
+        metavar="PATTERN",
+        help="Filter by file patterns (e.g., '*.py' or 'src/*.js')",
+    )
+
+    # Verbose output
+    search_parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="Enable verbose output with additional details",
+    )
+
+    return search_parser
+
+
+def validate_search_args(args: argparse.Namespace) -> Optional[str]:
+    """
+    Validate search command arguments.
+
+    Args:
+        args: Parsed command line arguments.
+
+    Returns:
+        Error message if validation fails, None otherwise.
+    """
+    # Check threshold is in valid range
+    if hasattr(args, "threshold") and args.threshold is not None:
+        if not 0.0 <= args.threshold <= 1.0:
+            return "Similarity threshold must be between 0.0 and 1.0"
+
+    # Check limit is reasonable
+    if hasattr(args, "limit") and args.limit is not None:
+        if args.limit < 1:
+            return "Limit must be at least 1"
+        if args.limit > 50:
+            return "Limit cannot exceed 50"
+
+    # Check that function is only used with --similar
+    if (
+        hasattr(args, "function")
+        and args.function
+        and not getattr(args, "similar", None)
+    ):
+        return "--function can only be used with --similar"
+
+    # Check that focus is only used with --context
+    if hasattr(args, "focus") and args.focus and not getattr(args, "context", None):
+        return "--focus can only be used with --context"
+
+    # Check that force is only used with --index
+    if hasattr(args, "force") and args.force and not getattr(args, "index", False):
+        return "--force can only be used with --index"
+
+    # Ensure at least one operation is specified
+    if hasattr(args, "command") and args.command in ["mpm-search", "search"]:
+        has_operation = any(
+            [
+                getattr(args, "query", None),
+                getattr(args, "similar", None),
+                getattr(args, "context", None),
+                getattr(args, "index", False),
+                getattr(args, "status", False),
+            ]
+        )
+        if not has_operation:
+            return "No search operation specified. Use --help for options."
+
+    return None

claude_mpm/cli/parsers/skills_parser.py

@@ -0,0 +1,137 @@
+"""
+Skills command parser for claude-mpm CLI.
+
+WHY: This module contains all arguments specific to skills management commands,
+providing CLI access to the Skills Integration system.
+
+DESIGN DECISION: Skills commands expose the SkillsService functionality via CLI
+for listing, deploying, validating, updating, and configuring Claude Code skills.
+"""
+
+import argparse
+
+from ...constants import CLICommands, SkillsCommands
+from .base_parser import add_common_arguments
+
+
+def add_skills_subparser(subparsers) -> argparse.ArgumentParser:
+    """
+    Add the skills subparser with all skills management commands.
+
+    WHY: Skills management has multiple subcommands for discovery, deployment,
+    validation, updates, and configuration that need their own argument structures.
+
+    Args:
+        subparsers: The subparsers object from the main parser
+
+    Returns:
+        The configured skills subparser
+    """
+    # Skills command with subcommands
+    skills_parser = subparsers.add_parser(
+        CLICommands.SKILLS.value, help="Manage Claude Code skills"
+    )
+    add_common_arguments(skills_parser)
+
+    skills_subparsers = skills_parser.add_subparsers(
+        dest="skills_command", help="Skills commands", metavar="SUBCOMMAND"
+    )
+
+    # List command
+    list_parser = skills_subparsers.add_parser(
+        SkillsCommands.LIST.value, help="List available skills"
+    )
+    list_parser.add_argument(
+        "--category",
+        help="Filter by category (e.g., development, infrastructure, web-development)",
+    )
+    list_parser.add_argument(
+        "--agent", help="Show skills for specific agent (e.g., engineer, pm)"
+    )
+    list_parser.add_argument(
+        "--verbose",
+        "-v",
+        action="store_true",
+        help="Show detailed skill information",
+    )
+
+    # Deploy command
+    deploy_parser = skills_subparsers.add_parser(
+        SkillsCommands.DEPLOY.value, help="Deploy bundled skills to project"
+    )
+    deploy_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force redeployment of already deployed skills",
+    )
+    deploy_parser.add_argument(
+        "--skill",
+        action="append",
+        dest="skills",
+        help="Deploy specific skill(s) only (can be used multiple times)",
+    )
+
+    # Validate command
+    validate_parser = skills_subparsers.add_parser(
+        SkillsCommands.VALIDATE.value, help="Validate skill structure and metadata"
+    )
+    validate_parser.add_argument("skill_name", help="Name of the skill to validate")
+    validate_parser.add_argument(
+        "--strict",
+        action="store_true",
+        help="Use strict validation (treat warnings as errors)",
+    )
+
+    # Update command
+    update_parser = skills_subparsers.add_parser(
+        SkillsCommands.UPDATE.value, help="Check for and install skill updates"
+    )
+    update_parser.add_argument(
+        "skill_names",
+        nargs="*",
+        help="Specific skills to update (default: all)",
+    )
+    update_parser.add_argument(
+        "--check-only",
+        action="store_true",
+        help="Check for updates without installing them",
+    )
+    update_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force update even if versions match",
+    )
+
+    # Info command
+    info_parser = skills_subparsers.add_parser(
+        SkillsCommands.INFO.value, help="Show detailed skill information"
+    )
+    info_parser.add_argument("skill_name", help="Name of the skill")
+    info_parser.add_argument(
+        "--show-content",
+        action="store_true",
+        help="Show full skill content (SKILL.md)",
+    )
+
+    # Config command
+    config_parser = skills_subparsers.add_parser(
+        SkillsCommands.CONFIG.value, help="View or edit skills configuration"
+    )
+    config_parser.add_argument(
+        "--scope",
+        choices=["system", "user", "project"],
+        default="project",
+        help="Configuration scope (default: project)",
+    )
+    config_parser.add_argument(
+        "--edit",
+        action="store_true",
+        help="Open configuration in $EDITOR",
+    )
+    config_parser.add_argument(
+        "--path",
+        action="store_true",
+        help="Show configuration file path",
+    )
+
+    return skills_parser