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
@@ -1,87 +1,9 @@
-# Inbox `cancel` Test Plan
+# Inbox `cancel` Test Plan Index

-## Scope
+## Case Files

-This document covers thread cancellation via `inbox cancel`.
-
-Shared conventions live in [../_shared/README.md](../_shared/README.md).
-
-## case: cancel-marks-thread-cancelled
-
-### 用例意义
-
-验证 `cancel` 可以把非终态线程推进到 `cancelled` 终态，并生成控制消息。
-
-### 前置条件
-
- 已存在一个非终态线程 `THREAD_ID`
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json cancel --agent leader --thread THREAD_ID --reason "Task superseded by a larger refactor"
-```
-
-### 预期输出
-
- 命令退出码为 `0`
- `thread.status == "cancelled"`
- `message.kind == "control"`
-
-### 断言结论
-
- `cancel` 是线程级终态转换
- 取消时会释放活跃 lease
-
-## case: cancel-persists-reason-and-artifact
-
-### 用例意义
-
-验证 `cancel` 的原因文本与附件会被完整持久化。
-
-### 前置条件
-
- 已存在一个非终态线程 `THREAD_ID`
- `TMPDIR/cancel.md` 已存在
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json cancel --agent leader --thread THREAD_ID --reason "Task superseded by a larger refactor" --artifact TMPDIR/cancel.md --artifact-kind brief
-inbox --db TMPDIR/coord.db --json show --thread THREAD_ID
-```
-
-### 预期输出
-
- `cancel` 成功
- 取消消息 `summary` 与 `body` 都保留取消原因
- 取消消息包含 1 个 artifact
-
-### 断言结论
-
- `cancel` 既保留人类可读原因，也支持附带上下文材料
-
-## case: cancel-rejects-when-thread-missing
-
-### 用例意义
-
-验证 `cancel` 对不存在线程返回稳定的 not-found 错误契约。
-
-### 前置条件
-
- 空数据库已完成 `init`
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json cancel --agent leader --thread thr_missing
-```
-
-### 预期输出
-
- 退出码为 `40`
- JSON 错误码为 `not_found`
-
-### 断言结论
-
- `cancel` 不会为缺失线程隐式创建控制消息
+| Case Slug | File | Coverage Note |
+| --- | --- | --- |
+| `cancel-marks-thread-cancelled` | [cancel-marks-thread-cancelled.md](./cancel-marks-thread-cancelled.md) | moves a non-terminal thread into `cancelled` and emits a control message |
+| `cancel-persists-reason-and-artifact` | [cancel-persists-reason-and-artifact.md](./cancel-persists-reason-and-artifact.md) | persists cancel reason text and attached artifacts |
+| `cancel-rejects-when-thread-missing` | [cancel-rejects-when-thread-missing.md](./cancel-rejects-when-thread-missing.md) | returns stable not-found contract when thread does not exist |