claude-mpm 5.4.22__py3-none-any.whl → 5.6.34__py3-none-any.whl

claude_mpm/commander/workflow/notifier.py

@@ -0,0 +1,146 @@
+"""Basic notification delivery for events.
+
+This module provides Notifier which sends notifications for events.
+Currently supports logging, with extensibility for future channels
+(Slack, email, webhooks).
+"""
+
+import logging
+from dataclasses import dataclass
+
+from ..models.events import Event
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class NotifierConfig:
+    """Configuration for notifier.
+
+    Attributes:
+        log_level: Logging level for notifications (default: INFO)
+
+    Future attributes:
+        slack_webhook: URL for Slack webhook notifications
+        email_config: SMTP configuration for email notifications
+        webhook_urls: List of webhook URLs for custom integrations
+    """
+
+    log_level: str = "INFO"
+    # Future: slack_webhook, email_config, webhook_urls
+
+
+class Notifier:
+    """Sends notifications for events.
+
+    Currently implements logging-based notifications with configurable
+    log levels. Designed for extensibility to support future notification
+    channels like Slack, email, and webhooks.
+
+    Attributes:
+        config: Notifier configuration
+
+    Example:
+        >>> config = NotifierConfig(log_level="INFO")
+        >>> notifier = Notifier(config)
+        >>> await notifier.notify(event)
+        >>> await notifier.notify_resolution(event, "User responded")
+    """
+
+    def __init__(self, config: NotifierConfig | None = None) -> None:
+        """Initialize notifier.
+
+        Args:
+            config: Optional NotifierConfig (uses defaults if not provided)
+        """
+        self.config = config or NotifierConfig()
+
+        # Map log level string to logging level
+        level_map = {
+            "DEBUG": logging.DEBUG,
+            "INFO": logging.INFO,
+            "WARNING": logging.WARNING,
+            "ERROR": logging.ERROR,
+            "CRITICAL": logging.CRITICAL,
+        }
+        self._log_level = level_map.get(self.config.log_level.upper(), logging.INFO)
+
+        logger.debug("Notifier initialized with log level: %s", self.config.log_level)
+
+    async def notify(self, event: Event) -> None:
+        """Send notification for an event.
+
+        Currently logs the event at the configured log level. Future versions
+        will support additional notification channels.
+
+        Args:
+            event: Event to notify about
+
+        Example:
+            >>> await notifier.notify(event)
+            # Logs: [HIGH] Event evt_123: Choose deployment target
+        """
+        # Format notification message
+        message = self._format_event(event)
+
+        # Log notification
+        logger.log(
+            self._log_level,
+            "Event notification: %s",
+            message,
+        )
+
+        # Future: Send to Slack, email, webhooks
+        # if self.config.slack_webhook:
+        #     await self._send_slack(event)
+        # if self.config.email_config:
+        #     await self._send_email(event)
+
+    async def notify_resolution(self, event: Event, response: str) -> None:
+        """Notify that an event was resolved.
+
+        Logs the resolution with the user's response. Future versions will
+        send resolution notifications to configured channels.
+
+        Args:
+            event: Event that was resolved
+            response: User's response to the event
+
+        Example:
+            >>> await notifier.notify_resolution(event, "Deploy to staging")
+            # Logs: Event evt_123 resolved: Deploy to staging
+        """
+        message = f"Event {event.id} resolved: {response[:100]}"
+
+        logger.log(
+            self._log_level,
+            "Event resolution: %s",
+            message,
+        )
+
+        # Future: Send resolution notifications to channels
+
+    def _format_event(self, event: Event) -> str:
+        """Format event for notification display.
+
+        Args:
+            event: Event to format
+
+        Returns:
+            Formatted notification string
+
+        Example:
+            >>> msg = notifier._format_event(event)
+            '[HIGH] evt_123 (proj_456): Choose deployment target'
+        """
+        parts = [
+            f"[{event.priority.value.upper()}]",
+            f"{event.id}",
+            f"({event.project_id})",
+            f"{event.title}",
+        ]
+
+        if event.options:
+            parts.append(f"Options: {', '.join(event.options)}")
+
+        return " ".join(parts)

claude_mpm/commands/mpm-config.md

@@ -4,262 +4,33 @@ 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
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-config"
 ---
-# Unified configuration management
 
-Manage Claude MPM configuration with auto-detection, manual viewing, validation, and status checks.
+> **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.
 
-## 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
+# /mpm-config
 
-**Example:**
-```
-/mpm-config validate --strict
-/mpm-config validate --config-file .claude/config.yaml --fix
-```
-
-**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
-```
+Unified configuration management with auto-detection.
 
-## 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
+## Usage
 ```
-/mpm-config auto --force       # Re-run auto-detection
+/mpm-config [auto|view|validate|status] [options]
 ```
 
-## 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,25 @@ 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
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-doctor"
 ---
-# Run diagnostic checks on claude-mpm installation
 
-Run comprehensive diagnostic checks on your Claude MPM installation to identify and fix common issues.
+> **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.
 
-This command checks:
-- Installation integrity
-- Configuration validity
-- WebSocket connectivity
-- Agent deployment status
-- Memory system health
-- Hook service status
+# /mpm-doctor
 
-Usage: /mpm-doctor [options]
+Run comprehensive diagnostics on Claude MPM installation.
 
-Options:
-- --verbose: Show detailed output
-- --no-color: Disable colored output  
-- --checks [list]: Run specific checks only
-- --fix: Attempt to fix identified issues
+## Usage
+```
+/mpm-doctor [--verbose] [--fix]
+```
 
-Examples:
-- /mpm-doctor
-- /mpm-doctor --verbose
-- /mpm-doctor --fix
+Checks: installation, configuration, WebSocket, agents, memory, hooks.
+
+See docs/commands/doctor.md for details.

claude_mpm/commands/mpm-help.md

@@ -4,218 +4,25 @@ 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
+deprecated: true
+deprecated_in: "5.5.0"
+replacement: "skill:mpm-help"
 ---
-# Show help for available MPM commands
 
-Display help information for Claude MPM slash commands and CLI capabilities.
+> **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.
 
-## 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.
+# /mpm-help
 
-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
-```
+Show help for MPM commands. Delegates to PM agent.
 
-Shows detailed help for a specific command including:
-- Full description
-- Available options and flags
-- Usage examples
-- Related commands
-
-## Expected Output
-
-### General Help
+## Usage
 ```
-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.