lite-kits 0.3.1__tar.gz → 0.3.3__tar.gz

{lite_kits-0.3.1 → lite_kits-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lite-kits
-Version: 0.3.1
+Version: 0.3.3
 Summary: Lightweight enhancement kits for vanilla dev tools (spec-kit, etc.)
 Project-URL: Homepage, https://github.com/tmorgan181/lite-kits
 Project-URL: Documentation, https://github.com/tmorgan181/lite-kits#readme
@@ -29,7 +29,7 @@ Description-Content-Type: text/markdown
 
 # 🌈 LITE-KITS 🎒
 
-[![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](https://github.com/tmorgan181/lite-kits/releases/tag/v0.3.0)
+[![PyPI version](https://img.shields.io/pypi/v/lite-kits.svg)](https://pypi.org/project/lite-kits/)
 [![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 [![Spec-Kit](https://img.shields.io/badge/spec--kit-compatible-purple.svg)](https://github.com/github/spec-kit)

{lite_kits-0.3.1 → lite_kits-0.3.3}/README.md

@@ -1,6 +1,6 @@
 # 🌈 LITE-KITS 🎒
 
-[![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](https://github.com/tmorgan181/lite-kits/releases/tag/v0.3.0)
+[![PyPI version](https://img.shields.io/pypi/v/lite-kits.svg)](https://pypi.org/project/lite-kits/)
 [![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 [![Spec-Kit](https://img.shields.io/badge/spec--kit-compatible-purple.svg)](https://github.com/github/spec-kit)

{lite_kits-0.3.1 → lite_kits-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lite-kits"
-version = "0.3.1"
+version = "0.3.3"
 description = "Lightweight enhancement kits for vanilla dev tools (spec-kit, etc.)"
 readme = "README.md"
 requires-python = ">=3.11"

{lite_kits-0.3.1 → lite_kits-0.3.3}/src/lite_kits/__init__.py

@@ -6,7 +6,7 @@ without forking or replacing any core files.
 """
 
 # Version
-__version__ = "0.3.1"
+__version__ = "0.3.3"
 
 # Package metadata
 APP_NAME = "lite-kits"

{lite_kits-0.3.1 → lite_kits-0.3.3}/src/lite_kits/cli.py

@@ -51,7 +51,7 @@ def print_help_hint():
 def print_version_info():
     """Print version information."""
     console.print(f"[bold]Version:[/bold]")
-    console.print(f"  [bold cyan]{APP_NAME} version {__version__}[/bold cyan]\n")
+    console.print(f"  [bold cyan]{APP_NAME} version {__version__}[/bold cyan]")
 
 def print_quick_start():
     console.print("[bold]Quick Start:[/bold]")
@@ -80,15 +80,68 @@ def print_spec_kit_error():
     console.print("  4. More info: https://github.com/github/spec-kit\n")
     console.print()
 
+def _build_kit_breakdown_table(target_dir: Path, kits: list[str]) -> Table:
+    """Build agent/shell breakdown table for kits.
+
+    Args:
+        target_dir: Target project directory
+        kits: List of kit names (e.g., ["dev", "multiagent"])
+
+    Returns:
+        Rich Table with agent/shell breakdown
+    """
+    from rich.box import ROUNDED
+
+    # Detect which agents/shells have files
+    agent_dirs = {
+        "Claude Code": target_dir / ".claude" / "commands",
+        "GitHub Copilot": target_dir / ".github" / "prompts"
+    }
+
+    shell_dirs = {
+        "Bash": target_dir / ".specify" / "scripts" / "bash",
+        "PowerShell": target_dir / ".specify" / "scripts" / "powershell"
+    }
+
+    # Build table
+    table = Table(show_header=True, header_style="bold cyan", box=ROUNDED, title=f"[bold magenta]Kit Breakdown[/bold magenta]")
+    table.add_column("Kit", style="cyan")
+    table.add_column("Agents", style="green")
+    table.add_column("Shells", style="white")
+
+    for kit in kits:
+        # Check which agents have this kit's files
+        agents_with_kit = []
+        for agent_name, agent_dir in agent_dirs.items():
+            if agent_dir.exists() and any(agent_dir.glob("*.md")):
+                # Check for at least one non-spec-kit file (not speckit.*)
+                non_speckit_files = [f for f in agent_dir.glob("*.md") if not f.stem.startswith("speckit.")]
+                if non_speckit_files:
+                    agents_with_kit.append(agent_name)
+
+        # Check which shells have scripts
+        shells_with_kit = []
+        for shell_name, shell_dir in shell_dirs.items():
+            if shell_dir.exists() and (any(shell_dir.glob("*.sh")) or any(shell_dir.glob("*.ps1"))):
+                shells_with_kit.append(shell_name)
+
+        # Format output
+        agents_display = ", ".join(agents_with_kit) if agents_with_kit else "[dim]none[/dim]"
+        shells_display = ", ".join(shells_with_kit) if shells_with_kit else "[dim]none[/dim]"
+
+        # Use consistent kit naming format: "kit-name" not "kit-name-kit"
+        table.add_row(kit, agents_display, shells_display)
+
+    return table
+
 def print_kit_info(target_dir: Path, is_spec_kit: bool, installed_kits: list):
-    """Print kit installation info."""
+    """Print kit installation info with agent/shell breakdown."""
     console.print()
     if is_spec_kit:
         console.print(f"[bold green][OK] Spec-kit project detected in {target_dir}.[/bold green]\n")
         if installed_kits:
-            console.print("Installed kits:", style="bold")
-            for kit in installed_kits:
-                console.print(f"  [green]+[/green] {kit}-kit")
+            table = _build_kit_breakdown_table(target_dir, installed_kits)
+            console.print(table)
         else:
             console.print("No kits installed.", style="dim yellow")
     else:
@@ -221,13 +274,17 @@ def add_kits(
         kits = [k.strip() for k in kit.split(',')]
     # else: kits=None will use default from manifest
 
+    # Parse comma-separated agents and shells
+    agents = [a.strip() for a in agent.split(',')] if agent else None
+    shells = [s.strip() for s in shell.split(',')] if shell else None
+
     try:
         installer = Installer(
             target_dir,
             kits=kits,
             force=force,
-            agent=agent,
-            shell=shell
+            agents=agents,
+            shells=shells
         )
     except ValueError as e:
         console.print()
@@ -259,10 +316,16 @@ def add_kits(
 
     # Always show preview unless --force flag was used
     if not skip_preview:
-        console.print(f"\n[bold magenta]Previewing changes for:[/bold magenta]\n[bold yellow]{target_dir}[/bold yellow]\n")
-        preview = installer.preview_installation()
+        try:
+            preview = installer.preview_installation()
+        except ValueError as e:
+            console.print()
+            console.print(f"[red]Error:[/red] {e}", style="bold")
+            console.print()
+            raise typer.Exit(1)
+
         normalized_preview = _normalize_preview_for_display(preview, operation="install")
-        _display_changes(normalized_preview, verbose=verbose)
+        _display_changes(normalized_preview, target_dir, verbose=verbose)
 
         # Show warnings/conflicts
         if preview.get("warnings"):
@@ -288,8 +351,8 @@ def add_kits(
             target_dir,
             kits=kits,
             force=True,  # Skip conflict checks after user confirmed
-            agent=agent,
-            shell=shell
+            agents=agents,
+            shells=shells
         )
 
     # Install
@@ -385,7 +448,6 @@ def remove(
     # Show preview and confirmation unless --force is used
     if not force:
         # Show preview of files to be removed
-        console.print(f"\n[bold magenta]Previewing changes for:[/bold magenta]\n[bold yellow]{target_dir}[/bold yellow]\n")
         preview = installer.preview_removal()
 
         if preview["total_files"] == 0:
@@ -395,7 +457,7 @@ def remove(
 
         # Normalize removal preview to standard format for DRY display
         normalized_preview = _normalize_preview_for_display(preview, operation="remove")
-        _display_changes(normalized_preview, verbose=verbose)
+        _display_changes(normalized_preview, target_dir, verbose=verbose)
 
         # Confirm removal
         if not typer.confirm("Continue with removal?"):
@@ -543,15 +605,19 @@ def _normalize_preview_for_display(preview: dict, operation: str = "install") ->
     else:
         raise ValueError(f"Unknown operation: {operation}")
 
-def _display_changes(changes: dict, verbose: bool = False):
+def _display_changes(changes: dict, target_dir: Path, verbose: bool = False):
     """Display preview of changes.
 
     Args:
         changes: Normalized preview dict with file/directory changes
+        target_dir: Target directory being modified
         verbose: If True, show detailed file listings; if False, show only tables
     """
     from collections import defaultdict
 
+    # Show preview header
+    console.print(f"\n[bold magenta]Previewing changes for:[/bold magenta]\n[bold yellow]{target_dir}[/bold yellow]\n")
+
     # Collect stats for each kit
     kit_stats = {}
     total_stats = defaultdict(int)
@@ -859,13 +925,18 @@ def _display_removal_summary(result: dict, verbose: bool = False):
         console.print(f"\nRemoved {len(all_removed)} files")
 
 def _display_validation_results(validation_result: dict):
-    """Display validation results in a user-friendly format.
+    """Display validation results with per-kit status and breakdown table.
+
+    Shows validation-specific information (file checks, missing files, integrity issues)
+    followed by the agent/shell breakdown table for kits that passed validation.
 
     Args:
-        validation_result: Dict with 'valid' (bool) and 'checks' (dict of kit results)
+        validation_result: Dict with 'valid' (bool), 'checks' (dict of kit results), and 'target_dir' (Path)
     """
     checks = validation_result.get("checks", {})
+    target_dir = validation_result.get("target_dir", Path.cwd())
 
+    # Show per-kit validation status with detailed issues
     for kit_name, result in checks.items():
         status = result.get("status", "unknown")
 
@@ -874,13 +945,25 @@ def _display_validation_results(validation_result: dict):
         elif status == "not_installed":
             console.print(f"[dim][-] {kit_name} (not installed)[/dim]")
         elif status == "partial":
-            console.print(f"[yellow][!] {kit_name} (partial - some files missing)[/yellow]")
+            console.print(f"[yellow][!] {kit_name} (partial - issues found)[/yellow]")
+            # Show detailed issues
             missing = result.get("missing_files", [])
+            corrupted = result.get("corrupted_files", [])
             if missing:
-                console.print(f"[dim]  Missing files: {', '.join(missing[:3])}" + (" ..." if len(missing) > 3 else "") + "[/dim]")
+                console.print(f"[dim]  Missing: {', '.join(missing[:3])}" + (" ..." if len(missing) > 3 else "") + "[/dim]")
+            if corrupted:
+                console.print(f"[dim]  Corrupted: {', '.join(corrupted[:3])}" + (" ..." if len(corrupted) > 3 else "") + "[/dim]")
         else:
             console.print(f"[red][X] {kit_name} ({status})[/red]")
 
+    # Show agent/shell breakdown table for validated kits
+    validated_kits = [kit_name for kit_name, result in checks.items() if result.get("status") == "installed"]
+
+    if validated_kits:
+        console.print()
+        table = _build_kit_breakdown_table(target_dir, validated_kits)
+        console.print(table)
+
 def _cleanup_empty_directories(target_dir: Path):
     """Clean up empty directories created by lite-kits."""
     directories_to_check = [

{lite_kits-0.3.1 → lite_kits-0.3.3}/src/lite_kits/core/detector.py

@@ -24,24 +24,37 @@ class Detector:
         self.target_dir = target_dir
         self.manifest = manifest
 
-    def detect_agents(self, preferred: Optional[str] = None) -> List[str]:
+    def detect_agents(self, preferred: Optional[List[str]] = None) -> List[str]:
         """
         Auto-detect which AI agents are present.
 
         Args:
-            preferred: Explicit agent preference (overrides auto-detection)
+            preferred: List of explicit agent preferences (overrides auto-detection)
 
         Returns:
             List of agent names sorted by priority
         """
-        # If explicit preference, validate and return
+        # If explicit preferences, validate and return
         if preferred:
-            config = self.manifest.get_agent_config(preferred)
-            if not config:
-                raise ValueError(f"Unknown agent: {preferred}")
-            if not config.get('supported', False):
-                raise ValueError(f"Agent not supported: {preferred}")
-            return [preferred]
+            validated = []
+            for agent_name in preferred:
+                config = self.manifest.get_agent_config(agent_name)
+                if not config:
+                    # Build helpful error message with valid options
+                    agents = self.manifest.manifest.get('agents', {})
+                    valid_agents = [
+                        name for name, cfg in agents.items()
+                        if cfg.get('supported', False)
+                    ]
+                    valid_list = ', '.join(valid_agents)
+                    raise ValueError(
+                        f"Unknown agent: '{agent_name}'\n"
+                        f"Valid options: {valid_list}"
+                    )
+                if not config.get('supported', False):
+                    raise ValueError(f"Agent not supported: {agent_name}")
+                validated.append(agent_name)
+            return validated
 
         # Auto-detect from manifest
         detected = []
@@ -65,24 +78,48 @@ class Detector:
         detected.sort(key=lambda x: x['priority'])
         return [agent['name'] for agent in detected]
 
-    def detect_shells(self, preferred: Optional[str] = None) -> List[str]:
+    def detect_shells(self, preferred: Optional[List[str]] = None) -> List[str]:
         """
         Determine which shells to install for.
 
         Args:
-            preferred: Explicit shell preference (overrides auto-detection)
+            preferred: List of explicit shell preferences (overrides auto-detection)
 
         Returns:
             List of shell names
         """
-        # If explicit preference, validate and return
+        # Shell aliases for common shorthands
+        shell_aliases = {
+            'ps': 'powershell',
+            'pwsh': 'powershell',
+            'sh': 'bash',
+        }
+
+        # If explicit preferences, validate and return
         if preferred:
-            config = self.manifest.manifest.get('shells', {}).get(preferred)
-            if not config:
-                raise ValueError(f"Unknown shell: {preferred}")
-            if not config.get('supported', False):
-                raise ValueError(f"Shell not supported: {preferred}")
-            return [preferred]
+            validated = []
+            for shell_name in preferred:
+                # Normalize shell name using aliases
+                normalized = shell_aliases.get(shell_name.lower(), shell_name.lower())
+
+                config = self.manifest.manifest.get('shells', {}).get(normalized)
+                if not config:
+                    # Build helpful error message with valid options
+                    shells_config = self.manifest.manifest.get('shells', {})
+                    valid_shells = [
+                        name for name, cfg in shells_config.items()
+                        if cfg.get('supported', False)
+                    ]
+                    valid_list = ', '.join(valid_shells)
+                    raise ValueError(
+                        f"Unknown shell: '{shell_name}'\n"
+                        f"Valid options: {valid_list}\n"
+                        f"Aliases: ps/pwsh->powershell, sh->bash"
+                    )
+                if not config.get('supported', False):
+                    raise ValueError(f"Shell not supported: {normalized}")
+                validated.append(normalized)
+            return validated
 
         # Check if shell detection is enabled
         options = self.manifest.manifest.get('options', {})

{lite_kits-0.3.1 → lite_kits-0.3.3}/src/lite_kits/core/installer.py

@@ -23,8 +23,8 @@ class Installer:
         target_dir: Path,
         kits: Optional[List[str]] = None,
         force: bool = False,
-        agent: Optional[str] = None,
-        shell: Optional[str] = None,
+        agents: Optional[List[str]] = None,
+        shells: Optional[List[str]] = None,
     ):
         """
         Initialize installer.
@@ -33,8 +33,8 @@ class Installer:
             target_dir: Target spec-kit project directory
             kits: List of kits to install (None = use default from manifest)
             force: Skip confirmations and overwrite existing files
-            agent: Explicit agent preference (None = auto-detect)
-            shell: Explicit shell preference (None = auto-detect)
+            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"
@@ -54,9 +54,15 @@ class Installer:
         # Operational modes
         self.force = force
 
-        # Preferences
-        self.preferred_agent = agent
-        self.preferred_shell = shell
+        # 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()]
@@ -82,8 +88,8 @@ class Installer:
 
     def preview_installation(self) -> Dict:
         """Preview installation without making changes."""
-        agents = self.detector.detect_agents(self.preferred_agent)
-        shells = self.detector.detect_shells(self.preferred_shell)
+        agents = self.detector.detect_agents(self.preferred_agents)
+        shells = self.detector.detect_shells(self.preferred_shells)
 
         preview = {
             "kits": [],
@@ -169,8 +175,8 @@ class Installer:
         }
 
         try:
-            agents = self.detector.detect_agents(self.preferred_agent)
-            shells = self.detector.detect_shells(self.preferred_shell)
+            agents = self.detector.detect_agents(self.preferred_agents)
+            shells = self.detector.detect_shells(self.preferred_shells)
 
             if not agents:
                 supported = [

{lite_kits-0.3.1 → lite_kits-0.3.3}/src/lite_kits/core/validator.py

@@ -8,6 +8,7 @@ from pathlib import Path
 from typing import Dict
 
 from .manifest import KitManifest
+from .detector import Detector
 
 
 class Validator:
@@ -23,6 +24,7 @@ class Validator:
         """
         self.target_dir = target_dir
         self.manifest = manifest
+        self.detector = Detector(target_dir, manifest)
 
     def validate_all(self) -> Dict:
         """
@@ -46,6 +48,7 @@ class Validator:
         return {
             "valid": any_installed,
             "checks": checks,
+            "target_dir": self.target_dir,
         }
 
     def validate_kit(self, kit_name: str, options: Dict) -> Dict:
@@ -75,14 +78,48 @@ class Validator:
                 "message": f"{kit_info['name']}: not installed",
             }
 
-        # Kit is installed, validate files
+        # 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 all_files:
+        for file_info in files_to_validate:
             # Skip non-required files
             if not file_info.get('required', True):
                 continue