Distillation

Date: Sep 16, 2026

• 🔴 (12:15) User stated native ONNX Runtime package resolution is fail-closed and must never interrupt WASM fallback.
• 🔴 (12:15) User stated native ONNX Runtime binding resolution must search only the selected worker package’s own node_modules and must never select an arbitrary package.
• 🔴 (12:15) User stated resolveNativeOrtBindingPath must never throw when a package is unresolvable because this is the expected dist-only case.
• 🔴 (12:15) User stated native ONNX Runtime resolution must return null and never throw when native packages are absent.
• 🟡 (12:15) Added isNativeOrtLoadError(msg: string) to packages/core/src/embedding-worker-types.ts and packages/core/src/embedding-worker.ts. It requires both a native-runtime indicator (onnxruntime_binding.node, ONNX Runtime shared libraries, or OrtGetApiBase) and a load-failure indicator such as ERR_DLOPEN_FAILED, invalid ELF/Mach-O/Win32, truncated files, missing shared objects/images/modules, undefined or missing symbols, or dlopen.
• 🟡 (12:15) Expanded packages/core/test/ort-native.test.ts from 85 to 483 lines with filesystem-backed fixtures using mkdirSync, mkdtempSync, realpathSync, rmSync, symlinkSync, and writeFileSync; tests cover absent native packages, published-manifest mutations, workspace layouts, supported targets, worker loading, and native-addon load markers.
• 🟡 (12:15) Native runtime selection explicitly treats unknown Linux libc as unsupported and falls back to WASM.
• 🟡 (12:15) Repository search found 74 gateway-test matches related to process spawning or gateway bundles. packages/gateway/test/cli-bundle-smoke.test.ts uses packages/gateway/dist/bin.cjs, BUNDLE_TIMEOUT_MS = 30_000, and currently errors if the bundle is absent; packages/gateway/test/cli-signal-lifecycle.test.ts likewise requires that bundle for spawned CLI lifecycle tests.
• 🟢 (12:16) A subsequent file search returned “No files found.”