@seanyao/roll 3.610.2 → 3.611.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 (5) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/README.md +25 -14
  3. package/dist/roll.mjs +2856 -1410
  4. package/package.json +1 -1
  5. package/skills/roll-loop/SKILL.md +3 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,53 @@
1
1
  # Changelog
2
2
 
3
+ ## v3.611.2 — 2026-06-11
4
+
5
+ ### 事实对齐(US-TRUTH 史诗全量交付)
6
+
7
+ - 字段级事实权威矩阵:十类持久事实各自声明唯一权威源/唯一写者/冲突仲裁/unknown 判据,跨仓仲裁 github_pr_merge > product_main > roll_meta(US-TRUTH-000) `[truth]`
8
+ - 周期终态事件 schema v1:每个事实字段要么有完整值要么带枚举化缺失原因,静默 0/"—" 在结构上不可能;被杀周期也能推导终态(US-TRUTH-001) `[truth]`
9
+ - 影子一致性审计 `roll consistency audit`:七条漂移规则只读扫描,fail/warn/unknown/grandfathered 分级,报告落盘不报警不拦截(US-TRUTH-002) `[truth]`
10
+ - 真相选择器:story/cycle/evidence 三类结论由纯函数统一推导,闭合 reason code,真实漂移案例冻结(US-TRUTH-003) `[truth]`
11
+ - 读侧三件套(dashboard/dossier/status)统一走真相适配器,unknown 一律显示 ?,绝不静默装成功(US-TRUTH-004) `[truth]`
12
+ - 发版闸接入审计:fail 级漂移拦截发版;owner 豁免必须记录原因/范围/期限/操作者并进事实流,过期失效(US-TRUTH-005) `[truth]`
13
+ - 变更点护栏:落盘字段必须登记权威语义,未登记字段 CI 红灯并指路登记(US-TRUTH-006) `[truth]`
14
+
15
+ ### 稳定性
16
+
17
+ - 死循环必须尖叫:连续异常 tick 触发 ALERT(带首末时间),恢复自动注记;gh_error 落底层错误首行(FIX-233) `[loop]`
18
+ - 观察窗锚定本次 cycle:live.log 周期起始重置,不再回放上个周期的旧转录(FIX-237) `[loop]`
19
+ - agent 自开 PR 被运行时收编登记并记违纪日志,绝不重复开 PR;skill 硬闸同步(FIX-245) `[loop]`
20
+ - `loop off` 清扫全部 com.roll.* 僵尸 lane;`roll doctor` 列出全部 lane 及指向/加载态,陈旧标红(FIX-234) `[loop]`
21
+ - 门禁判死 ≠ 产物丢弃:带提交的失败周期把分支推上远端可审计可营救;明确裁定不自动复用(FIX-247) `[loop]`
22
+
23
+ ### CLI 契约
24
+
25
+ - 统一求助契约:--help 一律只读(update --help 曾真执行升级!)、stdout 用法、exit 0;未知子命令 stderr+非零;报错带上标志名(FIX-238/239) `[cli]`
26
+ - loop 用法行只列现役子命令,monitor/attach 退役项移除(FIX-240) `[cli]`
27
+ - `roll story new` 成为真正的单一建卡入口:卡夹+backlog 行+索引刷新一步完成,--no-index 支持批量(FIX-250) `[cli]`
28
+
29
+ ### 文档
30
+
31
+ - 两份 README 命令表与现役注册表逐项对齐(中英一致),新增 README-vs-registry CI 防漂测试(FIX-241) `[docs]`
32
+ - methodology/loop 指南子命令清单更新为现役全集,退役 branches 指到 git ls-remote(FIX-242) `[docs]`
33
+
34
+ ### 其他
35
+
36
+ - 裁定删除 FIX-235(premature Done 已由审计+闸覆盖)与 FIX-236(TCR 闸一次性事件未复现);backlog 全量清零
37
+
38
+ ## v3.611.1 — 2026-06-11
39
+
40
+ ### 稳定性
41
+
42
+ - 漏写验收意图映射不再整批枪毙交付:补救通道让同一 agent 当场补写 ac-map 再过闸,诚实红线不动(FIX-246) `[loop]`
43
+ - 新终态"已发布待合并"终结幻影失败与发布即 Done:连败计数只数真正无产出的失败,loop 不再因成功而停摆(FIX-244) `[loop]`
44
+ - 合并证据回填接进每个 cycle 收尾:失败/待合并的历史记录在 PR 真合并后自动翻账为已交付(FIX-243) `[loop]`
45
+
46
+ ### 可见性
47
+
48
+ - 周期记录补上 tokens/成本/模型字段,claude 流式、页脚刮取、pi 会话恢复三条适配通道全部接通;预算护栏改由真实成本驱动,烧钱有上限感知(FIX-249) `[loop]`
49
+ - 状态面板按 v3 词表如实分类:十四个失败不再显示成零,ROLLUP/RECENT/agents 三区段同窗口同口径(FIX-248) `[loop]`
50
+
3
51
  ## v3.610.2 — 2026-06-10
4
52
 
5
53
  ### 可见性
package/README.md CHANGED
@@ -44,27 +44,38 @@ First time through? Start with [Getting started](guide/en/getting-started.md).
44
44
  | Command | Description |
45
45
  |---------|-------------|
46
46
  | **Autonomy · daily use** | |
47
- | `roll loop <on\|off\|now\|status\|eval\|signals\|runs\|story\|…>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
47
+ | `roll loop <on\|off\|now\|status\|runs\|log\|story\|events\|eval\|signals\|fmt\|pr-inbox\|mute\|unmute\|pause\|resume\|reset\|gc>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
48
48
  | `roll brief` | Show latest owner brief |
49
49
  | `roll backlog [sync\|block\|defer\|lint\|…]` | View, manage, and sync (from GitHub Issues) pending tasks |
50
- | `roll peer` | Cross-agent negotiation & review |
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 |
53
- | **Project · per repo** | |
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 |
50
+ | `roll alert [run-once]` | View / clear loop alerts |
51
+ | `roll status` | Show current state and drift |
52
+ | `roll doctor` | Environment + install diagnosis (agents, plists, launchd lanes) |
53
+ | `roll dream run-once` | Nightly self-scan (patterns, docs freshness, test quality) — one pass now |
54
+ | `roll tune [reset]` | Suggest-only self-tuning from loop trends — read-only, never auto-applies |
55
+ | **Cards & evidence** | |
56
+ | `roll idea "<one-sentence description>"` | Capture a card: auto-classify, number, lint, infer epic, mint the full story folder — the one user entry for adding cards |
57
+ | `roll story new <ID> --title <t> [--epic <e>] [--no-index]` | The one minting entry agents/skills use: card folder + backlog row + index refresh (`--no-index` for batches) |
56
58
  | `roll attest <ID>` | Render the acceptance-evidence report into the card folder |
57
59
  | `roll index` | Rebuild the three-layer Delivery Dossier (front page · epics · story dossiers) |
58
- | `roll status` | Show current state and drift |
59
- | `roll agent [use <name>]` | Per-machine complexity-slot routing (easy/default/hard/fallback) |
60
- | `roll ci [--wait]` | Show or wait for current commit's CI status |
60
+ | `roll consistency <check\|audit>` | Five-dimension gap check · US-TRUTH shadow drift audit (read-only, exit 0) |
61
+ | `roll changelog` | Sync CHANGELOG from merged work |
62
+ | **Project · per repo** | |
63
+ | `roll init` | Set up Roll in this project (agent-driven onboarding for legacy code) |
64
+ | `roll offboard` | Remove Roll from this project |
65
+ | `roll migrate` | Upgrade a pre-2.0 project layout |
61
66
  | `roll test [--where] [--reset]` | Run the test suite (routes through the isolation adapter; unknown types fail loud) |
62
- | `roll release` | Run the release script (human-only) |
63
- | `roll review-pr <number>` | AI-powered code review for a PR |
64
- | **Machine · global** | |
67
+ | `roll ci [--wait]` | Show or wait for current commit's CI status |
68
+ | `roll release [ship\|waiver]` | Release guidance · gated tag push (`ship`) · recorded drift waiver (`waiver`) — npm publish stays human |
69
+ | `roll feedback --type bug\|idea\|ux` | Open a GitHub issue for this project |
70
+ | `roll pair [init\|status]` | Cross-agent pairing: heterogeneous peer re-checks during builds |
71
+ | **Config & machine** | |
72
+ | `roll config [lang <zh\|en\|--reset>\|…]` | Read/write roll config (language, loop window, dream time) |
73
+ | `roll agent [set <slot> <agent>\|use <name>\|list]` | Per-machine complexity-slot routing (easy/default/hard/fallback) |
74
+ | `roll prices [refresh]` | Model price table (cost accounting source) |
75
+ | `roll skills` | Skill catalog status |
65
76
  | `roll setup [-f]` | First-time install or re-sync conventions to all AI clients |
66
77
  | `roll update` | Upgrade to latest + re-sync |
67
- | `roll version` | Print installed roll version |
78
+ | `roll --version` / `roll -v` | Print installed roll version |
68
79
 
69
80
  ## Repository layout
70
81