claude-mpm 0.3.0__tar.gz → 1.1.0__tar.gz

claude_mpm-1.1.0/.claude/commands/README.md

@@ -0,0 +1,36 @@
+# Claude MPM Slash Commands
+
+This directory contains slash command definitions for Claude MPM.
+
+## Overview
+
+Slash commands allow you to execute specific actions without going through the LLM. They are processed directly by the claude-mpm framework.
+
+## Available Commands
+
+### `/mpm:test`
+- **Description**: A simple test command that returns "Hello World"
+- **Usage**: `/mpm:test`
+- **Purpose**: Demonstrates the slash command system
+
+## Implementation
+
+Commands are handled in two ways:
+
+1. **Command Router** (`.claude/scripts/command_router.py`): A standalone Python script that can execute commands independently
+2. **Simple Runner Integration** (`src/claude_mpm/core/simple_runner.py`): Intercepts `/mpm:` commands before they reach Claude
+
+## Adding New Commands
+
+To add a new slash command:
+
+1. Add the command handler to the command router
+2. Create a markdown file in the appropriate subdirectory (e.g., `.claude/commands/mpm/mycommand.md`)
+3. Optionally update the `_handle_mpm_command` method in simple_runner.py for direct integration
+
+## Future Enhancements
+
+- Hook-based command processing for better modularity
+- Command discovery and auto-registration
+- Rich command output formatting
+- Command history and logging

claude_mpm-1.1.0/.claude/commands/mpm.md

@@ -0,0 +1,5 @@
+---
+description: Claude MPM management commands
+---
+
+/mpm

claude_mpm-1.1.0/.claude/hooks.json

@@ -0,0 +1,32 @@
+{
+  "hooks": {
+    "userPromptSubmit": [
+      {
+        "name": "mpm-command-interceptor",
+        "enabled": true,
+        "priority": 100,
+        "conditions": {
+          "promptPatterns": ["/mpm:", "Hello World"]
+        },
+        "handler": "/Users/masa/Projects/claude-mpm/.claude/hooks/mpm_intercept_hook.js"
+      },
+      {
+        "name": "helloworld-command",
+        "enabled": true,
+        "priority": 90,
+        "conditions": {
+          "promptPatterns": ["/helloworld"]
+        },
+        "handler": "/Users/masa/Projects/claude-mpm/.claude/hooks/helloworld_hook.js"
+      }
+    ]
+  },
+  "global": {
+    "timeoutMs": 5000,
+    "retryCount": 3,
+    "logging": {
+      "level": "info",
+      "destination": "/Users/masa/Projects/claude-mpm/.claude/logs/hooks.log"
+    }
+  }
+}

claude_mpm-1.1.0/.claude/scripts/command_router.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""Simple command router for /mpm: commands."""
+
+import sys
+from typing import Dict, Callable, Optional
+
+
+class CommandRouter:
+    """Simple command dispatcher for /mpm: commands."""
+    
+    def __init__(self):
+        self.commands: Dict[str, Callable] = {}
+        self._register_builtin_commands()
+    
+    def _register_builtin_commands(self):
+        """Register built-in commands."""
+        self.register("test", self._test_command)
+    
+    def register(self, command: str, handler: Callable):
+        """Register a command handler."""
+        self.commands[command] = handler
+    
+    def _test_command(self, *args) -> str:
+        """Simple test command that returns Hello World."""
+        return "Hello World"
+    
+    def execute(self, command: str, *args) -> Optional[str]:
+        """Execute a command and return the result."""
+        if command in self.commands:
+            return self.commands[command](*args)
+        return None
+    
+    def list_commands(self) -> list:
+        """List all available commands."""
+        return list(self.commands.keys())
+
+
+def main():
+    """Main entry point for command router."""
+    router = CommandRouter()
+    
+    if len(sys.argv) < 2:
+        print("Usage: command_router.py <command> [args...]")
+        print(f"Available commands: {', '.join(router.list_commands())}")
+        sys.exit(1)
+    
+    command = sys.argv[1]
+    args = sys.argv[2:]
+    
+    result = router.execute(command, *args)
+    if result is not None:
+        print(result)
+    else:
+        print(f"Unknown command: {command}")
+        print(f"Available commands: {', '.join(router.list_commands())}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

claude_mpm-1.1.0/.claude/settings.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/Projects/claude-mpm/src/claude_mpm/hooks/claude_hooks/hook_wrapper.sh"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/Projects/claude-mpm/src/claude_mpm/hooks/claude_hooks/hook_wrapper.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/Projects/claude-mpm/src/claude_mpm/hooks/claude_hooks/hook_wrapper.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

claude_mpm-1.1.0/.python-version

@@ -0,0 +1 @@
+3.11

{claude_mpm-0.3.0 → claude_mpm-1.1.0}/CHANGELOG.md

@@ -5,6 +5,48 @@ All notable changes to claude-mpm will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-07-26
+
+## [1.0.1] - 2025-07-26
+
+## [1.0.0] - 2025-07-26
+
+### BREAKING CHANGES
+- **Simplified architecture**: Replaced the entire orchestrator system with a simple runner
+  - Removed 16 orchestrator implementations and consolidated to `simple_runner.py`
+  - Deleted todo hijacking and subprocess runner features
+  - Removed agent modification tracker service
+  - Archived old orchestrators to `orchestration/archive/`
+
+### Added
+- **TodoWrite Agent Prefix Hook system**: Automatic delegation of todo items to specialized agents
+  - `todo_agent_prefix_hook.py` for automatic todo list delegation
+  - `tool_call_interceptor.py` for intercepting TodoWrite tool calls
+  - Comprehensive documentation and example implementations
+  - Test script for validating todo hook functionality
+- **Enhanced CLI with argument preprocessing**: Better command-line interaction
+  - Support for `@agent` syntax for direct agent specification
+  - Pass-through arguments to Claude with proper escaping
+  - Improved logging and error handling in CLI operations
+
+### Changed
+- **Updated agent instructions**: Clearer guidelines for agent development
+- **Simplified ticket manager**: Removed unnecessary complexity in ticket management
+- **Streamlined test suite**: Removed 15 obsolete test files related to old orchestration patterns
+- **Updated remaining tests**: Modified to work with simplified architecture
+- **Improved framework loader**: Better clarity and maintainability
+
+### Removed
+- Complex orchestrator system (moved to archive)
+- Todo hijacking features
+- Subprocess runner features
+- Agent modification tracker service
+- Obsolete tests for deprecated features
+
+### Fixed
+- Test suite compatibility with new architecture
+- Import paths and module references
+
 ## [0.5.0] - 2024-01-25
 
 ### Added
@@ -59,6 +101,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Framework loader
 - Basic CLI structure
 
+[1.0.0]: https://github.com/bobmatnyc/claude-mpm/compare/v0.5.0...v1.0.0
 [0.5.0]: https://github.com/bobmatnyc/claude-mpm/compare/v0.3.0...v0.5.0
 [0.3.0]: https://github.com/bobmatnyc/claude-mpm/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/bobmatnyc/claude-mpm/compare/v0.1.0...v0.2.0

claude_mpm-1.1.0/INSTALL.md

@@ -0,0 +1,204 @@
+# Installation Guide
+
+Claude MPM can be installed via UV, pip, or npm. UV is recommended for the best experience.
+
+## Prerequisites
+
+- **Claude Code** 1.0.60 or later (required)
+- **Python** 3.8 or later
+- **Package Manager**: UV (recommended), pip, or npm
+
+## Option 1: Install via UV (Recommended)
+
+[UV](https://github.com/astral-sh/uv) is a fast Python package installer that handles virtual environments automatically:
+
+```bash
+# Install UV if not already installed
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install claude-mpm
+uv pip install claude-mpm
+```
+
+## Option 2: Install via pip
+
+Traditional Python installation:
+
+```bash
+# Create virtual environment (recommended)
+python -m venv claude-mpm-env
+source claude-mpm-env/bin/activate  # On Windows: claude-mpm-env\Scripts\activate
+
+# Install claude-mpm
+pip install claude-mpm
+```
+
+## Option 3: Install via npm (Wrapper)
+
+The npm package provides a convenient wrapper that will install the Python package on first run:
+
+```bash
+npm install -g @bobmatnyc/claude-mpm
+```
+
+**Note**: This is just a wrapper - Python 3.8+ must be installed on your system.
+
+## Verify Installation
+
+After installation, verify it works:
+
+```bash
+# Show version and help
+claude-mpm --help
+
+# Test in interactive mode
+claude-mpm
+
+# Run a simple test
+claude-mpm run -i "Say hello" --non-interactive
+```
+
+## Usage
+
+### Interactive Mode (Default)
+
+```bash
+claude-mpm
+```
+
+This launches Claude Code with the PM framework loaded, including:
+- System instructions for orchestration
+- Deployed specialized agents (engineer, qa, research, etc.)
+- Delegation-only operation mode
+
+### Non-Interactive Mode
+
+```bash
+claude-mpm run -i "Your task here" --non-interactive
+```
+
+### Common Options
+
+```bash
+# Disable agent deployment
+claude-mpm --no-native-agents
+
+# Enable debug logging
+claude-mpm --logging DEBUG
+
+# Disable hooks
+claude-mpm --no-hooks
+```
+
+## Terminal UI Mode
+
+Claude MPM includes a terminal UI that shows Claude output, ToDo lists, and tickets in separate panes:
+
+```bash
+# Launch with rich UI (requires pip install claude-mpm[ui])
+claude-mpm --mpm:ui
+
+# Launch with basic curses UI
+claude-mpm --mpm:ui --mode curses
+```
+
+### Terminal UI Features
+
+- **Claude Output Pane**: Live Claude interaction
+- **ToDo List Pane**: Shows current tasks from Claude's todo system
+- **Tickets Pane**: Browse and create tickets
+- **Keyboard Shortcuts**:
+  - `Tab`: Switch between panes
+  - `F5`: Refresh ToDo and ticket lists
+  - `N`: Create new ticket (when in tickets pane)
+  - `Q`: Quit
+
+### Installing UI Dependencies
+
+For the best terminal UI experience:
+
+```bash
+# With UV
+uv pip install claude-mpm[ui]
+
+# With pip
+pip install claude-mpm[ui]
+```
+
+## Development Installation
+
+For contributing or modifying Claude MPM:
+
+```bash
+# Clone repository
+git clone https://github.com/bobmatnyc/claude-mpm.git
+cd claude-mpm
+
+# Run development install script (auto-detects UV)
+./install_dev.sh
+```
+
+## Troubleshooting
+
+### "claude: command not found"
+
+Install Claude Code 1.0.60+ from https://claude.ai/code
+
+### "Python not found"
+
+Install Python 3.8+ from:
+- macOS: `brew install python@3.11`
+- Ubuntu/Debian: `sudo apt install python3.11`
+- Windows/Other: https://python.org
+
+### PEP 668 "externally managed environment" error
+
+Modern systems protect the global Python environment. Solutions:
+
+1. **Use UV** (automatically handles virtual environments)
+2. **Use pipx**: `pipx install claude-mpm`
+3. **Use a virtual environment** (see pip instructions above)
+
+### npm install fails
+
+Ensure you have Node.js 14+ installed. The npm package is just a wrapper - the actual functionality requires Python.
+
+## Updating
+
+### UV
+```bash
+uv pip install --upgrade claude-mpm
+```
+
+### pip
+```bash
+pip install --upgrade claude-mpm
+```
+
+### npm
+```bash
+npm update -g @bobmatnyc/claude-mpm
+```
+
+## Uninstalling
+
+### UV
+```bash
+uv pip uninstall claude-mpm
+```
+
+### pip
+```bash
+pip uninstall claude-mpm
+```
+
+### npm
+```bash
+npm uninstall -g @bobmatnyc/claude-mpm
+```
+
+## Next Steps
+
+- See [Getting Started Guide](docs/user/01-getting-started/README.md)
+- Read the [User Documentation](docs/user/README.md)
+- Check out [Example Usage](docs/user/02-guides/basic-usage.md)

{claude_mpm-0.3.0 → claude_mpm-1.1.0}/MANIFEST.in

@@ -24,6 +24,9 @@ include ticket
 # Include configuration examples
 recursive-include src/claude_mpm/config *.py
 
+# Include hook files (including shell scripts)
+recursive-include src/claude_mpm/hooks *.py *.sh
+
 # Exclude test and cache files
 global-exclude __pycache__
 global-exclude *.py[co]

{claude_mpm-0.3.0 → claude_mpm-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 0.3.0
+Version: 1.1.0
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -44,6 +44,8 @@ Dynamic: requires-python
 
 # Claude MPM - Multi-Agent Project Manager
 
+> **Note**: This project is a fork of [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm), enhanced to integrate with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) v1.0.60+'s native agent system. This integration enables seamless orchestration of Claude Code's built-in agents (research, engineer, qa, documentation, security, ops, version_control, data_engineer) through a unified project management interface.
+
 A framework for Claude that enables multi-agent workflows and extensible capabilities through a modular architecture.
 
 
@@ -117,17 +119,52 @@ Claude MPM provides a modular framework for extending Claude's capabilities:
 
 ## Installation
 
-### From Source
+### Quick Install Options
+
+#### Option 1: Using UV (Recommended - Fast)
+UV is a lightning-fast Python package manager written in Rust, offering 10-100x speed improvements over pip.
+
+```bash
+# Install UV (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install claude-mpm with UV
+uv pip install claude-mpm
+
+# Or install from git
+uv pip install git+https://github.com/bobmatnyc/claude-mpm.git
+```
+
+#### Option 2: Using pip (Traditional)
+```bash
+# Install from PyPI
+pip install claude-mpm
+
+# Or install from git
+pip install git+https://github.com/bobmatnyc/claude-mpm.git
+```
+
+#### Option 3: Using npm (Wrapper)
+**Note**: This installs a wrapper that still requires Python. It's provided for convenience but the Python package is the primary distribution method.
+
+```bash
+npm install -g @bobmatnyc/claude-mpm
+```
+
+### From Source (Development)
 
 ```bash
 # Clone the repository
-git clone https://github.com/yourusername/claude-mpm.git
+git clone https://github.com/bobmatnyc/claude-mpm.git
 cd claude-mpm
 
-# Run development installation script
-./install_dev.sh
+# Option A: Using UV (Recommended - Much faster)
+uv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+uv pip install -e .
 
-# Activate virtual environment
+# Option B: Traditional approach
+./install_dev.sh
 source venv/bin/activate
 ```
 
@@ -135,7 +172,7 @@ source venv/bin/activate
 
 #### Core Requirements
 - Python 3.8+
-- Claude CLI (must be installed and in PATH)
+- Claude Code CLI 1.0.60+ (must be installed and in PATH)
 
 #### Automatically Installed
 - tree-sitter & language packs (for code analysis)

{claude_mpm-0.3.0 → claude_mpm-1.1.0}/README.md

@@ -1,5 +1,7 @@
 # Claude MPM - Multi-Agent Project Manager
 
+> **Note**: This project is a fork of [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm), enhanced to integrate with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) v1.0.60+'s native agent system. This integration enables seamless orchestration of Claude Code's built-in agents (research, engineer, qa, documentation, security, ops, version_control, data_engineer) through a unified project management interface.
+
 A framework for Claude that enables multi-agent workflows and extensible capabilities through a modular architecture.
 
 
@@ -73,17 +75,52 @@ Claude MPM provides a modular framework for extending Claude's capabilities:
 
 ## Installation
 
-### From Source
+### Quick Install Options
+
+#### Option 1: Using UV (Recommended - Fast)
+UV is a lightning-fast Python package manager written in Rust, offering 10-100x speed improvements over pip.
+
+```bash
+# Install UV (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install claude-mpm with UV
+uv pip install claude-mpm
+
+# Or install from git
+uv pip install git+https://github.com/bobmatnyc/claude-mpm.git
+```
+
+#### Option 2: Using pip (Traditional)
+```bash
+# Install from PyPI
+pip install claude-mpm
+
+# Or install from git
+pip install git+https://github.com/bobmatnyc/claude-mpm.git
+```
+
+#### Option 3: Using npm (Wrapper)
+**Note**: This installs a wrapper that still requires Python. It's provided for convenience but the Python package is the primary distribution method.
+
+```bash
+npm install -g @bobmatnyc/claude-mpm
+```
+
+### From Source (Development)
 
 ```bash
 # Clone the repository
-git clone https://github.com/yourusername/claude-mpm.git
+git clone https://github.com/bobmatnyc/claude-mpm.git
 cd claude-mpm
 
-# Run development installation script
-./install_dev.sh
+# Option A: Using UV (Recommended - Much faster)
+uv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+uv pip install -e .
 
-# Activate virtual environment
+# Option B: Traditional approach
+./install_dev.sh
 source venv/bin/activate
 ```
 
@@ -91,7 +128,7 @@ source venv/bin/activate
 
 #### Core Requirements
 - Python 3.8+
-- Claude CLI (must be installed and in PATH)
+- Claude Code CLI 1.0.60+ (must be installed and in PATH)
 
 #### Automatically Installed
 - tree-sitter & language packs (for code analysis)