Inbox watch Test Plan
Scope
This document covers blocking thread-activity wait behavior via inbox watch.
Shared conventions live in ../_shared/README.md.
case: watch-wakes-on-matching-thread
用例意义
验证 watch 在新匹配线程到达时会被唤醒，并返回线程、消息与事件信息。
前置条件
worker-d当前没有匹配pending线程watch先于send启动
输入
inbox --db TMPDIR/coord.db --json watch --agent worker-d --status pending --timeout-seconds 2
inbox --db TMPDIR/coord.db --json send --from leader --to worker-d --subject "Build admin editor" --summary "Create the first editor screen"
预期输出
watch退出码为0watch.data.woke == true- 返回
thread、message、event
断言结论
watch唤醒结果不仅说明“醒了”，还提供触发该唤醒的具体事件上下文
case: watch-respects-status-filter
用例意义
验证 watch --status 只会对匹配状态的后续事件唤醒。
前置条件
- 存在一个会被推进到
blocked的线程THREAD_ID watch以--status blocked先启动
输入
inbox --db TMPDIR/coord.db --json watch --agent worker-c --status blocked --timeout-seconds 2
inbox --db TMPDIR/coord.db --json update --agent worker-c --thread THREAD_ID --status blocked --summary "Need policy decision"
预期输出
watch只在线程进入blocked后返回- 返回的
thread.status == "blocked"
断言结论
watch的状态过滤作用在“事件发生后的线程状态”上
case: watch-times-out-with-no-activity
用例意义
验证在超时时间内没有匹配活动时，watch 返回稳定超时契约。
前置条件
- 没有新匹配事件会发生
输入
inbox --db TMPDIR/coord.db --json watch --agent worker-d --status pending --timeout-seconds 1
预期输出
- 退出码为
10 - JSON 错误码为
no_matching_work
断言结论
watch超时被归类为“无匹配工作”，而不是内部错误
Notes
- 未传
--after-event时，watch默认从“当前时刻之后”开始等待，不会回放既有事件