docs: split inbox test plans into case files

2026-03-19 11:29:17 +08:00
parent 9beb7e93eb
commit 5f59350577
70 changed files with 1820 additions and 1606 deletions
@@ -1,87 +1,9 @@
-# Inbox `renew` Test Plan
+# Inbox `renew` Test Plan Index

-## Scope
+## Case Files

-This document covers lease renewal behavior via `inbox renew`.
-
-Shared conventions live in [../_shared/README.md](../_shared/README.md).
-
-## case: renew-extends-active-lease
-
-### 用例意义
-
-验证租约拥有者可以对活跃 lease 执行续租，并生成续租事件消息。
-
-### 前置条件
-
- `worker-c` 已成功 `claim` 线程 `THREAD_ID`
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json renew --agent worker-c --thread THREAD_ID --lease-seconds 600
-```
-
-### 预期输出
-
- 命令退出码为 `0`
- `thread.status` 保持原状态
- `message.kind == "event"`
- `message.summary == "lease renewed"`
- `message.payload_json.lease_seconds == 600`
-
-### 断言结论
-
- `renew` 是在原线程上追加续租事件，而不是重新 claim
-
-## case: renew-rejects-non-owner
-
-### 用例意义
-
-验证非租约拥有者不能续租别人的活跃 lease。
-
-### 前置条件
-
- `worker-c` 已成功 `claim` 线程 `THREAD_ID`
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json renew --agent worker-x --thread THREAD_ID --lease-seconds 600
-```
-
-### 预期输出
-
- 退出码为 `20`
- JSON 错误码为 `lease_conflict`
-
-### 断言结论
-
- `renew` 与 `claim` 一样受 lease owner 约束
-
-## case: renew-rejects-without-active-lease
-
-### 用例意义
-
-验证线程没有活跃租约时，`renew` 会明确失败。
-
-### 前置条件
-
- 已存在线程 `THREAD_ID`
- 该线程当前没有活跃 lease
-
-### 输入
-
-```bash
-inbox --db TMPDIR/coord.db --json renew --agent worker-c --thread THREAD_ID --lease-seconds 600
-```
-
-### 预期输出
-
- 退出码为 `30`
- JSON 错误码为 `invalid_state`
-
-### 断言结论
-
- `renew` 依赖已有活跃租约
- 没有 lease 属于状态错误，不是 not-found
+| Case Slug | File | Coverage Note |
+| --- | --- | --- |
+| `renew-extends-active-lease` | [renew-extends-active-lease.md](./renew-extends-active-lease.md) | owner renews an active lease and gets a renewal event |
+| `renew-rejects-non-owner` | [renew-rejects-non-owner.md](./renew-rejects-non-owner.md) | non-owner renew attempt returns lease_conflict |
+| `renew-rejects-without-active-lease` | [renew-rejects-without-active-lease.md](./renew-rejects-without-active-lease.md) | missing active lease returns invalid_state |