From ce6d3c6debf4ac9ee5cb096cc68ebb8b5840d255 Mon Sep 17 00:00:00 2001
From: Codex <codex@noreply.local>
Date: Wed, 20 May 2026 04:31:15 +0000
Subject: [PATCH] docs: update commander queue brief

---
 docs/report/202605/20260520_Commander.md | 61 ++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/docs/report/202605/20260520_Commander.md b/docs/report/202605/20260520_Commander.md
index b0df375e..5f4c381e 100644
--- a/docs/report/202605/20260520_Commander.md
+++ b/docs/report/202605/20260520_Commander.md
@@ -115,3 +115,64 @@ worker prompt 必须包含目标分支，final response 必须报告：
 - 该 commit 是否可从 `origin/<target-branch>` 获取。
 
 “push to master” 或 “push current branch” 这类含糊说法不再满足指挥官派单要求。
+
+## 更新 2026-05-20 04:22 UTC
+
+已将指挥简报和长期指挥规则中文化并推送：
+
+- commit：`7dd947a`
+- 分支：`master`
+- 内容：
+  - 新增 `docs/report/202605/20260520_Commander.md`；
+  - 将 `docs/reference/code-queue-supervision.md` 整体改为中文；
+  - 固化“目标分支必须显式写入 prompt 和 final response”的指挥规则。
+
+同时派出 #16 恢复任务：
+
+- task：`codex_1779250940463_1`
+- queue：`infra`
+- 目标分支：`master`
+- 任务目标：核实 `codex_1779248781778_1` 声称的 commit `ed6f8a0586c0423eca4f3763fe0cf4ebd25ab0f6` 为什么远端不可见；如果 worker worktree 中存在该 commit，则 rebase/merge 到最新 `origin/master` 并推送；如果不存在，则报告原因或低风险恢复最小实现。
+
+队列态势：
+
+- 运行中：2（#12 后端、#12 前端）
+- 排队中：5（新增 #16 恢复任务后，infra 队列也有待执行任务）
+- 完成未读：#16 原任务仍未读，等待恢复任务或人工审阅结论。
+
+## 更新 2026-05-20 04:31 UTC
+
+指挥官仓库已按单一 `master` worktree 规则快进到最新远端：
+
+- 当前 `origin/master`：`f9b190945d5e7b53adeac29a37df22f92fc7843c`
+- 提交信息：`feat: tighten code queue supervision cli`
+- 来源：#16 恢复任务 `codex_1779250940463_1`
+- `git ls-remote origin refs/heads/master` 已能看到同一个 hash。
+
+#16 当前判断：
+
+- 原任务 `codex_1779248781778_1` 仍处于完成未读，不能直接批量标记已读。
+- 原任务声明的 `ed6f8a0586c0423eca4f3763fe0cf4ebd25ab0f6` 仍不是当前远端头，但恢复任务已经把等价后继实现推到 `master` 的 `f9b1909`。
+- 恢复任务仍在运行，正在解释原任务为什么 succeeded 后远端不可见；等恢复任务终态后再审阅并决定是否接受原 #16。
+
+新 CLI 的监督能力已经生效：
+
+- `bun scripts/cli.ts codex tasks --unread --limit 10` 现在只返回完成未读任务，不再退化为全量 overview。
+- `bun scripts/cli.ts codex tasks --view supervisor --limit 10` 能显示 running、completedUnread、queued 和每个任务的 drill-down 命令。
+- `codex queues` 仍显示 `split-brain`，但 `splitBrainLive=true`、`effectiveLiveness=live`，heartbeat 新鲜，按长期规则继续监督。
+
+队列态势：
+
+- 运行中：3
+  - `codex_1779247828759_1`：#12 frontend，报告实际部署已切到 `6e86d36` 且 service-proxy `/health` 确认新 commit；当前摩擦点是部署脚本定位 pod 的 selector 过旧，worker 正在修 fallback。
+  - `codex_1779247780398_1`：#12 backend/API，已完成设计 pass，正在做窄范围编辑。
+  - `codex_1779250940463_1`：#16 恢复，已推送 `f9b1909` 到 `master`，仍在补原因分析。
+- 排队中：4
+  - #13 backend/API stats：`codex_1779248021103_1`
+  - #13 frontend stats：`codex_1779248052767_1`
+  - #14 split-brain UI：`codex_1779248189933_1`
+  - #15 PR 支持：`codex_1779248492207_1`
+
+长期化建议：
+
+- 部署脚本的“部署失败”判定不能只依赖单一 pod selector；如果服务健康和 live commit 已符合预期，脚本应明确区分“部署成功但验证 selector 需要 fallback”和“服务实际未部署成功”。