feat(release):完成双 release 运维闭环

USERGUIDE.md

@@ -501,6 +501,10 @@ Glossary 相关定义变化会使受影响 override 失效，无关术语变化
 | `resource.repair` | ✅ | 触发本地 manifest 审计 + 修复任务，返回 `task_id`；不继承 `force` |
 | `resource.manifest` / `resource.list` | ✅ | 当前版本下载 manifest 分页查询（`params.offset` 默认 0、`params.limit` 默认 100/上限 1000） |
 | `resource.index` | ✅ | 查询现有 SQLite ResourceRepository 索引，支持资源类型、hash、路径模式、release、平台、destination、bundle path、archive entry、parse status 和 TextUnit format 过滤 |
+| `release.status` | ✅ | 查询 official/localized 当前与历史 release 的统一状态、来源关系和完整性 |
+| `release.list` | ✅ | 按 namespace 查询历史 release 摘要，识别 current、legacy、stale 和 damaged |
+| `release.distribution` | ✅ | 选择已验证的 official 或 localized 当前/历史 release；默认 official，不跨 channel fallback |
+| `release.cleanup` | ✅ | 先 dry-run 生成 `plan_id`，再由 Rust 重验证引用后清理无引用历史 release |
 | `parse.status` | ✅ | 查询当前 release 的解析缓存、TextUnit 索引和队列摘要 |
 | `parse.text_units` / `parse.errors` | ✅ | 查询当前 release 的 TextUnit 明细和解析错误 |
 | `translation.tasks` | ✅ | 查询离线 TextUnit 翻译任务及 worker 状态 |
@@ -523,10 +527,23 @@ Glossary 相关定义变化会使受影响 override 失效，无关术语变化
 | 未知方法 | — | `BAT-ERR-700001`（unknown method） |
 
 只读查询（`daemon.doctor` / `resource.state` / `resource.manifest` / `resource.list` /
-`resource.index` / `parse.*` / `translation.tasks` / `translation.handoff` /
+`resource.index` / `release.status` / `release.list` / `release.distribution` / `parse.*` / `translation.tasks` / `translation.handoff` /
 `localized.status` / `catalog.status` / `catalog.versions` / `catalog.diff`）在尚无已发布版本
 或对应文件不存在时返回 `ok: true` 且 `data.available: false`（正常状态而非错误，便于调用方直接分支）。
 
+`localized.status` 会分别返回 `patch_manifest_contract_status` 和
+`artifact_integrity_status`。current 仍存在但 release 文件被截断或手工修改时，
+状态为 `degraded` / `localized.degraded`，不会自动回滚、删除或修复。`release.distribution`
+默认选择 official；只有 Rust 已验证的当前或显式历史 release 可分发，localized、
+staging、损坏或路径不安全的 release 不会回退到另一 channel。
+
+`release.list` 的每项摘要还会返回 `rollback_available`、`stale`、`damaged`、
+`referenced` 和 `unknown`，便于区分可回滚、损坏和证据不足的历史 release。
+
+双 release cleanup 不是独立 CLI：通过 `release.cleanup` 先执行 dry-run，再把返回的
+`plan_id` 传给 `execute=true`。Rust 会保护 current、rollback、staging、source、
+状态/manifest/CAS 引用和未知归属对象；rollback 仍使用独立的 `localized.rollback`。
+
 ### 任务模型
 
 `resource.sync` / `resource.verify` / `resource.repair` / `catalog.refresh` 是**异步任务**：入队即返回 `{ "task_id": "task-<pid>-<seq>", "kind": "resource.sync" }`（`status: "accepted"`），实际执行由后台任务 worker 串行完成，通过 `task.status` / `task.list` 轮询。任务记录：
@@ -567,4 +584,16 @@ printf '{"jsonrpc":"2.0","id":5,"method":"resource.manifest","params":{"offset":
 # 触发本地资源审计+修复任务
 printf '{"jsonrpc":"2.0","id":6,"method":"resource.repair"}\n' \
   | socat - UNIX-CONNECT:/tmp/bat-pid/bat.sock
+
+# 查询双 release 状态，并选择已验证的 localized release
+printf '{"jsonrpc":"2.0","id":7,"method":"release.status"}\n' \
+  | socat - UNIX-CONNECT:/tmp/bat-pid/bat.sock
+printf '{"jsonrpc":"2.0","id":8,"method":"release.distribution","params":{"channel":"localized"}}\n' \
+  | socat - UNIX-CONNECT:/tmp/bat-pid/bat.sock
+
+# cleanup 必须先 dry-run，再使用同一 plan_id 执行
+printf '{"jsonrpc":"2.0","id":9,"method":"release.cleanup","params":{"execute":false}}\n' \
+  | socat - UNIX-CONNECT:/tmp/bat-pid/bat.sock
+printf '{"jsonrpc":"2.0","id":10,"method":"release.cleanup","params":{"execute":true,"plan_id":"<plan-id>"}}\n' \
+  | socat - UNIX-CONNECT:/tmp/bat-pid/bat.sock
 ```