@linzumi/cli 1.0.272 → 1.0.273

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

@@ -1,398 +0,0 @@
-// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md
-// (M3 cluster 1, protocol-types).
-// Relationship: Builds the TS-side PARITY ORACLE for the protocol/type
-// cluster of the ReScript commander port. The oracle bundles the REAL TS
-// protocol modules (protocol.ts, json.ts, localCodexMessageState.ts,
-// terminalFailureRetry.ts, localConfig.ts) behind a one-shot batch driver:
-// it reads a JSON array of cases on stdin and writes a JSON array of
-// results on stdout. The ReScript package's parity conformance
-// (packages/linzumi-cli-rescript/src/parity/ProtocolParityConformance.res)
-// drives the SAME inputs through the sury schemas/functions and asserts
-// accept/reject/normalized-output equivalence - so the two protocol layers
-// cannot drift silently.
-// Native Commander catalog extension spec:
-// plans/2026-09-08-rescript-commander-native-model-catalog.spec.md
-//
-// Like build-differential-entry.mjs, 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 { mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import {
-  isJsonObject,
-  parseJsonObject,
-  requireString,
-  requirePositiveInteger,
-  extractCodexIds,
-  terminalStartupFailureHeartbeatPayload,
-} from './src/protocol';
-import {
-  objectValue,
-  arrayValue,
-  stringValue,
-  integerValue,
-  stringListValue,
-  parseJsonObjectOrUndefined,
-} from './src/json';
-import {
-  approvalRequestKey,
-  codexApprovalMessageState,
-  compactingConversationHistoryReason,
-  fleetBreakerHoldReason,
-  parkedAsOwnTurnQueuedReason,
-  parkedAsOwnTurnReasonDetail,
-  processingReasonForCodexNotification,
-  queuedBehindEarlierMessagesReason,
-  queuedBehindRunningTurnReason,
-  queuedBehindReasonPrefix,
-  queuedBehindRunningTurnReasonPrefix,
-  resumingAfterStreamStallReason,
-  steeredIntoRunningTurnReason,
-} from './src/localCodexMessageState';
-import { parseFleetBreakerPayload } from './src/fleetBreaker';
-import {
-  fateRetryable,
-  isTerminalFailureFate,
-  terminalFailureClasses,
-  terminalFailureFate,
-  terminalFailureFates,
-  terminalFailureRetryableStamp,
-} from './src/terminalFailureRetry';
-import { readLocalConfig, readLocalSignupAuth } from './src/localConfig';
-import {
-  ADT_BINDING_ACK_EVENT,
-  ADT_FRAME_ENTRY_KIND,
-  ADT_FRAME_EVENT,
-  ADT_STREAM_BINDING_KEY,
-  ADT_STREAM_V1_CAPABILITY,
-  adoptAdtStreamBinding,
-  adtBindingRefusalMessage,
-  adtFrameContentDigest,
-  adtFrameEntryData,
-  adtFrameTelemetry,
-  adtFrameWirePayload,
-  adtObserveOutboxEntry,
-  adtRejectionTelemetry,
-  classifyAdtAppendRejection,
-  fenceAdtEmitter,
-  finishAdtStream,
-  makeAdtFrameEmitter,
-  parseAdtStreamBinding,
-  pollAdtInterval,
-  pushAdtDelta,
-  utf8ByteLength,
-} from './src/pipeline/contracts';
-import { discoverCodexModelCatalog } from './src/channelSession';
-import { discoverClaudeCodeModelCatalog } from './src/claudeCodeSession';
-import { claudeCodeRoutedProxyModel } from './src/claudeModelTransportLane';
-
-const jsonHelpers = {
-  isJsonObject,
-  parseJsonObject,
-  requireString,
-  requirePositiveInteger,
-  extractCodexIds,
-  objectValue,
-  arrayValue,
-  stringValue,
-  integerValue,
-  stringListValue,
-  parseJsonObjectOrUndefined,
-};
-
-const messageStateFns = {
-  approvalRequestKey,
-  codexApprovalMessageState,
-  parkedAsOwnTurnQueuedReason,
-  parkedAsOwnTurnReasonDetail,
-  processingReasonForCodexNotification,
-  queuedBehindEarlierMessagesReason,
-  queuedBehindRunningTurnReason,
-};
-
-// Encode a call outcome so undefined stays distinguishable from null after
-// JSON serialization.
-function outcome(run) {
-  try {
-    const value = run();
-    return value === undefined ? { defined: false } : { defined: true, value };
-  } catch (error) {
-    return { threw: true, message: error instanceof Error ? error.message : String(error) };
-  }
-}
-
-async function outcomeAsync(run) {
-  try {
-    const value = await run();
-    return value === undefined ? { defined: false } : { defined: true, value };
-  } catch (error) {
-    return { threw: true, message: error instanceof Error ? error.message : String(error) };
-  }
-}
-
-// --- adt_stream_v1 (Part C CLI-first leg): the adt protocol core rides
-// THIS oracle (its charter: the TS protocol modules; the zero-raw-JS
-// ratchet forbids a new sibling .mjs). Case ops are namespaced 'adt*'
-// where they would collide.
-const adtRowEntryKinds = {
-  postStreamedRow: 'pipeline.post_streamed_row',
-  streamSnapshot: 'pipeline.stream_snapshot',
-  finalizeRow: 'pipeline.finalize_row',
-  postCompletedRow: 'pipeline.post_completed_row',
-  messageState: 'pipeline.message_state',
-};
-
-const adtFrameOut = (frame) =>
-  frame === null
-    ? null
-    : {
-        entryData: adtFrameEntryData(frame),
-        wirePayload: adtFrameWirePayload(frame),
-        telemetry: adtFrameTelemetry(frame),
-      };
-
-async function handle(testCase) {
-  switch (testCase.op) {
-    case 'jsonHelper': {
-      const fn = jsonHelpers[testCase.fn];
-      if (fn === undefined) {
-        return { threw: true, message: 'unknown jsonHelper ' + testCase.fn };
-      }
-      return outcome(() => fn(...testCase.args));
-    }
-    case 'messageState': {
-      const fn = messageStateFns[testCase.fn];
-      if (fn === undefined) {
-        return { threw: true, message: 'unknown messageState fn ' + testCase.fn };
-      }
-      return outcome(() => fn(...testCase.args));
-    }
-    case 'terminalStartupFailureHeartbeatPayload':
-      return outcome(() => terminalStartupFailureHeartbeatPayload(testCase.controlSeqs));
-    case 'constants':
-      return {
-        compactingConversationHistoryReason,
-        resumingAfterStreamStallReason,
-        steeredIntoRunningTurnReason,
-        queuedBehindReasonPrefix,
-        queuedBehindRunningTurnReasonPrefix,
-        fleetBreakerHoldReason,
-      };
-    case 'fleetBreakerParse':
-      return outcome(() => parseFleetBreakerPayload(testCase.value));
-    case 'fateTables': {
-      const retryableByFate = {};
-      for (const fate of terminalFailureFates) {
-        retryableByFate[fate] = fateRetryable(fate);
-      }
-      const fateByClass = {};
-      const stampByClass = {};
-      for (const failureClass of terminalFailureClasses) {
-        fateByClass[failureClass] = terminalFailureFate(failureClass);
-        stampByClass[failureClass] = terminalFailureRetryableStamp(failureClass);
-      }
-      return {
-        fates: [...terminalFailureFates],
-        retryableByFate,
-        classes: [...terminalFailureClasses],
-        fateByClass,
-        stampByClass,
-      };
-    }
-    case 'isFate':
-      return outcome(() => isTerminalFailureFate(testCase.value));
-    case 'localConfig': {
-      const dir = mkdtempSync(join(tmpdir(), 'linzumi-protocol-parity-'));
-      const path = join(dir, 'config.json');
-      writeFileSync(path, testCase.contents, 'utf8');
-      const config = outcome(() => readLocalConfig(path));
-      const signupAuth = outcome(() => readLocalSignupAuth(path));
-      return { config, signupAuth };
-    }
-    case 'adtConstants':
-      return {
-        capability: ADT_STREAM_V1_CAPABILITY,
-        bindingKey: ADT_STREAM_BINDING_KEY,
-        frameEvent: ADT_FRAME_EVENT,
-        bindingAckEvent: ADT_BINDING_ACK_EVENT,
-        frameEntryKind: ADT_FRAME_ENTRY_KIND,
-      };
-    case 'parseBinding': {
-      const parsed = parseAdtStreamBinding(testCase.value);
-      return parsed.ok
-        ? { ok: true, binding: parsed.binding }
-        : { ok: false, reason: parsed.reason };
-    }
-    case 'refusalMessage':
-      return { message: adtBindingRefusalMessage(testCase.reason) };
-    case 'adopt': {
-      const adoption = adoptAdtStreamBinding(
-        testCase.binding,
-        testCase.sourceSeq,
-        testCase.nowMs ?? 0
-      );
-      if (adoption.kind === 'accepted') {
-        return {
-          kind: 'accepted',
-          ackPayload: adoption.ackPayload,
-          sourceSeq: adoption.session.sourceSeq,
-        };
-      }
-      if (adoption.kind === 'refused') {
-        return { kind: 'refused', reason: adoption.reason, message: adoption.message };
-      }
-      return { kind: 'absent' };
-    }
-    case 'emitterRun': {
-      const parsed = parseAdtStreamBinding(testCase.binding);
-      if (!parsed.ok) {
-        return { refused: parsed.reason };
-      }
-      const emitter = makeAdtFrameEmitter(parsed.binding, testCase.startMs ?? 0);
-      const results = [];
-      for (const step of testCase.steps) {
-        switch (step.op) {
-          case 'delta':
-            results.push(adtFrameOut(pushAdtDelta(emitter, step.chunk, step.nowMs)));
-            break;
-          case 'poll':
-            results.push(adtFrameOut(pollAdtInterval(emitter, step.nowMs)));
-            break;
-          case 'finish':
-            results.push(adtFrameOut(finishAdtStream(emitter, step.nowMs)));
-            break;
-          case 'fence':
-            fenceAdtEmitter(emitter);
-            results.push(null);
-            break;
-          default:
-            results.push({ unknownStep: String(step.op) });
-        }
-      }
-      return {
-        results,
-        final: {
-          cumulative: emitter.cumulative,
-          nextFrameIndex: emitter.nextFrameIndex,
-          emittedFrameCount: emitter.emittedFrameCount,
-          terminalEmitted: emitter.terminalEmitted,
-          fenced: emitter.fenced,
-        },
-      };
-    }
-    case 'tapRun': {
-      const adoption = adoptAdtStreamBinding(
-        testCase.binding,
-        testCase.sourceSeq,
-        testCase.startMs ?? 0
-      );
-      if (adoption.kind !== 'accepted') {
-        return { adoption: adoption.kind };
-      }
-      const session = adoption.session;
-      const results = testCase.entries.map((entry) =>
-        adtObserveOutboxEntry(
-          session,
-          entry.kind,
-          entry.data,
-          entry.nowMs ?? 0,
-          adtRowEntryKinds
-        ).map((frame) => adtFrameOut(frame))
-      );
-      return {
-        results,
-        final: {
-          trackedItemKey: session.trackedItemKey ?? null,
-          trackedItemRank: session.trackedItemRank,
-          lastBody: session.lastBody,
-          done: session.done,
-        },
-      };
-    }
-    case 'classifyRejection':
-      return { reason: classifyAdtAppendRejection(testCase.value) };
-    case 'rejectionTelemetry':
-      return adtRejectionTelemetry(testCase.frame, testCase.reason);
-    case 'digest':
-      return {
-        digest: adtFrameContentDigest(testCase.frame),
-        byteLen: utf8ByteLength(testCase.frame.body),
-      };
-    case 'nativeCodexModelCatalog':
-      return outcomeAsync(() =>
-        discoverCodexModelCatalog({
-          request: async (method, params) => {
-            if (method !== 'model/list') throw new Error('unexpected Codex method ' + method);
-            const cursor = typeof params?.cursor === 'string' ? params.cursor : null;
-            const page = testCase.pages.find((candidate) => candidate.cursor === cursor);
-            if (page === undefined) throw new Error('missing Codex fixture page ' + String(cursor));
-            return { jsonrpc: '2.0', id: 1, result: page.result };
-          },
-        })
-      );
-    case 'nativeClaudeModelCatalog': {
-      let closeCount = 0;
-      const outcomeValue = await outcomeAsync(() =>
-        discoverClaudeCodeModelCatalog({
-          close: () => undefined,
-          query: () => ({
-            supportedModels: async () => testCase.models,
-            return: async () => {
-              closeCount += 1;
-              return { done: true, value: undefined };
-            },
-          }),
-        })
-      );
-      return { outcome: outcomeValue, closeCount };
-    }
-    case 'claudeCodeRoutedProxyModel':
-      return outcome(() =>
-        claudeCodeRoutedProxyModel(testCase.model, testCase.nativeModelCatalog)
-      );
-    default:
-      return { threw: true, message: 'unknown op ' + String(testCase.op) };
-  }
-}
-
-const stdin = process.argv[2] ?? readFileSync(0, 'utf8');
-const cases = JSON.parse(stdin);
-writeFileSync(1, JSON.stringify(await Promise.all(cases.map(handle))));
-`;
-
-await mkdir(join(packageRoot, '.differential'), { recursive: true });
-
-await build({
-  stdin: {
-    contents: driverSource,
-    resolveDir: packageRoot,
-    sourcefile: 'protocol-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 __protocolOracleCreateRequire } from 'node:module';\nconst require = __protocolOracleCreateRequire(import.meta.url);",
-  },
-  platform: 'node',
-  target: 'node20',
-  format: 'esm',
-  outfile: join(packageRoot, '.differential/protocol-parity-oracle.mjs'),
-  minify: false,
-  sourcemap: false,
-  legalComments: 'none',
-  // The protocol modules are dependency-light; anything that leaks in from
-  // the wider commander graph stays external exactly like the entry build.
-  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
-});