lite-kits 0.1.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

lite_kits/core/manifest.py

@@ -1,146 +1,146 @@
-"""
-Kit manifest loader and utilities.
-
-Loads kit definitions from kits.yaml and provides helpers for installation,
-validation, and status checking.
-"""
-
-from pathlib import Path
-from typing import Dict, List, Optional
-import yaml
-
-
-class KitManifest:
-    """Loads and provides access to kit definitions from kits.yaml"""
-
-    def __init__(self, kits_dir: Path):
-        """
-        Initialize manifest loader.
-
-        Args:
-            kits_dir: Path to kits directory containing kits.yaml
-        """
-        self.kits_dir = kits_dir
-        self.manifest_path = kits_dir / "kits.yaml"
-        self._manifest = None
-
-    @property
-    def manifest(self) -> Dict:
-        """Load and cache manifest data"""
-        if self._manifest is None:
-            with open(self.manifest_path) as f:
-                self._manifest = yaml.safe_load(f)
-        return self._manifest
-
-    def get_kit(self, kit_name: str) -> Optional[Dict]:
-        """Get kit definition by name"""
-        return self.manifest['kits'].get(kit_name)
-
-    def get_all_kits(self) -> Dict[str, Dict]:
-        """Get all kit definitions"""
-        return self.manifest['kits']
-
-    def get_kit_names(self) -> List[str]:
-        """Get list of all kit names"""
-        return list(self.manifest['kits'].keys())
-
-    def get_recommended_kits(self) -> List[str]:
-        """Get list of recommended kit names"""
-        return [
-            name for name, kit in self.manifest['kits'].items()
-            if kit.get('recommended', False)
-        ]
-
-    def get_default_kit(self) -> str:
-        """Get default kit name"""
-        return self.manifest['options']['default_kit']
-
-    def get_kit_files(self, kit_name: str, agent: Optional[str] = None) -> List[Dict]:
-        """
-        Get list of files for a kit.
-
-        Args:
-            kit_name: Name of kit
-            agent: Optional agent filter ('claude', 'copilot', None for all)
-
-        Returns:
-            List of file dicts with 'path', 'source', 'required' keys
-        """
-        kit = self.get_kit(kit_name)
-        if not kit:
-            return []
-
-        files = []
-        file_groups = kit.get('files', {})
-
-        # Map agent names to file groups
-        agent_groups = {
-            'claude': ['claude'],
-            'copilot': ['copilot'],
-            None: list(file_groups.keys())  # All groups
-        }
-
-        groups_to_include = agent_groups.get(agent, [])
-
-        for group_name in groups_to_include:
-            if group_name in file_groups:
-                files.extend(file_groups[group_name])
-
-        return files
-
-    def get_kit_markers(self, kit_name: str) -> List[str]:
-        """
-        Get marker files for kit detection.
-
-        Args:
-            kit_name: Name of kit
-
-        Returns:
-            List of marker file paths
-        """
-        kit = self.get_kit(kit_name)
-        return kit.get('markers', []) if kit else []
-
-    def get_kit_commands(self, kit_name: str) -> List[Dict]:
-        """
-        Get list of commands for a kit.
-
-        Args:
-            kit_name: Name of kit
-
-        Returns:
-            List of command dicts with 'name', 'description', 'status' keys
-        """
-        kit = self.get_kit(kit_name)
-        return kit.get('commands', []) if kit else []
-
-    def get_agent_config(self, agent: str) -> Optional[Dict]:
-        """
-        Get agent configuration.
-
-        Args:
-            agent: Agent name ('claude', 'copilot')
-
-        Returns:
-            Agent config dict or None
-        """
-        return self.manifest.get('agents', {}).get(agent)
-
-    def validate_kit_name(self, kit_name: str) -> bool:
-        """Check if kit name is valid"""
-        return kit_name in self.get_kit_names()
-
-    def get_kit_description(self, kit_name: str) -> str:
-        """Get kit description"""
-        kit = self.get_kit(kit_name)
-        return kit.get('description', '') if kit else ''
-
-    def get_kit_icon(self, kit_name: str) -> str:
-        """Get kit icon emoji"""
-        kit = self.get_kit(kit_name)
-        return kit.get('icon', '📦') if kit else '📦'
-
-    def is_recommended(self, kit_name: str) -> bool:
-        """Check if kit is recommended"""
-        kit = self.get_kit(kit_name)
-        return kit.get('recommended', False) if kit else False
+"""
+Kit manifest loader and utilities.
+
+Loads kit definitions from kits.yaml and provides helpers for installation,
+validation, and status checking.
+"""
+
+from pathlib import Path
+from typing import Dict, List, Optional
+import yaml
+
+
+class KitManifest:
+    """Loads and provides access to kit definitions from kits.yaml"""
+
+    def __init__(self, kits_dir: Path):
+        """
+        Initialize manifest loader.
+
+        Args:
+            kits_dir: Path to kits directory containing kits.yaml
+        """
+        self.kits_dir = kits_dir
+        self.manifest_path = kits_dir / "kits.yaml"
+        self._manifest = None
+
+    @property
+    def manifest(self) -> Dict:
+        """Load and cache manifest data"""
+        if self._manifest is None:
+            with open(self.manifest_path, encoding='utf-8') as f:
+                self._manifest = yaml.safe_load(f)
+        return self._manifest
+
+    def get_kit(self, kit_name: str) -> Optional[Dict]:
+        """Get kit definition by name"""
+        return self.manifest['kits'].get(kit_name)
+
+    def get_all_kits(self) -> Dict[str, Dict]:
+        """Get all kit definitions"""
+        return self.manifest['kits']
+
+    def get_kit_names(self) -> List[str]:
+        """Get list of all kit names"""
+        return list(self.manifest['kits'].keys())
+
+    def get_recommended_kits(self) -> List[str]:
+        """Get list of recommended kit names"""
+        return [
+            name for name, kit in self.manifest['kits'].items()
+            if kit.get('recommended', False)
+        ]
+
+    def get_default_kit(self) -> str:
+        """Get default kit name"""
+        return self.manifest['options']['default_kit']
+
+    def get_kit_files(self, kit_name: str, agent: Optional[str] = None) -> List[Dict]:
+        """
+        Get list of files for a kit.
+
+        Args:
+            kit_name: Name of kit
+            agent: Optional agent filter ('claude', 'copilot', None for all)
+
+        Returns:
+            List of file dicts with 'path', 'source', 'required' keys
+        """
+        kit = self.get_kit(kit_name)
+        if not kit:
+            return []
+
+        files = []
+        file_groups = kit.get('files', {})
+
+        # Map agent names to file groups
+        agent_groups = {
+            'claude': ['claude'],
+            'copilot': ['copilot'],
+            None: list(file_groups.keys())  # All groups
+        }
+
+        groups_to_include = agent_groups.get(agent, [])
+
+        for group_name in groups_to_include:
+            if group_name in file_groups:
+                files.extend(file_groups[group_name])
+
+        return files
+
+    def get_kit_markers(self, kit_name: str) -> List[str]:
+        """
+        Get marker files for kit detection.
+
+        Args:
+            kit_name: Name of kit
+
+        Returns:
+            List of marker file paths
+        """
+        kit = self.get_kit(kit_name)
+        return kit.get('markers', []) if kit else []
+
+    def get_kit_commands(self, kit_name: str) -> List[Dict]:
+        """
+        Get list of commands for a kit.
+
+        Args:
+            kit_name: Name of kit
+
+        Returns:
+            List of command dicts with 'name', 'description', 'status' keys
+        """
+        kit = self.get_kit(kit_name)
+        return kit.get('commands', []) if kit else []
+
+    def get_agent_config(self, agent: str) -> Optional[Dict]:
+        """
+        Get agent configuration.
+
+        Args:
+            agent: Agent name ('claude', 'copilot')
+
+        Returns:
+            Agent config dict or None
+        """
+        return self.manifest.get('agents', {}).get(agent)
+
+    def validate_kit_name(self, kit_name: str) -> bool:
+        """Check if kit name is valid"""
+        return kit_name in self.get_kit_names()
+
+    def get_kit_description(self, kit_name: str) -> str:
+        """Get kit description"""
+        kit = self.get_kit(kit_name)
+        return kit.get('description', '') if kit else ''
+
+    def get_kit_icon(self, kit_name: str) -> str:
+        """Get kit icon emoji"""
+        kit = self.get_kit(kit_name)
+        return kit.get('icon', '📦') if kit else '📦'
+
+    def is_recommended(self, kit_name: str) -> bool:
+        """Check if kit is recommended"""
+        kit = self.get_kit(kit_name)
+        return kit.get('recommended', False) if kit else False

lite_kits/core/validator.py

@@ -0,0 +1,183 @@
+"""
+Kit validation and integrity checking.
+
+Validates installed kits, checks for missing/corrupted files.
+"""
+
+from pathlib import Path
+from typing import Dict
+
+from .manifest import KitManifest
+from .detector import Detector
+
+
+class Validator:
+    """Validates kit installations."""
+
+    def __init__(self, target_dir: Path, manifest: KitManifest):
+        """
+        Initialize validator.
+
+        Args:
+            target_dir: Target project directory
+            manifest: Loaded kit manifest
+        """
+        self.target_dir = target_dir
+        self.manifest = manifest
+        self.detector = Detector(target_dir, manifest)
+
+    def validate_all(self) -> Dict:
+        """
+        Validate all kits.
+
+        Returns:
+            Validation results for all kits
+        """
+        checks = {}
+        options = self.manifest.manifest.get('options', {})
+
+        for kit_name in self.manifest.get_kit_names():
+            checks[kit_name] = self.validate_kit(kit_name, options)
+
+        # Overall validation passes if at least one kit is fully installed
+        any_installed = any(
+            check['status'] == 'installed'
+            for check in checks.values()
+        )
+
+        return {
+            "valid": any_installed,
+            "checks": checks,
+            "target_dir": self.target_dir,
+        }
+
+    def validate_kit(self, kit_name: str, options: Dict) -> Dict:
+        """
+        Validate a single kit.
+
+        Args:
+            kit_name: Name of kit to validate
+            options: Options from manifest
+
+        Returns:
+            Validation result for this kit
+        """
+        kit_info = self.manifest.get_kit(kit_name)
+        markers = self.manifest.get_kit_markers(kit_name)
+
+        # Check if kit is installed
+        kit_installed = any(
+            (self.target_dir / marker).exists()
+            for marker in markers
+        )
+
+        if not kit_installed:
+            return {
+                "passed": True,
+                "status": "not_installed",
+                "message": f"{kit_info['name']}: not installed",
+            }
+
+        # Detect which agents are actually present in the project
+        detected_agents = self.detector.detect_agents()
+        detected_shells = self.detector.detect_shells()
+
+        # Kit is installed, validate only files for detected agents/shells that actually have kit files
+        files_to_validate = []
+
+        # Add agent-specific files (commands/prompts) - only if at least one kit file exists for that agent
+        for agent in detected_agents:
+            agent_files = self.manifest.get_kit_files(kit_name, agent=agent)
+            # Check if any of this kit's files exist for this agent
+            has_kit_files = any(
+                (self.target_dir / f['path']).exists()
+                for f in agent_files
+                if f.get('status') != 'planned'
+            )
+            if has_kit_files:
+                files_to_validate.extend(agent_files)
+
+        # Add shell-specific files (scripts) - only if at least one kit file exists for that shell
+        for shell in detected_shells:
+            shell_files = self.manifest.get_kit_files(kit_name, agent=shell)
+            has_kit_files = any(
+                (self.target_dir / f['path']).exists()
+                for f in shell_files
+                if f.get('status') != 'planned'
+            )
+            if has_kit_files:
+                files_to_validate.extend(shell_files)
+
+        # Add agent/shell-agnostic files (memory, templates, etc.)
+        all_files = self.manifest.get_kit_files(kit_name, agent=None)
+        for file_info in all_files:
+            # Only add files that aren't agent/shell-specific
+            if file_info.get('type') not in ['command', 'prompt', 'script']:
+                files_to_validate.append(file_info)
+
+        missing = []
+        corrupted = []
+        outdated = []
+
+        for file_info in files_to_validate:
+            # Skip non-required files
+            if not file_info.get('required', True):
+                continue
+
+            # Skip planned files
+            if file_info.get('status') == 'planned':
+                continue
+
+            target_path = self.target_dir / file_info['path']
+
+            # Check exists
+            if not target_path.exists():
+                missing.append(file_info['path'])
+                continue
+
+            # Check integrity
+            if options.get('check_file_integrity', True):
+                min_size = options.get('min_file_size', 100)
+                if target_path.stat().st_size < min_size:
+                    corrupted.append(file_info['path'])
+
+            # Check if outdated (differs from source)
+            # (Placeholder for now, can add diff later)
+
+        # Build result
+        if missing or corrupted:
+            issues = []
+            if missing:
+                issues.append(f"{len(missing)} missing")
+            if corrupted:
+                issues.append(f"{len(corrupted)} corrupted")
+
+            return {
+                "passed": False,
+                "status": "partial",
+                "message": f"{kit_info['name']}: {', '.join(issues)}",
+                "missing_files": missing,
+                "corrupted_files": corrupted,
+            }
+
+        return {
+            "passed": True,
+            "status": "installed",
+            "message": f"{kit_info['name']}: all files present",
+        }
+
+    def is_kit_installed(self, kit_name: str) -> bool:
+        """
+        Quick check if kit is installed.
+
+        Args:
+            kit_name: Name of kit
+
+        Returns:
+            True if any marker exists
+        """
+        markers = self.manifest.get_kit_markers(kit_name)
+        return any(
+            (self.target_dir / marker).exists()
+            for marker in markers
+        )

lite_kits/kits/README.md

@@ -6,7 +6,7 @@ This directory contains modular add-on kits that can be installed independently
 
 ### ✅ Recommended (Default Installation)
 
-#### 1. **project-kit**
+#### 1. **dev-kit**
 **Commands**: `/orient` ⭐, `/audit`, `/stats`
 **Scripts**: Enhanced feature creation with custom naming
 
@@ -21,7 +21,7 @@ Essential project-level utilities combining agent orientation, quality checks, a
 
 ---
 
-#### 2. **git-kit**
+#### 2. **dev-kit**
 **Commands**: `/commit`, `/pr`, `/review`, `/sync`, `/cleanup`
 
 Git workflow automation with smart commits, PR creation, code review, sync status, and cleanup operations. Includes ASCII visualization for better readability.
@@ -48,7 +48,7 @@ Multi-agent coordination structure for complex projects with multiple AI agents
 - `.specify/memory/git-worktrees-protocol.md`
 - `specs/*/collaboration/` (template, created per-feature)
 
-**Use case**: Large projects with multiple AI agents collaborating (e.g., Claude Code + Copilot). Works best when combined with project-kit and git-kit.
+**Use case**: Large projects with multiple AI agents collaborating (e.g., Claude Code + Copilot). Works best when combined with dev-kit and dev-kit.
 
 ---
 
@@ -139,7 +139,7 @@ lite-kits remove -Kit git,project
 
 ## Kit Details
 
-### project-kit Commands
+### dev-kit Commands
 
 | Command | Description |
 |---------|-------------|
@@ -147,7 +147,7 @@ lite-kits remove -Kit git,project
 | `/audit` | Security and quality audit |
 | `/stats` | Project statistics (LOC, test coverage, complexity) |
 
-### git-kit Commands
+### dev-kit Commands
 
 | Command | Description |
 |---------|-------------|
@@ -156,7 +156,7 @@ lite-kits remove -Kit git,project
 | `/review` | Code review of staged changes against best practices |
 | `/cleanup` | Clean merged branches, stale worktrees |
 
-### project-kit Enhancements
+### dev-kit Enhancements
 
 | Enhancement | Description |
 |-------------|-------------|