@agent-teams/repository-mutation 0.0.0

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

@@ -0,0 +1,134 @@
+import { constants, lstat, open } from "node:fs/promises";
+function identityFromStat(metadata) {
+    return {
+        birthtimeNs: metadata.birthtimeNs,
+        dev: metadata.dev,
+        ino: metadata.ino
+    };
+}
+function isMissing(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+function hasErrorCode(error, code) {
+    return (error instanceof Error &&
+        "code" in error &&
+        error.code === code);
+}
+async function isExistingNonRegularPath(path) {
+    try {
+        const metadata = await lstat(path);
+        return metadata.isSymbolicLink() || !metadata.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function sameFileObservation(left, right) {
+    return (left.dev === right.dev &&
+        left.ino === right.ino &&
+        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) {
+    const chunks = [];
+    let total = 0;
+    while (total <= maximumBytes) {
+        const remaining = maximumBytes + 1 - total;
+        const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, remaining));
+        const { bytesRead } = await handle.read(buffer, 0, buffer.byteLength, null);
+        if (bytesRead === 0) {
+            return Buffer.concat(chunks, total);
+        }
+        chunks.push(buffer.subarray(0, bytesRead));
+        total += bytesRead;
+    }
+    return undefined;
+}
+export async function readBoundedRegularFileWithFaults(path, maximumBytes, faultInjector) {
+    if (!Number.isSafeInteger(maximumBytes) || maximumBytes < 0) {
+        throw new TypeError("maximumBytes must be a non-negative safe integer.");
+    }
+    if (await isExistingNonRegularPath(path)) {
+        return { outcome: "invalid" };
+    }
+    const noFollow = process.platform === "win32" ? 0 : constants.O_NOFOLLOW;
+    const nonBlocking = process.platform === "win32" ? 0 : constants.O_NONBLOCK;
+    let handle;
+    try {
+        handle = await open(path, constants.O_RDONLY | noFollow | nonBlocking);
+    }
+    catch (error) {
+        if (hasErrorCode(error, "ELOOP") ||
+            (await isExistingNonRegularPath(path))) {
+            return { outcome: "invalid" };
+        }
+        throw error;
+    }
+    try {
+        return await readBoundedRegularFileHandle(handle, path, maximumBytes, faultInjector);
+    }
+    finally {
+        await handle.close();
+    }
+}
+export function readBoundedRegularFile(path, maximumBytes) {
+    return readBoundedRegularFileWithFaults(path, maximumBytes);
+}
+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 }));
+}
+export async function pathMatchesRegularFileIdentity(path, expected) {
+    try {
+        const metadata = await lstat(path, { bigint: true });
+        if (metadata.isSymbolicLink() || !metadata.isFile()) {
+            return "different";
+        }
+        const observed = identityFromStat(metadata);
+        return observed.dev === expected.dev &&
+            observed.ino === expected.ino &&
+            observed.birthtimeNs === expected.birthtimeNs
+            ? "match"
+            : "different";
+    }
+    catch (error) {
+        if (isMissing(error)) {
+            return "missing";
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=node-bounded-regular-file.js.map

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

@@ -0,0 +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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"}

package/dist/repository-mutation/adapters/node/node-cleanup-owned-temporary.d.ts

@@ -0,0 +1,26 @@
+import { link, mkdir, rename } from "node:fs/promises";
+import type { PortablePathIdentity } from "../../application/model/path-identity.js";
+import type { OwnedTemporaryCleanupTransitionPort } from "../../application/ports/owned-temporary-cleanup-transition.js";
+import { pathMatchesRegularFileIdentity } from "./node-bounded-regular-file.js";
+import type { DirectoryDurability } from "./node-directory-durability.js";
+export declare const OWNED_TEMPORARY_CLEANUP_RESIDUE_MARKER = ".foundation-owned-cleanup-";
+export declare function ownedTemporaryCleanupResiduePrefix(temporaryPath: string): string;
+export declare function cleanupIdentityMatchingOwnedTemporary(options: {
+    readonly allowUnsupportedDirectoryDurability: boolean;
+    readonly displayPath: string;
+    readonly expectedIdentity: PortablePathIdentity;
+    readonly parent: string;
+    readonly rm: (path: string) => Promise<void>;
+    readonly syncDirectory: (path: string) => Promise<DirectoryDurability>;
+    readonly temporaryPath: string;
+    readonly transition?: OwnedTemporaryCleanupTransitionPort;
+    readonly operations?: {
+        readonly beforeLogicalRetirement?: (path: string) => Promise<void> | void;
+        readonly mkdir?: typeof mkdir;
+        readonly link?: typeof link;
+        readonly pathMatchesRegularFileIdentity?: typeof pathMatchesRegularFileIdentity;
+        readonly quarantineToken?: () => string;
+        readonly rename?: typeof rename;
+    };
+}): Promise<"different" | "missing" | "removed">;
+//# sourceMappingURL=node-cleanup-owned-temporary.d.ts.map

package/dist/repository-mutation/adapters/node/node-cleanup-owned-temporary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-cleanup-owned-temporary.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-cleanup-owned-temporary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,+DAA+D,CAAC;AACzH,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAQ1E,eAAO,MAAM,sCAAsC,+BACrB,CAAC;AAI/B,wBAAgB,kCAAkC,CAChD,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAkHD,wBAAsB,qCAAqC,CAAC,OAAO,EAAE;IACnE,QAAQ,CAAC,mCAAmC,EAAE,OAAO,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,CACtB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,mCAAmC,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,CAAC;QAC5B,QAAQ,CAAC,8BAA8B,CAAC,EAAE,OAAO,8BAA8B,CAAC;QAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC;KACjC,CAAC;CACH,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC,CAuH/C"}

package/dist/repository-mutation/adapters/node/node-cleanup-owned-temporary.js

@@ -0,0 +1,172 @@
+import { randomUUID } from "node:crypto";
+import { link, mkdir, rename } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { pathMatchesRegularFileIdentity } from "./node-bounded-regular-file.js";
+import { syncPublicationDirectory } from "./node-absent-file-publication-private.js";
+import { assertTerminalEvidenceDirectory, ensureTerminalEvidenceDirectory } from "./node-terminal-evidence-directory.js";
+export const OWNED_TEMPORARY_CLEANUP_RESIDUE_MARKER = ".foundation-owned-cleanup-";
+const OWNED_TEMPORARY_RETIRED_EVIDENCE_MARKER = ".foundation-retired-evidence-";
+export function ownedTemporaryCleanupResiduePrefix(temporaryPath) {
+    return `.${basename(temporaryPath)}${OWNED_TEMPORARY_CLEANUP_RESIDUE_MARKER}`;
+}
+function cleanupOperations(operations) {
+    return {
+        beforeLogicalRetirement: operations?.beforeLogicalRetirement,
+        identityMatch: operations?.pathMatchesRegularFileIdentity ?? pathMatchesRegularFileIdentity,
+        makeDirectory: operations?.mkdir ?? mkdir,
+        restore: operations?.link ?? link,
+        move: operations?.rename ?? rename,
+        token: operations?.quarantineToken?.() ?? randomUUID()
+    };
+}
+async function beginCleanupTransition(options) {
+    const initialOwnership = await options.identityMatch(options.temporaryPath, options.expectedIdentity);
+    if (initialOwnership !== "match") {
+        return { outcome: initialOwnership };
+    }
+    const transition = await options.transition?.begin();
+    if (transition !== undefined &&
+        (await options.identityMatch(options.temporaryPath, options.expectedIdentity)) !== "match") {
+        throw new Error(`Owned temporary changed after its cleanup transition began: ${options.displayPath}.`);
+    }
+    return { outcome: "owned", transition };
+}
+async function removeEmptyQuarantineAfterMissing(options) {
+    const terminalRoot = await ensureTerminalEvidenceDirectory(options.retiredEvidenceRoot, { mkdir: options.makeDirectory });
+    await assertTerminalEvidenceDirectory(terminalRoot);
+    await options.move(options.quarantineDirectory, options.retiredDirectory);
+    await syncPublicationDirectory({
+        ...options.cleanupOptions,
+        parent: options.retiredEvidenceRoot
+    });
+    await syncPublicationDirectory(options.cleanupOptions);
+    if ((await options.identityMatch(options.temporaryPath, options.expectedIdentity)) !== "missing") {
+        return "different";
+    }
+    await options.transition?.complete();
+    return "missing";
+}
+async function logicallyRetireQuarantine(options) {
+    await options.beforeLogicalRetirement?.(options.quarantinedPath);
+    if ((await options.identityMatch(options.quarantinedPath, options.expectedIdentity)) !== "match") {
+        return "different";
+    }
+    await assertTerminalEvidenceDirectory(options.terminalRoot);
+    await options.move(options.quarantineDirectory, options.retiredDirectory);
+    await syncPublicationDirectory({
+        ...options.cleanupOptions,
+        parent: options.terminalRoot.path
+    });
+    await syncPublicationDirectory(options.cleanupOptions);
+    return "removed";
+}
+export async function cleanupIdentityMatchingOwnedTemporary(options) {
+    const { beforeLogicalRetirement, identityMatch, makeDirectory, move, restore, token } = cleanupOperations(options.operations);
+    const quarantineDirectory = join(options.parent, `${ownedTemporaryCleanupResiduePrefix(options.temporaryPath)}${token}`);
+    const quarantinedPath = join(quarantineDirectory, "owned-temporary");
+    const retiredEvidenceRoot = join(options.parent, OWNED_TEMPORARY_RETIRED_EVIDENCE_MARKER);
+    const retiredDirectory = join(retiredEvidenceRoot, token);
+    const begun = await beginCleanupTransition({
+        displayPath: options.displayPath,
+        expectedIdentity: options.expectedIdentity,
+        identityMatch,
+        temporaryPath: options.temporaryPath,
+        ...(options.transition === undefined
+            ? {}
+            : { transition: options.transition })
+    });
+    if (begun.outcome !== "owned") {
+        return begun.outcome;
+    }
+    const { transition } = begun;
+    try {
+        await makeDirectory(quarantineDirectory, { mode: 0o700 });
+    }
+    catch (error) {
+        if (errorCode(error) === "EEXIST") {
+            return "different";
+        }
+        throw error;
+    }
+    try {
+        await move(options.temporaryPath, quarantinedPath);
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT") {
+            return removeEmptyQuarantineAfterMissing({
+                cleanupOptions: options,
+                expectedIdentity: options.expectedIdentity,
+                identityMatch,
+                makeDirectory,
+                quarantineDirectory,
+                move,
+                retiredEvidenceRoot,
+                retiredDirectory,
+                temporaryPath: options.temporaryPath,
+                transition
+            });
+        }
+        throw error;
+    }
+    // Persist the atomic capture before deciding whether it grants deletion
+    // authority. Rename changes both directories, so durability requires the
+    // destination quarantine first and the source parent second.
+    await syncCleanupDirectory(options, quarantineDirectory);
+    await syncCleanupDirectory(options, options.parent);
+    const ownership = await identityMatch(quarantinedPath, options.expectedIdentity);
+    if (ownership === "missing") {
+        return "different";
+    }
+    if (ownership === "different") {
+        try {
+            await restore(quarantinedPath, options.temporaryPath);
+        }
+        catch (error) {
+            if (errorCode(error) === "EEXIST") {
+                return "different";
+            }
+            throw error;
+        }
+        await syncCleanupDirectory(options, options.parent);
+        return "different";
+    }
+    const terminalRoot = await ensureTerminalEvidenceDirectory(retiredEvidenceRoot, { mkdir: makeDirectory });
+    await syncCleanupDirectory(options, options.parent);
+    // Node exposes no unlink-by-handle or identity-conditional unlink. Moving
+    // the whole private directory into a terminal namespace is atomic and can
+    // never delete a pathname replacement introduced after the final proof.
+    const retirement = await logicallyRetireQuarantine({
+        cleanupOptions: options,
+        expectedIdentity: options.expectedIdentity,
+        identityMatch,
+        move,
+        quarantinedPath,
+        quarantineDirectory,
+        retiredDirectory,
+        terminalRoot,
+        ...(beforeLogicalRetirement === undefined
+            ? {}
+            : { beforeLogicalRetirement })
+    });
+    if (retirement === "different") {
+        return retirement;
+    }
+    // Retirement proves the captured evidence is durable, but success also
+    // requires the original source name to remain absent. A repopulated source
+    // is foreign evidence: retain both names and the begun transition so the
+    // PUBLISHING transaction cannot be falsely completed.
+    if ((await identityMatch(options.temporaryPath, options.expectedIdentity)) !== "missing") {
+        return "different";
+    }
+    await transition?.complete();
+    return "removed";
+}
+async function syncCleanupDirectory(options, parent) {
+    await syncPublicationDirectory({ ...options, parent });
+}
+function errorCode(error) {
+    return error instanceof Error && "code" in error
+        ? error.code
+        : undefined;
+}
+//# sourceMappingURL=node-cleanup-owned-temporary.js.map

package/dist/repository-mutation/adapters/node/node-cleanup-owned-temporary.js.map

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

package/dist/repository-mutation/adapters/node/node-create-and-bind-directory.d.ts

@@ -0,0 +1,14 @@
+export interface NodeDirectoryCreateAndBindOperations<Parent, Observed, Bound> {
+    readonly ambiguousError: (error: unknown) => Error;
+    readonly bind: (bound: Bound) => Promise<void>;
+    readonly captureParent: () => Promise<Parent>;
+    readonly createAndObserve: (parent: Parent, markCreated: () => void) => Promise<Observed>;
+    readonly recapture: (parent: Parent, observed: Observed) => Promise<Bound>;
+    readonly syncParent: (parent: Parent) => Promise<void>;
+}
+/**
+ * Shared no-cancellation directory critical section. Callers retain their own
+ * full-chain authority model, while this kernel fixes the mutation ordering.
+ */
+export declare function createAndBindNodeDirectory<Parent, Observed, Bound>(operations: NodeDirectoryCreateAndBindOperations<Parent, Observed, Bound>): Promise<Bound>;
+//# sourceMappingURL=node-create-and-bind-directory.d.ts.map

package/dist/repository-mutation/adapters/node/node-create-and-bind-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-create-and-bind-directory.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-create-and-bind-directory.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oCAAoC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK;IAC3E,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,CACzB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,IAAI,KACpB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3E,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EACtE,UAAU,EAAE,oCAAoC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,GACxE,OAAO,CAAC,KAAK,CAAC,CAmBhB"}

package/dist/repository-mutation/adapters/node/node-create-and-bind-directory.js

@@ -0,0 +1,23 @@
+/**
+ * Shared no-cancellation directory critical section. Callers retain their own
+ * full-chain authority model, while this kernel fixes the mutation ordering.
+ */
+export async function createAndBindNodeDirectory(operations) {
+    const parent = await operations.captureParent();
+    const mutation = { created: false };
+    try {
+        const observed = await operations.createAndObserve(parent, () => { mutation.created = true; });
+        await operations.recapture(parent, observed);
+        await operations.syncParent(parent);
+        const bound = await operations.recapture(parent, observed);
+        await operations.bind(bound);
+        return bound;
+    }
+    catch (error) {
+        if (!mutation.created) {
+            throw error;
+        }
+        throw operations.ambiguousError(error);
+    }
+}
+//# sourceMappingURL=node-create-and-bind-directory.js.map

package/dist/repository-mutation/adapters/node/node-create-and-bind-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-create-and-bind-directory.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-create-and-bind-directory.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAyE;IAEzE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAChD,MAAM,EACN,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CACnC,CAAC;QACF,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC7C,MAAM,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3D,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,17 @@
+export type DirectoryDurability = "durable" | "unsupported";
+export declare class StrictDirectoryDurabilityError extends Error {
+    constructor(path: string);
+}
+export interface DirectorySyncHandle {
+    close(): Promise<void>;
+    sync(): Promise<void>;
+}
+export interface DirectoryDurabilityOperations {
+    readonly open: (path: string) => Promise<DirectorySyncHandle>;
+    readonly platform: NodeJS.Platform;
+}
+export declare function syncDirectoryDurably(path: string, operations?: DirectoryDurabilityOperations): Promise<DirectoryDurability>;
+/** For evidence whose protocol cannot honestly admit best-effort durability. */
+export declare function syncDirectoryStrictly(path: string): Promise<void>;
+export declare function syncDirectoryStrictlyWith(path: string, syncDirectory: (path: string) => Promise<DirectoryDurability>): Promise<void>;
+//# sourceMappingURL=node-directory-durability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-directory-durability.d.ts","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-directory-durability.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,aAAa,CAAC;AAE5D,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,YAAmB,IAAI,EAAE,MAAM,EAG9B;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CACpC;AAeD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,6BAAiE,GAC5E,OAAO,CAAC,mBAAmB,CAAC,CAkB9B;AAED,gFAAgF;AAChF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC,CAIf"}

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

@@ -0,0 +1,47 @@
+import { open } from "node:fs/promises";
+export class StrictDirectoryDurabilityError extends Error {
+    constructor(path) {
+        super(`Strict directory durability is unsupported: ${path}.`);
+        this.name = "StrictDirectoryDurabilityError";
+    }
+}
+const nodeDirectoryDurabilityOperations = {
+    async open(path) {
+        return open(path, "r");
+    },
+    platform: process.platform
+};
+function errorCode(error) {
+    return error instanceof Error && "code" in error
+        ? error.code
+        : undefined;
+}
+export async function syncDirectoryDurably(path, operations = nodeDirectoryDurabilityOperations) {
+    try {
+        const handle = await operations.open(path);
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        return "durable";
+    }
+    catch (error) {
+        if (operations.platform === "win32" &&
+            ["EACCES", "EINVAL", "EISDIR", "EPERM"].includes(errorCode(error) ?? "")) {
+            return "unsupported";
+        }
+        throw error;
+    }
+}
+/** For evidence whose protocol cannot honestly admit best-effort durability. */
+export async function syncDirectoryStrictly(path) {
+    return syncDirectoryStrictlyWith(path, syncDirectoryDurably);
+}
+export async function syncDirectoryStrictlyWith(path, syncDirectory) {
+    if ((await syncDirectory(path)) === "unsupported") {
+        throw new StrictDirectoryDurabilityError(path);
+    }
+}
+//# sourceMappingURL=node-directory-durability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-directory-durability.js","sourceRoot":"","sources":["../../../../src/repository-mutation/adapters/node/node-directory-durability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIxC,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD,YAAmB,IAAY;QAC7B,KAAK,CAAC,+CAA+C,IAAI,GAAG,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAYD,MAAM,iCAAiC,GAAkC;IACvE,KAAK,CAAC,IAAI,CAAC,IAAI;QACb,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,QAAQ,EAAE,OAAO,CAAC,QAAQ;CAC3B,CAAC;AAEF,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK;QAC9C,CAAC,CAAE,KAA+B,CAAC,IAAI;QACvC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,UAAU,GAAkC,iCAAiC;IAE7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,UAAU,CAAC,QAAQ,KAAK,OAAO;YAC/B,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EACxE,CAAC;YACD,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,OAAO,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAY,EACZ,aAA6D;IAE7D,IAAI,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;QAClD,MAAM,IAAI,8BAA8B,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

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;AAwL1B,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"}