@h-rig/cli 0.0.6-alpha.8 → 0.0.6-alpha.81

package/dist/src/app-opentui/scenes/doctor.d.ts

@@ -0,0 +1,2 @@
+import type { AppSceneFrame, AppState } from "../types";
+export declare function renderDoctorScene(state: AppState): AppSceneFrame;

package/dist/src/app-opentui/scenes/doctor.js

@@ -0,0 +1,91 @@
+// @bun
+// packages/cli/src/app-opentui/theme.ts
+import {
+  bold as otuiBold,
+  dim as otuiDim,
+  fg as otuiFg,
+  t,
+  TextAttributes
+} from "@opentui/core";
+var RIG_UI = {
+  bg: "#070809",
+  bg2: "#0b0c0e",
+  panel: "#101115",
+  panel2: "#101115",
+  glass: "#14161b",
+  ink: "#f2f3f6",
+  ink2: "#aeb0ba",
+  ink3: "#6c6e79",
+  ink4: "#44464f",
+  lime: "#ccff4d",
+  limeDim: "#a9d63f",
+  cyan: "#56d8ff",
+  red: "#ff5d5d",
+  yellow: "#ffd24d",
+  magenta: "#ff79b0"
+};
+var styles = {
+  ink: otuiFg(RIG_UI.ink),
+  ink2: otuiFg(RIG_UI.ink2),
+  ink3: otuiFg(RIG_UI.ink3),
+  ink4: otuiFg(RIG_UI.ink4),
+  lime: otuiFg(RIG_UI.lime),
+  limeDim: otuiFg(RIG_UI.limeDim),
+  cyan: otuiFg(RIG_UI.cyan),
+  red: otuiFg(RIG_UI.red),
+  yellow: otuiFg(RIG_UI.yellow),
+  magenta: otuiFg(RIG_UI.magenta)
+};
+
+// packages/cli/src/app-opentui/render/scene.ts
+function line(text, options = {}) {
+  return { text, ...options };
+}
+function blank() {
+  return { text: "" };
+}
+function center(text, fg = RIG_UI.ink2, bold = false) {
+  return { text, fg, bold, align: "center" };
+}
+function makeSceneFrame(input) {
+  return input;
+}
+
+// packages/cli/src/app-opentui/scenes/doctor.ts
+function checks(state) {
+  const doctor = state.data.doctor;
+  if (!doctor || typeof doctor !== "object" || Array.isArray(doctor))
+    return [];
+  const checks2 = doctor.checks;
+  return Array.isArray(checks2) ? checks2 : [];
+}
+function glyph(status) {
+  return status === "pass" ? "\u25CF" : status === "warn" ? "\u25B2" : "\u2715";
+}
+function doctorColor(status) {
+  return status === "pass" ? RIG_UI.limeDim : status === "warn" ? RIG_UI.yellow : RIG_UI.red;
+}
+function renderDoctorScene(state) {
+  const records = checks(state);
+  const failures = records.filter((check) => check.status === "fail").length;
+  const warnings = records.filter((check) => check.status === "warn").length;
+  const firstRemediation = records.find((check) => check.status !== "pass" && check.remediation)?.remediation;
+  return makeSceneFrame({
+    scene: "doctor",
+    title: "Doctor",
+    lines: [
+      center("doctor", RIG_UI.ink, true),
+      center(records.length > 0 ? `${failures} fail \xB7 ${warnings} warn` : "diagnostics ready", RIG_UI.ink3),
+      blank(),
+      ...records.length > 0 ? records.slice(0, 14).map((check) => line(`${glyph(check.status)} ${check.label}${check.detail ? ` \u2014 ${check.detail}` : ""}`, { fg: doctorColor(check.status), align: "center" })) : [line("type doctor to run checks", { fg: RIG_UI.ink3, align: "center" })],
+      blank(),
+      line(firstRemediation ? `next: ${firstRemediation}` : records.length > 0 ? "ready" : "idle", { fg: firstRemediation ? RIG_UI.yellow : RIG_UI.ink4, align: "center" })
+    ],
+    footer: { message: records.length > 0 ? `${records.length} checks` : "doctor idle" },
+    typeBarPlaceholder: "doctor \xB7 server \xB7 tasks \xB7 init",
+    live: state.status === "action" || records.length === 0
+  });
+}
+export {
+  renderDoctorScene
+};

package/dist/src/app-opentui/scenes/error.d.ts

@@ -0,0 +1,2 @@
+import type { AppSceneFrame, AppState } from "../types";
+export declare function renderErrorScene(state: AppState): AppSceneFrame;

package/dist/src/app-opentui/scenes/error.js

@@ -0,0 +1,190 @@
+// @bun
+// packages/cli/src/app-opentui/drone.ts
+import { RGBA, StyledText, TextAttributes as TextAttributes2 } from "@opentui/core";
+
+// packages/cli/src/app-opentui/theme.ts
+import {
+  bold as otuiBold,
+  dim as otuiDim,
+  fg as otuiFg,
+  t,
+  TextAttributes
+} from "@opentui/core";
+var RIG_UI = {
+  bg: "#070809",
+  bg2: "#0b0c0e",
+  panel: "#101115",
+  panel2: "#101115",
+  glass: "#14161b",
+  ink: "#f2f3f6",
+  ink2: "#aeb0ba",
+  ink3: "#6c6e79",
+  ink4: "#44464f",
+  lime: "#ccff4d",
+  limeDim: "#a9d63f",
+  cyan: "#56d8ff",
+  red: "#ff5d5d",
+  yellow: "#ffd24d",
+  magenta: "#ff79b0"
+};
+var styles = {
+  ink: otuiFg(RIG_UI.ink),
+  ink2: otuiFg(RIG_UI.ink2),
+  ink3: otuiFg(RIG_UI.ink3),
+  ink4: otuiFg(RIG_UI.ink4),
+  lime: otuiFg(RIG_UI.lime),
+  limeDim: otuiFg(RIG_UI.limeDim),
+  cyan: otuiFg(RIG_UI.cyan),
+  red: otuiFg(RIG_UI.red),
+  yellow: otuiFg(RIG_UI.yellow),
+  magenta: otuiFg(RIG_UI.magenta)
+};
+
+// packages/cli/src/app-opentui/drone.ts
+var MINI_DRONE = [
+  "(!!!)   (!!!)",
+  "  \\%==%/  ",
+  "   %%?%%   ",
+  "  /%==%\\  ",
+  "(!!!)   (!!!)"
+];
+var LEAD_MARK = [
+  " .-=-. ",
+  "=%%?%%=",
+  " '-=-' "
+];
+var BLADE_FRAMES = ["---", "\\\\\\", "|||", "///"];
+var EYE_FRAMES = ["o", "@", "\u2022", "."];
+var COLOR = {
+  body: RGBA.fromHex(RIG_UI.lime),
+  mini: RGBA.fromHex(RIG_UI.limeDim),
+  rotor: RGBA.fromHex(RIG_UI.cyan),
+  path: RGBA.fromHex(RIG_UI.cyan),
+  eye: RGBA.fromHex(RIG_UI.ink),
+  dim: RGBA.fromHex(RIG_UI.ink4),
+  ink: RGBA.fromHex(RIG_UI.ink2)
+};
+function bladeForTick(tick, phase = 0) {
+  return BLADE_FRAMES[(Math.floor(tick / 3) + phase) % BLADE_FRAMES.length];
+}
+function eyeForTick(tick, phase = 0) {
+  const pulse = Math.sin(tick * 0.09 + phase);
+  return pulse > 0.55 ? EYE_FRAMES[1] : pulse > 0.1 ? EYE_FRAMES[0] : pulse > -0.45 ? EYE_FRAMES[2] : EYE_FRAMES[3];
+}
+function chunk(text, fg, bold = false, dim = false) {
+  let attributes = TextAttributes2.NONE;
+  if (bold)
+    attributes |= TextAttributes2.BOLD;
+  if (dim)
+    attributes |= TextAttributes2.DIM;
+  return { __isChunk: true, text, fg, ...attributes !== TextAttributes2.NONE ? { attributes } : {} };
+}
+function styledLine(text, colorFor) {
+  const chunks = [];
+  let run = "";
+  let runColor = null;
+  const flush = () => {
+    if (!run || !runColor)
+      return;
+    chunks.push(chunk(run, COLOR[runColor], runColor === "body" || runColor === "eye", runColor === "dim"));
+    run = "";
+  };
+  for (const char of text) {
+    const next = colorFor(char);
+    if (next !== runColor) {
+      flush();
+      runColor = next;
+    }
+    run += char;
+  }
+  flush();
+  return new StyledText(chunks.length > 0 ? chunks : [chunk("", COLOR.ink)]);
+}
+function droneColor(char) {
+  if (char === "?" || char === "o" || char === "@" || char === "\u2022")
+    return "eye";
+  if (char === "%" || char === "=")
+    return "mini";
+  if (char === "$")
+    return "body";
+  if (char === "(" || char === ")" || char === "/" || char === "\\" || char === "|" || char === "-")
+    return "rotor";
+  if (char === "\xB7" || char === "\u2022" || char === "'" || char === ".")
+    return "path";
+  if (char.trim() === "")
+    return "dim";
+  return "ink";
+}
+function motionColor(char) {
+  if (char === "\u25CF" || char === "\u25C6" || char === "\u25C9")
+    return "body";
+  if (char === "\u2022" || char === "\xB7" || char === "\u2500" || char === "\u2502" || char === "\u2571" || char === "\u2572" || char === "\u256D" || char === "\u256E" || char === "\u2570" || char === "\u256F")
+    return "path";
+  if (char === "\u258C" || char === "\u2590" || char === "\u2581" || char === "\u2594")
+    return "mini";
+  return droneColor(char);
+}
+function materializeDrone(lines, tick, phase = 0) {
+  const blade = bladeForTick(tick, phase);
+  const eye = eyeForTick(tick, phase);
+  return lines.map((line) => line.replaceAll("!!!", blade).replaceAll("?", eye));
+}
+function brandFleetLines(tick, align = "center") {
+  const left = materializeDrone(MINI_DRONE, tick, 0);
+  const right = materializeDrone(MINI_DRONE, tick, 2);
+  const lead = materializeDrone(LEAD_MARK, tick, 1);
+  const packet = ["\xB7", "\u2022", "\u25CF", "\u2022"][Math.floor(tick / 2) % 4];
+  const bridge = [
+    `    ${left[0]}       ${lead[0]}       ${right[0]}`,
+    `    ${left[1]}   \xB7\u2500\u2500${packet}\u2500\u2500\xB7   ${lead[1]}   \xB7\u2500\u2500${packet}\u2500\u2500\xB7   ${right[1]}`,
+    `    ${left[2]}  \xB7'       '${lead[2]}'       '\xB7  ${right[2]}`,
+    `    ${left[3]}       \u2572  signal bus  \u2571       ${right[3]}`,
+    `    ${left[4]}    \xB7\u2500\u2500\u2500${packet}\u2500\u2500\u2500\u2500\u2500\u2500${packet}\u2500\u2500\u2500\xB7    ${right[4]}`
+  ];
+  return bridge.map((text) => ({
+    text,
+    styledText: styledLine(text, motionColor),
+    fg: RIG_UI.limeDim,
+    align
+  }));
+}
+function errorDrone(tick) {
+  return brandFleetLines(tick).map((line, index) => ({
+    ...line,
+    fg: index % 2 === 0 ? RIG_UI.red : line.fg
+  }));
+}
+
+// packages/cli/src/app-opentui/render/scene.ts
+function blank() {
+  return { text: "" };
+}
+function center(text, fg = RIG_UI.ink2, bold = false) {
+  return { text, fg, bold, align: "center" };
+}
+function makeSceneFrame(input) {
+  return input;
+}
+
+// packages/cli/src/app-opentui/scenes/error.ts
+function renderErrorScene(state) {
+  const message = state.error?.message ?? "Unknown Rig app error";
+  const hint = state.error?.hint ?? "type main, help, or retry after fixing the issue";
+  return makeSceneFrame({
+    scene: "error",
+    title: "Rig error",
+    lines: [
+      ...errorDrone(state.tick).slice(2, 16),
+      blank(),
+      center("DRONE SIGNAL DEGRADED", RIG_UI.red, true),
+      center(message, RIG_UI.ink2),
+      blank(),
+      center(hint, RIG_UI.limeDim)
+    ],
+    typeBarPlaceholder: hint,
+    live: true
+  });
+}
+export {
+  renderErrorScene
+};

package/dist/src/app-opentui/scenes/fleet.d.ts

@@ -0,0 +1,3 @@
+import type { StageLayout } from "../layout";
+import type { AppSceneFrame, AppState } from "../types";
+export declare function renderFleetScene(state: AppState, layout?: StageLayout): AppSceneFrame;

package/dist/src/app-opentui/scenes/fleet.js

@@ -0,0 +1,207 @@
+// @bun
+// packages/cli/src/app-opentui/theme.ts
+import {
+  bold as otuiBold,
+  dim as otuiDim,
+  fg as otuiFg,
+  t,
+  TextAttributes
+} from "@opentui/core";
+var RIG_UI = {
+  bg: "#070809",
+  bg2: "#0b0c0e",
+  panel: "#101115",
+  panel2: "#101115",
+  glass: "#14161b",
+  ink: "#f2f3f6",
+  ink2: "#aeb0ba",
+  ink3: "#6c6e79",
+  ink4: "#44464f",
+  lime: "#ccff4d",
+  limeDim: "#a9d63f",
+  cyan: "#56d8ff",
+  red: "#ff5d5d",
+  yellow: "#ffd24d",
+  magenta: "#ff79b0"
+};
+var styles = {
+  ink: otuiFg(RIG_UI.ink),
+  ink2: otuiFg(RIG_UI.ink2),
+  ink3: otuiFg(RIG_UI.ink3),
+  ink4: otuiFg(RIG_UI.ink4),
+  lime: otuiFg(RIG_UI.lime),
+  limeDim: otuiFg(RIG_UI.limeDim),
+  cyan: otuiFg(RIG_UI.cyan),
+  red: otuiFg(RIG_UI.red),
+  yellow: otuiFg(RIG_UI.yellow),
+  magenta: otuiFg(RIG_UI.magenta)
+};
+function statusColor(status) {
+  switch (status) {
+    case "running":
+    case "success":
+    case "completed":
+    case "merged":
+      return RIG_UI.lime;
+    case "preparing":
+    case "created":
+    case "validating":
+    case "reviewing":
+    case "closing-out":
+    case "stopping":
+    case "loading":
+    case "action":
+      return RIG_UI.cyan;
+    case "needs-attention":
+    case "needs_attention":
+      return RIG_UI.yellow;
+    case "failed":
+    case "error":
+      return RIG_UI.red;
+    default:
+      return RIG_UI.ink3;
+  }
+}
+
+// packages/cli/src/app-opentui/render/scene.ts
+function line(text, options = {}) {
+  return { text, ...options };
+}
+function makeSceneFrame(input) {
+  return input;
+}
+
+// packages/cli/src/app-opentui/list-search.ts
+function isListSearchScene(scene) {
+  return scene === "fleet" || scene === "tasks";
+}
+function listSearchQuery(state) {
+  return isListSearchScene(state.scene) ? state.typeBar.value.trim() : "";
+}
+function valueText(value) {
+  if (value === undefined || value === null)
+    return "";
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+    return String(value);
+  if (Array.isArray(value))
+    return value.map(valueText).join(" ");
+  if (typeof value === "object") {
+    const record = value;
+    return ["id", "runId", "taskId", "number", "title", "name", "summary", "status", "state", "label", "labels", "assignee", "assignees", "url"].map((key) => valueText(record[key])).join(" ");
+  }
+  return "";
+}
+function includesQuery(haystack, query) {
+  const needle = query.trim().toLowerCase();
+  if (!needle)
+    return true;
+  return haystack.map(valueText).join(" ").toLowerCase().includes(needle);
+}
+function filterRunsForSearch(runs, query) {
+  return query.trim() ? runs.filter((run) => includesQuery([run.runId, run.status, run.title, run.taskId, run.raw], query)) : [...runs];
+}
+function searchSummary(kind, query, visible, total) {
+  return query.trim() ? `search ${JSON.stringify(query)} \xB7 ${visible}/${total} ${kind}` : `${total} ${kind}`;
+}
+
+// packages/cli/src/app-opentui/scenes/fleet.ts
+function asRuns(state) {
+  const fleet = state.data.fleet;
+  if (!fleet || typeof fleet !== "object" || Array.isArray(fleet))
+    return [];
+  const runs = fleet.runs;
+  return Array.isArray(runs) ? runs : [];
+}
+function panelWidth(layout) {
+  return layout?.centerWidth ?? 100;
+}
+function panelHeight(layout, top = 3) {
+  return Math.max(4, (layout?.centerHeight ?? 24) - top);
+}
+function clip(value, width) {
+  if (width <= 0)
+    return "";
+  return value.length <= width ? value : `${value.slice(0, Math.max(0, width - 1))}\u2026`;
+}
+function runRow(width, run, index, active) {
+  const id = run.runId.slice(0, 8).padEnd(9);
+  const status = run.status.replace(/[_-]/g, " ").slice(0, 13).padEnd(14);
+  const marker = active ? "\u258C" : " ";
+  const prefix = `${marker} ${id} ${status}`;
+  const titleWidth = Math.max(12, width - prefix.length - 2);
+  return line(`${prefix}${clip(run.title, titleWidth)}`, {
+    fg: active ? RIG_UI.ink : statusColor(run.status),
+    bold: active,
+    selectableIndex: index
+  });
+}
+function emptyRows(query, total) {
+  if (query.trim() && total > 0) {
+    return [
+      line("No matching runs.", { fg: RIG_UI.ink2, bold: true }),
+      line(`search ${JSON.stringify(query)} returned 0/${total}`, { fg: RIG_UI.ink3 }),
+      line("escape clears search", { fg: RIG_UI.ink4 })
+    ];
+  }
+  return [
+    line("No runs yet.", { fg: RIG_UI.ink2, bold: true }),
+    line("Open Tasks and dispatch work; live and completed runs appear here.", { fg: RIG_UI.ink3 }),
+    line("tab switches screens", { fg: RIG_UI.ink4 })
+  ];
+}
+function degradedRows(state) {
+  if (!state.error)
+    return [];
+  return [
+    line(`status: ${state.error.message}`, { fg: RIG_UI.red, bold: true }),
+    ...state.error.hint ? [line(state.error.hint, { fg: RIG_UI.yellow })] : [],
+    line("", { fg: RIG_UI.ink3 })
+  ];
+}
+function renderFleetScene(state, layout) {
+  const width = panelWidth(layout);
+  const allRuns = asRuns(state);
+  const query = listSearchQuery(state);
+  const runs = filterRunsForSearch(allRuns, query);
+  const selectedRun = typeof state.data.selectedRunId === "string" && runs.some((run) => run.runId === state.data.selectedRunId) ? state.data.selectedRunId : runs[0]?.runId;
+  const selectedIndex = Math.max(0, runs.findIndex((run) => run.runId === selectedRun));
+  const panelTop = 0;
+  const contentWidth = Math.max(12, width - (layout?.compact ? 8 : 10));
+  const panelLines = [
+    line(`RUN       STATUS         TITLE`, { fg: RIG_UI.ink3, bold: true }),
+    line("", { fg: RIG_UI.ink3 }),
+    ...degradedRows(state),
+    ...query.trim() ? [line(searchSummary("runs", query, runs.length, allRuns.length), { fg: RIG_UI.ink4 }), line("", { fg: RIG_UI.ink3 })] : [],
+    ...runs.length > 0 ? runs.map((run, index) => runRow(contentWidth, run, index, index === selectedIndex)) : emptyRows(query, allRuns.length)
+  ];
+  return makeSceneFrame({
+    scene: "fleet",
+    title: "Runs",
+    lines: [
+      line("", { fg: RIG_UI.ink4 }),
+      line(query.trim() ? `   rig runs --search ${JSON.stringify(query)}` : "   rig runs", { fg: RIG_UI.ink3 })
+    ],
+    panels: [{
+      id: "runs-list",
+      top: panelTop,
+      width,
+      height: panelHeight(layout, panelTop),
+      lines: panelLines,
+      backgroundColor: RIG_UI.panel,
+      backgroundAlpha: 184,
+      opacity: 1,
+      border: false,
+      chrome: "ad-terminal",
+      headerText: query.trim() ? `rig runs --search ${JSON.stringify(query)}` : "rig runs",
+      headerHeight: 3,
+      paddingX: layout?.compact ? 2 : 3,
+      paddingY: 1
+    }],
+    footer: { run: selectedRun ? selectedRun.slice(0, 8) : "no runs", message: searchSummary("runs", query, runs.length, allRuns.length) },
+    typeBarPlaceholder: "search runs\u2026",
+    live: true
+  });
+}
+export {
+  renderFleetScene
+};

package/dist/src/app-opentui/scenes/handoff.d.ts

@@ -0,0 +1,2 @@
+import type { AppSceneFrame, AppState } from "../types";
+export declare function renderHandoffScene(state: AppState): AppSceneFrame;

package/dist/src/app-opentui/scenes/handoff.js

@@ -0,0 +1,147 @@
+// @bun
+// packages/cli/src/app-opentui/theme.ts
+import {
+  bold as otuiBold,
+  dim as otuiDim,
+  fg as otuiFg,
+  t,
+  TextAttributes
+} from "@opentui/core";
+var RIG_UI = {
+  bg: "#070809",
+  bg2: "#0b0c0e",
+  panel: "#101115",
+  panel2: "#101115",
+  glass: "#14161b",
+  ink: "#f2f3f6",
+  ink2: "#aeb0ba",
+  ink3: "#6c6e79",
+  ink4: "#44464f",
+  lime: "#ccff4d",
+  limeDim: "#a9d63f",
+  cyan: "#56d8ff",
+  red: "#ff5d5d",
+  yellow: "#ffd24d",
+  magenta: "#ff79b0"
+};
+var styles = {
+  ink: otuiFg(RIG_UI.ink),
+  ink2: otuiFg(RIG_UI.ink2),
+  ink3: otuiFg(RIG_UI.ink3),
+  ink4: otuiFg(RIG_UI.ink4),
+  lime: otuiFg(RIG_UI.lime),
+  limeDim: otuiFg(RIG_UI.limeDim),
+  cyan: otuiFg(RIG_UI.cyan),
+  red: otuiFg(RIG_UI.red),
+  yellow: otuiFg(RIG_UI.yellow),
+  magenta: otuiFg(RIG_UI.magenta)
+};
+
+// packages/cli/src/app-opentui/render/scene.ts
+function line(text, options = {}) {
+  return { text, ...options };
+}
+function blank() {
+  return { text: "" };
+}
+function center(text, fg = RIG_UI.ink2, bold = false) {
+  return { text, fg, bold, align: "center" };
+}
+function deckRow(input) {
+  const prefix = input.active ? "\u25B8" : " ";
+  const label = input.label.toUpperCase().padEnd(10);
+  return line(`${prefix} ${label} ${input.detail}`, {
+    fg: input.active ? RIG_UI.lime : RIG_UI.ink2,
+    bold: input.active,
+    selectableIndex: input.index,
+    activateOnClick: input.activateOnClick
+  });
+}
+function makeSceneFrame(input) {
+  return input;
+}
+
+// packages/cli/src/app-opentui/scenes/handoff.ts
+function handoffState(state) {
+  const value = state.data.piAttach ?? state.data.handoff;
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function terminalState(state) {
+  const value = state.data.piTerminal;
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function clip(value, width) {
+  if (width <= 0)
+    return "";
+  return value.length <= width ? value : `${value.slice(0, Math.max(0, width - 1))}\u2026`;
+}
+function terminalRail(snapshot) {
+  const text = ` run ${snapshot.runId.slice(0, 8)} \xB7 bundled Pi \xB7 mouse wheel scroll \xB7 ctrl-] detach \xB7 ${snapshot.message ?? snapshot.status}`;
+  return line(clip(text, snapshot.cols), { fg: RIG_UI.limeDim });
+}
+function terminalLines(snapshot) {
+  const hasVisibleOutput = snapshot.lines.some((entry) => entry.trim().length > 0);
+  const body = !hasVisibleOutput && snapshot.status === "running" ? [line(`starting bundled Pi for ${snapshot.runId.slice(0, 8)}\u2026`, { fg: RIG_UI.ink3 })] : snapshot.lines.map((text, index) => line(text, { fg: RIG_UI.ink, styledText: snapshot.styledLines?.[index] }));
+  return [...body, terminalRail(snapshot)];
+}
+function renderHandoffScene(state) {
+  const terminal = terminalState(state);
+  if (terminal && (terminal.status === "starting" || terminal.status === "running")) {
+    return makeSceneFrame({
+      scene: "handoff",
+      title: "Pi",
+      lines: [],
+      panels: [{
+        id: `pi-terminal-${terminal.runId}`,
+        top: 0,
+        left: 0,
+        width: terminal.cols,
+        height: terminal.rows,
+        lines: terminalLines(terminal),
+        backgroundColor: "#050607",
+        backgroundAlpha: 128,
+        opacity: 1,
+        border: false,
+        stickyScroll: true,
+        stickyStart: "bottom"
+      }],
+      footer: { run: terminal.runId.slice(0, 8), message: terminal.message ?? "bundled Pi" },
+      live: true,
+      fullScreen: true,
+      hideTypeBar: true,
+      terminalActive: true
+    });
+  }
+  const handoff = handoffState(state);
+  const runId = handoff?.runId ?? terminal?.runId ?? (typeof state.data.selectedRunId === "string" ? state.data.selectedRunId : undefined);
+  const status = handoff?.status ?? (runId ? "preparing" : "select-run");
+  const message = handoff?.message ?? (runId ? "ready to start bundled Pi inside Rig" : "choose a run before entering Pi");
+  const hasRun = Boolean(runId);
+  return makeSceneFrame({
+    scene: "handoff",
+    title: "Pi handoff",
+    lines: [
+      center(hasRun ? "PI" : "ATTACH", RIG_UI.ink, true),
+      center("Bundled Pi runs in this terminal. Rig only hosts the PTY.", RIG_UI.ink3),
+      blank(),
+      ...hasRun ? [
+        line(`  run       ${runId}`, { fg: RIG_UI.limeDim }),
+        line(`  status    ${status}`, { fg: status === "failed" ? RIG_UI.red : RIG_UI.cyan }),
+        line(`  message   ${message}`, { fg: RIG_UI.ink2 }),
+        blank(),
+        deckRow({ label: "attach", detail: "open bundled Pi", index: 0, active: true })
+      ] : [
+        line("  run       none selected", { fg: RIG_UI.yellow }),
+        line(`  message   ${message}`, { fg: RIG_UI.ink2 }),
+        blank(),
+        deckRow({ label: "runs", detail: "select a run first", index: 0, active: true })
+      ]
+    ],
+    footer: { run: runId ? `${runId.slice(0, 8)} handoff` : "select run", message: "real Pi only" },
+    typeBarPlaceholder: runId ? `attach ${runId.slice(0, 8)} \xB7 runs` : "runs \xB7 attach <run>",
+    live: true
+  });
+}
+export {
+  renderHandoffScene
+};

package/dist/src/app-opentui/scenes/help.d.ts

@@ -0,0 +1,3 @@
+import type { StageLayout } from "../layout";
+import type { AppSceneFrame, AppState } from "../types";
+export declare function renderHelpScene(state: AppState, layout?: StageLayout): AppSceneFrame;