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

claude_mpm/services/mcp_gateway/tools/__init__.py

@@ -14,11 +14,12 @@ from .base_adapter import (
 from .document_summarizer import DocumentSummarizerTool
 from .kuzu_memory_service import (
     KuzuMemoryService,
-    store_memory,
+    get_context,
     recall_memories,
     search_memories,
-    get_context,
+    store_memory,
 )
+
 # Ticket tools removed - using mcp-ticketer instead
 
 __all__ = [
@@ -26,10 +27,10 @@ __all__ = [
     "CalculatorToolAdapter",
     "DocumentSummarizerTool",
     "EchoToolAdapter",
-    "SystemInfoToolAdapter",
     "KuzuMemoryService",
-    "store_memory",
+    "SystemInfoToolAdapter",
+    "get_context",
     "recall_memories",
     "search_memories",
-    "get_context",
+    "store_memory",
 ]

claude_mpm/services/mcp_gateway/tools/external_mcp_services.py

@@ -432,7 +432,9 @@ class ExternalMCPServiceManager:
                             f"Initialized external service: {service.service_name}"
                         )
                 elif self.logger:
-                    self.logger.debug(f"Service not available (optional): {service.service_name}")
+                    self.logger.debug(
+                        f"Service not available (optional): {service.service_name}"
+                    )
             except Exception as e:
                 if self.logger:
                     self.logger.error(f"Error initializing {service.service_name}: {e}")

claude_mpm/services/mcp_gateway/tools/kuzu_memory_service.py

@@ -17,17 +17,15 @@ DESIGN DECISIONS:
 
 import json
 import subprocess
-import sys
-from datetime import datetime
 from pathlib import Path
 from typing import Any, Dict, List, Optional
 
-from claude_mpm.services.mcp_gateway.tools.base_adapter import BaseToolAdapter
 from claude_mpm.services.mcp_gateway.core.interfaces import (
     MCPToolDefinition,
     MCPToolInvocation,
     MCPToolResult,
 )
+from claude_mpm.services.mcp_gateway.tools.base_adapter import BaseToolAdapter
 
 
 class KuzuMemoryService(BaseToolAdapter):
@@ -181,45 +179,33 @@ class KuzuMemoryService(BaseToolAdapter):
         try:
             if action == "store":
                 result = await self.store_memory(
-                    params.get("content"),
-                    params.get("tags"),
-                    {}  # metadata
+                    params.get("content"), params.get("tags"), {}  # metadata
                 )
             elif action == "recall":
                 result = await self.recall_memories(
-                    params.get("query"),
-                    params.get("limit", 5),
-                    params.get("tags")
+                    params.get("query"), params.get("limit", 5), params.get("tags")
                 )
             elif action == "search":
                 result = await self.search_memories(
                     params.get("query", ""),
                     "both",  # search_type
-                    params.get("limit", 10)
+                    params.get("limit", 10),
                 )
             elif action == "context":
                 result = await self.get_context(
-                    params.get("query", ""),
-                    2,  # depth
-                    True  # include_related
+                    params.get("query", ""), 2, True  # depth  # include_related
                 )
             else:
-                return MCPToolResult(
-                    success=False,
-                    error=f"Unknown action: {action}"
-                )
+                return MCPToolResult(success=False, error=f"Unknown action: {action}")
 
             return MCPToolResult(
                 success=result.get("success", False),
                 data=result,
-                error=result.get("error")
+                error=result.get("error"),
             )
 
         except Exception as e:
-            return MCPToolResult(
-                success=False,
-                error=str(e)
-            )
+            return MCPToolResult(success=False, error=str(e))
 
     def validate_parameters(self, parameters: Dict[str, Any]) -> bool:
         """Validate tool parameters - basic implementation."""
@@ -227,8 +213,7 @@ class KuzuMemoryService(BaseToolAdapter):
 
     async def shutdown(self) -> None:
         """Shutdown the service."""
-        pass  # No resources to clean up
-
+        # No resources to clean up
 
     async def store_memory(
         self,
@@ -264,13 +249,13 @@ class KuzuMemoryService(BaseToolAdapter):
                 capture_output=True,
                 text=True,
                 timeout=10,
-                cwd=str(self.project_path),
+                cwd=str(self.project_path), check=False,
             )
 
             if result.returncode == 0:
                 return {
                     "success": True,
-                    "message": f"Memory stored successfully",
+                    "message": "Memory stored successfully",
                     "content": content[:100],
                     "tags": tags or [],
                 }
@@ -330,7 +315,7 @@ class KuzuMemoryService(BaseToolAdapter):
                 capture_output=True,
                 text=True,
                 timeout=10,
-                cwd=str(self.project_path),
+                cwd=str(self.project_path), check=False,
             )
 
             if result.returncode == 0 and result.stdout:
@@ -399,7 +384,7 @@ class KuzuMemoryService(BaseToolAdapter):
                 capture_output=True,
                 text=True,
                 timeout=10,
-                cwd=str(self.project_path),
+                cwd=str(self.project_path), check=False,
             )
 
             if result.returncode == 0 and result.stdout:
@@ -476,7 +461,7 @@ class KuzuMemoryService(BaseToolAdapter):
                 capture_output=True,
                 text=True,
                 timeout=15,
-                cwd=str(self.project_path),
+                cwd=str(self.project_path), check=False,
             )
 
             if result.returncode == 0 and result.stdout:
@@ -484,7 +469,7 @@ class KuzuMemoryService(BaseToolAdapter):
                     "success": True,
                     "topic": topic,
                     "context": result.stdout.strip(),
-                    "memories": []  # Enhanced context is already processed
+                    "memories": [],  # Enhanced context is already processed
                 }
 
             # Fallback to recall if enhance fails
@@ -539,4 +524,4 @@ async def get_context(
     """Get enriched context for a topic."""
     service = KuzuMemoryService()
     await service.initialize()
-    return await service.get_context(topic, depth, include_related)
+    return await service.get_context(topic, depth, include_related)

claude_mpm/services/memory/cache/simple_cache.py

@@ -22,8 +22,8 @@ from pathlib import Path
 from typing import Any, Dict, List, Optional, Set
 
 from claude_mpm.core.interfaces import ICacheService
-
 from claude_mpm.core.logging_utils import get_logger
+
 logger = get_logger(__name__)
 
 

claude_mpm/services/project/archive_manager.py

@@ -25,12 +25,13 @@ import shutil
 import subprocess
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Set, Tuple
+from typing import Dict, List, Optional, Tuple
 
 from rich.console import Console
 from rich.table import Table
 
 from claude_mpm.core.logging_utils import get_logger
+
 logger = get_logger(__name__)
 console = Console()
 
@@ -125,13 +126,15 @@ Generated by Claude MPM Archive Manager
             # Create metadata file if provided
             if metadata or reason:
                 meta_data = metadata or {}
-                meta_data.update({
-                    "original_path": str(file_path),
-                    "archived_at": datetime.now().isoformat(),
-                    "reason": reason or "Manual archive",
-                    "file_size": file_path.stat().st_size,
-                    "file_hash": self._calculate_file_hash(file_path),
-                })
+                meta_data.update(
+                    {
+                        "original_path": str(file_path),
+                        "archived_at": datetime.now().isoformat(),
+                        "reason": reason or "Manual archive",
+                        "file_size": file_path.stat().st_size,
+                        "file_hash": self._calculate_file_hash(file_path),
+                    }
+                )
 
                 meta_path = self.archive_path / f"{archive_name}.meta.json"
                 meta_path.write_text(json.dumps(meta_data, indent=2))
@@ -252,7 +255,9 @@ Generated by Claude MPM Archive Manager
                 "name": archive_file.name,
                 "path": str(archive_file),
                 "size": archive_file.stat().st_size,
-                "modified": datetime.fromtimestamp(archive_file.stat().st_mtime).isoformat(),
+                "modified": datetime.fromtimestamp(
+                    archive_file.stat().st_mtime
+                ).isoformat(),
                 "compressed": archive_file.suffix == ".gz",
             }
 
@@ -308,7 +313,9 @@ Generated by Claude MPM Archive Manager
             # Backup current file if it exists
             if target_path.exists():
                 self.archive_file(
-                    target_path, reason="Backup before restoration", metadata={"restoration_from": archive_name}
+                    target_path,
+                    reason="Backup before restoration",
+                    metadata={"restoration_from": archive_name},
                 )
 
             # Restore file
@@ -325,7 +332,7 @@ Generated by Claude MPM Archive Manager
 
         except Exception as e:
             logger.error(f"Failed to restore {archive_name}: {e}")
-            return False, f"Restoration failed: {str(e)}"
+            return False, f"Restoration failed: {e!s}"
 
     def compare_with_archive(self, current_file: Path, archive_name: str) -> Dict:
         """Compare current file with an archived version."""
@@ -366,7 +373,7 @@ Generated by Claude MPM Archive Manager
             }
 
         except Exception as e:
-            return {"error": f"Comparison failed: {str(e)}"}
+            return {"error": f"Comparison failed: {e!s}"}
 
     def create_archive_report(self) -> Dict:
         """Generate a report of all archives."""
@@ -462,13 +469,15 @@ Generated by Claude MPM Archive Manager
             return []
 
         relative_path = file_path.relative_to(self.project_path)
-        output = self._run_git_command([
-            "log",
-            f"-{limit}",
-            "--pretty=format:%H|%an|%at|%s",
-            "--follow",
-            str(relative_path),
-        ])
+        output = self._run_git_command(
+            [
+                "log",
+                f"-{limit}",
+                "--pretty=format:%H|%an|%at|%s",
+                "--follow",
+                str(relative_path),
+            ]
+        )
 
         if not output:
             return []
@@ -477,12 +486,14 @@ Generated by Claude MPM Archive Manager
         for line in output.splitlines():
             parts = line.split("|", 3)
             if len(parts) == 4:
-                commits.append({
-                    "hash": parts[0][:8],
-                    "author": parts[1],
-                    "date": datetime.fromtimestamp(int(parts[2])).isoformat(),
-                    "message": parts[3],
-                })
+                commits.append(
+                    {
+                        "hash": parts[0][:8],
+                        "author": parts[1],
+                        "date": datetime.fromtimestamp(int(parts[2])).isoformat(),
+                        "message": parts[3],
+                    }
+                )
         return commits
 
     def get_file_last_modified(self, file_path: Path) -> Optional[datetime]:
@@ -491,12 +502,14 @@ Generated by Claude MPM Archive Manager
             return None
 
         relative_path = file_path.relative_to(self.project_path)
-        output = self._run_git_command([
-            "log",
-            "-1",
-            "--format=%at",
-            str(relative_path),
-        ])
+        output = self._run_git_command(
+            [
+                "log",
+                "-1",
+                "--format=%at",
+                str(relative_path),
+            ]
+        )
 
         if output:
             return datetime.fromtimestamp(int(output))
@@ -523,10 +536,12 @@ Generated by Claude MPM Archive Manager
 
                 # Check for outdated content
                 if file_report.get("outdated_indicators"):
-                    report["outdated_sections"].append({
-                        "file": doc_file,
-                        "indicators": file_report["outdated_indicators"],
-                    })
+                    report["outdated_sections"].append(
+                        {
+                            "file": doc_file,
+                            "indicators": file_report["outdated_indicators"],
+                        }
+                    )
 
         # Check synchronization between docs
         sync_issues = self._check_documentation_sync()
@@ -561,10 +576,12 @@ Generated by Claude MPM Archive Manager
         for pattern_name, pattern in self.version_patterns.items():
             matches = pattern.findall(content)
             if matches:
-                report["version_references"].append({
-                    "type": pattern_name,
-                    "versions": matches[:5],  # First 5 matches
-                })
+                report["version_references"].append(
+                    {
+                        "type": pattern_name,
+                        "versions": matches[:5],  # First 5 matches
+                    }
+                )
 
         # Detect outdated indicators
         outdated_indicators = self._detect_outdated_content(content, file_path.name)
@@ -591,11 +608,13 @@ Generated by Claude MPM Archive Manager
             regex = re.compile(pattern, re.IGNORECASE)
             for i, line in enumerate(lines, 1):
                 if regex.search(line):
-                    indicators.append({
-                        "line": i,
-                        "type": description,
-                        "content": line.strip()[:100],  # First 100 chars
-                    })
+                    indicators.append(
+                        {
+                            "line": i,
+                            "type": description,
+                            "content": line.strip()[:100],  # First 100 chars
+                        }
+                    )
 
         # Check for old version numbers if VERSION file exists
         version_file = self.project_path / "VERSION"
@@ -605,13 +624,17 @@ Generated by Claude MPM Archive Manager
 
             for match in old_version_pattern.finditer(content):
                 found_version = match.group(0)
-                if found_version != current_version and self._is_older_version(found_version, current_version):
-                    pos = content[:match.start()].count('\n') + 1
-                    indicators.append({
-                        "line": pos,
-                        "type": "Old version reference",
-                        "content": f"Found {found_version} (current: {current_version})",
-                    })
+                if found_version != current_version and self._is_older_version(
+                    found_version, current_version
+                ):
+                    pos = content[: match.start()].count("\n") + 1
+                    indicators.append(
+                        {
+                            "line": pos,
+                            "type": "Old version reference",
+                            "content": f"Found {found_version} (current: {current_version})",
+                        }
+                    )
 
         return indicators[:20]  # Limit to 20 most relevant
 
@@ -648,22 +671,28 @@ Generated by Claude MPM Archive Manager
 
             if claude_versions and readme_versions:
                 if claude_versions[0] != readme_versions[0]:
-                    issues.append({
-                        "type": "Version mismatch",
-                        "files": ["CLAUDE.md", "README.md"],
-                        "details": f"CLAUDE.md: {claude_versions[0]}, README.md: {readme_versions[0]}",
-                    })
+                    issues.append(
+                        {
+                            "type": "Version mismatch",
+                            "files": ["CLAUDE.md", "README.md"],
+                            "details": f"CLAUDE.md: {claude_versions[0]}, README.md: {readme_versions[0]}",
+                        }
+                    )
 
             # Check for project name consistency
-            project_names = re.findall(r"Claude MPM|claude-mpm", readme_content, re.IGNORECASE)
+            project_names = re.findall(
+                r"Claude MPM|claude-mpm", readme_content, re.IGNORECASE
+            )
             if project_names:
                 unique_names = set(project_names)
                 if len(unique_names) > 1:
-                    issues.append({
-                        "type": "Inconsistent project naming",
-                        "files": ["README.md"],
-                        "details": f"Found variations: {', '.join(unique_names)}",
-                    })
+                    issues.append(
+                        {
+                            "type": "Inconsistent project naming",
+                            "files": ["README.md"],
+                            "details": f"Found variations: {', '.join(unique_names)}",
+                        }
+                    )
 
         # Check CHANGELOG.md exists and is recent
         changelog_path = self.project_path / "CHANGELOG.md"
@@ -672,17 +701,21 @@ Generated by Claude MPM Archive Manager
             if last_modified:
                 days_old = (datetime.now() - last_modified).days
                 if days_old > 30:
-                    issues.append({
-                        "type": "Stale changelog",
-                        "files": ["CHANGELOG.md"],
-                        "details": f"Last updated {days_old} days ago",
-                    })
+                    issues.append(
+                        {
+                            "type": "Stale changelog",
+                            "files": ["CHANGELOG.md"],
+                            "details": f"Last updated {days_old} days ago",
+                        }
+                    )
         else:
-            issues.append({
-                "type": "Missing file",
-                "files": ["CHANGELOG.md"],
-                "details": "CHANGELOG.md does not exist",
-            })
+            issues.append(
+                {
+                    "type": "Missing file",
+                    "files": ["CHANGELOG.md"],
+                    "details": "CHANGELOG.md does not exist",
+                }
+            )
 
         return issues
 
@@ -700,7 +733,9 @@ Generated by Claude MPM Archive Manager
         if report["synchronization_issues"]:
             for issue in report["synchronization_issues"]:
                 if issue["type"] == "Version mismatch":
-                    recommendations.append("🔄 Synchronize version numbers across documentation files")
+                    recommendations.append(
+                        "🔄 Synchronize version numbers across documentation files"
+                    )
                 elif issue["type"] == "Stale changelog":
                     recommendations.append("📅 Update CHANGELOG.md with recent changes")
                 elif issue["type"] == "Missing file":
@@ -708,17 +743,29 @@ Generated by Claude MPM Archive Manager
 
         # Check for TODO items
         total_todos = sum(
-            len([i for i in file_report.get("outdated_indicators", [])
-                 if i["type"] == "Unresolved TODOs"])
+            len(
+                [
+                    i
+                    for i in file_report.get("outdated_indicators", [])
+                    if i["type"] == "Unresolved TODOs"
+                ]
+            )
             for file_report in report["files_reviewed"].values()
         )
         if total_todos > 0:
-            recommendations.append(f"✅ Resolve {total_todos} TODO items in documentation")
+            recommendations.append(
+                f"✅ Resolve {total_todos} TODO items in documentation"
+            )
 
         # Check for deprecated references
         deprecated_count = sum(
-            len([i for i in file_report.get("outdated_indicators", [])
-                 if "deprecated" in i["type"].lower()])
+            len(
+                [
+                    i
+                    for i in file_report.get("outdated_indicators", [])
+                    if "deprecated" in i["type"].lower()
+                ]
+            )
             for file_report in report["files_reviewed"].values()
         )
         if deprecated_count > 0:
@@ -768,20 +815,24 @@ Generated by Claude MPM Archive Manager
                         "auto_detection": True,
                         "indicators": file_report.get("outdated_indicators", [])[:5],
                         "review_timestamp": review["timestamp"],
-                    }
+                    },
                 )
                 if archive_result:
-                    result["archived_files"].append({
+                    result["archived_files"].append(
+                        {
+                            "file": filename,
+                            "reason": archive_reason,
+                            "archive_path": str(archive_result),
+                        }
+                    )
+            elif should_archive:
+                result["skipped_files"].append(
+                    {
                         "file": filename,
                         "reason": archive_reason,
-                        "archive_path": str(archive_result),
-                    })
-            elif should_archive:
-                result["skipped_files"].append({
-                    "file": filename,
-                    "reason": archive_reason,
-                    "action": "Would archive (dry run)",
-                })
+                        "action": "Would archive (dry run)",
+                    }
+                )
 
         return result
 
@@ -854,7 +905,9 @@ Generated by Claude MPM Archive Manager
                     # Archive before update
                     self.archive_file(readme_path, reason="Before version sync")
                     readme_path.write_text(updated_readme)
-                    result["changes"].append(f"Updated README.md to version {current_version}")
+                    result["changes"].append(
+                        f"Updated README.md to version {current_version}"
+                    )
 
             # Update CHANGELOG.md header if exists
             if changelog_path.exists() and current_version:
@@ -877,14 +930,18 @@ Generated by Claude MPM Archive Manager
                         updated_changelog = "\n".join(lines)
 
                         # Archive before update
-                        self.archive_file(changelog_path, reason="Before adding new version")
+                        self.archive_file(
+                            changelog_path, reason="Before adding new version"
+                        )
                         changelog_path.write_text(updated_changelog)
-                        result["changes"].append(f"Added {current_version} section to CHANGELOG.md")
+                        result["changes"].append(
+                            f"Added {current_version} section to CHANGELOG.md"
+                        )
 
             result["synced"] = len(result["changes"]) > 0
 
         except Exception as e:
-            result["errors"].append(f"Sync failed: {str(e)}")
+            result["errors"].append(f"Sync failed: {e!s}")
             logger.error(f"Documentation sync failed: {e}")
 
         return result
@@ -919,7 +976,9 @@ Generated by Claude MPM Archive Manager
         table.add_column("Last Updated", style="magenta")
 
         for filename, report in review["files_reviewed"].items():
-            status = "✅ OK" if not report.get("outdated_indicators") else "⚠️ Needs Review"
+            status = (
+                "✅ OK" if not report.get("outdated_indicators") else "⚠️ Needs Review"
+            )
             issues = len(report.get("outdated_indicators", []))
 
             last_updated = "Unknown"
@@ -964,13 +1023,17 @@ Generated by Claude MPM Archive Manager
 
         # Generate diff if current file exists and review requested
         if target_path.exists() and review_changes:
-            diff_report = self.generate_documentation_diff_report(target_path, archive_file)
+            diff_report = self.generate_documentation_diff_report(
+                target_path, archive_file
+            )
 
             console.print("\n[bold cyan]📝 Changes to be applied:[/bold cyan]")
             console.print(diff_report)
 
             # Ask for confirmation
-            console.print("\n[bold yellow]Proceed with restoration? (y/n): [/bold yellow]", end="")
+            console.print(
+                "\n[bold yellow]Proceed with restoration? (y/n): [/bold yellow]", end=""
+            )
             # In automated context, assume yes
             confirm = True
 
@@ -978,4 +1041,4 @@ Generated by Claude MPM Archive Manager
                 return False, "Restoration cancelled by user"
 
         # Proceed with restoration
-        return self.restore_archive(archive_name, target_path)
+        return self.restore_archive(archive_name, target_path)