@h-rig/cli 0.0.6-alpha.90 → 0.0.6-alpha.91

package/dist/src/commands/connect.d.ts

@@ -1,7 +0,0 @@
-import { type RunnerContext } from "../runner";
-import type { CommandOutcome } from "@rig/runtime/control-plane/runtime/types";
-export type ConnectionCommandOptions = {
-    group: "server";
-    interactiveUse?: boolean;
-};
-export declare function executeConnectionCommand(context: RunnerContext, args: string[], options: ConnectionCommandOptions): Promise<CommandOutcome>;

package/dist/src/commands/connect.js

@@ -1,419 +0,0 @@
-// @bun
-// packages/cli/src/app/drone-ui.ts
-import { ProcessTerminal, TUI, Text, Input, SelectList, matchesKey } from "@earendil-works/pi-tui";
-
-// packages/cli/src/app/theme.ts
-var RIG_PALETTE = {
-  ink: "#f2f3f6",
-  ink2: "#aeb0ba",
-  ink3: "#6c6e79",
-  ink4: "#44464f",
-  accent: "#ccff4d",
-  accentDim: "#a9d63f",
-  cyan: "#56d8ff",
-  red: "#ff5d5d",
-  yellow: "#ffd24d"
-};
-function hexToRgb(hex) {
-  const value = hex.replace("#", "");
-  return [
-    Number.parseInt(value.slice(0, 2), 16),
-    Number.parseInt(value.slice(2, 4), 16),
-    Number.parseInt(value.slice(4, 6), 16)
-  ];
-}
-function fg(hex) {
-  const [r, g, b] = hexToRgb(hex);
-  return (text) => `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
-}
-var ink = fg(RIG_PALETTE.ink);
-var ink2 = fg(RIG_PALETTE.ink2);
-var ink3 = fg(RIG_PALETTE.ink3);
-var ink4 = fg(RIG_PALETTE.ink4);
-var accent = fg(RIG_PALETTE.accent);
-var accentDim = fg(RIG_PALETTE.accentDim);
-var cyan = fg(RIG_PALETTE.cyan);
-var red = fg(RIG_PALETTE.red);
-var yellow = fg(RIG_PALETTE.yellow);
-function bold(text) {
-  return `\x1B[1m${text}\x1B[22m`;
-}
-var DRONE_ART = [
-  "  .-=-.                   .-=-.   ",
-  " ( !!! )                 ( !!! )  ",
-  "  '-=-'._               _.'-=-'   ",
-  "        '._           _.'         ",
-  "           '=$$$$$$$=.'           ",
-  "          =$$$$$$$$$$$=           ",
-  "         $$$@@@@@@@@@@$$$         ",
-  "        $$$@@        @@$$$        ",
-  "        $$@    ?     @$$$         ",
-  "        $$$@   '-'   @$$$         ",
-  "        $$$@@        @@$$$        ",
-  "         $$$@@@@@@@@@@$$$         ",
-  "          =$$$$$$$$$$$=           ",
-  "           '=$$$$$$$=.'           ",
-  "        _.'           '._         ",
-  "  .-=-.'                 '.-=-.   ",
-  " ( !!! )                 ( !!! )  ",
-  "  '-=-'                   '-=-'   "
-];
-var EYE_FRAMES = ["@", "o", "."];
-var DRONE_WIDTH = DRONE_ART[0].length;
-var DRONE_HEIGHT = DRONE_ART.length;
-var MICRO_BLADES = ["---", "\\\\\\", "|||", "///"];
-function microDroneFrame(tick) {
-  const blade = MICRO_BLADES[tick % MICRO_BLADES.length];
-  const eye = EYE_FRAMES[Math.floor(tick / 2) % EYE_FRAMES.length];
-  return `(${blade})${eye}(${blade})`;
-}
-var MICRO_DRONE_FRAMES = Array.from({ length: 12 }, (_, index) => microDroneFrame(index));
-
-// packages/cli/src/app/drone-ui.ts
-var isTty = () => Boolean(process.stdout.isTTY);
-function droneCancel(text) {
-  console.log(` ${red("\u2716")} ${ink3(text)}`);
-}
-var SELECT_THEME = {
-  selectedPrefix: (text) => accent(text),
-  selectedText: (text) => bold(ink(text)),
-  description: (text) => ink3(text),
-  scrollInfo: (text) => ink4(text),
-  noMatch: (text) => ink3(text)
-};
-async function runMiniTui(build) {
-  const terminal = new ProcessTerminal;
-  const tui = new TUI(terminal);
-  let settled = false;
-  return await new Promise((resolve) => {
-    const finish = (result) => {
-      if (settled)
-        return;
-      settled = true;
-      tui.stop();
-      resolve(result);
-    };
-    build(tui, finish);
-    tui.start();
-  });
-}
-async function droneSelect(input) {
-  if (!isTty() || input.options.length === 0) {
-    return input.initialValue ?? input.options[0]?.value ?? null;
-  }
-  return runMiniTui((tui, finish) => {
-    tui.addChild(new Text(` ${accent("\u258D")}${bold(ink(input.message))}`));
-    const items = input.options.map((option) => ({
-      value: option.value,
-      label: option.label,
-      ...option.hint ? { description: option.hint } : {}
-    }));
-    const list = new SelectList(items, Math.min(items.length, 12), SELECT_THEME);
-    const initialIndex = input.initialValue ? items.findIndex((item) => item.value === input.initialValue) : -1;
-    if (initialIndex > 0)
-      list.setSelectedIndex(initialIndex);
-    list.onSelect = (item) => finish(item.value);
-    list.onCancel = () => finish(null);
-    tui.addChild(list);
-    tui.addChild(new Text(ink4(" \u2191\u2193 navigate \xB7 enter select \xB7 esc cancel")));
-    tui.setFocus(list);
-    tui.addInputListener((data) => {
-      if (matchesKey(data, "ctrl+c") || matchesKey(data, "escape")) {
-        finish(null);
-        return { consume: true };
-      }
-      return;
-    });
-  });
-}
-
-// packages/cli/src/runner.ts
-import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
-import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-
-class CliError extends RuntimeCliError {
-  hint;
-  constructor(message, exitCode = 1, options = {}) {
-    super(message, exitCode);
-    if (options.hint?.trim()) {
-      this.hint = options.hint.trim();
-    }
-  }
-}
-function requireNoExtraArgs(args, usage) {
-  if (args.length > 0) {
-    throw new CliError(`Unexpected arguments: ${args.join(" ")}
-Usage: ${usage}`);
-  }
-}
-
-// packages/cli/src/commands/_connection-state.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { dirname, resolve } from "path";
-function resolveGlobalConnectionsPath(env = process.env) {
-  const explicit = env.RIG_CONNECTIONS_FILE?.trim();
-  if (explicit)
-    return resolve(explicit);
-  const stateDir = env.RIG_GLOBAL_STATE_DIR?.trim();
-  if (stateDir)
-    return resolve(stateDir, "connections.json");
-  return resolve(homedir(), ".rig", "connections.json");
-}
-function resolveRepoConnectionPath(projectRoot) {
-  return resolve(projectRoot, ".rig", "state", "connection.json");
-}
-function readJsonFile(path) {
-  if (!existsSync(path))
-    return null;
-  try {
-    return JSON.parse(readFileSync(path, "utf8"));
-  } catch (error) {
-    throw new CliError(`Invalid Rig connection state at ${path}: ${error instanceof Error ? error.message : String(error)}`, 1, { hint: "Fix or delete that file, then re-select a server with `rig server use <alias|local>`." });
-  }
-}
-function writeJsonFile(path, value) {
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, `${JSON.stringify(value, null, 2)}
-`, "utf8");
-}
-function normalizeConnection(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value))
-    return null;
-  const record = value;
-  if (record.kind === "local")
-    return { kind: "local", mode: "auto" };
-  if (record.kind === "remote" && typeof record.baseUrl === "string" && record.baseUrl.trim()) {
-    const baseUrl = record.baseUrl.trim().replace(/\/+$/, "");
-    return { kind: "remote", baseUrl };
-  }
-  return null;
-}
-function readGlobalConnections(options = {}) {
-  const path = resolveGlobalConnectionsPath(options.env ?? process.env);
-  const payload = readJsonFile(path);
-  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
-    return { connections: {} };
-  }
-  const rawConnections = payload.connections;
-  const connections = {};
-  if (rawConnections && typeof rawConnections === "object" && !Array.isArray(rawConnections)) {
-    for (const [alias, raw] of Object.entries(rawConnections)) {
-      const connection = normalizeConnection(raw);
-      if (connection)
-        connections[alias] = connection;
-    }
-  }
-  return { connections };
-}
-function writeGlobalConnections(state, options = {}) {
-  writeJsonFile(resolveGlobalConnectionsPath(options.env ?? process.env), state);
-}
-function upsertGlobalConnection(alias, connection, options = {}) {
-  const cleanAlias = alias.trim();
-  if (!cleanAlias)
-    throw new CliError("Connection alias is required.", 1, { hint: "Save a server with `rig server add <alias> <url>`." });
-  const state = readGlobalConnections(options);
-  state.connections[cleanAlias] = connection;
-  writeGlobalConnections(state, options);
-  return state;
-}
-function readRepoConnection(projectRoot) {
-  const payload = readJsonFile(resolveRepoConnectionPath(projectRoot));
-  if (!payload || typeof payload !== "object" || Array.isArray(payload))
-    return null;
-  const record = payload;
-  const selected = typeof record.selected === "string" ? record.selected.trim() : "";
-  if (!selected)
-    return null;
-  return {
-    selected,
-    project: typeof record.project === "string" ? record.project : undefined,
-    linkedAt: typeof record.linkedAt === "string" ? record.linkedAt : undefined,
-    serverProjectRoot: typeof record.serverProjectRoot === "string" && record.serverProjectRoot.trim() ? record.serverProjectRoot.trim() : undefined
-  };
-}
-function writeRepoConnection(projectRoot, state) {
-  writeJsonFile(resolveRepoConnectionPath(projectRoot), state);
-}
-
-// packages/cli/src/commands/_cli-format.ts
-import pc from "picocolors";
-var themeDim = (value) => ink3(value);
-var themeFaint = (value) => ink4(value);
-function truncate(value, width) {
-  if (value.length <= width)
-    return value;
-  if (width <= 1)
-    return "\u2026";
-  return `${value.slice(0, width - 1)}\u2026`;
-}
-function pad(value, width) {
-  return value.length >= width ? value : `${value}${" ".repeat(width - value.length)}`;
-}
-function statusColor(status) {
-  const normalized = status.toLowerCase();
-  if (["completed", "merged", "closed", "done", "accepted", "pass", "selected", "approved", "running"].includes(normalized))
-    return accent;
-  if (["failed", "needs_attention", "needs-attention", "blocked", "error", "rejected"].includes(normalized))
-    return red;
-  if (["reviewing", "validating", "in_progress", "in-progress", "remote", "preparing", "closing-out"].includes(normalized))
-    return cyan;
-  if (["ready", "open", "queued", "created", "local", "pending"].includes(normalized))
-    return yellow;
-  return themeDim;
-}
-function formatStatusPill(status) {
-  const label = status || "unknown";
-  return statusColor(label)(`\u25CF ${label}`);
-}
-function formatSection(title, subtitle) {
-  return `${pc.bold(accent("\u25C6"))} ${pc.bold(title)}${subtitle ? themeDim(` \u2014 ${subtitle}`) : ""}`;
-}
-function formatSuccessCard(title, rows = []) {
-  const body = rows.filter(([, value]) => value !== undefined && value !== null && String(value).length > 0).map(([key, value]) => `${themeFaint("\u2502")} ${themeDim(key.padEnd(12))} ${value}`);
-  return [formatSection(title), ...body].join(`
-`);
-}
-function formatNextSteps(steps) {
-  if (steps.length === 0)
-    return [];
-  return [pc.bold("Next"), ...steps.map((step) => `${accent("\u203A")} ${step}`)];
-}
-function formatConnectionList(connections) {
-  const rows = [["local", { kind: "local", mode: "auto" }], ...Object.entries(connections)];
-  const aliasWidth = Math.min(24, Math.max(5, ...rows.map(([alias]) => alias.length)));
-  const lines = rows.map(([alias, connection]) => [
-    pc.bold(pad(truncate(alias, aliasWidth), aliasWidth)),
-    formatStatusPill(connection.kind),
-    connection.kind === "remote" ? connection.baseUrl ?? "" : connection.mode ?? "local"
-  ].join("  "));
-  return [formatSection("Rig servers", `${rows.length} available`), `${pc.bold(pad("ALIAS", aliasWidth))}  ${pc.bold("KIND")}  ${pc.bold("TARGET")}`, ...lines, "", ...formatNextSteps(["Select one: `rig server use <alias|local>`"])].join(`
-`);
-}
-function formatConnectionStatus(selected, connections) {
-  const connection = selected === "local" ? { kind: "local", mode: "auto" } : connections[selected];
-  const target = !connection ? "not configured" : connection.kind === "remote" ? connection.baseUrl : "local";
-  return [
-    formatSection("Rig server", "selected for this repo"),
-    `${themeFaint("\u2502")} ${themeDim("selected ")} ${pc.bold(selected)}`,
-    `${themeFaint("\u2502")} ${themeDim("kind     ")} ${formatStatusPill(connection?.kind ?? "unknown")}`,
-    `${themeFaint("\u2502")} ${themeDim("target   ")} ${target ?? "not configured"}`,
-    "",
-    ...formatNextSteps(["Change: `rig server use <alias|local>`", "List saved servers: `rig server list`"])
-  ].join(`
-`);
-}
-
-// packages/cli/src/commands/connect.ts
-function usageName(options) {
-  return `rig ${options.group}`;
-}
-function parseConnection(alias, value, options) {
-  if (alias === "local" && !value)
-    return { kind: "local", mode: "auto" };
-  if (!value)
-    throw new CliError(`Missing remote server URL. Usage: ${usageName(options)} add <alias> <url>`, 1);
-  let parsed;
-  try {
-    parsed = new URL(value);
-  } catch {
-    throw new CliError(`Invalid Rig server URL: ${value}`, 1, { hint: "Pass a full http(s) URL, e.g. `rig server add prod https://rig.example.com`." });
-  }
-  if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
-    throw new CliError("Rig remote server URL must be http(s).", 1, { hint: "Use an http:// or https:// URL, e.g. `rig server add prod https://rig.example.com`." });
-  }
-  return { kind: "remote", baseUrl: parsed.toString().replace(/\/+$/, "") };
-}
-function printJsonOrText(context, payload, text) {
-  if (context.outputMode === "json") {
-    console.log(JSON.stringify(payload, null, 2));
-  } else {
-    console.log(text);
-  }
-}
-async function promptForConnectionAlias(context) {
-  const state = readGlobalConnections();
-  const repo = readRepoConnection(context.projectRoot);
-  const options = [
-    { value: "local", label: "local", hint: "Use/start a local Rig server" },
-    ...Object.entries(state.connections).map(([alias, connection]) => ({
-      value: alias,
-      label: alias,
-      hint: connection.kind === "remote" ? connection.baseUrl : "local"
-    }))
-  ].filter((option, index, all) => all.findIndex((candidate) => candidate.value === option.value) === index);
-  const answer = await droneSelect({
-    message: "Select Rig server for this repo",
-    initialValue: repo?.selected ?? "local",
-    options
-  });
-  if (answer === null) {
-    droneCancel("No server selected.");
-    throw new CliError("No server selected.", 3);
-  }
-  return String(answer);
-}
-async function executeConnectionCommand(context, args, options) {
-  const [command, ...rest] = args;
-  switch (command ?? "status") {
-    case "list": {
-      requireNoExtraArgs(rest, `${usageName(options)} list`);
-      const state = readGlobalConnections();
-      printJsonOrText(context, state, formatConnectionList(state.connections));
-      return { ok: true, group: options.group, command: "list", details: state };
-    }
-    case "add": {
-      const [alias, url, ...extra] = rest;
-      if (!alias)
-        throw new CliError(`Missing alias. Usage: ${usageName(options)} add <alias> <url>`, 1);
-      requireNoExtraArgs(extra, `${usageName(options)} add <alias> <url>`);
-      const connection = parseConnection(alias, url, options);
-      const state = upsertGlobalConnection(alias, connection);
-      printJsonOrText(context, { alias, connection }, formatSuccessCard("Rig server saved", [
-        ["alias", alias],
-        ["target", connection.kind === "remote" ? connection.baseUrl : "local"],
-        ["next", `${usageName(options)} use ${alias}`]
-      ]));
-      return { ok: true, group: options.group, command: "add", details: { alias, connection, count: Object.keys(state.connections).length } };
-    }
-    case "use": {
-      let [alias, ...extra] = rest;
-      requireNoExtraArgs(extra, `${usageName(options)} use <alias|local>`);
-      if (!alias && options.interactiveUse && context.outputMode === "text" && process.stdin.isTTY) {
-        alias = await promptForConnectionAlias(context);
-      }
-      if (!alias)
-        throw new CliError(`Missing alias. Usage: ${usageName(options)} use <alias|local>`, 1);
-      if (alias !== "local") {
-        const state = readGlobalConnections();
-        if (!state.connections[alias])
-          throw new CliError(`Unknown Rig server: ${alias}`, 1, { hint: "Run `rig server list` to see saved aliases, or save one with `rig server add <alias> <url>`." });
-      }
-      const repoState = { selected: alias, linkedAt: new Date().toISOString() };
-      writeRepoConnection(context.projectRoot, repoState);
-      printJsonOrText(context, repoState, formatSuccessCard("Rig server selected", [
-        ["selected", alias],
-        ["scope", "this repo"],
-        ["next", "rig task list"]
-      ]));
-      return { ok: true, group: options.group, command: "use", details: repoState };
-    }
-    case "status": {
-      requireNoExtraArgs(rest, `${usageName(options)} status`);
-      const repo = readRepoConnection(context.projectRoot);
-      const global = readGlobalConnections();
-      const details = { selected: repo?.selected ?? "local", repo, connections: global.connections };
-      printJsonOrText(context, details, formatConnectionStatus(details.selected, global.connections));
-      return { ok: true, group: options.group, command: "status", details };
-    }
-    default:
-      throw new CliError(`Unknown ${options.group} command: ${String(command)}
-Usage: ${usageName(options)} <list|add|use|status>`, 1);
-  }
-}
-export {
-  executeConnectionCommand
-};

package/dist/src/commands/inspector.d.ts

@@ -1,3 +0,0 @@
-import { type RunnerContext } from "../runner";
-import type { CommandOutcome } from "@rig/runtime/control-plane/runtime/types";
-export declare function executeInspector(context: RunnerContext, args: string[]): Promise<CommandOutcome>;

package/dist/src/commands/inspector.js

@@ -1,263 +0,0 @@
-// @bun
-// packages/cli/src/commands/inspector.ts
-import { iterateServerSentEvents } from "@rig/client";
-
-// packages/cli/src/runner.ts
-import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
-import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-
-class CliError extends RuntimeCliError {
-  hint;
-  constructor(message, exitCode = 1, options = {}) {
-    super(message, exitCode);
-    if (options.hint?.trim()) {
-      this.hint = options.hint.trim();
-    }
-  }
-}
-function takeFlag(args, flag) {
-  const rest = [];
-  let value = false;
-  for (const arg of args) {
-    if (arg === flag) {
-      value = true;
-      continue;
-    }
-    rest.push(arg);
-  }
-  return { value, rest };
-}
-function takeOption(args, option) {
-  const rest = [];
-  let value;
-  for (let index = 0;index < args.length; index += 1) {
-    const current = args[index];
-    if (current === option) {
-      const next = args[index + 1];
-      if (!next || next.startsWith("-")) {
-        throw new CliError(`Missing value for ${option}`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} <value>\`.` });
-      }
-      value = next;
-      index += 1;
-      continue;
-    }
-    if (current !== undefined) {
-      rest.push(current);
-    }
-  }
-  return { value, rest };
-}
-function requireNoExtraArgs(args, usage) {
-  if (args.length > 0) {
-    throw new CliError(`Unexpected arguments: ${args.join(" ")}
-Usage: ${usage}`);
-  }
-}
-
-// packages/cli/src/commands/inspector.ts
-import { ensureLocalRigServerConnection } from "@rig/runtime/local-server";
-
-// packages/cli/src/commands/_parsers.ts
-function parseRequiredPositiveInt(value, option) {
-  if (!value) {
-    throw new CliError(`Missing value for ${option}.`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} 10\`.` });
-  }
-  const parsed = Number.parseInt(value, 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new CliError(`Invalid ${option} value: ${value}`, 1, { hint: `Pass a positive integer, e.g. \`${option} 10\`.` });
-  }
-  return parsed;
-}
-
-// packages/cli/src/commands/inspector.ts
-function formatInspectorStreamLine(payload) {
-  const emittedAt = payload.emittedAt ?? new Date().toISOString();
-  const agentStatus = String(payload.agent?.status ?? "unknown");
-  const queueDepth = Number(payload.agent?.queueDepth ?? 0);
-  const activeRuns = Array.isArray(payload.snapshot?.activeRuns) ? payload.snapshot?.activeRuns.length : 0;
-  const lines = [
-    `[${emittedAt}] seq=${String(payload.sequence ?? "?")} agent=${agentStatus} queue=${queueDepth} activeRuns=${activeRuns}`
-  ];
-  const lastAssistantMessage = payload.agent?.lastAssistantMessage?.trim();
-  if (lastAssistantMessage) {
-    lines.push(`  assistant: ${lastAssistantMessage.split(`
-`)[0].slice(0, 240)}`);
-  }
-  const recentProtocol = payload.agent?.recentProtocolEvents;
-  const latestProtocol = Array.isArray(recentProtocol) && recentProtocol.length > 0 ? recentProtocol[recentProtocol.length - 1] : null;
-  if (latestProtocol?.method) {
-    lines.push(`  protocol: ${String(latestProtocol.direction ?? "recv")} ${String(latestProtocol.kind ?? "notification")} ${latestProtocol.method}`);
-  }
-  const finding = Array.isArray(payload.journal?.recentFindings) && payload.journal?.recentFindings.length > 0 ? payload.journal?.recentFindings[0] : null;
-  if (finding?.summary) {
-    lines.push(`  finding: ${String(finding.source ?? "journal")} \xB7 ${finding.summary}`);
-  }
-  const action = Array.isArray(payload.journal?.recentActions) && payload.journal?.recentActions.length > 0 ? payload.journal?.recentActions[0] : null;
-  if (action?.actionType) {
-    lines.push(`  action: ${action.actionType} (${String(action.status ?? "unknown")})${action.target ? ` -> ${action.target}` : ""}`);
-  }
-  return lines;
-}
-async function executeInspector(context, args) {
-  const [command = "stream", ...rest] = args;
-  switch (command) {
-    case "stream": {
-      let pending = rest;
-      const onceResult = takeFlag(pending, "--once");
-      pending = onceResult.rest;
-      const secondsResult = takeOption(pending, "--seconds");
-      pending = secondsResult.rest;
-      const pollMsResult = takeOption(pending, "--poll-ms");
-      pending = pollMsResult.rest;
-      requireNoExtraArgs(pending, "rig inspector stream [--once] [--seconds <n>] [--poll-ms <n>]");
-      const seconds = secondsResult.value ? parseRequiredPositiveInt(secondsResult.value, "--seconds") : null;
-      const pollMs = pollMsResult.value ? parseRequiredPositiveInt(pollMsResult.value, "--poll-ms") : null;
-      if (context.outputMode === "json" && !onceResult.value && !seconds) {
-        throw new CliError("--json inspector stream requires --once or --seconds <n>.", 2, { hint: "Re-run as `rig inspector stream --once --json` or `rig inspector stream --seconds 10 --json`." });
-      }
-      const connection = await ensureLocalRigServerConnection(context.projectRoot);
-      const streamUrl = new URL("/api/inspector/stream", connection.baseUrl);
-      if (onceResult.value) {
-        streamUrl.searchParams.set("once", "1");
-      }
-      if (pollMs) {
-        streamUrl.searchParams.set("pollMs", String(pollMs));
-      }
-      const controller = new AbortController;
-      const deadline = seconds ? setTimeout(() => controller.abort(), seconds * 1000) : null;
-      let interrupted = false;
-      const onSignal = () => {
-        interrupted = true;
-        controller.abort();
-      };
-      if (!onceResult.value) {
-        process.once("SIGINT", onSignal);
-        process.once("SIGTERM", onSignal);
-      }
-      try {
-        const response = await fetch(streamUrl, {
-          headers: connection.authToken ? { authorization: `Bearer ${connection.authToken}` } : undefined,
-          signal: controller.signal
-        });
-        if (!response.ok) {
-          throw new CliError(`Inspector stream request failed (${response.status}).`, response.status);
-        }
-        let received = 0;
-        let lastEvent = null;
-        for await (const event of iterateServerSentEvents(response)) {
-          const payload = JSON.parse(event.data);
-          lastEvent = { event: event.event, payload };
-          received += 1;
-          if (context.outputMode === "text" && event.event === "snapshot") {
-            for (const line of formatInspectorStreamLine(payload)) {
-              console.log(line);
-            }
-          } else if (context.outputMode === "text") {
-            console.log(`[inspector:${event.event}] ${event.data}`);
-          }
-          if (onceResult.value) {
-            break;
-          }
-        }
-        return {
-          ok: true,
-          group: "inspector",
-          command,
-          details: {
-            streamUrl: streamUrl.toString(),
-            received,
-            interrupted,
-            once: onceResult.value,
-            seconds,
-            lastEvent
-          }
-        };
-      } catch (error) {
-        if (controller.signal.aborted && !onceResult.value) {
-          return {
-            ok: true,
-            group: "inspector",
-            command,
-            details: {
-              streamUrl: streamUrl.toString(),
-              received: 0,
-              interrupted: true,
-              once: onceResult.value,
-              seconds,
-              lastEvent: null
-            }
-          };
-        }
-        throw error;
-      } finally {
-        if (deadline) {
-          clearTimeout(deadline);
-        }
-        if (!onceResult.value) {
-          process.off("SIGINT", onSignal);
-          process.off("SIGTERM", onSignal);
-        }
-      }
-    }
-    case "scan-upstream-drift": {
-      let pending = rest;
-      const scanIdResult = takeOption(pending, "--scan-id");
-      pending = scanIdResult.rest;
-      requireNoExtraArgs(pending, "rig inspector scan-upstream-drift [--scan-id <id>]");
-      const connection = await ensureLocalRigServerConnection(context.projectRoot);
-      const response = await fetch(new URL("/api/inspector/tools/invoke", connection.baseUrl), {
-        method: "POST",
-        headers: {
-          "content-type": "application/json",
-          ...connection.authToken ? { authorization: `Bearer ${connection.authToken}` } : {}
-        },
-        body: JSON.stringify({
-          name: "scan_upstream_drift",
-          input: scanIdResult.value ? { scanId: scanIdResult.value } : {}
-        })
-      });
-      if (!response.ok) {
-        throw new CliError(`Upstream drift scan request failed (${response.status}).`, response.status);
-      }
-      const result = await response.json();
-      if (context.outputMode === "text") {
-        console.log(String(result.summary ?? "Upstream drift scan completed"));
-        const details = result.details;
-        if (details && typeof details === "object" && !Array.isArray(details)) {
-          const record = details;
-          if (typeof record.scannedCommitCount === "number") {
-            console.log(`  scanned commits: ${record.scannedCommitCount}`);
-          }
-          if (typeof record.ignoredCommitCount === "number") {
-            console.log(`  ignored commits: ${record.ignoredCommitCount}`);
-          }
-          if (typeof record.followupCount === "number") {
-            console.log(`  follow-up tasks: ${record.followupCount}`);
-          }
-          if (Array.isArray(record.createdTaskIds) && record.createdTaskIds.length > 0) {
-            console.log(`  created tasks: ${record.createdTaskIds.join(", ")}`);
-          }
-          if (typeof record.latestHeadSha === "string" && record.latestHeadSha.length > 0) {
-            console.log(`  latest upstream head: ${record.latestHeadSha}`);
-          }
-        }
-      }
-      return {
-        ok: true,
-        group: "inspector",
-        command,
-        details: {
-          scanId: scanIdResult.value ?? null,
-          result
-        }
-      };
-    }
-    default:
-      throw new CliError(`Unknown inspector command: ${command}`, 1, { hint: "Run `rig inspector --help` \u2014 commands are stream|scan-upstream-drift." });
-  }
-}
-export {
-  executeInspector
-};