@agent-teams/engineering-foundation 0.17.0-rc.0 → 0.17.0-rc.2

package/dist/repository-mutation/adapters/node/node-bounded-regular-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-bounded-regular-file.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-bounded-regular-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,0CAA0C,CAAC;AAElD,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,mCAAmC,GAAG,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAiF3B,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,mCAAmC,GAClD,OAAO,CAAC,sBAAsB,CAAC,CAkDjC;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAkB5B"}
+{"version":3,"file":"node-bounded-regular-file.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-bounded-regular-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,0CAA0C,CAAC;AAElD,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,mCAAmC,GAAG,CAAC,KAAK,EAAE;IACxD,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAmF3B,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,mCAAmC,GAClD,OAAO,CAAC,sBAAsB,CAAC,CA0BjC;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,mCAAmC,GAClD,OAAO,CAAC,sBAAsB,CAAC,CA8BjC;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAkB5B"}

package/dist/repository-mutation/adapters/node/node-bounded-regular-file.js

@@ -31,6 +31,7 @@ function sameFileObservation(left, right) {
         left.birthtimeNs === right.birthtimeNs &&
         left.ctimeNs === right.ctimeNs &&
         left.mtimeNs === right.mtimeNs &&
+        left.nlink === right.nlink &&
         left.size === right.size);
 }
 async function readAtMost(handle, maximumBytes) {
@@ -69,34 +70,41 @@ export async function readBoundedRegularFile(path, maximumBytes, faultInjector)
         throw error;
     }
     try {
-        const before = await handle.stat({ bigint: true });
-        if (!before.isFile() || before.size > BigInt(maximumBytes)) {
-            return { outcome: "invalid" };
-        }
-        const identity = identityFromStat(before);
-        const bytes = await readAtMost(handle, maximumBytes);
-        if (bytes === undefined) {
-            return { outcome: "invalid" };
-        }
-        await faultInjector?.({ phase: "before-stability-check", path });
-        const after = await handle.stat({ bigint: true });
-        if (!after.isFile() ||
-            !sameFileObservation(before, after) ||
-            after.size !== BigInt(bytes.byteLength) ||
-            (await pathMatchesRegularFileIdentity(path, identity)) !== "match") {
-            return { outcome: "changed" };
-        }
-        return {
-            outcome: "read",
-            bytes,
-            identity,
-            mode: Number(after.mode)
-        };
+        return await readBoundedRegularFileHandle(handle, path, maximumBytes, faultInjector);
     }
     finally {
         await handle.close();
     }
 }
+export async function readBoundedRegularFileHandle(handle, path, maximumBytes, faultInjector) {
+    if (!Number.isSafeInteger(maximumBytes) || maximumBytes < 0) {
+        throw new TypeError("maximumBytes must be a non-negative safe integer.");
+    }
+    const before = await handle.stat({ bigint: true });
+    if (!before.isFile() || before.size > BigInt(maximumBytes)) {
+        return { outcome: "invalid" };
+    }
+    const identity = identityFromStat(before);
+    const bytes = await readAtMost(handle, maximumBytes);
+    if (bytes === undefined) {
+        return { outcome: "invalid" };
+    }
+    await faultInjector?.({ phase: "before-stability-check", path });
+    const after = await handle.stat({ bigint: true });
+    if (!after.isFile() ||
+        !sameFileObservation(before, after) ||
+        after.size !== BigInt(bytes.byteLength) ||
+        (await pathMatchesRegularFileIdentity(path, identity)) !== "match") {
+        return { outcome: "changed" };
+    }
+    return {
+        outcome: "read",
+        bytes,
+        identity,
+        linkCount: after.nlink,
+        mode: Number(after.mode)
+    };
+}
 export async function captureFileHandleIdentity(handle) {
     return identityFromStat(await handle.stat({ bigint: true }));
 }

package/dist/repository-mutation/adapters/node/node-bounded-regular-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-bounded-regular-file.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-bounded-regular-file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-bounded-regular-file.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-bounded-regular-file.ts"],"names":[],"mappings":"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"}

package/dist/repository-mutation/adapters/node/node-known-file-recovery-filesystem.d.ts

@@ -0,0 +1,28 @@
+import type { KnownFileImageV1 } from "../../application/model/known-file-transaction.js";
+import type { KnownFileTransactionJournalV1 } from "../../application/model/known-file-transaction-journal.js";
+import { deserializeKnownFileIdentity } from "../../application/model/known-file-transaction-journal.js";
+import { captureFileHandleIdentity } from "./node-bounded-regular-file.js";
+import { type ObservedKnownFile } from "./node-known-file-transaction-filesystem.js";
+export declare function knownFileCapturePaths(options: {
+    readonly operationPath: string;
+    readonly operationIndex: number;
+    readonly parent: string;
+    readonly planDigest: string;
+}): {
+    readonly captured: string;
+    readonly directory: string;
+    readonly retired: string;
+};
+export declare function cleanupCommittedKnownFileCaptures(root: string, journal: KnownFileTransactionJournalV1, faultInjector?: (point: {
+    readonly operationIndex: number;
+    readonly path: string;
+    readonly phase: "after-committed-capture-unlinked";
+}) => Promise<void> | void): Promise<void>;
+export declare function observeRecoveryFile(path: string, maximumBytes: number): Promise<ObservedKnownFile>;
+export declare function prepareRollbackTemporary(options: {
+    readonly expectedIdentity?: ReturnType<typeof deserializeKnownFileIdentity>;
+    readonly operationPath: string;
+    readonly path: string;
+    readonly preimage: KnownFileImageV1;
+}): Promise<Awaited<ReturnType<typeof captureFileHandleIdentity>>>;
+//# sourceMappingURL=node-known-file-recovery-filesystem.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-recovery-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-recovery-filesystem.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-recovery-filesystem.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2DAA2D,CAAC;AAC/G,OAAO,EAAE,4BAA4B,EAAE,MAAM,2DAA2D,CAAC;AACzG,OAAO,EACL,yBAAyB,EAG1B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,6CAA6C,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAWtF;AAuBD,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,6BAA6B,EACtC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,kCAAkC,CAAC;CACpD,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACzB,OAAO,CAAC,IAAI,CAAC,CA6Ff;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;IAC5E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC,CAuFjE"}

package/dist/repository-mutation/adapters/node/node-known-file-recovery-filesystem.js

@@ -0,0 +1,194 @@
+import { constants, lstat, open, readdir, rmdir, unlink } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { deserializeKnownFileIdentity } from "../../application/model/known-file-transaction-journal.js";
+import { captureFileHandleIdentity, readBoundedRegularFile, readBoundedRegularFileHandle } from "./node-bounded-regular-file.js";
+import { syncDirectoryStrictly } from "./node-directory-durability.js";
+import { knownFileErrorCode, knownFileCaptureDirectoryName, knownFileImageBytes, KnownFileTransactionError, matchesKnownFileImage, sameKnownFileIdentity } from "./node-known-file-transaction-filesystem.js";
+export function knownFileCapturePaths(options) {
+    const directory = join(options.parent, knownFileCaptureDirectoryName(options.operationPath, options.planDigest, options.operationIndex));
+    return {
+        captured: join(directory, "preimage"),
+        directory,
+        retired: join(directory, "retired")
+    };
+}
+async function assertCaptureDirectoryIdentity(path, expected, displayPath) {
+    const metadata = await lstat(path, { bigint: true }).catch((error) => {
+        if (knownFileErrorCode(error) === "ENOENT") {
+            return null;
+        }
+        throw error;
+    });
+    if (metadata === null) {
+        return false;
+    }
+    if (!metadata.isDirectory() || metadata.isSymbolicLink() ||
+        metadata.birthtimeNs !== expected.birthtimeNs || metadata.dev !== expected.dev ||
+        metadata.ino !== expected.ino) {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Transaction capture directory changed: ${displayPath}.`);
+    }
+    return true;
+}
+export async function cleanupCommittedKnownFileCaptures(root, journal, faultInjector) {
+    for (const [index, journalOperation] of journal.operations.entries()) {
+        if (!("temporaryIdentity" in journalOperation) ||
+            journalOperation.captureDirectoryIdentity === undefined) {
+            continue;
+        }
+        const operation = journal.plan.operations[index];
+        const parent = dirname(join(root, ...operation.path.split("/")));
+        const paths = knownFileCapturePaths({
+            operationIndex: index,
+            operationPath: operation.path,
+            parent,
+            planDigest: journal.plan.planDigest
+        });
+        if (operation.precondition.state !== "known-file" ||
+            journalOperation.matchedPreimage === undefined) {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Committed replacement lacks exact preimage authority: ${operation.path}.`);
+        }
+        const preimage = operation.precondition.acceptedPreimages[journalOperation.matchedPreimage];
+        if (journalOperation.rollbackTemporaryIdentity !== undefined) {
+            const rollbackPath = join(parent, `.${basename(operation.path)}.agent-teams.rollback.${index}.tmp`);
+            const rollback = await observeRecoveryFile(rollbackPath, preimage.size);
+            if (rollback.state === "file") {
+                const expectedRollback = deserializeKnownFileIdentity(journalOperation.rollbackTemporaryIdentity);
+                if (rollback.identity === undefined ||
+                    !sameKnownFileIdentity(rollback.identity, expectedRollback) ||
+                    !matchesKnownFileImage(rollback, preimage)) {
+                    throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Committed rollback copy changed: ${operation.path}.`);
+                }
+                await unlink(rollbackPath);
+                await syncDirectoryStrictly(parent);
+            }
+        }
+        const expectedDirectory = deserializeKnownFileIdentity(journalOperation.captureDirectoryIdentity);
+        const directoryExists = await assertCaptureDirectoryIdentity(paths.directory, expectedDirectory, operation.path);
+        if (!directoryExists) {
+            continue;
+        }
+        const entries = (await readdir(paths.directory)).toSorted();
+        if (entries.length === 0) {
+            await rmdir(paths.directory);
+            await syncDirectoryStrictly(parent);
+            continue;
+        }
+        if (journalOperation.capturedPreimageIdentity === undefined) {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Committed replacement lacks captured preimage authority: ${operation.path}.`);
+        }
+        const captured = await readBoundedRegularFile(paths.captured, operation.precondition.acceptedPreimages[journalOperation.matchedPreimage].size);
+        const expectedCaptured = deserializeKnownFileIdentity(journalOperation.capturedPreimageIdentity);
+        if (captured.outcome !== "read" ||
+            !sameKnownFileIdentity(captured.identity, expectedCaptured) ||
+            !matchesKnownFileImage({
+                state: "file", bytes: captured.bytes, identity: captured.identity,
+                mode: captured.mode & 0o777
+            }, preimage)) {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Committed captured preimage changed: ${operation.path}.`);
+        }
+        if (entries.join(",") !== "preimage") {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Committed capture directory contains foreign evidence: ${operation.path}.`);
+        }
+        await unlink(paths.captured);
+        await syncDirectoryStrictly(paths.directory);
+        await faultInjector?.({
+            operationIndex: index,
+            path: operation.path,
+            phase: "after-committed-capture-unlinked"
+        });
+        await rmdir(paths.directory);
+        await syncDirectoryStrictly(parent);
+    }
+}
+export async function observeRecoveryFile(path, maximumBytes) {
+    let observed;
+    try {
+        observed = await readBoundedRegularFile(path, maximumBytes);
+    }
+    catch (error) {
+        if (knownFileErrorCode(error) === "ENOENT") {
+            return { state: "absent" };
+        }
+        throw error;
+    }
+    if (observed.outcome !== "read") {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", "Recovery path is not one stable bounded regular file.");
+    }
+    return {
+        state: "file",
+        bytes: observed.bytes,
+        identity: observed.identity,
+        mode: observed.mode & 0o777
+    };
+}
+export async function prepareRollbackTemporary(options) {
+    let handle;
+    let rollbackIdentity;
+    let created = false;
+    try {
+        handle = await open(options.path, "wx", 0o600);
+        created = true;
+        rollbackIdentity = await captureFileHandleIdentity(handle);
+    }
+    catch (error) {
+        if (knownFileErrorCode(error) !== "EEXIST") {
+            throw error;
+        }
+        if (options.expectedIdentity === undefined) {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Rollback temporary exists without durable identity authority: ${options.operationPath}.`);
+        }
+        const noFollow = process.platform === "win32" ? 0 : constants.O_NOFOLLOW;
+        handle = await open(options.path, constants.O_RDWR | noFollow);
+        try {
+            const stale = await readBoundedRegularFileHandle(handle, options.path, options.preimage.size);
+            if (stale.outcome !== "read" || !matchesKnownFileImage({
+                state: "file", bytes: stale.bytes, identity: stale.identity,
+                mode: stale.mode & 0o777
+            }, options.preimage)) {
+                throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Rollback temporary is foreign or modified: ${options.operationPath}.`);
+            }
+            rollbackIdentity = await captureFileHandleIdentity(handle);
+            if (!sameKnownFileIdentity(rollbackIdentity, stale.identity) ||
+                !sameKnownFileIdentity(rollbackIdentity, options.expectedIdentity)) {
+                throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Rollback temporary changed while it was opened: ${options.operationPath}.`);
+            }
+        }
+        catch (inspectionError) {
+            await handle.close();
+            throw inspectionError;
+        }
+    }
+    if (created) {
+        try {
+            const bytes = knownFileImageBytes(options.preimage);
+            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 KnownFileTransactionError("KNOWN_FILE_RECOVERY_FAILED", `Rollback temporary write made no progress: ${options.operationPath}.`);
+                }
+                offset += bytesWritten;
+            }
+            await handle.chmod(options.preimage.mode);
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    else {
+        await handle.close();
+    }
+    const prepared = await readBoundedRegularFile(options.path, options.preimage.size);
+    if (prepared.outcome !== "read" ||
+        !sameKnownFileIdentity(prepared.identity, rollbackIdentity) ||
+        !matchesKnownFileImage({
+            state: "file", bytes: prepared.bytes, identity: prepared.identity,
+            mode: prepared.mode & 0o777
+        }, options.preimage)) {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Rollback temporary changed before publication: ${options.operationPath}.`);
+    }
+    return rollbackIdentity;
+}
+//# sourceMappingURL=node-known-file-recovery-filesystem.js.map

package/dist/repository-mutation/adapters/node/node-known-file-recovery-filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-recovery-filesystem.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-recovery-filesystem.ts"],"names":[],"mappings":"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"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction-filesystem.d.ts

@@ -0,0 +1,25 @@
+import type { KnownFileImageV1, KnownFileTransactionPlanV1 } from "../../application/model/known-file-transaction.js";
+import type { KnownFileTransactionJournalOperationV1 } from "../../application/model/known-file-transaction-journal.js";
+import { captureFileHandleIdentity } from "./node-bounded-regular-file.js";
+export declare class KnownFileTransactionError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: ErrorOptions);
+}
+export interface ObservedKnownFile {
+    readonly state: "absent" | "file";
+    readonly bytes?: Buffer;
+    readonly identity?: Awaited<ReturnType<typeof captureFileHandleIdentity>>;
+    readonly mode?: number;
+}
+export declare function knownFileErrorCode(error: unknown): string | undefined;
+export declare function sameKnownFileIdentity(left: Awaited<ReturnType<typeof captureFileHandleIdentity>>, right: Awaited<ReturnType<typeof captureFileHandleIdentity>>): boolean;
+export declare function knownFileImageBytes(image: KnownFileImageV1): Buffer;
+export declare function matchesKnownFileImage(observed: ObservedKnownFile, image: KnownFileImageV1): boolean;
+export declare function knownFileTemporaryName(path: string, planDigest: string, operationIndex: number): string;
+export declare function knownFileCaptureDirectoryName(path: string, planDigest: string, operationIndex: number): string;
+export declare function canonicalKnownFileRoot(consumerRoot: string): Promise<string>;
+export declare function knownFileAliasEntry(parent: string, requested: string): Promise<string | undefined>;
+export declare function observeKnownFile(root: string, repositoryPath: string, maximumBytes: number): Promise<ObservedKnownFile>;
+export declare function maximumKnownFileEvidenceBytes(operation: KnownFileTransactionPlanV1["operations"][number]): number;
+export declare function classifyKnownFileOperation(operation: KnownFileTransactionPlanV1["operations"][number], observed: ObservedKnownFile): KnownFileTransactionJournalOperationV1;
+//# sourceMappingURL=node-known-file-transaction-filesystem.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction-filesystem.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction-filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,2DAA2D,CAAC;AAKxH,OAAO,EACL,yBAAyB,EAE1B,MAAM,gCAAgC,CAAC;AAKxC,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAmB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAIvE;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIrE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,EAC3D,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,GAC3D,OAAO,CAGT;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEnE;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAKT;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAED,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlF;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAuCD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAqC5B;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,GAC1D,MAAM,CAOR;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,EAC3D,QAAQ,EAAE,iBAAiB,GAC1B,sCAAsC,CAuBxC"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction-filesystem.js

@@ -0,0 +1,129 @@
+import { createHash } from "node:crypto";
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { portableRepositoryPathIdentity, portableRepositoryPathProblem } from "../../application/model/repository-path.js";
+import { captureFileHandleIdentity, readBoundedRegularFile } from "./node-bounded-regular-file.js";
+import { isLexicallyContainedPath } from "./node-repository-path.js";
+const MAXIMUM_MANAGED_FILE_BYTES = 8 * 1024 * 1024;
+export class KnownFileTransactionError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "KnownFileTransactionError";
+        this.code = code;
+    }
+}
+export function knownFileErrorCode(error) {
+    return error instanceof Error && "code" in error
+        ? error.code
+        : undefined;
+}
+export function sameKnownFileIdentity(left, right) {
+    return left.birthtimeNs === right.birthtimeNs &&
+        left.dev === right.dev && left.ino === right.ino;
+}
+export function knownFileImageBytes(image) {
+    return Buffer.from(image.contentBase64, "base64");
+}
+export function matchesKnownFileImage(observed, image) {
+    return observed.state === "file" && observed.bytes !== undefined &&
+        observed.bytes.byteLength === image.size &&
+        `sha256:${createHash("sha256").update(observed.bytes).digest("hex")}` === image.digest &&
+        observed.mode === image.mode;
+}
+export function knownFileTemporaryName(path, planDigest, operationIndex) {
+    return `.${basename(path)}.agent-teams.${planDigest.slice(7, 23)}.${operationIndex}.tmp`;
+}
+export function knownFileCaptureDirectoryName(path, planDigest, operationIndex) {
+    return `.${basename(path)}.agent-teams.capture.${planDigest.slice(7, 23)}.${operationIndex}`;
+}
+export async function canonicalKnownFileRoot(consumerRoot) {
+    const requested = resolve(consumerRoot);
+    const metadata = await lstat(requested);
+    if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+        throw new KnownFileTransactionError("KNOWN_FILE_ROOT_INVALID", "Consumer root must be one real directory, not a symlink.");
+    }
+    return realpath(requested);
+}
+export async function knownFileAliasEntry(parent, requested) {
+    const identity = portableRepositoryPathIdentity(requested);
+    const matches = (await readdir(parent)).filter((entry) => portableRepositoryPathIdentity(entry) === identity);
+    if (matches.some((entry) => entry !== requested)) {
+        throw new KnownFileTransactionError("KNOWN_FILE_PATH_ALIAS", `Portable case or Unicode path collision blocks ${requested}.`);
+    }
+    return matches.find((entry) => entry === requested);
+}
+async function resolveExistingParent(root, repositoryPath) {
+    const problem = portableRepositoryPathProblem(repositoryPath);
+    if (problem !== undefined) {
+        throw new KnownFileTransactionError("KNOWN_FILE_PATH_INVALID", `Repository path is not portable (${problem}): ${repositoryPath}.`);
+    }
+    const segments = repositoryPath.split("/");
+    segments.pop();
+    let current = root;
+    for (const segment of segments) {
+        if (await knownFileAliasEntry(current, segment) === undefined) {
+            return { absolute: current, complete: false };
+        }
+        current = join(current, segment);
+        const metadata = await lstat(current);
+        if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+            throw new KnownFileTransactionError("KNOWN_FILE_ANCESTOR_INVALID", `Repository ancestor must be one real directory: ${repositoryPath}.`);
+        }
+        const canonical = await realpath(current);
+        if (!isLexicallyContainedPath(root, canonical) || canonical !== current) {
+            throw new KnownFileTransactionError("KNOWN_FILE_PATH_ESCAPE", `Repository ancestor escapes or aliases the root: ${repositoryPath}.`);
+        }
+    }
+    return { absolute: current, complete: true };
+}
+export async function observeKnownFile(root, repositoryPath, maximumBytes) {
+    const parent = await resolveExistingParent(root, repositoryPath);
+    if (!parent.complete) {
+        return { state: "absent" };
+    }
+    const name = repositoryPath.split("/").at(-1);
+    if (await knownFileAliasEntry(parent.absolute, name) === undefined) {
+        return { state: "absent" };
+    }
+    const path = join(root, ...repositoryPath.split("/"));
+    const metadata = await lstat(path, { bigint: true });
+    if (metadata.isSymbolicLink() || !metadata.isFile()) {
+        throw new KnownFileTransactionError("KNOWN_FILE_DESTINATION_INVALID", `Managed path must be a real regular file: ${repositoryPath}.`);
+    }
+    const observed = await readBoundedRegularFile(path, Math.max(maximumBytes, MAXIMUM_MANAGED_FILE_BYTES));
+    if (observed.outcome !== "read") {
+        throw new KnownFileTransactionError("KNOWN_FILE_UNSTABLE", `Managed path is oversized, unstable, or invalid: ${repositoryPath}.`);
+    }
+    if (observed.linkCount !== 1n) {
+        throw new KnownFileTransactionError("KNOWN_FILE_HARDLINK", `Managed path has multiple hard links: ${repositoryPath}.`);
+    }
+    return {
+        state: "file",
+        bytes: observed.bytes,
+        identity: observed.identity,
+        mode: observed.mode & 0o777
+    };
+}
+export function maximumKnownFileEvidenceBytes(operation) {
+    return Math.max(operation.postimage.size, ...(operation.precondition.state === "known-file"
+        ? operation.precondition.acceptedPreimages.map(({ size }) => size)
+        : [0]));
+}
+export function classifyKnownFileOperation(operation, observed) {
+    if (matchesKnownFileImage(observed, operation.postimage)) {
+        return { path: operation.path, state: "already-satisfied" };
+    }
+    if (operation.precondition.state === "absent") {
+        if (observed.state !== "absent") {
+            throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `Expected an absent managed path: ${operation.path}.`);
+        }
+        return { path: operation.path, state: "pending" };
+    }
+    const matchedPreimage = operation.precondition.acceptedPreimages.findIndex((image) => matchesKnownFileImage(observed, image));
+    if (matchedPreimage === -1) {
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `Managed path does not match an exact accepted preimage: ${operation.path}.`);
+    }
+    return { path: operation.path, state: "pending", matchedPreimage };
+}
+//# sourceMappingURL=node-known-file-transaction-filesystem.js.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-filesystem.js.map

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

package/dist/repository-mutation/adapters/node/node-known-file-transaction-inspection.d.ts

@@ -0,0 +1,12 @@
+export type KnownFileTransactionBarrierInspection = {
+    readonly state: "idle";
+} | {
+    readonly state: "recovery-required";
+    readonly code: "KNOWN_FILE_OPERATION_ACTIVE" | "KNOWN_FILE_RECOVERY_REQUIRED";
+    readonly recoverableByInstalledBuild: boolean;
+    readonly message: string;
+};
+export declare function inspectKnownFileTransactionBarrier(options: {
+    readonly consumerRoot: string;
+}): Promise<KnownFileTransactionBarrierInspection>;
+//# sourceMappingURL=node-known-file-transaction-inspection.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction-inspection.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction-inspection.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,qCAAqC,GAC7C;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IACE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,IAAI,EACT,6BAA6B,GAC7B,8BAA8B,CAAC;IACnC,QAAQ,CAAC,2BAA2B,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAYN,wBAAsB,kCAAkC,CAAC,OAAO,EAAE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,qCAAqC,CAAC,CA6BjD"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction-inspection.js

@@ -0,0 +1,46 @@
+import { lstat } from "node:fs/promises";
+import { join } from "node:path";
+import { LOCAL_OPERATION_LOCK, LOCAL_STATE_DIRECTORY } from "../../../foundation-state-contract.js";
+import { createNodeFoundationTransactionCoordinator } from "../../../transaction-coordination/adapters/node/node-foundation-transaction-coordinator.js";
+import { canonicalKnownFileRoot, knownFileErrorCode } from "./node-known-file-transaction-filesystem.js";
+async function operationLockExists(root) {
+    try {
+        await lstat(join(root, LOCAL_STATE_DIRECTORY, LOCAL_OPERATION_LOCK));
+        return true;
+    }
+    catch (error) {
+        if (knownFileErrorCode(error) === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function inspectKnownFileTransactionBarrier(options) {
+    const root = await canonicalKnownFileRoot(options.consumerRoot);
+    const [hasOperationLock, status] = await Promise.all([
+        operationLockExists(root),
+        createNodeFoundationTransactionCoordinator(root).then((coordinator) => coordinator.inspect())
+    ]);
+    if (status.state !== "idle") {
+        const recoverableByInstalledBuild = status.state === "pending" &&
+            status.operationKind === "known-file-transaction" &&
+            !status.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH");
+        return Object.freeze({
+            state: "recovery-required",
+            code: "KNOWN_FILE_RECOVERY_REQUIRED",
+            recoverableByInstalledBuild,
+            message: status.diagnostics[0]?.message ??
+                "Foundation transaction evidence must be recovered before consumer integration can continue."
+        });
+    }
+    if (hasOperationLock) {
+        return Object.freeze({
+            state: "recovery-required",
+            code: "KNOWN_FILE_OPERATION_ACTIVE",
+            recoverableByInstalledBuild: false,
+            message: "A Foundation operation is active or interrupted; retry after it completes or recover its evidence."
+        });
+    }
+    return Object.freeze({ state: "idle" });
+}
+//# sourceMappingURL=node-known-file-transaction-inspection.js.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction-inspection.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,0CAA0C,EAAE,MAAM,4FAA4F,CAAC;AACxJ,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAazG,KAAK,UAAU,mBAAmB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YAAA,OAAO,KAAK,CAAC;QAAA,CAAC;QAC3D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CAAC,OAExD;IACC,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,mBAAmB,CAAC,IAAI,CAAC;QACzB,0CAA0C,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;KAC9F,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,2BAA2B,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS;YAC5D,MAAM,CAAC,aAAa,KAAK,wBAAwB;YACjD,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACpC,IAAI,KAAK,yCAAyC,CACnD,CAAC;QACJ,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,8BAA8B;YACpC,2BAA2B;YAC3B,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO;gBACrC,6FAA6F;SAChG,CAAC,CAAC;IACL,CAAC;IACD,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,6BAA6B;YACnC,2BAA2B,EAAE,KAAK;YAClC,OAAO,EAAE,oGAAoG;SAC9G,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/repository-mutation/adapters/node/node-known-file-transaction-journal-store.d.ts

@@ -0,0 +1,21 @@
+import type { KnownFileTransactionEnvelopeV1 } from "../../application/model/known-file-transaction-journal.js";
+import { captureFileHandleIdentity } from "./node-bounded-regular-file.js";
+export interface KnownFileJournalAuthority {
+    readonly digest: `sha256:${string}`;
+    readonly identity: Awaited<ReturnType<typeof captureFileHandleIdentity>>;
+}
+declare function readEnvelope(path: string): Promise<{
+    readonly authority: KnownFileJournalAuthority;
+    readonly envelope: KnownFileTransactionEnvelopeV1;
+} | undefined>;
+export declare class NodeKnownFileTransactionJournalStore {
+    #private;
+    constructor(stateDirectory: string);
+    read(): Promise<Awaited<ReturnType<typeof readEnvelope>>>;
+    create(envelope: KnownFileTransactionEnvelopeV1): Promise<KnownFileJournalAuthority>;
+    replace(expected: KnownFileJournalAuthority, envelope: KnownFileTransactionEnvelopeV1): Promise<KnownFileJournalAuthority>;
+    remove(expected: KnownFileJournalAuthority): Promise<void>;
+    canonicalizeTemporary(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=node-known-file-transaction-journal-store.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-transaction-journal-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-transaction-journal-store.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-transaction-journal-store.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2DAA2D,CAAC;AAEhH,OAAO,EACL,yBAAyB,EAG1B,MAAM,gCAAgC,CAAC;AAOxC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,UAAU,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC;CAC1E;AAwBD,iBAAe,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;CACnD,GAAG,SAAS,CAAC,CAsBb;AAUD,qBAAa,oCAAoC;;IAK/C,YAAmB,cAAc,EAAE,MAAM,EAIxC;IAEY,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAMrE;IA8BY,MAAM,CAAC,QAAQ,EAAE,8BAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAUhG;IAEY,OAAO,CAClB,QAAQ,EAAE,yBAAyB,EACnC,QAAQ,EAAE,8BAA8B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CASpC;IAEY,MAAM,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAItE;IAEY,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2ClD;CACF"}