claude-mpm 4.25.10__py3-none-any.whl → 5.1.8__py3-none-any.whl

claude_mpm/cli/startup_display.py

@@ -264,9 +264,9 @@ def display_startup_banner(version: str, logging_level: str) -> None:
         version: Claude MPM version string
         logging_level: Current logging level (OFF/INFO/DEBUG)
     """
-    # Display launch message (subtle, dim styling)
-    print(f"{DIM}Launching Claude Multi-agent Product Manager (claude-mpm)...{RESET}")
-    print()  # Empty line after launch message
+    # Note: Banner is shown BEFORE "Launching Claude..." progress bar (in cli/__init__.py)
+    # This ensures users see welcome message before background services start
+    print()  # Empty line before banner
 
     # Get terminal width and calculate panel sizes
     terminal_width = _get_terminal_width()
@@ -398,7 +398,7 @@ def display_startup_banner(version: str, logging_level: str) -> None:
     else:
         lines.append(
             _format_two_column_line(
-                "", "/mpm-tickets for more", left_panel_width, right_panel_width
+                "", "/mpm-help for more", left_panel_width, right_panel_width
             )
         )
 

claude_mpm/commands/{mpm-auto-configure.md → mpm-agents-auto-configure.md}

@@ -1,3 +1,12 @@
+---
+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.

claude_mpm/commands/mpm-agents-detect.md

@@ -1,3 +1,12 @@
+---
+namespace: mpm/agents
+command: detect
+aliases: [mpm-agents-detect]
+migration_target: /mpm/agents:detect
+category: agents
+deprecated_aliases: []
+description: Scan project to detect programming languages, frameworks, tools, and configurations
+---
 # Detect project toolchain and frameworks
 
 Scan your project to detect programming languages, frameworks, tools, and configurations.

claude_mpm/commands/{mpm-agents.md → mpm-agents-list.md}

@@ -1,3 +1,12 @@
+---
+namespace: mpm/agents
+command: list
+aliases: [mpm-agents-list]
+migration_target: /mpm/agents:list
+category: agents
+deprecated_aliases: [mpm-agents]
+description: List all available Claude MPM agents with versions and deployment status
+---
 # Show available agents and their versions
 
 Show all available Claude MPM agents with their versions and deployment status.

claude_mpm/commands/mpm-agents-recommend.md

@@ -1,3 +1,12 @@
+---
+namespace: mpm/agents
+command: recommend
+aliases: [mpm-agents-recommend]
+migration_target: /mpm/agents:recommend
+category: agents
+deprecated_aliases: []
+description: Get intelligent agent recommendations based on detected project toolchain
+---
 # Show recommended agents for detected project stack
 
 Get intelligent agent recommendations based on your project's detected toolchain.

claude_mpm/commands/{mpm-config.md → mpm-config-view.md}

@@ -1,3 +1,12 @@
+---
+namespace: mpm/config
+command: view
+aliases: [mpm-config-view]
+migration_target: /mpm/config:view
+category: config
+deprecated_aliases: [mpm-config]
+description: View and validate Claude MPM configuration settings
+---
 # View and validate claude-mpm configuration
 
 Manage Claude MPM configuration settings through validation, viewing, and status checks.

claude_mpm/commands/mpm-doctor.md

@@ -1,3 +1,12 @@
+---
+namespace: mpm/system
+command: doctor
+aliases: [mpm-doctor]
+migration_target: /mpm/system:doctor
+category: system
+deprecated_aliases: []
+description: Run comprehensive diagnostic checks on Claude MPM installation
+---
 # Run diagnostic checks on claude-mpm installation
 
 Run comprehensive diagnostic checks on your Claude MPM installation to identify and fix common issues.

claude_mpm/commands/mpm-help.md

@@ -1,3 +1,12 @@
+---
+namespace: mpm/system
+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
+---
 # Show help for available MPM commands
 
 Display help information for Claude MPM slash commands and CLI capabilities.
@@ -63,6 +72,9 @@ Available Commands:
 /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
 
@@ -78,8 +90,8 @@ Available Commands:
 /mpm-config [validate|view|status]
   Manage configuration settings
 
-/mpm-tickets [list|create|update]
-  Manage project tickets
+/mpm-ticket [organize|proceed|status|update|project]
+  High-level ticketing workflows and project management
 
 /mpm-organize [--dry-run] [--force]
   Organize project file structure

claude_mpm/commands/mpm-init.md

@@ -1,3 +1,12 @@
+---
+namespace: mpm/system
+command: init
+aliases: [mpm-init]
+migration_target: /mpm/system:init
+category: system
+deprecated_aliases: []
+description: Initialize or update project for Claude Code and Claude MPM
+---
 # /mpm-init [update]
 
 Initialize or intelligently update your project for optimal use with Claude Code and Claude MPM using the Agentic Coder Optimizer agent.

claude_mpm/commands/mpm-monitor.md

@@ -1,3 +1,12 @@
+---
+namespace: mpm/system
+command: monitor
+aliases: [mpm-monitor]
+migration_target: /mpm/system:monitor
+category: system
+deprecated_aliases: []
+description: Control Claude MPM monitoring server for real-time dashboard interface
+---
 # Manage Socket.IO monitoring server
 
 Control the Claude MPM monitoring server that powers the real-time dashboard interface for event tracking and project visualization.

claude_mpm/commands/mpm-postmortem.md

@@ -0,0 +1,123 @@
+---
+namespace: mpm/analysis
+command: postmortem
+aliases: [mpm-postmortem]
+migration_target: /mpm/analysis:postmortem
+category: analysis
+deprecated_aliases: []
+description: Analyze session errors and suggest improvements
+---
+# Analyze session errors and suggest improvements
+
+Perform a comprehensive analysis of errors encountered during the current or previous session and generate actionable improvement suggestions.
+
+## Usage
+
+```
+/mpm-postmortem [options]
+```
+
+## Description
+
+The postmortem command analyzes errors from:
+- Script execution failures
+- Skill execution issues
+- Agent instruction problems
+- User code errors (analysis only)
+
+It categorizes errors, identifies root causes, and generates actionable improvements:
+- **Scripts**: Tests and fixes in place
+- **Skills**: Updates skill files with improvements
+- **MPM Agents**: Prepares PRs with rationale for remote agent repository
+- **User Code**: Provides suggestions without modification
+
+## Options
+
+- `--dry-run`: Preview analysis without making changes (default for destructive operations)
+- `--auto-fix`: Automatically apply fixes to scripts and skills
+- `--create-prs`: Create pull requests for agent improvements
+- `--session-id <id>`: Analyze specific session (default: current session)
+- `--format <format>`: Output format: terminal, json, markdown (default: terminal)
+- `--output <file>`: Save report to file
+- `--verbose`: Include detailed error traces and analysis
+
+## Examples
+
+```bash
+# Analyze current session
+/mpm-postmortem
+
+# Preview changes without applying
+/mpm-postmortem --dry-run
+
+# Auto-fix scripts and skills
+/mpm-postmortem --auto-fix
+
+# Create PRs for agent improvements
+/mpm-postmortem --create-prs
+
+# Analyze specific session
+/mpm-postmortem --session-id 2025-12-03-143000
+
+# Save detailed report
+/mpm-postmortem --verbose --output postmortem-report.md
+```
+
+## Expected Output
+
+```
+📊 Session Postmortem Analysis
+═══════════════════════════════
+
+Session: 2025-12-03-143000
+Duration: 45 minutes
+Errors Found: 3
+
+🔧 Script Errors (1)
+─────────────────────
+• manage_version.py line 42: KeyError 'version'
+  Root Cause: Missing default value handling for optional configuration
+  Fix: Add fallback to default value when key not present
+  Status: Fixed ✓
+
+📚 Skill Errors (0)
+──────────────────
+No skill errors detected
+
+🤖 Agent Improvements (2)
+──────────────────────────
+• ticketing agent: Timeout on large ticket lists
+  Issue: Default timeout too short for projects with 500+ tickets
+  Improvement: Add pagination support and increase timeout threshold
+  PR: Created #123 (awaiting review)
+
+• engineer agent: Type validation missing for tool parameters
+  Issue: Invalid parameters passed to Edit tool causing failures
+  Improvement: Add parameter validation before tool invocation
+  Status: Ready to create PR (use --create-prs)
+
+💡 User Code Suggestions (0)
+────────────────────────────
+No user code issues detected
+
+📈 Summary
+──────────
+Total Errors: 3
+Fixed: 1
+PRs Created: 1
+Suggestions: 1
+```
+
+## Safety Features
+
+- **Dry-run by default**: Preview changes before applying
+- **Confirmation prompts**: Verify before creating PRs
+- **Backup before modifications**: Automatic backup of modified files
+- **Rollback capability**: Restore previous versions if needed
+- **Git integration**: Check for uncommitted changes before modifications
+
+## Related Commands
+
+- `/mpm-doctor`: Diagnose installation and configuration issues
+- `/mpm-session-resume`: Resume previous session with context
+- `/mpm-status`: View current system status

claude_mpm/commands/{mpm-resume.md → mpm-session-resume.md}

@@ -1,3 +1,12 @@
+---
+namespace: mpm/session
+command: resume
+aliases: [mpm-session-resume]
+migration_target: /mpm/session:resume
+category: session
+deprecated_aliases: [mpm-resume]
+description: Load and display context from most recent paused session to continue work
+---
 # /mpm-resume - Load Previous Session
 
 Load and display context from the most recent paused session to seamlessly continue your work.

claude_mpm/commands/mpm-status.md

@@ -1,3 +1,12 @@
+---
+namespace: mpm/system
+command: status
+aliases: [mpm-status]
+migration_target: /mpm/system:status
+category: system
+deprecated_aliases: []
+description: Display Claude MPM status including environment, services, and health
+---
 # Show claude-mpm status and environment
 
 Display the current status of Claude MPM including environment information, active services, and system health.

claude_mpm/commands/{mpm-organize.md → mpm-ticket-organize.md}

@@ -1,3 +1,12 @@
+---
+namespace: mpm/ticket
+command: organize
+aliases: [mpm-ticket-organize]
+migration_target: /mpm/ticket:organize
+category: tickets
+deprecated_aliases: [mpm-organize]
+description: Organize project files into proper directories with intelligent pattern detection
+---
 # /mpm-organize
 
 Organize your project files into proper directories using intelligent pattern detection and framework-aware structure management.