@agent-teams/engineering-foundation 0.16.1 → 0.17.0-rc.1

package/dist/repository-mutation/adapters/node/node-directory-materialization.d.ts

@@ -0,0 +1,37 @@
+import type { BoundDirectoryCreation, CapturedDirectory, DirectoryCreatePolicy, DirectoryMaterializationProjection, UnboundDirectoryCreationRecovery } from "../../application/model/directory-materialization.js";
+import type { PortablePathIdentity } from "../../application/model/path-identity.js";
+export interface DirectoryIdentityBindingPort {
+    bindCreatedDirectory(directory: CapturedDirectory & {
+        readonly parentIdentity: PortablePathIdentity;
+    }): Promise<void>;
+}
+interface DirectoryCreationFaultPoint {
+    readonly phase: "after-mkdir-before-capture" | "after-parent-sync-before-bind";
+    readonly repositoryPath: string;
+}
+export type DirectoryCreationFaultInjector = (point: DirectoryCreationFaultPoint) => Promise<void> | void;
+export declare function projectDirectoryMaterialization(options: {
+    readonly createPolicy: DirectoryCreatePolicy;
+    readonly repositoryPath: string;
+    readonly repositoryRoot: string;
+}): Promise<DirectoryMaterializationProjection>;
+export declare function recaptureExactDirectoryIdentity(options: {
+    readonly expectedIdentity: PortablePathIdentity;
+    readonly repositoryPath: string;
+    readonly repositoryRoot: string;
+}): Promise<CapturedDirectory>;
+export declare function createAndBindOneDirectory(options: {
+    readonly binding: Pick<DirectoryIdentityBindingPort, "bindCreatedDirectory">;
+    readonly createPolicy: DirectoryCreatePolicy;
+    readonly expectedParentIdentity: PortablePathIdentity;
+    readonly faultInjector?: DirectoryCreationFaultInjector;
+    readonly mode?: number;
+    readonly repositoryPath: string;
+    readonly repositoryRoot: string;
+}): Promise<BoundDirectoryCreation>;
+export declare function classifyUnboundDirectoryCreation(options: {
+    readonly repositoryPath: string;
+    readonly repositoryRoot: string;
+}): Promise<UnboundDirectoryCreationRecovery>;
+export {};
+//# sourceMappingURL=node-directory-materialization.d.ts.map

package/dist/repository-mutation/adapters/node/node-directory-materialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-directory-materialization.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-directory-materialization.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,kCAAkC,EAElC,gCAAgC,EACjC,MAAM,sDAAsD,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AASrF,MAAM,WAAW,4BAA4B;IAC3C,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG;QAClD,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;KAC/C,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,UAAU,2BAA2B;IACnC,QAAQ,CAAC,KAAK,EAAE,4BAA4B,GAAG,+BAA+B,CAAC;IAC/E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,KAAK,EAAE,2BAA2B,KAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAkK1B,wBAAsB,+BAA+B,CAAC,OAAO,EAAE;IAC7D,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAuC9C;AAED,wBAAsB,+BAA+B,CAAC,OAAO,EAAE;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAW7B;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,4BAA4B,EAAE,sBAAsB,CAAC,CAAC;IAC7E,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAoFlC;AAED,wBAAsB,gCAAgC,CAAC,OAAO,EAAE;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAY5C"}

package/dist/repository-mutation/adapters/node/node-directory-materialization.js

@@ -0,0 +1,224 @@
+import { lstat, mkdir, readdir, realpath } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { DirectoryMutationError } from "../../application/model/directory-materialization.js";
+import { portableRepositoryPathIdentity, portableRepositoryPathProblem } from "../../application/model/repository-path.js";
+import { syncDirectoryStrictly } from "./node-directory-durability.js";
+import { createAndBindNodeDirectory } from "./node-create-and-bind-directory.js";
+import { isLexicallyContainedPath } from "./node-repository-path.js";
+function errorCode(error) {
+    return error instanceof Error && "code" in error
+        ? error.code
+        : undefined;
+}
+function isMissing(error) {
+    return errorCode(error) === "ENOENT";
+}
+function sameIdentity(left, right) {
+    return (left.dev === right.dev &&
+        left.ino === right.ino &&
+        left.birthtimeNs === right.birthtimeNs);
+}
+function identityFromMetadata(metadata) {
+    const identity = {
+        birthtimeNs: metadata.birthtimeNs,
+        dev: metadata.dev,
+        ino: metadata.ino
+    };
+    if (identity.birthtimeNs === 0n ||
+        identity.dev === 0n ||
+        identity.ino === 0n) {
+        throw new DirectoryMutationError("IDENTITY_UNAVAILABLE", "The filesystem did not provide a nonzero directory identity.");
+    }
+    return identity;
+}
+function assertRepositoryPath(repositoryPath) {
+    const problem = portableRepositoryPathProblem(repositoryPath);
+    if (problem !== undefined) {
+        throw new DirectoryMutationError("INVALID_PATH", `Invalid portable repository directory path (${problem}): ${repositoryPath}.`);
+    }
+    return repositoryPath.split("/");
+}
+async function captureRealDirectory(absolutePath, repositoryPath) {
+    const metadata = await lstat(absolutePath, { bigint: true });
+    if (metadata.isSymbolicLink()) {
+        throw new DirectoryMutationError("SYMLINK", `Repository directory must not be a symbolic link: ${repositoryPath}.`);
+    }
+    if (!metadata.isDirectory()) {
+        throw new DirectoryMutationError("NOT_DIRECTORY", `Repository path is not a directory: ${repositoryPath}.`);
+    }
+    return {
+        absolutePath,
+        identity: identityFromMetadata(metadata),
+        repositoryPath
+    };
+}
+async function assertCanonicalContainment(canonicalRoot, directory) {
+    const canonical = await realpath(directory.absolutePath);
+    if (!isLexicallyContainedPath(canonicalRoot, canonical)) {
+        throw new DirectoryMutationError("OUTSIDE_ROOT", `Repository directory resolves outside its root: ${directory.repositoryPath}.`);
+    }
+    const recaptured = await captureRealDirectory(directory.absolutePath, directory.repositoryPath);
+    if (!sameIdentity(directory.identity, recaptured.identity)) {
+        throw new DirectoryMutationError("CONCURRENT_CHANGE", `Directory identity changed while checking containment: ${directory.repositoryPath}.`);
+    }
+}
+async function assertNoAlias(parent, requestedName) {
+    const requestedIdentity = portableRepositoryPathIdentity(requestedName);
+    const entries = await readdir(parent);
+    const aliases = entries.filter((entry) => portableRepositoryPathIdentity(entry) === requestedIdentity);
+    if (aliases.some((entry) => entry !== requestedName)) {
+        throw new DirectoryMutationError("ALIAS_COLLISION", `Portable case/NFC alias collides with requested directory: ${requestedName}.`);
+    }
+    return aliases.includes(requestedName);
+}
+async function captureRoot(repositoryRoot) {
+    const absoluteRoot = resolve(repositoryRoot);
+    const root = await captureRealDirectory(absoluteRoot, ".");
+    const canonicalRoot = await realpath(absoluteRoot);
+    const recapturedRoot = await captureRealDirectory(canonicalRoot, ".");
+    if (!sameIdentity(root.identity, recapturedRoot.identity)) {
+        throw new DirectoryMutationError("CONCURRENT_CHANGE", "Repository root identity changed while it was captured.");
+    }
+    return {
+        canonicalRoot,
+        root: recapturedRoot
+    };
+}
+async function captureExistingPath(canonicalRoot, repositoryPath) {
+    if (repositoryPath === ".") {
+        return captureRealDirectory(canonicalRoot, ".");
+    }
+    let current = canonicalRoot;
+    let captured = await captureRealDirectory(canonicalRoot, ".");
+    const traversed = [];
+    for (const segment of assertRepositoryPath(repositoryPath)) {
+        await assertNoAlias(current, segment);
+        traversed.push(segment);
+        current = join(current, segment);
+        captured = await captureRealDirectory(current, traversed.join("/"));
+        await assertCanonicalContainment(canonicalRoot, captured);
+    }
+    return captured;
+}
+export async function projectDirectoryMaterialization(options) {
+    const segments = assertRepositoryPath(options.repositoryPath);
+    const { canonicalRoot, root } = await captureRoot(options.repositoryRoot);
+    let anchor = root;
+    let currentAbsolute = canonicalRoot;
+    const traversed = [];
+    const missingDirectories = [];
+    for (const segment of segments) {
+        traversed.push(segment);
+        currentAbsolute = join(currentAbsolute, segment);
+        const repositoryPath = traversed.join("/");
+        if (missingDirectories.length > 0) {
+            missingDirectories.push({ absolutePath: currentAbsolute, repositoryPath });
+            continue;
+        }
+        const exists = await assertNoAlias(dirname(currentAbsolute), segment);
+        if (!exists) {
+            missingDirectories.push({
+                absolutePath: currentAbsolute,
+                repositoryPath
+            });
+            continue;
+        }
+        const captured = await captureRealDirectory(currentAbsolute, repositoryPath);
+        await assertCanonicalContainment(canonicalRoot, captured);
+        anchor = captured;
+    }
+    return {
+        anchor,
+        createPolicy: options.createPolicy,
+        finalParent: {
+            absolutePath: join(canonicalRoot, ...segments),
+            repositoryPath: options.repositoryPath
+        },
+        missingDirectories,
+        repositoryRoot: root
+    };
+}
+export async function recaptureExactDirectoryIdentity(options) {
+    assertRepositoryPath(options.repositoryPath);
+    const { canonicalRoot } = await captureRoot(options.repositoryRoot);
+    const captured = await captureExistingPath(canonicalRoot, options.repositoryPath);
+    if (!sameIdentity(captured.identity, options.expectedIdentity)) {
+        throw new DirectoryMutationError("CONCURRENT_CHANGE", `Directory identity changed: ${options.repositoryPath}.`);
+    }
+    return captured;
+}
+export async function createAndBindOneDirectory(options) {
+    const segments = assertRepositoryPath(options.repositoryPath);
+    if (options.createPolicy !== "allow") {
+        throw new DirectoryMutationError("CREATE_FORBIDDEN", `Directory creation is forbidden by policy: ${options.repositoryPath}.`);
+    }
+    return createAndBindNodeDirectory({
+        ambiguousError: (error) => new DirectoryMutationError("AMBIGUOUS_CREATION", `Directory may exist without a durable identity binding: ${options.repositoryPath}. Manual recovery is required.`, { cause: error, manualRecoveryRequired: true }),
+        async bind(bound) {
+            await options.binding.bindCreatedDirectory(bound);
+        },
+        async captureParent() {
+            const { canonicalRoot } = await captureRoot(options.repositoryRoot);
+            const absolutePath = join(canonicalRoot, ...segments);
+            const parentPath = dirname(absolutePath);
+            const parentRepositoryPath = segments.slice(0, -1).join("/") || ".";
+            const parent = await captureExistingPath(canonicalRoot, parentRepositoryPath);
+            if (!sameIdentity(parent.identity, options.expectedParentIdentity)) {
+                throw new DirectoryMutationError("CONCURRENT_CHANGE", `Parent directory identity changed: ${parentRepositoryPath}.`);
+            }
+            await assertNoAlias(parentPath, segments.at(-1) ?? "");
+            return { absolutePath, canonicalRoot, parent, parentPath, parentRepositoryPath };
+        },
+        async createAndObserve(parent, markCreated) {
+            await mkdir(parent.absolutePath, {
+                mode: options.mode ?? 0o755,
+                recursive: false
+            });
+            markCreated();
+            // Portable Node cannot atomically return mkdir's identity. The first
+            // observation is authoritative only for cooperative writers.
+            const observed = await captureRealDirectory(parent.absolutePath, options.repositoryPath);
+            await options.faultInjector?.({
+                phase: "after-mkdir-before-capture",
+                repositoryPath: options.repositoryPath
+            });
+            return observed;
+        },
+        async recapture(parent, observed) {
+            const captured = await captureExistingPath(parent.canonicalRoot, options.repositoryPath);
+            const recapturedParent = await captureExistingPath(parent.canonicalRoot, parent.parentRepositoryPath);
+            await assertNoAlias(parent.parentPath, segments.at(-1) ?? "");
+            if (!sameIdentity(observed.identity, captured.identity) ||
+                !sameIdentity(recapturedParent.identity, parent.parent.identity)) {
+                throw new DirectoryMutationError("CONCURRENT_CHANGE", `Created directory or its parent changed before binding: ${options.repositoryPath}.`);
+            }
+            return {
+                ...captured,
+                outcome: "created-and-bound",
+                parentIdentity: parent.parent.identity
+            };
+        },
+        async syncParent(parent) {
+            await syncDirectoryStrictly(parent.parentPath);
+            await options.faultInjector?.({
+                phase: "after-parent-sync-before-bind",
+                repositoryPath: options.repositoryPath
+            });
+        }
+    });
+}
+export async function classifyUnboundDirectoryCreation(options) {
+    assertRepositoryPath(options.repositoryPath);
+    const { canonicalRoot } = await captureRoot(options.repositoryRoot);
+    try {
+        const captured = await captureExistingPath(canonicalRoot, options.repositoryPath);
+        return { observedIdentity: captured.identity, outcome: "ambiguous-manual" };
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return { outcome: "not-created" };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=node-directory-materialization.js.map

package/dist/repository-mutation/adapters/node/node-directory-materialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-directory-materialization.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-directory-materialization.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"}