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/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 """
@@ -43,38 +44,33 @@ class TodoTaskToolsGenerator(BaseSectionGenerator):
 Task(description="[task description]", subagent_type="[agent-type]")
 ```
 
-**Valid subagent_type values (both formats accepted):**
+**Valid subagent_type values (use lowercase format for Claude Code compatibility):**
 
-**Lowercase-hyphenated format (traditional):**
-- `subagent_type="research"` - For investigation and analysis
+**Required format (Claude Code expects these exact values from deployed agent YAML names):**
+- `subagent_type="research-agent"` - For investigation and analysis
 - `subagent_type="engineer"` - For coding and implementation
-- `subagent_type="qa"` - For testing and quality assurance
-- `subagent_type="documentation"` - For docs and guides
-- `subagent_type="security"` - For security assessments
-- `subagent_type="ops"` - For deployment and infrastructure
+- `subagent_type="qa-agent"` - For testing and quality assurance
+- `subagent_type="documentation-agent"` - For docs and guides
+- `subagent_type="security-agent"` - For security assessments
+- `subagent_type="ops-agent"` - For deployment and infrastructure
 - `subagent_type="version-control"` - For git and version management
 - `subagent_type="data-engineer"` - For data processing and APIs
+- `subagent_type="pm"` - For project management coordination
+- `subagent_type="test_integration"` - For integration testing
+
+**Note:** Claude Code's Task tool requires exact agent names as defined in the deployed agent YAML frontmatter. The names must match exactly - including hyphens where specified.
 
-**Capitalized format (matching TodoWrite prefixes - also accepted):**
-- `subagent_type="Research"` - For investigation and analysis
-- `subagent_type="Engineer"` - For coding and implementation
-- `subagent_type="QA"` - For testing and quality assurance
-- `subagent_type="Documentation"` - For docs and guides
-- `subagent_type="Security"` - For security assessments
-- `subagent_type="Ops"` - For deployment and infrastructure
-- `subagent_type="Version Control"` - For git and version management
-- `subagent_type="Data Engineer"` - For data processing and APIs
-
-**Examples of Proper Task Tool Usage (both formats work):**
-- ✅ `Task(description="Update framework documentation", subagent_type="documentation")`
-- ✅ `Task(description="Execute test suite validation", subagent_type="qa")`
+**Examples of Proper Task Tool Usage (must match deployed agent YAML names):**
+- ✅ `Task(description="Update framework documentation", subagent_type="documentation-agent")`
+- ✅ `Task(description="Execute test suite validation", subagent_type="qa-agent")`
 - ✅ `Task(description="Create feature branch and sync", subagent_type="version-control")`
-- ✅ `Task(description="Investigate performance patterns", subagent_type="research")`
+- ✅ `Task(description="Investigate performance patterns", subagent_type="research-agent")`
 - ✅ `Task(description="Implement authentication system", subagent_type="engineer")`
 - ✅ `Task(description="Configure database and optimize queries", subagent_type="data-engineer")`
-- ✅ `Task(description="Analyze code patterns", subagent_type="Research")` (capitalized format)
-- ✅ `Task(description="Update API docs", subagent_type="Documentation")` (capitalized format)
-- ✅ `Task(description="Create release tags", subagent_type="Version Control")` (capitalized format)
+- ✅ `Task(description="Coordinate project tasks", subagent_type="pm")`
+- ❌ `Task(description="Analyze code patterns", subagent_type="research")` (WRONG - missing '-agent' suffix)
+- ❌ `Task(description="Update API docs", subagent_type="documentation")` (WRONG - missing '-agent' suffix)
+- ❌ `Task(description="Create release tags", subagent_type="version_control")` (WRONG - should be 'version-control')
 
 ### 🚨 MANDATORY: THREE SHORTCUT COMMANDS
 
@@ -103,13 +99,13 @@ Task(description="[task description]", subagent_type="[agent-type]")
 - ☐ [Data Engineer] Validate data integrity and verify API connectivity
 - ☐ [Version Control] Apply semantic version bump and create release tags
 
-# Corresponding Task Tool delegations:
-Task(description="Generate changelog and analyze version impact", subagent_type="documentation")
-Task(description="Execute full test suite and quality validation", subagent_type="qa")
+# Corresponding Task Tool delegations (must match deployed agent names):
+Task(description="Generate changelog and analyze version impact", subagent_type="documentation-agent")
+Task(description="Execute full test suite and quality validation", subagent_type="qa-agent")
 Task(description="Validate data integrity and verify API connectivity", subagent_type="data-engineer")
 Task(description="Apply semantic version bump and create release tags", subagent_type="version-control")
 
 # 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 """
@@ -21,7 +22,7 @@ class TroubleshootingGenerator(BaseSectionGenerator):
 4. **Permission Issues**: Ensure proper file permissions on CLI executables
 
 ### claude-pm init and Agent Hierarchy Issues
-5. **Missing .claude-pm Directories**: Run `claude-pm init --setup`
+5. **Missing .claude-mpm Directories**: Run `claude-pm init --setup`
 6. **Agent Hierarchy Validation Errors**: Run `claude-pm init --verify` for detailed validation
 
 ### Core System Issues
@@ -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

claude_mpm/services/framework_claude_md_generator/version_manager.py

@@ -1,3 +1,5 @@
+from pathlib import Path
+
 """
 Version management for framework CLAUDE.md templates.
 
@@ -5,28 +7,27 @@ Handles version parsing, incrementing, and comparison operations.
 """
 
 import re
-from typing import Tuple, Optional
-from pathlib import Path
+from typing import Optional
 
 
 class VersionManager:
     """Manages version numbering for framework CLAUDE.md templates."""
-    
+
     def __init__(self):
         """Initialize version manager."""
         self.framework_version = self._get_framework_version()
-    
+
     def _get_framework_version(self) -> str:
         """
         Get the current framework version from framework/VERSION file.
-        
+
         Returns:
             str: Framework version (e.g., "015")
         """
         # Check if we're in a wheel installation
         package_path = Path(__file__).parent.parent.parent
         path_str = str(package_path.resolve())
-        if 'site-packages' in path_str or 'dist-packages' in path_str:
+        if "site-packages" in path_str or "dist-packages" in path_str:
             # For wheel installations, check data directory
             version_path = package_path / "data" / "framework" / "VERSION"
             if not version_path.exists():
@@ -35,87 +36,87 @@ class VersionManager:
         else:
             # Source installation
             version_path = package_path.parent / "framework" / "VERSION"
-        
+
         if version_path.exists():
-            with open(version_path, 'r') as f:
+            with version_path.open() as f:
                 version_content = f.read().strip()
                 # Framework VERSION file contains just the framework version number
                 try:
                     return f"{int(version_content):03d}"
                 except ValueError:
                     # If not a plain number, try to extract from version string
-                    match = re.match(r'(\d+)', version_content)
+                    match = re.match(r"(\d+)", version_content)
                     if match:
                         return f"{int(match.group(1)):03d}"
         return "014"  # Default fallback
-    
+
     def parse_current_version(self, content: str) -> str:
         """
         Parse the current CLAUDE_MD_VERSION from existing content.
-        
+
         Args:
             content: Existing CLAUDE.md content
-            
+
         Returns:
             str: Version number (e.g., "016")
         """
         # First try simple serial format
-        match = re.search(r'CLAUDE_MD_VERSION:\s*(\d+)(?!-)', content)
+        match = re.search(r"CLAUDE_MD_VERSION:\s*(\d+)(?!-)", content)
         if match:
             return match.group(1)
-        
+
         # Handle old format for backward compatibility
-        match = re.search(r'CLAUDE_MD_VERSION:\s*(\d+)-(\d+)', content)
+        match = re.search(r"CLAUDE_MD_VERSION:\s*(\d+)-(\d+)", content)
         if match:
             return match.group(1)  # Return just the framework part
-        
+
         return self.framework_version
-    
+
     def auto_increment_version(self, current_content: Optional[str] = None) -> str:
         """
         Get the current framework version (no auto-increment for simple serial numbers).
-        
+
         Args:
             current_content: Current CLAUDE.md content (unused with simple serials)
-            
+
         Returns:
             str: Current framework version (e.g., "016")
         """
         # With simple serial numbers, we just use the framework version
         # Incrementing is done by updating the framework/VERSION file
         return self.framework_version
-    
+
     def compare_versions(self, version1: str, version2: str) -> int:
         """
         Compare two version strings.
-        
+
         Args:
             version1: First version string (e.g., "016")
             version2: Second version string (e.g., "017")
-            
+
         Returns:
             int: -1 if version1 < version2, 0 if equal, 1 if version1 > version2
         """
+
         def parse_version(v: str) -> int:
             # Handle simple serial format
-            if '-' not in v:
+            if "-" not in v:
                 try:
                     return int(v)
                 except ValueError:
                     return 0
-            
+
             # Handle old format for backward compatibility
-            match = re.match(r'(\d+)-(\d+)', v)
+            match = re.match(r"(\d+)-(\d+)", v)
             if match:
                 return int(match.group(1))  # Just compare framework part
             return 0
-        
+
         v1 = parse_version(version1)
         v2 = parse_version(version2)
-        
+
         if v1 < v2:
             return -1
-        elif v1 > v2:
+        if v1 > v2:
             return 1
-        else:
-            return 0
+        return 0

claude_mpm/services/git/__init__.py

@@ -0,0 +1,21 @@
+"""
+Git Operations Service Package
+================================
+
+Provides Git operations abstraction for PR workflow automation.
+Used by agent-improver and skills-manager agents.
+"""
+
+from .git_operations_service import (
+    GitAuthenticationError,
+    GitConflictError,
+    GitOperationError,
+    GitOperationsService,
+)
+
+__all__ = [
+    "GitAuthenticationError",
+    "GitConflictError",
+    "GitOperationError",
+    "GitOperationsService",
+]