claude-mpm 4.4.3__py3-none-any.whl → 4.4.4__py3-none-any.whl

claude_mpm/core/file_utils.py

@@ -22,7 +22,6 @@ from claude_mpm.core.logging_utils import get_logger
 logger = get_logger(__name__)
 
 
-
 # ==============================================================================
 # PATH UTILITIES
 # ==============================================================================

claude_mpm/core/framework/__init__.py

@@ -4,17 +4,17 @@ This module provides the modular framework loading system with specialized compo
 for handling different aspects of framework initialization and management.
 """
 
+from .formatters import (
+    CapabilityGenerator,
+    ContentFormatter,
+    ContextGenerator,
+)
 from .loaders import (
     AgentLoader,
     FileLoader,
     InstructionLoader,
     PackagedLoader,
 )
-from .formatters import (
-    CapabilityGenerator,
-    ContentFormatter,
-    ContextGenerator,
-)
 from .processors import (
     MemoryProcessor,
     MetadataProcessor,
@@ -35,4 +35,4 @@ __all__ = [
     "MetadataProcessor",
     "TemplateProcessor",
     "MemoryProcessor",
-]
+]

claude_mpm/core/framework/formatters/__init__.py

@@ -5,7 +5,7 @@ from .content_formatter import ContentFormatter
 from .context_generator import ContextGenerator
 
 __all__ = [
-    "ContentFormatter",
     "CapabilityGenerator",
+    "ContentFormatter",
     "ContextGenerator",
-]
+]

claude_mpm/core/framework/formatters/capability_generator.py

@@ -1,7 +1,6 @@
 """Agent capability generator for dynamic agent discovery."""
 
 import json
-import time
 from pathlib import Path
 from typing import Any, Dict, List, Optional
 
@@ -128,7 +127,9 @@ class CapabilityGenerator:
             if agent.get("memory_routing"):
                 memory_routing = agent["memory_routing"]
                 if memory_routing.get("description"):
-                    section += f"- **Memory Routing**: {memory_routing['description']}\n"
+                    section += (
+                        f"- **Memory Routing**: {memory_routing['description']}\n"
+                    )
 
         # Add simple Context-Aware Agent Selection
         section += "\n## Context-Aware Agent Selection\n\n"
@@ -159,7 +160,9 @@ class CapabilityGenerator:
             # Default values
             agent_data = {
                 "id": agent_file.stem,
-                "display_name": agent_file.stem.replace("_", " ").replace("-", " ").title(),
+                "display_name": agent_file.stem.replace("_", " ")
+                .replace("-", " ")
+                .title(),
                 "description": "Specialized agent",
             }
 
@@ -191,7 +194,9 @@ class CapabilityGenerator:
 
             # Try to load memory routing metadata from JSON template
             if "memory_routing" not in agent_data:
-                memory_routing_data = self.load_memory_routing_from_template(agent_file.stem)
+                memory_routing_data = self.load_memory_routing_from_template(
+                    agent_file.stem
+                )
                 if memory_routing_data:
                     agent_data["memory_routing"] = memory_routing_data
 
@@ -233,7 +238,9 @@ class CapabilityGenerator:
                 return None
 
             # For development mode, load from filesystem
-            templates_dir = framework_path / "src" / "claude_mpm" / "agents" / "templates"
+            templates_dir = (
+                framework_path / "src" / "claude_mpm" / "agents" / "templates"
+            )
             template_file = templates_dir / f"{agent_name}.json"
 
             if template_file.exists():
@@ -297,7 +304,9 @@ class CapabilityGenerator:
                 return None
 
             # For development mode, load from filesystem
-            templates_dir = framework_path / "src" / "claude_mpm" / "agents" / "templates"
+            templates_dir = (
+                framework_path / "src" / "claude_mpm" / "agents" / "templates"
+            )
             template_file = templates_dir / f"{agent_name}.json"
 
             if template_file.exists():
@@ -328,7 +337,9 @@ class CapabilityGenerator:
             return None
 
         except Exception as e:
-            self.logger.debug(f"Could not load memory routing from template for {agent_name}: {e}")
+            self.logger.debug(
+                f"Could not load memory routing from template for {agent_name}: {e}"
+            )
             return None
 
     def get_fallback_capabilities(self) -> str:
@@ -353,4 +364,4 @@ You have the following specialized agents available for delegation:
 - **Version Control** (`version-control`): Git operations and version management
 
 **IMPORTANT**: Use the exact agent ID in parentheses when delegating tasks.
-"""
+"""

claude_mpm/core/framework/formatters/content_formatter.py

@@ -174,7 +174,10 @@ You are a multi-agent orchestrator. Your primary responsibilities are:
                 # Use the actual agent_name as the ID (it's the filename stem)
                 agent_id = agent_name
                 clean_name = agent_name.replace("-", " ").replace("_", " ").title()
-                if "engineer" in agent_name.lower() and "data" not in agent_name.lower():
+                if (
+                    "engineer" in agent_name.lower()
+                    and "data" not in agent_name.lower()
+                ):
                     agent_list.append(
                         f"- **Engineer Agent** (`{agent_id}`): Code implementation and development"
                     )
@@ -215,7 +218,9 @@ You are a multi-agent orchestrator. Your primary responsibilities are:
 
             # Add full agent details
             instructions += "### Agent Details\n\n"
-            for agent_name, agent_content in sorted(framework_content["agents"].items()):
+            for agent_name, agent_content in sorted(
+                framework_content["agents"].items()
+            ):
                 instructions += f"#### {agent_name.replace('-', ' ').title()}\n"
                 instructions += agent_content + "\n\n"
 
@@ -280,4 +285,4 @@ You have the following specialized agents available for delegation:
 - **Version Control** (`version-control`): Git operations and version management
 
 **IMPORTANT**: Use the exact agent ID in parentheses when delegating tasks.
-"""
+"""

claude_mpm/core/framework/formatters/context_generator.py

@@ -54,7 +54,9 @@ class ContextGenerator:
             time_str = now.strftime("%H:%M:%S")
             day_name = now.strftime("%A")
 
-            context_lines.append(f"**Current DateTime**: {date_str} {time_str} {tz_info}\n")
+            context_lines.append(
+                f"**Current DateTime**: {date_str} {time_str} {tz_info}\n"
+            )
             context_lines.append(f"**Day**: {day_name}\n")
 
         except Exception as e:
@@ -148,7 +150,9 @@ class ContextGenerator:
                 try:
                     platform_version = platform.release()
                     if platform_version:
-                        context_lines.append(f"**System Version**: {platform_version}\n")
+                        context_lines.append(
+                            f"**System Version**: {platform_version}\n"
+                        )
                 except Exception:
                     pass
 
@@ -177,4 +181,4 @@ class ContextGenerator:
                 context_lines.append(f"**Locale**: {current_locale[0]}\n")
         except Exception:
             # Locale is optional
-            pass
+            pass

claude_mpm/core/framework/loaders/__init__.py

@@ -6,8 +6,8 @@ from .instruction_loader import InstructionLoader
 from .packaged_loader import PackagedLoader
 
 __all__ = [
+    "AgentLoader",
     "FileLoader",
-    "PackagedLoader",
     "InstructionLoader",
-    "AgentLoader",
-]
+    "PackagedLoader",
+]

claude_mpm/core/framework/loaders/agent_loader.py

@@ -47,7 +47,9 @@ class AgentLoader:
         self.logger.debug(f"Total deployed agents found: {len(deployed)}")
         return deployed
 
-    def load_single_agent(self, agent_file: Path) -> Tuple[Optional[str], Optional[str]]:
+    def load_single_agent(
+        self, agent_file: Path
+    ) -> Tuple[Optional[str], Optional[str]]:
         """
         Load a single agent file.
 
@@ -120,7 +122,9 @@ class AgentLoader:
 
         # Check for local JSON templates in priority order
         template_dirs = [
-            Path.cwd() / ".claude-mpm" / "agents",  # Project local agents (highest priority)
+            Path.cwd()
+            / ".claude-mpm"
+            / "agents",  # Project local agents (highest priority)
             Path.home() / ".claude-mpm" / "agents",  # User local agents
         ]
 
@@ -199,4 +203,4 @@ class AgentLoader:
             if "," in tools:
                 return tools
             return tools
-        return "Standard Tools"
+        return "Standard Tools"

claude_mpm/core/framework/loaders/file_loader.py

@@ -66,7 +66,9 @@ class FileLoader:
             if "INSTRUCTIONS.md" in str(file_path):
                 self.framework_last_modified = timestamp
 
-    def load_instructions_file(self, current_dir: Path) -> tuple[Optional[str], Optional[str]]:
+    def load_instructions_file(
+        self, current_dir: Path
+    ) -> tuple[Optional[str], Optional[str]]:
         """
         Load custom INSTRUCTIONS.md from .claude-mpm directories.
 
@@ -106,7 +108,9 @@ class FileLoader:
 
         return None, None
 
-    def load_workflow_file(self, current_dir: Path, framework_path: Path) -> tuple[Optional[str], Optional[str]]:
+    def load_workflow_file(
+        self, current_dir: Path, framework_path: Path
+    ) -> tuple[Optional[str], Optional[str]]:
         """
         Load WORKFLOW.md from various locations.
 
@@ -148,7 +152,9 @@ class FileLoader:
 
         # Fall back to system workflow (lowest priority)
         if framework_path and framework_path != Path("__PACKAGED__"):
-            system_workflow_path = framework_path / "src" / "claude_mpm" / "agents" / "WORKFLOW.md"
+            system_workflow_path = (
+                framework_path / "src" / "claude_mpm" / "agents" / "WORKFLOW.md"
+            )
             if system_workflow_path.exists():
                 loaded_content = self.try_load_file(
                     system_workflow_path, "system WORKFLOW.md"
@@ -159,7 +165,9 @@ class FileLoader:
 
         return None, None
 
-    def load_memory_file(self, current_dir: Path, framework_path: Path) -> tuple[Optional[str], Optional[str]]:
+    def load_memory_file(
+        self, current_dir: Path, framework_path: Path
+    ) -> tuple[Optional[str], Optional[str]]:
         """
         Load MEMORY.md from various locations.
 
@@ -201,7 +209,9 @@ class FileLoader:
 
         # Fall back to system memory instructions (lowest priority)
         if framework_path and framework_path != Path("__PACKAGED__"):
-            system_memory_path = framework_path / "src" / "claude_mpm" / "agents" / "MEMORY.md"
+            system_memory_path = (
+                framework_path / "src" / "claude_mpm" / "agents" / "MEMORY.md"
+            )
             if system_memory_path.exists():
                 loaded_content = self.try_load_file(
                     system_memory_path, "system MEMORY.md"
@@ -210,4 +220,4 @@ class FileLoader:
                     self.logger.info("Using system memory instructions")
                     return loaded_content, "system"
 
-        return None, None
+        return None, None

claude_mpm/core/framework/loaders/instruction_loader.py

@@ -75,14 +75,18 @@ class InstructionLoader:
             content["instructions_version"] = self.file_loader.framework_version
             content["version"] = self.file_loader.framework_version
         if self.file_loader.framework_last_modified:
-            content["instructions_last_modified"] = self.file_loader.framework_last_modified
+            content["instructions_last_modified"] = (
+                self.file_loader.framework_last_modified
+            )
 
         # Transfer metadata from packaged loader if available
         if self.packaged_loader.framework_version:
             content["instructions_version"] = self.packaged_loader.framework_version
             content["version"] = self.packaged_loader.framework_version
         if self.packaged_loader.framework_last_modified:
-            content["instructions_last_modified"] = self.packaged_loader.framework_last_modified
+            content["instructions_last_modified"] = (
+                self.packaged_loader.framework_last_modified
+            )
 
     def _load_filesystem_framework_instructions(self, content: Dict[str, Any]) -> None:
         """Load framework instructions from filesystem.
@@ -120,7 +124,9 @@ class InstructionLoader:
                 )
 
         # Load BASE_PM.md for core framework requirements
-        base_pm_path = self.framework_path / "src" / "claude_mpm" / "agents" / "BASE_PM.md"
+        base_pm_path = (
+            self.framework_path / "src" / "claude_mpm" / "agents" / "BASE_PM.md"
+        )
         if base_pm_path.exists():
             base_pm_content = self.file_loader.try_load_file(
                 base_pm_path, "BASE_PM framework requirements"
@@ -134,7 +140,9 @@ class InstructionLoader:
         Args:
             content: Dictionary to update with workflow instructions
         """
-        workflow, level = self.file_loader.load_workflow_file(self.current_dir, self.framework_path)
+        workflow, level = self.file_loader.load_workflow_file(
+            self.current_dir, self.framework_path
+        )
         if workflow:
             content["workflow_instructions"] = workflow
             content["workflow_instructions_level"] = level
@@ -145,7 +153,9 @@ class InstructionLoader:
         Args:
             content: Dictionary to update with memory instructions
         """
-        memory, level = self.file_loader.load_memory_file(self.current_dir, self.framework_path)
+        memory, level = self.file_loader.load_memory_file(
+            self.current_dir, self.framework_path
+        )
         if memory:
             content["memory_instructions"] = memory
-            content["memory_instructions_level"] = level
+            content["memory_instructions_level"] = level

claude_mpm/core/framework/loaders/packaged_loader.py

@@ -68,7 +68,9 @@ class PackagedLoader:
                 self.logger.warning(f"File {filename} not found in package")
                 return None
         except Exception as e:
-            self.logger.error(f"Failed to load {filename} from package with fallback: {e}")
+            self.logger.error(
+                f"Failed to load {filename} from package with fallback: {e}"
+            )
             return None
 
     def extract_metadata_from_content(self, content: str, filename: str) -> None:
@@ -97,7 +99,9 @@ class PackagedLoader:
             content: Dictionary to update with loaded content
         """
         if not files:
-            self.logger.warning("importlib.resources not available, cannot load packaged framework")
+            self.logger.warning(
+                "importlib.resources not available, cannot load packaged framework"
+            )
             self.logger.debug(f"files variable is: {files}")
             # Try alternative import methods
             try:
@@ -107,7 +111,9 @@ class PackagedLoader:
                 self.load_framework_content_fallback(content, resources)
                 return
             except ImportError:
-                self.logger.error("No importlib.resources available, using minimal framework")
+                self.logger.error(
+                    "No importlib.resources available, using minimal framework"
+                )
                 return
 
         try:
@@ -118,7 +124,9 @@ class PackagedLoader:
                 content["loaded"] = True
                 self.logger.info("Loaded consolidated PM_INSTRUCTIONS.md from package")
                 # Extract and store version/timestamp metadata
-                self.extract_metadata_from_content(pm_instructions_content, "PM_INSTRUCTIONS.md")
+                self.extract_metadata_from_content(
+                    pm_instructions_content, "PM_INSTRUCTIONS.md"
+                )
             else:
                 # Fall back to legacy INSTRUCTIONS.md
                 instructions_content = self.load_packaged_file("INSTRUCTIONS.md")
@@ -127,7 +135,9 @@ class PackagedLoader:
                     content["loaded"] = True
                     self.logger.warning("Using legacy INSTRUCTIONS.md from package")
                     # Extract and store version/timestamp metadata
-                    self.extract_metadata_from_content(instructions_content, "INSTRUCTIONS.md")
+                    self.extract_metadata_from_content(
+                        instructions_content, "INSTRUCTIONS.md"
+                    )
 
             if self.framework_version:
                 content["instructions_version"] = self.framework_version
@@ -155,7 +165,9 @@ class PackagedLoader:
         except Exception as e:
             self.logger.error(f"Failed to load packaged framework content: {e}")
 
-    def load_framework_content_fallback(self, content: Dict[str, Any], resources) -> None:
+    def load_framework_content_fallback(
+        self, content: Dict[str, Any], resources
+    ) -> None:
         """Load framework content using importlib.resources fallback.
 
         Args:
@@ -164,22 +176,30 @@ class PackagedLoader:
         """
         try:
             # Try new consolidated PM_INSTRUCTIONS.md first
-            pm_instructions_content = self.load_packaged_file_fallback("PM_INSTRUCTIONS.md", resources)
+            pm_instructions_content = self.load_packaged_file_fallback(
+                "PM_INSTRUCTIONS.md", resources
+            )
             if pm_instructions_content:
                 content["framework_instructions"] = pm_instructions_content
                 content["loaded"] = True
                 self.logger.info("Loaded consolidated PM_INSTRUCTIONS.md via fallback")
                 # Extract and store version/timestamp metadata
-                self.extract_metadata_from_content(pm_instructions_content, "PM_INSTRUCTIONS.md")
+                self.extract_metadata_from_content(
+                    pm_instructions_content, "PM_INSTRUCTIONS.md"
+                )
             else:
                 # Fall back to legacy INSTRUCTIONS.md
-                instructions_content = self.load_packaged_file_fallback("INSTRUCTIONS.md", resources)
+                instructions_content = self.load_packaged_file_fallback(
+                    "INSTRUCTIONS.md", resources
+                )
                 if instructions_content:
                     content["framework_instructions"] = instructions_content
                     content["loaded"] = True
                     self.logger.warning("Using legacy INSTRUCTIONS.md via fallback")
                     # Extract and store version/timestamp metadata
-                    self.extract_metadata_from_content(instructions_content, "INSTRUCTIONS.md")
+                    self.extract_metadata_from_content(
+                        instructions_content, "INSTRUCTIONS.md"
+                    )
 
             if self.framework_version:
                 content["instructions_version"] = self.framework_version
@@ -193,7 +213,9 @@ class PackagedLoader:
                 content["base_pm_instructions"] = base_pm_content
 
             # Load WORKFLOW.md
-            workflow_content = self.load_packaged_file_fallback("WORKFLOW.md", resources)
+            workflow_content = self.load_packaged_file_fallback(
+                "WORKFLOW.md", resources
+            )
             if workflow_content:
                 content["workflow_instructions"] = workflow_content
                 content["workflow_instructions_level"] = "system"
@@ -205,4 +227,6 @@ class PackagedLoader:
                 content["memory_instructions_level"] = "system"
 
         except Exception as e:
-            self.logger.error(f"Failed to load packaged framework content with fallback: {e}")
+            self.logger.error(
+                f"Failed to load packaged framework content with fallback: {e}"
+            )

claude_mpm/core/framework/processors/__init__.py

@@ -5,7 +5,7 @@ from .metadata_processor import MetadataProcessor
 from .template_processor import TemplateProcessor
 
 __all__ = [
+    "MemoryProcessor",
     "MetadataProcessor",
     "TemplateProcessor",
-    "MemoryProcessor",
-]
+]

claude_mpm/core/framework/processors/memory_processor.py

@@ -1,7 +1,7 @@
 """Memory content processor for framework memory management."""
 
 from pathlib import Path
-from typing import Any, Dict, Optional, Set
+from typing import Any, Dict, Set
 
 from claude_mpm.core.logging_utils import get_logger
 
@@ -28,7 +28,9 @@ class MemoryProcessor:
                 content = project_memory_file.read_text()
                 memories["actual_memories"] = content
                 memories["memory_source"] = "project"
-                self.logger.info(f"Loaded PM memories from project: {project_memory_file}")
+                self.logger.info(
+                    f"Loaded PM memories from project: {project_memory_file}"
+                )
                 return memories
             except Exception as e:
                 self.logger.error(f"Failed to load project PM memories: {e}")
@@ -74,10 +76,14 @@ class MemoryProcessor:
                     try:
                         content = memory_file.read_text()
                         agent_memories[agent_name] = content
-                        self.logger.debug(f"Loaded memories for {agent_name} from {memory_file}")
+                        self.logger.debug(
+                            f"Loaded memories for {agent_name} from {memory_file}"
+                        )
                         break  # Use first found (project > user)
                     except Exception as e:
-                        self.logger.error(f"Failed to load memories for {agent_name}: {e}")
+                        self.logger.error(
+                            f"Failed to load memories for {agent_name}: {e}"
+                        )
 
         return agent_memories
 
@@ -217,6 +223,8 @@ class MemoryProcessor:
                     self.logger.info(f"Migrated memories from {old_path} to {new_path}")
                     migrated = True
                 except Exception as e:
-                    self.logger.error(f"Failed to migrate memories from {old_path}: {e}")
+                    self.logger.error(
+                        f"Failed to migrate memories from {old_path}: {e}"
+                    )
 
-        return migrated
+        return migrated

claude_mpm/core/framework/processors/metadata_processor.py

@@ -61,7 +61,9 @@ class MetadataProcessor:
             # Default values
             agent_data = {
                 "id": agent_file.stem,
-                "display_name": agent_file.stem.replace("_", " ").replace("-", " ").title(),
+                "display_name": agent_file.stem.replace("_", " ")
+                .replace("-", " ")
+                .title(),
                 "description": "Specialized agent",
                 "file_path": str(agent_file),
                 "file_mtime": agent_file.stat().st_mtime,
@@ -96,9 +98,7 @@ class MetadataProcessor:
             self.logger.debug(f"Could not parse metadata from {agent_file}: {e}")
             return None
 
-    def extract_cache_metadata(
-        self, data: Any, cache_key: str
-    ) -> Tuple[Any, float]:
+    def extract_cache_metadata(self, data: Any, cache_key: str) -> Tuple[Any, float]:
         """Extract cache metadata for storage.
 
         Args:
@@ -143,4 +143,4 @@ class MetadataProcessor:
             return True
         except Exception as e:
             self.logger.debug(f"Cache validation failed: {e}")
-            return False
+            return False

claude_mpm/core/framework/processors/template_processor.py

@@ -82,7 +82,9 @@ class TemplateProcessor:
         Returns:
             Template data or None if not found
         """
-        templates_dir = self.framework_path / "src" / "claude_mpm" / "agents" / "templates"
+        templates_dir = (
+            self.framework_path / "src" / "claude_mpm" / "agents" / "templates"
+        )
 
         # Try exact match first
         template_file = templates_dir / f"{agent_name}.json"
@@ -114,8 +116,8 @@ class TemplateProcessor:
             {
                 agent_name.replace("-", "_"),  # api-qa -> api_qa
                 agent_name.replace("_", "-"),  # api_qa -> api-qa
-                agent_name.replace("-", ""),   # api-qa -> apiqa
-                agent_name.replace("_", ""),   # api_qa -> apiqa
+                agent_name.replace("-", ""),  # api-qa -> apiqa
+                agent_name.replace("_", ""),  # api_qa -> apiqa
                 agent_name.replace("-agent", ""),  # research-agent -> research
                 agent_name.replace("_agent", ""),  # research_agent -> research
                 agent_name + "_agent",  # research -> research_agent
@@ -123,7 +125,9 @@ class TemplateProcessor:
             }
         )
 
-    def extract_routing(self, template_data: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+    def extract_routing(
+        self, template_data: Dict[str, Any]
+    ) -> Optional[Dict[str, Any]]:
         """Extract routing information from template.
 
         Args:
@@ -134,7 +138,9 @@ class TemplateProcessor:
         """
         return template_data.get("routing")
 
-    def extract_memory_routing(self, template_data: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+    def extract_memory_routing(
+        self, template_data: Dict[str, Any]
+    ) -> Optional[Dict[str, Any]]:
         """Extract memory routing information from template.
 
         Args:
@@ -235,4 +241,4 @@ class TemplateProcessor:
                 except Exception as e:
                     self.logger.warning(f"Failed to process template {json_file}: {e}")
 
-        return local_agents
+        return local_agents