@githolon/testing 0.48.0 → 0.49.0

package/package.json

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

@@ -1992,16 +1992,21 @@ export function packDelta(eng, ws, base, head) {
 // pack of all reachable from main (fresh clone); `base` = the client's known head ⇒ the incremental delta.
 // The kernel resolves main itself. Returns `{ packB64, bytes }` (base64 so it rides the container JSON op).
 export function servePack(eng, ws, base = "") {
+  // `head`: the tip this pack reaches (resolved BEFORE packing, so it can only under-state, never
+  // over-state, what the pack contains) — the cache-coherence anchor for the worker's short-TTL pack
+  // cache: a cached pack is reusable ONLY while main still points at the head it was built from.
+  let head = null;
+  try { head = kgit.resolveRef(eng, gitdirOf(ws), BRANCH); } catch { /* diagnostics only */ }
   let r;
   try {
     r = JSON.parse(call(eng.ex, "pack_delta", { repoArg: repoArgOf(ws), workspace: ws, base, branch: BRANCH }, eng.STDERR));
   } catch (e) {
     // UP TO DATE: the client's `have` already IS main → nothing to send. A clean empty response, not an error.
-    if (/nothing to pack|head == base/.test(String(e))) return { packB64: "", bytes: 0, upToDate: true };
+    if (/nothing to pack|head == base/.test(String(e))) return { packB64: "", bytes: 0, upToDate: true, ...(head ? { head } : {}) };
     throw e;
   }
   if (!r || r.ok !== true || typeof r.packB64 !== "string") throw new Error("servePack: kernel produced no pack");
-  return { packB64: r.packB64, bytes: r.bytes };
+  return { packB64: r.packB64, bytes: r.bytes, ...(head ? { head } : {}) };
 }
 
 // ── G3 COLD-STORAGE: SURFACE THE BORN CHILD'S CUSTODY BYTES (the host-bailiff persist lane) ──────────────