@seanyao/roll 3.607.2 → 3.609.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/CHANGELOG.md +94 -0
  2. package/README.md +9 -4
  3. package/dist/roll.mjs +17019 -11082
  4. package/package.json +3 -4
  5. package/skills/roll-.changelog/SKILL.md +2 -2
  6. package/skills/roll-build/SKILL.md +23 -11
  7. package/skills/roll-design/SKILL.md +3 -2
  8. package/skills/roll-fix/SKILL.md +19 -8
  9. package/skills/roll-loop/SKILL.md +3 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,99 @@
1
1
  # Changelog
2
2
 
3
+ ## Unreleased
4
+
5
+ ## v3.609.2 — 2026-06-09
6
+
7
+ ### 可见性
8
+
9
+ - 交付档案首页改表格视图：epic 列表以 Epic / Progress / Stories 表格呈现，扫读对齐更顺（US-DOSSIER-005）
10
+ - 交付档案按证据标完成：迁移来的 V2 历史卡按其标题 ✅ 标记显示为已交付，不再因缺 v3 验收报告而全标未交付（US-DOSSIER-006）
11
+
12
+ ### 其他
13
+
14
+ - changelog generate 剔除已在某版本段发布的故事，不再在 Unreleased 过度累积；纯 PR / 手工条目保留（FIX-227）
15
+ - roll release ship 的交互确认改为按行读 stdin，不再因等 EOF 在交互终端永久挂起（FIX-228）
16
+ - 把 loop 日志与事件的只读子命令改写为 TS，脱离 bash 回落引擎（US-PORT-022 part 1）
17
+
18
+ ## v3.609.1 — 2026-06-09
19
+
20
+ ### 自动化流水线
21
+
22
+ - 把 dream 调度剩余子命令改写为 TS，脱离 bash 回落引擎（US-PORT-020）
23
+ - 交付段补可重建证据轻量版，含合并请求与集成结论与改动与交付方与成本与时间线（US-EVID-008）
24
+ - 二阶闭环把成功率趋势回灌做自整定：roll tune 只读聚合 self-score/agent pass 率/误判/rubric 相关性，产阈值-路由-rubric 三类建议（仅建议、样本门+冷却防失真）（US-EVID-015）
25
+
26
+ ### 工程和测试
27
+
28
+ - 确定性证据自动落盘，测试输出与覆盖率与产物都写进证据框（US-EVID-002）
29
+ - attest 从迁移后的多故事 epic 文件抽取验收条目返回空，致已有 ac-map 的 Done 故事渲染成零条 AC（US-PORT-001 实证），改 resolveStoryAcItems 越过空壳 owner 取真 AC 文件（FIX-226）
30
+
31
+ ### 其他
32
+
33
+ - 把项目初始化命令改写为 TS，脱离 bash 回落引擎（US-PORT-013）
34
+ - 把技能挂载与约定分发命令改写为 TS，脱离 bash 回落引擎（US-PORT-014）
35
+ - 把在线刷新模型价目的命令改写为 TS，脱离 bash 回落引擎（US-PORT-017）
36
+ - 把切换与设置 agent 的写入命令改写为 TS，脱离 bash 回落引擎（US-PORT-018）
37
+ - 修退役命令引用并立一页新手上手指南（US-DOC-GS-001）
38
+ - 证据框在每个周期开头就立好，运行目录与证据归处先备好交给执行用（US-EVID-001）
39
+ - 瞬态证据当场采，改前改后与验证时各截一张成对入框（US-EVID-003）
40
+ - 收尾时由运行器确定性组装验收报告并刷新档案，不依赖代理记得（US-EVID-004）
41
+ - 验收硬闸默认开启，标完成却无报告从提醒升级为发版闸拦截（US-EVID-005）
42
+ - 证据生命周期相关文档中英双轨刷新收尾（US-EVID-006）
43
+ - 档案脊柱口径对齐，老的已完成卡一次性补跑回填证据（US-EVID-007）
44
+ - 自评分作为评分门禁参与通过与否，回归或低分能真的拦下完成（US-EVID-013）
45
+ - 无人值守执行器，出错先归因再自动纠正，默认保守且不自动合主干且振荡移交刹车 — report: `.roll/features/acceptance-evidence/US-EVID-014/2026-06-08T23-03-10/US-EVID-014-report.html`
46
+ - 无人值守安全刹车，同卡反复退回自动熔断暂停并加一页夜间运行晨报 — report: `.roll/features/acceptance-evidence/US-EVID-016/2026-06-08T23-54-55/US-EVID-016-report.html`
47
+ - 跨代理结对的中英双轨文档刷新收尾（US-PAIR-007）
48
+ - roll init 顺带生成 pairing 配置并在界面告知，新用户少一步且仍显式（US-PAIR-008）
49
+ - site: roll-build explainer page (site-aligned, bilingual) + homepage CTA（PR#546）
50
+ - site: track site/diagrams/ + roll-build skill infographic（PR#545）
51
+ - site: roll-build 技能卡可点击跳转讲解页（PR#547）
52
+
53
+ ## v3.608.2 — 2026-06-08
54
+
55
+ ### 跨 Agent 结对（异构第二双眼睛）
56
+
57
+ - 结对成为一等能力：交付后由一个**不同厂商**的 agent 单向复检改动，换视角多样性——理性挑选（只挑已装+可用+胜任+异构）、可复现轮换、无搭档如实留痕不静默（US-PAIR-001/003）`[pair]`
58
+ - `roll pair init` 物化显式 `.roll/pairing.yaml`：文件在=开、删=关，默认值写进文件而非隐藏；`roll init` 也顺带生成，新项目零额外步骤，现有项目一条命令补上（US-PAIR-001/008）`[pair]`
59
+ - `roll pair status` 看结对池：谁能结对、厂商、能力、谁因何被排除，外加**结对花了多少钱**（次数/搭档/成本），可观测不靠猜（US-PAIR-002/006）`[pair]`
60
+ - 多阶段结对：设计/测试/代码/周期四个检查点可独立开关，默认仅代码（US-PAIR-004）`[pair]`
61
+ - 配对越用越准：成本真实记账 + ε-greedy 偏好高命中异构对但保底探索不锁死多样性（US-PAIR-006）`[pair]`
62
+ - 安全底线：30 秒硬超时、超时/出错不阻塞 cycle、绝不自行动主干（US-PAIR-003）`[pair]`
63
+
64
+ ### 可见性
65
+
66
+ - 故事档案 = 一个故事的全部上下文入口：页顶 As a / I want / So that 原语 + CONTEXT + AC 内联 + 显眼可点的设计文档链接（US-DOSSIER-003）
67
+ - 设计文档链接打开 markdown 渲染页而非裸文件（US-DOSSIER-004）
68
+ - 验收证据可重跑：每条 AC 配一条任何人能照着重跑的验证命令 + 测试清单，证据从"看截图"升级到"自己能验"（US-EVID-010）
69
+
70
+ ### 工程和测试
71
+
72
+ - `roll ci --wait` 移植到 TS：CI 等待门脱离 bash，逐轮裁定镜像 v2 顺序（US-PORT-015）
73
+ - `roll release ship` 一条受闸命令完成 tag-push（发版第 4 步），一致性闸把关，npm publish 仍人工（US-REL-SHIP）
74
+ - cleanup：`.codex/`、`.worktrees/` 进 .gitignore（per-machine 状态不入库）
75
+
76
+ ## v3.608.1 — 2026-06-08
77
+
78
+ ### 自动化流水线
79
+
80
+ - 非 claude agent 的 loop 观察窗不再黑屏：套伪终端逐行直播，进程组清杀不留孤儿（FIX-224） `[loop]`
81
+ - 断网不再误伤：网络不可达时周期降级为本地交付，输出提示而非报错，连败不累计、不误触自动暂停（IDEA-001） `[loop]`
82
+
83
+ ### 可见性
84
+
85
+ - 三层交付档案：roll index 重建首页总账（愿望→事实进度）、史诗页、故事五站档案，全部来自真实模型可逐层下钻（US-DOSSIER-001a~d）
86
+
87
+ ### 工程和测试
88
+
89
+ - 验收命令认出卡片文件夹布局：别处一句提及不再劫走归档位置，报告与 AC 解析归位（FIX-225）
90
+ - 旧档案树退役收尾：卡片文件夹成为运行产物唯一的家，读取兼容移除（US-META-002c）
91
+ - 卡片契约进发版闸：活卡必须有卡片文件夹、证据链接不许悬空，史前卡只计数不拦截（US-CONSIST-006）
92
+ - 铸卡单一通道：roll story new 一条命令建卡，拒绝覆盖；每次验收收尾自动刷新档案索引（US-META-009）
93
+ - 自评笔记归卡：故事自评住进卡片文件夹，看板趋势与档案复盘双源合并读（US-META-008）
94
+ - 发版就绪判定认两种形态：Unreleased 段或预写好的下一版本段都算 changelog 就绪（FIX-226）
95
+ - 文档与官网一致性清扫两轮：档案单一家、四槽路由、降级模式、六维闸全部对齐实现（指南中英 + skills + README）
96
+
3
97
  ## v3.607.2 — 2026-06-07
4
98
 
5
99
  ### 自动化流水线
package/README.md CHANGED
@@ -37,21 +37,26 @@ roll loop on # let AI work through the backlog (optional)
37
37
  ```
38
38
 
39
39
  `roll init` detects legacy code and routes you to `$roll-onboard` when appropriate.
40
+ First time through? Start with [Getting started](guide/en/getting-started.md).
40
41
 
41
42
  ## Commands
42
43
 
43
44
  | Command | Description |
44
45
  |---------|-------------|
45
46
  | **Autonomy · daily use** | |
46
- | `roll loop <on\|off\|now\|status\|eval\|signals\|runs\|story\|monitor\|…>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
47
+ | `roll loop <on\|off\|now\|status\|eval\|signals\|runs\|story\|…>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
47
48
  | `roll brief` | Show latest owner brief |
48
49
  | `roll backlog [sync\|block\|defer\|lint\|…]` | View, manage, and sync (from GitHub Issues) pending tasks |
49
50
  | `roll peer` | Cross-agent negotiation & review |
50
51
  | `roll alert` | View / clear loop alerts |
52
+ | `roll tune [reset]` | Suggest-only self-tuning: surface threshold / route / rubric adjustments from loop trends — read-only, never auto-applies |
51
53
  | **Project · per repo** | |
52
54
  | `roll init` | Set up Roll in this project |
55
+ | `roll story new <ID> --title <t> [--epic <e>]` | Mint a story's card folder (spec + page + index) — the single creation channel |
56
+ | `roll attest <ID>` | Render the acceptance-evidence report into the card folder |
57
+ | `roll index` | Rebuild the three-layer Delivery Dossier (front page · epics · story dossiers) |
53
58
  | `roll status` | Show current state and drift |
54
- | `roll agent [use <name>]` | Per-project agent selection |
59
+ | `roll agent [use <name>]` | Per-machine complexity-slot routing (easy/default/hard/fallback) |
55
60
  | `roll ci [--wait]` | Show or wait for current commit's CI status |
56
61
  | `roll test [--where] [--reset]` | Run the test suite (routes through the isolation adapter; unknown types fail loud) |
57
62
  | `roll release` | Run the release script (human-only) |
@@ -82,9 +87,9 @@ Published as a single npm package `@seanyao/roll`: `dist/` (TS bundled by esbuil
82
87
 
83
88
  | | |
84
89
  |---|---|
85
- | **Start here** | [Overview & architecture](guide/en/overview.md) · [Engineering methodology](guide/en/methodology.md) |
90
+ | **Start here** | [Getting started](guide/en/getting-started.md) · [Overview & architecture](guide/en/overview.md) · [Engineering methodology](guide/en/methodology.md) |
86
91
  | **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) |
87
- | **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) |
92
+ | **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) |
88
93
  | **Under the hood** | [Architecture: layers · domain · invariants](docs/architecture.md) · [Verification system](docs/verification.md) · [Manifesto](docs/manifesto.md) |
89
94
 
90
95
  Full guide index: [guide/en/](guide/en/) — agents, peer review, slides, feedback, backlog sync, adoption patterns, and more.