@seanyao/roll 3.611.3 → 3.613.1

package/CHANGELOG.md

@@ -2,6 +2,75 @@
 
 ## Unreleased
 
+## v3.613.1 — 2026-06-13
+
+### 稳定性
+
+- `roll release` 事务健壮性：任一步骤依赖抛错（提交闸拦截、网络故障…）都归为该步的有序中止而非裸栈；带测试证明提交闸的仓库（roll 自身）先刷新证明重试一次再提交（FIX-277，发版实战首跑揪出） `[release]`
+  <!-- evidence: .roll/features/release-management/FIX-277/latest/FIX-277-report.html -->
+
+- `roll setup skills` 在全局安装环境不再向安装树写 guide 文档撞 ENOENT 崩栈：安装树无目录清单可维护，单行提示后跳过；源码仓行为不变（FIX-276） `[cli]`
+  <!-- evidence: .roll/features/documentation/FIX-276/latest/FIX-276-report.html -->
+
+- cycle worktree 依赖安装失败会直接以失败终态和 `[FAIL] worktree deps bootstrap failed` ALERT 暴露，并清理空 worktree，不再继续烧 agent 后误落 `idle_no_work`（FIX-268） `[loop]`
+
+### 新功能
+
+- `roll release` 收口为唯一发版命令：一条事务（版本号→折叠 changelog→包闸→发版 PR→等合并→快进 main→一致性闸→推 tag），每个不可逆步骤前都有闸，失败 fail-loud 零半成品；ship/waiver/changelog/consistency 旧子命令物理删除（豁免路径不复存在——修掉漂移才能发）；CI 闸入口改 `roll release --gate-check`（US-REL-007） `[release]`
+  <!-- evidence: .roll/features/release-management/US-REL-007/latest/US-REL-007-report.html -->
+
+- 全站可复制命令芯片与数据新鲜度：周期账本行 → roll cycle、待交付行 → roll loop go/backlog promote、故事档案头 → 拾取命令（全部真实存在，点击 ✓ copied）；总览 generated 超 6h 亮"数据过期"警示，心跳 next 做客户端倒计时（US-DOSSIER-018） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-018/latest/US-DOSSIER-018-report.html -->
+
+- `roll cycle <id>` 单周期轨迹带：摘要行+story 行+垂直七段（色点+事实摘要，中途死掉的段显示"未达"不省略）+ PR/diff/story 证据指针；与 web 轨迹带同形同词表（US-CLI-013） `[cli]`
+  <!-- evidence: .roll/features/cli-simplification/US-CLI-013/latest/US-CLI-013-report.html -->
+
+- `roll cycles [--since 1d|3d|7d|all]` 升一等命令：周期账本每行周期号·结局·story·模型·tokens·花费·耗时，汇总行失败=failed+reverted+blocked 不吞，尾部 → roll cycle 提示；与 web 账本同聚合同词表（US-CLI-012） `[cli]`
+  <!-- evidence: .roll/features/cli-simplification/US-CLI-012/latest/US-CLI-012-report.html -->
+
+- 技能页签：审计条（N skills·violations·hub 总行数，与 audit-skills --strict 同口径）、四组契约清单带调用频次（自评分 note 口径），行展开看真实文件树（行数）、审计要件勾选、可复制目录路径与 SKILL.md 原文滚动区；清单从仓库目录实读防漂移（US-DOSSIER-017） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-017/latest/US-DOSSIER-017-report.html -->
+- 发版页签待交付与变更日志：待交付按史诗分组（行点进档案），变更日志从 merged PR 真相生成（pr:merge 事件优先、Done 行 PR# 注记兜底，行带 #N merged 证据链）；页底历史版本可折叠展开（含曾豁免标记）；闸门头 merged/pending 与两段同算术（US-DOSSIER-016） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-016/latest/US-DOSSIER-016-report.html -->
+- 发版页签六维一致性面板：闸门头（tag·判定·f/w/?·切版·上一版·merged/pending 进度条）+ 六维对账行（漂移卡可点跳待办搜索），合计与状态行严格同数，任一维 fail 明示挡发版；⑦data 维以提案虚线行呈现并链 FIX-248/249；附可复制 roll release consistency check 芯片（US-DOSSIER-015） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-015/latest/US-DOSSIER-015-report.html -->
+- 循环页签本机 agents 面板：每行运行器·版本·近72h周期与花费·可用状态（未检测置灰），展开看接入文件同步真相（✓/⟳/−），约定过期带琥珀标与可复制 roll setup 修复命令（US-DOSSIER-014） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-014/latest/US-DOSSIER-014-report.html -->
+- 循环页签周期账本：Today/3d/7d/All 范围切换实时重算（失败=failed+reverted+blocked 不吞），每行结局点·周期号·story·模型·tokens·花费·耗时，展开成 cycle→story→build→peer→ci→pr→end 七段轨迹带带证据（US-DOSSIER-013） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-013/latest/US-DOSSIER-013-report.html -->
+- 待办页签重设计：愿望页头、搜索+六态筛选 chips（总览光谱点击预置）、史诗手风琴（交付中/已落定分组），故事行带类型徽标·ID·迷你脊柱·claim↔truth 对照；epic/story 面包屑根改 Backlog 页签（US-DOSSIER-012） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-012/latest/US-DOSSIER-012-report.html -->
+- 看板升级五页签真相控制台：总览页三十秒读完判定条、循环心跳、三聚合卡与六态光谱，页签 hash 路由下钻返回不丢；品牌与 slogan 注入式；旧 ledger 暂驻待办页签（US-DOSSIER-011） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-011/latest/US-DOSSIER-011-report.html -->
+- 真相口径同源：`roll index` 一次聚合产出 TruthSnapshot，同一序列化同时内嵌 index.html 并写出 `truth.json`（机器可读）；reverted cycle 纳入失败计数不再被吞（US-DOSSIER-010） `[dossier]`
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-010/latest/US-DOSSIER-010-report.html -->
+
+### 性能
+
+- 建卡与 `roll index` 提速 5.4 倍（实测 41s → 7.6s，产物字节级不变）：索引一次树遍历、每卡 3 次 git 扫描合并为一次快照、全局趋势与反向依赖一次计算（FIX-275） `[cli]`
+  <!-- evidence: .roll/features/loop/FIX-275/latest/FIX-275-report.html -->
+- 技能自评分改走 TS 原生命令 `roll self-score`，幂等可重试；不再让 agent 把 TS bundle 当 bash 库 source（FIX-274） `[skills]`
+  <!-- evidence: .roll/features/skill-ecosystem/FIX-274/latest/FIX-274-report.html -->
+
+### 新功能
+
+- 评分成为 pairing 场景：score 阶段由异构配对 agent 给交付打分（note 带 scored-by 溯源），无候选/超时回落自评，永不阻塞 cycle；`roll pair init` 默认开 code+score 两阶段（US-PAIR-009） `[pairing]`
+  <!-- evidence: .roll/features/cross-agent-pairing/US-PAIR-009/latest/US-PAIR-009-report.html -->
+- `roll pair score <story>` 手动让配对 agent 打分；`roll self-score` 新增 `--fallback-reason` 记录回落原因；三技能契约改"配对优先、自评回落"，结对指南中英双轨更新（US-PAIR-010） `[pairing]`
+  <!-- evidence: .roll/features/cross-agent-pairing/US-PAIR-010/latest/US-PAIR-010-report.html -->
+
+## v3.612.2 — 2026-06-12
+
+### 稳定性
+
+- `roll loop go` 撞上运行中的 cycle 不再秒停，等锁释放后接着跑（FIX-269） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/FIX-269/spec.md -->
+- cycle worktree 在 agent 进场前先装好依赖，离线沙箱里测试也能跑（FIX-268 根因预防） `[loop]`
+- `roll attest --capture-command` 截图后不再弹 macOS 终止进程确认
+  <!-- evidence: .roll/features/acceptance-evidence/FIX-266/latest/FIX-266-report.html -->
+
+## v3.612.1 — 2026-06-12
+
 ### 新功能
 
 - `roll loop go` — 连续跑 backlog 到完成或暂停（US-GOAL-002） `[loop]`
@@ -33,8 +102,24 @@
   <!-- evidence: .roll/features/goal-mode/US-GOAL-006/latest/US-GOAL-006-report.html -->
 - `roll loop resume` 清失败计数，不再恢复即熔断（FIX-251） `[loop]`
   <!-- evidence: .roll/features/loop-engine/FIX-251/latest/FIX-251-report.html -->
+- loop 出网预检不再依赖 macOS 默认缺失的 GNU `timeout`，避免直连正常时误报 `egress blocked`（FIX-257） `[loop]`
 - 调度环境残留会被体检指出，不再静默污染 loop（FIX-232） `[loop]`
 
+### 稳定性
+
+- `roll loop go --cards` 不再沿用上次暂停的全量范围（FIX-259）
+- goal 失败原因现在直达状态页，不再只剩 `no_cycle_terminal`（FIX-260）
+- 验收证据不再只靠文字声明，缺截图会被指出（FIX-258）
+- `roll attest --capture-command` 不再把失败命令当验收通过（FIX-263）
+- `roll attest --capture-command` 相对路径按项目目录执行（FIX-262）
+
+### 工程和测试
+
+- `roll attest` 现在识别新卡的验收清单（FIX-261）
+  <!-- evidence: .roll/features/acceptance-evidence/FIX-261/latest/FIX-261-report.html -->
+- 新 worktree 跑 `roll test` 会自动补齐 skills（FIX-264）
+- goal/off/pause 的文档讲清了和定时 loop 的关系（FIX-256）
+
 
 ## v3.611.2 — 2026-06-11
 

package/README.md

@@ -45,7 +45,7 @@ First time through? Start with [Getting started](guide/en/getting-started.md).
 |---------|-------------|
 | **Autonomy · daily use** | |
 | `roll loop <on\|off\|now\|status\|runs\|log\|story\|events\|eval\|signals\|alert\|fmt\|pr-inbox\|mute\|unmute\|pause\|resume\|reset\|gc>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
-| `roll loop go [--epic <e>\|--cards <ids>] [--budget <usd>] [--for <duration>] [--review <auto\|hetero\|self\|off>]` | Run goal mode manually until the scoped work completes, pauses, or hits a budget/usage/timebox guardrail; final review defaults to `auto` |
+| `roll loop go [--epic <e>\|--cards <ids>] [--budget <usd>] [--for <duration>] [--review <auto\|hetero\|self\|off>]` | Run goal mode manually until the scoped work completes, pauses, or hits a budget/usage/timebox guardrail; it can run while the scheduler is off, and a paused loop should be resumed first; final review defaults to `auto` |
 | `roll loop goal` | Show persisted goal scope, review mode, usage, limits, safety gate, and last decision |
 | `roll brief` | Show latest owner brief |
 | `roll backlog [sync\|block\|defer\|lint\|…]` | View, manage, and sync (from GitHub Issues) pending tasks |
@@ -61,10 +61,10 @@ First time through? Start with [Getting started](guide/en/getting-started.md).
 | `roll offboard` | Remove Roll from this project |
 | `roll test [--where] [--reset]` | Run the test suite (routes through the isolation adapter; unknown types fail loud) |
 | `roll ci [--wait]` | Show or wait for current commit's CI status |
-| `roll release [ship\|waiver\|changelog\|consistency]` | Release guidance · changelog · consistency gate · gated tag push (`ship`) · recorded drift waiver (`waiver`) |
-| `roll release changelog generate [--write]` | Sync CHANGELOG from merged work |
-| `roll release consistency <check\|audit>` | Five-dimension gap check · US-TRUTH shadow drift audit (read-only, exit 0) |
-| `roll pair [init\|status]` | Cross-agent pairing: heterogeneous peer re-checks during builds |
+| `roll release [--dry-run]` | The ONE release flow: bump → changelog fold → package gate → PR → merge → consistency gate → tag push |
+| `roll pair [init\|status\|score]` | Cross-agent pairing: heterogeneous peer re-checks and scores deliveries |
+| `roll cycles [--since 1d\|3d\|7d\|all]` | The cycle ledger — one line per cycle, failures never swallowed |
+| `roll cycle <id>` | One cycle's full trace tape (cycle→story→build→peer→ci→pr→end) |
 | `roll peer [--reviewer <agent>] (--prompt <text>\|--file <path>)` | One-shot structured external-provider review; records `.roll/peer/runs.jsonl` |
 | **Config & machine** | |
 | `roll config [lang <zh\|en\|--reset>\|…]` | Read/write roll config (language, loop window, dream time) |