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: `send-appends-message-to-existing-thread`
+
+## 用例意义
+
+验证 `send` 在指定既有 `--thread` 时会向原线程追加消息，而不是重建线程。
+
+## 前置条件
+
+- 已存在一个由 `leader` 发给 `worker-d` 的非终态线程 `THREAD_ID`
+
+## 输入
+
+```bash
+inbox --db TMPDIR/coord.db --json send --from leader --to worker-d --thread THREAD_ID --summary "Use a markdown editor" --body "Prefer a textarea-based markdown editor for v1."
+inbox --db TMPDIR/coord.db --json show --thread THREAD_ID
+```
+
+## 预期输出
+
+- `send` 成功，返回的 `thread.thread_id` 仍为 `THREAD_ID`
+- 线程状态保持原值，不被强制改写为新状态
+- `show` 可见消息数增加
+
+## 断言结论
+
+- 追加消息不会重置线程生命周期
+- 线程历史按时间顺序保留旧消息与新消息
+
+## 补充约束
+
+- `--to` 是 CLI 必填参数；即使是向既有线程追加消息也不能省略
+- 对既有线程执行追加时，如果传入了不同的 `--to`，线程的 `assigned_to` 会更新为新的接收者
+- 终态线程不允许继续通过 `send` 追加消息，预期错误类型为 `invalid_state`