claude-mpm 3.5.4__py3-none-any.whl → 3.5.6__py3-none-any.whl

claude_mpm/services/agents/deployment/agent_deployment.py

@@ -70,13 +70,14 @@ class AgentDeploymentService:
     - YAML generation capabilities
     """
     
-    def __init__(self, templates_dir: Optional[Path] = None, base_agent_path: Optional[Path] = None):
+    def __init__(self, templates_dir: Optional[Path] = None, base_agent_path: Optional[Path] = None, working_directory: Optional[Path] = None):
         """
         Initialize agent deployment service.
         
         Args:
             templates_dir: Directory containing agent JSON files
             base_agent_path: Path to base_agent.md file
+            working_directory: User's working directory (for project agents)
             
         METRICS OPPORTUNITY: Track initialization performance:
         - Template directory scan time
@@ -100,6 +101,17 @@ class AgentDeploymentService:
             'deployment_errors': {}  # Track error types and frequencies
         }
         
+        # Determine the actual working directory
+        # Priority: working_directory param > CLAUDE_MPM_USER_PWD env var > current directory
+        if working_directory:
+            self.working_directory = Path(working_directory)
+        elif 'CLAUDE_MPM_USER_PWD' in os.environ:
+            self.working_directory = Path(os.environ['CLAUDE_MPM_USER_PWD'])
+        else:
+            self.working_directory = Path.cwd()
+        
+        self.logger.info(f"Working directory for deployment: {self.working_directory}")
+        
         # Find templates directory using centralized path management
         if templates_dir:
             self.templates_dir = Path(templates_dir)
@@ -137,6 +149,7 @@ class AgentDeploymentService:
         - Error type frequencies
         
         OPERATIONAL FLOW:
+        0. Validates and repairs broken frontmatter in existing agents (Step 0)
         1. Validates target directory (creates if needed)
         2. Loads base agent configuration
         3. Discovers all agent templates
@@ -178,13 +191,15 @@ class AgentDeploymentService:
             - skipped: List of unchanged agents
             - errors: List of deployment errors
             - total: Total number of agents processed
+            - repaired: List of agents with repaired frontmatter
         """
         # METRICS: Record deployment start time for performance tracking
         deployment_start_time = time.time()
         
         if not target_dir:
-            # Default to user's home .claude/agents directory
-            agents_dir = Path(Paths.CLAUDE_AGENTS_DIR.value).expanduser()
+            # Default to working directory's .claude/agents directory (not home)
+            # This ensures we deploy to the user's project directory, not the framework directory
+            agents_dir = self.working_directory / ".claude" / "agents"
         else:
             # If target_dir provided, use it directly (caller decides structure)
             # This allows for both passing a project dir or the full agents path
@@ -211,6 +226,7 @@ class AgentDeploymentService:
             "updated": [],
             "migrated": [],  # Track agents migrated from old format
             "converted": [],  # Track YAML to MD conversions
+            "repaired": [],  # Track agents with repaired frontmatter
             "total": 0,
             # METRICS: Add detailed timing and performance data to results
             "metrics": {
@@ -226,6 +242,16 @@ class AgentDeploymentService:
         try:
             # Create agents directory if needed
             agents_dir.mkdir(parents=True, exist_ok=True)
+            
+            # STEP 0: Validate and repair broken frontmatter in existing agents
+            # This ensures all existing agents have valid YAML frontmatter before deploying new ones
+            repair_results = self._validate_and_repair_existing_agents(agents_dir)
+            if repair_results["repaired"]:
+                results["repaired"] = repair_results["repaired"]
+                self.logger.info(f"Repaired frontmatter in {len(repair_results['repaired'])} existing agents")
+                for agent_name in repair_results["repaired"]:
+                    self.logger.debug(f"  - Repaired: {agent_name}")
+            
             # Determine source tier for logging
             source_tier = "SYSTEM"
             if ".claude-mpm/agents" in str(self.templates_dir) and "/templates" not in str(self.templates_dir):
@@ -269,7 +295,8 @@ class AgentDeploymentService:
             # Get all template files
             template_files = list(self.templates_dir.glob("*.json"))
             # Filter out non-agent files - exclude system files and uppercase special files
-            excluded_names = {"__init__", "MEMORIES", "TODOWRITE", "INSTRUCTIONS", "README"}
+            # CRITICAL: PM (Project Manager) must NEVER be deployed as it's the main Claude instance
+            excluded_names = {"__init__", "MEMORIES", "TODOWRITE", "INSTRUCTIONS", "README", "pm", "PM", "project_manager"}
             template_files = [
                 f for f in template_files 
                 if f.stem not in excluded_names 
@@ -373,6 +400,7 @@ class AgentDeploymentService:
                 f"updated {len(results['updated'])}, "
                 f"migrated {len(results['migrated'])}, "
                 f"converted {len(results['converted'])} YAML files, "
+                f"repaired {len(results['repaired'])} frontmatter, "
                 f"skipped {len(results['skipped'])}, "
                 f"errors: {len(results['errors'])}"
             )
@@ -864,7 +892,8 @@ temperature: {temperature}"""
             Dictionary of environment variables set for verification
         """
         if not config_dir:
-            config_dir = Path.cwd() / Paths.CLAUDE_CONFIG_DIR.value
+            # Use the working directory determined during initialization
+            config_dir = self.working_directory / Paths.CLAUDE_CONFIG_DIR.value
         
         env_vars = {}
         
@@ -930,7 +959,8 @@ temperature: {temperature}"""
             - warnings: List of potential issues
         """
         if not config_dir:
-            config_dir = Path.cwd() / ".claude"
+            # Use the working directory determined during initialization
+            config_dir = self.working_directory / ".claude"
         
         results = {
             "config_dir": str(config_dir),
@@ -1094,7 +1124,8 @@ temperature: {temperature}"""
         
         template_files = sorted(self.templates_dir.glob("*.json"))
         # Filter out non-agent files - exclude system files and uppercase special files
-        excluded_names = {"__init__", "MEMORIES", "TODOWRITE", "INSTRUCTIONS", "README"}
+        # CRITICAL: PM (Project Manager) must NEVER be deployed as it's the main Claude instance
+        excluded_names = {"__init__", "MEMORIES", "TODOWRITE", "INSTRUCTIONS", "README", "pm", "PM", "project_manager"}
         template_files = [
             f for f in template_files 
             if f.stem not in excluded_names 
@@ -1283,7 +1314,8 @@ temperature: {temperature}"""
             Cleanup results
         """
         if not config_dir:
-            config_dir = Path.cwd() / ".claude"
+            # Use the working directory determined during initialization
+            config_dir = self.working_directory / ".claude"
         
         results = {
             "removed": [],
@@ -1934,4 +1966,128 @@ metadata:
         except Exception as e:
             self.logger.warning(f"Error extracting YAML field '{field_name}': {e}")
         
-        return None
+        return None
+    
+    def _validate_and_repair_existing_agents(self, agents_dir: Path) -> Dict[str, Any]:
+        """
+        Validate and repair broken frontmatter in existing agent files.
+        
+        This method scans existing .claude/agents/*.md files and validates their
+        frontmatter. If the frontmatter is broken or missing, it attempts to repair
+        it or marks the agent for replacement during deployment.
+        
+        WHY: Ensures all existing agents have valid YAML frontmatter before deployment,
+        preventing runtime errors in Claude Code when loading agents.
+        
+        Args:
+            agents_dir: Directory containing agent .md files
+            
+        Returns:
+            Dictionary with validation results:
+            - repaired: List of agent names that were repaired
+            - replaced: List of agent names marked for replacement
+            - errors: List of validation errors
+        """
+        results = {
+            "repaired": [],
+            "replaced": [],
+            "errors": []
+        }
+        
+        try:
+            # Import frontmatter validator
+            from claude_mpm.agents.frontmatter_validator import FrontmatterValidator
+            validator = FrontmatterValidator()
+            
+            # Find existing agent files
+            agent_files = list(agents_dir.glob("*.md"))
+            
+            if not agent_files:
+                self.logger.debug("No existing agent files to validate")
+                return results
+            
+            self.logger.debug(f"Validating frontmatter in {len(agent_files)} existing agents")
+            
+            for agent_file in agent_files:
+                try:
+                    agent_name = agent_file.stem
+                    
+                    # Read agent file content
+                    content = agent_file.read_text()
+                    
+                    # Check if this is a system agent (authored by claude-mpm)
+                    # Only repair system agents, leave user agents alone
+                    if "author: claude-mpm" not in content and "author: 'claude-mpm'" not in content:
+                        self.logger.debug(f"Skipping validation for user agent: {agent_name}")
+                        continue
+                    
+                    # Extract and validate frontmatter
+                    if not content.startswith("---"):
+                        # No frontmatter at all - mark for replacement
+                        self.logger.warning(f"Agent {agent_name} has no frontmatter, marking for replacement")
+                        results["replaced"].append(agent_name)
+                        # Delete the file so it will be recreated
+                        agent_file.unlink()
+                        continue
+                    
+                    # Try to extract frontmatter
+                    try:
+                        end_marker = content.find("\n---\n", 4)
+                        if end_marker == -1:
+                            end_marker = content.find("\n---\r\n", 4)
+                        
+                        if end_marker == -1:
+                            # Broken frontmatter - mark for replacement
+                            self.logger.warning(f"Agent {agent_name} has broken frontmatter, marking for replacement")
+                            results["replaced"].append(agent_name)
+                            # Delete the file so it will be recreated
+                            agent_file.unlink()
+                            continue
+                        
+                        # Validate frontmatter with the validator
+                        validation_result = validator.validate_file(agent_file)
+                        
+                        if not validation_result.is_valid:
+                            # Check if it can be corrected
+                            if validation_result.corrected_frontmatter:
+                                # Apply corrections
+                                correction_result = validator.correct_file(agent_file, dry_run=False)
+                                if correction_result.corrections:
+                                    results["repaired"].append(agent_name)
+                                    self.logger.info(f"Repaired frontmatter for agent {agent_name}")
+                                    for correction in correction_result.corrections:
+                                        self.logger.debug(f"  - {correction}")
+                            else:
+                                # Cannot be corrected - mark for replacement
+                                self.logger.warning(f"Agent {agent_name} has invalid frontmatter that cannot be repaired, marking for replacement")
+                                results["replaced"].append(agent_name)
+                                # Delete the file so it will be recreated
+                                agent_file.unlink()
+                        elif validation_result.warnings:
+                            # Has warnings but is valid
+                            for warning in validation_result.warnings:
+                                self.logger.debug(f"Agent {agent_name} warning: {warning}")
+                        
+                    except Exception as e:
+                        # Any error in parsing - mark for replacement
+                        self.logger.warning(f"Failed to parse frontmatter for {agent_name}: {e}, marking for replacement")
+                        results["replaced"].append(agent_name)
+                        # Delete the file so it will be recreated
+                        try:
+                            agent_file.unlink()
+                        except Exception:
+                            pass
+                    
+                except Exception as e:
+                    error_msg = f"Failed to validate agent {agent_file.name}: {e}"
+                    self.logger.error(error_msg)
+                    results["errors"].append(error_msg)
+            
+        except ImportError:
+            self.logger.warning("FrontmatterValidator not available, skipping validation")
+        except Exception as e:
+            error_msg = f"Agent validation failed: {e}"
+            self.logger.error(error_msg)
+            results["errors"].append(error_msg)
+        
+        return results

claude_mpm/services/agents/management/agent_management_service.py

@@ -57,7 +57,8 @@ class AgentManager:
             
         if project_dir is None:
             project_root = PathResolver.get_project_root()
-            self.project_dir = project_root / ConfigPaths.CONFIG_DIR / "agents" / "project-specific"
+            # Use direct agents directory without subdirectory to match deployment expectations
+            self.project_dir = project_root / ConfigPaths.CONFIG_DIR / "agents"
         else:
             self.project_dir = project_dir
         self.version_manager = AgentVersionManager()

claude_mpm/services/framework_claude_md_generator/README.md

@@ -0,0 +1,92 @@
+# Framework CLAUDE.md Generator
+
+This directory contains the refactored framework CLAUDE.md generator service, originally a single 1,267-line file.
+
+## Structure
+
+### Core Modules
+
+- **`__init__.py`** (~250 lines) - Main facade class that coordinates all functionality
+- **`version_manager.py`** (~100 lines) - Handles version parsing, incrementing, and comparison
+- **`content_assembler.py`** (~120 lines) - Assembles sections and applies template variables
+- **`content_validator.py`** (~80 lines) - Validates generated content structure and completeness
+- **`deployment_manager.py`** (~80 lines) - Handles deployment to parent directories
+- **`section_manager.py`** (~60 lines) - Manages section registration, ordering, and updates
+
+### Section Generators
+
+The `section_generators/` subdirectory contains individual generators for each section:
+
+- **`__init__.py`** - Base classes and registry
+- **`header.py`** - Header with version metadata
+- **`role_designation.py`** - AI Assistant role designation
+- **`agents.py`** (~570 lines) - Comprehensive agents documentation (largest section)
+- **`todo_task_tools.py`** - Todo and Task Tools integration
+- **`claude_pm_init.py`** - Claude-PM initialization procedures
+- **`orchestration_principles.py`** - Core orchestration principles
+- **`subprocess_validation.py`** - Subprocess validation protocol
+- **`delegation_constraints.py`** - Critical delegation constraints
+- **`environment_config.py`** - Environment configuration
+- **`troubleshooting.py`** - Troubleshooting guide
+- **`core_responsibilities.py`** - Core responsibilities list
+- **`footer.py`** - Footer with metadata
+
+## Usage
+
+The API remains unchanged from the original implementation:
+
+```python
+from claude_pm.services.framework_claude_md_generator import FrameworkClaudeMdGenerator
+
+# Create generator instance
+generator = FrameworkClaudeMdGenerator()
+
+# Generate content
+content = generator.generate(
+    current_content=existing_content,  # Optional: for version auto-increment
+    template_variables={'PLATFORM': 'darwin', 'PYTHON_CMD': 'python3'}
+)
+
+# Deploy to parent directory
+success, message = generator.deploy_to_parent(Path('/parent/dir'))
+
+# Update a section
+generator.update_section('agents', 'Custom agents content')
+
+# Add custom section
+generator.add_custom_section('custom', 'Custom content', after='agents')
+```
+
+## Design Benefits
+
+1. **Modularity**: Each concern is separated into its own module
+2. **Maintainability**: Smaller, focused modules are easier to understand and modify
+3. **Testability**: Individual components can be tested in isolation
+4. **Extensibility**: New section generators can be added easily
+5. **Performance**: Section generators are loaded on demand
+6. **Backward Compatibility**: Original API preserved through facade pattern
+
+## Section Generator Pattern
+
+To add a new section generator:
+
+1. Create a new file in `section_generators/`
+2. Inherit from `BaseSectionGenerator`
+3. Implement the `generate()` method
+4. Register in `section_generators/__init__.py`
+
+Example:
+```python
+from . import BaseSectionGenerator
+
+class CustomSectionGenerator(BaseSectionGenerator):
+    def generate(self, data: Dict[str, Any]) -> str:
+        return "## Custom Section\n\nContent here..."
+```
+
+## Refactoring Summary
+
+- **Original**: 1,267 lines in a single file
+- **Refactored**: ~250 lines in main module + well-organized submodules
+- **Total line reduction**: Main module reduced by 80%
+- **Improved organization**: 13 focused modules instead of 1 large file

claude_mpm/services/framework_claude_md_generator/section_generators/agents.py

@@ -75,8 +75,8 @@ class AgentsGenerator(BaseSectionGenerator):
 **ALL AGENT OPERATIONS FOLLOW HIERARCHICAL PRECEDENCE**
 
 #### Agent Hierarchy (Highest to Lowest Priority)
-1. **Project Agents**: `$PROJECT/.claude-mpm/agents/project-specific/`
-   - Project-specific implementations and overrides
+1. **Project Agents**: `$PROJECT/.claude-mpm/agents/`
+   - Project implementations and overrides
    - Highest precedence for project context
    - Custom agents tailored to project requirements
 
@@ -376,7 +376,7 @@ for agent_id, metadata in agents.items():
 #### Directory Precedence Rules and Agent Discovery
 
 **Enhanced Agent Discovery Pattern (Highest to Lowest Priority):**
-1. **Project Agents**: `$PROJECT/.claude-mpm/agents/project-specific/`
+1. **Project Agents**: `$PROJECT/.claude-mpm/agents/`
 2. **Current Directory User Agents**: `$PWD/.claude-mpm/agents/user-agents/`
 3. **Parent Directory User Agents**: Walk up tree checking `../user-agents/`, `../../user-agents/`, etc.
 4. **User Home Agents**: `~/.claude-mpm/agents/user-defined/`

claude_mpm/services/framework_claude_md_generator/section_generators/claude_pm_init.py

@@ -79,9 +79,9 @@ claude-pm init --verify
    - Working directory context
 
 3. **Project Directory** (`$PROJECT_ROOT/.claude-mpm/`)
-   - Project-specific agents in `agents/project-specific/`
+   - Project agents in `agents/`
    - User agents in `agents/user-agents/` with directory precedence
-   - Project-specific configuration
+   - Project configuration
 
 ### Health Validation and Deployment Procedures
 

claude_mpm/services/version_control/VERSION

@@ -0,0 +1 @@
+0.9.0

{claude_mpm-3.5.4.dist-info → claude_mpm-3.5.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.5.4
+Version: 3.5.6
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -45,6 +45,11 @@ Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Provides-Extra: monitor
+Provides-Extra: agents
+Requires-Dist: packaging>=21.0; extra == "agents"
+Requires-Dist: toml>=0.10.2; extra == "agents"
+Requires-Dist: tree-sitter>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-language-pack>=0.8.0; extra == "agents"
 Dynamic: author-email
 Dynamic: home-page
 Dynamic: license-file
@@ -74,6 +79,12 @@ pip install claude-mpm
 
 # Install with development dependencies
 pip install "claude-mpm[dev]"
+
+# Install with agent dependencies (recommended for full functionality)
+pip install "claude-mpm[agents]"
+
+# Install with all optional dependencies
+pip install "claude-mpm[agents,dev]"
 ```
 
 ## Basic Usage
@@ -107,6 +118,37 @@ claude-mpm agents fix --all --dry-run
 
 For detailed usage, see [QUICKSTART.md](QUICKSTART.md)
 
+### Agent Dependencies
+
+Claude MPM automatically manages Python dependencies required by agents. Agents can declare their dependencies in their configuration files, and the system aggregates them for easy installation.
+
+```bash
+# Install all agent dependencies
+pip install "claude-mpm[agents]"
+
+# View current agent dependencies
+python scripts/aggregate_agent_dependencies.py --dry-run
+
+# Update pyproject.toml with latest agent dependencies
+python scripts/aggregate_agent_dependencies.py
+```
+
+**Agent developers** can declare dependencies in their agent configurations:
+
+```json
+{
+  "agent_id": "my_agent",
+  "dependencies": {
+    "python": ["pandas>=2.0.0", "numpy>=1.24.0"],
+    "system": ["ripgrep", "git"]
+  }
+}
+```
+
+Dependencies are automatically aggregated from all agent sources (PROJECT > USER > SYSTEM) during the build process, with intelligent version conflict resolution taking the highest compatible version.
+
+For comprehensive documentation, see [docs/AGENT_DEPENDENCIES.md](docs/AGENT_DEPENDENCIES.md).
+
 ## Key Capabilities
 
 ### Multi-Agent Orchestration

{claude_mpm-3.5.4.dist-info → claude_mpm-3.5.6.dist-info}/RECORD

@@ -1,13 +1,15 @@
-claude_mpm/VERSION,sha256=ODaoFqJsPS4t5O67abi4Nf3-pVUk3xzTHEdohX9_YN0,6
+claude_mpm/VERSION,sha256=HpVENFe46keiMkGxLn5qWThpphm3cOa0-_-DaFHyo88,6
 claude_mpm/__init__.py,sha256=ix_J0PHZBz37nVBDEYJmLpwnURlWuBKKQ8rK_00TFpk,964
 claude_mpm/__main__.py,sha256=8IcM9tEbTqSN_er04eKTPX3AGo6qzRiTnPI7KfIf7rw,641
 claude_mpm/constants.py,sha256=VZl6jPim-EXryEXCEtXbnG-E7Aka0uGz-Hm_EmbNt5Y,4546
 claude_mpm/deployment_paths.py,sha256=JO7-fhhp_AkVB7ZssggHDBbee-r2sokpkqjoqnQLTmM,9073
-claude_mpm/init.py,sha256=41cjA4FQCzryy7f159opOipd-abIj3RtT3z5WzphETU,9607
+claude_mpm/init.py,sha256=l-PgvEnaUvanH5mGWzncd6lCH2O0u8qDa29pMyWg_8Y,13265
 claude_mpm/ticket_wrapper.py,sha256=bWjLReYyuHSBguuiRm1d52rHYNHqrPJAOLUbMt4CnuM,836
+claude_mpm/.claude-mpm/logs/hooks_20250728.log,sha256=5CAZYZB8sl1mE50SphO3RbdW6E_VVT6YUBCwzN-Y-RI,1244
 claude_mpm/agents/BASE_AGENT_TEMPLATE.md,sha256=TYgSd9jNBMWp4mAOBUl9dconX4RcGbvmMEScRy5uyko,3343
-claude_mpm/agents/INSTRUCTIONS.md,sha256=jCLo-4DPIf2Fh9F6UVEqvP3g1eM2RWxR2hKFpCbRVPI,10847
+claude_mpm/agents/INSTRUCTIONS.md,sha256=CF5BI1wldUAVvdfE4w7s9K0NuU7ckQpiHDEFdCgzeMg,11043
 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=gScerY4D_j1Q5zfwAthi5SLU2mmcfz-IxUSF9L6r68I,58059
 claude_mpm/agents/agent_loader_integration.py,sha256=h07Kmk4D75jmHxz5BucP6oQ5VhqVgQ35Sn5w3hcZNYI,7474
 claude_mpm/agents/agents_metadata.py,sha256=Xju9Yim6XSv2u1J_Swre5VJySbdxxC-9TzpOfXG8ibg,5170
@@ -38,23 +40,26 @@ claude_mpm/agents/templates/backup/qa_agent_20250726_234551.json,sha256=_FHWnUeh
 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/cli/README.md,sha256=BJhHwcwwrxqM0ZCoIJBPvumb32IL1gd-5RcVe2kYQGY,3370
 claude_mpm/cli/__init__.py,sha256=4YB2djriA_a4zVQZDOWBsVTn28jEaF9oFYCZ-fHDwYM,6838
 claude_mpm/cli/__main__.py,sha256=vShalycGU13i1-OOixEb_bjl8da4_FolrKdvoiZB-64,769
 claude_mpm/cli/parser.py,sha256=6jJU_LKKP3xkMEdAlXZ6tIxp_C5SDpK8--4a7Yrnfh8,18975
-claude_mpm/cli/utils.py,sha256=dKE3wvK9nFyYpRdEqS6rUC6ln5VbmhSihoaJTTiSZJI,6005
+claude_mpm/cli/utils.py,sha256=qNIbQcA6iE46lsve-GyoIw6eyd9ksHZz3tQA4bSmtt8,6325
 claude_mpm/cli/commands/__init__.py,sha256=8VGmIJlQuQGWXq49ES35SGjxRkqPpmzP-KvqOLA8IlM,512
-claude_mpm/cli/commands/agents.py,sha256=JGfEqXW_c-ZxpSS7Hw0bBs2WfSNo_yH3fOflzOfW85s,20968
+claude_mpm/cli/commands/agents.py,sha256=fB9BuvlQ2MevXUvCLZgDlSK40hhJc9zpF3hYY7O21ec,21659
 claude_mpm/cli/commands/info.py,sha256=ETL6jC08OTQVTPjs219Y0m3FzfKOUlI0-yI81AI8FXY,2990
 claude_mpm/cli/commands/memory.py,sha256=ymw4EatEKHfvvMHSy6dr4-x9OB7e1nZdJS0EP0f5paI,37350
 claude_mpm/cli/commands/monitor.py,sha256=80_tmSdfn_2cYpzxxPu9GnvFW0eixlSJ4wCqbn8VSCM,12407
-claude_mpm/cli/commands/run.py,sha256=33wq8Nsiknd7gBWW3fwfb_dLEHF_BtqaKo-mcn4AB20,30812
+claude_mpm/cli/commands/run.py,sha256=2XB3gBYth5G-rPaEoW_LBlurrrJ_kDPKnfPjFTObZcc,30388
 claude_mpm/cli/commands/tickets.py,sha256=SXyGtHSyGJwTeJwDAHf7kRbdiG1DlZkXkod5UoNy7Ik,2150
 claude_mpm/cli_module/__init__.py,sha256=CkMp4gzWKoZZF_qKyBDi2sQaZw_GLWZYLtKouv-4f8s,390
 claude_mpm/cli_module/args.py,sha256=nilYpziBsoEySO4W1hQ2MRJyn9TFx3c3TrucyMMhRtk,7970
 claude_mpm/cli_module/commands.py,sha256=CBNfO-bXrZ0spjeW_7-swprEq5V4PQSc0qhl9SLP5UU,7168
 claude_mpm/cli_module/migration_example.py,sha256=C-_GbsW8dGzutnNeRLLld74ibDLyAOQx0stdpYZS0hs,6137
+claude_mpm/cli_module/refactoring_guide.md,sha256=fl1PGwLZAj4OYWmU0syg1jDd81PqK7rC7rhwgFId5BE,7048
 claude_mpm/config/__init__.py,sha256=xte4oPG1ubIKhzne1do7slU6FbGebXin_QmyzGRn8c8,1114
 claude_mpm/config/agent_config.py,sha256=QS-25LSiNz4uOocjIM_FX_SGoRQHJOfkBZCKlz09K5k,13830
+claude_mpm/config/async_logging_config.yaml,sha256=SBnTiykFxPpHU5yV-oFeRPAzTP7ewRbdl7dt3PPADds,3805
 claude_mpm/config/paths.py,sha256=bOxSLNPBDQ3GM4NupY4Z0Jrxykgtw40z92Ytc-LMCuo,9670
 claude_mpm/config/socketio_config.py,sha256=fSzqleM9EzehWg3U_--0y_zVgXZo7Q45JCI_a2xPs1g,9452
 claude_mpm/core/__init__.py,sha256=yEiE03zgfISu6rSaLIUJ5vruNhkYrDHN69YeWRlrEIY,1079
@@ -62,12 +67,12 @@ claude_mpm/core/agent_name_normalizer.py,sha256=-X68oz3_74t9BRbHA54NEGyjy0xjTsGp
 claude_mpm/core/agent_registry.py,sha256=YvEu-ZBc7XBi9KC2ZV8sWbVAuk0iwi38tg2cK45ZWb4,22521
 claude_mpm/core/agent_session_manager.py,sha256=6alXQr4gnMR-unT4J1ryEtTxJqQolA0-NgPQN6X3lqY,11212
 claude_mpm/core/base_service.py,sha256=qWI_rUybHmmKroptJxcE4rzPBhK8yeMKIt2JqnqJB7E,29125
-claude_mpm/core/claude_runner.py,sha256=2A7lUNUE7MGJ98uQPNTi_Tl1-Z6_ad6G_xjMuBXrkgs,70097
+claude_mpm/core/claude_runner.py,sha256=d4r439GgUs4jxSq33IL7VIlwk__Cw9jWbYO42JjYbiI,73351
 claude_mpm/core/config.py,sha256=Yr4bVHq-Ld4_E1QprdEwCvoRXS37xu2UtxzoNePJdJw,20635
 claude_mpm/core/config_aliases.py,sha256=uilRxeIVMY4ZM_I7lnUeR0n4_nmiOpW2jY2_aW4udNA,10105
-claude_mpm/core/config_paths.py,sha256=nV8054MXZtO0WkXwpFMIGiT0uHPRU54I0ciEhsY_hEs,5019
+claude_mpm/core/config_paths.py,sha256=SwoB02p7GVw5pnEasC5wPyjfFZKxCsQvQmepRCpm-Es,4971
 claude_mpm/core/container.py,sha256=P4c4nSo_USSfHTxvpR1sQkVGNsgqozZBN27l3IXqiDc,12216
-claude_mpm/core/factories.py,sha256=Vas0bSrnhHBX7FmogFl3jxgK695wyrJy99qVMmVeGFk,6034
+claude_mpm/core/factories.py,sha256=hdC1BwS8gIYXt7NxoJxas3URIPxkWU8FcRbuy31ctB0,6310
 claude_mpm/core/framework_loader.py,sha256=SdONNh8a7vSicr4vVuRzd7OqgDMIyg9k_xxbr8bLRi8,19547
 claude_mpm/core/hook_manager.py,sha256=pVjVTu54FvpzI4F91VWX-hNStTeQelKCUM3qLjE8MhE,7045
 claude_mpm/core/injectable_service.py,sha256=7fOny9c6x8IJ9hVZmFql1eNDXXB1jcWbsxfTKbMZk74,7497
@@ -80,12 +85,16 @@ claude_mpm/core/service_registry.py,sha256=1DnOOWLoDjQJB49YRlV_Ehf6YP79ilPMtHNpS
 claude_mpm/core/session_manager.py,sha256=D6ZA7bHAgfdkv0nLKjza0FKDng5iqi___IESrb3nSuk,8292
 claude_mpm/core/socketio_pool.py,sha256=B83uDsmqRF5S0QDwwatyKS-m2SdTvotCVfc3_2uQxd8,22438
 claude_mpm/core/tool_access_control.py,sha256=htZbDhC8s7D7BVqfmk0BwRrYJnlnUAk8_NeJKOaeNlg,6632
+claude_mpm/core/.claude-mpm/logs/hooks_20250730.log,sha256=sIDaaPfbtKTAYy6CoS-Tu12J5vRHBmNvXV88HPlP-hI,4210
+claude_mpm/dashboard/README.md,sha256=BuaFPsg9QOvxd_TAw9a5OdgaBDg8OUJ8eeBOpqe6LK8,4050
 claude_mpm/dashboard/index.html,sha256=lXd4WCDn46w9a6edUpGQIy5DtCmiTvDerd1vY97Ule8,451
 claude_mpm/dashboard/open_dashboard.py,sha256=aXUc6LzUMwmTQMkl_h2jjvICimr-ED4FPMHP_9mnrgQ,1108
 claude_mpm/dashboard/test_dashboard.html,sha256=Aakmm9O-pWld_CCXLuUBOJC81Ix9D1avytTN93u0zfc,15090
+claude_mpm/dashboard/.claude-mpm/memories/README.md,sha256=gDuLkzgcELaaoEB5Po70F0qabTu11vBi1PnUrYCK3fw,1098
 claude_mpm/dashboard/static/css/dashboard.css,sha256=z2Z9jLWoPsC71gdQQML9D9Dkr54XnpKhcz4jomCKfdY,49692
 claude_mpm/dashboard/static/js/dashboard-original.js,sha256=MfrEvUbvB-sU67wslVBEYmk2q9d0s2a_u1NWodJNQrc,162374
 claude_mpm/dashboard/static/js/dashboard.js,sha256=vCRjE6HfxQ4VGqe8sML2_8lX0w6qoaZF0AmWjKVldpM,72056
+claude_mpm/dashboard/static/js/dashboard.js.backup,sha256=UNqDPBwzJ1aZAVCxT-FGBY13nF1Q6W2UUUZggNZnOxY,71607
 claude_mpm/dashboard/static/js/socket-client.js,sha256=hjh-HGAlTpaX0Cr6A7DG75TZjujPFcRQSdw7FrysCWQ,18912
 claude_mpm/dashboard/static/js/components/agent-inference.js,sha256=xlH3ka8Ev-WybsMp5wAHTQyJzqpht6n3iksmgGO8nfc,27889
 claude_mpm/dashboard/static/js/components/event-processor.js,sha256=7CsQw1WtKuhV_uj5AaVNMYj6PAAOcT77dxyucBDqs4w,25428
@@ -101,9 +110,13 @@ claude_mpm/dashboard/static/js/components/socket-manager.js,sha256=x0mKU7gIpIkfA
 claude_mpm/dashboard/static/js/components/ui-state-manager.js,sha256=5Ligdos7L_UTWMtCW34Y7BNh7msdd9ArCr-7Yr9-VS8,12979
 claude_mpm/dashboard/static/js/components/working-directory.js,sha256=YGyTP0vCaRc9qR7g2d1INShG0-0_X-xkqCW2IF82eXc,33213
 claude_mpm/dashboard/templates/index.html,sha256=ONVRsfpsqmvQDuz9d3QTaF2zN08YoQM9kU-Bxri4660,14997
+claude_mpm/dashboard/templates/.claude-mpm/memories/README.md,sha256=gDuLkzgcELaaoEB5Po70F0qabTu11vBi1PnUrYCK3fw,1098
+claude_mpm/dashboard/templates/.claude-mpm/memories/engineer_agent.md,sha256=t8WHtbTdnh9lKJPaHPD-3nynA7kMCogaEGER-orO4bs,1150
+claude_mpm/dashboard/templates/.claude-mpm/memories/version_control_agent.md,sha256=tHMYDLOkL06iaiuI0Lt-UK81iJxMaa8APWfgPXc46nw,1091
 claude_mpm/experimental/cli_enhancements.py,sha256=-N5f2u9TaxUcOJegUd3lt1FRz5ErEyYUvvgrNmMRL7Q,11814
 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=wrj5GP0aiPzx0vQrZlE4I1JaQ_JaO_kdQPj7pgfiQKc,3129
 claude_mpm/hooks/__init__.py,sha256=Y3JJ_mEtvRP07r_gXkju4c0s18bjIXGH1uAbhSw1ES0,166
 claude_mpm/hooks/base_hook.py,sha256=a4V2EKEG02QQB0h-pnxhZI-fouKBLYbdBLckcaNuf0k,5098
 claude_mpm/hooks/memory_integration_hook.py,sha256=z0I5R4rsmLx3mzYf7QLeMTYbRShagjS6u3ASyc4XLv0,16311
@@ -114,6 +127,7 @@ claude_mpm/hooks/claude_hooks/hook_handler.py,sha256=jbUf-ccs9B1QRSVsMnUJrNL4ogu
 claude_mpm/hooks/claude_hooks/hook_wrapper.sh,sha256=JBbedWNs1EHaUsAkmqfPv_tWxV_DcRP707hma74oHU0,2370
 claude_mpm/models/__init__.py,sha256=vy2NLX2KT9QeH76SjCYh9dOYKPLRgxGrnwkQFAg08gc,465
 claude_mpm/models/agent_definition.py,sha256=y9XQOED_maOyiYKhNB8H8MfJJMBN0vIYPS_wCXnRJmA,6647
+claude_mpm/schemas/agent_schema.json,sha256=T6yRidCHiRbeXYj1MqZJkepiOfUSN9kwNcU28Zqdi_k,13911
 claude_mpm/scripts/socketio_daemon.py,sha256=93jzq-h5GQRK-xYpLaovaqNAXtwR_ZqYjmEMmFn0xE8,9741
 claude_mpm/services/__init__.py,sha256=6iAzVquVu_hhNN05fdGzOwhyLfWbYkTv-gaCHS_tmoE,4616
 claude_mpm/services/async_session_logger.py,sha256=KhV540ZFu__ry9sDuckSA5MkyNfov8dLCTRZkgMQ62Q,21651
@@ -135,7 +149,7 @@ claude_mpm/services/ticket_manager_di.py,sha256=pIsIGncbboKzBYSRQTO7ZX5MuQzV6iFf
 claude_mpm/services/ticketing_service_original.py,sha256=_GbPCPuIAlfxQGfmHN-LQ6sjuDk00eNdY7rlS4qhjI4,16745
 claude_mpm/services/agents/__init__.py,sha256=F5yJSTruNz0qiI2--oJIBO5-LoGQ6wXHvbt1sk-eVLU,2224
 claude_mpm/services/agents/deployment/__init__.py,sha256=PhQQ108KP9RoxLLh_8aoPIjmwJau3az_10cEoPDm7DQ,538
-claude_mpm/services/agents/deployment/agent_deployment.py,sha256=e1KhTKJeke8f0NuSBW6v-piMRKpVlc9xhh1Y66Gd2cM,85801
+claude_mpm/services/agents/deployment/agent_deployment.py,sha256=ITrSLALasj_vVxSoHkoqGXxrlnYEl7ITQ1rNpf1V05k,94343
 claude_mpm/services/agents/deployment/agent_lifecycle_manager.py,sha256=b7guIDwEiJNRWtaRx1PwusqZX5QCnXqq-tl5AQOFp7Y,50136
 claude_mpm/services/agents/deployment/agent_versioning.py,sha256=y4SiKGKdTn-9_Ht6nGlmKGJW6MLgEHZUy5SR1OPTZZM,1108
 claude_mpm/services/agents/loading/__init__.py,sha256=NN4JGAH7nsoY7qTW-jIBKOJPpLJVcD4P6S2Vmdd7QH8,305
@@ -144,7 +158,7 @@ claude_mpm/services/agents/loading/base_agent_manager.py,sha256=y_MKtqReD5h70BpC
 claude_mpm/services/agents/loading/framework_agent_loader.py,sha256=fyP54zrNxv-Xe8hRMInTnltaMtFgmRuCfMbaArPlkmc,17560
 claude_mpm/services/agents/management/__init__.py,sha256=ZZm0jEdso59S72fw4O8jnU1iGWfDN68nWdXe9APvi8U,233
 claude_mpm/services/agents/management/agent_capabilities_generator.py,sha256=hWG0zV2InmzrDMxSbQzjVBBTzEaxg0bFxl8tmTMJ8qA,6565
-claude_mpm/services/agents/management/agent_management_service.py,sha256=Ka0K71bW9UquhnL-orkUdVGspRqS2W_gE-NnKya3wMs,22978
+claude_mpm/services/agents/management/agent_management_service.py,sha256=OKU6dxxR1x53I9eimlJPMUDV9Hbc-Urw5gerCvM1nEk,23053
 claude_mpm/services/agents/memory/__init__.py,sha256=IzY-iU93_v9HBCHZ0UaSYkdLWXobFRLcjdJXd6iAuFY,455
 claude_mpm/services/agents/memory/agent_memory_manager.py,sha256=8JIcNEdmofEiWyVqX3SG5s--hQVAcVRj142YB9asvjU,58846
 claude_mpm/services/agents/memory/agent_persistence_service.py,sha256=B_Vz43zCKWq47zWkoibcia-Qwn2y3gARu7MV5Cpiptc,2893
@@ -152,6 +166,7 @@ claude_mpm/services/agents/registry/__init__.py,sha256=_NsxGhhykoj0NecfA4o8Xscrv
 claude_mpm/services/agents/registry/agent_registry.py,sha256=jb-hIDGAoLWqBauS49N5Iin-nSozspGgUtb-gAROCfc,31570
 claude_mpm/services/agents/registry/deployed_agent_discovery.py,sha256=EFsrutLB3Kxa5TXoQC2aVNx5cMIAaDcTqCBnF1FfrPc,9762
 claude_mpm/services/agents/registry/modification_tracker.py,sha256=efkl652bAHhxUc6keoE2dOxlaQXtDnC3lkmR_jat4u4,34565
+claude_mpm/services/framework_claude_md_generator/README.md,sha256=_-ty72t2afPagDVVUEizPkhs4BYkCeqCnZDNPgZAYtY,3511
 claude_mpm/services/framework_claude_md_generator/__init__.py,sha256=OtnwxLiJektfFtsKdkHM1X27rKkFiNd_rcf4843ziKw,7334
 claude_mpm/services/framework_claude_md_generator/content_assembler.py,sha256=DNMVz6Jvy7bxxa8WNL2h-JwrK89bJpuxXEI5xD1i8mY,6570
 claude_mpm/services/framework_claude_md_generator/content_validator.py,sha256=89QSGil9_NL15ci3HsVVQmfg7MZvsJS3i_ELP5yD-gA,4583
@@ -159,8 +174,8 @@ claude_mpm/services/framework_claude_md_generator/deployment_manager.py,sha256=G
 claude_mpm/services/framework_claude_md_generator/section_manager.py,sha256=KbipmnUg7FD3YnVdUj4Ttrm3HMmWrDnjWC6fKX5D3tI,3222
 claude_mpm/services/framework_claude_md_generator/version_manager.py,sha256=VpJMieGEVkkKC6vyhHxKcUjPNzxBuPwD61lTyPJwxXM,4284
 claude_mpm/services/framework_claude_md_generator/section_generators/__init__.py,sha256=HIIW34LgzTJk_ne4qoNxXgYZp3EhEisJR0SjfNjPG7o,3486
-claude_mpm/services/framework_claude_md_generator/section_generators/agents.py,sha256=PjLmAlk15cVXFzqvy8m-qdP6buIchdh3wRMBnDmZ7Cg,23244
-claude_mpm/services/framework_claude_md_generator/section_generators/claude_pm_init.py,sha256=t3AAKSsVhL_jHhNWzV7UUngt_lU-azhu6nYzhgnQ65g,2924
+claude_mpm/services/framework_claude_md_generator/section_generators/agents.py,sha256=b4pTJQKGt4BmqZmFGa8cKlgy03JJekmIZi_rIsCStaE,23201
+claude_mpm/services/framework_claude_md_generator/section_generators/claude_pm_init.py,sha256=oZ-QNeF6iAC13T1yCGhD9ROogfoJKPYq2Rn4ld6cgPY,2889
 claude_mpm/services/framework_claude_md_generator/section_generators/core_responsibilities.py,sha256=B52TWCQ2Uic9cOke8FftpzfJQ8MbbOLyn92QN8g83qA,1823
 claude_mpm/services/framework_claude_md_generator/section_generators/delegation_constraints.py,sha256=WGw1cFvopLHK4Xz8l1qqlNDmUMKNdMr1_88DNJ0oKSk,995
 claude_mpm/services/framework_claude_md_generator/section_generators/environment_config.py,sha256=MUoO0jKnxWA1WC3JP-jJCVz2cgCM-EwUPnMN7cmNdBQ,629
@@ -178,6 +193,7 @@ claude_mpm/services/memory/router.py,sha256=ECQQ1v0BsMFQ4RXqpKfc9fwAXpzx5Kk0QlmJ
 claude_mpm/services/memory/cache/__init__.py,sha256=FBff6fkrJWuWbQjQ4MoOxQa6ybRVBeH29hQC2XP0DEU,350
 claude_mpm/services/memory/cache/shared_prompt_cache.py,sha256=bw1FDXM6iMuVfFxx_RNlIFZfiGC10p18Npwk-IGFCJ0,29899
 claude_mpm/services/memory/cache/simple_cache.py,sha256=eVJq7mD4fn-EfRaLgKJxP65rqQrup-AqB-Cf7EFYy58,10480
+claude_mpm/services/version_control/VERSION,sha256=MMmeixA-rL5vbW4bVLBsptXzFktPUAlDNKUXrpXKj7o,5
 claude_mpm/services/version_control/__init__.py,sha256=5BFbqFUMtpCyDbMcekRjCQ4jgBAJI50PhfuZ8S5NTjk,1513
 claude_mpm/services/version_control/branch_strategy.py,sha256=xOLeNcu0AtpgIRmNkew-fNvXVcGHRuAe6MqOyyS36HQ,23068
 claude_mpm/services/version_control/conflict_resolution.py,sha256=yWa9fzmkds1U0EBw-LyTZvlj56MpEEsRmryLQg4KDdU,26084
@@ -195,9 +211,9 @@ claude_mpm/utils/paths.py,sha256=DlkYrIVvfgyuF9cN01cWuxehK0UUsCfjp6ymrv8XY7A,102
 claude_mpm/utils/session_logging.py,sha256=9G0AzB7V0WkhLQlN0ocqbyDv0ifooEsJ5UPXIhA-wt0,3022
 claude_mpm/validation/__init__.py,sha256=bJ19g9lnk7yIjtxzN8XPegp87HTFBzCrGQOpFgRTf3g,155
 claude_mpm/validation/agent_validator.py,sha256=Jy7Oi7GVM7jqFYLVFDQ9pKYXsXH2KEf5uorflIwWGC4,20348
-claude_mpm-3.5.4.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
-claude_mpm-3.5.4.dist-info/METADATA,sha256=_Usy3KtLBevJwBs3tMAq4RZr3fO5iiXhymMfX6XHd9I,7683
-claude_mpm-3.5.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-3.5.4.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
-claude_mpm-3.5.4.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-3.5.4.dist-info/RECORD,,
+claude_mpm-3.5.6.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
+claude_mpm-3.5.6.dist-info/METADATA,sha256=DOr2AUi_jx6A_XFlAOMThF_b7XEKvpX3pEVRib3q8UI,9128
+claude_mpm-3.5.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-3.5.6.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
+claude_mpm-3.5.6.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-3.5.6.dist-info/RECORD,,