@linzumi/cli 1.0.113 → 1.0.114

package/README.md

@@ -58,7 +58,7 @@ Install the CLI or run it with `npx`:
 ```bash
 npm install -g @linzumi/cli@latest
 npx -y @linzumi/cli@latest signup
-npx -y @linzumi/cli@1.0.113 --version
+npx -y @linzumi/cli@1.0.114 --version
 linzumi --version
 ```
 

package/dist/index.js

@@ -1473,7 +1473,7 @@ To kick the agent off:
 `,O=Buffer.byteLength(T,"utf8");if(O>s)return l("runner_diagnostics.spool_entry_dropped",{reason:"entry_too_large",entry_bytes:O,max_entry_bytes:s}),!1;VSe(n,{recursive:!0}),m(u)+O>i&&f(),_(O);let E=b()?`
 `:"";return BSe(u,`${E}${T}`,"utf8"),!0}catch(R){return l("runner_diagnostics.spool_failed",{error:R instanceof Error?R.message:String(R)}),!1}},v=k=>{let R=[],T=HSe(k,"utf8");for(let O of T.split(`
 `))if(O.trim()!=="")try{let E=JSON.parse(O);E!==null&&typeof E=="object"&&R.push({parsed:E,raw:O})}catch{}return R};return{append:S,drain:async k=>{if(c)return{uploadedBatches:0,uploadedEntries:0,remainingBatches:p().length,skipped:!0};c=!0;let R=0,T=0;try{f(),_(0);let O=a()-o;for(let E of p()){let j;try{j=v(E)}catch(H){l("runner_diagnostics.spool_batch_unreadable",{file:E,error:H instanceof Error?H.message:String(H)}),y(E,"unreadable");continue}let z=j.filter(H=>{let ce=lke(H.parsed);return ce===void 0||ce>=O});if(z.length===0){y(E,"empty_or_expired");continue}let D=vP(E,".jsonl"),U=z.map(H=>H.raw).join(`
-`),J=z.map(H=>H.parsed.spooled_at).filter(H=>typeof H=="string"),Z={bundle_name:"runner-diagnostics-spool",exported_at:new Date(a()).toISOString(),idempotency_key:D,diagnostics:{kind:"runner_diagnostic_log",spool_batch:!0,idempotency_key:D,entry_count:z.length,...J.length===0?{}:{first_spooled_at:J[0],last_spooled_at:J[J.length-1]}},telemetry_ndjson:U};try{await k(Z)}catch(H){l("runner_diagnostics.spool_upload_failed",{file:E,remaining_batches:p().length,error:H instanceof Error?H.message:String(H)});break}R+=1,T+=z.length;try{V9(E)}catch(H){l("runner_diagnostics.spool_delete_failed",{file:E,error:H instanceof Error?H.message:String(H)})}}}catch(O){l("runner_diagnostics.spool_drain_failed",{error:O instanceof Error?O.message:String(O)})}finally{c=!1}return{uploadedBatches:R,uploadedEntries:T,remainingBatches:p().length,skipped:!1}},pendingBatchFiles:p}}var eke,nke,tke,rke,oke,W9,ske,ake,G9=F(()=>{"use strict";cx();eke=32*1024*1024,nke=10080*60*1e3,tke=4*1024*1024,rke=1024*1024,oke="spool.jsonl",W9=/^batch-(\d{1,16})-[0-9a-f-]+\.jsonl$/;ske=/\b([A-Z][A-Z0-9_]{1,})=("[^"\n]*"|'[^'\n]*'|[^\s"'`;,)\]}]+)/g,ake=/(?:\/(?:[A-Za-z0-9._@~+-]|%[0-9A-Fa-f]{2})+){2,}/g});var Nt,kP,ra=F(()=>{"use strict";Nt="1.0.113",kP=`linzumi ${Nt}`});import{closeSync as Q9,existsSync as TP,mkdirSync as pke,openSync as X9,readFileSync as Y9,renameSync as fke,unlinkSync as kd,writeFileSync as mke,writeSync as e3}from"node:fs";import{dirname as n3,join as hke}from"node:path";function PP(e){return e instanceof xs||e instanceof Error&&e.name===r3&&"lockPath"in e&&"heldBy"in e}function IP(e,n=Hn(),t){let r=t===void 0?encodeURIComponent(e):gd(t);return hke(n3(n),"runners",`${r}.lock`)}function w_(e){let n=IP(e.machineId,e.configPath,e.linzumiUrl),t=e.isPidAlive??c3,r=e.now??(()=>new Date),o=e.killPid??Ike,i=r().toISOString(),s={version:1,machineId:e.machineId,runnerId:e.runnerId,pid:e.pid??process.pid,cwd:e.cwd,workspace:e.workspace,...e.linzumiUrl===void 0?{}:{linzumiUrl:zn(e.linzumiUrl)},...e.launchSource===void 0?{}:{launchSource:e.launchSource},startedAt:i,heartbeatAt:i,cliVersion:e.cliVersion??Nt,...e.gracefulUpdateDrain===!0?{gracefulUpdateDrain:!0}:{}};_ke(e.machineId,e.configPath,e.linzumiUrl,t,r,o,e.onTakeover),bke(n,s,t,r,o,e.onTakeover,e.beforeReadExistingLock,e.beforeReplaceStaleLock);let a=()=>o3(n,s,r),d=setInterval(a,t3);return d.unref(),{path:n,record:s,heartbeat:a,release:()=>{clearInterval(d),d3(n,s)}}}function o3(e,n,t){try{let r=S_(e);if(r===void 0||r.machineId!==n.machineId||r.runnerId!==n.runnerId||r.pid!==n.pid||r.startedAt!==n.startedAt)return;let o={...r,heartbeatAt:t().toISOString()},i=`${e}.tmp`;mke(i,`${JSON.stringify(o,null,2)}
+`),J=z.map(H=>H.parsed.spooled_at).filter(H=>typeof H=="string"),Z={bundle_name:"runner-diagnostics-spool",exported_at:new Date(a()).toISOString(),idempotency_key:D,diagnostics:{kind:"runner_diagnostic_log",spool_batch:!0,idempotency_key:D,entry_count:z.length,...J.length===0?{}:{first_spooled_at:J[0],last_spooled_at:J[J.length-1]}},telemetry_ndjson:U};try{await k(Z)}catch(H){l("runner_diagnostics.spool_upload_failed",{file:E,remaining_batches:p().length,error:H instanceof Error?H.message:String(H)});break}R+=1,T+=z.length;try{V9(E)}catch(H){l("runner_diagnostics.spool_delete_failed",{file:E,error:H instanceof Error?H.message:String(H)})}}}catch(O){l("runner_diagnostics.spool_drain_failed",{error:O instanceof Error?O.message:String(O)})}finally{c=!1}return{uploadedBatches:R,uploadedEntries:T,remainingBatches:p().length,skipped:!1}},pendingBatchFiles:p}}var eke,nke,tke,rke,oke,W9,ske,ake,G9=F(()=>{"use strict";cx();eke=32*1024*1024,nke=10080*60*1e3,tke=4*1024*1024,rke=1024*1024,oke="spool.jsonl",W9=/^batch-(\d{1,16})-[0-9a-f-]+\.jsonl$/;ske=/\b([A-Z][A-Z0-9_]{1,})=("[^"\n]*"|'[^'\n]*'|[^\s"'`;,)\]}]+)/g,ake=/(?:\/(?:[A-Za-z0-9._@~+-]|%[0-9A-Fa-f]{2})+){2,}/g});var Nt,kP,ra=F(()=>{"use strict";Nt="1.0.114",kP=`linzumi ${Nt}`});import{closeSync as Q9,existsSync as TP,mkdirSync as pke,openSync as X9,readFileSync as Y9,renameSync as fke,unlinkSync as kd,writeFileSync as mke,writeSync as e3}from"node:fs";import{dirname as n3,join as hke}from"node:path";function PP(e){return e instanceof xs||e instanceof Error&&e.name===r3&&"lockPath"in e&&"heldBy"in e}function IP(e,n=Hn(),t){let r=t===void 0?encodeURIComponent(e):gd(t);return hke(n3(n),"runners",`${r}.lock`)}function w_(e){let n=IP(e.machineId,e.configPath,e.linzumiUrl),t=e.isPidAlive??c3,r=e.now??(()=>new Date),o=e.killPid??Ike,i=r().toISOString(),s={version:1,machineId:e.machineId,runnerId:e.runnerId,pid:e.pid??process.pid,cwd:e.cwd,workspace:e.workspace,...e.linzumiUrl===void 0?{}:{linzumiUrl:zn(e.linzumiUrl)},...e.launchSource===void 0?{}:{launchSource:e.launchSource},startedAt:i,heartbeatAt:i,cliVersion:e.cliVersion??Nt,...e.gracefulUpdateDrain===!0?{gracefulUpdateDrain:!0}:{}};_ke(e.machineId,e.configPath,e.linzumiUrl,t,r,o,e.onTakeover),bke(n,s,t,r,o,e.onTakeover,e.beforeReadExistingLock,e.beforeReplaceStaleLock);let a=()=>o3(n,s,r),d=setInterval(a,t3);return d.unref(),{path:n,record:s,heartbeat:a,release:()=>{clearInterval(d),d3(n,s)}}}function o3(e,n,t){try{let r=S_(e);if(r===void 0||r.machineId!==n.machineId||r.runnerId!==n.runnerId||r.pid!==n.pid||r.startedAt!==n.startedAt)return;let o={...r,heartbeatAt:t().toISOString()},i=`${e}.tmp`;mke(i,`${JSON.stringify(o,null,2)}
 `,"utf8"),fke(i,e)}catch{}}function Cd(e,n,t){if(!n(e.pid))return{state:"dead"};let r=e.heartbeatAt??e.startedAt,o=Date.parse(r);return Number.isNaN(o)||t().getTime()-o>gke?{state:"wedged",reason:e.heartbeatAt===void 0?"missing_heartbeat":"stale_heartbeat"}:{state:"live"}}function i3(e,n,t,r){return t!==v_||e.launchSource!==v_?!1:r.state!=="live"?!0:yke(n,e.cliVersion)>0}function yke(e,n){let t=Z9(e),r=Z9(n);for(let o=0;o<3;o++){let i=t.core[o],s=r.core[o];if(i===void 0||s===void 0)throw new Error(`compareCliVersions: unexpected undefined at core index ${o}`);if(i!==s)return i>s?1:-1}return t.prerelease.length===0&&r.prerelease.length===0?0:t.prerelease.length===0?1:r.prerelease.length===0?-1:xke(t.prerelease,r.prerelease)}function Z9(e){let n=e.trim().replace(/^v/i,"").split("+",1)[0]??"",t=n.indexOf("-"),r=t===-1?n:n.slice(0,t),o=t===-1?"":n.slice(t+1),i=r.split("."),s=[CP(i[0]),CP(i[1]),CP(i[2])],a=o===""?[]:o.split(".").filter(d=>d!=="");return{core:s,prerelease:a}}function CP(e){let n=Number.parseInt(e??"",10);return Number.isInteger(n)&&n>=0?n:0}function xke(e,n){let t=Math.max(e.length,n.length);for(let r=0;r<t;r++){let o=e[r],i=n[r];if(o===void 0)return-1;if(i===void 0)return 1;let s=Number.parseInt(o,10),a=Number.parseInt(i,10),d=s.toString()===o,u=a.toString()===i;if(d&&u){if(s!==a)return s>a?1:-1}else{if(d!==u)return d?-1:1;if(o!==i)return o>i?1:-1}}return 0}function s3(e,n,t,r,o){try{r(n.pid)}catch(i){let s=i!==null&&typeof i=="object"&&"code"in i?i.code:void 0;if(s!=="ESRCH")throw s==="EPERM"||s==="EACCES"?new Error(`Cannot take over the runner lock at ${e}: its holder process (pid ${n.pid}) is owned by another user and cannot be stopped. Stop that process, or remove the lock file, then retry.`):i}o?.({lockPath:e,holderPid:n.pid,holderRunnerId:n.runnerId,reason:t})}function _ke(e,n,t,r,o,i,s){if(t===void 0||xr(t)!==xr(Kt))return;let a=IP(e,n),d=S_(a);if(d!==void 0){if(Cd(d,r,o).state==="live")throw new xs(a,d);a3(a,r,()=>{let u=TP(a)?RP(a):void 0;if(u===void 0)return;let c=Cd(u,r,o);if(c.state==="live")throw new xs(a,u);c.state==="wedged"&&s3(a,u,c.reason,i,s),kd(a)})}}function bke(e,n,t,r,o,i,s,a){if(b_(e,n))return;s?.();let d=S_(e);if(d===void 0){if(b_(e,n))return;throw new Error(`another Linzumi runner lock appeared while starting: ${e}`)}if(Cd(d,t,r).state==="live")throw new xs(e,d);a?.(),a3(e,t,()=>{let u=TP(e)?RP(e):void 0;if(u!==void 0){let c=Cd(u,t,r);if(c.state==="live")throw new xs(e,u);c.state==="wedged"&&s3(e,u,c.reason,o,i),kd(e)}if(!b_(e,n))throw new Error(`another Linzumi runner lock appeared while starting: ${e}`)})}function b_(e,n){pke(n3(e),{recursive:!0});try{let t=X9(e,"wx");try{e3(t,`${JSON.stringify(n,null,2)}
 `)}finally{Q9(t)}return!0}catch(t){if(Zc(t,"EEXIST"))return!1;throw t}}function a3(e,n,t){let r=`${e}.replace`;for(;;)try{let o=X9(r,"wx");try{e3(o,`${process.pid}
 `),t()}finally{Q9(o),kd(r)}return}catch(o){if(Zc(o,"EEXIST")){let i=wke(r);if(i===void 0)continue;if(n(i))throw new Error(["another Linzumi runner is already replacing a stale runner lock",`lock: ${e}`,"Wait for that startup to finish, then retry."].join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linzumi/cli",
-  "version": "1.0.113",
+  "version": "1.0.114",
   "description": "Linzumi CLI \u2014 point a Codex agent at the real code on your laptop, with your team watching and steering from shared threads.",
   "type": "module",
   "bin": {

package/scripts/build-tui-demo-evidence.mjs

@@ -0,0 +1,107 @@
+// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md
+// (M3 cluster 11, the TUI - visual evidence).
+// Relationship: Builds the TS-side VISUAL-EVIDENCE demo driver: a bundle
+// that mounts the REAL TS commander console TUI (reportRunnerConsoleEvent
+// on a live TTY) and replays the SAME dummy-event feed the ReScript demo
+// entrypoint replays
+// (packages/linzumi-cli-rescript/src/tui/commanderTuiDemoFeed.json), so
+// the cluster's before/after terminal captures compare the two
+// implementations on identical input.
+//
+// Run (inside a real terminal / tmux pane):
+//   node scripts/build-tui-demo-evidence.mjs
+//   LINZUMI_TUI_DEMO_FIXED_NOW=<ms> node .differential/tui-demo.mjs
+//
+// Env knobs (mirroring the ReScript demo):
+//   LINZUMI_TUI_DEMO_FIXED_NOW  pin Date.now() (and therefore every
+//                               time-ago cell + the render ticker clock)
+//                               so captures are deterministic.
+//
+// The output is a local evidence artifact (.differential/ is gitignored,
+// never published).
+import { mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { build } from 'esbuild';
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+
+const driverSource = `
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { reportRunnerConsoleEvent } from './src/runnerConsoleReporter';
+
+const fixedNowRaw = process.env.LINZUMI_TUI_DEMO_FIXED_NOW;
+const fixedNow = fixedNowRaw === undefined ? undefined : Number(fixedNowRaw);
+if (fixedNow !== undefined && Number.isFinite(fixedNow)) {
+  const RealDate = Date;
+  class FixedDate extends RealDate {
+    constructor(...args) {
+      if (args.length === 0) {
+        super(fixedNow);
+      } else {
+        super(...args);
+      }
+    }
+    static now() {
+      return fixedNow;
+    }
+  }
+  globalThis.Date = FixedDate;
+}
+
+const now = Date.now();
+
+// Resolve *_offset timestamp fields against the demo clock (the ReScript
+// demo performs the same resolution).
+function resolveOffsets(value) {
+  if (Array.isArray(value)) {
+    return value.map(resolveOffsets);
+  }
+  if (value !== null && typeof value === 'object') {
+    const out = {};
+    for (const [key, entry] of Object.entries(value)) {
+      if (key.endsWith('_offset') && typeof entry === 'number') {
+        out[key.slice(0, -'_offset'.length)] = now + entry;
+      } else {
+        out[key] = resolveOffsets(entry);
+      }
+    }
+    return out;
+  }
+  return value;
+}
+
+const feedPath = join(
+  process.cwd(),
+  '../linzumi-cli-rescript/src/tui/commanderTuiDemoFeed.json'
+);
+const feed = JSON.parse(readFileSync(feedPath, 'utf8'));
+for (const entry of feed.events) {
+  reportRunnerConsoleEvent(entry.event, resolveOffsets(entry.payload));
+}
+
+// Keep the process (and the TUI) alive for interactive navigation; the
+// TUI's own C-c binding exits.
+setInterval(() => {}, 1000);
+`;
+
+await mkdir(join(packageRoot, '.differential'), { recursive: true });
+
+await build({
+  stdin: {
+    contents: driverSource,
+    resolveDir: packageRoot,
+    sourcefile: 'tui-demo-driver.ts',
+    loader: 'ts',
+  },
+  bundle: true,
+  platform: 'node',
+  target: 'node20',
+  format: 'esm',
+  outfile: join(packageRoot, '.differential/tui-demo.mjs'),
+  minify: false,
+  sourcemap: false,
+  legalComments: 'none',
+  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
+});

package/scripts/build-tui-parity-oracle.mjs

@@ -0,0 +1,577 @@
+// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md
+// (M3 cluster 11, the TUI).
+// Relationship: Builds the TS-side PARITY ORACLE for the commander
+// console/TUI port - the deterministic core of the console-reporter module
+// (dashboard state fold, selection machinery, key/chunk parsers, every
+// render surface incl. the TUI table/header-layout models) plus the
+// blessed hardening transforms (terminfo conditional repair, the ACS
+// charset fix, the #2955 screen-registry sweep) and the reporter's
+// teardown/degrade/fail-soft latches. ONE bundle imports the REAL TS
+// module exports behind the one-shot batch driver: a JSON array of cases
+// on stdin, a JSON array of results on stdout. The ReScript package's
+// ConsoleTuiParityConformance drives the SAME inputs through
+// src/tui/CommanderConsole* / CommanderTuiGuards and asserts byte-equal
+// rendered strings, deep-equal state projections, and identical event
+// traces.
+//
+// Determinism: every op is pure given its inputs - clocks arrive as
+// explicit nowMs values, and the reporter-latch ops reset the module
+// latches per case via the exported *ForTest hooks. The teardown/degrade
+// ops route observability through explicit sinks (so the TS default audit
+// sink never fires), and scripted dashboards/streams throw
+// deterministically shaped errors.
+//
+// SECRETS: the oracle only ever sees the conformance suite's synthetic
+// payloads; nothing here logs case contents.
+//
+// The output is a local test artifact (.differential/ is gitignored, never
+// published) and stays unminified for debuggability.
+import { mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { build } from 'esbuild';
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+
+const driverSource = `
+import {
+  arrowKeysInRawChunk,
+  createRunnerConsoleDashboard,
+  dashboardJobKeyAtTableRow,
+  dashboardNoticeLines,
+  droppedArrowKeysInRawChunk,
+  formatRunnerConsoleEvent,
+  keypressIsEscape,
+  rawInputChunkContainsMouseReport,
+  rawInputChunkSignalsEscape,
+  renderRunnerConsoleDashboard,
+  resolveSelectionAfterRefresh,
+  runnerConsoleDashboardTableModel,
+  runnerConsoleTuiEscapePressed,
+  runnerConsoleTuiHeaderLayout,
+  selectDashboardJobAtVisibleIndex,
+  selectDashboardJobByKey,
+  tableSelectionPageStep,
+  tableSelectionRowIndex,
+  updateRunnerConsoleDashboard,
+  updateRunnerConsoleDashboardMode,
+  createRunnerConsoleDashboardTuiFailSoft,
+  resetRunnerConsoleDashboardTuiConstructionForTest,
+  teardownRunnerConsoleDashboardTuiSafely,
+  degradeRunnerConsoleTuiToHeadless,
+  resetRunnerConsoleTuiDegradeForTest,
+  runnerConsoleTuiDegradedToHeadless,
+  setRunnerConsoleDashboardTuiForTest,
+  runnerConsoleDashboardTuiActiveForTest,
+} from './src/runnerConsoleReporter';
+import { balanceTerminfoConditionals } from './src/blessedTputSetulcShim';
+import {
+  applyBlessedAcsCharsetFix,
+  blessedWouldUseAcsCharset,
+  forceUnicodeBoxDrawingOnTput,
+} from './src/blessedAcsCharsetShim';
+import {
+  constructBlessedScreenGuarded,
+  detachBlessedScreenFromRegistry,
+  sweepStrandedBlessedScreens,
+} from './src/blessedScreenLifecycleGuard';
+import { linzumiCliVersion } from './src/version';
+
+// --- Projections ------------------------------------------------------------------------
+
+const orNull = (value) => (value === undefined ? null : value);
+
+function projectJob(job) {
+  return {
+    key: job.key,
+    createdAtMs: job.createdAtMs,
+    createdOrdinal: job.createdOrdinal,
+    agentProvider: orNull(job.agentProvider),
+    linzumiThreadId: orNull(job.linzumiThreadId),
+    linzumiThreadTitle: orNull(job.linzumiThreadTitle),
+    // The shared agent-session slot: the TS field carries the deprecated
+    // name; the projection uses the canonical key (D44) so both impls
+    // compare on neutral vocabulary.
+    harnessSessionId: orNull(job.codexThreadId),
+    tokenUsage: orNull(job.tokenUsage),
+    lastIncomingPreview: orNull(job.lastIncomingPreview),
+    lastIncomingAtMs: orNull(job.lastIncomingAtMs),
+    lastAssistantPreview: orNull(job.lastAssistantPreview),
+    lastAssistantAtMs: orNull(job.lastAssistantAtMs),
+    latestHarnessEventId: orNull(job.latestCodexEventId),
+    eventType: orNull(job.eventType),
+    creditExhaustion: orNull(job.creditExhaustion),
+    queueDepth: orNull(job.queueDepth),
+    turnId: orNull(job.turnId),
+    updatedAtMs: job.updatedAtMs,
+  };
+}
+
+function projectState(state) {
+  return {
+    jobs: [...state.jobs.entries()].map(([key, job]) => [key, projectJob(job)]),
+    discovery: [...state.discovery.entries()].map(([key, status]) => [
+      key,
+      {
+        key: status.key,
+        phase: status.phase,
+        status: status.status,
+        placesSearched: status.placesSearched,
+        message: orNull(status.message),
+        currentPlace: orNull(status.currentPlace),
+        currentSource: orNull(status.currentSource),
+        lastError: orNull(status.lastError),
+        metadata: orNull(status.metadata),
+        updatedAtMs: status.updatedAtMs,
+      },
+    ]),
+    notices: [...state.notices.entries()].map(([key, notice]) => [
+      key,
+      {
+        key: notice.key,
+        severity: notice.severity,
+        message: notice.message,
+        count: notice.count,
+        updatedAtMs: notice.updatedAtMs,
+      },
+    ]),
+    rawLines: state.rawLines.map((line) => ({
+      jobKey: orNull(line.jobKey),
+      line: line.line,
+    })),
+    nextJobOrdinal: state.nextJobOrdinal,
+    mode:
+      state.mode.type === 'raw_job'
+        ? { type: 'raw_job', jobKey: state.mode.jobKey }
+        : { type: state.mode.type },
+    selectedJobKey: orNull(state.selectedJobKey),
+    selectedJobIndexHint: orNull(state.selectedJobIndexHint),
+    tokenUsage: orNull(state.tokenUsage),
+    rateLimit: orNull(state.rateLimit),
+    creditExhaustion: orNull(state.creditExhaustion),
+    lastUpdateAtMs: orNull(state.lastUpdateAtMs),
+    browserUrl: orNull(state.browserUrl),
+    workspace: orNull(state.workspace),
+    runnerId: orNull(state.runnerId),
+    connectionStale: state.connectionStale,
+    rosterTruncated: state.rosterTruncated,
+  };
+}
+
+function projectTableModel(model) {
+  return {
+    rows: model.rows,
+    rowJobKeys: model.rowJobKeys.map((key) => orNull(key)),
+    selectedJobKey: orNull(model.selectedJobKey),
+    jobKeys: model.jobs.map((job) => job.key),
+    selectionRowIndex: tableSelectionRowIndex(model),
+  };
+}
+
+// --- scenario: the state fold + render surfaces ------------------------------------------
+
+function handleScenario(testCase) {
+  const state = createRunnerConsoleDashboard();
+  const outputs = [];
+  for (const step of testCase.steps) {
+    switch (step.op) {
+      case 'event':
+        updateRunnerConsoleDashboard(state, step.event, step.payload, step.nowMs);
+        outputs.push(null);
+        break;
+      case 'mode_key':
+        updateRunnerConsoleDashboardMode(state, step.key);
+        outputs.push(null);
+        break;
+      case 'select_index':
+        selectDashboardJobAtVisibleIndex(state, step.index);
+        outputs.push(null);
+        break;
+      case 'select_key':
+        selectDashboardJobByKey(state, step.key ?? undefined);
+        outputs.push(null);
+        break;
+      case 'escape_pressed':
+        outputs.push(runnerConsoleTuiEscapePressed(state));
+        break;
+      case 'escape_chunk': {
+        const signals = rawInputChunkSignalsEscape(step.chunk);
+        const changed = signals ? runnerConsoleTuiEscapePressed(state) : false;
+        outputs.push({ signals, changed });
+        break;
+      }
+      case 'render':
+        outputs.push(orNull(renderRunnerConsoleDashboard(state, step.nowMs)));
+        break;
+      case 'table_model':
+        outputs.push(projectTableModel(runnerConsoleDashboardTableModel(state, step.nowMs)));
+        break;
+      case 'header_layout':
+        outputs.push(
+          runnerConsoleTuiHeaderLayout(
+            state,
+            step.jobCount,
+            step.nowMs,
+            step.terminalRows
+          )
+        );
+        break;
+      case 'notice_lines':
+        outputs.push(dashboardNoticeLines(state, step.mode));
+        break;
+      case 'state':
+        outputs.push(projectState(state));
+        break;
+      default:
+        outputs.push({ threw: true, message: 'unknown scenario step ' + String(step.op) });
+        break;
+    }
+  }
+  return outputs;
+}
+
+// --- Reporter-latch ops -------------------------------------------------------------------
+
+function makeSinkCollector() {
+  const events = [];
+  return {
+    events,
+    sinks: {
+      audit: (event, fields) => events.push({ sink: 'audit', event, fields }),
+      log: (event, fields) => events.push({ sink: 'log', event, fields }),
+    },
+  };
+}
+
+function scriptedError(spec) {
+  const error = new Error(spec.message);
+  if (spec.code !== undefined) {
+    error.code = spec.code;
+  }
+  return error;
+}
+
+function handleTeardownScenario(testCase) {
+  resetRunnerConsoleTuiDegradeForTest();
+  setRunnerConsoleDashboardTuiForTest(undefined);
+  const collector = makeSinkCollector();
+  const outputs = [];
+  let stopCalls = 0;
+  let destroyCalls = 0;
+  for (const step of testCase.steps) {
+    switch (step.op) {
+      case 'install': {
+        destroyCalls = 0;
+        stopCalls = 0;
+        const dashboard = {
+          render: () => {},
+          destroy: () => {
+            destroyCalls += 1;
+            if (step.destroyError !== undefined) {
+              throw scriptedError(step.destroyError);
+            }
+          },
+        };
+        setRunnerConsoleDashboardTuiForTest(
+          dashboard,
+          { stdin: step.stdinTty ?? true, stdout: step.stdoutTty ?? true },
+          () => {
+            stopCalls += 1;
+          }
+        );
+        outputs.push(null);
+        break;
+      }
+      case 'teardown': {
+        const outcome = teardownRunnerConsoleDashboardTuiSafely(
+          { trigger: step.trigger },
+          collector.sinks
+        );
+        outputs.push({
+          hadTui: outcome.hadTui,
+          ok: outcome.ok,
+          swallowedErrorCode: orNull(outcome.swallowedErrorCode),
+          active: runnerConsoleDashboardTuiActiveForTest(),
+          stopCalls,
+          destroyCalls,
+        });
+        break;
+      }
+      case 'degrade': {
+        degradeRunnerConsoleTuiToHeadless(
+          { code: step.code ?? undefined, stage: step.stage },
+          collector.sinks
+        );
+        outputs.push({
+          degraded: runnerConsoleTuiDegradedToHeadless(),
+          active: runnerConsoleDashboardTuiActiveForTest(),
+          stopCalls,
+          destroyCalls,
+        });
+        break;
+      }
+      case 'reset_degrade':
+        resetRunnerConsoleTuiDegradeForTest();
+        outputs.push(null);
+        break;
+      default:
+        outputs.push({ threw: true, message: 'unknown teardown step ' + String(step.op) });
+        break;
+    }
+  }
+  return { outputs, events: collector.events };
+}
+
+function handleFailSoftScenario(testCase) {
+  resetRunnerConsoleDashboardTuiConstructionForTest();
+  const collector = makeSinkCollector();
+  const outputs = [];
+  let createCalls = 0;
+  for (const step of testCase.steps) {
+    switch (step.op) {
+      case 'create': {
+        const result = createRunnerConsoleDashboardTuiFailSoft(() => {
+          createCalls += 1;
+          if (step.createError !== undefined) {
+            throw scriptedError(step.createError);
+          }
+          return { render: () => {}, destroy: () => {} };
+        }, collector.sinks);
+        outputs.push({ defined: result !== undefined, createCalls });
+        break;
+      }
+      case 'reset_construction':
+        resetRunnerConsoleDashboardTuiConstructionForTest();
+        outputs.push(null);
+        break;
+      default:
+        outputs.push({ threw: true, message: 'unknown failsoft step ' + String(step.op) });
+        break;
+    }
+  }
+  return {
+    outputs,
+    // The guarded construction wraps the REAL blessed registry; only the
+    // event vocabulary is compared (stack contents are impl-specific), so
+    // project events to sink+event+swept_screens.
+    events: collector.events.map((entry) => ({
+      sink: entry.sink,
+      event: entry.event,
+      swept_screens: orNull(entry.fields.swept_screens),
+    })),
+  };
+}
+
+// --- Blessed-guard ops -----------------------------------------------------------------------
+
+function makeFakeScreen(spec, sweepTrace) {
+  const screen = {};
+  if (spec.hasProgram) {
+    screen.program = {};
+  }
+  screen.destroy = () => {
+    sweepTrace.push('destroy:' + spec.name);
+    if (spec.destroyError !== undefined) {
+      throw scriptedError(spec.destroyError);
+    }
+    // A real complete screen's destroy() detaches itself from the
+    // registry; the scripted double mirrors that so the sweep's
+    // idempotent re-detach is exercised the same way on both impls.
+    if (spec.selfDetach !== false) {
+      const index = spec.registry.instances.indexOf(screen);
+      if (index !== -1) {
+        spec.registry.instances.splice(index, 1);
+        spec.registry.total -= 1;
+        spec.registry.global = spec.registry.instances[0];
+        if (spec.registry.total === 0) {
+          spec.registry.global = null;
+        }
+      }
+    }
+  };
+  return screen;
+}
+
+function projectRegistry(registry, names) {
+  return {
+    instanceNames: registry.instances.map((instance) => names.get(instance) ?? '?'),
+    total: registry.total,
+    global:
+      registry.global === null
+        ? null
+        : registry.global === undefined
+          ? '<undefined>'
+          : (names.get(registry.global) ?? '?'),
+  };
+}
+
+function handleRegistryGuard(testCase) {
+  const collector = makeSinkCollector();
+  const sweepTrace = [];
+  const registry = { instances: [], total: 0, global: null };
+  const names = new Map();
+  const preexisting = [];
+  for (const spec of testCase.preexisting ?? []) {
+    const screen = makeFakeScreen({ ...spec, registry }, sweepTrace);
+    names.set(screen, spec.name);
+    registry.instances.push(screen);
+    registry.total += 1;
+    preexisting.push(screen);
+  }
+  registry.global = registry.instances[0] ?? null;
+  let result;
+  try {
+    result = {
+      returned: constructBlessedScreenGuarded(
+        registry,
+        () => {
+          for (const spec of testCase.constructed ?? []) {
+            const screen = makeFakeScreen({ ...spec, registry }, sweepTrace);
+            names.set(screen, spec.name);
+            registry.instances.push(screen);
+            registry.total += 1;
+          }
+          if (testCase.constructError !== undefined) {
+            throw scriptedError(testCase.constructError);
+          }
+          return 'constructed';
+        },
+        { sinks: collector.sinks, context: { surface: 'parity_case' } }
+      ),
+    };
+  } catch (error) {
+    result = { threw: true, message: error instanceof Error ? error.message : String(error) };
+  }
+  return {
+    result,
+    registry: projectRegistry(registry, names),
+    sweepTrace,
+    events: collector.events,
+  };
+}
+
+function handleRegistryDetach(testCase) {
+  const registry = { instances: [], total: testCase.total ?? 0, global: null };
+  const names = new Map();
+  const screens = [];
+  for (const name of testCase.instances) {
+    const screen = { name };
+    names.set(screen, name);
+    registry.instances.push(screen);
+    screens.push(screen);
+  }
+  registry.global = registry.instances[0] ?? null;
+  const target = screens[testCase.detachIndex];
+  const detached = detachBlessedScreenFromRegistry(
+    registry,
+    target ?? { name: 'unregistered' }
+  );
+  return { detached, registry: projectRegistry(registry, names) };
+}
+
+// --- Dispatch ----------------------------------------------------------------------------------
+
+function handle(testCase) {
+  switch (testCase.op) {
+    case 'version':
+      return linzumiCliVersion;
+    case 'format_line':
+      return orNull(formatRunnerConsoleEvent(testCase.event, testCase.payload));
+    case 'keys':
+      return {
+        escape: rawInputChunkSignalsEscape(testCase.chunk),
+        mouse: rawInputChunkContainsMouseReport(testCase.chunk),
+        arrows: arrowKeysInRawChunk(testCase.chunk),
+        dropped: droppedArrowKeysInRawChunk(testCase.chunk),
+      };
+    case 'keypress_escape':
+      return keypressIsEscape(testCase.key);
+    case 'selection_resolve': {
+      const resolved = resolveSelectionAfterRefresh(
+        testCase.previousKey ?? undefined,
+        testCase.previousIndexHint ?? undefined,
+        testCase.jobKeys
+      );
+      return { key: orNull(resolved.key), index: orNull(resolved.index) };
+    }
+    case 'page_step':
+      return tableSelectionPageStep(testCase.tableHeight);
+    case 'job_key_at_row': {
+      const state = createRunnerConsoleDashboard();
+      for (const step of testCase.events) {
+        updateRunnerConsoleDashboard(state, step.event, step.payload, step.nowMs);
+      }
+      const model = runnerConsoleDashboardTableModel(state, testCase.nowMs);
+      return testCase.rows.map((row) => orNull(dashboardJobKeyAtTableRow(model, row)));
+    }
+    case 'terminfo_balance':
+      return balanceTerminfoConditionals(testCase.cap);
+    case 'acs_would_use':
+      return blessedWouldUseAcsCharset(
+        testCase.tput ?? undefined,
+        testCase.ch,
+        testCase.alreadyInAcsRun ?? false
+      );
+    case 'acs_force': {
+      const tput = testCase.tput ?? undefined;
+      const mutated = forceUnicodeBoxDrawingOnTput(tput);
+      return { mutated, tput: orNull(tput) };
+    }
+    case 'acs_fix': {
+      const screen = testCase.screen ?? undefined;
+      if (screen !== undefined && testCase.shareProgramTput === true) {
+        screen.program = { tput: screen.tput };
+      }
+      applyBlessedAcsCharsetFix(screen);
+      return orNull(screen);
+    }
+    case 'scenario':
+      return handleScenario(testCase);
+    case 'teardown_scenario':
+      return handleTeardownScenario(testCase);
+    case 'failsoft_scenario':
+      return handleFailSoftScenario(testCase);
+    case 'registry_guard':
+      return handleRegistryGuard(testCase);
+    case 'registry_detach':
+      return handleRegistryDetach(testCase);
+    default:
+      return { threw: true, message: 'unknown op ' + String(testCase.op) };
+  }
+}
+
+let stdin = '';
+process.stdin.setEncoding('utf8');
+for await (const chunk of process.stdin) {
+  stdin += chunk;
+}
+const cases = JSON.parse(stdin);
+const results = [];
+for (const testCase of cases) {
+  results.push(handle(testCase));
+}
+process.stdout.write(JSON.stringify(results));
+`;
+
+await mkdir(join(packageRoot, '.differential'), { recursive: true });
+
+await build({
+  stdin: {
+    contents: driverSource,
+    resolveDir: packageRoot,
+    sourcefile: 'tui-parity-driver.ts',
+    loader: 'ts',
+  },
+  bundle: true,
+  platform: 'node',
+  target: 'node20',
+  format: 'esm',
+  outfile: join(packageRoot, '.differential/tui-parity-oracle.mjs'),
+  minify: false,
+  sourcemap: false,
+  legalComments: 'none',
+  // The console-reporter module imports blessed (and the crash-handler /
+  // logger slice pulls the runtime graph); the runtime externals stay
+  // aligned with the other cluster oracles.
+  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
+});