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

package/dist/src/app-opentui/adapters/pi-attach.d.ts

@@ -1,16 +1,25 @@
-import type { AppAdapter } from "../types";
 import { type AppAdapterContext } from "./common";
-export declare function createPiAttachAdapter(renderer?: {
-    suspend?: () => void | Promise<void>;
-    resume?: () => void | Promise<void>;
-    destroy?: () => void | Promise<void>;
-}): AppAdapter;
+/** One concrete prep step in the attach pipeline (connect → fetch transcript →
+ * spawn host → start Pi). Carries a wall-clock start so the handoff scene can
+ * show step-by-step progress with elapsed time during the otherwise-blank
+ * window before Pi's transcript paints (bug #2). */
+export type PiAttachStep = {
+    readonly label: string;
+    readonly startedAtMs: number;
+    readonly status: "running" | "done" | "failed";
+    /** Set when the step settles, so elapsed time freezes instead of ticking. */
+    readonly endedAtMs?: number;
+};
 export type PiAttachHandoffState = {
     readonly runId: string;
     readonly status: "preparing" | "entering-pi" | "returned" | "failed";
     readonly message: string;
     readonly result?: Record<string, unknown>;
     readonly ready?: boolean;
+    /** Ordered prep steps with timing, surfaced during the blank attach window. */
+    readonly steps?: readonly PiAttachStep[];
+    /** Operator-facing failure reason when status === "failed". */
+    readonly failureReason?: string;
 };
 export declare function preparePiAttachHandoff(ctx: AppAdapterContext, runId: string): Promise<PiAttachHandoffState>;
 export declare function attachRunWithBundledPi(ctx: AppAdapterContext, runId: string): Promise<Record<string, unknown>>;

package/dist/src/app-opentui/adapters/pi-attach.js

@@ -15,6 +15,70 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
+// packages/cli/src/app-opentui/adapters/common.ts
+function projectRootOf(ctx) {
+  const root = ctx.rig?.projectRoot ?? ctx.projectRoot ?? ctx.getState().projectRoot;
+  if (typeof root === "string" && root.trim())
+    return root;
+  throw new Error("App adapter requires a projectRoot.");
+}
+function normalizeAppError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  const rawHint = error instanceof Error ? error.hint : undefined;
+  return {
+    message,
+    ...typeof rawHint === "string" && rawHint.trim() ? { hint: rawHint.trim() } : {}
+  };
+}
+function emitStarted(ctx, label, optimistic) {
+  ctx.emit({ type: "action.started", label, ...optimistic ? { optimistic } : {} });
+}
+function emitProgress(ctx, label, detail, data) {
+  ctx.emit({ type: "action.progress", label, ...detail ? { detail } : {}, ...data ? { data } : {} });
+}
+function emitCompleted(ctx, label, data) {
+  ctx.emit({ type: "action.completed", label, ...data ? { data } : {} });
+}
+function emitFailed(ctx, label, error, data) {
+  if (data)
+    patchData(ctx, data);
+  const normalized = normalizeAppError(error);
+  ctx.emit({
+    type: "action.failed",
+    label,
+    message: normalized.message,
+    ...normalized.hint ? { hint: normalized.hint } : {},
+    cause: error
+  });
+}
+function patchData(ctx, data) {
+  ctx.emit({ type: "data.patch", data });
+}
+function patchFooter(ctx, footer) {
+  ctx.emit({ type: "footer.patch", footer });
+}
+function arrayFromPayload(value) {
+  if (Array.isArray(value)) {
+    return value.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry)));
+  }
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    const entries = value.entries;
+    if (Array.isArray(entries))
+      return arrayFromPayload(entries);
+  }
+  return [];
+}
+function stringField(record, keys, fallback = "") {
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "string" && value.trim())
+      return value.trim();
+    if (typeof value === "number" && Number.isFinite(value))
+      return String(value);
+  }
+  return fallback;
+}
+
 // packages/cli/src/runner.ts
 import { EventBus } from "@rig/runtime/control-plane/runtime/events";
 import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
@@ -766,72 +830,203 @@ var init__server_client = __esm(() => {
   ]);
 });
 
-// packages/cli/src/app-opentui/adapters/common.ts
-function adapterContextFromRuntime(runtime, renderer) {
-  return {
-    projectRoot: runtime.getState().projectRoot,
-    renderer,
-    ensureRuntime: () => runtime.getRunnerContext(),
-    emit: (event) => runtime.emit(event),
-    getState: () => runtime.getState()
-  };
-}
-function projectRootOf(ctx) {
-  const root = ctx.rig?.projectRoot ?? ctx.projectRoot ?? ctx.getState().projectRoot;
-  if (typeof root === "string" && root.trim())
-    return root;
-  throw new Error("App adapter requires a projectRoot.");
-}
-function normalizeAppError(error) {
-  const message = error instanceof Error ? error.message : String(error);
-  const rawHint = error instanceof Error ? error.hint : undefined;
-  return {
-    message,
-    ...typeof rawHint === "string" && rawHint.trim() ? { hint: rawHint.trim() } : {}
-  };
-}
-function emitStarted(ctx, label, optimistic) {
-  ctx.emit({ type: "action.started", label, ...optimistic ? { optimistic } : {} });
-}
-function emitProgress(ctx, label, detail, data) {
-  ctx.emit({ type: "action.progress", label, ...detail ? { detail } : {}, ...data ? { data } : {} });
+// packages/cli/src/app-opentui/adapters/inspect.ts
+var exports_inspect = {};
+__export(exports_inspect, {
+  loadInspectRuns: () => loadInspectRuns,
+  loadInspect: () => loadInspect,
+  INSPECT_VIEWS: () => INSPECT_VIEWS
+});
+import { execFile } from "child_process";
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync, statSync } from "fs";
+import { resolve as resolve3 } from "path";
+import { promisify } from "util";
+import { resolveTaskArtifactDirs } from "@rig/runtime/control-plane/authority-files";
+import { readTaskArtifactPreview } from "@rig/runtime/control-plane/native/workspace-ops";
+import { resolveHarnessPaths, resolveMonorepoRoot, runCapture } from "@rig/runtime/control-plane/native/utils";
+function isFailureEntry(entry) {
+  const status = `${entry.status ?? entry.level ?? entry.type ?? ""}`.toLowerCase();
+  return status.includes("fail") || status.includes("error");
+}
+async function gitDiff(projectRoot) {
+  try {
+    const { stdout } = await execFileAsync("git", ["diff", "--no-color"], { cwd: projectRoot, maxBuffer: 8 * 1024 * 1024 });
+    return { diff: stdout };
+  } catch (error) {
+    return { diff: "", error: normalizeAppError(error).message };
+  }
 }
-function emitCompleted(ctx, label, data) {
-  ctx.emit({ type: "action.completed", label, ...data ? { data } : {} });
+function listArtifacts(projectRoot, taskId) {
+  if (!taskId)
+    return { artifacts: [], error: "run has no task id \u2014 artifacts are resolved per task" };
+  try {
+    const dirs = resolveTaskArtifactDirs(projectRoot, taskId).filter((dir) => existsSync3(dir));
+    const out = [];
+    const seen = new Set;
+    for (const dir of dirs) {
+      for (const name of readdirSync(dir)) {
+        if (seen.has(name))
+          continue;
+        seen.add(name);
+        const path = resolve3(dir, name);
+        try {
+          const stat = statSync(path);
+          out.push({ name, path, sizeBytes: stat.size, isDir: stat.isDirectory() });
+        } catch {
+          out.push({ name, path, sizeBytes: 0, isDir: false });
+        }
+      }
+    }
+    out.sort((left, right) => left.name.localeCompare(right.name));
+    return { artifacts: out };
+  } catch (error) {
+    return { artifacts: [], error: normalizeAppError(error).message };
+  }
 }
-function emitFailed(ctx, label, error, data) {
-  if (data)
-    patchData(ctx, data);
-  const normalized = normalizeAppError(error);
-  ctx.emit({
-    type: "action.failed",
-    label,
-    message: normalized.message,
-    ...normalized.hint ? { hint: normalized.hint } : {},
-    cause: error
-  });
+function readArtifact(projectRoot, taskId, fileName) {
+  if (!taskId)
+    return;
+  try {
+    const preview = readTaskArtifactPreview(projectRoot, taskId, fileName);
+    return { name: fileName, contents: preview.contents, truncated: preview.truncated, sizeBytes: preview.sizeBytes };
+  } catch (error) {
+    return { name: fileName, contents: `Failed to read artifact: ${normalizeAppError(error).message}`, truncated: false, sizeBytes: 0 };
+  }
 }
-function patchData(ctx, data) {
-  ctx.emit({ type: "data.patch", data });
+function loadGraph(projectRoot) {
+  try {
+    const result = runCapture(["br", "--no-db", "list", "--pretty"], resolveMonorepoRoot(projectRoot));
+    if (result.exitCode !== 0)
+      return { graph: "", error: result.stderr || result.stdout || "failed to inspect graph" };
+    return { graph: result.stdout };
+  } catch (error) {
+    return { graph: "", error: normalizeAppError(error).message };
+  }
 }
-function patchFooter(ctx, footer) {
-  ctx.emit({ type: "footer.patch", footer });
+function loadAudit(projectRoot) {
+  try {
+    const auditPath = resolve3(resolveHarnessPaths(projectRoot).logsDir, "audit.jsonl");
+    if (!existsSync3(auditPath))
+      return [];
+    return readFileSync3(auditPath, "utf-8").split(/\r?\n/).filter(Boolean).slice(-50).flatMap((raw) => {
+      try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? [parsed] : [{ detail: raw }];
+      } catch {
+        return [{ detail: raw }];
+      }
+    });
+  } catch {
+    return [];
+  }
 }
-function stringField(record, keys, fallback = "") {
-  for (const key of keys) {
-    const value = record[key];
-    if (typeof value === "string" && value.trim())
-      return value.trim();
-    if (typeof value === "number" && Number.isFinite(value))
-      return String(value);
+async function loadInspectRuns(ctx, options = {}) {
+  const label = "Loading runs to inspect";
+  emitStarted(ctx, label);
+  try {
+    const projectRoot = projectRootOf(ctx);
+    const { listRunsViaServer: listRunsViaServer2 } = await Promise.resolve().then(() => (init__server_client(), exports__server_client));
+    emitProgress(ctx, label, "listing recent runs");
+    const runs = await listRunsViaServer2({ projectRoot }, { limit: options.limit ?? 50 });
+    const options_ = runs.flatMap((record) => {
+      const runId = stringField(record, ["runId", "id"]);
+      if (!runId)
+        return [];
+      const taskId = stringField(record, ["taskId"]);
+      const updatedAt = stringField(record, ["updatedAt", "createdAt"]);
+      return [{
+        runId,
+        status: stringField(record, ["status", "state"], "unknown"),
+        title: stringField(record, ["title", "taskTitle", "taskId"], "untitled run"),
+        ...taskId ? { taskId } : {},
+        ...updatedAt ? { updatedAt } : {}
+      }];
+    });
+    patchData(ctx, { inspectRuns: options_, lastRefreshError: undefined });
+    emitCompleted(ctx, label, { count: options_.length });
+    return options_;
+  } catch (error) {
+    emitFailed(ctx, label, error);
+    throw error;
   }
-  return fallback;
 }
-function payloadString(intent, key) {
-  const value = intent.action.payload?.[key];
-  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+async function loadInspect(ctx, runId) {
+  const cleanRunId = runId.trim();
+  const label = `Inspecting run ${cleanRunId.slice(0, 8)}`;
+  if (!cleanRunId) {
+    await loadInspectRuns(ctx).catch(() => []);
+    const error = new Error("Inspect requires a run id.");
+    throw error;
+  }
+  emitStarted(ctx, label);
+  try {
+    const projectRoot = projectRootOf(ctx);
+    const { getRunDetailsViaServer: getRunDetailsViaServer2, getRunLogsViaServer: getRunLogsViaServer2, getRunTimelineViaServer: getRunTimelineViaServer2 } = await Promise.resolve().then(() => (init__server_client(), exports__server_client));
+    const context = { projectRoot };
+    emitProgress(ctx, label, "loading logs, timeline, diff, artifacts, graph, and audit");
+    const [runPayload, logsPayload, timelinePayload, diffResult] = await Promise.all([
+      getRunDetailsViaServer2(context, cleanRunId).catch((error) => ({ error: normalizeAppError(error).message })),
+      getRunLogsViaServer2(context, cleanRunId, { limit: 500 }).catch(() => []),
+      getRunTimelineViaServer2(context, cleanRunId, { limit: 500 }).catch(() => []),
+      gitDiff(projectRoot)
+    ]);
+    const run = runPayload && typeof runPayload === "object" && "run" in runPayload && runPayload.run && typeof runPayload.run === "object" ? runPayload.run : runPayload;
+    const logs = arrayFromPayload(logsPayload);
+    const timeline = arrayFromPayload(timelinePayload);
+    const taskId = stringField(run, ["taskId"]) || undefined;
+    const { artifacts, error: artifactsError } = listArtifacts(projectRoot, taskId);
+    const { graph, error: graphError } = loadGraph(projectRoot);
+    const audit = loadAudit(projectRoot);
+    const state = ctx.getState();
+    const selectedArtifact = typeof state.data?.inspectArtifact === "string" ? state.data.inspectArtifact : undefined;
+    const artifactView = selectedArtifact ? readArtifact(projectRoot, taskId, selectedArtifact) : undefined;
+    const snapshot = {
+      runId: cleanRunId,
+      status: stringField(run, ["status", "state"], "unknown"),
+      title: stringField(run, ["title", "taskId", "id"], "untitled run"),
+      logs,
+      timeline,
+      diff: diffResult.diff,
+      failures: [...logs, ...timeline].filter(isFailureEntry),
+      artifacts,
+      graph,
+      audit,
+      refreshedAt: Date.now(),
+      ...taskId ? { taskId } : {},
+      ...artifactView ? { artifactView } : {},
+      ...diffResult.error ? { diffError: diffResult.error } : {},
+      ...graphError ? { graphError } : {},
+      ...artifactsError ? { artifactsError } : {}
+    };
+    patchData(ctx, { inspect: snapshot, lastRefreshError: undefined });
+    emitCompleted(ctx, label, {
+      runId: cleanRunId,
+      logs: logs.length,
+      timeline: timeline.length,
+      diffBytes: snapshot.diff.length,
+      artifacts: artifacts.length,
+      audit: audit.length
+    });
+    return snapshot;
+  } catch (error) {
+    emitFailed(ctx, label, error, { runId: cleanRunId });
+    throw error;
+  }
 }
-
+var execFileAsync, INSPECT_VIEWS;
+var init_inspect = __esm(() => {
+  execFileAsync = promisify(execFile);
+  INSPECT_VIEWS = [
+    "logs",
+    "timeline",
+    "artifacts",
+    "artifact",
+    "diff",
+    "failures",
+    "graph",
+    "audit"
+  ];
+});
 // packages/cli/src/app-opentui/pi-pty-host.ts
 import { fileURLToPath } from "url";
 import { basename } from "path";
@@ -983,9 +1178,11 @@ class PiPtyHost {
   cols;
   rows;
   message = "starting bundled Pi";
+  lastResizeError = null;
   exitCode;
   signal;
   notifyTimer = null;
+  lastStreamKey = "";
   _disposed = false;
   constructor(options) {
     this.runId = options.runId;
@@ -1002,6 +1199,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;
@@ -1088,7 +1296,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() {
@@ -1130,7 +1341,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)
@@ -1159,6 +1370,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,
@@ -1166,7 +1378,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 } : {}
     };
@@ -1236,7 +1449,7 @@ async function refreshFleet(ctx, options = {}) {
       const entry = normalizeRunRecord(run);
       return entry ? [entry] : [];
     });
-    patchData(ctx, { fleet: { runs: normalized, refreshedAt: new Date().toISOString() } });
+    patchData(ctx, { fleet: { runs: normalized, refreshedAt: new Date().toISOString() }, lastRefreshError: undefined });
     patchFooter(ctx, { server: serverLabel, runs: String(normalized.length) });
     emitCompleted(ctx, label, { count: normalized.length });
     return normalized;
@@ -1247,25 +1460,31 @@ async function refreshFleet(ctx, options = {}) {
 }
 
 // packages/cli/src/app-opentui/adapters/pi-attach.ts
-function createPiAttachAdapter(renderer) {
-  return {
-    id: "pi-attach",
-    async handleIntent(runtime, intent) {
-      if (intent.scene !== "handoff" && intent.action.kind !== "run-attach")
-        return false;
-      const ctx = adapterContextFromRuntime(runtime, renderer);
-      const runId = payloadString(intent, "runId") ?? runtime.getState().data.selectedRunId;
-      if (intent.action.kind === "run-attach" && runId) {
-        await attachRunWithBundledPi(ctx, runId);
-        return true;
-      }
-      if (runId) {
-        await preparePiAttachHandoff(ctx, runId);
-        return true;
-      }
-      return false;
-    }
-  };
+function currentAttachState(ctx, runId) {
+  const value = ctx.getState().data?.piAttach;
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return null;
+  const state = value;
+  return state.runId === runId ? state : null;
+}
+function recordStep(ctx, runId, label, emitLabel) {
+  const now = Date.now();
+  const previous = currentAttachState(ctx, runId);
+  const priorSteps = previous?.steps ?? [];
+  const settled = priorSteps.map((step) => step.status === "running" ? { ...step, status: "done", endedAtMs: step.endedAtMs ?? now } : step);
+  const steps = [...settled, { label, startedAtMs: now, status: "running" }];
+  patchData(ctx, {
+    piAttach: { ...previous ?? { runId, status: "preparing", message: label }, runId, steps }
+  });
+  emitProgress(ctx, emitLabel, label);
+}
+function settleSteps(ctx, runId) {
+  const now = Date.now();
+  const previous = currentAttachState(ctx, runId);
+  if (!previous?.steps)
+    return;
+  const steps = previous.steps.map((step) => step.status === "running" ? { ...step, status: "done", endedAtMs: step.endedAtMs ?? now } : step);
+  patchData(ctx, { piAttach: { ...previous, steps } });
 }
 async function preparePiAttachHandoff(ctx, runId) {
   const cleanRunId = runId.trim();
@@ -1274,7 +1493,7 @@ async function preparePiAttachHandoff(ctx, runId) {
   try {
     const { getRunDetailsViaServer: getRunDetailsViaServer2, getRunPiStatusViaServer: getRunPiStatusViaServer2, resolveServerConnectionLabel: resolveServerConnectionLabel2 } = await Promise.resolve().then(() => (init__server_client(), exports__server_client));
     const projectRoot = projectRootOf(ctx);
-    emitProgress(ctx, label, "checking run and Pi session readiness");
+    recordStep(ctx, cleanRunId, "connecting to server \xB7 checking run and Pi session readiness", label);
     const [run, piStatus, server] = await Promise.all([
       getRunDetailsViaServer2({ projectRoot }, cleanRunId).catch((error) => ({ error: error instanceof Error ? error.message : String(error) })),
       getRunPiStatusViaServer2({ projectRoot }, cleanRunId).catch((error) => ({ error: error instanceof Error ? error.message : String(error) })),
@@ -1285,13 +1504,21 @@ async function preparePiAttachHandoff(ctx, runId) {
       status: "preparing",
       message: "ready to enter worker Pi",
       result: { run, piStatus, server },
-      ready: true
+      ready: true,
+      ...currentAttachState(ctx, cleanRunId)?.steps ? { steps: currentAttachState(ctx, cleanRunId).steps } : {}
     };
-    patchData(ctx, { piAttach: state });
+    patchData(ctx, { piAttach: state, lastRefreshError: undefined });
     emitCompleted(ctx, label, { runId: cleanRunId, server });
     return state;
   } catch (error) {
-    const state = { runId: cleanRunId, status: "failed", message: error instanceof Error ? error.message : String(error) };
+    const reason = error instanceof Error ? error.message : String(error);
+    const state = {
+      runId: cleanRunId,
+      status: "failed",
+      message: reason,
+      failureReason: reason,
+      ...currentAttachState(ctx, cleanRunId)?.steps ? { steps: currentAttachState(ctx, cleanRunId).steps } : {}
+    };
     patchData(ctx, { piAttach: state });
     emitFailed(ctx, label, error, { runId: cleanRunId });
     throw error;
@@ -1306,32 +1533,52 @@ async function attachRunWithBundledPi(ctx, runId) {
     throw error;
   }
   emitStarted(ctx, label, { piAttach: { runId: cleanRunId, status: "entering-pi" } });
-  patchData(ctx, { piAttach: { runId: cleanRunId, status: "entering-pi", message: "starting bundled Pi" } });
+  patchData(ctx, { piAttach: { runId: cleanRunId, status: "entering-pi", message: "starting bundled Pi", steps: [] } });
   try {
-    await preparePiAttachHandoff(ctx, cleanRunId).catch(() => null);
-    emitProgress(ctx, label, "starting Bun PTY host for bundled Pi");
+    recordStep(ctx, cleanRunId, "connecting to server and fetching run transcript", label);
+    await preparePiAttachHandoff(ctx, cleanRunId).catch((error) => {
+      patchData(ctx, { lastRefreshError: normalizeAppError(error).message });
+      return null;
+    });
+    recordStep(ctx, cleanRunId, "spawning Bun PTY host for bundled Pi", label);
     const projectRoot = projectRootOf(ctx);
     const cols = typeof process.stdout.columns === "number" ? process.stdout.columns : 100;
     const rows = Math.max(1, (typeof process.stdout.rows === "number" ? process.stdout.rows : 35) - 1);
     const patchTerminal = (snapshot) => {
+      const previousSteps = currentAttachState(ctx, cleanRunId)?.steps;
+      const failed = snapshot.status === "failed";
+      const reason = failed ? snapshot.message ?? `bundled Pi exited with code ${snapshot.exitCode ?? "unknown"}` : undefined;
       patchData(ctx, {
         piTerminal: snapshot,
         piAttach: {
           runId: cleanRunId,
-          status: snapshot.status === "failed" ? "failed" : snapshot.status === "exited" ? "returned" : "entering-pi",
+          status: failed ? "failed" : snapshot.status === "exited" ? "returned" : "entering-pi",
           message: snapshot.message ?? "bundled Pi running",
-          result: { runId: cleanRunId, status: snapshot.status, exitCode: snapshot.exitCode }
+          result: { runId: cleanRunId, status: snapshot.status, exitCode: snapshot.exitCode },
+          ...previousSteps ? { steps: previousSteps } : {},
+          ...reason ? { failureReason: reason } : {}
         }
       });
     };
+    recordStep(ctx, cleanRunId, "starting bundled Pi", label);
     await startPiPtyHost({
       runId: cleanRunId,
       projectRoot,
       cols,
       rows,
-      onSnapshot: patchTerminal,
+      onSnapshot: (snapshot) => {
+        if (snapshot.status === "running" && snapshot.lines.some((entry) => entry.trim().length > 0)) {
+          settleSteps(ctx, cleanRunId);
+        }
+        patchTerminal(snapshot);
+      },
       onExit: (snapshot) => {
         patchTerminal(snapshot);
+        if (snapshot.status === "failed") {
+          Promise.resolve().then(() => (init_inspect(), exports_inspect)).then(({ loadInspect: loadInspect2 }) => loadInspect2(ctx, cleanRunId)).catch(() => null);
+          emitFailed(ctx, label, new Error(snapshot.message ?? `bundled Pi exited with code ${snapshot.exitCode ?? "unknown"}`), { runId: cleanRunId, result: { status: snapshot.status, exitCode: snapshot.exitCode } });
+          return;
+        }
         emitCompleted(ctx, label, { runId: cleanRunId, result: { status: snapshot.status, exitCode: snapshot.exitCode } });
         ctx.emit({ type: "scene.change", scene: "fleet", intent: { scene: "fleet", argv: ["runs"], action: { kind: "refresh", label: "Opening runs" } } });
         refreshFleet(ctx).catch((error) => emitFailed(ctx, "Refresh runs", error));
@@ -1349,13 +1596,21 @@ async function attachRunWithBundledPi(ctx, runId) {
     emitProgress(ctx, label, "bundled Pi is running", { piAttach: { runId: cleanRunId, status: "entering-pi", message: "bundled Pi running", result: record } });
     return record;
   } catch (error) {
-    patchData(ctx, { piAttach: { runId: cleanRunId, status: "failed", message: error instanceof Error ? error.message : String(error) } });
+    const reason = error instanceof Error ? error.message : String(error);
+    patchData(ctx, {
+      piAttach: {
+        runId: cleanRunId,
+        status: "failed",
+        message: reason,
+        failureReason: reason,
+        ...currentAttachState(ctx, cleanRunId)?.steps ? { steps: currentAttachState(ctx, cleanRunId).steps } : {}
+      }
+    });
     emitFailed(ctx, label, error, { runId: cleanRunId });
     throw error;
   }
 }
 export {
   preparePiAttachHandoff,
-  createPiAttachAdapter,
   attachRunWithBundledPi
 };

package/dist/src/app-opentui/adapters/pi.d.ts

@@ -0,0 +1,23 @@
+import { type AppAdapterContext } from "./common";
+export type AppPiProjectPackage = {
+    readonly source: string;
+    readonly managedByRigConfig: boolean;
+};
+/** One npm search hit from `rig pi search` (details.results[]): a real
+ * installable package, rendered as a selectable row that installs inline. */
+export type AppPiSearchResult = {
+    readonly name: string;
+    readonly version: string;
+    readonly description: string;
+};
+export type AppPiSnapshot = {
+    readonly projectPackages: readonly AppPiProjectPackage[];
+    readonly userPackages: readonly string[];
+    /** The term the current search results were produced for (undefined = no
+     * search has run this session). */
+    readonly searchTerm?: string;
+    /** Results of the last `rig pi search` — each is installable inline. */
+    readonly searchResults: readonly AppPiSearchResult[];
+    readonly refreshedAt: number;
+};
+export declare function refreshPi(ctx: AppAdapterContext): Promise<AppPiSnapshot>;