@agent-teams/engineering-foundation 0.14.0 → 0.16.0-rc.0

package/dist/document-authoring/adapters/node/node-document-planning-state-reader.js

@@ -0,0 +1,164 @@
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { assertNotCancelled } from "../../../cancellation.js";
+import { ContainedFileReadError, readContainedRegularFile } from "../../../filesystem-path-safety.js";
+import { documentRepositoryParentPath, isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+const MAX_EXISTING_DESTINATION_BYTES = 1024 * 1024;
+function hasCode(error, code) {
+    return error instanceof Error && "code" in error &&
+        error.code === code;
+}
+function isMissing(error) {
+    return hasCode(error, "ENOENT") || hasCode(error, "ENOTDIR");
+}
+function contained(root, candidate) {
+    const relation = relative(root, candidate);
+    return relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`));
+}
+function portableNameIdentity(name) {
+    return name.normalize("NFC").replace(/[A-Z]/gu, (character) => character.toLowerCase());
+}
+async function hasPortableNameCollision(parent, requestedName) {
+    const requestedIdentity = portableNameIdentity(requestedName);
+    const entries = await readdir(parent);
+    return entries.some((entry) => entry !== requestedName && portableNameIdentity(entry) === requestedIdentity);
+}
+function parentUnavailable(message, cause) {
+    throw new DocumentPlanningError("DOCUMENT_PLANNING_PARENT_UNAVAILABLE", message, cause === undefined ? undefined : { cause });
+}
+function observationUnavailable(message, cause) {
+    throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", message, cause === undefined ? undefined : { cause });
+}
+async function observeRegularDestination(input) {
+    try {
+        const bytes = await readContainedRegularFile({
+            candidate: input.candidate,
+            maxBytes: MAX_EXISTING_DESTINATION_BYTES,
+            root: input.root
+        });
+        return Object.freeze({
+            bytes: new Uint8Array(bytes),
+            state: "regular-file"
+        });
+    }
+    catch (error) {
+        if (error instanceof ContainedFileReadError &&
+            (error.failure === "invalid" || error.failure === "symlink")) {
+            return Object.freeze({ kind: "special-file", state: "conflict" });
+        }
+        if (error instanceof ContainedFileReadError) {
+            observationUnavailable(`Document destination changed or became unavailable: ${input.destination}.`, error);
+        }
+        throw error;
+    }
+}
+async function observeRealParent(input) {
+    const lexicalRoot = resolve(input.consumerRoot);
+    let root;
+    try {
+        const rootMetadata = await lstat(lexicalRoot);
+        if (rootMetadata.isSymbolicLink() || !rootMetadata.isDirectory()) {
+            parentUnavailable("Document repository root must be a real directory.");
+        }
+        root = await realpath(lexicalRoot);
+    }
+    catch (error) {
+        if (error instanceof DocumentPlanningError) {
+            throw error;
+        }
+        parentUnavailable("Document repository root is unavailable.", error);
+    }
+    let current = root;
+    const parentSegments = input.destination.split("/").slice(0, -1);
+    for (const segment of parentSegments) {
+        assertNotCancelled(input.signal);
+        try {
+            if (await hasPortableNameCollision(current, segment)) {
+                parentUnavailable(`Document destination parent has a portable name collision: ${segment}.`);
+            }
+            const next = join(current, segment);
+            const metadata = await lstat(next);
+            if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+                parentUnavailable(`Document destination parent ancestry must contain only real directories: ${segment}.`);
+            }
+            const canonical = await realpath(next);
+            if (!contained(root, canonical)) {
+                parentUnavailable("Document destination parent escapes the repository.");
+            }
+            current = canonical;
+        }
+        catch (error) {
+            if (error instanceof DocumentPlanningError) {
+                throw error;
+            }
+            if (isMissing(error)) {
+                parentUnavailable("Document destination parent must already exist.", error);
+            }
+            parentUnavailable("Document destination parent cannot be observed safely.", error);
+        }
+    }
+    return { parent: current, root };
+}
+export class NodeDocumentPlanningStateReader {
+    async observe(request) {
+        assertNotCancelled(request.signal);
+        if (!isDocumentRepositoryPath(request.destination)) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_INPUT_INVALID", "Document destination must use the portable repository-relative path grammar.");
+        }
+        const { parent, root } = await observeRealParent(request);
+        assertNotCancelled(request.signal);
+        const basename = request.destination.split("/").at(-1) ?? "";
+        let destination;
+        try {
+            if (await hasPortableNameCollision(parent, basename)) {
+                destination = Object.freeze({
+                    kind: "portable-name-collision",
+                    state: "conflict"
+                });
+            }
+            else {
+                const candidate = join(parent, basename);
+                const metadata = await lstat(candidate).catch((error) => {
+                    if (isMissing(error)) {
+                        return null;
+                    }
+                    throw error;
+                });
+                if (metadata === null) {
+                    destination = Object.freeze({ state: "absent" });
+                }
+                else if (metadata.isSymbolicLink() || !metadata.isFile()) {
+                    destination = Object.freeze({
+                        kind: metadata.isDirectory() ? "directory" : "special-file",
+                        state: "conflict"
+                    });
+                }
+                else {
+                    destination = await observeRegularDestination({
+                        candidate,
+                        destination: request.destination,
+                        root
+                    });
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof DocumentPlanningError) {
+                throw error;
+            }
+            observationUnavailable(`Document destination cannot be observed safely: ${request.destination}.`, error);
+        }
+        assertNotCancelled(request.signal);
+        return Object.freeze({
+            destination,
+            expectedParent: Object.freeze({
+                ancestry: "real-directories",
+                path: documentRepositoryParentPath(request.destination),
+                state: "directory"
+            })
+        });
+    }
+}
+//# sourceMappingURL=node-document-planning-state-reader.js.map

package/dist/document-authoring/adapters/node/node-document-planning-state-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-planning-state-reader.js","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-planning-state-reader.ts"],"names":[],"mappings":"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"}

package/dist/document-authoring/adapters/node/node-document-publisher-private.d.ts

@@ -0,0 +1,2 @@
+export { NodeDocumentPublisher } from "./node-document-publisher.js";
+//# sourceMappingURL=node-document-publisher-private.d.ts.map

package/dist/document-authoring/adapters/node/node-document-publisher-private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-publisher-private.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-publisher-private.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACtB,MAAM,8BAA8B,CAAC"}

package/dist/document-authoring/adapters/node/node-document-publisher-private.js

@@ -0,0 +1,2 @@
+export { NodeDocumentPublisher } from "./node-document-publisher.js";
+//# sourceMappingURL=node-document-publisher-private.js.map

package/dist/document-authoring/adapters/node/node-document-publisher-private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-publisher-private.js","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-publisher-private.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACtB,MAAM,8BAA8B,CAAC"}

package/dist/document-authoring/adapters/node/node-document-publisher.d.ts

@@ -0,0 +1,54 @@
+import { link, open, rm } from "node:fs/promises";
+import { syncDirectoryDurably, syncDirectoryStrictly } from "../../../repository-mutation/adapters/node/node-directory-durability.js";
+import { type DocumentPhysicalIdentity } from "../../application/model/document-physical-identity.js";
+import type { DocumentOwnedTemporary } from "../../application/model/document-transaction.js";
+import type { DocumentPlan } from "../../application/model/document-planning.js";
+import type { DocumentPublicationResult, DocumentPublisher } from "../../application/ports/document-publisher.js";
+type NodeDocumentPublisherFaultPoint = {
+    readonly phase: "after-temporary-synced";
+} | {
+    readonly phase: "after-hard-link";
+} | {
+    readonly phase: "after-publication-synced";
+} | {
+    readonly phase: "after-temporary-cleanup-synced";
+};
+type NodeDocumentPublisherFaultInjector = (point: NodeDocumentPublisherFaultPoint) => Promise<void> | void;
+export interface NodeDocumentPublisherOperations {
+    readonly faultInjector?: NodeDocumentPublisherFaultInjector;
+    readonly link?: typeof link;
+    readonly open?: typeof open;
+    readonly remove?: typeof rm;
+    readonly syncDirectoryDurably?: typeof syncDirectoryDurably;
+    readonly syncDirectoryStrictly?: typeof syncDirectoryStrictly;
+}
+export declare class NodeDocumentPublisher implements DocumentPublisher {
+    #private;
+    constructor(operations?: NodeDocumentPublisherOperations);
+    prepare(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentOwnedTemporary>;
+    publishPrepared(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+        readonly temporary: DocumentOwnedTemporary;
+    }): Promise<DocumentPublicationResult>;
+    completePublication(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+        readonly temporary: DocumentOwnedTemporary;
+    }): Promise<{
+        readonly publicationIdentity: DocumentPhysicalIdentity;
+    }>;
+    removeOwnedTemporary(request: {
+        readonly consumerRoot: string;
+        readonly signal?: AbortSignal;
+        readonly temporary: DocumentOwnedTemporary;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=node-document-publisher.d.ts.map

package/dist/document-authoring/adapters/node/node-document-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-publisher.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-publisher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,yEAAyE,CAAC;AAKjF,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,+CAA+C,CAAC;AAmEvD,KAAK,+BAA+B,GAChC;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACrC;IAAE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,KAAK,EAAE,gCAAgC,CAAA;CAAE,CAAC;AAEzD,KAAK,kCAAkC,GAAG,CACxC,KAAK,EAAE,+BAA+B,KACnC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,kCAAkC,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAC;IAC5D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,qBAAqB,CAAC;CAC/D;AAED,qBAAa,qBAAsB,YAAW,iBAAiB;;IAI7D,YAAmB,UAAU,GAAE,+BAAoC,EAWlE;IAEK,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2ClC;IAEK,eAAe,CAAC,OAAO,EAAE;QAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;KAC5C,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAkDrC;IAEK,mBAAmB,CAAC,OAAO,EAAE;QACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;KAC5C,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,CAAA;KAAE,CAAC,CA+DtE;IAEK,oBAAoB,CAAC,OAAO,EAAE;QAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;KAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;CACF"}

package/dist/document-authoring/adapters/node/node-document-publisher.js

@@ -0,0 +1,252 @@
+import { createHash } from "node:crypto";
+import { link, open, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { cleanupIdentityMatchingOwnedTemporary } from "../../../repository-mutation/adapters/node/node-cleanup-owned-temporary.js";
+import { syncDirectoryDurably, syncDirectoryStrictly } from "../../../repository-mutation/adapters/node/node-directory-durability.js";
+import { prepareExactSiblingTemporary } from "../../../repository-mutation/adapters/node/node-prepare-exact-sibling-temporary.js";
+import { publishPreparedAbsentFile } from "../../../repository-mutation/adapters/node/node-publish-prepared-absent-file.js";
+import { readBoundedRegularFile } from "../../../repository-mutation/adapters/node/node-bounded-regular-file.js";
+import { assertDocumentPhysicalIdentity, assertNonzeroDocumentPhysicalIdentity } from "../../application/model/document-physical-identity.js";
+import { documentTemporaryPath } from "../../application/policies/document-temporary-path.js";
+import { recaptureDocumentPublicationPaths, sameDocumentAncestry, sameDocumentPhysicalIdentity } from "./recapture-document-publication-paths.js";
+function postimage(plan) {
+    return {
+        bytes: Buffer.from(plan.output.contentBase64, "base64"),
+        digest: plan.output.digest,
+        mode: 0o644,
+        size: plan.output.size
+    };
+}
+function wireIdentity(identity, authorityRequired) {
+    const result = {
+        adapter: "node-filesystem",
+        version: 1,
+        dev: identity.dev.toString(10),
+        ino: identity.ino.toString(10),
+        birthtimeNs: identity.birthtimeNs.toString(10)
+    };
+    assertDocumentPhysicalIdentity(result);
+    if (authorityRequired) {
+        assertNonzeroDocumentPhysicalIdentity(result);
+    }
+    return result;
+}
+function physicalIdentity(temporary) {
+    const value = temporary.identity;
+    assertNonzeroDocumentPhysicalIdentity(value);
+    const result = {
+        dev: BigInt(value.dev),
+        ino: BigInt(value.ino),
+        birthtimeNs: BigInt(value.birthtimeNs)
+    };
+    return result;
+}
+async function readExactPublicationIdentity(destinationPath, plan) {
+    const observed = await readBoundedRegularFile(destinationPath, plan.output.size);
+    if (observed.outcome !== "read" ||
+        observed.bytes.byteLength !== plan.output.size ||
+        `sha256:${createHash("sha256").update(observed.bytes).digest("hex")}` !== plan.output.digest ||
+        (process.platform !== "win32" && (observed.mode & 0o777) !== 0o644)) {
+        throw new Error("Published document identity could not be verified.");
+    }
+    return wireIdentity(observed.identity, true);
+}
+function assertTemporaryBinding(plan, temporary) {
+    if (temporary.path !== documentTemporaryPath(plan.destination, plan.planDigest) ||
+        temporary.digest !== plan.output.digest) {
+        throw new Error("Document temporary is not exactly bound to the supplied Plan.");
+    }
+}
+export class NodeDocumentPublisher {
+    #operations;
+    constructor(operations = {}) {
+        this.#operations = {
+            link: operations.link ?? link,
+            open: operations.open ?? open,
+            remove: operations.remove ?? rm,
+            syncDirectoryDurably: operations.syncDirectoryDurably ?? syncDirectoryDurably,
+            syncDirectoryStrictly: operations.syncDirectoryStrictly ?? syncDirectoryStrictly,
+            ...(operations.faultInjector === undefined
+                ? {}
+                : { faultInjector: operations.faultInjector })
+        };
+    }
+    async prepare(request) {
+        request.signal?.throwIfAborted();
+        const paths = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.plan.destination
+        });
+        const temporaryPath = documentTemporaryPath(request.plan.destination, request.plan.planDigest);
+        const temporaryAbsolutePath = join(paths.root, ...temporaryPath.split("/"));
+        await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: temporaryPath
+        });
+        await this.#operations.syncDirectoryStrictly(paths.parent);
+        const recaptured = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.plan.destination
+        });
+        if (!sameDocumentAncestry(paths.ancestryIdentities, recaptured.ancestryIdentities)) {
+            throw new Error("Document publication parent changed during durability preflight.");
+        }
+        request.signal?.throwIfAborted();
+        const captured = await prepareExactSiblingTemporary({
+            displayPath: temporaryPath,
+            faultInjector: undefined,
+            onIdentityCaptured() { },
+            open: this.#operations.open,
+            postimage: postimage(request.plan),
+            temporaryPath: temporaryAbsolutePath
+        });
+        await this.#operations.syncDirectoryStrictly(recaptured.parent);
+        await this.#operations.faultInjector?.({ phase: "after-temporary-synced" });
+        const temporary = {
+            path: temporaryPath,
+            digest: request.plan.output.digest,
+            identity: wireIdentity(captured, false)
+        };
+        return Object.freeze({
+            ...temporary,
+            identity: Object.freeze(temporary.identity)
+        });
+    }
+    async publishPrepared(request) {
+        request.signal?.throwIfAborted();
+        assertTemporaryBinding(request.plan, request.temporary);
+        const expectedIdentity = physicalIdentity(request.temporary);
+        const before = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.plan.destination
+        });
+        await this.#operations.syncDirectoryStrictly(before.parent);
+        const paths = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.plan.destination
+        });
+        if (!sameDocumentAncestry(before.ancestryIdentities, paths.ancestryIdentities)) {
+            throw new Error("Document publication parent changed during durability preflight.");
+        }
+        const temporaryPath = join(paths.root, ...request.temporary.path.split("/"));
+        request.signal?.throwIfAborted();
+        // No cancellation observation is allowed after this point: link may have
+        // succeeded even when a caller aborts while publication is in flight.
+        const outcome = await publishPreparedAbsentFile({
+            allowUnsupportedDirectoryDurability: false,
+            classifyBoundedRegularFile: readBoundedRegularFile,
+            destinationPath: paths.destinationPath,
+            displayPath: request.plan.destination,
+            expectedIdentity,
+            faultInjector: async () => this.#operations.faultInjector?.({
+                phase: "after-hard-link"
+            }),
+            link: this.#operations.link,
+            parent: paths.parent,
+            postimage: postimage(request.plan),
+            readBoundedRegularFile,
+            syncDirectory: this.#operations.syncDirectoryDurably,
+            temporaryPath
+        });
+        await this.#operations.faultInjector?.({ phase: "after-publication-synced" });
+        if (outcome === "published") {
+            return Object.freeze({
+                outcome,
+                publicationIdentity: Object.freeze(wireIdentity(expectedIdentity, true)),
+                identityEvidence: "owned-temporary"
+            });
+        }
+        return Object.freeze({
+            outcome,
+            publicationIdentity: Object.freeze(await readExactPublicationIdentity(paths.destinationPath, request.plan))
+        });
+    }
+    async completePublication(request) {
+        request.signal?.throwIfAborted();
+        assertTemporaryBinding(request.plan, request.temporary);
+        const expectedIdentity = physicalIdentity(request.temporary);
+        const before = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.plan.destination
+        });
+        const temporaryPath = join(before.root, ...request.temporary.path.split("/"));
+        request.signal?.throwIfAborted();
+        // From this point recovery completion is cancellation-masked: publication
+        // may already exist and its durability must reach a verified postcondition.
+        const publicationIdentity = await readExactPublicationIdentity(before.destinationPath, request.plan);
+        if (!sameDocumentPhysicalIdentity({
+            dev: BigInt(publicationIdentity.dev),
+            ino: BigInt(publicationIdentity.ino),
+            birthtimeNs: BigInt(publicationIdentity.birthtimeNs)
+        }, expectedIdentity)) {
+            throw new Error("Published document does not match its bound temporary identity.");
+        }
+        try {
+            const observedTemporary = await readBoundedRegularFile(temporaryPath, request.plan.output.size);
+            if (observedTemporary.outcome !== "read" ||
+                !sameDocumentPhysicalIdentity(observedTemporary.identity, expectedIdentity) ||
+                `sha256:${createHash("sha256").update(observedTemporary.bytes).digest("hex")}` !== request.plan.output.digest ||
+                (process.platform !== "win32" && (observedTemporary.mode & 0o777) !== 0o644)) {
+                throw new Error("Bound document temporary changed during publication completion.");
+            }
+        }
+        catch (error) {
+            if (!(error instanceof Error && "code" in error &&
+                error.code === "ENOENT")) {
+                throw error;
+            }
+        }
+        await this.#operations.syncDirectoryStrictly(before.parent);
+        const after = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.plan.destination
+        });
+        if (!sameDocumentAncestry(before.ancestryIdentities, after.ancestryIdentities)) {
+            throw new Error("Document publication parent changed during completion.");
+        }
+        const verifiedIdentity = await readExactPublicationIdentity(after.destinationPath, request.plan);
+        if (verifiedIdentity.dev !== publicationIdentity.dev ||
+            verifiedIdentity.ino !== publicationIdentity.ino ||
+            verifiedIdentity.birthtimeNs !== publicationIdentity.birthtimeNs) {
+            throw new Error("Published document identity changed during completion.");
+        }
+        return Object.freeze({
+            publicationIdentity: Object.freeze(verifiedIdentity)
+        });
+    }
+    async removeOwnedTemporary(request) {
+        request.signal?.throwIfAborted();
+        const expectedIdentity = physicalIdentity(request.temporary);
+        const paths = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.temporary.path
+        });
+        await this.#operations.syncDirectoryStrictly(paths.parent);
+        const recaptured = await recaptureDocumentPublicationPaths({
+            consumerRoot: request.consumerRoot,
+            destination: request.temporary.path
+        });
+        if (!sameDocumentAncestry(paths.ancestryIdentities, recaptured.ancestryIdentities)) {
+            throw new Error("Document temporary parent changed during durability preflight.");
+        }
+        request.signal?.throwIfAborted();
+        // Cleanup is an identity-authorized mutation. Once started, finish without
+        // observing cancellation so callers cannot receive a false pre-mutation view.
+        const outcome = await cleanupIdentityMatchingOwnedTemporary({
+            allowUnsupportedDirectoryDurability: false,
+            displayPath: request.temporary.path,
+            expectedIdentity,
+            parent: recaptured.parent,
+            rm: this.#operations.remove,
+            syncDirectory: this.#operations.syncDirectoryDurably,
+            temporaryPath: recaptured.destinationPath
+        });
+        if (outcome === "different") {
+            throw new Error("Document temporary was replaced and was preserved.");
+        }
+        await this.#operations.faultInjector?.({
+            phase: "after-temporary-cleanup-synced"
+        });
+    }
+}
+//# sourceMappingURL=node-document-publisher.js.map

package/dist/document-authoring/adapters/node/node-document-publisher.js.map

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

package/dist/document-authoring/adapters/node/node-document-reachability-projector.d.ts

@@ -0,0 +1,17 @@
+import type { DocumentReachabilityProjection } from "../../application/model/document-command.js";
+import type { DocumentPlan } from "../../application/model/document-planning.js";
+import type { DocumentPlanningProfileReader } from "../../application/ports/document-planning-profile-reader.js";
+import type { DocumentReachabilityProjector } from "../../application/ports/document-reachability-projector.js";
+/**
+ * Projects the manual reachability action from the exact profile authority
+ * captured by the plan. It never infers a profile from repository layout.
+ */
+export declare class NodeDocumentReachabilityProjector implements DocumentReachabilityProjector {
+    #private;
+    constructor(profiles: DocumentPlanningProfileReader);
+    project(input: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+    }): Promise<DocumentReachabilityProjection>;
+}
+//# sourceMappingURL=node-document-reachability-projector.d.ts.map

package/dist/document-authoring/adapters/node/node-document-reachability-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-reachability-projector.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-reachability-projector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAIlG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6DAA6D,CAAC;AACjH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4DAA4D,CAAC;AAqBhH;;;GAGG;AACH,qBAAa,iCACb,YAAW,6BAA6B;;IAGtC,YAAY,QAAQ,EAAE,6BAA6B,EAElD;IAEK,OAAO,CAAC,KAAK,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;KAC7B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAwB1C;CACF"}

package/dist/document-authoring/adapters/node/node-document-reachability-projector.js

@@ -0,0 +1,43 @@
+import { projectDocumentReachability } from "../../application/policies/project-document-reachability.js";
+import { selectDocumentArtifact } from "../../application/policies/resolve-document-authoring.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+function sameEvidence(observed, planned) {
+    return observed.path === planned.path &&
+        observed.digest === planned.digest &&
+        observed.size === planned.size;
+}
+function authorityMismatch(message) {
+    throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_CHANGED", message);
+}
+/**
+ * Projects the manual reachability action from the exact profile authority
+ * captured by the plan. It never infers a profile from repository layout.
+ */
+export class NodeDocumentReachabilityProjector {
+    #profiles;
+    constructor(profiles) {
+        this.#profiles = profiles;
+    }
+    async project(input) {
+        const profile = await this.#profiles.read({
+            consumerRoot: input.consumerRoot,
+            path: input.plan.authority.profile.path,
+        });
+        if (!sameEvidence(profile.evidence, input.plan.authority.profile)) {
+            authorityMismatch("Document authoring profile changed after the plan was compiled.");
+        }
+        if (profile.projectId !== input.plan.projectId) {
+            authorityMismatch("Document authoring profile no longer identifies the planned project.");
+        }
+        const artifact = selectDocumentArtifact(profile, input.plan.intent.type);
+        const heading = artifact.heading.kind === "title"
+            ? input.plan.intent.title
+            : `${input.plan.intent.id}: ${input.plan.intent.title}`;
+        return projectDocumentReachability({
+            artifact,
+            destination: input.plan.destination,
+            heading,
+        });
+    }
+}
+//# sourceMappingURL=node-document-reachability-projector.js.map

package/dist/document-authoring/adapters/node/node-document-reachability-projector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-reachability-projector.js","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-reachability-projector.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,SAAS,YAAY,CACnB,QAAmC,EACnC,OAAkC;IAElC,OAAO,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI;QACnC,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;QAClC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,IAAI,qBAAqB,CAC7B,qCAAqC,EACrC,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,iCAAiC;IAEnC,SAAS,CAAgC;IAElD,YAAY,QAAuC;QACjD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAGb;QACC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YACxC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI;SACxC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAClE,iBAAiB,CACf,iEAAiE,CAClE,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/C,iBAAiB,CACf,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;YAC/C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK;YACzB,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,OAAO,2BAA2B,CAAC;YACjC,QAAQ;YACR,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;YACnC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/document-authoring/adapters/node/node-document-structure-verifier.d.ts

@@ -0,0 +1,21 @@
+import type { DocumentPlan } from "../../application/model/document-planning.js";
+import type { DocumentStructureDiagnostic, DocumentStructureVerifier } from "../../application/ports/document-structure-verifier.js";
+import type { DocumentPlanningProfileReader } from "../../application/ports/document-planning-profile-reader.js";
+import type { DocumentationCatalogReader } from "../../application/ports/documentation-catalog-reader.js";
+/** Rebuilds the catalog and proves that the applied document has one exact descriptor. */
+export declare class NodeDocumentStructureVerifier implements DocumentStructureVerifier {
+    #private;
+    constructor(dependencies: {
+        readonly catalog: DocumentationCatalogReader;
+        readonly profiles: DocumentPlanningProfileReader;
+    });
+    verify(input: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+    }): Promise<{
+        readonly diagnostics: readonly DocumentStructureDiagnostic[];
+        readonly valid: boolean;
+    }>;
+}
+//# sourceMappingURL=node-document-structure-verifier.d.ts.map

package/dist/document-authoring/adapters/node/node-document-structure-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-structure-verifier.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-structure-verifier.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6DAA6D,CAAC;AACjH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AAuE1G,0FAA0F;AAC1F,qBAAa,6BAA8B,YAAW,yBAAyB;;IAI7E,YAAY,YAAY,EAAE;QACxB,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;QAC7C,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,CAAC;KAClD,EAGA;IAEK,MAAM,CAAC,KAAK,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC;QACV,QAAQ,CAAC,WAAW,EAAE,SAAS,2BAA2B,EAAE,CAAC;QAC7D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,CAAC,CAwDD;CACF"}