Author orch Markdown test plan

docs/tests/orch/ready/ready-lists-only-eligible-tasks.md

@@ -0,0 +1,38 @@
+# Case: `ready-lists-only-eligible-tasks`
+
+## 用例意义
+
+验证 `ready` 只返回当前真正可调度的任务，而不会把仍受依赖阻塞的任务混入结果。
+
+## 前置条件
+
+- 已存在 run `run_blog_002`
+- `T1` 与 `T2` 已创建
+- `T2` 已通过 `dep add` 依赖 `T1`
+
+## 输入
+
+```bash
+orch --db TMPDIR/coord.db --json run init --run run_blog_002 --goal "Build dependency-aware workflow"
+orch --db TMPDIR/coord.db --json task add --run run_blog_002 --task T1 --title "Build backend" --default-to worker-a
+orch --db TMPDIR/coord.db --json task add --run run_blog_002 --task T2 --title "Build frontend" --default-to worker-b
+orch --db TMPDIR/coord.db --json dep add --run run_blog_002 --task T2 --depends-on T1
+orch --db TMPDIR/coord.db --json ready --run run_blog_002
+```
+
+## 预期输出
+
+- `ready` 退出码为 `0`
+- `data.tasks` 长度为 `1`
+- 唯一返回项是 `T1`
+- 返回任务状态为 `ready`
+
+## 断言结论
+
+- `ready` 是经过依赖和状态过滤后的结果，不是“所有未完成任务”的简单列表
+- 新 agent 可以依赖该命令决定可立即 dispatch 的工作
+
+## 补充约束
+
+- 未显式传 `--limit` 时，默认上限是 `20`
+- `--run` 指向不存在的 run 时，应返回 `not_found`