pkuppens/maintenance-cleanup

Maintenance Cleanup

Post-merge hygiene: branch cleanup, worktree removal, GitHub Actions runs, tmp/ hygiene.

When to use

• After PR merge when local branch should be deleted
• When git branch -D fails because branch is used by a worktree
• When cleaning up old GitHub Actions workflow runs
• When tidying tmp/ or other scratch directories

Branch cleanup

For a full PR-merge checklist (merge, squash, rebase, gone remotes), see branch-cleanup-after-pr.

1. git checkout main, git pull
2. git fetch --prune to remove stale remote-tracking refs
3. Prefer git branch -d <branch>
4. If -d fails with "not fully merged", run git cherry -v main <branch>:
   • all - => functionally merged (safe to delete with git branch -D <branch>)
   • any + => not merged, keep branch

If branch is used by a worktree

If git branch -D <branch> fails with "cannot delete branch used by worktree", follow the remove/clean procedure in git-worktrees.

GitHub Actions runs

You can treat “obsolete” workflow runs as follows:

1. Runs from branches that are gone: delete completed runs whose head_branch no longer exists in the repository.
2. Runs for workflows that no longer exist: delete completed runs whose workflow_id is not present in the current workflow set.
3. Runs superseded by a later successful run: for each workflow, keep the latest conclusion: success run, and delete other completed runs older than that latest success (superseded).

Repository examples

on_prem_rag (automated): After Python CI succeeds on main, the Repository Cleanup workflow runs scripts/cleanup-github-actions.sh. This implements (3) “superseded by later success” plus additional retention rules for debugging.

Do not assume all failed runs are kept forever; only failures after the latest pass are retained.

Other repos (manual): you may still delete very old completed runs by age, for example:

# Delete completed runs older than 30 days for a workflow
gh run list --workflow ci.yml --status completed --limit 100 --json databaseId,createdAt \
  | jq '[.[] | select(.createdAt < (now - 2592000 | todate))] | .[].databaseId' \
  | xargs -I {} gh run delete {}

tmp/ hygiene

Ensure tmp/ is gitignored. Remove obsolete drafts, planning notes, and debug artifacts. Per-repo tmp/ layout: see workspace CLAUDE.md scratch directory section.

Integration

• Runs after integration-merge.
• Worktree removal: git-worktrees.