112 lines
2.5 KiB
Markdown
112 lines
2.5 KiB
Markdown
# Inbox `reply` Test Plan
|
|
|
|
## Scope
|
|
|
|
This document covers reply behavior within an existing thread via `inbox reply`.
|
|
|
|
Shared conventions live in [../_shared/README.md](../_shared/README.md).
|
|
|
|
## case: reply-adds-answer-message
|
|
|
|
### 用例意义
|
|
|
|
验证 `reply` 默认会向现有线程追加一条 `answer` 消息，并保持线程状态不变。
|
|
|
|
### 前置条件
|
|
|
|
- 已存在一个非终态线程 `THREAD_ID`
|
|
|
|
### 输入
|
|
|
|
```bash
|
|
inbox --db TMPDIR/coord.db --json reply --from leader --to worker-a --thread THREAD_ID --summary "Retry read timeouts" --body "Yes, include read timeouts in the retry policy."
|
|
```
|
|
|
|
### 预期输出
|
|
|
|
- 命令退出码为 `0`
|
|
- `message.kind == "answer"`
|
|
- `thread.thread_id == THREAD_ID`
|
|
- 线程状态保持原值
|
|
|
|
### 断言结论
|
|
|
|
- `reply` 是线程内追加消息，而不是状态转换命令
|
|
|
|
## case: reply-supports-control-kind
|
|
|
|
### 用例意义
|
|
|
|
验证 `reply --kind control` 可以发送控制类消息，而不局限于默认 `answer`。
|
|
|
|
### 前置条件
|
|
|
|
- 已存在一个非终态线程 `THREAD_ID`
|
|
|
|
### 输入
|
|
|
|
```bash
|
|
inbox --db TMPDIR/coord.db --json reply --from leader --to worker-a --thread THREAD_ID --kind control --summary "Pause rollout" --body "Pause rollout until QA confirms the fix."
|
|
```
|
|
|
|
### 预期输出
|
|
|
|
- 命令退出码为 `0`
|
|
- `message.kind == "control"`
|
|
|
|
### 断言结论
|
|
|
|
- `reply` 的消息种类可由调用方显式指定
|
|
|
|
## case: reply-attaches-artifact
|
|
|
|
### 用例意义
|
|
|
|
验证 `reply` 支持追加带附件的答复消息。
|
|
|
|
### 前置条件
|
|
|
|
- 已存在一个非终态线程 `THREAD_ID`
|
|
- `TMPDIR/decision.md` 已存在
|
|
|
|
### 输入
|
|
|
|
```bash
|
|
inbox --db TMPDIR/coord.db --json reply --from leader --to worker-a --thread THREAD_ID --summary "Retry read timeouts" --artifact TMPDIR/decision.md --artifact-kind brief --artifact-metadata-json '{"label":"decision"}'
|
|
```
|
|
|
|
### 预期输出
|
|
|
|
- 命令退出码为 `0`
|
|
- `message.artifacts` 长度为 `1`
|
|
- artifact 路径、kind、metadata 都可读
|
|
|
|
### 断言结论
|
|
|
|
- `reply` 与 `send/update/done/fail` 共享附件写入契约
|
|
|
|
## case: reply-rejects-invalid-payload-json
|
|
|
|
### 用例意义
|
|
|
|
验证 `reply` 对非法 `--payload-json` 输入返回稳定错误契约。
|
|
|
|
### 前置条件
|
|
|
|
- 已存在一个非终态线程 `THREAD_ID`
|
|
|
|
### 输入
|
|
|
|
```bash
|
|
inbox --db TMPDIR/coord.db --json reply --from leader --to worker-a --thread THREAD_ID --summary "Retry read timeouts" --payload-json not-json
|
|
```
|
|
|
|
### 预期输出
|
|
|
|
- 退出码为 `30`
|
|
- JSON 错误码为 `invalid_input`
|
|
|
|
### 断言结论
|
|
|
|
- `reply` 的 payload 与其他消息写入命令一样需要通过 JSON 校验
|