@seanyao/roll 3.611.2 → 3.612.1

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Changelog
 
+## Unreleased
+
+### 稳定性
+
+- `roll attest --capture-command` 截图后不再弹 macOS 终止进程确认
+  <!-- evidence: .roll/features/acceptance-evidence/FIX-266/latest/FIX-266-report.html -->
+
+## v3.612.1 — 2026-06-12
+
+### 新功能
+
+- `roll loop go` — 连续跑 backlog 到完成或暂停（US-GOAL-002） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/US-GOAL-002/latest/US-GOAL-002-report.html -->
+- `roll loop goal` — 查看目标、安全闸和最后裁定（US-GOAL-001） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/US-GOAL-001/latest/US-GOAL-001-report.html -->
+- `roll peer` — 一次性外部评审有结构化记录（FIX-255） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/FIX-255/latest/FIX-255-report.html -->
+
+### 可见性
+
+- 交付档案新增真相板，一眼看 Story/Cycle/Release（US-TRUTH-011） `[truth]`
+  <!-- evidence: .roll/features/feedback-truth-alignment/US-TRUTH-011/latest/US-TRUTH-011-report.html -->
+- epic 页能直接打开总览设计文档（US-DOSSIER-009）
+  <!-- evidence: .roll/features/delivery-dossier/US-DOSSIER-009/latest/US-DOSSIER-009-report.html -->
+- 主帮助只显示常用命令，机器入口收进对应分组（REFACTOR-052） `[loop]`
+- 帮助与文档已跟 goal/peer 新命令对齐（US-GOAL-007）
+  <!-- evidence: .roll/features/goal-mode/US-GOAL-007/latest/US-GOAL-007-report.html -->
+
+### 自动化流水线
+
+- goal 完成前按主干证据裁定，不再提前报 Done（US-GOAL-003） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/US-GOAL-003/latest/US-GOAL-003-report.html -->
+- goal 无进展会跳卡报警，不再空转烧熔断（US-GOAL-004） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/US-GOAL-004/latest/US-GOAL-004-report.html -->
+- goal 连跑有预算、用量和时间盒安全闸（US-GOAL-005） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/US-GOAL-005/latest/US-GOAL-005-report.html -->
+- goal 完结前有异构终审，降级也会留痕（US-GOAL-006） `[loop]`
+  <!-- evidence: .roll/features/goal-mode/US-GOAL-006/latest/US-GOAL-006-report.html -->
+- `roll loop resume` 清失败计数，不再恢复即熔断（FIX-251） `[loop]`
+  <!-- evidence: .roll/features/loop-engine/FIX-251/latest/FIX-251-report.html -->
+- loop 出网预检不再依赖 macOS 默认缺失的 GNU `timeout`，避免直连正常时误报 `egress blocked`（FIX-257） `[loop]`
+- 调度环境残留会被体检指出，不再静默污染 loop（FIX-232） `[loop]`
+
+### 稳定性
+
+- `roll loop go --cards` 不再沿用上次暂停的全量范围（FIX-259）
+- goal 失败原因现在直达状态页，不再只剩 `no_cycle_terminal`（FIX-260）
+- 验收证据不再只靠文字声明，缺截图会被指出（FIX-258）
+- `roll attest --capture-command` 不再把失败命令当验收通过（FIX-263）
+- `roll attest --capture-command` 相对路径按项目目录执行（FIX-262）
+
+### 工程和测试
+
+- `roll attest` 现在识别新卡的验收清单（FIX-261）
+  <!-- evidence: .roll/features/acceptance-evidence/FIX-261/latest/FIX-261-report.html -->
+- 新 worktree 跑 `roll test` 会自动补齐 skills（FIX-264）
+- goal/off/pause 的文档讲清了和定时 loop 的关系（FIX-256）
+
+
 ## v3.611.2 — 2026-06-11
 
 ### 事实对齐(US-TRUTH 史诗全量交付)

package/README.md

@@ -44,39 +44,49 @@ First time through? Start with [Getting started](guide/en/getting-started.md).
 | Command | Description |
 |---------|-------------|
 | **Autonomy · daily use** | |
-| `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) |
+| `roll loop <on\|off\|now\|status\|runs\|log\|story\|events\|eval\|signals\|alert\|fmt\|pr-inbox\|mute\|unmute\|pause\|resume\|reset\|gc>` | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) |
+| `roll loop go [--epic <e>\|--cards <ids>] [--budget <usd>] [--for <duration>] [--review <auto\|hetero\|self\|off>]` | Run goal mode manually until the scoped work completes, pauses, or hits a budget/usage/timebox guardrail; it can run while the scheduler is off, and a paused loop should be resumed first; final review defaults to `auto` |
+| `roll loop goal` | Show persisted goal scope, review mode, usage, limits, safety gate, and last decision |
 | `roll brief` | Show latest owner brief |
 | `roll backlog [sync\|block\|defer\|lint\|…]` | View, manage, and sync (from GitHub Issues) pending tasks |
-| `roll alert [run-once]` | View / clear loop alerts |
+| `roll loop alert [list\|ack\|resolve\|log]` | View / clear loop alerts |
 | `roll status` | Show current state and drift |
-| `roll doctor` | Environment + install diagnosis (agents, plists, launchd lanes) |
-| `roll dream run-once` | Nightly self-scan (patterns, docs freshness, test quality) — one pass now |
+| `roll doctor [skills]` | Environment + install diagnosis (agents, skill catalog, plists, launchd lanes) |
 | `roll tune [reset]` | Suggest-only self-tuning from loop trends — read-only, never auto-applies |
 | **Cards & evidence** | |
 | `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 |
 | `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) |
-| `roll attest <ID>` | Render the acceptance-evidence report into the card folder |
-| `roll index` | Rebuild the three-layer Delivery Dossier (front page · epics · story dossiers) |
-| `roll consistency <check\|audit>` | Five-dimension gap check · US-TRUTH shadow drift audit (read-only, exit 0) |
-| `roll changelog` | Sync CHANGELOG from merged work |
 | **Project · per repo** | |
 | `roll init` | Set up Roll in this project (agent-driven onboarding for legacy code) |
 | `roll offboard` | Remove Roll from this project |
-| `roll migrate` | Upgrade a pre-2.0 project layout |
 | `roll test [--where] [--reset]` | Run the test suite (routes through the isolation adapter; unknown types fail loud) |
 | `roll ci [--wait]` | Show or wait for current commit's CI status |
-| `roll release [ship\|waiver]` | Release guidance · gated tag push (`ship`) · recorded drift waiver (`waiver`) — npm publish stays human |
-| `roll feedback --type bug\|idea\|ux` | Open a GitHub issue for this project |
+| `roll release [ship\|waiver\|changelog\|consistency]` | Release guidance · changelog · consistency gate · gated tag push (`ship`) · recorded drift waiver (`waiver`) |
+| `roll release changelog generate [--write]` | Sync CHANGELOG from merged work |
+| `roll release consistency <check\|audit>` | Five-dimension gap check · US-TRUTH shadow drift audit (read-only, exit 0) |
 | `roll pair [init\|status]` | Cross-agent pairing: heterogeneous peer re-checks during builds |
+| `roll peer [--reviewer <agent>] (--prompt <text>\|--file <path>)` | One-shot structured external-provider review; records `.roll/peer/runs.jsonl` |
 | **Config & machine** | |
 | `roll config [lang <zh\|en\|--reset>\|…]` | Read/write roll config (language, loop window, dream time) |
 | `roll agent [set <slot> <agent>\|use <name>\|list]` | Per-machine complexity-slot routing (easy/default/hard/fallback) |
 | `roll prices [refresh]` | Model price table (cost accounting source) |
-| `roll skills` | Skill catalog status |
-| `roll setup [-f]` | First-time install or re-sync conventions to all AI clients |
+| `roll setup [skills\|-f]` | First-time install, skill catalog generation, or re-sync conventions to all AI clients |
 | `roll update` | Upgrade to latest + re-sync |
 | `roll --version` / `roll -v` | Print installed roll version |
 
+## Truth Model In The UI
+
+The Delivery Dossier is a truth projection, not a backlog mirror. Persistent
+facts flow through one read path: anchors -> selectors -> adapter ->
+projections. `roll index` renders the front truth board from three aggregates:
+Story, Cycle, and Release.
+
+- A backlog row is a claim; merge evidence on `main` and recorded acceptance
+  evidence are truth. A premature `✅ Done` claim is shown as drift.
+- Cycle history is read through the TerminalOutcome vocabulary, not legacy
+  free-form summary text.
+- Missing facts render as `?`. A visible `0` means a known zero, not unknown.
+
 ## Repository layout
 
 Dev side — a pnpm monorepo. Publish side — one npm package.
@@ -99,7 +109,7 @@ Published as a single npm package `@seanyao/roll`: `dist/` (the CLI bundled to o
 |---|---|
 | **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) · [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) |
+| **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) · [Peer review](guide/en/peer.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, feedback, backlog sync, adoption patterns, and more.