@seanyao/roll 4.702.2 → 4.702.4

package/dist/roll.mjs

@@ -2240,8 +2240,8 @@ var init_catalog_v3 = __esm({
       // `design.*` — explicit `roll design` entry point (US-ONBOARD-NUDGE-004 / FIX-1055).
       // Thin wrapper that launches the existing $roll-design skill interactively.
       "design.usage": {
-        en: 'Usage: roll design [--from-file <path> | "<requirement>"] [--agent <name>] [--verbose|--raw]\n  Launch the $roll-design skill in an interactive agent conversation.\n  `--from-file` binds a PRD/brief file as the design input.\n  `"<requirement>"` binds a free-text design target; it cannot be combined with `--from-file`.\n  `--agent` and `ROLL_DESIGN_AGENT` override only this design session; scoped roles live in ~/.roll/agents.yaml and .roll/agents.yaml.\n  `--verbose` shows tier-C assistant text; `--raw` dumps the full transcript.\n  Unlike `roll init`, this command runs an LLM \u2014 run it only when you want to design.',
-        zh: '\u7528\u6CD5\uFF1Aroll design [--from-file <path> | "<requirement>"] [--agent <name>] [--verbose|--raw]\n  \u5728\u4EA4\u4E92\u5F0F agent \u5BF9\u8BDD\u4E2D\u542F\u52A8 $roll-design skill\u3002\n  `--from-file` \u4F1A\u628A PRD/brief \u6587\u4EF6\u7ED1\u5B9A\u4E3A\u8BBE\u8BA1\u8F93\u5165\u3002\n  `"<requirement>"` \u4F1A\u7ED1\u5B9A\u81EA\u7531\u6587\u672C\u8BBE\u8BA1\u76EE\u6807\uFF1B\u4E0D\u80FD\u4E0E `--from-file` \u6DF7\u7528\u3002\n  `--agent` \u4E0E `ROLL_DESIGN_AGENT` \u53EA\u8986\u76D6\u672C\u6B21 design session\uFF1Bscoped roles \u4F4D\u4E8E ~/.roll/agents.yaml \u548C .roll/agents.yaml\u3002\n  `--verbose` \u663E\u793A tier-C assistant \u6587\u672C\uFF1B`--raw` \u8F93\u51FA\u5B8C\u6574\u539F\u59CB\u8BB0\u5F55\u3002\n  \u4E0E `roll init` \u4E0D\u540C\uFF0C\u672C\u547D\u4EE4\u4F1A\u8FD0\u884C LLM\u2014\u2014\u53EA\u5728\u9700\u8981\u8BBE\u8BA1\u65F6\u6267\u884C\u3002'
+        en: 'Usage: roll design [--from-file <path> | "<requirement>"] [--agent <name>] [--verbose|--raw]\n  Launch the $roll-design skill in an interactive agent conversation.\n  Default output streams bounded live progress, card-created events, quiet heartbeats, and the final handoff while preserving the raw transcript.\n  `--from-file` binds a PRD/brief file as the design input.\n  `"<requirement>"` binds a free-text design target; it cannot be combined with `--from-file`.\n  `--agent` and `ROLL_DESIGN_AGENT` override only this design session; scoped roles live in ~/.roll/agents.yaml and .roll/agents.yaml.\n  `--verbose` streams lower-priority normalized activity; `--raw` streams the raw child output live.\n  Unlike `roll init`, this command runs an LLM \u2014 run it only when you want to design.',
+        zh: '\u7528\u6CD5\uFF1Aroll design [--from-file <path> | "<requirement>"] [--agent <name>] [--verbose|--raw]\n  \u5728\u4EA4\u4E92\u5F0F agent \u5BF9\u8BDD\u4E2D\u542F\u52A8 $roll-design skill\u3002\n  \u9ED8\u8BA4\u8F93\u51FA\u4F1A\u5B9E\u65F6\u663E\u793A\u6709\u754C\u8FDB\u5C55\u3001\u5EFA\u5361\u4E8B\u4EF6\u3001\u9759\u9ED8\u5FC3\u8DF3\u548C\u6700\u7EC8\u4EA4\u4ED8\uFF0C\u540C\u65F6\u4FDD\u7559\u5B8C\u6574\u539F\u59CB\u8BB0\u5F55\u3002\n  `--from-file` \u4F1A\u628A PRD/brief \u6587\u4EF6\u7ED1\u5B9A\u4E3A\u8BBE\u8BA1\u8F93\u5165\u3002\n  `"<requirement>"` \u4F1A\u7ED1\u5B9A\u81EA\u7531\u6587\u672C\u8BBE\u8BA1\u76EE\u6807\uFF1B\u4E0D\u80FD\u4E0E `--from-file` \u6DF7\u7528\u3002\n  `--agent` \u4E0E `ROLL_DESIGN_AGENT` \u53EA\u8986\u76D6\u672C\u6B21 design session\uFF1Bscoped roles \u4F4D\u4E8E ~/.roll/agents.yaml \u548C .roll/agents.yaml\u3002\n  `--verbose` \u5B9E\u65F6\u663E\u793A\u8F83\u4F4E\u4F18\u5148\u7EA7\u7684\u89C4\u8303\u5316\u6D3B\u52A8\uFF1B`--raw` \u5B9E\u65F6\u8F93\u51FA\u5B50\u8FDB\u7A0B\u539F\u59CB\u6D41\u3002\n  \u4E0E `roll init` \u4E0D\u540C\uFF0C\u672C\u547D\u4EE4\u4F1A\u8FD0\u884C LLM\u2014\u2014\u53EA\u5728\u9700\u8981\u8BBE\u8BA1\u65F6\u6267\u884C\u3002'
       },
       "design.not_roll_project": {
         en: "This directory is not a Roll project (no .roll/). Run `roll init` first.",
@@ -12475,6 +12475,12 @@ function signalLabel(ev) {
       return `pair ${clean2(ev.peer)} ${ev.cause}`;
     case "pair:excluded":
       return `pair ${clean2(ev.agent)} excluded ${ev.cause} (${ev.failures})`;
+    case "agent:retry":
+      return `retry ${clean2(ev.fromAgent)} \u2192 ${clean2(ev.toAgent)} (${clean2(ev.reason)})`;
+    case "goal:gate_tripped":
+      return `paused ${clean2(ev.reason)} (${ev.gate})`;
+    case "goal:state":
+      return `goal ${clean2(ev.to)} ${clean2(ev.reason)}`;
     default:
       return void 0;
   }
@@ -12486,6 +12492,20 @@ function summarizeWatchEvents(lines3, durableLookup, nowMs) {
   const summary = { tcrCount: 0, hasEnd: false };
   const events = [];
   let seen = false;
+  const resetCycleScope = (cycleId) => {
+    if (summary.cycleId === cycleId)
+      return;
+    summary.cycleId = cycleId;
+    summary.storyId = void 0;
+    summary.agent = void 0;
+    summary.phase = void 0;
+    summary.tcrCount = 0;
+    summary.outcome = void 0;
+    summary.hasEnd = false;
+    summary.acceptedScore = void 0;
+    summary.attest = void 0;
+    summary.lastPr = void 0;
+  };
   for (const line of lines3) {
     const ev = parseEventLine(line);
     if (ev === null)
@@ -12493,26 +12513,26 @@ function summarizeWatchEvents(lines3, durableLookup, nowMs) {
     events.push(ev);
     seen = true;
     if (ev.type === "cycle:start") {
-      summary.cycleId = ev.cycleId;
+      resetCycleScope(ev.cycleId);
       summary.storyId = ev.storyId;
       summary.agent = ev.agent;
-      summary.phase = void 0;
-      summary.tcrCount = 0;
-      summary.outcome = void 0;
-      summary.hasEnd = false;
-      summary.acceptedScore = void 0;
-      summary.attest = void 0;
-      summary.lastPr = void 0;
     } else if (ev.type === "cycle:phase") {
-      summary.cycleId = ev.cycleId;
+      resetCycleScope(ev.cycleId);
       summary.phase = ev.phase;
     } else if (ev.type === "cycle:tcr") {
-      summary.cycleId = ev.cycleId;
+      resetCycleScope(ev.cycleId);
       summary.tcrCount += 1;
-    } else if (ev.type === "cycle:end" || ev.type === "cycle:terminal") {
-      summary.cycleId = ev.cycleId;
+    } else if (ev.type === "cycle:end") {
+      resetCycleScope(ev.cycleId);
+      summary.outcome = ev.outcome;
+      summary.hasEnd = true;
+    } else if (ev.type === "cycle:terminal") {
+      resetCycleScope(ev.cycleId);
+      summary.storyId = ev.storyId;
+      summary.agent = ev.agent;
       summary.outcome = ev.outcome;
       summary.hasEnd = true;
+      summary.tcrCount = ev.tcr.present ? ev.tcr.value : 0;
     }
     if (ev.type === "pair:score") {
       summary.acceptedScore = { peer: ev.peer, score: ev.score, verdict: ev.verdict };
@@ -12584,7 +12604,7 @@ function renderWatchStatusSummary(summary, nowMs) {
   const story = summary.storyId !== void 0 && summary.storyId !== "" ? summary.storyId : "story unknown";
   const agent = summary.agent !== void 0 && summary.agent !== "" ? summary.agent : "agent unknown";
   const phase = summary.phase !== void 0 ? `phase ${summary.phase}` : "phase unknown";
-  const classification = summary.classification !== void 0 ? summary.classification : "active";
+  const classification = summary.classification !== void 0 ? summary.classification : summary.hasEnd ? "ended" : "active";
   const tcr = `${summary.tcrCount} TCR`;
   const parts = [`status  ${phase}`, classification, quietText(summary, nowMs), story, agent, cycle];
   if (summary.microStep !== void 0) {
@@ -12656,11 +12676,18 @@ function previousTransitionLine(previous) {
   return `  previous: ${parts.join(" \xB7 ")}`;
 }
 function nextTransitionLine(current, ctx) {
+  if (current.storyId === void 0 || current.storyId === "") {
+    const outcome = current.hasEnd ? current.outcome ?? "unknown" : "no active story";
+    return `  next:     no runnable work \xB7 ${outcome}`;
+  }
   const story = current.storyId !== void 0 && current.storyId !== "" ? current.storyId : "story unknown";
   const brief = current.storyId !== void 0 && current.storyId !== "" ? ctx?.storyBrief?.(current.storyId) ?? "brief unavailable" : "brief unavailable";
   return `  next:     ${story} \xB7 ${brief}`;
 }
 function builderTransitionLine(current, ctx) {
+  if (current.storyId === void 0 || current.storyId === "") {
+    return "  builder:  none \xB7 no story/agent selected";
+  }
   const route = current.storyId !== void 0 && current.storyId !== "" ? ctx?.routeReason?.(current.storyId) : void 0;
   if (route !== void 0) {
     return `  builder:  ${route.agent} \xB7 selected by ${route.reason}`;
@@ -18793,16 +18820,16 @@ async function crontabRead() {
   }
 }
 async function crontabWrite(text2) {
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     const child = execFile4("crontab", ["-"], (err16) => {
       if (err16 === null) {
-        resolve11(0);
+        resolve12(0);
       } else if (typeof err16.code === "number") {
-        resolve11(err16.code);
+        resolve12(err16.code);
       } else if (err16.code === "ENOENT") {
         reject(err16);
       } else {
-        resolve11(1);
+        resolve12(1);
       }
     });
     child.stdin?.end(text2);
@@ -20846,14 +20873,14 @@ var init_mcp = __esm({
         child.on("exit", () => this.rejectAll(new Error("MCP server exited")));
       }
       static async open(child) {
-        await new Promise((resolve11, reject) => {
+        await new Promise((resolve12, reject) => {
           const onError = (cause) => {
             child.off("spawn", onSpawn);
             reject(cause);
           };
           const onSpawn = () => {
             child.off("error", onError);
-            resolve11();
+            resolve12();
           };
           child.once("error", onError);
           child.once("spawn", onSpawn);
@@ -20882,8 +20909,8 @@ var init_mcp = __esm({
         const id = this.nextId;
         this.nextId += 1;
         const message = { jsonrpc: "2.0", id, method, params };
-        return new Promise((resolve11, reject) => {
-          this.pending.set(id, { resolve: resolve11, reject });
+        return new Promise((resolve12, reject) => {
+          this.pending.set(id, { resolve: resolve12, reject });
           this.write(message);
         });
       }
@@ -20978,7 +21005,7 @@ async function requestWithRedirects(url, input, deps, timeoutMs, redirects, star
   return response;
 }
 function requestOnce(url, input, deps, timeoutMs, startedAt) {
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     const proxy = proxyFor(url);
     const viaProxy = proxy !== void 0;
     const requestUrl = viaProxy ? proxy : url;
@@ -21000,7 +21027,7 @@ function requestOnce(url, input, deps, timeoutMs, startedAt) {
       });
       res.on("end", () => {
         clearTimeout(timer);
-        resolve11({
+        resolve12({
           statusCode: res.statusCode ?? 0,
           headers: normalizeHeaders(res.headers),
           body: deps.redact(Buffer.concat(chunks).toString("utf8")),
@@ -21054,7 +21081,7 @@ function isTimeout(cause) {
 function delay(ms) {
   if (ms <= 0)
     return Promise.resolve();
-  return new Promise((resolve11) => setTimeout(resolve11, ms));
+  return new Promise((resolve12) => setTimeout(resolve12, ms));
 }
 function failure5(invocation, startedAt, endedAt, code, message, retryable, detail, attempt) {
   return {
@@ -145685,7 +145712,7 @@ ${lanes.join("\n")}
           }
         }
         function createImportCallExpressionAMD(arg, containsLexicalThis) {
-          const resolve11 = factory2.createUniqueName("resolve");
+          const resolve12 = factory2.createUniqueName("resolve");
           const reject = factory2.createUniqueName("reject");
           const parameters = [
             factory2.createParameterDeclaration(
@@ -145694,7 +145721,7 @@ ${lanes.join("\n")}
               /*dotDotDotToken*/
               void 0,
               /*name*/
-              resolve11
+              resolve12
             ),
             factory2.createParameterDeclaration(
               /*modifiers*/
@@ -145711,7 +145738,7 @@ ${lanes.join("\n")}
                 factory2.createIdentifier("require"),
                 /*typeArguments*/
                 void 0,
-                [factory2.createArrayLiteralExpression([arg || factory2.createOmittedExpression()]), resolve11, reject]
+                [factory2.createArrayLiteralExpression([arg || factory2.createOmittedExpression()]), resolve12, reject]
               )
             )
           ]);
@@ -232642,8 +232669,8 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
         installPackage(options) {
           this.packageInstallId++;
           const request = { kind: "installPackage", ...options, id: this.packageInstallId };
-          const promise = new Promise((resolve11, reject) => {
-            (this.packageInstalledPromise ?? (this.packageInstalledPromise = /* @__PURE__ */ new Map())).set(this.packageInstallId, { resolve: resolve11, reject });
+          const promise = new Promise((resolve12, reject) => {
+            (this.packageInstalledPromise ?? (this.packageInstalledPromise = /* @__PURE__ */ new Map())).set(this.packageInstallId, { resolve: resolve12, reject });
           });
           this.installer.send(request);
           return promise;
@@ -232936,10 +232963,10 @@ __export(structure_scan_exports, {
 });
 import { createHash as createHash5 } from "node:crypto";
 import { existsSync as existsSync63, readFileSync as readFileSync59 } from "node:fs";
-import { basename as basename13, dirname as dirname32, extname, join as join65, relative as relative5, resolve as resolve6, sep as sep4 } from "node:path";
+import { basename as basename13, dirname as dirname32, extname, join as join65, relative as relative5, resolve as resolve7, sep as sep4 } from "node:path";
 function buildStaticProjectGraph(input) {
-  const root = resolve6(input.root);
-  const tsconfigPaths = input.tsconfigPath ? [resolve6(root, input.tsconfigPath)] : findTsconfigs(root);
+  const root = resolve7(input.root);
+  const tsconfigPaths = input.tsconfigPath ? [resolve7(root, input.tsconfigPath)] : findTsconfigs(root);
   if (tsconfigPaths.length === 0) {
     return emptyGraph(root, "No tsconfig.json found for Dream structure scan");
   }
@@ -233086,7 +233113,7 @@ function createLanguageServiceHost(fileNames, options) {
   };
 }
 function normalizePath(root, path) {
-  return relative5(root, resolve6(path)).split(sep4).join("/");
+  return relative5(root, resolve7(path)).split(sep4).join("/");
 }
 function isExcluded(root, path) {
   const rel = normalizePath(root, path);
@@ -233200,7 +233227,7 @@ function importEdges(root, sourceFile) {
 function resolveModulePath(root, containingFile, specifier) {
   if (!specifier.startsWith("."))
     return void 0;
-  const base = resolve6(dirname32(containingFile), specifier);
+  const base = resolve7(dirname32(containingFile), specifier);
   for (const suffix of [".ts", ".tsx", ".mts", ".cts", "/index.ts"]) {
     const candidate = `${base}${suffix}`;
     if (existsSync63(candidate))
@@ -233623,7 +233650,7 @@ __export(showcase_exports, {
   resetSandbox: () => resetSandbox,
   showcaseCommand: () => showcaseCommand
 });
-import { spawnSync as spawnSync16 } from "node:child_process";
+import { spawnSync as spawnSync15 } from "node:child_process";
 import { cpSync as cpSync2, existsSync as existsSync105, mkdirSync as mkdirSync51, mkdtempSync as mkdtempSync8, readdirSync as readdirSync41, readFileSync as readFileSync99, rmSync as rmSync18, statSync as statSync35, writeFileSync as writeFileSync54 } from "node:fs";
 import { tmpdir as tmpdir10 } from "node:os";
 import { dirname as dirname49, join as join109 } from "node:path";
@@ -233695,7 +233722,7 @@ function runRoll(sandbox, rollHome4, args, opts = {}) {
   }
   const bin = rollBin3();
   const [cmd, cmdArgs] = bin === "roll" ? [bin, args] : [process.execPath, [bin, ...args]];
-  const r = spawnSync16(cmd, cmdArgs, {
+  const r = spawnSync15(cmd, cmdArgs, {
     cwd: sandbox,
     env,
     encoding: "utf8",
@@ -234138,7 +234165,7 @@ function networkNeeds(command, args) {
   }
 }
 function tcpConnect(host, port, timeoutMs) {
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     const socket = createConnection({ host, port });
     let settled = false;
     const done = (err16) => {
@@ -234150,7 +234177,7 @@ function tcpConnect(host, port, timeoutMs) {
       if (err16)
         reject(err16);
       else
-        resolve11();
+        resolve12();
     };
     socket.setTimeout(timeoutMs, () => done(new Error("tcp timeout")));
     socket.once("connect", () => done());
@@ -234162,11 +234189,11 @@ async function networkReachable(probes = {}) {
     host: PROBE_HOST,
     port: PROBE_PORT
   };
-  const resolve11 = probes.resolve ?? ((h) => lookup(h));
+  const resolve12 = probes.resolve ?? ((h) => lookup(h));
   const tcpProbe2 = probes.tcpProbe ?? (() => tcpConnect(target.host, target.port, TCP_TIMEOUT_MS));
   try {
     await Promise.race([
-      resolve11(target.host),
+      resolve12(target.host),
       new Promise((_, rej) => {
         const timer = setTimeout(() => rej(new Error("dns timeout")), DNS_TIMEOUT_MS);
         if (typeof timer === "object")
@@ -234473,7 +234500,7 @@ init_dist2();
 import { spawn as spawn2 } from "node:child_process";
 import { existsSync as existsSync15, readFileSync as readFileSync12, realpathSync as realpathSync2, unlinkSync, writeFileSync as writeFileSync6 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { join as join18 } from "node:path";
+import { join as join18, resolve as resolve5 } from "node:path";
 var liveAgents = /* @__PURE__ */ new Set();
 function killLiveAgents(signal = "SIGKILL") {
   let n = 0;
@@ -234799,12 +234826,28 @@ function evidenceFrameEnv(runDir) {
   };
 }
 var INHERITED_GIT_ENV_KEYS = ["GIT_DIR", "GIT_WORK_TREE", "GIT_COMMON_DIR", "GIT_INDEX_FILE"];
+function worktreeGitEnv(cwd) {
+  const gitPath = join18(cwd, ".git");
+  if (!existsSync15(gitPath))
+    return {};
+  try {
+    const text2 = readFileSync12(gitPath, "utf8");
+    const match = /^gitdir:\s*(.+)\s*$/m.exec(text2);
+    if (match?.[1] !== void 0 && match[1].trim() !== "") {
+      return { GIT_DIR: resolve5(cwd, match[1].trim()), GIT_WORK_TREE: cwd };
+    }
+  } catch {
+    return { GIT_DIR: gitPath, GIT_WORK_TREE: cwd };
+  }
+  return {};
+}
 function childEnv(opts) {
   const env = { ...opts.env ?? process.env };
   for (const key of INHERITED_GIT_ENV_KEYS)
     delete env[key];
   env.PWD = opts.cwd;
   delete env.OLDPWD;
+  Object.assign(env, worktreeGitEnv(opts.cwd));
   return opts.runDir !== void 0 && opts.runDir !== "" ? { ...env, ...evidenceFrameEnv(opts.runDir) } : env;
 }
 function withAgentProfileEnv(agent, opts) {
@@ -234820,7 +234863,7 @@ function withAgentProfileEnv(agent, opts) {
 function spawnAndWait(bin, args, opts, pty = false) {
   process.stderr.write(`[runner] spawn ${bin} argv=${JSON.stringify(args.map((a) => a.length > 80 ? `${a.slice(0, 77)}...` : a))}
 `);
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     const child = spawn2(bin, args, {
       cwd: opts.cwd,
       env: childEnv(opts),
@@ -234863,7 +234906,7 @@ function spawnAndWait(bin, args, opts, pty = false) {
         opts.cleanup?.();
       } catch {
       }
-      resolve11(result);
+      resolve12(result);
     };
     child.on("error", (e) => {
       settle({ stdout, stderr: `${stderr}${String(e)}
@@ -234890,13 +234933,13 @@ function realDeps() {
     sharedRoot: () => process.env["ROLL_SHARED_ROOT"] || join19(homedir5(), ".shared", "roll"),
     launchdDir: () => join19(homedir5(), "Library", "LaunchAgents"),
     scheduler: createScheduler(process.platform, { uid: process.getuid?.() ?? 501 }),
-    execRunner: (runner) => new Promise((resolve11) => {
+    execRunner: (runner) => new Promise((resolve12) => {
       const child = spawn3("bash", [runner], {
         stdio: "inherit",
         env: { ...process.env, ROLL_LOOP_FORCE: "1" }
       });
-      child.on("exit", (code) => resolve11(code ?? 1));
-      child.on("error", () => resolve11(1));
+      child.on("exit", (code) => resolve12(code ?? 1));
+      child.on("error", () => resolve12(1));
     }),
     hasTmux: () => {
       try {
@@ -234907,7 +234950,7 @@ function realDeps() {
     },
     // The `loop now` inline observation: tail live.log while the cycle holds
     // the inner lock; Ctrl-C stops the TAIL only (the cycle lives in tmux).
-    observe: (rt) => new Promise((resolve11) => {
+    observe: (rt) => new Promise((resolve12) => {
       const lock = join19(rt, "inner.lock");
       const tail3 = spawn3("tail", ["-n", "+1", "-F", join19(rt, "live.log")], { stdio: "inherit" });
       let sawLock = false;
@@ -234918,7 +234961,7 @@ function realDeps() {
         } catch {
         }
         process.removeListener("SIGINT", finish);
-        resolve11();
+        resolve12();
       };
       const timer = setInterval(() => {
         if (existsSync16(lock))
@@ -249779,13 +249822,13 @@ function followSupervisorCollabStream(projectPath3, noColor2) {
   const tickLimit = envOptionalPositiveInt("ROLL_SUPERVISOR_COLLAB_WATCH_TICKS");
   let renderedCycles = 0;
   let ticks = 0;
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     let timer;
     const stop = (code) => {
       if (timer !== void 0)
         clearInterval(timer);
       process.removeListener("SIGINT", onSigint);
-      resolve11(code);
+      resolve12(code);
     };
     const onSigint = () => stop(130);
     const tick = () => {
@@ -249876,7 +249919,7 @@ function unknownSupervisorLiveFlag(args) {
 function followSupervisorLiveBoard(projectPath3, intervalMs) {
   const tickLimit = envOptionalPositiveInt("ROLL_SUPERVISOR_LIVE_WATCH_TICKS");
   let ticks = 0;
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     let timer;
     let stopped = false;
     const stop = (code) => {
@@ -249887,7 +249930,7 @@ function followSupervisorLiveBoard(projectPath3, intervalMs) {
         clearInterval(timer);
       process.removeListener("SIGINT", onSigint);
       process.stdout.write("\x1B[?25h");
-      resolve11(code);
+      resolve12(code);
     };
     const onSigint = () => stop(130);
     const tick = () => {
@@ -251053,7 +251096,7 @@ function spawnPeerReviewAgent(input) {
   const cmd = textAgentArgv(input.agent, input.prompt);
   if (cmd === null)
     return Promise.resolve({ status: "error", reason: "unsupported_reviewer", stdout: "" });
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     let stdout = "";
     let stderr = "";
     let timedOut = false;
@@ -251071,7 +251114,7 @@ function spawnPeerReviewAgent(input) {
       settled = true;
       if (timer !== void 0)
         clearTimeout(timer);
-      resolve11(result);
+      resolve12(result);
     };
     timer = setTimeout(() => {
       timedOut = true;
@@ -251681,7 +251724,7 @@ function realDeps5() {
     startTmux: startGoTmux,
     followFeed: followGoLiveFeed,
     runOnce: realRunOnce,
-    sleep: (ms) => new Promise((resolve11) => setTimeout(resolve11, ms)),
+    sleep: (ms) => new Promise((resolve12) => setTimeout(resolve12, ms)),
     externalTools: guideExternalToolSetup,
     preinstallChromium: () => {
       silentPreinstallChromium();
@@ -251726,6 +251769,59 @@ function eventsPath(projectPath3) {
 function runsPath2(projectPath3) {
   return join55(runtimeDir5(projectPath3), "runs.jsonl");
 }
+function parsePorcelainPath(line) {
+  const raw = line.length > 3 ? line.slice(3).trim() : line.trim();
+  const target = raw.includes(" -> ") ? raw.split(" -> ").at(-1) ?? raw : raw;
+  return target.replace(/^"|"$/g, "").replace(/\/$/, "");
+}
+function gitDirtyPaths(projectPath3) {
+  const result = spawnSync8("git", ["status", "--porcelain", "--untracked-files=all"], {
+    cwd: projectPath3,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+  if (result.status !== 0)
+    return [];
+  return String(result.stdout ?? "").split("\n").map((line) => line.trimEnd()).filter((line) => line.trim() !== "").map(parsePorcelainPath).filter((path) => path !== ".roll/loop" && !path.startsWith(".roll/loop/")).slice(0, 50);
+}
+function isBootstrapArtifactPath(path) {
+  if (path === "AGENTS.md" || path === "CLAUDE.md" || path === ".cursor-rules" || path === "project_rules.md")
+    return true;
+  if (path === ".roll" || path.startsWith(".roll/"))
+    return true;
+  if (path === ".claude" || path.startsWith(".claude/"))
+    return true;
+  return false;
+}
+function classifyBootstrapArtifacts(paths) {
+  const files = paths.filter((path) => path.trim() !== "");
+  if (files.length === 0)
+    return { kind: "none", files: [] };
+  return files.every(isBootstrapArtifactPath) ? { kind: "bootstrap_only", files } : { kind: "mixed", files };
+}
+function bootstrapArtifactsMessage(files) {
+  const shown = files.slice(0, 12).join(", ");
+  const more = files.length > 12 ? `, ... +${files.length - 12} more` : "";
+  return [
+    "roll loop go: bootstrap_artifacts_unconfirmed",
+    `  files: ${shown}${more}`,
+    "  These files define project conventions/backlog metadata. Confirm their ownership before running builders:",
+    "  - commit them to the product repo if they are product truth",
+    "  - commit private Roll metadata inside .roll/roll-meta when applicable",
+    "  - ignore/externalize them by project policy",
+    "  - or clean them up and re-run init/design",
+    "  Then rerun: roll loop go",
+    "",
+    "roll loop go: bootstrap_artifacts_unconfirmed",
+    "  \u8FD9\u4E9B\u6587\u4EF6\u5B9A\u4E49\u9879\u76EE\u7EA6\u5B9A/backlog \u5143\u6570\u636E\u3002\u5148\u786E\u8BA4\u5F52\u5C5E\uFF0C\u518D\u542F\u52A8 builder\uFF1A",
+    "  - \u5C5E\u4E8E\u4EA7\u54C1\u4E8B\u5B9E\u5C31\u63D0\u4EA4\u5230\u4EA7\u54C1\u4ED3",
+    "  - \u5C5E\u4E8E\u79C1\u6709 Roll \u5143\u6570\u636E\u5C31\u63D0\u4EA4\u5230 .roll/roll-meta",
+    "  - \u6309\u9879\u76EE\u7EA6\u5B9A ignore/\u5916\u7F6E",
+    "  - \u6216\u6E05\u7406\u540E\u91CD\u8DD1 init/design",
+    "  \u7136\u540E\u518D\u8FD0\u884C\uFF1Aroll loop go",
+    ""
+  ].join("\n");
+}
 function parseOptions(args) {
   let scope = { kind: "all" };
   let maxCycles;
@@ -251958,7 +252054,7 @@ function startGoTmux(input) {
   }
 }
 function followGoLiveFeed(projectPath3, rollBin4) {
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     const cmd = rollBin4.endsWith(".js") || rollBin4.endsWith(".mjs") ? process.execPath : rollBin4;
     const args = rollBin4.endsWith(".js") || rollBin4.endsWith(".mjs") ? [rollBin4, "loop", "watch", "--since", "all"] : ["loop", "watch", "--since", "all"];
     const watch = spawn7(cmd, args, { cwd: projectPath3, stdio: ["ignore", "inherit", "inherit"] });
@@ -251968,7 +252064,7 @@ function followGoLiveFeed(projectPath3, rollBin4) {
       } catch {
       }
       process.removeListener("SIGINT", finish);
-      resolve11();
+      resolve12();
     };
     process.on("SIGINT", finish);
     watch.on("exit", finish);
@@ -251979,7 +252075,7 @@ function realRunOnce(input) {
   const bin = rollBin();
   const cmd = bin.endsWith(".js") || bin.endsWith(".mjs") ? process.execPath : bin;
   const args = cmd === process.execPath ? [bin, "loop", "run-once"] : ["loop", "run-once"];
-  return new Promise((resolve11) => {
+  return new Promise((resolve12) => {
     const child = spawn7(cmd, args, {
       cwd: input.projectPath,
       detached: true,
@@ -251993,8 +252089,8 @@ function realRunOnce(input) {
       },
       stdio: "inherit"
     });
-    child.on("exit", (code) => resolve11(code ?? 1));
-    child.on("error", () => resolve11(1));
+    child.on("exit", (code) => resolve12(code ?? 1));
+    child.on("error", () => resolve12(1));
   });
 }
 function writeGoal(path, goal) {
@@ -252822,6 +252918,14 @@ async function runGoWorker(id, opts, deps) {
         stopReason2 = preProgressGate.reason;
         break;
       }
+      const bootstrap = classifyBootstrapArtifacts(gitDirtyPaths(id.path));
+      if (bootstrap.kind === "bootstrap_only") {
+        stopReason2 = "bootstrap_artifacts_unconfirmed";
+        appendGoalGate(bus, evPath, sid, "progress", "paused", stopReason2, { files: bootstrap.files.join(", "), count: bootstrap.files.length }, deps.nowSec());
+        process.stdout.write(bootstrapArtifactsMessage(bootstrap.files));
+        goal = pauseGoal(id.path, bus, stopReason2, deps.nowIso(), deps.nowSec()) ?? goal;
+        break;
+      }
       const allowedCards = allowedCardsForScope(id.path, goal, progress);
       if (allScopeCardsSkipped(id.path, goal, progress)) {
         stopReason2 = "no_progress_on_all_cards";
@@ -253975,7 +254079,7 @@ function renderDesignNudge(lang10) {
 init_dist2();
 init_dist();
 import { existsSync as existsSync59, readdirSync as readdirSync24, readFileSync as readFileSync56, statSync as statSync22 } from "node:fs";
-import { relative as relative4, resolve as resolve5 } from "node:path";
+import { relative as relative4, resolve as resolve6 } from "node:path";
 var IGNORE_DIRS = /* @__PURE__ */ new Set([
   ".git",
   "node_modules",
@@ -253997,23 +254101,23 @@ function walkMarkdownFiles(dir, out3, includeGenerated) {
         continue;
       if (!includeGenerated && (entry.name === ".roll" || entry.name === "archive"))
         continue;
-      walkMarkdownFiles(resolve5(dir, entry.name), out3, includeGenerated);
+      walkMarkdownFiles(resolve6(dir, entry.name), out3, includeGenerated);
     } else if (entry.isFile() && isMarkdownFile(entry.name)) {
-      out3.push(resolve5(dir, entry.name));
+      out3.push(resolve6(dir, entry.name));
     }
   }
 }
 function defaultScanRoots(root, includeGenerated) {
   const roots = [];
   for (const rel of ["AGENTS.md", "roll.md", "conventions", "skills", "guide"]) {
-    const abs = resolve5(root, rel);
+    const abs = resolve6(root, rel);
     if (!existsSync59(abs))
       continue;
     roots.push(abs);
   }
   if (includeGenerated) {
     for (const rel of [".roll", "archive"]) {
-      const abs = resolve5(root, rel);
+      const abs = resolve6(root, rel);
       if (existsSync59(abs))
         roots.push(abs);
     }
@@ -256854,7 +256958,7 @@ function renderAiClients(out3, clients) {
     }
     out3.push("  " + pad(nameCol, 14) + pad(c("dim", cl.cfg_file), 14) + pad(syncCol, 14) + c("dim", String(cl.skills)));
     if (cl.sync === "out-of-sync" || cl.sync === "missing") {
-      out3.push("       " + c("dim", "fix: ") + c("blue", `roll setup -f ${cl.name}`));
+      out3.push("       " + c("dim", "fix: ") + c("blue", "roll setup -f"));
     }
   }
   out3.push("", hr(), "");
@@ -257180,7 +257284,7 @@ function collectAgentPanel(projectPath3, deps = defaultAgentPanelDeps()) {
       costUsd72h: Number(s.cost.toFixed(4)),
       files,
       syncStale: isInstalled && stale,
-      ...isInstalled && stale ? { setupCmd: `roll setup -f ${name}` } : {}
+      ...isInstalled && stale ? { setupCmd: "roll setup -f" } : {}
     });
   }
   rows.sort((a, b) => Number(b.installed) - Number(a.installed) || b.cycles72h - a.cycles72h || a.name.localeCompare(b.name));
@@ -258049,7 +258153,7 @@ function collectLoopHeartbeat(deps) {
 // packages/cli/dist/lib/git-hooks.js
 import { execFileSync as execFileSync20 } from "node:child_process";
 import { readdirSync as readdirSync29 } from "node:fs";
-import { isAbsolute, join as join77, resolve as resolve7 } from "node:path";
+import { isAbsolute, join as join77, resolve as resolve8 } from "node:path";
 var HOOK_DESCRIPTIONS = {
   "pre-commit": {
     en: "TCR proof gate before commit",
@@ -258111,11 +258215,11 @@ function resolveHooksPath(projectPath3) {
   if (configured !== "" && configured !== ".git/hooks") {
     return {
       displayPath: configured,
-      fsPath: isAbsolute(configured) ? configured : resolve7(projectPath3, configured)
+      fsPath: isAbsolute(configured) ? configured : resolve8(projectPath3, configured)
     };
   }
   const gitPath = gitOutput3(projectPath3, ["rev-parse", "--git-path", "hooks"]);
-  const fsPath = gitPath === "" ? join77(projectPath3, ".git", "hooks") : isAbsolute(gitPath) ? gitPath : resolve7(projectPath3, gitPath);
+  const fsPath = gitPath === "" ? join77(projectPath3, ".git", "hooks") : isAbsolute(gitPath) ? gitPath : resolve8(projectPath3, gitPath);
   return {
     displayPath: configured === "" ? ".git/hooks" : configured,
     fsPath
@@ -260053,6 +260157,91 @@ function registerProject(projectDir) {
   } catch {
   }
 }
+var ROLL_OWNED_GIT_PATHS = [
+  "AGENTS.md",
+  ".claude/CLAUDE.md",
+  ".roll/.version",
+  ".roll/agents.yaml",
+  ".roll/backlog.md",
+  ".roll/brief.md",
+  ".roll/briefs",
+  ".roll/domain",
+  ".roll/domain/context-map.md",
+  ".roll/features",
+  ".roll/features.md",
+  ".roll/init-diagnosis.yaml",
+  ".roll/onboard-changeset.yaml",
+  ".roll/onboard-plan.yaml",
+  ".roll/tech-analysis.md",
+  ".roll/test-assessment.md",
+  ".gitignore"
+];
+function runGit(projectDir, args) {
+  const result = spawnSync11("git", args, {
+    cwd: projectDir,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  return {
+    ok: result.status === 0,
+    stdout: String(result.stdout ?? ""),
+    stderr: String(result.stderr ?? "")
+  };
+}
+function existingRollOwnedPaths(projectDir) {
+  return ROLL_OWNED_GIT_PATHS.filter((rel) => existsSync83(join86(projectDir, rel.replace(/\/$/, ""))));
+}
+function printGitFinalizeManual(reason, command) {
+  warn4(`Roll meta git finalize needs manual follow-up: ${reason}`);
+  process.stderr.write(`  ${command}
+`);
+}
+function finalizeRollOwnedGit(projectDir) {
+  if (!runGit(projectDir, ["rev-parse", "--is-inside-work-tree"]).ok)
+    return;
+  const topLevel = runGit(projectDir, ["rev-parse", "--show-toplevel"]);
+  if (!topLevel.ok)
+    return;
+  if (realpathSync11(projectDir) !== realpathSync11(topLevel.stdout.trim()))
+    return;
+  const paths = existingRollOwnedPaths(projectDir);
+  if (paths.length === 0)
+    return;
+  if (!runGit(projectDir, ["diff", "--cached", "--quiet"]).ok) {
+    printGitFinalizeManual("existing staged changes; auto commit skipped", `git add -A -f -- ${paths.join(" ")} && git commit -m 'roll init: commit Roll-owned meta files'`);
+    return;
+  }
+  const add = runGit(projectDir, ["add", "-A", "-f", "--", ...paths]);
+  if (!add.ok) {
+    printGitFinalizeManual("git add failed", `git add -A -f -- ${paths.join(" ")}`);
+    return;
+  }
+  if (runGit(projectDir, ["diff", "--cached", "--quiet", "--", ...paths]).ok)
+    return;
+  const commit2 = runGit(projectDir, ["commit", "-m", "roll init: commit Roll-owned meta files"]);
+  if (!commit2.ok) {
+    printGitFinalizeManual("git commit failed", "git commit -m 'roll init: commit Roll-owned meta files' -- AGENTS.md .roll .claude .gitignore");
+    return;
+  }
+  const sha = runGit(projectDir, ["rev-parse", "--short", "HEAD"]).stdout.trim();
+  ok10(`Roll meta committed${sha !== "" ? `: ${sha}` : ""}`);
+  const branch = runGit(projectDir, ["rev-parse", "--abbrev-ref", "HEAD"]).stdout.trim();
+  if (branch === "" || branch === "HEAD") {
+    printGitFinalizeManual("detached HEAD; push skipped", "git push origin HEAD");
+    return;
+  }
+  const remotes = runGit(projectDir, ["remote"]).stdout.split("\n").filter((line) => line.trim() !== "");
+  if (!remotes.includes("origin")) {
+    printGitFinalizeManual("origin remote is not configured; push skipped", `git push -u origin ${branch}`);
+    return;
+  }
+  const push2 = runGit(projectDir, ["push", "-u", "origin", branch]);
+  if (!push2.ok) {
+    printGitFinalizeManual("git push failed", `git push -u origin ${branch}`);
+    return;
+  }
+  ok10(`Roll meta pushed: origin/${branch}`);
+}
 function err9(line) {
   const { RED, NC } = pal4();
   process.stderr.write(`${RED}[roll]${NC} ${line}
@@ -260914,6 +261103,7 @@ function initRepair(projectDir, facts, diagnosis2, opts = {}) {
   recordCreatedFileIfNeeded(projectDir, changeset, ".roll/.version", stampExisted);
   printMergeSummary(summary);
   ok10("Repair complete.");
+  finalizeRollOwnedGit(projectDir);
   return 0;
 }
 function initApply(projectDir, opts = {}) {
@@ -261029,6 +261219,7 @@ function initApply(projectDir, opts = {}) {
     registerProject(projectDir);
     process.stdout.write("\n");
     ok10(m3("init.onboard_apply_complete_onboard"));
+    finalizeRollOwnedGit(projectDir);
     return 0;
   } catch (error) {
     err9(m32("init.onboard_apply_failed"));
@@ -261859,6 +262050,7 @@ function initCommand(args, deps = {}) {
   registerProject(projectDir);
   const shouldNudge = detectDesignHandoff(projectDir).shouldNudge;
   emitInitUi(projectDir, hasAgents, syncStatus, summary, shouldNudge, repairMode ? "repair" : void 0, conciergeNextItems(brief, initDiagnosis));
+  finalizeRollOwnedGit(projectDir);
   void err9;
   return 0;
 }
@@ -262055,9 +262247,9 @@ function nextCommand(args) {
 // packages/cli/dist/commands/design.js
 init_dist();
 init_dist2();
-import { spawnSync as spawnSync12 } from "node:child_process";
-import { existsSync as existsSync85, mkdirSync as mkdirSync37, readFileSync as readFileSync78, renameSync as renameSync16, statSync as statSync31, writeFileSync as writeFileSync39 } from "node:fs";
-import { dirname as dirname39, join as join88, relative as relative6, resolve as resolve8 } from "node:path";
+import { spawn as spawnChild } from "node:child_process";
+import { appendFileSync as appendFileSync13, existsSync as existsSync85, mkdirSync as mkdirSync37, readFileSync as readFileSync78, renameSync as renameSync16, statSync as statSync31, writeFileSync as writeFileSync39 } from "node:fs";
+import { dirname as dirname39, join as join88, relative as relative6, resolve as resolve9 } from "node:path";
 
 // packages/cli/dist/lib/review-page.js
 init_dist2();
@@ -262443,7 +262635,7 @@ function lookupEpic(target, cwd) {
 function readBacklogItems(cwd) {
   try {
     const content = readFileSync78(join88(cwd, ".roll", "backlog.md"), "utf8");
-    return parseBacklog(content).map((row2) => ({ id: row2.id }));
+    return parseBacklog(content).map((row2) => ({ id: row2.id, desc: row2.desc }));
   } catch {
     return [];
   }
@@ -262466,7 +262658,7 @@ function renderDesignReviewPageForTarget(ctx, cardsCreated) {
     return;
   const base = join88(".roll", "features", epic, ctx.target);
   const md = join88(base, "spec.md");
-  const absMd = resolve8(ctx.cwd, md);
+  const absMd = resolve9(ctx.cwd, md);
   if (!existsSync85(absMd) || !hasDetailedDesign(absMd))
     return;
   const markdown = readFileSync78(absMd, "utf8");
@@ -262481,7 +262673,7 @@ function renderDesignReviewPageForTarget(ctx, cardsCreated) {
     markdown,
     lang: ctx.lang
   });
-  const out3 = resolve8(ctx.cwd, base, "design-review.html");
+  const out3 = resolve9(ctx.cwd, base, "design-review.html");
   mkdirSync37(dirname39(out3), { recursive: true });
   const tmp = `${out3}.tmp`;
   writeFileSync39(tmp, html, "utf8");
@@ -262499,37 +262691,203 @@ function formatSignal(sig) {
   const detail = sig.detail !== void 0 && sig.detail !== "" ? `  ${sig.detail}` : "";
   return `${fmtHhmmss(sig.ts)}  ${sig.summary}${detail}`.trimEnd();
 }
-function progressLines(agent, combined, startMs, verbose) {
-  const normalizer = normalizerFor(agent);
+function isPromiseLike(value) {
+  return typeof value.then === "function";
+}
+function isDesignNoise(text2) {
+  const s = text2.trim();
+  if (s === "")
+    return true;
+  if (/^\?\?\s/.test(s))
+    return true;
+  if (/^\s*-\s*\[\s*\]\s+/.test(s))
+    return true;
+  return /\$roll-design|roll-design contract|ID generation algorithm|Who writes the data|encrypted reasoning/i.test(s);
+}
+function isMeaningfulDesignSay(summary) {
+  return /\b(reading|planning|designing|writing|validating|recovering|handoff|backlog|spec|artifact|context|contexts|created|card)\b/i.test(summary);
+}
+function shouldShowSignal(sig, verbose) {
+  const joined = `${sig.summary} ${sig.detail ?? ""}`;
+  if (isDesignNoise(joined))
+    return false;
+  if (verbose)
+    return true;
+  if (sig.tier === "A" || sig.tier === "B")
+    return true;
+  if (sig.kind === "say" && isMeaningfulDesignSay(sig.summary))
+    return true;
+  return sig.kind === "say" && isQuestionLike(sig.summary);
+}
+function formatDuration(ms) {
+  const total = Math.max(0, Math.round(ms / 1e3));
+  const m7 = Math.floor(total / 60);
+  const s = total % 60;
+  if (m7 === 0)
+    return `${s}s`;
+  return `${m7}m ${String(s).padStart(2, "0")}s`;
+}
+function formatBytes(bytes) {
+  if (bytes < 1024)
+    return `${bytes} B`;
+  if (bytes < 1024 * 1024)
+    return `${Math.round(bytes / 1024)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function transcriptSize(path) {
+  try {
+    return statSync31(path).size;
+  } catch {
+    return 0;
+  }
+}
+function splitCardDescription(desc) {
+  const clean3 = desc.replace(/\s+/g, " ").trim();
+  const solves = /\s+·\s+solves\s+/i.exec(clean3);
+  if (solves !== null) {
+    const title = clean3.slice(0, solves.index).trim();
+    const problem = clean3.slice(solves.index + solves[0].length).trim();
+    return { title: title || clean3, problem: problem || title || clean3 };
+  }
+  return { title: clean3 || "Untitled card", problem: clean3 || "the design gap" };
+}
+function createLiveProgress(ctx, deps, opts) {
+  const normalizer = normalizerFor(ctx.agent);
   const state = newNormalizerState();
-  const out3 = [];
-  const lines3 = combined.split("\n");
-  for (let i = 0; i < lines3.length; i += 1) {
-    const line = lines3[i] ?? "";
-    const nowMs = startMs + i * 1e3;
-    const signals = normalizer.normalize(line, state, nowMs);
+  const emittedCards = /* @__PURE__ */ new Set();
+  const knownBefore = new Set(ctx.beforeBacklog.map((row2) => row2.id));
+  let stdoutBuffer = "";
+  let stderrBuffer = "";
+  let rawTranscript = "";
+  let sawLiveOutput = false;
+  let lastPrintedTs = ctx.startTs;
+  let heartbeat;
+  const scanCards = () => {
+    if (opts.raw)
+      return;
+    for (const item of readBacklogItems(ctx.cwd)) {
+      if (knownBefore.has(item.id) || emittedCards.has(item.id))
+        continue;
+      emittedCards.add(item.id);
+      const { title, problem } = splitCardDescription(item.desc);
+      const ts2 = deps.now();
+      lastPrintedTs = ts2;
+      emit4(`${fmtHhmmss(ts2)}  card created: ${item.id} \u2014 ${title} \xB7 solves ${problem}`);
+    }
+  };
+  const processLine = (line) => {
+    if (opts.raw)
+      return;
+    const ts2 = deps.now();
+    const signals = normalizer.normalize(line, state, ts2);
     for (const sig of signals) {
-      const show = verbose || sig.tier === "A" || sig.tier === "B" || sig.kind === "say" && isQuestionLike(sig.summary);
-      if (show) {
-        out3.push(formatSignal(sig));
+      if (!shouldShowSignal(sig, opts.verbose))
+        continue;
+      lastPrintedTs = sig.ts;
+      emit4(formatSignal(sig));
+    }
+  };
+  const ingest = (chunk, stream) => {
+    if (chunk === "")
+      return;
+    sawLiveOutput = true;
+    rawTranscript += chunk;
+    appendFileSync13(ctx.transcriptPath, chunk, "utf8");
+    if (opts.raw) {
+      process.stderr.write(chunk);
+      return;
+    }
+    const next = (stream === "stdout" ? stdoutBuffer : stderrBuffer) + chunk;
+    const parts = next.split(/\n/);
+    const complete = parts.slice(0, -1);
+    for (const line of complete)
+      processLine(line);
+    if (stream === "stdout")
+      stdoutBuffer = parts[parts.length - 1] ?? "";
+    else
+      stderrBuffer = parts[parts.length - 1] ?? "";
+    scanCards();
+  };
+  const emitHeartbeat = () => {
+    if (opts.raw)
+      return;
+    const ts2 = deps.now();
+    if (ts2 - lastPrintedTs < deps.heartbeatMs)
+      return;
+    lastPrintedTs = ts2;
+    emit4(`${fmtHhmmss(ts2)}  heartbeat: still designing \xB7 elapsed ${formatDuration(ts2 - ctx.startTs)} \xB7 transcript ${formatBytes(transcriptSize(ctx.transcriptPath))} \xB7 cards observed ${emittedCards.size}`);
+  };
+  return {
+    get sawLiveOutput() {
+      return sawLiveOutput;
+    },
+    get rawTranscript() {
+      return rawTranscript;
+    },
+    startHeartbeat: () => {
+      if (opts.raw)
+        return;
+      heartbeat = setInterval(emitHeartbeat, deps.heartbeatMs);
+      heartbeat.unref?.();
+    },
+    stopHeartbeat: () => {
+      if (heartbeat !== void 0)
+        clearInterval(heartbeat);
+    },
+    ingestStdout: (chunk) => ingest(chunk, "stdout"),
+    ingestStderr: (chunk) => ingest(chunk, "stderr"),
+    flush: () => {
+      if (stdoutBuffer !== "") {
+        processLine(stdoutBuffer);
+        stdoutBuffer = "";
       }
+      if (stderrBuffer !== "") {
+        processLine(stderrBuffer);
+        stderrBuffer = "";
+      }
+      scanCards();
     }
-  }
-  return out3;
+  };
 }
 var defaultDeps = {
   cwd: process.cwd(),
   env: process.env,
   readLine: readLineFromStdin,
   now: () => Date.now(),
-  spawn: (bin, args, opts) => {
-    const r = spawnSync12(bin, args, { ...opts, stdio: ["inherit", "pipe", "pipe"], encoding: "utf8" });
-    return {
-      status: r.status ?? null,
-      signal: r.signal ?? null,
-      stdout: typeof r.stdout === "string" ? r.stdout : "",
-      stderr: typeof r.stderr === "string" ? r.stderr : ""
-    };
+  heartbeatMs: 6e4,
+  spawn: (bin, args, opts, live) => {
+    return new Promise((resolveSpawn) => {
+      const child = spawnChild(bin, args, { ...opts, stdio: ["inherit", "pipe", "pipe"] });
+      let stdout = "";
+      let stderr = "";
+      let settled = false;
+      const finish = (result) => {
+        if (settled)
+          return;
+        settled = true;
+        resolveSpawn(result);
+      };
+      child.stdout?.setEncoding("utf8");
+      child.stderr?.setEncoding("utf8");
+      child.stdout?.on("data", (chunk) => {
+        stdout += chunk;
+        live?.onStdout(chunk);
+      });
+      child.stderr?.on("data", (chunk) => {
+        stderr += chunk;
+        live?.onStderr(chunk);
+      });
+      child.on("error", (err16) => {
+        const message = `${err16 instanceof Error ? err16.message : String(err16)}
+`;
+        stderr += message;
+        live?.onStderr(message);
+        finish({ status: 1, signal: null, stdout, stderr });
+      });
+      child.on("close", (code, signal) => {
+        finish({ status: code, signal, stdout, stderr });
+      });
+    });
   }
 };
 function selectAgent(installed, forced, envAgent, primary, readLine) {
@@ -262594,12 +262952,12 @@ function printHandoff(ctx, statusCode, rawTranscript) {
     const md = join88(base, "spec.md");
     const reviewHtml = join88(base, "design-review.html");
     const html = join88(base, "spec.html");
-    if (existsSync85(resolve8(ctx.cwd, md))) {
-      designPath = hasDetailedDesign(resolve8(ctx.cwd, md)) ? `${md}#detailed-design` : md;
+    if (existsSync85(resolve9(ctx.cwd, md))) {
+      designPath = hasDetailedDesign(resolve9(ctx.cwd, md)) ? `${md}#detailed-design` : md;
     }
-    if (existsSync85(resolve8(ctx.cwd, reviewHtml)))
+    if (existsSync85(resolve9(ctx.cwd, reviewHtml)))
       reviewPagePath = reviewHtml;
-    else if (existsSync85(resolve8(ctx.cwd, html)))
+    else if (existsSync85(resolve9(ctx.cwd, html)))
       reviewPagePath = html;
   }
   let status2;
@@ -262664,7 +263022,7 @@ function designCommand(args, deps = {}) {
     emit4(t(v3Catalog, l, "design.not_roll_project"));
     return 1;
   }
-  if (fromFile !== void 0 && !isRegularFile(resolve8(d.cwd, fromFile))) {
+  if (fromFile !== void 0 && !isRegularFile(resolve9(d.cwd, fromFile))) {
     emit4(t(v3Catalog, l, "design.from_file_not_found", fromFile));
     return 1;
   }
@@ -262717,20 +263075,35 @@ function designCommand(args, deps = {}) {
     beforeBacklog: readBacklogItems(d.cwd)
   };
   printStartBlock(ctx);
-  const result = d.spawn(cmd.bin, cmd.args, { cwd: d.cwd, env: d.env });
-  const rawTranscript = [result.stdout ?? "", result.stderr ?? ""].filter((s) => s !== "").join("\n");
-  writeFileSync39(runTranscript, rawTranscript, "utf8");
-  if (rawMode) {
-    if (rawTranscript !== "")
-      emit4(rawTranscript);
-  } else {
-    const lines3 = progressLines(agent, rawTranscript, startTs, verbose);
-    for (const line of lines3)
-      emit4(line);
+  const live = createLiveProgress(ctx, d, { raw: rawMode, verbose });
+  live.startHeartbeat();
+  const finish = (result) => {
+    if (!live.sawLiveOutput) {
+      live.ingestStdout(result.stdout ?? "");
+      live.ingestStderr(result.stderr ?? "");
+    } else {
+      const stdout = result.stdout ?? "";
+      const stderr = result.stderr ?? "";
+      if (stdout !== "" && !live.rawTranscript.includes(stdout))
+        live.ingestStdout(stdout);
+      if (stderr !== "" && !live.rawTranscript.includes(stderr))
+        live.ingestStderr(stderr);
+    }
+    live.stopHeartbeat();
+    live.flush();
+    const statusCode = result.status ?? (result.signal === null ? 1 : 130);
+    printHandoff(ctx, statusCode, live.rawTranscript);
+    return statusCode;
+  };
+  const spawned = d.spawn(cmd.bin, cmd.args, { cwd: d.cwd, env: d.env }, { onStdout: live.ingestStdout, onStderr: live.ingestStderr });
+  if (isPromiseLike(spawned)) {
+    return spawned.then(finish, (err16) => {
+      live.ingestStderr(`${err16 instanceof Error ? err16.message : String(err16)}
+`);
+      return finish({ status: 1, signal: null });
+    });
   }
-  const statusCode = result.status ?? (result.signal === null ? 1 : 130);
-  printHandoff(ctx, statusCode, rawTranscript);
-  return statusCode;
+  return finish(spawned);
 }
 
 // packages/cli/dist/commands/loop-watch.js
@@ -262738,7 +263111,7 @@ init_dist();
 init_dist2();
 init_dist3();
 init_render();
-import { spawn as spawn8, spawnSync as spawnSync13 } from "node:child_process";
+import { spawn as spawn8, spawnSync as spawnSync12 } from "node:child_process";
 import { existsSync as existsSync86, readFileSync as readFileSync79 } from "node:fs";
 import { join as join89 } from "node:path";
 import { createInterface as createInterface4 } from "node:readline";
@@ -262899,13 +263272,13 @@ function realDeps7() {
     render: (input, opts) => streamThroughRenderer(input, process.stdout, opts),
     renderEvents: streamEvents,
     tmuxState: probeWatchTmuxState,
-    tmuxRun: (argv) => spawnSync13("tmux", argv, { stdio: "ignore" }).status === 0,
+    tmuxRun: (argv) => spawnSync12("tmux", argv, { stdio: "ignore" }).status === 0,
     tmuxAttach: (session) => {
-      spawnSync13("tmux", ["attach-session", "-r", "-t", session], { stdio: "inherit" });
+      spawnSync12("tmux", ["attach-session", "-r", "-t", session], { stdio: "inherit" });
     },
     hasTmux: () => {
       try {
-        return spawnSync13("tmux", ["-V"], { stdio: "ignore" }).status === 0;
+        return spawnSync12("tmux", ["-V"], { stdio: "ignore" }).status === 0;
       } catch {
         return false;
       }
@@ -262916,10 +263289,10 @@ function realDeps7() {
 }
 function probeWatchTmuxState(slug3) {
   const session = watchSessionName(slug3);
-  const sessionExists = spawnSync13("tmux", ["has-session", "-t", session], { stdio: "ignore" }).status === 0;
+  const sessionExists = spawnSync12("tmux", ["has-session", "-t", session], { stdio: "ignore" }).status === 0;
   if (!sessionExists)
     return { sessionExists: false, watchWindowExists: false };
-  const listed = spawnSync13("tmux", ["list-windows", "-t", session, "-F", "#{window_name}"], { encoding: "utf8" });
+  const listed = spawnSync12("tmux", ["list-windows", "-t", session, "-F", "#{window_name}"], { encoding: "utf8" });
   const windows = listed.status === 0 ? String(listed.stdout ?? "").split("\n").map((w) => w.trim()) : [];
   return { sessionExists: true, watchWindowExists: windows.includes("watch") };
 }
@@ -263296,14 +263669,14 @@ ${RECONCILE_PENDING_USAGE}
 
 // packages/cli/dist/commands/loop-review-resize.js
 init_dist2();
-import { appendFileSync as appendFileSync14, mkdirSync as mkdirSync39 } from "node:fs";
+import { appendFileSync as appendFileSync15, mkdirSync as mkdirSync39 } from "node:fs";
 import { dirname as dirname41, join as join92 } from "node:path";
 init_dist2();
 
 // packages/cli/dist/commands/loop-self-downgrade.js
 init_dist2();
 init_dist3();
-import { appendFileSync as appendFileSync13, existsSync as existsSync87, mkdirSync as mkdirSync38, readFileSync as readFileSync80, readdirSync as readdirSync32 } from "node:fs";
+import { appendFileSync as appendFileSync14, existsSync as existsSync87, mkdirSync as mkdirSync38, readFileSync as readFileSync80, readdirSync as readdirSync32 } from "node:fs";
 import { dirname as dirname40, join as join91 } from "node:path";
 function realSelfDowngradeDeps() {
   return {
@@ -263418,7 +263791,7 @@ async function loopSelfDowngradeCommand(argv, deps = realSelfDowngradeDeps()) {
     const headline = plan.capReason === "chain-cap" ? `${parentId} hit the self-downgrade chain cap (chain_depth=${plan.chainDepth} \u2265 ${CHAIN_DEPTH_CAP}) \u2014 held for human triage` : `${parentId} could not be split into \u22652 sub-stories (irreducible) \u2014 held for human triage`;
     try {
       mkdirSync38(dirname40(alertsPath), { recursive: true });
-      appendFileSync13(alertsPath, `[${isoUtc(ts2)}] ALERT ${headline}
+      appendFileSync14(alertsPath, `[${isoUtc(ts2)}] ALERT ${headline}
 `, "utf8");
     } catch {
     }
@@ -263521,7 +263894,7 @@ For each sub-story create its .roll/features/<epic>/<id>/spec.md. Do NOT edit th
       const alertsPath = (process.env["ROLL_LOOP_ALERT"] ?? "").trim() || join92(rt, `ALERT-${projectSlug3(projectPath3)}.md`);
       try {
         mkdirSync39(dirname41(alertsPath), { recursive: true });
-        appendFileSync14(alertsPath, `[${new Date(ts2).toISOString()}] ALERT ${message}
+        appendFileSync15(alertsPath, `[${new Date(ts2).toISOString()}] ALERT ${message}
 `, "utf8");
       } catch {
       }
@@ -263621,7 +263994,7 @@ async function loopExhaustionSplitCommand(argv, deps = realExhaustionSplitDeps()
 init_dist2();
 init_dist();
 init_dist3();
-import { appendFileSync as appendFileSync18, existsSync as existsSync99, mkdirSync as mkdirSync47, readFileSync as readFileSync93, writeFileSync as writeFileSync49 } from "node:fs";
+import { appendFileSync as appendFileSync19, existsSync as existsSync99, mkdirSync as mkdirSync47, readFileSync as readFileSync93, writeFileSync as writeFileSync49 } from "node:fs";
 import { dirname as dirname46, join as join103 } from "node:path";
 
 // packages/cli/dist/runner/executor.js
@@ -263670,7 +264043,7 @@ function writeCycleRoleSummaryBestEffort(cycleId, eventsPath3, cycleLogDir) {
 
 // packages/cli/dist/runner/executor.js
 import { execFile as execFile10, execFileSync as execFileSync22 } from "node:child_process";
-import { appendFileSync as appendFileSync16, existsSync as existsSync95, lstatSync as lstatSync5, mkdirSync as mkdirSync44, readdirSync as readdirSync36, readFileSync as readFileSync89, realpathSync as realpathSync13, renameSync as renameSync17, rmSync as rmSync16, statSync as statSync33, symlinkSync as symlinkSync3, unlinkSync as unlinkSync4, writeFileSync as writeFileSync46 } from "node:fs";
+import { appendFileSync as appendFileSync17, existsSync as existsSync95, lstatSync as lstatSync5, mkdirSync as mkdirSync44, readdirSync as readdirSync36, readFileSync as readFileSync89, realpathSync as realpathSync13, renameSync as renameSync17, rmSync as rmSync16, statSync as statSync33, symlinkSync as symlinkSync3, unlinkSync as unlinkSync4, writeFileSync as writeFileSync46 } from "node:fs";
 import { homedir as homedir27 } from "node:os";
 import { dirname as dirname43, join as join100 } from "node:path";
 import { promisify as promisify10 } from "node:util";
@@ -263734,8 +264107,8 @@ async function probeAgentReachable(agent, spawn10, opts = {}) {
   try {
     res = await Promise.race([
       spawn10(agent, { cwd, skillBody: `Reply with exactly: ${token}`, timeoutMs, bare: true }),
-      new Promise((resolve11) => {
-        setTimeout(() => resolve11(null), timeoutMs).unref();
+      new Promise((resolve12) => {
+        setTimeout(() => resolve12(null), timeoutMs).unref();
       })
     ]);
   } catch (e) {
@@ -264323,7 +264696,7 @@ function autoAttachScreenshotToAcMap(worktreeCwd, storyId, runDir) {
 // packages/cli/dist/runner/correction-actuator.js
 init_dist2();
 init_dist();
-import { appendFileSync as appendFileSync15, existsSync as existsSync93, mkdirSync as mkdirSync42, readFileSync as readFileSync87, readdirSync as readdirSync35, writeFileSync as writeFileSync44 } from "node:fs";
+import { appendFileSync as appendFileSync16, existsSync as existsSync93, mkdirSync as mkdirSync42, readFileSync as readFileSync87, readdirSync as readdirSync35, writeFileSync as writeFileSync44 } from "node:fs";
 import { dirname as dirname42, join as join98 } from "node:path";
 function readMode(projectPath3) {
   try {
@@ -264345,7 +264718,7 @@ function readEvents4(eventsPath3) {
 function appendEvent(eventsPath3, event) {
   try {
     mkdirSync42(dirname42(eventsPath3), { recursive: true });
-    appendFileSync15(eventsPath3, `${JSON.stringify(event)}
+    appendFileSync16(eventsPath3, `${JSON.stringify(event)}
 `, "utf8");
   } catch {
   }
@@ -264353,7 +264726,7 @@ function appendEvent(eventsPath3, event) {
 function appendAlert2(alertsPath, msg6) {
   try {
     mkdirSync42(dirname42(alertsPath), { recursive: true });
-    appendFileSync15(alertsPath, `${msg6}
+    appendFileSync16(alertsPath, `${msg6}
 `, "utf8");
   } catch {
   }
@@ -264621,7 +264994,7 @@ function reviewTimeoutMs(diffChars) {
 async function firstValid(promises) {
   if (promises.length === 0)
     return null;
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     let pending = promises.length;
     let settled = false;
     let lastError;
@@ -264633,7 +265006,7 @@ async function firstValid(promises) {
         if (threw)
           reject(lastError);
         else
-          resolve11(null);
+          resolve12(null);
       }
     };
     for (const p of promises) {
@@ -264642,7 +265015,7 @@ async function firstValid(promises) {
           return;
         if (value !== null) {
           settled = true;
-          resolve11(value);
+          resolve12(value);
           return;
         }
         onNonResult();
@@ -265025,7 +265398,7 @@ DIFF:
 
 // packages/cli/dist/runner/executor.js
 var execFileAsync10 = promisify10(execFile10);
-function parsePorcelainPath(line) {
+function parsePorcelainPath2(line) {
   const raw = line.length > 3 ? line.slice(3).trim() : line.trim();
   const target = raw.includes(" -> ") ? raw.split(" -> ").at(-1) ?? raw : raw;
   return target.replace(/^"|"$/g, "");
@@ -265036,7 +265409,7 @@ async function checkMainDirty(repoCwd) {
       cwd: repoCwd,
       encoding: "utf8"
     });
-    return stdout.split("\n").map((line) => line.trimEnd()).filter((line) => line.trim() !== "").map(parsePorcelainPath).filter((path) => path !== ".roll" && !path.startsWith(".roll/")).slice(0, 50);
+    return stdout.split("\n").map((line) => line.trimEnd()).filter((line) => line.trim() !== "").map(parsePorcelainPath2).filter((path) => path !== ".roll" && !path.startsWith(".roll/")).slice(0, 50);
   } catch {
     return [];
   }
@@ -265141,7 +265514,7 @@ var ActivitySignalRecorder = class {
   }
   append(signals) {
     try {
-      appendFileSync16(this.signalPath, signals.map((sig) => JSON.stringify(sig)).join("\n") + "\n", "utf8");
+      appendFileSync17(this.signalPath, signals.map((sig) => JSON.stringify(sig)).join("\n") + "\n", "utf8");
     } catch {
     }
   }
@@ -265510,7 +265883,7 @@ function createCaptureMarkerSink(runDir, capture) {
   const record = (marker, result) => {
     try {
       mkdirSync44(dirname43(logPath), { recursive: true });
-      appendFileSync16(logPath, JSON.stringify({ marker, result }) + "\n", "utf8");
+      appendFileSync17(logPath, JSON.stringify({ marker, result }) + "\n", "utf8");
     } catch {
     }
   };
@@ -265756,7 +266129,7 @@ ${skillBodyForSpawn}` : skillBodyForSpawn;
             stallDetector.markProgress();
             captureSink?.onChunk(d);
             try {
-              appendFileSync16(livePath, d);
+              appendFileSync17(livePath, d);
             } catch {
             }
             signalRecorder.accept(d);
@@ -265995,7 +266368,7 @@ ${stderr}
               // FIX-319: review-only framing, no worker autorun directive
               ...ctx.evidenceRunDir !== void 0 ? { runDir: ctx.evidenceRunDir } : {}
             }),
-            new Promise((resolve11) => setTimeout(() => resolve11(null), timeoutMs).unref())
+            new Promise((resolve12) => setTimeout(() => resolve12(null), timeoutMs).unref())
           ]);
         } catch (e) {
           const detail = e instanceof Error ? e.message : String(e);
@@ -266135,7 +266508,7 @@ ${res.stderr}`;
                 timeoutMs,
                 ...ctx.evidenceRunDir !== void 0 ? { runDir: ctx.evidenceRunDir } : {}
               }),
-              new Promise((resolve11) => setTimeout(() => resolve11(null), timeoutMs).unref())
+              new Promise((resolve12) => setTimeout(() => resolve12(null), timeoutMs).unref())
             ]);
           } catch (e) {
             const detail = e instanceof Error ? e.message : String(e);
@@ -267354,7 +267727,7 @@ async function linkRollIntoWorktree(repoCwd, worktreePath) {
     const cur = existsSync95(exclude) ? readFileSync89(exclude, "utf8") : "";
     if (!/^\.roll$/m.test(cur)) {
       mkdirSync44(dirname43(exclude), { recursive: true });
-      appendFileSync16(exclude, `${cur === "" || cur.endsWith("\n") ? "" : "\n"}.roll
+      appendFileSync17(exclude, `${cur === "" || cur.endsWith("\n") ? "" : "\n"}.roll
 `, "utf8");
     }
   } catch {
@@ -267928,7 +268301,7 @@ function nodePorts(opts) {
 }
 function appendAlertLine(alertsPath, message) {
   mkdirSync44(dirname43(alertsPath), { recursive: true });
-  appendFileSync16(alertsPath, `${message}
+  appendFileSync17(alertsPath, `${message}
 `, "utf8");
 }
 
@@ -268271,7 +268644,7 @@ async function warnIfBinaryStale(rollHomeDir2, runningVersion, appendAlert3) {
 // packages/cli/dist/runner/correction-circuit.js
 init_dist2();
 init_dist();
-import { appendFileSync as appendFileSync17, existsSync as existsSync98, mkdirSync as mkdirSync46, readFileSync as readFileSync92, writeFileSync as writeFileSync48 } from "node:fs";
+import { appendFileSync as appendFileSync18, existsSync as existsSync98, mkdirSync as mkdirSync46, readFileSync as readFileSync92, writeFileSync as writeFileSync48 } from "node:fs";
 import { dirname as dirname45, join as join102 } from "node:path";
 function readLoopSafety(projectPath3) {
   try {
@@ -268295,7 +268668,7 @@ function alreadyTripped(events, verdict) {
 }
 function appendEvent2(eventsPath3, event) {
   mkdirSync46(dirname45(eventsPath3), { recursive: true });
-  appendFileSync17(eventsPath3, `${JSON.stringify(event)}
+  appendFileSync18(eventsPath3, `${JSON.stringify(event)}
 `, "utf8");
 }
 function applyCorrectionCircuitBreaker(projectPath3, slug3, eventsPath3, alertsPath, nowSec2 = Math.floor(Date.now() / 1e3)) {
@@ -268321,7 +268694,7 @@ function applyCorrectionCircuitBreaker(projectPath3, slug3, eventsPath3, alertsP
     if (pauseWritten)
       writeFileSync48(pauseMarker, alertMsg, "utf8");
     mkdirSync46(dirname45(alertsPath), { recursive: true });
-    appendFileSync17(alertsPath, `${alertMsg}
+    appendFileSync18(alertsPath, `${alertMsg}
 `, "utf8");
     appendEvent2(eventsPath3, {
       type: "correction:circuit_breaker",
@@ -268341,7 +268714,7 @@ function applyCorrectionCircuitBreaker(projectPath3, slug3, eventsPath3, alertsP
 
 // packages/cli/dist/commands/loop-run-once.js
 init_dist();
-import { execFileSync as execFileSync23, spawn as spawn9, spawnSync as spawnSync14 } from "node:child_process";
+import { execFileSync as execFileSync23, spawn as spawn9, spawnSync as spawnSync13 } from "node:child_process";
 import { lookup as lookup2 } from "node:dns/promises";
 function announceReport(projectPath3, slug3, storyId, opener = (p) => {
   try {
@@ -268487,7 +268860,7 @@ function writeCardSkipAlert(alertsPath, eventsPath3, cycleId, storyId, count) {
 **Action**: investigate ${storyId} (it likely needs a smaller split, a spec fix, or manual delivery). Once addressed, remove it from \`.roll/loop/skip-cards.json\` (or just fix the card) to re-arm it.
 `;
   try {
-    appendFileSync18(alertsPath, `${msg6}
+    appendFileSync19(alertsPath, `${msg6}
 `, "utf8");
   } catch {
   }
@@ -268534,7 +268907,7 @@ function incrementConsecutiveFails(projectPath3, slug3, alertsPath, eventsPath3,
 `;
   try {
     writeFileSync49(pauseMarker, alertMsg, "utf8");
-    appendFileSync18(alertsPath, `${alertMsg}
+    appendFileSync19(alertsPath, `${alertMsg}
 `, "utf8");
     const ts2 = Date.now();
     const bus = new EventBus();
@@ -268701,7 +269074,7 @@ function writeReviewerBlockedAlert(projectPath3, slug3, alertsPath, eventsPath3,
 ` : "") + `**Action**: ${fix}
 `;
   try {
-    appendFileSync18(alertsPath, `${msg6}
+    appendFileSync19(alertsPath, `${msg6}
 `, "utf8");
   } catch {
   }
@@ -268852,10 +269225,10 @@ async function loopRunOnceCommand(args) {
       const headline = t(v3Catalog, lang10, "loop.egress_blocked", cycleId);
       try {
         const ts2 = (/* @__PURE__ */ new Date()).toISOString();
-        appendFileSync18(alertsPath, `[${ts2}] ALERT ${headline}
+        appendFileSync19(alertsPath, `[${ts2}] ALERT ${headline}
 `, "utf8");
         for (const line of guardLines)
-          appendFileSync18(alertsPath, `[${ts2}] ALERT ${line}
+          appendFileSync19(alertsPath, `[${ts2}] ALERT ${line}
 `, "utf8");
       } catch {
       }
@@ -268880,7 +269253,7 @@ loop run-once: ${repoCheck.detail !== "" ? `(${repoCheck.detail})` : ""}
   if (skillBody === null) {
     const msg6 = `[${(/* @__PURE__ */ new Date()).toISOString()}] ALERT loop run-once: roll-loop SKILL.md not found (checked ROLL_LOOP_SKILL, .roll/skills/, skills/) \u2014 cycle ${cycleId} refused to start`;
     try {
-      appendFileSync18(alertsPath, `${msg6}
+      appendFileSync19(alertsPath, `${msg6}
 `, "utf8");
     } catch {
     }
@@ -268914,7 +269287,7 @@ loop run-once: \u627E\u4E0D\u5230 roll-loop SKILL.md \u2014 \u62D2\u7EDD\u76F2\u
   try {
     await warnIfBinaryStale(rollHome(), rollVersion(), (msg6) => {
       try {
-        appendFileSync18(alertsPath, `${msg6}
+        appendFileSync19(alertsPath, `${msg6}
 `, "utf8");
       } catch {
       }
@@ -269132,10 +269505,10 @@ function autoGc(projectPath3) {
     }
   }
 }
-async function isOffline(resolve11 = (h) => lookup2(h)) {
+async function isOffline(resolve12 = (h) => lookup2(h)) {
   try {
     await Promise.race([
-      resolve11("github.com"),
+      resolve12("github.com"),
       new Promise((_, rej) => {
         const t2 = setTimeout(() => rej(new Error("dns timeout")), 1500);
         if (typeof t2 === "object")
@@ -269152,7 +269525,7 @@ function isLoopPaused(projectPath3, slug3) {
 }
 function checkRepoPushable(projectPath3) {
   const git4 = (args) => {
-    const r = spawnSync14("git", args, { cwd: projectPath3, encoding: "utf8" });
+    const r = spawnSync13("git", args, { cwd: projectPath3, encoding: "utf8" });
     return { code: r.status ?? 1, stderr: r.stderr ?? "" };
   };
   const inside = git4(["rev-parse", "--git-dir"]);
@@ -269184,7 +269557,7 @@ function writeRepoAlert(alertsPath, eventsPath3, cycleId, result) {
 **Action**: ${t(v3Catalog, lang10, "loop.no_remote")}
 `;
   try {
-    appendFileSync18(alertsPath, `${msg6}
+    appendFileSync19(alertsPath, `${msg6}
 `, "utf8");
   } catch {
   }
@@ -269201,10 +269574,10 @@ function writeRepoAlert(alertsPath, eventsPath3, cycleId, result) {
 
 // packages/cli/dist/commands/offboard.js
 init_dist();
-import { spawnSync as spawnSync15 } from "node:child_process";
+import { spawnSync as spawnSync14 } from "node:child_process";
 import { existsSync as existsSync100, readFileSync as readFileSync94, realpathSync as realpathSync14, renameSync as renameSync18, rmSync as rmSync17, writeFileSync as writeFileSync50 } from "node:fs";
 import { homedir as homedir28 } from "node:os";
-import { join as join104, resolve as resolve9 } from "node:path";
+import { join as join104, resolve as resolve10 } from "node:path";
 function pal5() {
   const noColor2 = (process.env["NO_COLOR"] ?? "") !== "";
   return noColor2 ? { RED: "", GREEN: "", YELLOW: "", CYAN: "", BOLD: "", NC: "" } : {
@@ -269250,13 +269623,13 @@ function loopInCycle2() {
 function runLaunchctl(args) {
   const readOnly = /* @__PURE__ */ new Set(["print", "print-disabled", "list", "version", "dumpstate", "examine"]);
   if (args[0] !== void 0 && readOnly.has(args[0])) {
-    return spawnSync15("launchctl", args, { stdio: "inherit" }).status ?? 1;
+    return spawnSync14("launchctl", args, { stdio: "inherit" }).status ?? 1;
   }
   const canonical = join104(homedir28(), "Library", "LaunchAgents");
   const launchdDir = process.env["_LAUNCHD_DIR"] ?? canonical;
   if (launchdDir !== canonical)
     return 0;
-  return spawnSync15("launchctl", args, { stdio: "inherit" }).status ?? 1;
+  return spawnSync14("launchctl", args, { stdio: "inherit" }).status ?? 1;
 }
 var SECTIONS = ["files_merged", "files_created", "dirs_created", "gitignore_entries_added", "launchd_plists_installed"];
 function parseChangeset(text2) {
@@ -269308,7 +269681,7 @@ function writeFileAtomic2(path, text2) {
   }
 }
 function resolveChangesetItem(projectDir, item) {
-  return item.startsWith("/") ? resolve9(item) : resolve9(projectDir, item);
+  return item.startsWith("/") ? resolve10(item) : resolve10(projectDir, item);
 }
 var HELP3 = `Usage: roll offboard [--confirm]
   Preview (default) or apply (--confirm) the removal of every
@@ -269329,7 +269702,7 @@ function offboardCommand(args) {
   }
   let projectDir;
   try {
-    projectDir = realpathSync14(resolve9(process.cwd()));
+    projectDir = realpathSync14(resolve10(process.cwd()));
   } catch {
     projectDir = process.cwd();
   }
@@ -271799,7 +272172,7 @@ ${c("dim", "\u2192 Running the golden-path showcase (real models; its verdict do
 // packages/cli/dist/commands/setup.js
 init_dist();
 init_render();
-import { spawnSync as spawnSync17 } from "node:child_process";
+import { spawnSync as spawnSync16 } from "node:child_process";
 import { existsSync as existsSync107, lstatSync as lstatSync6, mkdirSync as mkdirSync52, readFileSync as readFileSync101, readdirSync as readdirSync42, readlinkSync as readlinkSync3, statSync as statSync36 } from "node:fs";
 import { join as join111 } from "node:path";
 function err13(line) {
@@ -271906,13 +272279,13 @@ function runSetupStep(watch, fn) {
   return before === after ? "unchanged" : "changed";
 }
 function ensureHooksPath(repoPath) {
-  const inRepo = spawnSync17("git", ["-C", repoPath, "rev-parse", "--git-dir"], { stdio: "ignore" }).status === 0;
+  const inRepo = spawnSync16("git", ["-C", repoPath, "rev-parse", "--git-dir"], { stdio: "ignore" }).status === 0;
   if (!inRepo)
     return;
-  const cur = spawnSync17("git", ["-C", repoPath, "config", "core.hooksPath"], { encoding: "utf8" });
+  const cur = spawnSync16("git", ["-C", repoPath, "config", "core.hooksPath"], { encoding: "utf8" });
   const current = cur.status === 0 ? (cur.stdout ?? "").trim() : "";
   if (current === "" || current === ".git/hooks") {
-    spawnSync17("git", ["-C", repoPath, "config", "core.hooksPath", "hooks"], { stdio: "ignore" });
+    spawnSync16("git", ["-C", repoPath, "config", "core.hooksPath", "hooks"], { stdio: "ignore" });
   }
 }
 function peerEnsureStateDir() {
@@ -271935,7 +272308,7 @@ function submoduleGuard() {
     empty = true;
   }
   if (hasGit && hasMods && empty) {
-    spawnSync17("git", ["submodule", "update", "--init", "--recursive", "--quiet"], {
+    spawnSync16("git", ["submodule", "update", "--init", "--recursive", "--quiet"], {
       cwd: pkg,
       stdio: "ignore"
     });
@@ -272116,9 +272489,9 @@ function setupCommand(args) {
 init_showcase2();
 
 // packages/cli/dist/commands/test.js
-import { spawnSync as spawnSync18 } from "node:child_process";
-import { appendFileSync as appendFileSync19, existsSync as existsSync108, mkdirSync as mkdirSync53, readFileSync as readFileSync102, rmSync as rmSync19, writeFileSync as writeFileSync56 } from "node:fs";
-import { dirname as dirname50, join as join112, resolve as resolve10 } from "node:path";
+import { spawnSync as spawnSync17 } from "node:child_process";
+import { appendFileSync as appendFileSync20, existsSync as existsSync108, mkdirSync as mkdirSync53, readFileSync as readFileSync102, rmSync as rmSync19, writeFileSync as writeFileSync56 } from "node:fs";
+import { dirname as dirname50, join as join112, resolve as resolve11 } from "node:path";
 function pal7() {
   const noColor2 = (process.env["NO_COLOR"] ?? "") !== "";
   return noColor2 ? { CYAN: "", GREEN: "", YELLOW: "", RED: "", NC: "" } : { CYAN: "\x1B[0;36m", GREEN: "\x1B[0;32m", YELLOW: "\x1B[0;33m", RED: "\x1B[0;31m", NC: "\x1B[0m" };
@@ -272138,7 +272511,7 @@ function currentEvidenceFrame() {
   const raw = (process.env["ROLL_RUN_DIR"] ?? "").trim();
   if (raw === "")
     return null;
-  const runDir = resolve10(raw);
+  const runDir = resolve11(raw);
   if (!existsSync108(runDir))
     return null;
   const frame = {
@@ -272175,7 +272548,7 @@ function appendRollTestEvidence(frame, cmd, argv, status2, stdout, stderr) {
   try {
     const ts2 = (/* @__PURE__ */ new Date()).toISOString();
     const command = [cmd, ...argv];
-    appendFileSync19(join112(frame.evidenceDir, "roll-test-output.log"), [
+    appendFileSync20(join112(frame.evidenceDir, "roll-test-output.log"), [
       `===== roll test ${ts2} exit=${status2} =====`,
       `$ ${command.join(" ")}`,
       "--- stdout ---",
@@ -272184,7 +272557,7 @@ function appendRollTestEvidence(frame, cmd, argv, status2, stdout, stderr) {
       stderr,
       ""
     ].join("\n"), "utf8");
-    appendFileSync19(join112(frame.evidenceDir, "roll-test-summary.txt"), JSON.stringify({
+    appendFileSync20(join112(frame.evidenceDir, "roll-test-summary.txt"), JSON.stringify({
       ts: ts2,
       command,
       exitCode: status2,
@@ -272264,7 +272637,7 @@ function resetReleaseLock() {
 }
 function runForward(cmd, argv) {
   const frame = currentEvidenceFrame();
-  const r = spawnSync18(cmd, argv, { encoding: "utf8", env: childEnvForEvidence(frame) });
+  const r = spawnSync17(cmd, argv, { encoding: "utf8", env: childEnvForEvidence(frame) });
   const stdout = typeof r.stdout === "string" ? r.stdout : "";
   const stderr = typeof r.stderr === "string" ? r.stderr : "";
   const status2 = r.status ?? 1;
@@ -272282,7 +272655,7 @@ function ensureSkillsSubmoduleReady() {
   if (existsSync108(required2))
     return true;
   if (existsSync108(join112(pkg, ".git")) && existsSync108(join112(pkg, ".gitmodules"))) {
-    spawnSync18("git", ["submodule", "update", "--init", "--recursive", "--quiet", "skills"], {
+    spawnSync17("git", ["submodule", "update", "--init", "--recursive", "--quiet", "skills"], {
       cwd: pkg,
       stdio: "ignore"
     });
@@ -272788,7 +273161,7 @@ function tuneCommand(argv) {
 
 // packages/cli/dist/commands/update.js
 init_dist();
-import { spawnSync as spawnSync19 } from "node:child_process";
+import { spawnSync as spawnSync18 } from "node:child_process";
 import { existsSync as existsSync111, mkdtempSync as mkdtempSync9, readFileSync as readFileSync105, rmSync as rmSync20 } from "node:fs";
 import { tmpdir as tmpdir11 } from "node:os";
 import { join as join116 } from "node:path";
@@ -272829,7 +273202,7 @@ function m6(key, ...args) {
   return t(v2Catalog, msgLang10(), key, ...args);
 }
 function runForward2(cmd, argv) {
-  const r = spawnSync19(cmd, argv, { encoding: "utf8" });
+  const r = spawnSync18(cmd, argv, { encoding: "utf8" });
   if (typeof r.stdout === "string" && r.stdout !== "")
     process.stdout.write(r.stdout);
   if (typeof r.stderr === "string" && r.stderr !== "")
@@ -272840,7 +273213,7 @@ function resolveRemoteVersion() {
   const pinned = process.env["ROLL_VERSION"];
   if (pinned !== void 0 && pinned !== "")
     return pinned;
-  const r = spawnSync19("curl", ["-fsSL", "-H", "Accept: application/vnd.github+json", "https://api.github.com/repos/seanyao/roll/releases/latest"], { encoding: "utf8" });
+  const r = spawnSync18("curl", ["-fsSL", "-H", "Accept: application/vnd.github+json", "https://api.github.com/repos/seanyao/roll/releases/latest"], { encoding: "utf8" });
   let latest = "";
   if (r.status === 0 && typeof r.stdout === "string") {
     const mm = /"tag_name"\s*:\s*"([^"]*)"/.exec(r.stdout);
@@ -272865,7 +273238,7 @@ function downloadAndInstallCurl(tag) {
     }
     info5("[roll] Extracting ...");
     const extractDir = join116(tmpDir, "extract");
-    spawnSync19("mkdir", ["-p", extractDir], { stdio: "ignore" });
+    spawnSync18("mkdir", ["-p", extractDir], { stdio: "ignore" });
     const ex = runForward2("tar", [
       "-xzf",
       join116(tmpDir, "roll.tar.gz"),
@@ -272883,16 +273256,16 @@ function downloadAndInstallCurl(tag) {
   }
 }
 function checkInstalledVersionOrRetry() {
-  const expected = (spawnSync19("npm", ["view", "@seanyao/roll", "version"], { encoding: "utf8" }).stdout ?? "").trim();
-  const pkgRoot = (spawnSync19("npm", ["root", "-g"], { encoding: "utf8" }).stdout ?? "").trim();
+  const expected = (spawnSync18("npm", ["view", "@seanyao/roll", "version"], { encoding: "utf8" }).stdout ?? "").trim();
+  const pkgRoot = (spawnSync18("npm", ["root", "-g"], { encoding: "utf8" }).stdout ?? "").trim();
   const installedTree = join116(pkgRoot, "@seanyao", "roll");
   const installed = treeVersion(installedTree);
   if (expected === "" || installed === "")
     return;
   if (installed !== expected) {
     warn5(m6("update.version_mismatch", installed, expected));
-    spawnSync19("npm", ["cache", "clean", "--force"], { stdio: "ignore" });
-    spawnSync19("npm", ["install", "-g", "@seanyao/roll@latest"], { stdio: "ignore" });
+    spawnSync18("npm", ["cache", "clean", "--force"], { stdio: "ignore" });
+    spawnSync18("npm", ["install", "-g", "@seanyao/roll@latest"], { stdio: "ignore" });
     const after = treeVersion(installedTree);
     if (after !== "" && after !== expected)
       warn5(m6("update.still_mismatch", after));
@@ -273102,7 +273475,7 @@ function registerAll() {
   });
   registerPorted("init", initCommand, { help: "Usage: roll init [--auto|--repair|--apply]\n  Diagnose this project and route to scaffold, PRD design, existing-codebase onboard, repair, migration, or roll status.\n  --auto: apply deterministic fresh-project scaffolding in non-interactive runs.\n  --repair: repair partial Roll markers only.\n  --apply: validate and apply a reviewed existing-codebase onboard plan.\n\u8BCA\u65AD\u9879\u76EE\u5E76\u8DEF\u7531\u5230\u9AA8\u67B6\u3001PRD \u8BBE\u8BA1\u3001\u5DF2\u6709\u4EE3\u7801\u5E93\u63A5\u5165\u3001\u4FEE\u590D\u3001\u8FC1\u79FB\u6216 roll status\u3002\n  --apply\uFF1A\u6821\u9A8C\u5E76\u5E94\u7528\u5DF2\u5BA1\u9605\u7684\u5DF2\u6709\u4EE3\u7801\u5E93\u63A5\u5165\u8BA1\u5212\u3002" });
   registerPorted("next", nextCommand, { help: NEXT_USAGE });
-  registerPorted("design", designCommand, { help: 'Usage: roll design [--from-file <path> | "<requirement>"] [--agent <name>] [--verbose|--raw]\n  Launch $roll-design interactively; --from-file binds a PRD/brief; quoted text binds a free-text requirement; --raw dumps the full transcript.\n\u4EA4\u4E92\u5F0F\u542F\u52A8 $roll-design\uFF1B--from-file \u7ED1\u5B9A PRD/brief\uFF1B\u5F15\u53F7\u6587\u672C\u7ED1\u5B9A\u81EA\u7531\u6587\u672C\u9700\u6C42\uFF1B--raw \u8F93\u51FA\u5B8C\u6574\u539F\u59CB\u8BB0\u5F55\u3002' });
+  registerPorted("design", designCommand, { help: 'Usage: roll design [--from-file <path> | "<requirement>"] [--agent <name>] [--verbose|--raw]\n  Launch $roll-design interactively with bounded live progress, card-created events, quiet heartbeats, and final handoff; --verbose streams lower-priority normalized activity; --raw streams raw child output live.\n\u4EA4\u4E92\u5F0F\u542F\u52A8 $roll-design\uFF1B\u9ED8\u8BA4\u5B9E\u65F6\u663E\u793A\u6709\u754C\u8FDB\u5C55\u3001\u5EFA\u5361\u4E8B\u4EF6\u3001\u9759\u9ED8\u5FC3\u8DF3\u548C\u6700\u7EC8\u4EA4\u4ED8\uFF1B--verbose \u663E\u793A\u66F4\u591A\u89C4\u8303\u5316\u6D3B\u52A8\uFF1B--raw \u5B9E\u65F6\u8F93\u51FA\u539F\u59CB\u6D41\u3002' });
   registerPorted("offboard", removedTopLevel("offboard"));
   registerPorted("setup", (args) => {
     if (args[0] === "skills") {
@@ -273114,7 +273487,7 @@ function registerAll() {
     if (args[0] === "offboard")
       return offboardCommand(args.slice(1));
     return setupCommand(args);
-  }, { help: "Usage: roll setup [skills|offboard]\n  Install roll conventions/templates for this machine, or remove recorded Roll artifacts.\n\u672C\u673A\u5B89\u88C5\u6A21\u677F\uFF0C\u6216\u79FB\u9664\u8BB0\u5F55\u8FC7\u7684 Roll \u4EA7\u7269\u3002" });
+  }, { help: "Usage: roll setup [-f|--force] [--reselect]\n       roll setup skills [args...]\n       roll setup offboard [args...]\n  Install or re-sync Roll conventions/templates for this machine; use -f to force refresh.\n\u672C\u673A\u5B89\u88C5\u6216\u91CD\u65B0\u540C\u6B65 Roll \u6A21\u677F\u4E0E\u7EA6\u5B9A\uFF1B-f \u5F3A\u5236\u5237\u65B0\u3002" });
   registerPorted("ci", (args) => {
     if (args.includes("--wait"))
       return ciWaitCommand(args);