ai-workflow-skill/docs/tests/orch/cleanup/cleanup-removes-completed-worktree.md

Case: cleanup-removes-completed-worktree

用例意义

验证 cleanup 会移除已完成尝试的 worktree，并把清理结果返回给 leader。

前置条件

• 已创建运行 run_blog_cleanup_001
• 已创建任务 T1
• T1 已通过严格 worktree 模式完成 dispatch
• worker-a 已完成 claim 并通过 inbox done 把线程推进到 done
• 最近一次 reconcile 已执行，使任务状态同步为 done
• 已知当前尝试的 worktree 路径为 WORKTREE_PATH

输入

orch --db TMPDIR/coord.db --json cleanup --run run_blog_cleanup_001 --task T1

预期输出

• 退出码为 0
• cleanup.data.cleaned 长度为 1
• 唯一记录对应 T1 的已完成尝试
• WORKTREE_PATH 在文件系统上已不存在

断言结论

• cleanup 针对的是尝试工作区资源，不会改变任务的完成结果
• 成功清理后，leader 可以安全回收已终态尝试占用的 worktree

补充约束

• cleanup 支持按 --task、--attempt 或 --all-completed 选择范围
• --force 用于非常规清理；本用例验证的是常规完成态清理路径