claude-mpm 4.1.4__py3-none-any.whl → 4.1.6__py3-none-any.whl

claude_mpm/services/project/analyzer.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
-Project Analyzer Service
-=======================
+Project Analyzer Service (Refactored)
+=====================================
 
 Analyzes project characteristics to enable project-specific memory creation.
 
@@ -9,8 +9,15 @@ WHY: Instead of creating generic memories, agents need to understand the specifi
 project they're working on - its tech stack, architecture patterns, coding conventions,
 and key components. This service extracts these characteristics automatically.
 
-DESIGN DECISION: Separates project analysis from memory creation to allow reuse
-across different memory-related services and enable caching of analysis results.
+REFACTORING NOTE: This module has been refactored to follow SOLID principles.
+The original god class has been split into focused services:
+- LanguageAnalyzerService: Language and framework detection
+- DependencyAnalyzerService: Dependency and package management
+- ArchitectureAnalyzerService: Architecture and structure analysis
+- MetricsCollectorService: Code metrics collection
+
+The main ProjectAnalyzer class now orchestrates these services while maintaining
+full backward compatibility with the original interface.
 
 This service analyzes:
 - Technology stack from config files (package.json, requirements.txt, etc.)
@@ -34,6 +41,8 @@ from claude_mpm.core.config import Config
 from claude_mpm.core.interfaces import ProjectAnalyzerInterface
 from claude_mpm.core.unified_paths import get_path_manager
 
+# Import refactored services
+
 
 @dataclass
 class ProjectCharacteristics:

claude_mpm/services/project/analyzer_refactored.py

@@ -0,0 +1,450 @@
+#!/usr/bin/env python3
+"""
+Refactored Project Analyzer Service
+===================================
+
+WHY: Refactored from the original god class to follow SOLID principles.
+This version orchestrates specialized services instead of handling all
+analysis tasks directly.
+
+DECISION: Use dependency injection and service composition to maintain
+single responsibility while preserving the original interface.
+"""
+
+import logging
+import time
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from claude_mpm.core.config import Config
+from claude_mpm.core.interfaces import ProjectAnalyzerInterface
+from claude_mpm.core.unified_paths import get_path_manager
+
+from .analyzer import ProjectCharacteristics  # Reuse data class
+from .architecture_analyzer import ArchitectureAnalyzerService
+from .dependency_analyzer import DependencyAnalyzerService
+from .language_analyzer import LanguageAnalyzerService
+from .metrics_collector import MetricsCollectorService
+
+
+class RefactoredProjectAnalyzer(ProjectAnalyzerInterface):
+    """Refactored project analyzer using service composition.
+
+    WHY: This refactored version maintains the same interface but delegates
+    work to specialized services, following single responsibility principle.
+    Each service handles one aspect of project analysis.
+
+    DESIGN DECISION: Use dependency injection for services to enable easy
+    testing and future extensibility. Cache results to avoid redundant analysis.
+    """
+
+    def __init__(
+        self,
+        config: Optional[Config] = None,
+        working_directory: Optional[Path] = None,
+        # Dependency injection for services
+        language_analyzer: Optional[LanguageAnalyzerService] = None,
+        dependency_analyzer: Optional[DependencyAnalyzerService] = None,
+        architecture_analyzer: Optional[ArchitectureAnalyzerService] = None,
+        metrics_collector: Optional[MetricsCollectorService] = None,
+    ):
+        """Initialize the refactored project analyzer.
+
+        Args:
+            config: Optional Config object
+            working_directory: Optional working directory path
+            language_analyzer: Optional language analyzer service
+            dependency_analyzer: Optional dependency analyzer service
+            architecture_analyzer: Optional architecture analyzer service
+            metrics_collector: Optional metrics collector service
+        """
+        self.config = config or Config()
+        self.working_directory = (
+            working_directory or get_path_manager().get_project_root()
+        )
+        self.logger = logging.getLogger(f"{__name__}.{self.__class__.__name__}")
+
+        # Initialize services (use injected or create new)
+        self.language_analyzer = language_analyzer or LanguageAnalyzerService(
+            self.working_directory
+        )
+        self.dependency_analyzer = dependency_analyzer or DependencyAnalyzerService(
+            self.working_directory
+        )
+        self.architecture_analyzer = (
+            architecture_analyzer or ArchitectureAnalyzerService(self.working_directory)
+        )
+        self.metrics_collector = metrics_collector or MetricsCollectorService(
+            self.working_directory
+        )
+
+        # Cache for analysis results
+        self._analysis_cache: Optional[ProjectCharacteristics] = None
+        self._cache_timestamp: Optional[float] = None
+        self._cache_ttl = 300  # 5 minutes
+
+    def analyze_project(self, force_refresh: bool = False) -> ProjectCharacteristics:
+        """Analyze the current project and return characteristics.
+
+        WHY: Orchestrates multiple specialized services to provide comprehensive
+        project analysis while maintaining the original interface.
+
+        Args:
+            force_refresh: If True, ignores cache and performs fresh analysis
+
+        Returns:
+            ProjectCharacteristics: Structured project analysis results
+        """
+        try:
+            # Check cache first
+            if not force_refresh and self._is_cache_valid():
+                self.logger.debug("Using cached project analysis")
+                return self._analysis_cache
+
+            self.logger.info(f"Analyzing project at: {self.working_directory}")
+
+            # Initialize characteristics
+            characteristics = self._create_empty_characteristics()
+
+            # Perform analysis using specialized services
+            self._analyze_with_language_service(characteristics)
+            self._analyze_with_dependency_service(characteristics)
+            self._analyze_with_architecture_service(characteristics)
+            self._enrich_with_metrics(characteristics)
+
+            # Cache the results
+            self._update_cache(characteristics)
+
+            self.logger.info(
+                f"Project analysis complete: {characteristics.primary_language} project "
+                f"with {len(characteristics.frameworks)} frameworks"
+            )
+            return characteristics
+
+        except Exception as e:
+            self.logger.error(f"Error analyzing project: {e}")
+            return self._create_empty_characteristics()
+
+    def _analyze_with_language_service(
+        self, characteristics: ProjectCharacteristics
+    ) -> None:
+        """Use language analyzer service to populate language-related fields.
+
+        WHY: Delegates language analysis to specialized service while
+        maintaining data structure compatibility.
+        """
+        try:
+            # Detect languages
+            characteristics.languages = self.language_analyzer.detect_languages()
+
+            # Detect primary language
+            characteristics.primary_language = (
+                self.language_analyzer.detect_primary_language()
+            )
+
+            # Detect frameworks
+            characteristics.frameworks = self.language_analyzer.detect_frameworks()
+
+            # Analyze code style
+            characteristics.code_conventions = (
+                self.language_analyzer.analyze_code_style()
+            )
+
+        except Exception as e:
+            self.logger.warning(f"Error in language analysis: {e}")
+
+    def _analyze_with_dependency_service(
+        self, characteristics: ProjectCharacteristics
+    ) -> None:
+        """Use dependency analyzer service to populate dependency-related fields.
+
+        WHY: Delegates dependency analysis to specialized service for better
+        separation of concerns.
+        """
+        try:
+            # Detect package manager
+            characteristics.package_manager = (
+                self.dependency_analyzer.detect_package_manager()
+            )
+
+            # Analyze all dependencies
+            deps = self.dependency_analyzer.analyze_dependencies()
+
+            # Populate characteristics
+            characteristics.key_dependencies = deps["production"][:20]  # Top 20
+            characteristics.databases = self.dependency_analyzer.detect_databases(
+                deps["production"] + deps["development"]
+            )
+            characteristics.web_frameworks = (
+                self.dependency_analyzer.detect_web_frameworks(deps["production"])
+            )
+
+            # Detect testing framework
+            testing_frameworks = self.dependency_analyzer.detect_testing_frameworks(
+                deps["development"] + deps["testing"]
+            )
+            if testing_frameworks:
+                characteristics.testing_framework = testing_frameworks[0]
+
+            # Get build tools
+            characteristics.build_tools = self.dependency_analyzer.get_build_tools()
+
+        except Exception as e:
+            self.logger.warning(f"Error in dependency analysis: {e}")
+
+    def _analyze_with_architecture_service(
+        self, characteristics: ProjectCharacteristics
+    ) -> None:
+        """Use architecture analyzer service to populate structure-related fields.
+
+        WHY: Delegates architectural analysis to specialized service for
+        better modularity and testability.
+        """
+        try:
+            # Analyze architecture
+            arch_info = self.architecture_analyzer.analyze_architecture()
+
+            # Populate characteristics
+            characteristics.architecture_type = arch_info.architecture_type
+            characteristics.main_modules = arch_info.main_modules
+            characteristics.key_directories = arch_info.key_directories
+            characteristics.entry_points = arch_info.entry_points
+            characteristics.api_patterns = arch_info.api_patterns
+            characteristics.configuration_patterns = arch_info.configuration_patterns
+            characteristics.project_terminology = arch_info.project_terminology
+
+            # Detect design patterns
+            design_patterns = self.architecture_analyzer.detect_design_patterns()
+            if design_patterns:
+                # Add to code conventions
+                for pattern in design_patterns[:3]:  # Top 3 patterns
+                    pattern_name = pattern.replace("_", " ").title() + " Pattern"
+                    if pattern_name not in characteristics.code_conventions:
+                        characteristics.code_conventions.append(pattern_name)
+
+        except Exception as e:
+            self.logger.warning(f"Error in architecture analysis: {e}")
+
+    def _enrich_with_metrics(self, characteristics: ProjectCharacteristics) -> None:
+        """Enrich characteristics with metrics data.
+
+        WHY: Metrics provide quantitative insights that complement
+        the qualitative analysis from other services.
+        """
+        try:
+            # Collect metrics
+            metrics = self.metrics_collector.collect_metrics()
+
+            # Add testing patterns based on metrics
+            if metrics.test_files > 0:
+                characteristics.test_patterns.append(f"{metrics.test_files} test files")
+
+            if metrics.test_to_code_ratio > 0:
+                ratio_pct = int(metrics.test_to_code_ratio * 100)
+                characteristics.test_patterns.append(
+                    f"{ratio_pct}% test coverage ratio"
+                )
+
+            if metrics.test_coverage_files > 0:
+                characteristics.test_patterns.append("Test coverage tracking")
+
+            # Add file organization insights
+            if metrics.files_over_1000_lines > 0:
+                characteristics.code_conventions.append("Large file refactoring needed")
+
+            # Find documentation files
+            doc_patterns = ["README*", "CONTRIBUTING*", "CHANGELOG*", "docs/*"]
+            doc_files = []
+            for pattern in doc_patterns:
+                matches = list(self.working_directory.glob(pattern))
+                doc_files.extend(
+                    [
+                        str(f.relative_to(self.working_directory))
+                        for f in matches
+                        if f.is_file()
+                    ]
+                )
+            characteristics.documentation_files = doc_files[:10]
+
+            # Find important configs
+            config_patterns = ["*.json", "*.yaml", "*.yml", "*.toml", "*.ini", ".env*"]
+            config_files = []
+            for pattern in config_patterns:
+                matches = list(self.working_directory.glob(pattern))
+                config_files.extend(
+                    [
+                        str(f.relative_to(self.working_directory))
+                        for f in matches
+                        if f.is_file()
+                    ]
+                )
+            characteristics.important_configs = config_files[:10]
+
+        except Exception as e:
+            self.logger.warning(f"Error collecting metrics: {e}")
+
+    def _create_empty_characteristics(self) -> ProjectCharacteristics:
+        """Create empty ProjectCharacteristics with defaults."""
+        return ProjectCharacteristics(
+            project_name=self.working_directory.name,
+            primary_language=None,
+            languages=[],
+            frameworks=[],
+            architecture_type="unknown",
+            main_modules=[],
+            key_directories=[],
+            entry_points=[],
+            testing_framework=None,
+            test_patterns=[],
+            package_manager=None,
+            build_tools=[],
+            databases=[],
+            web_frameworks=[],
+            api_patterns=[],
+            key_dependencies=[],
+            code_conventions=[],
+            configuration_patterns=[],
+            project_terminology=[],
+            documentation_files=[],
+            important_configs=[],
+        )
+
+    def _is_cache_valid(self) -> bool:
+        """Check if cache is still valid."""
+        if self._analysis_cache is None or self._cache_timestamp is None:
+            return False
+        return time.time() - self._cache_timestamp < self._cache_ttl
+
+    def _update_cache(self, characteristics: ProjectCharacteristics) -> None:
+        """Update the cache with new results."""
+        self._analysis_cache = characteristics
+        self._cache_timestamp = time.time()
+
+    # ================================================================================
+    # Interface Adapter Methods
+    # ================================================================================
+    # These methods maintain backward compatibility with ProjectAnalyzerInterface
+
+    def detect_technology_stack(self) -> List[str]:
+        """Detect technologies used in the project."""
+        characteristics = self.analyze_project()
+
+        technologies = []
+        technologies.extend(characteristics.languages)
+        technologies.extend(characteristics.frameworks)
+        technologies.extend(characteristics.web_frameworks)
+        technologies.extend(characteristics.databases)
+
+        if characteristics.package_manager:
+            technologies.append(characteristics.package_manager)
+
+        technologies.extend(characteristics.build_tools)
+
+        return list(set(technologies))
+
+    def analyze_code_patterns(self) -> Dict[str, Any]:
+        """Analyze code patterns and conventions."""
+        characteristics = self.analyze_project()
+
+        return {
+            "code_conventions": characteristics.code_conventions,
+            "test_patterns": characteristics.test_patterns,
+            "api_patterns": characteristics.api_patterns,
+            "configuration_patterns": characteristics.configuration_patterns,
+            "architecture_type": characteristics.architecture_type,
+        }
+
+    def get_project_structure(self) -> Dict[str, Any]:
+        """Get project directory structure analysis."""
+        characteristics = self.analyze_project()
+
+        return {
+            "project_name": characteristics.project_name,
+            "main_modules": characteristics.main_modules,
+            "key_directories": characteristics.key_directories,
+            "entry_points": characteristics.entry_points,
+            "documentation_files": characteristics.documentation_files,
+            "important_configs": characteristics.important_configs,
+            "architecture_type": characteristics.architecture_type,
+        }
+
+    def identify_entry_points(self) -> List[Path]:
+        """Identify project entry points."""
+        characteristics = self.analyze_project()
+
+        entry_paths = []
+        for entry_point in characteristics.entry_points:
+            entry_path = self.working_directory / entry_point
+            if entry_path.exists():
+                entry_paths.append(entry_path)
+
+        return entry_paths
+
+    def get_project_context_summary(self) -> str:
+        """Get a concise summary of project context for memory templates."""
+        characteristics = self.analyze_project()
+
+        summary_parts = []
+
+        # Basic project info
+        lang_info = characteristics.primary_language or "mixed"
+        if characteristics.languages and len(characteristics.languages) > 1:
+            lang_info = (
+                f"{lang_info} (with {', '.join(characteristics.languages[1:3])})"
+            )
+
+        summary_parts.append(
+            f"{characteristics.project_name}: {lang_info} {characteristics.architecture_type.lower()}"
+        )
+
+        # Key directories and modules
+        if characteristics.main_modules:
+            modules_str = ", ".join(characteristics.main_modules[:4])
+            summary_parts.append(f"- Main modules: {modules_str}")
+
+        # Frameworks and tools
+        if characteristics.frameworks or characteristics.web_frameworks:
+            all_frameworks = characteristics.frameworks + characteristics.web_frameworks
+            frameworks_str = ", ".join(all_frameworks[:3])
+            summary_parts.append(f"- Uses: {frameworks_str}")
+
+        # Testing
+        if characteristics.testing_framework:
+            summary_parts.append(f"- Testing: {characteristics.testing_framework}")
+        elif characteristics.test_patterns:
+            summary_parts.append(f"- Testing: {characteristics.test_patterns[0]}")
+
+        # Key patterns
+        if characteristics.code_conventions:
+            patterns_str = ", ".join(characteristics.code_conventions[:2])
+            summary_parts.append(f"- Key patterns: {patterns_str}")
+
+        return "\n".join(summary_parts)
+
+    def get_important_files_for_context(self) -> List[str]:
+        """Get list of important files that should be considered for memory context."""
+        characteristics = self.analyze_project()
+        important_files = []
+
+        # Always include standard documentation
+        standard_docs = ["README.md", "CONTRIBUTING.md", "CHANGELOG.md"]
+        for doc in standard_docs:
+            if (self.working_directory / doc).exists():
+                important_files.append(doc)
+
+        # Include configuration files
+        important_files.extend(characteristics.important_configs)
+
+        # Include project-specific documentation
+        important_files.extend(characteristics.documentation_files[:5])
+
+        # Include entry points
+        important_files.extend(characteristics.entry_points)
+
+        # Look for architecture documentation
+        arch_patterns = ["ARCHITECTURE.md", "docs/architecture.md", "docs/STRUCTURE.md"]
+        for pattern in arch_patterns:
+            if (self.working_directory / pattern).exists():
+                important_files.append(pattern)
+
+        return list(set(important_files))