Author orch Markdown test plan

This commit is contained in:
2026-03-19 16:27:28 +08:00
parent b448d98e71
commit a20bec1cac
68 changed files with 2225 additions and 160 deletions
@@ -0,0 +1,37 @@
# 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`
## 输入
```bash
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` 用于非常规清理;本用例验证的是常规完成态清理路径