claude-mpm 3.9.11__py3-none-any.whl → 4.0.3__py3-none-any.whl

claude_mpm/services/framework_claude_md_generator/section_generators/agents.py

@@ -1,3 +1,5 @@
+from pathlib import Path
+
 """
 Agents section generator for framework CLAUDE.md.
 
@@ -5,13 +7,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 """
@@ -251,7 +254,7 @@ 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"
@@ -356,10 +359,10 @@ TEMPORAL CONTEXT: Today is [date]. Apply date awareness to data operations.
 
 **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.list_agents()
@@ -400,7 +403,7 @@ $PWD/.claude-mpm/agents/user-agents/
 **Discovery Implementation:**
 ```python
 # Orchestrator pattern for agent discovery
-registry = AgentRegistry()
+registry = get_agent_registry()
 
 # Discover all agents
 all_agents = registry.list_agents()
@@ -428,7 +431,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 +440,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.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,7 +460,7 @@ 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()
@@ -483,18 +486,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.list_agents()
-    matching_agents = {k: v for k, v in all_agents.items() 
-                       if any(spec in v.get('specializations', []) 
+    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 +520,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']}
@@ -559,18 +562,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.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 +582,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.
    ```
 
@@ -88,10 +89,9 @@ claude-pm init --verify
 **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 """
@@ -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 """
@@ -27,4 +28,4 @@ class OrchestrationPrinciplesGenerator(BaseSectionGenerator):
 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
 ```
 
----"""
+---"""

claude_mpm/services/framework_claude_md_generator/section_generators/todo_task_tools.py

@@ -2,13 +2,14 @@
 Todo and Task Tools section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class TodoTaskToolsGenerator(BaseSectionGenerator):
     """Generates the Todo and Task Tools section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the todo and task tools section."""
         return """
@@ -107,4 +108,4 @@ Task(description="Apply semantic version bump and create release tags", subagent
 # Update TodoWrite status based on agent completions
 ```
 
----"""
+---"""

claude_mpm/services/framework_claude_md_generator/section_generators/troubleshooting.py

@@ -2,13 +2,14 @@
 Troubleshooting section generator for framework CLAUDE.md.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from . import BaseSectionGenerator
 
 
 class TroubleshootingGenerator(BaseSectionGenerator):
     """Generates the Troubleshooting section."""
-    
+
     def generate(self, data: Dict[str, Any]) -> str:
         """Generate the troubleshooting section."""
         return """
@@ -30,10 +31,10 @@ class TroubleshootingGenerator(BaseSectionGenerator):
 9. **Core System Performance Issues**: Implement system optimization
 
 ### Agent Registry Issues
-10. **Agent Registry Discovery Failures**: Run `python -c "from claude_pm.core.agent_registry import AgentRegistry; AgentRegistry().health_check()"`
+10. **Agent Registry Discovery Failures**: Run `python -c "from claude_mpm.core.agent_registry import AgentRegistry; get_agent_registry().health_check()"`
 11. **Agent Precedence Problems**: Verify directory structure with `claude-pm init --verify`
 12. **Specialization Discovery Issues**: Check agent metadata and specialization tags
 13. **Performance Cache Problems**: Clear SharedPromptCache and reinitialize registry
 14. **Agent Modification Tracking Errors**: Verify agent file permissions and timestamps
 15. **Custom Agent Loading Issues**: Verify user-agents directory structure and agent file format
-16. **Directory Precedence Problems**: Check user-agents directory hierarchy and parent directory traversal"""
+16. **Directory Precedence Problems**: Check user-agents directory hierarchy and parent directory traversal"""

claude_mpm/services/framework_claude_md_generator/section_manager.py

@@ -4,63 +4,64 @@ Section management for framework CLAUDE.md templates.
 Manages section registration, ordering, and updates.
 """
 
-from typing import Dict, List, Optional, Callable, Any
 from collections import OrderedDict
+from typing import Any, Callable, Dict, List, Optional
 
 
 class SectionManager:
     """Manages sections for framework CLAUDE.md generation."""
-    
+
     def __init__(self):
         """Initialize section manager."""
         self.sections = OrderedDict()
-    
-    def register_section(self, 
-                        name: str, 
-                        generator: Callable[[Dict[str, Any]], str],
-                        data: Optional[Dict[str, Any]] = None):
+
+    def register_section(
+        self,
+        name: str,
+        generator: Callable[[Dict[str, Any]], str],
+        data: Optional[Dict[str, Any]] = None,
+    ):
         """
         Register a section generator.
-        
+
         Args:
             name: Section name
             generator: Function that generates section content
             data: Optional data to pass to generator
         """
         self.sections[name] = (generator, data or {})
-    
+
     def update_section(self, section_name: str, content: str) -> bool:
         """
         Update a specific section's generator to return custom content.
-        
+
         Args:
             section_name: Name of section to update
             content: New content for the section
-            
+
         Returns:
             bool: Success status
         """
         if section_name not in self.sections:
             return False
-        
+
         # Create a lambda that returns the custom content
         self.sections[section_name] = (lambda data: content, {})
         return True
-    
-    def add_custom_section(self, 
-                          section_name: str, 
-                          content: str, 
-                          after: Optional[str] = None):
+
+    def add_custom_section(
+        self, section_name: str, content: str, after: Optional[str] = None
+    ):
         """
         Add a custom section to the generator.
-        
+
         Args:
             section_name: Name for the new section
             content: Content for the section
             after: Section name to insert after (None = append at end)
         """
         new_section = (lambda data: content, {})
-        
+
         if after is None or after not in self.sections:
             self.sections[section_name] = new_section
         else:
@@ -71,36 +72,36 @@ class SectionManager:
                 if key == after:
                     new_sections[section_name] = new_section
             self.sections = new_sections
-    
+
     def get_section_list(self) -> List[str]:
         """
         Get list of all section names in order.
-        
+
         Returns:
             List of section names
         """
         return list(self.sections.keys())
-    
+
     def get_sections(self) -> OrderedDict:
         """
         Get all sections.
-        
+
         Returns:
             OrderedDict of section definitions
         """
         return self.sections
-    
+
     def remove_section(self, section_name: str) -> bool:
         """
         Remove a section.
-        
+
         Args:
             section_name: Name of section to remove
-            
+
         Returns:
             bool: Success status
         """
         if section_name in self.sections:
             del self.sections[section_name]
             return True
-        return False
+        return False