@seanyao/roll 4.702.3 → 4.702.4

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## v4.702.4 — 2026-07-02
+
+### 可见性
+- `roll design` 默认输出现在会实时显示有界进展、逐张建卡事件和静默心跳，同时继续把完整原始输出写入 transcript；`--verbose` 与 `--raw` 也改为运行中实时输出，不再等 agent 退出后回放（FIX-1071）`[legacy-onboard]`
+
 ## v4.702.3 — 2026-07-02
 
 ### 稳定性

package/README.md

@@ -201,7 +201,7 @@ with `roll loop resume` when ready.
 | `roll agent [migrate\|list\|cast]` | Agent Scope, installed-agent inventory, and role casting |
 | `roll backlog [sync\|block\|defer\|lint\|…]` | View, manage, lint, and sync pending tasks |
 | `roll config [lang\|prices\|tune\|…]` | Read/write configuration, model prices, and suggest-only tuning |
-| `roll design [--from-file <path>] [--agent <name>]` | Launch `$roll-design` interactively; detailed designs get a self-contained Design Review Page |
+| `roll design [--from-file <path>] [--agent <name>] [--verbose\|--raw]` | Launch `$roll-design` with bounded live progress, card-created events, quiet heartbeats, raw transcript capture, and a final handoff |
 | `roll doctor [skills\|tools\|language]` | Diagnose install health, skills, tools, permissions, and language drift |
 | `roll help [--lang en\|zh] [name]` | View built-in Charter / guide docs; `roll --help` prints CLI usage |
 | `roll idea "<one-sentence description>"` | Capture and classify a new backlog card |

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.",
@@ -233650,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";
@@ -233722,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",
@@ -262247,8 +262247,8 @@ 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 { 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
@@ -262635,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 [];
   }
@@ -262691,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) {
@@ -262909,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
@@ -262930,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";
@@ -263091,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;
       }
@@ -263108,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") };
 }
@@ -263488,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 {
@@ -263610,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 {
     }
@@ -263713,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 {
       }
@@ -263813,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
@@ -263862,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";
@@ -264515,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 {
@@ -264537,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 {
   }
@@ -264545,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 {
   }
@@ -265333,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 {
     }
   }
@@ -265702,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 {
     }
   };
@@ -265948,7 +266129,7 @@ ${skillBodyForSpawn}` : skillBodyForSpawn;
             stallDetector.markProgress();
             captureSink?.onChunk(d);
             try {
-              appendFileSync16(livePath, d);
+              appendFileSync17(livePath, d);
             } catch {
             }
             signalRecorder.accept(d);
@@ -267546,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 {
@@ -268120,7 +268301,7 @@ function nodePorts(opts) {
 }
 function appendAlertLine(alertsPath, message) {
   mkdirSync44(dirname43(alertsPath), { recursive: true });
-  appendFileSync16(alertsPath, `${message}
+  appendFileSync17(alertsPath, `${message}
 `, "utf8");
 }
 
@@ -268463,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 {
@@ -268487,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)) {
@@ -268513,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",
@@ -268533,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 {
@@ -268679,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 {
   }
@@ -268726,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();
@@ -268893,7 +269074,7 @@ function writeReviewerBlockedAlert(projectPath3, slug3, alertsPath, eventsPath3,
 ` : "") + `**Action**: ${fix}
 `;
   try {
-    appendFileSync18(alertsPath, `${msg6}
+    appendFileSync19(alertsPath, `${msg6}
 `, "utf8");
   } catch {
   }
@@ -269044,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 {
       }
@@ -269072,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 {
     }
@@ -269106,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 {
       }
@@ -269344,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"]);
@@ -269376,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 {
   }
@@ -269393,7 +269574,7 @@ 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 resolve10 } from "node:path";
@@ -269442,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) {
@@ -271991,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) {
@@ -272098,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() {
@@ -272127,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"
     });
@@ -272308,8 +272489,8 @@ 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 { 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"] ?? "") !== "";
@@ -272367,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 ---",
@@ -272376,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,
@@ -272456,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;
@@ -272474,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"
     });
@@ -272980,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";
@@ -273021,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 !== "")
@@ -273032,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);
@@ -273057,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"),
@@ -273075,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));
@@ -273294,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") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanyao/roll",
-  "version": "4.702.3",
+  "version": "4.702.4",
   "description": "Roll — Roll out features with AI agents",
   "packageManager": "pnpm@11.1.3",
   "scripts": {