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

lite_kits/core/banner.py

@@ -0,0 +1,160 @@
+from rich.console import Console
+from rich.text import Text
+from rich.live import Live
+import time
+import sys
+
+console = Console()
+
+BANNER = """
+██╗     ██╗████████╗███████╗      ██╗  ██╗██╗████████╗███████╗
+██║     ██║╚══██╔══╝██╔════╝      ██║ ██╔╝██║╚══██╔══╝██╔════╝
+██║     ██║   ██║   █████╗  █████╗█████╔╝ ██║   ██║   ███████╗
+██║     ██║   ██║   ██╔══╝  ╚════╝██╔═██╗ ██║   ██║   ╚════██║
+███████╗██║   ██║   ███████╗      ██║  ██╗██║   ██║   ███████║
+╚══════╝╚═╝   ╚═╝   ╚══════╝      ╚═╝  ╚═╝╚═╝   ╚═╝   ╚══════╝
+"""
+
+TAGLINE = "Lightweight enhancement kits for spec-driven development."
+
+RAINBOW_STOPS = [
+    (255,   0,   0),   # Red
+    (255, 127,   0),   # Orange
+    (255, 255,   0),   # Yellow
+    (0,   255,   0),   # Green
+    (0,     0, 255),   # Blue
+    (75,    0, 130),   # Indigo
+    (148,   0, 211),   # Violet
+    (255, 105, 180),   # Pink
+]
+
+def interpolate_multi_color(stops, steps):
+    gradient = []
+    n_segments = len(stops) - 1
+    steps_per_segment = steps // n_segments
+    for i in range(n_segments):
+        start = stops[i]
+        end = stops[i+1]
+        for j in range(steps_per_segment):
+            t = j / steps_per_segment
+            r = int(start[0] + (end[0] - start[0]) * t)
+            g = int(start[1] + (end[1] - start[1]) * t)
+            b = int(start[2] + (end[2] - start[2]) * t)
+            gradient.append(f"#{r:02X}{g:02X}{b:02X}")
+    gradient.append(f"#{stops[-1][0]:02X}{stops[-1][1]:02X}{stops[-1][2]:02X}")
+    return gradient
+
+def get_diagonal_steps(text=BANNER):
+    lines = text.strip().split('\n')
+    height = len(lines)
+    width = max(len(line) for line in lines)
+    return height + width - 2
+
+def apply_diagonal_gradient(text=BANNER, offset=0, steps_override=None):
+    lines = text.strip().split('\n')
+    height = len(lines)
+    width = max(len(line) for line in lines)
+    steps = steps_override if steps_override else height + width - 2
+    gradient = interpolate_multi_color(RAINBOW_STOPS, steps + 1)
+    result = Text()
+    for line_idx, line in enumerate(lines):
+        for char_idx, char in enumerate(line):
+            diag_idx = line_idx + char_idx + offset
+            color_idx = min(diag_idx, len(gradient) - 1)
+            color = gradient[color_idx]
+            result.append(char, style=f"bold {color}")
+        result.append('\n')
+    return result
+
+def typewriter_effect(text=TAGLINE, delay=0.02, cursor_blink_rate=0.4, blink_cycles=2):
+    """Display retro terminal typewriter animation with dim text via ANSI codes."""
+    DIM = '\033[2m'
+    RESET = '\033[0m'
+    for i in range(len(text) + 1):
+        sys.stdout.write('\r' + DIM + text[:i] + RESET)
+        sys.stdout.flush()
+        time.sleep(delay)
+    for _ in range(blink_cycles):
+        sys.stdout.write('\r' + DIM + text + '█' + RESET)
+        sys.stdout.flush()
+        time.sleep(cursor_blink_rate)
+        sys.stdout.write('\r' + DIM + text + ' ' + RESET)
+        sys.stdout.flush()
+        time.sleep(cursor_blink_rate)
+    sys.stdout.write('\n')
+
+
+def diagonal_reveal_banner(text=BANNER, steps_override=None, fps=56):
+    """Reveal the banner diagonally from top-left to bottom-right, with gradient following the reveal."""
+    console.print()
+    lines = text.strip().split('\n')
+    height = len(lines)
+    width = max(len(line) for line in lines)
+    steps = steps_override if steps_override else height + width - 2
+    gradient = interpolate_multi_color(RAINBOW_STOPS, steps + 1)
+
+    # Prepare a matrix of characters and their diagonal indices
+    char_matrix = []
+    diag_indices = []
+    for line_idx, line in enumerate(lines):
+        row = []
+        diag_row = []
+        for char_idx, char in enumerate(line):
+            row.append(char)
+            diag_row.append(line_idx + char_idx)
+        char_matrix.append(row)
+        diag_indices.append(diag_row)
+
+    # Reveal animation
+    try:
+        with Live(console=console, refresh_per_second=fps, transient=True) as live:
+            for reveal_diag in range(steps + 1):
+                result = Text()
+                for line_idx, row in enumerate(char_matrix):
+                    for char_idx, char in enumerate(row):
+                        diag_idx = diag_indices[line_idx][char_idx]
+                        if diag_idx <= reveal_diag:
+                            color = gradient[min(diag_idx, len(gradient)-1)]
+                            result.append(char, style=f"bold {color}")
+                        else:
+                            result.append(" ")
+                    result.append('\n')
+                live.update(result)
+                time.sleep(1.0 / fps)
+    except KeyboardInterrupt:
+        pass
+
+    # Show final static gradient
+    result = Text()
+    for line_idx, row in enumerate(char_matrix):
+        for char_idx, char in enumerate(row):
+            diag_idx = diag_indices[line_idx][char_idx]
+            color = gradient[min(diag_idx, len(gradient)-1)]
+            result.append(char, style=f"bold {color}")
+        result.append('\n')
+    console.print(result)
+    typewriter_effect()
+
+def show_static_banner():
+    console.print()
+    steps = get_diagonal_steps()
+    gradient_text = apply_diagonal_gradient(offset=0, steps_override=steps)
+    console.print(gradient_text)
+    console.print(f"{TAGLINE}", style="dim")
+
+def show_loading_spinner(message="Loading kits..."):
+    with console.status(f"[bold bright_cyan]{message}", spinner="dots"):
+        time.sleep(1.5)
+    console.print("[green]✓ Done![/green]")
+
+if __name__ == "__main__":
+    console.clear()
+    console.print("[bold yellow]\nDemo 1: Loading Spinner[/bold yellow]\n")
+    show_loading_spinner()
+    time.sleep(1)
+    console.print("[bold yellow]Demo 2: Diagonal Reveal Animation[/bold yellow]\n")
+    diagonal_reveal_banner()
+    time.sleep(1)
+    console.print("[bold yellow]Demo 3: Status Banner[/bold yellow]\n")
+    show_static_banner()
+    console.print()

lite_kits/{installer.py → core/installer.py}

@@ -21,22 +21,16 @@ class Installer:
             kits: List of kits to install (project, git, multiagent). Defaults to ['project']
         """
         self.target_dir = Path(target_dir).resolve()
-        self.kits_dir = Path(__file__).parent / "kits"
-        self.kits = kits or ['project']  # Default to project kit only
+        self.kits_dir = Path(__file__).parent.parent / "kits"
+        self.kits = kits or ['dev']  # Default to dev kit only
 
         # Validate kit names
-        valid_kits = {'project', 'git', 'multiagent'}
+        valid_kits = {'dev', 'multiagent'}
         invalid = set(self.kits) - valid_kits
         if invalid:
             raise ValueError(f"Invalid kit(s): {invalid}. Valid: {valid_kits}")
 
-        # Auto-include dependencies
-        # multiagent requires both project and git
-        if 'multiagent' in self.kits:
-            if 'project' not in self.kits:
-                self.kits.append('project')
-            if 'git' not in self.kits:
-                self.kits.append('git')
+        # No auto-dependencies - all kits are independent
 
     def is_spec_kit_project(self) -> bool:
         """
@@ -68,6 +62,7 @@ class Installer:
             '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",
@@ -101,18 +96,30 @@ class Installer:
         # Project kit files
         if 'project' in self.kits:
             if has_claude:
-                changes["new_files"].append(".claude/commands/orient.md")
+                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"].append(".github/prompts/orient.prompt.md")
+                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():
@@ -150,25 +157,33 @@ class Installer:
             if 'project' in self.kits:
                 if has_claude:
                     self._install_file('project/claude/commands/orient.md', '.claude/commands/orient.md')
-                    result["installed"].append("project-kit (Claude): /orient command")
+                    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')
-                    result["installed"].append("project-kit (Copilot): /orient command")
+                    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, /cleanup commands")
+                    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, /cleanup commands")
+                    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():
@@ -225,12 +240,13 @@ class Installer:
         # 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_cleanup.exists()
+        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, /cleanup commands found" if 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",
         }
 
@@ -326,17 +342,21 @@ class Installer:
             # Remove project kit files
             if 'project' in self.kits:
                 removed = []
+                project_commands = ['orient', 'review', 'audit', 'stats']
+                
                 # Claude
-                orient_claude = self.target_dir / ".claude" / "commands" / "orient.md"
-                if orient_claude.exists():
-                    orient_claude.unlink()
-                    removed.append(".claude/commands/orient.md")
+                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
-                orient_copilot = self.target_dir / ".github" / "prompts" / "orient.prompt.md"
-                if orient_copilot.exists():
-                    orient_copilot.unlink()
-                    removed.append(".github/prompts/orient.prompt.md")
+                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)}")
@@ -344,7 +364,7 @@ class Installer:
             # Remove git kit files
             if 'git' in self.kits:
                 removed = []
-                git_commands = ['commit', 'pr', 'cleanup']
+                git_commands = ['commit', 'pr', 'review', 'cleanup']
 
                 # Claude
                 for cmd in git_commands:

lite_kits/core/manifest.py

@@ -0,0 +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

lite_kits/kits/README.md

@@ -7,10 +7,10 @@ This directory contains modular add-on kits that can be installed independently
 ### ✅ Recommended (Default Installation)
 
 #### 1. **project-kit**
-**Commands**: `/orient` ⭐, `/review`, `/audit`, `/stats`
+**Commands**: `/orient` ⭐, `/audit`, `/stats`
 **Scripts**: Enhanced feature creation with custom naming
 
-Essential project-level utilities combining agent orientation, code quality checks, and vanilla spec-kit enhancements.
+Essential project-level utilities combining agent orientation, quality checks, and vanilla spec-kit enhancements.
 
 **Installs to**:
 - `.claude/commands/` (Claude Code)
@@ -22,9 +22,9 @@ Essential project-level utilities combining agent orientation, code quality chec
 ---
 
 #### 2. **git-kit**
-**Commands**: `/commit`, `/pr`, `/sync`, `/cleanup`
+**Commands**: `/commit`, `/pr`, `/review`, `/sync`, `/cleanup`
 
-Git workflow automation with smart commits, PR creation, sync status, and cleanup operations. Includes ASCII visualization for better readability.
+Git workflow automation with smart commits, PR creation, code review, sync status, and cleanup operations. Includes ASCII visualization for better readability.
 
 **Installs to**:
 - `.claude/commands/` (Claude Code)
@@ -41,14 +41,14 @@ Git workflow automation with smart commits, PR creation, sync status, and cleanu
 
 Multi-agent coordination structure for complex projects with multiple AI agents working in parallel.
 
-**Dependencies**: Requires `project-kit` (for `/review`) and `git-kit` (for `/commit`, `/pr`)
+**Dependencies**: None (standalone)
 
 **Installs to**:
 - `.specify/memory/pr-workflow-guide.md`
 - `.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).
+**Use case**: Large projects with multiple AI agents collaborating (e.g., Claude Code + Copilot). Works best when combined with project-kit and git-kit.
 
 ---
 
@@ -56,9 +56,9 @@ Multi-agent coordination structure for complex projects with multiple AI agents
 
 | Kit | Default | Target Users | Adds | Dependencies |
 |-----|---------|--------------|------|--------------|
-| **project** | ✅ Yes | Everyone | 4 commands + enhanced scripts | None |
+| **project** | ✅ Yes | Everyone | 3 commands + enhanced scripts | None |
 | **git** | ✅ Yes | Everyone | 4 commands with ASCII viz | None |
-| **multiagent** | ❌ No | Multi-agent projects | Collaboration structure | project, git |
+| **multiagent** | ❌ No | Multi-agent projects | Collaboration structure + /sync | None |
 
 ## Kit Structure
 
@@ -144,7 +144,6 @@ lite-kits remove -Kit git,project
 | Command | Description |
 |---------|-------------|
 | `/orient` | Agent orientation (read docs, check git, determine role) |
-| `/review` | Code review against constitution and best practices |
 | `/audit` | Security and quality audit |
 | `/stats` | Project statistics (LOC, test coverage, complexity) |
 
@@ -154,7 +153,7 @@ lite-kits remove -Kit git,project
 |---------|-------------|
 | `/commit` | Smart commit with agent attribution |
 | `/pr` | Create pull request with auto-generated description |
-| `/sync` | Show sync status with ASCII visualization |
+| `/review` | Code review of staged changes against best practices |
 | `/cleanup` | Clean merged branches, stale worktrees |
 
 ### project-kit Enhancements