claude-mpm 4.1.1__py3-none-any.whl → 4.1.3__py3-none-any.whl

claude_mpm/core/output_style_manager.py

@@ -2,7 +2,7 @@
 
 This module handles:
 1. Claude version detection
-2. Output style extraction from framework instructions  
+2. Output style extraction from framework instructions
 3. One-time deployment to Claude Code >= 1.0.83 at startup
 4. Fallback injection for older versions
 
@@ -11,13 +11,10 @@ Users can change it if they want, and the system will respect their choice.
 """
 
 import json
-import logging
-import os
 import re
-import shutil
 import subprocess
 from pathlib import Path
-from typing import Dict, Optional, Tuple
+from typing import Dict, Optional
 
 from ..utils.imports import safe_import
 
@@ -35,14 +32,16 @@ class OutputStyleManager:
         self.output_style_dir = Path.home() / ".claude" / "output-styles"
         self.output_style_path = self.output_style_dir / "claude-mpm.md"
         self.settings_file = Path.home() / ".claude" / "settings.json"
-        
+
         # Cache the output style content path
-        self.mpm_output_style_path = Path(__file__).parent.parent / "agents" / "OUTPUT_STYLE.md"
+        self.mpm_output_style_path = (
+            Path(__file__).parent.parent / "agents" / "OUTPUT_STYLE.md"
+        )
 
     def _detect_claude_version(self) -> Optional[str]:
         """
         Detect Claude Code version by running 'claude --version'.
-        
+
         Returns:
             Version string (e.g., "1.0.82") or None if Claude not found
         """
@@ -52,26 +51,26 @@ class OutputStyleManager:
                 ["claude", "--version"],
                 capture_output=True,
                 text=True,
-                timeout=5
+                timeout=5,
+                check=False,
             )
-            
+
             if result.returncode != 0:
                 self.logger.warning(f"Claude command failed: {result.stderr}")
                 return None
-            
+
             # Parse version from output
             # Expected format: "Claude 1.0.82" or similar
             version_output = result.stdout.strip()
             version_match = re.search(r"(\d+\.\d+\.\d+)", version_output)
-            
+
             if version_match:
                 version = version_match.group(1)
                 self.logger.info(f"Detected Claude version: {version}")
                 return version
-            else:
-                self.logger.warning(f"Could not parse version from: {version_output}")
-                return None
-                
+            self.logger.warning(f"Could not parse version from: {version_output}")
+            return None
+
         except FileNotFoundError:
             self.logger.info("Claude Code not found in PATH")
             return None
@@ -85,29 +84,29 @@ class OutputStyleManager:
     def _compare_versions(self, version1: str, version2: str) -> int:
         """
         Compare two version strings.
-        
+
         Args:
             version1: First version string
             version2: Second version string
-            
+
         Returns:
             -1 if version1 < version2
             0 if version1 == version2
             1 if version1 > version2
         """
         try:
-            v1_parts = [int(x) for x in version1.split('.')]
-            v2_parts = [int(x) for x in version2.split('.')]
-            
+            v1_parts = [int(x) for x in version1.split(".")]
+            v2_parts = [int(x) for x in version2.split(".")]
+
             # Pad shorter version with zeros
             max_len = max(len(v1_parts), len(v2_parts))
             v1_parts.extend([0] * (max_len - len(v1_parts)))
             v2_parts.extend([0] * (max_len - len(v2_parts)))
-            
+
             for i in range(max_len):
                 if v1_parts[i] < v2_parts[i]:
                     return -1
-                elif v1_parts[i] > v2_parts[i]:
+                if v1_parts[i] > v2_parts[i]:
                     return 1
             return 0
         except Exception as e:
@@ -117,19 +116,19 @@ class OutputStyleManager:
     def supports_output_styles(self) -> bool:
         """
         Check if Claude Code supports output styles (>= 1.0.83).
-        
+
         Returns:
             True if Claude version >= 1.0.83, False otherwise
         """
         if not self.claude_version:
             return False
-        
+
         return self._compare_versions(self.claude_version, "1.0.83") >= 0
 
     def should_inject_content(self) -> bool:
         """
         Check if output style content should be injected into instructions.
-        
+
         Returns:
             True if Claude version < 1.0.83 or not detected, False otherwise
         """
@@ -138,45 +137,55 @@ class OutputStyleManager:
     def extract_output_style_content(self, framework_loader=None) -> str:
         """
         Extract output style content from framework instructions.
-        
+
         This extracts PM delegation behavior, tone, communication standards,
         response formats, TodoWrite requirements, and workflow rules from:
         - INSTRUCTIONS.md
         - BASE_PM.md
-        
+
         Args:
             framework_loader: Optional FrameworkLoader instance to reuse loaded content
-            
+
         Returns:
             Formatted output style content in YAML frontmatter + markdown format
         """
         # Build the content sections
         sections = []
-        
+
         # Add YAML frontmatter
         sections.append("---")
         sections.append("name: Claude MPM")
-        sections.append("description: Multi-Agent Project Manager orchestration mode for delegation and coordination")
+        sections.append(
+            "description: Multi-Agent Project Manager orchestration mode for delegation and coordination"
+        )
         sections.append("---")
         sections.append("")
-        
+
         # Header
-        sections.append("You are Claude Multi-Agent PM, a PROJECT MANAGER whose SOLE PURPOSE is to delegate work to specialized agents.")
+        sections.append(
+            "You are Claude Multi-Agent PM, a PROJECT MANAGER whose SOLE PURPOSE is to delegate work to specialized agents."
+        )
         sections.append("")
-        
+
         # Extract from INSTRUCTIONS.md
-        if framework_loader and framework_loader.framework_content.get("framework_instructions"):
+        if framework_loader and framework_loader.framework_content.get(
+            "framework_instructions"
+        ):
             instructions = framework_loader.framework_content["framework_instructions"]
             sections.extend(self._extract_instructions_sections(instructions))
         else:
             # Load from file if no framework_loader provided
-            instructions_path = Path(__file__).parent.parent / "agents" / "INSTRUCTIONS.md"
+            instructions_path = (
+                Path(__file__).parent.parent / "agents" / "INSTRUCTIONS.md"
+            )
             if instructions_path.exists():
                 instructions = instructions_path.read_text()
                 sections.extend(self._extract_instructions_sections(instructions))
-        
+
         # Extract from BASE_PM.md
-        if framework_loader and framework_loader.framework_content.get("base_pm_instructions"):
+        if framework_loader and framework_loader.framework_content.get(
+            "base_pm_instructions"
+        ):
             base_pm = framework_loader.framework_content["base_pm_instructions"]
             sections.extend(self._extract_base_pm_sections(base_pm))
         else:
@@ -185,83 +194,105 @@ class OutputStyleManager:
             if base_pm_path.exists():
                 base_pm = base_pm_path.read_text()
                 sections.extend(self._extract_base_pm_sections(base_pm))
-        
+
         return "\n".join(sections)
 
     def _extract_instructions_sections(self, content: str) -> list:
         """Extract relevant sections from INSTRUCTIONS.md."""
         sections = []
-        
+
         # Extract Primary Directive
         if "## 🔴 PRIMARY DIRECTIVE" in content:
             sections.append("## 🔴 PRIMARY DIRECTIVE - MANDATORY DELEGATION 🔴")
             sections.append("")
-            sections.append("**YOU ARE STRICTLY FORBIDDEN FROM DOING ANY WORK DIRECTLY.**")
+            sections.append(
+                "**YOU ARE STRICTLY FORBIDDEN FROM DOING ANY WORK DIRECTLY.**"
+            )
             sections.append("")
-            sections.append("Direct implementation is ABSOLUTELY PROHIBITED unless the user EXPLICITLY overrides with phrases like:")
+            sections.append(
+                "Direct implementation is ABSOLUTELY PROHIBITED unless the user EXPLICITLY overrides with phrases like:"
+            )
             sections.append('- "do this yourself"')
             sections.append('- "don\'t delegate"')
             sections.append('- "implement directly"')
             sections.append('- "you do it"')
             sections.append('- "no delegation"')
             sections.append("")
-        
+
         # Extract Core Identity and Rules
         if "## Core Identity" in content:
             sections.append("## Core Operating Rules")
             sections.append("")
             sections.append("**DEFAULT BEHAVIOR - ALWAYS DELEGATE**:")
-            sections.append("- 🔴 You MUST delegate 100% of ALL work to specialized agents by default")
-            sections.append("- 🔴 Direct action is STRICTLY FORBIDDEN without explicit user override")
-            sections.append("- 🔴 Even the simplest tasks MUST be delegated - NO EXCEPTIONS")
+            sections.append(
+                "- 🔴 You MUST delegate 100% of ALL work to specialized agents by default"
+            )
+            sections.append(
+                "- 🔴 Direct action is STRICTLY FORBIDDEN without explicit user override"
+            )
+            sections.append(
+                "- 🔴 Even the simplest tasks MUST be delegated - NO EXCEPTIONS"
+            )
             sections.append("- 🔴 When in doubt, ALWAYS DELEGATE - never act directly")
             sections.append("")
             sections.append("**Allowed Tools**:")
             sections.append("- **Task** for delegation (YOUR PRIMARY FUNCTION)")
             sections.append("- **TodoWrite** for tracking delegation progress ONLY")
-            sections.append("- **WebSearch/WebFetch** for gathering context BEFORE delegation")
-            sections.append("- **Direct answers** ONLY for questions about PM capabilities")
+            sections.append(
+                "- **WebSearch/WebFetch** for gathering context BEFORE delegation"
+            )
+            sections.append(
+                "- **Direct answers** ONLY for questions about PM capabilities"
+            )
             sections.append("")
-        
+
         # Extract Communication Standards
         if "## Communication Standards" in content:
             sections.append("## Communication Standards")
             sections.append("")
             sections.append("- **Tone**: Professional, neutral by default")
-            sections.append("- **Use**: \"Understood\", \"Confirmed\", \"Noted\"")
+            sections.append('- **Use**: "Understood", "Confirmed", "Noted"')
             sections.append("- **No simplification** without explicit user request")
             sections.append("- **No mocks** outside test environments")
             sections.append("- **Complete implementations** only - no placeholders")
-            sections.append("- **FORBIDDEN**: Overeager enthusiasm (\"Excellent!\", \"Perfect!\", \"Amazing!\")")
+            sections.append(
+                '- **FORBIDDEN**: Overeager enthusiasm ("Excellent!", "Perfect!", "Amazing!")'
+            )
             sections.append("")
-        
+
         # Extract Error Handling
         if "## Error Handling Protocol" in content:
             sections.append("## Error Handling Protocol")
             sections.append("")
             sections.append("**3-Attempt Process**:")
             sections.append("1. **First Failure**: Re-delegate with enhanced context")
-            sections.append("2. **Second Failure**: Mark \"ERROR - Attempt 2/3\", escalate if needed")
-            sections.append("3. **Third Failure**: TodoWrite escalation with user decision required")
+            sections.append(
+                '2. **Second Failure**: Mark "ERROR - Attempt 2/3", escalate if needed'
+            )
+            sections.append(
+                "3. **Third Failure**: TodoWrite escalation with user decision required"
+            )
             sections.append("")
-        
+
         # Extract Standard Operating Procedure
         if "## Standard Operating Procedure" in content:
             sections.append("## Standard Operating Procedure")
             sections.append("")
             sections.append("1. **Analysis**: Parse request, assess context (NO TOOLS)")
-            sections.append("2. **Planning**: Agent selection, task breakdown, priority assignment")
+            sections.append(
+                "2. **Planning**: Agent selection, task breakdown, priority assignment"
+            )
             sections.append("3. **Delegation**: Task Tool with enhanced format")
             sections.append("4. **Monitoring**: Track progress via TodoWrite")
             sections.append("5. **Integration**: Synthesize results, validate, report")
             sections.append("")
-        
+
         return sections
 
     def _extract_base_pm_sections(self, content: str) -> list:
         """Extract relevant sections from BASE_PM.md."""
         sections = []
-        
+
         # Extract TodoWrite Requirements
         if "## TodoWrite Framework Requirements" in content:
             sections.append("## TodoWrite Requirements")
@@ -279,15 +310,19 @@ class OutputStyleManager:
             sections.append("### Task Status Management")
             sections.append("")
             sections.append("- `pending` - Task not yet started")
-            sections.append("- `in_progress` - Currently being worked on (ONE at a time)")
+            sections.append(
+                "- `in_progress` - Currently being worked on (ONE at a time)"
+            )
             sections.append("- `completed` - Task finished successfully")
             sections.append("")
-        
+
         # Extract PM Response Format
         if "## PM Response Format" in content:
             sections.append("## Response Format")
             sections.append("")
-            sections.append("When completing delegations, provide structured summaries including:")
+            sections.append(
+                "When completing delegations, provide structured summaries including:"
+            )
             sections.append("- Request summary")
             sections.append("- Agents used and task counts")
             sections.append("- Tasks completed with [Agent] prefixes")
@@ -296,27 +331,27 @@ class OutputStyleManager:
             sections.append("- Next steps for user")
             sections.append("- Key information to remember")
             sections.append("")
-        
+
         return sections
 
     def save_output_style(self, content: str) -> Path:
         """
         Save output style content to OUTPUT_STYLE.md.
-        
+
         Args:
             content: The formatted output style content
-            
+
         Returns:
             Path to the saved file
         """
         try:
             # Ensure the parent directory exists
             self.mpm_output_style_path.parent.mkdir(parents=True, exist_ok=True)
-            
+
             # Write the content
-            self.mpm_output_style_path.write_text(content, encoding='utf-8')
+            self.mpm_output_style_path.write_text(content, encoding="utf-8")
             self.logger.info(f"Saved output style to {self.mpm_output_style_path}")
-            
+
             return self.mpm_output_style_path
         except Exception as e:
             self.logger.error(f"Failed to save output style: {e}")
@@ -326,30 +361,32 @@ class OutputStyleManager:
         """
         Deploy output style to Claude Code if version >= 1.0.83.
         Deploys the style file and activates it once.
-        
+
         Args:
             content: The output style content to deploy
-            
+
         Returns:
             True if deployed successfully, False otherwise
         """
         if not self.supports_output_styles():
-            self.logger.info(f"Claude version {self.claude_version or 'unknown'} does not support output styles")
+            self.logger.info(
+                f"Claude version {self.claude_version or 'unknown'} does not support output styles"
+            )
             return False
-        
+
         try:
             # Ensure output-styles directory exists
             self.output_style_dir.mkdir(parents=True, exist_ok=True)
-            
+
             # Write the output style file
-            self.output_style_path.write_text(content, encoding='utf-8')
+            self.output_style_path.write_text(content, encoding="utf-8")
             self.logger.info(f"Deployed output style to {self.output_style_path}")
-            
+
             # Activate the claude-mpm style
             self._activate_output_style()
-            
+
             return True
-            
+
         except Exception as e:
             self.logger.error(f"Failed to deploy output style: {e}")
             return False
@@ -358,7 +395,7 @@ class OutputStyleManager:
         """
         Update Claude Code settings to activate the claude-mpm output style.
         Sets activeOutputStyle to "claude-mpm" once at startup.
-        
+
         Returns:
             True if activated successfully, False otherwise
         """
@@ -369,30 +406,33 @@ class OutputStyleManager:
                 try:
                     settings = json.loads(self.settings_file.read_text())
                 except json.JSONDecodeError:
-                    self.logger.warning("Could not parse existing settings.json, using defaults")
-            
+                    self.logger.warning(
+                        "Could not parse existing settings.json, using defaults"
+                    )
+
             # Check current active style
             current_style = settings.get("activeOutputStyle")
-            
+
             # Update active output style to claude-mpm if not already set
             if current_style != "claude-mpm":
                 settings["activeOutputStyle"] = "claude-mpm"
-                
+
                 # Ensure settings directory exists
                 self.settings_file.parent.mkdir(parents=True, exist_ok=True)
-                
+
                 # Write updated settings
                 self.settings_file.write_text(
-                    json.dumps(settings, indent=2),
-                    encoding='utf-8'
+                    json.dumps(settings, indent=2), encoding="utf-8"
+                )
+
+                self.logger.info(
+                    f"✅ Activated claude-mpm output style (was: {current_style or 'none'})"
                 )
-                
-                self.logger.info(f"✅ Activated claude-mpm output style (was: {current_style or 'none'})")
             else:
                 self.logger.debug("Claude MPM output style already active")
-            
+
             return True
-            
+
         except Exception as e:
             self.logger.warning(f"Failed to update settings: {e}")
             return False
@@ -400,7 +440,7 @@ class OutputStyleManager:
     def get_status_summary(self) -> Dict[str, str]:
         """
         Get a summary of the output style status.
-        
+
         Returns:
             Dictionary with status information
         """
@@ -409,18 +449,18 @@ class OutputStyleManager:
             "supports_output_styles": "Yes" if self.supports_output_styles() else "No",
             "deployment_mode": "Not initialized",
             "active_style": "Unknown",
-            "file_status": "Not checked"
+            "file_status": "Not checked",
         }
-        
+
         if self.supports_output_styles():
             status["deployment_mode"] = "Output style deployment"
-            
+
             # Check if file exists
             if self.output_style_path.exists():
                 status["file_status"] = "Deployed"
             else:
                 status["file_status"] = "Pending deployment"
-                
+
             # Check active style
             if self.settings_file.exists():
                 try:
@@ -432,37 +472,38 @@ class OutputStyleManager:
             status["deployment_mode"] = "Framework injection"
             status["file_status"] = "N/A (legacy mode)"
             status["active_style"] = "N/A (legacy mode)"
-            
+
         return status
-    
+
     def get_injectable_content(self, framework_loader=None) -> str:
         """
         Get output style content for injection into instructions (for Claude < 1.0.83).
-        
+
         This returns a simplified version without YAML frontmatter, suitable for
         injection into the framework instructions.
-        
+
         Args:
             framework_loader: Optional FrameworkLoader instance to reuse loaded content
-            
+
         Returns:
             Simplified output style content for injection
         """
         # Extract the same content but without YAML frontmatter
         full_content = self.extract_output_style_content(framework_loader)
-        
+
         # Remove YAML frontmatter
-        lines = full_content.split('\n')
-        if lines[0] == '---':
+        lines = full_content.split("\n")
+        if lines[0] == "---":
             # Find the closing ---
             for i in range(1, len(lines)):
-                if lines[i] == '---':
+                if lines[i] == "---":
                     # Skip frontmatter and empty lines after it
                     content_start = i + 1
-                    while content_start < len(lines) and not lines[content_start].strip():
+                    while (
+                        content_start < len(lines) and not lines[content_start].strip()
+                    ):
                         content_start += 1
-                    return '\n'.join(lines[content_start:])
-        
+                    return "\n".join(lines[content_start:])
+
         # If no frontmatter found, return as-is
         return full_content
-    

claude_mpm/core/pm_hook_interceptor.py

@@ -12,7 +12,6 @@ WHY this is needed:
 """
 
 import functools
-import os
 import threading
 import time
 from datetime import datetime

claude_mpm/core/service_registry.py

@@ -129,10 +129,14 @@ class ServiceRegistry:
 
         # Create factory wrapper if config provided
         if config and not factory:
-            factory = lambda c: service_class(name=name, config=config, container=c)
+
+            def factory(c):
+                return service_class(name=name, config=config, container=c)
+
         elif not factory:
             # Default factory with container injection
-            factory = lambda c: service_class(name=name, container=c)
+            def factory(c):
+                return service_class(name=name, container=c)
 
         # Register with DI container
         self.container.register(
@@ -216,12 +220,11 @@ class ServiceRegistry:
                     if (
                         registration
                         and registration.lifetime == ServiceLifetime.SINGLETON
-                    ):
-                        if service_class in self.container._singletons:
-                            service = self.container._singletons[service_class]
-                            if hasattr(service, "stop") and service.running:
-                                await service.stop()
-                                logger.info(f"Stopped service: {name}")
+                    ) and service_class in self.container._singletons:
+                        service = self.container._singletons[service_class]
+                        if hasattr(service, "stop") and service.running:
+                            await service.stop()
+                            logger.info(f"Stopped service: {name}")
                 except Exception as e:
                     logger.error(f"Failed to stop service {name}: {e}")
 

claude_mpm/core/session_manager.py

@@ -195,7 +195,7 @@ class SessionManager:
         session_file = self.session_dir / "active_sessions.json"
         if session_file.exists():
             try:
-                with open(session_file, "r") as f:
+                with open(session_file) as f:
                     self.active_sessions = json.load(f)
 
                 # Clean up old sessions on load (archive by default)
@@ -323,7 +323,6 @@ class OrchestrationSession:
     def __exit__(self, exc_type, exc_val, exc_tb):
         """Exit session context."""
         # Could add cleanup here if needed
-        pass
 
 
 # Example usage in subprocess orchestrator:

claude_mpm/core/shared/__init__.py

@@ -11,7 +11,7 @@ from .singleton_manager import SingletonManager
 
 __all__ = [
     "ConfigLoader",
-    "ConfigPattern", 
+    "ConfigPattern",
     "PathResolver",
     "SingletonManager",
 ]