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

lite_kits/kits/git/claude/commands/cleanup.md

@@ -1,361 +0,0 @@
----
-description: Clean up merged branches
----
-
-# Branch Cleanup
-
-**Purpose**: Safely delete local branches that have been merged, keeping your workspace clean.
-
-## Usage
-
-```bash
-/cleanup                    # Clean up local branches only
-/cleanup --remote           # Also delete from remote
-/cleanup --include-current  # Include current branch if PR merged
-```
-
-## Prerequisites
-
-- Git repository
-- On a safe branch (not the branch you want to delete, unless using --include-current)
-
-## Execution Steps
-
-### 1. Get Current Branch and Base Branch
-
-```bash
-# Get current branch
-CURRENT_BRANCH=$(git branch --show-current)
-
-# Determine base branch (develop or main)
-for base in develop main master; do
-  if git show-ref --verify --quiet refs/heads/$base; then
-    BASE_BRANCH=$base
-    break
-  fi
-done
-
-echo "Current branch: $CURRENT_BRANCH"
-echo "Base branch: $BASE_BRANCH"
-```
-
-### 1a. Check if Current Branch Should Be Included
-
-**If `--include-current` flag is present OR current branch is merged with no uncommitted work**:
-
-```bash
-# Check if current branch is merged into base
-if git merge-base --is-ancestor HEAD origin/$BASE_BRANCH 2>/dev/null; then
-  # Check if there are any commits ahead of base
-  COMMITS_AHEAD=$(git rev-list --count origin/$BASE_BRANCH..HEAD)
-
-  if [ $COMMITS_AHEAD -eq 0 ]; then
-    # PR was merged, current branch is fully in base
-    echo "✓ Current branch PR appears to be merged (no commits ahead of $BASE_BRANCH)"
-
-    # Check for uncommitted changes
-    if git diff-index --quiet HEAD --; then
-      INCLUDE_CURRENT=true
-      echo "⚠️  Current branch can be deleted (will switch to $BASE_BRANCH first)"
-    else
-      echo "⚠️  Current branch has uncommitted changes - won't auto-delete"
-      INCLUDE_CURRENT=false
-    fi
-  fi
-fi
-```
-
-**If current branch should be included**:
-```
-⚠️  Your current branch (dev/004-cleanup-command) appears to be merged!
-
-The PR has been merged into develop with no additional commits.
-
-Include current branch in cleanup?
-  - Will switch to develop first
-  - Then delete dev/004-cleanup-command
-
-Include? (y/n): _____
-```
-
-**Safety check**:
-```
-⚠️  Currently on: dev/004-cleanup-command
-
-Cleanup will check branches merged into: develop
-
-Continue? (y/n): _____
-```
-
-### 2. Find Merged Branches
-
-```bash
-# Get all merged branches (excluding current, base, and protected branches)
-git branch --merged $BASE_BRANCH | \
-  grep -v "^\*" | \
-  grep -v "$BASE_BRANCH" | \
-  grep -v "main" | \
-  grep -v "master" | \
-  grep -v "develop"
-```
-
-**If no merged branches found**:
-```
-✓ No merged branches to clean up.
-
-All branches are either:
-  - Currently active
-  - Protected (main/develop/master)
-  - Unmerged
-
-Workspace is clean!
-```
-
-**If merged branches found**, analyze each:
-```bash
-# For each merged branch, get last commit info
-for branch in $MERGED_BRANCHES; do
-  LAST_COMMIT=$(git log -1 --format="%ar by %an" $branch)
-  LAST_HASH=$(git log -1 --format="%h" $branch)
-  echo "$branch | $LAST_HASH | $LAST_COMMIT"
-done
-```
-
-### 3. Present Branches for Cleanup
-
-Show branches in a code block with clear formatting:
-
-```
-**🧹 Merged Branches Available for Cleanup:**
-
-**Base branch:** develop
-
-**Merged branches:**
-
-1. dev/001-starter-kits
-   Last commit: 5b1ad35 (2 days ago by tmorgan181)
-
-2. dev/002-installer-polish
-   Last commit: 9cd3690 (1 day ago by tmorgan181)
-
-3. feature/old-experiment
-   Last commit: abc1234 (2 weeks ago by tmorgan181)
-
-**Protected branches** (will NOT be deleted):
-  - develop
-  - main
-  - dev/004-cleanup-command (current)
-
-===========================================================
-```
-
-**Ask for confirmation**:
-- **y** - Delete all listed branches
-- **n** - Cancel cleanup
-- **e** - Select specific branches (reply with numbers: e.g., "1 3")
-
-### 4. Execute Cleanup
-
-**If current branch should be deleted, switch first**:
-```bash
-if [ "$INCLUDE_CURRENT" = true ]; then
-  echo "Switching to $BASE_BRANCH..."
-  git checkout $BASE_BRANCH
-  git pull origin $BASE_BRANCH
-
-  # Add current branch to cleanup list
-  MERGED_BRANCHES="$MERGED_BRANCHES
-$CURRENT_BRANCH"
-fi
-```
-
-**If user selects specific branches (e.g., "1 3")**:
-```bash
-# Parse selection
-SELECTED="1 3"
-
-# Delete selected branches
-for num in $SELECTED; do
-  # Get branch name from list
-  BRANCH=$(echo "$MERGED_BRANCHES" | sed -n "${num}p")
-
-  # Delete local branch
-  git branch -d $BRANCH
-
-  if [ $? -eq 0 ]; then
-    echo "✓ Deleted local: $BRANCH"
-
-    # If --remote flag, also delete from remote
-    if [ "$DELETE_REMOTE" = true ]; then
-      if git ls-remote --heads origin $BRANCH | grep -q $BRANCH; then
-        git push origin --delete $BRANCH
-        if [ $? -eq 0 ]; then
-          echo "✓ Deleted remote: $BRANCH"
-        else
-          echo "✗ Failed to delete remote: $BRANCH"
-        fi
-      fi
-    fi
-  else
-    echo "✗ Failed to delete: $BRANCH"
-  fi
-done
-```
-
-**If user confirms all (y)**:
-```bash
-# Delete all merged branches
-for branch in $MERGED_BRANCHES; do
-  # Delete local branch
-  git branch -d $branch
-
-  if [ $? -eq 0 ]; then
-    echo "✓ Deleted local: $branch"
-
-    # If --remote flag, also delete from remote
-    if [ "$DELETE_REMOTE" = true ]; then
-      if git ls-remote --heads origin $branch | grep -q $branch; then
-        git push origin --delete $branch
-        if [ $? -eq 0 ]; then
-          echo "✓ Deleted remote: $branch"
-        else
-          echo "✗ Failed to delete remote: $branch"
-        fi
-      fi
-    fi
-  else
-    echo "✗ Failed to delete: $branch"
-  fi
-done
-```
-
-### 5. Show Summary
-
-After cleanup, show what was done:
-
-```
-===========================================================
-✓ Cleanup Complete
-===========================================================
-
-**Deleted branches:**
-  ✓ dev/001-starter-kits
-  ✓ dev/002-installer-polish
-
-**Kept branches:**
-  - develop (protected)
-  - main (protected)
-  - dev/004-cleanup-command (current)
-  - feature/in-progress (unmerged)
-
-**Workspace status:**
-  - 2 branches deleted
-  - 4 branches remaining
-
-===========================================================
-```
-
-## Important Notes
-
-**Safety Features**:
-- Never deletes current branch (unless `--include-current` and PR is merged)
-- Never deletes base branches (main, develop, master)
-- Only deletes branches that are fully merged
-- Uses `git branch -d` (safe delete, will fail if unmerged changes)
-- Always asks for confirmation before deletion
-- Remote deletion is opt-in with `--remote` flag
-
-**Protected Branches** (never deleted automatically):
-- Current branch (unless `--include-current` and PR merged with no new commits)
-- `main`, `master`, `develop` (common base branches)
-- Any branch that hasn't been merged
-
-**Flags**:
-- `--remote`: Also delete branches from remote repository
-- `--include-current`: Allow deletion of current branch if PR is merged
-
-**Error Handling**:
-```bash
-# If branch has unmerged changes
-if git branch -d $branch 2>&1 | grep -q "not fully merged"; then
-  echo "⚠️  Branch '$branch' has unmerged changes"
-  echo "   Use 'git branch -D $branch' to force delete (destructive!)"
-  echo "   Skipping..."
-fi
-```
-
-## Example Workflow
-
-```bash
-# User: /cleanup
-
-# Agent checks current state
-$ git branch --show-current
-dev/004-cleanup-command
-
-# Agent finds merged branches
-$ git branch --merged develop
-  dev/001-starter-kits
-  dev/002-installer-polish
-  dev/003-git-kit-enhancements
-
-# Agent presents options
-Merged branches available for cleanup:
-1. dev/001-starter-kits (2 days ago)
-2. dev/002-installer-polish (1 day ago)
-3. dev/003-git-kit-enhancements (2 hours ago)
-
-Delete which branches? (y/n/e): e
-
-# User selects
-Selection: 1 2
-
-# Agent deletes
-$ git branch -d dev/001-starter-kits
-Deleted branch dev/001-starter-kits (was 5b1ad35)
-
-$ git branch -d dev/002-installer-polish
-Deleted branch dev/002-installer-polish (was 9cd3690)
-
-✓ Cleanup complete: 2 branches deleted
-```
-
-## Multi-Agent Considerations
-
-When working with multiple agents:
-
-1. **Check collaboration status** (if multiagent-kit installed):
-   ```bash
-   # Don't delete branches with active collaboration
-   if [ -d "specs/*/collaboration/active" ]; then
-     # Check for active sessions on branches
-     echo "⚠️  Multi-agent project detected"
-     echo "   Checking for active collaboration..."
-   fi
-   ```
-
-2. **Warn about shared branches**:
-   ```
-   ⚠️  Branch 'feature/shared' may be used by other agents.
-
-   Check collaboration status before deleting.
-   Safe to delete? (y/n): _____
-   ```
-
-3. **Preserve handoff branches**:
-   - Branches with recent handoff documents shouldn't be auto-deleted
-   - Warn user if collaboration files exist
-
-## When NOT to Use
-
-**Don't use /cleanup for**:
-- Deleting unmerged branches (use `git branch -D` manually with caution)
-- Deleting remote branches (use `git push origin --delete`)
-- Deleting branches with uncommitted work (stash or commit first)
-- Cleaning up worktrees (that's a multiagent-kit feature)
-
-**Use /cleanup for**:
-- ✅ Removing local branches after PR merge
-- ✅ Cleaning up old feature branches
-- ✅ Keeping workspace tidy
-- ✅ Safe, confirmed deletions only

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