@h-rig/cli 0.0.6-alpha.83 → 0.0.6-alpha.84

package/dist/src/app-opentui/layout.d.ts

@@ -8,7 +8,14 @@ export type StageLayout = {
     readonly typeBarTop: number;
     readonly footerTop: number;
     readonly compact: boolean;
+    /** Raw terminal is below the usable threshold; render a guidance message
+     * instead of a scene that would clip into nothing (#18). */
+    readonly tooSmall: boolean;
 };
+/** Below these raw dimensions, ad-terminal panels collapse below their 4×4
+ * floor and the UI would blank silently. We show a "resize me" card instead. */
+export declare const MIN_TERMINAL_WIDTH = 48;
+export declare const MIN_TERMINAL_HEIGHT = 16;
 export declare function computeStageLayout(width: number, height: number): StageLayout;
 export declare function visibleWidth(text: string): number;
 export declare function alignText(text: string, width: number, align?: "left" | "center" | "right"): string;

package/dist/src/app-opentui/layout.js

@@ -1,17 +1,22 @@
 // @bun
 // packages/cli/src/app-opentui/layout.ts
+var MIN_TERMINAL_WIDTH = 48;
+var MIN_TERMINAL_HEIGHT = 16;
 function computeStageLayout(width, height) {
-  const safeWidth = Math.max(40, Math.trunc(width || 80));
-  const safeHeight = Math.max(18, Math.trunc(height || 24));
+  const rawWidth = Math.trunc(width || 80);
+  const rawHeight = Math.trunc(height || 24);
+  const tooSmall = rawWidth < MIN_TERMINAL_WIDTH || rawHeight < MIN_TERMINAL_HEIGHT;
+  const safeWidth = Math.max(40, rawWidth);
+  const safeHeight = Math.max(18, rawHeight);
   const compact = safeWidth < 92 || safeHeight < 30;
   const horizontalGutter = compact ? 1 : 2;
   const centerWidth = Math.max(36, safeWidth - horizontalGutter * 2);
   const centerLeft = horizontalGutter;
   const footerTop = Math.max(0, safeHeight - 1);
-  const typeBarTop = footerTop;
+  const typeBarTop = Math.max(0, footerTop - 1);
   const centerTop = compact ? 1 : Math.max(1, Math.floor(safeHeight * 0.055));
-  const centerHeight = Math.max(8, footerTop - centerTop);
-  return { width: safeWidth, height: safeHeight, centerWidth, centerLeft, centerTop, centerHeight, typeBarTop, footerTop, compact };
+  const centerHeight = Math.max(6, typeBarTop - centerTop);
+  return { width: safeWidth, height: safeHeight, centerWidth, centerLeft, centerTop, centerHeight, typeBarTop, footerTop, compact, tooSmall };
 }
 function visibleWidth(text) {
   return [...text].length;
@@ -40,5 +45,7 @@ export {
   visibleWidth,
   truncateText,
   computeStageLayout,
-  alignText
+  alignText,
+  MIN_TERMINAL_WIDTH,
+  MIN_TERMINAL_HEIGHT
 };

package/dist/src/app-opentui/list-search.d.ts

@@ -6,3 +6,27 @@ export declare function listSearchQuery(state: AppState): string;
 export declare function filterRunsForSearch(runs: readonly AppRunRecord[], query: string): AppRunRecord[];
 export declare function filterTasksForSearch(tasks: readonly AppTaskRecord[], query: string): AppTaskRecord[];
 export declare function searchSummary(kind: "runs" | "tasks", query: string, visible: number, total: number): string;
+export type SortDir = "asc" | "desc";
+export type RunSortKey = "status" | "runId" | "title" | "age";
+export type RunSortSpec = {
+    readonly key: RunSortKey;
+    readonly dir: SortDir;
+};
+export type TaskSortKey = "status" | "id" | "priority" | "assignee" | "title";
+export type TaskSortSpec = {
+    readonly key: TaskSortKey;
+    readonly dir: SortDir;
+};
+/** Read a typed run sort spec off the data bag, narrowing the `unknown` slice. */
+export declare function runSortSpec(value: unknown): RunSortSpec | null;
+/** Read a typed task sort spec off the data bag, narrowing the `unknown` slice. */
+export declare function taskSortSpec(value: unknown): TaskSortSpec | null;
+/** Cycle a column's sort: clicking the active column flips asc→desc→default;
+ * clicking a new column starts it ascending. `null` means "back to default". */
+export declare function cycleRunSort(current: RunSortSpec | null, key: RunSortKey): RunSortSpec | null;
+export declare function cycleTaskSort(current: TaskSortSpec | null, key: TaskSortKey): TaskSortSpec | null;
+/** Sort runs by a column. `spec === null` returns the input order unchanged. */
+export declare function sortRuns(runs: readonly AppRunRecord[], spec: RunSortSpec | null): AppRunRecord[];
+/** Sort tasks by a column, client-side over already-fetched records. `spec ===
+ * null` returns the input order unchanged (server/adapter order is preserved). */
+export declare function sortTasks(tasks: readonly AppTaskRecord[], spec: TaskSortSpec | null): AppTaskRecord[];

package/dist/src/app-opentui/list-search.js

@@ -34,10 +34,97 @@ function filterTasksForSearch(tasks, query) {
 function searchSummary(kind, query, visible, total) {
   return query.trim() ? `search ${JSON.stringify(query)} \xB7 ${visible}/${total} ${kind}` : `${total} ${kind}`;
 }
+function runSortSpec(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return null;
+  const record = value;
+  const key = record.key;
+  const dir = record.dir;
+  if ((key === "status" || key === "runId" || key === "title" || key === "age") && (dir === "asc" || dir === "desc")) {
+    return { key, dir };
+  }
+  return null;
+}
+function taskSortSpec(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return null;
+  const record = value;
+  const key = record.key;
+  const dir = record.dir;
+  if ((key === "status" || key === "id" || key === "priority" || key === "assignee" || key === "title") && (dir === "asc" || dir === "desc")) {
+    return { key, dir };
+  }
+  return null;
+}
+function cycleRunSort(current, key) {
+  if (!current || current.key !== key)
+    return { key, dir: "asc" };
+  if (current.dir === "asc")
+    return { key, dir: "desc" };
+  return null;
+}
+function cycleTaskSort(current, key) {
+  if (!current || current.key !== key)
+    return { key, dir: "asc" };
+  if (current.dir === "asc")
+    return { key, dir: "desc" };
+  return null;
+}
+function ageValue(updatedAt) {
+  const parsed = Date.parse(updatedAt ?? "");
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function applyDir(rows, compare, dir) {
+  const sorted = [...rows].sort(compare);
+  return dir === "desc" ? sorted.reverse() : sorted;
+}
+function sortRuns(runs, spec) {
+  if (!spec)
+    return [...runs];
+  const { key, dir } = spec;
+  if (key === "age") {
+    const byNewest = applyDir(runs, (a, b) => ageValue(b.updatedAt) - ageValue(a.updatedAt) || a.runId.localeCompare(b.runId), "asc");
+    return dir === "asc" ? byNewest : [...byNewest].reverse();
+  }
+  const compare = (a, b) => {
+    if (key === "status")
+      return a.status.localeCompare(b.status) || a.runId.localeCompare(b.runId);
+    if (key === "title")
+      return a.title.localeCompare(b.title, undefined, { sensitivity: "base" }) || a.runId.localeCompare(b.runId);
+    return a.runId.localeCompare(b.runId, undefined, { numeric: true });
+  };
+  return applyDir(runs, compare, dir);
+}
+function sortTasks(tasks, spec) {
+  if (!spec)
+    return [...tasks];
+  const { key, dir } = spec;
+  const compare = (a, b) => {
+    if (key === "status")
+      return a.status.localeCompare(b.status) || a.id.localeCompare(b.id, undefined, { numeric: true });
+    if (key === "priority") {
+      const left = a.priority ?? Number.NEGATIVE_INFINITY;
+      const right = b.priority ?? Number.NEGATIVE_INFINITY;
+      return right - left || a.id.localeCompare(b.id, undefined, { numeric: true });
+    }
+    if (key === "assignee")
+      return (a.assignees[0] ?? "").localeCompare(b.assignees[0] ?? "") || a.id.localeCompare(b.id, undefined, { numeric: true });
+    if (key === "title")
+      return a.title.localeCompare(b.title, undefined, { sensitivity: "base" }) || a.id.localeCompare(b.id, undefined, { numeric: true });
+    return a.id.localeCompare(b.id, undefined, { numeric: true });
+  };
+  return applyDir(tasks, compare, dir);
+}
 export {
+  taskSortSpec,
+  sortTasks,
+  sortRuns,
   searchSummary,
+  runSortSpec,
   listSearchQuery,
   isListSearchScene,
   filterTasksForSearch,
-  filterRunsForSearch
+  filterRunsForSearch,
+  cycleTaskSort,
+  cycleRunSort
 };

package/dist/src/app-opentui/pi-host-child.js

@@ -587,6 +587,14 @@ async function withSpinner(label, work, options = {}) {
 }
 
 // packages/cli/src/commands/_pi-frontend.ts
+var TERMINAL_RUN_STATUSES = new Set(["completed", "failed", "stopped", "cancelled", "canceled", "closed", "merged", "needs_attention", "needs-attention"]);
+
+class OperatorTranscriptUnavailableError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OperatorTranscriptUnavailableError";
+  }
+}
 function setTemporaryEnv(updates) {
   const previous = new Map;
   for (const [key, value] of Object.entries(updates)) {
@@ -614,6 +622,23 @@ function buildOperatorPiEnv(input) {
     ...input.serverProjectRoot ? { RIG_PROJECT_ROOT: input.serverProjectRoot } : {}
   };
 }
+function shouldRequireOperatorTranscript(status) {
+  return typeof status === "string" && TERMINAL_RUN_STATUSES.has(status.trim().toLowerCase());
+}
+function missingOperatorTranscriptMessage(runId, status) {
+  const shortRun = runId.trim().slice(0, 8) || "unknown";
+  const statusText = typeof status === "string" && status.trim() ? status.trim() : "terminal";
+  return `Run ${shortRun} is ${statusText}, but no worker Pi session transcript is recorded for this run. It likely failed before Pi started or predates full-session capture. Use \`rig run show ${runId}\` and \`rig run logs ${runId}\` for the lifecycle details.`;
+}
+function statusFromRunDetails(run) {
+  if (!run || typeof run !== "object" || Array.isArray(run))
+    return;
+  const record = run;
+  if (typeof record.status === "string")
+    return record.status;
+  const nested = record.run;
+  return nested && typeof nested === "object" && !Array.isArray(nested) ? nested.status : undefined;
+}
 async function prepareOperatorConsole(context, runId, tempSessionDir) {
   const server = await ensureServerForCli(context.projectRoot);
   const localCwd = join(homedir2(), ".rig", "drones", runId.slice(0, 8));
@@ -643,6 +668,13 @@ async function prepareOperatorConsole(context, runId, tempSessionDir) {
       sessionFileArg = ["--session", localSessionPath];
     }
   } catch {}
+  if (sessionFileArg.length === 0) {
+    const run = await getRunDetailsViaServer(context, runId).catch(() => null);
+    const status = statusFromRunDetails(run);
+    if (shouldRequireOperatorTranscript(status)) {
+      throw new OperatorTranscriptUnavailableError(missingOperatorTranscriptMessage(runId, status));
+    }
+  }
   return { server, sessionFileArg };
 }
 var RIG_PI_THEME = {
@@ -815,7 +847,7 @@ if (import.meta.main) {
   try {
     await runOpenTuiPiHostChild();
   } catch (error) {
-    const message = error instanceof Error ? error.stack || error.message : String(error);
+    const message = error instanceof Error ? error.name === "OperatorTranscriptUnavailableError" ? error.message : error.stack || error.message : String(error);
     process.stderr.write(`
 Pi host failed:
 ${message}

package/dist/src/app-opentui/pi-pty-host.d.ts

@@ -17,6 +17,7 @@ export type PiPtyHostSnapshot = {
     readonly lines: readonly string[];
     readonly styledLines?: readonly StyledText[];
     readonly message?: string;
+    readonly resizeError?: string;
     readonly exitCode?: number;
     readonly signal?: string | null;
 };
@@ -49,9 +50,13 @@ export declare class PiPtyHost {
     private cols;
     private rows;
     private message;
+    private lastResizeError;
     private exitCode;
     private signal;
     private notifyTimer;
+    /** Last streamed buffer content, so the onWriteParsed handler only emits a
+     * snapshot when the rendered content actually changed. */
+    private lastStreamKey;
     private _disposed;
     constructor(options: PiPtyHostOptions);
     get disposed(): boolean;

package/dist/src/app-opentui/pi-pty-host.js

@@ -158,9 +158,11 @@ class PiPtyHost {
   cols;
   rows;
   message = "starting bundled Pi";
+  lastResizeError = null;
   exitCode;
   signal;
   notifyTimer = null;
+  lastStreamKey = "";
   _disposed = false;
   constructor(options) {
     this.runId = options.runId;
@@ -177,6 +179,17 @@ class PiPtyHost {
       scrollback: 1000
     });
     this.registerTerminalResponders();
+    this.disposables.push(this.terminal.onWriteParsed(() => {
+      if (this._disposed)
+        return;
+      const snapshot = this.createSnapshot();
+      const key = snapshot.lines.join(`
+`);
+      if (key === this.lastStreamKey)
+        return;
+      this.lastStreamKey = key;
+      this.onSnapshot?.(snapshot);
+    }));
   }
   get disposed() {
     return this._disposed;
@@ -263,7 +276,10 @@ class PiPtyHost {
     this.terminal.resize(nextCols, nextRows);
     try {
       this.pty?.resize(nextCols, nextRows);
-    } catch {}
+      this.lastResizeError = null;
+    } catch (error) {
+      this.lastResizeError = error instanceof Error ? error.message : String(error);
+    }
     this.emitSnapshotSoon(0);
   }
   detach() {
@@ -305,7 +321,7 @@ class PiPtyHost {
       return;
     const text = this.decoder.decode(data, { stream: true });
     this.respondToRawTerminalQueries(text);
-    this.terminal.write(data, () => this.emitSnapshotSoon());
+    this.terminal.write(data);
   }
   emitSnapshotSoon(delayMs = SNAPSHOT_DELAY_MS) {
     if (this._disposed || this.notifyTimer)
@@ -334,6 +350,7 @@ class PiPtyHost {
       lines.push("");
       styledLines[lines.length - 1] = new StyledText([{ __isChunk: true, text: "" }]);
     }
+    const resolvedMessage = this.lastResizeError ? `resize degraded: ${this.lastResizeError}` : message;
     return {
       runId: this.runId,
       status: this.status,
@@ -341,7 +358,8 @@ class PiPtyHost {
       rows: this.rows,
       lines,
       styledLines,
-      message,
+      message: resolvedMessage,
+      ...this.lastResizeError ? { resizeError: this.lastResizeError } : {},
       ...this.exitCode !== undefined ? { exitCode: this.exitCode } : {},
       ...this.signal !== undefined ? { signal: this.signal } : {}
     };

package/dist/src/app-opentui/react/App.d.ts

@@ -0,0 +1,9 @@
+import { computeStageLayout } from "../layout";
+import { entryIntentForScene } from "../runtime";
+import { PRIMARY_NAV } from "./nav";
+import type { AppSceneFrame, AppSceneId, AppState } from "../types";
+type SceneRenderer = (state: AppState, layout: ReturnType<typeof computeStageLayout>) => AppSceneFrame;
+export declare function App(props: {
+    sceneRenderers?: Partial<Record<AppSceneId, SceneRenderer>>;
+}): React.ReactNode;
+export { PRIMARY_NAV, entryIntentForScene };