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

lite_kits/core/installer.py

@@ -1,433 +1,313 @@
 """
-Installer logic for spec-kit-multiagent
+Manifest-driven installer for lite-kits.
 
-Handles installation, removal, and validation of multiagent features.
+Orchestrates detection, validation, and file operations.
+Delegates to specialized modules for specific tasks.
 """
 
 import shutil
 from pathlib import Path
 from typing import Dict, List, Optional
 
+from .conflict_checker import ConflictChecker
+from .detector import Detector
+from .manifest import KitManifest
+from .validator import Validator
 
-class Installer:
-    """Manages installation of multiagent features to spec-kit projects."""
 
-    def __init__(self, target_dir: Path, kits: Optional[List[str]] = None):
+class Installer:
+    """Main installer orchestrator."""
+
+    def __init__(
+        self,
+        target_dir: Path,
+        kits: Optional[List[str]] = None,
+        force: bool = False,
+        agents: Optional[List[str]] = None,
+        shells: Optional[List[str]] = None,
+    ):
         """
         Initialize installer.
 
         Args:
             target_dir: Target spec-kit project directory
-            kits: List of kits to install (project, git, multiagent). Defaults to ['project']
+            kits: List of kits to install (None = use default from manifest)
+            force: Skip confirmations and overwrite existing files
+            agents: List of explicit agent preferences (None = auto-detect)
+            shells: List of explicit shell preferences (None = auto-detect)
         """
         self.target_dir = Path(target_dir).resolve()
         self.kits_dir = Path(__file__).parent.parent / "kits"
-        self.kits = kits or ['dev']  # Default to dev kit only
+
+        # Load manifest
+        self.manifest = KitManifest(self.kits_dir)
+
+        # Initialize specialized modules
+        self.detector = Detector(self.target_dir, self.manifest)
+        self.validator = Validator(self.target_dir, self.manifest)
+        self.conflict_checker = ConflictChecker(
+            self.target_dir,
+            self.kits_dir,
+            self.manifest
+        )
+
+        # Operational modes
+        self.force = force
+
+        # Preferences - validate immediately during init
+        self.preferred_agents = agents
+        self.preferred_shells = shells
+
+        # Validate agent/shell preferences early (raises ValueError if invalid)
+        if agents:
+            self.detector.detect_agents(agents)
+        if shells:
+            self.detector.detect_shells(shells)
+
+        # Kits to install
+        self.kits = kits or [self.manifest.get_default_kit()]
 
         # Validate kit names
-        valid_kits = {'dev', 'multiagent'}
+        self._validate_kit_names()
+
+    def _validate_kit_names(self):
+        """Validate kit names against manifest."""
+        valid_kits = set(self.manifest.get_kit_names())
         invalid = set(self.kits) - valid_kits
         if invalid:
-            raise ValueError(f"Invalid kit(s): {invalid}. Valid: {valid_kits}")
-
-        # No auto-dependencies - all kits are independent
+            valid_list = ', '.join(sorted(valid_kits))
+            raise ValueError(f"Invalid kit(s): {invalid}. Valid: {valid_list}")
 
     def is_spec_kit_project(self) -> bool:
-        """
-        Check if target directory is a spec-kit project.
-
-        Returns:
-            True if directory contains spec-kit markers
-        """
-        markers = [
-            self.target_dir / ".specify",
-            self.target_dir / ".claude",
-            self.target_dir / ".github" / "prompts",
-        ]
-        return any(marker.exists() for marker in markers)
-
-    def is_multiagent_installed(self) -> bool:
-        """
-        Check if multiagent features are already installed.
-
-        Returns:
-            True if multiagent features detected
-        """
-        # Check for kit markers
-        markers = {
-            'project': [
-                self.target_dir / ".claude" / "commands" / "orient.md",
-                self.target_dir / ".github" / "prompts" / "orient.prompt.md",
-            ],
-            'git': [
-                self.target_dir / ".claude" / "commands" / "commit.md",
-                self.target_dir / ".github" / "prompts" / "commit.prompt.md",
-                self.target_dir / ".claude" / "commands" / "review.md",
-            ],
-            'multiagent': [
-                self.target_dir / ".specify" / "memory" / "pr-workflow-guide.md",
-            ],
+        """Check if target is a spec-kit project."""
+        return self.detector.is_spec_kit_project()
+
+    def is_kit_installed(self, kit_name: str) -> bool:
+        """Check if kit is installed."""
+        return self.validator.is_kit_installed(kit_name)
+
+    def preview_installation(self) -> Dict:
+        """Preview installation without making changes."""
+        agents = self.detector.detect_agents(self.preferred_agents)
+        shells = self.detector.detect_shells(self.preferred_shells)
+
+        preview = {
+            "kits": [],
+            "conflicts": [],
+            "warnings": [],
+            "agents": agents,
+            "shells": shells,
         }
 
-        # Check if any requested kit is already installed
-        for kit in self.kits:
-            if any(marker.exists() for marker in markers.get(kit, [])):
-                return True
+        if not agents:
+            supported = [
+                name for name, config in self.manifest.manifest.get('agents', {}).items()
+                if config.get('supported', False)
+            ]
+            preview['warnings'].append(f"No AI agents detected. Supported: {', '.join(supported)}")
+            return preview
 
-        return False
+        conflicts = self.conflict_checker.check_conflicts(self.kits, agents, shells)
+        preview['conflicts'] = conflicts['overwrites']
 
-    def preview_installation(self) -> Dict[str, List[str]]:
-        """
-        Preview what files will be created/modified.
+        for kit_name in self.kits:
+            kit_preview = self._preview_kit(kit_name, agents, shells)
+            preview['kits'].append(kit_preview)
 
-        Returns:
-            Dictionary with lists of new_files, modified_files, new_directories
-        """
-        changes = {
+        return preview
+
+    def _preview_kit(self, kit_name: str, agents: List[str], shells: List[str]) -> Dict:
+        """Preview installation for a single kit."""
+        kit_info = self.manifest.get_kit(kit_name)
+        kit_preview = {
+            "name": kit_info['name'],
             "new_files": [],
             "modified_files": [],
             "new_directories": [],
         }
 
-        # Check which interface(s) exist
-        has_claude = (self.target_dir / ".claude").exists()
-        has_copilot = (self.target_dir / ".github" / "prompts").exists()
-
-        # Project kit files
-        if 'project' in self.kits:
-            if has_claude:
-                changes["new_files"].extend([
-                    ".claude/commands/orient.md",
-                    ".claude/commands/review.md",
-                    ".claude/commands/audit.md",
-                    ".claude/commands/stats.md",
-                ])
-            if has_copilot:
-                changes["new_files"].extend([
-                    ".github/prompts/orient.prompt.md",
-                    ".github/prompts/review.prompt.md",
-                    ".github/prompts/audit.prompt.md",
-                    ".github/prompts/stats.prompt.md",
-                ])
-
-        # Git kit files
-        if 'git' in self.kits:
-            if has_claude:
-                changes["new_files"].append(".claude/commands/commit.md")
-                changes["new_files"].append(".claude/commands/pr.md")
-                changes["new_files"].append(".claude/commands/review.md")
-            if has_copilot:
-                changes["new_files"].append(".github/prompts/commit.prompt.md")
-                changes["new_files"].append(".github/prompts/pr.prompt.md")
-                changes["new_files"].append(".github/prompts/review.prompt.md")
-
-        # Multiagent kit files
-        if 'multiagent' in self.kits and (self.target_dir / ".specify").exists():
-            changes["new_files"].extend([
-                ".specify/memory/pr-workflow-guide.md",
-                ".specify/memory/git-worktrees-protocol.md",
-            ])
-            changes["new_directories"].append("specs/*/collaboration/ (created with new features)")
-
-        return changes
+        for agent in agents:
+            files = self.manifest.get_kit_files(kit_name, agent=agent)
+            self._preview_files(files, kit_preview)
+
+        for shell in shells:
+            files = self.manifest.get_kit_files(kit_name, agent=shell)
+            self._preview_files(files, kit_preview)
+
+        # Get other files (not commands\prompts\scripts - those are handled above)
+        all_files = self.manifest.get_kit_files(kit_name, agent=None)
+        for file_info in all_files:
+            if file_info.get('type') in ['command', 'prompt', 'script']:
+                continue  # Already handled by agent/shell sections above
+            self._preview_files([file_info], kit_preview)
+
+        return kit_preview
+
+    def _preview_files(self, files: List[Dict], preview: Dict):
+        """Preview a list of files."""
+        for file_info in files:
+            if file_info.get('status') == 'planned':
+                continue
+
+            # Normalize paths to use backslashes for Windows display
+            target_path = str(file_info['path']).replace("/", "\\")
+            target_full = self.target_dir / file_info['path']
+
+            if target_full.exists():
+                if target_path not in preview["modified_files"]:
+                    preview["modified_files"].append(target_path)
+            else:
+                if target_path not in preview["new_files"]:
+                    preview["new_files"].append(target_path)
+
+                parent_dir = str(target_full.parent.relative_to(self.target_dir))
+                if parent_dir not in preview["new_directories"]:
+                    if not target_full.parent.exists():
+                        preview["new_directories"].append(parent_dir)
 
     def install(self) -> Dict:
-        """
-        Install multiagent features to target project.
-
-        Returns:
-            Dictionary with success status and installed items
-        """
+        """Install kits to target project."""
         result = {
             "success": False,
             "installed": [],
+            "skipped": [],
             "error": None,
         }
 
         try:
-            # Detect which interfaces are present
-            has_claude = (self.target_dir / ".claude").exists()
-            has_copilot = (self.target_dir / ".github" / "prompts").exists()
+            agents = self.detector.detect_agents(self.preferred_agents)
+            shells = self.detector.detect_shells(self.preferred_shells)
 
-            if not has_claude and not has_copilot:
-                result["error"] = "No supported AI interface found (.claude or .github/prompts)"
+            if not agents:
+                supported = [
+                    name for name, config in self.manifest.manifest.get('agents', {}).items()
+                    if config.get('supported', False)
+                ]
+                result["error"] = (
+                    f"No supported AI interface found. Supported: {', '.join(supported)}. "
+                    r"To enable AI interface support, create a '.claude\' or '.github\prompts\' directory in your project."
+                )
                 return result
 
-            # Install project kit
-            if 'project' in self.kits:
-                if has_claude:
-                    self._install_file('project/claude/commands/orient.md', '.claude/commands/orient.md')
-                    self._install_file('project/claude/commands/review.md', '.claude/commands/review.md')
-                    self._install_file('project/claude/commands/audit.md', '.claude/commands/audit.md')
-                    self._install_file('project/claude/commands/stats.md', '.claude/commands/stats.md')
-                    result["installed"].append("project-kit (Claude): /orient, /review, /audit, /stats commands")
-
-                if has_copilot:
-                    self._install_file('project/github/prompts/orient.prompt.md', '.github/prompts/orient.prompt.md')
-                    self._install_file('project/github/prompts/review.prompt.md', '.github/prompts/review.prompt.md')
-                    self._install_file('project/github/prompts/audit.prompt.md', '.github/prompts/audit.prompt.md')
-                    self._install_file('project/github/prompts/stats.prompt.md', '.github/prompts/stats.prompt.md')
-                    result["installed"].append("project-kit (Copilot): /orient, /review, /audit, /stats commands")
-
-            # Install git kit
-            if 'git' in self.kits:
-                if has_claude:
-                    self._install_file('git/claude/commands/commit.md', '.claude/commands/commit.md')
-                    self._install_file('git/claude/commands/pr.md', '.claude/commands/pr.md')
-                    self._install_file('git/claude/commands/review.md', '.claude/commands/review.md')
-                    self._install_file('git/claude/commands/cleanup.md', '.claude/commands/cleanup.md')
-                    result["installed"].append("git-kit (Claude): /commit, /pr, /review, /cleanup commands")
-
-                if has_copilot:
-                    self._install_file('git/github/prompts/commit.prompt.md', '.github/prompts/commit.prompt.md')
-                    self._install_file('git/github/prompts/pr.prompt.md', '.github/prompts/pr.prompt.md')
-                    self._install_file('git/github/prompts/review.prompt.md', '.github/prompts/review.prompt.md')
-                    self._install_file('git/github/prompts/cleanup.prompt.md', '.github/prompts/cleanup.prompt.md')
-                    result["installed"].append("git-kit (Copilot): /commit, /pr, /review, /cleanup commands")
-
-            # Install multiagent kit
-            if 'multiagent' in self.kits and (self.target_dir / ".specify").exists():
-                # Commands
-                if has_claude:
-                    self._install_file('multiagent/claude/commands/sync.md', '.claude/commands/sync.md')
-                if has_copilot:
-                    self._install_file('multiagent/github/prompts/sync.prompt.md', '.github/prompts/sync.prompt.md')
-
-                # Memory guides
-                self._install_file('multiagent/memory/pr-workflow-guide.md', '.specify/memory/pr-workflow-guide.md')
-                self._install_file('multiagent/memory/git-worktrees-protocol.md', '.specify/memory/git-worktrees-protocol.md')
-                self._install_file('multiagent/memory/parallel-work-protocol.md', '.specify/memory/parallel-work-protocol.md')
-
-                # Templates
-                templates_dir = self.target_dir / ".specify" / "templates"
-                templates_dir.mkdir(parents=True, exist_ok=True)
-                self._install_file('multiagent/templates/session-log.md', '.specify/templates/session-log.md')
-                self._install_file('multiagent/templates/handoff.md', '.specify/templates/handoff.md')
-                self._install_file('multiagent/templates/decision.md', '.specify/templates/decision.md')
-                self._install_file('multiagent/templates/collaboration-structure/README.md', '.specify/templates/collaboration-README.md')
-
-                result["installed"].append("multiagent-kit: /sync command")
-                result["installed"].append("multiagent-kit: Memory guides (PR workflow, git worktrees, parallel work)")
-                result["installed"].append("multiagent-kit: Templates (session-log, handoff, decision, collaboration)")
+            if not self.force:
+                conflicts = self.conflict_checker.check_conflicts(self.kits, agents, shells)
+
+                if conflicts['has_conflicts']:
+                    result["conflicts"] = conflicts['overwrites']
+                    result["error"] = f"Found {len(conflicts['conflicts'])} file conflicts. Use --force to overwrite."
+                    return result
+
+            options = self.manifest.manifest.get('options', {})
+
+            for kit_name in self.kits:
+                self._install_kit(kit_name, agents, shells, options, result)
 
             result["success"] = True
 
+            if options.get('validate_on_install', True):
+                result["validation"] = self.validator.validate_all()
+
         except Exception as e:
             result["error"] = str(e)
 
         return result
 
-    def validate(self) -> Dict:
-        """
-        Validate kit installation.
+    def _install_kit(self, kit_name: str, agents: List[str], shells: List[str], options: Dict, result: Dict):
+        """Install a single kit."""
+        skip_existing = options.get('skip_existing', True)
 
-        Returns:
-            Dictionary with validation results
-        """
-        checks = {}
+        for agent in agents:
+            files = self.manifest.get_kit_files(kit_name, agent=agent)
+            self._install_files(files, skip_existing, result)
 
-        # Check project-kit files
-        claude_orient = self.target_dir / ".claude" / "commands" / "orient.md"
-        copilot_orient = self.target_dir / ".github" / "prompts" / "orient.prompt.md"
+        for shell in shells:
+            files = self.manifest.get_kit_files(kit_name, agent=shell)
+            self._install_files(files, skip_existing, result)
 
-        project_kit_installed = claude_orient.exists() or copilot_orient.exists()
-        checks["project_kit"] = {
-            "passed": project_kit_installed,
-            "message": "project-kit: /orient command found" if project_kit_installed
-                      else "project-kit not installed - run: lite-kits add --here --kit project",
-        }
+        all_files = self.manifest.get_kit_files(kit_name, agent=None)
+        for file_info in all_files:
+            if file_info.get('type') in ['command', 'prompt', 'script']:
+                continue
+            self._install_files([file_info], skip_existing, result)
 
-        # Check git-kit files
-        claude_commit = self.target_dir / ".claude" / "commands" / "commit.md"
-        claude_pr = self.target_dir / ".claude" / "commands" / "pr.md"
-        claude_review = self.target_dir / ".claude" / "commands" / "review.md"
-        claude_cleanup = self.target_dir / ".claude" / "commands" / "cleanup.md"
-
-        git_kit_installed = claude_commit.exists() or claude_pr.exists() or claude_review.exists() or claude_cleanup.exists()
-        checks["git_kit"] = {
-            "passed": git_kit_installed,
-            "message": "git-kit: /commit, /pr, /review, /cleanup commands found" if git_kit_installed
-                      else "git-kit not installed - run: lite-kits add --here --kit git",
-        }
+    def _install_files(self, files: List[Dict], skip_existing: bool, result: Dict):
+        """Install a list of files."""
+        for file_info in files:
+            if file_info.get('status') == 'planned':
+                result["skipped"].append(f"{file_info['path']} (planned)")
+                continue
 
-        # Check multiagent-kit files (only if user is checking for them)
-        claude_sync = self.target_dir / ".claude" / "commands" / "sync.md"
-        pr_guide = self.target_dir / ".specify" / "memory" / "pr-workflow-guide.md"
-        worktree_guide = self.target_dir / ".specify" / "memory" / "git-worktrees-protocol.md"
+            target_path = self.target_dir / file_info['path']
 
-        multiagent_kit_installed = claude_sync.exists() or pr_guide.exists() or worktree_guide.exists()
-        checks["multiagent_kit"] = {
-            "passed": multiagent_kit_installed,
-            "message": "multiagent-kit: /sync command and memory guides found" if multiagent_kit_installed
-                      else "multiagent-kit not installed - run: lite-kits add --here --kit multiagent",
-        }
+            if skip_existing and target_path.exists() and not self.force:
+                result["skipped"].append(file_info['path'])
+                continue
 
-        # Only fail validation if NO kits are installed
-        # If they only installed project+git, don't fail on missing multiagent
-        all_passed = checks["project_kit"]["passed"] or checks["git_kit"]["passed"] or checks["multiagent_kit"]["passed"]
+            self._copy_file(file_info['source'], file_info['path'])
+            result["installed"].append(file_info['path'])
 
-        return {
-            "valid": all_passed,
-            "checks": checks,
+    def validate(self) -> Dict:
+        """Validate all installed kits."""
+        return self.validator.validate_all()
+
+    def preview_removal(self) -> Dict:
+        """Preview files that would be removed."""
+        preview = {
+            "kits": [],
+            "total_files": 0,
         }
 
-    # Private installation methods
+        for kit_name in self.kits:
+            kit_info = self.manifest.get_kit(kit_name)
+            files_to_remove = []
 
-    def _install_file(self, kit_relative_path: str, target_relative_path: str):
-        """
-        Install a file from kits directory to target project.
+            all_files = self.manifest.get_kit_files(kit_name, agent=None)
 
-        Args:
-            kit_relative_path: Path relative to kits/ directory (e.g., 'project/claude/commands/orient.md')
-            target_relative_path: Path relative to target directory (e.g., '.claude/commands/orient.md')
-        """
-        source = self.kits_dir / kit_relative_path
-        target = self.target_dir / target_relative_path
+            for file_info in all_files:
+                target_path = self.target_dir / file_info['path']
+                if target_path.exists():
+                    files_to_remove.append(file_info['path'])
 
-        if not source.exists():
-            raise FileNotFoundError(f"Kit file not found: {source}")
-
-        target.parent.mkdir(parents=True, exist_ok=True)
-        shutil.copy2(source, target)
+            if files_to_remove:
+                preview["kits"].append({
+                    'name': kit_info['name'],
+                    'files': files_to_remove
+                })
+                preview["total_files"] += len(files_to_remove)
 
-    # TODO: Implement these methods
-
-    def _merge_constitution(self):
-        """
-        Merge multiagent sections into existing constitution.
-
-        Strategy:
-        1. Read existing constitution
-        2. Check for multiagent marker (<!-- MULTIAGENT-START -->)
-        3. If marker exists, replace section
-        4. If marker missing, append section
-        5. Preserve user edits outside markers
-        """
-        # TODO: Implement smart merge logic
-        # - Read templates/enhancements/constitution-multiagent.md
-        # - Merge into .specify/memory/constitution.md
-        # - Use marker comments for idempotent updates
-        pass
-
-    def _install_collaboration_template(self):
-        """
-        Create collaboration directory template.
-
-        Creates:
-        - .specify/templates/collaboration-template/
-        - Scripts reference this when creating new features
-        """
-        # TODO: Create collaboration directory template
-        # - active/
-        # - archive/
-        # - results/
-        pass
+        return preview
 
     def remove(self) -> Dict:
-        """
-        Remove multiagent features from project.
-
-        Returns to vanilla spec-kit state.
-
-        Returns:
-            Dictionary with success status and removed items
-        """
+        """Remove kits from project."""
         result = {
             "success": False,
             "removed": [],
+            "not_found": [],
             "error": None,
         }
 
         try:
-            # Remove project kit files
-            if 'project' in self.kits:
-                removed = []
-                project_commands = ['orient', 'review', 'audit', 'stats']
-                
-                # Claude
-                for cmd in project_commands:
-                    cmd_file = self.target_dir / ".claude" / "commands" / f"{cmd}.md"
-                    if cmd_file.exists():
-                        cmd_file.unlink()
-                        removed.append(f".claude/commands/{cmd}.md")
-
-                # Copilot
-                for cmd in project_commands:
-                    cmd_file = self.target_dir / ".github" / "prompts" / f"{cmd}.prompt.md"
-                    if cmd_file.exists():
-                        cmd_file.unlink()
-                        removed.append(f".github/prompts/{cmd}.prompt.md")
-
-                if removed:
-                    result["removed"].append(f"project-kit: {', '.join(removed)}")
-
-            # Remove git kit files
-            if 'git' in self.kits:
-                removed = []
-                git_commands = ['commit', 'pr', 'review', 'cleanup']
-
-                # Claude
-                for cmd in git_commands:
-                    cmd_file = self.target_dir / ".claude" / "commands" / f"{cmd}.md"
-                    if cmd_file.exists():
-                        cmd_file.unlink()
-                        removed.append(f".claude/commands/{cmd}.md")
-
-                # Copilot
-                for cmd in git_commands:
-                    cmd_file = self.target_dir / ".github" / "prompts" / f"{cmd}.prompt.md"
-                    if cmd_file.exists():
-                        cmd_file.unlink()
-                        removed.append(f".github/prompts/{cmd}.prompt.md")
-
-                if removed:
-                    result["removed"].append(f"git-kit: {', '.join(removed)}")
-
-            # Remove multiagent kit files
-            if 'multiagent' in self.kits:
-                removed = []
-
-                # Sync command
-                sync_claude = self.target_dir / ".claude" / "commands" / "sync.md"
-                if sync_claude.exists():
-                    sync_claude.unlink()
-                    removed.append(".claude/commands/sync.md")
-
-                sync_copilot = self.target_dir / ".github" / "prompts" / "sync.prompt.md"
-                if sync_copilot.exists():
-                    sync_copilot.unlink()
-                    removed.append(".github/prompts/sync.prompt.md")
-
-                # Memory guides
-                memory_files = [
-                    'pr-workflow-guide.md',
-                    'git-worktrees-protocol.md',
-                    'parallel-work-protocol.md',
-                ]
-                for file in memory_files:
-                    file_path = self.target_dir / ".specify" / "memory" / file
-                    if file_path.exists():
-                        file_path.unlink()
-                        removed.append(f".specify/memory/{file}")
-
-                # Templates
-                template_files = [
-                    'session-log.md',
-                    'handoff.md',
-                    'decision.md',
-                    'collaboration-README.md',
-                ]
-                for file in template_files:
-                    file_path = self.target_dir / ".specify" / "templates" / file
-                    if file_path.exists():
-                        file_path.unlink()
-                        removed.append(f".specify/templates/{file}")
+            for kit_name in self.kits:
+                kit_info = self.manifest.get_kit(kit_name)
+                removed_files = []
+                not_found_files = []
 
-                if removed:
-                    result["removed"].append(f"multiagent-kit: {', '.join(removed)}")
+                all_files = self.manifest.get_kit_files(kit_name, agent=None)
 
-            # Note: Preserve collaboration directories (user data)
-            # Note: Preserve vanilla spec-kit files
+                for file_info in all_files:
+                    target_path = self.target_dir / file_info['path']
+
+                    if target_path.exists():
+                        target_path.unlink()
+                        removed_files.append(file_info['path'])
+                    else:
+                        not_found_files.append(file_info['path'])
+
+                if removed_files:
+                    result["removed"].append({'kit': kit_info['name'], 'files': removed_files})
+
+                if not_found_files:
+                    result["not_found"].extend(not_found_files)
 
             result["success"] = True
 
@@ -435,3 +315,14 @@ class Installer:
             result["error"] = str(e)
 
         return result
+
+    def _copy_file(self, kit_relative_path: str, target_relative_path: str):
+        """Copy file from kits/ to target project."""
+        source = self.kits_dir / kit_relative_path
+        target = self.target_dir / target_relative_path
+
+        if not source.exists():
+            raise FileNotFoundError(f"Kit file not found: {source}")
+
+        target.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(source, target)