@pulse-compute/wasm-compiler 1.0.0-beta.4 → 1.0.0-beta.6

package/README.md

@@ -8,9 +8,9 @@
 > **Stability:** Internal compiler interface; no application-author compatibility guarantee.<br>
 > **npm:** [`@pulse-compute/wasm-compiler`](https://www.npmjs.com/package/@pulse-compute/wasm-compiler)<br>
 > **Canonical replacement:** `@pulse-compute/cli`<br>
-> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.4/packages/implementation-packages/)
+> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.6/packages/implementation-packages/)
 >
-> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.4` package policy.
+> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.6` package policy.
 <!-- pulse-package-status:end -->
 
 Whole-project compiler implementation used by the `pulse` workflow. Application projects should use `@pulse-compute/cli`, not import this package directly.
@@ -38,6 +38,17 @@ The compiler orchestrates contracts but does not own:
 
 Package-specific lowering belongs to the package owning the facade. Provider realization belongs to provider packages. Shared protocol vocabulary belongs to `@pulse-compute/wasm-contracts`.
 
+Provider packages are not production dependencies of this compiler. Direct
+compiler consumers supply the selected provider in their project context; the
+product CLI owns its bundled Node/Fastly dependencies. Provider-neutral imports,
+compilation and legacy executable help do not load providers. Legacy proof
+commands load only their selected provider when invoked. Repository proof
+scripts retain provider development dependencies.
+
+The canonical API, Native-plan and Native-compiler facades use declared package
+imports and surface missing or unexported dependencies without checkout-relative
+recovery. Other historical loaders are outside this migration.
+
 ## Internal compiler spine
 
 The compiler connects root extraction, surface recognition, normalization, classification, validation, canonical IR, native lowering, provider realization, and artifact verification through a fixed package-internal pipeline. The pipeline is not exported and is not a plugin framework. Compiler refactors must preserve checked-in metadata, diagnostics, native-plan, and generated-Wasm evidence unless an explicit contract migration authorizes a difference.
@@ -52,4 +63,4 @@ The package exports its root implementation plus focused compiler, CLI, extracto
 
 Compiler changes should be covered by focused static/lowering tests, canonical project inspection, provider-plan parity, packed-package discovery where relevant, and the release documentation gates.
 
-See the installed [implementation package guide](https://pulsecompute.io/v1.0.0-beta.4/packages/implementation-packages/) and [compilation concepts](https://pulsecompute.io/v1.0.0-beta.4/concepts/compilation-and-lowering/).
+See the installed [implementation package guide](https://pulsecompute.io/v1.0.0-beta.6/packages/implementation-packages/) and [compilation concepts](https://pulsecompute.io/v1.0.0-beta.6/concepts/compilation-and-lowering/).

package/bin/provider-proof-composition.js

@@ -1,34 +1,32 @@
 'use strict';
 
-const node = require('@pulse-compute/provider-node/compiler');
-const fastly = require('@pulse-compute/provider-fastly/compiler');
-const {
-  buildNodeLiveOriginRouteHandlerEffectProof
-} = require('@pulse-compute/provider-node/compiler/route-handler-live-origin-proof');
-const {
-  buildNodeCompiledRouteHandlerEffectBridge
-} = require('@pulse-compute/provider-node/compiler/route-handler-compiled-wasm-bridge');
-const {
-  buildNodeBackendJsonRequestBodyProof
-} = require('@pulse-compute/provider-node/compiler/backend-json-request-body-proof');
+const path = require('node:path');
+const { createRequire } = require('node:module');
 
-module.exports = Object.freeze({
-  buildNodeAdapter: node.buildNodeAdapter,
-  buildNodeAssetsProviderProof: node.buildNodeAssetsProviderProof,
-  buildNodeCompiledWasmAssetsLifecycleProof: node.buildNodeCompiledWasmAssetsLifecycleProof,
-  buildNodeRouteHandlerEffectProof: node.buildNodeRouteHandlerEffectProof,
-  buildNodeRequestJsonBodyProof: node.buildNodeRequestJsonBodyProof,
-  buildNodeSchemaDecodeResultProof: node.buildNodeSchemaDecodeResultProof,
-  buildNodeSchemaResponseCodecProof: node.buildNodeSchemaResponseCodecProof,
-  buildNodeLiveOriginRouteHandlerEffectProof,
-  buildNodeCompiledRouteHandlerEffectBridge,
-  buildNodeBackendJsonRequestBodyProof,
-  buildFastlyReadiness: fastly.buildFastlyReadiness,
-  buildFastlyHostcallBinding: fastly.buildFastlyHostcallBinding,
-  buildFastlyStreamHeaderAdapter: fastly.buildFastlyStreamHeaderAdapter,
-  buildFastlyCommandEntry: fastly.buildFastlyCommandEntry,
-  buildFastlyAssetsProviderProof: fastly.buildFastlyAssetsProviderProof,
-  buildFastlyAssetsPackageOutParityProof: fastly.buildFastlyAssetsPackageOutParityProof,
-  buildFastlyRouteHandlerEffectProof: fastly.buildFastlyRouteHandlerEffectProof,
-  buildFastlyLifecycleParityProof: fastly.buildFastlyLifecycleParityProof
-});
+// Compatibility proof commands are optional and never loaded by plain compile,
+// help or version. The caller supplies its project/CLI composition root.
+function createProviderProofs(root = process.cwd()) {
+  const load = createRequire(path.join(path.resolve(root), 'package.json'));
+  return Object.freeze({
+    buildNodeAdapter: (...args) => load('@pulse-compute/provider-node/compiler').buildNodeAdapter(...args),
+    buildNodeAssetsProviderProof: (...args) => load('@pulse-compute/provider-node/compiler').buildNodeAssetsProviderProof(...args),
+    buildNodeCompiledWasmAssetsLifecycleProof: (...args) => load('@pulse-compute/provider-node/compiler').buildNodeCompiledWasmAssetsLifecycleProof(...args),
+    buildNodeRouteHandlerEffectProof: (...args) => load('@pulse-compute/provider-node/compiler').buildNodeRouteHandlerEffectProof(...args),
+    buildNodeRequestJsonBodyProof: (...args) => load('@pulse-compute/provider-node/compiler').buildNodeRequestJsonBodyProof(...args),
+    buildNodeSchemaDecodeResultProof: (...args) => load('@pulse-compute/provider-node/compiler').buildNodeSchemaDecodeResultProof(...args),
+    buildNodeSchemaResponseCodecProof: (...args) => load('@pulse-compute/provider-node/compiler').buildNodeSchemaResponseCodecProof(...args),
+    buildFastlyReadiness: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyReadiness(...args),
+    buildFastlyHostcallBinding: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyHostcallBinding(...args),
+    buildFastlyStreamHeaderAdapter: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyStreamHeaderAdapter(...args),
+    buildFastlyCommandEntry: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyCommandEntry(...args),
+    buildFastlyAssetsProviderProof: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyAssetsProviderProof(...args),
+    buildFastlyAssetsPackageOutParityProof: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyAssetsPackageOutParityProof(...args),
+    buildFastlyRouteHandlerEffectProof: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyRouteHandlerEffectProof(...args),
+    buildFastlyLifecycleParityProof: (...args) => load('@pulse-compute/provider-fastly/compiler').buildFastlyLifecycleParityProof(...args),
+    buildNodeLiveOriginRouteHandlerEffectProof: (...args) => load('@pulse-compute/provider-node/compiler/route-handler-live-origin-proof').buildNodeLiveOriginRouteHandlerEffectProof(...args),
+    buildNodeCompiledRouteHandlerEffectBridge: (...args) => load('@pulse-compute/provider-node/compiler/route-handler-compiled-wasm-bridge').buildNodeCompiledRouteHandlerEffectBridge(...args),
+    buildNodeBackendJsonRequestBodyProof: (...args) => load('@pulse-compute/provider-node/compiler/backend-json-request-body-proof').buildNodeBackendJsonRequestBodyProof(...args),
+  });
+}
+
+module.exports = { createProviderProofs };

package/bin/pulsewasm-extract.js

@@ -3,7 +3,7 @@
 
 const { runCli } = require('../src/cli.js');
 const { getDefaultArtifactsDir } = require('@pulse-compute/wasm-build-support/artifacts-dir');
-const providerProofs = require('./provider-proof-composition.js');
+const providerProofs = require('./provider-proof-composition.js').createProviderProofs(process.cwd());
 
 runCli(process.argv.slice(2), {
   cwd: process.cwd(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulse-compute/wasm-compiler",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.6",
   "license": "Apache-2.0",
   "description": "PulseWasm compiler package inside the Pulse monorepo.",
   "type": "commonjs",
@@ -9,15 +9,13 @@
     "pulsewasm": "./bin/pulsewasm-extract.js"
   },
   "dependencies": {
-    "@pulse-compute/provider-fastly": "1.0.0-beta.4",
-    "@pulse-compute/provider-node": "1.0.0-beta.4",
-    "@pulse-compute/wasm-build-support": "1.0.0-beta.4",
-    "@pulse-compute/wasm-contracts": "1.0.0-beta.4",
-    "@pulse-compute/wasm-guest-link": "1.0.0-beta.4",
-    "@pulse-compute/wasm-host-runtime": "1.0.0-beta.4",
-    "@pulse-compute/wasm-library-kit": "1.0.0-beta.4",
-    "@pulse-compute/wasm-runtime-core-as": "1.0.0-beta.4",
-    "@pulse-compute/wasm-schema-json": "1.0.0-beta.4",
+    "@pulse-compute/wasm-build-support": "1.0.0-beta.6",
+    "@pulse-compute/wasm-contracts": "1.0.0-beta.6",
+    "@pulse-compute/wasm-guest-link": "1.0.0-beta.6",
+    "@pulse-compute/wasm-host-runtime": "1.0.0-beta.6",
+    "@pulse-compute/wasm-library-kit": "1.0.0-beta.6",
+    "@pulse-compute/wasm-runtime-core-as": "1.0.0-beta.6",
+    "@pulse-compute/wasm-schema-json": "1.0.0-beta.6",
     "assemblyscript": "0.28.18",
     "json-as": "1.5.0",
     "typescript": "5.9.3"
@@ -58,7 +56,7 @@
     "url": "git+https://github.com/pulse-compute/pulse.git",
     "directory": "wasm/packages/compiler"
   },
-  "homepage": "https://pulsecompute.io/v1.0.0-beta.4/packages/implementation-packages/",
+  "homepage": "https://pulsecompute.io/v1.0.0-beta.6/packages/implementation-packages/",
   "bugs": {
     "url": "https://github.com/pulse-compute/pulse/issues"
   },

package/src/canonical-api-compiler.js

@@ -22,15 +22,7 @@ const {
   CanonicalCompileError
 } = require('./spine/plain-handler-frontend.js');
 
-function loadCanonicalRuntimeContract() {
-  try { return require('@pulse-compute/wasm-contracts/handler/canonical-runtime'); }
-  catch (error) {
-    if (error && ['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED'].includes(error.code)) return require('../../contracts/src/handler/canonical-runtime.js');
-    throw error;
-  }
-}
-
-const canonicalRuntimeContract = loadCanonicalRuntimeContract();
+const canonicalRuntimeContract = require('@pulse-compute/wasm-contracts/handler/canonical-runtime');
 
 const CANONICAL_API_COMPILER_VERSION = 'pulse.canonical-api-compiler.v7';
 

package/src/canonical-native-compiler.js

@@ -17,59 +17,12 @@ const {
   PACKAGE_REALIZATION_ARTIFACT_SET_VERSION
 } = require('@pulse-compute/wasm-contracts/package/package-contract');
 
-function loadNativePlanCompiler() {
-  try { return require('@pulse-compute/wasm-compiler/canonical-native-plan'); }
-  catch (error) {
-    if (error && ['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED'].includes(error.code)) return require('./canonical-native-plan.js');
-    throw error;
-  }
-}
-
-function loadRuntimeCore() {
-  try { return require('@pulse-compute/wasm-runtime-core-as/compiler/canonical-native'); }
-  catch (error) {
-    if (error && ['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED'].includes(error.code)) return require('../../runtime-core-as/src/compiler/canonical-native.js');
-    throw error;
-  }
-}
-
-function loadRuntimeContract() {
-  try { return require('@pulse-compute/wasm-contracts/handler/canonical-native-runtime'); }
-  catch (error) {
-    if (error && ['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED'].includes(error.code)) return require('../../contracts/src/handler/canonical-native-runtime.js');
-    throw error;
-  }
-}
-
-function loadEventContract() {
-  try { return require('@pulse-compute/wasm-contracts/events'); }
-  catch (error) {
-    if (error && ['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED'].includes(error.code)) return require('../../contracts/src/events/contracts.js');
-    throw error;
-  }
-}
-
-function loadBuildSupport() {
-  try { return require('@pulse-compute/wasm-build-support/assemblyscript-compile'); }
-  catch (error) {
-    if (error && ['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED'].includes(error.code)) return require('../../build-support/src/assemblyscript-compile.js');
-    throw error;
-  }
-}
-
-const nativePlanCompiler = loadNativePlanCompiler();
-const runtimeCore = loadRuntimeCore();
-const runtimeContract = loadRuntimeContract();
-const eventContract = loadEventContract();
-const { resolveAsc } = loadBuildSupport();
-const { memoryAbi } = (() => {
-  try {
-    return require('@pulse-compute/wasm-guest-link');
-  } catch (error) {
-    if (error && error.code === 'MODULE_NOT_FOUND') return require('../../wasm-guest-link/src/index.js');
-    throw error;
-  }
-})();
+const nativePlanCompiler = require('./canonical-native-plan.js');
+const runtimeCore = require('@pulse-compute/wasm-runtime-core-as/compiler/canonical-native');
+const runtimeContract = require('@pulse-compute/wasm-contracts/handler/canonical-native-runtime');
+const eventContract = require('@pulse-compute/wasm-contracts/events');
+const { resolveAsc } = require('@pulse-compute/wasm-build-support/assemblyscript-compile');
+const { memoryAbi } = require('@pulse-compute/wasm-guest-link');
 const {
   appendAssemblyScriptOptimizationArgs,
   resolveNativeOptimization
@@ -182,7 +135,13 @@ function realizeCanonicalNativePlan(plan, options = {}, providerRequirements) {
   const compilerPackageRoot = path.resolve(__dirname, '..');
   const asc = resolveAsc(cwd) || resolveAsc(compilerPackageRoot);
   if (!asc) throw new CanonicalNativeCompileError('AssemblyScript compiler dependency was not found.', { cwd, remediation: 'Install the lockfile-pinned AssemblyScript dependency before compiling native Wasm.' });
-  const generated = runtimeCore.generateCanonicalNativeAssemblyScript(plan, options);
+  const application = plan.packages && plan.packages.application;
+  const source = application && application.source + `\nconst __pulse_application_plan_hash: string = ${JSON.stringify(plan.planHash)}\n`;
+  const generated = application ? Object.freeze({
+    source, sourceHash: sha256(source), manifest: Object.freeze({
+      ...application.manifest, planVersion: plan.version, planHash: plan.planHash, sourceHash: sha256(source)
+    })
+  }) : runtimeCore.generateCanonicalNativeAssemblyScript(plan, options);
   const schemaCodecsActive = generated.manifest.schemaCodecs && generated.manifest.schemaCodecs.active === true;
   let jsonAs;
   if (schemaCodecsActive) {
@@ -209,6 +168,8 @@ function realizeCanonicalNativePlan(plan, options = {}, providerRequirements) {
     }
     jsonAs = Object.freeze({ transform, packageRoot, dependencyRoot, version: packageJson.version });
   }
+  if (options.emitWat !== undefined && typeof options.emitWat !== 'boolean') throw new TypeError('emitWat must be a boolean.');
+  const emitWat = options.emitWat === true;
   const stagingDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pulse-canonical-native-'));
   const requestedOutDir = options.outDir ? path.resolve(options.outDir) : undefined;
   const outputDir = requestedOutDir || stagingDir;
@@ -216,6 +177,7 @@ function realizeCanonicalNativePlan(plan, options = {}, providerRequirements) {
   const sourceFile = path.join(stagingDir, 'canonical-native.as.ts');
   const wasmFile = path.join(outputDir, options.wasmFile || 'canonical-native.wasm');
   const watFile = path.join(outputDir, options.watFile || 'canonical-native.wat');
+  if (!emitWat) fs.rmSync(watFile, { force: true });
   try {
     fs.writeFileSync(sourceFile, generated.source, 'utf8');
     // Compile from a stable, relative entry name so AssemblyScript's name section and
@@ -224,14 +186,25 @@ function realizeCanonicalNativePlan(plan, options = {}, providerRequirements) {
       asc.script,
       path.basename(sourceFile),
       '--outFile', wasmFile,
-      '--textFile', watFile,
       '--runtime', schemaCodecsActive ? 'incremental' : 'stub',
       '--noAssert',
       '--optimize'
     ];
-    const optimization = appendAssemblyScriptOptimizationArgs(args, options.nativeOptimization);
+    if (emitWat) args.push('--textFile', watFile);
+    const optimization = appendAssemblyScriptOptimizationArgs(args, options.nativeOptimization, {
+      guestLinked: guestUnits.length > 0
+    });
+    // The text capacity profile bounds each Native module to 256 MiB.
+    // Linked guests retain their separately owned fixed-memory ABI.
+    if (guestUnits.length === 0 && (runtimeContract.hasBoundedReadLoop(plan) || plan.capabilities.includes('response.output') || plan.capabilities.includes('request.body.transform') || plan.effects.some(effect => effect.kind === 'crypto.digestText' || effect.kind.startsWith('s3.')))) {
+      args.push('--maximumMemory', String(runtimeContract.CANONICAL_NATIVE_READ_LOOP_MEMORY.maximumMemoryPages));
+    }
+    if (guestUnits.length > 0 && (plan.capabilities.includes('response.output') || plan.capabilities.includes('request.body.transform'))) throw new CanonicalNativeCompileError('Generated output with linked guests requires separate memory qualification.');
     if (guestUnits.length > 0) {
       args.push(
+        '--disable', 'bulk-memory',
+        '--disable', 'nontrapping-f2i',
+        '--disable', 'sign-extension',
         '--importMemory',
         '--noExportMemory',
         '--initialMemory', String(memoryAbi.minimumPages),
@@ -276,12 +249,13 @@ function realizeCanonicalNativePlan(plan, options = {}, providerRequirements) {
       guestUnits,
       generated,
       wasm: fs.readFileSync(wasmFile),
-      wat: fs.existsSync(watFile) ? fs.readFileSync(watFile, 'utf8') : '',
+      wat: emitWat ? fs.readFileSync(watFile, 'utf8') : '',
+      textEmitted: emitWat,
       assemblyScriptVersion: require(path.join(asc.packageRoot, 'package.json')).version,
       jsonAsVersion: jsonAs && jsonAs.version,
       optimization,
       durationMs,
-      output: requestedOutDir ? Object.freeze({ outDir: outputDir, wasmFile, watFile }) : undefined
+      output: requestedOutDir ? Object.freeze({ outDir: outputDir, wasmFile, watFile: emitWat ? watFile : null }) : undefined
     });
   } finally {
     fs.rmSync(stagingDir, { recursive: true, force: true });
@@ -311,7 +285,9 @@ function verifyCanonicalNativeRealization(realization) {
       ? Object.freeze({ package: 'json-as', version: realization.jsonAsVersion, transform: true, strict: true, mode: 'NAIVE', fastPath: false })
       : null,
     wasm: Object.freeze({ bytes: inspection.bytes, sha256: inspection.sha256, magic: inspection.magic }),
-    wat: Object.freeze({ bytes: Buffer.byteLength(realization.wat), sha256: sha256(realization.wat) }),
+    wat: Object.freeze(realization.textEmitted
+      ? { emitted: true, bytes: Buffer.byteLength(realization.wat), sha256: sha256(realization.wat) }
+      : { emitted: false, bytes: 0, sha256: null }),
     importModules: inspection.importModules,
     imports: inspection.imports,
     exports: inspection.exports,
@@ -322,7 +298,7 @@ function verifyCanonicalNativeRealization(realization) {
       finalWasmAudit: realization.guestLink.audit,
       providerPackaging: realization.guestLink.providerPackaging
     } : {}),
-    policy: runtimeContract.CANONICAL_NATIVE_POLICY
+    policy: realization.generated.manifest.policy
   });
   return Object.freeze({
     version: runtimeContract.CANONICAL_NATIVE_WASM_VERSION,
@@ -376,7 +352,9 @@ function writeCanonicalNativeModule(compiled, outDir, options = {}) {
     : undefined;
   fs.writeFileSync(sourceFile, compiled.source, 'utf8');
   fs.writeFileSync(wasmFile, compiled.wasm);
-  fs.writeFileSync(watFile, compiled.wat, 'utf8');
+  const emitWat = compiled.manifest.wat.emitted !== false;
+  if (emitWat) fs.writeFileSync(watFile, compiled.wat, 'utf8');
+  else fs.rmSync(watFile, { force: true });
   fs.writeFileSync(planFile, `${nativePlanCompiler.stableStringify(compiled.plan, 2)}\n`, 'utf8');
   fs.writeFileSync(manifestFile, `${stableStringify(compiled.manifest, 2)}\n`, 'utf8');
   if (realizationArtifactsFile) {
@@ -389,7 +367,7 @@ function writeCanonicalNativeModule(compiled, outDir, options = {}) {
     target,
     sourceFile,
     wasmFile,
-    watFile,
+    watFile: emitWat ? watFile : null,
     planFile,
     manifestFile,
     realizationArtifactsFile,