@seanyao/roll 3.609.2 → 3.610.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 (103) hide show
  1. package/CHANGELOG.md +44 -1
  2. package/README.md +5 -6
  3. package/dist/roll.mjs +16146 -16186
  4. package/package.json +3 -2
  5. package/skills/README.md +14 -1
  6. package/skills/docs/skill-authoring.md +66 -0
  7. package/skills/reports/skill-audit-summary.md +53 -0
  8. package/skills/roll-.changelog/SKILL.md +25 -443
  9. package/skills/roll-.changelog/references/full-contract.md +462 -0
  10. package/skills/roll-.clarify/SKILL.md +6 -4
  11. package/skills/roll-.dream/SKILL.md +26 -353
  12. package/skills/roll-.dream/references/full-contract.md +365 -0
  13. package/skills/roll-.echo/SKILL.md +6 -4
  14. package/skills/roll-.qa/SKILL.md +25 -236
  15. package/skills/roll-.qa/references/full-contract.md +256 -0
  16. package/skills/roll-.review/SKILL.md +6 -2
  17. package/skills/roll-brief/SKILL.md +6 -8
  18. package/skills/roll-build/SKILL.md +28 -864
  19. package/skills/roll-build/references/full-contract.md +883 -0
  20. package/skills/roll-debug/SKILL.md +26 -585
  21. package/skills/roll-debug/references/full-contract.md +607 -0
  22. package/skills/roll-design/SKILL.md +28 -903
  23. package/skills/roll-design/references/full-contract.md +923 -0
  24. package/skills/roll-doc/SKILL.md +25 -574
  25. package/skills/roll-doc/references/full-contract.md +594 -0
  26. package/skills/roll-doctor/SKILL.md +21 -2
  27. package/skills/roll-fix/SKILL.md +28 -621
  28. package/skills/roll-fix/references/full-contract.md +640 -0
  29. package/skills/roll-idea/SKILL.md +6 -2
  30. package/skills/roll-loop/SKILL.md +27 -543
  31. package/skills/roll-loop/references/full-contract.md +555 -0
  32. package/skills/roll-notes/SKILL.md +6 -2
  33. package/skills/roll-onboard/SKILL.md +6 -2
  34. package/skills/roll-peer/SKILL.md +27 -316
  35. package/skills/roll-peer/references/full-contract.md +329 -0
  36. package/skills/roll-propose/SKILL.md +6 -8
  37. package/skills/roll-review-pr/SKILL.md +6 -2
  38. package/skills/roll-sentinel/SKILL.md +26 -344
  39. package/skills/roll-sentinel/references/full-contract.md +363 -0
  40. package/skills/roll-spar/SKILL.md +27 -269
  41. package/skills/roll-spar/references/full-contract.md +288 -0
  42. package/skills/route-cases/skills.json +235 -0
  43. package/skills/scripts/audit-skills.mjs +272 -0
  44. package/skills/scripts/test-audit-skills.mjs +39 -0
  45. package/skills/tests/fixtures/skill-audit/block-skill/SKILL.md +12 -0
  46. package/skills/tests/fixtures/skill-audit/minimal-skill/SKILL.md +8 -0
  47. package/skills/tests/fixtures/skill-audit/quoted-skill/SKILL.md +10 -0
  48. package/skills/tests/fixtures/skill-audit/route-cases.json +21 -0
  49. package/skills/tests/fixtures/skill-audit/spoke-skill/SKILL.md +12 -0
  50. package/skills/tests/fixtures/skill-audit/spoke-skill/references/runbook.md +3 -0
  51. package/bin/roll +0 -15361
  52. package/lib/backfill-pi-usage.py +0 -243
  53. package/lib/changelog_audit.py +0 -149
  54. package/lib/changelog_generate.py +0 -470
  55. package/lib/consistency_check.py +0 -409
  56. package/lib/context_feed_budget.sh +0 -194
  57. package/lib/github_sync.py +0 -876
  58. package/lib/i18n/slides.sh +0 -3
  59. package/lib/i18n/slides_build.sh +0 -38
  60. package/lib/i18n/slides_delete.sh +0 -19
  61. package/lib/i18n/slides_list.sh +0 -14
  62. package/lib/i18n/slides_logs.sh +0 -12
  63. package/lib/i18n/slides_new.sh +0 -15
  64. package/lib/i18n/slides_preview.sh +0 -14
  65. package/lib/i18n/slides_templates.sh +0 -7
  66. package/lib/i18n.sh +0 -211
  67. package/lib/loop-exit-summary.py +0 -393
  68. package/lib/loop-fmt.py +0 -589
  69. package/lib/loop_pick_agent.py +0 -316
  70. package/lib/loop_result_eval.py +0 -469
  71. package/lib/loop_unstick.py +0 -180
  72. package/lib/model_prices.py +0 -194
  73. package/lib/prices_fetcher.py +0 -534
  74. package/lib/roll-backlog.py +0 -225
  75. package/lib/roll-brief.py +0 -286
  76. package/lib/roll-help.py +0 -158
  77. package/lib/roll-home.py +0 -556
  78. package/lib/roll-init.py +0 -156
  79. package/lib/roll-loop-status.py +0 -1691
  80. package/lib/roll-loop-story.py +0 -191
  81. package/lib/roll-peer.py +0 -252
  82. package/lib/roll-setup.py +0 -102
  83. package/lib/roll-status.py +0 -367
  84. package/lib/roll_git.py +0 -41
  85. package/lib/roll_render.py +0 -414
  86. package/lib/slides/components/README.md +0 -123
  87. package/lib/slides/components/cards-2.html +0 -9
  88. package/lib/slides/components/cards-3.html +0 -9
  89. package/lib/slides/components/cards-4.html +0 -9
  90. package/lib/slides/components/compare.html +0 -22
  91. package/lib/slides/components/highlight.html +0 -9
  92. package/lib/slides/components/pipeline.html +0 -12
  93. package/lib/slides/components/plain.html +0 -7
  94. package/lib/slides/components/quote.html +0 -4
  95. package/lib/slides/components/timeline.html +0 -9
  96. package/lib/slides/templates/introduction-v3.html +0 -571
  97. package/lib/slides/templates/pitch.html +0 -0
  98. package/lib/slides-render.py +0 -778
  99. package/lib/slides-validate.py +0 -357
  100. package/lib/test_quality_gate.py +0 -143
  101. package/skills/roll-deck/SKILL.md +0 -296
  102. /package/skills/roll-debug/{injectable-bb.js → assets/injectable-bb.js} +0 -0
  103. /package/skills/roll-design/{ENGINEERING_CHECKLIST.md → references/engineering-checklist.md} +0 -0
package/CHANGELOG.md CHANGED
@@ -1,6 +1,49 @@
1
1
  # Changelog
2
2
 
3
- ## Unreleased
3
+ ## v3.610.2 — 2026-06-10
4
+
5
+ ### 可见性
6
+
7
+ - 改变交付真相的节点不刷新看板聚合页,新卡新状态要等手动重建索引才出现,看板静默滞后(FIX-231) `[loop]`
8
+
9
+ ### 自动化流水线
10
+
11
+ - loop 复用陈旧会话致 cycle 跑在冻结环境里,代理一关 agent 全部静默超时失败,连败到自动暂停(FIX-230) `[loop]`
12
+
13
+ ### 其他
14
+
15
+ - 幻灯片功能整体下线——交付控制器不内置做 PPT;slides 命令、模板与文档全部移除(US-CLI-008)
16
+ - 退役一次性迁移命令 archive migrate 与 migrate-features(能力分别归 gc 与 story new);roll migrate 保留为 pre-2.0 项目升级路径(REFACTOR-048)
17
+ - bump skills submodule → 32d9f5c (roll-deck removed)(PR#574)
18
+ - docs(guide): port quality-rubric examples bats/bash → TS/Vitest(PR#570)
19
+ - docs(guide): de-migrate the guides — current Vitest/TS reality (round 2)(PR#569)
20
+ - reframe to current TS-native architecture (drop v2→v3 migration narrative)(PR#568)
21
+ - coverage tooling (@vitest/coverage-v8 + pnpm test:cov)(PR#567)
22
+
23
+
24
+ ## v3.610.1 — 2026-06-10
25
+
26
+ ### 稳定性
27
+
28
+ - 故事档案改"按节点增量挂载"为主路:各生命周期节点把当场已知的产出挂上页面,全量重渲降级为显式 rebuild 修复工具,根治"合了但页面没动"(US-DOSSIER-007)
29
+
30
+ ### 可见性
31
+
32
+ - 历史交付卡 legacy 状态语义:pre-v3 已 Done 卡(无 latest/无 ac-map)派生 legacy 标记,状态仍=完成+历史 chip,脊柱不再读证据假装半成品(US-DOSSIER-008)
33
+ - backlog 状态机归一到单一强类型真相,渲染与调度与对账全部消费它,不再各自拿字符串猜状态(REFACTOR-047) `[loop]`
34
+
35
+ ### 工程和测试
36
+
37
+ - 把 7 个曾比对旧引擎 oracle、现退化为确定性自校验的差异测试升级为真冻结期望快照(US-PORT-021b)
38
+
39
+ ### 其他
40
+
41
+ - 把幻灯片渲染命令改写为 TS,脱离 bash 回落引擎(US-PORT-016)
42
+ - 把待办管理写端命令改写为 TS,脱离 bash 回落引擎(US-PORT-019)
43
+ - 所有命令脱回落后退役 bash 引擎并清残件(高爆破坏性收尾,人工放行)(US-PORT-021)
44
+ - release ship 的确认提示在新版 Node 上仍会卡住,敲回车没反应,目前只能用免确认参数绕过,需彻底修交互读取(FIX-229) `[loop]`
45
+ - dossier: redesign features index as a delivery board (status overview + foldable epics + lifecycle spine)(PR#560)
46
+ - dossier: align features index status/type with backlog + 3-state grouping (delivery board)(PR#559)
4
47
 
5
48
  ## v3.609.2 — 2026-06-09
6
49
 
package/README.md CHANGED
@@ -26,7 +26,7 @@ curl -fsSL https://seanyao.github.io/roll/install | bash
26
26
  npm install -g @seanyao/roll
27
27
  ```
28
28
 
29
- Requirements: Node.js ≥ 22 (the CLI entry runs on node). bash 3.2+ for the bundled fallback engine.
29
+ Requirements: Node.js ≥ 22. Roll is a self-contained TypeScript CLI no runtime engine beyond node.
30
30
 
31
31
  ## Use
32
32
 
@@ -72,16 +72,15 @@ Dev side — a pnpm monorepo. Publish side — one npm package.
72
72
 
73
73
  ```
74
74
  packages/ TypeScript engine (pnpm workspaces): spec · core · infra · cli · web
75
- bin/roll Frozen bash v2 engine automatic fallback + the diff-test oracle
76
- lib/ Runtime companions (python/sh) used by the loop & fallback paths
75
+ lib/ Runtime companions (prices snapshots, i18n catalog)
77
76
  skills/ Git submodule → seanyao/roll-skills (the agent skill contracts)
78
77
  conventions/ Conventions synced into AI clients by `roll setup`
79
78
  template/ Project scaffolding installed by `roll init`
80
79
  ```
81
80
 
82
- The frozen v2 bash lives on the `v2` branch (anchor tag `v2-freeze-2026-06-04`). Build & test: `pnpm install && pnpm -r test`.
81
+ Build & test: `pnpm install && pnpm -r test`.
83
82
 
84
- Published as a single npm package `@seanyao/roll`: `dist/` (TS bundled by esbuild) + `bin/` + `lib/` + `skills/` + `conventions/` + `template/`.
83
+ Published as a single npm package `@seanyao/roll`: `dist/` (the CLI bundled to one self-contained ESM by esbuild) + `lib/` + `skills/` + `conventions/` + `template/`.
85
84
 
86
85
  ## Documentation
87
86
 
@@ -92,7 +91,7 @@ Published as a single npm package `@seanyao/roll`: `dist/` (TS bundled by esbuil
92
91
  | **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) |
93
92
  | **Under the hood** | [Architecture: layers · domain · invariants](docs/architecture.md) · [Verification system](docs/verification.md) · [Manifesto](docs/manifesto.md) |
94
93
 
95
- Full guide index: [guide/en/](guide/en/) — agents, peer review, slides, feedback, backlog sync, adoption patterns, and more.
94
+ Full guide index: [guide/en/](guide/en/) — agents, peer review, feedback, backlog sync, adoption patterns, and more.
96
95
 
97
96
  ## Contributing
98
97