claude-mpm 5.4.106__tar.gz → 5.5.0__tar.gz

{claude_mpm-5.4.106/src/claude_mpm.egg-info → claude_mpm-5.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 5.4.106
+Version: 5.5.0
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team
@@ -108,7 +108,7 @@ Dynamic: license-file
 
 A powerful orchestration framework for **Claude Code (CLI)** that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
 
-> **⚠️ Important**: Claude MPM **requires Claude Code CLI** (v2.0.30+), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
+> **⚠️ Important**: Claude MPM **requires Claude Code CLI** (v2.1.3+), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
 >
 > **Don't have Claude Code?** Install from: https://docs.anthropic.com/en/docs/claude-code
 >
@@ -142,7 +142,7 @@ Claude MPM transforms Claude Code into a **multi-agent orchestration platform**
 ### Prerequisites
 
 1. **Python 3.10+** (3.11+ recommended)
-2. **Claude Code CLI v2.0.30+** (required!)
+2. **Claude Code CLI v2.1.3+** (required!)
 
 ```bash
 # Verify Claude Code is installed

{claude_mpm-5.4.106 → claude_mpm-5.5.0}/README.md

@@ -2,7 +2,7 @@
 
 A powerful orchestration framework for **Claude Code (CLI)** that enables multi-agent workflows, session management, and real-time monitoring through a streamlined Rich-based interface.
 
-> **⚠️ Important**: Claude MPM **requires Claude Code CLI** (v2.0.30+), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
+> **⚠️ Important**: Claude MPM **requires Claude Code CLI** (v2.1.3+), not Claude Desktop (app). All MCP integrations work with Claude Code's CLI interface only.
 >
 > **Don't have Claude Code?** Install from: https://docs.anthropic.com/en/docs/claude-code
 >
@@ -36,7 +36,7 @@ Claude MPM transforms Claude Code into a **multi-agent orchestration platform**
 ### Prerequisites
 
 1. **Python 3.10+** (3.11+ recommended)
-2. **Claude Code CLI v2.0.30+** (required!)
+2. **Claude Code CLI v2.1.3+** (required!)
 
 ```bash
 # Verify Claude Code is installed

{claude_mpm-5.4.106 → claude_mpm-5.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "5.4.106"
+version = "5.5.0"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -189,7 +189,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "5.4.106"
+version = "5.5.0"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-config.md

@@ -0,0 +1,36 @@
+---
+namespace: mpm/config
+command: config
+aliases: [mpm-config]
+migration_target: /mpm/config
+category: config
+description: Manage Claude MPM configuration
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-config"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-config` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-config` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-config
+
+Unified configuration management with auto-detection.
+
+## Usage
+```
+/mpm-config [auto|view|validate|status] [options]
+```
+
+**Modes:**
+- `auto` (default): Auto-detect toolchain and configure agents/skills
+- `view`: Display current configuration
+- `validate`: Check configuration validity
+- `status`: Show configuration health
+
+**Key Options:**
+- `--yes`: Auto-deploy without confirmation
+- `--preview`: Show recommendations only
+
+See docs/commands/config.md for full options.

{claude_mpm-5.4.106 → claude_mpm-5.5.0}/src/claude_mpm/commands/mpm-doctor.md

@@ -5,7 +5,15 @@ aliases: [mpm-doctor]
 migration_target: /mpm/system:doctor
 category: system
 description: Run diagnostic checks on Claude MPM installation
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-doctor"
 ---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-doctor` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-doctor` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
 # /mpm-doctor
 
 Run comprehensive diagnostics on Claude MPM installation.

{claude_mpm-5.4.106 → claude_mpm-5.5.0}/src/claude_mpm/commands/mpm-help.md

@@ -5,7 +5,15 @@ aliases: [mpm-help]
 migration_target: /mpm/system:help
 category: system
 description: Display help for Claude MPM commands
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-help"
 ---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-help` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-help` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
 # /mpm-help
 
 Show help for MPM commands. Delegates to PM agent.

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-init.md

@@ -0,0 +1,128 @@
+---
+namespace: mpm/system
+command: init
+aliases: [mpm-init]
+migration_target: /mpm/system:init
+category: system
+description: Initialize or update project for Claude Code and MPM
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-init"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-init` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-init` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-init
+
+Initialize or intelligently update project for Claude Code and Claude MPM.
+
+## Usage
+```
+/mpm-init [update|context|resume|catchup] [options]
+```
+
+## Core Modes
+
+### Project Setup
+```
+/mpm-init                      # Auto-detect: offer update or create
+/mpm-init update               # Quick update (30-day git activity)
+/mpm-init --update             # Full documentation refresh
+/mpm-init --force              # Force recreate from scratch
+```
+
+**Delegates to Agentic Coder Optimizer agent** for:
+- CLAUDE.md creation/update (with priority rankings 🔴🟡🟢⚪)
+- AST analysis and code structure docs
+- Single-path workflows (ONE way to do ANYTHING)
+- Tool configuration, memory system, gitignore management
+
+**Smart Update Mode:** Auto-detects existing CLAUDE.md and offers update vs recreate.
+
+### Context Analysis
+```
+/mpm-init context [--days N]   # Intelligent git history analysis (default: 7 days)
+/mpm-init catchup              # Quick commit history (last 25 commits, no analysis)
+```
+
+**context:** Delegates to Research agent for deep analysis of:
+- Active work streams (from commit patterns)
+- Intent and motivation (from messages)
+- Risks and blockers
+- Recommended next actions
+
+**catchup:** Direct CLI execution, instant output.
+
+### Resume from Logs
+```
+/mpm-init resume [--list] [--session-id ID]
+```
+
+Reads stop event logs from `.claude-mpm/resume-logs/` and `.claude-mpm/responses/` showing:
+- What was being worked on
+- Tasks completed, files modified
+- Next steps, stop reason, token usage
+- Git context (branch, status)
+
+## Key Options
+
+**Configuration:**
+- `--project-type TYPE`: web, api, cli, library
+- `--framework NAME`: react, django, fastapi, etc.
+- `--ast-analysis` / `--no-ast-analysis`: Enable/disable code analysis
+- `--comprehensive` / `--minimal`: Full setup vs CLAUDE.md only
+
+**Organization:**
+- `--organize`: Organize misplaced files
+- `--preserve-custom`: Keep custom sections (default)
+- `--review`: Review without changes
+
+## What Gets Created
+
+**New Projects:**
+- ✅ CLAUDE.md (priority-ranked instructions)
+- ✅ Single-path workflows (make build/test/deploy)
+- ✅ Tool configs (linting, formatting, testing)
+- ✅ Memory system (.claude-mpm/memories/)
+- ✅ DEVELOPER.md, CODE_STRUCTURE.md (with AST)
+- ✅ .gitignore updates (auto-adds .claude-mpm/)
+
+**Updates:**
+- ✅ Smart merging (preserves custom sections)
+- ✅ Automatic archival (docs/_archive/)
+- ✅ Change tracking
+
+## Examples
+
+```bash
+# Quick start
+/mpm-init                      # Auto-detect mode
+
+# Quick update (lightweight)
+/mpm-init update               # 30-day activity report
+
+# Resume work
+/mpm-init context --days 14    # Analyze last 2 weeks
+/mpm-init resume               # Show latest session from logs
+/mpm-init catchup              # Quick commit history
+
+# Full configuration
+/mpm-init --project-type web --framework react --comprehensive
+```
+
+## Implementation Notes
+
+**Delegation patterns:**
+- **Project init/update:** → Agentic Coder Optimizer agent
+- **context:** → PM → Research agent (structured analysis)
+- **catchup:** → Direct CLI (git log wrapper)
+- **resume:** → PM (reads logs, no delegation)
+
+**Token budgets:**
+- context analysis: 10-30s processing time
+- resume display: ~10-20k tokens
+- catchup: instant, minimal tokens
+
+See docs/commands/init.md for comprehensive documentation.

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-monitor.md

@@ -0,0 +1,39 @@
+---
+namespace: mpm/system
+command: monitor
+aliases: [mpm-monitor]
+migration_target: /mpm/system:monitor
+category: system
+description: Control monitoring server and dashboard
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-monitor"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-monitor` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-monitor` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-monitor
+
+Manage Socket.IO monitoring server for real-time dashboard.
+
+## Usage
+```
+/mpm-monitor [start|stop|restart|status|port] [options]
+```
+
+**Subcommands:**
+- `start`: Start server (auto-selects port 8765-8785)
+- `stop`: Stop running server
+- `status`: Show server status
+- `port <PORT>`: Start on specific port
+
+**Key Options:**
+- `--port PORT`: Specific port
+- `--force`: Force kill to reclaim port
+- `--foreground`: Run in foreground (default: background)
+
+Dashboard: http://localhost:8766
+
+See docs/commands/monitor.md for details.

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-organize.md

@@ -0,0 +1,128 @@
+---
+namespace: mpm/system
+command: organize
+aliases: [mpm-organize]
+migration_target: /mpm/system:organize
+category: system
+description: Organize project files with intelligent consolidation
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-organize"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-organize` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-organize` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-organize
+
+Organize ALL project files with intelligent detection, consolidation, and pruning.
+
+## Usage
+```
+/mpm-organize [--dry-run] [--force] [options]
+```
+
+**Delegates to Project Organizer agent** for comprehensive file organization.
+
+## Scope
+
+**Default:** Organizes ALL project files
+- Documentation (.md, .rst, .txt)
+- Source code (proper module structure)
+- Tests (organized test suites)
+- Scripts (scripts/ directory)
+- Configuration (appropriate locations)
+
+**Protected files (never moved):** README.md, package.json, pyproject.toml, Makefile, .gitignore, etc.
+
+## Key Options
+
+**Safety:**
+- `--dry-run`: Preview without changes (recommended first run)
+- `--force`: Proceed with uncommitted changes
+- `--no-backup`: Skip backup (not recommended)
+
+**Scope:**
+- `--docs-only`: Only documentation (legacy behavior)
+- `--code-only` / `--tests-only` / `--scripts-only`: Specific file types
+
+**Operations:**
+- `--consolidate-only`: Merge duplicates only
+- `--prune-only`: Remove stale files only
+- `--no-prune`: Keep all files (no deletions)
+
+## What It Does
+
+1. **Pattern Detection:** Scans for existing organization (PROJECT_ORGANIZATION.md, framework conventions)
+2. **Consolidation:** Merges duplicates (READMEs, guides, utilities)
+3. **Pruning:** Archives/removes stale content (>6 months old, empty files)
+4. **Categorization:** Sorts docs into research/user/developer
+5. **Safe Movement:** Uses `git mv` to preserve history
+6. **Backup:** Creates backup_project_YYYYMMDD_HHMMSS.tar.gz
+
+## Standard Structure
+
+```
+docs/
+├── research/        # Spikes, analysis, notes
+├── user/            # Guides, tutorials, FAQs
+└── developer/       # API docs, architecture, contributing
+
+src/<package>/       # Proper module structure
+tests/               # Mirrored source structure
+scripts/             # Automation tools
+config/              # Configuration (if needed)
+```
+
+## Examples
+
+```bash
+# Preview changes (recommended first)
+/mpm-organize --dry-run
+
+# Organize everything with backup
+/mpm-organize
+
+# Documentation only
+/mpm-organize --docs-only --dry-run
+
+# Consolidate without pruning
+/mpm-organize --consolidate-only --no-prune
+
+# Save report
+/mpm-organize --report /tmp/organize-report.md
+```
+
+## Expected Output
+
+```
+🔍 Analyzing project structure...
+✓ Detected PROJECT_ORGANIZATION.md - using project standards
+✓ Found 23 documentation files, 15 test files, 8 scripts
+
+📁 Proposed Changes:
+
+  Consolidate:
+    → Merge README_OLD.md + README_BACKUP.md → docs/user/README.md
+
+  Organize:
+    docs/research/ ← spike-oauth.md (from root)
+    tests/unit/ ← test_auth.py (from root)
+    scripts/ ← deploy.sh (from root)
+
+  Prune:
+    ✂ Remove TODO_2023.md (stale 18 months)
+
+📊 Summary: 8 to move, 2 to merge, 3 to prune
+```
+
+## Safety Features
+
+- Full project backup before changes
+- Git integration (preserves history)
+- Import validation (ensures moves won't break code)
+- Protected files never touched
+- Conservative pruning (archive when unsure)
+
+See docs/commands/organize.md for full documentation.

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-postmortem.md

@@ -0,0 +1,29 @@
+---
+namespace: mpm/analysis
+command: postmortem
+aliases: [mpm-postmortem]
+migration_target: /mpm/analysis:postmortem
+category: analysis
+description: Analyze session errors and suggest improvements
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-postmortem"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-postmortem` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-postmortem` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-postmortem
+
+Analyze session errors and generate improvement suggestions.
+
+## Usage
+```
+/mpm-postmortem [--auto-fix] [--create-prs] [--dry-run]
+```
+
+Analyzes errors from: scripts, skills, agents, user code.
+Generates: fixes, updates, PR recommendations, suggestions.
+
+See docs/commands/postmortem.md for details.

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-session-resume.md

@@ -0,0 +1,38 @@
+---
+namespace: mpm/session
+command: resume
+aliases: [mpm-session-resume]
+migration_target: /mpm/session:resume
+category: session
+description: Load context from paused session
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-session-resume"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-session-resume` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-session-resume` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-session-resume
+
+Load and display context from most recent paused session.
+
+## Usage
+```
+/mpm-resume
+```
+
+**What it shows:**
+- Session summary and time elapsed
+- Completed work and current tasks
+- Git context and recent commits
+- Next recommended actions
+
+**Session location:** `.claude-mpm/sessions/session-*.md`
+
+**Token usage:** ~20-40k tokens (10-20% of context budget)
+
+**Note:** Reads existing sessions (created automatically at 70% context). Does NOT create new files.
+
+See docs/features/session-auto-resume.md for details.

{claude_mpm-5.4.106 → claude_mpm-5.5.0}/src/claude_mpm/commands/mpm-status.md

@@ -5,7 +5,15 @@ aliases: [mpm-status]
 migration_target: /mpm/system:status
 category: system
 description: Display Claude MPM system status
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-status"
 ---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-status` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-status` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
 # /mpm-status
 
 Show MPM system status. Delegates to PM agent.

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-ticket-view.md

@@ -0,0 +1,117 @@
+---
+namespace: mpm/ticket
+command: view
+aliases: [mpm-ticket-view]
+migration_target: /mpm/ticket:view
+category: tickets
+description: Orchestrate ticketing agent for project management workflows
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-ticket-view"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-ticket-view` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-ticket-view` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-ticket
+
+High-level ticketing workflows delegating to ticketing agent.
+
+## Usage
+```
+/mpm-ticket <subcommand> [options]
+```
+
+**CRITICAL:** PM delegates ALL ticketing operations to ticketing agent. PM NEVER uses MCP tools directly.
+
+## Subcommands
+
+### /mpm-ticket organize
+Review, transition states, update priorities, identify stale tickets.
+
+**MCP Tools (ticketing agent uses):**
+- ticket_list, ticket_read, ticket_comment
+- ticket_transition, ticket_update
+- ticket_find_stale
+
+**Output:** Tickets transitioned, priorities updated, stale tickets identified, next actions.
+
+### /mpm-ticket proceed
+Analyze project board and recommend next actionable steps.
+
+**MCP Tools (ticketing agent uses):**
+- project_status, ticket_list, ticket_search
+- epic_issues, get_available_transitions
+
+**Output:** Project health, recommended next actions (top 3), blockers requiring attention.
+
+### /mpm-ticket status
+Generate comprehensive status report covering work, tickets, project health.
+
+**MCP Tools (ticketing agent uses):**
+- project_status, ticket_list, ticket_search
+- ticket_find_stale, get_my_tickets
+
+**Output:** Health metrics, ticket counts, high-priority work, blockers, recent activity, risk assessment.
+
+### /mpm-ticket update
+Create project status update (Linear ProjectUpdate).
+
+**MCP Tools (ticketing agent uses):**
+- project_status, project_update_create
+- project_update_list, ticket_list
+
+**Output:** Update ID, health status, accomplishments, metrics, risks, next sprint focus, published link.
+
+### /mpm-ticket project <url>
+Set project URL for context (Linear/GitHub/JIRA).
+
+**MCP Tools (ticketing agent uses):**
+- config_set_default_project, epic_get, config_get
+
+**Output:** Project context configured, platform/ID/name, access verified, summary.
+
+## Delegation Pattern
+
+**WRONG ❌:**
+```
+# PM directly using MCP tools
+result = mcp__mcp-ticketer__ticket_list()
+```
+
+**CORRECT ✅:**
+```
+# PM delegates to ticketing agent
+PM: "I'll have ticketing organize tickets..."
+[PM constructs delegation prompt]
+[Ticketing agent uses MCP tools]
+PM: [Presents results]
+```
+
+## Fallback Strategy
+
+If mcp-ticketer unavailable, ticketing agent falls back to aitrackdown CLI:
+```bash
+aitrackdown status tasks
+aitrackdown show TICKET-123
+aitrackdown transition TICKET-123 done
+```
+
+**PM still delegates** - ticketing agent handles CLI fallback internally.
+
+## Example Workflows
+
+```bash
+# Organize and analyze
+/mpm-ticket organize          # Clean up board
+/mpm-ticket proceed           # Get next steps
+
+# Weekly update
+/mpm-ticket update            # Create status update
+
+# Project setup
+/mpm-ticket project https://linear.app/team/project/abc-123
+```
+
+See docs/commands/ticket.md for comprehensive documentation.

claude_mpm-5.5.0/src/claude_mpm/commands/mpm-version.md

@@ -0,0 +1,28 @@
+---
+namespace: mpm/system
+command: version
+aliases: [mpm-version]
+migration_target: /mpm/system:version
+category: system
+description: Show version information
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-version"
+---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm-version` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm-version` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
+# /mpm-version
+
+Display version information for MPM, agents, and skills.
+
+## Usage
+```
+/mpm-version
+```
+
+Shows project version, build number, all agents (by tier), all skills (by source).
+
+See docs/commands/version.md for details.

{claude_mpm-5.4.106 → claude_mpm-5.5.0}/src/claude_mpm/commands/mpm.md

@@ -6,7 +6,15 @@ migration_target: /mpm
 category: system
 deprecated_aliases: []
 description: Access Claude MPM functionality and manage multi-agent orchestration
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm"
 ---
+
+> **Deprecated:** This command file is deprecated in favor of the `mpm` skill.
+> For Claude Code 2.1.3+, use the skill-based `/mpm` command instead.
+> This file is kept for backward compatibility with Claude Code < 2.1.3.
+
 # Claude MPM - Multi-Agent Project Manager
 
 Access Claude MPM functionality and manage your multi-agent orchestration.

{claude_mpm-5.4.106 → claude_mpm-5.5.0}/src/claude_mpm/hooks/claude_hooks/hook_handler.py

@@ -111,6 +111,8 @@ WHY version checking:
 Security: Version checking prevents execution on incompatible environments.
 """
 MIN_CLAUDE_VERSION = "1.0.92"
+# Minimum version for user-invocable skills support
+MIN_SKILLS_VERSION = "2.1.3"
 
 
 def check_claude_version() -> Tuple[bool, Optional[str]]: