docs: split inbox test plans into case files

2026-03-19 11:29:17 +08:00
parent 9beb7e93eb
commit 5f59350577
70 changed files with 1820 additions and 1606 deletions
@@ -0,0 +1,33 @@
+# Case: `done-marks-thread-terminal`
+
+## 用例意义
+
+验证租约拥有者可以将线程推进到 `done` 终态，并生成结果消息。
+
+## 前置条件
+
+- `worker-a` 已成功 `claim` 线程 `THREAD_ID`
+
+## 输入
+
+```bash
+inbox --db TMPDIR/coord.db --json done --agent worker-a --thread THREAD_ID --summary "Retry policy implemented" --body "The HTTP client now retries the selected transient failures."
+```
+
+## 预期输出
+
+- 命令退出码为 `0`
+- `thread.status == "done"`
+- `message.kind == "result"`
+
+## 断言结论
+
+- `done` 会把线程推进到成功终态
+- 完成时会释放活跃 lease
+
+## 补充约束
+
+- 当 `--agent` 未显式提供时，可以回退使用根级 `--agent`
+- 若线程存在但当前没有活跃 lease，例如 lease 已释放或过期，`done` 应返回 `invalid_state`，而不是 `lease_conflict`
+- `--thread` 与 `--summary` 是必填 flag；缺失时属于 `invalid_input` 类 usage error
+