githolon 0.102.0 → 0.102.1

package/dist/dev-server.mjs

@@ -2227,6 +2227,18 @@ var unb64 = (s) => new Uint8Array(Buffer.from(s, "base64"));
 function configDir() {
   return process.env.HOLON_CONFIG_DIR || path.join(os.homedir(), ".holon");
 }
+function explicitRuntimeDir() {
+  if (process.env.NOMOS_CANDIDATE_RUNTIME) {
+    return { dir: process.env.NOMOS_CANDIDATE_RUNTIME, candidate: true };
+  }
+  if (process.env.NOMOS_OFFLINE_RUNTIME) {
+    return { dir: process.env.NOMOS_OFFLINE_RUNTIME, candidate: false };
+  }
+  return null;
+}
+function selectedRuntimeDir() {
+  return explicitRuntimeDir()?.dir ?? path.join(configDir(), "runtime");
+}
 function firstExisting(...paths) {
   for (const p of paths) {
     if (p && existsSync2(p)) return p;
@@ -2272,21 +2284,39 @@ function capabilitiesForKernelHash(hash) {
 }
 var DEFAULT_KERNEL_SOURCE = "https://nomos.captainapp.co.uk";
 async function resolveTestMintWasm(kernelSource) {
-  const runtimeCache = path.join(configDir(), "runtime");
+  const explicitRuntime = explicitRuntimeDir();
+  const runtimeCache = selectedRuntimeDir();
   const cachePath = path.join(runtimeCache, "holon-testmint.wasm");
+  if (explicitRuntime) {
+    if (existsSync2(cachePath)) {
+      const bytes = readFileSync2(cachePath);
+      if (isTestMintBytes(bytes)) {
+        return { wasmPath: cachePath, wasmBytes: bytes, kernelKind: "test-mint", kernelSource: "explicit-runtime" };
+      }
+    }
+    if (explicitRuntime.candidate || String(process.env.NOMOS_RUNTIME_REFRESH || "auto").toLowerCase() === "never") {
+      throw new Error(
+        `explicit runtime is missing a valid test-mint kernel at ${cachePath}; hydrate that exact runtime bundle before running the generated proof`
+      );
+    }
+  }
   const local = process.env.NOMOS_LOCAL_WASM;
-  if (local && existsSync2(local)) {
+  if (!explicitRuntime && local && existsSync2(local)) {
     const bytes = readFileSync2(local);
     if (isTestMintBytes(bytes)) return { wasmPath: local, wasmBytes: bytes, kernelKind: "test-mint", kernelSource: "NOMOS_LOCAL_WASM" };
   }
   const bundled = path.join(DIR, "kernel-testmint.wasm");
-  if (existsSync2(bundled)) {
+  if (!explicitRuntime && existsSync2(bundled)) {
     const bytes = readFileSync2(bundled);
     if (isTestMintBytes(bytes)) return { wasmPath: bundled, wasmBytes: bytes, kernelKind: "test-mint", kernelSource: "bundled" };
   }
-  if (existsSync2(cachePath)) {
+  if (!explicitRuntime && existsSync2(cachePath)) {
     const bytes = readFileSync2(cachePath);
-    if (isTestMintBytes(bytes)) return { wasmPath: cachePath, wasmBytes: bytes, kernelKind: "test-mint", kernelSource: "cache" };
+    const sha = createHash2("sha256").update(bytes).digest("hex");
+    const currentTestMint = DEPLOYED_KERNELS.find((entry) => /test-mint/i.test(entry.note));
+    if (isTestMintBytes(bytes) && currentTestMint?.hash === sha) {
+      return { wasmPath: cachePath, wasmBytes: bytes, kernelKind: "test-mint", kernelSource: "cache" };
+    }
   }
   const src = String(kernelSource || process.env.NOMOS_KERNEL_SOURCE || DEFAULT_KERNEL_SOURCE).replace(/\/+$/, "");
   const url = `${src}/v1/runtime/holon-testmint.wasm`;
@@ -2307,7 +2337,8 @@ async function resolveTestMintWasm(kernelSource) {
   );
 }
 async function loadRuntime(opts = {}) {
-  const runtimeCache = path.join(configDir(), "runtime");
+  const explicitRuntime = explicitRuntimeDir();
+  const runtimeCache = selectedRuntimeDir();
   const repoDomainsDir = path.join(REPO_ROOT, "cloud/cloudflare-shell/container/domains");
   const vendoredFrameworkDir = path.join(DIR, "framework");
   let wasmPath, wasmBytes, kernelKind, kernelSource;
@@ -2315,9 +2346,10 @@ async function loadRuntime(opts = {}) {
     ({ wasmPath, wasmBytes, kernelKind, kernelSource } = await resolveTestMintWasm(opts.kernelSource));
   } else {
     wasmPath = firstExisting(
-      process.env.NOMOS_LOCAL_WASM,
-      path.join(REPO_ROOT, "cloud/cloudflare-shell/container/vendor/wasm_git_holon.wasm"),
-      path.join(runtimeCache, "holon.wasm")
+      explicitRuntime ? path.join(runtimeCache, "holon.wasm") : null,
+      explicitRuntime ? null : process.env.NOMOS_LOCAL_WASM,
+      explicitRuntime ? null : path.join(REPO_ROOT, "cloud/cloudflare-shell/container/vendor/wasm_git_holon.wasm"),
+      explicitRuntime ? null : path.join(runtimeCache, "holon.wasm")
     );
     if (!wasmPath) {
       throw new Error(
@@ -2331,7 +2363,16 @@ async function loadRuntime(opts = {}) {
   const repoBootstrap = firstExisting(path.join(repoDomainsDir, "domain_bootstrap.package.usda"));
   const repoNomos = firstExisting(path.join(repoDomainsDir, "domain_nomos.package.usda"));
   let bootstrapPkg, nomosPkg;
-  if (repoBootstrap && repoNomos) {
+  const explicitPackages = explicitRuntime ? path.join(runtimeCache, "packages.json") : null;
+  if (explicitPackages && existsSync2(explicitPackages)) {
+    const pkgs = JSON.parse(readFileSync2(explicitPackages, "utf8"));
+    bootstrapPkg = pkgs.bootstrap;
+    nomosPkg = pkgs.nomos;
+  } else if (explicitRuntime) {
+    throw new Error(
+      `explicit runtime is missing framework packages at ${explicitPackages}; hydrate that exact runtime bundle before starting the local Nomos cloud`
+    );
+  } else if (repoBootstrap && repoNomos) {
     bootstrapPkg = readFileSync2(repoBootstrap, "utf8");
     nomosPkg = readFileSync2(repoNomos, "utf8");
   } else if (existsSync2(path.join(vendoredFrameworkDir, "domain_bootstrap.package.usda"))) {
@@ -3107,6 +3148,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   });
 }
 export {
+  resolveTestMintWasm,
   startDevCloud,
   startGeneratedApplicationProofCloud
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "githolon",
-  "version": "0.102.0",
+  "version": "0.102.1",
   "type": "module",
   "description": "githolon — the Nomos developer CLI: Rails-style generators for @githolon/dsl domains + the package compiler. Kernel-independent.",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "@bjorn3/browser_wasi_shim": "0.4.2",
-    "@githolon/dsl": "^0.102.0",
+    "@githolon/dsl": "^0.102.1",
     "isomorphic-git": "^1.38.4"
   },
   "devDependencies": {