claude-mpm 5.4.36__py3-none-any.whl → 5.4.59__py3-none-any.whl

claude_mpm/commands/mpm-config.md

@@ -4,262 +4,25 @@ command: config
 aliases: [mpm-config]
 migration_target: /mpm/config
 category: config
-deprecated_aliases: [mpm-config-view]
-description: Unified configuration management with auto-detection and manual viewing
+description: Manage Claude MPM configuration
 ---
-# Unified configuration management
+# /mpm-config
 
-Manage Claude MPM configuration with auto-detection, manual viewing, validation, and status checks.
+Unified configuration management with auto-detection.
 
 ## Usage
-
-```
-/mpm-config [subcommand] [options]
-/mpm-config              # No args = auto (detect + recommend + preview)
-/mpm-config view         # Show current config
-/mpm-config auto         # Auto-configure: detect → recommend → deploy (with confirmation)
-/mpm-config auto --yes   # Auto-deploy without confirmation
-```
-
-## Description
-
-This unified command provides comprehensive configuration management:
-
-1. **Auto-configuration** (default): Detect toolchain and recommend agents/skills
-2. **Manual viewing**: Display current configuration settings
-3. **Validation**: Ensure configuration correctness
-4. **Status checks**: Show system health
-
-## Subcommands
-
-### Auto-Configure (Default)
-
-Automatically detect project toolchain and configure appropriate agents and skills.
-
-```
-/mpm-config              # Preview recommendations (default)
-/mpm-config auto         # Same as no args - detect and preview
-/mpm-config auto --yes   # Auto-deploy without confirmation
-```
-
-**What it does:**
-1. Scans project to detect programming languages, frameworks, and tools
-2. Recommends agents for your stack (e.g., fastapi-engineer, react-engineer)
-3. Recommends skills based on agent types
-4. Shows preview of what will be configured
-5. Deploys with confirmation (unless `--yes` is used)
-
-**Options:**
-- `--yes`: Automatically deploy without prompting
-- `--preview`: Show recommendations without deploying (default when no args)
-- `--min-confidence FLOAT`: Minimum confidence threshold (default: 0.8)
-- `--agents-only`: Only configure agents, skip skills
-- `--skills-only`: Only configure skills, skip agents
-- `--json`: Output results in JSON format
-
-**Examples:**
-```
-/mpm-config                    # Preview auto-configuration
-/mpm-config auto               # Same as above
-/mpm-config auto --yes         # Deploy automatically
-/mpm-config auto --min-confidence 0.7  # Lower threshold
-```
-
-**Detection Capabilities:**
-
-**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, unittest (Python)
-- Jest, Vitest (JavaScript)
-- Playwright, Cypress (Browser)
-
-**Example Output:**
-```
-📊 Detected Toolchain:
-  ✓ Python 3.11 (100% confidence)
-  ✓ FastAPI 0.104.0 (95% confidence)
-  ✓ pytest 7.4.0 (90% confidence)
-
-🤖 Recommended Agents:
-  ✓ fastapi-engineer (95% confidence)
-    Reason: FastAPI framework detected
-  ✓ python-engineer (90% confidence)
-    Reason: Python project support
-  ✓ api-qa (85% confidence)
-    Reason: API testing and validation
-
-🎯 Recommended Skills:
-  ✓ toolchains-python-frameworks-fastapi
-  ✓ toolchains-python-testing-pytest
-  ✓ toolchains-universal-api-testing
-
-Deploy 3 agent(s) and 3 skill(s)? (y/n/s for select):
-```
-
-### View Configuration
-
-Display current configuration settings.
-
-```
-/mpm-config view [--section SECTION] [--format FORMAT] [--show-defaults]
-```
-
-**Options:**
-- `--section SECTION`: Specific configuration section to view
-- `--format FORMAT`: Output format (yaml, json, table)
-- `--show-defaults`: Include default values in output
-
-**Examples:**
-```
-/mpm-config view
-/mpm-config view --section agents --format json
-/mpm-config view --show-defaults
-```
-
-### Validate Configuration
-
-Validate configuration files for correctness and completeness.
-
-```
-/mpm-config validate [--config-file PATH] [--strict] [--fix]
-```
-
-**Options:**
-- `--config-file PATH`: Validate specific config file (default: all)
-- `--strict`: Use strict validation rules
-- `--fix`: Attempt to fix validation errors automatically
-
-**Example:**
 ```
-/mpm-config validate --strict
-/mpm-config validate --config-file .claude/config.yaml --fix
+/mpm-config [auto|view|validate|status] [options]
 ```
 
-**Expected Output:**
-```
-Validating configuration files...
-
-✓ .claude/config.yaml: Valid
-✓ .claude/agents/config.yaml: Valid
-✓ Configuration schema: Valid
-
-Configuration is valid and ready to use.
-```
-
-### Configuration Status
-
-Show configuration health and status.
-
-```
-/mpm-config status [--verbose]
-```
-
-**Options:**
-- `--verbose`: Show detailed status information
-
-**Example:**
-```
-/mpm-config status --verbose
-```
-
-**Expected Output:**
-```
-Configuration Status
-====================
-
-Files Found: 2
-  ✓ .claude/config.yaml
-  ✓ .claude/agents/config.yaml
-
-Validation: Passed
-Schema Version: 4.5
-Last Modified: 2025-01-15 14:30:22
-
-Active Settings:
-  - WebSocket Port: 8765
-  - Agent Deploy Mode: project
-  - Logging Level: INFO
-```
-
-## Implementation
-
-This command executes:
-```bash
-claude-mpm config [subcommand] [options]
-```
-
-The slash command passes through to the actual CLI configuration management system.
-
-## Configuration Categories
-
-Configuration is organized into sections:
-
-- **agents**: Agent deployment and management settings
-- **memory**: Memory system configuration
-- **websocket**: WebSocket server settings (port, host)
-- **hooks**: Hook service configuration
-- **logging**: Logging levels and output
-- **tickets**: Ticket tracking settings
-- **monitor**: Dashboard and monitoring settings
-
-## Workflow Examples
-
-### Quick Start (New Project)
-```
-/mpm-config                    # Preview recommendations
-# Review output, then:
-/mpm-config auto --yes         # Deploy recommended agents and skills
-```
-
-### Check Current State
-```
-/mpm-config view               # See current settings
-/mpm-config status             # Verify health
-```
-
-### Validate After Manual Edits
-```
-/mpm-config validate --strict
-```
-
-### Reconfigure After Stack Changes
-```
-/mpm-config auto --force       # Re-run auto-detection
-```
-
-## Default Configuration Fallback
-
-When auto-configuration cannot detect your project's toolchain, it falls back to sensible defaults:
-
-**Default Agents** (moderate confidence 0.7):
-- engineer (general-purpose)
-- research (code exploration)
-- qa (testing)
-- ops (infrastructure)
-- documentation (technical writing)
-
-**Disable defaults:**
-Edit `.claude-mpm/config/agent_capabilities.yaml`:
-```yaml
-default_configuration:
-  enabled: false  # Disable default fallback
-```
+**Modes:**
+- `auto` (default): Auto-detect toolchain and configure agents/skills
+- `view`: Display current configuration
+- `validate`: Check configuration validity
+- `status`: Show configuration health
 
-## Related Commands
+**Key Options:**
+- `--yes`: Auto-deploy without confirmation
+- `--preview`: Show recommendations only
 
-- `/mpm-status`: Show overall system status
-- `/mpm-doctor`: Diagnose configuration issues
-- `/mpm-init`: Initialize project configuration
-- `/mpm-agents`: Manually manage agents
-- `/mpm-configure`: Unified configuration interface (includes toolchain detection and recommendations)
+See docs/commands/config.md for full options.

claude_mpm/commands/mpm-doctor.md

@@ -4,30 +4,17 @@ command: doctor
 aliases: [mpm-doctor]
 migration_target: /mpm/system:doctor
 category: system
-deprecated_aliases: []
-description: Run comprehensive diagnostic checks on Claude MPM installation
+description: Run diagnostic checks on Claude MPM installation
 ---
-# Run diagnostic checks on claude-mpm installation
+# /mpm-doctor
 
-Run comprehensive diagnostic checks on your Claude MPM installation to identify and fix common issues.
+Run comprehensive diagnostics on Claude MPM installation.
 
-This command checks:
-- Installation integrity
-- Configuration validity
-- WebSocket connectivity
-- Agent deployment status
-- Memory system health
-- Hook service status
+## Usage
+```
+/mpm-doctor [--verbose] [--fix]
+```
 
-Usage: /mpm-doctor [options]
+Checks: installation, configuration, WebSocket, agents, memory, hooks.
 
-Options:
-- --verbose: Show detailed output
-- --no-color: Disable colored output  
-- --checks [list]: Run specific checks only
-- --fix: Attempt to fix identified issues
-
-Examples:
-- /mpm-doctor
-- /mpm-doctor --verbose
-- /mpm-doctor --fix
+See docs/commands/doctor.md for details.

claude_mpm/commands/mpm-help.md

@@ -4,218 +4,17 @@ command: help
 aliases: [mpm-help]
 migration_target: /mpm/system:help
 category: system
-deprecated_aliases: []
-description: Display help information for Claude MPM slash commands and CLI capabilities
+description: Display help for Claude MPM commands
 ---
-# Show help for available MPM commands
+# /mpm-help
 
-Display help information for Claude MPM slash commands and CLI capabilities.
+Show help for MPM commands. Delegates to PM agent.
 
 ## Usage
-
 ```
 /mpm-help [command]
 ```
 
-## Description
-
-This slash command delegates to the **PM agent** to provide comprehensive help information about available MPM commands and capabilities.
-
-## Implementation
-
-This slash command delegates to the **PM agent** to show help information.
-
-When you run `/mpm-help [command]`, the PM will:
-1. List all available slash commands if no command specified
-2. Show detailed help for a specific command if provided
-3. Include usage examples and options
-4. Explain what each command does and when to use it
-
-## Examples
-
-### Show All Commands
-```
-/mpm-help
-```
-
-Shows a complete list of all available MPM slash commands with brief descriptions.
-
-### Show Command-Specific Help
-```
-/mpm-help doctor
-/mpm-help agents
-/mpm-help config
-/mpm-help organize
-```
-
-Shows detailed help for a specific command including:
-- Full description
-- Available options and flags
-- Usage examples
-- Related commands
-
-## Expected Output
-
-### General Help
-```
-Claude MPM Slash Commands
-=========================
-
-Available Commands:
-
-/mpm-help [command]
-  Show this help or help for specific command
-
-/mpm-status
-  Display system status and environment information
-
-/mpm-doctor [--fix] [--verbose]
-  Diagnose and fix common issues
-
-/mpm-postmortem [--auto-fix] [--create-prs]
-  Analyze session errors and suggest improvements
-
-/mpm-agents [list|deploy|remove] [name]
-  Manage agent deployment
-
-/mpm-configure
-  🤖 Unified configuration interface for agents, skills, and project settings
-
-/mpm-config [validate|view|status]
-  Manage configuration settings
-
-/mpm-ticket [organize|proceed|status|update|project]
-  High-level ticketing workflows and project management
-
-/mpm-organize [--dry-run] [--force]
-  Organize project file structure
-
-/mpm-init [update]
-  Initialize or update project documentation
-
-/mpm-resume
-  Create session resume files for easy work resumption
-
-/mpm-monitor [start|stop|restart|status|port]
-  Manage Socket.IO monitoring server and dashboard
-
-/mpm-version
-  Display comprehensive version information including project version, all agents with versions, and all skills with versions
-
-Use '/mpm-help <command>' for detailed help on a specific command.
-```
-
-### Command-Specific Help
-```
-/mpm-doctor - Diagnose and Fix Issues
-======================================
-
-Description:
-  Runs comprehensive diagnostics on your Claude MPM installation
-  and project setup. Can automatically fix common issues.
-
-Usage:
-  /mpm-doctor [options]
-
-Options:
-  --fix       Automatically fix detected issues
-  --verbose   Show detailed diagnostic output
-
-Examples:
-  /mpm-doctor              # Run diagnostics
-  /mpm-doctor --fix        # Run and fix issues
-  /mpm-doctor --verbose    # Show detailed output
-
-What it checks:
-  - Python environment and dependencies
-  - Configuration file validity
-  - Agent deployment status
-  - Service availability (WebSocket, Hooks)
-  - Memory system integrity
-  - Git repository status
-
-Related Commands:
-  /mpm-status   Show current system status
-  /mpm-config   Manage configuration
-```
-
-## Auto-Configuration Commands (NEW!)
-
-### /mpm-auto-configure - Automatic Agent Configuration
-
-**Description:**
-Automatically detects your project's toolchain and frameworks, then recommends and optionally deploys the most appropriate agents for your stack.
-
-**Usage:**
-```
-/mpm-auto-configure [options]
-```
-
-**Options:**
-- `--preview` - Show what would be configured without making changes
-- `--yes` - Skip confirmation prompts and apply automatically
-- `--force` - Force reconfiguration even if agents already deployed
-
-**Examples:**
-```
-/mpm-auto-configure --preview    # Preview recommendations
-/mpm-auto-configure              # Interactive configuration
-/mpm-auto-configure --yes        # Auto-apply recommendations
-```
-
-**What it detects:**
-- Programming languages (Python, Node.js, Rust, Go, Java)
-- Frameworks (FastAPI, Flask, Next.js, React, Vue, Express)
-- Testing tools (pytest, Jest, Vitest, Playwright)
-- Build tools (Vite, Webpack, Rollup)
-- Package managers (npm, yarn, pnpm, pip, poetry)
-- Deployment platforms (Vercel, Railway, Docker)
-
-**Recommended agents by stack:**
-- **Python + FastAPI**: fastapi-engineer, python-engineer, api-qa
-- **Next.js**: nextjs-engineer, react-engineer, web-qa
-- **React**: react-engineer, web-qa
-- **Full-stack**: Combination of backend + frontend agents
-- **Testing**: playwright-qa, api-qa based on detected test tools
-
-## Quick Start with Configuration
-
-For new projects or first-time setup, use the unified `/mpm-configure` command which provides:
-- Toolchain detection
-- Agent recommendations
-- Skills management
-- Auto-configuration
-
-**Usage:**
-```
-/mpm-configure
-```
-
-The interactive menu will guide you through:
-1. Detecting your project's toolchain
-2. Viewing recommended agents
-3. Deploying agents and skills
-4. Managing configuration settings
-
-## Supported Technology Stacks
-
-**Python:**
-- FastAPI, Flask, Django, Starlette
-- pytest, unittest
-- uvicorn, gunicorn
-
-**JavaScript/TypeScript:**
-- Next.js, React, Vue, Svelte
-- Express, Nest.js, Fastify
-- Jest, Vitest, Playwright
-- Vite, Webpack, Rollup
-
-**Other:**
-- Rust (Cargo, Actix, Rocket)
-- Go (modules, Gin, Echo)
-- Java (Maven, Gradle, Spring Boot)
-
-## Related Commands
+Shows all commands or detailed help for specific command.
 
-- All other `/mpm-*` commands - Access help for any command
-- Standard Claude `--help` flag - CLI-level help
+See docs/commands/help.md for full command reference.