@h-rig/cli 0.0.6-alpha.60 → 0.0.6-alpha.62

package/dist/src/commands/_authority-runs.js

@@ -5,8 +5,7 @@ import { resolve } from "path";
 import {
   readAuthorityRun,
   readJsonlFile,
-  resolveAuthorityRunDir,
-  writeJsonFile
+  writeAuthorityRunRecord
 } from "@rig/runtime/control-plane/authority-files";
 
 // packages/cli/src/commands/_paths.ts
@@ -100,7 +99,7 @@ function upsertAgentAuthorityRun(projectRoot, input) {
   } else if ("errorText" in next) {
     delete next.errorText;
   }
-  writeJsonFile(resolve(resolveAuthorityRunDir(projectRoot, input.runId), "run.json"), next);
+  writeAuthorityRunRecord(projectRoot, input.runId, next);
   return next;
 }
 export {

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

@@ -112,6 +112,7 @@ var PRIMARY_GROUPS = [
       { command: "stop [<run-id>|--run <id>]", description: "Request stop for one run or local active runs.", primary: true },
       { command: "steer <run-id> --message <text>", description: "Queue a steering message into a live worker without attaching." },
       { command: "timeline --run <id> [--follow]", description: "Stream raw run timeline events." },
+      { command: "replay <run-id>|--run <id> [--with-session]", description: "Print the run's consolidated run.jsonl as a merged timeline; --with-session interleaves the Pi session log." },
       { command: "resume", description: "Resume the most recent interrupted local run." },
       { command: "restart", description: "Restart the most recent local run from a clean runtime." },
       { command: "delete|cleanup", description: "Remove completed run records/artifacts." }

package/dist/src/commands/_run-driver-helpers.js

@@ -12,11 +12,13 @@ import { CliError as CliError2 } from "@rig/runtime/control-plane/errors";
 
 // packages/cli/src/commands/_run-driver-helpers.ts
 import {
-  appendJsonlRecord,
   appendRunLifecycleEvent,
+  appendRunLogEntry,
+  appendRunTimelineEntry,
+  patchAuthorityRunRecord,
   readAuthorityRun as readAuthorityRun2,
-  resolveAuthorityRunDir as resolveAuthorityRunDir2,
-  writeJsonFile as writeJsonFile2
+  resolveAuthorityRunDir,
+  writeJsonFile
 } from "@rig/runtime/control-plane/authority-files";
 import { taskLookup } from "@rig/runtime/control-plane/native/task-ops";
 import { readPriorPrProgressPromptSection } from "@rig/runtime/control-plane/prompt-context";
@@ -29,8 +31,7 @@ import { resolve as resolve2 } from "path";
 import {
   readAuthorityRun,
   readJsonlFile,
-  resolveAuthorityRunDir,
-  writeJsonFile
+  writeAuthorityRunRecord
 } from "@rig/runtime/control-plane/authority-files";
 
 // packages/cli/src/commands/_paths.ts
@@ -64,16 +65,10 @@ function readLatestBeadRecord(projectRoot, taskId) {
 
 // packages/cli/src/commands/_run-driver-helpers.ts
 function patchAuthorityRun(projectRoot, runId, patch) {
-  const current = readAuthorityRun2(projectRoot, runId);
-  if (!current) {
+  const next = patchAuthorityRunRecord(projectRoot, runId, patch);
+  if (!next) {
     throw new CliError2(`Run not found: ${runId}`, 2);
   }
-  const next = {
-    ...current,
-    ...patch,
-    updatedAt: new Date().toISOString()
-  };
-  writeJsonFile2(resolve3(resolveAuthorityRunDir2(projectRoot, runId), "run.json"), next);
   return next;
 }
 function touchAuthorityRun(projectRoot, runId) {
@@ -81,21 +76,21 @@ function touchAuthorityRun(projectRoot, runId) {
   if (!current) {
     return;
   }
-  writeJsonFile2(resolve3(resolveAuthorityRunDir2(projectRoot, runId), "run.json"), {
+  writeJsonFile(resolve3(resolveAuthorityRunDir(projectRoot, runId), "run.json"), {
     ...current,
     updatedAt: new Date().toISOString()
   });
 }
 function appendRunTimeline(projectRoot, runId, value) {
-  appendJsonlRecord(resolve3(resolveAuthorityRunDir2(projectRoot, runId), "timeline.jsonl"), value);
+  appendRunTimelineEntry(projectRoot, runId, value);
   touchAuthorityRun(projectRoot, runId);
 }
 function appendRunLog(projectRoot, runId, value) {
-  appendJsonlRecord(resolve3(resolveAuthorityRunDir2(projectRoot, runId), "logs.jsonl"), value);
+  appendRunLogEntry(projectRoot, runId, value);
   touchAuthorityRun(projectRoot, runId);
 }
 function appendRunAction(projectRoot, runId, value) {
-  appendJsonlRecord(resolve3(resolveAuthorityRunDir2(projectRoot, runId), "timeline.jsonl"), {
+  appendRunTimelineEntry(projectRoot, runId, {
     id: value.id,
     type: "action",
     actionType: value.actionType,

package/dist/src/commands/_run-replay.js

@@ -0,0 +1,142 @@
+// @bun
+// packages/cli/src/commands/_run-replay.ts
+import { existsSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import {
+  readAuthorityRun,
+  readJsonlFile,
+  runLifecycleLogPath
+} from "@rig/runtime/control-plane/authority-files";
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function text(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function snippet(value, max = 120) {
+  const raw = text(value);
+  if (!raw)
+    return null;
+  const flat = raw.replace(/\s+/g, " ");
+  return flat.length > max ? `${flat.slice(0, max - 1)}\u2026` : flat;
+}
+function summarizeLifecycleEntry(entry) {
+  const type = text(entry.type) ?? "event";
+  switch (type) {
+    case "status": {
+      const anchor = text(entry.sessionId);
+      return [
+        `status \u2192 ${text(entry.status) ?? "(unknown)"}`,
+        snippet(entry.detail) ? `\u2014 ${snippet(entry.detail)}` : null,
+        anchor ? `[session ${anchor}]` : null
+      ].filter(Boolean).join(" ");
+    }
+    case "timeline-entry": {
+      const payload = asRecord(entry.payload) ?? {};
+      const kind = text(payload.type) ?? "entry";
+      const body = snippet(payload.title) ?? snippet(payload.text) ?? snippet(payload.detail);
+      const state = text(payload.state);
+      return [`timeline ${kind}`, body ? `\u2014 ${body}` : null, state ? `(${state})` : null].filter(Boolean).join(" ");
+    }
+    case "log-entry": {
+      const payload = asRecord(entry.payload) ?? {};
+      const title = snippet(payload.title) ?? "log";
+      const detail = snippet(payload.detail);
+      return [`log ${title}`, detail ? `\u2014 ${detail}` : null].filter(Boolean).join(" ");
+    }
+    case "record-patch": {
+      const patch = asRecord(entry.patch) ?? {};
+      const keys = Object.keys(patch);
+      const shown = keys.slice(0, 8).join(", ");
+      return `record-patch {${shown}${keys.length > 8 ? `, +${keys.length - 8} more` : ""}}`;
+    }
+    case "timeline":
+      return "timeline updated (signal)";
+    case "log":
+      return `log signal${snippet(entry.title) ? ` \u2014 ${snippet(entry.title)}` : ""}`;
+    case "completed":
+      return "run completed";
+    case "failed":
+      return `run failed${snippet(entry.error) ? ` \u2014 ${snippet(entry.error)}` : ""}`;
+    default:
+      return type;
+  }
+}
+function summarizeSessionEntry(entry) {
+  const type = text(entry.type) ?? "entry";
+  const message = asRecord(entry.message);
+  const role = text(message?.role);
+  const content = message?.content;
+  let body = null;
+  if (typeof content === "string") {
+    body = snippet(content);
+  } else if (Array.isArray(content)) {
+    body = snippet(content.map((part) => text(asRecord(part)?.text) ?? "").filter(Boolean).join(" "));
+  }
+  return [
+    `pi ${type}`,
+    role ? `(${role})` : null,
+    body ? `\u2014 ${body}` : null
+  ].filter(Boolean).join(" ");
+}
+function sessionEntryTimestamp(entry) {
+  return text(entry.timestamp) ?? text(entry.at) ?? text(entry.createdAt) ?? null;
+}
+function resolveRunSessionFile(record) {
+  const piSession = record?.piSession ?? null;
+  if (!piSession)
+    return null;
+  const recorded = text(piSession.sessionFile);
+  if (recorded && existsSync(recorded)) {
+    return recorded;
+  }
+  const cwd = text(piSession.cwd);
+  const sessionId = text(piSession.sessionId);
+  if (!cwd || !sessionId)
+    return null;
+  const sessionDir = resolve(cwd, ".rig", "session");
+  try {
+    const match = readdirSync(sessionDir).find((name) => name.endsWith(`_${sessionId}.jsonl`));
+    return match ? join(sessionDir, match) : null;
+  } catch {
+    return null;
+  }
+}
+function buildRunReplay(projectRoot, runId, options = {}) {
+  const logPath = runLifecycleLogPath(projectRoot, runId);
+  const record = readAuthorityRun(projectRoot, runId);
+  const lifecycleEntries = readJsonlFile(logPath).map((entry) => asRecord(entry)).filter((entry) => entry !== null);
+  const merged = lifecycleEntries.map((entry) => ({
+    at: text(entry.at),
+    source: "run",
+    summary: summarizeLifecycleEntry(entry)
+  }));
+  let sessionFile = null;
+  let sessionEntryCount = 0;
+  if (options.withSession) {
+    sessionFile = resolveRunSessionFile(record);
+    if (sessionFile) {
+      let lastSeenAt = null;
+      const sessionLines = readJsonlFile(sessionFile).map((entry) => asRecord(entry)).filter((entry) => entry !== null).map((entry) => {
+        lastSeenAt = sessionEntryTimestamp(entry) ?? lastSeenAt;
+        return { at: lastSeenAt, source: "session", summary: summarizeSessionEntry(entry) };
+      });
+      sessionEntryCount = sessionLines.length;
+      merged.push(...sessionLines);
+      merged.sort((left, right) => (left.at ?? "").localeCompare(right.at ?? ""));
+    }
+  }
+  const lines = merged.map((line) => `${line.at ?? "(no timestamp)      "}  ${line.source === "run" ? "run    " : "session"}  ${line.summary}`);
+  return {
+    runId,
+    logPath,
+    sessionFile,
+    entryCount: lifecycleEntries.length,
+    sessionEntryCount,
+    lines
+  };
+}
+export {
+  resolveRunSessionFile,
+  buildRunReplay
+};

package/dist/src/commands/agent.js

@@ -62,8 +62,7 @@ import { resolve } from "path";
 import {
   readAuthorityRun,
   readJsonlFile,
-  resolveAuthorityRunDir,
-  writeJsonFile
+  writeAuthorityRunRecord
 } from "@rig/runtime/control-plane/authority-files";
 
 // packages/cli/src/commands/_paths.ts
@@ -157,7 +156,7 @@ function upsertAgentAuthorityRun(projectRoot, input) {
   } else if ("errorText" in next) {
     delete next.errorText;
   }
-  writeJsonFile(resolve(resolveAuthorityRunDir(projectRoot, input.runId), "run.json"), next);
+  writeAuthorityRunRecord(projectRoot, input.runId, next);
   return next;
 }
 

package/dist/src/commands/run.js

@@ -50,7 +50,7 @@ Usage: ${usage}`);
 // packages/cli/src/commands/run.ts
 import {
   listAuthorityRuns,
-  readAuthorityRun
+  readAuthorityRun as readAuthorityRun2
 } from "@rig/runtime/control-plane/authority-files";
 import {
   cleanupRunState,
@@ -429,6 +429,144 @@ async function buildRunPiEventsWebSocketUrl(context, runId) {
   return url.toString();
 }
 
+// packages/cli/src/commands/_run-replay.ts
+import { existsSync as existsSync3, readdirSync } from "fs";
+import { join, resolve as resolve3 } from "path";
+import {
+  readAuthorityRun,
+  readJsonlFile,
+  runLifecycleLogPath
+} from "@rig/runtime/control-plane/authority-files";
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function text(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function snippet(value, max = 120) {
+  const raw = text(value);
+  if (!raw)
+    return null;
+  const flat = raw.replace(/\s+/g, " ");
+  return flat.length > max ? `${flat.slice(0, max - 1)}\u2026` : flat;
+}
+function summarizeLifecycleEntry(entry) {
+  const type = text(entry.type) ?? "event";
+  switch (type) {
+    case "status": {
+      const anchor = text(entry.sessionId);
+      return [
+        `status \u2192 ${text(entry.status) ?? "(unknown)"}`,
+        snippet(entry.detail) ? `\u2014 ${snippet(entry.detail)}` : null,
+        anchor ? `[session ${anchor}]` : null
+      ].filter(Boolean).join(" ");
+    }
+    case "timeline-entry": {
+      const payload = asRecord(entry.payload) ?? {};
+      const kind = text(payload.type) ?? "entry";
+      const body = snippet(payload.title) ?? snippet(payload.text) ?? snippet(payload.detail);
+      const state = text(payload.state);
+      return [`timeline ${kind}`, body ? `\u2014 ${body}` : null, state ? `(${state})` : null].filter(Boolean).join(" ");
+    }
+    case "log-entry": {
+      const payload = asRecord(entry.payload) ?? {};
+      const title = snippet(payload.title) ?? "log";
+      const detail = snippet(payload.detail);
+      return [`log ${title}`, detail ? `\u2014 ${detail}` : null].filter(Boolean).join(" ");
+    }
+    case "record-patch": {
+      const patch = asRecord(entry.patch) ?? {};
+      const keys = Object.keys(patch);
+      const shown = keys.slice(0, 8).join(", ");
+      return `record-patch {${shown}${keys.length > 8 ? `, +${keys.length - 8} more` : ""}}`;
+    }
+    case "timeline":
+      return "timeline updated (signal)";
+    case "log":
+      return `log signal${snippet(entry.title) ? ` \u2014 ${snippet(entry.title)}` : ""}`;
+    case "completed":
+      return "run completed";
+    case "failed":
+      return `run failed${snippet(entry.error) ? ` \u2014 ${snippet(entry.error)}` : ""}`;
+    default:
+      return type;
+  }
+}
+function summarizeSessionEntry(entry) {
+  const type = text(entry.type) ?? "entry";
+  const message = asRecord(entry.message);
+  const role = text(message?.role);
+  const content = message?.content;
+  let body = null;
+  if (typeof content === "string") {
+    body = snippet(content);
+  } else if (Array.isArray(content)) {
+    body = snippet(content.map((part) => text(asRecord(part)?.text) ?? "").filter(Boolean).join(" "));
+  }
+  return [
+    `pi ${type}`,
+    role ? `(${role})` : null,
+    body ? `\u2014 ${body}` : null
+  ].filter(Boolean).join(" ");
+}
+function sessionEntryTimestamp(entry) {
+  return text(entry.timestamp) ?? text(entry.at) ?? text(entry.createdAt) ?? null;
+}
+function resolveRunSessionFile(record) {
+  const piSession = record?.piSession ?? null;
+  if (!piSession)
+    return null;
+  const recorded = text(piSession.sessionFile);
+  if (recorded && existsSync3(recorded)) {
+    return recorded;
+  }
+  const cwd = text(piSession.cwd);
+  const sessionId = text(piSession.sessionId);
+  if (!cwd || !sessionId)
+    return null;
+  const sessionDir = resolve3(cwd, ".rig", "session");
+  try {
+    const match = readdirSync(sessionDir).find((name) => name.endsWith(`_${sessionId}.jsonl`));
+    return match ? join(sessionDir, match) : null;
+  } catch {
+    return null;
+  }
+}
+function buildRunReplay(projectRoot, runId, options = {}) {
+  const logPath = runLifecycleLogPath(projectRoot, runId);
+  const record = readAuthorityRun(projectRoot, runId);
+  const lifecycleEntries = readJsonlFile(logPath).map((entry) => asRecord(entry)).filter((entry) => entry !== null);
+  const merged = lifecycleEntries.map((entry) => ({
+    at: text(entry.at),
+    source: "run",
+    summary: summarizeLifecycleEntry(entry)
+  }));
+  let sessionFile = null;
+  let sessionEntryCount = 0;
+  if (options.withSession) {
+    sessionFile = resolveRunSessionFile(record);
+    if (sessionFile) {
+      let lastSeenAt = null;
+      const sessionLines = readJsonlFile(sessionFile).map((entry) => asRecord(entry)).filter((entry) => entry !== null).map((entry) => {
+        lastSeenAt = sessionEntryTimestamp(entry) ?? lastSeenAt;
+        return { at: lastSeenAt, source: "session", summary: summarizeSessionEntry(entry) };
+      });
+      sessionEntryCount = sessionLines.length;
+      merged.push(...sessionLines);
+      merged.sort((left, right) => (left.at ?? "").localeCompare(right.at ?? ""));
+    }
+  }
+  const lines = merged.map((line) => `${line.at ?? "(no timestamp)      "}  ${line.source === "run" ? "run    " : "session"}  ${line.summary}`);
+  return {
+    runId,
+    logPath,
+    sessionFile,
+    entryCount: lifecycleEntries.length,
+    sessionEntryCount,
+    lines
+  };
+}
+
 // packages/cli/src/commands/_operator-surface.ts
 import { createInterface } from "readline";
 var CANONICAL_STAGES = [
@@ -526,22 +664,22 @@ function createPiRunStreamRenderer(output = process.stdout) {
       for (const [index, entry] of entries.entries()) {
         const id = entryId(entry, `timeline:${index}:${String(entry.cursor ?? "")}`);
         if (entry.type === "assistant_message" && typeof entry.text === "string") {
-          const text = entry.text;
+          const text2 = entry.text;
           const previousText = assistantTextById.get(id) ?? "";
-          if (!previousText && text.trim()) {
+          if (!previousText && text2.trim()) {
             writeLine("[Pi assistant]");
           }
-          if (text.startsWith(previousText)) {
-            const delta = text.slice(previousText.length);
+          if (text2.startsWith(previousText)) {
+            const delta = text2.slice(previousText.length);
             if (delta)
               output.write(delta);
-          } else if (text.trim() && text !== previousText) {
+          } else if (text2.trim() && text2 !== previousText) {
             if (previousText)
               writeLine(`
 [Pi assistant]`);
-            output.write(text);
+            output.write(text2);
           }
-          assistantTextById.set(id, text);
+          assistantTextById.set(id, text2);
           continue;
         }
         if (seenTimeline.has(id))
@@ -556,15 +694,15 @@ function createPiRunStreamRenderer(output = process.stdout) {
           continue;
         }
         if (entry.type === "action") {
-          const text = String(entry.detail ?? entry.message ?? entry.title ?? "").trim();
-          if (text)
-            writeLine(`[Rig action] ${text}`);
+          const text2 = String(entry.detail ?? entry.message ?? entry.title ?? "").trim();
+          if (text2)
+            writeLine(`[Rig action] ${text2}`);
           continue;
         }
         if (entry.type === "user_message") {
-          const text = String(entry.text ?? entry.message ?? entry.detail ?? "").trim();
-          if (text)
-            writeLine(`[Operator] ${text}`);
+          const text2 = String(entry.text ?? entry.message ?? entry.detail ?? "").trim();
+          if (text2)
+            writeLine(`[Operator] ${text2}`);
           continue;
         }
         const fallback = String(entry.detail ?? entry.message ?? entry.text ?? entry.title ?? "").trim();
@@ -624,7 +762,7 @@ function createOperatorSurface(options = {}) {
 // packages/cli/src/commands/_pi-frontend.ts
 import { mkdtempSync, rmSync } from "fs";
 import { tmpdir } from "os";
-import { join } from "path";
+import { join as join2 } from "path";
 import {
   createAgentSessionFromServices,
   createAgentSessionServices,
@@ -756,15 +894,15 @@ class RigRemoteSessionController {
     for (const compaction of this.pendingCompactions.splice(0))
       compaction.reject(new Error("Remote session closed."));
   }
-  async sendPrompt(text, streamingBehavior) {
-    await this.transport.sendPrompt(this.context, this.runId, text, streamingBehavior);
+  async sendPrompt(text2, streamingBehavior) {
+    await this.transport.sendPrompt(this.context, this.runId, text2, streamingBehavior);
   }
-  async sendCommand(text) {
-    const result = await this.transport.runCommand(this.context, this.runId, text);
+  async sendCommand(text2) {
+    const result = await this.transport.runCommand(this.context, this.runId, text2);
     return typeof result.message === "string" ? result.message : "worker command accepted";
   }
-  async sendShell(text) {
-    await this.transport.sendShell(this.context, this.runId, text);
+  async sendShell(text2) {
+    await this.transport.sendShell(this.context, this.runId, text2);
   }
   async abort() {
     await this.transport.abort(this.context, this.runId);
@@ -916,8 +1054,8 @@ class RigRemoteAgentSession extends PiAgentSession {
   replaceRemoteMessages(messages) {
     this.agent.state.messages = messages;
   }
-  async expandLocalInput(text) {
-    let current = text;
+  async expandLocalInput(text2) {
+    let current = text2;
     const runner = this.extensionRunner;
     if (runner.hasHandlers("input")) {
       const result = await runner.emitInput(current, undefined, "interactive");
@@ -930,8 +1068,8 @@ class RigRemoteAgentSession extends PiAgentSession {
     current = expandPromptTemplate(current, [...this.promptTemplates]);
     return current;
   }
-  async prompt(text, options) {
-    const trimmed = text.trim();
+  async prompt(text2, options) {
+    const trimmed = text2.trim();
     if (!trimmed)
       return;
     if (trimmed.startsWith("/")) {
@@ -960,8 +1098,8 @@ class RigRemoteAgentSession extends PiAgentSession {
     options?.preflightResult?.(true);
     await this.remote.sendPrompt(expanded, behavior);
   }
-  async steer(text) {
-    const trimmed = text.trim();
+  async steer(text2) {
+    const trimmed = text2.trim();
     if (trimmed.startsWith("/") && await this._tryExecuteExtensionCommand(trimmed))
       return;
     const expanded = await this.expandLocalInput(trimmed);
@@ -969,8 +1107,8 @@ class RigRemoteAgentSession extends PiAgentSession {
       return;
     await this.remote.sendPrompt(expanded, "steer");
   }
-  async followUp(text) {
-    const trimmed = text.trim();
+  async followUp(text2) {
+    const trimmed = text2.trim();
     if (trimmed.startsWith("/") && await this._tryExecuteExtensionCommand(trimmed))
       return;
     const expanded = await this.expandLocalInput(trimmed);
@@ -982,8 +1120,8 @@ class RigRemoteAgentSession extends PiAgentSession {
     await this.remote.abort();
   }
   async compact(customInstructions) {
-    const pending = new Promise((resolve3, reject) => {
-      this.remote.registerPendingCompaction({ resolve: resolve3, reject });
+    const pending = new Promise((resolve4, reject) => {
+      this.remote.registerPendingCompaction({ resolve: resolve4, reject });
     });
     await this.remote.sendCommand(`/compact${customInstructions ? ` ${customInstructions}` : ""}`);
     return pending;
@@ -1052,8 +1190,8 @@ class RigRemoteAgentSession extends PiAgentSession {
 function createRemoteBashOperations(controller, excludeFromContext) {
   return {
     exec(command, _cwd, execOptions) {
-      return new Promise((resolve3, reject) => {
-        const pending = { onData: execOptions.onData, resolve: resolve3, reject, sawChunk: false };
+      return new Promise((resolve4, reject) => {
+        const pending = { onData: execOptions.onData, resolve: resolve4, reject, sawChunk: false };
         const cleanup = () => {
           execOptions.signal?.removeEventListener("abort", onAbort);
           if (timer)
@@ -1217,8 +1355,8 @@ function createRigWorkerPiBridgeExtension(options) {
       const prefix = busy ? `${SPINNER_FRAMES[frame]} ` : connected ? "\u25CF " : "\u25CB ";
       ctx.ui.setStatus("rig-worker-pi", `${prefix}${statusText}`);
     };
-    const setStatus = (ctx, text, isBusy) => {
-      statusText = text;
+    const setStatus = (ctx, text2, isBusy) => {
+      statusText = text2;
       busy = isBusy;
       renderStatus(ctx);
     };
@@ -1262,7 +1400,7 @@ function createRigWorkerPiBridgeExtension(options) {
         ctx.ui.notify("Initial message sent to the worker Pi daemon.", "info");
       const nativeUi = ctx.ui;
       options.controller.setUiHooks({
-        onStatusText: (text) => setStatus(ctx, text, !connected),
+        onStatusText: (text2) => setStatus(ctx, text2, !connected),
         onActivity: (label, detail) => {
           const active = label !== "idle" && !/complete|ready/i.test(label);
           setStatus(ctx, [label, detail].filter(Boolean).join(" \u2014 "), active);
@@ -1319,7 +1457,7 @@ function setTemporaryEnv(updates) {
   };
 }
 async function attachRunBundledPiFrontend(context, input) {
-  const tempSessionDir = mkdtempSync(join(tmpdir(), "rig-pi-frontend-sessions-"));
+  const tempSessionDir = mkdtempSync(join2(tmpdir(), "rig-pi-frontend-sessions-"));
   const restoreEnv = setTemporaryEnv({
     PI_CODING_AGENT_SESSION_DIR: tempSessionDir,
     PI_SKIP_VERSION_CHECK: "1",
@@ -1833,7 +1971,7 @@ async function executeRun(context, args) {
       if (!runId) {
         throw new CliError2("run show requires a run id.");
       }
-      const record = readAuthorityRun(context.projectRoot, runId) ?? normalizeRemoteRunDetails(await getRunDetailsViaServer(context, runId).catch(() => ({})));
+      const record = readAuthorityRun2(context.projectRoot, runId) ?? normalizeRemoteRunDetails(await getRunDetailsViaServer(context, runId).catch(() => ({})));
       if (!record) {
         throw new CliError2(`Run not found: ${runId}`, 2);
       }
@@ -1871,6 +2009,46 @@ async function executeRun(context, args) {
       }
       return { ok: true, group: "run", command, details: { runId: run.value, events, cursor } };
     }
+    case "replay": {
+      let pending = rest;
+      const run = takeOption(pending, "--run");
+      pending = run.rest;
+      const withSession = takeFlag(pending, "--with-session");
+      pending = withSession.rest;
+      const positionalRunId = pending.length > 0 && pending[0] && !pending[0].startsWith("-") ? pending[0] : undefined;
+      const extra = positionalRunId ? pending.slice(1) : pending;
+      requireNoExtraArgs(extra, "rig run replay <id>|--run <id> [--with-session]");
+      const runId = run.value ?? positionalRunId;
+      if (!runId) {
+        throw new CliError2("run replay requires a run id.", 2);
+      }
+      const replay = buildRunReplay(context.projectRoot, runId, { withSession: withSession.value });
+      if (replay.entryCount === 0 && replay.sessionEntryCount === 0) {
+        throw new CliError2(`No run.jsonl lifecycle log found for ${runId} (looked at ${replay.logPath}).`, 2);
+      }
+      if (context.outputMode === "text") {
+        console.log(`Replay of ${runId} (${replay.entryCount} lifecycle entries${withSession.value ? `, ${replay.sessionEntryCount} session entries` : ""}):`);
+        for (const line of replay.lines) {
+          console.log(line);
+        }
+        if (withSession.value && !replay.sessionFile) {
+          console.log("(no Pi session file resolvable from the run record; showing run.jsonl only)");
+        }
+      }
+      return {
+        ok: true,
+        group: "run",
+        command,
+        details: {
+          runId,
+          logPath: replay.logPath,
+          sessionFile: replay.sessionFile,
+          entryCount: replay.entryCount,
+          sessionEntryCount: replay.sessionEntryCount,
+          lines: replay.lines
+        }
+      };
+    }
     case "attach": {
       let pending = rest;
       const runOption = takeOption(pending, "--run");

package/dist/src/commands/server.js

@@ -39,8 +39,7 @@ import { resolveRigServerCommand } from "@rig/runtime/local-server";
 import {
   readAuthorityRun,
   readJsonlFile,
-  resolveAuthorityRunDir,
-  writeJsonFile
+  writeAuthorityRunRecord
 } from "@rig/runtime/control-plane/authority-files";
 
 // packages/cli/src/commands/_paths.ts
@@ -89,7 +88,7 @@ function readJsonFile(path) {
     throw new CliError2(`Invalid Rig connection state at ${path}: ${error instanceof Error ? error.message : String(error)}`, 1);
   }
 }
-function writeJsonFile2(path, value) {
+function writeJsonFile(path, value) {
   mkdirSync(dirname(path), { recursive: true });
   writeFileSync(path, `${JSON.stringify(value, null, 2)}
 `, "utf8");
@@ -124,7 +123,7 @@ function readGlobalConnections(options = {}) {
   return { connections };
 }
 function writeGlobalConnections(state, options = {}) {
-  writeJsonFile2(resolveGlobalConnectionsPath(options.env ?? process.env), state);
+  writeJsonFile(resolveGlobalConnectionsPath(options.env ?? process.env), state);
 }
 function upsertGlobalConnection(alias, connection, options = {}) {
   const cleanAlias = alias.trim();
@@ -151,7 +150,7 @@ function readRepoConnection(projectRoot) {
   };
 }
 function writeRepoConnection(projectRoot, state) {
-  writeJsonFile2(resolveRepoConnectionPath(projectRoot), state);
+  writeJsonFile(resolveRepoConnectionPath(projectRoot), state);
 }
 function resolveSelectedConnection(projectRoot, options = {}) {
   const repo = readRepoConnection(projectRoot);