@agent-teams/engineering-foundation 0.17.0 → 0.19.0

package/dist/repository-mutation/adapters/node/node-known-file-apply-effects.js

@@ -0,0 +1,232 @@
+import { link, lstat, mkdir, open, realpath, rename, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { serializeKnownFileIdentity } from "../../application/model/known-file-transaction-journal.js";
+import { captureFileHandleIdentity, pathMatchesRegularFileIdentity, readBoundedRegularFile } from "./node-bounded-regular-file.js";
+import { syncDirectoryStrictly } from "./node-directory-durability.js";
+import { prepareRollbackTemporary } from "./node-known-file-recovery-filesystem.js";
+import { persistKnownFileApplyState, transitionKnownFileOperation } from "./node-known-file-apply-state.js";
+import { knownFileAliasEntry, knownFileCaptureDirectoryName, knownFileErrorCode, knownFileImageBytes, knownFileTemporaryName, KnownFileTransactionError, matchesKnownFileImage, maximumKnownFileEvidenceBytes, sameKnownFileIdentity } from "./node-known-file-transaction-filesystem.js";
+import { isLexicallyContainedPath } from "./node-repository-path.js";
+export async function ensureKnownFileParentDirectories(options) {
+    const segments = options.operationPath.split("/");
+    segments.pop();
+    let current = options.root;
+    const traversed = [];
+    for (const segment of segments) {
+        traversed.push(segment);
+        const repositoryPath = traversed.join("/");
+        if (await knownFileAliasEntry(current, segment) === undefined) {
+            const authorized = Object.freeze({
+                ...options.stored.envelope.journal,
+                authorizedDirectories: Object.freeze([
+                    ...options.stored.envelope.journal.authorizedDirectories,
+                    repositoryPath
+                ])
+            });
+            await persistKnownFileApplyState(options.store, options.stored, authorized);
+            await options.faultInjector?.({
+                phase: "after-directory-authorized",
+                operationIndex: options.index,
+                path: repositoryPath
+            });
+            await mkdir(join(current, segment), { mode: 0o755 });
+            await syncDirectoryStrictly(current);
+            const metadata = await lstat(join(current, segment), { bigint: true });
+            if (!metadata.isDirectory() || metadata.isSymbolicLink()) {
+                throw new KnownFileTransactionError("KNOWN_FILE_DIRECTORY_INVALID", `Created ancestor is not one real directory: ${repositoryPath}.`);
+            }
+            const identity = serializeKnownFileIdentity({
+                birthtimeNs: metadata.birthtimeNs,
+                dev: metadata.dev,
+                ino: metadata.ino
+            });
+            await options.faultInjector?.({
+                phase: "after-directory-created-unbound",
+                operationIndex: options.index,
+                path: repositoryPath
+            });
+            const journal = Object.freeze({
+                ...options.stored.envelope.journal,
+                authorizedDirectories: Object.freeze(options.stored.envelope.journal.authorizedDirectories.filter((path) => path !== repositoryPath)),
+                createdDirectories: Object.freeze([
+                    ...options.stored.envelope.journal.createdDirectories,
+                    Object.freeze({ path: repositoryPath, identity })
+                ])
+            });
+            await persistKnownFileApplyState(options.store, options.stored, journal);
+            await options.faultInjector?.({
+                phase: "after-directory-created",
+                operationIndex: options.index,
+                path: repositoryPath
+            });
+        }
+        current = join(current, segment);
+        const metadata = await lstat(current);
+        if (metadata.isSymbolicLink() || !metadata.isDirectory() ||
+            !isLexicallyContainedPath(options.root, await realpath(current))) {
+            throw new KnownFileTransactionError("KNOWN_FILE_ANCESTOR_INVALID", `Managed path ancestor changed: ${options.operationPath}.`);
+        }
+    }
+    return current;
+}
+export async function prepareKnownFileTemporary(options) {
+    const path = join(options.parent, knownFileTemporaryName(options.operation.path, options.planDigest, options.operationIndex));
+    const handle = await open(path, "wx", 0o600).catch((error) => {
+        throw new KnownFileTransactionError(knownFileErrorCode(error) === "EEXIST" ? "KNOWN_FILE_TEMPORARY_EXISTS" : "KNOWN_FILE_TEMPORARY_CREATE_FAILED", `Could not create the transaction-owned temporary for ${options.operation.path}.`, { cause: error });
+    });
+    try {
+        await handle.writeFile(knownFileImageBytes(options.operation.postimage));
+        await handle.chmod(options.operation.postimage.mode);
+        await handle.sync();
+        return Object.freeze({ path, identity: await captureFileHandleIdentity(handle) });
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function verifyKnownFileTemporary(temporary, image) {
+    const observed = await readBoundedRegularFile(temporary.path, image.size);
+    if (observed.outcome !== "read" ||
+        !sameKnownFileIdentity(observed.identity, temporary.identity) ||
+        !matchesKnownFileImage({
+            state: "file",
+            bytes: observed.bytes,
+            identity: observed.identity,
+            mode: observed.mode & 0o777
+        }, image)) {
+        throw new KnownFileTransactionError("KNOWN_FILE_TEMPORARY_CHANGED", "Transaction-owned temporary changed before publication.");
+    }
+}
+export async function prepareKnownFileCapture(options) {
+    const directory = join(options.parent, knownFileCaptureDirectoryName(options.operation.path, options.planDigest, options.operationIndex));
+    const paths = {
+        captured: join(directory, "preimage"),
+        directory,
+        retired: join(directory, "retired")
+    };
+    await mkdir(paths.directory, { mode: 0o700 }).catch((error) => {
+        throw new KnownFileTransactionError(knownFileErrorCode(error) === "EEXIST"
+            ? "KNOWN_FILE_CAPTURE_EXISTS"
+            : "KNOWN_FILE_CAPTURE_CREATE_FAILED", `Could not create the transaction-owned capture for ${options.operation.path}.`, { cause: error });
+    });
+    await syncDirectoryStrictly(options.parent);
+    const metadata = await lstat(paths.directory, { bigint: true });
+    if (!metadata.isDirectory() || metadata.isSymbolicLink()) {
+        throw new KnownFileTransactionError("KNOWN_FILE_CAPTURE_INVALID", `Transaction capture is not one real directory: ${options.operation.path}.`);
+    }
+    return Object.freeze({
+        identity: {
+            birthtimeNs: metadata.birthtimeNs,
+            dev: metadata.dev,
+            ino: metadata.ino
+        },
+        paths: Object.freeze(paths)
+    });
+}
+export async function captureKnownFilePreimage(options) {
+    const destination = join(options.root, ...options.operation.path.split("/"));
+    await link(destination, options.capture.paths.captured).catch((error) => {
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `Could not capture the exact replacement preimage: ${options.operation.path}.`, { cause: error });
+    });
+    await syncDirectoryStrictly(options.capture.paths.directory);
+    const captured = await readBoundedRegularFile(options.capture.paths.captured, maximumKnownFileEvidenceBytes(options.operation));
+    const matchedPreimage = captured.outcome === "read"
+        ? options.operation.precondition.acceptedPreimages.findIndex((image) => matchesKnownFileImage({
+            state: "file",
+            bytes: captured.bytes,
+            identity: captured.identity,
+            mode: captured.mode & 0o777
+        }, image))
+        : -1;
+    if (captured.outcome !== "read" || captured.linkCount !== 2n || matchedPreimage < 0) {
+        await unlink(options.capture.paths.captured);
+        await syncDirectoryStrictly(options.capture.paths.directory);
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `Captured replacement preimage is no longer accepted: ${options.operation.path}.`);
+    }
+    return Object.freeze({ identity: captured.identity, matchedPreimage });
+}
+export async function prepareKnownFileRollback(options) {
+    const rollbackPath = join(options.parent, `.${options.operation.path.split("/").at(-1)}.agent-teams.rollback.${options.index}.tmp`);
+    const rollbackIdentity = await prepareRollbackTemporary({
+        operationPath: options.operation.path,
+        path: rollbackPath,
+        preimage: options.operation.precondition.acceptedPreimages[options.preimageIndex]
+    });
+    await options.faultInjector?.({
+        phase: "after-rollback-temporary-created-unbound",
+        operationIndex: options.index,
+        path: options.operation.path
+    });
+    await syncDirectoryStrictly(options.parent);
+    if (await pathMatchesRegularFileIdentity(rollbackPath, rollbackIdentity) !== "match") {
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `Rollback temporary changed before durable identity binding: ${options.operation.path}.`);
+    }
+    const journal = transitionKnownFileOperation(options.stored.envelope.journal, options.index, { rollbackTemporaryIdentity: serializeKnownFileIdentity(rollbackIdentity) });
+    await persistKnownFileApplyState(options.store, options.stored, journal);
+    await options.faultInjector?.({
+        phase: "after-rollback-temporary-ready",
+        operationIndex: options.index,
+        path: options.operation.path
+    });
+}
+export async function retireKnownFileDestination(options) {
+    await rename(options.destination, options.capture.paths.retired).catch((error) => {
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `Destination disappeared before identity-bound capture: ${options.operationPath}.`, { cause: error });
+    });
+    await syncDirectoryStrictly(options.capture.paths.directory);
+    await syncDirectoryStrictly(options.parent);
+    await options.faultInjector?.({
+        phase: "after-destination-captured",
+        operationIndex: options.index,
+        path: options.operationPath
+    });
+    const retired = await readBoundedRegularFile(options.capture.paths.retired, 8 * 1024 * 1024);
+    if (retired.outcome !== "read" ||
+        !sameKnownFileIdentity(retired.identity, options.capturedIdentity)) {
+        if (retired.outcome === "read") {
+            try {
+                await link(options.capture.paths.retired, options.destination);
+                await syncDirectoryStrictly(options.parent);
+                await unlink(options.capture.paths.retired);
+                await syncDirectoryStrictly(options.capture.paths.directory);
+            }
+            catch (error) {
+                if (knownFileErrorCode(error) !== "EEXIST") {
+                    throw error;
+                }
+            }
+        }
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `A foreign destination appeared during identity-bound capture: ${options.operationPath}.`);
+    }
+    const stableCaptured = await readBoundedRegularFile(options.capture.paths.captured, options.preimage.size);
+    if (stableCaptured.outcome !== "read" ||
+        stableCaptured.linkCount !== 2n ||
+        !sameKnownFileIdentity(stableCaptured.identity, options.capturedIdentity) ||
+        !matchesKnownFileImage({
+            state: "file",
+            bytes: stableCaptured.bytes,
+            identity: stableCaptured.identity,
+            mode: stableCaptured.mode & 0o777
+        }, options.preimage)) {
+        await link(options.capture.paths.retired, options.destination).catch((error) => {
+            throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_CONFLICT", `Mutated retired destination could not be restored: ${options.operationPath}.`, { cause: error });
+        });
+        await syncDirectoryStrictly(options.parent);
+        await unlink(options.capture.paths.retired);
+        await syncDirectoryStrictly(options.capture.paths.directory);
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", `Captured replacement preimage changed through an open file handle: ${options.operationPath}.`);
+    }
+    await unlink(options.capture.paths.retired);
+    await syncDirectoryStrictly(options.capture.paths.directory);
+}
+export async function publishKnownFileLink(options) {
+    await link(options.temporaryPath, options.destination).catch((error) => {
+        throw new KnownFileTransactionError("KNOWN_FILE_CAS_MISMATCH", options.replacement
+            ? `Destination appeared during replacement publication: ${options.operationPath}.`
+            : `Destination appeared during create CAS: ${options.operationPath}.`, { cause: error });
+    });
+}
+export async function unlinkKnownFileTemporary(path) {
+    await unlink(path);
+}
+//# sourceMappingURL=node-known-file-apply-effects.js.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-effects.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-effects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,0BAA0B,EAAE,MAAM,2DAA2D,CAAC;AACvG,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,sBAAsB,EACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEpF,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAE7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,EAC7B,qBAAqB,EACtB,MAAM,6CAA6C,CAAC;AAErD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAmBrE,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,OAOtD;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,CAAC;IACf,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO;gBAClC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC;oBACnC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB;oBACxD,cAAc;iBACf,CAAC;aACH,CAAC,CAAC;YACH,MAAM,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC5E,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC5B,KAAK,EAAE,4BAA4B;gBACnC,cAAc,EAAE,OAAO,CAAC,KAAK;gBAC7B,IAAI,EAAE,cAAc;aACrB,CAAC,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;gBACzD,MAAM,IAAI,yBAAyB,CACjC,8BAA8B,EAC9B,+CAA+C,cAAc,GAAG,CACjE,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,0BAA0B,CAAC;gBAC1C,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,GAAG,EAAE,QAAQ,CAAC,GAAG;aAClB,CAAC,CAAC;YACH,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC5B,KAAK,EAAE,iCAAiC;gBACxC,cAAc,EAAE,OAAO,CAAC,KAAK;gBAC7B,IAAI,EAAE,cAAc;aACrB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC5B,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO;gBAClC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAClC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAC1D,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,cAAc,CAClC,CACF;gBACD,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC;oBAChC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB;oBACrD,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;iBAClD,CAAC;aACH,CAAC,CAAC;YACH,MAAM,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACzE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC5B,KAAK,EAAE,yBAAyB;gBAChC,cAAc,EAAE,OAAO,CAAC,KAAK;gBAC7B,IAAI,EAAE,cAAc;aACrB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;YACtD,CAAC,wBAAwB,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,yBAAyB,CACjC,6BAA6B,EAC7B,kCAAkC,OAAO,CAAC,aAAa,GAAG,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAK/C;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,CACtD,OAAO,CAAC,SAAS,CAAC,IAAI,EACtB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,cAAc,CACvB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACpE,MAAM,IAAI,yBAAyB,CACjC,kBAAkB,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,oCAAoC,EAC7G,wDAAwD,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,EACjF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAqC,EACrC,KAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM;QAC7B,CAAC,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC;QAC7D,CAAC,qBAAqB,CAAC;YACrB,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,KAAK;SAC5B,EAAE,KAAK,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,yBAAyB,CACjC,8BAA8B,EAC9B,yDAAyD,CAC1D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAK7C;IACC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,6BAA6B,CAClE,OAAO,CAAC,SAAS,CAAC,IAAI,EACtB,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,cAAc,CACvB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG;QACZ,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;QACrC,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC;KACpC,CAAC;IACF,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACrE,MAAM,IAAI,yBAAyB,CACjC,kBAAkB,CAAC,KAAK,CAAC,KAAK,QAAQ;YACpC,CAAC,CAAC,2BAA2B;YAC7B,CAAC,CAAC,kCAAkC,EACtC,sDAAsD,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,EAC/E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;QACzD,MAAM,IAAI,yBAAyB,CACjC,4BAA4B,EAC5B,kDAAkD,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE;YACR,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,GAAG,EAAE,QAAQ,CAAC,GAAG;SAClB;QACD,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAM9C;IACC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC/E,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,EACzB,qDAAqD,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,EAC9E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAC3C,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAC9B,6BAA6B,CAAC,OAAO,CAAC,SAAS,CAAC,CACjD,CAAC;IACF,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,KAAK,MAAM;QACjD,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CACnE,qBAAqB,CAAC;YACpB,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,KAAK;SAC5B,EAAE,KAAK,CAAC,CACV;QACH,CAAC,CAAC,CAAC,CAAC,CAAC;IACP,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM,IAAI,QAAQ,CAAC,SAAS,KAAK,EAAE,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACpF,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,EACzB,wDAAwD,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAU9C;IACC,MAAM,YAAY,GAAG,IAAI,CACvB,OAAO,CAAC,MAAM,EACd,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,yBAAyB,OAAO,CAAC,KAAK,MAAM,CAC1F,CAAC;IACF,MAAM,gBAAgB,GAAG,MAAM,wBAAwB,CAAC;QACtD,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;QACrC,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAE;KACnF,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAC5B,KAAK,EAAE,0CAA0C;QACjD,cAAc,EAAE,OAAO,CAAC,KAAK;QAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;KAC7B,CAAC,CAAC;IACH,MAAM,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,8BAA8B,CAAC,YAAY,EAAE,gBAAgB,CAAC,KAAK,OAAO,EAAE,CAAC;QACrF,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,EACzB,+DAA+D,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,CACzF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,4BAA4B,CAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAC/B,OAAO,CAAC,KAAK,EACb,EAAE,yBAAyB,EAAE,0BAA0B,CAAC,gBAAgB,CAAC,EAAE,CAC5E,CAAC;IACF,MAAM,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAC5B,KAAK,EAAE,gCAAgC;QACvC,cAAc,EAAE,OAAO,CAAC,KAAK;QAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAShD;IACC,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxF,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,EACzB,0DAA0D,OAAO,CAAC,aAAa,GAAG,EAClF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAC5B,KAAK,EAAE,4BAA4B;QACnC,cAAc,EAAE,OAAO,CAAC,KAAK;QAC7B,IAAI,EAAE,OAAO,CAAC,aAAa;KAC5B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM;QAC5B,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrE,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC/D,MAAM,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC5C,MAAM,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC/D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAAA,MAAM,KAAK,CAAC;gBAAA,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,EACzB,iEAAiE,OAAO,CAAC,aAAa,GAAG,CAC1F,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,sBAAsB,CACjD,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CACtB,CAAC;IACF,IAAI,cAAc,CAAC,OAAO,KAAK,MAAM;QACnC,cAAc,CAAC,SAAS,KAAK,EAAE;QAC/B,CAAC,qBAAqB,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC;QACzE,CAAC,qBAAqB,CAAC;YACrB,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,QAAQ,EAAE,cAAc,CAAC,QAAQ;YACjC,IAAI,EAAE,cAAc,CAAC,IAAI,GAAG,KAAK;SAClC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACtF,MAAM,IAAI,yBAAyB,CACjC,8BAA8B,EAC9B,sDAAsD,OAAO,CAAC,aAAa,GAAG,EAC9E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,EACzB,sEAAsE,OAAO,CAAC,aAAa,GAAG,CAC/F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAK1C;IACC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC9E,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,EACzB,OAAO,CAAC,WAAW;YACjB,CAAC,CAAC,wDAAwD,OAAO,CAAC,aAAa,GAAG;YAClF,CAAC,CAAC,2CAA2C,OAAO,CAAC,aAAa,GAAG,EACvE,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAY;IACzD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/dist/repository-mutation/adapters/node/node-known-file-apply-faults.d.ts

@@ -0,0 +1,9 @@
+export type KnownFileTransactionFaultPoint = {
+    readonly phase: "after-barrier-acquired" | "after-journal-created" | "after-journal-committed" | "after-journal-retired";
+} | {
+    readonly phase: "after-directory-created" | "after-directory-created-unbound" | "after-directory-authorized" | "after-temporary-authorized" | "after-temporary-synced" | "after-temporary-created-unbound" | "after-capture-ready" | "after-capture-created-unbound" | "after-capture-authorized" | "after-preimage-captured" | "after-preimage-linked-unbound" | "after-rollback-temporary-created-unbound" | "after-rollback-temporary-ready" | "after-destination-captured" | "after-destination-retired" | "after-operation-publishing" | "after-postimage-linked" | "after-operation-published" | "after-committed-capture-unlinked";
+    readonly operationIndex: number;
+    readonly path: string;
+};
+export type KnownFileTransactionFaultInjector = (point: KnownFileTransactionFaultPoint) => Promise<void> | void;
+//# sourceMappingURL=node-known-file-apply-faults.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-faults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-faults.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-faults.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,8BAA8B,GACtC;IACE,QAAQ,CAAC,KAAK,EACV,wBAAwB,GACxB,uBAAuB,GACvB,yBAAyB,GACzB,uBAAuB,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,KAAK,EACV,yBAAyB,GACzB,iCAAiC,GACjC,4BAA4B,GAC5B,4BAA4B,GAC5B,wBAAwB,GACxB,iCAAiC,GACjC,qBAAqB,GACrB,+BAA+B,GAC/B,0BAA0B,GAC1B,yBAAyB,GACzB,+BAA+B,GAC/B,0CAA0C,GAC1C,gCAAgC,GAChC,4BAA4B,GAC5B,2BAA2B,GAC3B,4BAA4B,GAC5B,wBAAwB,GACxB,2BAA2B,GAC3B,kCAAkC,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,iCAAiC,GAAG,CAC9C,KAAK,EAAE,8BAA8B,KAClC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC"}

package/dist/repository-mutation/adapters/node/node-known-file-apply-faults.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node-known-file-apply-faults.js.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-faults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-faults.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-faults.ts"],"names":[],"mappings":""}

package/dist/repository-mutation/adapters/node/node-known-file-apply-observation.d.ts

@@ -0,0 +1,6 @@
+import type { KnownFileTransactionPlanV1 } from "../../application/model/known-file-transaction.js";
+import type { KnownFileTransactionJournalV1 } from "../../application/model/known-file-transaction-journal.js";
+export declare function observeInitialKnownFileJournal(root: string, plan: KnownFileTransactionPlanV1): Promise<KnownFileTransactionJournalV1>;
+export declare function verifyApplyingKnownFilePostimages(root: string, journal: KnownFileTransactionJournalV1): Promise<void>;
+export declare function verifyCommittedKnownFilePostimages(root: string, journal: KnownFileTransactionJournalV1): Promise<void>;
+//# sourceMappingURL=node-known-file-apply-observation.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-observation.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AACpG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2DAA2D,CAAC;AAS/G,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,6BAA6B,CAAC,CAiBxC;AAgBD,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/repository-mutation/adapters/node/node-known-file-apply-observation.js

@@ -0,0 +1,30 @@
+import { classifyKnownFileOperation, KnownFileTransactionError, matchesKnownFileImage, maximumKnownFileEvidenceBytes, observeKnownFile } from "./node-known-file-transaction-filesystem.js";
+export async function observeInitialKnownFileJournal(root, plan) {
+    const operations = [];
+    for (const operation of plan.operations) {
+        const observation = await observeKnownFile(root, operation.path, maximumKnownFileEvidenceBytes(operation));
+        operations.push(classifyKnownFileOperation(operation, observation));
+    }
+    return Object.freeze({
+        schemaVersion: 1,
+        plan,
+        operations: Object.freeze(operations),
+        authorizedDirectories: Object.freeze([]),
+        createdDirectories: Object.freeze([])
+    });
+}
+async function verifyKnownFilePostimages(root, journal, code, message) {
+    for (const operation of journal.plan.operations) {
+        const observation = await observeKnownFile(root, operation.path, operation.postimage.size);
+        if (!matchesKnownFileImage(observation, operation.postimage)) {
+            throw new KnownFileTransactionError(code, message(operation.path));
+        }
+    }
+}
+export async function verifyApplyingKnownFilePostimages(root, journal) {
+    await verifyKnownFilePostimages(root, journal, "KNOWN_FILE_PRECOMMIT_DRIFT", (path) => `Transaction postimage changed before commit: ${path}.`);
+}
+export async function verifyCommittedKnownFilePostimages(root, journal) {
+    await verifyKnownFilePostimages(root, journal, "KNOWN_FILE_COMMITTED_DRIFT", (path) => `Committed postimage changed before journal retirement: ${path}.`);
+}
+//# sourceMappingURL=node-known-file-apply-observation.js.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-observation.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-observation.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,EAC7B,gBAAgB,EACjB,MAAM,6CAA6C,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,IAAY,EACZ,IAAgC;IAEhC,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,MAAM,gBAAgB,CACxC,IAAI,EACJ,SAAS,CAAC,IAAI,EACd,6BAA6B,CAAC,SAAS,CAAC,CACzC,CAAC;QACF,UAAU,CAAC,IAAI,CAAC,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,IAAI;QACJ,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QACrC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;KACtC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,IAAY,EACZ,OAAsC,EACtC,IAAiE,EACjE,OAAiC;IAEjC,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3F,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,IAAY,EACZ,OAAsC;IAEtC,MAAM,yBAAyB,CAC7B,IAAI,EACJ,OAAO,EACP,4BAA4B,EAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,gDAAgD,IAAI,GAAG,CAClE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,IAAY,EACZ,OAAsC;IAEtC,MAAM,yBAAyB,CAC7B,IAAI,EACJ,OAAO,EACP,4BAA4B,EAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,0DAA0D,IAAI,GAAG,CAC5E,CAAC;AACJ,CAAC"}

package/dist/repository-mutation/adapters/node/node-known-file-apply-operation.d.ts

@@ -0,0 +1,11 @@
+import type { KnownFileTransactionFaultInjector } from "./node-known-file-apply-faults.js";
+import { type KnownFileApplyState } from "./node-known-file-apply-state.js";
+import type { NodeKnownFileTransactionJournalStore } from "./node-known-file-transaction-journal-store.js";
+export declare function executeKnownFileOperation(options: {
+    readonly faultInjector?: KnownFileTransactionFaultInjector;
+    readonly index: number;
+    readonly root: string;
+    readonly store: NodeKnownFileTransactionJournalStore;
+    readonly stored: KnownFileApplyState;
+}): Promise<void>;
+//# sourceMappingURL=node-known-file-apply-operation.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-operation.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-operation.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAO1C,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,gDAAgD,CAAC;AAwI3G,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,iCAAiC,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,oCAAoC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DhB"}

package/dist/repository-mutation/adapters/node/node-known-file-apply-operation.js

@@ -0,0 +1,159 @@
+import { join } from "node:path";
+import { serializeKnownFileIdentity } from "../../application/model/known-file-transaction-journal.js";
+import { syncDirectoryStrictly } from "./node-directory-durability.js";
+import { captureKnownFilePreimage, ensureKnownFileParentDirectories, prepareKnownFileCapture, prepareKnownFileRollback, prepareKnownFileTemporary, publishKnownFileLink, retireKnownFileDestination, unlinkKnownFileTemporary, verifyKnownFileTemporary } from "./node-known-file-apply-effects.js";
+import { persistKnownFileApplyState, transitionKnownFileOperation } from "./node-known-file-apply-state.js";
+import { KnownFileTransactionError, matchesKnownFileImage, observeKnownFile, sameKnownFileIdentity } from "./node-known-file-transaction-filesystem.js";
+async function transitionAndCheckpoint(context, transition, phase) {
+    const operation = context.stored.envelope.journal.plan.operations[context.index];
+    const journal = transitionKnownFileOperation(context.stored.envelope.journal, context.index, transition);
+    await persistKnownFileApplyState(context.store, context.stored, journal);
+    await context.faultInjector?.({
+        phase,
+        operationIndex: context.index,
+        path: operation.path
+    });
+}
+async function publishPreparedLink(context, replacement) {
+    const operation = context.stored.envelope.journal.plan.operations[context.index];
+    await transitionAndCheckpoint(context, { state: "publishing" }, "after-operation-publishing");
+    await publishKnownFileLink({
+        destination: context.destination,
+        operationPath: operation.path,
+        temporaryPath: context.temporary.path,
+        replacement
+    });
+    await context.faultInjector?.({
+        phase: "after-postimage-linked",
+        operationIndex: context.index,
+        path: operation.path
+    });
+    await unlinkKnownFileTemporary(context.temporary.path);
+}
+async function prepareCapture(context) {
+    const operation = context.stored.envelope.journal.plan.operations[context.index];
+    await transitionAndCheckpoint(context, { state: "capture-authorized" }, "after-capture-authorized");
+    const capture = await prepareKnownFileCapture({
+        operation,
+        operationIndex: context.index,
+        parent: context.parent,
+        planDigest: context.stored.envelope.journal.plan.planDigest
+    });
+    await context.faultInjector?.({
+        phase: "after-capture-created-unbound",
+        operationIndex: context.index,
+        path: operation.path
+    });
+    await transitionAndCheckpoint(context, {
+        captureDirectoryIdentity: serializeKnownFileIdentity(capture.identity),
+        state: "capture-ready"
+    }, "after-capture-ready");
+    return capture;
+}
+async function executeKnownFileReplacement(context) {
+    const operation = context.stored.envelope.journal.plan.operations[context.index];
+    if (operation.precondition.state !== "known-file") {
+        throw new KnownFileTransactionError("KNOWN_FILE_JOURNAL_INVALID", `Replacement operation has no known preimage: ${operation.path}.`);
+    }
+    const capture = await prepareCapture(context);
+    const captured = await captureKnownFilePreimage({
+        capture,
+        operation: { ...operation, precondition: operation.precondition },
+        root: context.root
+    });
+    await context.faultInjector?.({
+        phase: "after-preimage-linked-unbound",
+        operationIndex: context.index,
+        path: operation.path
+    });
+    await transitionAndCheckpoint(context, {
+        capturedPreimageIdentity: serializeKnownFileIdentity(captured.identity),
+        matchedPreimage: captured.matchedPreimage,
+        state: "preimage-captured"
+    }, "after-preimage-captured");
+    await prepareKnownFileRollback({
+        ...(context.faultInjector === undefined ? {} : { faultInjector: context.faultInjector }),
+        index: context.index,
+        operation: { ...operation, precondition: operation.precondition },
+        parent: context.parent,
+        preimageIndex: captured.matchedPreimage,
+        store: context.store,
+        stored: context.stored
+    });
+    await retireKnownFileDestination({
+        capture,
+        capturedIdentity: captured.identity,
+        destination: context.destination,
+        ...(context.faultInjector === undefined ? {} : { faultInjector: context.faultInjector }),
+        index: context.index,
+        operationPath: operation.path,
+        parent: context.parent,
+        preimage: operation.precondition.acceptedPreimages[captured.matchedPreimage]
+    });
+    await transitionAndCheckpoint(context, { state: "destination-retired" }, "after-destination-retired");
+    await publishPreparedLink(context, true);
+}
+async function verifyPublishedPostimage(context) {
+    const operation = context.stored.envelope.journal.plan.operations[context.index];
+    await syncDirectoryStrictly(context.parent);
+    const published = await observeKnownFile(context.root, operation.path, operation.postimage.size);
+    if (!matchesKnownFileImage(published, operation.postimage) || published.identity === undefined ||
+        !sameKnownFileIdentity(published.identity, context.temporary.identity)) {
+        throw new KnownFileTransactionError("KNOWN_FILE_POSTIMAGE_INVALID", `Published postimage failed exact verification: ${operation.path}.`);
+    }
+    await transitionAndCheckpoint(context, { state: "published" }, "after-operation-published");
+}
+export async function executeKnownFileOperation(options) {
+    const operation = options.stored.envelope.journal.plan.operations[options.index];
+    const journalOperation = options.stored.envelope.journal.operations[options.index];
+    if (journalOperation.state === "already-satisfied" || journalOperation.state === "published") {
+        return;
+    }
+    if (journalOperation.state !== "pending") {
+        throw new KnownFileTransactionError("KNOWN_FILE_RECOVERY_REQUIRED", `Operation ${operation.path} is already in progress and requires recovery.`);
+    }
+    const parent = await ensureKnownFileParentDirectories({
+        ...options,
+        operationPath: operation.path
+    });
+    const temporaryContext = {
+        destination: join(options.root, ...operation.path.split("/")),
+        ...options,
+        parent
+    };
+    const authorized = transitionKnownFileOperation(options.stored.envelope.journal, options.index, { state: "temporary-authorized" });
+    await persistKnownFileApplyState(options.store, options.stored, authorized);
+    await options.faultInjector?.({
+        phase: "after-temporary-authorized",
+        operationIndex: options.index,
+        path: operation.path
+    });
+    const temporary = await prepareKnownFileTemporary({
+        operation,
+        operationIndex: options.index,
+        parent,
+        planDigest: options.stored.envelope.journal.plan.planDigest
+    });
+    await options.faultInjector?.({
+        phase: "after-temporary-created-unbound",
+        operationIndex: options.index,
+        path: operation.path
+    });
+    const ready = transitionKnownFileOperation(options.stored.envelope.journal, options.index, { state: "temporary-ready", temporaryIdentity: serializeKnownFileIdentity(temporary.identity) });
+    await persistKnownFileApplyState(options.store, options.stored, ready);
+    await options.faultInjector?.({
+        phase: "after-temporary-synced",
+        operationIndex: options.index,
+        path: operation.path
+    });
+    await verifyKnownFileTemporary(temporary, operation.postimage);
+    const context = { ...temporaryContext, temporary };
+    if (operation.precondition.state === "absent") {
+        await publishPreparedLink(context, false);
+    }
+    else {
+        await executeKnownFileReplacement(context);
+    }
+    await verifyPublishedPostimage(context);
+}
+//# sourceMappingURL=node-known-file-apply-operation.js.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-operation.js.map

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

package/dist/repository-mutation/adapters/node/node-known-file-apply-state.d.ts

@@ -0,0 +1,9 @@
+import type { KnownFileTransactionEnvelopeV1, KnownFileTransactionJournalOperationV1, KnownFileTransactionJournalV1 } from "../../application/model/known-file-transaction-journal.js";
+import type { KnownFileJournalAuthority, NodeKnownFileTransactionJournalStore } from "./node-known-file-transaction-journal-store.js";
+export interface KnownFileApplyState {
+    authority: KnownFileJournalAuthority;
+    envelope: KnownFileTransactionEnvelopeV1;
+}
+export declare function transitionKnownFileOperation(journal: KnownFileTransactionJournalV1, index: number, transition: Partial<KnownFileTransactionJournalOperationV1>): KnownFileTransactionJournalV1;
+export declare function persistKnownFileApplyState(store: NodeKnownFileTransactionJournalStore, stored: KnownFileApplyState, journal: KnownFileTransactionJournalV1, state?: KnownFileTransactionEnvelopeV1["state"]): Promise<void>;
+//# sourceMappingURL=node-known-file-apply-state.d.ts.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-state.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,sCAAsC,EACtC,6BAA6B,EAC9B,MAAM,2DAA2D,CAAC;AAEnE,OAAO,KAAK,EACV,yBAAyB,EACzB,oCAAoC,EACrC,MAAM,gDAAgD,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,yBAAyB,CAAC;IACrC,QAAQ,EAAE,8BAA8B,CAAC;CAC1C;AAaD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,EACtC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,CAAC,sCAAsC,CAAC,GAC1D,6BAA6B,CAO/B;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,oCAAoC,EAC3C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,6BAA6B,EACtC,KAAK,GAAE,8BAA8B,CAAC,OAAO,CAAc,GAC1D,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/repository-mutation/adapters/node/node-known-file-apply-state.js

@@ -0,0 +1,21 @@
+import { compileKnownFileTransactionEnvelope } from "../../application/policies/known-file-transaction-envelope.js";
+function replaceKnownFileOperation(journal, index, replacement) {
+    return Object.freeze({
+        ...journal,
+        operations: Object.freeze(journal.operations.with(index, replacement))
+    });
+}
+export function transitionKnownFileOperation(journal, index, transition) {
+    const current = journal.operations[index];
+    return replaceKnownFileOperation(journal, index, Object.freeze({ ...current, ...transition }));
+}
+export async function persistKnownFileApplyState(store, stored, journal, state = "APPLYING") {
+    const envelope = compileKnownFileTransactionEnvelope({
+        foundation: stored.envelope.foundation,
+        journal,
+        state
+    });
+    stored.authority = await store.replace(stored.authority, envelope);
+    stored.envelope = envelope;
+}
+//# sourceMappingURL=node-known-file-apply-state.js.map

package/dist/repository-mutation/adapters/node/node-known-file-apply-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-apply-state.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-apply-state.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mCAAmC,EAAE,MAAM,+DAA+D,CAAC;AAWpH,SAAS,yBAAyB,CAChC,OAAsC,EACtC,KAAa,EACb,WAAmD;IAEnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;KACvE,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAAsC,EACtC,KAAa,EACb,UAA2D;IAE3D,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAE,CAAC;IAC3C,OAAO,yBAAyB,CAC9B,OAAO,EACP,KAAK,EACL,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,EAAE,CAA2C,CACvF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAA2C,EAC3C,MAA2B,EAC3B,OAAsC,EACtC,KAAK,GAA4C,UAAU;IAE3D,MAAM,QAAQ,GAAG,mCAAmC,CAAC;QACnD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;QACtC,OAAO;QACP,KAAK;KACN,CAAC,CAAC;IACH,MAAM,CAAC,SAAS,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { KnownFileRecoveryFaultInjector, StoredRecoveryJournal } from "./node-known-file-recovery-state.js";
+import type { NodeKnownFileTransactionJournalStore } from "./node-known-file-transaction-journal-store.js";
+export declare function rollbackKnownFileRecovery(options: {
+    readonly faultInjector?: KnownFileRecoveryFaultInjector;
+    readonly root: string;
+    readonly store: NodeKnownFileTransactionJournalStore;
+    readonly stored: StoredRecoveryJournal;
+}): Promise<void>;
+//# sourceMappingURL=node-known-file-recovery-cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-known-file-recovery-cleanup.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-known-file-recovery-cleanup.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,gDAAgD,CAAC;AAyK3G,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,oCAAoC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DhB"}