@holoscript/core 8.0.14 → 8.0.16

package/dist/{chunk-VA7THINF.cjs → chunk-ZXXC2GXB.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkP65OIMJT_cjs = require('./chunk-P65OIMJT.cjs');
-var chunkSE2Y5BSL_cjs = require('./chunk-SE2Y5BSL.cjs');
+var chunkIYK6LMQ7_cjs = require('./chunk-IYK6LMQ7.cjs');
+var chunkCMEINO5I_cjs = require('./chunk-CMEINO5I.cjs');
 var chunkZHPMP447_cjs = require('./chunk-ZHPMP447.cjs');
 var ans = require('@holoscript/core-types/ans');
 
@@ -50,11 +50,11 @@ function compileToVRChat(composition, options) {
 exports.VRChatCompiler = void 0;
 var init_VRChatCompiler = chunkZHPMP447_cjs.__esm({
   "src/compiler/VRChatCompiler.ts"() {
-    chunkSE2Y5BSL_cjs.init_CompilerBase();
+    chunkCMEINO5I_cjs.init_CompilerBase();
     init_udon_assembly();
     init_udon_extern_manifest();
-    chunkP65OIMJT_cjs.init_DomainBlockCompilerMixin();
-    exports.VRChatCompiler = class extends chunkSE2Y5BSL_cjs.CompilerBase {
+    chunkIYK6LMQ7_cjs.init_DomainBlockCompilerMixin();
+    exports.VRChatCompiler = class extends chunkCMEINO5I_cjs.CompilerBase {
       constructor(options = {}) {
         super();
         this.compilerName = "VRChatCompiler";
@@ -297,59 +297,59 @@ var init_VRChatCompiler = chunkZHPMP447_cjs.__esm({
         this.emit("");
         this.emit("// === v4.2 Domain Blocks (VRChat/Unity) ===");
         let blockIdx = 0;
-        const compiled = chunkP65OIMJT_cjs.compileDomainBlocks(
+        const compiled = chunkIYK6LMQ7_cjs.compileDomainBlocks(
           domainBlocks,
           {
             material: (block) => {
-              const mat = chunkP65OIMJT_cjs.compileMaterialBlock(block);
-              return chunkP65OIMJT_cjs.materialToVRChat(mat, `db${blockIdx++}`);
+              const mat = chunkIYK6LMQ7_cjs.compileMaterialBlock(block);
+              return chunkIYK6LMQ7_cjs.materialToVRChat(mat, `db${blockIdx++}`);
             },
             physics: (block) => {
-              const phys = chunkP65OIMJT_cjs.compilePhysicsBlock(block);
-              return chunkP65OIMJT_cjs.physicsToUnity(phys, `db${blockIdx++}`);
+              const phys = chunkIYK6LMQ7_cjs.compilePhysicsBlock(block);
+              return chunkIYK6LMQ7_cjs.physicsToUnity(phys, `db${blockIdx++}`);
             },
             vfx: (block) => {
-              const ps = chunkP65OIMJT_cjs.compileParticleBlock(block);
-              return chunkP65OIMJT_cjs.particlesToUnity(ps, `db${blockIdx++}`);
+              const ps = chunkIYK6LMQ7_cjs.compileParticleBlock(block);
+              return chunkIYK6LMQ7_cjs.particlesToUnity(ps, `db${blockIdx++}`);
             },
             postfx: (block) => {
-              const pp = chunkP65OIMJT_cjs.compilePostProcessingBlock(block);
-              return chunkP65OIMJT_cjs.postProcessingToUnity(pp);
+              const pp = chunkIYK6LMQ7_cjs.compilePostProcessingBlock(block);
+              return chunkIYK6LMQ7_cjs.postProcessingToUnity(pp);
             },
             audio: (block) => {
-              const audio = chunkP65OIMJT_cjs.compileAudioSourceBlock(block);
-              return chunkP65OIMJT_cjs.audioSourceToUnity(audio, `db${blockIdx++}`);
+              const audio = chunkIYK6LMQ7_cjs.compileAudioSourceBlock(block);
+              return chunkIYK6LMQ7_cjs.audioSourceToUnity(audio, `db${blockIdx++}`);
             },
             weather: (block) => {
-              const weather = chunkP65OIMJT_cjs.compileWeatherBlock(block);
-              return chunkP65OIMJT_cjs.weatherToUnity(weather);
+              const weather = chunkIYK6LMQ7_cjs.compileWeatherBlock(block);
+              return chunkIYK6LMQ7_cjs.weatherToUnity(weather);
             },
             narrative: (block) => {
-              const narr = chunkP65OIMJT_cjs.compileNarrativeBlock(block);
-              return chunkP65OIMJT_cjs.narrativeToVRChat(narr);
+              const narr = chunkIYK6LMQ7_cjs.compileNarrativeBlock(block);
+              return chunkIYK6LMQ7_cjs.narrativeToVRChat(narr);
             },
             payment: (block) => {
-              const pay = chunkP65OIMJT_cjs.compilePaymentBlock(block);
-              return chunkP65OIMJT_cjs.paymentToVRChat(pay);
+              const pay = chunkIYK6LMQ7_cjs.compilePaymentBlock(block);
+              return chunkIYK6LMQ7_cjs.paymentToVRChat(pay);
             },
             healthcare: (block) => {
-              const h = chunkP65OIMJT_cjs.compileHealthcareBlock(block);
-              return chunkP65OIMJT_cjs.healthcareToVRChat(h);
+              const h = chunkIYK6LMQ7_cjs.compileHealthcareBlock(block);
+              return chunkIYK6LMQ7_cjs.healthcareToVRChat(h);
             },
             robotics: (block) => {
-              const r = chunkP65OIMJT_cjs.compileRoboticsBlock(block);
-              return chunkP65OIMJT_cjs.roboticsToVRChat(r);
+              const r = chunkIYK6LMQ7_cjs.compileRoboticsBlock(block);
+              return chunkIYK6LMQ7_cjs.roboticsToVRChat(r);
             },
-            iot: (block) => chunkP65OIMJT_cjs.iotToVRChat(chunkP65OIMJT_cjs.compileIoTBlock(block)),
-            dataviz: (block) => chunkP65OIMJT_cjs.datavizToVRChat(chunkP65OIMJT_cjs.compileDataVizBlock(block)),
-            education: (block) => chunkP65OIMJT_cjs.educationToVRChat(chunkP65OIMJT_cjs.compileEducationBlock(block)),
-            music: (block) => chunkP65OIMJT_cjs.musicToVRChat(chunkP65OIMJT_cjs.compileMusicBlock(block)),
-            architecture: (block) => chunkP65OIMJT_cjs.architectureToVRChat(chunkP65OIMJT_cjs.compileArchitectureBlock(block)),
-            web3: (block) => chunkP65OIMJT_cjs.web3ToVRChat(chunkP65OIMJT_cjs.compileWeb3Block(block)),
-            procedural: (block) => chunkP65OIMJT_cjs.proceduralToVRChat(chunkP65OIMJT_cjs.compileProceduralBlock(block)),
-            rendering: (block) => chunkP65OIMJT_cjs.renderingToVRChat(chunkP65OIMJT_cjs.compileRenderingBlock(block)),
-            navigation: (block) => chunkP65OIMJT_cjs.navigationToVRChat(chunkP65OIMJT_cjs.compileNavigationBlock(block)),
-            input: (block) => chunkP65OIMJT_cjs.inputToVRChat(chunkP65OIMJT_cjs.compileInputBlock(block))
+            iot: (block) => chunkIYK6LMQ7_cjs.iotToVRChat(chunkIYK6LMQ7_cjs.compileIoTBlock(block)),
+            dataviz: (block) => chunkIYK6LMQ7_cjs.datavizToVRChat(chunkIYK6LMQ7_cjs.compileDataVizBlock(block)),
+            education: (block) => chunkIYK6LMQ7_cjs.educationToVRChat(chunkIYK6LMQ7_cjs.compileEducationBlock(block)),
+            music: (block) => chunkIYK6LMQ7_cjs.musicToVRChat(chunkIYK6LMQ7_cjs.compileMusicBlock(block)),
+            architecture: (block) => chunkIYK6LMQ7_cjs.architectureToVRChat(chunkIYK6LMQ7_cjs.compileArchitectureBlock(block)),
+            web3: (block) => chunkIYK6LMQ7_cjs.web3ToVRChat(chunkIYK6LMQ7_cjs.compileWeb3Block(block)),
+            procedural: (block) => chunkIYK6LMQ7_cjs.proceduralToVRChat(chunkIYK6LMQ7_cjs.compileProceduralBlock(block)),
+            rendering: (block) => chunkIYK6LMQ7_cjs.renderingToVRChat(chunkIYK6LMQ7_cjs.compileRenderingBlock(block)),
+            navigation: (block) => chunkIYK6LMQ7_cjs.navigationToVRChat(chunkIYK6LMQ7_cjs.compileNavigationBlock(block)),
+            input: (block) => chunkIYK6LMQ7_cjs.inputToVRChat(chunkIYK6LMQ7_cjs.compileInputBlock(block))
           },
           (block) => `// Domain block: ${block.domain}/${block.keyword} "${this.escapeStringValue(block.name, "CSharp")}"`
         );
@@ -735,5 +735,5 @@ var init_VRChatCompiler = chunkZHPMP447_cjs.__esm({
 exports.VRChatCompiler_exports = VRChatCompiler_exports;
 exports.compileToVRChat = compileToVRChat;
 exports.init_VRChatCompiler = init_VRChatCompiler;
-//# sourceMappingURL=chunk-VA7THINF.cjs.map
-//# sourceMappingURL=chunk-VA7THINF.cjs.map
+//# sourceMappingURL=chunk-ZXXC2GXB.cjs.map
+//# sourceMappingURL=chunk-ZXXC2GXB.cjs.map

package/dist/cli/holoscript-runner.cjs

@@ -5,12 +5,12 @@ var chunkQVJMDVYZ_cjs = require('../chunk-QVJMDVYZ.cjs');
 var chunk37HHY7RH_cjs = require('../chunk-37HHY7RH.cjs');
 var chunkXHIV6326_cjs = require('../chunk-XHIV6326.cjs');
 var chunkR75BSDH7_cjs = require('../chunk-R75BSDH7.cjs');
-var chunkN7IYRAFG_cjs = require('../chunk-N7IYRAFG.cjs');
-require('../chunk-TKDDIE3T.cjs');
+var chunkFVNV4WHQ_cjs = require('../chunk-FVNV4WHQ.cjs');
+require('../chunk-ILO2KMER.cjs');
 require('../chunk-YP5CHEYU.cjs');
-require('../chunk-LHUDAJQT.cjs');
-require('../chunk-EI3J6LTW.cjs');
-require('../chunk-36NPLOI4.cjs');
+require('../chunk-2PVEXEOL.cjs');
+require('../chunk-6RDHWSZM.cjs');
+require('../chunk-JERWCCEJ.cjs');
 require('../chunk-AWXFEAQL.cjs');
 require('../chunk-4FIBOJW6.cjs');
 require('../chunk-N74QRJGP.cjs');
@@ -704,6 +704,65 @@ async function runDaemon(runtime, opts) {
     rl.once("close", () => resolve2());
   });
 }
+var RUN_RECEIPT_SCHEMA = "holoscript.cli.run-receipt.v1";
+var RUN_SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".holo", ".hs", ".hsplus"]);
+function sha256(value) {
+  return `sha256:${crypto.createHash("sha256").update(value).digest("hex")}`;
+}
+function summarizeRunParseErrors(errors) {
+  if (!Array.isArray(errors)) return [];
+  return errors.slice(0, 8).map((error) => {
+    const item = error && typeof error === "object" ? error : {};
+    const summary = {
+      message: typeof item.message === "string" ? item.message : "HoloScript parse failed"
+    };
+    if (typeof item.code === "string") summary.code = item.code;
+    if (Number.isInteger(item.line)) summary.line = item.line;
+    if (Number.isInteger(item.column)) summary.column = item.column;
+    return summary;
+  });
+}
+function integerStat(stats, key) {
+  const value = stats[key];
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+function normalizeRuntimeCounters(stats) {
+  return {
+    tickCount: integerStat(stats, "tickCount") ?? integerStat(stats, "updateCount"),
+    nodesProcessed: integerStat(stats, "nodesProcessed"),
+    instanceCount: integerStat(stats, "instanceCount"),
+    peakInstanceCount: integerStat(stats, "peakInstanceCount"),
+    eventCount: integerStat(stats, "eventCount")
+  };
+}
+function resolvePortableRunOutput(output) {
+  if (!output) return void 0;
+  const portable = output.replace(/\\/gu, "/");
+  const segments = portable.split("/");
+  if (path__namespace.isAbsolute(output) || /^[a-z]:/iu.test(portable) || portable.startsWith("//") || segments.some((segment) => segment === "..") || path__namespace.extname(portable).toLowerCase() !== ".json") {
+    throw new Error("Run receipt output must be a portable, relative .json path");
+  }
+  const resolved = path__namespace.resolve(process.cwd(), output);
+  const relative2 = path__namespace.relative(process.cwd(), resolved);
+  if (relative2.startsWith("..") || path__namespace.isAbsolute(relative2)) {
+    throw new Error("Run receipt output must stay within the working directory");
+  }
+  return resolved;
+}
+function emitRunReceipt(opts, outputPath, stableReceipt) {
+  const receipt = {
+    ...stableReceipt,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    receiptHash: sha256(JSON.stringify(stableReceipt))
+  };
+  if (outputPath) {
+    fs__namespace.mkdirSync(path__namespace.dirname(outputPath), { recursive: true });
+    fs__namespace.writeFileSync(outputPath, `${JSON.stringify(receipt, null, 2)}
+`, "utf-8");
+  }
+  if (opts.json) console.log(JSON.stringify(receipt));
+  return receipt;
+}
 async function runScript(opts) {
   if (!opts.file) {
     console.error("Error: No input file specified");
@@ -716,8 +775,57 @@ async function runScript(opts) {
   }
   const source = fs__namespace.readFileSync(filePath, "utf-8");
   const ext = path__namespace.extname(filePath);
-  console.log(`[holoscript] Running ${path__namespace.basename(filePath)} (target: ${opts.target})`);
-  const parseResult = chunkN7IYRAFG_cjs.parse(source);
+  const outputPath = resolvePortableRunOutput(opts.output);
+  if (opts.watch && (opts.json || outputPath)) {
+    throw new Error("Run receipts cannot be combined with --watch");
+  }
+  if (!opts.json) {
+    console.log(`[holoscript] Running ${path__namespace.basename(filePath)} (target: ${opts.target})`);
+  }
+  if (!RUN_SOURCE_EXTENSIONS.has(ext.toLowerCase())) {
+    const errors = [
+      {
+        code: "CLI001",
+        message: "HoloScript run accepts only .holo, .hs, or .hsplus source"
+      }
+    ];
+    emitRunReceipt(opts, outputPath, {
+      schema: RUN_RECEIPT_SCHEMA,
+      ok: false,
+      source: {
+        file: path__namespace.basename(filePath),
+        extension: ext.toLowerCase(),
+        digest: sha256(source),
+        parsePassed: false,
+        errors
+      },
+      execution: null
+    });
+    if (!opts.json) console.error(`[holoscript] Admission failed \u2014 ${errors[0].message}`);
+    process.exitCode = 2;
+    return;
+  }
+  const parseResult = chunkFVNV4WHQ_cjs.parse(source);
+  if (!parseResult.success || !parseResult.ast) {
+    const errors = summarizeRunParseErrors(parseResult.errors);
+    emitRunReceipt(opts, outputPath, {
+      schema: RUN_RECEIPT_SCHEMA,
+      ok: false,
+      source: {
+        file: path__namespace.basename(filePath),
+        extension: ext.toLowerCase(),
+        digest: sha256(source),
+        parsePassed: false,
+        errors
+      },
+      execution: null
+    });
+    if (!opts.json) {
+      console.error(`[holoscript] Parse failed \u2014 ${errors[0]?.message ?? "invalid HoloScript"}`);
+    }
+    process.exitCode = 2;
+    return;
+  }
   const ast = parseResult.ast;
   if (opts.debug) {
     console.log(`[holoscript] Parsed ${ast.body?.length || 0} top-level nodes`);
@@ -764,9 +872,44 @@ async function runScript(opts) {
   runTicks(runtime, opts.ticks);
   runtime.stop();
   const stats = runtime.getStats();
-  console.log(
-    `[holoscript] Complete \u2014 ${stats.tickCount} ticks, ${stats.nodesProcessed} nodes processed`
-  );
+  const counters = normalizeRuntimeCounters(stats);
+  const sceneRuntime = runtime;
+  const scene = sceneRuntime.getSceneReceipt?.() ?? {
+    schema: "holoscript-headless-scene-receipt-unavailable-v1",
+    rootId: null,
+    objectCount: 0,
+    objects: []
+  };
+  const stableReceipt = {
+    schema: RUN_RECEIPT_SCHEMA,
+    ok: true,
+    source: {
+      file: path__namespace.basename(filePath),
+      extension: ext.toLowerCase(),
+      digest: sha256(source),
+      parsePassed: true,
+      topLevelNodes: ast.body?.length ?? 0
+    },
+    execution: {
+      target: opts.target,
+      profile: profile.name,
+      requestedTicks: opts.ticks,
+      counters,
+      scene,
+      policy: {
+        shellAllowed: opts.allowShell,
+        networkAllowed: opts.allowedHosts.length > 0,
+        allowedPathCount: opts.allowedPaths.length
+      }
+    }
+  };
+  emitRunReceipt(opts, outputPath, stableReceipt);
+  if (!opts.json) {
+    const objectCount = integerStat(scene, "objectCount") ?? 0;
+    console.log(
+      `[holoscript] Complete \u2014 ${counters.tickCount ?? "unknown"} ticks, ${objectCount} scene objects`
+    );
+  }
   if (opts.watch) {
     console.log(`[holoscript] Watching for changes... (Ctrl+C to stop)`);
     const watcher = new chunkXHIV6326_cjs.HotReloadWatcher({
@@ -781,7 +924,11 @@ async function runScript(opts) {
       console.log(`[holoscript] Re-running ${path__namespace.basename(filePath)}...`);
       try {
         const newSource = fs__namespace.readFileSync(filePath, "utf-8");
-        const newParseResult = chunkN7IYRAFG_cjs.parse(newSource);
+        const newParseResult = chunkFVNV4WHQ_cjs.parse(newSource);
+        if (!newParseResult.success || !newParseResult.ast) {
+          const parseError = summarizeRunParseErrors(newParseResult.errors)[0];
+          throw new Error(parseError?.message ?? "invalid HoloScript");
+        }
         const newAst = newParseResult.ast;
         const newRuntime = createHeadlessRuntime(newAst, {
           profile: opts.profile === "headless" ? HEADLESS_PROFILE : getProfile(opts.profile),
@@ -792,9 +939,11 @@ async function runScript(opts) {
         newRuntime.start();
         runTicks(newRuntime, opts.ticks);
         newRuntime.stop();
-        const newStats = newRuntime.getStats();
+        const newStats = normalizeRuntimeCounters(
+          newRuntime.getStats()
+        );
         console.log(
-          `[holoscript] Complete \u2014 ${newStats.tickCount} ticks, ${newStats.nodesProcessed} nodes`
+          `[holoscript] Complete \u2014 ${newStats.tickCount ?? "unknown"} ticks, ${newStats.nodesProcessed ?? "unknown"} nodes`
         );
       } catch (err) {
         console.error(`[holoscript] Error:`, err.message);
@@ -817,7 +966,7 @@ async function testScript(opts) {
   }
   const source = fs__namespace.readFileSync(filePath, "utf-8");
   console.log(`[holoscript test] Running tests in ${path__namespace.basename(filePath)}`);
-  const parseResult = chunkN7IYRAFG_cjs.parse(source);
+  const parseResult = chunkFVNV4WHQ_cjs.parse(source);
   const ast = parseResult.ast;
   const { createHeadlessRuntime, HEADLESS_PROFILE } = await loadEngineRuntime();
   const profile = HEADLESS_PROFILE;
@@ -900,7 +1049,7 @@ function compileScript(opts) {
     }
     console.log(`[holoscript compile] @gotcha check passed (no critical violations)`);
   }
-  const compileResult = chunkN7IYRAFG_cjs.parse(source);
+  const compileResult = chunkFVNV4WHQ_cjs.parse(source);
   if (!compileResult.success) {
     console.error(`[holoscript compile] Failed to parse: ${compileResult.errors?.[0]?.message}`);
     process.exit(1);
@@ -979,7 +1128,7 @@ async function deployScript(opts) {
   const fileName = path__namespace.basename(filePath);
   const title = path__namespace.basename(filePath, path__namespace.extname(filePath));
   console.log(`Parsing ${fileName}...`);
-  const ast = chunkN7IYRAFG_cjs.parse(source);
+  const ast = chunkFVNV4WHQ_cjs.parse(source);
   if (ast.errors && ast.errors.length > 0) {
     console.error("Parse errors:");
     for (const err of ast.errors) {
@@ -1344,7 +1493,7 @@ async function daemonScript(opts) {
   const { createDaemonActions, getDaemonFileState } = await import('@holoscript/absorb-service/daemon');
   const repoRoot = findGitRoot(path__namespace.dirname(filePath));
   const source = fs__namespace.readFileSync(filePath, "utf-8");
-  const parseResult = chunkN7IYRAFG_cjs.parse(source);
+  const parseResult = chunkFVNV4WHQ_cjs.parse(source);
   if (!parseResult.success || !parseResult.ast) {
     const errors = parseResult.errors?.map((e) => e.message).join(", ") || "unknown";
     console.error(`[daemon] Parse failed: ${errors}`);
@@ -1911,7 +2060,7 @@ async function holoMeshDaemonScript(opts) {
   }
   const rawSource = fs__namespace.readFileSync(filePath, "utf-8");
   const source = rawSource.replace(/^#(version|target|mode)\s+.*/gm, "");
-  const parseResult = chunkN7IYRAFG_cjs.parse(source);
+  const parseResult = chunkFVNV4WHQ_cjs.parse(source);
   if (!parseResult.success || !parseResult.ast) {
     const errors = parseResult.errors?.map((e) => e.message).join(", ") || "unknown";
     console.error(`[holomesh-daemon] Parse failed: ${errors}`);
@@ -2234,7 +2383,7 @@ function showHelp() {
 HoloScript CLI \u2014 Headless Runner v5.0
 
 Usage:
-  holoscript run <file>     [--target node|python|ros2] [--profile headless|minimal|full] [--ticks <n>] [--daemon] [--debug]
+  holoscript run <file>     [--target node|python|ros2] [--profile headless|minimal|full] [--ticks <n>] [--output <receipt.json>] [--json] [--daemon] [--debug]
   holoscript test <file>    [--debug]
   holoscript compile <file> [--target node|python] [--output <path>] [--enforce-gotchas]
   holoscript deploy <file>  [--share] [--publish] [--price <eth>] [--mint-nft] [--wallet-key <key>] [--author <name>] [--license <type>] [--server <url>]

package/dist/cli/holoscript-runner.js

@@ -3,12 +3,12 @@ import { checkLicenseCompatibility, ethToWei, calculateRevenueDistribution, form
 import { InteropContext } from '../chunk-TPZ3BN2D.js';
 import { AbsorbProcessor, ScriptTestRunner, HotReloadWatcher } from '../chunk-2M2DPHKB.js';
 import { generateProvenance } from '../chunk-4R6SBXDB.js';
-import { parse } from '../chunk-C73GVAYC.js';
-import '../chunk-Z7NUL73U.js';
+import { parse } from '../chunk-F33KLYOS.js';
+import '../chunk-MSZNGI5P.js';
 import '../chunk-UNMVGZVW.js';
-import '../chunk-FWKEY4LD.js';
-import '../chunk-2EGGAZT3.js';
-import '../chunk-YW3I2FQL.js';
+import '../chunk-4AGNARX6.js';
+import '../chunk-QS27OYBU.js';
+import '../chunk-ANMME7XT.js';
 import '../chunk-7I74JWPW.js';
 import '../chunk-2I3XAGMF.js';
 import '../chunk-MD4IVS42.js';
@@ -20,7 +20,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as readline from 'readline';
 import { spawn } from 'child_process';
-import { randomUUID } from 'crypto';
+import { randomUUID, createHash } from 'crypto';
 
 init_safeJsonParse();
 var engineRuntimeModule;
@@ -680,6 +680,65 @@ async function runDaemon(runtime, opts) {
     rl.once("close", () => resolve2());
   });
 }
+var RUN_RECEIPT_SCHEMA = "holoscript.cli.run-receipt.v1";
+var RUN_SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".holo", ".hs", ".hsplus"]);
+function sha256(value) {
+  return `sha256:${createHash("sha256").update(value).digest("hex")}`;
+}
+function summarizeRunParseErrors(errors) {
+  if (!Array.isArray(errors)) return [];
+  return errors.slice(0, 8).map((error) => {
+    const item = error && typeof error === "object" ? error : {};
+    const summary = {
+      message: typeof item.message === "string" ? item.message : "HoloScript parse failed"
+    };
+    if (typeof item.code === "string") summary.code = item.code;
+    if (Number.isInteger(item.line)) summary.line = item.line;
+    if (Number.isInteger(item.column)) summary.column = item.column;
+    return summary;
+  });
+}
+function integerStat(stats, key) {
+  const value = stats[key];
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+function normalizeRuntimeCounters(stats) {
+  return {
+    tickCount: integerStat(stats, "tickCount") ?? integerStat(stats, "updateCount"),
+    nodesProcessed: integerStat(stats, "nodesProcessed"),
+    instanceCount: integerStat(stats, "instanceCount"),
+    peakInstanceCount: integerStat(stats, "peakInstanceCount"),
+    eventCount: integerStat(stats, "eventCount")
+  };
+}
+function resolvePortableRunOutput(output) {
+  if (!output) return void 0;
+  const portable = output.replace(/\\/gu, "/");
+  const segments = portable.split("/");
+  if (path.isAbsolute(output) || /^[a-z]:/iu.test(portable) || portable.startsWith("//") || segments.some((segment) => segment === "..") || path.extname(portable).toLowerCase() !== ".json") {
+    throw new Error("Run receipt output must be a portable, relative .json path");
+  }
+  const resolved = path.resolve(process.cwd(), output);
+  const relative2 = path.relative(process.cwd(), resolved);
+  if (relative2.startsWith("..") || path.isAbsolute(relative2)) {
+    throw new Error("Run receipt output must stay within the working directory");
+  }
+  return resolved;
+}
+function emitRunReceipt(opts, outputPath, stableReceipt) {
+  const receipt = {
+    ...stableReceipt,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    receiptHash: sha256(JSON.stringify(stableReceipt))
+  };
+  if (outputPath) {
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, `${JSON.stringify(receipt, null, 2)}
+`, "utf-8");
+  }
+  if (opts.json) console.log(JSON.stringify(receipt));
+  return receipt;
+}
 async function runScript(opts) {
   if (!opts.file) {
     console.error("Error: No input file specified");
@@ -692,8 +751,57 @@ async function runScript(opts) {
   }
   const source = fs.readFileSync(filePath, "utf-8");
   const ext = path.extname(filePath);
-  console.log(`[holoscript] Running ${path.basename(filePath)} (target: ${opts.target})`);
+  const outputPath = resolvePortableRunOutput(opts.output);
+  if (opts.watch && (opts.json || outputPath)) {
+    throw new Error("Run receipts cannot be combined with --watch");
+  }
+  if (!opts.json) {
+    console.log(`[holoscript] Running ${path.basename(filePath)} (target: ${opts.target})`);
+  }
+  if (!RUN_SOURCE_EXTENSIONS.has(ext.toLowerCase())) {
+    const errors = [
+      {
+        code: "CLI001",
+        message: "HoloScript run accepts only .holo, .hs, or .hsplus source"
+      }
+    ];
+    emitRunReceipt(opts, outputPath, {
+      schema: RUN_RECEIPT_SCHEMA,
+      ok: false,
+      source: {
+        file: path.basename(filePath),
+        extension: ext.toLowerCase(),
+        digest: sha256(source),
+        parsePassed: false,
+        errors
+      },
+      execution: null
+    });
+    if (!opts.json) console.error(`[holoscript] Admission failed \u2014 ${errors[0].message}`);
+    process.exitCode = 2;
+    return;
+  }
   const parseResult = parse(source);
+  if (!parseResult.success || !parseResult.ast) {
+    const errors = summarizeRunParseErrors(parseResult.errors);
+    emitRunReceipt(opts, outputPath, {
+      schema: RUN_RECEIPT_SCHEMA,
+      ok: false,
+      source: {
+        file: path.basename(filePath),
+        extension: ext.toLowerCase(),
+        digest: sha256(source),
+        parsePassed: false,
+        errors
+      },
+      execution: null
+    });
+    if (!opts.json) {
+      console.error(`[holoscript] Parse failed \u2014 ${errors[0]?.message ?? "invalid HoloScript"}`);
+    }
+    process.exitCode = 2;
+    return;
+  }
   const ast = parseResult.ast;
   if (opts.debug) {
     console.log(`[holoscript] Parsed ${ast.body?.length || 0} top-level nodes`);
@@ -740,9 +848,44 @@ async function runScript(opts) {
   runTicks(runtime, opts.ticks);
   runtime.stop();
   const stats = runtime.getStats();
-  console.log(
-    `[holoscript] Complete \u2014 ${stats.tickCount} ticks, ${stats.nodesProcessed} nodes processed`
-  );
+  const counters = normalizeRuntimeCounters(stats);
+  const sceneRuntime = runtime;
+  const scene = sceneRuntime.getSceneReceipt?.() ?? {
+    schema: "holoscript-headless-scene-receipt-unavailable-v1",
+    rootId: null,
+    objectCount: 0,
+    objects: []
+  };
+  const stableReceipt = {
+    schema: RUN_RECEIPT_SCHEMA,
+    ok: true,
+    source: {
+      file: path.basename(filePath),
+      extension: ext.toLowerCase(),
+      digest: sha256(source),
+      parsePassed: true,
+      topLevelNodes: ast.body?.length ?? 0
+    },
+    execution: {
+      target: opts.target,
+      profile: profile.name,
+      requestedTicks: opts.ticks,
+      counters,
+      scene,
+      policy: {
+        shellAllowed: opts.allowShell,
+        networkAllowed: opts.allowedHosts.length > 0,
+        allowedPathCount: opts.allowedPaths.length
+      }
+    }
+  };
+  emitRunReceipt(opts, outputPath, stableReceipt);
+  if (!opts.json) {
+    const objectCount = integerStat(scene, "objectCount") ?? 0;
+    console.log(
+      `[holoscript] Complete \u2014 ${counters.tickCount ?? "unknown"} ticks, ${objectCount} scene objects`
+    );
+  }
   if (opts.watch) {
     console.log(`[holoscript] Watching for changes... (Ctrl+C to stop)`);
     const watcher = new HotReloadWatcher({
@@ -758,6 +901,10 @@ async function runScript(opts) {
       try {
         const newSource = fs.readFileSync(filePath, "utf-8");
         const newParseResult = parse(newSource);
+        if (!newParseResult.success || !newParseResult.ast) {
+          const parseError = summarizeRunParseErrors(newParseResult.errors)[0];
+          throw new Error(parseError?.message ?? "invalid HoloScript");
+        }
         const newAst = newParseResult.ast;
         const newRuntime = createHeadlessRuntime(newAst, {
           profile: opts.profile === "headless" ? HEADLESS_PROFILE : getProfile(opts.profile),
@@ -768,9 +915,11 @@ async function runScript(opts) {
         newRuntime.start();
         runTicks(newRuntime, opts.ticks);
         newRuntime.stop();
-        const newStats = newRuntime.getStats();
+        const newStats = normalizeRuntimeCounters(
+          newRuntime.getStats()
+        );
         console.log(
-          `[holoscript] Complete \u2014 ${newStats.tickCount} ticks, ${newStats.nodesProcessed} nodes`
+          `[holoscript] Complete \u2014 ${newStats.tickCount ?? "unknown"} ticks, ${newStats.nodesProcessed ?? "unknown"} nodes`
         );
       } catch (err) {
         console.error(`[holoscript] Error:`, err.message);
@@ -2210,7 +2359,7 @@ function showHelp() {
 HoloScript CLI \u2014 Headless Runner v5.0
 
 Usage:
-  holoscript run <file>     [--target node|python|ros2] [--profile headless|minimal|full] [--ticks <n>] [--daemon] [--debug]
+  holoscript run <file>     [--target node|python|ros2] [--profile headless|minimal|full] [--ticks <n>] [--output <receipt.json>] [--json] [--daemon] [--debug]
   holoscript test <file>    [--debug]
   holoscript compile <file> [--target node|python] [--output <path>] [--enforce-gotchas]
   holoscript deploy <file>  [--share] [--publish] [--price <eth>] [--mint-nft] [--wallet-key <key>] [--author <name>] [--license <type>] [--server <url>]

package/dist/compiler/agent-inference.cjs

@@ -2,30 +2,30 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkYMI3ED3B_cjs = require('../chunk-YMI3ED3B.cjs');
-require('../chunk-SE2Y5BSL.cjs');
+var chunkCRUIGXF7_cjs = require('../chunk-CRUIGXF7.cjs');
+require('../chunk-CMEINO5I.cjs');
 require('../chunk-7FYSSI3C.cjs');
 require('../chunk-CI33NINL.cjs');
 require('../chunk-Q47JEE2C.cjs');
 require('../chunk-ZHPMP447.cjs');
 
-chunkYMI3ED3B_cjs.init_AgentInferenceExportTarget();
+chunkCRUIGXF7_cjs.init_AgentInferenceExportTarget();
 
 Object.defineProperty(exports, "AgentInferenceCompiler", {
   enumerable: true,
-  get: function () { return chunkYMI3ED3B_cjs.AgentInferenceCompiler; }
+  get: function () { return chunkCRUIGXF7_cjs.AgentInferenceCompiler; }
 });
 Object.defineProperty(exports, "createAgentInferenceCompiler", {
   enumerable: true,
-  get: function () { return chunkYMI3ED3B_cjs.createAgentInferenceCompiler; }
+  get: function () { return chunkCRUIGXF7_cjs.createAgentInferenceCompiler; }
 });
 Object.defineProperty(exports, "createPythonAgentInferenceCompiler", {
   enumerable: true,
-  get: function () { return chunkYMI3ED3B_cjs.createPythonAgentInferenceCompiler; }
+  get: function () { return chunkCRUIGXF7_cjs.createPythonAgentInferenceCompiler; }
 });
 Object.defineProperty(exports, "default", {
   enumerable: true,
-  get: function () { return chunkYMI3ED3B_cjs.AgentInferenceExportTarget_default; }
+  get: function () { return chunkCRUIGXF7_cjs.AgentInferenceExportTarget_default; }
 });
 //# sourceMappingURL=agent-inference.cjs.map
 //# sourceMappingURL=agent-inference.cjs.map