docs: add inbox markdown test plans

2026-03-19 10:54:39 +08:00
parent dab0506c5a
commit 9beb7e93eb
18 changed files with 2091 additions and 135 deletions
@@ -0,0 +1,107 @@
+# Inbox `list` Test Plan
+
+## Scope
+
+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 是硬上限，不会返回超量结果