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
+4 -4
View File
@@ -1,7 +1,7 @@
# Orch `status` Test Plan Index
## Status
## Case Files
No command case files are authored yet.
Use [../ROADMAP.md](../ROADMAP.md) for planned case slugs and document progress.
| Case Slug | File | Coverage Note |
| --- | --- | --- |
| `status-returns-run-summary-and-task-list` | [status-returns-run-summary-and-task-list.md](./status-returns-run-summary-and-task-list.md) | returns aggregate run status plus the per-task status list |
@@ -0,0 +1,37 @@
# Case: `status-returns-run-summary-and-task-list`
## 用例意义
验证 `status` 会返回 run 聚合视图以及任务明细列表,是 leader 端的完整状态检查入口。
## 前置条件
- 已存在 run `run_blog_001`
- 任务 `T1` 已经过完整的 dispatch -> worker done -> reconcile 流程
## 输入
```bash
orch --db TMPDIR/coord.db --json run init --run run_blog_001 --goal "Build blog MVP"
orch --db TMPDIR/coord.db --json task add --run run_blog_001 --task T1 --title "Implement retry policy" --default-to worker-a
orch --db TMPDIR/coord.db --json dispatch --run run_blog_001 --task T1 --body "Implement retry handling for the HTTP client."
inbox --db TMPDIR/coord.db --json claim --agent worker-a --thread THREAD_ID
inbox --db TMPDIR/coord.db --json done --agent worker-a --thread THREAD_ID --summary "Retry policy implemented" --body "The HTTP client now retries transient failures."
orch --db TMPDIR/coord.db --json reconcile --run run_blog_001
orch --db TMPDIR/coord.db --json status --run run_blog_001
```
## 预期输出
- `status` 退出码为 `0`
- `data.run.run_id == "run_blog_001"`
- `data.run.status == "done"`
- 返回 `data.task_counts`
- 返回 `data.tasks` 数组
- `data.tasks[0].task_id == "T1"`
- `data.tasks[0].status == "done"`
## 断言结论
- `status``run show` 更完整,适合做 run 级收口检查
- 任务清单与 run 聚合状态应保持一致,不应出现 run 已完成而任务仍显示旧状态的结果