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,107 +1,10 @@
-# Inbox `list` Test Plan
+# Inbox `list` Test Plan Index

-## Scope
+## Case Files

-This document covers thread listing behavior via `inbox list`.
-
-Shared conventions live in [../_shared/README.md](../_shared/README.md).
-
-## case: list-filters-by-status
-
-### 用例意义
-
-验证 `list --status` 只返回指定状态集合内的线程。
-
-### 前置条件
-
- 数据库中存在多个不同状态的线程
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json list --status pending,blocked
-```
-
-### 预期输出
-
- 命令退出码为 `0`
- 返回的每条线程都满足 `status in ["pending","blocked"]`
-
-### 断言结论
-
- `list` 是全局筛选视角，状态过滤不会被忽略
-
-## case: list-filters-by-created-by
-
-### 用例意义
-
-验证 `list --created-by` 能按线程创建者筛选结果。
-
-### 前置条件
-
- 至少有两位不同创建者产生的线程
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json list --created-by leader
-```
-
-### 预期输出
-
- 命令退出码为 `0`
- 返回的每条线程都满足 `created_by == "leader"`
-
-### 断言结论
-
- `created-by` 过滤条件直接作用在线程元数据上
-
-## case: list-filters-by-assigned-to
-
-### 用例意义
-
-验证 `list --assigned-to` 能按当前指派执行者筛选线程。
-
-### 前置条件
-
- 数据库中存在多个不同 `assigned_to` 的线程
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json list --assigned-to worker-d --status pending
-```
-
-### 预期输出
-
- 命令退出码为 `0`
- 返回的每条线程都满足 `assigned_to == "worker-d"`
-
-### 断言结论
-
- `list` 可用于管理侧查看某位执行者当前承担的线程集合
-
-## case: list-respects-limit
-
-### 用例意义
-
-验证 `list --limit` 会约束返回条数，并按更新时间倒序返回最新线程。
-
-### 前置条件
-
- 存在多个满足过滤条件的线程
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json list --assigned-to worker-d --limit 1
-```
-
-### 预期输出
-
- 命令退出码为 `0`
- 返回线程数不超过 `1`
-
-### 断言结论
-
- `list` 的 limit 是硬上限，不会返回超量结果
+| Case Slug | File | Coverage Note |
+| --- | --- | --- |
+| `list-filters-by-status` | [list-filters-by-status.md](./list-filters-by-status.md) | filters returned threads by status set |
+| `list-filters-by-created-by` | [list-filters-by-created-by.md](./list-filters-by-created-by.md) | filters returned threads by creator |
+| `list-filters-by-assigned-to` | [list-filters-by-assigned-to.md](./list-filters-by-assigned-to.md) | filters returned threads by current assignee |
+| `list-respects-limit` | [list-respects-limit.md](./list-respects-limit.md) | enforces hard cap on returned thread count |
@@ -0,0 +1,25 @@
+# case: list-filters-by-assigned-to
+
+### 用例意义
+
+验证 `list --assigned-to` 能按当前指派执行者筛选线程。
+
+### 前置条件
+
+- 数据库中存在多个不同 `assigned_to` 的线程
+
+### 输入
+
+```bash
+inbox --db TMPDIR/coord.db --json list --assigned-to worker-d --status pending
+```
+
+### 预期输出
+
+- 命令退出码为 `0`
+- 返回的每条线程都满足 `assigned_to == "worker-d"`
+
+### 断言结论
+
+- `list` 可用于管理侧查看某位执行者当前承担的线程集合
+
@@ -0,0 +1,26 @@
+# case: list-filters-by-created-by
+
+### 用例意义
+
+验证 `list --created-by` 能按线程创建者筛选结果。
+
+### 前置条件
+
+- 至少有两位不同创建者产生的线程
+
+### 输入
+
+```bash
+inbox --db TMPDIR/coord.db --json list --created-by leader
+```
+
+### 预期输出
+
+- 命令退出码为 `0`
+- 返回的每条线程都满足 `created_by == "leader"`
+
+### 断言结论
+
+- `created-by` 过滤条件直接作用在线程元数据上
+- 没有任何匹配线程时，`list` 返回退出码 `10` 和错误码 `no_matching_work`，而不是成功空数组
+
@@ -0,0 +1,26 @@
+# case: list-filters-by-status
+
+### 用例意义
+
+验证 `list --status` 只返回指定状态集合内的线程。
+
+### 前置条件
+
+- 数据库中存在多个不同状态的线程
+
+### 输入
+
+```bash
+inbox --db TMPDIR/coord.db --json list --status pending,blocked
+```
+
+### 预期输出
+
+- 命令退出码为 `0`
+- 返回的每条线程都满足 `status in ["pending","blocked"]`
+
+### 断言结论
+
+- `list` 会严格应用状态过滤
+- 当未显式传 `--assigned-to` 时，`list` 可以作为全局视角，也可以在提供 `--agent` 或根级 `--agent` 时退化为“按 assigned-to 过滤”的快捷入口
+
@@ -0,0 +1,26 @@
+# case: list-respects-limit
+
+### 用例意义
+
+验证 `list --limit` 会约束返回条数，并按更新时间倒序返回最新线程。
+
+### 前置条件
+
+- 存在多个满足过滤条件的线程
+
+### 输入
+
+```bash
+inbox --db TMPDIR/coord.db --json list --assigned-to worker-d --limit 1
+```
+
+### 预期输出
+
+- 命令退出码为 `0`
+- 返回线程数不超过 `1`
+
+### 断言结论
+
+- `list` 的 limit 是硬上限，不会返回超量结果
+- `--limit <= 0` 时会回退到默认值 `20`
+