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

lite_kits/kits/git/scripts/powershell/Get-GitContext.ps1

@@ -1,242 +0,0 @@
-#Requires -Version 5.1
-
-<#
-.SYNOPSIS
-    Gathers comprehensive git repository context for AI agents.
-
-.DESCRIPTION
-    Collects git status, branch information, recent commits, and change statistics
-    in a structured format suitable for AI agent orientation and commit workflows.
-
-.PARAMETER IncludeCommits
-    Number of recent commits to include (default: 5)
-
-.PARAMETER IncludeDiff
-    Include file diff statistics (default: true)
-
-.PARAMETER Format
-    Output format: Object, Json, or Text (default: Object)
-
-.EXAMPLE
-    Get-GitContext
-    Returns git context as PowerShell object
-
-.EXAMPLE
-    Get-GitContext -Format Text | Write-Host
-    Displays formatted text output
-
-.EXAMPLE
-    Get-GitContext -IncludeCommits 10 -Format Json
-    Returns last 10 commits as JSON
-#>
-
-[CmdletBinding()]
-param(
-    [Parameter()]
-    [int]$IncludeCommits = 5,
-
-    [Parameter()]
-    [switch]$IncludeDiff,
-
-    [Parameter()]
-    [ValidateSet('Object', 'Json', 'Text')]
-    [string]$Format = 'Object'
-)
-
-# Check if we're in a git repository
-if (-not (git rev-parse --git-dir 2>$null)) {
-    Write-Error "Not a git repository"
-    return
-}
-
-# Gather git context
-$context = [PSCustomObject]@{
-    Branch = $null
-    CommitHash = $null
-    Status = @{
-        Staged = @()
-        Unstaged = @()
-        Untracked = @()
-        Counts = @{
-            Staged = 0
-            Unstaged = 0
-            Untracked = 0
-        }
-    }
-    RecentCommits = @()
-    Remote = @{
-        Url = $null
-        Ahead = 0
-        Behind = 0
-        Tracking = $null
-    }
-    Stats = @{
-        TotalFiles = 0
-        Insertions = 0
-        Deletions = 0
-    }
-}
-
-# Get current branch
-$context.Branch = git branch --show-current
-
-# Get current commit hash
-$context.CommitHash = git rev-parse --short HEAD 2>$null
-
-# Get git status
-$statusLines = git status --porcelain
-
-foreach ($line in $statusLines) {
-    if ($line) {
-        $statusCode = $line.Substring(0, 2)
-        $filePath = $line.Substring(3)
-
-        # Staged files (first character)
-        if ($statusCode[0] -match '[MADRC]') {
-            $context.Status.Staged += [PSCustomObject]@{
-                Status = $statusCode[0]
-                Path = $filePath
-            }
-            $context.Status.Counts.Staged++
-        }
-
-        # Unstaged files (second character)
-        if ($statusCode[1] -match '[MD]') {
-            $context.Status.Unstaged += [PSCustomObject]@{
-                Status = $statusCode[1]
-                Path = $filePath
-            }
-            $context.Status.Counts.Unstaged++
-        }
-
-        # Untracked files
-        if ($statusCode -eq '??') {
-            $context.Status.Untracked += [PSCustomObject]@{
-                Path = $filePath
-            }
-            $context.Status.Counts.Untracked++
-        }
-    }
-}
-
-# Get remote tracking info
-$tracking = git rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>$null
-if ($tracking) {
-    $context.Remote.Tracking = $tracking
-
-    # Get ahead/behind counts
-    $aheadBehind = git rev-list --left-right --count HEAD...$tracking 2>$null
-    if ($aheadBehind) {
-        $parts = $aheadBehind -split '\s+'
-        $context.Remote.Ahead = [int]$parts[0]
-        $context.Remote.Behind = [int]$parts[1]
-    }
-}
-
-# Get remote URL
-$remoteUrl = git remote get-url origin 2>$null
-if ($remoteUrl) {
-    $context.Remote.Url = $remoteUrl
-}
-
-# Get recent commits
-if ($IncludeCommits -gt 0) {
-    $commitFormat = '%H%x00%h%x00%an%x00%ae%x00%ad%x00%s'
-    $commitLines = git log -n $IncludeCommits --pretty=format:$commitFormat --date=relative
-
-    foreach ($line in $commitLines) {
-        if ($line) {
-            $parts = $line -split "`0", 6
-            $context.RecentCommits += [PSCustomObject]@{
-                Hash = $parts[0]
-                ShortHash = $parts[1]
-                Author = $parts[2]
-                Email = $parts[3]
-                Date = $parts[4]
-                Subject = $parts[5]
-            }
-        }
-    }
-}
-
-# Get diff statistics
-if ($IncludeDiff -and $context.Status.Counts.Staged -gt 0) {
-    $diffStat = git diff --cached --numstat
-
-    foreach ($line in $diffStat) {
-        if ($line) {
-            $parts = $line -split '\s+', 3
-            $insertions = if ($parts[0] -eq '-') { 0 } else { [int]$parts[0] }
-            $deletions = if ($parts[1] -eq '-') { 0 } else { [int]$parts[1] }
-
-            $context.Stats.Insertions += $insertions
-            $context.Stats.Deletions += $deletions
-            $context.Stats.TotalFiles++
-        }
-    }
-}
-
-# Output based on format
-switch ($Format) {
-    'Json' {
-        $context | ConvertTo-Json -Depth 10
-    }
-    'Text' {
-        # Formatted text output
-        Write-Output "==============================================================="
-        Write-Output "📊 Git Status (on: $($context.Branch)):"
-        Write-Output "==============================================================="
-        Write-Output "Staged:    $($context.Status.Counts.Staged) files"
-        Write-Output "Unstaged:  $($context.Status.Counts.Unstaged) files"
-        Write-Output "Untracked: $($context.Status.Counts.Untracked) files"
-
-        if ($context.Remote.Tracking) {
-            Write-Output ""
-            Write-Output "Remote: $($context.Remote.Tracking)"
-            if ($context.Remote.Ahead -gt 0) {
-                Write-Output "  Ahead by $($context.Remote.Ahead) commit(s)"
-            }
-            if ($context.Remote.Behind -gt 0) {
-                Write-Output "  Behind by $($context.Remote.Behind) commit(s)"
-            }
-        }
-
-        if ($context.Status.Staged.Count -gt 0) {
-            Write-Output ""
-            Write-Output "Staged files:"
-            foreach ($file in $context.Status.Staged) {
-                Write-Output "  $($file.Status)  $($file.Path)"
-            }
-        }
-
-        if ($context.Status.Unstaged.Count -gt 0) {
-            Write-Output ""
-            Write-Output "Unstaged files:"
-            foreach ($file in $context.Status.Unstaged) {
-                Write-Output "   $($file.Status) $($file.Path)"
-            }
-        }
-
-        if ($context.Status.Untracked.Count -gt 0) {
-            Write-Output ""
-            Write-Output "Untracked files:"
-            foreach ($file in $context.Status.Untracked) {
-                Write-Output "  ?? $($file.Path)"
-            }
-        }
-
-        if ($context.RecentCommits.Count -gt 0) {
-            Write-Output ""
-            Write-Output "Recent commits:"
-            foreach ($commit in $context.RecentCommits) {
-                Write-Output "  $($commit.ShortHash) $($commit.Subject) ($($commit.Date))"
-            }
-        }
-
-        Write-Output "==============================================================="
-    }
-    default {
-        # Return PowerShell object
-        $context
-    }
-}

lite_kits/kits/project/README.md

@@ -1,244 +0,0 @@
-# Project Kit
-
-**Status**: ✅ Recommended (Default)
-
-Essential project-level utilities and enhancements for vanilla spec-kit. Includes agent orientation, code review, quality checks, and enhanced feature creation scripts.
-
-## What It Adds
-
-### Commands (AI Agents)
-
-| Command | Claude Code | GitHub Copilot | Description |
-|---------|-------------|----------------|-------------|
-| `/orient` | ✅ | ✅ | Agent orientation protocol (most essential!) |
-| `/review` | 🚧 | 🚧 | Code review helper |
-| `/audit` | 🚧 | 🚧 | Security & quality audit |
-| `/stats` | 🚧 | 🚧 | Project statistics |
-
-### Scripts (Enhanced Vanilla)
-
-| Script | Bash | PowerShell | Description |
-|--------|------|------------|-------------|
-| Feature creation | 🚧 | 🚧 | Custom feature numbering/naming |
-
-✅ = Implemented | 🚧 = Coming Soon
-
-## Installation
-
-### As part of recommended kits:
-```bash
-lite-kits install -Recommended  # project + git
-```
-
-### Individually:
-```bash
-lite-kits install -Kit project
-```
-
-## What Gets Installed
-
-```
-your-project/
-├── .claude/commands/              # If Claude Code detected
-│   ├── orient.md                  # ✅ Essential!
-│   ├── review.md                  # 🚧 Coming Soon
-│   ├── audit.md                   # 🚧 Coming Soon
-│   └── stats.md                   # 🚧 Coming Soon
-├── .github/prompts/               # If GitHub Copilot detected
-│   ├── orient.prompt.md           # ✅ Essential!
-│   ├── review.prompt.md           # 🚧 Coming Soon
-│   ├── audit.prompt.md            # 🚧 Coming Soon
-│   └── stats.prompt.md            # 🚧 Coming Soon
-└── .specify/scripts/              # Enhanced vanilla scripts
-    ├── bash/
-    │   └── create-feature-enhanced.sh      # 🚧 Coming Soon
-    └── powershell/
-        └── Create-Feature-Enhanced.ps1     # 🚧 Coming Soon
-```
-
-**Note**: Vanilla spec-kit files are **never modified** - only new files are added.
-
-## Commands
-
-### `/orient` - Agent Orientation ⭐ ESSENTIAL
-
-**Purpose**: Help AI agents quickly understand project context before starting work.
-
-**What it does**:
-1. Reads `.github/copilot-instructions.md` (primary source)
-2. Reads `.specify/memory/constitution.md` (project philosophy)
-3. Checks current git state (branch, recent commits)
-4. Reviews collaboration directories (if multiagent-kit installed)
-5. Determines agent role (Claude = leader, Copilot = specialist)
-6. Outputs concise summary (~150-200 words)
-
-**Example usage**:
-```
-/orient
-
-## Orientation Complete - Primary Agent
-
-**I am**: claude-sonnet-4.5 @ Claude Code (Primary)
-
-**Project**: Pip-installable add-on for spec-kit
-
-**Stack**: Python 3.11+, typer, rich
-
-**Principles**:
-- Add-on pattern (no vanilla modifications)
-- Cross-platform (Bash + PowerShell)
-- Cross-agent (Claude + Copilot)
-
-**State**: Branch dev/001-starter-kits, 3 files changed
-
-**Coordination**: Solo work
-
-**Next**: Implement project-kit structure
-
-**Confirm?**: Ready to proceed?
-```
-
-**Why this is essential**: Every AI agent should run `/orient` at the start of each session to get up to speed quickly without wasting tokens.
-
----
-
-### `/review` - Code Review (Coming Soon)
-
-**Purpose**: Review code changes against project constitution and best practices.
-
-**What it will do**:
-- Check staged changes against constitution principles
-- Identify common code smells
-- Suggest improvements
-- Verify test coverage
-- Check documentation completeness
-
----
-
-### `/audit` - Security & Quality Audit (Coming Soon)
-
-**Purpose**: Scan for security issues and quality problems.
-
-**What it will do**:
-- Scan for hardcoded secrets/credentials
-- Check for common vulnerabilities (SQL injection, XSS, CSRF)
-- Analyze dependencies for known CVEs
-- Verify input validation
-- Check file permissions
-
----
-
-### `/stats` - Project Statistics (Coming Soon)
-
-**Purpose**: Show project health metrics.
-
-**What it will do**:
-- Lines of code by language
-- Test coverage percentage
-- Git activity with agent attribution
-- Complexity metrics
-- Dependency count
-- Health score
-
----
-
-## Enhanced Scripts
-
-### Feature Creation Enhancement (Coming Soon)
-
-**Problem**: Vanilla `create-new-feature` script auto-generates feature numbers and uses first 3 words of description for naming.
-
-**Enhancement**: Full control over feature numbering and naming.
-
-**Usage** (planned):
-```bash
-# Vanilla (auto number, auto name from "Add user authentication system")
-.specify/scripts/bash/create-new-feature.sh "Add user authentication system"
-# Creates: 003-add-user-authentication
-
-# Enhanced (custom number and name)
-.specify/scripts/bash/create-feature-enhanced.sh --num 010 --name user-auth-v2 "Add user authentication system"
-# Creates: 010-user-auth-v2
-
-# Enhanced (custom number, auto name)
-.specify/scripts/bash/create-feature-enhanced.sh --num 007 "Add user authentication system"
-# Creates: 007-add-user-authentication
-```
-
-**Benefits**:
-- Match feature numbers to issue/ticket numbers
-- Use shorter, clearer names
-- Support feature name conventions (e.g., `api-`, `ui-`, `db-` prefixes)
-
----
-
-## Use Cases
-
-### Solo Developer with AI Agent
-**Install**: `--recommended` (includes project-kit)
-**Use**: `/orient` at start of every session (essential!)
-
-### Team with Multiple Agents
-**Install**: `--recommended` + `--kit=multiagent`
-**Use**: `/orient` + `/review` before committing
-
-### Security-Focused Project
-**Install**: `--recommended`
-**Use**: `/audit` regularly, `/review` on every change
-
-### Custom Workflow Needs
-**Install**: `--kit=project`
-**Use**: Enhanced scripts for precise feature naming
-
----
-
-## Configuration
-
-No configuration needed - works out of the box.
-
-**Optional customization**:
-- Edit `.github/copilot-instructions.md` - Affects `/orient` output
-- Edit `.specify/memory/constitution.md` - Project principles for `/review`
-
----
-
-## Dependencies
-
-**None** - project-kit is standalone.
-
-**Note**: multiagent-kit recommends project-kit for `/review` and best practices.
-
----
-
-## Compatibility
-
-- ✅ **Agents**: Claude Code, GitHub Copilot
-- ✅ **Platforms**: Linux, macOS, Windows
-- ✅ **Shells**: Bash, PowerShell
-- ✅ **Vanilla safe**: Only adds new files, never modifies existing
-
----
-
-## Uninstall
-
-```bash
-lite-kits remove -Kit project
-```
-
-Removes:
-- `.claude/commands/{orient,review,audit,stats}.md`
-- `.github/prompts/{orient,review,audit,stats}.prompt.md`
-- `.specify/scripts/{bash,powershell}/create-feature-enhanced.{sh,ps1}`
-
----
-
-## Future Enhancements
-
-Considering for project-kit:
-- `/docs` - Generate/update documentation
-- `/history` - Show project timeline
-- `/dependencies` - Dependency analysis
-- `/performance` - Performance profiling
-- Template library (api, cli, library, frontend feature templates)
-
-Suggest more in [GitHub Discussions](https://github.com/tmorgan181/spec-kit-multiagent-lite/discussions).