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

lite_kits/kits/git/README.md

@@ -1,374 +0,0 @@
-# Git Kit
-
-**Status**: ✅ Recommended (Default)
-
-Git workflow automation with smart commits, PR creation, sync visualization, and cleanup operations. Includes ASCII visualization for better readability.
-
-## What It Adds
-
-### Commands
-
-| Command | Claude Code | GitHub Copilot | Description |
-|---------|-------------|----------------|-------------|
-| `/commit` | 🚧 | 🚧 | Smart commit with agent attribution |
-| `/pr` | 🚧 | 🚧 | Create PR with auto-generated description |
-| `/sync` | 🚧 | 🚧 | Show sync status with ASCII visualization |
-| `/cleanup` | 🚧 | 🚧 | Clean merged branches, stale worktrees |
-
-🚧 = Coming Soon
-
-## Installation
-
-### As part of recommended kits:
-```bash
-lite-kits install -Recommended  # project + git
-```
-
-### Individually:
-```bash
-lite-kits install -Kit git
-```
-
-## What Gets Installed
-
-```
-your-project/
-├── .claude/commands/          # If Claude Code detected
-│   ├── commit.md
-│   ├── pr.md
-│   ├── sync.md
-│   └── cleanup.md
-└── .github/prompts/           # If GitHub Copilot detected
-    ├── commit.prompt.md
-    ├── pr.prompt.md
-    ├── sync.prompt.md
-    └── cleanup.prompt.md
-```
-
-**Note**: Vanilla spec-kit files are **never modified** - only new files are added.
-
-## Commands
-
-### `/commit` - Smart Commit (Coming Soon)
-
-**Purpose**: Generate smart commit messages with agent attribution.
-
-**What it will do**:
-1. Run `git status` to see staged files
-2. Run `git diff --staged` to see changes
-3. Analyze changes and generate conventional commit message
-4. Add agent attribution footer
-5. Execute commit with generated message
-
-**Example usage** (planned):
-```
-/commit
-
-## Smart Commit
-
-**Staged files**: 3
-- src/auth.py (new)
-- src/models.py (modified)
-- tests/test_auth.py (new)
-
-**Changes detected**:
-- New feature: Authentication system
-- Added User model
-- Comprehensive test coverage
-
-**Suggested commit message**:
-
-feat: Add user authentication system
-
-Implements bcrypt password hashing, JWT token generation,
-and session management. Includes User model and comprehensive
-tests with 94% coverage.
-
-via claude-sonnet-4.5 @ claude-code
-
-**Confirm?** (y/n): y
-
-[dev/003-auth a1b2c3d] feat: Add user authentication system
- 3 files changed, 247 insertions(+)
- create mode 100644 src/auth.py
- create mode 100644 tests/test_auth.py
-```
-
-**Benefits**:
-- Consistent commit message format
-- Auto-attribution for AI-generated code
-- Follows conventional commits
-- Saves time thinking about messages
-
----
-
-### `/pr` - Create Pull Request (Coming Soon)
-
-**Purpose**: Create PR with auto-generated description from commits.
-
-**What it will do**:
-1. Check current branch against base (main/develop)
-2. List all commits that will be in PR
-3. Analyze changes across all commits
-4. Generate PR title and description
-5. Create PR using `gh pr create`
-
-**Example usage** (planned):
-```
-/pr
-
-## Create Pull Request
-
-**Branch**: dev/003-auth → main
-**Commits**: 5
-
-**Changes summary**:
-- Added authentication system (bcrypt + JWT)
-- Created User model with validation
-- Added login/logout API endpoints
-- Comprehensive test suite (94% coverage)
-- Updated API documentation
-
-**Generated PR**:
-
-Title: feat: Add user authentication system
-
-Body:
-## Summary
-- Implements bcrypt password hashing
-- JWT token generation and validation
-- Session management
-- User model with SQLAlchemy
-
-## Changes
-- `src/auth.py` - Authentication logic
-- `src/models.py` - User model
-- `src/api/auth_routes.py` - Login/logout endpoints
-- `tests/test_auth.py` - Test suite (94% coverage)
-
-## Test Plan
-- [x] Unit tests passing (24/24)
-- [x] Manual testing of login flow
-- [x] Password validation tested
-- [ ] Security review pending
-
-## Related
-- Implements: specs/003-user-auth/spec.md
-- Closes: #42
-
-🤖 Generated with spec-kit-multiagent
-via claude-sonnet-4.5 @ claude-code
-
-**Create PR?** (y/n): y
-
-✓ Pull request created: https://github.com/user/repo/pull/15
-```
-
----
-
-### `/sync` - Sync Status with Visualization (Coming Soon)
-
-**Purpose**: Show git sync status with ASCII visualization.
-
-**Problem**: `git status` output is text-heavy and hard to parse visually.
-
-**Solution**: ASCII tree diagrams and colorized status.
-
-**Example usage** (planned):
-```
-/sync
-
-## Git Sync Status
-
-**Branch**: dev/003-auth
-**Tracking**: origin/dev/003-auth
-
-**Local vs Remote**:
-
-    origin/main ─────────────┬──────> main (up to date)
-                              │
-                              ├──────> dev/003-auth (5 commits ahead)
-                              │        ↑ PUSH NEEDED
-                              │
-    Your commits:             │
-    ├─ a1b2c3d feat: Add auth│
-    ├─ b2c3d4e feat: Add user│
-    ├─ c3d4e5f test: Add auth│
-    ├─ d4e5f6g docs: Update  │
-    └─ e5f6g7h fix: Resolve  │
-                              │
-**Status**:
-✓ No uncommitted changes
-⚠ 5 commits not pushed
-✓ Up to date with remote (fetched 2m ago)
-
-**Actions**:
-1. git push origin dev/003-auth
-2. git fetch (refresh remote status)
-3. /pr (create pull request)
-
-**Worktrees** (if any):
-None active
-
-**Branches** (recent):
-- dev/003-auth (current) ← 5 commits ahead
-- main (up to date)
-- dev/002-blog (merged, can cleanup)
-```
-
-**Benefits**:
-- Visual understanding at a glance
-- Clear action items
-- Worktree awareness
-- Branch cleanup suggestions
-
----
-
-### `/cleanup` - Git Cleanup (Coming Soon)
-
-**Purpose**: Clean up merged branches, stale worktrees, and old features.
-
-**What it will do**:
-1. Detect merged branches (local and remote)
-2. Find stale worktrees
-3. Identify old feature directories in `specs/`
-4. Suggest safe cleanup actions
-5. Execute cleanup with confirmation
-
-**Example usage** (planned):
-```
-/cleanup
-
-## Git Cleanup
-
-**Merged branches** (safe to delete):
-- dev/001-init (merged 2 weeks ago)
-- dev/002-blog (merged 1 week ago)
-- feature/old-experiment (merged 3 months ago)
-
-**Stale worktrees**:
-- ../blog-backend (branch merged, worktree orphaned)
-
-**Old feature specs**:
-- specs/001-init/ (merged, archived?)
-
-**Cleanup plan**:
-1. Delete 3 merged local branches
-2. Delete 2 merged remote branches
-3. Remove 1 stale worktree
-4. Suggest archiving specs/001-init/
-
-**Disk space freed**: ~45 MB
-
-**Proceed?** (y/n): y
-
-✓ Deleted branch dev/001-init
-✓ Deleted branch dev/002-blog
-✓ Deleted branch feature/old-experiment
-✓ Deleted remote branch origin/dev/001-init
-✓ Removed stale worktree ../blog-backend
-⚠ Manual action: Archive specs/001-init/ to specs/.archive/
-
-**Cleanup complete!**
-```
-
----
-
-## ASCII Visualization Examples
-
-Git-kit emphasizes visual output because AI agents are good at generating ASCII art and it makes git status much easier to understand.
-
-### Branch Relationships
-```
-main ──────────┬──────────> origin/main (synced)
-               │
-               ├─ develop ──> origin/develop (2 ahead, 1 behind)
-               │              ↕ PULL & PUSH NEEDED
-               │  │
-               │  ├─ dev/001-kits (current, 3 ahead)
-               │  │  ↑ PUSH NEEDED
-               │  │
-               │  └─ dev/002-examples (merged)
-               │     🗑 CAN DELETE
-               │
-               └─ hotfix/security (1 ahead)
-                  ⚠ URGENT PUSH
-```
-
-### Commit Graph
-```
-Commits ahead of main:
-
-  * e5f6g7h (HEAD) fix: Resolve merge conflict
-  │
-  * d4e5f6g docs: Update README
-  │
-  * c3d4e5f test: Add auth tests
-  │
-  * b2c3d4e feat: Add User model
-  │
-  * a1b2c3d feat: Add auth system
-  │
-  o ─────── (origin/main)
-```
-
----
-
-## Use Cases
-
-### Daily Development
-**Use**: `/commit` for every commit, `/sync` multiple times per day
-
-### Before Creating PR
-**Use**: `/sync` to ensure up to date, `/pr` to create pull request
-
-### Weekly Maintenance
-**Use**: `/cleanup` to remove merged branches and free up space
-
-### Multi-Agent Projects
-**Combine with**: multiagent-kit for coordination
-**Use**: `/sync` shows worktree status for parallel development
-
----
-
-## Dependencies
-
-**None** - git-kit is standalone.
-
-**Requires**: Git 2.0+, optionally `gh` CLI for `/pr` command
-
-**Recommended with**: multiagent-kit (for worktree visualization)
-
----
-
-## Compatibility
-
-- ✅ **Agents**: Claude Code, GitHub Copilot
-- ✅ **Platforms**: Linux, macOS, Windows
-- ✅ **Shells**: Bash, PowerShell (ASCII works in both!)
-- ✅ **Vanilla safe**: Only adds new files, never modifies existing
-
----
-
-## Uninstall
-
-```bash
-lite-kits remove -Kit git
-```
-
-Removes:
-- `.claude/commands/{commit,pr,sync,cleanup}.md`
-- `.github/prompts/{commit,pr,sync,cleanup}.prompt.md`
-
----
-
-## Future Enhancements
-
-Considering for git-kit:
-- `/rebase` - Interactive rebase helper
-- `/stash` - Stash management with visualization
-- `/blame` - Enhanced git blame with agent attribution
-- `/conflicts` - Merge conflict resolver helper
-- `/bisect` - Git bisect helper for finding bugs
-
-Suggest more in [GitHub Discussions](https://github.com/tmorgan181/spec-kit-multiagent-lite/discussions).

lite_kits/kits/git/scripts/bash/get-git-context.sh

@@ -1,208 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# get-git-context.sh
-# Gathers comprehensive git repository context for AI agents
-
-show_help() {
-    cat << EOF
-Usage: get-git-context.sh [OPTIONS]
-
-Gathers git status, branch information, recent commits, and change statistics
-in a structured format suitable for AI agent orientation and commit workflows.
-
-OPTIONS:
-    -c, --commits NUM     Number of recent commits to include (default: 5)
-    -f, --format FORMAT   Output format: text, json (default: text)
-    -n, --no-diff         Exclude diff statistics
-    -h, --help            Show this help message
-
-EXAMPLES:
-    get-git-context.sh
-    get-git-context.sh --commits 10
-    get-git-context.sh --format json
-EOF
-}
-
-# Default options
-INCLUDE_COMMITS=5
-FORMAT="text"
-INCLUDE_DIFF=true
-
-# Parse arguments
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        -c|--commits)
-            INCLUDE_COMMITS="$2"
-            shift 2
-            ;;
-        -f|--format)
-            FORMAT="$2"
-            shift 2
-            ;;
-        -n|--no-diff)
-            INCLUDE_DIFF=false
-            shift
-            ;;
-        -h|--help)
-            show_help
-            exit 0
-            ;;
-        *)
-            echo "Unknown option: $1"
-            show_help
-            exit 1
-            ;;
-    esac
-done
-
-# Check if we're in a git repository
-if ! git rev-parse --git-dir >/dev/null 2>&1; then
-    echo "Error: Not a git repository" >&2
-    exit 1
-fi
-
-# Gather git context
-BRANCH=$(git branch --show-current)
-COMMIT_HASH=$(git rev-parse --short HEAD 2>/dev/null || echo "")
-
-# Count file statuses
-STAGED_COUNT=0
-UNSTAGED_COUNT=0
-UNTRACKED_COUNT=0
-
-while IFS= read -r line; do
-    if [[ -n "$line" ]]; then
-        STATUS="${line:0:2}"
-
-        # Staged files (first character)
-        if [[ "${STATUS:0:1}" =~ [MADRC] ]]; then
-            ((STAGED_COUNT++))
-        fi
-
-        # Unstaged files (second character)
-        if [[ "${STATUS:1:1}" =~ [MD] ]]; then
-            ((UNSTAGED_COUNT++))
-        fi
-
-        # Untracked files
-        if [[ "$STATUS" == "??" ]]; then
-            ((UNTRACKED_COUNT++))
-        fi
-    fi
-done < <(git status --porcelain)
-
-# Get remote tracking info
-TRACKING=$(git rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>/dev/null || echo "")
-AHEAD=0
-BEHIND=0
-
-if [[ -n "$TRACKING" ]]; then
-    # Get ahead/behind counts
-    AHEAD_BEHIND=$(git rev-list --left-right --count "$TRACKING"..HEAD 2>/dev/null || echo "0 0")
-    AHEAD=$(echo "$AHEAD_BEHIND" | awk '{print $1}')
-    BEHIND=$(echo "$AHEAD_BEHIND" | awk '{print $2}')
-fi
-
-# Get remote URL
-REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "")
-
-# Get diff statistics
-INSERTIONS=0
-DELETIONS=0
-FILES_CHANGED=0
-
-if [[ "$INCLUDE_DIFF" == true ]] && [[ $STAGED_COUNT -gt 0 ]]; then
-    while IFS= read -r line; do
-        if [[ -n "$line" ]]; then
-            INS=$(echo "$line" | awk '{print $1}')
-            DEL=$(echo "$line" | awk '{print $2}')
-
-            # Handle binary files (-)
-            [[ "$INS" != "-" ]] && INSERTIONS=$((INSERTIONS + INS))
-            [[ "$DEL" != "-" ]] && DELETIONS=$((DELETIONS + DEL))
-            ((FILES_CHANGED++))
-        fi
-    done < <(git diff --cached --numstat)
-fi
-
-# Output based on format
-if [[ "$FORMAT" == "json" ]]; then
-    # JSON output
-    cat << EOF
-{
-  "branch": "$BRANCH",
-  "commitHash": "$COMMIT_HASH",
-  "status": {
-    "counts": {
-      "staged": $STAGED_COUNT,
-      "unstaged": $UNSTAGED_COUNT,
-      "untracked": $UNTRACKED_COUNT
-    }
-  },
-  "remote": {
-    "tracking": "$TRACKING",
-    "url": "$REMOTE_URL",
-    "ahead": $AHEAD,
-    "behind": $BEHIND
-  },
-  "stats": {
-    "filesChanged": $FILES_CHANGED,
-    "insertions": $INSERTIONS,
-    "deletions": $DELETIONS
-  }
-}
-EOF
-else
-    # Text output
-    echo "==============================================================="
-    echo "📊 Git Status (on: $BRANCH):"
-    echo "==============================================================="
-    echo "Staged:    $STAGED_COUNT files"
-    echo "Unstaged:  $UNSTAGED_COUNT files"
-    echo "Untracked: $UNTRACKED_COUNT files"
-
-    if [[ -n "$TRACKING" ]]; then
-        echo ""
-        echo "Remote: $TRACKING"
-        if [[ $AHEAD -gt 0 ]]; then
-            echo "  Ahead by $AHEAD commit(s)"
-        fi
-        if [[ $BEHIND -gt 0 ]]; then
-            echo "  Behind by $BEHIND commit(s)"
-        fi
-    fi
-
-    if [[ $STAGED_COUNT -gt 0 ]]; then
-        echo ""
-        echo "Staged files:"
-        git status --porcelain | grep '^[MADRC]' | while IFS= read -r line; do
-            echo "  ${line:0:2} ${line:3}"
-        done
-    fi
-
-    if [[ $UNSTAGED_COUNT -gt 0 ]]; then
-        echo ""
-        echo "Unstaged files:"
-        git status --porcelain | grep '^ [MD]' | while IFS= read -r line; do
-            echo "  ${line:0:2} ${line:3}"
-        done
-    fi
-
-    if [[ $UNTRACKED_COUNT -gt 0 ]]; then
-        echo ""
-        echo "Untracked files:"
-        git status --porcelain | grep '^??' | while IFS= read -r line; do
-            echo "  ${line:0:2} ${line:3}"
-        done
-    fi
-
-    if [[ $INCLUDE_COMMITS -gt 0 ]]; then
-        echo ""
-        echo "Recent commits:"
-        git log -n "$INCLUDE_COMMITS" --pretty=format:'  %h %s (%ar)' --abbrev-commit
-        echo ""
-    fi
-
-    echo "==============================================================="
-fi