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

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/skill_source_parser.py

@@ -0,0 +1,169 @@
+"""Skill source command parser for skill repository management.
+
+WHY: This module provides CLI commands for managing skill source repositories
+(Git repositories containing skill JSON files). Parallel to agent source management
+but for the Skills feature (single-tier Git-based skills system).
+
+DESIGN DECISION: Skill source management is separate from skill deployment to
+maintain clear separation of concerns:
+- skill-source commands: Manage repository configuration
+- skills commands: View and interact with skills themselves
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_skill_source_subparser(subparsers) -> argparse.ArgumentParser:
+    """Add the skill-source subparser with all repository management commands.
+
+    WHY: Skill 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 skill-source subparser
+    """
+    # Skill source command with subcommands
+    skill_source_parser = subparsers.add_parser(
+        "skill-source",
+        help="Manage skill source repositories",
+    )
+    add_common_arguments(skill_source_parser)
+
+    skill_source_subparsers = skill_source_parser.add_subparsers(
+        dest="skill_source_command",
+        help="Skill source repository commands",
+        metavar="SUBCOMMAND",
+    )
+
+    # Add repository
+    add_parser = skill_source_subparsers.add_parser(
+        "add",
+        help="Add a new skill source repository",
+    )
+    add_parser.add_argument(
+        "url",
+        help="Git repository URL (e.g., https://github.com/owner/repo)",
+    )
+    add_parser.add_argument(
+        "--branch",
+        default="main",
+        help="Git branch to use (default: main)",
+    )
+    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 = skill_source_subparsers.add_parser(
+        "remove",
+        help="Remove a skill source repository",
+    )
+    remove_parser.add_argument(
+        "source_id",
+        help="Source identifier (e.g., repository name)",
+    )
+    remove_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Skip confirmation prompt",
+    )
+
+    # List repositories
+    list_parser = skill_source_subparsers.add_parser(
+        "list",
+        help="List configured skill 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 = skill_source_subparsers.add_parser(
+        "update",
+        help="Update (sync) skill 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 = skill_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 = skill_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 = skill_source_subparsers.add_parser(
+        "show",
+        help="Show details for a skill source",
+    )
+    show_parser.add_argument(
+        "source_id",
+        help="Source identifier to show",
+    )
+    show_parser.add_argument(
+        "--skills",
+        action="store_true",
+        help="Also list skills from this source",
+    )
+
+    return skill_source_parser

claude_mpm/cli/parsers/skills_parser.py

@@ -0,0 +1,277 @@
+"""
+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",
+    )
+
+    # Configure command (interactive skills selection)
+    skills_subparsers.add_parser(
+        SkillsCommands.CONFIGURE.value,
+        help="Interactive skills configuration with checkbox selection (like agents configure)",
+    )
+    # No additional arguments needed - purely interactive
+
+    # GitHub deployment commands
+    # Deploy from GitHub command
+    deploy_github_parser = skills_subparsers.add_parser(
+        SkillsCommands.DEPLOY_FROM_GITHUB.value,
+        help="Deploy skills from GitHub to ~/.claude/skills/ for Claude Code",
+    )
+    deploy_github_parser.add_argument(
+        "--collection",
+        "-c",
+        help="Collection to deploy from (default: uses default collection)",
+    )
+    deploy_github_parser.add_argument(
+        "--toolchain",
+        nargs="+",
+        help="Filter by toolchain/language (e.g., python javascript rust)",
+    )
+    deploy_github_parser.add_argument(
+        "--categories",
+        nargs="+",
+        help="Filter by categories (e.g., testing debugging web)",
+    )
+    deploy_github_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force redeployment of already deployed skills",
+    )
+
+    # List available GitHub skills
+    list_available_parser = skills_subparsers.add_parser(
+        SkillsCommands.LIST_AVAILABLE.value,
+        help="List all available skills from GitHub repository",
+    )
+    list_available_parser.add_argument(
+        "--collection",
+        "-c",
+        help="Collection to list from (default: uses default collection)",
+    )
+    list_available_parser.add_argument(
+        "--verbose",
+        "-v",
+        action="store_true",
+        help="Show detailed skill information including names",
+    )
+
+    # Check deployed skills
+    skills_subparsers.add_parser(
+        SkillsCommands.CHECK_DEPLOYED.value,
+        help="Check which skills are currently deployed in ~/.claude/skills/",
+    )
+
+    # Remove skills
+    remove_parser = skills_subparsers.add_parser(
+        SkillsCommands.REMOVE.value,
+        help="Remove deployed skills from ~/.claude/skills/",
+    )
+    remove_parser.add_argument(
+        "skill_names",
+        nargs="*",
+        help="Specific skills to remove",
+    )
+    remove_parser.add_argument(
+        "--all",
+        action="store_true",
+        help="Remove all deployed skills",
+    )
+
+    # Collection management commands
+    # List collections
+    skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_LIST.value,
+        help="List all configured skill collections",
+    )
+
+    # Add collection
+    collection_add_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_ADD.value,
+        help="Add a new skill collection from GitHub",
+    )
+    collection_add_parser.add_argument(
+        "collection_name",
+        help="Name for the collection (e.g., obra-superpowers)",
+    )
+    collection_add_parser.add_argument(
+        "collection_url",
+        help="GitHub repository URL (e.g., https://github.com/obra/superpowers)",
+    )
+    collection_add_parser.add_argument(
+        "--priority",
+        type=int,
+        default=99,
+        help="Collection priority (lower = higher priority, default: 99)",
+    )
+
+    # Remove collection
+    collection_remove_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_REMOVE.value,
+        help="Remove a skill collection",
+    )
+    collection_remove_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to remove",
+    )
+
+    # Enable collection
+    collection_enable_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_ENABLE.value,
+        help="Enable a disabled collection",
+    )
+    collection_enable_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to enable",
+    )
+
+    # Disable collection
+    collection_disable_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_DISABLE.value,
+        help="Disable a collection without removing it",
+    )
+    collection_disable_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to disable",
+    )
+
+    # Set default collection
+    collection_set_default_parser = skills_subparsers.add_parser(
+        SkillsCommands.COLLECTION_SET_DEFAULT.value,
+        help="Set the default collection for deployments",
+    )
+    collection_set_default_parser.add_argument(
+        "collection_name",
+        help="Name of the collection to set as default",
+    )
+
+    return skills_parser