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

Case: ready-lists-only-eligible-tasks

用例意义

验证 ready 只返回当前真正可调度的任务，而不会把仍受依赖阻塞的任务混入结果。

前置条件

• 已存在 run run_blog_002
• T1 与 T2 已创建
• T2 已通过 dep add 依赖 T1

输入

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