@linzumi/cli 1.0.272 → 1.0.273

package/scripts/build-core-integration-parity-oracle.mjs

@@ -1,453 +0,0 @@
-// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md
-// (M3 cluster 10, runner core).
-// Relationship: Builds the TS-side PARITY ORACLE for the pipeline
-// INTEGRATION module of the ReScript commander port, the sibling of
-// build-pipeline-parity-oracle.mjs (cluster 9) and
-// build-queue-parity-oracle.mjs (cluster 5). The oracle bundles the REAL
-// TS pipeline integration module (src/pipeline/integration.ts - the
-// per-session loop + outbox lifecycle, the outbox entry builders, and the
-// completion-snapshot resolution helpers) plus the real phoenix push-error
-// factory and the turnTrace per-thread traceparent registry, behind the
-// cluster 1/2 one-shot BATCH driver (a JSON array of cases on stdin, a
-// JSON array of results on stdout).
-//
-// Byte parity: builder results and snapshot-helper outputs are returned
-// VERBATIM (the TS object literals' own key order rides JSON.stringify),
-// and scripted SESSION runs return their full event trace - pushes with
-// complete payloads, acks/failures, snapshot resolutions, terminal
-// callbacks, log events, flushes, metrics counters, close - so the
-// ReScript side must reproduce field presence AND insertion order exactly.
-// Determinism: hosts are fully scripted (push outcomes, snapshot outcomes,
-// wire contexts, envelope shapes, recovered turns, runtime metadata);
-// retry cadences are configured to millisecond-scale delays so the traces
-// pin the LOGGED delay values while real time stays tiny; the stats
-// interval is disabled (0) in session runs; traces capture only
-// deterministic metric counters (never wall-clock ages).
-//
-// SECRETS: the oracle only ever sees the conformance suite's synthetic
-// payloads. 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 {
-  createSessionPipeline,
-  createSessionPipelineBuilders,
-  defaultOutboxMaxInFlightPushes,
-  isConnectionLostPushError,
-  isConnectionWaitPushError,
-  mergeSnapshotItems,
-  preReduceSnapshotItems,
-  rawSnapshotItemsForTurn,
-} from './src/pipeline/integration';
-import { outboxEntryKinds, adoptAdtStreamBinding } from './src/pipeline/contracts';
-import { phoenixPushErrors } from './src/phoenix';
-import {
-  rememberTurnTraceparent,
-  __resetTurnTraceparentsForTest,
-} from './src/turnTrace';
-
-function sleep(ms) {
-  return new Promise((resolve) => {
-    setTimeout(resolve, ms);
-  });
-}
-
-// The scripted row-command envelope shared with the ReScript conformance
-// side (both implement this exact shape over the same case JSON, so the
-// seam itself is identical while the builder's spread/override semantics
-// around it are what the comparison pins).
-function scriptedEnvelope(caseInput) {
-  return (eventType, sessionId, sourceMessageSeq, extraMetadata) => ({
-    ...(caseInput.envelopeBase ?? {}),
-    type: eventType,
-    thread: sessionId,
-    ...(sourceMessageSeq === undefined ? {} : { envelope_seq: sourceMessageSeq }),
-    ...(extraMetadata === undefined ? {} : { local_runner_metadata: extraMetadata }),
-  });
-}
-
-function wireOf(spec) {
-  return {
-    workspaceSlug: spec.workspaceSlug,
-    channelSlug: spec.channelSlug,
-    kandanThreadId: spec.threadId ?? undefined,
-    codexThreadId: spec.harnessSessionId ?? undefined,
-    rootSeq: spec.rootSeq ?? undefined,
-    ...(spec.leaseEpoch === undefined ? {} : { leaseEpoch: spec.leaseEpoch }),
-  };
-}
-
-function seedTraceparents(caseInput) {
-  __resetTurnTraceparentsForTest();
-  for (const entry of caseInput.traceparents ?? []) {
-    rememberTurnTraceparent(entry.threadId, entry.traceparent);
-  }
-}
-
-function runBuildersCase(caseInput) {
-  seedTraceparents(caseInput);
-  const recovered = new Set(caseInput.recoveredTurns ?? []);
-  const wires = (caseInput.wires ?? []).map(wireOf);
-  let wireIndex = 0;
-  const builders = createSessionPipelineBuilders({
-    instanceId: caseInput.instanceId ?? 'instance-parity',
-    wire: () => wires[wireIndex],
-    runnerPayload: scriptedEnvelope(caseInput),
-    isRecoveredTurn: (turnId) => recovered.has(turnId),
-    // Spec: spec/sandbox-denial-surfacing.md (:sandbox-denial/rule-08): the
-    // per-host classification opt-in, driven from the case JSON so the
-    // ReScript conformance side pins the annotated bytes differentially.
-    ...(caseInput.sandboxNetworkDenialSurfacing === true
-      ? { sandboxNetworkDenialSurfacing: true }
-      : {}),
-  });
-  const context = {
-    remember: () => {},
-    recall: () => undefined,
-  };
-  return {
-    results: (caseInput.calls ?? []).map((call) => {
-      wireIndex = call.wireIndex ?? 0;
-      const builder = builders[call.kind];
-      if (builder === undefined) {
-        return { missingBuilder: true };
-      }
-      return builder.build(call.data ?? {}, context);
-    }),
-  };
-}
-
-function scriptedFailure(spec) {
-  switch (spec.factory) {
-    case 'socketClosed':
-      return phoenixPushErrors.socketClosed();
-    case 'reconnectFailed':
-      return phoenixPushErrors.reconnectFailed();
-    case 'socketNotOpen':
-      return phoenixPushErrors.socketNotOpen();
-    case 'clientClosedWait':
-      return phoenixPushErrors.clientClosed('wait_for_connection');
-    case 'clientClosedReply':
-      return phoenixPushErrors.clientClosed('reply');
-    case 'notConnected':
-      return phoenixPushErrors.notConnected();
-    case 'connectionWaitTimeout':
-      return phoenixPushErrors.connectionWaitTimeout(spec.timeoutMs ?? 5, spec.event ?? 'evt');
-    case 'replyTimeout':
-      return phoenixPushErrors.replyTimeout(spec.timeoutMs ?? 5, spec.event ?? 'evt');
-    default:
-      return new Error(spec.message ?? 'scripted push failure');
-  }
-}
-
-function runClassifierCase(caseInput) {
-  const failure = scriptedFailure(caseInput.failure ?? {});
-  return {
-    lost: isConnectionLostPushError(failure),
-    wait: isConnectionWaitPushError(failure),
-    message: failure.message,
-  };
-}
-
-async function runSessionCase(caseInput) {
-  seedTraceparents(caseInput);
-  const trace = [];
-  const recovered = new Set(caseInput.recoveredTurns ?? []);
-  const wires = (caseInput.wires ?? []).map(wireOf);
-  let wireIndex = 0;
-  const turnSeqs = new Map();
-  const retryAttempts = new Map();
-  const resumeAttempts = new Map();
-  const ladders = new Map();
-  const runtimeMetadata = new Map();
-  for (const entry of caseInput.runtimeMetadata ?? []) {
-    runtimeMetadata.set(entry.seq, entry.metadata);
-  }
-  const pushScript = [...(caseInput.pushScript ?? [])];
-  const snapshotScript = new Map();
-  for (const entry of caseInput.snapshotScript ?? []) {
-    const queue = snapshotScript.get(entry.turnId) ?? [];
-    queue.push(entry);
-    snapshotScript.set(entry.turnId, queue);
-  }
-
-  const pipeline = createSessionPipeline({
-    instanceId: caseInput.instanceId ?? 'instance-parity',
-    threadKey: caseInput.threadKey ?? 'thread-parity',
-    persistDir: undefined,
-    push: async (event, payload, _timeoutMs, onSent) => {
-      trace.push({ t: 'push', event, payload });
-      onSent?.();
-      const step = pushScript.shift() ?? { kind: 'ack' };
-      if (step.delayMs !== undefined) {
-        await sleep(step.delayMs);
-      }
-      if (step.kind === 'ack') {
-        trace.push({ t: 'ack' });
-        return step.reply ?? { ok: true };
-      }
-      trace.push({ t: 'pushFail', mode: step.mode ?? 'plain' });
-      if (step.mode === 'wait') {
-        throw phoenixPushErrors.connectionWaitTimeout(5, event);
-      }
-      if (step.mode === 'lost') {
-        throw phoenixPushErrors.socketClosed();
-      }
-      throw new Error(step.message ?? 'scripted push failure');
-    },
-    wire: () => wires[wireIndex],
-    runnerPayload: scriptedEnvelope(caseInput),
-    runtimeMetadataForSourceSeq: (seq) =>
-      seq === undefined ? undefined : runtimeMetadata.get(seq),
-    sourceSeqForTurn: (turnId) => turnSeqs.get(turnId),
-    autoRetryAttemptsForSeq: (seq) => retryAttempts.get(seq) ?? 0,
-    midStreamResumeAttemptAtMsForSeq: (seq) => resumeAttempts.get(seq),
-    ladderHistoryForSeq: (seq, fate) => ladders.get(seq + ':' + fate),
-    isRecoveredTurn: (turnId) => recovered.has(turnId),
-    resolveSnapshot: async (turnId) => {
-      const queue = snapshotScript.get(turnId) ?? [];
-      const step = queue.shift() ?? { ok: true, items: [] };
-      trace.push({ t: 'resolveSnapshot', turnId, ok: step.ok === true });
-      if (step.delayMs !== undefined) {
-        await sleep(step.delayMs);
-      }
-      if (step.ok === true) {
-        return { items: step.items ?? [] };
-      }
-      throw new Error(step.message ?? 'scripted snapshot failure');
-    },
-    onTurnTerminal: (
-      turnId,
-      outcome,
-      reason,
-      retryableEmptyTurn,
-      autoResume,
-      fate,
-      freshSessionResume
-    ) => {
-      trace.push({
-        t: 'terminal',
-        turnId,
-        outcome,
-        reason: reason ?? null,
-        retryableEmptyTurn: retryableEmptyTurn === true,
-        autoResumeMidStreamStall: autoResume === true,
-        // #3455 leg 4 (Greptile P2): the second-stall fresh-session flag is
-        // part of the compared terminal surface, so a future divergence in
-        // the ReScript reducer goes red here, not just in the TS e2e tests.
-        freshSessionResumeMidStreamStall: freshSessionResume === true,
-        fate: fate ?? null,
-      });
-    },
-    log: (event, fields) => {
-      trace.push({ t: 'log', event, fields });
-    },
-    linzumiAgentSession: caseInput.linzumiAgentSession === true,
-    outboxRetryDelaysMs: caseInput.outboxRetryDelaysMs ?? [1, 2],
-    outboxMaxInFlightPushes: caseInput.maxInFlightPushes ?? 1,
-    snapshotRetryDelaysMs: caseInput.snapshotRetryDelaysMs ?? undefined,
-    // Determinism: the periodic stats interval is disabled; the reporter
-    // still stops on close in the same order as production.
-    statsIntervalMs: 0,
-  });
-
-  for (const op of caseInput.ops ?? []) {
-    if (op.op === 'submit') pipeline.submitNotification(op.method, op.params ?? undefined);
-    else if (op.op === 'mapTurn') turnSeqs.set(op.turnId, op.seq);
-    else if (op.op === 'retryAttempts') retryAttempts.set(op.seq, op.attempts);
-    else if (op.op === 'resumeAttemptAt') resumeAttempts.set(op.seq, op.atMs);
-    else if (op.op === 'ladder') ladders.set(op.seq + ':' + op.fate, op.ladder);
-    else if (op.op === 'recover') recovered.add(op.turnId);
-    else if (op.op === 'notifyReady') pipeline.notifyTurnMappingReady(op.turnId);
-    else if (op.op === 'notifyFailed') pipeline.notifyTurnMappingFailed(op.turnId, op.reason);
-    else if (op.op === 'noteActivity') pipeline.noteTurnActivity(op.turnId, op.kind);
-    else if (op.op === 'lifecycle') pipeline.submitLifecycle(op.kind, op.reason);
-    else if (op.op === 'pause') pipeline.pause();
-    else if (op.op === 'resume') pipeline.resume();
-    else if (op.op === 'rebind') pipeline.rebindThreadKey(op.threadKey);
-    else if (op.op === 'setWire') wireIndex = op.index;
-    else if (op.op === 'sleep') await sleep(op.ms);
-    else if (op.op === 'metrics') {
-      const metrics = pipeline.metrics();
-      trace.push({
-        t: 'metrics',
-        value: {
-          depth: metrics.depth,
-          totalEnqueued: metrics.totalEnqueued,
-          totalAcked: metrics.totalAcked,
-          totalRetried: metrics.totalRetried,
-          totalDroppedBestEffort: metrics.totalDroppedBestEffort,
-          totalPermanentFailures: metrics.totalPermanentFailures,
-          paused: metrics.paused,
-        },
-      });
-    } else if (op.op === 'flush') {
-      try {
-        await pipeline.flushOutbox(op.timeoutMs ?? undefined);
-        trace.push({ t: 'flushed', ok: true });
-      } catch (error) {
-        trace.push({
-          t: 'flushed',
-          ok: false,
-          message: error instanceof Error ? error.message : String(error),
-        });
-      }
-    } else if (op.op === 'close') {
-      await pipeline.close(op.timeoutMs ?? undefined);
-      trace.push({ t: 'closed' });
-    }
-  }
-  return { trace };
-}
-
-// Spec: spec/adt-final-answer-identity-rules.md, rules 1–3.
-// Actual producer/outbox boundary; assertions remain in the ReScript owner.
-async function runFinalCheckpointIdentity(input) {
-  const adoption = adoptAdtStreamBinding({session_id: 3600, lease_epoch: 1, next_frame_index: 37,
-    checkpoint_config: {version: 3, thresholds: {max_bytes: 1, max_deltas: 1, max_interval_ms: 2000}}}, 44, Date.now());
-  if (adoption.kind !== 'accepted') throw new Error('fixture_adoption_refused');
-  const pushes = [];
-  const logs = [];
-  let finishProvider;
-  const providerTerminal = new Promise(resolve => {finishProvider = resolve;});
-  const pipeline = createSessionPipeline({
-    instanceId: 'synthetic-yc-identity', threadKey: 'synthetic-final-identity', persistDir: undefined,
-    messageStateReplyShape: {kind: 'inner_response'},
-    wire: () => ({workspaceSlug: 'fixture', channelSlug: 'office', kandanThreadId: 'fixture-thread',
-      codexThreadId: 'fixture-provider-thread', rootSeq: 1}),
-    runnerPayload: (eventType, codexThreadId, sourceSeq, extra) => ({metadata: {local_codex_runner: {
-      ...extra, event_type: eventType, codex_thread_id: codexThreadId, source_message_seq: sourceSeq,
-    }}}),
-    sourceSeqForTurn: () => 44,
-    adtAuthorityForSourceSeq: seq => seq === 44 ? adoption.session : undefined,
-    resolveSnapshot: async () => ({items: mergeSnapshotItems(input.readItems, input.sessionItems)}),
-    onTurnTerminal: () => finishProvider(),
-    log: (event, fields) => logs.push({event, fields}), statsIntervalMs: 0,
-    push: async (event, payload) => {
-      pushes.push({event, payload});
-      if (event === 'terminal_attempt') return {terminal_attempt: {
-        frame: {accepted: true}, message_state: {disposition: 'applied', thread_id: 'fixture-thread', source_seq: 44},
-      }};
-      return {seq: pushes.length, accepted: true};
-    },
-  });
-  try {
-    pipeline.submitNotification('item/agentMessage/delta', {threadId: 'fixture-provider-thread',
-      turnId: 'fixture-turn', itemId: 'msg-live-final', delta: input.body});
-    pipeline.submitNotification('item/completed', {threadId: 'fixture-provider-thread', turnId: 'fixture-turn',
-      item: {id: 'msg-live-final', type: 'agentMessage', text: input.body, phase: 'final_answer'}});
-    await pipeline.flushOutbox(1000);
-    pipeline.submitNotification('turn/completed', {threadId: 'fixture-provider-thread', turn: {id: 'fixture-turn'}});
-    await providerTerminal;
-    await pipeline.flushOutbox(1000);
-    const metrics = pipeline.metrics();
-    return {
-      standalone: pushes.filter(push => push.event === 'adt_frame').map(push => push.payload),
-      terminals: pushes.filter(push => push.event === 'terminal_attempt').map(push => push.payload.terminal_frame),
-      depth: metrics.depth, failures: metrics.totalPermanentFailures,
-      faults: logs.filter(log => /rejected|refused|failed/.test(log.event)),
-    };
-  } finally { await pipeline.close(1000); }
-}
-
-async function runCase(input) {
-  switch (input.kind) {
-    // Spec: spec/commander-recovery-rules.md authenticated terminal evidence.
-    case 'terminalRepairReceipt': {
-      const remembered = [];
-      const builder = createSessionPipelineBuilders({
-        instanceId: 'terminal-repair-fixture',
-        wire: () => ({workspaceSlug: 'synthetic', channelSlug: 'synthetic',
-          kandanThreadId: 'repair-thread', codexThreadId: 'provider-thread'}),
-        runnerPayload: () => ({}),
-        messageStateReplyShape: {kind: 'full_reply'},
-        log: () => {},
-      })['adt.terminal_attempt'];
-      const context = {remember: (key, value) => remembered.push({key, value}), recall: () => undefined};
-      const verdict = builder.replyPolicy.adjudicateReply(input.data, input.reply, context);
-      if (verdict.kind === 'accept') builder.onReply(input.data, input.reply, context);
-      return {accepted: verdict.kind === 'accept', remembered};
-    }
-    case 'constants':
-      return {
-        defaultOutboxMaxInFlightPushes,
-        outboxEntryKinds,
-      };
-    case 'builders':
-      return runBuildersCase(input);
-    case 'classifier':
-      return runClassifierCase(input);
-    case 'rawItems':
-      return rawSnapshotItemsForTurn(input.response, input.turnId);
-    case 'preReduce':
-      return preReduceSnapshotItems(input.items);
-    case 'merge':
-      return mergeSnapshotItems(input.readItems, input.sessionItems);
-    case 'sessionRun':
-      return runSessionCase(input);
-    case 'finalCheckpointIdentity':
-      return runFinalCheckpointIdentity(input);
-    default:
-      return { error: 'unknown case kind ' + String(input.kind) };
-  }
-}
-
-async function runBatch() {
-  const chunks = [];
-  for await (const chunk of process.stdin) chunks.push(chunk);
-  const cases = JSON.parse(Buffer.concat(chunks).toString('utf8'));
-  const results = [];
-  for (const testCase of cases) {
-    results.push(await runCase(testCase));
-  }
-  process.stdout.write(JSON.stringify(results), () => {
-    process.exit(0);
-  });
-}
-
-runBatch().then(
-  () => {},
-  (error) => {
-    process.stderr.write(String(error && error.stack ? error.stack : error) + '\\n');
-    process.exit(1);
-  }
-);
-`;
-
-const outDir = join(packageRoot, '.differential');
-const outPath = join(outDir, 'core-integration-parity-oracle.mjs');
-
-await mkdir(outDir, { recursive: true });
-
-await build({
-  stdin: {
-    contents: driverSource,
-    resolveDir: packageRoot,
-    sourcefile: 'core-integration-parity-driver.ts',
-    loader: 'ts',
-  },
-  bundle: true,
-  // Spec: plans/2026-09-09-ts-native-account-continuation.md. Match the
-  // production/auth-oracle ESM bridge for reachable CJS runtime dependencies;
-  // the distinct banner binding cannot collide with bundled createRequire.
-  banner: {
-    js: "import { createRequire as __coreIntegrationOracleCreateRequire } from 'node:module';\nconst require = __coreIntegrationOracleCreateRequire(import.meta.url);",
-  },
-  platform: 'node',
-  target: 'node20',
-  format: 'esm',
-  outfile: outPath,
-  minify: false,
-  sourcemap: false,
-  legalComments: 'none',
-  logLevel: 'silent',
-  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
-});
-
-process.stdout.write(outPath + '\n');