@amalgm/live 0.2.52 → 0.2.54

package/PURPOSE.md

@@ -181,14 +181,19 @@ its cutover.
     stronger current-content witness exists. Repository packing remains
     transfer preparation and may run beside structural registration, but
     neither act may weaken the other's result.
-30. **Proof travels forward; bytes do not travel backward.** Capture derives
-    and stores a block manifest while it already owns an artifact's bytes.
-    Every ordinary text or binary file enters through the same bounded block
-    stream; no file type or file size permits a complete-file allocation.
-    Cold upload reads those sealed bytes once to send them, and cold download
-    writes received bytes once before their registered adapter consumes them.
-    Reopening a complete artifact to recreate or repeat an earlier integrity
-    proof is redundant work, not additional correctness.
+30. **Proof travels forward; disposable bytes need not.** Registration reads
+    every ordinary text or binary file through one bounded stream to classify
+    it, derive its content head, and retain any block-manifest evidence needed
+    by the later Upload stage. A graph-only Register capture does not copy
+    those same bytes into the machine cache merely to preserve them for
+    Upload. Upload receives one seekable source selected by the host — an
+    already-sealed cache object when one exists, otherwise the registered
+    ground itself — and verifies every byte it sends against the captured
+    content head. A typed source mismatch returns control to Register so it
+    can recapture current ground; stale bytes can never be sealed or
+    published. Download still writes received bytes once before their
+    registered adapter consumes them. No file type or size permits a
+    complete-file allocation in the bounded transfer path.
 31. **A content block is not a round trip.** Text and binary retain independent
     content-addressed block identities. Cold upload may move complete small
     artifacts in bounded cargo waves, while cold upload and download move
@@ -267,6 +272,17 @@ its cutover.
    while its work remains private (`declared` or `prepared`); once revealed,
    the exact visible target must Verify before Apply advances.
 
+42. **The registry graph is immutable pages, and its head is the snapshot.**
+    A page is one root's UUID-sorted records serialized canonically under a
+    fixed byte budget, identified by the hash of its own bytes, and stored as
+    ordinary immutable content. The head names each root's ordered pages and
+    nothing else; its checksum proves the head bytes, never a reassembled
+    record list. A publication rebuilds only roots it walked and carries every
+    other root's committed page list forward byte-identically. The authority
+    verifies every replaced root from its pages and requires unchanged roots
+    to match the committed head exactly. A first head over a records-shaped
+    base pages every root because that base carries no page identities.
+
 ## Five surfaces, one behavior
 
 ```

package/dist/entities/cloud.d.ts

@@ -1,12 +1,19 @@
 /**
  * The entity-cloud boundary's pure half (engine
  * registration/entity-cloud.js): the snapshot codec, record assertions,
- * equality, the private resource id, and the repo travel law — only
- * logical graph facts, never a path, inode, watcher, or database row.
+ * equality, the private resource id, containment selection, and the repo
+ * travel law — only logical graph facts, never a path, inode, watcher, or
+ * database row.
  *
  * Wire parity is the contract here: `stableJson`, record key order, and
  * snapshot sorting reproduce the engine's bytes exactly, so a snapshot
  * packed on either side hashes and compares identically.
+ *
+ * Every ancestor question in this module is answered once per graph, not
+ * once per record. A workspace of ~19,000 entities 32 levels deep re-walks
+ * the same spine for every record it holds, and that is the difference
+ * between a linear pass and a quadratic one. `indexRepositoryTerritory`
+ * (src/detection/territory.ts) memoizes the same shape for the same reason.
  */
 import { type EntityStatus, type EntityType, type Sha256Hex } from './types.js';
 /** `@1` could project arbitrary pre-cloud registrations. `@2` omitted the
@@ -51,10 +58,16 @@ export declare function privateEntityResourceId(userId: string, sha256Hex: Sha25
 /** The one JSON spelling every snapshot comparison and checksum uses. */
 export declare const stableJson: (value: unknown) => string;
 export declare const sameRecord: (left: unknown, right: unknown) => boolean;
-/** Two record lists describe the same graph (normalized, sorted, compared whole). */
-export declare const sameRecords: (left: readonly unknown[], right: readonly unknown[]) => boolean;
-/** Every record in `records` appears byte-identically in `expected`. */
-export declare function recordsAreSubset(records: readonly unknown[], expected: readonly unknown[]): boolean;
+/** Two record lists describe the same graph (normalized, sorted, compared
+ * field by field).
+ *
+ * Comparing the canonical bytes would answer the same question, but it would
+ * spell out both whole graphs to answer one boolean — megabytes of JSON per
+ * call at register scale. `assertRecord` guarantees the equivalence: every
+ * normalized record carries exactly these eight keys in this order, and every
+ * value is `string | null`, never `undefined`. JSON's spelling of a string is
+ * injective, so field-wise equality and byte equality decide identically. */
+export declare function sameRecords(left: readonly unknown[], right: readonly unknown[]): boolean;
 /**
  * Validate one snapshot record and normalize it (UUIDs lowercased,
  * transportVersion defaulted to null). Refusals: an invalid shape; a
@@ -102,6 +115,18 @@ export declare function travelingRecords(records: readonly unknown[], sha256Hex:
 /** Normalize records into the one canonical snapshot: asserted, sorted by
  * uuid, duplicates refused. */
 export declare function snapshotFromRecords(records: readonly unknown[]): CloudSnapshot;
+/** One complete subtree of an already-normalized record list: `rootUuid` and
+ * everything that descends from it, in the order it arrived.
+ *
+ * Containment is reachability down child edges, so it is answered by one
+ * walk over one child index — not by sweeping the whole graph until a fixed
+ * point stops moving. Records sorted by UUID arrive in no useful tree order,
+ * so a sweep adds roughly one level per pass and pays the graph's full depth
+ * in whole-list scans. Reachability is the whole law, exactly as a sweep
+ * decided it: a record in a cycle the root cannot reach stays out, and a
+ * record whose named parent is the root itself stays in even when no record
+ * for that root is present. */
+export declare function containedRecords(records: readonly CloudEntityRecord[], rootUuid: string): readonly CloudEntityRecord[];
 /** Build the complete, self-contained root replacement carried by cold
  * Register. Every declared root must be present, every record must descend
  * from one of those roots inside this same operation, and active slots must

package/dist/entities/cloud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/entities/cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EACnD,MAAM,YAAY,CAAC;AAIpB;;;;;+DAK+D;AAC/D,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAEhE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAK7C;;mCAEmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED;;;2DAG2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAChD;AAED;;iDAEiD;AACjD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAGpF;AAED,yEAAyE;AACzE,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,MAA+B,CAAC;AAE5E,eAAO,MAAM,UAAU,GAAI,MAAM,OAAO,EAAE,OAAO,OAAO,KAAG,OACnB,CAAC;AAEzC,qFAAqF;AACrF,eAAO,MAAM,WAAW,GAAI,MAAM,SAAS,OAAO,EAAE,EAAE,OAAO,SAAS,OAAO,EAAE,KAAG,OACf,CAAC;AAEpE,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAMnG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAqC9D;AAED;qDACqD;AACrD,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,KAC7C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/F;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EACjF,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAYT;AAED;;;;;;;;;;;;;;6CAc6C;AAC7C,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,SAAS,EAAE,SAAS,GACnB,SAAS,iBAAiB,EAAE,CAwC9B;AAED;+BAC+B;AAC/B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,aAAa,CAW9E;AAED;;;;6DAI6D;AAC7D,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,SAAS,OAAO,EAAE,GAC1B,oBAAoB,CAkDtB;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,aAAa,CAavE"}
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/entities/cloud.ts"],"names":[],"mappings":"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"}

package/dist/entities/cloud.js

@@ -1,14 +1,21 @@
 /**
  * The entity-cloud boundary's pure half (engine
  * registration/entity-cloud.js): the snapshot codec, record assertions,
- * equality, the private resource id, and the repo travel law — only
- * logical graph facts, never a path, inode, watcher, or database row.
+ * equality, the private resource id, containment selection, and the repo
+ * travel law — only logical graph facts, never a path, inode, watcher, or
+ * database row.
  *
  * Wire parity is the contract here: `stableJson`, record key order, and
  * snapshot sorting reproduce the engine's bytes exactly, so a snapshot
  * packed on either side hashes and compares identically.
+ *
+ * Every ancestor question in this module is answered once per graph, not
+ * once per record. A workspace of ~19,000 entities 32 levels deep re-walks
+ * the same spine for every record it holds, and that is the difference
+ * between a linear pass and a quadratic one. `indexRepositoryTerritory`
+ * (src/detection/territory.ts) memoizes the same shape for the same reason.
  */
-import { CONTAINERS, DERIVED_PAYLOAD, ROOT_TYPES, TYPES, UUID_PATTERN, } from './types.js';
+import { CONTAINERS, DERIVED_PAYLOAD, ROOT_TYPES, STATUSES, TYPES, UUID_PATTERN, } from './types.js';
 import { bytesToBase64Url, hexToBytes, utf8Decode } from './bytes.js';
 import { canonicalVersion, membershipHash } from './rules.js';
 /** `@1` could project arbitrary pre-cloud registrations. `@2` omitted the
@@ -31,13 +38,32 @@ export function privateEntityResourceId(userId, sha256Hex) {
 /** The one JSON spelling every snapshot comparison and checksum uses. */
 export const stableJson = (value) => JSON.stringify(value);
 export const sameRecord = (left, right) => stableJson(left) === stableJson(right);
-/** Two record lists describe the same graph (normalized, sorted, compared whole). */
-export const sameRecords = (left, right) => sameRecord(snapshotFromRecords(left), snapshotFromRecords(right));
-/** Every record in `records` appears byte-identically in `expected`. */
-export function recordsAreSubset(records, expected) {
-    const expectedByUuid = new Map(snapshotFromRecords(expected).records.map((record) => [record.uuid, record]));
-    return snapshotFromRecords(records).records
-        .every((record) => sameRecord(record, expectedByUuid.get(record.uuid)));
+/** The eight canonical record fields, in the order `assertRecord` emits them. */
+const RECORD_FIELDS = [
+    'uuid', 'type', 'parentUUID', 'name', 'status', 'version', 'payloadVersion', 'transportVersion',
+];
+/** Two record lists describe the same graph (normalized, sorted, compared
+ * field by field).
+ *
+ * Comparing the canonical bytes would answer the same question, but it would
+ * spell out both whole graphs to answer one boolean — megabytes of JSON per
+ * call at register scale. `assertRecord` guarantees the equivalence: every
+ * normalized record carries exactly these eight keys in this order, and every
+ * value is `string | null`, never `undefined`. JSON's spelling of a string is
+ * injective, so field-wise equality and byte equality decide identically. */
+export function sameRecords(left, right) {
+    const ours = snapshotFromRecords(left).records;
+    const theirs = snapshotFromRecords(right).records;
+    if (ours.length !== theirs.length)
+        return false;
+    for (let index = 0; index < ours.length; index += 1) {
+        const mine = ours[index];
+        const yours = theirs[index];
+        for (const field of RECORD_FIELDS)
+            if (mine[field] !== yours[field])
+                return false;
+    }
+    return true;
 }
 /**
  * Validate one snapshot record and normalize it (UUIDs lowercased,
@@ -52,7 +78,7 @@ export function assertRecord(value) {
         || typeof record.type !== 'string' || !TYPES.has(record.type)
         || (record.parentUUID !== null && (typeof record.parentUUID !== 'string' || !UUID_PATTERN.test(record.parentUUID)))
         || typeof record.name !== 'string' || !record.name || record.name.includes('/') || record.name.includes('\0')
-        || !['active', 'trashed', 'deleted'].includes(record.status)
+        || !STATUSES.has(record.status)
         || typeof record.version !== 'string' || !/^[0-9a-f]{64}$/.test(record.version)
         || (record.payloadVersion !== null && typeof record.payloadVersion !== 'string')
         || (record.transportVersion !== undefined && record.transportVersion !== null
@@ -80,6 +106,66 @@ export function assertRecord(value) {
         transportVersion,
     };
 }
+/** A chain that never terminates, so no node on it can name a repository. */
+const CYCLIC_CHAIN = Symbol('cyclic parent chain');
+/**
+ * The repo travel law resolved once per graph. Asking it record by record
+ * re-walks the same spine for every entity the spine holds, which is
+ * quadratic in a deep workspace; the answer only ever depends on where the
+ * walk starts, so one memo serves every asker.
+ *
+ * The memo holds the nearest repository's UUID rather than a boolean because
+ * the naive walk's refusal is asker-dependent: it seeds its `seen` set with
+ * the asking record's own UUID, so a repository that is its own nearest
+ * repository is convicted of a cycle before its type can answer `true`. That
+ * is the single case where a chain-only answer would differ, and comparing
+ * the resolved UUID against the asker restores it exactly.
+ */
+function createRepositoryEnclosure(lookup) {
+    const nearest = new Map();
+    const resolve = (start) => {
+        const walked = [];
+        const walking = new Set();
+        let cursor = start;
+        let answer = null;
+        for (;;) {
+            if (cursor === null || cursor === undefined)
+                break;
+            const memoized = nearest.get(cursor);
+            if (memoized !== undefined) {
+                answer = memoized;
+                break;
+            }
+            if (walking.has(cursor)) {
+                answer = CYCLIC_CHAIN;
+                break;
+            }
+            walking.add(cursor);
+            walked.push(cursor);
+            const node = lookup(cursor);
+            if (!node)
+                break;
+            if (node.type === 'repo.git') {
+                answer = cursor;
+                break;
+            }
+            cursor = node.parentUUID;
+        }
+        for (const uuid of walked)
+            nearest.set(uuid, answer);
+        return answer;
+    };
+    return (record) => {
+        const { parentUUID } = record;
+        if (parentUUID === null || parentUUID === undefined)
+            return false;
+        const repository = resolve(parentUUID);
+        if (repository === CYCLIC_CHAIN || repository === record.uuid) {
+            throw new Error(`cloud entity ${record.uuid} has a cyclic parent chain`);
+        }
+        return repository !== null;
+    };
+}
 /**
  * The repo travel law: a record with a `repo.git` PROPER ancestor never
  * travels to the cloud on its own. The repository is the sync boundary —
@@ -92,20 +178,7 @@ export function assertRecord(value) {
  * silently unsynced entity.
  */
 export function enclosedByRepositoryAncestor(record, lookup) {
-    const seen = new Set([record.uuid]);
-    let parentUUID = record.parentUUID;
-    while (parentUUID !== null && parentUUID !== undefined) {
-        if (seen.has(parentUUID))
-            throw new Error(`cloud entity ${record.uuid} has a cyclic parent chain`);
-        seen.add(parentUUID);
-        const parent = lookup(parentUUID);
-        if (!parent)
-            return false;
-        if (parent.type === 'repo.git')
-            return true;
-        parentUUID = parent.parentUUID;
-    }
-    return false;
+    return createRepositoryEnclosure(lookup)(record);
 }
 /** Project a complete local entity graph onto the cloud registry. Ordinary
  * repository children keep their local SQLite identities inside the nearest
@@ -125,10 +198,16 @@ export function enclosedByRepositoryAncestor(record, lookup) {
 export function travelingRecords(records, sha256Hex) {
     const snapshot = snapshotFromRecords(records);
     const byUuid = new Map(snapshot.records.map((record) => [record.uuid, record]));
-    const traveling = new Set(snapshot.records
-        .filter((record) => !enclosedByRepositoryAncestor(record, (uuid) => byUuid.get(uuid)))
-        .map((record) => record.uuid));
-    for (const repository of snapshot.records.filter((record) => record.type === 'repo.git')) {
+    const encloses = createRepositoryEnclosure((uuid) => byUuid.get(uuid));
+    const repositories = [];
+    const traveling = new Set();
+    for (const record of snapshot.records) {
+        if (record.type === 'repo.git')
+            repositories.push(record);
+        if (!encloses(record))
+            traveling.add(record.uuid);
+    }
+    for (const repository of repositories) {
         let cursor = repository;
         while (cursor) {
             traveling.add(cursor.uuid);
@@ -137,13 +216,20 @@ export function travelingRecords(records, sha256Hex) {
             cursor = byUuid.get(cursor.parentUUID);
         }
     }
-    const narrowed = new Set(snapshot.records
-        .filter((record) => !traveling.has(record.uuid) && record.status === 'active'
-        && record.parentUUID !== null && traveling.has(record.parentUUID))
-        .map((record) => record.parentUUID));
-    const projected = snapshot.records.filter((record) => traveling.has(record.uuid));
+    // The containers that lost active children, the records that survive, and
+    // each survivor's active membership all read the same list — so they read
+    // it once.
+    const narrowed = new Set();
+    const projected = [];
     const activeChildren = new Map();
-    for (const record of projected) {
+    for (const record of snapshot.records) {
+        if (!traveling.has(record.uuid)) {
+            if (record.status === 'active' && record.parentUUID !== null && traveling.has(record.parentUUID)) {
+                narrowed.add(record.parentUUID);
+            }
+            continue;
+        }
+        projected.push(record);
         if (record.status !== 'active' || record.parentUUID === null)
             continue;
         const siblings = activeChildren.get(record.parentUUID);
@@ -170,8 +256,11 @@ export function travelingRecords(records, sha256Hex) {
 export function snapshotFromRecords(records) {
     const normalized = records.map(assertRecord)
         .sort((left, right) => (left.uuid < right.uuid ? -1 : left.uuid > right.uuid ? 1 : 0));
-    if (new Set(normalized.map((record) => record.uuid)).size !== normalized.length) {
-        throw new Error('cloud entity snapshot has duplicate UUIDs');
+    // Sorted, so duplicates are adjacent: no second array and no set to build.
+    for (let index = 1; index < normalized.length; index += 1) {
+        if (normalized[index].uuid === normalized[index - 1].uuid) {
+            throw new Error('cloud entity snapshot has duplicate UUIDs');
+        }
     }
     return {
         schemaVersion: ENTITY_CLOUD_SCHEMA_VERSION,
@@ -179,6 +268,83 @@ export function snapshotFromRecords(records) {
         records: normalized,
     };
 }
+/** One complete subtree of an already-normalized record list: `rootUuid` and
+ * everything that descends from it, in the order it arrived.
+ *
+ * Containment is reachability down child edges, so it is answered by one
+ * walk over one child index — not by sweeping the whole graph until a fixed
+ * point stops moving. Records sorted by UUID arrive in no useful tree order,
+ * so a sweep adds roughly one level per pass and pays the graph's full depth
+ * in whole-list scans. Reachability is the whole law, exactly as a sweep
+ * decided it: a record in a cycle the root cannot reach stays out, and a
+ * record whose named parent is the root itself stays in even when no record
+ * for that root is present. */
+export function containedRecords(records, rootUuid) {
+    const children = new Map();
+    for (const record of records) {
+        if (record.parentUUID === null)
+            continue;
+        const siblings = children.get(record.parentUUID);
+        if (siblings)
+            siblings.push(record);
+        else
+            children.set(record.parentUUID, [record]);
+    }
+    const included = new Set([rootUuid]);
+    const frontier = [rootUuid];
+    while (frontier.length > 0) {
+        for (const child of children.get(frontier.pop()) ?? []) {
+            if (included.has(child.uuid))
+                continue;
+            included.add(child.uuid);
+            frontier.push(child.uuid);
+        }
+    }
+    return records.filter((record) => included.has(record.uuid));
+}
+/** The two ways a record's climb to a root can fail. */
+const PARENT_CYCLE = Symbol('parent cycle');
+const INCOMPLETE_ANCESTRY = Symbol('incomplete ancestry');
+/** Answer "which root is above this record" once per node instead of once
+ * per record. Unlike the enclosure walk this one starts its cycle set empty,
+ * so the answer is already a pure function of where the climb begins: every
+ * node the climb crosses shares the answer it lands on, faults included —
+ * a node leading into a cycle can only ever lead into that cycle. */
+function createRootResolver(byUuid) {
+    const ancestry = new Map();
+    return (record) => {
+        const walked = [];
+        const walking = new Set();
+        let cursor = record;
+        let answer;
+        for (;;) {
+            const memoized = ancestry.get(cursor.uuid);
+            if (memoized !== undefined) {
+                answer = memoized;
+                break;
+            }
+            if (cursor.parentUUID === null) {
+                answer = cursor.uuid;
+                break;
+            }
+            if (walking.has(cursor.uuid)) {
+                answer = PARENT_CYCLE;
+                break;
+            }
+            walking.add(cursor.uuid);
+            walked.push(cursor.uuid);
+            const parent = byUuid.get(cursor.parentUUID);
+            if (!parent) {
+                answer = INCOMPLETE_ANCESTRY;
+                break;
+            }
+            cursor = parent;
+        }
+        for (const uuid of walked)
+            ancestry.set(uuid, answer);
+        return answer;
+    };
+}
 /** Build the complete, self-contained root replacement carried by cold
  * Register. Every declared root must be present, every record must descend
  * from one of those roots inside this same operation, and active slots must
@@ -206,6 +372,7 @@ export function rootReplacementFromRecords(rootIds, records) {
         || actual.some((rootId, index) => rootId !== normalizedRoots[index])) {
         throw new Error('cloud root replacement records do not exactly match its roots');
     }
+    const ancestryOf = createRootResolver(byUuid);
     const activeSlots = new Set();
     for (const record of snapshot.records) {
         if (record.parentUUID !== null) {
@@ -220,17 +387,13 @@ export function rootReplacementFromRecords(rootIds, records) {
                 activeSlots.add(slot);
             }
         }
-        const seen = new Set();
-        let cursor = record;
-        while (cursor.parentUUID !== null) {
-            if (seen.has(cursor.uuid))
-                throw new Error('cloud root replacement has a parent cycle');
-            seen.add(cursor.uuid);
-            cursor = byUuid.get(cursor.parentUUID);
-            if (!cursor)
-                throw new Error(`cloud root replacement entity ${record.uuid} has incomplete ancestry`);
+        const ancestry = ancestryOf(record);
+        if (ancestry === PARENT_CYCLE)
+            throw new Error('cloud root replacement has a parent cycle');
+        if (ancestry === INCOMPLETE_ANCESTRY) {
+            throw new Error(`cloud root replacement entity ${record.uuid} has incomplete ancestry`);
         }
-        if (!declared.has(cursor.uuid)) {
+        if (!declared.has(ancestry)) {
             throw new Error(`cloud root replacement entity ${record.uuid} is outside its declared roots`);
         }
     }

package/dist/entities/cloud.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloud.js","sourceRoot":"","sources":["../../src/entities/cloud.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloud.js","sourceRoot":"","sources":["../../src/entities/cloud.ts"],"names":[],"mappings":"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"}

package/dist/entities/graph-head.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Immutable graph pages and the committed graph head.
+ *
+ * The registry resource is only ever written by Register, and Register
+ * always replaces whole roots. So the immutable unit of graph publication
+ * is the root subtree: each root's canonical records split into
+ * content-addressed pages, and the whole graph named by one small head —
+ * sorted roots, each listing its ordered pages. Publishing a workspace
+ * uploads that workspace's pages and commits a head that names every other
+ * root's pages unchanged; nothing about an untouched root is rebuilt,
+ * serialized, journaled, or transmitted.
+ *
+ * Laws:
+ * - Page bytes are the canonical JSON array of a contiguous uuid-sorted
+ *   slice of one root's records; the page's identity is the SHA-256 of
+ *   those exact bytes.
+ * - Pagination is canonical: the same records always split into the same
+ *   pages (`pagesForRoot`), so two machines paging one root agree
+ *   byte-for-byte and an unchanged root is provable by page-list identity.
+ * - The head is total: it names every root of the graph. Its checksum,
+ *   `sha256(stableJson(head))`, is the graph's snapshot checksum.
+ * - Assembly re-proves everything it accepts: page hashes, root-subtree
+ *   laws (via `rootReplacementFromRecords`), and canonical pagination.
+ */
+import { type Sha256Hex } from './types.js';
+import { type CloudEntityRecord } from './cloud.js';
+/** Byte budget one page targets. A single record larger than the budget
+ * still travels as its own page: the budget bounds waste, never validity. */
+export declare const GRAPH_PAGE_BYTES: number;
+export declare const GRAPH_HEAD_KIND = "amalgm-entity-registry-head";
+export declare const GRAPH_HEAD_OPERATION_KIND = "entity.graph.head";
+/** One immutable page: identity, size, and how many records it carries. */
+export interface GraphPageRef {
+    readonly sha256: string;
+    readonly bytes: number;
+    readonly records: number;
+}
+/** One root of the committed graph and its ordered pages. */
+export interface GraphHeadRoot {
+    readonly rootId: string;
+    readonly pages: readonly GraphPageRef[];
+}
+/** The committed graph head: the total graph as sorted roots over
+ * immutable pages. This exact value, canonically serialized, is the
+ * authority's stored snapshot and the input to the graph checksum. */
+export interface CloudGraphHead {
+    readonly schemaVersion: number;
+    readonly kind: typeof GRAPH_HEAD_KIND;
+    readonly roots: readonly GraphHeadRoot[];
+}
+/** One atomic head commit: the complete new head plus the roots whose
+ * pages the publisher rebuilt. Every root outside `replacedRootIds` must
+ * carry page lists identical to the authority's current head — the
+ * structural proof the publisher folded on the base it claims. A replaced
+ * root absent from the head is a root deletion. */
+export interface CloudGraphHeadReplacement {
+    readonly kind: typeof GRAPH_HEAD_OPERATION_KIND;
+    readonly head: CloudGraphHead;
+    readonly replacedRootIds: readonly string[];
+}
+/** A page with its proof and its parsed records. */
+export interface GraphPage {
+    readonly ref: GraphPageRef;
+    readonly bytes: Uint8Array;
+    readonly records: readonly CloudEntityRecord[];
+}
+/** Split one complete root subtree into its canonical pages. The records
+ * must be exactly the subtree — the same law `entity.roots.replace`
+ * enforced — so every page set that exists is lawful by construction. */
+export declare function pagesForRoot(rootId: string, records: readonly unknown[], sha256Hex: Sha256Hex): readonly GraphPage[];
+/** Group a record list by the root each record descends from, every group
+ * uuid-sorted. A record no root reaches down child edges — an orphan or a
+ * cycle — refuses the graph rather than silently dropping out of it. */
+export declare function recordsByRoot(records: readonly unknown[]): ReadonlyMap<string, readonly CloudEntityRecord[]>;
+/** Build the canonical head from per-root page lists: roots validated,
+ * sorted, duplicates refused; every root carries at least one page
+ * because every root holds at least its own record. */
+export declare function graphHeadFromRootPages(roots: readonly {
+    readonly rootId: string;
+    readonly pages: readonly GraphPageRef[];
+}[]): CloudGraphHead;
+/** The graph's snapshot checksum: the SHA-256 of the head's canonical
+ * serialization. Unchanged roots contribute only their page identities,
+ * so the checksum never requires materializing their records. */
+export declare function graphHeadChecksum(head: CloudGraphHead, sha256Hex: Sha256Hex): string;
+/** Parse head bytes (or their UTF-8 text) back into the canonical form. */
+export declare function parseGraphHead(bytes: Uint8Array | string): CloudGraphHead;
+/** Two page lists name the same immutable pages in the same order. */
+export declare function sameRootPages(left: readonly GraphPageRef[], right: readonly GraphPageRef[]): boolean;
+/** Re-prove one root from its page bytes: every page's hash, size, and
+ * count; the complete subtree laws; and canonical pagination, so a lawful
+ * but differently-split page set is refused rather than cached as a
+ * second spelling of the same root. Returns the root's uuid-sorted
+ * records. */
+export declare function assembleRootRecords(rootId: string, refs: readonly GraphPageRef[], pages: readonly Uint8Array[], sha256Hex: Sha256Hex): readonly CloudEntityRecord[];
+/** Build the atomic head-commit operation. */
+export declare function graphHeadReplacement(head: CloudGraphHead, replacedRootIds: readonly string[]): CloudGraphHeadReplacement;
+/** Page every root of a complete record list — the transition from a
+ * records-shape snapshot to its head, and the shape of a first
+ * publication that must name the whole account. */
+export declare function graphHeadFromSnapshotRecords(records: readonly unknown[], sha256Hex: Sha256Hex): {
+    readonly head: CloudGraphHead;
+    readonly pages: readonly GraphPage[];
+};
+/** Materialize the complete graph a head names, reading each page's bytes
+ * through `readPage`. Every root is re-proved on the way in; the result is
+ * the canonical whole-graph record list. */
+export declare function recordsFromHead(head: CloudGraphHead, readPage: (ref: GraphPageRef) => Uint8Array, sha256Hex: Sha256Hex): readonly CloudEntityRecord[];
+//# sourceMappingURL=graph-head.d.ts.map

package/dist/entities/graph-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-head.d.ts","sourceRoot":"","sources":["../../src/entities/graph-head.ts"],"names":[],"mappings":"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"}