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

{claude_mpm-1.1.0 → claude_mpm-2.0.0}/.gitignore

@@ -27,3 +27,14 @@ build/
 # Test logs
 test_logs/
 tests/test_logs/
+
+# Agent backups
+src/claude_mpm/agents/templates/backup/
+**/backup/
+
+# Temporary directories
+test_dir/
+ai-trackdown-pytools-bug-support/
+
+# Claude MPM temporary files
+**/.claude-mpm/

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

@@ -5,6 +5,61 @@ 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).
 
+## [2.0.0] - 2025-07-27
+
+### BREAKING CHANGES
+- **Agent Schema Standardization**: Complete overhaul of agent definition format
+  - Agent IDs no longer use `_agent` suffix (e.g., `research_agent` → `research`)
+  - Migrated from YAML to JSON format with strict schema validation
+  - All agents must conform to new standardized schema at `src/claude_mpm/schemas/agent_schema.json`
+  - Resource allocation now uses predefined tiers (intensive, standard, lightweight)
+  - Model names standardized (e.g., `claude-sonnet-4-20250514` → `claude-4-sonnet-20250514`)
+
+### Added
+- **Comprehensive Schema Validation Framework**
+  - JSON Schema-based validation for all agent definitions
+  - Business rule validation for resource allocation consistency
+  - Automatic validation on agent load
+  - Migration tools for converting old format to new
+- **Resource Tier System**
+  - Three predefined tiers: intensive (900s/3072MB), standard (600s/2048MB), lightweight (300s/1024MB)
+  - Automatic resource allocation based on agent type
+  - Clear rationale for resource assignments
+- **Enhanced Agent Metadata**
+  - Required metadata fields: name, description, category, tags
+  - Optional fields: author, created_at, updated_at
+  - Improved agent discoverability through standardized tags
+- **Validation API**
+  - `AgentValidator` class for programmatic validation
+  - Detailed error and warning reporting
+  - Integration with CI/CD pipelines
+
+### Changed
+- **Agent Definition Format**
+  - Migrated from YAML to JSON for better schema validation
+  - Standardized field names and structure
+  - Added required version field using semantic versioning
+  - Instructions limited to 8000 characters for consistency
+- **Agent Loader Improvements**
+  - Backward compatibility for old agent IDs (both `research` and `research_agent` work)
+  - Performance improvements through caching (1.6x faster)
+  - Better error messages for validation failures
+- **Model Naming Convention**
+  - Standardized to `claude-{version}-{variant}-{date}` format
+  - Updated all agents to use consistent model names
+
+### Fixed
+- **Validation Issues**
+  - Inconsistent versioning across agents (was using integers, now semantic)
+  - Resource allocation inconsistencies
+  - Missing required fields in some agents
+  - Tool array inconsistencies
+
+### Migration Guide
+- See [Schema Standardization Migration Guide](docs/user/05-migration/schema-standardization-migration.md)
+- Use backward compatibility layer during transition
+- Run validation on all custom agents before deployment
+
 ## [1.1.0] - 2025-07-26
 
 ## [1.0.1] - 2025-07-26

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 1.1.0
+Version: 2.0.0
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -46,8 +46,104 @@ Dynamic: requires-python
 
 > **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.
 
+> **⚠️ Version 2.0.0 Breaking Changes**: Agent schema has been standardized. Agent IDs no longer use the `_agent` suffix (e.g., `research_agent` → `research`). See the [migration guide](docs/user/05-migration/schema-standardization-migration.md) for details.
+
 A framework for Claude that enables multi-agent workflows and extensible capabilities through a modular architecture.
 
+## Quick Start
+
+### Why Interactive Mode?
+**Interactive mode is significantly more performant** than non-interactive commands. It maintains context between requests and avoids the overhead of repeatedly launching Claude, making your development workflow much faster and more efficient.
+
+### Installation
+
+```bash
+# Install globally via npm (recommended)
+npm install -g @bobmatnyc/claude-mpm
+
+# Or use npx for one-time usage
+npx @bobmatnyc/claude-mpm
+```
+
+### Three Essential Use Cases
+
+#### 1. 🔍 **Understand Your Codebase**
+Start with codebase exploration - perfect for onboarding or getting oriented:
+
+```bash
+# Launch interactive mode
+claude-mpm
+
+# Then ask:
+> Explain the codebase structure. What are the main components, how do they interact, and what architectural patterns are used?
+```
+
+#### 2. 🚀 **Build a New Project** 
+For greenfield development, use detailed, AI-generated prompts for best results:
+
+```bash
+claude-mpm
+
+# Example detailed prompt (AI-generated prompts work best):
+> Create a modern web application with the following requirements:
+> - Next.js 14 with TypeScript and Tailwind CSS
+> - Authentication using NextAuth.js with GitHub provider
+> - PostgreSQL database with Prisma ORM
+> - User dashboard with CRUD operations for "projects"
+> - API routes following REST conventions
+> - Responsive design with dark/light mode toggle
+> - Form validation using react-hook-form and zod
+> - Include proper error handling and loading states
+> - Set up ESLint, Prettier, and basic testing with Jest
+> - Generate a complete project structure with all necessary files
+```
+
+#### 3. 🔧 **Enhance Existing Code**
+For working on your current codebase, provide rich context:
+
+```bash
+claude-mpm
+
+# Example detailed enhancement prompt:
+> I need to add real-time notifications to my existing Next.js application. Current tech stack:
+> - Next.js 13 with app router
+> - TypeScript
+> - Tailwind CSS
+> - PostgreSQL with Prisma
+> - User authentication already implemented
+> 
+> Requirements:
+> - WebSocket-based real-time notifications
+> - Toast notifications in the UI
+> - Database table to store notification history
+> - Mark as read/unread functionality
+> - Different notification types (info, warning, success, error)
+> - Admin panel to send system-wide notifications
+> - Email fallback for offline users
+> 
+> Please analyze my current codebase structure and implement this feature following my existing patterns and conventions.
+```
+
+### 💡 Pro Tips for Better Results
+
+1. **Use AI to generate your prompts**: Ask ChatGPT or Claude to help you create detailed, specific prompts for your use case
+2. **Provide context**: Include your tech stack, requirements, and any constraints
+3. **Stay interactive**: Keep the conversation going to refine and iterate on solutions
+4. **Ask for explanations**: Request explanations of architectural decisions and trade-offs
+
+### Alternative: Non-Interactive Mode
+For automation or simple one-off tasks:
+
+```bash
+# Quick analysis
+claude-mpm run -i "What testing frameworks are used in this project?" --non-interactive
+
+# With subprocess orchestration for complex tasks
+claude-mpm run --subprocess -i "Audit this codebase for security vulnerabilities" --non-interactive
+```
+
+**Note**: Non-interactive mode has higher overhead and is less efficient for multi-step development workflows.
+
 
 ## 📚 Documentation
 
@@ -119,9 +215,9 @@ Claude MPM provides a modular framework for extending Claude's capabilities:
 
 ## Installation
 
-### Quick Install Options
+### Other Installation Methods
 
-#### Option 1: Using UV (Recommended - Fast)
+#### Using UV (Recommended - Fast)
 UV is a lightning-fast Python package manager written in Rust, offering 10-100x speed improvements over pip.
 
 ```bash
@@ -135,7 +231,7 @@ uv pip install claude-mpm
 uv pip install git+https://github.com/bobmatnyc/claude-mpm.git
 ```
 
-#### Option 2: Using pip (Traditional)
+#### Using pip (Traditional)
 ```bash
 # Install from PyPI
 pip install claude-mpm
@@ -144,13 +240,6 @@ pip install claude-mpm
 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
@@ -218,21 +307,6 @@ Commands:
   info                 Show framework and configuration info
 ```
 
-## Quick Start
-
-```bash
-# 1. Clone and install
-git clone https://github.com/yourusername/claude-mpm.git
-cd claude-mpm
-./install_dev.sh
-source venv/bin/activate
-
-# 2. Run interactive session
-claude-mpm
-
-# 3. Or run a single command
-claude-mpm run -i "Explain the codebase structure" --non-interactive
-```
 
 
 ## Architecture

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

@@ -2,8 +2,104 @@
 
 > **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.
 
+> **⚠️ Version 2.0.0 Breaking Changes**: Agent schema has been standardized. Agent IDs no longer use the `_agent` suffix (e.g., `research_agent` → `research`). See the [migration guide](docs/user/05-migration/schema-standardization-migration.md) for details.
+
 A framework for Claude that enables multi-agent workflows and extensible capabilities through a modular architecture.
 
+## Quick Start
+
+### Why Interactive Mode?
+**Interactive mode is significantly more performant** than non-interactive commands. It maintains context between requests and avoids the overhead of repeatedly launching Claude, making your development workflow much faster and more efficient.
+
+### Installation
+
+```bash
+# Install globally via npm (recommended)
+npm install -g @bobmatnyc/claude-mpm
+
+# Or use npx for one-time usage
+npx @bobmatnyc/claude-mpm
+```
+
+### Three Essential Use Cases
+
+#### 1. 🔍 **Understand Your Codebase**
+Start with codebase exploration - perfect for onboarding or getting oriented:
+
+```bash
+# Launch interactive mode
+claude-mpm
+
+# Then ask:
+> Explain the codebase structure. What are the main components, how do they interact, and what architectural patterns are used?
+```
+
+#### 2. 🚀 **Build a New Project** 
+For greenfield development, use detailed, AI-generated prompts for best results:
+
+```bash
+claude-mpm
+
+# Example detailed prompt (AI-generated prompts work best):
+> Create a modern web application with the following requirements:
+> - Next.js 14 with TypeScript and Tailwind CSS
+> - Authentication using NextAuth.js with GitHub provider
+> - PostgreSQL database with Prisma ORM
+> - User dashboard with CRUD operations for "projects"
+> - API routes following REST conventions
+> - Responsive design with dark/light mode toggle
+> - Form validation using react-hook-form and zod
+> - Include proper error handling and loading states
+> - Set up ESLint, Prettier, and basic testing with Jest
+> - Generate a complete project structure with all necessary files
+```
+
+#### 3. 🔧 **Enhance Existing Code**
+For working on your current codebase, provide rich context:
+
+```bash
+claude-mpm
+
+# Example detailed enhancement prompt:
+> I need to add real-time notifications to my existing Next.js application. Current tech stack:
+> - Next.js 13 with app router
+> - TypeScript
+> - Tailwind CSS
+> - PostgreSQL with Prisma
+> - User authentication already implemented
+> 
+> Requirements:
+> - WebSocket-based real-time notifications
+> - Toast notifications in the UI
+> - Database table to store notification history
+> - Mark as read/unread functionality
+> - Different notification types (info, warning, success, error)
+> - Admin panel to send system-wide notifications
+> - Email fallback for offline users
+> 
+> Please analyze my current codebase structure and implement this feature following my existing patterns and conventions.
+```
+
+### 💡 Pro Tips for Better Results
+
+1. **Use AI to generate your prompts**: Ask ChatGPT or Claude to help you create detailed, specific prompts for your use case
+2. **Provide context**: Include your tech stack, requirements, and any constraints
+3. **Stay interactive**: Keep the conversation going to refine and iterate on solutions
+4. **Ask for explanations**: Request explanations of architectural decisions and trade-offs
+
+### Alternative: Non-Interactive Mode
+For automation or simple one-off tasks:
+
+```bash
+# Quick analysis
+claude-mpm run -i "What testing frameworks are used in this project?" --non-interactive
+
+# With subprocess orchestration for complex tasks
+claude-mpm run --subprocess -i "Audit this codebase for security vulnerabilities" --non-interactive
+```
+
+**Note**: Non-interactive mode has higher overhead and is less efficient for multi-step development workflows.
+
 
 ## 📚 Documentation
 
@@ -75,9 +171,9 @@ Claude MPM provides a modular framework for extending Claude's capabilities:
 
 ## Installation
 
-### Quick Install Options
+### Other Installation Methods
 
-#### Option 1: Using UV (Recommended - Fast)
+#### Using UV (Recommended - Fast)
 UV is a lightning-fast Python package manager written in Rust, offering 10-100x speed improvements over pip.
 
 ```bash
@@ -91,7 +187,7 @@ uv pip install claude-mpm
 uv pip install git+https://github.com/bobmatnyc/claude-mpm.git
 ```
 
-#### Option 2: Using pip (Traditional)
+#### Using pip (Traditional)
 ```bash
 # Install from PyPI
 pip install claude-mpm
@@ -100,13 +196,6 @@ pip install claude-mpm
 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
@@ -174,21 +263,6 @@ Commands:
   info                 Show framework and configuration info
 ```
 
-## Quick Start
-
-```bash
-# 1. Clone and install
-git clone https://github.com/yourusername/claude-mpm.git
-cd claude-mpm
-./install_dev.sh
-source venv/bin/activate
-
-# 2. Run interactive session
-claude-mpm
-
-# 3. Or run a single command
-claude-mpm run -i "Explain the codebase structure" --non-interactive
-```
 
 
 ## Architecture

claude_mpm-2.0.0/VERSION

@@ -0,0 +1 @@
+2.0.0

claude_mpm-2.0.0/claude-mpm

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# Project-level claude-mpm wrapper that delegates to the scripts directory version
+
+set -e
+
+# Get the directory where this script is located
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Prevent infinite recursion by checking if we're already being called from ourselves
+if [ -n "$CLAUDE_MPM_WRAPPER_ACTIVE" ]; then
+    echo "Error: Recursive call detected. Please check your installation."
+    echo "This usually happens when the global 'claude-mpm' command points back to this wrapper."
+    echo "Try using the full path: $SCRIPT_DIR/scripts/claude-mpm"
+    exit 1
+fi
+
+# Mark that we're in the wrapper to prevent recursion
+export CLAUDE_MPM_WRAPPER_ACTIVE=1
+
+# Check if running from source or installed
+if [ -f "$SCRIPT_DIR/scripts/claude-mpm" ]; then
+    # Running from source directory
+    exec "$SCRIPT_DIR/scripts/claude-mpm" "$@"
+elif command -v claude-mpm &> /dev/null; then
+    # Check if the found claude-mpm is actually this script (via symlink)
+    FOUND_CLAUDE_MPM=$(command -v claude-mpm)
+    RESOLVED_CLAUDE_MPM=$(readlink -f "$FOUND_CLAUDE_MPM" 2>/dev/null || echo "$FOUND_CLAUDE_MPM")
+    THIS_SCRIPT=$(readlink -f "$0" 2>/dev/null || echo "$0")
+    
+    if [ "$RESOLVED_CLAUDE_MPM" = "$THIS_SCRIPT" ]; then
+        # The found claude-mpm is actually this script, use the scripts version
+        if [ -f "$SCRIPT_DIR/scripts/claude-mpm" ]; then
+            exec "$SCRIPT_DIR/scripts/claude-mpm" "$@"
+        else
+            echo "Error: scripts/claude-mpm not found in $SCRIPT_DIR"
+            exit 1
+        fi
+    else
+        # Running a different installed version
+        exec claude-mpm "$@"
+    fi
+else
+    echo "Error: claude-mpm not found. Please run ./install.sh"
+    exit 1
+fi

{claude_mpm-1.1.0 → claude_mpm-2.0.0}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobmatnyc/claude-mpm",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "description": "NPM wrapper for claude-mpm Python package - Requires Python 3.8+. Orchestrate Claude with agent delegation and ticket tracking",
   "keywords": [
     "claude",

{claude_mpm-1.1.0 → claude_mpm-2.0.0}/pyproject.toml

@@ -89,7 +89,6 @@ disallow_untyped_defs = true
 write_to = "src/claude_mpm/_version.py"
 version_scheme = "post-release"
 local_scheme = "dirty-tag"
-fallback_version = "1.0.0"
+fallback_version = "2.0.0"
 
-[tool.setuptools.dynamic]
-version = {attr = "claude_mpm._version.__version__"}
+# Version is handled by setuptools_scm, not by reading from file

{claude_mpm-1.1.0 → claude_mpm-2.0.0}/scripts/deploy_local.sh

@@ -196,11 +196,11 @@ setup_path_and_scripts() {
     # Ensure ~/.local/bin exists
     mkdir -p "$HOME/.local/bin"
     
-    # Create symlink to main script
+    # Create symlink to the actual script (not the wrapper to avoid recursion)
     if [ -f "$HOME/.local/bin/claude-mpm" ]; then
         rm "$HOME/.local/bin/claude-mpm"
     fi
-    ln -s "$PROJECT_ROOT/claude-mpm" "$HOME/.local/bin/claude-mpm"
+    ln -s "$PROJECT_ROOT/scripts/claude-mpm" "$HOME/.local/bin/claude-mpm"
     chmod +x "$HOME/.local/bin/claude-mpm"
     print_success "Created claude-mpm command"