claude-mods/skills/git-ops/scripts/status.sh

#!/bin/bash
# git-status - one-shot read-only repo overview
#
# Usage:
#   bash status.sh             # survey current directory
#   bash status.sh <repo-path> # survey explicit path
#
# Exit codes:
#   0  CLEAN (nothing ahead/behind, tree empty, no stashes)
#   1  NON-CLEAN (at least one signal non-zero)
#   2  Not a git repo

set -u

REPO="${1:-$PWD}"

# Guard: must be inside a git repo
if ! git -C "$REPO" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
  echo "not-a-repo: $REPO"
  exit 2
fi

REPO_ROOT=$(git -C "$REPO" rev-parse --show-toplevel)
cd "$REPO_ROOT" || { echo "cannot-cd: $REPO_ROOT"; exit 2; }

# Best-effort fetch — record failure but don't abort
FETCH_OK=true
git fetch --quiet 2>/dev/null || FETCH_OK=false

# Age of last successful fetch (mtime of FETCH_HEAD)
fetch_age=-1
if [ -f .git/FETCH_HEAD ]; then
  if fetch_mtime=$(stat -c '%Y' .git/FETCH_HEAD 2>/dev/null); then
    :
  elif fetch_mtime=$(stat -f '%m' .git/FETCH_HEAD 2>/dev/null); then
    :
  else
    fetch_mtime=""
  fi
  if [ -n "$fetch_mtime" ]; then
    fetch_age=$(( $(date +%s) - fetch_mtime ))
  fi
fi

# Branch / HEAD
BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null || echo "(detached)")
HEAD_INFO=$(git log -1 --format='%h %s (%ar)' 2>/dev/null || echo "(no commits)")

# Sync with upstream (if configured)
AHEAD=0
BEHIND=0
if [ "$BRANCH" != "(detached)" ] && git rev-parse '@{u}' >/dev/null 2>&1; then
  AHEAD=$(git rev-list --count '@{u}..HEAD' 2>/dev/null || echo 0)
  BEHIND=$(git rev-list --count 'HEAD..@{u}' 2>/dev/null || echo 0)
  SYNC_LINE="$AHEAD ahead / $BEHIND behind"
else
  SYNC_LINE="no upstream"
fi

# Working tree
STAGED=$(git diff --cached --name-only | wc -l | tr -d ' ')
UNSTAGED=$(git diff --name-only | wc -l | tr -d ' ')
UNTRACKED=$(git ls-files --others --exclude-standard | wc -l | tr -d ' ')
STASHES=$(git stash list | wc -l | tr -d ' ')

# Shortstat if there's uncommitted change
SHORTSTAT=""
if [ "$STAGED" -gt 0 ] || [ "$UNSTAGED" -gt 0 ]; then
  SHORTSTAT=$(git diff HEAD --shortstat 2>/dev/null \
    | sed 's/^ *//' \
    | sed -E 's/([0-9]+) files? changed, //' \
    | sed -E 's/([0-9]+) insertions?\(\+\)/+\1/' \
    | sed -E 's/([0-9]+) deletions?\(-\)/-\1/' \
    | tr -d '()')
fi

# Worktrees — registered vs filesystem
WT_REGISTERED=$(git worktree list 2>/dev/null | wc -l | tr -d ' ')
WT_FS=0
if [ -d .claude/worktrees ]; then
  WT_FS=$(find .claude/worktrees -maxdepth 1 -mindepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
fi

# Branches
BR_LOCAL=$(git branch 2>/dev/null | wc -l | tr -d ' ')
BR_REMOTE=$(git branch -r 2>/dev/null | wc -l | tr -d ' ')

# Optional PR linkage (graceful if gh absent or no PR)
PR_LINE=""
if command -v gh >/dev/null 2>&1 && [ "$BRANCH" != "(detached)" ]; then
  PR_JSON=$(gh pr view --json number,url,state 2>/dev/null || true)
  if [ -n "$PR_JSON" ] && command -v jq >/dev/null 2>&1; then
    PR_LINE=$(printf '%s' "$PR_JSON" \
      | jq -r 'if .number then "PR #\(.number): \(.url) [\(.state)]" else empty end' 2>/dev/null)
  fi
fi

# --- Output -----------------------------------------------------------------
echo "repo:    $REPO_ROOT"
echo "branch:  $BRANCH"
echo "HEAD:    $HEAD_INFO"
echo "sync:    $SYNC_LINE"

TREE_LINE="$STAGED staged / $UNSTAGED unstaged / $UNTRACKED untracked / $STASHES stashes"
if [ -n "$SHORTSTAT" ]; then
  TREE_LINE="$TREE_LINE ($SHORTSTAT)"
fi
echo "tree:    $TREE_LINE"

# Only show worktrees line if there are multiple registered OR .claude/worktrees exists
if [ "$WT_REGISTERED" -gt 1 ] || [ "$WT_FS" -gt 0 ]; then
  echo "trees:   $WT_REGISTERED registered / $WT_FS in .claude/worktrees"
fi

echo "branch:  $BR_LOCAL local / $BR_REMOTE remote"

if [ -n "$PR_LINE" ]; then
  echo "pr:      $PR_LINE"
fi

# Fetch failure warning
if [ "$FETCH_OK" = false ]; then
  if [ "$fetch_age" -ge 0 ]; then
    if   [ "$fetch_age" -gt 86400 ]; then age_display="$((fetch_age / 86400))d ago"
    elif [ "$fetch_age" -gt 3600  ]; then age_display="$((fetch_age / 3600))h ago"
    elif [ "$fetch_age" -gt 60    ]; then age_display="$((fetch_age / 60))m ago"
    else age_display="${fetch_age}s ago"
    fi
  else
    age_display="unknown"
  fi
  echo "fetch:   FAILED (last successful: $age_display)"
fi

# --- Verdict ----------------------------------------------------------------
echo ""
if [ "$AHEAD" -eq 0 ] && [ "$BEHIND" -eq 0 ] && \
   [ "$STAGED" -eq 0 ] && [ "$UNSTAGED" -eq 0 ] && \
   [ "$UNTRACKED" -eq 0 ] && [ "$STASHES" -eq 0 ]; then
  echo "verdict: CLEAN"
  exit 0
fi

FLAGS=""
[ "$AHEAD"     -gt 0 ] && FLAGS="$FLAGS ahead"
[ "$BEHIND"    -gt 0 ] && FLAGS="$FLAGS behind"
[ "$STAGED"    -gt 0 ] && FLAGS="$FLAGS staged"
[ "$UNSTAGED"  -gt 0 ] && FLAGS="$FLAGS unstaged"
[ "$UNTRACKED" -gt 0 ] && FLAGS="$FLAGS untracked"
[ "$STASHES"   -gt 0 ] && FLAGS="$FLAGS stashes"
echo "verdict: NON-CLEAN —${FLAGS}"
exit 1