@seanyao/roll 3.617.1 → 3.617.2

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## Unreleased
 
+## v3.617.2 — 2026-06-17
+
+### 修复
+
+- **各类 agent 的展示、用量和 smoke 行为改走统一注册表**:模型名、实时观察窗、usage recovery、dashboard 回填、pairing 成本和 loop smoke 不再散落写 claude/pi/kimi/codex 特判;新增 agent 只需补 AgentSpec,非 claude 不再显示成 `?` 或被 mock smoke 降级。(FIX-313) `[loop]`
+  <!-- evidence: .roll/features/loop-engine/FIX-313/latest/FIX-313-report.html -->
+
+- **Loop 页的"已合并显示"这次真生效了**:上一版加的"PR 合了 → 显示绿色"其实是哑的——一个缓冲区上限太小的 bug 让它读不到 git 记录、静默失效;现在已合并的交付会正确显示为已交付(绿),且只按这个循环自己开的 PR 判定,不会被别的 PR 误判成绿。(FIX-349, FIX-348, FIX-350) `[loop-observability]`
+
+- **重复的故事编号当场拦住**:同一个编号被两个地方使用时,不再静默读到错的卡;新增一个 CI 检查,扫到重复编号就报错。(FIX-340) `[loop-engine]`
+
+- **发布没成功的循环不再误标"失败"**:循环把活干完、过了质量闸,但因为临时的 GitHub 故障没能开 PR 时,现在显示"未发布"(中性灰),不再误显示成"失败"(红);`roll loop run-once --help` 也改为显示帮助,不再误跑一个循环。(FIX-351) `[loop-engine]`
+
+### 性能(可选,默认关闭)
+
+- **两个 execute 提速开关(默认关,需手动开启)**:`prebuild_dist`(循环工作区一建好就预构建,省 agent 找入口的往返)和 `project_map`(spawn 时给 agent 注入精简的仓库结构 + 本卡相关文件,省它摸索)。对所有 agent 通用、不破循环隔离;不开就完全没影响。(FIX-338) `[loop-engine]`
+
 ## v3.617.1 — 2026-06-17
 
 ### 质量与可信

package/dist/roll.mjs

@@ -2382,6 +2382,14 @@ var init_terminal = __esm({
       "orphan_timeout",
       "idle_no_work",
       "gave_up",
+      // FIX-351 — a cycle that reached the end with its gates PASSED (attest
+      // produced + peer ok/consulted, real TCR commits, exit 0 → a `built` capture)
+      // but whose publish could NOT complete (push / `gh pr create` failed before
+      // any orphan branch was pushed). The WORK is sound and locally committed —
+      // this is NOT a gate failure. A neutral "ran locally, never published" state,
+      // distinct from `failed` (a gate genuinely failed / errored) and from
+      // `aborted_with_delivery` (publish failed but the branch WAS pushed for audit).
+      "unpublished",
       "unknown"
     ];
   }
@@ -3076,6 +3084,131 @@ var init_registry = __esm({
   }
 });
 
+// packages/core/dist/agent/specs.js
+function canonicalSpecKey(name) {
+  const raw = name.trim().toLowerCase();
+  if (raw === "antigravity" || raw === "gemini")
+    return "agy";
+  if (raw === "openai")
+    return "codex";
+  if (raw === "deepseek")
+    return "pi";
+  return raw;
+}
+function withAgentSpecs(extra = []) {
+  const out3 = {};
+  for (const spec of [...BASE_AGENT_SPECS, ...extra]) {
+    out3[canonicalSpecKey(spec.name)] = spec;
+    for (const alias of spec.aliases ?? [])
+      out3[canonicalSpecKey(alias)] = spec;
+  }
+  return out3;
+}
+function getAgentSpec(name, registry2 = AGENT_SPECS) {
+  return registry2[canonicalSpecKey(name)];
+}
+function agentDefaultModel(name, registry2 = AGENT_SPECS) {
+  return getAgentSpec(name, registry2)?.defaultModel ?? name;
+}
+function agentNormalizerKind(name, registry2 = AGENT_SPECS) {
+  return getAgentSpec(name, registry2)?.normalizer ?? "generic";
+}
+function agentSmokeCommand(name, registry2 = AGENT_SPECS) {
+  return getAgentSpec(name, registry2)?.smokeCommand ?? `${name} --version`;
+}
+var BASE_AGENT_SPECS, AGENT_SPECS;
+var init_specs = __esm({
+  "packages/core/dist/agent/specs.js"() {
+    "use strict";
+    BASE_AGENT_SPECS = [
+      {
+        name: "claude",
+        displayName: "claude",
+        defaultModel: "claude-sonnet-4",
+        normalizer: "claude",
+        usage: { stdoutExtractor: "claude-stream", sessionBackfill: "claude-projects" },
+        smokeCommand: 'claude -p "Reply with a single word: hello"'
+      },
+      {
+        name: "codex",
+        aliases: ["openai"],
+        displayName: "codex",
+        defaultModel: "gpt-5.5",
+        normalizer: "codex",
+        usage: { stdoutExtractor: "openai", sessionRecovery: "codex" },
+        smokeCommand: 'codex exec "Reply with a single word: hello"'
+      },
+      {
+        name: "kimi",
+        displayName: "kimi",
+        defaultModel: "kimi-k2",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "kimi", sessionRecovery: "kimi" },
+        smokeCommand: 'kimi-code -p "Reply with a single word: hello"'
+      },
+      {
+        name: "qwen",
+        displayName: "qwen",
+        defaultModel: "qwen-coder-plus",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "qwen" },
+        smokeCommand: 'qwen -p "Reply with a single word: hello"'
+      },
+      {
+        name: "agy",
+        aliases: ["antigravity", "gemini"],
+        displayName: "antigravity (agy)",
+        defaultModel: "gemini-2.5-pro",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "gemini" },
+        smokeCommand: 'agy -p "Reply with a single word: hello"'
+      },
+      {
+        name: "pi",
+        aliases: ["deepseek"],
+        displayName: "pi",
+        defaultModel: "deepseek-v4-pro",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "pi", sessionRecovery: "pi" },
+        smokeCommand: 'pi -p "Reply with a single word: hello"'
+      },
+      {
+        name: "cursor",
+        displayName: "cursor",
+        defaultModel: "cursor",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "generic" },
+        smokeCommand: "cursor --version"
+      },
+      {
+        name: "opencode",
+        displayName: "opencode",
+        defaultModel: "opencode",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "generic" },
+        smokeCommand: "opencode --version"
+      },
+      {
+        name: "trae",
+        displayName: "trae",
+        defaultModel: "trae",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "generic" },
+        smokeCommand: "trae --version"
+      },
+      {
+        name: "openclaw",
+        displayName: "openclaw",
+        defaultModel: "openclaw",
+        normalizer: "generic",
+        usage: { stdoutExtractor: "generic" },
+        smokeCommand: "openclaw --version"
+      }
+    ];
+    AGENT_SPECS = withAgentSpecs();
+  }
+});
+
 // packages/core/dist/agent/router.js
 function classifyComplexity(estMin) {
   if (estMin === null || estMin === void 0)
@@ -3380,7 +3513,8 @@ function makeStdoutExtractor(spec) {
   };
 }
 function extractUsage(agent, lines2) {
-  const fn = REGISTRY[agent];
+  const key = getAgentSpec(agent)?.usage.stdoutExtractor ?? agent;
+  const fn = REGISTRY[key];
   if (fn === void 0)
     return null;
   let result;
@@ -3391,8 +3525,9 @@ function extractUsage(agent, lines2) {
   }
   if (result === null)
     return null;
-  for (const key of REQUIRED_FIELDS) {
-    if (result[key] === void 0 || result[key] === null)
+  const required2 = key === "claude-stream" ? REQUIRED_FIELDS.filter((field2) => field2 !== "cost_list_usd") : REQUIRED_FIELDS;
+  for (const field2 of required2) {
+    if (result[field2] === void 0 || result[field2] === null)
       return null;
   }
   return result;
@@ -3639,6 +3774,7 @@ var MODEL_RE, INPUT_RE, OUTPUT_RE, COST_RE, TOTAL_RE_OPENAI, TOTAL_RE_GENERIC, S
 var init_tracker = __esm({
   "packages/core/dist/cost/tracker.js"() {
     "use strict";
+    init_specs();
     init_prices();
     MODEL_RE = /^\s*model\s*[:=]\s*([A-Za-z0-9][\w.\-]*)/i;
     INPUT_RE = /input(?:\s+tokens)?\s*[:=]\s*([\d,]+)/i;
@@ -3658,11 +3794,13 @@ var init_tracker = __esm({
     qwenExtract = makeStdoutExtractor(STDOUT_AGENTS["qwen"]);
     piExtract = () => null;
     REGISTRY = {
+      "claude-stream": sumClaudeStream,
       pi: piExtract,
       openai: openaiExtract,
       gemini: geminiExtract,
       kimi: kimiExtract,
-      qwen: qwenExtract
+      qwen: qwenExtract,
+      generic: makeStdoutExtractor({ defaultModel: "generic", totalKind: "generic" })
     };
     REQUIRED_FIELDS = [
       "model",
@@ -3800,7 +3938,7 @@ function peerReviewCost(peer, stdout) {
   try {
     const canon = canonicalAgentName(peer);
     const lines2 = stdout.split("\n");
-    const usage2 = canon === "claude" ? sumClaudeStream(lines2) : extractUsage(canon, lines2);
+    const usage2 = extractUsage(canon, lines2);
     if (usage2 === null)
       return 0;
     if ((usage2.input_tokens ?? 0) === 0 && (usage2.output_tokens ?? 0) === 0)
@@ -5442,10 +5580,10 @@ function codexJsonl(line) {
   }
 }
 function normalizerFor(agent) {
-  const a = (agent ?? "").trim().toLowerCase();
-  if (a === "claude")
+  const kind = agentNormalizerKind(agent);
+  if (kind === "claude")
     return claudeNormalizer;
-  if (a === "codex")
+  if (kind === "codex")
     return codexNormalizer;
   return genericNormalizer;
 }
@@ -5453,6 +5591,7 @@ var KIND_TIER, DEFAULT_HEARTBEAT_GAP_MS, SUPPRESS_TOOLS, PEER_VERDICTS, claudeNo
 var init_activity_signal = __esm({
   "packages/core/dist/loop/activity-signal.js"() {
     "use strict";
+    init_specs();
     init_signals();
     KIND_TIER = {
       lifecycle: "A",
@@ -6298,6 +6437,8 @@ function mapV2Status(status2) {
       return "gave_up";
     case "orphan":
       return "aborted_with_delivery";
+    case "local":
+      return "unpublished";
     case "failed":
       return "failed";
     case "aborted":
@@ -6327,17 +6468,18 @@ function classifyPublish(pub) {
   if (pub.status === 0)
     return "published";
   if (pub.status === 2) {
-    if (pub.manualMerge === true)
-      return "failed";
+    if (pub.manualMerge === true) {
+      return pub.orphanPushed === true ? "orphan" : "local";
+    }
     if (pub.mergedBack === true)
       return "done";
     if (pub.orphanPushed === true)
       return "orphan";
-    return "failed";
+    return "local";
   }
   if (pub.orphanPushed === true)
     return "orphan";
-  return "failed";
+  return "local";
 }
 function watchdogVerdict(elapsedSec, limitSec = CYCLE_TIMEOUT_SEC) {
   if (elapsedSec >= limitSec)
@@ -6542,8 +6684,8 @@ function cycleStep(state, event) {
           { kind: "append_alert", message: `cycle ${state.ctx.cycleId}: publish failed; orphan branch+tag pushed; worktree cleaned` }
         ]);
       }
-      return terminate({ ...state, phase: "publish" }, "failed", [
-        { kind: "append_alert", message: `cycle ${state.ctx.cycleId}: publish failed; worktree preserved at branch ${state.ctx.branch}` }
+      return terminate({ ...state, phase: "publish" }, "local", [
+        { kind: "append_alert", message: `cycle ${state.ctx.cycleId}: gates passed but publish did not complete \u2014 work committed locally, worktree preserved at branch ${state.ctx.branch} (unpublished, not a failure)` }
       ]);
     }
     case "merge_polled": {
@@ -6915,7 +7057,15 @@ function parseLoopSafety(lines2, start) {
     ...flat["peer_gate"] === "hard" || flat["peer_gate"] === "soft" ? { peerGate: flat["peer_gate"] } : {},
     // FIX-298: the network-guard recovery hook. A non-empty string is the shell
     // command the guard runs to enable connectivity before re-checking.
-    ...flat["proxy_enable_cmd"] !== void 0 && flat["proxy_enable_cmd"] !== "" ? { proxyEnableCmd: flat["proxy_enable_cmd"] } : {}
+    ...flat["proxy_enable_cmd"] !== void 0 && flat["proxy_enable_cmd"] !== "" ? { proxyEnableCmd: flat["proxy_enable_cmd"] } : {},
+    // FIX-338: the prebuild-dist execute-speed lever. DEFAULT-OFF — only an
+    // explicit `prebuild_dist: true` turns it on; anything else (absent / false /
+    // garbage) leaves it false so deploy stays a NO-OP (稳字纪律).
+    ...flat["prebuild_dist"] === "true" ? { prebuildDist: true } : {},
+    // FIX-338 (杠杆2): the project-map injection execute-speed lever. DEFAULT-OFF —
+    // only an explicit `project_map: true` turns it on; anything else (absent /
+    // false / garbage) leaves it false so deploy stays a NO-OP (稳字纪律).
+    ...flat["project_map"] === "true" ? { projectMap: true } : {}
   };
   return [i, cfg];
 }
@@ -8441,7 +8591,10 @@ var init_selectors = __esm({
       // was unmapped, fell to outcome "" → "unknown" panel, and the failure was
       // silently swallowed from every failed count (the FIX-248 class).
       reverted: "failed",
-      orphan: "aborted_with_delivery"
+      orphan: "aborted_with_delivery",
+      // FIX-351: gates passed but publish did not land (work committed locally) — a
+      // neutral non-failure terminal, NOT mapped into the failed cluster.
+      local: "unpublished"
     };
   }
 });
@@ -8451,6 +8604,7 @@ var init_dist2 = __esm({
   "packages/core/dist/index.js"() {
     "use strict";
     init_registry();
+    init_specs();
     init_router();
     init_pairing();
     init_peer_review();
@@ -8575,11 +8729,15 @@ function fmtDur(s) {
 function fmtModel(model) {
   if (model === null || model === void 0 || model === "")
     return "\u2014";
-  if (!model.startsWith("claude-"))
-    return "?";
-  let s = model.slice("claude-".length);
+  const prefixed = /^([a-z][a-z0-9_]*)-(.+)$/i.exec(model);
+  if (prefixed === null)
+    return model;
+  const vendor = prefixed[1] ?? "";
+  let s = prefixed[2] ?? "";
+  if (vendor !== "claude")
+    return model;
   s = s.replace(/-\d{6,8}$/, "");
-  return s !== "" ? s : "?";
+  return s !== "" ? s : model;
 }
 function pyFixed1(x) {
   const scaled = x * 10;
@@ -8781,8 +8939,8 @@ function cycleRow(cy) {
   const timeC = outcome === "fail" ? "red" : "fg";
   const sidC = outcome === "fail" ? "red" : "blue";
   let modelLabel = fmtModel(cy.model);
-  if ((modelLabel === "\u2014" || modelLabel === "?") && cy.agent) {
-    modelLabel = AGENT_PRIMARY_MODEL[cy.agent] ?? cy.agent;
+  if (modelLabel === "\u2014" && cy.agent) {
+    modelLabel = agentDefaultModel(cy.agent);
   }
   const showModel = COLS >= 100;
   const modelSeg = showModel ? c("muted", pad(modelLabel, 11)) + " " : "";
@@ -8818,10 +8976,11 @@ function cycleRow(cy) {
   }
   return lines2;
 }
-var COLS, renderState, PAL, BOLD, RESET, ANSI_RE2, RESET_RAW, AGENT_PRIMARY_MODEL, BG_FAIL, WEEKDAY_EN, WEEKDAY_ZH;
+var COLS, renderState, PAL, BOLD, RESET, ANSI_RE2, RESET_RAW, BG_FAIL, WEEKDAY_EN, WEEKDAY_ZH;
 var init_render = __esm({
   "packages/cli/dist/render.js"() {
     "use strict";
+    init_dist2();
     COLS = 100;
     renderState = { useColor: true };
     PAL = {
@@ -8841,11 +9000,6 @@ var init_render = __esm({
     RESET = "\x1B[0m";
     ANSI_RE2 = /\x1b\[[\d;]*m/g;
     RESET_RAW = "\x1B[0m";
-    AGENT_PRIMARY_MODEL = {
-      pi: "deepseek-v4-pro",
-      deepseek: "deepseek-v4-pro",
-      kimi: "kimi-k2-0905"
-    };
     BG_FAIL = "\x1B[48;2;55;15;15m";
     WEEKDAY_EN = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"];
     WEEKDAY_ZH = ["\u5468\u4E00", "\u5468\u4E8C", "\u5468\u4E09", "\u5468\u56DB", "\u5468\u4E94", "\u5468\u516D", "\u5468\u65E5"];
@@ -12183,6 +12337,11 @@ function outcomeToPanel(outcome, state) {
       return "done";
     case "idle_no_work":
       return "idle";
+    // FIX-351: gates passed but publish did not land (work committed locally) —
+    // a NEUTRAL state, NOT a failure. Classified `idle`-side so the panel/tally
+    // never counts a sound-but-unpublished cycle as a fail (it is not red).
+    case "unpublished":
+      return "idle";
     case "failed":
     case "blocked":
     case "aborted_no_delivery":
@@ -14049,6 +14208,7 @@ duration: ${facts.durationMs}ms
 // packages/cli/dist/commands/dashboard.js
 init_render();
 init_dist3();
+init_dist2();
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { createHash as createHash3 } from "node:crypto";
 import { existsSync as existsSync18, readFileSync as readFileSync17, readdirSync as readdirSync7, realpathSync as realpathSync2, statSync as statSync8 } from "node:fs";
@@ -14731,7 +14891,9 @@ function repairOrphanCyclesFromGit(cycles, gitMerges) {
     }
   }
 }
-function loadClaudeSessionUsage(label4, slug) {
+function loadStreamJsonSessionUsage(label4, slug, agent) {
+  if (getAgentSpec(agent)?.usage.sessionBackfill !== "claude-projects")
+    return null;
   const user = process.env["USER"] ?? "seanyao";
   const worktreePath = `/Users/${user}/.shared/roll/worktrees/${slug}-cycle-${label4}`;
   const projName = "-" + worktreePath.replaceAll("/", "-").replaceAll(".", "-").replace(/^-+/, "");
@@ -14796,7 +14958,7 @@ function loadClaudeSessionUsage(label4, slug) {
     return null;
   return { model, ...sums, cost_reported_usd: cost, duration_ms: durationMs };
 }
-function backfillUsageFromClaudeSessions(cycles, slug) {
+function backfillUsageFromAgentSessions(cycles, slug) {
   for (const cy of cycles) {
     const ue = cy.usage_event;
     if (ue !== void 0 && (toInt2(ue["input_tokens"]) || toInt2(ue["output_tokens"]))) {
@@ -14827,7 +14989,7 @@ function backfillUsageFromClaudeSessions(cycles, slug) {
     }
     if (cy.input_tokens || cy.output_tokens)
       continue;
-    const u = loadClaudeSessionUsage(cy.label, slug);
+    const u = loadStreamJsonSessionUsage(cy.label, slug, cy.agent ?? "");
     if (!u)
       continue;
     cy.input_tokens = toInt2(u.input_tokens);
@@ -15414,7 +15576,7 @@ function isoLabel(d) {
   return `${d.getUTCFullYear()}${pad2(d.getUTCMonth() + 1)}${pad2(d.getUTCDate())}-${pad2(d.getUTCHours())}${pad2(d.getUTCMinutes())}${pad2(d.getUTCSeconds())}-30585`;
 }
 function render(out3, events, cron, state, backlog, args) {
-  const { days, lang: lang9, runs, gitMerges, claudeSlug, now } = args;
+  const { days, lang: lang9, runs, gitMerges, projectSlug: projectSlug4, now } = args;
   const cycles = aggregate(events, cron);
   const matchedRunIds = Object.keys(runs).length > 0 ? mergeRunsIntoCycles(cycles, runs) : /* @__PURE__ */ new Set();
   for (const cy of cycles) {
@@ -15430,7 +15592,7 @@ function render(out3, events, cron, state, backlog, args) {
   }
   if (Object.keys(gitMerges).length > 0)
     repairOrphanCyclesFromGit(cycles, gitMerges);
-  backfillUsageFromClaudeSessions(cycles, claudeSlug ?? "");
+  backfillUsageFromAgentSessions(cycles, projectSlug4 ?? "");
   const byDay = bucketByDay(cycles);
   const daysKeys = [...byDay.keys()].sort().reverse().slice(0, days);
   const bilingual2 = (enLine, zhLine) => {
@@ -15692,7 +15854,7 @@ function collectCycles(slug, days) {
     mergeRunsIntoCycles(cycles, runs);
   if (Object.keys(gitMerges).length > 0)
     repairOrphanCyclesFromGit(cycles, gitMerges);
-  backfillUsageFromClaudeSessions(cycles, slug);
+  backfillUsageFromAgentSessions(cycles, slug);
   return cycles;
 }
 function rollupForStory(cycles, storyId) {
@@ -15993,7 +16155,7 @@ roll-loop-status.py: error: unrecognized arguments: ${args.unknown.join(" ")}
     lang: lang9,
     runs,
     gitMerges,
-    claudeSlug: slug,
+    projectSlug: slug,
     now,
     rtDir: useFixture || slug === null ? null : loopRuntimeDir(slug)
   });
@@ -16907,6 +17069,12 @@ function overviewTab(input) {
 }
 var VERDICT_COLORS = {
   delivered: C.green,
+  pending_merge: C.amber,
+  // PR open, merge pending — in-flight (amber), not red
+  // FIX-351: gates passed but publish did not land (work committed locally) —
+  // a NEUTRAL blue, clearly distinct from `failed` (red). The dashboard reads
+  // it as "ran locally, not published", never as a failure.
+  unpublished: C.blue,
   reverted: C.amber,
   failed: C.red,
   blocked: C.purple,
@@ -16915,6 +17083,9 @@ var VERDICT_COLORS = {
 };
 var VERDICT_ZH = {
   delivered: "\u5DF2\u4EA4\u4ED8",
+  pending_merge: "\u5F85\u5408\u5E76",
+  unpublished: "\u672A\u53D1\u5E03",
+  // FIX-351: 闸通过但未发布(本地已提交)——中性,非失败
   reverted: "\u5DF2\u56DE\u6EDA",
   failed: "\u5931\u8D25",
   blocked: "\u88AB\u963B\u585E",
@@ -18091,6 +18262,8 @@ function ledgerVerdict(status2, outcome) {
   if (outcome === "published_pending_merge" || status2 === "published" || status2 === "built" || status2 === "done") {
     return "pending_merge";
   }
+  if (outcome === "unpublished" || status2 === "local")
+    return "unpublished";
   if (outcome === "blocked" || status2 === "blocked")
     return "blocked";
   if (outcome === "idle_no_work" || status2 === "idle")
@@ -18112,7 +18285,9 @@ function reconcilePendingMergeVerdicts(rows, isMerged) {
   return rows.map((r) => {
     if (r.verdict !== "pending_merge")
       return r;
-    if (r.storyId === "" || !isMerged(r.storyId))
+    if (r.storyId === "" && r.prNumber === void 0)
+      return r;
+    if (!isMerged(r.storyId, r.prNumber))
       return r;
     return {
       ...r,
@@ -18164,14 +18339,15 @@ function readEventFacts(projectPath3) {
   const byCycle = /* @__PURE__ */ new Map();
   const prMergedBy = /* @__PURE__ */ new Map();
   const prOpenBy = /* @__PURE__ */ new Map();
+  const prByCycle = /* @__PURE__ */ new Map();
   const path = join23(projectPath3, ".roll", "loop", "events.ndjson");
   if (!existsSync25(path))
-    return { byCycle, prMergedBy, prOpenBy };
+    return { byCycle, prMergedBy, prOpenBy, prByCycle };
   let content = "";
   try {
     content = readFileSync23(path, "utf8");
   } catch {
-    return { byCycle, prMergedBy, prOpenBy };
+    return { byCycle, prMergedBy, prOpenBy, prByCycle };
   }
   const facts = (id) => {
     let f = byCycle.get(id);
@@ -18195,14 +18371,28 @@ function readEventFacts(projectPath3) {
       prMergedBy.set(e.storyId, e.prNumber);
     else if (e.type === "pr:open")
       prOpenBy.set(e.storyId, e.prNumber);
+    else if (e.type === "cycle:terminal" && e.pr.present) {
+      const n = terminalPrNumber(e.pr.value);
+      if (n !== void 0)
+        prByCycle.set(e.cycleId, n);
+    }
   }
-  return { byCycle, prMergedBy, prOpenBy };
+  return { byCycle, prMergedBy, prOpenBy, prByCycle };
+}
+function terminalPrNumber(pr) {
+  if (typeof pr.number === "number" && Number.isInteger(pr.number) && pr.number > 0)
+    return pr.number;
+  const m7 = /\/pull\/(\d+)/.exec(pr.url);
+  if (m7 === null)
+    return void 0;
+  const n = Number(m7[1]);
+  return Number.isInteger(n) && n > 0 ? n : void 0;
 }
 function rowTape(row2, verdict, ev, prNumber, prOpen) {
   const storyId = typeof row2["story_id"] === "string" ? row2["story_id"] : "";
   const tcr = typeof row2["tcr_count"] === "number" ? row2["tcr_count"] : 0;
   const seg = (key, detail, state) => ({ key, detail, state });
-  const endState = verdict === "delivered" ? "pass" : verdict === "idle" ? "idle" : verdict === "unknown" ? "unknown" : "fail";
+  const endState = verdict === "delivered" ? "pass" : verdict === "idle" || verdict === "unpublished" ? "idle" : verdict === "unknown" ? "unknown" : "fail";
   return [
     seg("cycle", typeof row2["ts"] === "string" ? row2["ts"].replace("T", " ").replace(/:\d{2}Z$/, "Z") : "\u2014", "pass"),
     seg("story", storyId !== "" ? storyId : "\u2014", storyId !== "" ? "pass" : "idle"),
@@ -18228,7 +18418,7 @@ function collectCycleLedger(projectPath3) {
   } catch {
     return [];
   }
-  const { byCycle, prMergedBy, prOpenBy } = readEventFacts(projectPath3);
+  const { byCycle, prMergedBy, prOpenBy, prByCycle } = readEventFacts(projectPath3);
   const rows = [];
   for (const line of content.split("\n")) {
     if (line.trim() === "")
@@ -18269,7 +18459,10 @@ function collectCycleLedger(projectPath3) {
       cost: cost !== void 0 ? `$${cost.toFixed(2)}` : usageUnknown ? "?" : "\u2014",
       duration: fmtDuration(row2["duration_sec"]),
       tape: rowTape(row2, verdict, ev, prNumber, prOpen),
-      evidence
+      evidence,
+      // FIX-348: the cycle's own PR number (cycle:terminal twin), falling back to
+      // the merged/open PR event keyed by story when the terminal twin is absent.
+      prNumber: prByCycle.get(cycleId) ?? prNumber ?? prOpen
     });
   }
   const byId = /* @__PURE__ */ new Map();
@@ -21924,6 +22117,20 @@ function storyHasMergeEvidence(facts, storyId) {
     return true;
   return factsPrNumbers(facts, storyId).length > 0;
 }
+function gitHasPrMergeCommit(facts, prNumber) {
+  if (facts === null || !Number.isInteger(prNumber) || prNumber <= 0)
+    return false;
+  for (const c2 of facts.commits) {
+    for (const m7 of c2.subject.matchAll(/(?:\(#|PR\s*#?)(\d+)\)?/gi)) {
+      if (numberFromString(m7[1]) === prNumber)
+        return true;
+    }
+  }
+  return false;
+}
+function cycleMergeTruth(facts) {
+  return (storyId, prNumber) => prNumber !== void 0 && prNumber !== null ? gitHasPrMergeCommit(facts, prNumber) : storyId !== "" && storyHasMergeEvidence(facts, storyId);
+}
 function factsPrNumbers(facts, storyId) {
   const nums = /* @__PURE__ */ new Set();
   for (const subject of factsSubjects(facts, storyId)) {
@@ -21995,7 +22202,13 @@ function statDir(p) {
   return statSync13(p).isFile();
 }
 function execGit(cwd, args) {
-  return execFileSync6("git", args, { cwd, encoding: "utf8", timeout: 1e4, stdio: ["ignore", "pipe", "ignore"] });
+  return execFileSync6("git", args, {
+    cwd,
+    encoding: "utf8",
+    timeout: 1e4,
+    stdio: ["ignore", "pipe", "ignore"],
+    maxBuffer: 256 * 1024 * 1024
+  });
 }
 
 // packages/cli/dist/commands/index-gen.js
@@ -22335,7 +22548,10 @@ function generateDossierPages(cwd, rebuild) {
       // rewrites its runs row. Reuses the SAME offline git facts the dossier
       // already built (storyHasMergeEvidence — a `git log` check, no gh call;
       // refreshDossierMergeBaseline fetched origin/main just above).
-      cycles: reconcilePendingMergeVerdicts(collectCycleLedger(cwd), (id) => storyHasMergeEvidence(runCache.git, id)),
+      // FIX-348: cycleMergeTruth ALSO matches the row's recorded PR number, so
+      // a merged delivery whose squash commit carries `(#N)` but does NOT name
+      // the story-id (e.g. FIX-287 / PR #773) still reconciles to delivered.
+      cycles: reconcilePendingMergeVerdicts(collectCycleLedger(cwd), cycleMergeTruth(runCache.git)),
       agents: agentRows,
       releasePanel: collectReleasePanel(cwd),
       skills: collectSkillsPanel(cwd),
@@ -24919,7 +25135,7 @@ import { join as join42 } from "node:path";
 init_render();
 function reconciledLedger(cwd) {
   const git4 = collectGitDossierFacts(cwd);
-  return reconcilePendingMergeVerdicts(collectCycleLedger(cwd), (id) => storyHasMergeEvidence(git4, id));
+  return reconcilePendingMergeVerdicts(collectCycleLedger(cwd), cycleMergeTruth(git4));
 }
 var CYCLES_USAGE = "Usage: roll cycles [--since 1d|3d|7d|all] [--detail <id>]\n  The cycle ledger: one line per cycle, failures never swallowed (default --since 3d).\n  --detail <id>  the per-cycle build-phase timeline (per-commit / heartbeat timing).\n\u5468\u671F\u8D26\u672C\uFF1A\u6BCF\u884C\u4E00\u4E2A cycle\uFF0C\u5931\u8D25\u4E0D\u88AB\u541E\uFF08\u9ED8\u8BA4 --since 3d\uFF09\u3002\n  --detail <id>  \u5355\u4E2A cycle \u7684 build \u9636\u6BB5\u65F6\u95F4\u7EBF\uFF08\u6BCF\u63D0\u4EA4/\u5FC3\u8DF3\u8BA1\u65F6\uFF09\u3002";
 var WINDOWS = { "1d": 1, "3d": 3, "7d": 7 };
@@ -24931,6 +25147,8 @@ var VERDICT_COLOR3 = {
   delivered: "green",
   pending_merge: "yellow",
   // FIX-322: opened a PR, merge pending — in-flight, NOT delivered (amber)
+  unpublished: "blue",
+  // FIX-351: gates passed, work local, publish didn't land — neutral, NOT red
   reverted: "yellow",
   failed: "red",
   blocked: "purple",
@@ -25185,7 +25403,7 @@ function findCycle(rows, raw) {
 }
 function renderCycleTrace(row2, lang9, slug) {
   const lines2 = [];
-  lines2.push(`#${cycleNo(row2.cycleId)} \xB7 ${c(row2.verdict === "delivered" ? "green" : row2.verdict === "idle" ? "muted" : "red", row2.verdict)} \xB7 ${row2.model} \xB7 ${row2.tokens} \xB7 ${row2.cost} \xB7 ${row2.duration}`);
+  lines2.push(`#${cycleNo(row2.cycleId)} \xB7 ${c(row2.verdict === "delivered" ? "green" : row2.verdict === "idle" || row2.verdict === "unpublished" ? "muted" : "red", row2.verdict)} \xB7 ${row2.model} \xB7 ${row2.tokens} \xB7 ${row2.cost} \xB7 ${row2.duration}`);
   lines2.push(lang9 === "zh" ? `story ${row2.storyId === "" ? "\u2014\uFF08\u65E0\u6545\u4E8B\uFF09" : row2.storyId}` : `story ${row2.storyId === "" ? "\u2014 (no story)" : row2.storyId}`);
   lines2.push("");
   const reached = new Set(row2.tape.filter((s) => s.detail !== "\u2014" || s.state !== "unknown").map((s) => s.key));
@@ -28600,23 +28818,47 @@ function reportCandidates(worktreeCwd, storyId) {
 function acMapCandidates(worktreeCwd, storyId) {
   return [join57(cardArchiveDir(worktreeCwd, storyId), "ac-map.json")];
 }
-function storySpecPath(worktreeCwd, storyId) {
+function storySpecMatches(worktreeCwd, storyId) {
   const featuresDir = join57(worktreeCwd, ".roll", "features");
+  const matches = [];
+  let entries;
   try {
-    for (const epic of readdirSync23(featuresDir, { withFileTypes: true })) {
-      if (!epic.isDirectory())
-        continue;
-      const spec = join57(featuresDir, epic.name, storyId, "spec.md");
-      if (existsSync58(spec))
-        return spec;
-      const legacy = join57(featuresDir, epic.name, `${storyId}.md`);
-      if (existsSync58(legacy))
-        return legacy;
-    }
+    entries = readdirSync23(featuresDir, { withFileTypes: true });
   } catch {
-    return null;
+    return matches;
   }
-  return null;
+  for (const epic of entries) {
+    if (!epic.isDirectory())
+      continue;
+    const spec = join57(featuresDir, epic.name, storyId, "spec.md");
+    if (existsSync58(spec)) {
+      matches.push(spec);
+      continue;
+    }
+    const legacy = join57(featuresDir, epic.name, `${storyId}.md`);
+    if (existsSync58(legacy))
+      matches.push(legacy);
+  }
+  return matches;
+}
+var DuplicateStoryIdError = class extends Error {
+  storyId;
+  matches;
+  constructor(storyId, matches) {
+    super(`duplicate story id ${storyId}: resolves to ${matches.length} specs \u2014 a story id MUST resolve uniquely (\u4E00\u4E2A ID \u4E00\u4EFD spec). Disambiguate (rename/archive) one of:
+` + matches.map((m7) => `  - ${m7}`).join("\n"));
+    this.storyId = storyId;
+    this.matches = matches;
+    this.name = "DuplicateStoryIdError";
+  }
+};
+function storySpecPath(worktreeCwd, storyId) {
+  const matches = storySpecMatches(worktreeCwd, storyId);
+  if (matches.length === 0)
+    return null;
+  if (matches.length > 1)
+    throw new DuplicateStoryIdError(storyId, matches);
+  return matches[0] ?? null;
 }
 function storyHasAcBlock(worktreeCwd, storyId) {
   const spec = storySpecPath(worktreeCwd, storyId);
@@ -29367,7 +29609,18 @@ story validate: '${id}' \u4E0D\u662F\u5408\u6CD5\u6545\u4E8B ID
     return 2;
   }
   const cwd = process.cwd();
-  const spec = storySpecPath(cwd, id);
+  let spec;
+  try {
+    spec = storySpecPath(cwd, id);
+  } catch (e) {
+    if (e instanceof DuplicateStoryIdError) {
+      process.stderr.write(`story validate: ${e.message}
+story validate: ${id} \u89E3\u6790\u5230\u591A\u4EFD spec \u2014 \u5FC5\u987B\u552F\u4E00(\u6D88\u9664\u91CD\u590D ID \u540E\u91CD\u8BD5)
+`);
+      return 2;
+    }
+    throw e;
+  }
   if (spec === null) {
     process.stderr.write(`story validate: no spec found for ${id} (looked for features/<epic>/${id}/spec.md and features/<epic>/${id}.md)
 story validate: \u627E\u4E0D\u5230 ${id} \u7684 spec
@@ -30835,6 +31088,7 @@ async function loopWatchCommand(args, deps = realDeps6()) {
 
 // packages/cli/dist/commands/loop-maint.js
 init_dist3();
+init_dist2();
 init_dist();
 import { spawnSync as spawnSync8 } from "node:child_process";
 import { existsSync as existsSync61, mkdirSync as mkdirSync28, readFileSync as readFileSync56, readdirSync as readdirSync25, renameSync as renameSync8, rmSync as rmSync10, statSync as statSync21, writeFileSync as writeFileSync28 } from "node:fs";
@@ -31097,7 +31351,7 @@ function realTestDeps() {
   };
 }
 function defaultSmokeCmd(agent) {
-  return agent === "claude" ? 'claude -p "Reply with a single word: hello"; sleep 10' : `echo 'mock ${agent} output line 1'; echo 'mock ${agent} output line 2'`;
+  return `${agentSmokeCommand(agent)}; sleep 10`;
 }
 function loopTestCommand(args = [], deps = realTestDeps()) {
   const slug = deps.slug();
@@ -32353,6 +32607,7 @@ async function executeCommand(cmd, ports, ctx) {
       const depsOk = await bootstrapWorktreeDeps(ports.paths.worktreePath, ports.paths.alertsPath, ports.events, ports.depsExec);
       if (!depsOk)
         return { event: { type: "worktree_failed" } };
+      await bootstrapWorktreePrebuild(ports.paths.worktreePath, ports.paths.alertsPath, ports.events, readPrebuildDistEnabled(ports.repoCwd), ports.depsExec);
       return { event: { type: "worktree_created" } };
     }
     // backlog/picker pickStory (read backlog INSIDE the worktree, bin/roll:8938).
@@ -32437,11 +32692,12 @@ async function executeCommand(cmd, ports, ctx) {
       }
       const captureSink = ctx.evidenceRunDir !== void 0 && ctx.evidenceRunDir !== "" ? createCaptureMarkerSink(ctx.evidenceRunDir, ports.capture) : void 0;
       const observer = startCycleObserver(ports, ctx.cycleId ?? "");
+      const skillBodyForSpawn = maybeInjectProjectMap(ports.skillBody, ports.paths.worktreePath, readProjectMapEnabled(ports.repoCwd), ctx.storyId);
       let res;
       try {
         res = await ports.agentSpawn(cmd.agent, {
           cwd: ports.paths.worktreePath,
-          skillBody: ports.skillBody,
+          skillBody: skillBodyForSpawn,
           ...ctx.evidenceRunDir !== void 0 ? { runDir: ctx.evidenceRunDir } : {},
           writableRoots: agentWritableRoots(ports.repoCwd, ports.paths.alertsPath),
           env: {
@@ -32485,16 +32741,17 @@ ${res.stderr}
       try {
         const agentName = ctx.agent ?? cmd.agent;
         const lines2 = res.stdout.split("\n");
-        let usage2 = sumClaudeStream(lines2);
-        if (usage2 === null && agentName === "pi") {
+        const usageSpec = getAgentSpec(agentName)?.usage;
+        let usage2 = usageSpec?.stdoutExtractor === "claude-stream" ? extractUsage(agentName, lines2) : null;
+        if (usage2 === null && usageSpec?.sessionRecovery === "pi") {
           const rootOverride = (process.env["ROLL_PI_SESSIONS_ROOT"] ?? "").trim();
           usage2 = recoverPiUsage(ports.paths.worktreePath, ctx.startSec, ...rootOverride !== "" ? [rootOverride] : []);
         }
-        if (usage2 === null && agentName === "kimi") {
+        if (usage2 === null && usageSpec?.sessionRecovery === "kimi") {
           const rootOverride = (process.env["ROLL_KIMI_SESSIONS_DIR"] ?? "").trim();
           usage2 = recoverKimiUsage(ports.paths.worktreePath, ctx.startSec, ...rootOverride !== "" ? [rootOverride] : []);
         }
-        if (usage2 === null && (agentName === "codex" || agentName === "openai")) {
+        if (usage2 === null && usageSpec?.sessionRecovery === "codex") {
           const rootOverride = (process.env["ROLL_CODEX_SESSIONS_DIR"] ?? "").trim();
           usage2 = recoverCodexUsage(ports.paths.worktreePath, ctx.startSec, ...rootOverride !== "" ? [rootOverride] : []);
         }
@@ -32998,7 +33255,10 @@ function buildTerminalRecord(cmd, ctx, attestCwd, nowSec2) {
     failed: "failed",
     blocked: "blocked",
     aborted: "aborted_no_delivery",
-    orphan: "aborted_with_delivery"
+    orphan: "aborted_with_delivery",
+    // FIX-351: gates passed but publish could not complete (work committed
+    // locally, never published) — a neutral terminal, NOT a failure.
+    local: "unpublished"
   };
   let attest;
   if (storyId === "") {
@@ -33355,6 +33615,147 @@ async function bootstrapWorktreeDeps(worktreePath, alertsPath, events, exec = ex
     return false;
   }
 }
+var PREBUILD_TIMEOUT_MS = 6e5;
+function readPrebuildDistEnabled(repoCwd) {
+  try {
+    const p = join66(repoCwd, ".roll", "policy.yaml");
+    if (!existsSync66(p))
+      return false;
+    return parsePolicy(readFileSync62(p, "utf8")).loopSafety.prebuildDist === true;
+  } catch {
+    return false;
+  }
+}
+async function bootstrapWorktreePrebuild(worktreePath, alertsPath, events, enabled, exec = execFileAsync9) {
+  if (!enabled)
+    return;
+  if (!existsSync66(join66(worktreePath, "package.json")))
+    return;
+  if (!existsSync66(join66(worktreePath, "pnpm-lock.yaml")))
+    return;
+  try {
+    await exec("pnpm", ["-r", "build"], {
+      cwd: worktreePath,
+      timeout: PREBUILD_TIMEOUT_MS,
+      maxBuffer: 16 * 1024 * 1024
+    });
+  } catch (e) {
+    const msg6 = e instanceof Error ? e.message.split("\n")[0] : String(e);
+    events.appendAlert(alertsPath, `[WARN] worktree dist prebuild failed (pnpm -r build): ${msg6} \u2014 continuing; agent will build on demand`);
+  }
+}
+function readProjectMapEnabled(repoCwd) {
+  try {
+    const p = join66(repoCwd, ".roll", "policy.yaml");
+    if (!existsSync66(p))
+      return false;
+    return parsePolicy(readFileSync62(p, "utf8")).loopSafety.projectMap === true;
+  } catch {
+    return false;
+  }
+}
+var PROJECT_MAP_MAX_CHARS = 1800;
+var PROJECT_MAP_MAX_TOPLEVEL = 24;
+var PROJECT_MAP_MAX_RELEVANT = 12;
+var PROJECT_MAP_SKIP = /* @__PURE__ */ new Set([
+  ".git",
+  "node_modules",
+  ".vite",
+  "dist",
+  "coverage",
+  ".turbo",
+  ".cache",
+  ".DS_Store"
+]);
+var PROJECT_MAP_CONTAINERS = /* @__PURE__ */ new Set(["packages", "apps", "skills"]);
+function shallowDirents(dir) {
+  return readdirSync28(dir, { withFileTypes: true });
+}
+function shallowList(dir, limit) {
+  try {
+    const out3 = [];
+    for (const ent of shallowDirents(dir)) {
+      if (PROJECT_MAP_SKIP.has(ent.name))
+        continue;
+      out3.push(ent.isDirectory() ? `${ent.name}/` : ent.name);
+    }
+    out3.sort((a, b) => a.localeCompare(b));
+    return out3.slice(0, limit);
+  } catch {
+    return [];
+  }
+}
+function findRelevantFiles(root, token, limit) {
+  const needle = token.toLowerCase();
+  const hits = [];
+  let scanned = 0;
+  const maxScan = 4e3;
+  const walk2 = (dir, rel) => {
+    if (hits.length >= limit || scanned >= maxScan)
+      return;
+    let ents;
+    try {
+      ents = shallowDirents(dir);
+    } catch {
+      return;
+    }
+    for (const ent of ents) {
+      if (hits.length >= limit || scanned >= maxScan)
+        return;
+      if (PROJECT_MAP_SKIP.has(ent.name))
+        continue;
+      scanned += 1;
+      const childRel = rel === "" ? ent.name : `${rel}/${ent.name}`;
+      if (ent.isDirectory()) {
+        walk2(join66(dir, ent.name), childRel);
+      } else if (childRel.toLowerCase().includes(needle)) {
+        hits.push(childRel);
+      }
+    }
+  };
+  walk2(root, "");
+  hits.sort((a, b) => a.localeCompare(b));
+  return hits.slice(0, limit);
+}
+function buildProjectMap(worktreePath, storyId) {
+  const top = shallowList(worktreePath, PROJECT_MAP_MAX_TOPLEVEL);
+  if (top.length === 0)
+    return "";
+  const lines2 = ["[\u9879\u76EE\u5730\u56FE / project map]", "\u7ED3\u6784 / structure:"];
+  for (const name of top) {
+    lines2.push(`  ${name}`);
+    const bare = name.replace(/\/$/, "");
+    if (name.endsWith("/") && PROJECT_MAP_CONTAINERS.has(bare)) {
+      for (const child of shallowList(join66(worktreePath, bare), PROJECT_MAP_MAX_TOPLEVEL)) {
+        lines2.push(`    ${child}`);
+      }
+    }
+  }
+  const token = (storyId ?? "").trim();
+  if (token.length >= 3) {
+    const relevant = findRelevantFiles(worktreePath, token, PROJECT_MAP_MAX_RELEVANT);
+    if (relevant.length > 0) {
+      lines2.push(`\u672C\u5361\u76F8\u5173\u6587\u4EF6 / files matching ${token}:`);
+      for (const f of relevant)
+        lines2.push(`  ${f}`);
+    }
+  }
+  let map = lines2.join("\n");
+  if (map.length > PROJECT_MAP_MAX_CHARS) {
+    map = `${map.slice(0, PROJECT_MAP_MAX_CHARS - 3)}...`;
+  }
+  return map;
+}
+function maybeInjectProjectMap(skillBody, worktreePath, enabled, storyId) {
+  if (!enabled)
+    return skillBody;
+  const map = buildProjectMap(worktreePath, storyId);
+  if (map === "")
+    return skillBody;
+  return `${map}
+
+${skillBody}`;
+}
 function skillsEntryCount(worktreePath) {
   const dir = join66(worktreePath, "skills");
   if (!existsSync66(dir))
@@ -34219,7 +34620,13 @@ function readField(path, re) {
   }
   return void 0;
 }
+var RUN_ONCE_USAGE = "Usage: roll loop run-once [--dry-run]\n  Run ONE loop cycle now: pick a Todo card, build it through TCR, run the\n  gates (attest + peer), and publish a PR. Exits when the cycle terminates.\n  --dry-run   Print the command plan only \u2014 no git / gh / agent side effects.\n\u7ACB\u5373\u8DD1\u4E00\u4E2A loop \u5468\u671F:\u9009\u4E00\u5F20 Todo \u5361,\u7ECF TCR \u5EFA\u9020,\u8FC7\u95F8(\u9A8C\u6536+\u540C\u884C\u8BC4\u5BA1),\u53D1 PR\u3002\n  --dry-run   \u53EA\u6253\u5370\u547D\u4EE4\u8BA1\u5212\u2014\u2014\u4E0D\u52A8 git / gh / agent\u3002";
 async function loopRunOnceCommand(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    process.stdout.write(`${RUN_ONCE_USAGE}
+`);
+    return 0;
+  }
   const dryRun = args.includes("--dry-run");
   const id = await projectIdentity();
   const cycleId = makeCycleId();
@@ -34339,6 +34746,12 @@ loop run-once: \u627E\u4E0D\u5230 roll-loop SKILL.md \u2014 \u62D2\u7EDD\u76F2\u
   if (result.terminal === "published") {
     process.stdout.write("loop run-once: delivery published \u2014 PR open, merge pending (PR loop merges; backfill credits on merge evidence)\nloop run-once: \u4EA4\u4ED8\u5DF2\u53D1\u5E03\u2014\u2014PR \u5DF2\u5F00,\u7B49\u5F85\u5408\u5E76(PR loop \u8D1F\u8D23\u5408\u5E76;\u5408\u5E76\u8BC1\u636E\u843D\u5730\u540E\u7531\u56DE\u586B\u8BB0\u8D26)\n");
   }
+  if (result.terminal === "local") {
+    const storyId = (result.state?.ctx?.storyId ?? "").trim();
+    announceReport(id.path, id.slug, storyId);
+    resetConsecutiveFails(id.path);
+    process.stdout.write("loop run-once: gates passed but publish did not complete \u2014 work committed locally on the branch, not published (unpublished, not a failure)\nloop run-once: \u95F8\u5DF2\u901A\u8FC7\u4F46\u672A\u5B8C\u6210\u53D1\u5E03\u2014\u2014\u5DE5\u4F5C\u5DF2\u5728\u5206\u652F\u4E0A\u672C\u5730\u63D0\u4EA4,\u5C1A\u672A\u53D1\u5E03(\u672A\u53D1\u5E03,\u975E\u5931\u8D25)\n");
+  }
   const isFail = result.terminal === "failed" || result.terminal === "blocked";
   if (isFail) {
     if (await isOffline()) {

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@seanyao/roll",
-  "version": "3.617.1",
+  "version": "3.617.2",
   "description": "Roll — Roll out features with AI agents",
   "packageManager": "pnpm@11.1.3",
   "scripts": {
     "test": "bash scripts/test-ts.sh",
+    "lint:story-ids": "node scripts/lint-story-ids.mjs",
     "test:e2e": "pnpm -r build && pnpm --filter @roll/cli exec vitest run test/critical-flows.e2e.test.ts",
     "test:cov": "pnpm -r exec vitest run --coverage.enabled --coverage.provider=v8 --coverage.include='src/**' --coverage.reporter=text-summary --coverage.reporter=text",
     "bundle": "node scripts/bundle.mjs",