claude-mpm 3.4.10__py3-none-any.whl → 5.4.55__py3-none-any.whl

claude_mpm/services/parent_directory_manager/version_control_helper.py

@@ -1,339 +0,0 @@
-#!/usr/bin/env python3
-"""
-Version Control Helper Module
-=============================
-
-This module provides version control utilities for the Parent Directory Manager.
-It handles git operations and version control integration for the framework.
-
-Key Features:
-- Git repository detection
-- Branch management helpers
-- Commit status checking
-- Version control integration utilities
-"""
-
-import os
-from pathlib import Path
-from typing import Optional, List, Dict, Tuple, Any
-import logging
-from claude_pm.utils.subprocess_manager import SubprocessManager
-
-
-class VersionControlHelper:
-    """
-    Helper class for version control operations.
-    
-    This class provides utilities for interacting with git repositories
-    and managing version control operations within the framework.
-    """
-    
-    def __init__(self, working_dir: Path, logger: Optional[logging.Logger] = None):
-        """
-        Initialize the Version Control Helper.
-        
-        Args:
-            working_dir: The working directory path
-            logger: Optional logger instance
-        """
-        self.working_dir = Path(working_dir)
-        self.logger = logger or logging.getLogger(__name__)
-        
-        # Initialize subprocess manager
-        self.subprocess_manager = SubprocessManager()
-        
-        # Cache git repository detection
-        self._is_git_repo: Optional[bool] = None
-        self._git_root: Optional[Path] = None
-    
-    def is_git_repository(self) -> bool:
-        """
-        Check if the working directory is inside a git repository.
-        
-        Returns:
-            True if inside a git repository, False otherwise
-        """
-        if self._is_git_repo is not None:
-            return self._is_git_repo
-        
-        try:
-            result = self.subprocess_manager.run(
-                ["git", "rev-parse", "--git-dir"],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            self._is_git_repo = result.success
-            
-            if self._is_git_repo:
-                # Get the root of the git repository
-                root_result = self.subprocess_manager.run(
-                    ["git", "rev-parse", "--show-toplevel"],
-                    cwd=self.working_dir,
-                    capture_output=True,
-                    text=True
-                )
-                if root_result.success:
-                    self._git_root = Path(root_result.stdout.strip())
-            
-            return self._is_git_repo
-        except (OSError, FileNotFoundError):
-            self._is_git_repo = False
-            return False
-    
-    def get_git_root(self) -> Optional[Path]:
-        """
-        Get the root directory of the git repository.
-        
-        Returns:
-            Path to git root directory, or None if not in a git repo
-        """
-        if self.is_git_repository():
-            return self._git_root
-        return None
-    
-    def get_current_branch(self) -> Optional[str]:
-        """
-        Get the current git branch name.
-        
-        Returns:
-            Branch name or None if not in a git repository
-        """
-        if not self.is_git_repository():
-            return None
-        
-        try:
-            result = self.subprocess_manager.run(
-                ["git", "rev-parse", "--abbrev-ref", "HEAD"],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            if result.success:
-                return result.stdout.strip()
-        except Exception:
-            pass
-        
-        return None
-    
-    def has_uncommitted_changes(self) -> bool:
-        """
-        Check if there are uncommitted changes in the repository.
-        
-        Returns:
-            True if there are uncommitted changes, False otherwise
-        """
-        if not self.is_git_repository():
-            return False
-        
-        try:
-            result = self.subprocess_manager.run(
-                ["git", "status", "--porcelain"],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            if result.success:
-                return bool(result.stdout.strip())
-        except Exception:
-            pass
-        
-        return False
-    
-    def get_file_status(self, file_path: Path) -> Optional[str]:
-        """
-        Get the git status of a specific file.
-        
-        Args:
-            file_path: Path to the file to check
-            
-        Returns:
-            Git status string or None if not tracked
-        """
-        if not self.is_git_repository():
-            return None
-        
-        try:
-            # Make path relative to git root for consistent results
-            git_root = self.get_git_root()
-            if git_root:
-                try:
-                    relative_path = file_path.relative_to(git_root)
-                except ValueError:
-                    # File is outside git repository
-                    return None
-            else:
-                relative_path = file_path
-            
-            result = self.subprocess_manager.run(
-                ["git", "status", "--porcelain", str(relative_path)],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            if result.success and result.stdout:
-                return result.stdout.strip()
-        except Exception:
-            pass
-        
-        return None
-    
-    def is_file_ignored(self, file_path: Path) -> bool:
-        """
-        Check if a file is ignored by git.
-        
-        Args:
-            file_path: Path to check
-            
-        Returns:
-            True if file is ignored, False otherwise
-        """
-        if not self.is_git_repository():
-            return False
-        
-        try:
-            result = self.subprocess_manager.run(
-                ["git", "check-ignore", str(file_path)],
-                cwd=self.working_dir,
-                capture_output=True
-            )
-            return result.success
-        except Exception:
-            return False
-    
-    def add_to_gitignore(self, pattern: str) -> bool:
-        """
-        Add a pattern to .gitignore file.
-        
-        Args:
-            pattern: Pattern to add to gitignore
-            
-        Returns:
-            True if successfully added, False otherwise
-        """
-        if not self.is_git_repository():
-            self.logger.debug("Not in a git repository, skipping gitignore update")
-            return False
-        
-        git_root = self.get_git_root()
-        if not git_root:
-            return False
-        
-        gitignore_path = git_root / ".gitignore"
-        
-        try:
-            # Read existing content
-            existing_patterns = set()
-            if gitignore_path.exists():
-                existing_patterns = set(gitignore_path.read_text().strip().split('\n'))
-            
-            # Add pattern if not already present
-            if pattern not in existing_patterns:
-                with open(gitignore_path, 'a') as f:
-                    if gitignore_path.exists() and gitignore_path.stat().st_size > 0:
-                        f.write('\n')
-                    f.write(f"{pattern}\n")
-                
-                self.logger.info(f"Added '{pattern}' to .gitignore")
-                return True
-            else:
-                self.logger.debug(f"Pattern '{pattern}' already in .gitignore")
-                return True
-                
-        except Exception as e:
-            self.logger.warning(f"Failed to update .gitignore: {e}")
-            return False
-    
-    def get_last_commit_info(self) -> Optional[Dict[str, str]]:
-        """
-        Get information about the last commit.
-        
-        Returns:
-            Dictionary with commit info or None if not in a git repo
-        """
-        if not self.is_git_repository():
-            return None
-        
-        try:
-            # Get commit hash
-            hash_result = self.subprocess_manager.run(
-                ["git", "rev-parse", "HEAD"],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            
-            # Get commit message
-            msg_result = self.subprocess_manager.run(
-                ["git", "log", "-1", "--pretty=%B"],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            
-            # Get commit author
-            author_result = self.subprocess_manager.run(
-                ["git", "log", "-1", "--pretty=%an <%ae>"],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            
-            # Get commit date
-            date_result = self.subprocess_manager.run(
-                ["git", "log", "-1", "--pretty=%ai"],
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            
-            if all(r.success for r in [hash_result, msg_result, author_result, date_result]):
-                return {
-                    "hash": hash_result.stdout.strip(),
-                    "message": msg_result.stdout.strip(),
-                    "author": author_result.stdout.strip(),
-                    "date": date_result.stdout.strip()
-                }
-                
-        except Exception:
-            pass
-        
-        return None
-    
-    def create_version_tag(self, version: str, message: Optional[str] = None) -> bool:
-        """
-        Create a git tag for a version.
-        
-        Args:
-            version: Version string (e.g., "v1.0.0")
-            message: Optional tag message
-            
-        Returns:
-            True if tag was created successfully
-        """
-        if not self.is_git_repository():
-            return False
-        
-        try:
-            if message:
-                cmd = ["git", "tag", "-a", version, "-m", message]
-            else:
-                cmd = ["git", "tag", version]
-            
-            result = self.subprocess_manager.run(
-                cmd,
-                cwd=self.working_dir,
-                capture_output=True,
-                text=True
-            )
-            
-            if result.success:
-                self.logger.info(f"Created git tag: {version}")
-                return True
-            else:
-                self.logger.warning(f"Failed to create git tag: {result.stderr}")
-                return False
-                
-        except Exception as e:
-            self.logger.warning(f"Error creating git tag: {e}")
-            return False

claude_mpm/services/parent_directory_manager/version_manager.py

@@ -1,222 +0,0 @@
-#!/usr/bin/env python3
-"""
-Version Manager - Handles subsystem version tracking and management
-================================================================================
-
-This module manages subsystem version tracking, loading, updating, and reporting
-for the parent directory manager service.
-"""
-
-from pathlib import Path
-from typing import Dict, Any, Optional
-from datetime import datetime
-import logging
-from ...utils.path_operations import path_ops
-
-
-class VersionManager:
-    """Manages subsystem version tracking and operations."""
-
-    def __init__(
-        self,
-        framework_path: Path,
-        logger: Optional[logging.Logger] = None
-    ):
-        """
-        Initialize the Version Manager.
-
-        Args:
-            framework_path: Path to framework
-            logger: Logger instance to use
-        """
-        self.framework_path = framework_path
-        self.logger = logger or logging.getLogger(__name__)
-        self.subsystem_versions: Dict[str, Dict[str, Any]] = {}
-        
-        # Define subsystem version files
-        self.subsystem_files = {
-            "health": "HEALTH_VERSION"
-        }
-
-    async def load_subsystem_versions(self) -> None:
-        """Load subsystem versions from version files."""
-        try:
-            for subsystem, filename in self.subsystem_files.items():
-                version_file = self.framework_path / filename
-                if path_ops.validate_exists(version_file):
-                    try:
-                        version_content = path_ops.safe_read(version_file)
-                        version = version_content.strip() if version_content else ""
-                        self.subsystem_versions[subsystem] = {
-                            "version": version,
-                            "file_path": str(version_file),
-                            "last_checked": datetime.now().isoformat()
-                        }
-                        self.logger.debug(f"Loaded {subsystem} version: {version}")
-                    except Exception as e:
-                        self.logger.error(f"Failed to read {subsystem} version from {version_file}: {e}")
-                        self.subsystem_versions[subsystem] = {
-                            "version": "unknown",
-                            "file_path": str(version_file),
-                            "error": str(e),
-                            "last_checked": datetime.now().isoformat()
-                        }
-                else:
-                    self.logger.warning(f"Subsystem version file not found: {version_file}")
-                    self.subsystem_versions[subsystem] = {
-                        "version": "not_found",
-                        "file_path": str(version_file),
-                        "last_checked": datetime.now().isoformat()
-                    }
-
-            self.logger.info(f"Loading subsystem versions...")
-
-        except Exception as e:
-            self.logger.error(f"Failed to load subsystem versions: {e}")
-
-    def get_subsystem_versions(self) -> Dict[str, Any]:
-        """
-        Get all detected subsystem versions.
-
-        Returns:
-            Dictionary with subsystem version information
-        """
-        return {
-            "framework_path": str(self.framework_path),
-            "subsystems": self.subsystem_versions.copy(),
-            "detection_timestamp": datetime.now().isoformat()
-        }
-
-    def get_subsystem_version(self, subsystem: str) -> Optional[str]:
-        """
-        Get version for a specific subsystem.
-
-        Args:
-            subsystem: Name of the subsystem
-
-        Returns:
-            Version string or None if not found
-        """
-        version_info = self.subsystem_versions.get(subsystem, {})
-        version = version_info.get("version")
-        
-        # Return None for error states
-        if version in ["unknown", "not_found"]:
-            return None
-            
-        return version
-
-    async def update_subsystem_version(
-        self,
-        subsystem: str,
-        new_version: str,
-        create_backup_func
-    ) -> bool:
-        """
-        Update a subsystem version file.
-
-        Args:
-            subsystem: Name of the subsystem
-            new_version: New version string
-            create_backup_func: Function to create backup of version file
-
-        Returns:
-            True if updated successfully, False otherwise
-        """
-        try:
-            filename = self.subsystem_files.get(subsystem)
-            if not filename:
-                self.logger.error(f"Unknown subsystem: {subsystem}")
-                return False
-
-            version_file = self.framework_path / filename
-            
-            # Backup existing version file if it exists
-            if version_file.exists():
-                backup_path = await create_backup_func(version_file)
-                if backup_path:
-                    self.logger.info(f"Created backup of {filename}: {backup_path}")
-
-            # Write new version
-            version_file.write_text(new_version.strip())
-            
-            # Update in-memory tracking
-            self.subsystem_versions[subsystem] = {
-                "version": new_version,
-                "file_path": str(version_file),
-                "last_updated": datetime.now().isoformat()
-            }
-
-            self.logger.info(f"Updated {subsystem} version to: {new_version}")
-            return True
-
-        except Exception as e:
-            self.logger.error(f"Failed to update {subsystem} version to {new_version}: {e}")
-            return False
-
-    def get_subsystem_version_report(self) -> Dict[str, Any]:
-        """
-        Generate a comprehensive subsystem version report.
-
-        Returns:
-            Dictionary with detailed version information
-        """
-        try:
-            report = {
-                "report_timestamp": datetime.now().isoformat(),
-                "framework_path": str(self.framework_path),
-                "subsystem_count": len(self.subsystem_versions),
-                "subsystems": {},
-                "summary": {
-                    "total": 0,
-                    "found": 0,
-                    "missing": 0,
-                    "errors": 0
-                }
-            }
-
-            for subsystem, info in self.subsystem_versions.items():
-                version = info.get("version", "unknown")
-                status = "found"
-                
-                if version == "not_found":
-                    status = "missing"
-                    report["summary"]["missing"] += 1
-                elif version == "unknown" or "error" in info:
-                    status = "error"
-                    report["summary"]["errors"] += 1
-                else:
-                    report["summary"]["found"] += 1
-                
-                report["summary"]["total"] += 1
-                
-                report["subsystems"][subsystem] = {
-                    "version": version,
-                    "status": status,
-                    "file_path": info.get("file_path"),
-                    "last_checked": info.get("last_checked"),
-                    "error": info.get("error")
-                }
-
-            return report
-
-        except Exception as e:
-            self.logger.error(f"Failed to generate subsystem version report: {e}")
-            return {
-                "error": str(e),
-                "report_timestamp": datetime.now().isoformat()
-            }
-
-    def get_version_report(self) -> Dict[str, Any]:
-        """
-        Get a simple version report (for compatibility with VersionControlHelper).
-        
-        Returns:
-            Dictionary with subsystem versions
-        """
-        return {
-            "subsystems": {
-                subsystem: info.get("version", "unknown")
-                for subsystem, info in self.subsystem_versions.items()
-            }
-        }