@seanyao/roll 3.620.1 → 3.621.1

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## Unreleased
 
+## v3.621.1 — 2026-06-21
+
+### 修复
+
+- **watch 事件行时间戳与状态行统一显示设备本地时区**：之前事件行硬编码 UTC 渲染（`getUTCHours`），状态行却走本地时区，同屏出现时差；`cycle:terminal`、`report:morning` 等事件类型也落到了 "unsupported event" 无意义渲染。现在时间戳统一走设备本地时区，新增 `cycle:terminal` 和 `report:morning` 的显式渲染，未知事件干净降级不再显示 "unsupported event"。(FIX-385) `[loop-engine]`
+
+- **loop 不再盲目重选「在飞」的卡**：发 PR 后卡↔PR 连接不再断裂（`pr=None` 根治），reconcile 对 gh 探测失败也稳健守住 🔨，CI 红不再只是报警——走 fix-forward 恢复原分支修而非从头重选。(FIX-384) `[loop-engine]`
+
+- `roll loop watch` 状态行现在正确显示故事和 agent `[loop]`
+
+- **无人值守 loop 现在能为可视卡真正截图，不再空转挂起**：之前 loop 在 cycle 工作树里跑网页截图时，因为工作树没装 playwright 依赖（`require('playwright')` 找不到模块）就直接跳过，带页面证据的卡验收报告成了空壳、纠正熔断把整条 loop 停掉。现在截图失败会自动回退到能在工作树里跑、且会自愈安装浏览器的 headless 命令行路径，可视卡得以在无人值守下真正截图并交付。(FIX-379) `[acceptance-evidence]`
+
+- **建卡校验和交付期校验现在同一把尺子，杜绝「能建出来、一进 loop 必失败」的毒卡**：一张卡声明的「交付演示命令」，`roll story validate` 在建卡时就用和交付截图时完全相同的白名单来判（必须是 roll 的只读命令、不含 shell 特殊字符、不是会改状态的命令），并对 `watch` 这类一直刷屏不退出的流式命令明确提示——不能直接当交付命令，请加 `--once`/快照模式或声明无需截图。之前两处各判各的，能建出「建卡时绿、交付时必被拒」的卡，一进 loop 必失败、攒够三次还会熔断整条 loop。(FIX-383) `[loop-engine]`
+
+### 变更
+
+- **交付状态改用结构化账本追踪，卡的状态更准、不再靠「读文字猜」**：loop 判断一张卡有没有真正交付（发了 PR 没、合进 main 没、CI 红还是绿），现在统一从一份结构化的交付记录账本读取，不再去解析 backlog 的中文文字和正则猜测。好处是状态显示更可靠、少了「明明合并了却还显示待办」这类漂移和误判，backlog 的状态栏变成这份账本的派生展示；账本只追加不改写、跨多个工作树共享、原子落盘，避免并发写坏。配套落地：交付记录的数据类型与生命周期状态（和「评审裁定」彻底分开）、唯一的查询入口函数、消费侧改读结构化记录、运行账本改只追加消除并发部分写、架构文档同步说明这套机制。(US-TRUTH-013 / US-TRUTH-014 / US-TRUTH-016 / US-TRUTH-017 / US-TRUTH-019 / US-TRUTH-020) `[feedback-truth-alignment]`
+
 ## v3.620.1 — 2026-06-20
 
 ### 修复