lite-kits 0.1.1__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,228 +0,0 @@
-# Project Kit
-
-**Status**: ✅ Recommended (Default)
-
-Essential project-level utilities and enhancements for vanilla spec-kit. Includes agent orientation, 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!) |
-| `/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!
-│   ├── audit.md                   # 🚧 Coming Soon
-│   └── stats.md                   # 🚧 Coming Soon
-├── .github/prompts/               # If GitHub Copilot detected
-│   ├── orient.prompt.md           # ✅ Essential!
-│   ├── 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.
-
----
-
-### `/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` at start of every session
-
-### Security-Focused Project
-**Install**: `--recommended`
-**Use**: `/audit` regularly for security scans
-
-### 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**: Works great with git-kit for complete workflow automation.
-
----
-
-## 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,audit,stats}.md`
-- `.github/prompts/{orient,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).

lite_kits/kits/project/claude/commands/audit.md

@@ -1,143 +0,0 @@
----
-description: Perform security analysis on dependencies and code patterns
----
-
-# Security Audit Helper
-
-**Purpose**: Quick security analysis for AI agents working on features involving authentication, data handling, or external dependencies.
-
-## Execution Steps
-
-Execute the following steps to perform a security audit:
-
-### 1. Detect Project Type and Dependencies
-
-```bash
-# Check for Python dependencies
-ls requirements.txt pyproject.toml setup.py 2>/dev/null
-
-# Check for Node.js dependencies
-ls package.json package-lock.json 2>/dev/null
-
-# Check for Rust dependencies
-ls Cargo.toml Cargo.lock 2>/dev/null
-
-# Check for Go dependencies
-ls go.mod go.sum 2>/dev/null
-```
-
-### 2. Run Dependency Vulnerability Scan
-
-**Python projects**:
-```bash
-# Check if pip-audit is available
-command -v pip-audit >/dev/null 2>&1
-
-# If available, run scan
-pip-audit
-
-# If not available, suggest installation
-echo "Install pip-audit: pip install pip-audit"
-```
-
-**Node.js projects**:
-```bash
-# npm audit is built-in
-npm audit
-
-# Or use yarn
-yarn audit
-```
-
-**Other languages**: Suggest appropriate tools (cargo audit, go list, etc.)
-
-### 3. Scan for Common Security Anti-Patterns
-
-Check source code for security issues:
-
-```bash
-# Look for potential hardcoded secrets
-grep -r "API_KEY\s*=\s*['\"]" src/ 2>/dev/null | head -5
-grep -r "PASSWORD\s*=\s*['\"]" src/ 2>/dev/null | head -5
-grep -r "SECRET\s*=\s*['\"]" src/ 2>/dev/null | head -5
-
-# Look for weak crypto patterns (Python)
-grep -r "md5\|sha1" src/ 2>/dev/null | head -5
-
-# Look for SQL injection risks
-grep -r "execute.*%\|execute.*+" src/ 2>/dev/null | head -5
-```
-
-**Common patterns to flag**:
-- Hardcoded API keys, passwords, tokens
-- Weak cryptographic algorithms (MD5, SHA1)
-- SQL string concatenation
-- Eval/exec with user input
-- Insecure file permissions
-
-### 4. Generate Concise Report
-
-Provide analysis in this format (~150 words max):
-
-```markdown
-## Security Audit
-
-**Dependencies**: N scanned, M vulnerabilities found
-
-**Vulnerabilities** (if any):
-- package-name==version: [SEVERITY] - Brief description
-- Link to advisory for details
-
-**Code Patterns** (if any):
-- file.py:line: [PATTERN] - Recommendation
-
-**Next Action**: [Fix CVE-XXXX / Update package / Review auth code]
-```
-
-## Important Notes
-
-- **Graceful fallbacks**: If audit tools not installed, do basic pattern checks only
-- **Be concise**: Target <150 words total output
-- **Prioritize**: Show highest severity issues first
-- **Avoid false positives**: Note that manual review may be needed
-- **No dependencies**: Report "No dependencies to audit" gracefully
-- **Cross-platform**: Use commands available on Windows, macOS, Linux
-
-## Edge Cases
-
-- **No dependency files**: "No dependencies found. This appears to be a dependency-free project."
-- **Tool not installed**: Provide installation command, run basic grep checks
-- **No vulnerabilities**: "✅ No known vulnerabilities found! Consider reviewing auth/data handling patterns."
-- **Too many issues**: Sample top 5, note total count
-
-## Example Output
-
-```markdown
-## Security Audit
-
-**Dependencies**: 12 scanned, 2 vulnerabilities found
-
-**Vulnerabilities**:
-- requests==2.25.0: MEDIUM - CVE-2023-32681 (Proxy-Auth header leak)
-  Update to: requests>=2.31.0
-
-**Code Patterns**:
-- src/auth.py:42: Hardcoded API key detected
-- src/db.py:103: SQL string concatenation (injection risk)
-
-**Next Action**: Update requests package, move API key to environment variables, use parameterized queries
-```
-
-```markdown
-## Security Audit
-
-**Dependencies**: pip-audit not installed
-
-**Tool Not Available**:
-Install pip-audit for vulnerability scanning:
-`pip install pip-audit`
-
-**Code Patterns**: Basic grep checks performed, no obvious issues found
-
-**Next Action**: Install pip-audit and re-run for comprehensive dependency scan
-```