@agent-teams/engineering-foundation 0.12.0 → 0.13.1

package/dist/transaction-coordination/adapters/node/node-foundation-operation-lock.js

@@ -0,0 +1,336 @@
+import { randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { open, rename, unlink } from "node:fs/promises";
+import { hostname } from "node:os";
+import { join } from "node:path";
+import { TextDecoder } from "node:util";
+import { FoundationError } from "../../../errors.js";
+import { LOCAL_OPERATION_LOCK } from "../../../foundation-state-contract.js";
+import { parseStrictJson } from "../../../strict-json.js";
+import { readBoundedRegularFile } from "../../../repository-mutation/adapters/node/node-bounded-regular-file.js";
+import { ensureFoundationStateDirectory, pruneFoundationStateDirectory, syncFoundationStateDirectory } from "./node-foundation-state-directory.js";
+const maximumLockBytes = 8 * 1024;
+const strictUtf8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+function isErrorCode(error, code) {
+    return (error instanceof Error &&
+        "code" in error &&
+        error.code === code);
+}
+function evidenceBytes(evidence) {
+    return Buffer.from(`${JSON.stringify(evidence)}\n`, "utf8");
+}
+function parseEvidence(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error("Foundation operation lock evidence is invalid.");
+    }
+    const candidate = value;
+    const tokenIsValid = typeof candidate["token"] === "string" &&
+        /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u.test(candidate["token"]);
+    if (candidate["schemaVersion"] === 1 &&
+        candidate["kind"] === "transaction-barrier" &&
+        tokenIsValid &&
+        Object.keys(candidate).toSorted().join(",") === "kind,schemaVersion,token") {
+        return {
+            kind: "transaction-barrier",
+            schemaVersion: 1,
+            token: candidate["token"]
+        };
+    }
+    if (candidate["schemaVersion"] !== 1 ||
+        candidate["kind"] !== "active" ||
+        !tokenIsValid ||
+        typeof candidate["host"] !== "string" ||
+        candidate["host"].length === 0 ||
+        !Number.isSafeInteger(candidate["pid"]) ||
+        candidate["pid"] <= 0 ||
+        Object.keys(candidate).toSorted().join(",") !==
+            "host,kind,pid,schemaVersion,token") {
+        throw new Error("Foundation operation lock evidence is invalid.");
+    }
+    return {
+        host: candidate["host"],
+        kind: "active",
+        pid: candidate["pid"],
+        schemaVersion: 1,
+        token: candidate["token"]
+    };
+}
+async function readLock(path) {
+    const record = await readBoundedRegularFile(path, maximumLockBytes);
+    if (record.outcome !== "read") {
+        throw new Error("Foundation operation lock must be a stable bounded regular file.");
+    }
+    return {
+        evidence: parseEvidence(parseStrictJson(strictUtf8.decode(record.bytes))),
+        identity: record.identity
+    };
+}
+function identitiesEqual(left, right) {
+    return (left.birthtimeNs === right.birthtimeNs &&
+        left.dev === right.dev &&
+        left.ino === right.ino);
+}
+function evidenceEqual(left, right) {
+    if (left.kind !== right.kind || left.token !== right.token) {
+        return false;
+    }
+    return left.kind === "transaction-barrier" ||
+        right.kind === "transaction-barrier"
+        ? left.kind === right.kind
+        : left.host === right.host && left.pid === right.pid;
+}
+async function readHandleEvidence(handle, expectedIdentity) {
+    const before = await handle.stat({ bigint: true });
+    if (!before.isFile() ||
+        before.size > BigInt(maximumLockBytes) ||
+        !identitiesEqual({
+            birthtimeNs: before.birthtimeNs,
+            dev: before.dev,
+            ino: before.ino
+        }, expectedIdentity)) {
+        throw new Error("Foundation operation lock identity changed before rewrite.");
+    }
+    const bytes = Buffer.alloc(Number(before.size));
+    let offset = 0;
+    while (offset < bytes.byteLength) {
+        const { bytesRead } = await handle.read(bytes, offset, bytes.byteLength - offset, offset);
+        if (bytesRead === 0) {
+            throw new Error("Foundation operation lock was truncated before rewrite.");
+        }
+        offset += bytesRead;
+    }
+    const after = await handle.stat({ bigint: true });
+    if (before.birthtimeNs !== after.birthtimeNs ||
+        before.ctimeNs !== after.ctimeNs ||
+        before.dev !== after.dev ||
+        before.ino !== after.ino ||
+        before.mtimeNs !== after.mtimeNs ||
+        before.size !== after.size) {
+        throw new Error("Foundation operation lock changed during rewrite verification.");
+    }
+    return parseEvidence(parseStrictJson(strictUtf8.decode(bytes)));
+}
+async function rewriteOwnedLockEvidence(lockPath, expected, replacement) {
+    const noFollow = process.platform === "win32" ? 0 : constants.O_NOFOLLOW;
+    const handle = await open(lockPath, constants.O_RDWR | noFollow);
+    try {
+        const current = await readHandleEvidence(handle, expected.identity);
+        if (!evidenceEqual(current, expected.evidence)) {
+            throw new Error("Foundation operation lock ownership changed before rewrite.");
+        }
+        const bytes = evidenceBytes(replacement);
+        await handle.truncate(0);
+        let offset = 0;
+        while (offset < bytes.byteLength) {
+            const { bytesWritten } = await handle.write(bytes, offset, bytes.byteLength - offset, offset);
+            if (bytesWritten === 0) {
+                throw new Error("Foundation operation lock rewrite made no progress.");
+            }
+            offset += bytesWritten;
+        }
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    const observed = await readLock(lockPath);
+    if (!evidenceEqual(observed.evidence, replacement) ||
+        !identitiesEqual(observed.identity, expected.identity)) {
+        throw new Error("Foundation operation lock rewrite was not published.");
+    }
+    return observed.identity;
+}
+function activeOwnerIsAlive(owner) {
+    if (owner.host !== hostname()) {
+        return undefined;
+    }
+    try {
+        process.kill(owner.pid, 0);
+        return true;
+    }
+    catch (error) {
+        return isErrorCode(error, "ESRCH") ? false : undefined;
+    }
+}
+async function createOwnedLock(directory, lockPath) {
+    const evidence = {
+        host: hostname(),
+        kind: "active",
+        pid: process.pid,
+        schemaVersion: 1,
+        token: randomUUID()
+    };
+    const handle = await open(lockPath, "wx", 0o600);
+    try {
+        await handle.writeFile(evidenceBytes(evidence));
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    await syncFoundationStateDirectory(directory);
+    const observed = await readLock(lockPath);
+    if (observed.evidence.kind !== "active" ||
+        observed.evidence.token !== evidence.token) {
+        throw new Error("Foundation operation lock ownership was not published.");
+    }
+    return { evidence, identity: observed.identity };
+}
+async function takeoverLock(directory, lockPath) {
+    const expected = await readLock(lockPath);
+    if (expected.evidence.kind === "active" &&
+        activeOwnerIsAlive(expected.evidence) !== false) {
+        throw new Error("Foundation operation lock owner is live or cannot be proven dead.");
+    }
+    const evidence = {
+        host: hostname(),
+        kind: "active",
+        pid: process.pid,
+        schemaVersion: 1,
+        token: randomUUID()
+    };
+    const claimPath = `${lockPath}.claim.${expected.evidence.token}`;
+    let claimHeld = false;
+    let ownershipPublished = false;
+    try {
+        try {
+            const claimHandle = await open(claimPath, "wx", 0o600);
+            try {
+                await claimHandle.writeFile(evidenceBytes(evidence));
+                await claimHandle.sync();
+            }
+            finally {
+                await claimHandle.close();
+            }
+            await syncFoundationStateDirectory(directory);
+            claimHeld = true;
+        }
+        catch (error) {
+            if (isErrorCode(error, "EEXIST")) {
+                throw new Error("Foundation operation-lock takeover claim requires manual recovery.", { cause: error });
+            }
+            throw error;
+        }
+        const observed = await readLock(lockPath);
+        if (!evidenceEqual(observed.evidence, expected.evidence) ||
+            !identitiesEqual(observed.identity, expected.identity)) {
+            throw new Error("Foundation operation lock changed during takeover.");
+        }
+        const rewrittenIdentity = await rewriteOwnedLockEvidence(lockPath, observed, evidence);
+        await syncFoundationStateDirectory(directory);
+        const current = await readLock(lockPath);
+        if (current.evidence.kind !== "active" ||
+            current.evidence.token !== evidence.token ||
+            !identitiesEqual(current.identity, rewrittenIdentity)) {
+            throw new Error("Foundation operation-lock takeover was not published.");
+        }
+        ownershipPublished = true;
+        return { evidence, identity: current.identity };
+    }
+    finally {
+        if (claimHeld) {
+            await unlink(claimPath).catch((error) => {
+                if (!ownershipPublished && !isErrorCode(error, "ENOENT")) {
+                    throw error;
+                }
+            });
+        }
+    }
+}
+async function quarantineObservedLock(directory, lockPath, observed, phase) {
+    const quarantinePath = `${lockPath}.${phase}.${observed.evidence.token}`;
+    await rename(lockPath, quarantinePath);
+    const quarantined = await readLock(quarantinePath);
+    if (quarantined.evidence.token !== observed.evidence.token ||
+        !identitiesEqual(quarantined.identity, observed.identity)) {
+        throw new Error("Foundation operation lock ownership changed during cleanup.");
+    }
+    await syncFoundationStateDirectory(directory);
+    return quarantinePath;
+}
+async function retainTransactionBarrier(directory, lockPath, owned) {
+    const current = await readLock(lockPath);
+    if (current.evidence.kind !== "active" ||
+        current.evidence.token !== owned.evidence.token ||
+        !identitiesEqual(current.identity, owned.identity)) {
+        throw new Error("Foundation operation lock ownership changed before retention.");
+    }
+    const barrier = {
+        kind: "transaction-barrier",
+        schemaVersion: 1,
+        token: owned.evidence.token
+    };
+    const beforePublish = await readLock(lockPath);
+    if (beforePublish.evidence.kind !== "active" ||
+        beforePublish.evidence.token !== owned.evidence.token ||
+        !identitiesEqual(beforePublish.identity, owned.identity)) {
+        throw new Error("Foundation operation lock ownership changed during retention.");
+    }
+    await rewriteOwnedLockEvidence(lockPath, beforePublish, barrier);
+    await syncFoundationStateDirectory(directory);
+}
+export class NodeFoundationOperationLock {
+    #consumerRoot;
+    constructor(consumerRoot) {
+        this.#consumerRoot = consumerRoot;
+    }
+    async acquire() {
+        const directory = await ensureFoundationStateDirectory(this.#consumerRoot);
+        const lockPath = join(directory, LOCAL_OPERATION_LOCK);
+        let owned;
+        try {
+            try {
+                owned = await createOwnedLock(directory, lockPath);
+            }
+            catch (error) {
+                if (!isErrorCode(error, "EEXIST")) {
+                    throw error;
+                }
+                owned = await takeoverLock(directory, lockPath);
+            }
+        }
+        catch (error) {
+            throw new FoundationError("LOCAL_STATE_INVALID", "Another foundation operation is active or its lock is not safely recoverable.", { cause: error });
+        }
+        let state = "held";
+        let releaseInProgress;
+        return async (options = {}) => {
+            if (state === "released") {
+                return;
+            }
+            releaseInProgress ??= (async () => {
+                try {
+                    if (options.retainTransactionBarrier === true) {
+                        await retainTransactionBarrier(directory, lockPath, owned);
+                        state = "released";
+                        await syncFoundationStateDirectory(directory);
+                        return;
+                    }
+                    const current = await readLock(lockPath);
+                    if (current.evidence.kind !== "active" ||
+                        current.evidence.token !== owned.evidence.token ||
+                        !identitiesEqual(current.identity, owned.identity)) {
+                        throw new Error("Foundation operation lock ownership was lost before release.");
+                    }
+                    const quarantinePath = await quarantineObservedLock(directory, lockPath, current, "released");
+                    state = "released";
+                    await unlink(quarantinePath);
+                    await syncFoundationStateDirectory(directory);
+                    await pruneFoundationStateDirectory(this.#consumerRoot);
+                    await syncFoundationStateDirectory(this.#consumerRoot);
+                }
+                catch (error) {
+                    throw new FoundationError("LOCAL_STATE_INVALID", "Foundation operation lock could not be released without violating ownership.", { cause: error });
+                }
+            })();
+            try {
+                await releaseInProgress;
+            }
+            catch (error) {
+                releaseInProgress = undefined;
+                throw error;
+            }
+        };
+    }
+}
+//# sourceMappingURL=node-foundation-operation-lock.js.map

package/dist/transaction-coordination/adapters/node/node-foundation-operation-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-foundation-operation-lock.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-operation-lock.ts"],"names":[],"mappings":"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"}

package/dist/transaction-coordination/adapters/node/node-foundation-state-directory.d.ts

@@ -0,0 +1,4 @@
+export declare function ensureFoundationStateDirectory(consumerRoot: string): Promise<string>;
+export declare function syncFoundationStateDirectory(path: string): Promise<void>;
+export declare function pruneFoundationStateDirectory(consumerRoot: string): Promise<void>;
+//# sourceMappingURL=node-foundation-state-directory.d.ts.map

package/dist/transaction-coordination/adapters/node/node-foundation-state-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-foundation-state-directory.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-state-directory.ts"],"names":[],"mappings":"AAMA,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B9E;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/transaction-coordination/adapters/node/node-foundation-state-directory.js

@@ -0,0 +1,76 @@
+import { lstat, mkdir, open, realpath, rmdir } from "node:fs/promises";
+import { join } from "node:path";
+import { FoundationError } from "../../../errors.js";
+import { LOCAL_STATE_DIRECTORY } from "../../../foundation-state-contract.js";
+export async function ensureFoundationStateDirectory(consumerRoot) {
+    const directory = join(consumerRoot, LOCAL_STATE_DIRECTORY);
+    try {
+        const entry = await lstat(directory);
+        if (!entry.isDirectory() || entry.isSymbolicLink()) {
+            throw new FoundationError("LOCAL_STATE_INVALID", "Local foundation state path must be a real consumer-owned directory.");
+        }
+        if ((await realpath(directory)) !== directory) {
+            throw new FoundationError("LOCAL_STATE_INVALID", "Local foundation state directory resolves outside its expected path.");
+        }
+        return directory;
+    }
+    catch (error) {
+        if (!(error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT")) {
+            throw error;
+        }
+    }
+    try {
+        await mkdir(directory);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "EEXIST") {
+            return ensureFoundationStateDirectory(consumerRoot);
+        }
+        throw error;
+    }
+    await syncFoundationStateDirectory(consumerRoot);
+    return directory;
+}
+export async function syncFoundationStateDirectory(path) {
+    try {
+        const handle = await open(path, "r");
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return;
+        }
+        if (process.platform === "win32" &&
+            error instanceof Error &&
+            "code" in error &&
+            ["EACCES", "EINVAL", "EISDIR", "EPERM"].includes(error.code ?? "")) {
+            return;
+        }
+        throw error;
+    }
+}
+export async function pruneFoundationStateDirectory(consumerRoot) {
+    try {
+        await rmdir(join(consumerRoot, LOCAL_STATE_DIRECTORY));
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            ["ENOENT", "ENOTEMPTY"].includes(error.code ?? "")) {
+            return;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=node-foundation-state-directory.js.map

package/dist/transaction-coordination/adapters/node/node-foundation-state-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-foundation-state-directory.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-state-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,YAAoB;IAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,eAAe,CACvB,qBAAqB,EACrB,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9C,MAAM,IAAI,eAAe,CACvB,qBAAqB,EACrB,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,CAAC,CACC,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACd,KAA+B,CAAC,IAAI,KAAK,QAAQ,CACnD,EACD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACd,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAClD,CAAC;YACD,OAAO,8BAA8B,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,4BAA4B,CAAC,YAAY,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,IAAY;IAC7D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACd,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAClD,CAAC;YACD,OAAO;QACT,CAAC;QACD,IACE,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC5B,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACf,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAC7C,KAA+B,CAAC,IAAI,IAAI,EAAE,CAC5C,EACD,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACf,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAC7B,KAA+B,CAAC,IAAI,IAAI,EAAE,CAC5C,EACD,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-coordinator.d.ts

@@ -0,0 +1,3 @@
+import { FoundationTransactionCoordinator } from "../../application/foundation-transaction-coordinator.js";
+export declare function createNodeFoundationTransactionCoordinator(consumerRoot: string): Promise<FoundationTransactionCoordinator>;
+//# sourceMappingURL=node-foundation-transaction-coordinator.d.ts.map

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-foundation-transaction-coordinator.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-transaction-coordinator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gCAAgC,EAAE,MAAM,yDAAyD,CAAC;AAK3G,wBAAsB,0CAA0C,CAC9D,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gCAAgC,CAAC,CAc3C"}

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-coordinator.js

@@ -0,0 +1,23 @@
+import { realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+import { installedFoundationVersion } from "../../../package-version.js";
+import { FoundationTransactionCoordinator } from "../../application/foundation-transaction-coordinator.js";
+import { installedFoundationBuildIdentity } from "./installed-foundation-build-identity.js";
+import { NodeFoundationOperationLock } from "./node-foundation-operation-lock.js";
+import { NodeFoundationTransactionSlot } from "./node-foundation-transaction-slot.js";
+export async function createNodeFoundationTransactionCoordinator(consumerRoot) {
+    const canonicalRoot = await realpath(resolve(consumerRoot));
+    const [installedVersion, installedBuildIdentity] = await Promise.all([
+        installedFoundationVersion(),
+        installedFoundationBuildIdentity()
+    ]);
+    return new FoundationTransactionCoordinator({
+        lock: new NodeFoundationOperationLock(canonicalRoot),
+        slot: new NodeFoundationTransactionSlot({
+            consumerRoot: canonicalRoot,
+            installedVersion,
+            installedBuildIdentity
+        })
+    });
+}
+//# sourceMappingURL=node-foundation-transaction-coordinator.js.map

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-foundation-transaction-coordinator.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-transaction-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,gCAAgC,EAAE,MAAM,yDAAyD,CAAC;AAC3G,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,0CAA0C,CAC9D,YAAoB;IAEpB,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnE,0BAA0B,EAAE;QAC5B,gCAAgC,EAAE;KACnC,CAAC,CAAC;IACH,OAAO,IAAI,gCAAgC,CAAC;QAC1C,IAAI,EAAE,IAAI,2BAA2B,CAAC,aAAa,CAAC;QACpD,IAAI,EAAE,IAAI,6BAA6B,CAAC;YACtC,YAAY,EAAE,aAAa;YAC3B,gBAAgB;YAChB,sBAAsB;SACvB,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-slot.d.ts

@@ -0,0 +1,12 @@
+import type { FoundationTransactionStatus } from "../../application/model/transaction-status.js";
+import type { FoundationTransactionSlot } from "../../application/ports/foundation-transaction-slot.js";
+export declare class NodeFoundationTransactionSlot implements FoundationTransactionSlot {
+    #private;
+    constructor(options: {
+        readonly consumerRoot: string;
+        readonly installedBuildIdentity: string;
+        readonly installedVersion: string;
+    });
+    inspect(): Promise<FoundationTransactionStatus>;
+}
+//# sourceMappingURL=node-foundation-transaction-slot.d.ts.map

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-foundation-transaction-slot.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-transaction-slot.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAIV,2BAA2B,EAC5B,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AAuWxG,qBAAa,6BAA8B,YAAW,yBAAyB;;IAO7E,YAAY,OAAO,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;KACnC,EAUA;IA6CK,OAAO,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAYpD;CACF"}