116 lines
5.6 KiB
Bash
Executable file
116 lines
5.6 KiB
Bash
Executable file
#!/bin/bash
|
||
# Cleanup merged Claude Code background-session worktrees.
|
||
#
|
||
# `claude agents` / `claude --bg` создают `.claude/worktrees/agent-*` для
|
||
# каждой background session. После merge PR worktree остаётся locked
|
||
# и не удаляется автоматически — за неделю накапливаются десятки.
|
||
#
|
||
# Скрипт определяет, что worktree безопасно удалить, ЕСЛИ ОБА условия:
|
||
# 1. branch отсутствует на remote (см. ниже, почему не ancestor-check)
|
||
# 2. working tree чист (`git status --porcelain` пуст — untracked-only
|
||
# мусор типа node_modules/__pycache__ игнорируется, но staged/modified
|
||
# TRACKED-изменения блокируют удаление — там может быть незакоммиченная
|
||
# работа, которую стоит разобрать руками)
|
||
# Затем `git worktree prune` чистит references.
|
||
#
|
||
# ПОЧЕМУ НЕ `git merge-base --is-ancestor branch main` (ревизия 2026-07-04):
|
||
# репозиторий мержит PR через SQUASH (см. git-pr.md § Auto-merge policy) —
|
||
# squash создаёт НОВЫЙ коммит в main, оригинальный коммит ветки НИКОГДА не
|
||
# становится предком main, даже если PR давно смержен. Ancestor-check
|
||
# систематически давал ложный "не смержено" на каждой squash-смерженной
|
||
# ветке — это и есть причина, по которой скрипт годами не расчищал
|
||
# 60+ забытых worktree. Прокси "ветка удалена на remote" надёжен, потому что
|
||
# конвенция репо — всегда `delete_branch: true` при мерже (git-pr.md).
|
||
#
|
||
# ВАЖНО (2026-07-04): удаление worktree, управляемого супервизором Claude
|
||
# Code, из ОБЫЧНОЙ сессионной Bash-песочницы систематически не срабатывает
|
||
# (`git worktree remove -f -f` тихо не удаляет каталог, даже когда
|
||
# ответственный agent-pid уже мёртв) — похоже на намеренную защиту
|
||
# harness-managed состояния. Запускай этот скрипт ЛИБО из терминала вне
|
||
# активной Claude Code сессии, ЛИБО через `Ctrl+X` дважды в agent view
|
||
# для конкретной сессии (см. CLAUDE.md § Multi-session workflow).
|
||
#
|
||
# Запускать вручную или через cron (weekly recommended):
|
||
# 0 9 * * MON cd /path/to/gendesign && ./scripts/cleanup-merged-worktrees.sh
|
||
#
|
||
# Safe:
|
||
# - Не трогает branches, ещё живые на remote (in-progress work, PR ещё не merged)
|
||
# - Не трогает worktree с незакоммиченными TRACKED-изменениями (dirty tree)
|
||
# - Логи action — каждый удалённый branch выводится отдельной строкой
|
||
#
|
||
# Reference: https://code.claude.com/docs/en/worktrees#clean-up-worktrees
|
||
|
||
set -e
|
||
|
||
REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||
cd "$REPO_ROOT"
|
||
|
||
# Remote-алиас непереносим между чекаутами: где-то `forgejo`, где-то `origin`
|
||
# (см. git-pr.md — конвенция документирует `forgejo`, но не все клоны его
|
||
# заводят). Автоопределяем вместо жёсткого хардкода.
|
||
if git remote | grep -qx forgejo; then
|
||
REMOTE=forgejo
|
||
else
|
||
REMOTE=origin
|
||
fi
|
||
|
||
echo "Fetching $REMOTE (remote alias auto-detected)..."
|
||
git fetch "$REMOTE" --quiet
|
||
|
||
BEFORE=$(git worktree list | wc -l)
|
||
SIZE_BEFORE=$(du -sh .claude/worktrees/ 2>/dev/null | awk '{print $1}')
|
||
|
||
echo "Scanning $((BEFORE - 1)) worktrees (skip main)..."
|
||
|
||
REMOVED=0
|
||
KEPT=0
|
||
DIRTY=0
|
||
|
||
# Parse `git worktree list --porcelain` into "path branch" pairs.
|
||
git worktree list --porcelain | awk '/^worktree/{w=$2} /^branch/{b=$2} /^$/{print w" "b}' | \
|
||
while read path branch; do
|
||
# Skip main worktree (no branch field) and detached HEADs.
|
||
[ -z "$branch" ] && continue
|
||
|
||
short="${branch#refs/heads/}"
|
||
|
||
# Don't touch the worktree we're standing in.
|
||
if [ "$path" = "$REPO_ROOT" ]; then
|
||
continue
|
||
fi
|
||
|
||
# "Merged" proxy: branch no longer exists on remote (squash-merge convention
|
||
# means ancestor-check would false-negative on every merged branch — see
|
||
# header comment). A branch a human/bot deliberately deleted without
|
||
# merging is rare and the local copy is stale garbage either way.
|
||
if git ls-remote --exit-code --heads "$REMOTE" "$short" >/dev/null 2>&1; then
|
||
KEPT=$((KEPT + 1))
|
||
continue
|
||
fi
|
||
|
||
# Dirty gate: only untracked noise (node_modules, __pycache__, build
|
||
# artifacts) is tolerated. Any staged/modified TRACKED file blocks
|
||
# removal — that may be unlanded work worth rescuing by hand.
|
||
if [ -n "$(git -C "$path" status --porcelain | grep -v '^??')" ]; then
|
||
echo " SKIP (uncommitted tracked changes): $short ($path)"
|
||
DIRTY=$((DIRTY + 1))
|
||
continue
|
||
fi
|
||
|
||
if git worktree remove -f -f "$path" 2>/dev/null; then
|
||
echo " removed: $short"
|
||
REMOVED=$((REMOVED + 1))
|
||
else
|
||
echo " failed: $short ($path) — see header comment re: harness-managed removal"
|
||
fi
|
||
done
|
||
|
||
git worktree prune
|
||
|
||
AFTER=$(git worktree list | wc -l)
|
||
SIZE_AFTER=$(du -sh .claude/worktrees/ 2>/dev/null | awk '{print $1}')
|
||
|
||
echo ""
|
||
echo "Before: $((BEFORE - 1)) worktrees, $SIZE_BEFORE"
|
||
echo "After: $((AFTER - 1)) worktrees, $SIZE_AFTER"
|
||
echo "Dirty (skipped, needs manual review): $DIRTY"
|