claude-mpm 4.7.4__py3-none-any.whl → 4.18.2__py3-none-any.whl

claude_mpm/commands/mpm-help.md

@@ -66,6 +66,15 @@ Available Commands:
 /mpm-agents [list|deploy|remove] [name]
   Manage agent deployment
 
+/mpm-auto-configure [--preview] [--yes]
+  🤖 NEW! Automatically configure agents based on your project
+
+/mpm-agents-detect
+  🤖 NEW! Detect project toolchain and frameworks
+
+/mpm-agents-recommend
+  🤖 NEW! Show recommended agents for your project
+
 /mpm-config [validate|view|status]
   Manage configuration settings
 
@@ -81,6 +90,9 @@ Available Commands:
 /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.
 ```
 
@@ -118,6 +130,157 @@ Related Commands:
   /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
+
+### /mpm-agents-detect - Toolchain Detection
+
+**Description:**
+Scans your project to detect programming languages, frameworks, tools, and configuration files.
+
+**Usage:**
+```
+/mpm-agents-detect
+```
+
+**Output:**
+- Detected languages and versions
+- Frameworks and their configurations
+- Testing tools and test frameworks
+- Build tools and bundlers
+- Package managers
+- Deployment configurations
+
+**Example:**
+```
+/mpm-agents-detect
+
+Detected Project Stack:
+======================
+Languages: Python 3.11, Node.js 20.x
+Frameworks: FastAPI 0.104.0, React 18.2.0
+Testing: pytest, Playwright
+Build: Vite 5.0.0
+Package Manager: poetry, npm
+Deployment: Docker, Vercel
+```
+
+### /mpm-agents-recommend - Agent Recommendations
+
+**Description:**
+Based on detected toolchain, shows which agents are recommended for your project with explanations.
+
+**Usage:**
+```
+/mpm-agents-recommend
+```
+
+**Output:**
+- Recommended agents with rationale
+- Agent capabilities and when to use them
+- Suggested deployment order
+- Complementary agent combinations
+
+**Example:**
+```
+/mpm-agents-recommend
+
+Recommended Agents for Your Project:
+===================================
+
+Essential Agents:
+✓ fastapi-engineer - Detected FastAPI framework
+✓ python-engineer - Python 3.11 project
+✓ api-qa - API testing and validation
+
+Recommended Agents:
+○ react-engineer - React frontend detected
+○ web-qa - Web UI testing
+○ playwright-qa - Playwright tests found
+
+Optional Agents:
+○ docker-ops - Docker configuration found
+○ vercel-ops - Vercel deployment detected
+```
+
+## Quick Start with Auto-Configuration
+
+For new projects or first-time setup:
+
+1. **Preview what would be configured:**
+   ```
+   /mpm-auto-configure --preview
+   ```
+
+2. **Review recommendations:**
+   ```
+   /mpm-agents-recommend
+   ```
+
+3. **Apply configuration:**
+   ```
+   /mpm-auto-configure
+   ```
+
+Or skip straight to auto-apply:
+```
+/mpm-auto-configure --yes
+```
+
+## 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
 
 - All other `/mpm-*` commands - Access help for any command

claude_mpm/commands/mpm-init.md

@@ -7,6 +7,9 @@ Initialize or intelligently update your project for optimal use with Claude Code
 ```
 /mpm-init                      # Auto-detects and offers update or create
 /mpm-init update               # Lightweight update based on recent git activity
+/mpm-init context              # Intelligent context analysis from git history
+/mpm-init context --days 14    # Analyze last 14 days of git history
+/mpm-init catchup              # Quick commit history display (no analysis)
 /mpm-init --review             # Review project state without changes
 /mpm-init --update             # Full update of existing CLAUDE.md
 /mpm-init --organize           # Organize project structure
@@ -17,7 +20,11 @@ Initialize or intelligently update your project for optimal use with Claude Code
 
 ## Description
 
-This command delegates to the Agentic Coder Optimizer agent to establish clear, single-path project standards for documentation, tooling, and workflows.
+This command has two primary modes:
+- **Project initialization/updates**: Delegates to the Agentic Coder Optimizer agent for documentation, tooling, and workflow setup
+- **Context analysis** (context/catchup): Provides intelligent project context from git history for resuming work
+
+**Note**: The `resume` subcommand is deprecated. Use `context` instead. The `resume` command still works for backward compatibility but will be removed in a future version.
 
 **Quick Update Mode**: Running `/mpm-init update` performs a lightweight update focused on recent git activity. It analyzes recent commits, generates an activity report, and updates documentation with minimal changes. Perfect for quick refreshes after development sprints.
 
@@ -54,6 +61,46 @@ This command delegates to the Agentic Coder Optimizer agent to establish clear,
 - `--no-preserve-custom`: Don't preserve custom sections
 - `--skip-archive`: Skip archiving existing files before updating
 
+## Context Analysis
+
+**Purpose**: Provide intelligent project context for resuming work by analyzing git history.
+
+### Commands
+
+#### `/mpm-init context` (Primary)
+```bash
+/mpm-init context                  # Analyze last 7 days of git history
+/mpm-init context --days 14        # Analyze last 14 days
+```
+
+Analyzes recent git commits to identify:
+- **Active work streams**: What was being worked on (themes from commit patterns)
+- **Intent and motivation**: Why this work matters (from commit messages)
+- **Risks and blockers**: What needs attention (stalled work, conflicts, anti-patterns)
+- **Recommended next actions**: What to work on next (logical continuations)
+
+**How it works**:
+1. Parses git history (default: last 7 days)
+2. PM delegates to Research agent with structured prompt
+3. Research analyzes work streams, intent, risks, recommendations
+4. PM presents intelligent summary for seamless work resumption
+
+**NOT session state**: This does NOT save/restore conversation state like Claude Code. Instead, it reconstructs project context from git history using conventional commits and commit message analysis.
+
+#### `/mpm-init resume` [DEPRECATED]
+Alias for `context`. Use `context` instead.
+
+### `/mpm-init catchup` (Simple Git History)
+```bash
+/mpm-init catchup
+```
+
+Quick display of last 25 commits across all branches. No analysis - just raw git log output with authors and dates. Use this for quick "what happened recently?" checks.
+
+**Distinction**:
+- **catchup**: Quick commit history (instant, no analysis)
+- **context**: Intelligent work resumption (10-30s, deep analysis)
+
 ## What This Command Does
 
 ### Auto-Detection (NEW)
@@ -146,6 +193,53 @@ Fast update based on recent 30-day git activity. Generates activity report and u
 
 **Note**: Typing `/mpm-init update` executes `claude-mpm mpm-init --quick-update` automatically.
 
+### Context Analysis (Intelligent Resumption)
+
+Get intelligent context for resuming work based on git history analysis:
+
+**Standard Context Analysis:**
+```bash
+/mpm-init context              # Analyze last 7 days (default)
+/mpm-init context --days 14    # Analyze last 14 days
+/mpm-init context --days 30    # Analyze last 30 days
+```
+
+This provides intelligent analysis including:
+- **Work stream identification** from commit patterns
+- **Intent analysis** (why work was done)
+- **Risk detection** (stalled work, conflicts, etc.)
+- **Recommended next actions** for seamless continuation
+
+**How it works:**
+1. Parses git history (7 days default)
+2. PM delegates to Research agent with structured prompt
+3. Research agent provides deep analysis
+4. PM presents intelligent summary
+
+**NOT session state**: This reconstructs context from git history, not saved conversation state.
+
+**Backward Compatibility:**
+```bash
+/mpm-init resume               # Still works but deprecated
+```
+
+The old `resume` command redirects to `context` with a deprecation warning.
+
+### Quick Git History (Catchup)
+
+Display recent commit history without analysis:
+
+```bash
+/mpm-init catchup
+```
+
+Shows:
+- Last 25 commits from all branches
+- Author attribution and timestamps
+- Contributor activity summary
+
+Use this for quick "what happened recently?" checks. For intelligent analysis, use `context` instead.
+
 ### Review Project State
 ```bash
 /mpm-init --review
@@ -193,6 +287,49 @@ Quick initialization without code analysis.
 
 This command routes between different modes:
 
+### Context Analysis Commands
+
+**IMPORTANT**: Context analysis commands (`/mpm-init context`, `/mpm-init catchup`) have distinct behaviors:
+
+**`/mpm-init context` - Delegates to PM**:
+```bash
+claude-mpm mpm-init context --days 7
+```
+
+This command delegates work to the PM framework:
+1. Parses git history (7 days default)
+2. PM constructs structured Research delegation prompt
+3. PM presents prompt for Research agent to analyze
+4. Research identifies work streams, intent, risks, recommendations
+5. PM synthesizes for user
+
+This is intelligent analysis requiring Research agent expertise.
+
+**How the PM delegates to Research:**
+The PM creates a delegation prompt that asks Research to analyze:
+- **Work Stream Identification**: Groups related commits into themes
+- **Intent Analysis**: Infers why work was done from commit messages
+- **Risk Detection**: Identifies stalled work, conflicts, and blockers
+- **Recommended Actions**: Suggests logical next steps for continuation
+
+**`/mpm-init catchup` - Direct CLI execution**:
+```bash
+claude-mpm mpm-init catchup
+```
+
+This executes directly via CLI without agent delegation:
+- Displays last 25 commits from all branches
+- Shows authors, dates, commit messages
+- Instant output (no analysis)
+
+This is a simple git log display utility.
+
+---
+
+### Project Initialization/Update Commands
+
+**IMPORTANT**: Standard initialization and update commands delegate to the Agentic Coder Optimizer agent.
+
 **Quick Update Mode** (`/mpm-init update`):
 ```bash
 claude-mpm mpm-init --quick-update
@@ -251,12 +388,20 @@ The command delegates to the Agentic Coder Optimizer agent which:
 ## Notes
 
 - **Quick Update vs Full Update**: Use `/mpm-init update` for fast activity-based updates (30 days), or `/mpm-init --update` for comprehensive doc refresh
+- **Context Analysis**: Use `/mpm-init context` to analyze git history and get intelligent resumption context from Research agent
+- **Quick History**: Use `/mpm-init catchup` for instant commit history display without analysis
+- **Deprecation Notice**: The `resume` command is deprecated. Use `context` instead. The old command still works but shows a warning.
 - **Smart Mode**: Automatically detects existing CLAUDE.md and offers update vs recreate
 - **Safe Updates**: Previous versions always archived before updating
 - **Custom Content**: Your project-specific sections are preserved by default
-- **Git Integration**: Analyzes recent commits to understand project evolution
+- **Git Integration**: Analyzes recent commits to understand project evolution and provide work context
+- **Backward Compatibility**: All existing `resume` commands redirect to `context` with deprecation warning
 - **Argument Processing**: The slash command processes the `update` argument and routes to `--quick-update` flag
-- The command uses the Agentic Coder Optimizer agent for implementation
+- **Agent Delegation**:
+  - Project initialization and updates use the Agentic Coder Optimizer agent
+  - Context analysis (`context`) delegates to PM, who coordinates with Research agent
+  - Simple git history (`catchup`) executes directly via CLI without agent delegation
+- **NOT Session State**: Context analysis reconstructs project understanding from git history, not saved conversation state
 - AST analysis is enabled by default for comprehensive documentation
 - Priority rankings help AI agents focus on critical instructions first
 - The holistic review ensures documentation quality and completeness

claude_mpm/commands/mpm-version.md

@@ -0,0 +1,113 @@
+# Display Claude MPM Version Information
+
+Show comprehensive version information for Claude MPM project, agents, and skills.
+
+## Usage
+
+```
+/mpm-version
+```
+
+## Description
+
+Display version information including:
+- Project version and build number
+- All deployed agents with their versions (grouped by tier: system/user/project)
+- All available skills with their versions (grouped by source: bundled/user/project)
+- Summary statistics
+
+## Implementation
+
+When you run `/mpm-version`, the PM will:
+
+1. **Collect Version Information**
+   - Use VersionService to gather all version data
+   - Project version from pyproject.toml
+   - Build number from BUILD_NUMBER file
+   - Agent versions from AgentRegistry
+   - Skills versions from SkillRegistry
+
+2. **Format Output**
+   - Hierarchical display: Project → Agents → Skills
+   - Grouped by tier/source for clarity
+   - Sorted alphabetically within groups
+   - Summary statistics at the end
+
+3. **Display Results**
+   - Well-formatted tree structure
+   - Easy to scan and read
+   - Includes totals and counts
+
+## Example Output
+
+```
+Claude MPM Version Information
+==============================
+
+Project Version: 4.16.3
+Build: 481
+
+Agents (35 total)
+-----------------
+
+System Agents (30):
+  ├─ agent-manager (1.0.0)
+  ├─ engineer (3.9.1)
+  ├─ research-agent (4.5.1)
+  ├─ documentation (2.1.0)
+  ├─ qa (2.0.3)
+  └─ ... (25 more)
+
+User Agents (3):
+  ├─ custom-agent (1.0.0)
+  ├─ testing-agent (0.5.0)
+  └─ prototype-agent (0.1.0)
+
+Project Agents (2):
+  ├─ project-specific (2.0.0)
+  └─ domain-expert (1.1.0)
+
+Skills (20 total)
+-----------------
+
+Bundled Skills (20):
+  ├─ test-driven-development (0.1.0)
+  ├─ systematic-debugging (0.1.0)
+  ├─ async-testing (0.1.0)
+  ├─ performance-profiling (0.1.0)
+  ├─ security-scanning (0.1.0)
+  └─ ... (15 more)
+
+User Skills (0):
+  (none)
+
+Project Skills (0):
+  (none)
+
+Summary
+-------
+• Project: v4.16.3 (build 481)
+• Agents: 35 total (30 system, 3 user, 2 project)
+• Skills: 20 total (20 bundled, 0 user, 0 project)
+```
+
+## PM Implementation Instructions
+
+To execute this command, PM should:
+
+1. Import and use VersionService:
+   ```python
+   from claude_mpm.services.version_service import VersionService
+
+   service = VersionService()
+   summary = service.get_version_summary()
+   ```
+
+2. Format output following the example structure above
+3. Handle missing data gracefully (show "unknown" for missing versions)
+4. Include all tiers/sources even if counts are zero
+
+## Related Commands
+
+- `/mpm-help` - Show all available MPM commands
+- `/mpm-status` - Show system status information

claude_mpm/commands/mpm.md

@@ -8,6 +8,7 @@ Available MPM commands:
 - /mpm-help - Show command help
 - /mpm-status - Show MPM status
 - /mpm-config - Manage configuration
+- /mpm-version - Display version information for project, agents, and skills
 
 Claude MPM extends Claude Code with:
 - Multi-agent orchestration

claude_mpm/config/agent_config.py

@@ -242,7 +242,7 @@ class AgentConfig:
                 Path.cwd() / get_path_manager().CONFIG_DIR / "agent_config.yaml"
             )
             if project_config.exists():
-                logger.info(f"Loading project agent config from {project_config}")
+                logger.debug(f"Loading project agent config from {project_config}")
                 file_config = cls.from_file(project_config)
                 # Merge with environment config (env takes precedence)
                 config = cls._merge_configs(config, file_config)
@@ -252,7 +252,7 @@ class AgentConfig:
             if user_config_dir:
                 user_config = user_config_dir / "agent_config.yaml"
                 if user_config.exists():
-                    logger.info(f"Loading user agent config from {user_config}")
+                    logger.debug(f"Loading user agent config from {user_config}")
                     file_config = cls.from_file(user_config)
                     config = cls._merge_configs(config, file_config)