claude-mpm 3.4.10__py3-none-any.whl → 5.4.55__py3-none-any.whl

claude_mpm/services/framework_claude_md_generator/section_generators/agents.py

@@ -5,13 +5,14 @@ This is the largest section generator, containing all agent definitions,
 hierarchy, delegation patterns, and registry integration documentation.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class AgentsGenerator(BaseSectionGenerator):
     """Generates the comprehensive Agents section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the agents section."""
         return """
@@ -75,15 +76,15 @@ class AgentsGenerator(BaseSectionGenerator):
 **ALL AGENT OPERATIONS FOLLOW HIERARCHICAL PRECEDENCE**
 
 #### Agent Hierarchy (Highest to Lowest Priority)
-1. **Project Agents**: `$PROJECT/.claude-pm/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
 
 2. **User Agents**: Directory hierarchy with precedence walking
-   - **Current Directory**: `$PWD/.claude-pm/agents/user-agents/` (highest user precedence)
+   - **Current Directory**: `$PWD/.claude-mpm/agents/user-agents/` (highest user precedence)
    - **Parent Directories**: Walk up tree checking `../user-agents/`, `../../user-agents/`, etc.
-   - **User Home**: `~/.claude-pm/agents/user-defined/` (fallback user location)
+   - **User Home**: `~/.claude-mpm/agents/user-defined/` (fallback user location)
    - User-specific customizations across projects
    - Mid-priority, can override system defaults
 
@@ -251,14 +252,14 @@ TEMPORAL CONTEXT: Today is [current date]. Apply date awareness to:
 **Dynamic Agent Selection Pattern:**
 ```python
 # Enhanced delegation with registry discovery
-registry = AgentRegistry()
+registry = get_agent_registry()
 
 # Task-specific agent discovery
 task_type = "performance_optimization"
 required_specializations = ["performance", "monitoring"]
 
 # Discover optimal agent
-all_agents = registry.listAgents()
+all_agents = registry.list_agents()
 # Filter by specializations
 optimal_agents = {k: v for k, v in all_agents.items()
                   if any(spec in v.get('specializations', [])
@@ -352,17 +353,17 @@ TEMPORAL CONTEXT: Today is [date]. Apply date awareness to data operations.
 
 **CRITICAL: Agent Registry provides dynamic agent discovery beyond core 9 agent types**
 
-#### AgentRegistry.listAgents() Method Usage
+#### AgentRegistry.list_agents() Method Usage
 
 **Comprehensive Agent Discovery API:**
 ```python
-from claude_pm.core.agent_registry import AgentRegistry
+from claude_mpm.core.agent_registry import AgentRegistry
 
 # Initialize registry with directory precedence
-registry = AgentRegistry()
+registry = get_agent_registry()
 
 # List all available agents with metadata
-agents = registry.listAgents()
+agents = registry.list_agents()
 
 # Access agent metadata
 for agent_id, metadata in agents.items():
@@ -376,15 +377,15 @@ 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-pm/agents/project-specific/`
-2. **Current Directory User Agents**: `$PWD/.claude-pm/agents/user-agents/`
+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-pm/agents/user-defined/`
+4. **User Home Agents**: `~/.claude-mpm/agents/user-defined/`
 5. **System Agents**: `claude_pm/agents/`
 
 **User-Agents Directory Structure:**
 ```
-$PWD/.claude-pm/agents/user-agents/
+$PWD/.claude-mpm/agents/user-agents/
 ├── specialized/
 │   ├── performance-agent.md
 │   ├── architecture-agent.md
@@ -400,10 +401,10 @@ $PWD/.claude-pm/agents/user-agents/
 **Discovery Implementation:**
 ```python
 # Orchestrator pattern for agent discovery
-registry = AgentRegistry()
+registry = get_agent_registry()
 
 # Discover all agents
-all_agents = registry.listAgents()
+all_agents = registry.list_agents()
 
 # Filter by tier if needed
 project_agents = {k: v for k, v in all_agents.items() if v.get('tier') == 'project'}
@@ -420,7 +421,7 @@ system_agents = {k: v for k, v in all_agents.items() if v.get('tier') == 'system
 **Specialized Discovery Usage:**
 ```python
 # Discover agents by type (note: specialization filtering would require custom filtering)
-all_agents = registry.listAgents()
+all_agents = registry.list_agents()
 
 # Filter by specialization manually
 ui_agents = {k: v for k, v in all_agents.items() if 'ui_ux' in v.get('specializations', [])}
@@ -428,7 +429,7 @@ performance_agents = {k: v for k, v in all_agents.items() if 'performance' in v.
 architecture_agents = {k: v for k, v in all_agents.items() if 'architecture' in v.get('specializations', [])}
 
 # Multi-specialization discovery
-multi_spec = {k: v for k, v in all_agents.items() 
+multi_spec = {k: v for k, v in all_agents.items()
               if any(spec in v.get('specializations', []) for spec in ['integration', 'performance'])}
 ```
 
@@ -437,13 +438,13 @@ multi_spec = {k: v for k, v in all_agents.items()
 **Orchestrator Workflow with Modification Tracking:**
 ```python
 # Track agent changes for workflow optimization
-registry = AgentRegistry()
+registry = get_agent_registry()
 
 # Get all agents (modification timestamps are included by default)
-agents_with_tracking = registry.listAgents()
+agents_with_tracking = registry.list_agents()
 
 # Filter agents modified since last orchestration manually
-recent_agents = {k: v for k, v in agents_with_tracking.items() 
+recent_agents = {k: v for k, v in agents_with_tracking.items()
                  if v.get('last_modified', 0) > since_timestamp}
 
 # Update orchestration based on agent modifications
@@ -457,14 +458,14 @@ for agent_id, metadata in recent_agents.items():
 
 **99.7% Performance Improvement Integration:**
 ```python
-from claude_pm.services.shared_prompt_cache import SharedPromptCache
+from claude_mpm.services.shared_prompt_cache import SharedPromptCache
 
 # Initialize registry with caching
 cache = SharedPromptCache()
 registry = AgentRegistry(prompt_cache=cache)
 
 # Agent discovery (caching is automatic)
-cached_agents = registry.listAgents()
+cached_agents = registry.list_agents()
 
 # Cache optimization for repeated orchestration
 cache.preload_agent_prompts(agent_ids=['documentation', 'qa', 'engineer'])
@@ -483,18 +484,18 @@ for agent_id in ['researcher', 'security', 'ops']:
 ```python
 # Example: Dynamic agent selection based on task requirements
 def select_optimal_agent(task_type, specialization_requirements):
-    registry = AgentRegistry()
-    
+    registry = get_agent_registry()
+
     # Find agents matching requirements
-    all_agents = registry.listAgents()
-    matching_agents = {k: v for k, v in all_agents.items() 
-                       if any(spec in v.get('specializations', []) 
+    all_agents = registry.list_agents()
+    matching_agents = {k: v for k, v in all_agents.items()
+                       if any(spec in v.get('specializations', [])
                              for spec in specialization_requirements)}
-    
+
     # Select highest precedence agent
     if matching_agents:
         return registry.selectOptimalAgent(matching_agents, task_type)
-    
+
     # Fallback to core agents
     return registry.getCoreAgent(task_type)
 
@@ -517,7 +518,7 @@ optimal_agent = select_optimal_agent(
 
 TEMPORAL CONTEXT: Today is [date]. Using agent registry for optimal agent selection.
 
-**Agent Discovery**: 
+**Agent Discovery**:
 - Registry scan: Find agents with specialization {required_spec}
 - Selected agent: {optimal_agent_id} (precedence: {agent_precedence})
 - Capabilities: {agent_metadata['specializations']}
@@ -541,7 +542,7 @@ TEMPORAL CONTEXT: Today is [date]. Using agent registry for optimal agent select
 
 **Enhanced Orchestration with Dynamic Discovery:**
 
-1. **Dynamic Agent Selection**: Use AgentRegistry.listAgents() to select optimal agents based on task requirements and available specializations
+1. **Dynamic Agent Selection**: Use AgentRegistry.list_agents() to select optimal agents based on task requirements and available specializations
 
 2. **Precedence-Aware Delegation**: Respect directory precedence when multiple agents of same type exist
 
@@ -559,18 +560,18 @@ TEMPORAL CONTEXT: Today is [date]. Using agent registry for optimal agent select
 ```python
 # Enhanced orchestration with registry integration
 def orchestrate_with_registry(task_description, requirements):
-    registry = AgentRegistry()
-    
+    registry = get_agent_registry()
+
     # Discover optimal agents
-    all_agents = registry.listAgents()
+    all_agents = registry.list_agents()
     # Filter by requirements
     agents = {k: v for k, v in all_agents.items()
               if any(spec in v.get('specializations', [])
                     for spec in requirements.get('specializations', []))}
-    
+
     # Create Task Tool subprocess with optimal agent
     selected_agent = registry.selectOptimalAgent(agents, task_description)
-    
+
     return create_task_tool_subprocess(
         agent=selected_agent,
         task=task_description,
@@ -579,4 +580,4 @@ def orchestrate_with_registry(task_description, requirements):
     )
 ```
 
----"""
+---"""

claude_mpm/services/framework_claude_md_generator/section_generators/claude_pm_init.py

@@ -2,13 +2,14 @@
 Claude-PM Init section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class ClaudePmInitGenerator(BaseSectionGenerator):
     """Generates the Claude-PM Init section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the claude-pm init section."""
         return """
@@ -43,22 +44,22 @@ claude-pm init --verify
 
 3. **MANDATORY: Core System Health Check**:
    ```bash
-   python -c "from claude_pm.core import validate_core_system; validate_core_system()"
+   python -c "from claude_mpm.core import validate_core_system; validate_core_system()"
    ```
 
 4. **MANDATORY: Agent Registry Health Check**:
    ```bash
-   python -c "from claude_pm.core.agent_registry import AgentRegistry; registry = AgentRegistry(); print(f'Registry health: {registry.health_check()}')"
+   python -c "from claude_mpm.core.agent_registry import AgentRegistry; registry = get_agent_registry(); print(f'Registry health: {registry.health_check()}')"
    ```
 
 5. **MANDATORY: Initialize Core Agents with Registry Discovery**:
    ```
    Agent Registry: Discover available agents and build capability mapping across all directories
-   
+
    Documentation Agent: Scan project documentation patterns and build operational understanding.
-   
+
    Version Control Agent: Confirm availability and provide Git status summary.
-   
+
    Data Engineer Agent: Verify data store connectivity and AI API availability.
    ```
 
@@ -70,28 +71,27 @@ claude-pm init --verify
 
 **Multi-Project Orchestrator Pattern:**
 
-1. **Framework Directory** (`/Users/masa/Projects/claude-multiagent-pm/.claude-pm/`)
+1. **Framework Directory** (`/Users/masa/Projects/claude-multiagent-pm/.claude-mpm/`)
    - Global user agents (shared across all projects)
    - Framework-level configuration
 
-2. **Working Directory** (`$PWD/.claude-pm/`)
+2. **Working Directory** (`$PWD/.claude-mpm/`)
    - Current session configuration
    - Working directory context
 
-3. **Project Directory** (`$PROJECT_ROOT/.claude-pm/`)
-   - Project-specific agents in `agents/project-specific/`
+3. **Project Directory** (`$PROJECT_ROOT/.claude-mpm/`)
+   - Project agents in `agents/`
    - User agents in `agents/user-agents/` with directory precedence
-   - Project-specific configuration
+   - Project configuration
 
 ### Health Validation and Deployment Procedures
 
 **Framework Health Monitoring:**
 ```bash
 # Check framework protection status
-python -c "from claude_pm.services.health_monitor import HealthMonitor; HealthMonitor().check_framework_health()"
+python -c "from claude_mpm.services.health_monitor import HealthMonitor; HealthMonitor().check_framework_health()"
 
 # Validate agent hierarchy
 claude-pm init --verify
 
-
----"""
+---"""

claude_mpm/services/framework_claude_md_generator/section_generators/core_responsibilities.py

@@ -2,13 +2,14 @@
 Core responsibilities section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class CoreResponsibilitiesGenerator(BaseSectionGenerator):
     """Generates the Core Responsibilities section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the core responsibilities section."""
         return """
@@ -16,7 +17,7 @@ class CoreResponsibilitiesGenerator(BaseSectionGenerator):
 1. **Framework Initialization**: MANDATORY claude-pm init verification and three-tier agent hierarchy setup
 2. **Date Awareness**: Always acknowledge current date at session start and maintain temporal context
 3. **Core System Validation**: Verify core system health and ensure operational stability
-4. **Agent Registry Integration**: Use AgentRegistry.listAgents() for dynamic agent discovery and optimal task delegation
+4. **Agent Registry Integration**: Use AgentRegistry.list_agents() for dynamic agent discovery and optimal task delegation
 5. **Core Agent Orchestration**: MANDATORY collaboration with all 9 core agent types (Documentation, Ticketing, Version Control, QA, Research, Ops, Security, Engineer, Data Engineer) via Task Tool
 6. **Specialized Agent Discovery**: Leverage agent registry for 35+ specialized agent types beyond core 9
 7. **Multi-Agent Coordination**: Coordinate agents using three-tier hierarchy via Task Tool with registry-enhanced selection
@@ -24,4 +25,4 @@ class CoreResponsibilitiesGenerator(BaseSectionGenerator):
 9. **Precedence-Aware Delegation**: Respect directory precedence (project → user → system) when selecting agents
 10. **Temporal Context Integration**: Apply current date awareness to sprint planning, release scheduling, and priority assessment
 11. **Operation Tracking**: Ensure ALL agents provide operational insights and project patterns
-12. **Agent Modification Tracking**: Monitor agent changes and adapt orchestration patterns accordingly"""
+12. **Agent Modification Tracking**: Monitor agent changes and adapt orchestration patterns accordingly"""

claude_mpm/services/framework_claude_md_generator/section_generators/delegation_constraints.py

@@ -2,13 +2,14 @@
 Delegation constraints section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class DelegationConstraintsGenerator(BaseSectionGenerator):
     """Generates the Critical Delegation Constraints section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the delegation constraints section."""
         return """
@@ -20,4 +21,4 @@ class DelegationConstraintsGenerator(BaseSectionGenerator):
 - **Configuration**: NEVER modify config files - delegate to Ops Agent
 - **Testing**: NEVER write tests - delegate to QA Agent
 - **Documentation Operations**: ALL documentation tasks must be delegated to Documentation Agent
-- **Ticket Operations**: ALL ticket operations must be delegated to Ticketing Agent"""
+- **Ticket Operations**: ALL ticket operations must be delegated to Ticketing Agent"""

claude_mpm/services/framework_claude_md_generator/section_generators/environment_config.py

@@ -2,13 +2,14 @@
 Environment configuration section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class EnvironmentConfigGenerator(BaseSectionGenerator):
     """Generates the Environment Configuration section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the environment configuration section."""
         return """
@@ -20,4 +21,4 @@ class EnvironmentConfigGenerator(BaseSectionGenerator):
 - **Framework Import**: `import claude_pm`
 
 ### Platform-Specific Notes
-{{PLATFORM_NOTES}}"""
+{{PLATFORM_NOTES}}"""

claude_mpm/services/framework_claude_md_generator/section_generators/footer.py

@@ -2,19 +2,20 @@
 Footer section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class FooterGenerator(BaseSectionGenerator):
     """Generates the footer section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the footer section."""
-        deployment_id = data.get('deployment_id', '{{DEPLOYMENT_ID}}')
+        deployment_id = data.get("deployment_id", "{{DEPLOYMENT_ID}}")
         timestamp = self.get_timestamp()
-        
+
         return f"""
 **Framework Version**: {self.framework_version}
 **Deployment ID**: {deployment_id}
-**Last Updated**: {timestamp}"""
+**Last Updated**: {timestamp}"""

claude_mpm/services/framework_claude_md_generator/section_generators/header.py

@@ -2,25 +2,26 @@
 Header section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class HeaderGenerator(BaseSectionGenerator):
     """Generates the header section with version metadata."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the header section."""
-        version = data.get('version', f"{self.framework_version}-001")
+        version = data.get("version", f"{self.framework_version}-001")
         timestamp = self.get_timestamp()
-        content_hash = data.get('content_hash', 'pending')
-        
+        content_hash = data.get("content_hash", "pending")
+
         return f"""# Claude PM Framework Configuration - Deployment
 
-<!-- 
+<!--
 CLAUDE_MD_VERSION: {version}
 FRAMEWORK_VERSION: {self.framework_version}
 DEPLOYMENT_DATE: {timestamp}
 LAST_UPDATED: {timestamp}
 CONTENT_HASH: {content_hash}
--->"""
+-->"""

claude_mpm/services/framework_claude_md_generator/section_generators/orchestration_principles.py

@@ -2,13 +2,14 @@
 Orchestration principles section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class OrchestrationPrinciplesGenerator(BaseSectionGenerator):
     """Generates the Core Orchestration Principles section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the orchestration principles section."""
         return """
@@ -22,9 +23,9 @@ class OrchestrationPrinciplesGenerator(BaseSectionGenerator):
 6. **Cross-Agent Coordination**: Orchestrate workflows that span multiple agents with proper sequencing
 7. **TodoWrite Integration**: Use TodoWrite to track and coordinate complex multi-agent workflows
 8. **Operation Tracking**: Systematic capture of operational insights and project patterns
-9. **Agent Registry Integration**: Use AgentRegistry.listAgents() for dynamic agent discovery and optimal task delegation
+9. **Agent Registry Integration**: Use AgentRegistry.list_agents() for dynamic agent discovery and optimal task delegation
 10. **Precedence-Aware Orchestration**: Respect directory precedence (project → user → system) when selecting agents
 11. **Performance-Optimized Delegation**: Leverage SharedPromptCache for 99.7% faster agent loading and orchestration
 12. **Specialization-Based Routing**: Route tasks to agents with appropriate specializations beyond core 9 types using registry discovery
 
----"""
+---"""

claude_mpm/services/framework_claude_md_generator/section_generators/role_designation.py

@@ -2,17 +2,18 @@
 Role designation section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class RoleDesignationGenerator(BaseSectionGenerator):
     """Generates the AI Assistant Role Designation section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the role designation section."""
-        deployment_date = data.get('deployment_date', self.get_timestamp())
-        
+        deployment_date = data.get("deployment_date", self.get_timestamp())
+
         return f"""
 ## 🤖 AI ASSISTANT ROLE DESIGNATION
 
@@ -34,4 +35,4 @@ Your primary role is operating as a multi-agent orchestrator. Your job is to orc
 - **Core System**: 🔧 Framework orchestration and agent coordination
 - **Performance**: ⚡ <15 second health monitoring (77% improvement)
 
----"""
+---"""

claude_mpm/services/framework_claude_md_generator/section_generators/subprocess_validation.py

@@ -2,13 +2,14 @@
 Subprocess validation section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class SubprocessValidationGenerator(BaseSectionGenerator):
     """Generates the Subprocess Validation Protocol section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the subprocess validation section."""
         return """
@@ -35,13 +36,13 @@ class SubprocessValidationGenerator(BaseSectionGenerator):
    # MANDATORY: Test actual CLI commands, not just code existence
    claude-pm --version    # Verify actual version numbers
    claude-pm init         # Test real initialization
-   python3 -c "import claude_pm; print(claude_pm.__version__)"  # Verify imports
+   python3 -c "import claude_mpm; print(claude_mpm.__version__)"  # Verify imports
    ```
 
 2. **🚨 REAL IMPORT VALIDATION** - NEVER trust subprocess claims about imports:
    ```bash
    # MANDATORY: Test actual imports that will be used
-   python3 -c "from claude_pm.services.core import unified_core_service"
+   python3 -c "from claude_mpm.services.core import unified_core_service"
    python3 -c "import asyncio; asyncio.run(test_function())"
    ```
 
@@ -96,16 +97,16 @@ claude-pm --version
 claude-pm --help
 
 # Test actual imports
-python3 -c "import claude_pm; print('✅ Basic import works')"
-python3 -c "from claude_pm.services.core import [specific_function]; print('✅ Specific import works')"
+python3 -c "import claude_mpm; print('✅ Basic import works')"
+python3 -c "from claude_mpm.services.core import [specific_function]; print('✅ Specific import works')"
 
 # Test version consistency
 echo "📋 VERSION VERIFICATION:"
 echo "Package.json: $(grep '"version"' package.json)"
 echo "CLI Output: $(claude-pm --version 2>/dev/null || echo 'CLI FAILED')"
-echo "Python Module: $(python3 -c 'import claude_pm; print(claude_pm.__version__)' 2>/dev/null || echo 'IMPORT FAILED')"
+echo "Python Module: $(python3 -c 'import claude_mpm; print(claude_mpm.__version__)' 2>/dev/null || echo 'IMPORT FAILED')"
 
 # If ANY of the above fail, IMMEDIATELY inform user and fix issues
 ```
 
----"""
+---"""