claude-mpm 4.21.3__py3-none-any.whl → 5.0.2__py3-none-any.whl

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

@@ -134,4 +134,142 @@ def add_skills_subparser(subparsers) -> argparse.ArgumentParser:
         help="Show configuration file path",
     )
 
+    # 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",
+    )
+    deploy_github_parser.add_argument(
+        "--all",
+        action="store_true",
+        help="Deploy all available skills (no filtering)",
+    )
+
+    # 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

claude_mpm/cli/parsers/source_parser.py

@@ -0,0 +1,138 @@
+"""Source command parser for agent repository management.
+
+WHY: This module provides CLI commands for managing agent source repositories
+(Git repositories containing agent markdown files). Extracted into its own
+module to support the single-tier deployment migration (Phase 2).
+
+DESIGN DECISION: Source management is separate from agent deployment to
+maintain clear separation of concerns:
+- source commands: Manage repository configuration
+- agents commands: Deploy and manage agents themselves
+"""
+
+import argparse
+
+from .base_parser import add_common_arguments
+
+
+def add_source_subparser(subparsers) -> argparse.ArgumentParser:
+    """Add the source subparser with all repository management commands.
+
+    WHY: Agent 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 source subparser
+    """
+    # Source command with subcommands
+    source_parser = subparsers.add_parser(
+        "source",
+        help="Manage agent source repositories",
+    )
+    add_common_arguments(source_parser)
+
+    source_subparsers = source_parser.add_subparsers(
+        dest="source_command",
+        help="Source repository commands",
+        metavar="SUBCOMMAND",
+    )
+
+    # Add repository
+    add_parser = source_subparsers.add_parser(
+        "add",
+        help="Add a new agent source repository",
+    )
+    add_parser.add_argument(
+        "url",
+        help="GitHub repository URL (e.g., https://github.com/owner/repo)",
+    )
+    add_parser.add_argument(
+        "--subdirectory",
+        "--subdir",
+        help="Subdirectory path within repository (e.g., 'agents')",
+    )
+    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",
+    )
+
+    # Remove repository
+    remove_parser = source_subparsers.add_parser(
+        "remove",
+        help="Remove an agent source repository",
+    )
+    remove_parser.add_argument(
+        "identifier",
+        help="Repository identifier (e.g., 'owner/repo' or 'owner/repo/subdirectory')",
+    )
+
+    # List repositories
+    list_parser = source_subparsers.add_parser(
+        "list",
+        help="List configured agent source repositories",
+    )
+    list_parser.add_argument(
+        "--all",
+        action="store_true",
+        dest="show_all",
+        help="Show disabled repositories (default: only enabled)",
+    )
+
+    # Enable repository
+    enable_parser = source_subparsers.add_parser(
+        "enable",
+        help="Enable a disabled repository",
+    )
+    enable_parser.add_argument(
+        "identifier",
+        help="Repository identifier to enable",
+    )
+
+    # Disable repository
+    disable_parser = source_subparsers.add_parser(
+        "disable",
+        help="Disable a repository",
+    )
+    disable_parser.add_argument(
+        "identifier",
+        help="Repository identifier to disable",
+    )
+
+    # Disable system repository
+    disable_system_parser = source_subparsers.add_parser(
+        "disable-system",
+        help="Disable or enable the default system repository",
+    )
+    disable_system_parser.add_argument(
+        "--enable",
+        action="store_true",
+        help="Re-enable system repository instead of disabling",
+    )
+
+    # Sync repositories
+    sync_parser = source_subparsers.add_parser(
+        "sync",
+        help="Sync agent sources from Git",
+    )
+    sync_parser.add_argument(
+        "--force",
+        action="store_true",
+        help="Force sync even if cache is fresh (ignore ETags)",
+    )
+    sync_parser.add_argument(
+        "identifier",
+        nargs="?",
+        help="Optional: Sync only this repository (default: sync all)",
+    )
+
+    return source_parser