@seanyao/roll 3.606.2 → 3.607.1

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## v3.607.1 — 2026-06-07
+
+### 可见性
+
+- detectLiveCycle 僵尸周期污染：无 cycle:end 的僵尸周期被误判为"当前正在运行"，叠加 state.current_item 过期，dashboard 头行显示已交付数小时的旧故事；已加 >2h 僵尸跳过+最近活跃优先（FIX-217） `[loop]`
+
+### 其他
+
+- 验收闸查旧档案位：迁移后真报告被判缺失，硬闸假阴性逼出双账，闸址改与写端同源（FIX-216） `[loop]`
+- roll peer mktemp 竞态 + 解析器无法解析自然语言决议；已加 PID 防竞态 + prompt 要求 Resolution: 行 + 解析器优先读该行（FIX-219） `[loop]`
+- 层层嵌套索引站：从总览到史诗到卡片到报告全程可点击浏览（US-META-003）
+- 建卡时自动生成 story 定义文件和全景报告骨架，后续阶段逐步填充（US-META-005）
+- 交付与终评产物写入 story 文件夹，与验收报告同处一层（US-META-006）
+- 存量 story 数据迁移命令：补定义文件、建文件夹、跳过多故事文件并保留反向引用（US-META-007）
+
+## v3.606.3 — 2026-06-06
+
+### 新功能
+
+- 档案制写入端：待办与交付物同夹的布局支持，含编号到史诗的索引与垃圾回收命令（US-META-001）
+
+### 稳定性
+
+- 版本探针读冻结引擎的化石串：version 显示旧号、update 自检误报、升级 nag 永不消失，三症同根（FIX-202） `[loop]`
+
+### 可见性
+
+- 完成状态抢跑：PR 还没合并卡片就翻了完成，违反完成即已合主干的纪律（FIX-211） `[loop]`
+- 面板对历史全瞎：周期记录缺时间戳，八次真实交付显示零，统计无从分桶（FIX-213） `[loop]`
+- 面板对运行中的周期全盲：活性探测还读旧信号，真在干活却显示空闲零周期（FIX-203） `[loop]`
+- (最小核) — roll loop now 改前台直跑:重入本 CLI run-once,agent 转录经 ROLL_LOOP_STREAM 实时打到当前终端(零 tmux 零弹窗零 tail);launchd 排程仍走静默 runner;buffered 用量采集不变 (#470)（US-PORT-011）
+
+### 自动化流水线
+
+- 终态失真：真实交付已合并完成，周期记录却写失败，失败语义被稀释（FIX-214） `[loop]`
+- 无人值守周期自产实拍：给截屏调度器加终端通道，无图形环境时诚实跳过留痕（US-ATTEST-011）
+- roll release v3 原生重写：版本号引导、changelog、PR 与 tag 流程提示；发版闸已在 CI（US-PORT-004）
+- loop 读面子命令 TS 薄读取（eval、runs、story、signals）；tmux 流的 monitor 与 attach 退役（US-PORT-007）
+- dream 服务出 v3 runner（复用调度模板模式）或裁定退役；现状是断链僵尸（US-PORT-008）
+- loop cycle cycle-20260606-050516-6852 (#477)（PR#477）
+
+### 工程和测试
+
+- 迁移命令嵌套仓盲区：对私仓的搬迁打到主仓上，吞错自报成功，修执行面并补嵌套形态测试（FIX-215） `[loop]`
+- 档案迁移命令：读索引按清单搬树改名重建链，演练模式先行，可重入有测试（US-META-002a）
+- difftest 卸 oracle：领域服务层一批对拍全部转冻结期望，测试期不再起 bash 或 python 引擎（US-PORT-009b）
+
+### 其他
+
+- v3 心脏首跑即瘫：skill 路径化石致 agent 盲开、改动漏回主仓、被杀不留痕、cycle 不可观测；修解析+钉题+连 .roll+信号善后+tmux 观测窗（FIX-204） `[loop]`
+- 交付可以悄悄跳过验收报告：文本约束没牙，缺报告要在运行时留痕可审计，政策可升硬闸（FIX-207） `[loop]`
+- 排程静默死亡：启用命令吞掉挂载失败照报成功，三小时无 tick 全靠人肉掩盖（FIX-212） `[loop]`
+- 验收证据惯例升级：文本证据属 agent 自述可伪造，CLI 卡默认改为真实终端截屏走独立捕获通道，文本降级为补充（US-ATTEST-010）
+- 验收口径补全：失败与阻塞有名分、敏感信息进档前遮蔽、报告生成后冒烟自检（US-ATTEST-012）
+- 验收报告分层且自含待办全貌：卡情上下文与业务结论在前技术折叠，空章节裁剪，设计审查不改证据（US-ATTEST-013）
+- 过程内联进报告：时间线与关键转折加折叠全转录，无人过程也可回溯（US-ATTEST-014）
+- 执行存量迁移：演练过目后真跑，重写唯一活引用，全仓对账校验存档（US-META-002b）
+- skills 验收文案同步新档案布局，跨仓改 roll-skills 后 bump submodule manual-only（US-META-004）
+- changelog 生成同输入两次运行结果漂移：探针偶发失败静默切换过滤分支，17 条目消失（FIX-199） `[loop]`
+- 观测窗可读性：裸流换三层关键节点转录，信号口径与验收报告时间线同源（US-PORT-012）
+- roll brief TS 化：汇报口吻保留，默认一屏精简、细节折叠，跟随 locale 单语；agent 经结构化流只取终稿，绝不漏思考过程（US-PORT-002）
+- roll idea TS 化：分类、自动编号、过 lint 规则落卡，与 backlog 存取同源（US-PORT-003）
+- changelog 确定性输出转正：AI 润色降级为可选路径或退役，默认不再回落 bash（US-PORT-005）
+- config 写面 TS 化，整个 config 命令收口（US-PORT-006）
+- difftest 卸 oracle 第一步：立可复用的冻结期望转换范式，先转规格层与基础设施层两批验证可行（US-PORT-009a）
+- difftest 卸 oracle：命令行只读命令一批对拍转冻结期望（US-PORT-009c）
+
 ## v3.606.2
 
 ### 稳定性

package/bin/roll

@@ -4,7 +4,7 @@ set -euo pipefail
 # Roll — AI Agent Convention Manager
 # Single source of truth for how all AI coding agents behave.
 
-VERSION="3.0.0"
+VERSION="3.606.3"
 ROLL_HOME="${ROLL_HOME:-${HOME}/.roll}"
 ROLL_CONFIG="${ROLL_HOME}/config.yaml"
 ROLL_GLOBAL="${ROLL_HOME}/conventions/global"
@@ -1948,7 +1948,7 @@ _check_installed_version_or_retry() {
   local expected installed pkg_dir
   expected="$(npm view @seanyao/roll version 2>/dev/null || true)"
   pkg_dir="$(npm root -g 2>/dev/null || true)"
-  installed="$(grep "^VERSION=" "${pkg_dir}/@seanyao/roll/bin/roll" 2>/dev/null | sed 's/VERSION="\([^"]*\)"/\1/' || true)"
+  installed="$(_tree_version "${pkg_dir}/@seanyao/roll")"  # FIX-202: package.json, not fossil VERSION=
 
   [[ -z "$expected" || -z "$installed" ]] && return 0
 
@@ -1957,7 +1957,7 @@ _check_installed_version_or_retry() {
     npm cache clean --force &>/dev/null || true
     npm install -g @seanyao/roll@latest &>/dev/null || true
     local after
-    after="$(grep "^VERSION=" "${pkg_dir}/@seanyao/roll/bin/roll" 2>/dev/null | sed 's/VERSION="\([^"]*\)"/\1/' || true)"
+    after="$(_tree_version "${pkg_dir}/@seanyao/roll")"
     if [[ -n "$after" && "$after" != "$expected" ]]; then
       warn "$(msg update.still_mismatch "$after")"
     fi
@@ -1987,7 +1987,7 @@ cmd_update() {
     fi
 
     local new_version
-    new_version="$(grep "^VERSION=" "$ROLL_PKG_DIR/bin/roll" 2>/dev/null | sed 's/VERSION="\([^"]*\)"/\1/' || true)"
+    new_version="$(_tree_version "$ROLL_PKG_DIR")"  # FIX-202: package.json, not fossil VERSION=
     if [[ -n "$new_version" ]]; then
       info "$(msg update.new_version "$new_version")"
     fi
@@ -3960,7 +3960,7 @@ _peer_dispatch_in_tmux() {
   local session="$1" cmd_str="$2" out_file="$3" err_file="$4" timeout="${5:-180}"
   local done_file="${out_file}.done"
   local inner
-  inner=$(mktemp /tmp/roll-peer-inner-XXXXXX.sh)
+  inner=$(mktemp /tmp/roll-peer-inner-$$-XXXXXX.sh)
   {
     printf '#!/bin/bash -l\n'
     # FIX-050: portable PATH assembly (was hardcoded /opt/homebrew/bin)
@@ -4074,9 +4074,12 @@ _peer_call() {
 _peer_parse_resolution() {
   local output="$1"
   local resolution
-  # Match AGREE/REFINE/OBJECT/ESCALATE near line start (only non-letters before it)
-  # Covers: **AGREE**, ### 结论：AGREE, - AGREE:, * REFINE, OBJECT — ...
-  resolution="$(printf '%s\n' "$output" | grep -oiE '^[^a-zA-Z]*\b(AGREE|REFINE|OBJECT|ESCALATE)\b' | head -1 | grep -oiE '\b(AGREE|REFINE|OBJECT|ESCALATE)\b' | tr '[:lower:]' '[:upper:]')"
+  # Prefer explicit "Resolution:" or "决议：" line (most reliable).
+  resolution="$(printf '%s\n' "$output" | grep -oiE '^(Resolution|决议)\s*:\s*(AGREE|REFINE|OBJECT|ESCALATE)\b' | head -1 | grep -oiE '\b(AGREE|REFINE|OBJECT|ESCALATE)\b' | tr '[:lower:]' '[:upper:]')"
+  if [[ -z "$resolution" ]]; then
+    # Fallback: keyword at line start (legacy, kimi natural-language detection).
+    resolution="$(printf '%s\n' "$output" | grep -oiE '^[^a-zA-Z]*\b(AGREE|REFINE|OBJECT|ESCALATE)\b' | head -1 | grep -oiE '\b(AGREE|REFINE|OBJECT|ESCALATE)\b' | tr '[:lower:]' '[:upper:]')"
+  fi
   printf '%s\n' "$resolution"
 }
 
@@ -4197,7 +4200,7 @@ cmd_peer() {
   fi
 
   local prompt
-  prompt="[PEER_REVIEW round=${round} tool=${from_tool}→${to_tool}]\n\n${context}"
+  prompt="[PEER_REVIEW round=${round} tool=${from_tool}→${to_tool}]\n\n${context}\n\n---\n请以以下格式结束你的回复（必须单独一行）：\nResolution: AGREE|REFINE|OBJECT"
 
   local peer_session=""
   if command -v tmux >/dev/null 2>&1; then
@@ -15326,6 +15329,31 @@ _notify_update() {
   warn "$(msg update.available "$latest")"
 }
 
+# FIX-202: read an install tree's version — package.json is the single source of
+# truth (v3 bumps it on release); the bin/roll VERSION= literal is only a
+# last-resort fallback for a tree predating the package.json convention. Used for
+# $VERSION (the running version) and by the update self-checks. Defined at the
+# foot so the resolution runs after every helper is sourced and so it adds no
+# lines above the line-coupled extraction regions other difftests rely on.
+_tree_version() {
+  local tree="$1" v=""
+  if [[ -f "${tree}/package.json" ]]; then
+    v="$(grep -m1 '"version"' "${tree}/package.json" 2>/dev/null \
+      | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' || true)"
+  fi
+  if [[ -z "$v" ]]; then
+    v="$(grep "^VERSION=" "${tree}/bin/roll" 2>/dev/null \
+      | sed 's/.*VERSION="\([^"]*\)".*/\1/' || true)"
+  fi
+  echo "$v"
+}
+
+# The running version is the tree containing THIS bin/roll ($(dirname SCRIPT_DIR)),
+# independent of any ROLL_PKG_DIR override (tests isolate the curl-swap tree there).
+_running_v="$(_tree_version "$(dirname "$SCRIPT_DIR")")"
+[[ -n "$_running_v" ]] && VERSION="$_running_v"
+unset _running_v
+
 if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
   _check_update_async
   main "$@"