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,64 +1,8 @@
-# Inbox `init` Test Plan
+# Inbox `init` Test Plan Index

-## Scope
+## Case Files

-This document covers the externally visible behavior of `inbox init`.
-
-Shared conventions live in [../_shared/README.md](../_shared/README.md).
-
-## case: init-creates-schema-on-empty-db
-
-### 用例意义
-
-验证在空数据库路径上执行 `init` 会创建可用的 inbox schema，并返回稳定的初始化响应。
-
-### 前置条件
-
- 选择一个尚不存在的数据库路径 `TMPDIR/coord.db`
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json init
-```
-
-### 预期输出
-
- 命令退出码为 `0`
- 返回 `ok=true`
- `command` 为 `init`
- `data.db_path` 等于传入路径
- `data.status` 为 `initialized`
-
-### 断言结论
-
- `init` 在空路径上可以直接完成 schema 初始化
- 初始化结果足以让后续 `send`、`fetch` 等命令继续使用同一数据库
-
-## case: init-is-idempotent-on-existing-db
-
-### 用例意义
-
-验证 `init` 可以对已初始化过的数据库重复执行，而不会报错或破坏已有 schema。
-
-### 前置条件
-
- `TMPDIR/coord.db` 已经执行过一次 `inbox --db TMPDIR/coord.db --json init`
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json init
-inbox --db TMPDIR/coord.db --json init
-```
-
-### 预期输出
-
- 两次命令都退出码为 `0`
- 两次响应都返回 `data.status == "initialized"`
- 两次响应都返回相同的 `data.db_path`
-
-### 断言结论
-
- `init` 是幂等操作
- 对已存在 schema 的重复初始化不应引入额外迁移失败或状态漂移
+| Case Slug | File | Coverage Note |
+| --- | --- | --- |
+| `init-creates-schema-on-empty-db` | [init-creates-schema-on-empty-db.md](./init-creates-schema-on-empty-db.md) | initializes an empty database path and returns initialized status |
+| `init-is-idempotent-on-existing-db` | [init-is-idempotent-on-existing-db.md](./init-is-idempotent-on-existing-db.md) | repeated init succeeds on the same database path |