claude-mpm 5.0.9__py3-none-any.whl → 5.6.23__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

@@ -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/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,299 +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.
-
-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
-```
+# /mpm-help
 
-Shows detailed help for a specific command including:
-- Full description
-- Available options and flags
-- Usage examples
-- Related commands
+Show help for MPM commands. Delegates to PM agent.
 
-## 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-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
-
-/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
-
-### /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
+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.