@its-not-rocket-science/ananke 0.1.13 → 0.1.15

package/dist/src/wasm-kernel.js

@@ -0,0 +1,96 @@
+// src/wasm-kernel.ts — Node.js loader and host bridge for the AssemblyScript WASM modules.
+//
+// Provides a shadow-mode step that runs as/push.wasm + as/injury.wasm alongside the
+// TypeScript kernel.  In shadow mode the WASM outputs are NOT applied to world state;
+// they are returned for the caller to log or validate.
+//
+// Usage:
+//   const kernel = await loadWasmKernel();       // once at startup
+//   const report = kernel.shadowStep(world);     // after stepWorld() each tick
+//   console.log(report.summary);
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { SCALE } from "./units.js";
+// ── Region order shared with as/injury.ts ─────────────────────────────────────
+const REGION_ORDER = ["head", "torso", "leftArm", "rightArm", "leftLeg", "rightLeg"];
+// ── Kernel class ──────────────────────────────────────────────────────────────
+export class WasmKernel {
+    push;
+    injury;
+    // Canonical kernel push tuning (mirrors src/sim/kernel.ts)
+    static PUSH_RADIUS_M = Math.trunc(0.45 * SCALE.m); // 4500
+    static PUSH_REPEL_MPS2 = Math.trunc(1.5 * SCALE.mps2); // 15000
+    constructor(push, injury) {
+        this.push = push;
+        this.injury = injury;
+    }
+    /**
+     * Run WASM push + injury steps on the current world state (shadow mode — does not
+     * mutate world).  Returns a per-entity report and a one-line summary string.
+     *
+     * Call this after stepWorld() each tick for validation / diagnostics.
+     */
+    shadowStep(world, tick) {
+        const entities = world.entities;
+        const pushMax = this.push.MAX_ENTITIES.value;
+        const injMax = this.injury.MAX_ENTITIES.value;
+        const n = Math.min(entities.length, pushMax, injMax);
+        // ── Push pass (position-based repulsion) ──────────────────────────────────
+        for (let i = 0; i < n; i++) {
+            const e = entities[i];
+            this.push.writeEntity(i, e.position_m.x, e.position_m.y, e.injury.dead ? 0 : 1);
+        }
+        this.push.stepRepulsionPairs(n, WasmKernel.PUSH_RADIUS_M, WasmKernel.PUSH_REPEL_MPS2);
+        // ── Injury pass (clotting / bleed / shock / consciousness) ────────────────
+        for (let i = 0; i < n; i++) {
+            const e = entities[i];
+            const suff = e.condition["suffocation"] ?? 0;
+            this.injury.writeVitals(i, e.injury.fluidLoss, e.injury.shock, e.injury.consciousness, e.injury.dead ? 1 : 0, e.energy.fatigue, suff);
+            for (let r = 0; r < REGION_ORDER.length; r++) {
+                const reg = e.injury.byRegion[REGION_ORDER[r]];
+                this.injury.writeRegion(i, r, reg?.bleedingRate ?? 0, reg?.structuralDamage ?? 0, reg?.internalDamage ?? 0, reg?.["surfaceDamage"] ?? 0);
+            }
+        }
+        this.injury.stepBleedAndShock(n);
+        // ── Build report ──────────────────────────────────────────────────────────
+        const reports = [];
+        for (let i = 0; i < n; i++) {
+            const e = entities[i];
+            reports.push({
+                entityId: e.id,
+                pushDvX: this.push.readDvX(i),
+                pushDvY: this.push.readDvY(i),
+                projFluidLoss: this.injury.readFluidLoss(i),
+                projShock: this.injury.readShock(i),
+                projConsciousness: this.injury.readConsciousness(i),
+                projDead: this.injury.readDead(i) === 1,
+            });
+        }
+        const summary = reports
+            .map(r => `e${r.entityId} dv=(${r.pushDvX},${r.pushDvY}) ` +
+            `fl=${(r.projFluidLoss / SCALE.Q).toFixed(3)} ` +
+            `sh=${(r.projShock / SCALE.Q).toFixed(3)} ` +
+            `co=${(r.projConsciousness / SCALE.Q).toFixed(3)}` +
+            (r.projDead ? " DEAD" : ""))
+            .join(" | ");
+        return { tick, entities: reports, ok: true, summary: `[wasm] tick ${tick}: ${summary}` };
+    }
+}
+// ── Factory ───────────────────────────────────────────────────────────────────
+/**
+ * Load push.wasm and injury.wasm from dist/as/ (co-located with this compiled module)
+ * and return a WasmKernel ready for use.
+ *
+ * Throws if the WASM files are not found (e.g. npm run build:wasm:all not yet run).
+ */
+export async function loadWasmKernel() {
+    // Compiled to dist/src/wasm-kernel.js → WASM files are at ../as/*.wasm
+    const base = new URL("../as/", import.meta.url);
+    const pushBuf = readFileSync(fileURLToPath(new URL("push.wasm", base)));
+    const injuryBuf = readFileSync(fileURLToPath(new URL("injury.wasm", base)));
+    const [pushResult, injuryResult] = await Promise.all([
+        WebAssembly.instantiate(pushBuf),
+        WebAssembly.instantiate(injuryBuf),
+    ]);
+    return new WasmKernel(pushResult.instance.exports, injuryResult.instance.exports);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -54,10 +54,15 @@
     "./competence": {
       "import": "./dist/src/competence/index.js",
       "types": "./dist/src/competence/index.d.ts"
+    },
+    "./wasm-kernel": {
+      "import": "./dist/src/wasm-kernel.js",
+      "types": "./dist/src/wasm-kernel.d.ts"
     }
   },
   "files": [
     "dist/src",
+    "dist/as",
     "docs/project-overview.md",
     "docs/host-contract.md",
     "docs/integration-primer.md",
@@ -118,12 +123,19 @@
     "benchmark-check:strict": "node dist/tools/benchmark-check.js --threshold=0.10",
     "benchmark-check:update": "node dist/tools/benchmark-check.js --update-baseline",
     "benchmark:guide": "node dist/tools/benchmark-guide.js",
-    "benchmark:parallel": "node dist/tools/benchmark-parallel.js"
+    "benchmark:parallel": "node dist/tools/benchmark-parallel.js",
+    "run:renderer-bridge": "node dist/tools/renderer-bridge.js",
+    "build:wasm": "asc as/units.ts --outFile dist/as/units.wasm --textFile dist/as/units.wat --runtime stub --optimize",
+    "build:wasm:push": "asc as/push.ts --outFile dist/as/push.wasm --textFile dist/as/push.wat --runtime stub --optimize --initialMemory 1",
+    "build:wasm:injury": "asc as/injury.ts --outFile dist/as/injury.wasm --textFile dist/as/injury.wat --runtime stub --optimize --initialMemory 1",
+    "build:wasm:all": "npm run build:wasm && npm run build:wasm:push && npm run build:wasm:injury",
+    "test:wasm": "npm run build:wasm:all && vitest run test/as/"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.3",
     "@types/node": "^20.0.0",
     "@vitest/coverage-v8": "^2.1.8",
+    "assemblyscript": "^0.27.37",
     "eslint": "^9.39.3",
     "fast-check": "^4.6.0",
     "typescript": "^5.5.4",