@githolon/testing 0.15.0 → 0.16.0

package/vendor/engine/git-fs.mjs

@@ -1,4 +1,8 @@
-// AUTO-SYNCED from cloud/holon-host/src/git-fs.mjs by testing/build.mjs — DO NOT EDIT HERE.
+// AUTO-SYNCED from adapter/git-fs.mjs by testing/build.mjs — DO NOT EDIT HERE.
+// CANONICAL SHARED ADAPTER PRIMITIVE (OFFER_KERNEL_ARCHITECTURE.dot — the one adapter). Imported by
+// BOTH the client (cloud/web-client) and the cloud shell (cloud/cloudflare-shell); deploy.sh syncs it into the
+// container build context. Do NOT fork a per-platform copy — drift here is exactly the platform-specific
+// surface the one-adapter consolidation removes.
 // An isomorphic-git fs adapter over a @bjorn3/browser_wasi_shim PreopenDirectory tree.
 //
 // This is what lets the DO push/fetch the EXACT same in-memory git repo that the holon's gix

package/vendor/engine/tree.mjs

@@ -1,8 +1,13 @@
-// AUTO-SYNCED from cloud/holon-host/src/tree.mjs by testing/build.mjs — DO NOT EDIT HERE.
-// /work tree ⇄ flat manifest bytes — the decoupled twin of opfs_tree.mjs (serialize/deserialize
-// only, no OPFS I/O). On the edge the manifest bytes round-trip through R2 instead of an OPFS
-// SyncAccessHandle. Byte format is identical to opfs_tree.mjs so a snapshot is portable between
-// the browser holon and the edge holon:
+// AUTO-SYNCED from adapter/tree.mjs by testing/build.mjs — DO NOT EDIT HERE.
+// CANONICAL SHARED ADAPTER PRIMITIVE (OFFER_KERNEL_ARCHITECTURE.dot — the one adapter). Imported by
+// BOTH the client (cloud/web-client) and the cloud shell (cloud/cloudflare-shell); deploy.sh syncs it into the
+// container build context. Do NOT fork a per-platform copy — drift here is exactly the platform-specific
+// surface the one-adapter consolidation removes.
+// /work tree ⇄ flat manifest bytes — the client twin of cloud/cloudflare-shell/src/tree.mjs.
+// Used by holon.export() / connect({ restoreFrom }) to persist the workspace directory
+// (the bare nomos.git + manifests) across page loads / devices. Byte format is IDENTICAL
+// to the edge serializer, so a snapshot is portable between the browser holon and the
+// edge holon:
 //   [u32 count] then per entry: [u8 isDir][u32 pathLen][path][u32 byteLen][bytes]
 const enc = new TextEncoder();
 const dec = new TextDecoder();
@@ -44,8 +49,10 @@ export function serializeTree(workTree) {
   return out;
 }
 
+/** Returns a `Map<name, File|Directory>` — the `contents` of the deserialized root. */
 export function deserializeTree(bytes, { File, Directory }) {
-  const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const u8 = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+  const dv = new DataView(u8.buffer, u8.byteOffset, u8.byteLength);
   let off = 0;
   const count = dv.getUint32(off, true); off += 4;
   const root = new Directory(new Map());
@@ -53,8 +60,8 @@ export function deserializeTree(bytes, { File, Directory }) {
     const isDir = dv.getUint8(off); off += 1;
     const pathLen = dv.getUint32(off, true); off += 4;
     const byteLen = dv.getUint32(off, true); off += 4;
-    const path = dec.decode(bytes.subarray(off, off + pathLen)); off += pathLen;
-    const body = bytes.subarray(off, off + byteLen); off += byteLen;
+    const path = dec.decode(u8.subarray(off, off + pathLen)); off += pathLen;
+    const body = u8.subarray(off, off + byteLen); off += byteLen;
     const parts = path.split("/");
     let cur = root;
     for (let p = 0; p < parts.length - 1; p++) {