claude-mpm 3.7.1__py3-none-any.whl → 3.7.8__py3-none-any.whl

claude_mpm/utils/robust_installer.py

@@ -0,0 +1,587 @@
+"""
+Robust dependency installer with retry logic and fallback strategies.
+
+WHY: Network issues and temporary unavailability can cause dependency installation
+to fail. This module provides resilient installation with automatic retries,
+fallback strategies, and clear error reporting.
+
+DESIGN DECISION: We implement exponential backoff for retries and provide
+multiple installation strategies (pip, conda, source) to maximize success rate.
+"""
+
+import subprocess
+import sys
+import time
+import json
+import re
+from pathlib import Path
+from typing import List, Tuple, Optional, Dict, Any
+from enum import Enum
+from dataclasses import dataclass
+
+from ..core.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class InstallStrategy(Enum):
+    """Available installation strategies."""
+    PIP = "pip"
+    PIP_NO_DEPS = "pip_no_deps"
+    PIP_UPGRADE = "pip_upgrade"
+    PIP_INDEX_URL = "pip_index_url"
+    SOURCE = "source"
+
+
+@dataclass
+class InstallAttempt:
+    """Record of an installation attempt."""
+    strategy: InstallStrategy
+    package: str
+    success: bool
+    error: Optional[str]
+    duration: float
+    retry_count: int
+
+
+class RobustPackageInstaller:
+    """
+    Robust package installer with retry logic and multiple strategies.
+    
+    WHY: This class handles the complexity of package installation in various
+    environments, network conditions, and Python versions. It ensures maximum
+    success rate while providing clear feedback on failures.
+    """
+    
+    def __init__(
+        self,
+        max_retries: int = 3,
+        retry_delay: float = 2.0,
+        timeout: int = 300,
+        use_cache: bool = True
+    ):
+        """
+        Initialize robust installer.
+        
+        Args:
+            max_retries: Maximum number of retry attempts per package
+            retry_delay: Initial delay between retries (uses exponential backoff)
+            timeout: Maximum time for each installation attempt in seconds
+            use_cache: Whether to use pip cache
+        """
+        self.max_retries = max_retries
+        self.retry_delay = retry_delay
+        self.timeout = timeout
+        self.use_cache = use_cache
+        self.attempts: List[InstallAttempt] = []
+        self.success_cache: Dict[str, bool] = {}
+        
+    def install_package(
+        self,
+        package_spec: str,
+        strategies: Optional[List[InstallStrategy]] = None
+    ) -> Tuple[bool, Optional[str]]:
+        """
+        Install a package using robust retry logic and multiple strategies.
+        
+        WHY: Single installation attempts often fail due to transient issues.
+        This method tries multiple strategies with retries to maximize success.
+        
+        Args:
+            package_spec: Package specification (e.g., "pandas>=2.0.0")
+            strategies: List of strategies to try (defaults to sensible order)
+            
+        Returns:
+            Tuple of (success, error_message)
+        """
+        # Check success cache first
+        if package_spec in self.success_cache:
+            if self.success_cache[package_spec]:
+                logger.debug(f"Package {package_spec} already successfully installed")
+                return True, None
+        
+        # Default strategy order
+        if strategies is None:
+            strategies = [
+                InstallStrategy.PIP,
+                InstallStrategy.PIP_UPGRADE,
+                InstallStrategy.PIP_NO_DEPS,
+                InstallStrategy.PIP_INDEX_URL,
+            ]
+        
+        # Extract package name for special handling
+        package_name = self._extract_package_name(package_spec)
+        
+        # Special handling for known problematic packages
+        if self._needs_special_handling(package_name):
+            strategies = self._get_special_strategies(package_name)
+        
+        # Try each strategy with retries
+        for strategy in strategies:
+            for retry in range(self.max_retries):
+                start_time = time.time()
+                
+                # Calculate delay with exponential backoff
+                if retry > 0:
+                    delay = self.retry_delay * (2 ** (retry - 1))
+                    logger.info(f"Retry {retry}/{self.max_retries} after {delay:.1f}s delay...")
+                    time.sleep(delay)
+                
+                # Attempt installation
+                success, error = self._attempt_install(package_spec, strategy)
+                duration = time.time() - start_time
+                
+                # Record attempt
+                self.attempts.append(InstallAttempt(
+                    strategy=strategy,
+                    package=package_spec,
+                    success=success,
+                    error=error,
+                    duration=duration,
+                    retry_count=retry
+                ))
+                
+                if success:
+                    logger.info(f"Successfully installed {package_spec} using {strategy.value}")
+                    self.success_cache[package_spec] = True
+                    return True, None
+                
+                # Check if error is retryable
+                if not self._is_retryable_error(error):
+                    logger.warning(f"Non-retryable error for {package_spec}: {error}")
+                    break
+        
+        # All attempts failed
+        self.success_cache[package_spec] = False
+        final_error = self._get_consolidated_error(package_spec)
+        return False, final_error
+    
+    def _attempt_install(
+        self,
+        package_spec: str,
+        strategy: InstallStrategy
+    ) -> Tuple[bool, Optional[str]]:
+        """
+        Attempt to install a package using a specific strategy.
+        
+        Args:
+            package_spec: Package specification
+            strategy: Installation strategy to use
+            
+        Returns:
+            Tuple of (success, error_message)
+        """
+        try:
+            cmd = self._build_install_command(package_spec, strategy)
+            logger.debug(f"Running: {' '.join(cmd)}")
+            
+            result = subprocess.run(
+                cmd,
+                capture_output=True,
+                text=True,
+                timeout=self.timeout
+            )
+            
+            if result.returncode == 0:
+                # Verify installation
+                if self._verify_installation(package_spec):
+                    return True, None
+                else:
+                    return False, "Package installed but verification failed"
+            else:
+                error_msg = self._extract_error_message(result.stderr)
+                logger.debug(f"Installation failed: {error_msg}")
+                return False, error_msg
+                
+        except subprocess.TimeoutExpired:
+            return False, f"Installation timed out after {self.timeout}s"
+        except Exception as e:
+            return False, f"Unexpected error: {str(e)}"
+    
+    def _build_install_command(
+        self,
+        package_spec: str,
+        strategy: InstallStrategy
+    ) -> List[str]:
+        """
+        Build the installation command for a given strategy.
+        
+        Args:
+            package_spec: Package specification
+            strategy: Installation strategy
+            
+        Returns:
+            Command as list of arguments
+        """
+        base_cmd = [sys.executable, "-m", "pip", "install"]
+        
+        # Add cache control
+        if not self.use_cache:
+            base_cmd.append("--no-cache-dir")
+        
+        if strategy == InstallStrategy.PIP:
+            return base_cmd + [package_spec]
+            
+        elif strategy == InstallStrategy.PIP_NO_DEPS:
+            return base_cmd + ["--no-deps", package_spec]
+            
+        elif strategy == InstallStrategy.PIP_UPGRADE:
+            return base_cmd + ["--upgrade", package_spec]
+            
+        elif strategy == InstallStrategy.PIP_INDEX_URL:
+            # Try alternative index (PyPI mirror)
+            return base_cmd + [
+                "--index-url", "https://pypi.org/simple",
+                "--extra-index-url", "https://pypi.python.org/simple",
+                package_spec
+            ]
+            
+        else:
+            return base_cmd + [package_spec]
+    
+    def _extract_package_name(self, package_spec: str) -> str:
+        """
+        Extract package name from specification.
+        
+        Args:
+            package_spec: Package specification (e.g., "pandas>=2.0.0")
+            
+        Returns:
+            Package name (e.g., "pandas")
+        """
+        # Remove version specifiers
+        match = re.match(r'^([a-zA-Z0-9_-]+)', package_spec)
+        if match:
+            return match.group(1)
+        return package_spec
+    
+    def _needs_special_handling(self, package_name: str) -> bool:
+        """
+        Check if package needs special installation handling.
+        
+        Args:
+            package_name: Name of the package
+            
+        Returns:
+            True if package needs special handling
+        """
+        # Known problematic packages
+        special_packages = {
+            'tree-sitter-ruby',
+            'tree-sitter-php',
+            'tree-sitter-javascript',
+            'tree-sitter-typescript',
+            'tree-sitter-go',
+            'tree-sitter-rust',
+            'tree-sitter-java',
+            'tree-sitter-cpp',
+            'tree-sitter-c',
+        }
+        
+        return package_name.lower() in special_packages
+    
+    def _get_special_strategies(self, package_name: str) -> List[InstallStrategy]:
+        """
+        Get special installation strategies for problematic packages.
+        
+        Args:
+            package_name: Name of the package
+            
+        Returns:
+            List of strategies to try
+        """
+        # For tree-sitter packages, try upgrade first (often fixes version conflicts)
+        if package_name.startswith('tree-sitter-'):
+            return [
+                InstallStrategy.PIP_UPGRADE,
+                InstallStrategy.PIP,
+                InstallStrategy.PIP_INDEX_URL,
+                InstallStrategy.PIP_NO_DEPS,
+            ]
+        
+        return [InstallStrategy.PIP, InstallStrategy.PIP_UPGRADE]
+    
+    def _verify_installation(self, package_spec: str) -> bool:
+        """
+        Verify that a package was successfully installed.
+        
+        Args:
+            package_spec: Package specification
+            
+        Returns:
+            True if package is installed and importable
+        """
+        package_name = self._extract_package_name(package_spec)
+        
+        # Convert package name to import name (e.g., tree-sitter-ruby -> tree_sitter_ruby)
+        import_name = package_name.replace('-', '_')
+        
+        try:
+            # Check if package is installed
+            import importlib.metadata
+            try:
+                version = importlib.metadata.version(package_name)
+                logger.debug(f"Package {package_name} version {version} is installed")
+                
+                # For tree-sitter packages, don't try to import (they have C extensions)
+                if package_name.startswith('tree-sitter-'):
+                    return True
+                
+                # Try to import the package
+                try:
+                    __import__(import_name)
+                    return True
+                except ImportError:
+                    # Some packages have different import names, that's OK
+                    return True
+                    
+            except importlib.metadata.PackageNotFoundError:
+                return False
+                
+        except ImportError:
+            # Fallback for older Python versions
+            try:
+                import pkg_resources
+                pkg_resources.get_distribution(package_name)
+                return True
+            except pkg_resources.DistributionNotFound:
+                return False
+    
+    def _is_retryable_error(self, error: Optional[str]) -> bool:
+        """
+        Determine if an error is worth retrying.
+        
+        Args:
+            error: Error message
+            
+        Returns:
+            True if error is retryable
+        """
+        if not error:
+            return False
+        
+        # Retryable error patterns
+        retryable_patterns = [
+            'connection', 'timeout', 'temporary failure',
+            'network', 'unreachable', 'could not find',
+            'no matching distribution', 'httperror',
+            'http error', 'ssl', 'certificate',
+            'readtimeout', 'connectionerror'
+        ]
+        
+        error_lower = error.lower()
+        return any(pattern in error_lower for pattern in retryable_patterns)
+    
+    def _extract_error_message(self, stderr: str) -> str:
+        """
+        Extract meaningful error message from pip stderr.
+        
+        Args:
+            stderr: Standard error output from pip
+            
+        Returns:
+            Extracted error message
+        """
+        if not stderr:
+            return "Unknown error"
+        
+        # Look for ERROR: lines
+        error_lines = []
+        for line in stderr.splitlines():
+            if 'ERROR:' in line:
+                error_lines.append(line.split('ERROR:', 1)[1].strip())
+        
+        if error_lines:
+            return ' | '.join(error_lines)
+        
+        # Fall back to last non-empty line
+        lines = [l.strip() for l in stderr.splitlines() if l.strip()]
+        if lines:
+            return lines[-1]
+        
+        return "Installation failed"
+    
+    def _get_consolidated_error(self, package_spec: str) -> str:
+        """
+        Get a consolidated error message from all attempts.
+        
+        Args:
+            package_spec: Package specification that failed
+            
+        Returns:
+            Consolidated error message
+        """
+        # Get unique error messages from attempts
+        errors = set()
+        for attempt in self.attempts:
+            if attempt.package == package_spec and attempt.error:
+                errors.add(attempt.error)
+        
+        if not errors:
+            return f"Failed to install {package_spec} after {len(self.attempts)} attempts"
+        
+        # Format error message
+        if len(errors) == 1:
+            return list(errors)[0]
+        else:
+            return f"Multiple errors: {' | '.join(errors)}"
+    
+    def install_packages(
+        self,
+        packages: List[str],
+        parallel: bool = False
+    ) -> Tuple[List[str], List[str], Dict[str, str]]:
+        """
+        Install multiple packages with robust error handling.
+        
+        Args:
+            packages: List of package specifications
+            parallel: Whether to attempt parallel installation
+            
+        Returns:
+            Tuple of (successful_packages, failed_packages, error_map)
+        """
+        successful = []
+        failed = []
+        errors = {}
+        
+        # Group packages that can be installed together
+        if parallel and len(packages) > 1:
+            # Try to install all at once first
+            logger.info(f"Attempting batch installation of {len(packages)} packages...")
+            success, error = self._attempt_batch_install(packages)
+            
+            if success:
+                logger.info("Batch installation successful")
+                return packages, [], {}
+            else:
+                logger.warning(f"Batch installation failed: {error}")
+                logger.info("Falling back to individual installation...")
+        
+        # Install packages individually
+        for i, package in enumerate(packages, 1):
+            logger.info(f"Installing package {i}/{len(packages)}: {package}")
+            
+            success, error = self.install_package(package)
+            
+            if success:
+                successful.append(package)
+            else:
+                failed.append(package)
+                errors[package] = error or "Unknown error"
+        
+        return successful, failed, errors
+    
+    def _attempt_batch_install(self, packages: List[str]) -> Tuple[bool, Optional[str]]:
+        """
+        Attempt to install multiple packages in a single pip command.
+        
+        Args:
+            packages: List of package specifications
+            
+        Returns:
+            Tuple of (success, error_message)
+        """
+        try:
+            cmd = [sys.executable, "-m", "pip", "install"] + packages
+            
+            result = subprocess.run(
+                cmd,
+                capture_output=True,
+                text=True,
+                timeout=self.timeout * 2  # Longer timeout for batch
+            )
+            
+            if result.returncode == 0:
+                # Verify all packages
+                all_verified = all(
+                    self._verify_installation(pkg) for pkg in packages
+                )
+                if all_verified:
+                    return True, None
+                else:
+                    return False, "Some packages failed verification"
+            else:
+                error_msg = self._extract_error_message(result.stderr)
+                return False, error_msg
+                
+        except subprocess.TimeoutExpired:
+            return False, f"Batch installation timed out"
+        except Exception as e:
+            return False, f"Batch installation error: {str(e)}"
+    
+    def get_report(self) -> str:
+        """
+        Generate a report of installation attempts.
+        
+        Returns:
+            Formatted report string
+        """
+        lines = []
+        lines.append("=" * 60)
+        lines.append("INSTALLATION REPORT")
+        lines.append("=" * 60)
+        
+        # Summary
+        total_attempts = len(self.attempts)
+        successful = sum(1 for a in self.attempts if a.success)
+        failed = total_attempts - successful
+        
+        lines.append(f"Total attempts: {total_attempts}")
+        lines.append(f"Successful: {successful}")
+        lines.append(f"Failed: {failed}")
+        lines.append("")
+        
+        # Details by package
+        packages = {}
+        for attempt in self.attempts:
+            if attempt.package not in packages:
+                packages[attempt.package] = []
+            packages[attempt.package].append(attempt)
+        
+        for package, attempts in packages.items():
+            success = any(a.success for a in attempts)
+            status = "✓" if success else "✗"
+            lines.append(f"{status} {package}:")
+            
+            for attempt in attempts:
+                retry_str = f" (retry {attempt.retry_count})" if attempt.retry_count > 0 else ""
+                result = "success" if attempt.success else f"failed: {attempt.error}"
+                lines.append(f"  - {attempt.strategy.value}{retry_str}: {result}")
+        
+        lines.append("=" * 60)
+        return "\n".join(lines)
+
+
+def install_with_retry(
+    packages: List[str],
+    max_retries: int = 3,
+    verbose: bool = False
+) -> Tuple[bool, str]:
+    """
+    Convenience function to install packages with retry logic.
+    
+    Args:
+        packages: List of package specifications
+        max_retries: Maximum retry attempts
+        verbose: Whether to print verbose output
+        
+    Returns:
+        Tuple of (all_success, error_message)
+    """
+    if verbose:
+        import logging
+        logging.getLogger().setLevel(logging.DEBUG)
+    
+    installer = RobustPackageInstaller(max_retries=max_retries)
+    successful, failed, errors = installer.install_packages(packages)
+    
+    if verbose:
+        print(installer.get_report())
+    
+    if failed:
+        error_msg = f"Failed to install {len(failed)} packages: "
+        error_msg += ", ".join(f"{pkg} ({errors[pkg]})" for pkg in failed)
+        return False, error_msg
+    
+    return True, ""

{claude_mpm-3.7.1.dist-info → claude_mpm-3.7.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 3.7.1
+Version: 3.7.8
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team
@@ -30,7 +30,6 @@ Requires-Dist: flask>=3.0.0
 Requires-Dist: flask-cors>=4.0.0
 Requires-Dist: watchdog>=3.0.0
 Requires-Dist: tree-sitter>=0.21.0
-Requires-Dist: tree-sitter-language-pack>=0.8.0
 Requires-Dist: python-socketio>=5.11.0
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: aiohttp-cors>=0.8.0
@@ -47,53 +46,48 @@ Requires-Dist: flake8; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Provides-Extra: monitor
 Provides-Extra: agents
-Requires-Dist: allure-pytest>=2.13.0; extra == "agents"
-Requires-Dist: ansible>=9.0.0; extra == "agents"
-Requires-Dist: apache-airflow>=2.8.0; extra == "agents"
 Requires-Dist: bandit>=1.7.5; extra == "agents"
 Requires-Dist: black>=23.0.0; extra == "agents"
-Requires-Dist: checkov>=3.1.0; extra == "agents"
 Requires-Dist: commitizen>=3.13.0; extra == "agents"
-Requires-Dist: cryptography>=41.0.0; extra == "agents"
 Requires-Dist: dask>=2023.12.0; extra == "agents"
 Requires-Dist: detect-secrets>=1.4.0; extra == "agents"
 Requires-Dist: diagrams>=0.23.0; extra == "agents"
-Requires-Dist: docker>=7.0.0; extra == "agents"
 Requires-Dist: docstring-parser>=0.15.0; extra == "agents"
 Requires-Dist: faker>=20.0.0; extra == "agents"
 Requires-Dist: gitlint>=0.19.0; extra == "agents"
 Requires-Dist: gitpython>=3.1.40; extra == "agents"
-Requires-Dist: great-expectations>=0.18.0; extra == "agents"
 Requires-Dist: hypothesis>=6.92.0; extra == "agents"
 Requires-Dist: isort>=5.12.0; extra == "agents"
-Requires-Dist: kubernetes>=28.0.0; extra == "agents"
 Requires-Dist: lizard>=1.17.0; extra == "agents"
 Requires-Dist: mermaid-py>=0.2.0; extra == "agents"
 Requires-Dist: mkdocs>=1.5.0; extra == "agents"
 Requires-Dist: mutmut>=2.4.0; extra == "agents"
 Requires-Dist: mypy>=1.8.0; extra == "agents"
 Requires-Dist: pandas>=2.1.0; extra == "agents"
-Requires-Dist: pip-audit>=2.6.0; extra == "agents"
 Requires-Dist: pre-commit>=3.5.0; extra == "agents"
 Requires-Dist: prometheus-client>=0.19.0; extra == "agents"
 Requires-Dist: pydoc-markdown>=4.8.0; extra == "agents"
 Requires-Dist: pydriller>=2.5.0; extra == "agents"
 Requires-Dist: pygments>=2.17.0; extra == "agents"
-Requires-Dist: pyjwt>=2.8.0; extra == "agents"
 Requires-Dist: pytest>=7.4.0; extra == "agents"
 Requires-Dist: pytest-benchmark>=4.0.0; extra == "agents"
 Requires-Dist: pytest-cov>=4.1.0; extra == "agents"
 Requires-Dist: radon>=6.0.0; extra == "agents"
 Requires-Dist: rope>=1.11.0; extra == "agents"
-Requires-Dist: safety>=3.0.0; extra == "agents"
-Requires-Dist: semgrep>=1.45.0; extra == "agents"
 Requires-Dist: sphinx>=7.2.0; extra == "agents"
 Requires-Dist: sqlalchemy>=2.0.0; extra == "agents"
 Requires-Dist: sqlparse>=0.4.4; extra == "agents"
-Requires-Dist: terraform-compliance>=1.3.0; extra == "agents"
 Requires-Dist: tree-sitter>=0.21.0; extra == "agents"
-Requires-Dist: tree-sitter-language-pack>=0.8.0; extra == "agents"
-Requires-Dist: ydata-profiling>=4.6.0; extra == "agents"
+Requires-Dist: tree-sitter-python>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-javascript>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-typescript>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-go>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-rust>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-java>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-cpp>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-c>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-ruby>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-php>=0.21.0; extra == "agents"
 Dynamic: author-email
 Dynamic: home-page
 Dynamic: license-file
@@ -118,19 +112,21 @@ A powerful orchestration framework for Claude Code that enables multi-agent work
 ## Installation
 
 ```bash
-# Install from PyPI
+# Basic installation - pure Python, no compilation required
 pip install claude-mpm
 
 # Install with development dependencies
 pip install "claude-mpm[dev]"
 
-# Install with agent dependencies (recommended for full functionality)
+# Install with agent dependencies - pure Python tools
 pip install "claude-mpm[agents]"
 
 # Install with all optional dependencies
 pip install "claude-mpm[agents,dev]"
 ```
 
+All dependencies are pure Python - no Rust or compilation required. The `agents` dependency group includes tools for testing, code analysis, documentation, and development workflows.
+
 ## Basic Usage
 
 ```bash
@@ -164,10 +160,10 @@ For detailed usage, see [QUICKSTART.md](QUICKSTART.md)
 
 ### Agent Dependencies
 
-Claude MPM automatically manages Python dependencies required by agents. Agents can declare their dependencies in their configuration files, and the system aggregates them for easy installation.
+Claude MPM automatically manages Python dependencies required by agents. All dependencies are pure Python packages that don't require compilation. Agents can declare their dependencies in their configuration files, and the system aggregates them for easy installation.
 
 ```bash
-# Install all agent dependencies
+# Install all agent dependencies (pure Python)
 pip install "claude-mpm[agents]"
 
 # View current agent dependencies