@seanyao/roll 3.608.1 → 3.610.1

package/CHANGELOG.md

@@ -1,5 +1,100 @@
 # Changelog
 
+## v3.610.1 — 2026-06-10
+
+### 稳定性
+
+- 故事档案改"按节点增量挂载"为主路：各生命周期节点把当场已知的产出挂上页面，全量重渲降级为显式 rebuild 修复工具，根治"合了但页面没动"（US-DOSSIER-007）
+
+### 可见性
+
+- 历史交付卡 legacy 状态语义：pre-v3 已 Done 卡(无 latest/无 ac-map)派生 legacy 标记，状态仍=完成+历史 chip，脊柱不再读证据假装半成品（US-DOSSIER-008）
+- backlog 状态机归一到单一强类型真相，渲染与调度与对账全部消费它，不再各自拿字符串猜状态（REFACTOR-047） `[loop]`
+
+### 工程和测试
+
+- 把 7 个曾比对旧引擎 oracle、现退化为确定性自校验的差异测试升级为真冻结期望快照（US-PORT-021b）
+
+### 其他
+
+- 把幻灯片渲染命令改写为 TS，脱离 bash 回落引擎（US-PORT-016）
+- 把待办管理写端命令改写为 TS，脱离 bash 回落引擎（US-PORT-019）
+- 所有命令脱回落后退役 bash 引擎并清残件（高爆破坏性收尾，人工放行）（US-PORT-021）
+- release ship 的确认提示在新版 Node 上仍会卡住，敲回车没反应，目前只能用免确认参数绕过，需彻底修交互读取（FIX-229） `[loop]`
+- dossier: redesign features index as a delivery board (status overview + foldable epics + lifecycle spine)（PR#560）
+- dossier: align features index status/type with backlog + 3-state grouping (delivery board)（PR#559）
+
+## v3.609.2 — 2026-06-09
+
+### 可见性
+
+- 交付档案首页改表格视图：epic 列表以 Epic / Progress / Stories 表格呈现，扫读对齐更顺（US-DOSSIER-005）
+- 交付档案按证据标完成：迁移来的 V2 历史卡按其标题 ✅ 标记显示为已交付，不再因缺 v3 验收报告而全标未交付（US-DOSSIER-006）
+
+### 其他
+
+- changelog generate 剔除已在某版本段发布的故事，不再在 Unreleased 过度累积；纯 PR / 手工条目保留（FIX-227）
+- roll release ship 的交互确认改为按行读 stdin，不再因等 EOF 在交互终端永久挂起（FIX-228）
+- 把 loop 日志与事件的只读子命令改写为 TS，脱离 bash 回落引擎（US-PORT-022 part 1）
+
+## v3.609.1 — 2026-06-09
+
+### 自动化流水线
+
+- 把 dream 调度剩余子命令改写为 TS，脱离 bash 回落引擎（US-PORT-020）
+- 交付段补可重建证据轻量版，含合并请求与集成结论与改动与交付方与成本与时间线（US-EVID-008）
+- 二阶闭环把成功率趋势回灌做自整定：roll tune 只读聚合 self-score/agent pass 率/误判/rubric 相关性，产阈值-路由-rubric 三类建议（仅建议、样本门+冷却防失真）（US-EVID-015）
+
+### 工程和测试
+
+- 确定性证据自动落盘，测试输出与覆盖率与产物都写进证据框（US-EVID-002）
+- attest 从迁移后的多故事 epic 文件抽取验收条目返回空，致已有 ac-map 的 Done 故事渲染成零条 AC（US-PORT-001 实证），改 resolveStoryAcItems 越过空壳 owner 取真 AC 文件（FIX-226）
+
+### 其他
+
+- 把项目初始化命令改写为 TS，脱离 bash 回落引擎（US-PORT-013）
+- 把技能挂载与约定分发命令改写为 TS，脱离 bash 回落引擎（US-PORT-014）
+- 把在线刷新模型价目的命令改写为 TS，脱离 bash 回落引擎（US-PORT-017）
+- 把切换与设置 agent 的写入命令改写为 TS，脱离 bash 回落引擎（US-PORT-018）
+- 修退役命令引用并立一页新手上手指南（US-DOC-GS-001）
+- 证据框在每个周期开头就立好，运行目录与证据归处先备好交给执行用（US-EVID-001）
+- 瞬态证据当场采，改前改后与验证时各截一张成对入框（US-EVID-003）
+- 收尾时由运行器确定性组装验收报告并刷新档案，不依赖代理记得（US-EVID-004）
+- 验收硬闸默认开启，标完成却无报告从提醒升级为发版闸拦截（US-EVID-005）
+- 证据生命周期相关文档中英双轨刷新收尾（US-EVID-006）
+- 档案脊柱口径对齐，老的已完成卡一次性补跑回填证据（US-EVID-007）
+- 自评分作为评分门禁参与通过与否，回归或低分能真的拦下完成（US-EVID-013）
+- 无人值守执行器，出错先归因再自动纠正，默认保守且不自动合主干且振荡移交刹车 — report: `.roll/features/acceptance-evidence/US-EVID-014/2026-06-08T23-03-10/US-EVID-014-report.html`
+- 无人值守安全刹车，同卡反复退回自动熔断暂停并加一页夜间运行晨报 — report: `.roll/features/acceptance-evidence/US-EVID-016/2026-06-08T23-54-55/US-EVID-016-report.html`
+- 跨代理结对的中英双轨文档刷新收尾（US-PAIR-007）
+- roll init 顺带生成 pairing 配置并在界面告知，新用户少一步且仍显式（US-PAIR-008）
+- site: roll-build explainer page (site-aligned, bilingual) + homepage CTA（PR#546）
+- site: track site/diagrams/ + roll-build skill infographic（PR#545）
+- site: roll-build 技能卡可点击跳转讲解页（PR#547）
+
+## v3.608.2 — 2026-06-08
+
+### 跨 Agent 结对（异构第二双眼睛）
+
+- 结对成为一等能力：交付后由一个**不同厂商**的 agent 单向复检改动，换视角多样性——理性挑选（只挑已装+可用+胜任+异构）、可复现轮换、无搭档如实留痕不静默（US-PAIR-001/003）`[pair]`
+- `roll pair init` 物化显式 `.roll/pairing.yaml`：文件在=开、删=关，默认值写进文件而非隐藏；`roll init` 也顺带生成，新项目零额外步骤，现有项目一条命令补上（US-PAIR-001/008）`[pair]`
+- `roll pair status` 看结对池：谁能结对、厂商、能力、谁因何被排除，外加**结对花了多少钱**（次数/搭档/成本），可观测不靠猜（US-PAIR-002/006）`[pair]`
+- 多阶段结对：设计/测试/代码/周期四个检查点可独立开关，默认仅代码（US-PAIR-004）`[pair]`
+- 配对越用越准：成本真实记账 + ε-greedy 偏好高命中异构对但保底探索不锁死多样性（US-PAIR-006）`[pair]`
+- 安全底线：30 秒硬超时、超时/出错不阻塞 cycle、绝不自行动主干（US-PAIR-003）`[pair]`
+
+### 可见性
+
+- 故事档案 = 一个故事的全部上下文入口：页顶 As a / I want / So that 原语 + CONTEXT + AC 内联 + 显眼可点的设计文档链接（US-DOSSIER-003）
+- 设计文档链接打开 markdown 渲染页而非裸文件（US-DOSSIER-004）
+- 验收证据可重跑：每条 AC 配一条任何人能照着重跑的验证命令 + 测试清单，证据从"看截图"升级到"自己能验"（US-EVID-010）
+
+### 工程和测试
+
+- `roll ci --wait` 移植到 TS：CI 等待门脱离 bash，逐轮裁定镜像 v2 顺序（US-PORT-015）
+- `roll release ship` 一条受闸命令完成 tag-push（发版第 4 步），一致性闸把关，npm publish 仍人工（US-REL-SHIP）
+- cleanup：`.codex/`、`.worktrees/` 进 .gitignore（per-machine 状态不入库）
+
 ## v3.608.1 — 2026-06-08
 
 ### 自动化流水线

package/README.md

@@ -37,17 +37,19 @@ roll loop on        # let AI work through the backlog (optional)
 ```
 
 `roll init` detects legacy code and routes you to `$roll-onboard` when appropriate.
+First time through? Start with [Getting started](guide/en/getting-started.md).
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | **Autonomy · daily use** | |
-| `roll loop <on\|off\|now\|status\|eval\|signals\|runs\|story\|monitor\|…>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
+| `roll loop <on\|off\|now\|status\|eval\|signals\|runs\|story\|…>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
 | `roll brief` | Show latest owner brief |
 | `roll backlog [sync\|block\|defer\|lint\|…]` | View, manage, and sync (from GitHub Issues) pending tasks |
 | `roll peer` | Cross-agent negotiation & review |
 | `roll alert` | View / clear loop alerts |
+| `roll tune [reset]` | Suggest-only self-tuning: surface threshold / route / rubric adjustments from loop trends — read-only, never auto-applies |
 | **Project · per repo** | |
 | `roll init` | Set up Roll in this project |
 | `roll story new <ID> --title <t> [--epic <e>]` | Mint a story's card folder (spec + page + index) — the single creation channel |
@@ -70,8 +72,7 @@ Dev side — a pnpm monorepo. Publish side — one npm package.
 
 ```
 packages/      TypeScript engine (pnpm workspaces): spec · core · infra · cli · web
-bin/roll       Frozen bash v2 engine — automatic fallback + the diff-test oracle
-lib/           Runtime companions (python/sh) used by the loop & fallback paths
+lib/           Runtime companions (python/sh) used by the loop
 skills/        Git submodule → seanyao/roll-skills (the agent skill contracts)
 conventions/   Conventions synced into AI clients by `roll setup`
 template/      Project scaffolding installed by `roll init`
@@ -85,9 +86,9 @@ Published as a single npm package `@seanyao/roll`: `dist/` (TS bundled by esbuil
 
 | | |
 |---|---|
-| **Start here** | [Overview & architecture](guide/en/overview.md) · [Engineering methodology](guide/en/methodology.md) |
+| **Start here** | [Getting started](guide/en/getting-started.md) · [Overview & architecture](guide/en/overview.md) · [Engineering methodology](guide/en/methodology.md) |
 | **Daily driving** | [The loop (autonomous executor)](guide/en/loop.md) · [Configuration](guide/en/configuration.md) · [Pricing & cost](guide/en/pricing.md) · [FAQ](guide/en/faq.md) |
-| **Quality machinery** | [Acceptance evidence (`roll attest`)](guide/en/acceptance-evidence.md) · [Consistency & release gate](guide/en/consistency.md) · [Test isolation](guide/en/test-isolation.md) |
+| **Quality machinery** | [Acceptance evidence (`roll attest`)](guide/en/acceptance-evidence.md) · [Evidence lifecycle](guide/en/acceptance-evidence.md#lifecycle-in-three-stages) · [Consistency & release gate](guide/en/consistency.md) · [Cross-agent pairing](guide/en/pairing.md) · [Test isolation](guide/en/test-isolation.md) |
 | **Under the hood** | [Architecture: layers · domain · invariants](docs/architecture.md) · [Verification system](docs/verification.md) · [Manifesto](docs/manifesto.md) |
 
 Full guide index: [guide/en/](guide/en/) — agents, peer review, slides, feedback, backlog sync, adoption patterns, and more.