@githolon/testing 0.45.0 → 0.47.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@githolon/testing",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "type": "module",
   "description": "@githolon/testing — law TDD for Nomos domains: boot the REAL engine plane in-process (the exact machinery every cloud DO, heavy container and web client runs), dispatch directives, assert rows, assert TYPED REFUSALS, fork for what-ifs — fully offline inside vitest.",
   "license": "SEE LICENSE IN LICENSE.md",

package/vendor/engine/engine.mjs

@@ -129,7 +129,8 @@ export async function createEngine({ wasmModule, bootstrapPkg, nomosPkg, replica
   root.set("ws", new Directory(new Map()));
   const preopen = new PreopenDirectory("/work", root);
   const STDERR = [];
-  const fds = [new OpenFile(new File([])), ConsoleStdout.lineBuffered(() => {}), ConsoleStdout.lineBuffered((l) => STDERR.push(l)), preopen];
+  const pushStderr = (l) => { if (STDERR.length >= 500) STDERR.splice(0, STDERR.length - 499); STDERR.push(l); };
+  const fds = [new OpenFile(new File([])), ConsoleStdout.lineBuffered(() => {}), ConsoleStdout.lineBuffered(pushStderr), preopen];
   const wasi = new WASI(["wasm_git_holon", "reactor"], [], fds, { debug: false });
   const inst = await WebAssembly.instantiate(wasmModule, { wasi_snapshot_preview1: wasi.wasiImport });
   const code = wasi.start(inst);
@@ -1346,6 +1347,16 @@ export function currentLaw(eng, ws) {
   return out.keyMap || {};
 }
 
+/** INSTALLED-LAW META-READ — kernel-folded control-plane state, not tenant projection. */
+export function installedLaw(eng, ws) {
+  return JSON.parse(call(eng.ex, "query", { repoArg: repoArgOf(ws), workspace: ws, queryBytes: b64Json({ op: "installedLaw" }), branch: BRANCH }, eng.STDERR));
+}
+
+/** INSTALLED PACKAGE META-READ — package bytes from folded policy/domain-installation state. */
+export function domainPackage(eng, ws, hash) {
+  return JSON.parse(call(eng.ex, "query", { repoArg: repoArgOf(ws), workspace: ws, queryBytes: b64Json({ op: "domainPackage", hash }), branch: BRANCH }, eng.STDERR));
+}
+
 /** THE CAPABILITY DECLARATION READ (Full-A — capability_marketplace.md §4): the holon
  * surfaces every CURRENTLY-INSTALLED domain's `nomosCapabilities` law key (the impure-
  * capability quartets sealed into the law). The deploy lane relays these as a "declared —
@@ -1955,6 +1966,9 @@ export const count = (eng, ws, countId, groupKey, principal = "") => JSON.parse(
 export const sum = (eng, ws, sumId, groupKey, principal = "") => JSON.parse(call(eng.ex, "query", { repoArg: repoArgOf(ws), workspace: ws, queryBytes: b64Json({ op: "sum", sumId, groupKey }), principal, branch: BRANCH }, eng.STDERR));
 /** The maintained O(1) min/max read (#47). `kind` = "min"|"max"; an absent group answers `value: null`
  *  (never a fabricated 0). Kernel-gated; rides the `query` verb (`op:"extremum"`, `kind` = min/max). */
+/** THE SPATIAL READ (R*Tree probe): rows of the index's of-type intersecting the bbox. Kernel-gated
+ *  like a granular query (a private of-type needs its cap); row shape identical to a declared query. */
+export const spatialWithin = (eng, ws, spatialId, bbox, principal = "") => JSON.parse(call(eng.ex, "query", { repoArg: repoArgOf(ws), workspace: ws, queryBytes: b64Json({ op: "spatial", spatialId, minLng: bbox.minLng, minLat: bbox.minLat, maxLng: bbox.maxLng, maxLat: bbox.maxLat }), principal, branch: BRANCH }, eng.STDERR));
 export const extremum = (eng, ws, extremumId, kind, groupKey, principal = "") => JSON.parse(call(eng.ex, "query", { repoArg: repoArgOf(ws), workspace: ws, queryBytes: b64Json({ op: "extremum", extremumId, kind, groupKey: groupKey ?? "" }), principal, branch: BRANCH }, eng.STDERR));
 // GIT OFF THE HOT PATH: the KERNEL builds the conformant delta packfile (gix-pack); the adapter is dumb
 // plumbing (frames pkt-lines + POSTs). Returns the pack bytes (Uint8Array), or null if the kernel