@plurnk/plurnk-service 3.1.0 → 3.3.0

package/dist/core/FileAddress.js

@@ -0,0 +1,73 @@
+import { resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { PathSyntax } from "@plurnk/plurnk-contracts";
+import Namespace from "./namespace.js";
+import PathGlob from "./PathGlob.js";
+import Results from "./results.js";
+// {§file-url} Authored spellings are interpreted here; bound keys are always literal.
+export default class FileAddress {
+    static isPattern(target) {
+        return target !== null && target !== undefined && PathSyntax.hasGlob(target.kind === "url" ? target.pathname : PathSyntax.decodeParens(target.raw));
+    }
+    static pathname(target) {
+        if (target.kind === "local")
+            return PathSyntax.decodeParens(target.raw);
+        if (target.scheme !== "file")
+            throw new TypeError("FileAddress requires a file target.");
+        try {
+            const pathname = fileURLToPath(target.raw);
+            if (pathname.includes("\0"))
+                throw new TypeError("File URL path must not include NUL characters.");
+            return pathname;
+        }
+        catch (cause) {
+            if (!(cause instanceof TypeError || cause instanceof URIError))
+                throw cause;
+            return Results.failure("scheme:file", "invalid-file-url", 400, cause.message, {}, { retryable: false });
+        }
+    }
+    static selector(target, projectRoot = null) {
+        const pathname = FileAddress.pathname(target);
+        if (typeof pathname !== "string" || target.kind === "local" || !FileAddress.isPattern(target))
+            return pathname;
+        const url = new URL(target.raw);
+        const parts = target.pathname.split("/");
+        const rootParts = projectRoot === null ? [] : resolve(projectRoot).split("/");
+        let common = 0;
+        while (common < rootParts.length && common < parts.length && decodeURIComponent(parts[common]) === rootParts[common])
+            common++;
+        // URI-encoded glob characters are filename data, even next to authored glob syntax.
+        // The common filesystem base is removed by relativization, not matched as a glob.
+        url.pathname = parts.map((part, index) => index < common ? part
+            : part.replace(/%(?:2a|3f|5b|5c|5d|7b|7d|28|29)/giu, (encoded) => encodeURIComponent(PathGlob.escape(decodeURIComponent(encoded))))).join("/");
+        return fileURLToPath(url);
+    }
+    static async projectRoot({ db, workspaceId }) {
+        const row = await db.envelope_get_workspace.get({ id: workspaceId });
+        return row?.project_root ?? null;
+    }
+    // {§fs-canonical-name} A resource name must never render as a channel, alias or selector.
+    static render(key, projectRoot) {
+        const bare = Namespace.literalSpelling(key);
+        const ambiguous = /[#<\p{Cc}]|%2[89]/iu.test(bare) || bare.trim() !== bare
+            || /^[a-z][a-z0-9+.-]*:\/\//iu.test(bare)
+            || PathSyntax.hasGlob(bare);
+        if (!ambiguous)
+            return PathSyntax.escapeTarget(PathSyntax.encodeParens(bare));
+        if (projectRoot === null)
+            throw new TypeError("Rendering this file address requires its project root.");
+        const url = pathToFileURL(resolve(projectRoot, key));
+        if (key.endsWith("/") && !url.pathname.endsWith("/"))
+            url.pathname += "/";
+        // URL permits literal '*'; our target slot uses it as a collection selector.
+        const address = url.href.replaceAll("*", "%2A");
+        return PathSyntax.escapeTarget(PathSyntax.encodeParens(address));
+    }
+    static renderSelector(key, target) {
+        if (target.kind === "local")
+            return PathSyntax.escapeTarget(PathSyntax.encodeParens(Namespace.literalSpelling(key)));
+        // Decoding and re-encoding a selector loses which metacharacters were literal.
+        return PathSyntax.escapeTarget(`file://${target.hostname ?? ""}${target.pathname}`);
+    }
+}
+//# sourceMappingURL=FileAddress.js.map

package/dist/core/FileAddress.js.map

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

package/dist/core/FilePublication.d.ts

@@ -0,0 +1,15 @@
+import { type FileRevision } from "./FileSnapshot.ts";
+export type PublishedFile = {
+    readonly status: "conflict";
+} | {
+    readonly status: "published";
+    readonly revision: FileRevision;
+} | {
+    readonly status: "failed";
+    readonly published: boolean;
+    readonly cause: unknown;
+};
+export default class FilePublication {
+    static write(requested: string, canonical: string, baseline: FileRevision | null, bytes: Uint8Array): Promise<PublishedFile>;
+}
+//# sourceMappingURL=FilePublication.d.ts.map

package/dist/core/FilePublication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePublication.d.ts","sourceRoot":"","sources":["../../src/core/FilePublication.ts"],"names":[],"mappings":"AAIA,OAAqB,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,MAAM,aAAa,GACnB;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAG1F,MAAM,CAAC,OAAO,OAAO,eAAe;IAChC,OAAa,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAgEjI;CACJ"}

package/dist/core/FilePublication.js

@@ -0,0 +1,143 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import fs from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { contentHash } from "./content-hash.js";
+import FileSnapshot from "./FileSnapshot.js";
+// {§file-publication}: caller holds the physical path's commit boundary through projection settlement.
+export default class FilePublication {
+    static async write(requested, canonical, baseline, bytes) {
+        let directory;
+        let published = false;
+        let result = { status: "conflict" };
+        try {
+            await fs.mkdir(dirname(canonical), { recursive: true });
+            directory = await fs.mkdtemp(join(dirname(canonical), ".plurnk-write-"));
+            const staged = join(directory, "content");
+            let identity;
+            {
+                const env_1 = { stack: [], error: void 0, hasError: false };
+                try {
+                    const handle = __addDisposableResource(env_1, await fs.open(staged, "wx", 0o600), true);
+                    identity = await handle.stat({ bigint: true });
+                    await handle.writeFile(bytes);
+                    const source = baseline === null ? null : await FileSnapshot.observe(requested);
+                    const current = await handle.stat({ bigint: true });
+                    if (source !== null && (current.uid !== source.stats.uid || current.gid !== source.stats.gid)) {
+                        await handle.chown(Number(source.stats.uid), Number(source.stats.gid));
+                    }
+                    await handle.chmod(source === null ? 0o666 & ~process.umask() : Number(source.stats.mode & 4095n));
+                    await handle.sync();
+                }
+                catch (e_1) {
+                    env_1.error = e_1;
+                    env_1.hasError = true;
+                }
+                finally {
+                    const result_1 = __disposeResources(env_1);
+                    if (result_1)
+                        await result_1;
+                }
+            }
+            if (baseline !== null) {
+                const current = await FileSnapshot.acquire(requested, null);
+                if (current === null || !FileSnapshot.matches(baseline, current.revision)) {
+                    result = { status: "conflict" };
+                }
+                else {
+                    await fs.rename(staged, canonical);
+                    published = true;
+                }
+            }
+            else if (await FileSnapshot.prospectivePath(requested) === canonical) {
+                // Linking the completed same-filesystem stage publishes without replacing any occupant.
+                try {
+                    await fs.link(staged, canonical);
+                    published = true;
+                    await fs.unlink(staged);
+                }
+                catch (cause) {
+                    if (cause.code !== "EEXIST")
+                        throw cause;
+                    result = { status: "conflict" };
+                }
+            }
+            if (published) {
+                const landed = await FileSnapshot.acquire(requested, null);
+                if (landed === null || landed.stats.dev !== identity.dev || landed.stats.ino !== identity.ino
+                    || landed.revision.canonical !== canonical || landed.revision.hash !== contentHash(bytes)) {
+                    result = { status: "failed", published, cause: new Error("The published file changed before its projection could be recorded.") };
+                }
+                else {
+                    result = { status: "published", revision: landed.revision };
+                }
+            }
+        }
+        catch (cause) {
+            result = { status: "failed", published, cause };
+        }
+        finally {
+            if (directory !== undefined) {
+                try {
+                    await fs.rm(join(directory, "content"), { force: true });
+                    await fs.rmdir(directory);
+                }
+                catch (cause) {
+                    result = { status: "failed", published, cause: new AggregateError(result.status === "failed" ? [result.cause, cause] : [cause], "File staging cleanup failed.") };
+                }
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=FilePublication.js.map

package/dist/core/FilePublication.js.map

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

package/dist/core/FileSnapshot.d.ts

@@ -0,0 +1,26 @@
+import type { BigIntStats } from "node:fs";
+export interface FileRevision {
+    readonly canonical: string;
+    readonly fingerprint: string;
+    readonly hash: string | null;
+}
+export interface FileObservation {
+    readonly canonical: string;
+    readonly stats: BigIntStats;
+    readonly fingerprint: string;
+}
+export interface AcquiredFile extends FileObservation {
+    readonly revision: FileRevision;
+    readonly bytes: Buffer | null;
+}
+export default class FileSnapshot {
+    #private;
+    static serialize<T>(canonical: string, commit: () => Promise<T>): Promise<T>;
+    static fingerprint(st: BigIntStats): string;
+    static decode(encoded: string | null): FileRevision | null;
+    static matches(expected: FileRevision, observed: FileRevision): boolean;
+    static observe(path: string): Promise<FileObservation | null>;
+    static prospectivePath(requested: string): Promise<string>;
+    static acquire(path: string, maximumBytes: number | null): Promise<AcquiredFile | null>;
+}
+//# sourceMappingURL=FileSnapshot.d.ts.map

package/dist/core/FileSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSnapshot.d.ts","sourceRoot":"","sources":["../../src/core/FileSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACjD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAGD,MAAM,CAAC,OAAO,OAAO,YAAY;;IAG7B,OAAa,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWjF;IAED,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAE1C;IAED,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAQzD;IAED,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAItE;IAED,OAAa,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CASlE;IAGD,OAAa,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc/D;IAID,OAAa,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkC5F;CACJ"}

package/dist/core/FileSnapshot.js

@@ -0,0 +1,179 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import fs from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { basename, dirname, join } from "node:path";
+// {§file-snapshot-revision}, {§file-commit-serialization}, {§file-external-race}
+export default class FileSnapshot {
+    static #commits = new Map();
+    static async serialize(canonical, commit) {
+        const previous = FileSnapshot.#commits.get(canonical);
+        const released = Promise.withResolvers();
+        FileSnapshot.#commits.set(canonical, released.promise);
+        try {
+            await previous;
+            return await commit();
+        }
+        finally {
+            released.resolve();
+            if (FileSnapshot.#commits.get(canonical) === released.promise)
+                FileSnapshot.#commits.delete(canonical);
+        }
+    }
+    static fingerprint(st) {
+        return [st.dev, st.ino, st.size, st.mtimeNs, st.ctimeNs, st.mode, st.uid, st.gid, st.nlink].join(":");
+    }
+    static decode(encoded) {
+        if (encoded === null || encoded === "absent")
+            return null;
+        const revision = JSON.parse(encoded);
+        if (typeof revision.canonical !== "string" || typeof revision.fingerprint !== "string"
+            || (revision.hash !== null && typeof revision.hash !== "string")) {
+            throw new TypeError("A stored file revision is malformed.");
+        }
+        return revision;
+    }
+    static matches(expected, observed) {
+        return expected.canonical === observed.canonical
+            && expected.fingerprint === observed.fingerprint
+            && (expected.hash === null || expected.hash === observed.hash);
+    }
+    static async observe(path) {
+        try {
+            const canonical = await fs.realpath(path);
+            const stats = await fs.stat(canonical, { bigint: true });
+            return { canonical, stats, fingerprint: FileSnapshot.fingerprint(stats) };
+        }
+        catch (cause) {
+            if (cause.code === "ENOENT")
+                return null;
+            throw cause;
+        }
+    }
+    // Resolve an absent name through its nearest existing ancestor, including symlinked parents.
+    static async prospectivePath(requested) {
+        const tail = [basename(requested)];
+        let cursor = dirname(requested);
+        while (true) {
+            try {
+                return join(await fs.realpath(cursor), ...tail);
+            }
+            catch (cause) {
+                if (cause.code !== "ENOENT")
+                    throw cause;
+            }
+            const parent = dirname(cursor);
+            if (parent === cursor)
+                throw new Error(`No existing ancestor contains '${requested}'.`);
+            tail.unshift(basename(cursor));
+            cursor = parent;
+        }
+    }
+    // Read a fixed extent through one descriptor, then verify both that descriptor and its name.
+    // A growing file cannot turn the bounded snapshot into an unbounded read.
+    static async acquire(path, maximumBytes) {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
+            const observed = await FileSnapshot.observe(path);
+            if (observed === null || !observed.stats.isFile())
+                return null;
+            let handle;
+            try {
+                handle = await fs.open(observed.canonical, "r");
+            }
+            catch (cause) {
+                if (cause.code === "ENOENT")
+                    return null;
+                throw cause;
+            }
+            const descriptor = __addDisposableResource(env_1, handle, true);
+            const initial = await descriptor.stat({ bigint: true });
+            if (FileSnapshot.fingerprint(initial) !== observed.fingerprint)
+                return null;
+            if (maximumBytes !== null && initial.size > BigInt(maximumBytes))
+                return null;
+            const hash = createHash("sha256");
+            const chunks = [];
+            let length = 0;
+            if (initial.size > 0n) {
+                for await (const chunk of descriptor.createReadStream({ autoClose: false, start: 0, end: Number(initial.size) - 1 })) {
+                    const bytes = chunk;
+                    hash.update(bytes);
+                    length += bytes.length;
+                    if (maximumBytes !== null)
+                        chunks.push(bytes);
+                }
+            }
+            const final = await descriptor.stat({ bigint: true });
+            const current = await FileSnapshot.observe(path);
+            if (BigInt(length) !== initial.size || FileSnapshot.fingerprint(final) !== observed.fingerprint
+                || current?.canonical !== observed.canonical || current.fingerprint !== observed.fingerprint)
+                return null;
+            return {
+                ...observed,
+                revision: { canonical: observed.canonical, fingerprint: observed.fingerprint, hash: hash.digest("hex") },
+                bytes: maximumBytes !== null ? Buffer.concat(chunks, length) : null,
+            };
+        }
+        catch (e_1) {
+            env_1.error = e_1;
+            env_1.hasError = true;
+        }
+        finally {
+            const result_1 = __disposeResources(env_1);
+            if (result_1)
+                await result_1;
+        }
+    }
+}
+//# sourceMappingURL=FileSnapshot.js.map

package/dist/core/FileSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSnapshot.js","sourceRoot":"","sources":["../../src/core/FileSnapshot.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmBpD,iFAAiF;AACjF,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,MAAM,CAAU,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE5D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAI,SAAiB,EAAE,MAAwB;QACjE,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAC;QAC/C,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC;YACD,MAAM,QAAQ,CAAC;YACf,OAAO,MAAM,MAAM,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACP,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,OAAO;gBAAE,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3G,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,EAAe;QAC9B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAsB;QAChC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;QACrD,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ;eAC/E,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,QAAsB,EAAE,QAAsB;QACzD,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;eACzC,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;eAC7C,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAY;QAC7B,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACpE,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,6FAA6F;IAC7F,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,SAAiB;QAC1C,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACnC,IAAI,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,EAAE,CAAC;YACV,IAAI,CAAC;gBACD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAC;YACxE,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,MAAM,KAAK,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,IAAI,CAAC,CAAC;YACxF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/B,MAAM,GAAG,MAAM,CAAC;QACpB,CAAC;IACL,CAAC;IAED,6FAA6F;IAC7F,0EAA0E;IAC1E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,YAA2B;;;YAC1D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC/D,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACD,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBACpE,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,MAAY,UAAU,kCAAG,MAAM,OAAA,CAAC;YAChC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAC;YAC5E,IAAI,YAAY,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9E,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,IAAI,OAAO,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;gBACpB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACnH,MAAM,KAAK,GAAG,KAAe,CAAC;oBAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;oBACvB,IAAI,YAAY,KAAK,IAAI;wBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClD,CAAC;YACL,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,WAAW;mBACxF,OAAO,EAAE,SAAS,KAAK,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAC;YAC9G,OAAO;gBACH,GAAG,QAAQ;gBACX,QAAQ,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;gBACxG,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;aACtE,CAAC;;;;;;;;;;;IACN,CAAC;CACJ"}

package/dist/core/KillHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KillHandler.d.ts","sourceRoot":"","sources":["../../src/core/KillHandler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,aAAa,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,KAAK,iBAAiB,IAAI,wBAAwB,EAAE,KAAK,sBAAsB,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACrJ,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAI9E,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAC;AAE5D,MAAM,CAAC,OAAO,OAAO,WAAW;;IAY5B,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;QAC5I,EAAE,EAAE,EAAE,CAAC;QACP,OAAO,EAAE,cAAc,CAAC;QACxB,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,YAAY,EAAE,kBAAkB,GAAG,SAAS,CAAC;QAC7C,uBAAuB,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,EAAE,UAAU,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,sBAAsB,CAAC;YAAC,QAAQ,EAAE,cAAc,CAAC;YAAC,GAAG,EAAE,mBAAmB,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;SAAE,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAClO,iBAAiB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,KAAK,aAAa,GAAG,IAAI,CAAC;QAC/H,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;QAChH,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACzH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,cAAc,CAAC;KACzK,EAUA;IAGK,UAAU,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuJ9F;CAsBJ"}
+{"version":3,"file":"KillHandler.d.ts","sourceRoot":"","sources":["../../src/core/KillHandler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,aAAa,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,KAAK,iBAAiB,IAAI,wBAAwB,EAAE,KAAK,sBAAsB,IAAI,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACrJ,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAK9E,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAC;AAE5D,MAAM,CAAC,OAAO,OAAO,WAAW;;IAY5B,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;QAC5I,EAAE,EAAE,EAAE,CAAC;QACP,OAAO,EAAE,cAAc,CAAC;QACxB,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,YAAY,EAAE,kBAAkB,GAAG,SAAS,CAAC;QAC7C,uBAAuB,EAAE,CAAC,IAAI,EAAE;YAAE,MAAM,EAAE,UAAU,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,sBAAsB,CAAC;YAAC,QAAQ,EAAE,cAAc,CAAC;YAAC,GAAG,EAAE,mBAAmB,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;SAAE,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAClO,iBAAiB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,KAAK,aAAa,GAAG,IAAI,CAAC;QAC/H,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;QAChH,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAAE,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACzH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,cAAc,CAAC;KACzK,EAUA;IAGK,UAAU,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwJ9F;CAsBJ"}

package/dist/core/KillHandler.js

@@ -6,6 +6,7 @@ import { InvalidOperationResultError } from "@plurnk/plurnk-schemes";
 import ResourceBindings from "./ResourceBindings.js";
 import ExecOutputScheme from "../schemes/ExecOutputScheme.js";
 import ChannelWrite from "./ChannelWrite.js";
+import FileAddress from "./FileAddress.js";
 export default class KillHandler {
     #db;
     #schemes;
@@ -66,7 +67,7 @@ export default class KillHandler {
                 if (resolved.result !== null)
                     return resolved.result;
                 if (resolved.address === null) {
-                    const target = entryAddress(schemeName, coordinate.authority, coordinate.pathname);
+                    const target = entryAddress(schemeName, coordinate.authority, coordinate.pathname, schemeName === "file" ? await FileAddress.projectRoot(ctx) : null);
                     return this.#failure("entry-not-found", 404, missDetail(schemeName, target), {}, missExtensions(schemeName, target));
                 }
                 handlerCtx = new SchemeCtxImpl(ctx, resolved.address.scheme, manifest, this.#liveSubscriptions, {

package/dist/core/KillHandler.js.map

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

package/dist/core/LoopLifecycle.sql

@@ -169,8 +169,9 @@ SELECT 'ops://' || w.name || '/' || l.sequence AS resource
 FROM loops l JOIN workers w ON w.id = l.worker_id WHERE l.id = $loop_id;
 
 -- PREP: loop_live_obligations
--- {§worker-obligations}: the live work a loop is held on — its worker's open streams and live children.
-SELECT streams, workers FROM loop_obligations WHERE loop_id = $loop_id;
+-- {§worker-obligations}: the live work a loop is held on — its worker's open streams, live children, and the
+-- messages it sent to other workers that await completion.
+SELECT streams, workers, messages FROM loop_obligations WHERE loop_id = $loop_id;
 
 -- PREP: lifecycle_tree_budget
 -- {§turn-cap-counts-the-tree} — the budget of the worker tree a loop belongs to. The owner is

package/dist/core/MembershipMaterialization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MembershipMaterialization.d.ts","sourceRoot":"","sources":["../../src/core/MembershipMaterialization.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,KAAK,EAAE,YAAY,EAA4C,MAAM,qBAAqB,CAAC;AAqClG,MAAM,CAAC,OAAO,OAAO,yBAAyB;;IAU1C,OAAa,iBAAiB,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,mBAAmB,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GACzC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmH9B;CAuJJ"}
+{"version":3,"file":"MembershipMaterialization.d.ts","sourceRoot":"","sources":["../../src/core/MembershipMaterialization.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,KAAK,EAAE,YAAY,EAA4C,MAAM,qBAAqB,CAAC;AAuClG,MAAM,CAAC,OAAO,OAAO,yBAAyB;;IAE1C,OAAa,iBAAiB,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,mBAAmB,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GACzC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAuE9B;CA8GJ"}