claude-mpm 3.9.8__py3-none-any.whl → 3.9.9__py3-none-any.whl

claude_mpm/utils/subprocess_utils.py

@@ -0,0 +1,305 @@
+#!/usr/bin/env python3
+"""
+Subprocess utilities for Claude MPM.
+
+This module provides enhanced subprocess execution and management utilities
+with proper error handling, timeouts, and process cleanup.
+"""
+
+import asyncio
+import os
+import signal
+import subprocess
+import sys
+import time
+from typing import Dict, List, Optional, Union, Any
+import psutil
+
+
+class SubprocessError(Exception):
+    """Unified exception for subprocess errors."""
+    
+    def __init__(self, message: str, returncode: Optional[int] = None, 
+                 stdout: Optional[str] = None, stderr: Optional[str] = None):
+        super().__init__(message)
+        self.returncode = returncode
+        self.stdout = stdout
+        self.stderr = stderr
+
+
+class SubprocessResult:
+    """Result object for subprocess execution."""
+    
+    def __init__(self, returncode: int, stdout: str = "", stderr: str = ""):
+        self.returncode = returncode
+        self.stdout = stdout
+        self.stderr = stderr
+        
+    @property
+    def success(self) -> bool:
+        """True if the subprocess completed successfully."""
+        return self.returncode == 0
+
+
+def run_subprocess(
+    cmd: List[str],
+    timeout: Optional[float] = None,
+    capture_output: bool = True,
+    text: bool = True,
+    cwd: Optional[str] = None,
+    env: Optional[Dict[str, str]] = None,
+    **kwargs
+) -> SubprocessResult:
+    """
+    Run a subprocess with enhanced error handling and timeout support.
+    
+    Args:
+        cmd: Command and arguments to execute
+        timeout: Maximum time to wait for completion (seconds)
+        capture_output: Whether to capture stdout/stderr
+        text: Whether to return text (True) or bytes (False)
+        cwd: Working directory for the subprocess
+        env: Environment variables for the subprocess
+        **kwargs: Additional arguments passed to subprocess.run
+        
+    Returns:
+        SubprocessResult object with returncode, stdout, stderr
+        
+    Raises:
+        SubprocessError: If the subprocess fails or times out
+    """
+    try:
+        result = subprocess.run(
+            cmd,
+            timeout=timeout,
+            capture_output=capture_output,
+            text=text,
+            cwd=cwd,
+            env=env,
+            **kwargs
+        )
+        
+        return SubprocessResult(
+            returncode=result.returncode,
+            stdout=result.stdout if capture_output else "",
+            stderr=result.stderr if capture_output else ""
+        )
+        
+    except subprocess.TimeoutExpired as e:
+        raise SubprocessError(
+            f"Command timed out after {timeout}s: {' '.join(cmd)}",
+            returncode=None,
+            stdout=e.stdout.decode() if e.stdout else "",
+            stderr=e.stderr.decode() if e.stderr else ""
+        )
+    except subprocess.CalledProcessError as e:
+        raise SubprocessError(
+            f"Command failed with return code {e.returncode}: {' '.join(cmd)}",
+            returncode=e.returncode,
+            stdout=e.stdout if e.stdout else "",
+            stderr=e.stderr if e.stderr else ""
+        )
+    except Exception as e:
+        raise SubprocessError(f"Subprocess execution failed: {e}")
+
+
+async def run_subprocess_async(
+    cmd: List[str],
+    timeout: Optional[float] = None,
+    capture_output: bool = True,
+    cwd: Optional[str] = None,
+    env: Optional[Dict[str, str]] = None,
+    **kwargs
+) -> SubprocessResult:
+    """
+    Run a subprocess asynchronously with timeout support.
+    
+    Args:
+        cmd: Command and arguments to execute
+        timeout: Maximum time to wait for completion (seconds)
+        capture_output: Whether to capture stdout/stderr
+        cwd: Working directory for the subprocess
+        env: Environment variables for the subprocess
+        **kwargs: Additional arguments passed to asyncio.create_subprocess_exec
+        
+    Returns:
+        SubprocessResult object with returncode, stdout, stderr
+        
+    Raises:
+        SubprocessError: If the subprocess fails or times out
+    """
+    try:
+        if capture_output:
+            stdout = asyncio.subprocess.PIPE
+            stderr = asyncio.subprocess.PIPE
+        else:
+            stdout = None
+            stderr = None
+            
+        process = await asyncio.create_subprocess_exec(
+            *cmd,
+            stdout=stdout,
+            stderr=stderr,
+            cwd=cwd,
+            env=env,
+            **kwargs
+        )
+        
+        try:
+            stdout_data, stderr_data = await asyncio.wait_for(
+                process.communicate(),
+                timeout=timeout
+            )
+        except asyncio.TimeoutError:
+            process.kill()
+            await process.wait()
+            raise SubprocessError(
+                f"Command timed out after {timeout}s: {' '.join(cmd)}",
+                returncode=None
+            )
+            
+        return SubprocessResult(
+            returncode=process.returncode,
+            stdout=stdout_data.decode() if stdout_data else "",
+            stderr=stderr_data.decode() if stderr_data else ""
+        )
+        
+    except Exception as e:
+        if not isinstance(e, SubprocessError):
+            raise SubprocessError(f"Async subprocess execution failed: {e}")
+        raise
+
+
+def terminate_process_tree(pid: int, timeout: float = 5.0) -> int:
+    """
+    Terminate a process and all its children.
+    
+    Args:
+        pid: Process ID to terminate
+        timeout: Time to wait for graceful termination before force killing
+        
+    Returns:
+        Number of processes terminated
+        
+    Raises:
+        SubprocessError: If the process cannot be terminated
+    """
+    try:
+        parent = psutil.Process(pid)
+    except psutil.NoSuchProcess:
+        return 0
+        
+    # Get all child processes recursively
+    children = parent.children(recursive=True)
+    processes = [parent] + children
+    
+    terminated_count = 0
+    
+    # First, try graceful termination
+    for process in processes:
+        try:
+            process.terminate()
+        except psutil.NoSuchProcess:
+            pass
+            
+    # Wait for processes to terminate gracefully
+    gone, alive = psutil.wait_procs(processes, timeout=timeout)
+    terminated_count += len(gone)
+    
+    # Force kill any remaining processes
+    for process in alive:
+        try:
+            process.kill()
+            terminated_count += 1
+        except psutil.NoSuchProcess:
+            pass
+            
+    return terminated_count
+
+
+def get_process_info(pid: Optional[int] = None) -> Dict[str, Any]:
+    """
+    Get information about a process.
+    
+    Args:
+        pid: Process ID (defaults to current process)
+        
+    Returns:
+        Dictionary with process information
+    """
+    try:
+        process = psutil.Process(pid)
+        return {
+            "pid": process.pid,
+            "name": process.name(),
+            "status": process.status(),
+            "create_time": process.create_time(),
+            "cpu_percent": process.cpu_percent(),
+            "memory_info": process.memory_info()._asdict(),
+            "cmdline": process.cmdline(),
+            "cwd": process.cwd() if hasattr(process, 'cwd') else None,
+            "num_threads": process.num_threads(),
+            "children": [child.pid for child in process.children()]
+        }
+    except psutil.NoSuchProcess:
+        return {"error": f"Process {pid} not found"}
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def monitor_process_resources(pid: int) -> Optional[Dict[str, Any]]:
+    """
+    Monitor resource usage of a process.
+    
+    Args:
+        pid: Process ID to monitor
+        
+    Returns:
+        Dictionary with resource information or None if process not found
+    """
+    try:
+        process = psutil.Process(pid)
+        memory_info = process.memory_info()
+        
+        return {
+            "pid": pid,
+            "cpu_percent": process.cpu_percent(),
+            "memory_mb": memory_info.rss / 1024 / 1024,  # Convert to MB
+            "memory_percent": process.memory_percent(),
+            "num_threads": process.num_threads(),
+            "status": process.status(),
+            "create_time": process.create_time()
+        }
+    except psutil.NoSuchProcess:
+        return None
+    except Exception:
+        return None
+
+
+def cleanup_orphaned_processes(pattern: str, max_age_hours: float = 1.0) -> int:
+    """
+    Clean up orphaned processes matching a pattern.
+    
+    Args:
+        pattern: String pattern to match in process command line
+        max_age_hours: Maximum age in hours before considering a process orphaned
+        
+    Returns:
+        Number of processes cleaned up
+    """
+    current_time = time.time()
+    cleanup_count = 0
+    
+    for process in psutil.process_iter(['pid', 'name', 'cmdline', 'create_time']):
+        try:
+            cmdline = ' '.join(process.info['cmdline'] or [])
+            if pattern in cmdline:
+                # Check if process is old enough to be considered orphaned
+                age_hours = (current_time - process.info['create_time']) / 3600
+                if age_hours > max_age_hours:
+                    process.terminate()
+                    cleanup_count += 1
+        except (psutil.NoSuchProcess, psutil.AccessDenied):
+            continue
+            
+    return cleanup_count

{claude_mpm-3.9.8.dist-info → claude_mpm-3.9.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.9.8
+Version: 3.9.9
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -181,6 +181,8 @@ Comprehensive API documentation is available at [docs/api/](docs/api/) - build w
 
 **Major Architecture Refactoring (TSK-0053)**: Complete service-oriented redesign with 50-80% performance improvements, enhanced security, and interface-based design.
 
+**Process Management Improvements**: Enhanced hook system reliability with automatic process cleanup, timeout protection, and orphan process monitoring to prevent resource leaks.
+
 See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
 
 ## Development

{claude_mpm-3.9.8.dist-info → claude_mpm-3.9.9.dist-info}/RECORD

@@ -1,7 +1,7 @@
-claude_mpm/VERSION,sha256=h01io9HCAB1m4bnlQNdifYpyeVWWMCfYdccCRf4Vw2A,6
+claude_mpm/VERSION,sha256=AZyavayorqiuMCFTau7LwYJ4R-VH84F2LR8vijsz9DM,6
 claude_mpm/__init__.py,sha256=_adJRYaqKpyQFHGdsXrUgODkLmAXt4NRTj8khx4miAY,1512
 claude_mpm/__main__.py,sha256=8IcM9tEbTqSN_er04eKTPX3AGo6qzRiTnPI7KfIf7rw,641
-claude_mpm/constants.py,sha256=2r2YXHgILU9Vf_HW3alxx7Ma6rk72C0-arsyDqLMZrY,5248
+claude_mpm/constants.py,sha256=OL5pmvmOeJHnORsWBNWk-dCAmG8-Stk7ntfURL5HXfo,5510
 claude_mpm/deployment_paths.py,sha256=JO7-fhhp_AkVB7ZssggHDBbee-r2sokpkqjoqnQLTmM,9073
 claude_mpm/init.py,sha256=hK_ROp6FsgTjpi-VJ_Z4FJICNEXwchh6F2KOqms-kfI,14938
 claude_mpm/ticket_wrapper.py,sha256=bWjLReYyuHSBguuiRm1d52rHYNHqrPJAOLUbMt4CnuM,836
@@ -15,7 +15,7 @@ claude_mpm/agents/agent_loader.py,sha256=DgY0CMShaxdANV5GYT1Bd-lYizRKz89KpuR89VR
 claude_mpm/agents/agent_loader_integration.py,sha256=h07Kmk4D75jmHxz5BucP6oQ5VhqVgQ35Sn5w3hcZNYI,7474
 claude_mpm/agents/agents_metadata.py,sha256=C8GzqXB-AdWUzz2gpR-Dz3V2phUTbi1TRg1Xmxtdgxc,5853
 claude_mpm/agents/async_agent_loader.py,sha256=jHW3N13au-TlFSyo1_NhI8aExCt8QNumoWlrdtLp6V4,15145
-claude_mpm/agents/base_agent.json,sha256=Te1_Xi8zGoPKY_i4aYekyOqu-AVKqOcwVq-a41as9bA,5406
+claude_mpm/agents/base_agent.json,sha256=uzNGCmojfh8Xr5MnahvpaIdX1rx94UOzgiN9Au5o5u4,5406
 claude_mpm/agents/base_agent_loader.py,sha256=Ur2pcYQXInS_z8MAD3154rvPn-zEpD2fx66iTSRDtY4,19015
 claude_mpm/agents/frontmatter_validator.py,sha256=OR6DWgGxV7b6A6WPAM9ikkDqCJitmp3UgYC45TkB5ZU,22630
 claude_mpm/agents/system_agent_config.py,sha256=Lke4FFjU0Vq3LLo4O7KvtHxadP7agAwC-ljCXK40h_A,23526
@@ -30,17 +30,11 @@ claude_mpm/agents/templates/ops.json,sha256=pXDc2RUQVv5qqDtZ9LGHXYFoccNkH5mBYIYH
 claude_mpm/agents/templates/project_organizer.json,sha256=d1VKgiT0t7GjUBp88kgqbW6A4txgHrFRYPNvrDYkJ80,17161
 claude_mpm/agents/templates/qa.json,sha256=ObztCsMr9haahOaHvaLDRHYj1TZwRxECuzluKscUb_M,10807
 claude_mpm/agents/templates/research.json,sha256=WlPnKlojeiCBZ4H75nWexLl_dHU5cSORIqLCDp4tCMM,8419
-claude_mpm/agents/templates/research_memory_efficient.json,sha256=WlPnKlojeiCBZ4H75nWexLl_dHU5cSORIqLCDp4tCMM,8419
 claude_mpm/agents/templates/security.json,sha256=KAJOIZeYUPbnC83S2q7ufwdmpS1xrEwWW6H9bvSNVdo,12349
 claude_mpm/agents/templates/ticketing.json,sha256=H4-RJHATbDPv07iK_Heff8GdYZRf3d6uIL9_L_KDKwM,33920
 claude_mpm/agents/templates/version_control.json,sha256=yaRwaFA2JjMzCfGki2RIylKytjiVcn-lJKJ3jzTbuyY,11692
 claude_mpm/agents/templates/web_qa.json,sha256=4enHHY0KonWE7c2zS_P7JPoOG1foarMtI4CzUpZp49k,17634
 claude_mpm/agents/templates/web_ui.json,sha256=M4ILRYG_EhIilUcu93XVlO51BiVh72M4p7XvUbTqkcs,22752
-claude_mpm/agents/templates/.claude-mpm/memories/README.md,sha256=gDuLkzgcELaaoEB5Po70F0qabTu11vBi1PnUrYCK3fw,1098
-claude_mpm/agents/templates/.claude-mpm/memories/engineer_agent.md,sha256=oX-L8D2oyS-NAoe5UNVTbfmLWYTpp1gYq6dKAm6KxLI,1150
-claude_mpm/agents/templates/.claude-mpm/memories/qa_agent.md,sha256=3GOmBq3t3y1-mvWC7_lJ4ltsujJ14wCZCSzEVWCIrz8,1065
-claude_mpm/agents/templates/.claude-mpm/memories/research_agent.md,sha256=dPeQQlV0Rb0-hw4hjca71rzT78PkL3I6YHUHF0aw-XQ,1150
-claude_mpm/agents/templates/.claude-mpm/memories/version_control_agent.md,sha256=ghepeG5Wneo2Q5kWI0mu2oWxnVVzoYr0YEBFzqOiCd0,1091
 claude_mpm/agents/templates/backup/data_engineer_agent_20250726_234551.json,sha256=lLso4RHXVTQmX4A1XwF84kT59zZDblPO1xCgBj4S4x8,5060
 claude_mpm/agents/templates/backup/documentation_agent_20250726_234551.json,sha256=snfJW2yW9aMv9ldCSIWW7zwnyoQRx5u7xLMkNlfus9I,2258
 claude_mpm/agents/templates/backup/engineer_agent_20250726_234551.json,sha256=21o8TGCM9TO6eocSV9Ev5MmCq-xYwwCqMU7KQESaY2Q,8479
@@ -48,19 +42,21 @@ claude_mpm/agents/templates/backup/ops_agent_20250726_234551.json,sha256=y-unQij
 claude_mpm/agents/templates/backup/qa_agent_20250726_234551.json,sha256=_FHWnUeh151rgWX_xUgXsfGrJz7Bs3wno2lXU0nTwAo,2157
 claude_mpm/agents/templates/backup/research_agent_2025011_234551.json,sha256=pk2Tg0GVSPEkPEnMw5Iax5QUFY8XY7uF1uPG6eHBe14,12336
 claude_mpm/agents/templates/backup/research_agent_20250726_234551.json,sha256=o4n_sqSbjnsFRELB2q501vgwm-o2tQNLJLYvnVP9LWU,5629
+claude_mpm/agents/templates/backup/research_memory_efficient.json,sha256=WlPnKlojeiCBZ4H75nWexLl_dHU5cSORIqLCDp4tCMM,8419
 claude_mpm/agents/templates/backup/security_agent_20250726_234551.json,sha256=l5YuD-27CxKSOsRLv0bDY_tCZyds0yGbeizLb8paeFY,2322
 claude_mpm/agents/templates/backup/version_control_agent_20250726_234551.json,sha256=too38RPTLJ9HutCMn0nfmEdCj2me241dx5tUYDFtu94,2143
-claude_mpm/cli/__init__.py,sha256=0qY86ZM7_C6xHUTQAGyG7D6kQuRJ_aNU0sqkDujqsYk,7060
+claude_mpm/cli/__init__.py,sha256=N6VLSwB8ogCbv4gDGcX2XbVLKo2usdp1C4Tm3hGEaSI,7119
 claude_mpm/cli/__main__.py,sha256=vShalycGU13i1-OOixEb_bjl8da4_FolrKdvoiZB-64,769
-claude_mpm/cli/parser.py,sha256=ocmgSLo8Wucgw14Q9oBj4F3bfL3f3vwDW6ng_sXzM9E,31010
+claude_mpm/cli/parser.py,sha256=Z1LG3-RvnHiEvlIWC-9fLz_Q7JU5R88lrPStIiRMJxA,35081
 claude_mpm/cli/ticket_cli.py,sha256=Jftgan7t7ZGNWo9zuZoPcw5zItCrVpBjPSOWz3FuIXE,919
 claude_mpm/cli/utils.py,sha256=qNIbQcA6iE46lsve-GyoIw6eyd9ksHZz3tQA4bSmtt8,6325
-claude_mpm/cli/commands/__init__.py,sha256=ebHYAmkAlbAv8Y19rrNQF6ZkFOWOnvAU0XYHl-l3oEE,729
+claude_mpm/cli/commands/__init__.py,sha256=XzHpYgA2RIVmDeYJ2Rx3YWzSc-sbyYTzO8QKbNjbGv4,775
 claude_mpm/cli/commands/agents.py,sha256=E8Nyn2NyZqpHmQiK9t7-r1AfcCZFKLFMsKuo6Ed5T08,33831
 claude_mpm/cli/commands/aggregate.py,sha256=rFFIYlOosGnw_DvTuWKw_6sxJeYag3RdACPSz0RHZyE,14869
-claude_mpm/cli/commands/cleanup.py,sha256=9N-oMZgHXKf4nAyiMlSG9DbSbjUndac5SxmQEItMZrU,14324
+claude_mpm/cli/commands/cleanup.py,sha256=wdaL6Mtv3030QQbwAMm3hYv10koyw7hsNlj48GjYOHs,15076
 claude_mpm/cli/commands/config.py,sha256=50LzTVlvR1LbeW25i-oSx4D6BZGa48DXuLLGXKhejyk,9919
 claude_mpm/cli/commands/info.py,sha256=ETL6jC08OTQVTPjs219Y0m3FzfKOUlI0-yI81AI8FXY,2990
+claude_mpm/cli/commands/mcp.py,sha256=C96QiWt4r3CX_9cnBavJl0CeaNDuqQXX9CKwSL8LUgg,27291
 claude_mpm/cli/commands/memory.py,sha256=ymw4EatEKHfvvMHSy6dr4-x9OB7e1nZdJS0EP0f5paI,37350
 claude_mpm/cli/commands/monitor.py,sha256=80_tmSdfn_2cYpzxxPu9GnvFW0eixlSJ4wCqbn8VSCM,12407
 claude_mpm/cli/commands/run.py,sha256=cn-IcH2S4ss0-NRmyu7R2n0qzk7KIUoRhJXd3h5G7g4,43550
@@ -71,6 +67,7 @@ claude_mpm/cli_module/commands.py,sha256=CBNfO-bXrZ0spjeW_7-swprEq5V4PQSc0qhl9SL
 claude_mpm/cli_module/migration_example.py,sha256=C-_GbsW8dGzutnNeRLLld74ibDLyAOQx0stdpYZS0hs,6137
 claude_mpm/config/__init__.py,sha256=KTJkOHVtC1t6goMkj2xaQWZKZfokEHNw0wxPE48bl1g,828
 claude_mpm/config/agent_config.py,sha256=QS-25LSiNz4uOocjIM_FX_SGoRQHJOfkBZCKlz09K5k,13830
+claude_mpm/config/memory_guardian_config.py,sha256=j4b73FJUEcKXARZnpF0Wn18N8T8KEQZSka9KprgrdM4,13243
 claude_mpm/config/paths.py,sha256=MznUhL7kvpOhwqtNdOavEE1JvUauvfIN_8PUXl8MytU,12553
 claude_mpm/config/socketio_config.py,sha256=rf5XKtdAKeypwZZPF8r6uSHnJHVXeMmX1YiYQmzUOZo,9727
 claude_mpm/core/__init__.py,sha256=5Hdb4fLdMEqXdOeBJB0zFGJx8CxtaSRYIiD-foiz3yQ,874
@@ -137,12 +134,13 @@ claude_mpm/hooks/memory_integration_hook.py,sha256=z0I5R4rsmLx3mzYf7QLeMTYbRShag
 claude_mpm/hooks/tool_call_interceptor.py,sha256=08_Odgm6Sg1zBJhGjwzVa03AReeBPZHTjndyjEO99cY,7629
 claude_mpm/hooks/validation_hooks.py,sha256=7TU2N4SzCm2nwpsR0xiNKsHQNsWODnOVAmK9jHq1QqM,6582
 claude_mpm/hooks/claude_hooks/__init__.py,sha256=bMUwt2RzDGAcEbtDMA7vWS1uJsauOY0OixIe4pHwgQ0,129
-claude_mpm/hooks/claude_hooks/hook_handler.py,sha256=hMJRlFIpYtl3SGDMseS1_kiXMrzm_w1mFG-oqU5hJ8Q,79765
+claude_mpm/hooks/claude_hooks/hook_handler.py,sha256=LrAe0fcrfWYac3a6lm22SfwDHQeMG3-M50fC-1lWgvY,81736
 claude_mpm/hooks/claude_hooks/hook_handler_fixed.py,sha256=hYE5Tc4RaaK0kLmFNLVXvDhiuTLA40Gt3hmhCQUO5UA,15626
 claude_mpm/hooks/claude_hooks/hook_wrapper.sh,sha256=JBbedWNs1EHaUsAkmqfPv_tWxV_DcRP707hma74oHU0,2370
 claude_mpm/models/__init__.py,sha256=vy2NLX2KT9QeH76SjCYh9dOYKPLRgxGrnwkQFAg08gc,465
 claude_mpm/models/agent_definition.py,sha256=y9XQOED_maOyiYKhNB8H8MfJJMBN0vIYPS_wCXnRJmA,6647
 claude_mpm/models/agent_session.py,sha256=cBl71q33TIBX8S6U1w2UnKOjEWyypFB04s0BCyKv0iQ,20174
+claude_mpm/models/state_models.py,sha256=3osnbGKTUe0gX6ogMUGwF6jNzlZyIYfZT8xbcRKk21E,14787
 claude_mpm/scripts/__init__.py,sha256=zKYLZfT0P5z7C7r1YrhsTDnnyFXY-2awxhLVPYx68ek,552
 claude_mpm/scripts/socketio_daemon.py,sha256=93jzq-h5GQRK-xYpLaovaqNAXtwR_ZqYjmEMmFn0xE8,9741
 claude_mpm/scripts/start_activity_logging.py,sha256=9xTu6Kd9lmCx17vMmoAGRXegoaZIVqLzLJoXQDeZ9Yw,2917
@@ -189,8 +187,8 @@ claude_mpm/services/agents/registry/__init__.py,sha256=_NsxGhhykoj0NecfA4o8Xscrv
 claude_mpm/services/agents/registry/agent_registry.py,sha256=jb-hIDGAoLWqBauS49N5Iin-nSozspGgUtb-gAROCfc,31570
 claude_mpm/services/agents/registry/deployed_agent_discovery.py,sha256=EFsrutLB3Kxa5TXoQC2aVNx5cMIAaDcTqCBnF1FfrPc,9762
 claude_mpm/services/agents/registry/modification_tracker.py,sha256=efkl652bAHhxUc6keoE2dOxlaQXtDnC3lkmR_jat4u4,34565
-claude_mpm/services/communication/__init__.py,sha256=7sa76Pvv0-gAE7wrWW6J3oVg8yM3SFZ86utUiLR8GT0,526
-claude_mpm/services/communication/socketio.py,sha256=C4uvt7BgtX8n_xE77CDPEdztygkZUEPqkLix0kcBB8k,90265
+claude_mpm/services/communication/__init__.py,sha256=B4q9qUsRpjWglmZ57wO0ynIg02xTmgo7n3cuW73rUMY,558
+claude_mpm/services/communication/socketio.py,sha256=sbNCo7wi7exjyWzakmUQohhjGapJv2rCdH49mZU1dfo,90551
 claude_mpm/services/communication/websocket.py,sha256=WAfCm5AzWo2sNjzJGWOhyvJv3ah-KiGAk7-rgl9V7FU,18344
 claude_mpm/services/core/__init__.py,sha256=mWqf6wfzspDgrue_ktLkK12LyxNrJJCfMJP72TpQVoc,2420
 claude_mpm/services/core/base.py,sha256=mgv9p-hyIh6_3PIYvNBzEvOoKPd-9E04JlzKP2L1khc,7570
@@ -214,10 +212,12 @@ claude_mpm/services/framework_claude_md_generator/section_generators/role_design
 claude_mpm/services/framework_claude_md_generator/section_generators/subprocess_validation.py,sha256=eqj2nNXtOZ8KkMyINpkU-JLDfXHY81MpKhf_qmnZdUc,4117
 claude_mpm/services/framework_claude_md_generator/section_generators/todo_task_tools.py,sha256=xTm2_K1iSizg2E7NnP7vXS3r3oiMmv5cdGPt9C5XE8E,5767
 claude_mpm/services/framework_claude_md_generator/section_generators/troubleshooting.py,sha256=_wYqXRj6z48bJjX7zb_7Zacx5G9LXNDZpsUxvBe27DE,1888
-claude_mpm/services/infrastructure/__init__.py,sha256=rZir3Ktwc0Dyrc0Sl2rAn7h6uc8VBp7QWcnRRK3kQ5Y,504
-claude_mpm/services/infrastructure/logging.py,sha256=LuujazzNebzfOCB921wSAUpGDrIxkMrlsvLxI4e1RRo,6693
+claude_mpm/services/infrastructure/__init__.py,sha256=1e900yFJ6MSjbmc7XH3d_Dn8aHdn2g5cvEcSFyupHLQ,662
+claude_mpm/services/infrastructure/logging.py,sha256=7gzjWZI8-GFXAjnRimx06gDqhaWy90l3DhixZs3jP9Q,6696
+claude_mpm/services/infrastructure/memory_guardian.py,sha256=9NZgSE7F46epkFcp0Z6ql17Yw8gRbXTqmjxoRood8mI,27724
 claude_mpm/services/infrastructure/monitoring.py,sha256=OPyT976wENCMFzid88ovG5HLqCo71evYqTVn5lsJ4SU,33882
-claude_mpm/services/mcp_gateway/__init__.py,sha256=cxoD-Bpwfg--W7P_c0KY6vUjy8HrlUdCAo5s9KjAGGY,3866
+claude_mpm/services/mcp_gateway/__init__.py,sha256=PxLMTsjJt6KvWyUDhZG4G_hPbT4-bk_ZgvzODnJAYoA,4522
+claude_mpm/services/mcp_gateway/main.py,sha256=z9tatWvsbjH2EWVMgaAv1TMkh_lgPlN-ElL6Ma5ao1A,10512
 claude_mpm/services/mcp_gateway/config/__init__.py,sha256=nBj4JSBi2A9TFNXw_nM6tdoLMrServ-yqzMBvFruGlg,385
 claude_mpm/services/mcp_gateway/config/config_loader.py,sha256=dIajqrDboSY7ArAoAOzlXqQarqix6i9ZEjpcVpofygo,7611
 claude_mpm/services/mcp_gateway/config/config_schema.py,sha256=cP1FZoLd_RSuFnP51aLN36f2ifzDWQalBAEeisHUj_Y,9452
@@ -226,9 +226,17 @@ claude_mpm/services/mcp_gateway/core/__init__.py,sha256=5alHHmyb6SKrF-HX00fALk8L
 claude_mpm/services/mcp_gateway/core/base.py,sha256=zZ36EYvjLEhm75E4q7sB5SZltYCGp4N3SrP3Tu9DHOE,10639
 claude_mpm/services/mcp_gateway/core/exceptions.py,sha256=aygJk4qLI4dJXvpBhvxXz9GS7WlBxtHvaXMIUWhmx6M,6924
 claude_mpm/services/mcp_gateway/core/interfaces.py,sha256=Z1b71vA444yExicMZr9PCzlY7Y9iRS-E6kdkcvKcmt0,11075
-claude_mpm/services/mcp_gateway/registry/__init__.py,sha256=ePGM1q7smHcPo0kKgzDfMXIfg4Vs35xq_J_7pnSgePI,221
-claude_mpm/services/mcp_gateway/server/__init__.py,sha256=aLT78iptTwoCOjMgFV5gyyWQwmbj1Z2aV1ClZYMTyJY,210
-claude_mpm/services/mcp_gateway/tools/__init__.py,sha256=n7niUlLV7DMk6VfpAJyIQRPibdZSuIQLO-kiZ9-04eo,230
+claude_mpm/services/mcp_gateway/registry/__init__.py,sha256=j7wwnvIhbZrhL1aZdvefvT4pLKAsrAk8uC4Cpjgrdo0,194
+claude_mpm/services/mcp_gateway/registry/service_registry.py,sha256=1AZD0U1kVQV9yrv374zWLYP3JG3kcptGp28CKFUb7I0,13895
+claude_mpm/services/mcp_gateway/registry/tool_registry.py,sha256=sGb5vEaGKXcZgce2wzDIFEZaNQkC6sJWhnjtcWanewk,16754
+claude_mpm/services/mcp_gateway/server/__init__.py,sha256=L7RSyO6hxvs-kR335udll_a0UUzr45msR7E0rzFK3Ck,290
+claude_mpm/services/mcp_gateway/server/mcp_server.py,sha256=IbpR3S25cHSCb2BZeVaJxEZu2j9soj6fYbqNz_C7qwk,14318
+claude_mpm/services/mcp_gateway/server/mcp_server_simple.py,sha256=952GDCHVzMtmTAmJhZ4YxQWU0c8zqNdiAb7w2gVv21o,15045
+claude_mpm/services/mcp_gateway/server/stdio_handler.py,sha256=g64TmOBNKlaSHf6YrBQiIUzKrqUjD6mjAoCAjqwemfU,12106
+claude_mpm/services/mcp_gateway/tools/__init__.py,sha256=_p0VKMum_dmbfLqKMPAHCr7fDAsgyHBInhOGYti-e6E,453
+claude_mpm/services/mcp_gateway/tools/base_adapter.py,sha256=YW6CBRoB6ev8bWIDxX4BykNgxbpczSv1cogHUXqC7ug,16736
+claude_mpm/services/mcp_gateway/tools/document_summarizer.py,sha256=X48-lTOedfuQQL_ezpi3dRfSsrPbg64h7x5biEs5qVQ,28153
+claude_mpm/services/mcp_gateway/tools/hello_world.py,sha256=x0Pm97VTvSqkSXvBeTxh07JLXOFbJyQEWneQoC-udjU,20866
 claude_mpm/services/memory/__init__.py,sha256=XkRcNRalLYPClYc8CX9PNhmSqSI5FNHatMfiGHCuW4o,394
 claude_mpm/services/memory/builder.py,sha256=a3X3mZsd3YxmhwOYsAmbpmCACkoKxcuKuyHXPa26gqs,34075
 claude_mpm/services/memory/indexed_memory.py,sha256=nb2bVxFelNyJ9GINw5mPABj8wNJJ23XyTNZ9NgywB1w,20098
@@ -264,19 +272,22 @@ claude_mpm/utils/dependency_manager.py,sha256=2Gs881HkzwMEm7X2z7Lx8l2Lws4PvS-rPB
 claude_mpm/utils/dependency_strategies.py,sha256=83YZ45ZAwgFN_hhCSUaDv__QR0AWTqBGWMwnBxmiF1Q,11473
 claude_mpm/utils/environment_context.py,sha256=ZbtarJ3gUPF9cLKYIG_vtpZYowetyDxKpz0FPW0Wpu8,10527
 claude_mpm/utils/error_handler.py,sha256=7fVcmQIoj-mmdmibEts7aJit-XMbuCOrxbJmLuUBaZQ,8174
+claude_mpm/utils/file_utils.py,sha256=SGU6056Z_cFF1cmnfI1xiVlS0s8pGaSoP99YCkmXDE8,7402
 claude_mpm/utils/framework_detection.py,sha256=nzs1qRZK9K-zT0382z1FpGDvgzUNrUg8rBL-O_WLq-Q,1217
 claude_mpm/utils/import_migration_example.py,sha256=W4a4XH3FY_VBB00BB8Lae2aRPM021PxLHzdUfEs0B5w,2463
 claude_mpm/utils/imports.py,sha256=wX-SOXUHbemx01MHRGQpVwajzXH6qYdQkYNFCIbb2mw,6851
 claude_mpm/utils/path_operations.py,sha256=6pLMnAWBVzHkgp6JyQHmHbGD-dWn-nX21yV4E_eT-kM,11614
 claude_mpm/utils/paths.py,sha256=_4d2uV7QDLMeybSNch6B5H3s0cQ6Ii-idI8rFC-OCn4,14653
+claude_mpm/utils/platform_memory.py,sha256=pEufP7UWB59k_7ID2sxN3MRtEDjNhW9Cn8rZIRkGbf8,16757
 claude_mpm/utils/robust_installer.py,sha256=5-iW4Qpba4DBitx5Ie3uoUJgXBpbvuLUJ_uNGgOxwi4,19855
 claude_mpm/utils/session_logging.py,sha256=9G0AzB7V0WkhLQlN0ocqbyDv0ifooEsJ5UPXIhA-wt0,3022
+claude_mpm/utils/subprocess_utils.py,sha256=MLXIOUZ-Wk3j0lv_nOHTcppjR8_NNj_vCCZ5dTJ0Mig,9317
 claude_mpm/validation/__init__.py,sha256=bJ19g9lnk7yIjtxzN8XPegp87HTFBzCrGQOpFgRTf3g,155
 claude_mpm/validation/agent_validator.py,sha256=OEYhmy0K99pkoCCoVea2Q-d1JMiDyhEpzEJikuF8T-U,20910
 claude_mpm/validation/frontmatter_validator.py,sha256=vSinu0XD9-31h0-ePYiYivBbxTZEanhymLinTCODr7k,7206
-claude_mpm-3.9.8.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
-claude_mpm-3.9.8.dist-info/METADATA,sha256=Ug3P-YCt3Ygy2GYebTt0Lfc8PP6sns2pKZ4zvr8VjVU,8706
-claude_mpm-3.9.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-3.9.8.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
-claude_mpm-3.9.8.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-3.9.8.dist-info/RECORD,,
+claude_mpm-3.9.9.dist-info/licenses/LICENSE,sha256=cSdDfXjoTVhstrERrqme4zgxAu4GubU22zVEHsiXGxs,1071
+claude_mpm-3.9.9.dist-info/METADATA,sha256=d1RGEytLoAibDyKIYVpG8gJiu5E0ACH7Jg8waLW9kV8,8886
+claude_mpm-3.9.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-3.9.9.dist-info/entry_points.txt,sha256=3_d7wLrg9sRmQ1SfrFGWoTNL8Wrd6lQb2XVSYbTwRIg,324
+claude_mpm-3.9.9.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-3.9.9.dist-info/RECORD,,

claude_mpm/agents/templates/.claude-mpm/memories/README.md

@@ -1,36 +0,0 @@
-# Agent Memory System
-
-## Purpose
-Each agent maintains project-specific knowledge in these files. Agents read their memory file before tasks and update it when they learn something new.
-
-## Manual Editing
-Feel free to edit these files to:
-- Add project-specific guidelines
-- Remove outdated information  
-- Reorganize for better clarity
-- Add domain-specific knowledge
-
-## Memory Limits
-- Max file size: 8KB (~2000 tokens)
-- Max sections: 10
-- Max items per section: 15
-- Files auto-truncate when limits exceeded
-
-## File Format
-Standard markdown with structured sections. Agents expect:
-- Project Architecture
-- Implementation Guidelines
-- Common Mistakes to Avoid
-- Current Technical Context
-
-## How It Works
-1. Agents read their memory file before starting tasks
-2. Agents add learnings during or after task completion
-3. Files automatically enforce size limits
-4. Developers can manually edit for accuracy
-
-## Memory File Lifecycle
-- Created automatically when agent first runs
-- Updated through hook system after delegations
-- Manually editable by developers
-- Version controlled with project

claude_mpm/agents/templates/.claude-mpm/memories/engineer_agent.md

@@ -1,39 +0,0 @@
-# Engineer Agent Memory - templates
-
-<!-- MEMORY LIMITS: 8KB max | 10 sections max | 15 items per section -->
-<!-- Last Updated: 2025-08-13 14:34:34 | Auto-updated by: engineer -->
-
-## Project Context
-templates: mixed standard application
-
-## Project Architecture
-- Standard Application with mixed implementation
-
-## Coding Patterns Learned
-<!-- Items will be added as knowledge accumulates -->
-
-## Implementation Guidelines
-<!-- Items will be added as knowledge accumulates -->
-
-## Domain-Specific Knowledge
-<!-- Agent-specific knowledge for templates domain -->
-- Key project terms: templates
-- Focus on implementation patterns, coding standards, and best practices
-
-## Effective Strategies
-<!-- Successful approaches discovered through experience -->
-
-## Common Mistakes to Avoid
-<!-- Items will be added as knowledge accumulates -->
-
-## Integration Points
-<!-- Items will be added as knowledge accumulates -->
-
-## Performance Considerations
-<!-- Items will be added as knowledge accumulates -->
-
-## Current Technical Context
-<!-- Items will be added as knowledge accumulates -->
-
-## Recent Learnings
-<!-- Most recent discoveries and insights -->

claude_mpm/agents/templates/.claude-mpm/memories/qa_agent.md

@@ -1,38 +0,0 @@
-# Qa Agent Memory - templates
-
-<!-- MEMORY LIMITS: 8KB max | 10 sections max | 15 items per section -->
-<!-- Last Updated: 2025-08-13 14:37:34 | Auto-updated by: qa -->
-
-## Project Context
-templates: mixed standard application
-
-## Project Architecture
-- Standard Application with mixed implementation
-
-## Coding Patterns Learned
-<!-- Items will be added as knowledge accumulates -->
-
-## Implementation Guidelines
-<!-- Items will be added as knowledge accumulates -->
-
-## Domain-Specific Knowledge
-<!-- Agent-specific knowledge for templates domain -->
-- Key project terms: templates
-
-## Effective Strategies
-<!-- Successful approaches discovered through experience -->
-
-## Common Mistakes to Avoid
-<!-- Items will be added as knowledge accumulates -->
-
-## Integration Points
-<!-- Items will be added as knowledge accumulates -->
-
-## Performance Considerations
-<!-- Items will be added as knowledge accumulates -->
-
-## Current Technical Context
-<!-- Items will be added as knowledge accumulates -->
-
-## Recent Learnings
-<!-- Most recent discoveries and insights -->

claude_mpm/agents/templates/.claude-mpm/memories/research_agent.md

@@ -1,39 +0,0 @@
-# Research Agent Memory - templates
-
-<!-- MEMORY LIMITS: 16KB max | 10 sections max | 15 items per section -->
-<!-- Last Updated: 2025-08-13 14:29:28 | Auto-updated by: research -->
-
-## Project Context
-templates: mixed standard application
-
-## Project Architecture
-- Standard Application with mixed implementation
-
-## Coding Patterns Learned
-<!-- Items will be added as knowledge accumulates -->
-
-## Implementation Guidelines
-<!-- Items will be added as knowledge accumulates -->
-
-## Domain-Specific Knowledge
-<!-- Agent-specific knowledge for templates domain -->
-- Key project terms: templates
-- Focus on code analysis, pattern discovery, and architectural insights
-
-## Effective Strategies
-<!-- Successful approaches discovered through experience -->
-
-## Common Mistakes to Avoid
-<!-- Items will be added as knowledge accumulates -->
-
-## Integration Points
-<!-- Items will be added as knowledge accumulates -->
-
-## Performance Considerations
-<!-- Items will be added as knowledge accumulates -->
-
-## Current Technical Context
-<!-- Items will be added as knowledge accumulates -->
-
-## Recent Learnings
-<!-- Most recent discoveries and insights -->