lite-kits 0.1.0__py3-none-any.whl

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

@@ -0,0 +1,208 @@
+#!/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

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

@@ -0,0 +1,242 @@
+#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
+    }
+}