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

claude_mpm/services/project/documentation_manager.py

@@ -18,15 +18,15 @@ Created: 2025-01-26
 
 import difflib
 import hashlib
-import json
 import re
 from datetime import datetime
 from pathlib import Path
-from typing import Dict, List, Optional, Set, Tuple
+from typing import Dict, List, Tuple
 
 from rich.console import Console
 
 from claude_mpm.core.logging_utils import get_logger
+
 logger = get_logger(__name__)
 console = Console()
 
@@ -70,7 +70,9 @@ class DocumentationManager:
         if self.claude_md_path.exists():
             self.existing_content = self.claude_md_path.read_text(encoding="utf-8")
             self.content_hash = hashlib.md5(self.existing_content.encode()).hexdigest()
-            logger.info(f"Loaded existing CLAUDE.md ({len(self.existing_content)} chars)")
+            logger.info(
+                f"Loaded existing CLAUDE.md ({len(self.existing_content)} chars)"
+            )
 
     def has_existing_documentation(self) -> bool:
         """Check if project has existing CLAUDE.md."""
@@ -118,15 +120,17 @@ class DocumentationManager:
             if line.startswith("#"):
                 # Save previous section if exists
                 if current_section:
-                    sections.append({
-                        "title": current_section,
-                        "level": current_level,
-                        "start_line": section_start,
-                        "end_line": i - 1,
-                        "content_preview": self._get_content_preview(
-                            lines[section_start:i]
-                        ),
-                    })
+                    sections.append(
+                        {
+                            "title": current_section,
+                            "level": current_level,
+                            "start_line": section_start,
+                            "end_line": i - 1,
+                            "content_preview": self._get_content_preview(
+                                lines[section_start:i]
+                            ),
+                        }
+                    )
 
                 # Parse new section
                 level = len(line.split()[0])
@@ -137,13 +141,15 @@ class DocumentationManager:
 
         # Add last section
         if current_section:
-            sections.append({
-                "title": current_section,
-                "level": current_level,
-                "start_line": section_start,
-                "end_line": len(lines) - 1,
-                "content_preview": self._get_content_preview(lines[section_start:]),
-            })
+            sections.append(
+                {
+                    "title": current_section,
+                    "level": current_level,
+                    "start_line": section_start,
+                    "end_line": len(lines) - 1,
+                    "content_preview": self._get_content_preview(lines[section_start:]),
+                }
+            )
 
         return sections
 
@@ -160,13 +166,18 @@ class DocumentationManager:
 
         if self.existing_content:
             # Check for old patterns
-            if "## Installation" in self.existing_content and "pip install" not in self.existing_content:
+            if (
+                "## Installation" in self.existing_content
+                and "pip install" not in self.existing_content
+            ):
                 patterns.append("Missing installation instructions")
 
             if "TODO" in self.existing_content or "FIXME" in self.existing_content:
                 patterns.append("Contains TODO/FIXME items")
 
-            if not re.search(r"Last Updated:|Last Modified:", self.existing_content, re.IGNORECASE):
+            if not re.search(
+                r"Last Updated:|Last Modified:", self.existing_content, re.IGNORECASE
+            ):
                 patterns.append("Missing update timestamp")
 
             if "```" not in self.existing_content:
@@ -193,12 +204,16 @@ class DocumentationManager:
         custom = []
         for section in sections:
             title_lower = section["title"].lower()
-            if not any(re.search(pattern, title_lower) for pattern in standard_patterns):
+            if not any(
+                re.search(pattern, title_lower) for pattern in standard_patterns
+            ):
                 custom.append(section["title"])
 
         return custom
 
-    def merge_with_template(self, new_content: str, preserve_custom: bool = True) -> str:
+    def merge_with_template(
+        self, new_content: str, preserve_custom: bool = True
+    ) -> str:
         """Merge existing content with new template content."""
         if not self.existing_content:
             return new_content
@@ -279,35 +294,37 @@ class DocumentationManager:
         # Map to known section types
         if "priority" in title and "index" in title:
             return "priority_index"
-        elif "critical" in title and "security" in title:
+        if "critical" in title and "security" in title:
             return "critical_security"
-        elif "critical" in title and "business" in title:
+        if "critical" in title and "business" in title:
             return "critical_business"
-        elif "important" in title and "architecture" in title:
+        if "important" in title and "architecture" in title:
             return "important_architecture"
-        elif "important" in title and "workflow" in title:
+        if "important" in title and "workflow" in title:
             return "important_workflow"
-        elif "project" in title and "overview" in title:
+        if "project" in title and "overview" in title:
             return "project_overview"
-        elif "standard" in title and "coding" in title:
+        if "standard" in title and "coding" in title:
             return "standard_coding"
-        elif "standard" in title and "tasks" in title:
+        if "standard" in title and "tasks" in title:
             return "standard_tasks"
-        elif "documentation" in title:
+        if "documentation" in title:
             return "documentation_links"
-        elif "optional" in title or "future" in title:
+        if "optional" in title or "future" in title:
             return "optional_future"
-        elif "meta" in title or "maintain" in title:
+        if "meta" in title or "maintain" in title:
             return "meta_maintenance"
-        else:
-            return "unknown"
+        return "unknown"
 
     def _merge_section_content(
         self, existing: str, new: str, section_header: str
     ) -> str:
         """Merge content from existing and new sections."""
         # For critical sections, prefer new content but append unique existing items
-        if "critical" in section_header.lower() or "important" in section_header.lower():
+        if (
+            "critical" in section_header.lower()
+            or "important" in section_header.lower()
+        ):
             # Extract bullet points from both
             existing_items = self._extract_bullet_points(existing)
             new_items = self._extract_bullet_points(new)
@@ -321,13 +338,11 @@ class DocumentationManager:
             # Reconstruct section
             if all_items:
                 return "\n".join([""] + all_items + [""])
-            else:
-                return new
-        else:
-            # For other sections, use new as base and append existing
-            if existing.strip() and existing.strip() != new.strip():
-                return f"{new}\n\n<!-- Preserved from previous version -->\n{existing}"
             return new
+        # For other sections, use new as base and append existing
+        if existing.strip() and existing.strip() != new.strip():
+            return f"{new}\n\n<!-- Preserved from previous version -->\n{existing}"
+        return new
 
     def _extract_bullet_points(self, content: str) -> List[str]:
         """Extract bullet points from content."""
@@ -343,7 +358,9 @@ class DocumentationManager:
         for existing in items:
             existing_clean = re.sub(r"[^a-zA-Z0-9\s]", "", existing.lower())
             # Use fuzzy matching for similarity
-            similarity = difflib.SequenceMatcher(None, item_clean, existing_clean).ratio()
+            similarity = difflib.SequenceMatcher(
+                None, item_clean, existing_clean
+            ).ratio()
             if similarity > 0.8:  # 80% similarity threshold
                 return True
         return False
@@ -464,7 +481,9 @@ class DocumentationManager:
                 issues.append(f"Missing required section: {section}")
 
         # Check for priority markers
-        has_markers = any(marker in content for marker in self.PRIORITY_MARKERS.values())
+        has_markers = any(
+            marker in content for marker in self.PRIORITY_MARKERS.values()
+        )
         if not has_markers:
             issues.append("No priority markers found (🔴🟡🟢⚪)")
 
@@ -533,4 +552,4 @@ class DocumentationManager:
 - **Last Updated**: {datetime.now().isoformat()}
 - **Created By**: Claude MPM /mpm-init
 - **Update Frequency**: As needed when requirements change
-"""
+"""

claude_mpm/services/project/enhanced_analyzer.py

@@ -16,15 +16,15 @@ Author: Claude MPM Development Team
 Created: 2025-01-26
 """
 
-import json
 import subprocess
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Dict, List, Optional, Set, Tuple
+from typing import Dict, List, Optional
 
 from rich.console import Console
 
 from claude_mpm.core.logging_utils import get_logger
+
 logger = get_logger(__name__)
 console = Console()
 
@@ -77,12 +77,14 @@ class EnhancedProjectAnalyzer:
         since_date = (datetime.now() - timedelta(days=days)).strftime("%Y-%m-%d")
 
         # Get commit log with structured format
-        output = self._run_git_command([
-            "log",
-            f"--since={since_date}",
-            "--pretty=format:%H|%an|%ae|%at|%s",
-            "--no-merges",
-        ])
+        output = self._run_git_command(
+            [
+                "log",
+                f"--since={since_date}",
+                "--pretty=format:%H|%an|%ae|%at|%s",
+                "--no-merges",
+            ]
+        )
 
         if not output:
             return []
@@ -91,13 +93,15 @@ class EnhancedProjectAnalyzer:
         for line in output.splitlines():
             parts = line.split("|", 4)
             if len(parts) == 5:
-                commits.append({
-                    "hash": parts[0][:8],
-                    "author": parts[1],
-                    "email": parts[2],
-                    "timestamp": datetime.fromtimestamp(int(parts[3])).isoformat(),
-                    "message": parts[4],
-                })
+                commits.append(
+                    {
+                        "hash": parts[0][:8],
+                        "author": parts[1],
+                        "email": parts[2],
+                        "timestamp": datetime.fromtimestamp(int(parts[3])).isoformat(),
+                        "message": parts[4],
+                    }
+                )
 
         return commits[:50]  # Limit to 50 most recent
 
@@ -105,13 +109,15 @@ class EnhancedProjectAnalyzer:
         """Get files changed in recent commits."""
         since_date = (datetime.now() - timedelta(days=days)).strftime("%Y-%m-%d")
 
-        output = self._run_git_command([
-            "log",
-            f"--since={since_date}",
-            "--pretty=format:",
-            "--name-only",
-            "--no-merges",
-        ])
+        output = self._run_git_command(
+            [
+                "log",
+                f"--since={since_date}",
+                "--pretty=format:",
+                "--name-only",
+                "--no-merges",
+            ]
+        )
 
         if not output:
             return {}
@@ -134,13 +140,15 @@ class EnhancedProjectAnalyzer:
         """Get files added in recent commits."""
         since_date = (datetime.now() - timedelta(days=days)).strftime("%Y-%m-%d")
 
-        output = self._run_git_command([
-            "log",
-            f"--since={since_date}",
-            "--pretty=format:",
-            "--name-status",
-            "--diff-filter=A",  # Added files only
-        ])
+        output = self._run_git_command(
+            [
+                "log",
+                f"--since={since_date}",
+                "--pretty=format:",
+                "--name-status",
+                "--diff-filter=A",  # Added files only
+            ]
+        )
 
         if not output:
             return []
@@ -156,12 +164,14 @@ class EnhancedProjectAnalyzer:
         """Get author contribution statistics."""
         since_date = (datetime.now() - timedelta(days=days)).strftime("%Y-%m-%d")
 
-        output = self._run_git_command([
-            "shortlog",
-            "-sne",
-            f"--since={since_date}",
-            "--no-merges",
-        ])
+        output = self._run_git_command(
+            [
+                "shortlog",
+                "-sne",
+                f"--since={since_date}",
+                "--no-merges",
+            ]
+        )
 
         if not output:
             return {}
@@ -201,10 +211,12 @@ class EnhancedProjectAnalyzer:
             for line in remotes.splitlines():
                 parts = line.split()
                 if len(parts) >= 2:
-                    info["remotes"].append({
-                        "name": parts[0],
-                        "url": parts[1],
-                    })
+                    info["remotes"].append(
+                        {
+                            "name": parts[0],
+                            "url": parts[1],
+                        }
+                    )
 
         # Check for uncommitted changes
         status = self._run_git_command(["status", "--porcelain"])
@@ -223,12 +235,15 @@ class EnhancedProjectAnalyzer:
 
         doc_changes = {}
         for pattern in doc_patterns:
-            output = self._run_git_command([
-                "log",
-                f"--since={since_date}",
-                "--pretty=format:%H|%s",
-                "--", pattern,
-            ])
+            output = self._run_git_command(
+                [
+                    "log",
+                    f"--since={since_date}",
+                    "--pretty=format:%H|%s",
+                    "--",
+                    pattern,
+                ]
+            )
 
             if output:
                 for line in output.splitlines():
@@ -236,29 +251,38 @@ class EnhancedProjectAnalyzer:
                     if len(parts) == 2:
                         if pattern not in doc_changes:
                             doc_changes[pattern] = []
-                        doc_changes[pattern].append({
-                            "commit": parts[0][:8],
-                            "message": parts[1],
-                        })
+                        doc_changes[pattern].append(
+                            {
+                                "commit": parts[0][:8],
+                                "message": parts[1],
+                            }
+                        )
 
         # Check CLAUDE.md specifically
-        claude_history = self._run_git_command([
-            "log",
-            f"--since={since_date}",
-            "--pretty=format:%H|%at|%s",
-            "--", "CLAUDE.md",
-        ])
+        claude_history = self._run_git_command(
+            [
+                "log",
+                f"--since={since_date}",
+                "--pretty=format:%H|%at|%s",
+                "--",
+                "CLAUDE.md",
+            ]
+        )
 
         claude_updates = []
         if claude_history:
             for line in claude_history.splitlines():
                 parts = line.split("|", 2)
                 if len(parts) == 3:
-                    claude_updates.append({
-                        "commit": parts[0][:8],
-                        "timestamp": datetime.fromtimestamp(int(parts[1])).isoformat(),
-                        "message": parts[2],
-                    })
+                    claude_updates.append(
+                        {
+                            "commit": parts[0][:8],
+                            "timestamp": datetime.fromtimestamp(
+                                int(parts[1])
+                            ).isoformat(),
+                            "message": parts[2],
+                        }
+                    )
 
         return {
             "documentation_commits": doc_changes,
@@ -284,7 +308,9 @@ class EnhancedProjectAnalyzer:
                 patterns["features"].append(commit["message"][:100])
             elif any(kw in msg_lower for kw in ["fix", "bug", "resolve", "patch"]):
                 patterns["fixes"].append(commit["message"][:100])
-            elif any(kw in msg_lower for kw in ["refactor", "restructure", "reorganize"]):
+            elif any(
+                kw in msg_lower for kw in ["refactor", "restructure", "reorganize"]
+            ):
                 patterns["refactoring"].append(commit["message"][:100])
             elif any(kw in msg_lower for kw in ["doc", "readme", "comment"]):
                 patterns["documentation"].append(commit["message"][:100])
@@ -318,12 +344,14 @@ class EnhancedProjectAnalyzer:
         hot_spots = []
         for file_path, change_count in list(changed_files["most_changed"].items())[:10]:
             file_type = Path(file_path).suffix
-            hot_spots.append({
-                "file": file_path,
-                "changes": change_count,
-                "type": file_type,
-                "category": self._categorize_file(file_path),
-            })
+            hot_spots.append(
+                {
+                    "file": file_path,
+                    "changes": change_count,
+                    "type": file_type,
+                    "category": self._categorize_file(file_path),
+                }
+            )
 
         return hot_spots
 
@@ -334,18 +362,17 @@ class EnhancedProjectAnalyzer:
         # Check directory
         if "test" in str(path).lower():
             return "test"
-        elif "docs" in str(path).lower():
+        if "docs" in str(path).lower():
             return "documentation"
-        elif "src" in str(path) or "lib" in str(path):
+        if "src" in str(path) or "lib" in str(path):
             return "source"
-        elif "scripts" in str(path):
+        if "scripts" in str(path):
             return "scripts"
-        elif path.suffix in [".yml", ".yaml", ".json", ".toml", ".ini"]:
+        if path.suffix in [".yml", ".yaml", ".json", ".toml", ".ini"]:
             return "configuration"
-        elif path.suffix in [".md", ".rst", ".txt"]:
+        if path.suffix in [".md", ".rst", ".txt"]:
             return "documentation"
-        else:
-            return "other"
+        return "other"
 
     def detect_project_state(self) -> Dict:
         """Detect the current state and lifecycle phase of the project."""
@@ -371,7 +398,9 @@ class EnhancedProjectAnalyzer:
             indicators.append("Has GitLab CI")
 
         # Check for tests
-        if (self.project_path / "tests").exists() or (self.project_path / "test").exists():
+        if (self.project_path / "tests").exists() or (
+            self.project_path / "test"
+        ).exists():
             indicators.append("Has test directory")
 
         # Check for documentation
@@ -391,33 +420,45 @@ class EnhancedProjectAnalyzer:
                 # Determine phase based on commit count
                 if count < 10:
                     state["phase"] = "initial"
-                    state["recommendations"].append("Focus on establishing core structure")
+                    state["recommendations"].append(
+                        "Focus on establishing core structure"
+                    )
                 elif count < 50:
                     state["phase"] = "early_development"
-                    state["recommendations"].append("Consider adding tests and documentation")
+                    state["recommendations"].append(
+                        "Consider adding tests and documentation"
+                    )
                 elif count < 200:
                     state["phase"] = "active_development"
-                    state["recommendations"].append("Ensure CI/CD and testing are in place")
+                    state["recommendations"].append(
+                        "Ensure CI/CD and testing are in place"
+                    )
                 elif count < 1000:
                     state["phase"] = "maturing"
-                    state["recommendations"].append("Focus on optimization and documentation")
+                    state["recommendations"].append(
+                        "Focus on optimization and documentation"
+                    )
                 else:
                     state["phase"] = "mature"
                     state["recommendations"].append("Maintain backward compatibility")
 
             # Check age
-            first_commit = self._run_git_command([
-                "log", "--reverse", "--format=%at", "-1"
-            ])
+            first_commit = self._run_git_command(
+                ["log", "--reverse", "--format=%at", "-1"]
+            )
             if first_commit:
-                age_days = (datetime.now() - datetime.fromtimestamp(int(first_commit))).days
+                age_days = (
+                    datetime.now() - datetime.fromtimestamp(int(first_commit))
+                ).days
                 indicators.append(f"{age_days} days old")
 
         state["indicators"] = indicators
 
         # Add phase-specific recommendations
         if not (self.project_path / "CLAUDE.md").exists():
-            state["recommendations"].append("Create CLAUDE.md for AI agent documentation")
+            state["recommendations"].append(
+                "Create CLAUDE.md for AI agent documentation"
+            )
         if not (self.project_path / "tests").exists():
             state["recommendations"].append("Add tests directory for test organization")
         if not (self.project_path / ".gitignore").exists():
@@ -474,10 +515,12 @@ class EnhancedProjectAnalyzer:
                 try:
                     size = path.stat().st_size
                     if size > 1024 * 1024:  # Files over 1MB
-                        stats["largest_files"].append({
-                            "path": str(path.relative_to(self.project_path)),
-                            "size_mb": round(size / (1024 * 1024), 2),
-                        })
+                        stats["largest_files"].append(
+                            {
+                                "path": str(path.relative_to(self.project_path)),
+                                "size_mb": round(size / (1024 * 1024), 2),
+                            }
+                        )
                 except (OSError, PermissionError):
                     pass
 
@@ -488,4 +531,4 @@ class EnhancedProjectAnalyzer:
         stats["largest_files"].sort(key=lambda x: x["size_mb"], reverse=True)
         stats["largest_files"] = stats["largest_files"][:10]  # Top 10
 
-        return stats
+        return stats