@githolon/testing 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@githolon/testing",
-  "version": "0.6.0",
+  "version": "0.7.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

@@ -1190,7 +1190,7 @@ export function author(eng, ws, domain, directiveId, payload, controllerHash, op
   // (`warmEngine`, which every host already calls) flushes it eagerly. Pass
   // `opts.deferProjection: false` to keep the pre-#47 synchronous refresh.
   const defer = opts.deferProjection !== false;
-  const res = JSON.parse(call(eng.ex, "author", { repoArg: repoArgOf(ws), workspace: ws, domain, directiveId, payloadFile: `/work/payload-${seq}.json`, envelopeFile: `/work/envelope-${seq}.json`, seq, actor: "", domainFile: genesis ? "/work/domain.package.usda" : "", domainHash: genesis ? "" : controllerHash, branch: BRANCH, ...(defer ? { deferProjection: true } : {}) }, eng.STDERR));
+  const res = JSON.parse(call(eng.ex, "author", { repoArg: repoArgOf(ws), workspace: ws, domain, directiveId, payloadFile: `/work/payload-${seq}.json`, envelopeFile: `/work/envelope-${seq}.json`, seq, actor: opts.actor ?? "", domainFile: genesis ? "/work/domain.package.usda" : "", domainHash: genesis ? "" : controllerHash, branch: BRANCH, ...(defer ? { deferProjection: true } : {}) }, eng.STDERR));
   if (defer && res.ok) (eng.pendingProjection ??= new Set()).add(ws);
   return res;
 }
@@ -1208,6 +1208,25 @@ export function flushDeferredProjections(eng) {
   if (eng.pendingProjection) eng.pendingProjection.clear();
 }
 
+// ── PROJECTION CHECKPOINT (the cold-fold fix) ──────────────────────────────────────────────
+// A `:memory:` projection is rebuilt cold on every mount → a long-chain workspace (root, every
+// workspace's governance hub) re-folds genesis→tip = O(chain) (14s at 1105 commits, and it OOMs
+// the DO under load). The checkpoint persists the folded projection (cursor + every table) so a
+// cold mount RESTORES it and the first read folds only tip−cursor (O(delta)).
+
+/** Export `ws`'s projection-at-head to a base64 blob the HOST persists. Returns
+ *  `{cursor, blob, bytes}` (or `{empty:true}` for an unborn branch). */
+export function exportCheckpoint(eng, ws) {
+  return JSON.parse(call(eng.ex, "checkpoint_export", { repoArg: repoArgOf(ws), workspace: ws, branch: BRANCH }, eng.STDERR));
+}
+
+/** Restore a checkpoint blob into the pool BEFORE the first read on a cold mount (no-op if the pool
+ *  is already warm). The HOST restores ONLY a blob whose stored lawHash matches the workspace's
+ *  CURRENT law (schema parity); a mismatched/absent blob costs at most a cold fold, never a wrong read. */
+export function importCheckpoint(eng, ws, blobB64) {
+  return JSON.parse(call(eng.ex, "checkpoint_import", { repoArg: repoArgOf(ws), workspace: ws, branch: BRANCH, blob: blobB64 }, eng.STDERR));
+}
+
 // DURABILITY-BEFORE-ACK: only acked once the write LANDED in the ledger; a failed push
 // unmounts (drops local state) so the next access re-restores from custody.
 export async function commitAndPush(eng, ws, ledger) {