@h-rig/cli 0.0.6-alpha.78 → 0.0.6-alpha.79

package/dist/bin/build-rig-binaries.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/bin/rig.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/bin/rig.js

@@ -3217,6 +3217,7 @@ var init__help_catalog = __esm(() => {
         { command: "next [filters]", description: "Render the next matching task as a selected-task card.", primary: true },
         { command: "show <id>|--task <id> [--raw]", description: "Show a human task summary; --raw prints the full payload.", primary: true },
         { command: "run [#<issue>|<task-id>|--next|--task <id>]", description: "Submit a task run; interactive follows with bundled Pi.", primary: true },
+        { command: "ready", description: "List task IDs that are runnable now." },
         { command: "validate|verify [--task <id>]", description: "Run configured task checks/review gates." },
         { command: "details --task <id>", description: "Show full task info from the configured source." },
         { command: "reopen [--task <id> | --all] [--reason <text>]", description: "Reopen closed task(s) in the configured source." },
@@ -4011,7 +4012,7 @@ __export(exports_board, {
 import { randomUUID } from "crypto";
 import { existsSync as existsSync18 } from "fs";
 import { resolve as resolvePath } from "path";
-import { ProcessTerminal as ProcessTerminal2, TUI as TUI2, Text as Text2, matchesKey as matchesKey2, truncateToWidth } from "@earendil-works/pi-tui";
+import { ProcessTerminal as ProcessTerminal2, TUI as TUI2, Text as Text2, isKeyRelease, matchesKey as matchesKey2, truncateToWidth } from "@earendil-works/pi-tui";
 function oneLine(message2) {
   return message2.split(`
 `).map((line) => line.trim()).find((line) => line.length > 0)?.slice(0, 200) ?? "unknown error";
@@ -4463,13 +4464,13 @@ async function runOperatorBoard(context, options = {}) {
       return;
     }
     if (view === "help") {
-      footer.setText(` ${accent("\u2191\u2193")}${ink3(" scroll")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`);
+      footer.setText(` ${accent("\u2190")}${ink3(" back")}  ${accent("\u2191\u2193")}${ink3(" scroll")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`);
       return;
     }
     if (view === "tasks") {
       footer.setText([
         ` ${notice ? accentDim(notice) : ink4("pick a task \u2014 a drone launches with project defaults")}`,
-        ` ${accent("enter")}${ink3(" dispatch")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`
+        ` ${accent("\u2190")}${ink3(" back")}  ${accent("enter")}${ink3(" dispatch")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`
       ].join(`
 `));
       return;
@@ -4477,7 +4478,7 @@ async function runOperatorBoard(context, options = {}) {
     if (view === "inbox") {
       footer.setText([
         ` ${notice ? accentDim(notice) : ink4("gates the fleet is waiting on \u2014 resolve them here")}`,
-        ` ${accent("a")}${ink3(" approve")}  ${accent("d")}${ink3(" reject")}  ${accent("enter")}${ink3(" answer input")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}`
+        ` ${accent("\u2190")}${ink3(" back")}  ${accent("a")}${ink3(" approve")}  ${accent("d")}${ink3(" reject")}  ${accent("enter")}${ink3(" answer input")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}`
       ].join(`
 `));
       return;
@@ -4644,6 +4645,8 @@ async function runOperatorBoard(context, options = {}) {
     tui.requestRender();
   }).catch(() => {});
   tui.addInputListener((data) => {
+    if (isKeyRelease(data))
+      return { consume: true };
     if (inputLine) {
       if (matchesKey2(data, "escape")) {
         if (inputLine.kind === "search")
@@ -4680,7 +4683,7 @@ async function runOperatorBoard(context, options = {}) {
         helpView.scroll(-15);
       else if (matchesKey2(data, "pageDown") || data === " ")
         helpView.scroll(15);
-      else if (matchesKey2(data, "escape") || data === "?") {
+      else if (matchesKey2(data, "left") || matchesKey2(data, "escape") || data === "?") {
         setView("board");
         return { consume: true };
       }
@@ -4698,7 +4701,7 @@ async function runOperatorBoard(context, options = {}) {
           dispatchTask(task);
       } else if (data === "r")
         refreshTasks();
-      else if (matchesKey2(data, "escape"))
+      else if (matchesKey2(data, "left") || matchesKey2(data, "escape"))
         setView("board");
       tui.requestRender();
       return { consume: true };
@@ -4726,7 +4729,7 @@ async function runOperatorBoard(context, options = {}) {
         }
       } else if (data === "r")
         refreshInbox();
-      else if (matchesKey2(data, "escape"))
+      else if (matchesKey2(data, "left") || matchesKey2(data, "escape"))
         setView("board");
       tui.requestRender();
       return { consume: true };
@@ -4837,7 +4840,7 @@ async function runOperatorBoardLoop(context, attach, options = {}) {
     await attach(outcome.runId);
   }
 }
-var BOARD_REFRESH_MS = 5000, BOARD_TICK_MS = 120, BOARD_TASK_PAGE = 20;
+var BOARD_REFRESH_MS = 5000, BOARD_TICK_MS = 250, BOARD_TASK_PAGE = 20;
 var init_board = __esm(() => {
   init_theme();
   init__help_catalog();
@@ -7745,7 +7748,7 @@ async function ensurePiBinaryAvailable(input) {
     }
     return { ok: true, detail: (current.stdout || current.stderr).trim() || undefined };
   }
-  const installCommand = process.env.RIG_PI_INSTALL_COMMAND?.trim() || "bunx @earendil-works/pi@latest install";
+  const installCommand = process.env.RIG_PI_INSTALL_COMMAND?.trim() || "bunx @earendil-works/pi-coding-agent@latest install";
   const parts = splitInstallCommand(installCommand);
   if (parts.length === 0) {
     return { ok: false, error: (current.stderr || current.stdout).trim() || "pi --version failed" };
@@ -11213,6 +11216,19 @@ function looksLikeGitHubToken(value) {
     return false;
   return /^(gh[opusr]_|github_pat_)/.test(token);
 }
+function isSensitivePayloadKey(key) {
+  return /token|secret|password|authorization|credential/i.test(key);
+}
+function redactSensitivePayload(value) {
+  if (Array.isArray(value))
+    return value.map(redactSensitivePayload);
+  if (!value || typeof value !== "object")
+    return value;
+  return Object.fromEntries(Object.entries(value).map(([key, child]) => [
+    key,
+    isSensitivePayloadKey(key) && typeof child === "string" && child.trim() ? "[redacted]" : redactSensitivePayload(child)
+  ]));
+}
 function githubBridgeEnv(token) {
   const clean = token?.trim();
   if (!clean)
@@ -11903,7 +11919,7 @@ function appendPiToolTimelineFromRecord(input) {
 }
 function isNonRenderablePiProtocolRecord(record) {
   const type = typeof record.type === "string" ? record.type : "";
-  return type === "agent_start" || type === "agent_end" || type === "message_start" || type === "message_end" || type === "turn_start" || type === "turn_end" || type === "tool_result" || type === "message_update" && (!record.assistantMessageEvent || typeof record.assistantMessageEvent !== "object" || Array.isArray(record.assistantMessageEvent) || record.assistantMessageEvent.type !== "text_delta");
+  return type === "pi.event" || type === "status.update" || type === "activity.update" || type === "ready" || type === "agent_start" || type === "agent_end" || type === "message_start" || type === "message_end" || type === "turn_start" || type === "turn_end" || type === "tool_result" || type === "message_update" && (!record.assistantMessageEvent || typeof record.assistantMessageEvent !== "object" || Array.isArray(record.assistantMessageEvent) || record.assistantMessageEvent.type !== "text_delta");
 }
 function appendToolTimelineFromLog(input) {
   const title = typeof input.log.title === "string" ? input.log.title : "";
@@ -12463,7 +12479,15 @@ ${planningClassification.planningRequired ? `Before implementing, write a concis
       emitServerRunEvent({ type: "log", runId: input.runId, title });
       return true;
     }
-    return false;
+    appendRunTimeline(context.projectRoot, input.runId, {
+      id: `timeline:${input.runId}:${Date.now()}:wrapper:${event.type}`,
+      type: "wrapper-event",
+      eventType: event.type,
+      payload: redactSensitivePayload(payload),
+      createdAt: new Date().toISOString()
+    });
+    emitServerRunEvent({ type: "timeline", runId: input.runId });
+    return true;
   };
   const handleAgentStdoutLine = (line) => {
     const trimmed = line.trim();
@@ -13520,9 +13544,9 @@ async function openApp(context, options = {}) {
   const { runOperatorBoardLoop: runOperatorBoardLoop2 } = await Promise.resolve().then(() => (init_board(), exports_board));
   await runOperatorBoardLoop2(context, async (runId) => {
     const scriptArg = typeof process.argv[1] === "string" && /\.(ts|js|mjs)$/.test(process.argv[1]) ? [process.argv[1]] : [];
-    const child = Bun.spawn([process.execPath, ...scriptArg, "run", "attach", runId], {
+    const child = Bun.spawn([process.execPath, ...scriptArg, "--project", context.projectRoot, "run", "attach", runId], {
       stdio: ["inherit", "inherit", "inherit"],
-      env: process.env
+      env: { ...process.env, PROJECT_RIG_ROOT: context.projectRoot }
     });
     await child.exited;
   }, options);

package/dist/src/app/board.d.ts

@@ -0,0 +1,23 @@
+import type { RunnerContext } from "../runner";
+export type BoardOutcome = {
+    action: "quit";
+} | {
+    action: "attach";
+    runId: string;
+};
+export type RunSortMode = "active" | "recent" | "status";
+export type BoardView = "board" | "help" | "tasks" | "inbox";
+/**
+ * Run the operator board until the operator picks a run (→ attach) or
+ * quits. The caller owns the attach loop so the Pi console gets a clean
+ * terminal between board sessions.
+ */
+export declare function runOperatorBoard(context: Pick<RunnerContext, "projectRoot" | "outputMode">, options?: {
+    initialView?: BoardView;
+    helpGroup?: string;
+}): Promise<BoardOutcome>;
+/** Board ⇆ console loop: the operator lives here. */
+export declare function runOperatorBoardLoop(context: Pick<RunnerContext, "projectRoot" | "outputMode">, attach: (runId: string) => Promise<void>, options?: {
+    initialView?: BoardView;
+    helpGroup?: string;
+}): Promise<void>;

package/dist/src/app/board.js

@@ -3,7 +3,7 @@
 import { randomUUID } from "crypto";
 import { existsSync as existsSync3 } from "fs";
 import { resolve as resolvePath } from "path";
-import { ProcessTerminal as ProcessTerminal2, TUI as TUI2, Text as Text2, matchesKey as matchesKey2, truncateToWidth } from "@earendil-works/pi-tui";
+import { ProcessTerminal as ProcessTerminal2, TUI as TUI2, Text as Text2, isKeyRelease, matchesKey as matchesKey2, truncateToWidth } from "@earendil-works/pi-tui";
 
 // packages/cli/src/app/theme.ts
 var RIG_PALETTE = {
@@ -223,6 +223,7 @@ var PRIMARY_GROUPS = [
       { command: "next [filters]", description: "Render the next matching task as a selected-task card.", primary: true },
       { command: "show <id>|--task <id> [--raw]", description: "Show a human task summary; --raw prints the full payload.", primary: true },
       { command: "run [#<issue>|<task-id>|--next|--task <id>]", description: "Submit a task run; interactive follows with bundled Pi.", primary: true },
+      { command: "ready", description: "List task IDs that are runnable now." },
       { command: "validate|verify [--task <id>]", description: "Run configured task checks/review gates." },
       { command: "details --task <id>", description: "Show full task info from the configured source." },
       { command: "reopen [--task <id> | --all] [--reason <text>]", description: "Reopen closed task(s) in the configured source." },
@@ -950,7 +951,7 @@ async function loadTaskRunProjectDefaults(projectRoot) {
 
 // packages/cli/src/app/board.ts
 var BOARD_REFRESH_MS = 5000;
-var BOARD_TICK_MS = 120;
+var BOARD_TICK_MS = 250;
 var BOARD_TASK_PAGE = 20;
 function oneLine(message) {
   return message.split(`
@@ -1403,13 +1404,13 @@ async function runOperatorBoard(context, options = {}) {
       return;
     }
     if (view === "help") {
-      footer.setText(` ${accent("\u2191\u2193")}${ink3(" scroll")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`);
+      footer.setText(` ${accent("\u2190")}${ink3(" back")}  ${accent("\u2191\u2193")}${ink3(" scroll")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`);
       return;
     }
     if (view === "tasks") {
       footer.setText([
         ` ${notice ? accentDim(notice) : ink4("pick a task \u2014 a drone launches with project defaults")}`,
-        ` ${accent("enter")}${ink3(" dispatch")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`
+        ` ${accent("\u2190")}${ink3(" back")}  ${accent("enter")}${ink3(" dispatch")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}  ${accent("q")}${ink3(" quit")}`
       ].join(`
 `));
       return;
@@ -1417,7 +1418,7 @@ async function runOperatorBoard(context, options = {}) {
     if (view === "inbox") {
       footer.setText([
         ` ${notice ? accentDim(notice) : ink4("gates the fleet is waiting on \u2014 resolve them here")}`,
-        ` ${accent("a")}${ink3(" approve")}  ${accent("d")}${ink3(" reject")}  ${accent("enter")}${ink3(" answer input")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}`
+        ` ${accent("\u2190")}${ink3(" back")}  ${accent("a")}${ink3(" approve")}  ${accent("d")}${ink3(" reject")}  ${accent("enter")}${ink3(" answer input")}  ${accent("r")}${ink3(" reload")}  ${accent("esc")}${ink3(" board")}`
       ].join(`
 `));
       return;
@@ -1584,6 +1585,8 @@ async function runOperatorBoard(context, options = {}) {
     tui.requestRender();
   }).catch(() => {});
   tui.addInputListener((data) => {
+    if (isKeyRelease(data))
+      return { consume: true };
     if (inputLine) {
       if (matchesKey2(data, "escape")) {
         if (inputLine.kind === "search")
@@ -1620,7 +1623,7 @@ async function runOperatorBoard(context, options = {}) {
         helpView.scroll(-15);
       else if (matchesKey2(data, "pageDown") || data === " ")
         helpView.scroll(15);
-      else if (matchesKey2(data, "escape") || data === "?") {
+      else if (matchesKey2(data, "left") || matchesKey2(data, "escape") || data === "?") {
         setView("board");
         return { consume: true };
       }
@@ -1638,7 +1641,7 @@ async function runOperatorBoard(context, options = {}) {
           dispatchTask(task);
       } else if (data === "r")
         refreshTasks();
-      else if (matchesKey2(data, "escape"))
+      else if (matchesKey2(data, "left") || matchesKey2(data, "escape"))
         setView("board");
       tui.requestRender();
       return { consume: true };
@@ -1666,7 +1669,7 @@ async function runOperatorBoard(context, options = {}) {
         }
       } else if (data === "r")
         refreshInbox();
-      else if (matchesKey2(data, "escape"))
+      else if (matchesKey2(data, "left") || matchesKey2(data, "escape"))
         setView("board");
       tui.requestRender();
       return { consume: true };

package/dist/src/app/drone-ui.d.ts

@@ -0,0 +1,37 @@
+export declare function droneIntro(title: string, subtitle?: string): void;
+export declare function droneOutro(text: string): void;
+export declare function droneNote(message: string, title?: string): void;
+export declare function droneStep(text: string): void;
+export declare function droneInfo(text: string): void;
+export declare function droneWarn(text: string): void;
+export declare function droneError(text: string): void;
+export declare function droneCancel(text: string): void;
+/** Clack-spinner-shaped adapter over the micro-drone TTY spinner. */
+export declare function droneSpinner(): {
+    start(message: string): void;
+    stop(message?: string): void;
+    error(message?: string): void;
+};
+type DroneSelectOption<T extends string> = {
+    value: T;
+    label: string;
+    hint?: string;
+};
+/** Drone-styled select. Returns null on cancel (esc / ctrl+c / q). */
+export declare function droneSelect<T extends string>(input: {
+    readonly message: string;
+    readonly options: readonly DroneSelectOption<T>[];
+    readonly initialValue?: T;
+}): Promise<T | null>;
+/** Drone-styled text input. Returns null on cancel. */
+export declare function droneText(input: {
+    readonly message: string;
+    readonly placeholder?: string;
+    readonly initialValue?: string;
+}): Promise<string | null>;
+/** Drone-styled yes/no. Returns null on cancel. */
+export declare function droneConfirm(input: {
+    readonly message: string;
+    readonly initialValue?: boolean;
+}): Promise<boolean | null>;
+export {};

package/dist/src/app/theme.d.ts

@@ -0,0 +1,47 @@
+export declare const RIG_PALETTE: {
+    /** --ink: primary text */
+    readonly ink: "#f2f3f6";
+    /** --ink-2: body text */
+    readonly ink2: "#aeb0ba";
+    /** --ink-3: muted */
+    readonly ink3: "#6c6e79";
+    /** --ink-4: faint */
+    readonly ink4: "#44464f";
+    /** --ac: acid green accent */
+    readonly accent: "#ccff4d";
+    /** --ac-dim */
+    readonly accentDim: "#a9d63f";
+    /** --ac-2: cyan secondary */
+    readonly cyan: "#56d8ff";
+    /** status colors tuned to sit on the dark site bg */
+    readonly red: "#ff5d5d";
+    readonly yellow: "#ffd24d";
+};
+/** 24-bit foreground colorizer. */
+export declare function fg(hex: string): (text: string) => string;
+export declare const ink: (text: string) => string;
+export declare const ink2: (text: string) => string;
+export declare const ink3: (text: string) => string;
+export declare const ink4: (text: string) => string;
+export declare const accent: (text: string) => string;
+export declare const accentDim: (text: string) => string;
+export declare const cyan: (text: string) => string;
+export declare const red: (text: string) => string;
+export declare const yellow: (text: string) => string;
+export declare function bold(text: string): string;
+/** Run-status color, matching the site's pipeline color story. */
+export declare function statusColor(status: string): (text: string) => string;
+/** The braille spinner the site's hero terminal mirrors. */
+export declare const RIG_SPINNER_FRAMES: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/**
+ * Render one animation frame of the drone. `tick` drives rotor rotation and
+ * the eye pulse — call with an incrementing counter (the site advances the
+ * rotor every 4 ticks and pulses the eye on a sine).
+ */
+export declare function renderDroneFrame(tick: number): string[];
+export declare const DRONE_WIDTH: number;
+export declare const DRONE_HEIGHT: 18;
+export declare function microDroneFrame(tick: number): string;
+export declare const MICRO_DRONE_FRAMES: readonly string[];
+/** Truecolor micro-drone: cyan rotors, acid eye — site colors. */
+export declare function renderMicroDroneFrame(tick: number): string;

package/dist/src/commands/_async-ui.d.ts

@@ -0,0 +1,13 @@
+import type { OutputMode } from "@rig/runtime/control-plane/runtime/types";
+export type SpinnerOutput = Pick<NodeJS.WriteStream, "write"> & {
+    readonly isTTY?: boolean;
+};
+export type WithSpinnerOptions = {
+    /** Final line left behind on success. Default: the spinner line is erased. */
+    readonly doneLabel?: string;
+    /** Pass context.outputMode; "json" suppresses all spinner output. */
+    readonly outputMode?: OutputMode;
+    /** Stream override for tests. Defaults to process.stderr. */
+    readonly output?: SpinnerOutput;
+};
+export declare function withSpinner<T>(label: string, work: (update: (label: string) => void) => Promise<T>, options?: WithSpinnerOptions): Promise<T>;

package/dist/src/commands/_authority-runs.d.ts

@@ -0,0 +1,22 @@
+import { type AuthorityRunRecord } from "@rig/runtime/control-plane/authority-files";
+import type { RunStatus } from "@rig/contracts";
+export declare const RIG_WORKSPACE_ID = "rig-local-workspace";
+export type RuntimeAdapter = "claude-code" | "codex" | "pi";
+export declare function normalizeRuntimeAdapter(value: string | undefined): RuntimeAdapter;
+export declare function readLatestBeadRecord(projectRoot: string, taskId: string): Record<string, unknown> | null;
+export declare function upsertAgentAuthorityRun(projectRoot: string, input: {
+    runId: string;
+    taskId: string;
+    createdAt: string;
+    runtimeAdapter?: string;
+    status: RunStatus;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    worktreePath?: string | null;
+    artifactRoot?: string | null;
+    logRoot?: string | null;
+    sessionPath?: string | null;
+    sessionLogPath?: string | null;
+    pid?: number | null;
+    errorText?: string | null;
+}): AuthorityRunRecord & Record<string, unknown>;

package/dist/src/commands/_cli-format.d.ts

@@ -0,0 +1,49 @@
+export type CliTaskLike = Record<string, unknown>;
+export type CliRunLike = Record<string, unknown>;
+export declare function printFormattedOutput(message: string, options?: {
+    title?: string;
+}): void;
+export declare function formatStatusPill(status: string): string;
+export declare function formatSection(title: string, subtitle?: string): string;
+export declare function formatSuccessCard(title: string, rows?: Array<[string, string | number | null | undefined]>): string;
+export declare function formatNextSteps(steps: readonly string[]): string[];
+export declare function formatTaskList(tasks: readonly CliTaskLike[], options?: {
+    raw?: boolean;
+}): string;
+export declare function formatTaskCard(task: CliTaskLike, options?: {
+    title?: string;
+    selected?: boolean;
+}): string;
+export declare function formatTaskDetails(task: CliTaskLike): string;
+export declare function formatRunList(runs: readonly CliRunLike[], options?: {
+    source?: "local" | "server";
+}): string;
+export declare function formatSubmittedRun(input: {
+    runId: string;
+    task?: CliTaskLike | null;
+    runtimeAdapter?: string | null;
+    runtimeMode?: string | null;
+    interactionMode?: string | null;
+    detached?: boolean;
+}): string;
+export declare function formatRunCard(run: CliRunLike, options?: {
+    title?: string;
+}): string;
+export declare function formatRunStatus(summary: {
+    activeRuns?: CliRunLike[];
+    recentRuns?: CliRunLike[];
+    runs?: CliRunLike[];
+}, options?: {
+    source?: "local" | "server";
+}): string;
+export declare function formatInboxList(kind: "approvals" | "inputs", entries: readonly Record<string, unknown>[]): string;
+export declare function formatConnectionList(connections: Record<string, {
+    kind: string;
+    baseUrl?: string;
+    mode?: string;
+}>): string;
+export declare function formatConnectionStatus(selected: string, connections: Record<string, {
+    kind: string;
+    baseUrl?: string;
+    mode?: string;
+}>): string;

package/dist/src/commands/_connection-state.d.ts

@@ -0,0 +1,44 @@
+export type RigConnection = {
+    kind: "local";
+    mode: "auto";
+} | {
+    kind: "remote";
+    baseUrl: string;
+};
+export type GlobalConnectionState = {
+    connections: Record<string, RigConnection>;
+};
+export type RepoConnectionState = {
+    selected: string;
+    project?: string;
+    linkedAt?: string;
+    /**
+     * The server-host project root this repo scopes to (multi-root serving).
+     * Sent as the x-rig-project-root header on every remote request.
+     */
+    serverProjectRoot?: string;
+};
+export declare function resolveGlobalConnectionsPath(env?: NodeJS.ProcessEnv): string;
+export declare function resolveRepoConnectionPath(projectRoot: string): string;
+export declare function readGlobalConnections(options?: {
+    env?: NodeJS.ProcessEnv;
+}): GlobalConnectionState;
+export declare function writeGlobalConnections(state: GlobalConnectionState, options?: {
+    env?: NodeJS.ProcessEnv;
+}): void;
+export declare function upsertGlobalConnection(alias: string, connection: RigConnection, options?: {
+    env?: NodeJS.ProcessEnv;
+}): GlobalConnectionState;
+export declare function readRepoConnection(projectRoot: string): RepoConnectionState | null;
+export declare function writeRepoConnection(projectRoot: string, state: RepoConnectionState): void;
+export declare function resolveSelectedConnection(projectRoot: string, options?: {
+    env?: NodeJS.ProcessEnv;
+}): {
+    alias: string;
+    connection: RigConnection;
+    serverProjectRoot?: string;
+} | null;
+/** Persist the server-host project root this repo scopes to (multi-root serving). */
+export declare function writeRepoServerProjectRoot(projectRoot: string, serverProjectRoot: string): void;
+/** Whether this repo's selected connection targets a remote Rig server. */
+export declare function isRemoteConnectionSelected(projectRoot: string): boolean;

package/dist/src/commands/_doctor-checks.d.ts

@@ -0,0 +1,52 @@
+type DoctorConfig = {
+    readonly project?: Record<string, unknown>;
+    readonly taskSource?: {
+        readonly kind?: string;
+        readonly owner?: string;
+        readonly repo?: string;
+    };
+    readonly github?: {
+        readonly projects?: {
+            readonly enabled?: boolean;
+            readonly projectId?: string;
+            readonly statusFieldId?: string;
+        };
+    };
+    readonly pr?: {
+        readonly mode?: string;
+    };
+    readonly merge?: {
+        readonly mode?: string;
+        readonly method?: string;
+    };
+};
+import { type PiInstallCheck } from "./_pi-install";
+export type DoctorStatus = "pass" | "warn" | "fail";
+export type RigDoctorCheck = {
+    readonly id: string;
+    readonly label: string;
+    readonly status: DoctorStatus;
+    readonly detail?: string;
+    readonly remediation?: string;
+};
+export type RigDoctorServer = {
+    readonly baseUrl: string;
+    readonly authToken: string | null;
+    readonly connectionKind: "local" | "remote";
+};
+export type RunRigDoctorChecksOptions = {
+    readonly projectRoot: string;
+    readonly resolveServer?: (projectRoot: string) => Promise<RigDoctorServer>;
+    readonly requestJson?: (pathname: string, init?: RequestInit) => Promise<unknown>;
+    readonly piChecks?: () => Promise<readonly PiInstallCheck[]>;
+    readonly which?: (binary: string) => string | null;
+    readonly bunVersion?: string;
+    readonly loadConfig?: (projectRoot: string) => Promise<DoctorConfig | null>;
+    /** Per-check status narration ("Checking GitHub auth…") for wait spinners. */
+    readonly onProgress?: (label: string) => void;
+};
+export declare function runRigDoctorChecks(options: RunRigDoctorChecksOptions): Promise<RigDoctorCheck[]>;
+export declare function formatDoctorChecks(checks: readonly RigDoctorCheck[]): string;
+export declare function countDoctorFailures(checks: readonly RigDoctorCheck[]): number;
+export declare function throwIfDoctorFailed(checks: readonly RigDoctorCheck[]): void;
+export {};

package/dist/src/commands/_help-catalog.d.ts

@@ -0,0 +1,51 @@
+export type HelpCommand = {
+    command: string;
+    description: string;
+    primary?: boolean;
+};
+export type HelpGroup = {
+    name: string;
+    summary: string;
+    usage: string[];
+    commands: HelpCommand[];
+    examples?: string[];
+    next?: string[];
+    advanced?: string[];
+};
+export type TopLevelSection = {
+    title: string;
+    subtitle: string;
+    commands: HelpCommand[];
+};
+/** Catalog DATA for the app's help view — the view builds its own layout
+ * from these; the render* functions below remain for plain/script output. */
+export declare function helpCatalog(): {
+    sections: readonly TopLevelSection[];
+    groups: readonly HelpGroup[];
+};
+/**
+ * Night City boot screen. Rendered only on interactive TTY launches — plain
+ * mode and --json never see it.
+ */
+export declare function renderRigBanner(version?: string): string;
+export declare function renderTopLevelHelp(): string;
+export declare function renderAdvancedHelp(): string;
+export declare function renderGroupHelp(groupName: string): string | null;
+export declare function listHelpGroups(): string[];
+/**
+ * Fuzzy-match a bare word against known group subcommand names so the
+ * unknown-command error can suggest the canonical `rig <group> <cmd>`
+ * spelling. Primary groups win ties (ALL_GROUPS is primary-first).
+ */
+export declare function suggestGroupCommandForWord(word: string): string | null;
+export type TopLevelLaunchState = {
+    /** True when the cwd resolves to an initialized Rig project. */
+    projectInitialized?: boolean;
+    /** Short description of the selected server connection, if known. */
+    selectedServer?: string | null;
+    /** CLI version for the banner footer. */
+    version?: string;
+};
+export declare function printTopLevelHelp(state?: TopLevelLaunchState): void;
+export declare function printAdvancedHelp(): void;
+export declare function printGroupHelpDocument(groupName: string): void;

package/dist/src/commands/_help-catalog.js

@@ -94,6 +94,7 @@ var PRIMARY_GROUPS = [
       { command: "next [filters]", description: "Render the next matching task as a selected-task card.", primary: true },
       { command: "show <id>|--task <id> [--raw]", description: "Show a human task summary; --raw prints the full payload.", primary: true },
       { command: "run [#<issue>|<task-id>|--next|--task <id>]", description: "Submit a task run; interactive follows with bundled Pi.", primary: true },
+      { command: "ready", description: "List task IDs that are runnable now." },
       { command: "validate|verify [--task <id>]", description: "Run configured task checks/review gates." },
       { command: "details --task <id>", description: "Show full task info from the configured source." },
       { command: "reopen [--task <id> | --all] [--reason <text>]", description: "Reopen closed task(s) in the configured source." },

package/dist/src/commands/_json-output.d.ts

@@ -0,0 +1,11 @@
+import { type RigCliOutputEnvelope } from "@rig/contracts";
+/**
+ * Build the versioned `{ v: 1, command, data }` envelope for a command
+ * outcome, or null when the command has no output schema (legacy payload)
+ * or the details fail validation (warned on stderr, legacy payload).
+ */
+export declare function buildCliJsonEnvelope(outcome: unknown, options?: {
+    warn?: (message: string) => void;
+}): RigCliOutputEnvelope | null;
+/** Commands with a versioned --json envelope (for help/docs/tests). */
+export declare function listSchematizedCliCommands(): string[];

package/dist/src/commands/_operator-surface.d.ts

@@ -0,0 +1,34 @@
+import type { WorkspaceTaskRecord } from "./_server-client";
+export type OperatorSnapshot = {
+    readonly run: Record<string, unknown>;
+    readonly logs?: readonly Record<string, unknown>[];
+    readonly timeline?: readonly Record<string, unknown>[];
+};
+export declare function renderOperatorSnapshot(snapshot: OperatorSnapshot): string;
+export type PiRunStreamRenderer = {
+    renderSnapshot(snapshot: OperatorSnapshot): void;
+    renderTimeline(entries: readonly Record<string, unknown>[]): void;
+    renderLogs(entries: readonly Record<string, unknown>[]): void;
+};
+export declare function createPiRunStreamRenderer(output?: Pick<NodeJS.WriteStream, "write">): PiRunStreamRenderer;
+export type OperatorSurface = PiRunStreamRenderer & {
+    readonly mode: "text" | "pi-compatible-text";
+    info(message: string): void;
+    error(message: string): void;
+    attachCommandInput(handler: (line: string) => void | Promise<void>): {
+        close(): void;
+    } | null;
+};
+export declare function createOperatorSurface(options?: {
+    readonly input?: NodeJS.ReadStream;
+    readonly output?: Pick<NodeJS.WriteStream, "write"> & {
+        readonly isTTY?: boolean;
+    };
+    readonly errorOutput?: Pick<NodeJS.WriteStream, "write">;
+    readonly interactive?: boolean;
+}): OperatorSurface;
+export type TaskPickerRenderer = {
+    readonly writeLine: (line: string) => void;
+};
+export declare function renderTaskPickerRows(tasks: readonly WorkspaceTaskRecord[]): string[];
+export declare function promptForTaskSelection(question: string): Promise<string>;