@amalgm/live 0.2.53 → 0.2.55

package/dist/transfer/cargo.d.ts

@@ -1,26 +1,60 @@
 /**
- * Cargo waves — cold transport of many complete small artifacts.
+ * Cargo stream — cold transport of many complete small artifacts.
  *
  * A register journey moves file counts, not just bytes: tens of thousands
  * of small artifacts whose per-artifact negotiation frames would dwarf the
- * payload. A wave carries whole artifacts — every chunk and the manifest
- * identity — so the frame count scales with bytes moved, never with file
- * count. Only artifacts at or below the wave byte bound ride waves; larger
- * artifacts keep per-artifact transfer where chunk reuse pays.
+ * payload. The set streams as self-contained segments. Each segment carries
+ * whole artifacts — every chunk and the manifest identity — so the frame
+ * count scales with bytes moved, never with file count. Segments flow
+ * through one bounded window and never wait on one another's durability
+ * acknowledgements; the authority verifies and seals each segment
+ * independently, so an interruption loses only unacknowledged segments and
+ * a rerun resumes from the sealed inventory. Only artifacts at or below the
+ * segment byte bound ride the stream; larger artifacts keep per-artifact
+ * transfer where chunk reuse pays.
  */
-export declare const CARGO_WAVE_BYTES: number;
+export declare const CARGO_SEGMENT_BYTES: number;
 /** Bounded by the 64KiB binary-frame header law: every artifact declaration
  * (content hash, bytes, chunk list) rides the JSON header, and 256 worst-case
  * declarations stay under the bound with margin. The byte bound, not this
- * count, decides the wave tally on real grounds. */
-export declare const CARGO_WAVE_ARTIFACTS = 256;
-export interface CargoWaveItem {
+ * count, decides the segment tally on real grounds. */
+export declare const CARGO_SEGMENT_ARTIFACTS = 256;
+/** Four full segments may be in flight at once. The window keeps the wire
+ * busy while earlier segments await the authority's per-segment durability
+ * fan-out, and worst-case payload residency (plaintext plus one encoded
+ * copy per in-flight segment) stays comfortably inside a 1-GiB runtime. */
+export declare const CARGO_STREAM_IN_FLIGHT_BYTES: number;
+export interface CargoItem {
+    /** Artifact identity the authority must acknowledge sealing. */
+    readonly contentHash: string;
+    /** Exact byte count of the complete artifact. */
     readonly bytes: number;
 }
-export interface CargoWave<T extends CargoWaveItem> {
+export interface CargoSegment<T extends CargoItem> {
     readonly items: readonly T[];
     readonly bytes: number;
 }
-/** Pack items in order into waves within the byte and artifact bounds. */
-export declare function planCargoWaves<T extends CargoWaveItem>(items: readonly T[]): readonly CargoWave<T>[];
+export interface CargoStreamPorts<T extends CargoItem> {
+    /** Transmit one self-contained segment and return the content hashes the
+     * authority sealed for it. Resolving means every returned artifact is
+     * durable; segments share nothing, so the port may be called for a later
+     * segment while earlier acknowledgements are still outstanding. */
+    send(segment: CargoSegment<T>): Promise<readonly string[]>;
+}
+export interface CargoStreamOptions {
+    readonly lanes?: number;
+    readonly maxInFlightBytes?: number;
+}
+export interface CargoStreamReceipt {
+    readonly segments: number;
+    readonly artifacts: number;
+    readonly bytes: number;
+}
+/** Pack items in order into segments within the byte and artifact bounds. */
+export declare function planCargoSegments<T extends CargoItem>(items: readonly T[]): readonly CargoSegment<T>[];
+/** Stream one cold set of small artifacts as bounded pipelined segments.
+ * Every item must come back sealed or the stream fails; a failure stops new
+ * admission, lets in-flight segments settle, and leaves their sealed work
+ * durable for the resuming rerun. */
+export declare function streamCargo<T extends CargoItem>(items: readonly T[], ports: CargoStreamPorts<T>, options?: CargoStreamOptions): Promise<CargoStreamReceipt>;
 //# sourceMappingURL=cargo.d.ts.map

package/dist/transfer/cargo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cargo.d.ts","sourceRoot":"","sources":["../../src/transfer/cargo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,gBAAgB,QAA4B,CAAC;AAC1D;;;oDAGoD;AACpD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,aAAa;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EACpD,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAsBzB"}
+{"version":3,"file":"cargo.d.ts","sourceRoot":"","sources":["../../src/transfer/cargo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,eAAO,MAAM,mBAAmB,QAA4B,CAAC;AAC7D;;;uDAGuD;AACvD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C;;;2EAG2E;AAC3E,eAAO,MAAM,4BAA4B,QAA0B,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,SAAS;IACnD;;;uEAGmE;IACnE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EACnD,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,CAyB5B;AAED;;;qCAGqC;AACrC,wBAAsB,WAAW,CAAC,CAAC,SAAS,SAAS,EACnD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC1B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAqB7B"}

package/dist/transfer/cargo.js

@@ -1,35 +1,49 @@
 /**
- * Cargo waves — cold transport of many complete small artifacts.
+ * Cargo stream — cold transport of many complete small artifacts.
  *
  * A register journey moves file counts, not just bytes: tens of thousands
  * of small artifacts whose per-artifact negotiation frames would dwarf the
- * payload. A wave carries whole artifacts — every chunk and the manifest
- * identity — so the frame count scales with bytes moved, never with file
- * count. Only artifacts at or below the wave byte bound ride waves; larger
- * artifacts keep per-artifact transfer where chunk reuse pays.
+ * payload. The set streams as self-contained segments. Each segment carries
+ * whole artifacts — every chunk and the manifest identity — so the frame
+ * count scales with bytes moved, never with file count. Segments flow
+ * through one bounded window and never wait on one another's durability
+ * acknowledgements; the authority verifies and seals each segment
+ * independently, so an interruption loses only unacknowledged segments and
+ * a rerun resumes from the sealed inventory. Only artifacts at or below the
+ * segment byte bound ride the stream; larger artifacts keep per-artifact
+ * transfer where chunk reuse pays.
  */
 import { FILE_TRANSFER_BATCH_BYTES } from './batches.js';
-export const CARGO_WAVE_BYTES = FILE_TRANSFER_BATCH_BYTES;
+import { DEFAULT_TRANSFER_CONCURRENCY, weightedParallelForEach } from './parallel.js';
+export const CARGO_SEGMENT_BYTES = FILE_TRANSFER_BATCH_BYTES;
 /** Bounded by the 64KiB binary-frame header law: every artifact declaration
  * (content hash, bytes, chunk list) rides the JSON header, and 256 worst-case
  * declarations stay under the bound with margin. The byte bound, not this
- * count, decides the wave tally on real grounds. */
-export const CARGO_WAVE_ARTIFACTS = 256;
-/** Pack items in order into waves within the byte and artifact bounds. */
-export function planCargoWaves(items) {
-    const waves = [];
+ * count, decides the segment tally on real grounds. */
+export const CARGO_SEGMENT_ARTIFACTS = 256;
+/** Four full segments may be in flight at once. The window keeps the wire
+ * busy while earlier segments await the authority's per-segment durability
+ * fan-out, and worst-case payload residency (plaintext plus one encoded
+ * copy per in-flight segment) stays comfortably inside a 1-GiB runtime. */
+export const CARGO_STREAM_IN_FLIGHT_BYTES = 4 * CARGO_SEGMENT_BYTES;
+/** Pack items in order into segments within the byte and artifact bounds. */
+export function planCargoSegments(items) {
+    const segments = [];
     let current = [];
     let bytes = 0;
     for (const item of items) {
+        if (typeof item.contentHash !== 'string' || item.contentHash.length === 0) {
+            throw new Error('cargo item is missing its content identity');
+        }
         if (!Number.isSafeInteger(item.bytes) || item.bytes < 0) {
-            throw new Error('cargo wave item byte count is invalid');
+            throw new Error('cargo item byte count is invalid');
         }
-        if (item.bytes > CARGO_WAVE_BYTES) {
-            throw new Error('cargo wave item exceeds the wave byte bound');
+        if (item.bytes > CARGO_SEGMENT_BYTES) {
+            throw new Error('cargo item exceeds the segment byte bound');
         }
         if (current.length > 0
-            && (bytes + item.bytes > CARGO_WAVE_BYTES || current.length >= CARGO_WAVE_ARTIFACTS)) {
-            waves.push({ items: current, bytes });
+            && (bytes + item.bytes > CARGO_SEGMENT_BYTES || current.length >= CARGO_SEGMENT_ARTIFACTS)) {
+            segments.push({ items: current, bytes });
             current = [];
             bytes = 0;
         }
@@ -37,7 +51,27 @@ export function planCargoWaves(items) {
         bytes += item.bytes;
     }
     if (current.length > 0)
-        waves.push({ items: current, bytes });
-    return waves;
+        segments.push({ items: current, bytes });
+    return segments;
+}
+/** Stream one cold set of small artifacts as bounded pipelined segments.
+ * Every item must come back sealed or the stream fails; a failure stops new
+ * admission, lets in-flight segments settle, and leaves their sealed work
+ * durable for the resuming rerun. */
+export async function streamCargo(items, ports, options = {}) {
+    const segments = planCargoSegments(items);
+    let artifacts = 0;
+    let bytes = 0;
+    await weightedParallelForEach(segments, options.lanes ?? DEFAULT_TRANSFER_CONCURRENCY, options.maxInFlightBytes ?? CARGO_STREAM_IN_FLIGHT_BYTES, (segment) => Math.max(segment.bytes, 1), async (segment) => {
+        const sealed = new Set(await ports.send(segment));
+        for (const item of segment.items) {
+            if (!sealed.has(item.contentHash)) {
+                throw new Error(`cargo authority did not seal ${item.contentHash}`);
+            }
+        }
+        artifacts += segment.items.length;
+        bytes += segment.bytes;
+    });
+    return { segments: segments.length, artifacts, bytes };
 }
 //# sourceMappingURL=cargo.js.map

package/dist/transfer/cargo.js.map

@@ -1 +1 @@
-{"version":3,"file":"cargo.js","sourceRoot":"","sources":["../../src/transfer/cargo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAC1D;;;oDAGoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAWxC,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAC5B,KAAmB;IAEnB,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAQ,EAAE,CAAC;IACtB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,GAAG,gBAAgB,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;eACjB,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,gBAAgB,IAAI,OAAO,CAAC,MAAM,IAAI,oBAAoB,CAAC,EAAE,CAAC;YACvF,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACtC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"cargo.js","sourceRoot":"","sources":["../../src/transfer/cargo.ts"],"names":[],"mappings":"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"}

package/dist-cjs/contracts/deployments.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Immutable product deployments over one durable Live channel.
+ *
+ * Products own the definition carried by a deployment. Live owns the shared
+ * envelope law: one activation introduces immutable bytes and advances the
+ * subject's head atomically. The previous id records lineage; official
+ * channel order, not a client-side compare-and-swap, decides the current head.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEPLOYMENT_OPERATION = void 0;
+exports.checkDeploymentActivation = checkDeploymentActivation;
+exports.applyDeploymentActivation = applyDeploymentActivation;
+exports.emptyDeploymentSnapshot = emptyDeploymentSnapshot;
+const validate_js_1 = require("./validate.js");
+exports.DEPLOYMENT_OPERATION = 'deployment.activate';
+const EXAMPLE = '{ type: "deployment.activate", deployment: { id, subjectId, previousDeploymentId, definition, createdAt } }';
+/** Validate the shared envelope. The owning product validates `definition`. */
+function checkDeploymentActivation(input) {
+    if (!(0, validate_js_1.isRecord)(input) || input.type !== exports.DEPLOYMENT_OPERATION || !(0, validate_js_1.isRecord)(input.deployment)) {
+        return (0, validate_js_1.failShape)(EXAMPLE, 'the activation envelope was malformed');
+    }
+    const deployment = input.deployment;
+    if (!(0, validate_js_1.isNonEmptyString)(deployment.id) || !(0, validate_js_1.isNonEmptyString)(deployment.subjectId)) {
+        return (0, validate_js_1.failShape)(EXAMPLE, 'deployment id and subjectId must be non-empty strings');
+    }
+    if (deployment.previousDeploymentId !== null
+        && !(0, validate_js_1.isNonEmptyString)(deployment.previousDeploymentId)) {
+        return (0, validate_js_1.failShape)(EXAMPLE, 'previousDeploymentId must be null or a non-empty string');
+    }
+    if (!(0, validate_js_1.isNonEmptyString)(deployment.createdAt)) {
+        return (0, validate_js_1.failShape)(EXAMPLE, 'createdAt must be a non-empty string');
+    }
+    return (0, validate_js_1.pass)(input);
+}
+function canonical(value) {
+    if (Array.isArray(value))
+        return value.map(canonical);
+    if (!(0, validate_js_1.isRecord)(value))
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, item]) => [key, canonical(item)]));
+}
+function sameDeployment(left, right) {
+    return JSON.stringify(canonical(left)) === JSON.stringify(canonical(right));
+}
+/**
+ * Apply one officially ordered activation.
+ *
+ * A retry of an already-known deployment is a no-op even if newer operations
+ * have since advanced the head. Rollback therefore mints a new deployment;
+ * it never reactivates an old id. Reusing an id for different bytes is always
+ * corruption and is refused.
+ */
+function applyDeploymentActivation(snapshot, activation) {
+    const checked = checkDeploymentActivation(activation);
+    if (!checked.ok)
+        throw new Error(checked.error);
+    const deployment = activation.deployment;
+    const existing = snapshot.deployments[deployment.id];
+    if (existing) {
+        if (!sameDeployment(existing, deployment)) {
+            throw new Error(`Deployment id is immutable: ${deployment.id}`);
+        }
+        return snapshot;
+    }
+    return Object.freeze({
+        version: 1,
+        deployments: Object.freeze({ ...snapshot.deployments, [deployment.id]: deployment }),
+        heads: Object.freeze({ ...snapshot.heads, [deployment.subjectId]: deployment.id }),
+    });
+}
+function emptyDeploymentSnapshot() {
+    return Object.freeze({
+        version: 1,
+        deployments: Object.freeze({}),
+        heads: Object.freeze({}),
+    });
+}
+//# sourceMappingURL=deployments.js.map

package/dist-cjs/contracts/deployments.js.map

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

package/dist-cjs/contracts/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./resources.js"), exports);
 __exportStar(require("./events.js"), exports);
 __exportStar(require("./snapshot.js"), exports);
 __exportStar(require("./binding.js"), exports);
+__exportStar(require("./deployments.js"), exports);
 __exportStar(require("./presence.js"), exports);
 __exportStar(require("./docs.js"), exports);
 __exportStar(require("./content.js"), exports);

package/dist-cjs/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,4CAA0B;AAC1B,+CAA6B;AAC7B,kDAAgC;AAChC,qDAAmC;AACnC,sDAAoC;AACpC,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,gDAA8B;AAC9B,+CAA6B;AAC7B,mDAAiC;AACjC,gDAA8B;AAC9B,4CAA0B;AAC1B,+CAA6B;AAC7B,kDAAgC;AAChC,qDAAmC;AACnC,sDAAoC;AACpC,qDAAmC"}

package/dist-cjs/detection/adapter-contract.js

@@ -34,7 +34,7 @@
  *     behavior differs by type — never for symmetry.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.referenceAdapter = exports.lookFailed = exports.SOCKETS = exports.RAILS = void 0;
+exports.SOCKETS = exports.RAILS = void 0;
 exports.assertAdapter = assertAdapter;
 exports.buildTypeMap = buildTypeMap;
 /** The seven rails, declared once, frozen, in journey order. */
@@ -132,37 +132,4 @@ function buildTypeMap(adapters, alphabet) {
     }
     return byType;
 }
-/**
- * The three-state vocabulary's one shared judgment: what a FAILED look
- * at ground means. ENOENT and ENOTDIR are the filesystem itself saying
- * "not there" — honest ABSENCE, a fact. Every other failure means the
- * LOOK failed, not the ground — UNSETTLED: no conclusion, read again.
- *
- * Every truth reader classifies through this one function so no reader
- * can invent its own idea of absence: mistaking "could not look" for
- * "not there" is the exact lie axiom 4 forbids. Only present or absent
- * may produce a conclusion.
- */
-const lookFailed = (error) => error.code === 'ENOENT' || error.code === 'ENOTDIR'
-    ? { truth: 'absent' }
-    : { truth: 'unsettled', reason: error.code };
-exports.lookFailed = lookFailed;
-/**
- * The managed-reference adapter: Amalgm's OWN link kind, never
- * conflated with a filesystem symlink. Its payload is the target
- * entity's UUID — identity, not an address — and its local rendering as
- * an ordinary symlink is DERIVED state (entity-model.md, symlink
- * section). ASSIGNED, NOT YET OPERATIONAL — and that absence is the
- * honest truth: no rail is bound because the projection lives inside
- * the registration boundary today; its detect socket is ratified from
- * that seam when the projection is extracted, never invented ahead of
- * it.
- */
-exports.referenceAdapter = Object.freeze({
-    name: 'reference',
-    types: Object.freeze({
-        reference: "its target entity's UUID — identity, not an address; the rendered symlink is derived state",
-    }),
-    rails: Object.freeze({}),
-});
 //# sourceMappingURL=adapter-contract.js.map

package/dist-cjs/detection/adapter-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-contract.js","sourceRoot":"","sources":["../../src/detection/adapter-contract.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AA0EH,sCA6CC;AAQD,oCAyBC;AAlJD,gEAAgE;AACnD,QAAA,KAAK,GAAoB,MAAM,CAAC,MAAM,CAAC;IAClD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ;CAClE,CAAC,CAAC;AA8BH;;;;;;;GAOG;AACU,QAAA,OAAO,GAAuD,MAAM,CAAC,MAAM,CAAC;IACvF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC,CAAC;AAmBH;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAgB;IAC5C,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;QACvF,CAAC,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oEAAoE,CAAC,CAAC;IAChG,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0DAA0D,CAAC,CAAC;IACtF,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,CAAE,aAA2B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kCAAkC,aAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzG,CAAC;QACD,MAAM,MAAM,GAAG,eAAO,CAAC,IAAY,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU,IAAI,2FAA2F,CAAC,CAAC;QACrI,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU,IAAI,kDAAkD,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU,IAAI,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAC5L,CAAC;QACD,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,wEAAwE,CAAC,CAAC;YACxH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAuC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAC1B,QAA2B,EAC3B,QAA0B;IAE1B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IACpD,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YACrH,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,IAAI,QAAQ,OAAO,CAAC,IAAI,yBAAyB,CAAC,CAAC;YACtI,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD;;;;;;;;;;GAUG;AACI,MAAM,UAAU,GAAG,CACxB,KAAiB,EACoF,EAAE,CACvG,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;IACjD,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE;IACrB,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AALpC,QAAA,UAAU,cAK0B;AAEjD;;;;;;;;;;GAUG;AACU,QAAA,gBAAgB,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC/D,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,4FAA4F;KACxG,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;CACzB,CAAC,CAAC"}
+{"version":3,"file":"adapter-contract.js","sourceRoot":"","sources":["../../src/detection/adapter-contract.ts"],"names":[],"mappings":"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"}

package/dist-cjs/detection/diff.js

@@ -6,27 +6,19 @@
  * verdicts live here. Ratified by entity-model.md ("Address and
  * physical continuity are the two identity witnesses, never content").
  *
- * Three kinds of channel, three orderings of the same two witnesses:
- *
- *  - Files: path claims first; the inode rescues path-orphans. An
- *    atomic save replaces a file's inode in place, so the address must
- *    absorb that churn.
- *  - Directories: physical continuity claims first; the address claims
- *    what no inode claims. Nothing replaces a directory's inode in
- *    place, so a known inode at a new address IS the directory, moved.
- *  - Links: the FILE rules, for the file reason — retarget is unlink +
- *    recreate, so the inode churns exactly like an atomic save.
+ * Directories order the two witnesses opposite to files: physical
+ * continuity claims first and the address claims what no inode claims,
+ * because nothing replaces a directory's inode in place. So a known inode
+ * at a new address IS the directory, moved.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.matchByInode = matchByInode;
 exports.diffDirState = diffDirState;
-exports.diffLinkState = diffLinkState;
-exports.diffRootState = diffRootState;
 /**
  * Physical continuity, shared by every compare function: a row and an
  * entry sharing one device:inode, exactly one match on both sides → the
  * same physical thing. Anything else is never guessed. For files this
- * rescues path-orphans (rule 2); for directories it IS rule 1.
+ * rescues path-orphans; for directories it is the first rule.
  */
 function matchByInode(rows, entries) {
     const one = (map, key, value) => map.set(key, map.has(key) ? 'many' : value);
@@ -90,104 +82,4 @@ function diffDirState(rows, entries) {
         deletes: [...rowsByPath.values()],
     };
 }
-/**
- * The compare function for link channels — the FILE identity rules, for
- * the file reason: a symlink cannot be retargeted in place (retarget is
- * unlink + recreate, so the inode churns exactly like an atomic save),
- * so the path absorbs that churn and claims first; the inode rescues
- * path-orphans (`mv` preserves a symlink's inode). The payload is the
- * target string, already read at walk time. A consequence worth naming:
- * two links exchanging names read as two retargets (path-first),
- * because a link's meaning IS its written address.
- *  1. Path claims the channel: same target = continued (a new inode
- *     under an old name with an old target is silent recreation),
- *     different target = changed.
- *  2. Inode rescues path-orphans: renames.
- *  3. Leftover entries are creates; leftover rows are deletes.
- */
-function diffLinkState(rows, entries) {
-    const changes = [];
-    const retags = [];
-    const rowsByPath = new Map(rows.map((row) => [row.relPath, row]));
-    const claimedRowIds = new Set();
-    const orphanEntries = [];
-    for (const entry of entries) {
-        const row = rowsByPath.get(entry.relPath);
-        if (!row) {
-            orphanEntries.push(entry);
-            continue;
-        }
-        claimedRowIds.add(row.linkId);
-        if (row.target !== entry.target)
-            changes.push({ row, entry });
-        else if (row.device !== entry.device || row.inode !== entry.inode)
-            retags.push({ row, entry });
-    }
-    const orphanRows = rows.filter((row) => !claimedRowIds.has(row.linkId));
-    const renames = matchByInode(orphanRows, orphanEntries);
-    const renamedRowIds = new Set(renames.map((pair) => pair.row.linkId));
-    const renamedEntries = new Set(renames.map((pair) => pair.entry));
-    return {
-        changes,
-        retags,
-        renames,
-        creates: orphanEntries.filter((entry) => !renamedEntries.has(entry)),
-        deletes: orphanRows.filter((row) => !renamedRowIds.has(row.linkId)),
-    };
-}
-/**
- * The compare function for file channels — doorbells and rescans both
- * end here. Hashing is deferred — `checks` name the files whose content
- * must be read before an event may be claimed.
- *
- * Identity rules, in order:
- *  1. Path claims the channel. Same rel_path = same file_id, even when
- *     the inode changed (atomic saves replace the inode on every
- *     write).
- *  2. Inode rescues path-orphans (matchByInode above).
- *  3. Leftover entries are creates; leftover rows are deletes.
- *
- * The single stat-shortcut this layer allows itself: a (size, mtime,
- * inode) triple identical to the stored one is skipped as unchanged —
- * but only when the mtime is strictly older than the moment we last
- * read the bytes (git's "racily clean" rule), and only when nothing
- * pointed at the file. A path named in `mustCheck` (the doorbell said
- * so) is always hashed: timestamps can lie, a delivered watcher event
- * cannot be un-delivered.
- */
-function diffRootState(rows, entries, mustCheck = null) {
-    const checks = [];
-    let unchanged = 0;
-    const rowsByPath = new Map(rows.map((row) => [row.relPath, row]));
-    const claimedRowIds = new Set();
-    const orphanEntries = [];
-    for (const entry of entries) {
-        const row = rowsByPath.get(entry.relPath);
-        if (!row) {
-            orphanEntries.push(entry);
-            continue;
-        }
-        claimedRowIds.add(row.fileId);
-        const statsMatch = row.size === entry.size && row.mtimeMs === entry.mtimeMs && row.inode === entry.inode;
-        const provablyBeforeLastRead = typeof row.hashedAtMs === 'number' && entry.mtimeMs < row.hashedAtMs;
-        const named = mustCheck !== null && mustCheck.has(entry.relPath);
-        if (statsMatch && provablyBeforeLastRead && !named) {
-            unchanged += 1;
-        }
-        else {
-            checks.push({ row, entry });
-        }
-    }
-    const orphanRows = rows.filter((row) => !claimedRowIds.has(row.fileId));
-    const renames = matchByInode(orphanRows, orphanEntries);
-    const renamedRowIds = new Set(renames.map((pair) => pair.row.fileId));
-    const renamedEntries = new Set(renames.map((pair) => pair.entry));
-    return {
-        checks,
-        renames,
-        creates: orphanEntries.filter((entry) => !renamedEntries.has(entry)),
-        deletes: orphanRows.filter((row) => !renamedRowIds.has(row.fileId)),
-        unchanged,
-    };
-}
 //# sourceMappingURL=diff.js.map

package/dist-cjs/detection/diff.js.map

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

package/dist-cjs/detection/enrollment.js

@@ -1,17 +1,17 @@
 "use strict";
 /**
- * Detection enrollment policies.
+ * Detection enrollment policy.
  *
- * Current user ground enrolls everything except structural local state and
- * paths excluded by its tracked `.amalgmignore`; `.gitignore` never decides
- * Amalgm enrollment. `defaultShouldEnroll` remains only as the older explicit
- * registration policy for additive API compatibility. Current portable paths
- * already use `/`; a host converts its native separator at the boundary. A
- * literal `\\` is therefore preserved as part of a POSIX filename. Both
- * policies are pure strings-in/verdict-out and never inspect disk themselves.
+ * User ground enrolls everything except structural local state and paths
+ * excluded by its tracked `.amalgmignore`; `.gitignore` never decides Amalgm
+ * enrollment, and there are no implicit dependency, dotfile, cache, or secret
+ * exclusions. Portable paths already use `/`; a host converts its native
+ * separator at the boundary. A literal `\\` is therefore preserved as part of
+ * a POSIX filename. The policy is pure strings-in/verdict-out and never
+ * inspects disk itself.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultShouldEnroll = exports.DEFAULT_AMALGM_IGNORE = exports.AMALGM_IGNORE_FILE = exports.AMALGM_CONTROL_DIRECTORY = void 0;
+exports.DEFAULT_AMALGM_IGNORE = exports.AMALGM_IGNORE_FILE = exports.AMALGM_CONTROL_DIRECTORY = void 0;
 exports.normalizedRelativePath = normalizedRelativePath;
 exports.isAmalgmControlPath = isAmalgmControlPath;
 exports.isSqliteCoordinationPath = isSqliteCoordinationPath;
@@ -22,72 +22,6 @@ exports.createUserGroundEnrollmentPolicy = createUserGroundEnrollmentPolicy;
 exports.AMALGM_CONTROL_DIRECTORY = '.amalgm';
 exports.AMALGM_IGNORE_FILE = '.amalgmignore';
 exports.DEFAULT_AMALGM_IGNORE = `/${exports.AMALGM_CONTROL_DIRECTORY}/\n`;
-const EXCLUDED_DIRECTORIES = new Set([
-    '.amalgm',
-    '.aws',
-    '.cache',
-    '.docker',
-    '.git',
-    '.gnupg',
-    '.gradle',
-    '.hg',
-    '.kube',
-    '.mypy_cache',
-    '.next',
-    '.nyc_output',
-    '.parcel-cache',
-    '.pytest_cache',
-    '.ruff_cache',
-    '.ssh',
-    '.svn',
-    '.svelte-kit',
-    '.turbo',
-    '.venv',
-    '.vite',
-    '__pycache__',
-    'coverage',
-    'node_modules',
-]);
-const EXCLUDED_FILES = new Set([
-    '.DS_Store',
-    'Thumbs.db',
-    'desktop.ini',
-    'npm-debug.log',
-    'pnpm-debug.log',
-    'yarn-debug.log',
-    'yarn-error.log',
-]);
-function isPrivateFile(name) {
-    if (/^\.env(?:\..+)?$/i.test(name) && !/\.example$/i.test(name))
-        return true;
-    if (/^(?:credentials?|secrets?)\.(?:json|ya?ml|toml|ini|conf)$/i.test(name))
-        return true;
-    if (/^id_(?:dsa|ecdsa|ed25519|rsa)$/i.test(name))
-        return true;
-    if (/^(?:\.git-credentials|\.netrc|\.npmrc|\.pypirc|auth\.json|kubeconfig)$/i.test(name))
-        return true;
-    if (/^(?:service[-_]?account|firebase[-_]?adminsdk).*\.json$/i.test(name))
-        return true;
-    return /\.(?:key|keystore|kdbx|p12|pfx|pem|ppk|tfstate(?:\.backup)?)$/i.test(name);
-}
-/**
- * Legacy explicit-registration policy retained for additive API compatibility.
- * Current user-ground Detect must use {@link createUserGroundEnrollmentPolicy};
- * there are no implicit dependency, dotfile, cache, or secret exclusions.
- * Both separators are path separators; '' never enrolls.
- *
- * @deprecated Use `createUserGroundEnrollmentPolicy` for current user ground.
- */
-const defaultShouldEnroll = (relPath) => {
-    const parts = normalizedRelativePath(String(relPath || '').replace(/\\/g, '/')).split('/').filter(Boolean);
-    const name = parts.at(-1);
-    if (name === undefined || parts.some((part) => EXCLUDED_DIRECTORIES.has(part)))
-        return false;
-    if (EXCLUDED_FILES.has(name) || isPrivateFile(name))
-        return false;
-    return !name.startsWith('.#') && !name.endsWith('~') && !/\.(?:swp|swo)$/i.test(name);
-};
-exports.defaultShouldEnroll = defaultShouldEnroll;
 /**
  * One normalized spelling for portable enrollment and ignore matching.
  * Portable relative paths use `/`. Do not reinterpret `\\`: it is a valid,