groundhog

#!/bin/bash
# 🐿️ Groundhog Day — same thing, every time.
# Auto-syncs ~/.copilot/skills/ → DUBSOpenHub/copilot-skills
#
# Modes:
#   groundhog              — one-shot sync
#   groundhog watch        — real-time file watcher (runs forever)
#   groundhog status       — health check
#
# Runs as macOS LaunchAgent: com.dubsopenhub.groundhog

set -euo pipefail

REPO="$HOME/dev/copilot-skills"
SKILLS="$HOME/.copilot/skills"
LOG="$HOME/.groundhog.log"
LOCKFILE="/tmp/groundhog.lock"
DEBOUNCE_SECS=5
MAX_LOG_BYTES=1048576  # 1MB

# ── Logging ────────────────────────────────────────────────────────────────
log() { echo "$(date): $*" >> "$LOG"; }

rotate_log() {
  if [[ -f "$LOG" ]]; then
    local size
    size=$(stat -f%z "$LOG" 2>/dev/null || echo 0)
    if [[ "$size" -gt "$MAX_LOG_BYTES" ]]; then
      mv "$LOG" "${LOG}.old"
      log "log rotated (was ${size} bytes)"
    fi
  fi
}

# ── Repo health ────────────────────────────────────────────────────────────
validate_repo() {
  cd "$REPO" || { log "FATAL: repo dir $REPO missing"; return 1; }
  git rev-parse --is-inside-work-tree >/dev/null 2>&1 || { log "FATAL: not a git repo"; return 1; }
  if [[ -d .git/rebase-merge ]] || [[ -d .git/rebase-apply ]]; then
    log "FATAL: repo in rebase state — manual fix needed"; return 1
  fi
  if ! git diff --quiet 2>/dev/null; then
    log "WARN: dirty working tree, resetting"
    git checkout -- . 2>>"$LOG"
  fi
  return 0
}

validate_skills() {
  [[ -d "$SKILLS" ]] || { log "ERROR: skills dir $SKILLS missing"; return 1; }
  local count
  count=$(find "$SKILLS" -name 'SKILL.md' 2>/dev/null | wc -l | tr -d ' ')
  [[ "$count" -gt 0 ]] || { log "WARN: no skills found, skipping sync"; return 1; }
  return 0
}

# ── Push with retry ────────────────────────────────────────────────────────
push_with_retry() {
  local attempts=3
  for i in $(seq 1 $attempts); do
    git push >>"$LOG" 2>&1 && return 0
    log "push attempt $i/$attempts failed"
    sleep $((2 ** i))
  done
  osascript -e 'display notification "Git push failed after 3 attempts" with title "🐿️ Groundhog Day"' 2>/dev/null || true
  return 1
}

# ── Sync lock ──────────────────────────────────────────────────────────────
acquire_lock() { mkdir "$LOCKFILE" 2>/dev/null; }
release_lock() { rmdir "$LOCKFILE" 2>/dev/null || true; }

# ── Core sync ──────────────────────────────────────────────────────────────
do_sync() {
  rotate_log
  validate_skills || return 0
  validate_repo || return 1

  cd "$REPO" || return 1

  rsync -a --delete \
    --exclude='.git' --exclude='README.md' \
    --exclude='.DS_Store' --exclude='__pycache__' \
    --exclude='node_modules' --exclude='.env' \
    "$SKILLS"/ "$REPO"/ 2>>"$LOG"

  generate_readme

  git add -A
  if ! git diff --cached --quiet; then
    local msg
    msg="sync skills $(date +%Y-%m-%d-%H%M)"

    local new_skills
    new_skills=$(git diff --cached --name-only --diff-filter=A | grep 'SKILL.md' | sed 's|/SKILL.md||' | sort -u || true)
    if [ -n "$new_skills" ]; then
      msg="add skill: $(echo "$new_skills" | tr '\n' ', ' | sed 's/,$//')"
    fi

    git commit -m "$msg" >>"$LOG" 2>&1

    git pull --rebase --quiet >>"$LOG" 2>&1 || {
      log "ERROR: pull --rebase failed, manual fix needed"
      return 1
    }

    push_with_retry
    log "🐿️  synced — $msg"
    echo "🐿️  Groundhog Day synced: $msg"
  fi
}

do_sync_locked() {
  if ! acquire_lock; then
    # Clear stale locks older than 5 minutes
    local lock_age
    lock_age=$(( $(date +%s) - $(stat -f%m "$LOCKFILE" 2>/dev/null || echo "0") ))
    if [[ "$lock_age" -gt 300 ]]; then
      log "WARN: clearing stale lock (${lock_age}s old)"
      release_lock
      acquire_lock || return 0
    else
      return 0
    fi
  fi
  trap 'release_lock' RETURN
  do_sync
}

# ── README generation ──────────────────────────────────────────────────────
generate_readme() {
  cd "$REPO" || return

  cat > README.md << 'HEADER'
# Copilot CLI Skills

A collection of skills for [GitHub Copilot CLI](https://docs.github.com/copilot/concepts/agents/about-copilot-cli) that extend the agent with specialized workflows.

## Skills

| Skill | Description |
|-------|-------------|
HEADER

  python3 - "$REPO" >> README.md 2>/dev/null << 'PYSCRIPT'
import re, sys, os
repo = sys.argv[1]
for name in sorted(os.listdir(repo)):
    sf = os.path.join(repo, name, "SKILL.md")
    if not os.path.isfile(sf):
        continue
    text = open(sf).read()
    m = re.search(r'description:\s*>\s*\n((?:\s+.*\n)*)', text)
    if m:
        desc = ' '.join(m.group(1).strip().split())
    else:
        m = re.search(r'description:\s*(.*)', text)
        desc = m.group(1).strip().strip('"') if m else '\u2014'
    if len(desc) > 120:
        desc = desc[:117] + '...'
    print(f'| [{name}]({name}/) | {desc} |')
PYSCRIPT

  cat >> README.md << 'FOOTER'

## Install

### Install all skills

```bash
git clone https://github.com/DUBSOpenHub/copilot-skills.git /tmp/copilot-skills
cp -R /tmp/copilot-skills/*/ ~/.copilot/skills/
```

### Install a single skill

```bash
git clone --depth 1 https://github.com/DUBSOpenHub/copilot-skills.git /tmp/copilot-skills
cp -R /tmp/copilot-skills/pitch-master ~/.copilot/skills/
```

After installing, restart your Copilot CLI session (`/exit` then `copilot`) to pick up the new skills. Use `/skills` to verify they loaded.

## How skills work

Each skill is a folder containing a `SKILL.md` file with YAML frontmatter (name, description) and markdown prompt instructions. Copilot CLI loads skills from `~/.copilot/skills/` on startup.

## License

MIT
FOOTER
}

# ── Watch mode ─────────────────────────────────────────────────────────────
watch_mode() {
  trap 'log "🐿️  shutting down"; kill 0; exit 0' SIGTERM SIGINT

  echo "🐿️  Groundhog Day is watching... same thing, every time."
  log "🐿️  watcher started (PID $$)"

  fswatch -r -l "$DEBOUNCE_SECS" \
    --event Created --event Updated --event Removed --event Renamed \
    "$SKILLS" | while read -r _event; do
      # Brief pause to let batched events settle
      sleep 1
      log "🐿️  change detected"
      do_sync_locked
    done
}

# ── Status ─────────────────────────────────────────────────────────────────
cmd_status() {
  if launchctl list 2>&1 | grep -q "com.dubsopenhub.groundhog"; then
    echo "🐿️  Groundhog Day: ✅ Running"
  elif pgrep -f "groundhog watch" >/dev/null 2>&1; then
    echo "🐿️  Groundhog Day: ✅ Running (manual)"
  else
    echo "🐿️  Groundhog Day: ❌ Not running"
  fi
  echo ""
  if [[ -f "$LOG" ]]; then
    echo "Last 5 log entries:"
    tail -5 "$LOG"
  else
    echo "No log file found."
  fi
}

# ── Nightly checkup ───────────────────────────────────────────────────────
cmd_checkup() {
  local issues=0
  local report=""
  local CHECKUP_LOG="$HOME/.groundhog-checkup.log"

  report+="🐿️  Groundhog Day — Nightly Checkup\n"
  report+="$(date)\n"
  report+="────────────────────────────────────\n\n"

  # 1. Process health
  if pgrep -f "groundhog watch" >/dev/null 2>&1; then
    report+="✅ Watcher process: running\n"
  else
    report+="❌ Watcher process: NOT RUNNING\n"
    issues=$((issues + 1))
  fi

  # 2. LaunchAgent registered
  if launchctl list 2>/dev/null | grep -q "com.dubsopenhub.groundhog" 2>/dev/null; then
    report+="✅ LaunchAgent: loaded\n"
  elif pgrep -f "groundhog watch" >/dev/null 2>&1; then
    report+="✅ LaunchAgent: running (manual)\n"
  else
    report+="❌ LaunchAgent: not loaded\n"
    issues=$((issues + 1))
  fi

  # 3. Skills directory exists and has skills
  if [[ -d "$SKILLS" ]]; then
    local skill_count
    skill_count=$(find "$SKILLS" -name 'SKILL.md' 2>/dev/null | wc -l | tr -d ' ')
    report+="✅ Skills directory: $skill_count skills found\n"
  else
    report+="❌ Skills directory: MISSING ($SKILLS)\n"
    issues=$((issues + 1))
  fi

  # 4. Repo state
  if [[ -d "$REPO/.git" ]]; then
    cd "$REPO"
    if git diff --quiet 2>/dev/null && git diff --cached --quiet 2>/dev/null; then
      report+="✅ Repo state: clean\n"
    else
      report+="⚠️  Repo state: dirty (uncommitted changes)\n"
      issues=$((issues + 1))
    fi

    # Check if local is ahead of remote
    git fetch --quiet 2>/dev/null || true
    local ahead
    ahead=$(git rev-list --count origin/main..HEAD 2>/dev/null || echo "0")
    if [[ "$ahead" -gt 0 ]]; then
      report+="⚠️  Unpushed commits: $ahead\n"
      issues=$((issues + 1))
    else
      report+="✅ Remote: in sync\n"
    fi

    # Check for rebase state
    if [[ -d .git/rebase-merge ]] || [[ -d .git/rebase-apply ]]; then
      report+="❌ Repo: stuck in rebase\n"
      issues=$((issues + 1))
    fi
  else
    report+="❌ Repo: MISSING ($REPO)\n"
    issues=$((issues + 1))
  fi

  # 5. Recent push failures (last 7 days only)
  if [[ -f "$LOG" ]]; then
    local recent_failures=0
    local cutoff_epoch
    cutoff_epoch=$(date -v-7d +%s 2>/dev/null || date -d '7 days ago' +%s 2>/dev/null || echo "0")
    local line
    while IFS= read -r line; do
      # Log format: "Wed Mar 11 19:13:33 PDT 2026: ..."
      local line_date
      line_date=$(echo "$line" | sed 's/: .*//' | head -1)
      local line_epoch
      line_epoch=$(date -j -f "%a %b %d %T %Z %Y" "$line_date" +%s 2>/dev/null || echo "0")
      if [[ "$line_epoch" -ge "$cutoff_epoch" ]]; then
        recent_failures=$((recent_failures + 1))
      fi
    done < <(grep "push.*failed\|ERROR\|FATAL" "$LOG" 2>/dev/null || true)
    if [[ "$recent_failures" -gt 0 ]]; then
      report+="⚠️  Log errors (7d): $recent_failures found\n"
      local last_error
      last_error=$(grep "push.*failed\|ERROR\|FATAL" "$LOG" | tail -1)
      report+="   Last: $last_error\n"
      issues=$((issues + 1))
    else
      report+="✅ Log: no recent errors (7d)\n"
    fi

    # Log size
    local log_size
    log_size=$(stat -f%z "$LOG" 2>/dev/null || echo "0")
    local log_kb=$((log_size / 1024))
    report+="✅ Log size: ${log_kb}KB\n"

    # Last sync time
    local last_sync
    last_sync=$(grep "synced" "$LOG" | tail -1 | cut -d: -f1-3)
    if [[ -n "$last_sync" ]]; then
      report+="✅ Last sync: $last_sync\n"
    else
      report+="⚠️  Last sync: never\n"
      issues=$((issues + 1))
    fi
  else
    report+="⚠️  Log file: not found\n"
    issues=$((issues + 1))
  fi

  # 6. fswatch dependency
  if command -v fswatch >/dev/null 2>&1; then
    report+="✅ fswatch: installed\n"
  else
    report+="❌ fswatch: MISSING\n"
    issues=$((issues + 1))
  fi

  # 7. Copilot CLI check
  if command -v copilot >/dev/null 2>&1; then
    local cli_version
    cli_version=$(copilot --version 2>/dev/null | head -1 || echo "unknown")
    report+="✅ Copilot CLI: installed ($cli_version)\n"
  else
    report+="⚠️  Copilot CLI: not installed\n"
    issues=$((issues + 1))
  fi

  # 8. Stale lock file
  if [[ -d "$LOCKFILE" ]]; then
    local lock_age
    lock_age=$(( $(date +%s) - $(stat -f%m "$LOCKFILE" 2>/dev/null || echo "0") ))
    if [[ "$lock_age" -gt 300 ]]; then
      report+="⚠️  Stale lock: $LOCKFILE (${lock_age}s old, removing)\n"
      rmdir "$LOCKFILE" 2>/dev/null || true
      issues=$((issues + 1))
    else
      report+="✅ Sync lock: active (${lock_age}s old)\n"
    fi
  else
    report+="✅ Sync lock: clear\n"
  fi

  # 9. Shell config integrity (.zshrc)
  if [[ -f "$HOME/.zshrc" ]]; then
    if zsh -n "$HOME/.zshrc" 2>/dev/null; then
      report+="✅ Shell config: .zshrc syntax valid\n"
    else
      report+="⚠️  Shell config: .zshrc has syntax errors!\n"
      report+="   → Run: zsh -n ~/.zshrc to diagnose\n"
      issues=$((issues + 1))
    fi
  fi

  # 10. Daily sync — ensure skills are backed up even if fswatch missed changes
  log "🐿️  daily sync triggered by checkup"
  do_sync_locked
  report+="✅ Daily sync: completed\n"

  report+="\n────────────────────────────────────\n"

  if [[ "$issues" -eq 0 ]]; then
    report+="🐿️  All clear. Groundhog Day is healthy.\n"
  else
    report+="🚨 $issues issue(s) found. Run grid-medic:\n"
    report+="   → Open Copilot CLI and say:\n"
    report+="     \"grid-medic diagnose ~/bin/groundhog\"\n"
  fi

  # Output
  echo -e "$report"

  # Save to checkup log
  echo -e "$report" >> "$CHECKUP_LOG"

  # macOS notification if issues found
  if [[ "$issues" -gt 0 ]] && [[ "$(uname)" == "Darwin" ]]; then
    osascript -e "display notification \"$issues issue(s) found. Run: groundhog checkup\" with title \"🐿️ Groundhog Day Checkup\"" 2>/dev/null || true
  fi

  exit 0
}

# ── Main ───────────────────────────────────────────────────────────────────
case "${1:-}" in
  watch)   watch_mode ;;
  status)  cmd_status ;;
  checkup) cmd_checkup ;;
  *)       do_sync_locked ;;
esac