claude-mpm 1.0.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

claude_mpm/validation/agent_validator.py

@@ -0,0 +1,302 @@
+"""
+Agent validation framework using JSON Schema validation.
+
+This module provides comprehensive validation for agent configurations
+using the standardized JSON schema with direct validation approach.
+"""
+
+import json
+import logging
+from pathlib import Path
+from typing import Dict, List, Optional, Any, Tuple
+from dataclasses import dataclass, field
+from datetime import datetime
+import jsonschema
+from jsonschema import validate, ValidationError, Draft7Validator
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class ValidationResult:
+    """Result of agent validation."""
+    is_valid: bool
+    errors: List[str] = field(default_factory=list)
+    warnings: List[str] = field(default_factory=list)
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+
+class AgentValidator:
+    """Validates agent configurations against JSON schema."""
+    
+    def __init__(self, schema_path: Optional[Path] = None):
+        """Initialize the validator with the agent schema."""
+        if schema_path is None:
+            schema_path = Path(__file__).parent.parent / "schemas" / "agent_schema.json"
+        
+        self.schema_path = schema_path
+        self.schema = self._load_schema()
+        self.validator = Draft7Validator(self.schema)
+    
+    def _load_schema(self) -> Dict[str, Any]:
+        """Load the JSON schema from file."""
+        try:
+            with open(self.schema_path, 'r') as f:
+                return json.load(f)
+        except Exception as e:
+            logger.error(f"Failed to load schema from {self.schema_path}: {e}")
+            raise
+    
+    def validate_agent(self, agent_data: Dict[str, Any]) -> ValidationResult:
+        """
+        Validate a single agent configuration against the schema.
+        
+        Args:
+            agent_data: Agent configuration dictionary
+            
+        Returns:
+            ValidationResult with validation status and any errors/warnings
+        """
+        result = ValidationResult(is_valid=True)
+        
+        # Perform JSON schema validation
+        try:
+            validate(instance=agent_data, schema=self.schema)
+        except ValidationError as e:
+            result.is_valid = False
+            result.errors.append(f"Schema validation error: {e.message}")
+            
+            # Add path information if available
+            if e.path:
+                path = ".".join(str(p) for p in e.path)
+                result.errors.append(f"Error at path: {path}")
+        
+        # Additional business rule validations
+        if result.is_valid:
+            self._validate_business_rules(agent_data, result)
+        
+        # Add metadata
+        result.metadata = {
+            "validated_at": datetime.utcnow().isoformat(),
+            "schema_version": self.schema.get("version", "1.0.0"),
+            "agent_id": agent_data.get("id", "unknown")
+        }
+        
+        return result
+    
+    def _validate_business_rules(self, agent_data: Dict[str, Any], result: ValidationResult) -> None:
+        """Apply additional business rule validations beyond schema."""
+        
+        # Validate resource tier consistency
+        resource_tier = agent_data.get("capabilities", {}).get("resource_tier")
+        if resource_tier:
+            self._validate_resource_tier_limits(agent_data, resource_tier, result)
+        
+        # Validate instruction length (double-check)
+        instructions = agent_data.get("instructions", "")
+        if len(instructions) > 8000:
+            result.errors.append(f"Instructions exceed 8000 character limit: {len(instructions)} characters")
+            result.is_valid = False
+        
+        # Validate model compatibility with tools
+        self._validate_model_tool_compatibility(agent_data, result)
+        
+        # Validate agent ID format (clean IDs without _agent suffix)
+        agent_id = agent_data.get("id", "")
+        if agent_id.endswith("_agent"):
+            result.warnings.append(f"Agent ID '{agent_id}' contains deprecated '_agent' suffix")
+        
+        # Validate handoff agents exist
+        handoff_agents = agent_data.get("interactions", {}).get("handoff_agents", [])
+        for handoff_id in handoff_agents:
+            if handoff_id == agent_id:
+                result.warnings.append(f"Agent '{agent_id}' references itself in handoff_agents")
+    
+    def _validate_resource_tier_limits(self, agent_data: Dict[str, Any], tier: str, result: ValidationResult) -> None:
+        """Validate resource limits match the tier constraints."""
+        tier_limits = {
+            "intensive": {
+                "memory_limit": (4096, 8192),
+                "cpu_limit": (60, 100),
+                "timeout": (600, 3600)
+            },
+            "standard": {
+                "memory_limit": (2048, 4096),
+                "cpu_limit": (30, 60),
+                "timeout": (300, 1200)
+            },
+            "lightweight": {
+                "memory_limit": (512, 2048),
+                "cpu_limit": (10, 30),
+                "timeout": (30, 600)
+            }
+        }
+        
+        if tier not in tier_limits:
+            return
+        
+        limits = tier_limits[tier]
+        capabilities = agent_data.get("capabilities", {})
+        
+        # Check memory limit
+        memory = capabilities.get("memory_limit")
+        if memory is not None:
+            min_mem, max_mem = limits["memory_limit"]
+            if not (min_mem <= memory <= max_mem):
+                result.warnings.append(
+                    f"Memory limit {memory}MB outside recommended range "
+                    f"{min_mem}-{max_mem}MB for tier '{tier}'"
+                )
+        
+        # Check CPU limit
+        cpu = capabilities.get("cpu_limit")
+        if cpu is not None:
+            min_cpu, max_cpu = limits["cpu_limit"]
+            if not (min_cpu <= cpu <= max_cpu):
+                result.warnings.append(
+                    f"CPU limit {cpu}% outside recommended range "
+                    f"{min_cpu}-{max_cpu}% for tier '{tier}'"
+                )
+        
+        # Check timeout
+        timeout = capabilities.get("timeout")
+        if timeout is not None:
+            min_timeout, max_timeout = limits["timeout"]
+            if not (min_timeout <= timeout <= max_timeout):
+                result.warnings.append(
+                    f"Timeout {timeout}s outside recommended range "
+                    f"{min_timeout}-{max_timeout}s for tier '{tier}'"
+                )
+    
+    def _validate_model_tool_compatibility(self, agent_data: Dict[str, Any], result: ValidationResult) -> None:
+        """Validate that model and tools are compatible."""
+        model = agent_data.get("capabilities", {}).get("model", "")
+        tools = agent_data.get("capabilities", {}).get("tools", [])
+        
+        # Haiku models shouldn't use resource-intensive tools
+        if "haiku" in model.lower():
+            intensive_tools = {"docker", "kubectl", "terraform", "aws", "gcloud", "azure"}
+            used_intensive = set(tools) & intensive_tools
+            if used_intensive:
+                result.warnings.append(
+                    f"Haiku model '{model}' using resource-intensive tools: {used_intensive}"
+                )
+        
+        # Network access requirement
+        network_tools = {"WebSearch", "WebFetch", "aws", "gcloud", "azure"}
+        needs_network = bool(set(tools) & network_tools)
+        has_network = agent_data.get("capabilities", {}).get("network_access", False)
+        
+        if needs_network and not has_network:
+            result.warnings.append(
+                f"Agent uses network tools {set(tools) & network_tools} but network_access is False"
+            )
+    
+    def validate_file(self, file_path: Path) -> ValidationResult:
+        """Validate an agent configuration file."""
+        try:
+            with open(file_path, 'r') as f:
+                agent_data = json.load(f)
+            
+            result = self.validate_agent(agent_data)
+            result.metadata["file_path"] = str(file_path)
+            return result
+            
+        except json.JSONDecodeError as e:
+            result = ValidationResult(is_valid=False)
+            result.errors.append(f"Invalid JSON in {file_path}: {e}")
+            return result
+        except Exception as e:
+            result = ValidationResult(is_valid=False)
+            result.errors.append(f"Error reading {file_path}: {e}")
+            return result
+    
+    def validate_directory(self, directory: Path) -> Dict[str, ValidationResult]:
+        """Validate all agent files in a directory."""
+        results = {}
+        
+        for json_file in directory.glob("*.json"):
+            if json_file.name == "agent_schema.json":
+                continue
+            
+            logger.info(f"Validating {json_file}")
+            results[json_file.name] = self.validate_file(json_file)
+        
+        return results
+    
+    def get_schema_info(self) -> Dict[str, Any]:
+        """Get information about the loaded schema."""
+        return {
+            "schema_path": str(self.schema_path),
+            "schema_title": self.schema.get("title", "Unknown"),
+            "schema_description": self.schema.get("description", ""),
+            "required_fields": self.schema.get("required", []),
+            "properties": list(self.schema.get("properties", {}).keys())
+        }
+
+
+def validate_agent_migration(old_agent: Dict[str, Any], new_agent: Dict[str, Any]) -> ValidationResult:
+    """
+    Validate that a migrated agent maintains compatibility.
+    
+    Args:
+        old_agent: Original agent configuration
+        new_agent: Migrated agent configuration
+        
+    Returns:
+        ValidationResult with migration validation results
+    """
+    result = ValidationResult(is_valid=True)
+    
+    # Check that core functionality is preserved
+    old_tools = set(old_agent.get("configuration_fields", {}).get("tools", []))
+    new_tools = set(new_agent.get("capabilities", {}).get("tools", []))
+    
+    if old_tools != new_tools:
+        missing = old_tools - new_tools
+        added = new_tools - old_tools
+        if missing:
+            result.warnings.append(f"Tools removed in migration: {missing}")
+        if added:
+            result.warnings.append(f"Tools added in migration: {added}")
+    
+    # Check instruction preservation
+    old_instructions = old_agent.get("narrative_fields", {}).get("instructions", "")
+    new_instructions = new_agent.get("instructions", "")
+    
+    if old_instructions and not new_instructions:
+        result.errors.append("Instructions lost in migration")
+        result.is_valid = False
+    elif len(old_instructions) > len(new_instructions) * 1.1:  # Allow 10% reduction
+        result.warnings.append("Significant instruction content reduction in migration")
+    
+    return result
+
+
+# Convenience functions
+def validate_agent_file(file_path: Path) -> ValidationResult:
+    """Validate a single agent file."""
+    validator = AgentValidator()
+    return validator.validate_file(file_path)
+
+
+def validate_all_agents(directory: Path) -> Tuple[int, int, List[str]]:
+    """
+    Validate all agents in a directory and return summary.
+    
+    Returns:
+        Tuple of (valid_count, invalid_count, error_messages)
+    """
+    validator = AgentValidator()
+    results = validator.validate_directory(directory)
+    
+    valid_count = sum(1 for r in results.values() if r.is_valid)
+    invalid_count = len(results) - valid_count
+    
+    error_messages = []
+    for filename, result in results.items():
+        if not result.is_valid:
+            for error in result.errors:
+                error_messages.append(f"{filename}: {error}")
+    
+    return valid_count, invalid_count, error_messages

{claude_mpm-1.0.0.dist-info → claude_mpm-2.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 1.0.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
@@ -44,8 +44,106 @@ 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.
+
+> **⚠️ 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
 
@@ -117,17 +215,45 @@ Claude MPM provides a modular framework for extending Claude's capabilities:
 
 ## Installation
 
-### From Source
+### Other Installation Methods
+
+#### 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
+```
+
+#### 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
+```
+
+### 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 +261,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)
@@ -181,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.0.0.dist-info → claude_mpm-2.0.0.dist-info}/RECORD

@@ -1,30 +1,39 @@
 claude_mpm/__init__.py,sha256=sAbTZkHe3vWYAKDWdGyGVue5zwLD7nCOHZwZrLALM8A,395
 claude_mpm/__main__.py,sha256=smBw-5J3nf5s6GgQjj384GUr28YotIX-WNOxqpP0wnE,310
-claude_mpm/_version.py,sha256=n7VdPKEcovT2OwODlqBHlbkfj1OEIRsPXhFaCt3nRss,1206
-claude_mpm/cli.py,sha256=jQ9w3AqIF_6XHJk4D4NWL5Fo0jNS0wpmfekNlzudSSg,23666
+claude_mpm/_version.py,sha256=Ng-R0tLTmF6GT0YoJek11nrB3KB8c3Q4YfYsQ_cKXvw,1394
+claude_mpm/cli.py,sha256=EgzmFR-6njXedJUtMrWY0o-QAezsY3fc8uObehDDPMw,23164
+claude_mpm/cli_enhancements.py,sha256=nwdOrbXITRqvcq_vrJtPKW1GDS7dLIG4UqjoUet2vR0,10890
 claude_mpm/cli_main.py,sha256=KCAe-ws73NrIg5qmFhPdZ1a4uoiaEZ-lldYzQ6KfnJg,306
 claude_mpm/constants.py,sha256=5AG5hgBxOC7gMNHDx0lAhS-FQ8gXhtGtqJ9Moj3S6ro,4044
 claude_mpm/init.py,sha256=gOreOf7BLXkT0_HrQk_As4Kz1OT_NJG_RG0i0hbY0z0,8088
 claude_mpm/agents/BASE_AGENT_TEMPLATE.md,sha256=TYgSd9jNBMWp4mAOBUl9dconX4RcGbvmMEScRy5uyko,3343
-claude_mpm/agents/INSTRUCTIONS.md,sha256=FuLq0cBjUjqByA9rdi1H_3SCt8xSjsTWM_VvnIQz2fg,16578
-claude_mpm/agents/__init__.py,sha256=DxJswRx5DpgJVZEY5JlZm5VJNb_CakV5Ch231r7nWlo,3292
-claude_mpm/agents/agent_loader.py,sha256=RAAoIxM9DONMMIqyEhaU0nEiaZKYkEZpMP6humOBmU0,23669
+claude_mpm/agents/INSTRUCTIONS.md,sha256=I2Y_Aed6-E6p7gd2ujy5cyFuMIZorqFz_NbF4Y60Oz0,8013
+claude_mpm/agents/__init__.py,sha256=r-p7ervzjLPD7_8dm2tXX_fwvdTZy6KwKA03ofxN3sA,3275
+claude_mpm/agents/agent-template.yaml,sha256=koKJn8MCAJx0QNQMHouvIZrwvw5qjPV0U-aV-YVyk6s,2036
+claude_mpm/agents/agent_loader.py,sha256=aZiTX8u0__8ueHzwney98PHfVMSkrpF3Nh-DoFlso74,18675
 claude_mpm/agents/agent_loader_integration.py,sha256=z_DXxAIeuUD71HBYdxxvcFKoQYQxITLo8oAdN_M4LTA,7610
 claude_mpm/agents/agents_metadata.py,sha256=Xju9Yim6XSv2u1J_Swre5VJySbdxxC-9TzpOfXG8ibg,5170
-claude_mpm/agents/base_agent.json,sha256=P4724UbQJQlZy57WkwIz_f_R86JepljWpTflI9hLrUs,2296
-claude_mpm/agents/base_agent_loader.py,sha256=gVWXfxFh3_Z5FJ77SWbxrA8yFOQ8IwwfnOgmv6Z89CQ,18680
+claude_mpm/agents/base_agent.json,sha256=wvopTu58PEdvgvjBi45J5aBA6bxs5_v1KC84CbJeRzY,3820
+claude_mpm/agents/base_agent_loader.py,sha256=DJ0BDP_7ic3q0Zv5YQFZCYZp2V3bC3bB1v11ohbN8yU,18418
 claude_mpm/agents/system_agent_config.py,sha256=Lke4FFjU0Vq3LLo4O7KvtHxadP7agAwC-ljCXK40h_A,23526
 claude_mpm/agents/schema/agent_schema.json,sha256=Ca_8E0QkFpGwQd7XjVy3jnBMv_-Yo2rL7Po-ziHut2U,5472
 claude_mpm/agents/templates/__init__.py,sha256=7UyIChghCnkrDctvmCRYr0Wrnn8Oj-eCdgL0KpFy1Mo,2668
-claude_mpm/agents/templates/data_engineer_agent.json,sha256=MKeXvoIJga_tE1IKzFi3iRdfg8-6vk6DL12_TXjzdkk,2257
-claude_mpm/agents/templates/documentation_agent.json,sha256=snfJW2yW9aMv9ldCSIWW7zwnyoQRx5u7xLMkNlfus9I,2258
-claude_mpm/agents/templates/engineer_agent.json,sha256=t5SziRtblVTJaRGhHzZKAWoflrFg4wsckvW1RTz2AAA,6179
-claude_mpm/agents/templates/ops_agent.json,sha256=y-unQijBWKAaPz3YCFoe21OMZXsU8jJ-mFrLGcmo8H0,2227
-claude_mpm/agents/templates/qa_agent.json,sha256=_FHWnUeh151rgWX_xUgXsfGrJz7Bs3wno2lXU0nTwAo,2157
-claude_mpm/agents/templates/research_agent.json,sha256=o4n_sqSbjnsFRELB2q501vgwm-o2tQNLJLYvnVP9LWU,5629
-claude_mpm/agents/templates/security_agent.json,sha256=l5YuD-27CxKSOsRLv0bDY_tCZyds0yGbeizLb8paeFY,2322
-claude_mpm/agents/templates/update-optimized-specialized-agents.json,sha256=7lcCSZXfnvLzAUqqM-HENtwPdTUbdABONsCt0vqamU0,19005
-claude_mpm/agents/templates/version_control_agent.json,sha256=too38RPTLJ9HutCMn0nfmEdCj2me241dx5tUYDFtu94,2143
+claude_mpm/agents/templates/data_engineer.json,sha256=3qLAOSBO47O5bj8gnUNvEjeIe9bRc6Hzaj3w_pTvmvI,5811
+claude_mpm/agents/templates/documentation.json,sha256=W6gF0p2XpXrYPng7aUjbpE0Z3IW193EbP3nKoNmY4yc,3043
+claude_mpm/agents/templates/engineer.json,sha256=vRAr9sEgKt7_IVg2e3iZmLQFQHTzjgM-YQepS-TL6rY,8829
+claude_mpm/agents/templates/ops.json,sha256=mNoS_OS_e4Ht2drx3d7H0I18x38LX16E-mhsJn95ydQ,2899
+claude_mpm/agents/templates/qa.json,sha256=qEsJzkXbqM4pAdl4vyW1HeaQME5SvnIk4XttPWI2Dhw,2942
+claude_mpm/agents/templates/research.json,sha256=cfZlfJ9NMEUAb9BxqK_uo2bdRiMIt842jwQxolZ7YIM,6129
+claude_mpm/agents/templates/security.json,sha256=T0hRMeHq54ryblR2QsBFBJtNx-mYR3VEtwQYOvx4EOU,2945
+claude_mpm/agents/templates/version_control.json,sha256=RsV0WLs58boDOzurwB75Zdol4uXf_Za0VHOqQ3Og2Rw,2923
+claude_mpm/agents/templates/backup/data_engineer_agent_20250726_234551.json,sha256=lLso4RHXVTQmX4A1XwF84kT59zZDblPO1xCgBj4S4x8,5060
+claude_mpm/agents/templates/backup/documentation_agent_20250726_234551.json,sha256=snfJW2yW9aMv9ldCSIWW7zwnyoQRx5u7xLMkNlfus9I,2258
+claude_mpm/agents/templates/backup/engineer_agent_20250726_234551.json,sha256=21o8TGCM9TO6eocSV9Ev5MmCq-xYwwCqMU7KQESaY2Q,8479
+claude_mpm/agents/templates/backup/ops_agent_20250726_234551.json,sha256=y-unQijBWKAaPz3YCFoe21OMZXsU8jJ-mFrLGcmo8H0,2227
+claude_mpm/agents/templates/backup/qa_agent_20250726_234551.json,sha256=_FHWnUeh151rgWX_xUgXsfGrJz7Bs3wno2lXU0nTwAo,2157
+claude_mpm/agents/templates/backup/research_agent_20250726_234551.json,sha256=o4n_sqSbjnsFRELB2q501vgwm-o2tQNLJLYvnVP9LWU,5629
+claude_mpm/agents/templates/backup/security_agent_20250726_234551.json,sha256=l5YuD-27CxKSOsRLv0bDY_tCZyds0yGbeizLb8paeFY,2322
+claude_mpm/agents/templates/backup/version_control_agent_20250726_234551.json,sha256=too38RPTLJ9HutCMn0nfmEdCj2me241dx5tUYDFtu94,2143
 claude_mpm/agents/test_fix_deployment/.claude-pm/config/project.json,sha256=YZQgq2ri2_Y3qKzvPlC6TmzZKviDv0__GuyUOo1LbT8,146
 claude_mpm/cli_module/__init__.py,sha256=CkMp4gzWKoZZF_qKyBDi2sQaZw_GLWZYLtKouv-4f8s,390
 claude_mpm/cli_module/args.py,sha256=nilYpziBsoEySO4W1hQ2MRJyn9TFx3c3TrucyMMhRtk,7970
@@ -34,7 +43,6 @@ claude_mpm/cli_module/refactoring_guide.md,sha256=fl1PGwLZAj4OYWmU0syg1jDd81PqK7
 claude_mpm/cli_old/__init__.py,sha256=v7mFJSN0p6NOIcURZp5ibZaZBn6iGrLwyGl7tA_lh4c,32
 claude_mpm/cli_old/ticket_cli.py,sha256=oKIT2LR1tToHybwypRfsNdnYlwdRzjWyjlQN5lYwTOk,3795
 claude_mpm/config/__init__.py,sha256=p31JuaXLDHgIgoAbHApNvctN2IEZYq2MBkkXROdhbH8,105
-claude_mpm/config/hook_config.py,sha256=ehVAVHhn6ZBxrdWXqXB2M8jcAmqaWCnE9gVxuxR2UEs,1334
 claude_mpm/core/__init__.py,sha256=hE29BeE3qb8vC1-wiKjPh60WZebCwfo9UAUGM1zQnkc,1206
 claude_mpm/core/agent_name_normalizer.py,sha256=-X68oz3_74t9BRbHA54NEGyjy0xjTsGp_sCUHDtKp1s,9269
 claude_mpm/core/agent_registry.py,sha256=4MAfc7xDlrYWWkHmDMRmWE8q32teuCmIcud9D0I0dLo,20496
@@ -45,33 +53,36 @@ claude_mpm/core/base_service.py.bak,sha256=48A8eI_HPqxYm42X5jaTo8zQVOfFFXe7SqIUo
 claude_mpm/core/config.py,sha256=QNPufRWzXl99wAz14Gm2T_CG5K5n8d4eOjmpaxVllv0,12371
 claude_mpm/core/config_aliases.py,sha256=8eqA4wpWViIDm_9pL3f9j7cR_ssmhOYYiY2UzHrfUzg,10058
 claude_mpm/core/container.py,sha256=P4c4nSo_USSfHTxvpR1sQkVGNsgqozZBN27l3IXqiDc,12216
-claude_mpm/core/factories.py,sha256=ucS_t4mvLjyfQJ2FzMRemHJqKGqb_iTPe6HJ8x-ztOQ,9092
+claude_mpm/core/factories.py,sha256=Qh2n_x112ZIPWEfwFley9bb9IZcSG38LkpT3uValyDk,7484
 claude_mpm/core/framework_loader.py,sha256=SdONNh8a7vSicr4vVuRzd7OqgDMIyg9k_xxbr8bLRi8,19547
 claude_mpm/core/injectable_service.py,sha256=7fOny9c6x8IJ9hVZmFql1eNDXXB1jcWbsxfTKbMZk74,7497
 claude_mpm/core/interfaces.py,sha256=TpP474EKEng-1TrjKUsN69qq6dXy8zIjicS7iV-ZPV0,15269
 claude_mpm/core/logger.py,sha256=wqYlUy8wlSXyTWOeWCGNYaIWdiFYzT7yw1U0vdT3R_8,15894
 claude_mpm/core/minimal_framework_loader.py,sha256=liYS4IyuW_aFK7yhRDZwTwT-3q09fT3wIJSUzkI93Ko,3673
 claude_mpm/core/mixins.py,sha256=rTEH-7FDpNiLB8oo6mSb0CLarJklv4fDJw1xM-gr5wI,5599
-claude_mpm/core/service_registry.py,sha256=rRJDidqVU3DmGRuEWcb3-hhK2gxVe7MCFDPNOh7XlbY,10790
+claude_mpm/core/service_registry.py,sha256=wKJUO1g4UFA4dUpE3RkIYz1Ek8kIh4XfvU1kFeLCl2Q,10529
 claude_mpm/core/session_manager.py,sha256=3rO4KGZp8Qd_cUw6OWv4jyxGCUaL_MNPgCCpnwQt12A,6581
-claude_mpm/core/simple_runner.py,sha256=cEaA5fzU8itTIcEF6Zy84S5ZBgKkkAd7IqPEC0YiP64,20914
+claude_mpm/core/simple_runner.py,sha256=WdgPz7qMhb9ApGNK3HnM-p4CAdvzvPGPdXsdLxp4xWQ,22473
 claude_mpm/core/tool_access_control.py,sha256=htZbDhC8s7D7BVqfmk0BwRrYJnlnUAk8_NeJKOaeNlg,6632
-claude_mpm/hooks/README.md,sha256=lsvGzw9g8Lf0VfRcqoGNGpAZEQSmpE0C8DksZ4nvDso,8030
+claude_mpm/generators/__init__.py,sha256=l53aBn6kBQSDz3b6bZkMCJBcEmYnV9hHEZq8LKzXgH8,152
+claude_mpm/generators/agent_profile_generator.py,sha256=2HjOscogSyvrtQj8KwdgNPS6Ym_QvgX1BMeauQZewZA,5751
+claude_mpm/hooks/README.md,sha256=AjW-V7WQGf9o5X9otNl5k8rtal_MdyToFqVx_pudOXs,3289
 claude_mpm/hooks/__init__.py,sha256=Y3JJ_mEtvRP07r_gXkju4c0s18bjIXGH1uAbhSw1ES0,166
 claude_mpm/hooks/base_hook.py,sha256=a4V2EKEG02QQB0h-pnxhZI-fouKBLYbdBLckcaNuf0k,5098
-claude_mpm/hooks/hook_client.py,sha256=XxVIgV3L4RBV9YdfBHnm3oxfd8oZjFC4NYlVAbT5Lbk,8893
-claude_mpm/hooks/hook_runner.py,sha256=5cwo7SXRx4qr08JcYY4pbDktzBgJYgRZ624r8veGEgw,12800
-claude_mpm/hooks/json_rpc_executor.py,sha256=7D-jU_w1Gt1nV0kx5Rva_hleOPc92LtqZiX99j1MXjY,9091
-claude_mpm/hooks/json_rpc_hook_client.py,sha256=VZoTyKKIW0lfb5tZ5E3P_WlqBg6y9gzRG-ydZcomau0,11923
 claude_mpm/hooks/tool_call_interceptor.py,sha256=08_Odgm6Sg1zBJhGjwzVa03AReeBPZHTjndyjEO99cY,7629
+claude_mpm/hooks/validation_hooks.py,sha256=7TU2N4SzCm2nwpsR0xiNKsHQNsWODnOVAmK9jHq1QqM,6582
 claude_mpm/hooks/builtin/__init__.py,sha256=Tfh3dIGxlQRUKBzR_MWC64WAKJ0Q_POsVVFl7lz9CD4,36
 claude_mpm/hooks/builtin/logging_hook_example.py,sha256=SyfdAH9ENTIpMhw2IeqqZpXNBUakYDI1yF5DFS0RJZ4,4971
+claude_mpm/hooks/builtin/mpm_command_hook.py,sha256=PhQl1FifaB61gRrBOIXAim0R-XUBIzZwLdjb6WQuEGQ,4541
 claude_mpm/hooks/builtin/post_delegation_hook_example.py,sha256=54OJKRgjdXH8A2LHypbXoMlCNlmWXBY5Fvk0-VWq_fI,4596
 claude_mpm/hooks/builtin/pre_delegation_hook_example.py,sha256=JOAdDm46be_ol7uSmnQaE0jQS8SsiuGei80Auj3sdL8,4692
 claude_mpm/hooks/builtin/submit_hook_example.py,sha256=x7-yIF_QYe9uwCezeVDA_HdDTLu6uQfbTgZ12pdC4xo,3431
 claude_mpm/hooks/builtin/ticket_extraction_hook_example.py,sha256=4wNhS2tFUXgdcvepefUvi818Tt8kKnPQQJVxqINGeys,9237
 claude_mpm/hooks/builtin/todo_agent_prefix_hook.py,sha256=v_4w2vcZIt0bkZxqdHmgtN79yHZ1gviuhhBws0FHpIQ,10226
 claude_mpm/hooks/builtin/workflow_start_hook.py,sha256=EQrtYD9qLMLSYPl3oQinEheZAJ2i5EO_h2jhhR8lmt0,7490
+claude_mpm/hooks/claude_hooks/__init__.py,sha256=bMUwt2RzDGAcEbtDMA7vWS1uJsauOY0OixIe4pHwgQ0,129
+claude_mpm/hooks/claude_hooks/hook_handler.py,sha256=30YDU6hVoju-vDyhP9HdhdGo5NJ8g4reJiQokLjvSKk,16154
+claude_mpm/hooks/claude_hooks/hook_wrapper.sh,sha256=6n0-G317jIrPuNRGnAyFvBbNM4gVzKEat_WSbpvKN-g,1742
 claude_mpm/orchestration/SUBPROCESS_DESIGN.md,sha256=YwToiT1_NXblv1XIWhWPNc2uKzDvqY2E_Nix8qK7qk0,2136
 claude_mpm/orchestration/__init__.py,sha256=C-cwldtfBCgV19mKnJa5U1XiKw1rAZvx-kK61nIdcao,205
 claude_mpm/orchestration/archive/direct_orchestrator.py,sha256=j-IP-st-Xi9Xf33i-BLPZOE_kkxSZxNNuFZmp6MTuZY,7884
@@ -86,21 +97,19 @@ claude_mpm/orchestration/archive/simple_orchestrator.py,sha256=Booy_eeuC5H3i-1HA
 claude_mpm/orchestration/archive/subprocess_orchestrator.py,sha256=TYTAHX6p4OpgBsfU-CF2D6r_wmZHIASc9GR8l3-qXQM,31982
 claude_mpm/orchestration/archive/system_prompt_orchestrator.py,sha256=R16sc-94kQVeGjJzTYmvKn0aYgj_9qxyzShDy1E5zpE,12853
 claude_mpm/orchestration/archive/wrapper_orchestrator.py,sha256=cvL0NJf9kCWf3QJl67ySwvtR1Hd9Rym28Ii8Rtsdi6Q,6806
+claude_mpm/schemas/agent_schema.json,sha256=xPqYaZ8VNFyabdpEL91kufKPsWk36v6hYbqoMfUsvs4,9645
 claude_mpm/scripts/__init__.py,sha256=M2n9fQeyfILC8gogXvJv6ixnu7hwpqLEqLWJRaUN0MU,37
 claude_mpm/scripts/ticket.py,sha256=GmFimtTJxc927cCzJvvJH3gvoxXQtAB-W-xnuclcvNs,9350
 claude_mpm/services/__init__.py,sha256=-EBm07Lh9mjcofiQHCqyCCQJMLi9akVArPlz8i_kEOo,226
 claude_mpm/services/agent_deployment.py,sha256=FqxKBaTl2vQqsxN7QZPKIeLmhO-f8VW6maRBmAUNW50,40398
 claude_mpm/services/agent_lifecycle_manager.py,sha256=VZBVONepomFpMqL7soaXIawS4NoaltFWKed7tU6bS3w,39057
-claude_mpm/services/agent_management_service.py,sha256=aotSxiLzRW1VKPGkanFt7hzyPfxLf8LVE6o1EA7X2BY,22875
+claude_mpm/services/agent_management_service.py,sha256=eX5n6w17b9urcogVdr4V-kXcuo7yyjORTrIihjF8PeQ,22853
 claude_mpm/services/agent_modification_tracker.py,sha256=7FRDXuCNANUnLatCgtBArG-AxZNtKbGQjgCKjnzmJ80,34050
-claude_mpm/services/agent_profile_loader.py,sha256=PMcFbK-acIMleB7xoZMMoDX8xq1a2_PdmZ9-R2V41Cw,23148
-claude_mpm/services/agent_registry.py,sha256=X8f6ATNtftZBSR9AaTIZenLyRVAegA3PZ9tGoqpS0uw,24446
-claude_mpm/services/base_agent_manager.py,sha256=2u3efvWyw_Ki9l7z81eVGwyPpG__j2etRMQUhvOTpAw,15016
+claude_mpm/services/agent_profile_loader.py,sha256=4D1Xj0vgqV8wN7Y3r8lijh7ghy5cVGU5t5s931sVqGc,23133
+claude_mpm/services/agent_registry.py,sha256=vn8CEW0vppj_0EY2NofmNRZEnpV70mlWiX2kAViFDRg,24374
+claude_mpm/services/base_agent_manager.py,sha256=WEcfzdMaFXmXUSoEYEPNeGu8dvqjIv53zyUU0ITrhsM,14987
 claude_mpm/services/framework_agent_loader.py,sha256=QdRSYRurYF3YbAXJwIGei71BffD5AqOVcV3ktRPdk7g,14018
 claude_mpm/services/framework_claude_md_generator.py,sha256=3kHmkRLHTex6HFZ4DhbLVQb48j-5dAoy1q6UW1Qf7U8,22914
-claude_mpm/services/hook_service.py,sha256=8CMyvlSK_QvZtJqU3rAv3nST3KJLYhe6nTGdEi51mWE,13619
-claude_mpm/services/hook_service_manager.py,sha256=QtDwMdC3PAjoO6oZ3Re3FRPoyHujYnNF4akM4eqlM5U,8523
-claude_mpm/services/json_rpc_hook_manager.py,sha256=fd8YN460pVv4aI8vCFFsWMXJ2opYphXitCUkLBaqPL8,2981
 claude_mpm/services/shared_prompt_cache.py,sha256=D04lrRWyg0lHyqGcAHy7IYvRHRKSg6EOpAJwBUPa2wk,29890
 claude_mpm/services/ticket_manager.py,sha256=Ki11YjBkDax8BFVSaDdOBk3K4VU5gvdbgq9AmCyyoZ0,7454
 claude_mpm/services/ticket_manager_di.py,sha256=pIsIGncbboKzBYSRQTO7ZX5MuQzV6iFfIflvKe6u1jw,11123
@@ -148,12 +157,15 @@ claude_mpm/ui/rich_terminal_ui.py,sha256=gx_9TD0kR4Exq867pHjVVs_b-gw1q267t5oA2ZD
 claude_mpm/ui/terminal_ui.py,sha256=E_M-L-6EuGp6L8pRpaWEhTqf-ddDXhZp5W85D0XNRPw,11928
 claude_mpm/utils/__init__.py,sha256=E8Hvv6ykL6rnnc8-YmfoGNpRCZbcIirxcFuNz7YvDIg,346
 claude_mpm/utils/config_manager.py,sha256=TlekZYIWOz_ouWHQU4Gc-zckhoFK9AqA25b6A_XZdDc,16412
+claude_mpm/utils/error_handler.py,sha256=W_Zc0FrKudpXvxT66Oxx0v8WkR8HA2KlynzzGy3eGcU,8168
 claude_mpm/utils/import_migration_example.py,sha256=W4a4XH3FY_VBB00BB8Lae2aRPM021PxLHzdUfEs0B5w,2463
 claude_mpm/utils/imports.py,sha256=wX-SOXUHbemx01MHRGQpVwajzXH6qYdQkYNFCIbb2mw,6851
 claude_mpm/utils/path_operations.py,sha256=6pLMnAWBVzHkgp6JyQHmHbGD-dWn-nX21yV4E_eT-kM,11614
 claude_mpm/utils/paths.py,sha256=Xv0SZWdZRkRjN9e6clBcA165ya00GNQxt7SwMz51tfA,10153
-claude_mpm-1.0.0.dist-info/METADATA,sha256=s8VhjuHma1JWq9S1G6iq7eNfxD6__qDFbCF6aqZOw4c,8792
-claude_mpm-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-1.0.0.dist-info/entry_points.txt,sha256=PknO31um7d8bt6GjOiVeYpdJpjND0_C1z-LQfY6UfiU,142
-claude_mpm-1.0.0.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-1.0.0.dist-info/RECORD,,
+claude_mpm/validation/__init__.py,sha256=bJ19g9lnk7yIjtxzN8XPegp87HTFBzCrGQOpFgRTf3g,155
+claude_mpm/validation/agent_validator.py,sha256=gxBn3m3NyJiHymIoNGUBk4dzRjIrw3TVL6lWPpmZmW8,11693
+claude_mpm-2.0.0.dist-info/METADATA,sha256=RC_YCOD4Ed-EIA2RU4THxcAwU8mqthscpZdz-XetqBg,13250
+claude_mpm-2.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-2.0.0.dist-info/entry_points.txt,sha256=PknO31um7d8bt6GjOiVeYpdJpjND0_C1z-LQfY6UfiU,142
+claude_mpm-2.0.0.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-2.0.0.dist-info/RECORD,,