@seanyao/roll 3.612.1 → 3.613.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.
- package/CHANGELOG.md +72 -0
- package/README.md +4 -4
- package/dist/roll.mjs +16179 -14805
- package/package.json +1 -1
- package/skills/docs/skill-authoring.md +4 -0
- package/skills/roll-build/references/full-contract.md +16 -4
- package/skills/roll-design/references/full-contract.md +13 -4
- package/skills/roll-fix/references/full-contract.md +17 -5
package/CHANGELOG.md
CHANGED
|
@@ -2,8 +2,80 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
## v3.613.2 — 2026-06-13
|
|
6
|
+
|
|
7
|
+
### 稳定性
|
|
8
|
+
|
|
9
|
+
- `roll loop go` 的预算与运行上限改为每次启动显式设定：只取本次调用的 `--budget`/`--max-cycles`/`--for`，省略即本轮不设限，不再沿用上一次会话持久化的旧值（此前 flagless 连跑会继承几天前设的预算与单周期上限，一个 idle 周期即 budget_limited 收摊、整轮零产出）；scope/review 仍按需沿用（FIX-279） `[loop]`
|
|
10
|
+
<!-- evidence: .roll/features/goal-mode/FIX-279/latest/FIX-279-report.html -->
|
|
11
|
+
|
|
12
|
+
- `roll index --rebuild` 不再把已合并故事页降级：delivered 判定补离线 git 合并真相（提交标题点名故事 id，或 `(#N)` PR 合并提交引用它），rebuild 无实时 PR 快照时也保住已合并卡的"已合主干·已验收"横幅与交付脊柱；选择器可提升但不再抹掉 git 证明已合的卡，Done 闸防止 Todo 卡被误提升（FIX-278） `[dossier]`
|
|
13
|
+
<!-- evidence: .roll/features/delivery-dossier/FIX-278/latest/FIX-278-report.html -->
|
|
14
|
+
|
|
15
|
+
## v3.613.1 — 2026-06-13
|
|
16
|
+
|
|
17
|
+
### 稳定性
|
|
18
|
+
|
|
19
|
+
- `roll release` 事务健壮性：任一步骤依赖抛错（提交闸拦截、网络故障…）都归为该步的有序中止而非裸栈；带测试证明提交闸的仓库（roll 自身）先刷新证明重试一次再提交（FIX-277，发版实战首跑揪出） `[release]`
|
|
20
|
+
<!-- evidence: .roll/features/release-management/FIX-277/latest/FIX-277-report.html -->
|
|
21
|
+
|
|
22
|
+
- `roll setup skills` 在全局安装环境不再向安装树写 guide 文档撞 ENOENT 崩栈：安装树无目录清单可维护，单行提示后跳过；源码仓行为不变（FIX-276） `[cli]`
|
|
23
|
+
<!-- evidence: .roll/features/documentation/FIX-276/latest/FIX-276-report.html -->
|
|
24
|
+
|
|
25
|
+
- cycle worktree 依赖安装失败会直接以失败终态和 `[FAIL] worktree deps bootstrap failed` ALERT 暴露，并清理空 worktree，不再继续烧 agent 后误落 `idle_no_work`（FIX-268） `[loop]`
|
|
26
|
+
|
|
27
|
+
### 新功能
|
|
28
|
+
|
|
29
|
+
- `roll release` 收口为唯一发版命令：一条事务（版本号→折叠 changelog→包闸→发版 PR→等合并→快进 main→一致性闸→推 tag），每个不可逆步骤前都有闸，失败 fail-loud 零半成品；ship/waiver/changelog/consistency 旧子命令物理删除（豁免路径不复存在——修掉漂移才能发）；CI 闸入口改 `roll release --gate-check`（US-REL-007） `[release]`
|
|
30
|
+
<!-- evidence: .roll/features/release-management/US-REL-007/latest/US-REL-007-report.html -->
|
|
31
|
+
|
|
32
|
+
- 全站可复制命令芯片与数据新鲜度：周期账本行 → roll cycle、待交付行 → roll loop go/backlog promote、故事档案头 → 拾取命令（全部真实存在，点击 ✓ copied）；总览 generated 超 6h 亮"数据过期"警示，心跳 next 做客户端倒计时（US-DOSSIER-018） `[dossier]`
|
|
33
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-018/latest/US-DOSSIER-018-report.html -->
|
|
34
|
+
|
|
35
|
+
- `roll cycle <id>` 单周期轨迹带：摘要行+story 行+垂直七段（色点+事实摘要，中途死掉的段显示"未达"不省略）+ PR/diff/story 证据指针；与 web 轨迹带同形同词表（US-CLI-013） `[cli]`
|
|
36
|
+
<!-- evidence: .roll/features/cli-simplification/US-CLI-013/latest/US-CLI-013-report.html -->
|
|
37
|
+
|
|
38
|
+
- `roll cycles [--since 1d|3d|7d|all]` 升一等命令：周期账本每行周期号·结局·story·模型·tokens·花费·耗时，汇总行失败=failed+reverted+blocked 不吞，尾部 → roll cycle 提示；与 web 账本同聚合同词表（US-CLI-012） `[cli]`
|
|
39
|
+
<!-- evidence: .roll/features/cli-simplification/US-CLI-012/latest/US-CLI-012-report.html -->
|
|
40
|
+
|
|
41
|
+
- 技能页签：审计条（N skills·violations·hub 总行数，与 audit-skills --strict 同口径）、四组契约清单带调用频次（自评分 note 口径），行展开看真实文件树（行数）、审计要件勾选、可复制目录路径与 SKILL.md 原文滚动区；清单从仓库目录实读防漂移（US-DOSSIER-017） `[dossier]`
|
|
42
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-017/latest/US-DOSSIER-017-report.html -->
|
|
43
|
+
- 发版页签待交付与变更日志：待交付按史诗分组（行点进档案），变更日志从 merged PR 真相生成（pr:merge 事件优先、Done 行 PR# 注记兜底，行带 #N merged 证据链）；页底历史版本可折叠展开（含曾豁免标记）；闸门头 merged/pending 与两段同算术（US-DOSSIER-016） `[dossier]`
|
|
44
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-016/latest/US-DOSSIER-016-report.html -->
|
|
45
|
+
- 发版页签六维一致性面板：闸门头（tag·判定·f/w/?·切版·上一版·merged/pending 进度条）+ 六维对账行（漂移卡可点跳待办搜索），合计与状态行严格同数，任一维 fail 明示挡发版；⑦data 维以提案虚线行呈现并链 FIX-248/249；附可复制 roll release consistency check 芯片（US-DOSSIER-015） `[dossier]`
|
|
46
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-015/latest/US-DOSSIER-015-report.html -->
|
|
47
|
+
- 循环页签本机 agents 面板：每行运行器·版本·近72h周期与花费·可用状态（未检测置灰），展开看接入文件同步真相（✓/⟳/−），约定过期带琥珀标与可复制 roll setup 修复命令（US-DOSSIER-014） `[dossier]`
|
|
48
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-014/latest/US-DOSSIER-014-report.html -->
|
|
49
|
+
- 循环页签周期账本：Today/3d/7d/All 范围切换实时重算（失败=failed+reverted+blocked 不吞），每行结局点·周期号·story·模型·tokens·花费·耗时，展开成 cycle→story→build→peer→ci→pr→end 七段轨迹带带证据（US-DOSSIER-013） `[dossier]`
|
|
50
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-013/latest/US-DOSSIER-013-report.html -->
|
|
51
|
+
- 待办页签重设计：愿望页头、搜索+六态筛选 chips（总览光谱点击预置）、史诗手风琴（交付中/已落定分组），故事行带类型徽标·ID·迷你脊柱·claim↔truth 对照；epic/story 面包屑根改 Backlog 页签（US-DOSSIER-012） `[dossier]`
|
|
52
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-012/latest/US-DOSSIER-012-report.html -->
|
|
53
|
+
- 看板升级五页签真相控制台：总览页三十秒读完判定条、循环心跳、三聚合卡与六态光谱，页签 hash 路由下钻返回不丢；品牌与 slogan 注入式；旧 ledger 暂驻待办页签（US-DOSSIER-011） `[dossier]`
|
|
54
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-011/latest/US-DOSSIER-011-report.html -->
|
|
55
|
+
- 真相口径同源：`roll index` 一次聚合产出 TruthSnapshot，同一序列化同时内嵌 index.html 并写出 `truth.json`（机器可读）；reverted cycle 纳入失败计数不再被吞（US-DOSSIER-010） `[dossier]`
|
|
56
|
+
<!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-010/latest/US-DOSSIER-010-report.html -->
|
|
57
|
+
|
|
58
|
+
### 性能
|
|
59
|
+
|
|
60
|
+
- 建卡与 `roll index` 提速 5.4 倍（实测 41s → 7.6s，产物字节级不变）：索引一次树遍历、每卡 3 次 git 扫描合并为一次快照、全局趋势与反向依赖一次计算（FIX-275） `[cli]`
|
|
61
|
+
<!-- evidence: .roll/features/loop/FIX-275/latest/FIX-275-report.html -->
|
|
62
|
+
- 技能自评分改走 TS 原生命令 `roll self-score`，幂等可重试；不再让 agent 把 TS bundle 当 bash 库 source（FIX-274） `[skills]`
|
|
63
|
+
<!-- evidence: .roll/features/skill-ecosystem/FIX-274/latest/FIX-274-report.html -->
|
|
64
|
+
|
|
65
|
+
### 新功能
|
|
66
|
+
|
|
67
|
+
- 评分成为 pairing 场景：score 阶段由异构配对 agent 给交付打分（note 带 scored-by 溯源），无候选/超时回落自评，永不阻塞 cycle；`roll pair init` 默认开 code+score 两阶段（US-PAIR-009） `[pairing]`
|
|
68
|
+
<!-- evidence: .roll/features/cross-agent-pairing/US-PAIR-009/latest/US-PAIR-009-report.html -->
|
|
69
|
+
- `roll pair score <story>` 手动让配对 agent 打分；`roll self-score` 新增 `--fallback-reason` 记录回落原因；三技能契约改"配对优先、自评回落"，结对指南中英双轨更新（US-PAIR-010） `[pairing]`
|
|
70
|
+
<!-- evidence: .roll/features/cross-agent-pairing/US-PAIR-010/latest/US-PAIR-010-report.html -->
|
|
71
|
+
|
|
72
|
+
## v3.612.2 — 2026-06-12
|
|
73
|
+
|
|
5
74
|
### 稳定性
|
|
6
75
|
|
|
76
|
+
- `roll loop go` 撞上运行中的 cycle 不再秒停，等锁释放后接着跑（FIX-269） `[loop]`
|
|
77
|
+
<!-- evidence: .roll/features/goal-mode/FIX-269/spec.md -->
|
|
78
|
+
- cycle worktree 在 agent 进场前先装好依赖，离线沙箱里测试也能跑（FIX-268 根因预防） `[loop]`
|
|
7
79
|
- `roll attest --capture-command` 截图后不再弹 macOS 终止进程确认
|
|
8
80
|
<!-- evidence: .roll/features/acceptance-evidence/FIX-266/latest/FIX-266-report.html -->
|
|
9
81
|
|
package/README.md
CHANGED
|
@@ -61,10 +61,10 @@ First time through? Start with [Getting started](guide/en/getting-started.md).
|
|
|
61
61
|
| `roll offboard` | Remove Roll from this project |
|
|
62
62
|
| `roll test [--where] [--reset]` | Run the test suite (routes through the isolation adapter; unknown types fail loud) |
|
|
63
63
|
| `roll ci [--wait]` | Show or wait for current commit's CI status |
|
|
64
|
-
| `roll release [
|
|
65
|
-
| `roll
|
|
66
|
-
| `roll
|
|
67
|
-
| `roll
|
|
64
|
+
| `roll release [--dry-run]` | The ONE release flow: bump → changelog fold → package gate → PR → merge → consistency gate → tag push |
|
|
65
|
+
| `roll pair [init\|status\|score]` | Cross-agent pairing: heterogeneous peer re-checks and scores deliveries |
|
|
66
|
+
| `roll cycles [--since 1d\|3d\|7d\|all]` | The cycle ledger — one line per cycle, failures never swallowed |
|
|
67
|
+
| `roll cycle <id>` | One cycle's full trace tape (cycle→story→build→peer→ci→pr→end) |
|
|
68
68
|
| `roll peer [--reviewer <agent>] (--prompt <text>\|--file <path>)` | One-shot structured external-provider review; records `.roll/peer/runs.jsonl` |
|
|
69
69
|
| **Config & machine** | |
|
|
70
70
|
| `roll config [lang <zh\|en\|--reset>\|…]` | Read/write roll config (language, loop window, dream time) |
|