Distillation

Date: Sep 16, 2026

• 🔴 (10:08) User established that the bundle test builds the bundle on demand in beforeAll, so it always runs against a bundle built for the current checkout.
• 🔴 (10:08) User established that bundle assertions never run against an artifact that predates source; freshness checks compare source modification times with the oldest required artifact, while dependency upgrades in node_modules / ORT WASM are intentionally excluded from staleness detection.
• 🔴 (10:08) User established that the published package never imports @loreai/core at runtime.
• 🔴 (10:08) User established that devDependencies are never installed for a transitively installed consumer; every internal @loreai/* package consumed at runtime must be a declared runtime dependency, and no internal @loreai/* package may be hidden in devDependencies.
• 🔴 (10:08) User’s packages/gateway/script/ort-platform-package.ts generates version-locked per-platform native ONNX Runtime npm packages modeled on esbuild’s platform-package approach: @loreai/onnxruntime-<os>-<arch>.
• 🔴 (10:08) User’s native ORT npm targets are exactly: linux-x64 (linux/x64), linux-arm64 (linux/arm64), darwin-arm64 (darwin/arm64), win32-x64 (win32/x64), and win32-arm64 (win32/arm64). darwin-x64 is absent because onnxruntime-node 1.27.0 dropped the Intel macOS prebuilt; Intel Macs fall back to WASM through null binding-path resolution.
• 🔴 (10:08) User’s native ORT platform packages use npm os/cpu gating as optionalDependencies, set preferUnplugged: true for Yarn PnP, contain no install script, and intentionally omit an exports map so runtime code can deep-resolve @loreai/onnxruntime-<target>/onnxruntime_binding.node.
• 🔴 (10:08) User’s native ORT package design avoids relying directly on onnxruntime-node postinstall downloads, which may not run automatically under npm 12 and can fail in offline, air-gapped, or proxied environments; when no platform package resolves, the gateway falls back to its bundled single-threaded WASM runtime.
• 🔴 (10:08) User stated bundled single-threaded WASM ONNX Runtime is 2.7–4.1× slower than native ONNX Runtime.
• 🔴 (10:08) buildOrtPlatformPackages(outDir, version, platforms) in packages/gateway/script/ort-platform-package.ts recreates outDir/onnxruntime-<target>/, copies the target’s native addon and shared libraries flat into the package root, and writes package.json plus README.md; package metadata includes loreOrtNodeVersion, license FSL-1.1-Apache-2.0, public publish access, repository git+https://github.com/BYK/loreai.git, and repository directory packages/gateway.
• 🔴 (10:08) The packages/gateway/script/ort-platform-package.ts CLI is tsx script/ort-platform-package.ts --out <dir> [--version x.y.z]; --out is required and exits with status 1 when absent, while version defaults to the gateway’s package.json version.