Author orch Markdown test plan

2026-03-19 16:27:28 +08:00
parent b448d98e71
commit a20bec1cac
68 changed files with 2225 additions and 160 deletions
@@ -0,0 +1,33 @@
+# Case: `wait-times-out-without-matching-event`
+
+## 用例意义
+
+验证 `wait` 在没有后续匹配事件时返回稳定的超时结果，而不是把超时视为命令失败。
+
+## 前置条件
+
+- 空数据库已初始化
+- 已创建运行 `run_blog_wait_002`
+- 当前没有会产生 `task_done` 的后续事件
+
+## 输入
+
+```bash
+orch --db TMPDIR/coord.db --json wait --run run_blog_wait_002 --for task_done --after-event 0 --timeout-seconds 1
+```
+
+## 预期输出
+
+- 退出码为 `0`
+- `wait.data.woke == false`
+- `wait.data.next_event_id == 0`
+- `wait.data.events` 为空或缺省
+
+## 断言结论
+
+- `wait` 的超时是可消费的正常结果，不是错误态
+- leader 可以基于 `woke=false` 决定继续轮询、切换过滤条件，或退出当前控制循环
+
+## 补充约束
+
+- 该用例强调超时契约，不要求系统中存在任何任务