@amalgm/shell 0.1.164-preview.36072132286 → 0.1.164-preview.36809057014

package/dist/content-clock.d.ts

@@ -0,0 +1,42 @@
+import type Database from "better-sqlite3";
+import { type SourceStat } from "./source-signature.js";
+export interface ContentBoundary {
+    /** The stamp's mtime less its profile's margin, nanoseconds in decimal. */
+    readonly ns: string;
+    /** The device whose clock wrote the stamp. */
+    readonly dev: bigint;
+}
+/** One stamp: its boundary, and the retirement epoch it completed in, which
+ * every conclusion drawn from reads after it is drawn in. */
+export interface ContentStamp {
+    readonly boundary: ContentBoundary | null;
+    readonly epoch: number;
+}
+/** The boundary one leaf may carry: none under another device's clock. */
+export declare const leafBoundary: (clock: ContentBoundary | null, stat: Pick<SourceStat, "dev">) => string | null;
+/** How a directory listing read under clock closes: `racy` until a fresh
+ * listing under a later stamp can, `unqualified` when no stamp can because
+ * the root has no clock or another device holds the directory, so only
+ * listing it again after its walk closes it (see detection/ground-proof.ts). */
+export declare function listingQualification(clock: ContentBoundary | null, stat: Pick<SourceStat, "dev" | "mtimeNs" | "ctimeNs">): "qualified" | "racy" | "unqualified";
+/** Milliseconds until a later stamp can qualify a fresh listing of a racy
+ * directory that stays untouched: stamps only advance, so a stamp taken that
+ * long after this one has a boundary past both of its times. */
+export declare function listingWaitMs(clock: ContentBoundary, stat: Pick<SourceStat, "mtimeNs" | "ctimeNs">): number;
+/** The retirement epoch a conclusion drawn now is drawn in. */
+export declare const clockEpoch: () => number;
+/** Throws when a retirement since epoch touched root's ground: at, above or
+ * beneath it. */
+export declare function assertQualifiedSince(root: string, epoch: number): void;
+/** Stamps root's content clock. The boundary is null when the root cannot
+ * hold a stamp, being absent or unwritable, or when its filesystem is
+ * untrusted, which is still stamped so that a later trusted stamp sees the
+ * change of profile: no leaf under it is then qualified, and every one is
+ * reread by whatever reads it next, and every listing under it closes only by
+ * being listed again. */
+export declare function stampContentClock(file: string, root: string): Promise<ContentStamp>;
+/** The save: every leaf at or under root, in both inventories, loses its
+ * proof. Returns how many proofs it retired. */
+export declare function retireProofs(database: Database.Database, { root }: {
+    readonly root: string;
+}): number;

package/dist/content-clock.js

@@ -0,0 +1,166 @@
+import { lstat, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { GroundBasisChangedError } from "./ground-basis.js";
+import { groundProfile } from "./ground-profile.js";
+import { save } from "./ground-saver.js";
+import { groundStore } from "./ground-store.js";
+import { precedenceWaitNs, timePrecedes } from "./source-signature.js";
+import { cachedStatement } from "./sqlite.js";
+/** The boundary one leaf may carry: none under another device's clock. */
+export const leafBoundary = (clock, stat) => clock !== null && clock.dev === stat.dev ? clock.ns : null;
+/** How a directory listing read under clock closes: `racy` until a fresh
+ * listing under a later stamp can, `unqualified` when no stamp can because
+ * the root has no clock or another device holds the directory, so only
+ * listing it again after its walk closes it (see detection/ground-proof.ts). */
+export function listingQualification(clock, stat) {
+    if (clock === null || clock.dev !== stat.dev)
+        return "unqualified";
+    const boundary = BigInt(clock.ns);
+    return timePrecedes(stat.mtimeNs, boundary) && timePrecedes(stat.ctimeNs, boundary) ? "qualified" : "racy";
+}
+/** Milliseconds until a later stamp can qualify a fresh listing of a racy
+ * directory that stays untouched: stamps only advance, so a stamp taken that
+ * long after this one has a boundary past both of its times. */
+export function listingWaitMs(clock, stat) {
+    const boundary = BigInt(clock.ns);
+    const mtime = precedenceWaitNs(stat.mtimeNs, boundary), ctime = precedenceWaitNs(stat.ctimeNs, boundary);
+    return Number(((mtime > ctime ? mtime : ctime) + 999999n) / 1000000n);
+}
+const UNSTAMPABLE = new Set(["EACCES", "EPERM", "EROFS", "ENOENT", "ENOTDIR"]);
+const IGNORE_ALL = "*\n";
+/** Control trees this process already told Git to ignore. */
+const ignoredControls = new Set();
+/** The profile each root was last stamped under by this process. */
+const stampedUnder = new Map();
+/** Retirements this process took, and the latest one of each root. */
+let retirements = 0;
+const retiredAt = new Map();
+/** The retirement epoch a conclusion drawn now is drawn in. */
+export const clockEpoch = () => retirements;
+/** Throws when a retirement since epoch touched root's ground: at, above or
+ * beneath it. */
+export function assertQualifiedSince(root, epoch) {
+    for (const [retired, at] of retiredAt) {
+        if (at > epoch && (retired === root || retired.startsWith(`${root}/`) || root.startsWith(`${retired}/`))) {
+            throw new GroundBasisChangedError(`${retired} was requalified after a conclusion under ${root}`);
+        }
+    }
+}
+const absent = (error) => error.code === "ENOENT";
+/** The profile a standing stamp names; null when it names none. */
+async function stampProfile(clock) {
+    try {
+        return (await readFile(clock, "utf8")).match(/^content clock (\S+)\n$/)?.[1] ?? null;
+    }
+    catch (error) {
+        if (absent(error))
+            return null;
+        throw error;
+    }
+}
+/** Writes the control tree's `.gitignore` when it is absent or different. */
+async function ignoreControl(control) {
+    if (ignoredControls.has(control))
+        return;
+    const file = join(control, ".gitignore");
+    let current = null;
+    try {
+        current = await readFile(file, "utf8");
+    }
+    catch (error) {
+        if (!absent(error))
+            throw error;
+    }
+    if (current !== IGNORE_ALL)
+        await writeFile(file, IGNORE_ALL);
+    ignoredControls.add(control);
+}
+/** Each root's latest stamp, settled either way. */
+const stamping = new Map();
+/** Stamps root's content clock. The boundary is null when the root cannot
+ * hold a stamp, being absent or unwritable, or when its filesystem is
+ * untrusted, which is still stamped so that a later trusted stamp sees the
+ * change of profile: no leaf under it is then qualified, and every one is
+ * reread by whatever reads it next, and every listing under it closes only by
+ * being listed again. */
+export function stampContentClock(file, root) {
+    const stamp = (stamping.get(root) ?? Promise.resolve()).then(() => stampNow(file, root));
+    const settled = stamp.then(() => { }, () => { });
+    stamping.set(root, settled);
+    void settled.then(() => { if (stamping.get(root) === settled)
+        stamping.delete(root); });
+    return stamp;
+}
+async function stampNow(file, root) {
+    const control = join(root, ".amalgm");
+    const clock = join(control, "content-clock"), next = `${clock}.next`;
+    let profile;
+    try {
+        profile = groundProfile(root);
+        const content = `content clock ${profile.id}\n`;
+        // Only written bytes move mtime everywhere; truncating an empty file
+        // does not on every filesystem.
+        try {
+            await writeFile(next, content);
+        }
+        catch (error) {
+            if (!absent(error))
+                throw error;
+            // Only the control tree is created; a vanished root stays vanished.
+            await mkdir(control, { mode: 0o700 });
+            await writeFile(next, content);
+        }
+        await ignoreControl(control);
+    }
+    catch (error) {
+        if (UNSTAMPABLE.has(error.code ?? ""))
+            return { boundary: null, epoch: retirements };
+        throw error;
+    }
+    const stamp = await lstat(next, { bigint: true });
+    let previous;
+    try {
+        previous = await lstat(clock, { bigint: true });
+    }
+    catch (error) {
+        if (!absent(error))
+            throw error;
+    }
+    const backwards = previous !== undefined && stamp.mtimeNs < previous.mtimeNs;
+    const requalified = previous === undefined
+        || stampedUnder.get(root) !== profile.id && await stampProfile(clock) !== profile.id;
+    // The previous stamp is replaced only after its retirement committed.
+    const retired = backwards || requalified ? await retire(file, root) : 0;
+    await rename(next, clock);
+    stampedUnder.set(root, profile.id);
+    if (backwards)
+        throw new GroundBasisChangedError(`the filesystem clock under ${root} went backwards; its content proofs were retired`);
+    if (retired)
+        throw new GroundBasisChangedError(`${root} is now stamped under ${profile.id}; its earlier content proofs were retired`);
+    return { boundary: profile.marginNs === null ? null : { ns: (stamp.mtimeNs - profile.marginNs).toString(), dev: stamp.dev },
+        epoch: retirements };
+}
+/** Every leaf at or under root loses its proof, as a save. A conclusion
+ * drawn under root from here on is drawn in the new epoch. */
+async function retire(file, root) {
+    retiredAt.set(root, ++retirements);
+    return (await save(file, "ground.retireProofs", { root })).value;
+}
+/** The save: every leaf at or under root, in both inventories, loses its
+ * proof. Returns how many proofs it retired. */
+export function retireProofs(database, { root }) {
+    const prefix = `${root}/`;
+    let retired = 0;
+    groundStore(database).write(writer => {
+        for (const inventory of ["entities", "detection_notebook"]) {
+            const proven = cachedStatement(database, `SELECT uuid FROM ${inventory} WHERE content_verified_ns IS NOT NULL
+        AND (absolute_path = ? OR substr(absolute_path, 1, ?) = ?)`).pluck().all(root, prefix.length, prefix);
+            for (const uuid of proven) {
+                writer.update(inventory, uuid, { contentVerifiedNs: null }, inventory === "detection_notebook" ? "retain-equivalent" : undefined);
+            }
+            retired += proven.length;
+        }
+    });
+    return retired;
+}
+//# sourceMappingURL=content-clock.js.map

package/dist/content-clock.js.map

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

package/dist/content-direct.d.ts

@@ -30,6 +30,8 @@ export interface DirectContentMetrics {
 }
 export declare class DirectContentPlane {
     private readonly signal?;
+    /** This process's one-time fetch-client compile, measured at construction. */
+    readonly warmMs: number;
     /** Key material is stable for a resource's lifetime, so one handoff per
      * process is enough; it lives only in memory, never at rest. */
     private readonly keys;

package/dist/content-direct.js

@@ -36,8 +36,20 @@ function decodeRefs(frame) {
         return { url, offset: Number(ref.offset), length: Number(ref.length) };
     });
 }
+/** Node compiles its bundled fetch client on first use: one synchronous
+ * step of tens of milliseconds. A plane pays it when built, as declared
+ * startup work before readiness, not as a stall inside the first download.
+ * Constructing `Headers` loads that same client. Answers the milliseconds
+ * spent; zero once the client is loaded. */
+function warmFetchClient() {
+    const started = performance.now();
+    void new Headers();
+    return performance.now() - started;
+}
 export class DirectContentPlane {
     signal;
+    /** This process's one-time fetch-client compile, measured at construction. */
+    warmMs = warmFetchClient();
     /** Key material is stable for a resource's lifetime, so one handoff per
      * process is enough; it lives only in memory, never at rest. */
     keys = new Map();

package/dist/content-direct.js.map

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

package/dist/content-failure.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A content thread's failure as it crosses to the main thread. Only plain
+ * fields survive structured clone, so a thread describes its error by the
+ * fields callers classify by — above all `code` — and the main thread
+ * restores an Error of the same kind. A churned capture returns as
+ * CaptureSourceChangedError, so the walk's churn law sees it unchanged.
+ */
+export interface CaptureFailure {
+    readonly name: string;
+    readonly message: string;
+    readonly stack?: string;
+    readonly code?: string;
+    readonly errno?: number;
+    readonly syscall?: string;
+    readonly path?: string;
+}
+export declare function describeFailure(error: unknown): CaptureFailure;
+export declare function restoreFailure(failure: CaptureFailure): Error;

package/dist/content-failure.js

@@ -0,0 +1,38 @@
+/**
+ * A content thread's failure as it crosses to the main thread. Only plain
+ * fields survive structured clone, so a thread describes its error by the
+ * fields callers classify by — above all `code` — and the main thread
+ * restores an Error of the same kind. A churned capture returns as
+ * CaptureSourceChangedError, so the walk's churn law sees it unchanged.
+ */
+import { CaptureSourceChangedError } from "./content-cache-host.js";
+export function describeFailure(error) {
+    if (!(error instanceof Error))
+        return { name: "Error", message: String(error) };
+    const fields = error;
+    return {
+        name: error.name,
+        message: error.message,
+        ...(error.stack !== undefined ? { stack: error.stack } : {}),
+        ...(typeof fields.code === "string" ? { code: fields.code } : {}),
+        ...(typeof fields.errno === "number" ? { errno: fields.errno } : {}),
+        ...(typeof fields.syscall === "string" ? { syscall: fields.syscall } : {}),
+        ...(typeof fields.path === "string" ? { path: fields.path } : {}),
+    };
+}
+export function restoreFailure(failure) {
+    const error = failure.code === "CAPTURE_SOURCE_CHANGED"
+        ? new CaptureSourceChangedError(failure.message)
+        : Object.assign(new Error(failure.message), {
+            ...(failure.code !== undefined ? { code: failure.code } : {}),
+            ...(failure.errno !== undefined ? { errno: failure.errno } : {}),
+            ...(failure.syscall !== undefined ? { syscall: failure.syscall } : {}),
+            ...(failure.path !== undefined ? { path: failure.path } : {}),
+        });
+    if (failure.code !== "CAPTURE_SOURCE_CHANGED")
+        error.name = failure.name;
+    if (failure.stack)
+        error.stack = failure.stack;
+    return error;
+}
+//# sourceMappingURL=content-failure.js.map

package/dist/content-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-failure.js","sourceRoot":"","sources":["../src/content-failure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAYpE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAChF,MAAM,MAAM,GAAG,KAA8B,CAAC;IAC9C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,KAAK,wBAAwB;QACrD,CAAC,CAAC,IAAI,yBAAyB,CAAC,OAAO,CAAC,OAAO,CAAC;QAChD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC1C,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;IACL,IAAI,OAAO,CAAC,IAAI,KAAK,wBAAwB;QAAE,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IACzE,IAAI,OAAO,CAAC,KAAK;QAAE,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/content-stream-thread.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Large-file uploads stream on one thread of their own.
+ *
+ * A fused upload reads a large file once, hashes every block and the whole
+ * file, and ships each batch while reading the next. The read and both
+ * hashes run on the stream thread, never on the one thread that schedules
+ * Watch, Detect admission, Apply and Send. The main thread only relays each
+ * batch's blocks and the final seal to the wire; batch bytes cross by
+ * transfer, not copy.
+ *
+ * A stream spends most of its life waiting on the network between batches.
+ * It therefore holds no capture slot: the thread serves every concurrent
+ * stream at once, and none waits for another's upload. The capture laws —
+ * fingerprint before and after, manifest sealed last, two batches at most
+ * in memory — stay in content-cache-host and Live's uploadStream, run
+ * unchanged on that thread.
+ */
+import { type MessagePort } from "node:worker_threads";
+import type { ContentChunk, ContentManifest } from "@amalgm/live";
+import type { CapturedFileContent, CaptureStreamTransport } from "./content-cache-host.js";
+import { type CaptureFailure } from "./content-failure.js";
+import type { SourceStat } from "./source-signature.js";
+/** One stream as it crosses to the thread, with its own relay channel. */
+export interface StreamJob {
+    readonly sourceFile: string;
+    readonly expected: SourceStat;
+    readonly relay: MessagePort;
+}
+/** One wire effect a stream asks the main thread for. */
+export type StreamEffect = {
+    readonly op: "put";
+    readonly chunks: readonly ContentChunk[];
+    readonly bytes: Uint8Array;
+} | {
+    readonly op: "seal";
+    readonly manifest: ContentManifest;
+};
+/** A numbered effect, or how the stream ended. The thread closes nothing;
+ * the main thread closes the relay once the stream has ended. */
+export type StreamRequest = (StreamEffect & {
+    readonly seq: number;
+}) | {
+    readonly op: "done";
+    readonly captured: CapturedFileContent;
+} | {
+    readonly op: "failed";
+    readonly failure: CaptureFailure;
+};
+/** The wire's answer to one request. A failed effect keeps its error on the
+ * main thread, where the caller classifies it. */
+export interface StreamAnswer {
+    readonly seq: number;
+    readonly failed: boolean;
+}
+/**
+ * Capture one large file by streaming its single read to the wire through
+ * `transport`. Ground churn rejects as CaptureSourceChangedError; a failed
+ * transport effect rejects with that effect's own error.
+ */
+export declare function streamContentUpload(sourceFile: string, expected: SourceStat, transport: CaptureStreamTransport): Promise<CapturedFileContent>;

package/dist/content-stream-thread.js

@@ -0,0 +1,95 @@
+/**
+ * Large-file uploads stream on one thread of their own.
+ *
+ * A fused upload reads a large file once, hashes every block and the whole
+ * file, and ships each batch while reading the next. The read and both
+ * hashes run on the stream thread, never on the one thread that schedules
+ * Watch, Detect admission, Apply and Send. The main thread only relays each
+ * batch's blocks and the final seal to the wire; batch bytes cross by
+ * transfer, not copy.
+ *
+ * A stream spends most of its life waiting on the network between batches.
+ * It therefore holds no capture slot: the thread serves every concurrent
+ * stream at once, and none waits for another's upload. The capture laws —
+ * fingerprint before and after, manifest sealed last, two batches at most
+ * in memory — stay in content-cache-host and Live's uploadStream, run
+ * unchanged on that thread.
+ */
+import { MessageChannel } from "node:worker_threads";
+import { restoreFailure } from "./content-failure.js";
+import { moduleThread } from "./module-thread.js";
+import { queueTurn } from "./turns.js";
+const WORKER = new URL("./content-stream-worker.js", import.meta.url);
+let thread = null;
+function spawn() {
+    const spawned = { worker: moduleThread(WORKER), streams: new Set() };
+    let failure = null;
+    spawned.worker.on("error", error => { failure ??= error; });
+    // A stream fails only once its thread has exited, so no caller released
+    // by the failure races the thread's still-open file.
+    spawned.worker.on("exit", code => {
+        if (thread === spawned)
+            thread = null;
+        const error = failure ?? new Error(`content stream worker exited with code ${code}`);
+        for (const fail of [...spawned.streams])
+            fail(error);
+    });
+    spawned.worker.unref();
+    return spawned;
+}
+/**
+ * Capture one large file by streaming its single read to the wire through
+ * `transport`. Ground churn rejects as CaptureSourceChangedError; a failed
+ * transport effect rejects with that effect's own error.
+ */
+export function streamContentUpload(sourceFile, expected, transport) {
+    const current = thread ??= spawn();
+    return new Promise((resolve, reject) => {
+        const { port1: relay, port2 } = new MessageChannel();
+        let transportFailure = null;
+        let settled = false;
+        const settle = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            current.streams.delete(fail);
+            if (current.streams.size === 0)
+                current.worker.unref();
+            relay.close();
+            queueTurn(outcome);
+        };
+        const fail = (error) => settle(() => reject(error));
+        current.streams.add(fail);
+        // A streaming thread keeps the process alive; an idle one never does.
+        current.worker.ref();
+        relay.on("message", (request) => {
+            if (request.op === "done")
+                settle(() => resolve(request.captured));
+            else if (request.op === "failed")
+                fail(transportFailure ? transportFailure.error : restoreFailure(request.failure));
+            else {
+                queueTurn(() => {
+                    const effect = request.op === "put"
+                        ? transport.putBlocks(request.chunks, request.bytes)
+                        : transport.sealManifest(request.manifest);
+                    effect.then(() => { if (!settled)
+                        relay.postMessage({ seq: request.seq, failed: false }); }, (error) => {
+                        transportFailure ??= { error };
+                        if (!settled)
+                            relay.postMessage({ seq: request.seq, failed: true });
+                    });
+                });
+            }
+        });
+        current.worker.postMessage({
+            sourceFile,
+            // Only the signed fields travel; a Stats object loses its prototype.
+            expected: {
+                dev: expected.dev, ino: expected.ino, mode: expected.mode, nlink: expected.nlink,
+                size: expected.size, mtimeNs: expected.mtimeNs, ctimeNs: expected.ctimeNs,
+            },
+            relay: port2,
+        }, [port2]);
+    });
+}
+//# sourceMappingURL=content-stream-thread.js.map

package/dist/content-stream-thread.js.map

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

package/dist/content-stream-worker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The stream thread. It runs every large-file upload's one read and both of
+ * its hashes, many streams at once, and asks the main thread for each wire
+ * effect over the stream's own relay (content-stream-thread.ts). Batches
+ * cross by transfer; the main thread closes each relay once it has ended.
+ */
+export {};

package/dist/content-stream-worker.js

@@ -0,0 +1,52 @@
+/**
+ * The stream thread. It runs every large-file upload's one read and both of
+ * its hashes, many streams at once, and asks the main thread for each wire
+ * effect over the stream's own relay (content-stream-thread.ts). Batches
+ * cross by transfer; the main thread closes each relay once it has ended.
+ */
+import { parentPort } from "node:worker_threads";
+import { captureContentFileStream } from "./content-cache-host.js";
+import { describeFailure } from "./content-failure.js";
+const port = parentPort;
+if (!port)
+    throw new Error("content streams must run on a worker thread");
+port.on("message", (job) => { void stream(job); });
+/** The wire failed this effect; the main thread holds its error. */
+class RelayedEffectFailed extends Error {
+}
+async function stream({ sourceFile, expected, relay }) {
+    const waiting = new Map();
+    let next = 0;
+    relay.on("message", (answer) => {
+        const pending = waiting.get(answer.seq);
+        waiting.delete(answer.seq);
+        if (answer.failed)
+            pending?.reject(new RelayedEffectFailed("content stream wire effect failed"));
+        else
+            pending?.resolve();
+    });
+    const ask = (effect, transfer) => new Promise((resolve, reject) => {
+        const seq = next++;
+        waiting.set(seq, { resolve, reject });
+        relay.postMessage({ ...effect, seq }, transfer);
+    });
+    let ended;
+    try {
+        const captured = await captureContentFileStream(sourceFile, expected, {
+            putBlocks: (chunks, bytes) => {
+                // A batch that shares its ArrayBuffer is copied, so the transfer
+                // never detaches bytes this thread still holds.
+                const owned = bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength
+                    ? bytes : new Uint8Array(bytes);
+                return ask({ op: "put", chunks, bytes: owned }, [owned.buffer]);
+            },
+            sealManifest: manifest => ask({ op: "seal", manifest }, []),
+        });
+        ended = { op: "done", captured };
+    }
+    catch (error) {
+        ended = { op: "failed", failure: describeFailure(error) };
+    }
+    relay.postMessage(ended);
+}
+//# sourceMappingURL=content-stream-worker.js.map

package/dist/content-stream-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-stream-worker.js","sourceRoot":"","sources":["../src/content-stream-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,IAAI,CAAC,IAAI;IAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AAE1E,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAc,EAAE,EAAE,GAAG,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,oEAAoE;AACpE,MAAM,mBAAoB,SAAQ,KAAK;CAAG;AAE1C,KAAK,UAAU,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAa;IAC9D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqE,CAAC;IAC7F,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,MAAoB,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,CAAC,IAAI,mBAAmB,CAAC,mCAAmC,CAAC,CAAC,CAAC;;YAC5F,OAAO,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,CAAC,MAAoB,EAAE,QAAuB,EAAiB,EAAE,CAC3E,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAA0B,EAAE,QAAQ,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACL,IAAI,KAAoB,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,UAAU,EAAE,QAAQ,EAAE;YACpE,SAAS,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAC3B,iEAAiE;gBACjE,gDAAgD;gBAChD,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,MAAM,CAAC,UAAU;oBAClF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClC,OAAO,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAqB,CAAC,CAAC,CAAC;YACjF,CAAC;YACD,YAAY,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;SAC5D,CAAC,CAAC;QACH,KAAK,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5D,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/declaration-absorption.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Register's enclosing law. W's ground may enclose workspaces this machine
+ * already materializes. Each one the authority holds as its own root is
+ * absorbed: its accepted subtree joins W's head with every identity kept,
+ * and its root leaves the head in the same commit. Only its root record
+ * changes: it is re-placed where W's walk found it, under its parentUUID
+ * and name there, and a `workspace`, which only a root can be, becomes a
+ * `folder`.
+ *
+ * Absorbed ground rides as each inventory already holds it. The head
+ * carries its accepted records, and sharing (B) keeps its own rows
+ * (declaration-save.ts), so local work there, including an identity the walk
+ * found moved out of it, stays owed to ordinary Detect. Only identities an
+ * inventory lacks enter from the walk.
+ */
+import { type CloudEntityRecord, type Sha256Hex } from "@amalgm/live";
+import { type AcceptedView } from "./graph-publication.js";
+/** A workspace this machine binds to ground. */
+export interface BoundWorkspace {
+    readonly workspaceId: string;
+    readonly directory: string;
+}
+/** The bound workspaces W's ground encloses. */
+export declare function enclosedWorkspaces(bindings: readonly BoundWorkspace[], workspaceId: string, directory: string): BoundWorkspace[];
+/** The root AV holds this identity in, or null when AV never accepted it. */
+export declare function acceptedHolder(view: AcceptedView, uuid: string): Promise<string | null>;
+/** The enclosed workspaces W absorbs on this view. One held inside another
+ * enclosed workspace rides with it. Anything else refuses: ground whose own
+ * declaration the authority has not accepted, or that it holds inside a root
+ * this machine does not enclose, would move identities W never observed. */
+export declare function absorbedRoots(view: AcceptedView, workspaceId: string, enclosed: readonly BoundWorkspace[], held: ReadonlySet<string>): Promise<string[]>;
+/** An absorbed root's own record, re-placed where W's walk found it. */
+export declare function placeAbsorbedRoot(record: CloudEntityRecord, placement: Pick<CloudEntityRecord, "parentUUID" | "name">, sha256Hex: Sha256Hex): CloudEntityRecord;
+/** D's records for W: the walk outside absorbed ground, minus identities AV
+ * already holds there, plus each absorbed root exactly as AV holds it with
+ * its root re-placed. Container versions derive from D's own membership. */
+export declare function absorbingDeclaration(view: AcceptedView, workspaceId: string, walked: readonly CloudEntityRecord[], absorbed: readonly string[], sha256Hex: Sha256Hex): Promise<readonly CloudEntityRecord[]>;