Merge pull request 'feat: add session-owned worktree cleanup audit and TTL enforcement (Closes #401)' (#492) from feat/issue-401-worktree-cleanup-ttl into master

2026-07-08 10:11:15 -05:00
parent 6b45212659 cedf451a2b
commit 0b62d4e06a
5 changed files with 991 additions and 0 deletions
@@ -871,6 +871,16 @@ Confirm:

 Clean only the session-owned `branches/` review worktree if the project workflow explicitly allows cleanup.

+Review, baseline, and merge-simulation worktrees created during this run are
+transient and are removed automatically at successful completion once they are
+clean, carry no open PR, and hold no active lease (#401). Use
+`gitea_audit_worktree_cleanup` (read-only) to classify `branches/` entries; only
+`clean_stale_removable` and `detached_review_leftover` may be removed, one-by-one,
+after `git worktree list` proof plus per-worktree proof of path, branch/HEAD,
+clean/dirty status, no active PR/lease, and the removal result. Dirty,
+active-PR, active-issue, and leased worktrees are never deleted automatically; a
+failed removal must be reported with the leftover path and reason.
+
 Do not delete or mutate unrelated branches/worktrees.

 Do not touch the main checkout except to update the stable branch after merge if explicitly allowed by the workflow.