claude-mpm 5.4.14__py3-none-any.whl → 5.4.21__py3-none-any.whl

claude_mpm/cli/commands/agents_recommend.py

@@ -1,309 +0,0 @@
-"""
-Agents Recommend CLI Command for Claude MPM Framework
-======================================================
-
-WHY: This module provides a CLI interface for getting agent recommendations
-based on project toolchain without deploying anything. Useful for reviewing
-recommendations before committing to deployment.
-
-DESIGN DECISION: Focused on recommendation display with detailed reasoning,
-showing users why each agent was recommended. Supports JSON output for
-integration with other tools.
-
-Part of TSK-0054: Auto-Configuration Feature - Phase 5
-"""
-
-import json
-from pathlib import Path
-from typing import Optional
-
-try:
-    from rich.console import Console
-    from rich.panel import Panel
-    from rich.table import Table
-
-    RICH_AVAILABLE = True
-except ImportError:
-    RICH_AVAILABLE = False
-
-from ...services.agents.recommender import AgentRecommenderService
-from ...services.agents.registry import AgentRegistry
-from ...services.project.toolchain_analyzer import ToolchainAnalyzerService
-from ..shared import BaseCommand, CommandResult
-
-
-class AgentsRecommendCommand(BaseCommand):
-    """
-    Handle agents recommend CLI command.
-
-    This command analyzes the project toolchain and recommends appropriate
-    agents without deploying them. Shows detailed reasoning for each
-    recommendation.
-    """
-
-    def __init__(self):
-        """Initialize the agents recommend command."""
-        super().__init__("agents-recommend")
-        self.console = Console() if RICH_AVAILABLE else None
-        self._toolchain_analyzer = None
-        self._agent_recommender = None
-
-    @property
-    def toolchain_analyzer(self) -> ToolchainAnalyzerService:
-        """Get toolchain analyzer (lazy loaded)."""
-        if self._toolchain_analyzer is None:
-            self._toolchain_analyzer = ToolchainAnalyzerService()
-        return self._toolchain_analyzer
-
-    @property
-    def agent_recommender(self) -> AgentRecommenderService:
-        """Get agent recommender (lazy loaded)."""
-        if self._agent_recommender is None:
-            agent_registry = AgentRegistry()
-            self._agent_recommender = AgentRecommenderService(
-                agent_registry=agent_registry
-            )
-        return self._agent_recommender
-
-    def validate_args(self, args) -> Optional[str]:
-        """Validate command arguments."""
-        # Validate project path
-        project_path = (
-            Path(args.project_path)
-            if hasattr(args, "project_path") and args.project_path
-            else Path.cwd()
-        )
-        if not project_path.exists():
-            return f"Project path does not exist: {project_path}"
-
-        # Validate min_confidence range
-        if hasattr(args, "min_confidence") and args.min_confidence:
-            if not 0.0 <= args.min_confidence <= 1.0:
-                return "min_confidence must be between 0.0 and 1.0"
-
-        return None
-
-    def run(self, args) -> CommandResult:
-        """
-        Execute agents recommend command.
-
-        Returns:
-            CommandResult with success status and exit code
-        """
-        try:
-            # Setup logging
-            self.setup_logging(args)
-
-            # Validate arguments
-            error = self.validate_args(args)
-            if error:
-                return CommandResult.error_result(error)
-
-            # Get configuration options
-            project_path = (
-                Path(args.project_path)
-                if hasattr(args, "project_path") and args.project_path
-                else Path.cwd()
-            )
-            min_confidence = (
-                args.min_confidence
-                if hasattr(args, "min_confidence") and args.min_confidence
-                else 0.8
-            )
-            json_output = args.json if hasattr(args, "json") and args.json else False
-            show_reasoning = (
-                args.show_reasoning
-                if hasattr(args, "show_reasoning") and args.show_reasoning
-                else True
-            )
-
-            # Analyze toolchain
-            if self.console and not json_output:
-                with self.console.status("[bold green]Analyzing project toolchain..."):
-                    analysis = self.toolchain_analyzer.analyze_project(
-                        str(project_path)
-                    )
-            else:
-                analysis = self.toolchain_analyzer.analyze_project(str(project_path))
-
-            # Get recommendations
-            if self.console and not json_output:
-                with self.console.status(
-                    "[bold green]Generating agent recommendations..."
-                ):
-                    recommendations = self.agent_recommender.recommend_agents(
-                        analysis, min_confidence
-                    )
-            else:
-                recommendations = self.agent_recommender.recommend_agents(
-                    analysis, min_confidence
-                )
-
-            # Output results
-            if json_output:
-                return self._output_json(recommendations, analysis)
-            return self._display_results(recommendations, analysis, show_reasoning)
-
-        except KeyboardInterrupt:
-            if self.console:
-                self.console.print("\n\n❌ Operation cancelled by user")
-            else:
-                print("\n\nOperation cancelled by user")
-            return CommandResult.error_result("Operation cancelled", exit_code=130)
-
-        except Exception as e:
-            self.logger.exception("Agent recommendation failed")
-            error_msg = f"Agent recommendation failed: {e!s}"
-            if self.console:
-                self.console.print(f"\n❌ {error_msg}")
-            else:
-                print(f"\n{error_msg}")
-            return CommandResult.error_result(error_msg)
-
-    def _display_results(
-        self, recommendations, analysis, show_reasoning: bool
-    ) -> CommandResult:
-        """Display agent recommendations with Rich formatting."""
-        if not self.console:
-            return self._display_results_plain(
-                recommendations, analysis, show_reasoning
-            )
-
-        # Display header
-        self.console.print("\n🤖 Agent Recommendations", style="bold blue")
-        self.console.print(f"Project: {analysis.project_path}\n")
-
-        # Display quick summary
-        if recommendations:
-            summary_text = (
-                f"Found {len(recommendations)} recommended agent(s) "
-                f"for your project based on detected toolchain."
-            )
-            panel = Panel(summary_text, border_style="green")
-            self.console.print(panel)
-        else:
-            panel = Panel(
-                "No agents recommended for this project.\n"
-                "Try lowering the confidence threshold with --min-confidence",
-                border_style="yellow",
-            )
-            self.console.print(panel)
-            return CommandResult.success_result()
-
-        # Display recommendations table
-        self.console.print("\n📋 Recommended Agents:", style="bold green")
-        table = Table(show_header=True, header_style="bold")
-        table.add_column("Agent ID", style="cyan")
-        table.add_column("Confidence", style="green")
-        table.add_column("Priority", style="yellow")
-        if show_reasoning:
-            table.add_column("Reasoning", style="dim", no_wrap=False)
-
-        for rec in recommendations:
-            confidence_pct = int(rec.confidence * 100)
-            bar = "█" * (confidence_pct // 10) + "░" * (10 - confidence_pct // 10)
-            confidence_str = f"{bar} {confidence_pct}%"
-
-            if show_reasoning:
-                table.add_row(
-                    rec.agent_id,
-                    confidence_str,
-                    str(rec.priority),
-                    rec.reasoning,
-                )
-            else:
-                table.add_row(rec.agent_id, confidence_str, str(rec.priority))
-
-        self.console.print(table)
-
-        # Display match details if reasoning enabled
-        if show_reasoning:
-            self.console.print("\n🔍 Match Details:", style="bold blue")
-            for rec in recommendations:
-                self.console.print(f"\n[bold cyan]{rec.agent_id}[/bold cyan]")
-                self.console.print(f"  Confidence: {int(rec.confidence * 100)}%")
-                self.console.print(f"  Priority: {rec.priority}")
-                self.console.print(f"  Reasoning: {rec.reasoning}")
-
-                if rec.matched_capabilities:
-                    self.console.print("  Matched capabilities:", style="green")
-                    for cap in rec.matched_capabilities[:5]:
-                        self.console.print(f"    • {cap}", style="dim")
-                    if len(rec.matched_capabilities) > 5:
-                        remaining = len(rec.matched_capabilities) - 5
-                        self.console.print(f"    ... and {remaining} more", style="dim")
-
-        # Display next steps
-        self.console.print("\n💡 Next Steps:", style="bold yellow")
-        self.console.print("  1. Review the recommendations and their reasoning")
-        self.console.print(
-            "  2. Deploy agents with: [bold]claude-mpm auto-configure[/bold]"
-        )
-        self.console.print(
-            "  3. Or preview deployment with: [bold]claude-mpm auto-configure --preview[/bold]"
-        )
-
-        return CommandResult.success_result()
-
-    def _display_results_plain(
-        self, recommendations, analysis, show_reasoning: bool
-    ) -> CommandResult:
-        """Display results in plain text (fallback)."""
-        print("\n🤖 Agent Recommendations")
-        print(f"Project: {analysis.project_path}\n")
-
-        if not recommendations:
-            print("No agents recommended for this project.")
-            print("Try lowering the confidence threshold with --min-confidence")
-            return CommandResult.success_result()
-
-        print(f"Found {len(recommendations)} recommended agent(s) for your project:\n")
-
-        for rec in recommendations:
-            confidence_pct = int(rec.confidence * 100)
-            print(f"• {rec.agent_id} ({confidence_pct}% confidence)")
-
-            if show_reasoning:
-                print(f"  Priority: {rec.priority}")
-                print(f"  Reasoning: {rec.reasoning}")
-
-                if rec.matched_capabilities:
-                    print("  Matched capabilities:")
-                    for cap in rec.matched_capabilities[:5]:
-                        print(f"    - {cap}")
-                    if len(rec.matched_capabilities) > 5:
-                        remaining = len(rec.matched_capabilities) - 5
-                        print(f"    ... and {remaining} more")
-                print()
-
-        print("\nNext Steps:")
-        print("  1. Review the recommendations and their reasoning")
-        print("  2. Deploy agents with: claude-mpm auto-configure")
-        print("  3. Or preview deployment with: claude-mpm auto-configure --preview")
-
-        return CommandResult.success_result()
-
-    def _output_json(self, recommendations, analysis) -> CommandResult:
-        """Output recommendations as JSON."""
-        output = {
-            "project_path": analysis.project_path,
-            "recommendations": [
-                {
-                    "agent_id": rec.agent_id,
-                    "confidence": rec.confidence,
-                    "priority": rec.priority,
-                    "reasoning": rec.reasoning,
-                    "matched_capabilities": rec.matched_capabilities,
-                    "requirements": rec.requirements,
-                }
-                for rec in recommendations
-            ],
-            "toolchain_summary": {
-                "languages": len(analysis.languages),
-                "frameworks": len(analysis.frameworks),
-                "deployment_targets": len(analysis.deployment_targets),
-            },
-        }
-
-        print(json.dumps(output, indent=2))
-        return CommandResult.success_result(data=output)

claude_mpm/commands/mpm-agents-auto-configure.md

@@ -1,278 +0,0 @@
----
-namespace: mpm/agents
-command: auto-configure
-aliases: [mpm-agents-auto-configure]
-migration_target: /mpm/agents:auto-configure
-category: agents
-deprecated_aliases: [mpm-auto-configure]
-description: Automatically detect project toolchain and configure appropriate agents
----
-# Automatically configure agents based on project detection
-
-Automatically detect your project's toolchain and configure the most appropriate agents.
-
-## Usage
-
-```
-/mpm-auto-configure [options]
-```
-
-## Description
-
-This command provides intelligent auto-configuration that:
-1. Scans your project to detect programming languages, frameworks, and tools
-2. Recommends the most appropriate agents for your stack
-3. Optionally deploys the recommended agents with confirmation
-
-This is the fastest way to get started with Claude MPM in any project!
-
-## Options
-
-- `--preview` - Show what would be configured without making any changes
-- `--yes` - Automatically apply recommendations without prompting
-- `--force` - Force reconfiguration even if agents are already deployed
-
-## Implementation
-
-When you run `/mpm-auto-configure`, the PM will:
-
-1. **Detect Your Stack**:
-   - Scan for package.json, requirements.txt, Cargo.toml, go.mod, etc.
-   - Identify frameworks (FastAPI, Next.js, React, Express, etc.)
-   - Detect testing tools (pytest, Jest, Playwright, etc.)
-   - Find build tools and deployment configurations
-
-2. **Recommend Agents**:
-   - **Essential agents**: Required for your primary stack
-   - **Recommended agents**: Complementary agents for full functionality
-   - **Optional agents**: Specialized agents for detected tools
-
-3. **Deploy Agents** (with confirmation):
-   - Show what will be deployed
-   - Request confirmation (unless --yes is used)
-   - Deploy agents to your project
-   - Verify deployment success
-
-## Examples
-
-### Preview Mode (Recommended First Step)
-```
-/mpm-auto-configure --preview
-```
-Shows what would be configured without making changes. Great for understanding recommendations before applying.
-
-### Interactive Configuration
-```
-/mpm-auto-configure
-```
-Detect, recommend, and prompt for confirmation before deploying.
-
-### Automatic Configuration
-```
-/mpm-auto-configure --yes
-```
-Automatically apply all recommendations without prompting. Best for quick setup.
-
-### Force Reconfiguration
-```
-/mpm-auto-configure --force
-```
-Reconfigure agents even if some are already deployed. Useful for stack changes.
-
-## Expected Output
-
-```
-🤖 Auto-Configuration for Claude MPM
-=====================================
-
-Step 1: Detecting Project Stack
---------------------------------
-✓ Detected Python 3.11
-✓ Detected FastAPI 0.104.0
-✓ Detected pytest 7.4.0
-✓ Detected Docker configuration
-✓ Detected Vercel deployment
-
-Step 2: Agent Recommendations
-------------------------------
-Essential Agents (3):
-  ✓ fastapi-engineer - FastAPI framework detected
-  ✓ python-engineer - Python project support
-  ✓ api-qa - API testing and validation
-
-Recommended Agents (2):
-  ○ docker-ops - Docker configuration found
-  ○ vercel-ops - Vercel deployment detected
-
-Optional Agents (1):
-  ○ playwright-qa - Browser testing capability
-
-Step 3: Deploy Agents
----------------------
-Deploy 5 agents? (y/n): y
-
-Deploying agents...
-✓ fastapi-engineer deployed
-✓ python-engineer deployed
-✓ api-qa deployed
-✓ docker-ops deployed
-✓ vercel-ops deployed
-
-🎉 Auto-configuration complete!
-5 agents deployed successfully.
-
-Next steps:
-- Run /mpm-agents to see your deployed agents
-- Start working with specialized agents for your stack
-- Use /mpm-help for more information
-```
-
-## What Gets Detected
-
-### Languages
-- Python (CPython, PyPy)
-- JavaScript/TypeScript (Node.js, Deno, Bun)
-- Rust
-- Go
-- Java
-
-### Python Frameworks
-- FastAPI
-- Flask
-- Django
-- Starlette
-- Pyramid
-
-### JavaScript/TypeScript Frameworks
-- Next.js
-- React
-- Vue
-- Svelte
-- Angular
-- Express
-- Nest.js
-- Fastify
-
-### Testing Tools
-- pytest (Python)
-- unittest (Python)
-- Jest (JavaScript)
-- Vitest (JavaScript)
-- Playwright (Browser)
-- Cypress (Browser)
-
-### Build Tools
-- Vite
-- Webpack
-- Rollup
-- esbuild
-- Turbopack
-
-### Deployment Platforms
-- Vercel
-- Railway
-- Docker
-- PM2
-- Kubernetes
-
-## Agent Mapping Examples
-
-### Python + FastAPI
-**Essential:**
-- fastapi-engineer
-- python-engineer
-- api-qa
-
-**Recommended:**
-- docker-ops (if Docker detected)
-- vercel-ops (if Vercel detected)
-
-### Next.js + React
-**Essential:**
-- nextjs-engineer
-- react-engineer
-- web-qa
-
-**Recommended:**
-- playwright-qa (if Playwright detected)
-- vercel-ops (if Vercel detected)
-
-### Full-Stack (FastAPI + React)
-**Essential:**
-- fastapi-engineer
-- python-engineer
-- react-engineer
-- api-qa
-- web-qa
-
-**Recommended:**
-- playwright-qa
-- docker-ops
-- local-ops-agent
-
-## Default Configuration Fallback
-
-When auto-configuration cannot detect your project's toolchain (e.g., a new or uncommon language/framework), it automatically falls back to a sensible set of default general-purpose agents instead of leaving your project unconfigured.
-
-### When Defaults are Applied
-
-Default agents are deployed when:
-- Primary language is detected as "Unknown"
-- No specific framework or toolchain can be identified
-- No agent recommendations can be generated from detected technologies
-
-### Default Agents
-
-The following general-purpose agents are recommended with moderate confidence (0.7):
-
-- **engineer**: General-purpose engineer for code implementation
-- **research**: Code exploration and analysis
-- **qa**: Testing and quality assurance
-- **ops**: Infrastructure and deployment operations
-- **documentation**: Documentation and technical writing
-
-All default recommendations will be marked with `is_default: True` in the metadata.
-
-### Disabling Default Fallback
-
-To disable the default configuration fallback, edit `.claude-mpm/config/agent_capabilities.yaml`:
-
-```yaml
-default_configuration:
-  enabled: false  # Disable default fallback
-```
-
-When disabled, auto-configuration will recommend zero agents if the toolchain cannot be detected.
-
-### Customizing Defaults
-
-You can customize which agents are deployed by default by editing the `default_configuration.agents` section in `.claude-mpm/config/agent_capabilities.yaml`:
-
-```yaml
-default_configuration:
-  enabled: true
-  min_confidence: 0.7  # Confidence score for default recommendations
-  agents:
-    - agent_id: engineer
-      reasoning: "General-purpose engineer for code implementation"
-      priority: 1
-    - agent_id: research
-      reasoning: "Code exploration and analysis"
-      priority: 2
-    # Add or remove agents as needed
-```
-
-## Tips
-
-1. **Start with preview**: Always run with `--preview` first to see recommendations
-2. **Review carefully**: Check that detected stack matches your project
-3. **Customize later**: You can always deploy/remove agents manually after auto-config
-4. **Re-run after changes**: Run again with `--force` if you add new frameworks
-5. **Complementary commands**: Use `/mpm-agents-detect` and `/mpm-agents-recommend` for more details
-
-## Related Commands
-
-- `/mpm-agents-detect` - Just show detected toolchain
-- `/mpm-agents-recommend` - Show recommendations without deploying
-- `/mpm-agents` - Manage agents manually
-- `/mpm-help agents` - Learn about manual agent management