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,28 @@
+# case: wait-reply-times-out-when-no-reply
+
+### 用例意义
+
+验证在超时时间内没有匹配回复出现时，`wait-reply` 返回稳定超时契约。
+
+### 前置条件
+
+- 存在一个线程 `THREAD_ID`
+- 不会有新的 `answer/control/result` 消息到达
+
+### 输入
+
+```bash
+inbox --db TMPDIR/coord.db --agent worker-c --json wait-reply --thread THREAD_ID --timeout-seconds 1
+```
+
+### 预期输出
+
+- 退出码为 `10`
+- JSON 错误码为 `no_matching_work`
+
+### 断言结论
+
+- `wait-reply` 超时被视为“没有等到匹配回复”
+- `--thread` 是必填 flag；缺失时属于 `invalid_input` 类 usage error
+- `--timeout-seconds=0` 表示无限等待，而不是立即超时
+