doppler-gpu 0.4.15 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1063) hide show
  1. package/CHANGELOG.md +33 -577
  2. package/LICENSE +21 -201
  3. package/README.md +165 -213
  4. package/models/catalog.json +241 -33
  5. package/package.json +122 -86
  6. package/src/capsule-runtime.d.ts +23 -0
  7. package/src/capsule-runtime.js +23 -0
  8. package/src/capsule.d.ts +8 -0
  9. package/src/capsule.js +4 -0
  10. package/src/cli/argument-contract.js +200 -0
  11. package/src/cli/browser-report-output.js +24 -0
  12. package/src/cli/cli-model-resolution.js +2 -2
  13. package/src/cli/cli-output.js +10 -0
  14. package/src/cli/commands/bundle.js +828 -0
  15. package/src/cli/doppler-cli.js +101 -1349
  16. package/src/cli/doppler-serve.js +18 -244
  17. package/src/cli/output/manifest.js +368 -0
  18. package/src/cli/runtime-profiles.js +4 -8
  19. package/src/cli/serve/capsule-handler.d.ts +33 -0
  20. package/src/cli/serve/capsule-handler.js +105 -0
  21. package/src/cli/serve/capsule-http.js +102 -0
  22. package/src/cli/serve/receipt.js +269 -0
  23. package/src/client/capsule-host.browser.js +1 -0
  24. package/src/client/capsule-host.d.ts +3 -0
  25. package/src/client/capsule-host.js +1 -0
  26. package/src/client/doppler-api.browser.js +42 -0
  27. package/src/client/doppler-api.d.ts +64 -1
  28. package/src/client/doppler-api.js +42 -1
  29. package/src/client/doppler-registry.js +15 -7
  30. package/src/client/electron/index.d.ts +4 -0
  31. package/src/client/electron/index.js +13 -0
  32. package/src/client/electron/ipc-contract.d.ts +9 -0
  33. package/src/client/electron/ipc-contract.js +56 -0
  34. package/src/client/electron/release-state.d.ts +53 -0
  35. package/src/client/electron/release-state.js +425 -0
  36. package/src/client/electron/renderer-runtime.d.ts +19 -0
  37. package/src/client/electron/renderer-runtime.js +104 -0
  38. package/src/client/failure-taxonomy.js +1 -28
  39. package/src/client/fault-injection.js +0 -8
  40. package/src/client/inspection.d.ts +122 -0
  41. package/src/client/inspection.js +343 -0
  42. package/src/client/model-host/index.d.ts +140 -0
  43. package/src/client/model-host/index.js +548 -0
  44. package/src/client/model-host/model-evidence.js +255 -0
  45. package/src/client/model-host/model-session.d.ts +322 -0
  46. package/src/client/model-host/model-session.js +593 -0
  47. package/src/client/provider.d.ts +18 -2
  48. package/src/client/provider.js +26 -3
  49. package/src/client/receipt.js +30 -72
  50. package/src/client/runtime/capsule-acquisition.d.ts +18 -0
  51. package/src/client/runtime/capsule-acquisition.js +103 -0
  52. package/src/client/runtime/capsule-adapter-execution.d.ts +17 -0
  53. package/src/client/runtime/capsule-adapter-execution.js +63 -0
  54. package/src/client/runtime/capsule-artifact-source.js +62 -0
  55. package/src/client/runtime/capsule-embedding.d.ts +29 -0
  56. package/src/client/runtime/capsule-embedding.js +76 -0
  57. package/src/client/runtime/capsule-forecast-program.d.ts +2 -0
  58. package/src/client/runtime/capsule-forecast-program.js +85 -0
  59. package/src/client/runtime/capsule-forecast.d.ts +17 -0
  60. package/src/client/runtime/capsule-forecast.js +31 -0
  61. package/src/client/runtime/capsule-operation-adapters.d.ts +12 -0
  62. package/src/client/runtime/capsule-operation-adapters.js +68 -0
  63. package/src/client/runtime/capsule-operation-executor.d.ts +25 -0
  64. package/src/client/runtime/capsule-operation-executor.js +100 -0
  65. package/src/client/runtime/capsule-program-adapter.js +151 -0
  66. package/src/client/runtime/capsule-release-authorization.js +25 -0
  67. package/src/client/runtime/capsule-rerank.d.ts +50 -0
  68. package/src/client/runtime/capsule-rerank.js +105 -0
  69. package/src/client/runtime/capsule-session-execution.js +85 -0
  70. package/src/client/runtime/command-executor.d.ts +15 -0
  71. package/src/client/runtime/command-executor.js +128 -0
  72. package/src/client/runtime/composition-root.d.ts +74 -0
  73. package/src/client/runtime/composition-root.js +344 -0
  74. package/src/client/runtime/fetch-capsule-artifact-store.d.ts +10 -0
  75. package/src/client/runtime/fetch-capsule-artifact-store.js +25 -0
  76. package/src/client/runtime/index.d.ts +1 -63
  77. package/src/client/runtime/index.js +1 -261
  78. package/src/client/runtime/lora.d.ts +14 -0
  79. package/src/client/runtime/lora.js +19 -1
  80. package/src/client/runtime/model-manager.d.ts +0 -4
  81. package/src/client/runtime/model-manager.js +12 -28
  82. package/src/client/runtime/model-rerank.js +30 -0
  83. package/src/client/runtime/model-session.d.ts +1 -174
  84. package/src/client/runtime/model-source.d.ts +19 -1
  85. package/src/client/runtime/model-source.js +46 -17
  86. package/src/client/runtime/node-quickstart-cache.js +1 -1
  87. package/src/client/runtime/resolution-policy.d.ts +20 -0
  88. package/src/client/runtime/resolution-policy.js +84 -0
  89. package/src/client/runtime/resource-binder.d.ts +24 -0
  90. package/src/client/runtime/resource-binder.js +135 -0
  91. package/src/client/runtime/scoped-session.d.ts +126 -0
  92. package/src/client/runtime/scoped-session.js +276 -0
  93. package/src/client/runtime/session-controller.d.ts +30 -0
  94. package/src/client/runtime/session-controller.js +170 -0
  95. package/src/client/runtime/source-runtime.js +1 -1
  96. package/src/client/runtime/target-selector.d.ts +9 -0
  97. package/src/client/runtime/target-selector.js +2 -0
  98. package/src/client/runtime/types.d.ts +1 -1
  99. package/src/client/runtime/types.js +0 -1
  100. package/src/client/runtime/verified-capsule-artifact-store.js +72 -0
  101. package/src/client/wrap-pipeline-handle.js +3 -9
  102. package/src/config/backward-registry-loader.js +1 -1
  103. package/src/config/capsule-adapter-policy.js +30 -0
  104. package/src/config/capsule-adapters.d.ts +21 -0
  105. package/src/config/capsule-adapters.js +40 -0
  106. package/src/config/capsule-adapters.json +9 -0
  107. package/src/config/capsule-loading.d.ts +2 -0
  108. package/src/config/capsule-loading.js +14 -0
  109. package/src/config/capsule-loading.schema.json +11 -0
  110. package/src/config/capsule-operation.d.ts +19 -0
  111. package/src/config/capsule-operation.js +58 -0
  112. package/src/config/capsule-operations.json +18 -0
  113. package/src/config/capsule-release-contract.d.ts +66 -0
  114. package/src/config/capsule-release-contract.js +197 -0
  115. package/src/config/capsule-release-events.d.ts +53 -0
  116. package/src/config/capsule-release-events.js +172 -0
  117. package/src/config/capsule-sequence-receipt.js +19 -0
  118. package/src/config/capsule-serve.d.ts +9 -0
  119. package/src/config/capsule-serve.js +28 -0
  120. package/src/config/capsule-serve.schema.json +14 -0
  121. package/src/config/capsule-signature.d.ts +6 -0
  122. package/src/config/capsule-signature.js +50 -0
  123. package/src/config/capsule-v2.d.ts +70 -0
  124. package/src/config/capsule-v2.js +431 -0
  125. package/src/config/capsule-v3.d.ts +19 -0
  126. package/src/config/capsule-v3.js +72 -0
  127. package/src/config/capsule.d.ts +22 -0
  128. package/src/config/capsule.js +52 -0
  129. package/src/config/conversion/amplify/amplify-120m-f16-af32.json +1 -1
  130. package/src/config/conversion/embeddinggemma/google-embeddinggemma-300m-q4k-ehf16-af32.json +1 -1
  131. package/src/config/conversion/esm/esm2-t12-35m-ur50d-f32-af32.json +41 -1
  132. package/src/config/conversion/esmc/esmc-300m-f32-af32.json +1 -1
  133. package/src/config/conversion/gemma3/gemma-3-1b-it-q4k-ehf16-af32.json +1 -1
  134. package/src/config/conversion/gemma3/gemma-3-270m-it-f16-af32.json +1 -1
  135. package/src/config/conversion/gemma3/gemma-3-270m-it-q4k-ehf16-af16.json +1 -1
  136. package/src/config/conversion/gemma3/gemma-3-270m-it-q4k-ehf16-af32.json +1 -1
  137. package/src/config/conversion/gemma3/translategemma-4b-1b-enes-q4k-ehf16-af32.json +1 -1
  138. package/src/config/conversion/gemma3/translategemma-4b-it-q4k-ehf16-af32.json +1 -1
  139. package/src/config/conversion/gemma4/gemma-4-12b-it-text-q4k-ehf16-af16.json +2 -2
  140. package/src/config/conversion/gemma4/gemma-4-12b-it-text-q4k-ehf16-af32.json +1 -1
  141. package/src/config/conversion/gemma4/gemma-4-12b-it-text-q4k-ehf16-hq4k-af16.json +1 -1
  142. package/src/config/conversion/gemma4/gemma-4-12b-it-text-w4a16-ct-ehf16-af16.json +1 -1
  143. package/src/config/conversion/gemma4/gemma-4-31b-it-text-q4k-ehf16-af16.json +2 -2
  144. package/src/config/conversion/gemma4/gemma-4-31b-it-text-q4k-ehf16-af32.json +1 -1
  145. package/src/config/conversion/gemma4/gemma-4-e2b-it-q4k-ehf16-af16-int4ple.json +3 -3
  146. package/src/config/conversion/gemma4/gemma-4-e2b-it-q4k-ehf16-af32-int4ple.json +1 -1
  147. package/src/config/conversion/gemma4/gemma-4-e2b-it-q4k-ehf16-af32.json +1 -1
  148. package/src/config/conversion/glmocr/glm-ocr-f16-af32.json +442 -0
  149. package/src/config/conversion/minicpm/minicpm4-0-5b-f16-af32.json +1 -1
  150. package/src/config/conversion/muse-glimmer/muse-glimmer-30b-text-bf16-af32.json +529 -0
  151. package/src/config/conversion/muse-glimmer/muse-glimmer-30b-text-f16-af32.json +529 -0
  152. package/src/config/conversion/nucleotide-transformer/nucleotide-transformer-v2-50m-f32-af32.json +1 -1
  153. package/src/config/conversion/qwen3/qwen-3-5-0-8b-q4k-ehaf16.json +1 -1
  154. package/src/config/conversion/qwen3/qwen-3-5-2b-q4k-ehaf16.json +1 -1
  155. package/src/config/conversion/qwen3/qwen-3-5-9b-f16-af32.json +1 -1
  156. package/src/config/conversion/qwen3/qwen-3-5-9b-q4k-ehaf16.json +1 -1
  157. package/src/config/conversion/qwen3/qwen-3-6-27b-q4k-eaf16.json +2 -2
  158. package/src/config/conversion/qwen3/qwen-3-6-27b-q4k-ehaf16.json +1 -1
  159. package/src/config/conversion/qwen3/qwen-3-embedding-0-6b-f16-af32.json +463 -0
  160. package/src/config/conversion/qwen3/qwen-3-embedding-0-6b-q4k-ehf16-af32.json +1 -1
  161. package/src/config/conversion/qwen3/qwen-3-reranker-0-6b-f16-af32.json +1 -1
  162. package/src/config/conversion/qwen3/qwen-3-reranker-0-6b-f16-true-logit-af32.json +481 -0
  163. package/src/config/conversion/qwen3/qwen-3-reranker-0-6b-q4k-ehf16-af32.json +59 -7
  164. package/src/config/conversion/qwen3/qwen3.8-27b-text-f16-af32.json +561 -0
  165. package/src/config/conversion/qwen3/qwen3.8-27b-text-q4k-ehaf16.json +558 -0
  166. package/src/config/dtype-transition-contract.js +40 -0
  167. package/src/config/embedding-contract.js +26 -0
  168. package/src/config/embedding-reference.js +85 -0
  169. package/src/config/evidence/boundary-evidence-policy.json +54 -0
  170. package/src/config/evidence/source-intake-policy.json +122 -0
  171. package/src/config/execution-contract-check.d.ts +16 -73
  172. package/src/config/execution-contract-check.js +7 -429
  173. package/src/config/forecast-manifest.js +56 -0
  174. package/src/config/heterogeneous-attention-contract.js +46 -0
  175. package/src/config/initial-execution-identity.d.ts +58 -0
  176. package/src/config/initial-execution-identity.js +331 -0
  177. package/src/config/inspection/observation-policies.json +80 -0
  178. package/src/config/kernel-path-loader.d.ts +10 -0
  179. package/src/config/kernel-path-loader.js +23 -8
  180. package/src/config/kernel-registry-contract.d.ts +25 -0
  181. package/src/config/kernel-registry-contract.js +46 -0
  182. package/src/config/kernels/kernel-ref-digests.js +50 -2
  183. package/src/config/kernels/registry.js +1 -1
  184. package/src/config/kernels/registry.json +13592 -11377
  185. package/src/config/lora-layouts.d.ts +10 -0
  186. package/src/config/lora-layouts.js +17 -0
  187. package/src/config/lora-layouts.json +9 -0
  188. package/src/config/manifest-inference-validation.js +575 -0
  189. package/src/config/merge/execution-patches.js +12 -0
  190. package/src/config/{merge-helpers.js → merge/kernel-path-policy.js} +0 -52
  191. package/src/config/merge/value-selection.js +38 -0
  192. package/src/config/merge.js +43 -11
  193. package/src/config/model-ir-v2.d.ts +57 -0
  194. package/src/config/model-ir-v2.js +258 -0
  195. package/src/config/model-ir.d.ts +49 -0
  196. package/src/config/model-ir.js +180 -0
  197. package/src/config/param-validator.js +22 -37
  198. package/src/config/platforms/amd-strix-halo-gfx1151.json +17 -0
  199. package/src/config/platforms/loader.js +2 -1
  200. package/src/config/production-release-evidence.d.ts +23 -0
  201. package/src/config/production-release-evidence.js +423 -0
  202. package/src/config/production-release.js +321 -0
  203. package/src/{client/doppler-registry.json → config/quickstart-registry.json} +7 -7
  204. package/src/config/required-inference-fields-contract-check.js +2 -2
  205. package/src/config/rerank-reference.d.ts +28 -0
  206. package/src/config/rerank-reference.js +89 -0
  207. package/src/config/revocation-policy.d.ts +65 -0
  208. package/src/config/revocation-policy.js +290 -0
  209. package/src/config/revocation-registry.json +11 -0
  210. package/src/config/revocation-updates.d.ts +68 -0
  211. package/src/config/revocation-updates.js +440 -0
  212. package/src/config/runtime/compute/f16-activations.json +1 -0
  213. package/src/config/runtime/compute/f16-batched.json +1 -0
  214. package/src/config/runtime/default.json +1 -0
  215. package/src/config/runtime/diagnostics/debug-logits.json +1 -0
  216. package/src/config/runtime/experiments/bench/gemma3-bench-q4k-alt.json +1 -0
  217. package/src/config/runtime/experiments/bench/gemma3-bench-q4k-batched.json +1 -0
  218. package/src/config/runtime/experiments/bench/gemma3-bench-q4k.json +1 -0
  219. package/src/config/runtime/experiments/bench/gemma4-bench-q4k.json +1 -0
  220. package/src/config/runtime/experiments/bench/qwen3-bench-q4k-alt.json +1 -0
  221. package/src/config/runtime/experiments/bench/qwen3-bench-q4k-batched.json +1 -0
  222. package/src/config/runtime/experiments/debug/gemma3-browser-diagnose-q4k.json +1 -1
  223. package/src/config/runtime/experiments/debug/gemma3-debug-q4k.json +1 -3
  224. package/src/config/runtime/experiments/debug/gemma4-e2b-browser-diagnose-q4k.json +1 -1
  225. package/src/config/runtime/experiments/debug/qwen35-browser-diagnose-q4k.json +1 -1
  226. package/src/config/runtime/experiments/verify/gemma3-verify.json +1 -3
  227. package/src/config/runtime/experiments/verify/gemma4-e2b-verify.json +1 -3
  228. package/src/config/runtime/experiments/verify/lfm2-verify.json +1 -3
  229. package/src/config/runtime/experiments/verify/translategemma-verify.json +1 -3
  230. package/src/config/runtime/model/gemma2-debug.json +1 -0
  231. package/src/config/runtime/model/gemma2-pipeline-debug.json +1 -0
  232. package/src/config/runtime/model/gemma2-pipeline.json +1 -0
  233. package/src/config/runtime/model/gemma3-layer-probe.json +1 -0
  234. package/src/config/runtime/model/qwen3-5-layer-probe.json +1 -0
  235. package/src/config/runtime/model/qwen3-5-layer3-boundary-probe.json +1 -0
  236. package/src/config/runtime/model/qwen3-5-linear-attn-debug.json +1 -0
  237. package/src/config/runtime/optimization-candidates/registry.json +5 -0
  238. package/src/config/runtime/platform/metal-apple-q4k.json +1 -0
  239. package/src/config/runtime/profiles/default.json +1 -0
  240. package/src/config/runtime/profiles/diffusiongemma-26b-a4b-throughput.json +1 -0
  241. package/src/config/runtime/profiles/gemma3-270m-q4k-throughput-overlapped-probe.json +1 -0
  242. package/src/config/runtime/profiles/gemma3-270m-q4k-throughput-probe.json +1 -0
  243. package/src/config/runtime/profiles/gemma4-12b-rdrr-safe-b4.json +1 -3
  244. package/src/config/runtime/profiles/gemma4-12b-rdrr-safe-single.json +1 -3
  245. package/src/config/runtime/profiles/gemma4-31b-f16-activations-probe.json +2 -6
  246. package/src/config/runtime/profiles/gemma4-e2b-baseline-probe.json +1 -3
  247. package/src/config/runtime/profiles/gemma4-e2b-fused-rmsnorm-probe.json +1 -3
  248. package/src/config/runtime/profiles/gemma4-e2b-fused-rmsnorm-test.json +1 -0
  249. package/src/config/runtime/profiles/gemma4-e2b-int4ple-baseline-probe.json +1 -5
  250. package/src/config/runtime/profiles/gemma4-e2b-int4ple-f16a-probe.json +1 -5
  251. package/src/config/runtime/profiles/gemma4-e2b-int4ple-reference-export.json +1 -3
  252. package/src/config/runtime/profiles/gemma4-e2b-int4ple-retain-q4k-probe.json +1 -5
  253. package/src/config/runtime/profiles/gemma4-e2b-low-memory.json +1 -0
  254. package/src/config/runtime/profiles/gemma4-e2b-prefill-profile.json +1 -3
  255. package/src/config/runtime/profiles/gemma4-e2b-throughput-probe.json +1 -0
  256. package/src/config/runtime/profiles/low-memory.json +1 -0
  257. package/src/config/runtime/profiles/muse-glimmer-30b-source-parity-f32kv.json +30 -0
  258. package/src/config/runtime/profiles/muse-glimmer-30b-source-parity.json +110 -0
  259. package/src/config/runtime/profiles/production.json +1 -3
  260. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-attn128-candidate.json +1 -0
  261. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-maxbatch64-candidate.json +1 -0
  262. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-normed-ffn-candidate.json +1 -0
  263. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-overlap-ringtokens1-candidate.json +1 -0
  264. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-parity.json +1 -0
  265. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-sequential-candidate.json +1 -0
  266. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-throughput.json +1 -0
  267. package/src/config/runtime/profiles/qwen-3-5-0-8b-prefill-profile.json +1 -3
  268. package/src/config/runtime/profiles/qwen-3-5-0-8b-throughput-probe.json +1 -0
  269. package/src/config/runtime/profiles/qwen-3-5-2b-f16-primary-throughput.json +1 -5
  270. package/src/config/runtime/profiles/qwen-3-5-2b-metal-parity.json +1 -0
  271. package/src/config/runtime/profiles/qwen-3-5-2b-metal-throughput.json +1 -0
  272. package/src/config/runtime/profiles/qwen-3-5-9b-metal-correctness.json +1 -0
  273. package/src/config/runtime/profiles/qwen-3-embedding-0-6b-metal-stability.json +1 -3
  274. package/src/config/runtime/profiles/qwen-3-embedding-0-6b-metal-throughput.json +1 -0
  275. package/src/config/runtime/profiles/qwen-3-reranker-0-6b-metal-stability.json +1 -0
  276. package/src/config/runtime/profiles/qwen-3-reranker-0-6b-metal-throughput.json +1 -0
  277. package/src/config/runtime/profiles/qwen3-6-27b-f16-activations-probe.json +2 -6
  278. package/src/config/runtime/profiles/qwen3-8-27b-source-parity.json +87 -0
  279. package/src/config/runtime/profiles/rerank-stability.json +1 -3
  280. package/src/config/runtime/profiles/rerank-throughput.json +1 -3
  281. package/src/config/runtime/profiles/simulation.json +1 -3
  282. package/src/config/runtime/profiles/throughput.json +1 -3
  283. package/src/config/runtime/profiles/trace-layers.json +1 -3
  284. package/src/config/runtime/profiles/translategemma-1b-nativekd2-q4k-rdna3-throughput-probe.json +1 -0
  285. package/src/config/runtime/profiles/turboquant-contiguous-prod.json +1 -0
  286. package/src/config/runtime/profiles/turboquant-contiguous.json +1 -0
  287. package/src/config/runtime/profiles/turboquant.json +1 -0
  288. package/src/config/runtime/profiles/vector-stability.json +1 -3
  289. package/src/config/runtime/profiles/vector-throughput.json +1 -0
  290. package/src/config/runtime/profiles/verbose-trace.json +1 -3
  291. package/src/config/runtime/tiers/gemma4-128gb.json +1 -0
  292. package/src/config/runtime/tiers/gemma4-16gb.json +1 -0
  293. package/src/config/runtime/tiers/gemma4-24gb.json +1 -0
  294. package/src/config/runtime/tiers/gemma4-32gb.json +1 -0
  295. package/src/config/runtime-merge.js +1 -1
  296. package/src/config/runtime.js +1 -1
  297. package/src/config/schema/benchmark.schema.d.ts +7 -0
  298. package/src/config/schema/benchmark.schema.js +5 -0
  299. package/src/config/schema/browser-suite-metrics.schema.d.ts +1 -0
  300. package/src/config/schema/browser-suite-metrics.schema.js +2 -0
  301. package/src/config/schema/conversion-report.schema.d.ts +3 -0
  302. package/src/config/schema/conversion-report.schema.js +29 -0
  303. package/src/config/schema/converter.schema.d.ts +1 -0
  304. package/src/config/schema/debug.schema.d.ts +1 -0
  305. package/src/config/schema/doppler.schema.js +5 -5
  306. package/src/config/schema/emulation.schema.js +1 -1
  307. package/src/config/schema/execution-v1.schema.d.ts +3 -0
  308. package/src/config/schema/execution-v1.schema.js +19 -0
  309. package/src/config/schema/harness.schema.d.ts +13 -0
  310. package/src/config/schema/harness.schema.js +6 -0
  311. package/src/config/schema/index.d.ts +8 -16
  312. package/src/config/schema/index.js +5 -8
  313. package/src/config/schema/inference.schema.d.ts +21 -2
  314. package/src/config/schema/kernel-thresholds.schema.d.ts +0 -12
  315. package/src/config/schema/kernel-thresholds.schema.js +1 -13
  316. package/src/config/schema/kernel-warmup.schema.d.ts +1 -3
  317. package/src/config/schema/kernel-warmup.schema.js +0 -1
  318. package/src/config/schema/manifest.schema.d.ts +26 -7
  319. package/src/config/schema/manifest.schema.js +10 -1
  320. package/src/config/schema/program-bundle.schema.d.ts +52 -6
  321. package/src/config/schema/program-bundle.schema.js +145 -10
  322. package/src/config/schema/runtime-profile.schema.d.ts +24 -0
  323. package/src/config/schema/runtime-profile.schema.js +92 -0
  324. package/src/config/schema/shared-runtime.schema.d.ts +1 -4
  325. package/src/config/schema/shared-runtime.schema.js +0 -2
  326. package/src/config/schema/tooling.schema.d.ts +8 -5
  327. package/src/config/schema/tooling.schema.js +3 -2
  328. package/src/config/sequence-reference.d.ts +26 -0
  329. package/src/config/sequence-reference.js +100 -0
  330. package/src/config/target-plan.d.ts +108 -0
  331. package/src/config/target-plan.js +411 -0
  332. package/src/config/training-defaults.js +1 -1
  333. package/src/config/transforms/capability-transform-resolver.js +4 -105
  334. package/src/config/transforms/execution-graph/dtype.js +591 -0
  335. package/src/config/transforms/execution-graph/fusion.js +436 -0
  336. package/src/config/transforms/execution-graph/validation.js +414 -0
  337. package/src/config/transforms/execution-graph-transforms.js +13 -1419
  338. package/src/converter/artifact-identity.js +475 -0
  339. package/src/converter/conversion-plan.js +1 -1
  340. package/src/converter/core.js +94 -2096
  341. package/src/converter/forge-candidate-evaluation.js +271 -0
  342. package/src/converter/forge-qualification.js +162 -0
  343. package/src/converter/forge-stages.js +798 -0
  344. package/src/converter/manifest-builder.js +683 -0
  345. package/src/converter/quantization-info.js +4 -1
  346. package/src/converter/quantizer.js +58 -9
  347. package/src/converter/shard-packer.d.ts +1 -1
  348. package/src/converter/shard-packer.js +2 -2
  349. package/src/converter/tensor-transform.js +640 -0
  350. package/src/converter/tokenizer-contract.js +243 -0
  351. package/src/converter/tokenizer-manifest.js +243 -0
  352. package/src/debug/history.js +0 -8
  353. package/src/debug/index.js +0 -10
  354. package/src/debug/tensor.d.ts +2 -0
  355. package/src/debug/tensor.js +21 -2
  356. package/src/debug/trace.js +0 -7
  357. package/src/experimental/adapters/adapter-manager.js +2 -0
  358. package/src/experimental/adapters/adapter-manifest.d.ts +6 -0
  359. package/src/experimental/adapters/adapter-manifest.js +11 -0
  360. package/src/experimental/adapters/artifact-contract.d.ts +2 -2
  361. package/src/experimental/adapters/artifact-contract.js +5 -2
  362. package/src/experimental/adapters/lora-loader.d.ts +10 -1
  363. package/src/experimental/adapters/lora-loader.js +110 -48
  364. package/src/{inference/pipelines → experimental}/audio/gemma4.js +9 -31
  365. package/src/experimental/bdpa/basis-decomposed-paged.d.ts +50 -0
  366. package/src/experimental/bdpa/basis-decomposed-paged.js +276 -0
  367. package/src/experimental/bridge/trainer-artifact-bridge.js +3 -3
  368. package/src/experimental/browser/browser-converter.js +11 -11
  369. package/src/experimental/diffusion/index.d.ts +1 -1
  370. package/src/experimental/diffusion/index.js +1 -1
  371. package/src/{inference/pipelines → experimental}/diffusion/pipeline.d.ts +2 -2
  372. package/src/{inference/pipelines → experimental}/diffusion/pipeline.js +17 -17
  373. package/src/{inference/pipelines → experimental}/diffusion/text-encoder-gpu.js +21 -19
  374. package/src/experimental/diffusion/vae.js +596 -0
  375. package/src/experimental/distribution/shard-delivery/receipt.js +588 -0
  376. package/src/experimental/distribution/shard-delivery/retry.js +392 -0
  377. package/src/experimental/distribution/shard-delivery/transport.js +831 -0
  378. package/src/experimental/distribution/shard-delivery.js +4 -1709
  379. package/src/experimental/energy/index.d.ts +2 -2
  380. package/src/experimental/energy/index.js +2 -2
  381. package/src/{inference/pipelines → experimental}/energy/pipeline.js +13 -13
  382. package/src/{inference/pipelines → experimental}/energy/types.d.ts +2 -2
  383. package/src/experimental/logits/cpu-output.d.ts +27 -0
  384. package/src/{inference/pipelines/text/logits/utils.js → experimental/logits/cpu-output.js} +19 -27
  385. package/src/experimental/logits/cpu.d.ts +87 -0
  386. package/src/experimental/logits/cpu.js +95 -0
  387. package/src/experimental/orchestration/energy-row-head-pipeline.d.ts +103 -0
  388. package/src/{inference/pipelines/energy-head/row-head-pipeline.js → experimental/orchestration/energy-row-head-pipeline.js} +13 -13
  389. package/src/experimental/orchestration/index.d.ts +1 -1
  390. package/src/experimental/orchestration/index.js +1 -1
  391. package/src/experimental/training/artifacts.js +2 -2
  392. package/src/experimental/training/checkpoint.js +2 -2
  393. package/src/experimental/training/distillation/artifacts.js +1 -1
  394. package/src/experimental/training/distillation/dataset.js +2 -2
  395. package/src/experimental/training/distillation/eval.js +1 -1
  396. package/src/experimental/training/distillation/runtime.js +2 -2
  397. package/src/experimental/training/distillation/student-fixture/execution.js +166 -0
  398. package/src/experimental/training/distillation/student-fixture/model.js +353 -0
  399. package/src/experimental/training/distillation/student-fixture.js +2 -469
  400. package/src/experimental/training/lora/checkpoint.js +746 -0
  401. package/src/experimental/training/lora/execution.js +550 -0
  402. package/src/experimental/training/lora/plan.js +387 -0
  403. package/src/experimental/training/lora/recovery.js +418 -0
  404. package/src/experimental/training/lora-pipeline.js +7 -1949
  405. package/src/experimental/training/operator-artifacts.js +2 -2
  406. package/src/experimental/training/operator-command.js +4 -4
  407. package/src/experimental/training/runner/evaluation.js +62 -0
  408. package/src/experimental/training/runner/lifecycle.js +257 -0
  409. package/src/experimental/training/runner.js +5 -268
  410. package/src/experimental/training/suite/execution.js +879 -0
  411. package/src/experimental/training/suite/plan.js +855 -0
  412. package/src/experimental/training/suite.js +5 -1659
  413. package/src/experimental/training/workloads.d.ts +5 -5
  414. package/src/experimental/training/workloads.js +6 -6
  415. package/src/experimental/turboquant/codebook.js +470 -0
  416. package/src/formats/quantization-constants.d.ts +11 -0
  417. package/src/formats/quantization-constants.js +11 -0
  418. package/src/formats/rdrr/integrity.js +1 -1
  419. package/src/formats/rdrr/lowerings.js +0 -29
  420. package/src/formats/rdrr/merkle.js +1 -1
  421. package/src/formats/rdrr/tensor-config-validator.js +25 -5
  422. package/src/formats/rdrr/validation.js +3 -3
  423. package/src/gpu/command-recorder.d.ts +15 -1
  424. package/src/gpu/command-recorder.js +63 -2
  425. package/src/gpu/constant-buffer.js +29 -0
  426. package/src/gpu/device-state.js +36 -0
  427. package/src/gpu/device.js +6 -41
  428. package/src/gpu/kernel-runtime.js +3 -10
  429. package/src/gpu/kernels/activation-static-qdq.js +1 -1
  430. package/src/gpu/kernels/append_embedding.wgsl +14 -0
  431. package/src/gpu/kernels/attention/executors.js +960 -0
  432. package/src/gpu/kernels/attention/plan.js +472 -0
  433. package/src/gpu/kernels/attention.d.ts +4 -0
  434. package/src/gpu/kernels/attention.js +145 -1545
  435. package/src/gpu/kernels/attention_relative.wgsl +59 -0
  436. package/src/gpu/kernels/backward/adam.js +2 -1
  437. package/src/gpu/kernels/backward/attention_backward.js +1 -1
  438. package/src/gpu/kernels/backward/bias_add_backward.d.ts +1 -1
  439. package/src/gpu/kernels/backward/bias_add_backward.js +1 -1
  440. package/src/gpu/kernels/backward/causal_conv1d_silu_backward.js +2 -1
  441. package/src/gpu/kernels/backward/conv2d_backward.d.ts +1 -1
  442. package/src/gpu/kernels/backward/conv2d_backward.js +2 -1
  443. package/src/gpu/kernels/backward/cross_entropy_backward.d.ts +1 -1
  444. package/src/gpu/kernels/backward/cross_entropy_backward.js +1 -1
  445. package/src/gpu/kernels/backward/embed_backward.js +2 -1
  446. package/src/gpu/kernels/backward/executor.d.ts +34 -0
  447. package/src/gpu/kernels/backward/executor.js +158 -0
  448. package/src/gpu/kernels/backward/gated_delta_recurrent_backward.js +2 -1
  449. package/src/gpu/kernels/backward/gated_rmsnorm_backward.js +2 -1
  450. package/src/gpu/kernels/backward/gelu_backward.d.ts +1 -1
  451. package/src/gpu/kernels/backward/gelu_backward.js +1 -1
  452. package/src/gpu/kernels/backward/groupnorm_backward.d.ts +1 -1
  453. package/src/gpu/kernels/backward/groupnorm_backward.js +1 -1
  454. package/src/gpu/kernels/backward/layernorm_backward.d.ts +1 -1
  455. package/src/gpu/kernels/backward/layernorm_backward.js +2 -1
  456. package/src/gpu/kernels/backward/matmul.js +133 -0
  457. package/src/gpu/kernels/backward/matmul_backward.d.ts +0 -1
  458. package/src/gpu/kernels/backward/matmul_backward.js +1 -1
  459. package/src/gpu/kernels/backward/pixel_shuffle_backward.d.ts +1 -1
  460. package/src/gpu/kernels/backward/pixel_shuffle_backward.js +1 -1
  461. package/src/gpu/kernels/backward/rmsnorm_backward.d.ts +1 -1
  462. package/src/gpu/kernels/backward/rmsnorm_backward.js +2 -1
  463. package/src/gpu/kernels/backward/rope_backward.d.ts +1 -1
  464. package/src/gpu/kernels/backward/rope_backward.js +2 -1
  465. package/src/gpu/kernels/backward/scale_backward.d.ts +1 -1
  466. package/src/gpu/kernels/backward/scale_backward.js +2 -1
  467. package/src/gpu/kernels/backward/silu_backward.d.ts +1 -1
  468. package/src/gpu/kernels/backward/silu_backward.js +1 -1
  469. package/src/gpu/kernels/backward/softmax_backward.d.ts +1 -1
  470. package/src/gpu/kernels/backward/softmax_backward.js +1 -1
  471. package/src/gpu/kernels/backward/upsample2d_backward.d.ts +1 -1
  472. package/src/gpu/kernels/backward/upsample2d_backward.js +1 -1
  473. package/src/gpu/kernels/backward/utils.js +2 -392
  474. package/src/gpu/kernels/bind-group-validation.js +16 -0
  475. package/src/gpu/kernels/cast.js +2 -1
  476. package/src/gpu/kernels/check-finiteness.js +13 -49
  477. package/src/gpu/kernels/check-hot-vocab-stop.js +13 -39
  478. package/src/gpu/kernels/check-stop.js +14 -33
  479. package/src/gpu/kernels/check_finiteness.wgsl +33 -0
  480. package/src/gpu/kernels/check_hot_vocab_stop.wgsl +29 -0
  481. package/src/gpu/kernels/check_stop.wgsl +20 -0
  482. package/src/gpu/kernels/clamp.js +1 -1
  483. package/src/gpu/kernels/conv2d.js +1 -1
  484. package/src/gpu/kernels/cross_entropy_loss.js +1 -1
  485. package/src/gpu/kernels/depthwise_conv1d.js +1 -1
  486. package/src/gpu/kernels/depthwise_conv2d.js +1 -1
  487. package/src/gpu/kernels/dequant.js +7 -2
  488. package/src/gpu/kernels/diffusion-gemma-sampling.js +3 -5
  489. package/src/gpu/kernels/dispatch.js +12 -1
  490. package/src/gpu/kernels/embedding-pool.js +72 -0
  491. package/src/gpu/kernels/embedding_pool_f16.wgsl +38 -0
  492. package/src/gpu/kernels/embedding_pool_f32.wgsl +36 -0
  493. package/src/gpu/kernels/energy.js +2 -1
  494. package/src/gpu/kernels/forecast_output.wgsl +17 -0
  495. package/src/gpu/kernels/fused-gate-up-gelu.js +1 -1
  496. package/src/gpu/kernels/fused_ffn.js +10 -220
  497. package/src/gpu/kernels/fused_matmul_residual.js +2 -1
  498. package/src/gpu/kernels/fused_matmul_rmsnorm.js +2 -1
  499. package/src/gpu/kernels/fused_normed_ffn_q4k.wgsl +208 -0
  500. package/src/gpu/kernels/gated-short-conv.js +11 -69
  501. package/src/gpu/kernels/gated_delta_conv.wgsl +66 -0
  502. package/src/gpu/kernels/gated_delta_conv_f16.wgsl +68 -0
  503. package/src/gpu/kernels/gated_delta_fused_decode.wgsl +173 -0
  504. package/src/gpu/kernels/gated_delta_fused_decode_f16.wgsl +175 -0
  505. package/src/gpu/kernels/gated_delta_recurrent.wgsl +165 -0
  506. package/src/gpu/kernels/gated_delta_recurrent_f16.wgsl +167 -0
  507. package/src/gpu/kernels/gated_short_conv.wgsl +47 -0
  508. package/src/gpu/kernels/gather.d.ts +1 -1
  509. package/src/gpu/kernels/gather.js +30 -6
  510. package/src/gpu/kernels/gather_bf16.wgsl +69 -0
  511. package/src/gpu/kernels/gelu.js +1 -1
  512. package/src/gpu/kernels/gemma4-route-expert.js +1 -1
  513. package/src/gpu/kernels/grouped_pointwise_conv2d.js +1 -1
  514. package/src/gpu/kernels/groupnorm.js +1 -1
  515. package/src/gpu/kernels/index.d.ts +38 -7
  516. package/src/gpu/kernels/index.js +18 -6
  517. package/src/gpu/kernels/instance_stats.wgsl +26 -0
  518. package/src/gpu/kernels/kernel-base.js +1 -1
  519. package/src/gpu/kernels/kernel-cache-lifecycle.d.ts +9 -0
  520. package/src/gpu/kernels/kernel-cache-lifecycle.js +26 -0
  521. package/src/gpu/kernels/kernel-configs.d.ts +10 -61
  522. package/src/gpu/kernels/kernel-configs.js +26 -54
  523. package/src/gpu/kernels/kernel-execution.js +141 -0
  524. package/src/gpu/kernels/kernel-prewarm.d.ts +3 -0
  525. package/src/gpu/kernels/kernel-prewarm.js +60 -0
  526. package/src/gpu/kernels/kv-cache-write.js +4 -4
  527. package/src/gpu/kernels/kv-quantize.js +4 -1
  528. package/src/gpu/kernels/l2-normalize.js +36 -0
  529. package/src/gpu/kernels/l2_normalize.wgsl +53 -0
  530. package/src/gpu/kernels/layernorm.d.ts +4 -4
  531. package/src/gpu/kernels/layernorm.js +44 -7
  532. package/src/gpu/kernels/linear-attention-core.js +29 -449
  533. package/src/gpu/kernels/linear_attention.js +1 -1
  534. package/src/gpu/kernels/lm-head-argmax.js +2 -2
  535. package/src/gpu/kernels/lm-head-select-logits.js +2 -2
  536. package/src/gpu/kernels/logit-finalize.js +103 -0
  537. package/src/gpu/kernels/logit-merge.js +13 -125
  538. package/src/gpu/kernels/logit-scatter.js +40 -0
  539. package/src/gpu/kernels/logit_finalize_f16.wgsl +43 -0
  540. package/src/gpu/kernels/logit_finalize_f32.wgsl +41 -0
  541. package/src/gpu/kernels/logit_merge_geometric.wgsl +23 -0
  542. package/src/gpu/kernels/logit_merge_max.wgsl +23 -0
  543. package/src/gpu/kernels/logit_merge_weighted.wgsl +23 -0
  544. package/src/gpu/kernels/logit_scatter_f16.wgsl +26 -0
  545. package/src/gpu/kernels/logit_scatter_f32.wgsl +24 -0
  546. package/src/gpu/kernels/matmul-dispatch.js +6 -1
  547. package/src/gpu/kernels/matmul-selection.js +3 -2
  548. package/src/gpu/kernels/matmul.js +4 -15
  549. package/src/gpu/kernels/matmul_bf16w_f32a.wgsl +93 -0
  550. package/src/gpu/kernels/matmul_gemv_subgroup_bf16w.wgsl +433 -0
  551. package/src/gpu/kernels/modulate.js +1 -1
  552. package/src/gpu/kernels/moe.js +3 -1
  553. package/src/gpu/kernels/moe_router_bias_add_f16_f16.wgsl +23 -0
  554. package/src/gpu/kernels/moe_router_bias_add_f16_f32.wgsl +23 -0
  555. package/src/gpu/kernels/moe_router_bias_add_f32_f16.wgsl +23 -0
  556. package/src/gpu/kernels/moe_router_bias_add_f32_f32.wgsl +21 -0
  557. package/src/gpu/kernels/patch_context.wgsl +29 -0
  558. package/src/gpu/kernels/pipeline-cache.js +3 -1
  559. package/src/gpu/kernels/pixel_shuffle.js +1 -1
  560. package/src/gpu/kernels/probe_shader_f16.wgsl +7 -0
  561. package/src/gpu/kernels/relu.js +1 -1
  562. package/src/gpu/kernels/repeat_channels.js +1 -1
  563. package/src/gpu/kernels/residual.js +2 -2
  564. package/src/gpu/kernels/rmsnorm-pair.js +1 -1
  565. package/src/gpu/kernels/rmsnorm-qk.js +1 -1
  566. package/src/gpu/kernels/rmsnorm-stats.js +14 -113
  567. package/src/gpu/kernels/rmsnorm.js +1 -1
  568. package/src/gpu/kernels/rmsnorm_serial.wgsl +19 -0
  569. package/src/gpu/kernels/rmsnorm_stats.wgsl +59 -0
  570. package/src/gpu/kernels/rmsnorm_stats_subgroups.wgsl +76 -0
  571. package/src/gpu/kernels/rope-precompute.js +160 -0
  572. package/src/gpu/kernels/rope-qk.js +1 -1
  573. package/src/gpu/kernels/rope.js +2 -2
  574. package/src/gpu/kernels/rope_precompute.wgsl +74 -0
  575. package/src/gpu/kernels/sample.js +5 -1
  576. package/src/gpu/kernels/scale.js +1 -1
  577. package/src/gpu/kernels/shader-cache.js +8 -4
  578. package/src/gpu/kernels/shader-source-scope.js +68 -0
  579. package/src/gpu/kernels/silu.js +2 -1
  580. package/src/gpu/kernels/soft-embedding.js +3 -1
  581. package/src/gpu/kernels/softmax.js +4 -2
  582. package/src/gpu/kernels/split-qkv-rmsnorm-qk.js +1 -1
  583. package/src/gpu/kernels/split-qkv-rmsnorm-rope-qk.js +1 -1
  584. package/src/gpu/kernels/split_qg.js +1 -1
  585. package/src/gpu/kernels/split_qkv.d.ts +2 -0
  586. package/src/gpu/kernels/split_qkv.js +18 -3
  587. package/src/gpu/kernels/split_qkv.wgsl +5 -2
  588. package/src/gpu/kernels/split_qkv_f16.wgsl +5 -2
  589. package/src/gpu/kernels/submit_probe.wgsl +6 -0
  590. package/src/gpu/kernels/transpose.js +1 -1
  591. package/src/gpu/kernels/turboquant-codebook.js +4 -535
  592. package/src/gpu/kernels/uniform-utils.js +7 -2
  593. package/src/gpu/kernels/upsample2d.js +1 -1
  594. package/src/gpu/kernels/utils.js +9 -332
  595. package/src/gpu/kernels/vision-average-pool.d.ts +13 -0
  596. package/src/gpu/kernels/vision-average-pool.js +68 -0
  597. package/src/gpu/kernels/vision-patch-embed.d.ts +17 -0
  598. package/src/gpu/kernels/vision-patch-embed.js +117 -0
  599. package/src/gpu/kernels/vision-position-embedding.d.ts +13 -0
  600. package/src/gpu/kernels/vision-position-embedding.js +79 -0
  601. package/src/gpu/kernels/vision-rope-2d.d.ts +16 -0
  602. package/src/gpu/kernels/vision-rope-2d.js +73 -0
  603. package/src/gpu/kernels/vision-spatial-merge.d.ts +19 -0
  604. package/src/gpu/kernels/vision-spatial-merge.js +100 -0
  605. package/src/gpu/kernels/vision_average_pool.wgsl +42 -0
  606. package/src/gpu/kernels/vision_patch_embed.wgsl +59 -0
  607. package/src/gpu/kernels/vision_patch_embed_f16w.wgsl +61 -0
  608. package/src/gpu/kernels/vision_position_embedding.wgsl +33 -0
  609. package/src/gpu/kernels/vision_position_embedding_f16.wgsl +35 -0
  610. package/src/gpu/kernels/vision_rope_2d.wgsl +60 -0
  611. package/src/gpu/kernels/vision_spatial_merge.wgsl +48 -0
  612. package/src/gpu/readback-buffer.js +20 -0
  613. package/src/gpu/submit-probe.js +2 -26
  614. package/src/gpu/weight-buffer.d.ts +1 -0
  615. package/src/gpu/weight-buffer.js +7 -0
  616. package/src/index.d.ts +23 -1
  617. package/src/index.js +8 -1
  618. package/src/inference/browser-harness/benchmark-execution.js +872 -0
  619. package/src/inference/browser-harness/benchmark-rerank.js +284 -0
  620. package/src/inference/browser-harness/decode-diagnostics.js +241 -0
  621. package/src/inference/browser-harness/diffusion-performance.js +102 -0
  622. package/src/inference/browser-harness/inference-execution.js +543 -0
  623. package/src/inference/{browser-harness-model-helpers.js → browser-harness/model-initialization.js} +18 -145
  624. package/src/inference/browser-harness/model-resolution.js +137 -0
  625. package/src/inference/browser-harness/report.js +338 -0
  626. package/src/inference/browser-harness/request.js +263 -0
  627. package/src/inference/browser-harness/runtime-config.d.ts +25 -0
  628. package/src/inference/browser-harness/runtime-config.js +255 -0
  629. package/src/inference/browser-harness/runtime-isolation.d.ts +13 -0
  630. package/src/inference/browser-harness/runtime-isolation.js +45 -0
  631. package/src/inference/browser-harness/runtime-report.d.ts +26 -0
  632. package/src/inference/browser-harness/runtime-report.js +117 -0
  633. package/src/inference/browser-harness/suite-summary.js +39 -0
  634. package/src/inference/browser-harness/text-evidence.js +694 -0
  635. package/src/inference/browser-harness/text-execution.js +757 -0
  636. package/src/inference/browser-harness/text-input.js +725 -0
  637. package/src/inference/{browser-harness-suite-helpers.js → browser-harness/timing-diagnostics.js} +1 -379
  638. package/src/inference/browser-harness-contract-helpers.js +1 -1
  639. package/src/inference/browser-harness-diffusion-energy-suites.js +8 -3
  640. package/src/inference/browser-harness-runtime-helpers.d.ts +3 -56
  641. package/src/inference/browser-harness-runtime-helpers.js +3 -408
  642. package/src/inference/browser-harness-text-helpers.js +31 -2196
  643. package/src/inference/browser-harness.d.ts +19 -2
  644. package/src/inference/browser-harness.js +46 -1873
  645. package/src/inference/kv-cache/base.js +67 -381
  646. package/src/inference/kv-cache/basis-decomposed-paged.d.ts +2 -50
  647. package/src/inference/kv-cache/basis-decomposed-paged.js +1 -276
  648. package/src/inference/kv-cache/quantized.d.ts +2 -2
  649. package/src/inference/kv-cache/quantized.js +4 -8
  650. package/src/inference/kv-cache/update.js +309 -0
  651. package/src/inference/model-checkpoint-evidence.d.ts +75 -0
  652. package/src/inference/model-checkpoint-evidence.js +264 -0
  653. package/src/inference/moe-router.js +36 -216
  654. package/src/inference/multi-model-network.js +5 -341
  655. package/src/inference/observation-context.d.ts +22 -0
  656. package/src/inference/observation-context.js +41 -0
  657. package/src/inference/pipelines/audio/index.js +1 -20
  658. package/src/inference/pipelines/audio/mel.js +0 -38
  659. package/src/inference/pipelines/diffusion/profile-timing.js +10 -0
  660. package/src/inference/pipelines/diffusion/runtime-resources.js +54 -0
  661. package/src/inference/pipelines/diffusion/sd3/execution.js +805 -0
  662. package/src/inference/pipelines/diffusion/sd3/plan.js +125 -0
  663. package/src/inference/pipelines/diffusion/sd3-transformer.js +44 -895
  664. package/src/inference/pipelines/diffusion/{vae.js → vae/execution.js} +46 -618
  665. package/src/inference/pipelines/diffusion/{helpers.js → weight-contract.js} +1 -68
  666. package/src/inference/pipelines/energy-head/row-head-pipeline.d.ts +1 -103
  667. package/src/inference/pipelines/factory.js +14 -3
  668. package/src/inference/pipelines/shader-scoped-pipeline.js +29 -0
  669. package/src/inference/pipelines/structured/json-grammar-mask.js +0 -6
  670. package/src/inference/pipelines/text/abort-contract.js +22 -0
  671. package/src/inference/pipelines/text/attention/attn-config.js +1 -16
  672. package/src/inference/pipelines/text/attention/executor-immediate.js +42 -0
  673. package/src/inference/pipelines/text/attention/executor-recorded.js +29 -0
  674. package/src/inference/pipelines/text/attention/gate-projection.js +30 -0
  675. package/src/inference/pipelines/text/attention/heterogeneous-contract.js +8 -0
  676. package/src/inference/pipelines/text/attention/index.js +7 -0
  677. package/src/inference/pipelines/text/attention/interpreter/immediate.js +211 -0
  678. package/src/inference/pipelines/text/attention/interpreter/recorded.js +451 -0
  679. package/src/inference/pipelines/text/attention/interpreter.js +984 -0
  680. package/src/inference/pipelines/text/attention/plan.d.ts +37 -0
  681. package/src/inference/pipelines/text/attention/plan.js +345 -0
  682. package/src/inference/pipelines/text/attention/projection-executor.js +331 -0
  683. package/src/inference/pipelines/text/attention/projection-plan.js +259 -0
  684. package/src/inference/pipelines/text/attention/projections.js +20 -537
  685. package/src/inference/pipelines/text/attention/query-transform.js +11 -0
  686. package/src/inference/pipelines/text/attention/receipt.js +60 -0
  687. package/src/inference/pipelines/text/attention/record.js +1 -1277
  688. package/src/inference/pipelines/text/attention/recorded-health.js +21 -0
  689. package/src/inference/pipelines/text/attention/rope-observation.js +40 -0
  690. package/src/inference/pipelines/text/attention/run.js +1 -1385
  691. package/src/inference/pipelines/text/attention/types.js +3 -31
  692. package/src/inference/pipelines/text/chat-format.d.ts +3 -0
  693. package/src/inference/pipelines/text/chat-format.js +42 -0
  694. package/src/inference/pipelines/text/config/normalization.js +729 -0
  695. package/src/inference/pipelines/text/config/validation.js +9 -0
  696. package/src/inference/pipelines/text/config.d.ts +12 -1
  697. package/src/inference/pipelines/text/config.js +14 -1228
  698. package/src/inference/pipelines/text/debug-utils/health-metrics.js +57 -0
  699. package/src/inference/pipelines/text/debug-utils/index.js +3 -8
  700. package/src/inference/pipelines/text/debug-utils/profiles.js +8 -0
  701. package/src/inference/pipelines/text/debug-utils/readback-decoding.js +24 -0
  702. package/src/inference/pipelines/text/debug-utils/tensor.js +1 -1
  703. package/src/inference/pipelines/text/dtype-contract.js +1 -68
  704. package/src/inference/pipelines/text/embed.js +178 -241
  705. package/src/inference/pipelines/text/embedding-contract.d.ts +7 -0
  706. package/src/inference/pipelines/text/embedding-contract.js +21 -0
  707. package/src/inference/pipelines/text/embedding-extraction.js +225 -0
  708. package/src/inference/pipelines/text/embedding-normalization.js +39 -0
  709. package/src/inference/pipelines/text/execution-runtime-builders.js +0 -32
  710. package/src/inference/pipelines/text/execution-v1/plan.js +69 -0
  711. package/src/inference/pipelines/text/execution-v1/validation.js +233 -0
  712. package/src/inference/pipelines/text/execution-v1.js +7 -283
  713. package/src/inference/pipelines/text/execution.js +517 -0
  714. package/src/inference/pipelines/text/ffn/dense-executor.js +718 -0
  715. package/src/inference/pipelines/text/ffn/dense-plan.js +327 -0
  716. package/src/inference/pipelines/text/ffn/dense.js +4 -968
  717. package/src/inference/pipelines/text/ffn/sandwich.js +10 -9
  718. package/src/inference/pipelines/text/ffn/standard.js +2 -1
  719. package/src/inference/pipelines/text/generator/attention-lifecycle.js +24 -0
  720. package/src/inference/pipelines/text/generator/decode-runtime.js +991 -0
  721. package/src/inference/pipelines/text/generator/decode.js +952 -0
  722. package/src/inference/pipelines/text/generator/diffusion.js +607 -0
  723. package/src/inference/pipelines/text/generator/logits-config.js +63 -0
  724. package/src/inference/pipelines/text/generator/prefill-observation.js +29 -0
  725. package/src/inference/pipelines/text/generator/prefill-policy.js +56 -0
  726. package/src/inference/pipelines/text/generator/prefill-runtime.js +896 -0
  727. package/src/inference/pipelines/text/{generator-prefill-helpers.js → generator/prefix-embedding.js} +16 -121
  728. package/src/inference/pipelines/text/generator/prompt-input.js +47 -0
  729. package/src/inference/pipelines/text/generator/recovery.js +310 -0
  730. package/src/inference/pipelines/text/{generator-helpers.js → generator/session-context.js} +44 -110
  731. package/src/inference/pipelines/text/generator/text.js +448 -0
  732. package/src/inference/pipelines/text/generator/training.js +752 -0
  733. package/src/inference/pipelines/text/generator-decode-policy.js +5 -2
  734. package/src/inference/pipelines/text/generator-logits-observation.js +45 -0
  735. package/src/inference/pipelines/text/generator-runtime.js +5 -135
  736. package/src/inference/pipelines/text/generator-steps.js +37 -962
  737. package/src/inference/pipelines/text/generator.js +165 -3539
  738. package/src/inference/pipelines/text/image-transcription.js +304 -0
  739. package/src/inference/pipelines/text/init-qkv-fusion.js +18 -9
  740. package/src/inference/pipelines/text/init-rope.js +37 -189
  741. package/src/inference/pipelines/text/init.d.ts +11 -3
  742. package/src/inference/pipelines/text/init.js +6 -216
  743. package/src/inference/pipelines/text/layer-execution-contract.js +97 -0
  744. package/src/inference/pipelines/text/layer-input-execution.js +435 -0
  745. package/src/inference/pipelines/text/layer-plan-gpu.js +15 -6
  746. package/src/inference/pipelines/text/layer-plan.d.ts +21 -5
  747. package/src/inference/pipelines/text/layer-plan.js +45 -3
  748. package/src/inference/pipelines/text/layer.js +54 -522
  749. package/src/inference/pipelines/text/lifecycle.js +839 -0
  750. package/src/inference/pipelines/text/linear-attention/plan.js +554 -0
  751. package/src/inference/pipelines/text/linear-attention-ab-fusion.js +2 -2
  752. package/src/inference/pipelines/text/linear-attention.d.ts +2 -2
  753. package/src/inference/pipelines/text/linear-attention.js +7 -537
  754. package/src/inference/pipelines/text/logits/cpu-output.d.ts +1 -0
  755. package/src/inference/pipelines/text/logits/cpu-output.js +5 -0
  756. package/src/inference/pipelines/text/logits/cpu.d.ts +1 -87
  757. package/src/inference/pipelines/text/logits/cpu.js +8 -95
  758. package/src/inference/pipelines/text/logits/gpu-executor.js +368 -0
  759. package/src/inference/pipelines/text/logits/gpu.d.ts +27 -0
  760. package/src/inference/pipelines/text/logits/gpu.js +116 -579
  761. package/src/inference/pipelines/text/logits/index.d.ts +2 -1
  762. package/src/inference/pipelines/text/logits/index.js +62 -102
  763. package/src/inference/pipelines/text/logits/output-transform.js +47 -0
  764. package/src/inference/pipelines/text/logits/plan.js +184 -0
  765. package/src/inference/pipelines/text/logits/readback.d.ts +6 -0
  766. package/src/inference/pipelines/text/logits/readback.js +9 -0
  767. package/src/inference/pipelines/text/logits/scale-policy.js +20 -0
  768. package/src/inference/pipelines/text/logits/types.d.ts +1 -0
  769. package/src/inference/pipelines/text/lora-apply.js +12 -4
  770. package/src/inference/pipelines/text/lora-types.d.ts +12 -0
  771. package/src/inference/pipelines/text/modality-token-contract.js +115 -0
  772. package/src/inference/pipelines/text/model-load.d.ts +0 -1
  773. package/src/inference/pipelines/text/model-load.js +2 -31
  774. package/src/inference/pipelines/text/moe/expert-loading.js +9 -0
  775. package/src/inference/pipelines/text/moe/gpu-executor.js +513 -0
  776. package/src/inference/pipelines/text/moe/plan.js +47 -0
  777. package/src/inference/pipelines/text/moe-cpu.js +9 -135
  778. package/src/inference/pipelines/text/moe-gpu.js +21 -545
  779. package/src/inference/pipelines/text/normalization-contract.js +17 -0
  780. package/src/inference/pipelines/text/per-layer/materialize.js +736 -0
  781. package/src/inference/pipelines/text/per-layer/plan.js +362 -0
  782. package/src/inference/pipelines/text/per-layer-inputs.js +4 -1037
  783. package/src/inference/pipelines/text/pipeline-load-timing.js +77 -0
  784. package/src/inference/pipelines/text/probes.js +30 -0
  785. package/src/inference/pipelines/text/resolved-runtime-session.d.ts +56 -0
  786. package/src/inference/pipelines/text/resolved-runtime-session.js +175 -0
  787. package/src/inference/pipelines/text/state.d.ts +14 -0
  788. package/src/inference/pipelines/text/state.js +4 -0
  789. package/src/inference/pipelines/text/tsir-fixture-writer.js +88 -16
  790. package/src/inference/pipelines/text/types.d.ts +10 -0
  791. package/src/inference/pipelines/text/weight-loading-config.js +194 -0
  792. package/src/inference/pipelines/text.d.ts +2 -2
  793. package/src/inference/pipelines/text.js +48 -1620
  794. package/src/inference/pipelines/video/frame-sampler.js +0 -13
  795. package/src/inference/pipelines/video/index.js +0 -21
  796. package/src/inference/pipelines/vision/attention.js +59 -0
  797. package/src/inference/pipelines/vision/encoder.js +254 -369
  798. package/src/inference/pipelines/vision/gemma4.js +204 -318
  799. package/src/inference/pipelines/vision/glmocr-preprocess.js +273 -0
  800. package/src/inference/pipelines/vision/glmocr-rope.js +106 -0
  801. package/src/inference/pipelines/vision/glmocr.js +557 -0
  802. package/src/inference/pipelines/vision/image-preprocess.js +0 -27
  803. package/src/inference/pipelines/vision/index.js +8 -27
  804. package/src/inference/pipelines/vision/ops.js +11 -33
  805. package/src/inference/pipelines/vision/patch-embed.js +51 -145
  806. package/src/inference/pipelines/vision/spatial-merge.js +78 -0
  807. package/src/inference/pipelines/vision/weight-loading.js +79 -0
  808. package/src/inference/refactor-receipt.d.ts +49 -0
  809. package/src/inference/refactor-receipt.js +188 -0
  810. package/src/inference/rerank.js +182 -0
  811. package/src/inference/resource-scope.d.ts +33 -0
  812. package/src/inference/resource-scope.js +168 -0
  813. package/src/inference/test-harness.d.ts +3 -0
  814. package/src/inference/test-harness.js +1 -0
  815. package/src/inference/tokenizer.js +1 -1
  816. package/src/inference/tokenizers/behavior-flags.js +6 -3
  817. package/src/inference/tokenizers/bundled/decoders.js +133 -0
  818. package/src/inference/tokenizers/bundled/registry.js +216 -0
  819. package/src/inference/tokenizers/bundled.js +23 -353
  820. package/src/loader/doppler-loader.d.ts +4 -0
  821. package/src/loader/doppler-loader.js +119 -930
  822. package/src/loader/embedding-limit-preflight.js +11 -4
  823. package/src/loader/embedding-loader.js +1 -3
  824. package/src/loader/gpu-tensor-materialization.js +20 -0
  825. package/src/loader/layer-loader.js +15 -119
  826. package/src/loader/layer-tensor-aliases.js +99 -0
  827. package/src/loader/layer-weight-shape.js +29 -0
  828. package/src/loader/load-timing.js +64 -0
  829. package/src/loader/loader-types.d.ts +3 -0
  830. package/src/loader/model-executor.js +819 -0
  831. package/src/loader/model-load-validation.js +15 -0
  832. package/src/loader/quantization-constants.d.ts +11 -29
  833. package/src/loader/quantization-constants.js +1 -2
  834. package/src/loader/shard-resolver.js +0 -14
  835. package/src/loader/tensor-load-error.js +14 -0
  836. package/src/loader/tensor-shard-indices.js +8 -0
  837. package/src/loader/tensors/bf16-loader.js +125 -0
  838. package/src/loader/tensors/functional-descriptor-loader.js +3 -375
  839. package/src/loader/tensors/load-executor.js +577 -0
  840. package/src/loader/tensors/source-transform/executor.js +123 -0
  841. package/src/loader/tensors/source-transform/plan.js +107 -0
  842. package/src/loader/tensors/source-transform.js +15 -264
  843. package/src/loader/tensors/tensor-loader.d.ts +4 -4
  844. package/src/loader/tensors/tensor-loader.js +7 -653
  845. package/src/memory/buffer-pool.js +7 -29
  846. package/src/rules/capability-transform-resolver.js +80 -0
  847. package/src/rules/execution-contract.d.ts +73 -0
  848. package/src/rules/execution-contract.js +429 -0
  849. package/src/rules/execution-rules-contract-check.js +1 -1
  850. package/src/rules/generated/rule-bundle.json +4305 -0
  851. package/src/rules/inference/capability-transforms.rules.json +3 -3
  852. package/src/rules/layer-pattern-contract-check.js +1 -1
  853. package/src/rules/rule-registry.js +70 -57
  854. package/src/storage/artifact-storage-context.js +2 -2
  855. package/src/storage/backend-selection.js +43 -0
  856. package/src/storage/distribution-transport.js +5 -0
  857. package/src/storage/download/integrity.d.ts +33 -0
  858. package/src/storage/download/integrity.js +130 -0
  859. package/src/storage/download/resume-inspection.d.ts +22 -0
  860. package/src/storage/download/resume-inspection.js +134 -0
  861. package/src/storage/download/retry.js +57 -0
  862. package/src/storage/download/state.js +131 -0
  863. package/src/storage/download/transport.js +99 -0
  864. package/src/storage/downloader.js +74 -453
  865. package/src/storage/model-cache.d.ts +54 -0
  866. package/src/storage/model-cache.js +590 -0
  867. package/src/storage/shard-manager.d.ts +5 -0
  868. package/src/storage/shard-manager.js +50 -369
  869. package/src/storage/shards/index.js +60 -0
  870. package/src/storage/shards/integrity.js +225 -0
  871. package/src/storage/shards/lifecycle.js +22 -0
  872. package/src/storage/source-artifact-store.js +14 -4
  873. package/src/tooling/boundary-evidence.d.ts +51 -0
  874. package/src/tooling/boundary-evidence.js +408 -0
  875. package/src/tooling/browser-command-runner.js +17 -10
  876. package/src/tooling/capsule-v2.d.ts +11 -0
  877. package/src/tooling/capsule-v2.js +58 -0
  878. package/src/tooling/capsule.js +20 -0
  879. package/src/tooling/command-api-constants.js +1 -1
  880. package/src/tooling/command-api-family-normalizers.js +163 -5
  881. package/src/tooling/command-api.d.ts +42 -3
  882. package/src/tooling/command-api.js +7 -2
  883. package/src/tooling/command-context.d.ts +25 -0
  884. package/src/tooling/command-context.js +53 -0
  885. package/src/tooling/command-envelope.js +1 -1
  886. package/src/tooling/{command-api-helpers.js → command-request-normalization.js} +1 -1
  887. package/src/tooling/command-runner.html +49 -1
  888. package/src/tooling/{command-runner-shared.js → command-runtime-execution.js} +22 -5
  889. package/src/tooling/command-validation.js +1 -24
  890. package/src/tooling/conversion-run-timing.js +24 -0
  891. package/src/tooling/demo-receipts.d.ts +56 -0
  892. package/src/tooling/demo-receipts.js +113 -0
  893. package/src/tooling/diagnose-runner.js +13 -11
  894. package/src/tooling/distribution-shard-transport.js +11 -0
  895. package/src/tooling/execution-cost-ledger.d.ts +95 -0
  896. package/src/tooling/execution-cost-ledger.js +381 -0
  897. package/src/tooling/hf-registry/catalog-io.js +63 -0
  898. package/src/tooling/litert/package.js +863 -0
  899. package/src/tooling/litert-package-runtime.js +3 -849
  900. package/src/tooling/model-capsule-forge.js +478 -0
  901. package/src/tooling/node-browser/execution.d.ts +40 -0
  902. package/src/tooling/node-browser/execution.js +308 -0
  903. package/src/tooling/node-browser/static-server.js +188 -0
  904. package/src/tooling/node-browser/transport.d.ts +80 -0
  905. package/src/tooling/node-browser/transport.js +622 -0
  906. package/src/tooling/node-browser-command-runner.d.ts +18 -78
  907. package/src/tooling/node-browser-command-runner.js +10 -1112
  908. package/src/tooling/node-capsule-artifact-store.js +44 -0
  909. package/src/tooling/node-command-execution.js +237 -0
  910. package/src/tooling/node-command-runner.js +26 -205
  911. package/src/tooling/node-converter/input.js +521 -0
  912. package/src/tooling/node-converter/output.js +244 -0
  913. package/src/tooling/node-converter-chunk-batches.js +21 -0
  914. package/src/tooling/node-converter.js +7 -720
  915. package/src/tooling/node-source-runtime.js +16 -276
  916. package/src/tooling/node-webgpu-provider.v1.json +33 -0
  917. package/src/tooling/node-webgpu.js +178 -453
  918. package/src/tooling/opfs-cache.d.ts +15 -48
  919. package/src/tooling/opfs-cache.js +8 -510
  920. package/src/tooling/precision-replay-math.d.ts +42 -0
  921. package/src/tooling/precision-replay-math.js +174 -0
  922. package/src/tooling/production-release.d.ts +19 -0
  923. package/src/tooling/production-release.js +647 -0
  924. package/src/tooling/program-bundle/embedding-reference.js +19 -0
  925. package/src/tooling/program-bundle/materialize.js +324 -0
  926. package/src/tooling/program-bundle/rerank-reference.js +22 -0
  927. package/src/tooling/program-bundle/sequence-reference.js +42 -0
  928. package/src/tooling/program-bundle/validation.js +31 -0
  929. package/src/tooling/program-bundle/wgsl-closure.js +254 -0
  930. package/src/tooling/program-bundle-parity.d.ts +14 -4
  931. package/src/tooling/program-bundle-parity.js +267 -106
  932. package/src/tooling/program-bundle.d.ts +8 -52
  933. package/src/tooling/program-bundle.js +186 -730
  934. package/src/tooling/provider-v1-contract.d.ts +61 -0
  935. package/src/tooling/provider-v1-contract.js +192 -0
  936. package/src/tooling/registered-variant-calibration-job.d.ts +98 -0
  937. package/src/tooling/registered-variant-calibration-job.js +210 -0
  938. package/src/tooling/registered-variant-calibration.d.ts +184 -0
  939. package/src/tooling/registered-variant-calibration.js +336 -0
  940. package/src/tooling/runtime-input-composition.js +105 -53
  941. package/src/tooling/runtime-intent.js +41 -0
  942. package/src/tooling/runtime-optimization/candidates.js +664 -0
  943. package/src/tooling/runtime-optimization-campaign.js +166 -0
  944. package/src/tooling/runtime-optimization-index.d.ts +6 -0
  945. package/src/tooling/runtime-optimization-index.js +87 -0
  946. package/src/tooling/runtime-optimization.d.ts +91 -6
  947. package/src/tooling/runtime-optimization.js +290 -414
  948. package/src/tooling/source-intake.d.ts +49 -0
  949. package/src/tooling/source-intake.js +431 -0
  950. package/src/tooling/source-package-profiles.js +1 -1
  951. package/src/tooling/source-runtime/bundle-materialize.js +298 -0
  952. package/src/tooling/source-runtime/bundle-plan.js +121 -0
  953. package/src/tooling/source-runtime/node-loader.js +258 -0
  954. package/src/tooling/source-runtime-bundle.js +26 -411
  955. package/src/tooling/source-runtime-converter-config.js +1 -1
  956. package/src/tooling-experimental-exports.js +0 -5
  957. package/src/tooling-exports/evidence.d.ts +45 -0
  958. package/src/tooling-exports/evidence.js +45 -0
  959. package/src/tooling-exports/runtime.d.ts +7 -0
  960. package/src/tooling-exports/runtime.js +7 -0
  961. package/src/tooling-exports/storage.d.ts +5 -0
  962. package/src/tooling-exports/storage.js +4 -0
  963. package/src/tooling-exports.d.ts +14 -0
  964. package/src/tooling-exports.js +8 -3
  965. package/src/tooling-exports.shared.d.ts +46 -0
  966. package/src/tooling-exports.shared.js +37 -0
  967. package/src/training.d.ts +6 -6
  968. package/src/training.js +4 -4
  969. package/src/version.js +1 -1
  970. package/tests/kernels/browser/kernel-suite.js +512 -0
  971. package/tests/kernels/browser/test-page.js +169 -14
  972. package/tests/kernels/harness/tolerance.js +1 -0
  973. package/tests/kernels/reference/index.js +13 -1
  974. package/tests/kernels/reference/vision.js +160 -0
  975. package/src/client/runtime/model-session.js +0 -432
  976. package/src/config/schema/tuner.schema.d.ts +0 -39
  977. package/src/config/schema/tuner.schema.js +0 -13
  978. package/src/converter/quantizer.d.ts +0 -121
  979. package/src/gpu/kernel-tuner/benchmarks.js +0 -902
  980. package/src/gpu/kernel-tuner/cache.js +0 -145
  981. package/src/gpu/kernel-tuner/index.js +0 -38
  982. package/src/gpu/kernel-tuner/tuner.js +0 -247
  983. package/src/gpu/kernel-tuner.js +0 -12
  984. package/src/gpu/kernels/backward/utils.d.ts +0 -90
  985. package/src/gpu/kernels/kernel-tuning.d.ts +0 -42
  986. package/src/gpu/kernels/kernel-tuning.js +0 -158
  987. package/src/gpu/kernels/uniform-utils.d.ts +0 -66
  988. package/src/gpu/kernels/utils.d.ts +0 -149
  989. package/src/gpu/profiler.js +0 -382
  990. package/src/inference/pipelines/text/attention/output-gate-fusion.js +0 -37
  991. package/src/inference/pipelines/text/debug-utils/utils.js +0 -118
  992. package/src/inference/pipelines/text/logits/utils.d.ts +0 -58
  993. package/src/inference/pipelines/text/moe-cpu-gptoss.js +0 -115
  994. package/src/inference/pipelines/text/moe-helpers.js +0 -21
  995. package/src/rules/converter/execution.rules.json +0 -20
  996. package/src/rules/converter/tensor-roles.rules.json +0 -13
  997. package/src/rules/converter/tokenizer.rules.json +0 -12
  998. package/src/rules/inference/attention.rules.json +0 -69
  999. package/src/rules/inference/config.rules.json +0 -82
  1000. package/src/rules/inference/dtype.rules.json +0 -113
  1001. package/src/rules/inference/execution.rules.json +0 -195
  1002. package/src/rules/inference/ffn.rules.json +0 -123
  1003. package/src/rules/inference/layer-pattern.rules.json +0 -16
  1004. package/src/rules/inference/layer.rules.json +0 -7
  1005. package/src/rules/inference/moe.rules.json +0 -145
  1006. package/src/rules/kernels/attention.rules.json +0 -68
  1007. package/src/rules/kernels/conv2d.rules.json +0 -6
  1008. package/src/rules/kernels/depthwise-conv2d.rules.json +0 -6
  1009. package/src/rules/kernels/dequant.rules.json +0 -58
  1010. package/src/rules/kernels/energy.rules.json +0 -22
  1011. package/src/rules/kernels/fused-ffn.rules.json +0 -15
  1012. package/src/rules/kernels/fused-matmul-residual.rules.json +0 -6
  1013. package/src/rules/kernels/fused-matmul-rmsnorm.rules.json +0 -8
  1014. package/src/rules/kernels/gather.rules.json +0 -93
  1015. package/src/rules/kernels/gelu.rules.json +0 -11
  1016. package/src/rules/kernels/grouped-pointwise-conv2d.rules.json +0 -6
  1017. package/src/rules/kernels/groupnorm.rules.json +0 -10
  1018. package/src/rules/kernels/kv_quantize.rules.json +0 -9
  1019. package/src/rules/kernels/layernorm.rules.json +0 -6
  1020. package/src/rules/kernels/linear-attention.rules.json +0 -6
  1021. package/src/rules/kernels/lm-head-argmax.rules.json +0 -10
  1022. package/src/rules/kernels/matmul.rules.json +0 -95
  1023. package/src/rules/kernels/modulate.rules.json +0 -6
  1024. package/src/rules/kernels/moe.rules.gptoss.json +0 -105
  1025. package/src/rules/kernels/moe.rules.json +0 -14
  1026. package/src/rules/kernels/moe.rules.mixtral.json +0 -75
  1027. package/src/rules/kernels/pixel_shuffle.rules.json +0 -6
  1028. package/src/rules/kernels/relu.rules.json +0 -6
  1029. package/src/rules/kernels/rep-penalty.rules.json +0 -6
  1030. package/src/rules/kernels/repeat-channels.rules.json +0 -6
  1031. package/src/rules/kernels/residual.rules.json +0 -12
  1032. package/src/rules/kernels/rmsnorm-qk.rules.json +0 -6
  1033. package/src/rules/kernels/rmsnorm.rules.json +0 -46
  1034. package/src/rules/kernels/rope-qk.rules.json +0 -6
  1035. package/src/rules/kernels/rope.rules.json +0 -6
  1036. package/src/rules/kernels/sample.rules.json +0 -6
  1037. package/src/rules/kernels/scale.rules.json +0 -8
  1038. package/src/rules/kernels/silu.rules.json +0 -22
  1039. package/src/rules/kernels/softmax.rules.json +0 -25
  1040. package/src/rules/kernels/split-qg.rules.json +0 -6
  1041. package/src/rules/kernels/split-qkv.rules.json +0 -6
  1042. package/src/rules/kernels/upsample2d.rules.json +0 -6
  1043. package/src/rules/loader/tensor-loader.rules.json +0 -42
  1044. package/src/rules/loader/weights.rules.json +0 -42
  1045. package/src/rules/tooling/command-runtime.rules.json +0 -65
  1046. package/src/tooling/hf-registry-utils.js +0 -395
  1047. /package/src/converter/{tokenizer-utils.js → tokenizer-special-tokens.js} +0 -0
  1048. /package/src/{inference/pipelines/text/bdpa-steamroller.js → experimental/bdpa/steamroller.js} +0 -0
  1049. /package/src/{inference/pipelines → experimental}/diffusion/scheduler.js +0 -0
  1050. /package/src/{inference/pipelines → experimental}/energy/pipeline.d.ts +0 -0
  1051. /package/src/{inference/pipelines → experimental}/energy/quintel.d.ts +0 -0
  1052. /package/src/{inference/pipelines → experimental}/energy/quintel.js +0 -0
  1053. /package/src/{utils → formats}/array-buffer.js +0 -0
  1054. /package/src/{utils → formats}/canonical-hash.js +0 -0
  1055. /package/src/{utils → formats}/clone-json.js +0 -0
  1056. /package/src/{utils → formats}/encode-utf8.js +0 -0
  1057. /package/src/{utils → formats}/load-json.js +0 -0
  1058. /package/src/{utils → formats}/plain-object.js +0 -0
  1059. /package/src/{utils → formats}/sha256.js +0 -0
  1060. /package/src/{utils → formats}/stable-sort-object.js +0 -0
  1061. /package/src/{gpu/kernels → rules}/rule-matcher.js +0 -0
  1062. /package/src/{utils → storage}/hf-resolve-url.js +0 -0
  1063. /package/src/{utils → storage}/runtime-env.js +0 -0
@@ -5,7 +5,7 @@ import path from 'node:path';
5
5
  import { fileURLToPath, pathToFileURL } from 'node:url';
6
6
  import { runNodeCommand } from '../tooling/node-command-runner.js';
7
7
  import { runBrowserCommandInNode } from '../tooling/node-browser-command-runner.js';
8
- import { writeProgramBundle, writeReferenceReceipt } from '../tooling/program-bundle.js';
8
+ import { writeProgramBundle } from '../tooling/program-bundle.js';
9
9
  import {
10
10
  TOOLING_COMMANDS,
11
11
  normalizeToolingCommandRequest,
@@ -18,9 +18,10 @@ import {
18
18
  resolveStaticRootDir,
19
19
  resolveRdrrRoot,
20
20
  } from './cli-model-resolution.js';
21
- import { isPlainObject } from '../utils/plain-object.js';
21
+ import { isPlainObject } from '../formats/plain-object.js';
22
22
  import {
23
23
  toSummary,
24
+ isFailedVerificationResult,
24
25
  formatNumber,
25
26
  formatMs,
26
27
  saveBenchResult,
@@ -33,50 +34,33 @@ import {
33
34
  printMetricsSummary,
34
35
  } from './cli-output.js';
35
36
  import { formatRuntimeProfiles, listRuntimeProfiles } from './runtime-profiles.js';
37
+ import { persistBrowserRelayReport } from './browser-report-output.js';
38
+ import { isAbsoluteUrl, normalizeModelUrl, parseJsonObjectFlag, performIntake, readJsonObjectFile, readJsonObjectInput, runBoundaryCommand, runBundleCommand, runCommandOnSurface } from './commands/bundle.js';
39
+ import { DEFAULT_CLI_POLICY, createCliToolingErrorEnvelope, parseRuntimeConfigUrl, resolveConfigEnvelope, resolveSurfaceForCommand, runManifestSweep, runWithAutoSurface } from './output/manifest.js';
40
+ import {
41
+ parseCliArguments,
42
+ validateBoundaryFlags,
43
+ validateBundleFlags,
44
+ validateCommandFlags,
45
+ validateIntakeFlags,
46
+ validateOnboardFlags,
47
+ validateProfilesFlags,
48
+ validateProgramBundleFlags,
49
+ } from './argument-contract.js';
50
+ export { createCliToolingErrorEnvelope } from './output/manifest.js';
51
+ export { checkCapturePrecondition, finalizeCliCommandResponse, performIntake } from './commands/bundle.js';
36
52
 
37
53
  export { resolveBrowserModelUrl, resolveNodeModelUrl } from './cli-model-resolution.js';
38
54
 
39
- const NODE_WEBGPU_INCOMPLETE_MESSAGE = 'node command: WebGPU runtime is incomplete in Node';
40
55
  const CLI_POLICY_PATH = fileURLToPath(new URL('./config/doppler-cli-policy.json', import.meta.url));
41
- const DEFAULT_CLI_POLICY = {
42
- defaults: {
43
- surface: {
44
- default: 'auto',
45
- allowed: ['auto', 'node', 'browser'],
46
- },
47
- bench: {
48
- cacheMode: 'warm',
49
- },
50
- cacheMode: null,
51
- loadMode: null,
52
- benchmark: {
53
- saveDir: './benchmarks/vendors/results',
54
- },
55
- },
56
- surfaceFallback: {
57
- enabled: true,
58
- from: 'auto',
59
- to: 'browser',
60
- errorFragments: [NODE_WEBGPU_INCOMPLETE_MESSAGE],
61
- },
62
- };
63
-
64
- const COMMON_CLI_FLAGS = Object.freeze([
65
- 'config',
66
- 'surface',
67
- 'pretty',
68
- 'json',
69
- 'help',
70
- 'h',
71
- 'runtime-config',
72
- 'runtime-profile',
73
- ]);
74
56
 
75
57
  function usage() {
76
58
  return [
77
59
  'Usage:',
78
60
  ' doppler convert --config <path|url|json> [--surface auto|node]',
79
61
  ' doppler refresh-integrity --config <path|url|json> [--surface auto|node]',
62
+ ' doppler release --manifest <path> --out <dir> --capsule-trusted-signers <path> --fleet-trusted-signers <path> --signing-private-key <path> --signing-public-key <path> --signing-authority <id> [--fleet-receipts <path,path>] [--forge-config <path>]',
63
+ ' doppler release --action qualify --manifest <path> --target <id> --device-identity <path> --out <dir> --capsule-trusted-signers <path> --signing-private-key <path> --signing-public-key <path> --signing-authority <id>',
80
64
  ' doppler debug --config <path|url|json> [--runtime-profile <id>|--runtime-config <path|url|json>] [--surface auto|node|browser]',
81
65
  ' doppler bench --config <path|url|json> [--runtime-profile <id>|--runtime-config <path|url|json>] [--surface auto|node|browser]',
82
66
  ' doppler verify --config <path|url|json> [--runtime-profile <id>|--runtime-config <path|url|json>] [--surface auto|node|browser]',
@@ -86,8 +70,11 @@ function usage() {
86
70
  ' doppler distill --config <path|url|json> [--surface auto|node]',
87
71
  ' doppler program-bundle --config <path|json>',
88
72
  ' doppler program-bundle --manifest <path> --reference-report <path> --out <path> [--conversion-config <path>]',
89
- ' doppler reference-receipt --config <path|json>',
90
- ' doppler reference-receipt --manifest <path> --reference-transcript <path> --out <path>',
73
+ ' doppler onboard inspect --source <checkpoint-dir> --out <dir> [--family-intake <source-intake.json>]',
74
+ ' doppler boundary capture --report <diagnose-report.json> --out <runtime-boundaries.json>',
75
+ ' doppler boundary source-capsule --provider-capture <provider-capture.json> --out <source-boundaries.json>',
76
+ ' doppler boundary token-evidence --reference-transcript <reference-transcript.json> --out <token-evidence.json>',
77
+ ' doppler boundary compare --source-capsule <source-boundaries.json> --runtime-capture <runtime-boundaries.json> --token-evidence <json> --out <receipt.json>',
91
78
  ' doppler intake --convert-config <path|json> [--manifest <path>] [--out <intake-report.json>]',
92
79
  ' doppler bundle --manifest <path> --out <dir> [--prompt <text>] [--max-tokens <n>] [--surface node|browser]',
93
80
  ' doppler bundle --convert-config <path|json> --out <dir>',
@@ -120,261 +107,6 @@ function usage() {
120
107
  ].join('\n');
121
108
  }
122
109
 
123
- function parseArgs(argv) {
124
- const out = {
125
- command: null,
126
- flags: {},
127
- };
128
-
129
- if (!argv.length) return out;
130
- out.command = asStringOrNull(argv[0]);
131
-
132
- for (let i = 1; i < argv.length; i += 1) {
133
- const token = argv[i];
134
- if (token === '-h') {
135
- out.flags.h = true;
136
- continue;
137
- }
138
- if (token.startsWith('-') && !token.startsWith('--')) {
139
- throw new Error(`Unsupported short flag "${token}". Use long-form flags (for example --help).`);
140
- }
141
- if (!token.startsWith('--')) {
142
- throw new Error('Positional arguments are not supported. Use --config for command payloads.');
143
- }
144
-
145
- const key = token.slice(2);
146
- if (
147
- key === 'json'
148
- || key === 'pretty'
149
- || key === 'help'
150
- || key === 'h'
151
- || key === 'skip-convert'
152
- || key === 'skip-capture'
153
- ) {
154
- out.flags[key] = true;
155
- continue;
156
- }
157
-
158
- const value = argv[i + 1];
159
- if (value === undefined) {
160
- throw new Error(`Missing value for --${key}`);
161
- }
162
-
163
- if (value.startsWith('--')) {
164
- throw new Error(`Missing value for --${key}`);
165
- }
166
-
167
- out.flags[key] = value;
168
- i += 1;
169
- }
170
-
171
- return out;
172
- }
173
-
174
- function levenshteinDistance(a, b) {
175
- const source = String(a ?? '');
176
- const target = String(b ?? '');
177
- if (source === target) return 0;
178
- if (source.length === 0) return target.length;
179
- if (target.length === 0) return source.length;
180
-
181
- const previous = new Array(target.length + 1);
182
- const current = new Array(target.length + 1);
183
-
184
- for (let i = 0; i <= target.length; i += 1) {
185
- previous[i] = i;
186
- }
187
-
188
- for (let i = 1; i <= source.length; i += 1) {
189
- current[0] = i;
190
- for (let j = 1; j <= target.length; j += 1) {
191
- const cost = source[i - 1] === target[j - 1] ? 0 : 1;
192
- current[j] = Math.min(
193
- previous[j] + 1,
194
- current[j - 1] + 1,
195
- previous[j - 1] + cost
196
- );
197
- }
198
- for (let j = 0; j <= target.length; j += 1) {
199
- previous[j] = current[j];
200
- }
201
- }
202
-
203
- return previous[target.length];
204
- }
205
-
206
- function findClosestFlag(flag, allowedFlags) {
207
- const normalizedFlag = String(flag ?? '').trim();
208
- if (!normalizedFlag) return null;
209
-
210
- let candidate = null;
211
- let distance = Infinity;
212
- for (const allowedFlag of allowedFlags) {
213
- const nextDistance = levenshteinDistance(normalizedFlag, allowedFlag);
214
- if (nextDistance < distance) {
215
- candidate = allowedFlag;
216
- distance = nextDistance;
217
- }
218
- }
219
- return distance <= 3 ? candidate : null;
220
- }
221
-
222
- function validateCommandFlags(parsed) {
223
- const command = parsed?.command;
224
- if (!command || !TOOLING_COMMANDS.includes(command)) {
225
- return;
226
- }
227
-
228
- const allowedFlags = new Set(COMMON_CLI_FLAGS);
229
- const keys = Object.keys(parsed.flags || {});
230
- for (const key of keys) {
231
- if (allowedFlags.has(key)) {
232
- continue;
233
- }
234
-
235
- const suggestion = findClosestFlag(key, allowedFlags);
236
- if (suggestion) {
237
- throw new Error(`Unknown flag --${key} for "${command}". Did you mean --${suggestion}?`);
238
- }
239
- throw new Error(`Unknown flag --${key} for "${command}".`);
240
- }
241
- }
242
-
243
- function validateProgramBundleFlags(parsed) {
244
- const allowedFlags = new Set([
245
- 'config',
246
- 'manifest',
247
- 'model-dir',
248
- 'reference-report',
249
- 'conversion-config',
250
- 'runtime-config',
251
- 'out',
252
- 'bundle-id',
253
- 'created-at',
254
- 'pretty',
255
- 'json',
256
- 'help',
257
- 'h',
258
- ]);
259
- for (const key of Object.keys(parsed.flags || {})) {
260
- if (allowedFlags.has(key)) continue;
261
- throw new Error(`Unknown flag --${key} for "program-bundle".`);
262
- }
263
- }
264
-
265
- function validateIntakeFlags(parsed) {
266
- const allowedFlags = new Set([
267
- 'convert-config',
268
- 'manifest',
269
- 'model-dir',
270
- 'out',
271
- 'skip-convert',
272
- 'pretty',
273
- 'json',
274
- 'help',
275
- 'h',
276
- ]);
277
- for (const key of Object.keys(parsed.flags || {})) {
278
- if (allowedFlags.has(key)) continue;
279
- throw new Error(`Unknown flag --${key} for "intake".`);
280
- }
281
- }
282
-
283
- function validateBundleFlags(parsed) {
284
- const allowedFlags = new Set([
285
- 'convert-config',
286
- 'manifest',
287
- 'model-dir',
288
- 'model-url',
289
- 'conversion-config',
290
- 'prompt',
291
- 'max-tokens',
292
- 'surface',
293
- 'runtime-config',
294
- 'out',
295
- 'bundle-id',
296
- 'receipt-id',
297
- 'created-at',
298
- 'skip-convert',
299
- 'skip-capture',
300
- 'reference-report',
301
- 'reference-transcript',
302
- 'pretty',
303
- 'json',
304
- 'help',
305
- 'h',
306
- ]);
307
- for (const key of Object.keys(parsed.flags || {})) {
308
- if (allowedFlags.has(key)) continue;
309
- throw new Error(`Unknown flag --${key} for "bundle".`);
310
- }
311
- }
312
-
313
- function validateReferenceReceiptFlags(parsed) {
314
- const allowedFlags = new Set([
315
- 'config',
316
- 'manifest',
317
- 'model-dir',
318
- 'reference-transcript',
319
- 'out',
320
- 'receipt-id',
321
- 'created-at',
322
- 'pretty',
323
- 'json',
324
- 'help',
325
- 'h',
326
- ]);
327
- for (const key of Object.keys(parsed.flags || {})) {
328
- if (allowedFlags.has(key)) continue;
329
- throw new Error(`Unknown flag --${key} for "reference-receipt".`);
330
- }
331
- }
332
-
333
- function validateProfilesFlags(parsed) {
334
- const allowedFlags = new Set([
335
- 'pretty',
336
- 'json',
337
- 'help',
338
- 'h',
339
- ]);
340
- for (const key of Object.keys(parsed.flags || {})) {
341
- if (allowedFlags.has(key)) continue;
342
- throw new Error(`Unknown flag --${key} for "profiles".`);
343
- }
344
- }
345
-
346
- function parseJsonObjectFlag(value, label) {
347
- if (asStringOrNull(value) === null) return null;
348
- try {
349
- const parsed = JSON.parse(value);
350
- if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
351
- throw new Error('value must be a JSON object');
352
- }
353
- return parsed;
354
- } catch (error) {
355
- throw new Error(`Invalid ${label}: ${error.message}`);
356
- }
357
- }
358
-
359
- function parseRuntimeConfigUrl(value) {
360
- const normalized = asStringOrNull(value);
361
- if (normalized === null) return null;
362
- return isAbsoluteUrl(normalized)
363
- ? normalized
364
- : pathToFileURL(path.resolve(normalized)).href;
365
- }
366
-
367
- function isAbsoluteUrl(value) {
368
- const normalized = asStringOrNull(value);
369
- if (normalized === null) return false;
370
- try {
371
- const parsed = new URL(normalized);
372
- return typeof parsed.protocol === 'string' && parsed.protocol.length > 0;
373
- } catch {
374
- return false;
375
- }
376
- }
377
-
378
110
  function parseUnifiedRuntimeConfig(value) {
379
111
  const normalized = asStringOrNull(value);
380
112
  if (normalized === null) return null;
@@ -435,65 +167,6 @@ function resolveRuntimeConfigFlags(parsed) {
435
167
  return parseUnifiedRuntimeConfig(unifiedRaw);
436
168
  }
437
169
 
438
- async function readJsonObjectFile(filePath, label) {
439
- const resolved = path.resolve(String(filePath));
440
- let raw;
441
- try {
442
- raw = await fs.readFile(resolved, 'utf8');
443
- } catch (error) {
444
- throw new Error(`${label} not found or unreadable: ${resolved}`);
445
- }
446
- let parsed;
447
- try {
448
- parsed = JSON.parse(raw);
449
- } catch (error) {
450
- throw new Error(`${label} must contain valid JSON: ${error.message}`);
451
- }
452
- if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
453
- throw new Error(`${label} must be a JSON object.`);
454
- }
455
- return parsed;
456
- }
457
-
458
- async function readJsonObjectUrl(rawUrl, label) {
459
- let response;
460
- try {
461
- response = await fetch(rawUrl, {
462
- headers: {
463
- Connection: 'close',
464
- },
465
- redirect: 'follow',
466
- signal: AbortSignal.timeout(30000),
467
- });
468
- } catch (error) {
469
- throw new Error(`${label} URL request failed: ${error?.message || String(error)}`);
470
- }
471
- if (!response.ok) {
472
- throw new Error(`${label} URL request failed: HTTP ${response.status}`);
473
- }
474
- let raw;
475
- try {
476
- raw = await response.text();
477
- } catch (error) {
478
- throw new Error(`${label} URL request failed: ${error?.message || String(error)}`);
479
- }
480
- return parseJsonObjectFlag(raw, label);
481
- }
482
-
483
- async function readJsonObjectInput(inputValue, label) {
484
- const normalized = asStringOrNull(inputValue);
485
- if (normalized === null) {
486
- throw new Error(`${label} is required.`);
487
- }
488
- if (normalized.startsWith('{')) {
489
- return parseJsonObjectFlag(normalized, label);
490
- }
491
- if (isAbsoluteUrl(normalized)) {
492
- return readJsonObjectUrl(normalized, label);
493
- }
494
- return readJsonObjectFile(normalized, label);
495
- }
496
-
497
170
  async function buildProgramBundleOptions(parsed) {
498
171
  const repoRoot = path.resolve(fileURLToPath(new URL('../..', import.meta.url)));
499
172
  const configValue = asStringOrNull(parsed.flags.config);
@@ -535,140 +208,6 @@ async function runProgramBundleCommand(parsed, jsonOutput) {
535
208
  );
536
209
  }
537
210
 
538
- const INTAKE_SCHEMA_ID = 'doppler.intake-report/v1';
539
-
540
- export async function performIntake({
541
- convertConfigValue = null,
542
- manifestFlag = null,
543
- modelDir = null,
544
- skipConvert = false,
545
- } = {}) {
546
- const { extractExecutionContractFacts, validateExecutionContractFacts } = await import(
547
- '../config/execution-contract-check.js'
548
- );
549
- const fsMod = await import('node:fs/promises');
550
-
551
- const stages = [];
552
- const blockers = [];
553
- let manifest = null;
554
-
555
- let manifestPath = null;
556
- if (manifestFlag) {
557
- manifestPath = path.resolve(manifestFlag);
558
- } else if (modelDir) {
559
- manifestPath = path.resolve(modelDir, 'manifest.json');
560
- }
561
-
562
- if (convertConfigValue && !skipConvert) {
563
- stages.push({ stage: 'convert', status: 'starting' });
564
- try {
565
- const convertConfig = await readJsonObjectInput(convertConfigValue, '--convert-config');
566
- const request = normalizeToolingCommandRequest({
567
- command: 'convert',
568
- convertPayload: convertConfig,
569
- });
570
- const response = await runCommandOnSurface(request, 'node', {}, true);
571
- stages[stages.length - 1] = {
572
- stage: 'convert',
573
- status: 'succeeded',
574
- convertReport: response?.result?.report ?? null,
575
- };
576
- if (!manifestPath) {
577
- const inferredModelBaseId =
578
- convertConfig?.output?.modelBaseId
579
- || convertConfig?.converterConfig?.output?.modelBaseId
580
- || null;
581
- const inferredBaseDir =
582
- convertConfig?.output?.baseDir
583
- || convertConfig?.converterConfig?.output?.baseDir
584
- || 'models/local';
585
- if (inferredModelBaseId) {
586
- manifestPath = path.resolve(inferredBaseDir, inferredModelBaseId, 'manifest.json');
587
- }
588
- }
589
- } catch (error) {
590
- stages[stages.length - 1] = {
591
- stage: 'convert',
592
- status: 'failed',
593
- error: error?.message || String(error),
594
- };
595
- blockers.push({
596
- stage: 'convert',
597
- code: error?.code || 'convert_failed',
598
- message: error?.message || String(error),
599
- });
600
- }
601
- } else {
602
- stages.push({ stage: 'convert', status: skipConvert ? 'skipped' : 'not_requested' });
603
- }
604
-
605
- if (blockers.length === 0 && manifestPath) {
606
- stages.push({ stage: 'manifest_load', status: 'starting' });
607
- try {
608
- const raw = await fsMod.readFile(manifestPath, 'utf8');
609
- manifest = JSON.parse(raw);
610
- stages[stages.length - 1] = {
611
- stage: 'manifest_load',
612
- status: 'succeeded',
613
- manifestPath,
614
- modelId: manifest?.modelId ?? null,
615
- };
616
-
617
- stages.push({ stage: 'execution_contract_check', status: 'starting' });
618
- try {
619
- const facts = extractExecutionContractFacts(manifest);
620
- const validation = validateExecutionContractFacts(facts);
621
- stages[stages.length - 1] = {
622
- stage: 'execution_contract_check',
623
- status: 'succeeded',
624
- stepCount: facts.steps.length,
625
- checks: Array.isArray(validation?.checks) ? validation.checks.length : null,
626
- };
627
- } catch (error) {
628
- stages[stages.length - 1] = {
629
- stage: 'execution_contract_check',
630
- status: 'failed',
631
- error: error?.message || String(error),
632
- };
633
- blockers.push({
634
- stage: 'execution_contract_check',
635
- code: 'unsupported_op_or_contract_violation',
636
- message: error?.message || String(error),
637
- });
638
- }
639
- } catch (error) {
640
- stages[stages.length - 1] = {
641
- stage: 'manifest_load',
642
- status: 'failed',
643
- error: error?.message || String(error),
644
- };
645
- blockers.push({
646
- stage: 'manifest_load',
647
- code: 'manifest_unreadable',
648
- message: error?.message || String(error),
649
- });
650
- }
651
- } else if (blockers.length === 0) {
652
- stages.push({ stage: 'manifest_load', status: 'skipped' });
653
- blockers.push({
654
- stage: 'manifest_load',
655
- code: 'no_manifest_path',
656
- message:
657
- 'intake: no manifest path resolved. Provide --manifest, --model-dir, or a convert-config with output.modelBaseId.',
658
- });
659
- }
660
-
661
- const report = {
662
- schema: INTAKE_SCHEMA_ID,
663
- ok: blockers.length === 0,
664
- blockers,
665
- stages,
666
- createdAtUtc: new Date().toISOString(),
667
- };
668
-
669
- return { report, manifestPath, manifest };
670
- }
671
-
672
211
  async function runIntakeCommand(parsed, jsonOutput) {
673
212
  const fsMod = await import('node:fs/promises');
674
213
  const { report } = await performIntake({
@@ -703,44 +242,49 @@ async function runIntakeCommand(parsed, jsonOutput) {
703
242
  }
704
243
  }
705
244
 
706
- async function buildReferenceReceiptOptions(parsed) {
707
- const repoRoot = path.resolve(fileURLToPath(new URL('../..', import.meta.url)));
708
- const configValue = asStringOrNull(parsed.flags.config);
709
- const config = configValue
710
- ? await readJsonObjectInput(configValue, '--config')
711
- : {};
712
- return {
713
- repoRoot,
714
- ...config,
715
- manifestPath: parsed.flags.manifest ?? config.manifestPath ?? null,
716
- modelDir: parsed.flags['model-dir'] ?? config.modelDir ?? null,
717
- referenceTranscriptPath:
718
- parsed.flags['reference-transcript'] ?? config.referenceTranscriptPath ?? null,
719
- outputPath: parsed.flags.out ?? config.outputPath ?? config.out ?? null,
720
- receiptId: parsed.flags['receipt-id'] ?? config.receiptId ?? null,
721
- createdAtUtc: parsed.flags['created-at'] ?? config.createdAtUtc ?? null,
245
+ async function runOnboardInspectCommand(parsed, jsonOutput) {
246
+ const { inspectSourceModel } = await import('../tooling/source-intake.js');
247
+ const policyPath = fileURLToPath(
248
+ new URL('../config/evidence/source-intake-policy.json', import.meta.url)
249
+ );
250
+ const policy = await readJsonObjectFile(policyPath, 'source intake policy');
251
+ const familyIntakePath = asStringOrNull(parsed.flags['family-intake']);
252
+ const familyIntake = familyIntakePath
253
+ ? await readJsonObjectFile(path.resolve(familyIntakePath), '--family-intake')
254
+ : null;
255
+ const result = await inspectSourceModel({
256
+ sourceDir: path.resolve(parsed.flags.source),
257
+ policy,
258
+ familyIntake,
259
+ });
260
+ const outputDir = path.resolve(parsed.flags.out);
261
+ await fs.mkdir(outputDir, { recursive: true });
262
+ const outputs = {
263
+ intake: path.join(outputDir, 'source-intake.json'),
264
+ conversion: path.join(outputDir, 'conversion-config.skeleton.json'),
265
+ contractTests: path.join(outputDir, 'contract-tests.plan.json'),
722
266
  };
723
- }
724
-
725
- async function runReferenceReceiptCommand(parsed, jsonOutput) {
726
- const result = await writeReferenceReceipt(await buildReferenceReceiptOptions(parsed));
267
+ await Promise.all([
268
+ fs.writeFile(outputs.intake, `${JSON.stringify(result.report, null, 2)}\n`, 'utf8'),
269
+ fs.writeFile(outputs.conversion, `${JSON.stringify(result.artifacts.conversion, null, 2)}\n`, 'utf8'),
270
+ fs.writeFile(outputs.contractTests, `${JSON.stringify(result.artifacts.contractTests, null, 2)}\n`, 'utf8'),
271
+ ]);
727
272
  const summary = {
728
- ok: true,
729
- outputPath: path.relative(process.cwd(), result.outputPath),
730
- modelId: result.receipt.modelId,
731
- receiptId: result.receipt.receiptId,
732
- executionGraphHash: result.receipt.sources.executionGraph.hash,
733
- tokensGenerated: result.receipt.referenceTranscript?.output?.tokensGenerated ?? null,
734
- stopReason: result.receipt.referenceTranscript?.output?.stopReason ?? null,
273
+ ...result.report,
274
+ outputPaths: Object.fromEntries(
275
+ Object.entries(outputs).map(([key, value]) => [key, path.relative(process.cwd(), value)])
276
+ ),
735
277
  };
736
278
  if (jsonOutput) {
737
279
  console.log(JSON.stringify(summary, null, 2));
738
- return;
280
+ } else {
281
+ const status = result.report.ok ? 'ok' : 'review';
282
+ console.log(
283
+ `[${status}] source intake wrote ${path.relative(process.cwd(), outputDir)} ` +
284
+ `(${result.report.summary.accepted} accepted, ${result.report.summary.unresolved} unresolved)`
285
+ );
739
286
  }
740
- console.log(
741
- `[ok] wrote ${summary.outputPath} ` +
742
- `(modelId=${summary.modelId}, tokens=${summary.tokensGenerated}, stopReason=${summary.stopReason})`
743
- );
287
+ if (!result.report.ok) process.exitCode = 1;
744
288
  }
745
289
 
746
290
  async function runProfilesCommand(jsonOutput) {
@@ -752,373 +296,6 @@ async function runProfilesCommand(jsonOutput) {
752
296
  console.log(formatRuntimeProfiles(result));
753
297
  }
754
298
 
755
- const BUNDLE_SUMMARY_SCHEMA_ID = 'doppler.bundle-summary/v1';
756
- const DEFAULT_BUNDLE_PROMPT = 'The color of the sky is';
757
- const DEFAULT_BUNDLE_MAX_TOKENS = 8;
758
-
759
- export async function checkCapturePrecondition(surface) {
760
- const skipCaptureHint = 'Alternatively, use --skip-capture with pre-existing --reference-report and --reference-transcript paths.';
761
- if (surface === 'node') {
762
- const { bootstrapNodeWebGPU } = await import('../tooling/node-webgpu.js');
763
- const { hasNodeWebGPUSupport } = await import('../tooling/node-command-runner.js');
764
- const bootstrap = await bootstrapNodeWebGPU();
765
- if (bootstrap.ok && hasNodeWebGPUSupport()) {
766
- return { ok: true, surface, provider: bootstrap.provider ?? null };
767
- }
768
- return {
769
- ok: false,
770
- surface,
771
- code: 'capture_precondition_node_webgpu_unavailable',
772
- provider: bootstrap.provider ?? null,
773
- detail: bootstrap.detail ?? null,
774
- message:
775
- 'bundle: --surface node requires a working Node WebGPU binding. '
776
- + `Bootstrap attempt failed: ${bootstrap.detail ?? 'no provider produced a usable adapter'}`
777
- + '. Install a Node WebGPU binding (for example `npm install webgpu`) '
778
- + 'or set DOPPLER_NODE_WEBGPU_MODULE to a custom specifier; '
779
- + 'alternatively use --surface browser after `npx playwright install chromium`. '
780
- + skipCaptureHint,
781
- };
782
- }
783
- if (surface === 'browser') {
784
- let playwright = null;
785
- try {
786
- playwright = await import('playwright');
787
- } catch (error) {
788
- return {
789
- ok: false,
790
- surface,
791
- code: 'capture_precondition_playwright_missing',
792
- detail: error?.message ?? null,
793
- message:
794
- 'bundle: --surface browser requires the `playwright` package. '
795
- + 'Run `npm install --save-dev playwright` then `npx playwright install chromium`. '
796
- + 'Alternatively use --surface node after installing a Node WebGPU binding (e.g. `npm install webgpu`). '
797
- + skipCaptureHint,
798
- };
799
- }
800
- let executablePath = null;
801
- try {
802
- executablePath = playwright.chromium?.executablePath?.() ?? null;
803
- } catch (error) {
804
- return {
805
- ok: false,
806
- surface,
807
- code: 'capture_precondition_playwright_chromium_missing',
808
- detail: error?.message ?? null,
809
- message:
810
- 'bundle: Playwright is installed but Chromium binaries are missing. '
811
- + 'Run `npx playwright install chromium` to download them. '
812
- + skipCaptureHint,
813
- };
814
- }
815
- const fsSync = await import('node:fs');
816
- if (!executablePath || !fsSync.existsSync(executablePath)) {
817
- return {
818
- ok: false,
819
- surface,
820
- code: 'capture_precondition_playwright_chromium_missing',
821
- detail: executablePath ? `executable not found at ${executablePath}` : 'executablePath returned null',
822
- message:
823
- 'bundle: Playwright Chromium binaries are not installed. '
824
- + 'Run `npx playwright install chromium` to download them. '
825
- + skipCaptureHint,
826
- };
827
- }
828
- return { ok: true, surface, executablePath };
829
- }
830
- return {
831
- ok: false,
832
- surface,
833
- code: 'capture_precondition_unsupported_surface',
834
- detail: null,
835
- message: `bundle: --surface must be 'browser' or 'node', got '${surface}'.`,
836
- };
837
- }
838
-
839
- async function runBundleCommand(parsed, jsonOutput) {
840
- const {
841
- runReferenceCapture,
842
- extractReferenceReport,
843
- extractReferenceTranscriptSeed,
844
- writeReferenceReport,
845
- writeReferenceTranscript,
846
- normalizeModelUrl,
847
- } = await import('../tooling/reference-verify.js');
848
- const { writeProgramBundle, writeReferenceReceipt } = await import('../tooling/program-bundle.js');
849
- const fsMod = await import('node:fs/promises');
850
-
851
- const outDir = asStringOrNull(parsed.flags.out);
852
- if (!outDir) {
853
- throw new Error('bundle: --out <dir> is required.');
854
- }
855
- const skipCapture = parsed.flags['skip-capture'] === true
856
- || String(parsed.flags['skip-capture'] ?? '').toLowerCase() === 'true';
857
- const resolvedOut = path.resolve(outDir);
858
- await fsMod.mkdir(resolvedOut, { recursive: true });
859
-
860
- const repoRoot = path.resolve(fileURLToPath(new URL('../..', import.meta.url)));
861
- const stages = [];
862
- const blockers = [];
863
- const artifactPaths = {};
864
-
865
- stages.push({ stage: 'intake', status: 'starting' });
866
- const intakeResult = await performIntake({
867
- convertConfigValue: asStringOrNull(parsed.flags['convert-config']),
868
- manifestFlag: asStringOrNull(parsed.flags.manifest),
869
- modelDir: asStringOrNull(parsed.flags['model-dir']),
870
- skipConvert: parsed.flags['skip-convert'] === true
871
- || String(parsed.flags['skip-convert'] ?? '').toLowerCase() === 'true',
872
- });
873
- const intakeReportPath = path.join(resolvedOut, 'intake-report.json');
874
- await fsMod.writeFile(intakeReportPath, `${JSON.stringify(intakeResult.report, null, 2)}\n`, 'utf8');
875
- artifactPaths.intakeReport = path.relative(process.cwd(), intakeReportPath);
876
- if (!intakeResult.report.ok) {
877
- stages[stages.length - 1] = { stage: 'intake', status: 'failed', blockers: intakeResult.report.blockers };
878
- blockers.push(...intakeResult.report.blockers.map((b) => ({ ...b, stage: `intake:${b.stage}` })));
879
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
880
- }
881
- stages[stages.length - 1] = {
882
- stage: 'intake',
883
- status: 'succeeded',
884
- manifestPath: intakeResult.manifestPath,
885
- modelId: intakeResult.manifest?.modelId ?? null,
886
- };
887
-
888
- const manifestPath = intakeResult.manifestPath;
889
- const manifest = intakeResult.manifest;
890
- const modelDirResolved = asStringOrNull(parsed.flags['model-dir'])
891
- ? path.resolve(asStringOrNull(parsed.flags['model-dir']))
892
- : path.dirname(manifestPath);
893
- const modelId = manifest?.modelId ?? null;
894
- if (!modelId) {
895
- blockers.push({ stage: 'bundle', code: 'missing_model_id', message: 'manifest.modelId is required for bundle composition.' });
896
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
897
- }
898
-
899
- const referenceReportPath = path.join(resolvedOut, 'reference-report.json');
900
- const referenceTranscriptPath = path.join(resolvedOut, 'reference-transcript.json');
901
-
902
- if (!skipCapture) {
903
- const surface = asStringOrNull(parsed.flags.surface) ?? 'browser';
904
- stages.push({ stage: 'capture', status: 'starting', surface });
905
- const precondition = await checkCapturePrecondition(surface);
906
- if (!precondition.ok) {
907
- stages[stages.length - 1] = {
908
- stage: 'capture',
909
- status: 'blocked',
910
- surface,
911
- precondition: {
912
- code: precondition.code,
913
- detail: precondition.detail ?? null,
914
- provider: precondition.provider ?? null,
915
- },
916
- };
917
- blockers.push({
918
- stage: 'capture',
919
- code: precondition.code,
920
- message: precondition.message,
921
- surface,
922
- detail: precondition.detail ?? null,
923
- provider: precondition.provider ?? null,
924
- });
925
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
926
- }
927
- try {
928
- const modelUrl = normalizeModelUrl(asStringOrNull(parsed.flags['model-url']), modelDirResolved);
929
- const maxTokensRaw = asStringOrNull(parsed.flags['max-tokens']);
930
- const maxTokens = maxTokensRaw == null ? DEFAULT_BUNDLE_MAX_TOKENS : Number(maxTokensRaw);
931
- if (!Number.isFinite(maxTokens) || maxTokens <= 0) {
932
- throw new Error('--max-tokens must be a positive number.');
933
- }
934
- const response = await runReferenceCapture({
935
- manifest,
936
- modelId,
937
- modelUrl,
938
- surface,
939
- prompt: asStringOrNull(parsed.flags.prompt) ?? DEFAULT_BUNDLE_PROMPT,
940
- maxTokens,
941
- runtimeConfig: asStringOrNull(parsed.flags['runtime-config']),
942
- repoRoot,
943
- });
944
- const report = extractReferenceReport(response);
945
- await writeReferenceReport(report, referenceReportPath);
946
- artifactPaths.referenceReport = path.relative(process.cwd(), referenceReportPath);
947
- const transcript = extractReferenceTranscriptSeed(report);
948
- await writeReferenceTranscript(transcript, referenceTranscriptPath);
949
- artifactPaths.referenceTranscript = path.relative(process.cwd(), referenceTranscriptPath);
950
- stages[stages.length - 1] = {
951
- stage: 'capture',
952
- status: 'succeeded',
953
- surface,
954
- tokensGenerated: transcript.output?.tokensGenerated ?? null,
955
- stopReason: transcript.output?.stopReason ?? null,
956
- };
957
- } catch (error) {
958
- stages[stages.length - 1] = {
959
- stage: 'capture',
960
- status: 'failed',
961
- error: error?.message || String(error),
962
- };
963
- blockers.push({ stage: 'capture', code: 'capture_failed', message: error?.message || String(error) });
964
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
965
- }
966
- } else {
967
- stages.push({ stage: 'capture', status: 'skipped' });
968
- const preExistingReport = asStringOrNull(parsed.flags['reference-report']);
969
- const preExistingTranscript = asStringOrNull(parsed.flags['reference-transcript']);
970
- if (preExistingReport) artifactPaths.referenceReport = preExistingReport;
971
- if (preExistingTranscript) artifactPaths.referenceTranscript = preExistingTranscript;
972
- if (!preExistingReport || !preExistingTranscript) {
973
- blockers.push({
974
- stage: 'capture',
975
- code: 'skip_capture_requires_artifacts',
976
- message: 'bundle: --skip-capture requires existing --reference-report and --reference-transcript paths.',
977
- });
978
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
979
- }
980
- }
981
-
982
- stages.push({ stage: 'bundle', status: 'starting' });
983
- try {
984
- const bundleOutputPath = path.join(resolvedOut, 'program-bundle.json');
985
- const bundleResult = await writeProgramBundle({
986
- repoRoot,
987
- manifestPath,
988
- modelDir: modelDirResolved,
989
- referenceReportPath: artifactPaths.referenceReport
990
- ? path.resolve(artifactPaths.referenceReport)
991
- : referenceReportPath,
992
- conversionConfigPath: asStringOrNull(parsed.flags['conversion-config']),
993
- outputPath: bundleOutputPath,
994
- bundleId: asStringOrNull(parsed.flags['bundle-id']),
995
- createdAtUtc: asStringOrNull(parsed.flags['created-at']),
996
- });
997
- artifactPaths.programBundle = path.relative(process.cwd(), bundleResult.outputPath);
998
- stages[stages.length - 1] = {
999
- stage: 'bundle',
1000
- status: 'succeeded',
1001
- bundleId: bundleResult.bundle.bundleId,
1002
- executionGraphHash: bundleResult.bundle.sources.executionGraph.hash,
1003
- artifactCount: bundleResult.bundle.artifacts.length,
1004
- wgslModuleCount: bundleResult.bundle.wgslModules.length,
1005
- };
1006
- } catch (error) {
1007
- stages[stages.length - 1] = {
1008
- stage: 'bundle',
1009
- status: 'failed',
1010
- error: error?.message || String(error),
1011
- };
1012
- blockers.push({ stage: 'bundle', code: 'bundle_export_failed', message: error?.message || String(error) });
1013
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
1014
- }
1015
-
1016
- stages.push({ stage: 'receipt', status: 'starting' });
1017
- try {
1018
- const receiptOutputPath = path.join(resolvedOut, 'reference-receipt.json');
1019
- const receiptResult = await writeReferenceReceipt({
1020
- repoRoot,
1021
- manifestPath,
1022
- modelDir: modelDirResolved,
1023
- referenceTranscriptPath: artifactPaths.referenceTranscript
1024
- ? path.resolve(artifactPaths.referenceTranscript)
1025
- : referenceTranscriptPath,
1026
- outputPath: receiptOutputPath,
1027
- receiptId: asStringOrNull(parsed.flags['receipt-id']),
1028
- createdAtUtc: asStringOrNull(parsed.flags['created-at']),
1029
- });
1030
- artifactPaths.referenceReceipt = path.relative(process.cwd(), receiptResult.outputPath);
1031
- stages[stages.length - 1] = {
1032
- stage: 'receipt',
1033
- status: 'succeeded',
1034
- receiptId: receiptResult.receipt.receiptId,
1035
- executionGraphHash: receiptResult.receipt.sources.executionGraph.hash,
1036
- tokensGenerated: receiptResult.receipt.referenceTranscript?.output?.tokensGenerated ?? null,
1037
- stopReason: receiptResult.receipt.referenceTranscript?.output?.stopReason ?? null,
1038
- };
1039
- } catch (error) {
1040
- stages[stages.length - 1] = {
1041
- stage: 'receipt',
1042
- status: 'failed',
1043
- error: error?.message || String(error),
1044
- };
1045
- blockers.push({ stage: 'receipt', code: 'receipt_write_failed', message: error?.message || String(error) });
1046
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
1047
- }
1048
-
1049
- stages.push({ stage: 'parity', status: 'starting' });
1050
- try {
1051
- const { checkProgramBundleParity } = await import('../tooling/program-bundle-parity.js');
1052
- const parityOutputPath = path.join(resolvedOut, 'program-bundle-parity.json');
1053
- const bundlePath = artifactPaths.programBundle
1054
- ? path.resolve(artifactPaths.programBundle)
1055
- : path.join(resolvedOut, 'program-bundle.json');
1056
- const parityReport = await checkProgramBundleParity({
1057
- bundlePath,
1058
- mode: 'contract',
1059
- repoRoot,
1060
- });
1061
- await fs.writeFile(parityOutputPath, `${JSON.stringify(parityReport, null, 2)}\n`, 'utf8');
1062
- artifactPaths.programBundleParity = path.relative(process.cwd(), parityOutputPath);
1063
- stages[stages.length - 1] = {
1064
- stage: 'parity',
1065
- status: 'succeeded',
1066
- mode: parityReport.mode,
1067
- ok: parityReport.ok,
1068
- parityHash: parityReport.parityHash,
1069
- providers: parityReport.providers.map((result) => ({
1070
- provider: result.provider,
1071
- status: result.status,
1072
- ok: result.ok,
1073
- })),
1074
- };
1075
- } catch (error) {
1076
- stages[stages.length - 1] = {
1077
- stage: 'parity',
1078
- status: 'failed',
1079
- error: error?.message || String(error),
1080
- };
1081
- blockers.push({ stage: 'parity', code: 'parity_check_failed', message: error?.message || String(error) });
1082
- return emitBundleSummary({ ok: false, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
1083
- }
1084
-
1085
- return emitBundleSummary({ ok: true, stages, blockers, artifactPaths, jsonOutput, resolvedOut });
1086
- }
1087
-
1088
- async function emitBundleSummary({ ok, stages, blockers, artifactPaths, jsonOutput, resolvedOut }) {
1089
- const fsMod = await import('node:fs/promises');
1090
- const summary = {
1091
- schema: BUNDLE_SUMMARY_SCHEMA_ID,
1092
- ok,
1093
- stages,
1094
- blockers,
1095
- artifactPaths,
1096
- outputDir: path.relative(process.cwd(), resolvedOut),
1097
- createdAtUtc: new Date().toISOString(),
1098
- };
1099
- const summaryPath = path.join(resolvedOut, 'bundle-summary.json');
1100
- await fsMod.writeFile(summaryPath, `${JSON.stringify(summary, null, 2)}\n`, 'utf8');
1101
- summary.summaryPath = path.relative(process.cwd(), summaryPath);
1102
-
1103
- if (jsonOutput) {
1104
- console.log(JSON.stringify(summary, null, 2));
1105
- } else if (ok) {
1106
- console.log(`[ok] bundle composed under ${summary.outputDir} (${stages.length} stages)`);
1107
- for (const [key, value] of Object.entries(artifactPaths)) {
1108
- console.log(` - ${key}: ${value}`);
1109
- }
1110
- } else {
1111
- console.log(`[fail] bundle composition stopped with ${blockers.length} blocker(s):`);
1112
- for (const b of blockers) {
1113
- console.log(` - [${b.stage}] ${b.code}: ${b.message}`);
1114
- }
1115
- }
1116
- if (!ok) {
1117
- process.exitCode = 1;
1118
- }
1119
- return summary;
1120
- }
1121
-
1122
299
  function resolveCommandConfigFlag(parsed) {
1123
300
  const config = asStringOrNull(parsed.flags.config);
1124
301
  if (!config) {
@@ -1127,168 +304,6 @@ function resolveCommandConfigFlag(parsed) {
1127
304
  return config;
1128
305
  }
1129
306
 
1130
- function parseBooleanFlag(value, label) {
1131
- const normalizedInput = asStringOrNull(value);
1132
- if (normalizedInput === null) return null;
1133
- if (typeof value === 'boolean') return value;
1134
- if (typeof value === 'string') {
1135
- const normalized = normalizedInput.toLowerCase();
1136
- if (normalized === 'true') return true;
1137
- if (normalized === 'false') return false;
1138
- }
1139
- throw new Error(`${label} must be true or false`);
1140
- }
1141
-
1142
- function parseNumberFlag(value, label) {
1143
- const normalized = asStringOrNull(value);
1144
- if (normalized === null) return null;
1145
- const parsed = Number(normalized);
1146
- if (!Number.isFinite(parsed)) {
1147
- throw new Error(`${label} must be a number`);
1148
- }
1149
- return parsed;
1150
- }
1151
-
1152
- function parseBrowserArgs(value) {
1153
- if (value === undefined || value === null) return [];
1154
- return Array.isArray(value) ? value.map((item) => String(item)) : [String(value)];
1155
- }
1156
-
1157
- function parseSurface(value, command, policy = DEFAULT_CLI_POLICY) {
1158
- const normalizedInput = asStringOrNull(value);
1159
- const normalizedSurface = policy.defaults && policy.defaults.surface && policy.defaults.surface.default
1160
- ? policy.defaults.surface.default
1161
- : 'auto';
1162
- const allowedSurfaces = policy.defaults && Array.isArray(policy.defaults.surface?.allowed)
1163
- ? policy.defaults.surface.allowed
1164
- : ['auto', 'node', 'browser'];
1165
- const normalized = String(normalizedInput === null ? normalizedSurface : normalizedInput).trim().toLowerCase();
1166
- if (!allowedSurfaces.includes(normalized)) {
1167
- throw new Error('--surface must be one of auto, node, browser');
1168
- }
1169
- if ((command === 'convert' || command === 'refresh-integrity') && normalized === 'browser') {
1170
- throw new Error(`${command} is not supported on browser relay. Use --surface node or --surface auto.`);
1171
- }
1172
- if ((command === 'diagnose' || command === 'lora' || command === 'distill') && normalized === 'browser') {
1173
- throw new Error(`${command} is not supported on browser relay. Use --surface node or --surface auto.`);
1174
- }
1175
- return normalized;
1176
- }
1177
-
1178
- const CONFIG_ENVELOPE_KNOWN_KEYS = new Set([
1179
- 'request',
1180
- 'run',
1181
- 'runtimeProfile',
1182
- 'runtimeConfigUrl',
1183
- 'runtimeConfig',
1184
- ]);
1185
-
1186
- function buildRuntimeOverridesFromObject(source = {}, sourceLabel = '--config') {
1187
- const normalizedRuntimeProfile = asStringOrNull(source.runtimeProfile);
1188
- const normalizedRuntimeConfigUrl = asStringOrNull(source.runtimeConfigUrl) == null
1189
- ? null
1190
- : parseRuntimeConfigUrl(source.runtimeConfigUrl);
1191
-
1192
- const hasInlineRuntimeConfig = Object.prototype.hasOwnProperty.call(source, 'runtimeConfig');
1193
- let runtimeConfig = null;
1194
- if (hasInlineRuntimeConfig) {
1195
- if (!isPlainObject(source.runtimeConfig)) {
1196
- throw new Error(`${sourceLabel} runtimeConfig must be a JSON object when provided.`);
1197
- }
1198
- runtimeConfig = source.runtimeConfig;
1199
- }
1200
-
1201
- return {
1202
- runtimeProfile: normalizedRuntimeProfile,
1203
- runtimeConfigUrl: normalizedRuntimeConfigUrl,
1204
- runtimeConfig,
1205
- };
1206
- }
1207
-
1208
- function resolveConfigEnvelope(configPayload) {
1209
- if (!isPlainObject(configPayload)) {
1210
- throw new Error('--config must resolve to a JSON object.');
1211
- }
1212
- if (configPayload.request !== undefined && !isPlainObject(configPayload.request)) {
1213
- throw new Error('--config field "request" must be a JSON object when provided.');
1214
- }
1215
- if (configPayload.run !== undefined && !isPlainObject(configPayload.run)) {
1216
- throw new Error('--config field "run" must be a JSON object when provided.');
1217
- }
1218
- if (configPayload.request !== undefined) {
1219
- const topLevelUnknown = Object.keys(configPayload).filter(
1220
- (key) => !CONFIG_ENVELOPE_KNOWN_KEYS.has(key)
1221
- );
1222
- if (topLevelUnknown.length > 0) {
1223
- throw new Error(
1224
- `--config has unknown top-level keys for request envelope: ${topLevelUnknown.join(', ')}.`
1225
- );
1226
- }
1227
- }
1228
-
1229
- const hasRequestEnvelope = isPlainObject(configPayload.request);
1230
- const requestPayload = hasRequestEnvelope
1231
- ? { ...configPayload.request }
1232
- : { ...configPayload };
1233
- const topLevelRuntimeConfig = hasRequestEnvelope
1234
- ? buildRuntimeOverridesFromObject(configPayload, '--config')
1235
- : {
1236
- runtimeProfile: null,
1237
- runtimeConfigUrl: null,
1238
- runtimeConfig: null,
1239
- };
1240
- const requestRuntimeConfig = buildRuntimeOverridesFromObject(requestPayload, '--config.request');
1241
- if (hasRequestEnvelope) {
1242
- if (
1243
- topLevelRuntimeConfig.runtimeProfile != null
1244
- && requestRuntimeConfig.runtimeProfile != null
1245
- ) {
1246
- throw new Error(
1247
- 'Cannot set runtimeProfile in both --config payload top-level and --config.request.'
1248
- );
1249
- }
1250
- if (
1251
- topLevelRuntimeConfig.runtimeConfigUrl != null
1252
- && requestRuntimeConfig.runtimeConfigUrl != null
1253
- ) {
1254
- throw new Error(
1255
- 'Cannot set runtimeConfigUrl in both --config payload top-level and --config.request.'
1256
- );
1257
- }
1258
- if (
1259
- topLevelRuntimeConfig.runtimeConfig != null
1260
- && requestRuntimeConfig.runtimeConfig != null
1261
- ) {
1262
- throw new Error(
1263
- 'Cannot set runtimeConfig in both --config payload top-level and --config.request.'
1264
- );
1265
- }
1266
- }
1267
-
1268
- const requestInput = {
1269
- ...requestPayload,
1270
- runtimeProfile: (
1271
- topLevelRuntimeConfig.runtimeProfile !== null
1272
- ? topLevelRuntimeConfig.runtimeProfile
1273
- : requestRuntimeConfig.runtimeProfile
1274
- ),
1275
- runtimeConfigUrl: (
1276
- topLevelRuntimeConfig.runtimeConfigUrl !== null
1277
- ? topLevelRuntimeConfig.runtimeConfigUrl
1278
- : requestRuntimeConfig.runtimeConfigUrl
1279
- ),
1280
- runtimeConfig: (
1281
- topLevelRuntimeConfig.runtimeConfig !== null
1282
- ? topLevelRuntimeConfig.runtimeConfig
1283
- : requestRuntimeConfig.runtimeConfig
1284
- ),
1285
- };
1286
- return {
1287
- request: requestInput,
1288
- run: isPlainObject(configPayload.run) ? configPayload.run : {},
1289
- };
1290
- }
1291
-
1292
307
  function applyRuntimeFlagOverride(requestInput, runtimeOverride) {
1293
308
  if (!runtimeOverride) {
1294
309
  return;
@@ -1323,34 +338,37 @@ function resolveBenchRunOptions(runConfig, policy = DEFAULT_CLI_POLICY) {
1323
338
  };
1324
339
  }
1325
340
 
1326
- function normalizeModelUrl(value) {
1327
- if (typeof value !== 'string' || !value.trim()) {
1328
- return value;
1329
- }
1330
- const trimmed = value.trim();
1331
- if (/^[a-z][a-z0-9+.-]*:\/\//u.test(trimmed)) {
1332
- return trimmed;
1333
- }
1334
- if (trimmed.startsWith('/') || trimmed.startsWith('.')) {
1335
- return pathToFileURL(path.resolve(trimmed)).href.replace(/\/$/, '');
1336
- }
1337
- return trimmed;
1338
- }
1339
-
1340
- function resolveSurfaceForCommand(command, parsed, runConfig, policy = DEFAULT_CLI_POLICY) {
1341
- const fromCli = asStringOrNull(parsed.flags.surface);
1342
- const fromRun = asStringOrNull(runConfig?.surface);
1343
- return parseSurface(fromCli ?? fromRun ?? null, command, policy);
1344
- }
1345
-
1346
341
  export async function buildRequest(parsed, policy = DEFAULT_CLI_POLICY) {
1347
342
  const command = parsed.command;
1348
343
  if (!command || !TOOLING_COMMANDS.includes(command)) {
1349
344
  throw new Error(`Unsupported command "${command || ''}"`);
1350
345
  }
1351
346
 
1352
- const configValue = resolveCommandConfigFlag(parsed);
1353
- const configPayload = await readJsonObjectInput(configValue, '--config');
347
+ const configValue = asStringOrNull(parsed.flags.config);
348
+ const releaseFlags = command === 'release' && configValue === null
349
+ ? {
350
+ action: asStringOrNull(parsed.flags.action) ?? 'decide',
351
+ manifestPath: asStringOrNull(parsed.flags.manifest),
352
+ outputDirectory: asStringOrNull(parsed.flags.out),
353
+ repoRoot: asStringOrNull(parsed.flags['repo-root']),
354
+ forgeConfigPath: asStringOrNull(parsed.flags['forge-config']),
355
+ targetId: asStringOrNull(parsed.flags.target),
356
+ deviceIdentityPath: asStringOrNull(parsed.flags['device-identity']),
357
+ fleetReceiptPaths: (asStringOrNull(parsed.flags['fleet-receipts']) ?? '')
358
+ .split(',')
359
+ .map((entry) => entry.trim())
360
+ .filter(Boolean),
361
+ capsuleTrustedSignersPath: asStringOrNull(parsed.flags['capsule-trusted-signers']),
362
+ fleetTrustedSignersPath: asStringOrNull(parsed.flags['fleet-trusted-signers']),
363
+ signingPrivateKeyPath: asStringOrNull(parsed.flags['signing-private-key']),
364
+ signingPublicKeyPath: asStringOrNull(parsed.flags['signing-public-key']),
365
+ signingAuthority: asStringOrNull(parsed.flags['signing-authority']),
366
+ }
367
+ : null;
368
+ const configPayload = releaseFlags ?? await readJsonObjectInput(
369
+ resolveCommandConfigFlag(parsed),
370
+ '--config'
371
+ );
1354
372
  const envelope = resolveConfigEnvelope(configPayload);
1355
373
  const runtimeOverride = resolveRuntimeConfigFlags(parsed);
1356
374
 
@@ -1379,123 +397,6 @@ export async function buildRequest(parsed, policy = DEFAULT_CLI_POLICY) {
1379
397
  };
1380
398
  }
1381
399
 
1382
- function buildNodeRunOptions(jsonOutput) {
1383
- return {
1384
- onProgress(progress) {
1385
- if (jsonOutput) return;
1386
- if (!progress?.message) return;
1387
- if (Number.isFinite(progress.current) && Number.isFinite(progress.total)) {
1388
- console.error(`[progress] ${progress.current}/${progress.total} ${progress.message}`);
1389
- } else {
1390
- console.error(`[progress] ${progress.stage ?? 'run'} ${progress.message}`);
1391
- }
1392
- },
1393
- };
1394
- }
1395
-
1396
- function buildBrowserRunOptions(runConfig, jsonOutput, request = {}) {
1397
- const browser = isPlainObject(runConfig?.browser) ? runConfig.browser : {};
1398
-
1399
- const headed = parseBooleanFlag(browser.headed, 'run.browser.headed') === true;
1400
- const explicitHeadless = parseBooleanFlag(browser.headless, 'run.browser.headless');
1401
- if (headed && explicitHeadless !== null) {
1402
- throw new Error('run.browser.headed is mutually exclusive with run.browser.headless.');
1403
- }
1404
-
1405
- const options = {
1406
- channel: asStringOrNull(browser.channel),
1407
- executablePath: asStringOrNull(browser.executablePath),
1408
- runnerPath: asStringOrNull(browser.runnerPath),
1409
- staticRootDir: asStringOrNull(browser.staticRootDir),
1410
- rdrrRoot: asStringOrNull(browser.rdrrRoot),
1411
- baseUrl: asStringOrNull(browser.baseUrl),
1412
- browserArgs: parseBrowserArgs(browser.browserArgs),
1413
- headless: headed ? false : (explicitHeadless ?? true),
1414
- };
1415
- const rdrrRoot = resolveRdrrRoot(options);
1416
- options.staticMounts = [
1417
- {
1418
- urlPrefix: '/models/external',
1419
- rootDir: rdrrRoot,
1420
- },
1421
- ];
1422
-
1423
- const port = parseNumberFlag(browser.port, 'run.browser.port');
1424
- if (port !== null) {
1425
- options.port = port;
1426
- }
1427
-
1428
- const timeoutMs = parseNumberFlag(browser.timeoutMs, 'run.browser.timeoutMs');
1429
- if (timeoutMs !== null) {
1430
- options.timeoutMs = timeoutMs;
1431
- }
1432
-
1433
- const opfsCache = parseBooleanFlag(browser.opfsCache, 'run.browser.opfsCache');
1434
- if (opfsCache === false) {
1435
- options.opfsCache = false;
1436
- }
1437
-
1438
- const userDataDir = asStringOrNull(browser.userDataDir);
1439
- if (userDataDir) {
1440
- options.userDataDir = userDataDir;
1441
- }
1442
-
1443
- if (request.cacheMode === 'cold') {
1444
- options.wipeCacheBeforeLaunch = true;
1445
- }
1446
-
1447
- const streamConsole = parseBooleanFlag(browser.console, 'run.browser.console');
1448
- const shouldStreamConsole = streamConsole === true;
1449
- if (shouldStreamConsole && !jsonOutput) {
1450
- options.onConsole = ({ type, text }) => {
1451
- console.error(`[browser:${type}] ${text}`);
1452
- };
1453
- }
1454
-
1455
- return options;
1456
- }
1457
-
1458
- function isNodeWebGPUFallbackCandidate(error, fallbackPolicy = DEFAULT_CLI_POLICY.surfaceFallback) {
1459
- const message = error?.message || String(error || '');
1460
- const fallbackSignatures = Array.isArray(fallbackPolicy?.errorFragments) && fallbackPolicy.errorFragments.length > 0
1461
- ? fallbackPolicy.errorFragments
1462
- : [NODE_WEBGPU_INCOMPLETE_MESSAGE];
1463
- return fallbackSignatures.some((signature) => message.includes(signature));
1464
- }
1465
-
1466
- function isTrainingCommandFlow(request) {
1467
- if (!request || typeof request !== 'object') return false;
1468
- if (request.workload === 'training') return true;
1469
- if (request.command === 'lora' || request.command === 'distill') return true;
1470
- return request.command === 'bench' && (request.workload === 'training' || request.workloadType === 'training');
1471
- }
1472
-
1473
- function resolveErrorSurface(error, fallbackSurface = null) {
1474
- return (
1475
- asStringOrNull(fallbackSurface)
1476
- || asStringOrNull(error?.surface)
1477
- || asStringOrNull(error?.details?.surface)
1478
- || null
1479
- );
1480
- }
1481
-
1482
- export function createCliToolingErrorEnvelope(error, context = {}) {
1483
- return createToolingErrorEnvelope(error, {
1484
- surface: resolveErrorSurface(error, context.surface),
1485
- request: context.request ?? null,
1486
- });
1487
- }
1488
-
1489
- export function finalizeCliCommandResponse(response, request) {
1490
- if (!isPlainObject(response)) {
1491
- return response;
1492
- }
1493
- return {
1494
- ...response,
1495
- request,
1496
- };
1497
- }
1498
-
1499
400
  export async function withJsonStdoutIsolation(enabled, callback) {
1500
401
  if (!enabled) {
1501
402
  return callback();
@@ -1525,76 +426,6 @@ export async function withJsonStdoutIsolation(enabled, callback) {
1525
426
  }
1526
427
  }
1527
428
 
1528
- async function runCommandOnSurface(request, surface, runConfig, jsonOutput) {
1529
- if (surface === 'node') {
1530
- const nodeRequest = await resolveNodeModelUrl(request);
1531
- if (!jsonOutput) {
1532
- console.error('[surface] running on: node');
1533
- if (nodeRequest.modelUrl && nodeRequest.modelUrl !== request.modelUrl) {
1534
- console.error(`[surface] node resolved modelUrl=${nodeRequest.modelUrl}`);
1535
- }
1536
- }
1537
- const response = await runNodeCommand(nodeRequest, buildNodeRunOptions(jsonOutput));
1538
- return finalizeCliCommandResponse(response, request);
1539
- }
1540
-
1541
- const browserOptions = buildBrowserRunOptions(runConfig, jsonOutput, request);
1542
- const browserRequest = await resolveBrowserModelUrl(request, browserOptions);
1543
-
1544
- if (!jsonOutput) {
1545
- const mode = browserOptions.headless === false ? 'headed' : 'headless';
1546
- console.error(`[surface] running on: browser (${mode})`);
1547
- if (browserRequest.modelUrl && browserRequest.modelUrl !== request.modelUrl) {
1548
- console.error(`[surface] browser resolved modelUrl=${browserRequest.modelUrl}`);
1549
- }
1550
- }
1551
-
1552
- const response = await runBrowserCommandInNode(browserRequest, browserOptions);
1553
- return finalizeCliCommandResponse(response, request);
1554
- }
1555
-
1556
- async function runWithAutoSurface(request, runConfig, jsonOutput, policy = DEFAULT_CLI_POLICY) {
1557
- if (
1558
- request.command === 'convert'
1559
- || request.command === 'refresh-integrity'
1560
- || request.command === 'diagnose'
1561
- ) {
1562
- return runCommandOnSurface(request, 'node', runConfig, jsonOutput);
1563
- }
1564
- const fallbackPolicy = policy?.surfaceFallback || { enabled: false };
1565
-
1566
- try {
1567
- return await runCommandOnSurface(request, 'node', runConfig, jsonOutput);
1568
- } catch (error) {
1569
- if (!fallbackPolicy.enabled || !isNodeWebGPUFallbackCandidate(error, fallbackPolicy)) {
1570
- throw error;
1571
- }
1572
- if (isTrainingCommandFlow(request)) {
1573
- const downgradeError = new Error(
1574
- (request.command === 'lora' || request.command === 'distill')
1575
- ? 'Training command auto-surface downgrade is blocked. Re-run with --surface node after fixing Node WebGPU support.'
1576
- : 'Training command auto-surface downgrade is blocked. Re-run with --surface node after fixing Node WebGPU support, or explicitly choose --surface browser.'
1577
- );
1578
- downgradeError.code = 'training_surface_downgrade_blocked';
1579
- downgradeError.surface = 'node';
1580
- downgradeError.command = request.command;
1581
- downgradeError.workload = request.workload;
1582
- downgradeError.workloadType = request.workloadType || null;
1583
- downgradeError.fromSurface = 'node';
1584
- downgradeError.toSurface = fallbackPolicy.to || 'browser';
1585
- throw downgradeError;
1586
- }
1587
- if (fallbackPolicy.to !== 'browser') {
1588
- throw error;
1589
- }
1590
- if (!jsonOutput) {
1591
- console.error('[surface] node WebGPU unavailable, falling back to browser');
1592
- }
1593
- return runCommandOnSurface(request, 'browser', runConfig, jsonOutput);
1594
- }
1595
- }
1596
-
1597
-
1598
429
  async function loadManifest(manifestPath) {
1599
430
  const raw = await fs.readFile(path.resolve(manifestPath), 'utf-8');
1600
431
  const manifest = JSON.parse(raw);
@@ -1604,92 +435,6 @@ async function loadManifest(manifestPath) {
1604
435
  return manifest;
1605
436
  }
1606
437
 
1607
- function mergeRunConfig(base, ...overrides) {
1608
- const merged = isPlainObject(base) ? { ...base } : {};
1609
- for (const source of overrides) {
1610
- if (!isPlainObject(source)) {
1611
- continue;
1612
- }
1613
- for (const [key, value] of Object.entries(source)) {
1614
- if ((key === 'browser' || key === 'bench') && isPlainObject(value)) {
1615
- merged[key] = {
1616
- ...(isPlainObject(merged[key]) ? merged[key] : {}),
1617
- ...value,
1618
- };
1619
- continue;
1620
- }
1621
- merged[key] = value;
1622
- }
1623
- }
1624
- return merged;
1625
- }
1626
-
1627
- async function runManifestSweep(manifest, commandContext, jsonOutput, policy = DEFAULT_CLI_POLICY) {
1628
- const defaults = manifest.defaults || {};
1629
- const results = [];
1630
-
1631
- for (let i = 0; i < manifest.runs.length; i++) {
1632
- const run = manifest.runs[i];
1633
- const label = run.label || run.modelId || run.request?.modelId || `run-${i}`;
1634
- if (!jsonOutput) {
1635
- console.error(`[sweep] (${i + 1}/${manifest.runs.length}) ${label}`);
1636
- }
1637
-
1638
- const requestInput = {
1639
- ...commandContext.request,
1640
- ...(isPlainObject(defaults.request) ? defaults.request : {}),
1641
- ...(isPlainObject(run.request) ? run.request : {}),
1642
- command: commandContext.request.command,
1643
- };
1644
- const modelId = asStringOrNull(run.modelId) || asStringOrNull(defaults.modelId);
1645
- if (modelId) {
1646
- requestInput.modelId = modelId;
1647
- }
1648
- const modelUrl = asStringOrNull(run.modelUrl) || asStringOrNull(defaults.modelUrl);
1649
- if (modelUrl) {
1650
- requestInput.modelUrl = modelUrl;
1651
- }
1652
- const runtimeProfile = asStringOrNull(run.runtimeProfile)
1653
- || asStringOrNull(defaults.runtimeProfile);
1654
- if (runtimeProfile) {
1655
- requestInput.runtimeProfile = runtimeProfile;
1656
- }
1657
-
1658
- const mergedRunConfig = mergeRunConfig(commandContext.runConfig, defaults.run, run.run);
1659
- let request = null;
1660
- let surface = commandContext.surface;
1661
- try {
1662
- request = normalizeToolingCommandRequest(requestInput);
1663
- surface = commandContext.surfaceFromCli
1664
- ? commandContext.surface
1665
- : resolveSurfaceForCommand(
1666
- request.command,
1667
- { flags: { surface: null } },
1668
- mergedRunConfig,
1669
- policy
1670
- );
1671
- const response = surface === 'auto'
1672
- ? await runWithAutoSurface(request, mergedRunConfig, jsonOutput, policy)
1673
- : await runCommandOnSurface(request, surface, mergedRunConfig, jsonOutput);
1674
- results.push({ label, response, error: null });
1675
- } catch (error) {
1676
- results.push({
1677
- label,
1678
- response: null,
1679
- error: createCliToolingErrorEnvelope(error, {
1680
- surface: surface === 'auto' ? null : surface,
1681
- request,
1682
- }),
1683
- });
1684
- if (!jsonOutput) {
1685
- console.error(`[sweep] ${label} FAILED: ${error.message}`);
1686
- }
1687
- }
1688
- }
1689
-
1690
- return results;
1691
- }
1692
-
1693
438
  async function main() {
1694
439
  const argv = process.argv.slice(2);
1695
440
  const jsonOutputRequested = !argv.includes('--pretty');
@@ -1705,7 +450,7 @@ async function main() {
1705
450
  }
1706
451
 
1707
452
  const cliPolicy = await readJsonObjectFile(CLI_POLICY_PATH, '--cli-policy');
1708
- const parsed = parseArgs(argv);
453
+ const parsed = parseCliArguments(argv);
1709
454
  if (parsed.flags.help === true || parsed.flags.h === true) {
1710
455
  console.log(usage());
1711
456
  return;
@@ -1715,16 +460,21 @@ async function main() {
1715
460
  await runProgramBundleCommand(parsed, parsed.flags.pretty !== true);
1716
461
  return;
1717
462
  }
1718
- if (parsed.command === 'reference-receipt') {
1719
- validateReferenceReceiptFlags(parsed);
1720
- await runReferenceReceiptCommand(parsed, parsed.flags.pretty !== true);
1721
- return;
1722
- }
1723
463
  if (parsed.command === 'profiles') {
1724
464
  validateProfilesFlags(parsed);
1725
465
  await runProfilesCommand(parsed.flags.pretty !== true);
1726
466
  return;
1727
467
  }
468
+ if (parsed.command === 'onboard') {
469
+ validateOnboardFlags(parsed);
470
+ await runOnboardInspectCommand(parsed, parsed.flags.pretty !== true);
471
+ return;
472
+ }
473
+ if (parsed.command === 'boundary') {
474
+ validateBoundaryFlags(parsed);
475
+ await runBoundaryCommand(parsed, parsed.flags.pretty !== true);
476
+ return;
477
+ }
1728
478
  if (parsed.command === 'intake') {
1729
479
  validateIntakeFlags(parsed);
1730
480
  await runIntakeCommand(parsed, parsed.flags.pretty !== true);
@@ -1808,6 +558,8 @@ async function main() {
1808
558
 
1809
559
  return commandResponse;
1810
560
  });
561
+ const verificationFailed = isFailedVerificationResult(request, response?.result);
562
+ if (verificationFailed) process.exitCode = 1;
1811
563
 
1812
564
  if (jsonOutput) {
1813
565
  const output = response?.result?.report !== undefined
@@ -1817,7 +569,7 @@ async function main() {
1817
569
  return;
1818
570
  }
1819
571
 
1820
- console.log(`[ok] ${toSummary(response.result)}`);
572
+ console.log(`[${verificationFailed ? 'fail' : 'ok'}] ${toSummary(response.result)}`);
1821
573
  printConvertContractSummary(response.result);
1822
574
  printConvertReportSummary(response.result);
1823
575
  printMetricsSummary(response.result);