@wrongstack/cli 0.296.4 → 0.298.0

package/dist/hq-server/ws.d.ts

@@ -3,10 +3,69 @@
  *
  * @module hq-server/ws
  */
-import type { HqCommandAuditLog, HqEventEnvelope, HqPersistence, HqRedactionPolicy, HqToken, HqTranscriptEntry } from '@wrongstack/core/hq';
+import type { HqClientResumeMessage, HqCommandAuditLog, HqEventEnvelope, HqPeerRehydrateReason, HqPersistence, HqRedactionPolicy, HqToken, HqTranscriptEntry } from '@wrongstack/core/hq';
 import { WebSocket } from 'ws';
 import type { ConnectedClient, HqSnapshotBroadcaster, TranscriptRing } from './types.js';
-export declare function handleBrowser(ws: WebSocket, snapshotBroadcaster: HqSnapshotBroadcaster, browsers: Set<WebSocket>): void;
+/**
+ * Detect leader loss and emit the appropriate envelope. Currently wired
+ * on `client.closed` (graceful close) and the two heartbeat-timeout sites
+ * in `hq-server.ts`. An `auth-revoked` call site is a planned follow-up;
+ * the `reason` parameter already accepts it.
+ *
+ * Returns `true` when a leader-loss event was actually emitted. Note:
+ * the dedup gate (`PEER_DEDUP_WINDOW_MS`) suppresses re-emit for the same
+ * `(projectId, previousLeaderHandle)` and is intentionally NOT considered
+ * a "not the leader" outcome — the lost client is still the leader; the
+ * function returns `false` purely because there is nothing new to broadcast.
+ * Callers that need to log the loss should consult `lostClient.isLeader`
+ * separately.
+ *
+ * Dedup: a `peer.rehydrate` for the same `(projectId, previousLeaderHandle)`
+ * is suppressed if one was emitted within `PEER_DEDUP_WINDOW_MS` (1 h).
+ * `peer.lost` is not deduped — a project losing its last surviving client
+ * is significant enough to emit every time the topology changes.
+ */
+export declare function detectLeaderLoss(lostClient: ConnectedClient, clients: Map<WebSocket, ConnectedClient>, browsers: Set<WebSocket>, reason: HqPeerRehydrateReason, eventSink?: {
+    eventLog: HqEventEnvelope[];
+    persistence?: HqPersistence | undefined;
+}): boolean;
+/**
+ * Server-side fanout of a `hq.kanban_snapshot` envelope after a merge.
+ *
+ * C2 — broadcasts the post-merge `delta` payload to:
+ *  - every client whose `projectId` matches `projectId`, and
+ *  - every browser in `browsers` (browsers are not project-scoped at the
+ *    WS level; the browser-side projection filters by project when it
+ *    applies the snapshot).
+ *
+ * The `delta` payload is the same touched-only payload the merge handler
+ * builds (full-set broadcasts drive V8 heap exhaustion on long-lived
+ * boards — see the merge handler's comment).
+ *
+ * Exported for direct unit testing in `tests/hq-kanban-fanout.test.ts`.
+ */
+export declare function fanoutKanbanDelta(message: string, clients: Map<WebSocket, ConnectedClient>, browsers: Set<WebSocket>, projectId: string): {
+    clientsNotified: number;
+    browsersNotified: number;
+};
+/**
+ * Server-side handler for `client.resume` frames.
+ *
+ * Wired from `handleClient` (line 511) when the client frame type is
+ * `client.resume`. The handler:
+ *  - Validates identity (clientId/projectId match against the WS).
+ *  - Updates `client.lastSeenAt`.
+ *  - Computes the cursor (what the client has received).
+ *  - Filters `eventLog` for envelopes with `clientId === client.clientId && env.seq > cursor`.
+ *  - Checks the log cannot serve the gap (log_unavailable).
+ *  - Checks the gap is fresh (last_seen_too_old).
+ *  - Checks the gap is not too large (gap_too_large).
+ *  - Sends `hq.resume_gap` on success.
+ *
+ * Exported for direct unit testing in `tests/hq-resume-handler.test.ts`.
+ */
+export declare function handleClientResume(ws: WebSocket, clients: Map<WebSocket, ConnectedClient>, eventLog: HqEventEnvelope[], frame: HqClientResumeMessage, snapshotBroadcaster?: HqSnapshotBroadcaster): void;
+export declare function handleBrowser(ws: WebSocket, snapshotBroadcaster: HqSnapshotBroadcaster, browsers: Set<WebSocket>, eventLog: HqEventEnvelope[]): void;
 export declare function handleClient(ws: WebSocket, clients: Map<WebSocket, ConnectedClient>, browsers: Set<WebSocket>, eventLog: HqEventEnvelope[], auth: {
     token?: HqToken | undefined;
     getOperatorPolicy: () => Partial<HqRedactionPolicy> | undefined;

package/dist/{hq-server-6AQ3BXZA.js → hq-server-6TSAORAC.js}

@@ -15,7 +15,7 @@ import {
   readLocalSubagentTranscript,
   sanitizeApiError,
   startHqServer
-} from "./chunk-OI7GWJDS.js";
+} from "./chunk-C5GH4YBL.js";
 import "./chunk-Q5GTM25S.js";
 import "./chunk-7OCVIDC7.js";
 export {
@@ -36,4 +36,4 @@ export {
   sanitizeApiError,
   startHqServer
 };
-//# sourceMappingURL=hq-server-6AQ3BXZA.js.map
+//# sourceMappingURL=hq-server-6TSAORAC.js.map

package/dist/hq-server.d.ts

@@ -39,6 +39,16 @@ export interface HqServerOptions {
     allowInsecureOpen?: boolean;
     secureCookies?: boolean;
     requireBrowserAuth?: boolean;
+    /**
+     * Trust `Origin: file://` on the HTTP and WebSocket surfaces, for serving the
+     * HQ dashboard from a local file in air-gapped use. Default false.
+     *
+     * Off by default because the Host check does not contain a `file:` page — it
+     * can aim at the real HQ authority — so trusting it unconditionally let any
+     * locally-opened HTML file clear HQ's only cross-origin control (WS-081).
+     * Enable only when you actually serve the dashboard that way.
+     */
+    allowFileOrigin?: boolean;
     /**
      * Optional time-to-live (milliseconds) stamped on the first-run browser
      * and client tokens minted on a brand-new HQ data directory. Existing

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   makePromptDelegate,
   renderAgentsTemplate,
   renderDiff
-} from "./chunk-IHBYBYGA.js";
+} from "./chunk-A6Q5KGLV.js";
 import {
   theme
 } from "./chunk-QD544J2B.js";
@@ -16,21 +16,21 @@ import {
 import {
   helpCmd,
   versionCmd
-} from "./chunk-ABXK4VVY.js";
+} from "./chunk-ARWGQUB3.js";
 import {
   discoverAndMergeProviders
 } from "./chunk-TGDHN4LM.js";
 import {
   DEFAULT_PORT
-} from "./chunk-OI7GWJDS.js";
+} from "./chunk-C5GH4YBL.js";
 import "./chunk-Q5GTM25S.js";
 import {
   CLI_VERSION
 } from "./chunk-XJXDOF63.js";
 import {
   runUpdateCommand
-} from "./chunk-AXVZMEWG.js";
-import "./chunk-VJUEZZYB.js";
+} from "./chunk-I5MEUFDI.js";
+import "./chunk-U3SS4NRH.js";
 import "./chunk-F4PEGAJZ.js";
 import {
   parseArgs,
@@ -54,7 +54,7 @@ import {
 import "./chunk-7OCVIDC7.js";
 
 // src/cli-entry-point.ts
-import { writeErr } from "@wrongstack/core/utils";
+import { installCrashShield, writeErr } from "@wrongstack/core/utils";
 var SQLITE_WARNING_RE = /sqlite is an experimental feature/i;
 function installSqliteWarningFilter() {
   const originalEmit = process.emitWarning.bind(process);
@@ -91,6 +91,7 @@ function installBrokenPipeHandlers(options = {}) {
 function runAsMain(mainFn) {
   if (!isMain) return;
   installBrokenPipeHandlers();
+  installCrashShield();
   mainFn(process.argv.slice(2)).then(
     (c) => {
       process.exitCode = c;
@@ -1494,10 +1495,10 @@ function compactSingleLine(text) {
 
 // src/subcommands/index.ts
 var loaders = {
-  acp: async () => (await import("./acp-A5OSIU2P.js")).acpCmd,
+  acp: async () => (await import("./acp-S4LZQB66.js")).acpCmd,
   init: async () => (await import("./init-E2NDDOHI.js")).initCmd,
-  auth: async () => (await import("./auth-CJWQJVRH.js")).authCmd,
-  update: async () => (await import("./update-YC4TYW2Y.js")).updateCmd,
+  auth: async () => (await import("./auth-NLLGEYQR.js")).authCmd,
+  update: async () => (await import("./update-MV6TUACD.js")).updateCmd,
   sessions: async () => (await import("./sessions-config-NLCMK3BY.js")).sessionsCmd,
   config: async () => (await import("./sessions-config-NLCMK3BY.js")).configCmd,
   rewind: async () => (await import("./rewind-EJMVFVLS.js")).rewindCmd,
@@ -1514,17 +1515,18 @@ var loaders = {
   doctor: async () => (await import("./diag-doctor-OQ3AA63O.js")).doctorCmd,
   export: async () => (await import("./export-TPORYVRZ.js")).exportCmd,
   usage: async () => (await import("./plugin-usage-OU6X6LM3.js")).usageCmd,
-  version: async () => (await import("./version-help-DROHZRW6.js")).versionCmd,
-  help: async () => (await import("./version-help-DROHZRW6.js")).helpCmd,
+  version: async () => (await import("./version-help-ASKQYXDJ.js")).versionCmd,
+  help: async () => (await import("./version-help-ASKQYXDJ.js")).helpCmd,
   projects: async () => (await import("./projects-XE76NFNZ.js")).projectsCmd,
   modeldiag: async () => (await import("./modeldiag-HENYJ4N7.js")).modeldiagCmd,
   quick: async () => (await import("./quick-VIO2BEHS.js")).quickCmd,
   bench: async () => (await import("./bench-7ZDWSNEF.js")).benchCmd,
   chronicle: async () => (await import("./chronicle-QQEQFSSE.js")).chronicleCmd,
-  hq: async () => (await import("./hq-JUYKUNJX.js")).hqCmd,
-  mailbox: async () => (await import("./mailbox-serve-2UWHEN3M.js")).mailboxServeCmd,
+  hq: async () => (await import("./hq-WO6CLUSI.js")).hqCmd,
+  mailbox: async () => (await import("./mailbox-serve-DBOOOOWZ.js")).mailboxServeCmd,
   permissions: async () => (await import("./permissions-FNYLZIL4.js")).permissionsCmd,
-  project: async () => (await import("./project-BLQ3ALVL.js")).projectCmd
+  project: async () => (await import("./project-BLQ3ALVL.js")).projectCmd,
+  governance: async () => (await import("./governance-V2Z42RBE.js")).governanceCmd
 };
 var subcommands = Object.fromEntries(
   Object.entries(loaders).map(([name, load]) => [
@@ -2157,7 +2159,7 @@ async function isPortInUse(host, port) {
 }
 async function handleHqShortCircuit(flags) {
   if (flags["hq"] !== true) return null;
-  const { startHqServer } = await import("./hq-server-6AQ3BXZA.js");
+  const { startHqServer } = await import("./hq-server-6TSAORAC.js");
   const tunnelRequested = flags["tunnel"] === true;
   const host = typeof flags["host"] === "string" ? flags["host"] : tunnelRequested ? "127.0.0.1" : HQ_CLI_DEFAULT_HOST;
   if (tunnelRequested && !isLoopbackHost(host)) {
@@ -2316,9 +2318,122 @@ ${color8.green("Cloudflare Quick Tunnel ready:")} ${browserUrl}
 }
 
 // src/boot/launch-menu.ts
-import { atomicWrite as atomicWrite3, color as color9, isStdinTTY as isStdinTTY2 } from "@wrongstack/core/utils";
-import { HQ_CLI_DEFAULT_HOST as HQ_CLI_DEFAULT_HOST2 } from "@wrongstack/core/hq";
 import * as fs8 from "node:fs/promises";
+import { HQ_CLI_DEFAULT_HOST as HQ_CLI_DEFAULT_HOST2 } from "@wrongstack/core/hq";
+import { atomicWrite as atomicWrite3, color as color9, isStdinTTY as isStdinTTY2, setRawMode as setRawMode2 } from "@wrongstack/core/utils";
+
+// src/boot/launch-banner.ts
+var STACK_ORANGE = { r: 253, g: 159, b: 2 };
+var SIGNAL_PINK = { r: 254, g: 46, b: 95 };
+function mixRgb(a, b, t) {
+  const clamped = Math.min(1, Math.max(0, t));
+  return {
+    r: Math.round(a.r + (b.r - a.r) * clamped),
+    g: Math.round(a.g + (b.g - a.g) * clamped),
+    b: Math.round(a.b + (b.b - a.b) * clamped)
+  };
+}
+function fg(c) {
+  return `\x1B[38;2;${c.r};${c.g};${c.b}m`;
+}
+function colorsEnabled() {
+  const flag = (value) => value !== void 0 && value.trim() !== "" && !/^(0|false|no|off)$/i.test(value.trim());
+  if (flag(process.env.NO_COLOR)) return false;
+  if (flag(process.env.FORCE_COLOR)) return true;
+  return process.stdout.isTTY === true;
+}
+var WORDMARK_GLYPH_BITS = Object.freeze({
+  W: Object.freeze(["10001", "10001", "10001", "10101", "10101", "10101", "01010"]),
+  R: Object.freeze(["11110", "10001", "10001", "11110", "10100", "10010", "10001"]),
+  O: Object.freeze(["01110", "10001", "10001", "10001", "10001", "10001", "01110"]),
+  N: Object.freeze(["10001", "11001", "11001", "10101", "10011", "10011", "10001"]),
+  G: Object.freeze(["01110", "10001", "10000", "10111", "10001", "10001", "01110"]),
+  S: Object.freeze(["01111", "10000", "10000", "01110", "00001", "00001", "11110"]),
+  T: Object.freeze(["11111", "00100", "00100", "00100", "00100", "00100", "00100"]),
+  A: Object.freeze(["01110", "10001", "10001", "11111", "10001", "10001", "10001"]),
+  C: Object.freeze(["01111", "10000", "10000", "10000", "10000", "10000", "01111"]),
+  K: Object.freeze(["10001", "10010", "10100", "11000", "10100", "10010", "10001"])
+});
+var WORDMARK = "WRONGSTACK";
+var WORDMARK_PIXEL_ROWS = 7;
+var WORDMARK_ROWS = Math.ceil(WORDMARK_PIXEL_ROWS / 2);
+var GLYPH_WIDTH = 5;
+var WORDMARK_WIDTH = WORDMARK.length * GLYPH_WIDTH + WORDMARK.length - 1;
+function packedCell(top, bottom) {
+  if (top === "1" && bottom === "1") return "\u2588";
+  if (top === "1") return "\u2580";
+  if (bottom === "1") return "\u2584";
+  return " ";
+}
+function packedGlyphRow(glyph, row) {
+  const top = glyph[row * 2] ?? "";
+  const bottom = glyph[row * 2 + 1] ?? "";
+  return Array.from(
+    { length: GLYPH_WIDTH },
+    (_, column) => packedCell(top[column], bottom[column])
+  ).join("");
+}
+var WORDMARK_LINES = Object.freeze(
+  Array.from(
+    { length: WORDMARK_ROWS },
+    (_, row) => [...WORDMARK].map((letter) => {
+      const glyph = WORDMARK_GLYPH_BITS[letter];
+      return glyph ? packedGlyphRow(glyph, row) : " ".repeat(GLYPH_WIDTH);
+    }).join(" ")
+  )
+);
+function gradientLine(text, colorOn) {
+  if (!colorOn) return text;
+  const length = text.length;
+  let out = "\x1B[1m";
+  for (let i = 0; i < length; i++) {
+    const ch = text[i];
+    if (ch === " ") {
+      out += ch;
+      continue;
+    }
+    const t = length > 1 ? i / (length - 1) : 0.5;
+    out += `${fg(mixRgb(STACK_ORANGE, SIGNAL_PINK, t))}${ch}`;
+  }
+  return `${out}\x1B[0m`;
+}
+function dimLine(text, colorOn) {
+  return colorOn ? `\x1B[2m${text}\x1B[22m` : text;
+}
+var MARK_COLS = 5;
+var PINK_HOME = 1;
+var MARK_WIDTH = MARK_COLS * 2 + (MARK_COLS - 1);
+function buildMarkLines(colorOn) {
+  const orange = colorOn ? fg(STACK_ORANGE) : "";
+  const pink = colorOn ? fg(SIGNAL_PINK) : "";
+  const reset = colorOn ? "\x1B[0m" : "";
+  return Array.from({ length: 3 }, (_, row) => {
+    const cells = Array.from({ length: MARK_COLS }, (_2, column) => {
+      if (column === PINK_HOME && (row === 1 || row === 2)) return `${pink}\u2588\u2588${reset}`;
+      if (row < 2 && column !== PINK_HOME) return `${orange}\u2588\u2588${reset}`;
+      return "  ";
+    });
+    return cells.join(" ").trimEnd();
+  });
+}
+function launchBannerLines(columns, version) {
+  const colorOn = colorsEnabled();
+  const tagline = version ? `v${version} \xB7 the wrong stack for all the right reasons` : "the wrong stack for all the right reasons";
+  if (columns < WORDMARK_WIDTH + 4) {
+    const compact = "\u2590\u2588\u258C W R O N G S T A C K";
+    return [gradientLine(compact, colorOn), dimLine(tagline, colorOn)];
+  }
+  const markPad = " ".repeat(Math.max(0, Math.floor((WORDMARK_WIDTH - MARK_WIDTH) / 2)));
+  const tagPad = " ".repeat(Math.max(0, Math.floor((WORDMARK_WIDTH - tagline.length) / 2)));
+  return [
+    ...buildMarkLines(colorOn).map((line) => markPad + line),
+    "",
+    ...WORDMARK_LINES.map((line) => gradientLine(line, colorOn)),
+    tagPad + dimLine(tagline, colorOn)
+  ];
+}
+
+// src/boot/launch-menu.ts
 var DEFAULT_PORTS = {
   webui: 3456,
   simpleui: 3466,
@@ -2330,10 +2445,34 @@ function defaultHostFor(mode) {
   return mode === "hq" ? HQ_DEFAULT_HOST : DEFAULT_HOST;
 }
 var MODE_OPTIONS = [
-  { key: 1, mode: "tui-repl", label: "TUI / REPL", hint: "interactive terminal (default)", icon: "\u2328" },
-  { key: 2, mode: "webui", label: "WebUI", hint: `browser-based project UI (port ${DEFAULT_PORTS.webui})`, icon: "\u{1F310}" },
-  { key: 3, mode: "simpleui", label: "SimpleUI", hint: `lightweight browser UI (port ${DEFAULT_PORTS.simpleui})`, icon: "\u{1F4C4}" },
-  { key: 4, mode: "hq", label: "HQ", hint: `project-independent dashboard (port ${DEFAULT_PORT})`, icon: "\u{1F4CA}" }
+  {
+    key: 1,
+    mode: "tui-repl",
+    label: "TUI / REPL",
+    hint: "interactive terminal (default)",
+    icon: "\u2328"
+  },
+  {
+    key: 2,
+    mode: "webui",
+    label: "WebUI",
+    hint: `browser-based project UI (port ${DEFAULT_PORTS.webui})`,
+    icon: "\u{1F310}"
+  },
+  {
+    key: 3,
+    mode: "simpleui",
+    label: "SimpleUI",
+    hint: `lightweight browser UI (port ${DEFAULT_PORTS.simpleui})`,
+    icon: "\u{1F4C4}"
+  },
+  {
+    key: 4,
+    mode: "hq",
+    label: "HQ",
+    hint: `project-independent dashboard (port ${DEFAULT_PORT})`,
+    icon: "\u{1F4CA}"
+  }
 ];
 var MENU_TIMEOUT_MS = 8e3;
 var SUMMARY_TIMEOUT_MS = 5e3;
@@ -2365,6 +2504,7 @@ var KNOWN_SUBCOMMANDS = /* @__PURE__ */ new Set([
   "help",
   "provider",
   "project",
+  "governance",
   "session",
   "sessions",
   "replay",
@@ -2389,6 +2529,7 @@ async function runLaunchMenu(deps) {
   }
   const { renderer, reader, lastChoice } = deps;
   const ports = { ...DEFAULT_PORTS, ...deps.defaultPorts ?? {} };
+  writeBanner(renderer);
   if (lastChoice) {
     const accept = await promptSummaryGate(deps);
     if (accept === "use-last") {
@@ -2399,32 +2540,37 @@ async function runLaunchMenu(deps) {
     }
   }
   renderer.write(`
-  ${color9.bold("\u2731 WrongStack launch mode")}  ${color9.dim(`v${CLI_VERSION}`)}
-`);
-  renderer.write(`  ${color9.dim("\u2500".repeat(48))}
-`);
-  renderer.write(`  ${color9.amber("?")} Choose how to run WrongStack:
+  ${color9.amber("?")} Choose how to run WrongStack:
 
 `);
-  for (const opt of MODE_OPTIONS) {
-    renderer.write(
-      `    ${color9.bold(String(opt.key))}) ${opt.icon}  ${color9.bold(opt.label)}  ${color9.dim(opt.hint)}
+  const arrowPick = await promptModeArrow(deps);
+  let choice;
+  if (arrowPick) {
+    if (arrowPick.cancelled) {
+      return { mode: "tui-repl", cancelled: true };
+    }
+    choice = { mode: arrowPick.mode };
+  } else {
+    for (const opt of MODE_OPTIONS) {
+      renderer.write(
+        `    ${color9.bold(String(opt.key))}) ${opt.icon}  ${color9.bold(opt.label)}  ${color9.dim(opt.hint)}
 `
-    );
-  }
-  renderer.write(`
+      );
+    }
+    renderer.write(`
   ${color9.dim("\u2500".repeat(48))}
 `);
-  const answer = (await reader.readLine(
-    `  ${color9.amber("?")} Mode ${color9.dim("[1-4, q to quit]")} ${color9.dim(`(auto 1 in ${MENU_TIMEOUT_MS / 1e3}s)`)} `,
-    { timeoutMs: MENU_TIMEOUT_MS, defaultAnswer: "1" }
-  )).trim().toLowerCase();
-  if (answer === "q" || answer === "quit") {
-    renderer.write(color9.dim("  Goodbye!\n"));
-    return { mode: "tui-repl", cancelled: true };
+    const answer = (await reader.readLine(
+      `  ${color9.amber("?")} Mode ${color9.dim("[1-4, q to quit]")} ${color9.dim(`(auto 1 in ${MENU_TIMEOUT_MS / 1e3}s)`)} `,
+      { timeoutMs: MENU_TIMEOUT_MS, defaultAnswer: "1" }
+    )).trim().toLowerCase();
+    if (answer === "q" || answer === "quit") {
+      renderer.write(color9.dim("  Goodbye!\n"));
+      return { mode: "tui-repl", cancelled: true };
+    }
+    const picked = MODE_OPTIONS.find((o) => String(o.key) === answer || o.mode === answer);
+    choice = picked ? { mode: picked.mode } : { mode: "tui-repl" };
   }
-  const picked = MODE_OPTIONS.find((o) => String(o.key) === answer || o.mode === answer);
-  const choice = picked ? { mode: picked.mode } : { mode: "tui-repl" };
   if (choice.mode !== "tui-repl") {
     const port = await promptPort(deps, ports[choice.mode]);
     choice.port = port;
@@ -2434,6 +2580,155 @@ async function runLaunchMenu(deps) {
   }
   return finalize(choice, ports);
 }
+function writeBanner(renderer) {
+  const columns = process.stdout.columns ?? 80;
+  renderer.write("\n");
+  for (const line of launchBannerLines(columns, CLI_VERSION)) {
+    renderer.write(`  ${line}
+`);
+  }
+}
+function canUseArrowMenu() {
+  if (process.env.VITEST || process.env.NODE_ENV === "test") return false;
+  const stdin = process.stdin;
+  return isStdinTTY2() && process.stdout.isTTY === true && typeof stdin.setRawMode === "function";
+}
+async function promptModeArrow(deps) {
+  if (!canUseArrowMenu()) return null;
+  const { renderer } = deps;
+  const stdin = process.stdin;
+  const out = (s) => renderer.write(s);
+  return await new Promise((resolve2) => {
+    let index = 0;
+    let drawn = 0;
+    let remaining = Math.round(MENU_TIMEOUT_MS / 1e3);
+    let countdown = true;
+    let settled = false;
+    let interval;
+    const wasRaw = stdin.isRaw === true;
+    const wasPaused = stdin.isPaused();
+    const rows = () => {
+      const lines = [];
+      for (let i = 0; i < MODE_OPTIONS.length; i++) {
+        const opt = MODE_OPTIONS[i];
+        const selected = i === index;
+        const pointer = selected ? color9.pink("\u276F") : " ";
+        const label = selected ? color9.amber(color9.bold(opt.label)) : color9.bold(opt.label);
+        lines.push(
+          `  ${pointer} ${color9.dim(String(opt.key))} ${opt.icon}  ${label}  ${color9.dim(opt.hint)}`
+        );
+      }
+      lines.push("");
+      const auto = countdown ? color9.dim(` \xB7 auto-launches ${MODE_OPTIONS[index].label} in ${remaining}s`) : "";
+      lines.push(`  ${color9.dim("\u2191\u2193 move \xB7 Enter launch \xB7 1-4 jump \xB7 q quit")}${auto}`);
+      return lines;
+    };
+    const paint = () => {
+      const lines = rows();
+      let frame = drawn > 0 ? `\x1B[${drawn}A` : "";
+      frame += `${lines.map((line) => `\x1B[2K${line}`).join("\n")}
+`;
+      out(frame);
+      drawn = lines.length;
+    };
+    const stopInput = () => {
+      if (interval) {
+        clearInterval(interval);
+        interval = void 0;
+      }
+      stdin.off("data", onData);
+      stdin.off("close", onClose);
+      try {
+        setRawMode2(stdin, wasRaw);
+      } catch {
+      }
+      if (wasPaused) stdin.pause();
+    };
+    const settle = (result, finalLine) => {
+      if (settled) return;
+      settled = true;
+      stopCountdown();
+      stopInput();
+      if (drawn > 0) out(`\x1B[${drawn}A`);
+      out("\x1B[0J");
+      out(finalLine);
+      out("\x1B[?25h");
+      resolve2(result);
+    };
+    const pick = () => {
+      const opt = MODE_OPTIONS[index];
+      settle(
+        { cancelled: false, mode: opt.mode },
+        `  ${color9.green("\u2714")} ${opt.icon}  ${color9.bold(opt.label)}  ${color9.dim(opt.hint)}
+`
+      );
+    };
+    const cancel = () => {
+      settle({ cancelled: true, mode: "tui-repl" }, color9.dim("  Goodbye!\n"));
+    };
+    const stopCountdown = () => {
+      if (!countdown) return;
+      countdown = false;
+      if (interval) {
+        clearInterval(interval);
+        interval = void 0;
+      }
+    };
+    const onData = (buf) => {
+      const key = buf.toString("utf8");
+      stopCountdown();
+      if (key === "" || key === "q" || key === "Q" || key === "\x1B") {
+        cancel();
+        return;
+      }
+      if (key === "\r" || key === "\n") {
+        pick();
+        return;
+      }
+      if (key === "\x1B[A" || key === "\x1BOA" || key === "k") {
+        index = (index + MODE_OPTIONS.length - 1) % MODE_OPTIONS.length;
+        paint();
+        return;
+      }
+      if (key === "\x1B[B" || key === "\x1BOB" || key === "j") {
+        index = (index + 1) % MODE_OPTIONS.length;
+        paint();
+        return;
+      }
+      if (/^[0-9]$/.test(key)) {
+        const digit = Number.parseInt(key, 10);
+        if (digit >= 1 && digit <= MODE_OPTIONS.length) {
+          index = digit - 1;
+          pick();
+          return;
+        }
+      }
+      paint();
+    };
+    const onClose = () => {
+      settle({ cancelled: true, mode: "tui-repl" }, "");
+    };
+    try {
+      setRawMode2(stdin, true);
+      stdin.resume();
+    } catch {
+      resolve2(null);
+      return;
+    }
+    out("\x1B[?25l");
+    paint();
+    stdin.on("data", onData);
+    stdin.once("close", onClose);
+    interval = setInterval(() => {
+      remaining -= 1;
+      if (remaining <= 0) {
+        pick();
+        return;
+      }
+      paint();
+    }, 1e3);
+  });
+}
 async function promptSummaryGate(deps) {
   const { renderer, reader, lastChoice } = deps;
   if (!lastChoice) return "re-prompt";
@@ -2854,7 +3149,7 @@ async function initializeCli(argv) {
 async function main(argv) {
   const cliCtx = await initializeCli(argv);
   if (typeof cliCtx === "number") return cliCtx;
-  const { runInteractive } = await import("./cli-main-TOAWVJDY.js");
+  const { runInteractive } = await import("./cli-main-TJEU4OUY.js");
   return runInteractive(cliCtx);
 }
 

package/dist/kanban-hq-sync.d.ts

@@ -4,7 +4,19 @@ export interface KanbanHqSync {
     handleRemote(snapshot: HqKanbanSnapshotPayload): Promise<void>;
     /** Explicit refresh seam for hosts/tests; daemon events call the same path. */
     refresh(boardId?: string): void;
+    getStats(): KanbanHqSyncStats;
     stop(): void;
 }
-export declare function createKanbanHqSync(projectRoot: string, projectId?: string): KanbanHqSync;
+export interface KanbanHqSyncStats {
+    localPublishActive: boolean;
+    pendingBoardIds: number;
+    fullRescanPending: boolean;
+    remoteApplyQueued: boolean;
+    pendingRemoteBoards: number;
+    localPublishRuns: number;
+    coalescedLocalRefreshes: number;
+}
+export declare function createKanbanHqSync(projectRoot: string, projectId?: string, testHooks?: {
+    beforeLocalPublish?: (() => Promise<void>) | undefined;
+}): KanbanHqSync;
 //# sourceMappingURL=kanban-hq-sync.d.ts.map

package/dist/live-settings-input.d.ts

@@ -47,7 +47,7 @@ export interface LiveSettingsInput {
     breakerEnabled?: boolean | undefined;
     /** Auto kill/reset delay (ms) when the breaker trips. 0 = manual recovery. */
     breakerAutoKillResetMs?: number | undefined;
-    /** TUI statusline density. Defaults to detailed when unset. */
+    /** TUI statusline density. Defaults to minimum when unset. */
     statuslineMode?: 'minimum' | 'detailed' | undefined;
     /** Single word shown in the TUI rainbow working-state chip. */
     thinkingWord?: string | undefined;
@@ -65,5 +65,14 @@ export interface LiveSettingsInput {
     showModelReasoning?: boolean | undefined;
     /** Optionally show the persistent AGENT SWARM and todo mission queue panel; defaults to true at the storage layer. */
     showAgentSwarmPanel?: boolean | undefined;
+    /** Show SAGE Memory Inject blocks in tool results. Default: false. */
+    showSageMemoryInject?: boolean | undefined;
+    /**
+     * When true, the read tool includes codebase-index symbols alongside
+     * file content. Persisted as `autonomy.readAdvancedMode`.
+     */
+    readSymbols?: boolean | undefined;
+    /** Minimum relation strength for SAGE memory injection. Default: 0.85. */
+    sageMemoryInjectThreshold?: number | undefined;
 }
 //# sourceMappingURL=live-settings-input.d.ts.map