@agent-teams/engineering-foundation 0.15.0 → 0.16.0

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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,qCAAqC,EAAE,MAAM,4EAA4E,CAAC;AACnI,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,yEAAyE,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,oFAAoF,CAAC;AAClI,OAAO,EAAE,yBAAyB,EAAE,MAAM,iFAAiF,CAAC;AAC5H,OAAO,EAAE,sBAAsB,EAAE,MAAM,yEAAyE,CAAC;AAEjH,OAAO,EACL,8BAA8B,EAC9B,qCAAqC,EAEtC,MAAM,uDAAuD,CAAC;AAO/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uDAAuD,CAAC;AAC9F,OAAO,EACL,iCAAiC,EACjC,oBAAoB,EACpB,4BAA4B,EAC7B,MAAM,2CAA2C,CAAC;AAEnD,SAAS,SAAS,CAAC,IAAkB;IACnC,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC;QACvD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QAC1B,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,QAA8B,EAC9B,iBAA0B;IAE1B,MAAM,MAAM,GAA6B;QACvC,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;KAC/C,CAAC;IACF,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,iBAAiB,EAAE,CAAC;QACtB,qCAAqC,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiC;IACzD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC;IACjC,qCAAqC,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG;QACb,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;KACvC,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,eAAuB,EACvB,IAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjF,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM;QAC7B,QAAQ,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI;QAC9C,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM;QAC5F,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAkB,EAAE,SAAiC;IACnF,IAAI,SAAS,CAAC,IAAI,KAAK,qBAAqB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC;QAC7E,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAqBD,MAAM,OAAO,qBAAqB;IACvB,WAAW,CACqC;IAEzD,YAAmB,UAAU,GAAoC,EAAE;QACjE,IAAI,CAAC,WAAW,GAAG;YACjB,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,IAAI;YAC7B,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,IAAI;YAC7B,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;YAC/B,oBAAoB,EAAE,UAAU,CAAC,oBAAoB,IAAI,oBAAoB;YAC7E,qBAAqB,EAAE,UAAU,CAAC,qBAAqB,IAAI,qBAAqB;YAChF,GAAG,CAAC,UAAU,CAAC,aAAa,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,aAAa,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAIb;QACC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,iCAAiC,CAAC;YACpD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;SACtC,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,qBAAqB,CACzC,OAAO,CAAC,IAAI,CAAC,WAAW,EACxB,OAAO,CAAC,IAAI,CAAC,UAAU,CACxB,CAAC;QACF,MAAM,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5E,MAAM,iCAAiC,CAAC;YACtC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,aAAa;SAC3B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,MAAM,iCAAiC,CAAC;YACzD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC;YAClD,WAAW,EAAE,aAAa;YAC1B,aAAa,EAAE,SAAS;YACxB,kBAAkB,KAAI,CAAC;YACvB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAC3B,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;YAClC,aAAa,EAAE,qBAAqB;SACrC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;QAC5E,MAAM,SAAS,GAA2B;YACxC,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAClC,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;SACxC,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,SAAS;YACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAKrB;QACC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,iCAAiC,CAAC;YACrD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;SACtC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,iCAAiC,CAAC;YACpD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,yEAAyE;QACzE,sEAAsE;QACtE,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC;YAC9C,mCAAmC,EAAE,KAAK;YAC1C,0BAA0B,EAAE,sBAAsB;YAClD,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;YACrC,gBAAgB;YAChB,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;gBAC1D,KAAK,EAAE,iBAAiB;aACzB,CAAC;YACF,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;YAClC,sBAAsB;YACtB,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,oBAAoB;YACpD,aAAa;SACd,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC;QAC9E,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,OAAO;gBACP,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;gBACxE,gBAAgB,EAAE,iBAAiB;aACpC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO;YACP,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAChC,MAAM,4BAA4B,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,CACxE;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,OAKzB;QACC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,iCAAiC,CAAC;YACrD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;SACtC,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,0EAA0E;QAC1E,4EAA4E;QAC5E,MAAM,mBAAmB,GAAG,MAAM,4BAA4B,CAC5D,MAAM,CAAC,eAAe,EACtB,OAAO,CAAC,IAAI,CACb,CAAC;QACF,IAAI,CAAC,4BAA4B,CAC/B;YACE,GAAG,EAAE,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC;YACpC,GAAG,EAAE,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC;YACpC,WAAW,EAAE,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC;SACrD,EACD,gBAAgB,CACjB,EAAE,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,MAAM,sBAAsB,CACpD,aAAa,EACb,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CACzB,CAAC;YACF,IAAI,iBAAiB,CAAC,OAAO,KAAK,MAAM;gBACtC,CAAC,4BAA4B,CAAC,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAC3E,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC7G,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;gBAC/E,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK;gBAC5C,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACtD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,iCAAiC,CAAC;YACpD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;SACtC,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,gBAAgB,GAAG,MAAM,4BAA4B,CACzD,KAAK,CAAC,eAAe,EACrB,OAAO,CAAC,IAAI,CACb,CAAC;QACF,IAAI,gBAAgB,CAAC,GAAG,KAAK,mBAAmB,CAAC,GAAG;YAClD,gBAAgB,CAAC,GAAG,KAAK,mBAAmB,CAAC,GAAG;YAChD,gBAAgB,CAAC,WAAW,KAAK,mBAAmB,CAAC,WAAW,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,OAI1B;QACC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,iCAAiC,CAAC;YACpD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;SACpC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,MAAM,iCAAiC,CAAC;YACzD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,2EAA2E;QAC3E,8EAA8E;QAC9E,MAAM,OAAO,GAAG,MAAM,qCAAqC,CAAC;YAC1D,mCAAmC,EAAE,KAAK;YAC1C,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI;YACnC,gBAAgB;YAChB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;YAC3B,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,oBAAoB;YACpD,aAAa,EAAE,UAAU,CAAC,eAAe;SAC1C,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YACrC,KAAK,EAAE,gCAAgC;SACxC,CAAC,CAAC;IACL,CAAC;CACF"}

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"}

package/dist/document-authoring/adapters/node/node-document-structure-verifier.js

@@ -0,0 +1,80 @@
+import { selectDocumentArtifact } from "../../application/policies/resolve-document-authoring.js";
+function diagnostic(ruleId, subject, message) {
+    return Object.freeze({ ruleId, subject, message });
+}
+function sameEvidence(observed, planned) {
+    return observed.path === planned.path &&
+        observed.digest === planned.digest &&
+        observed.size === planned.size;
+}
+function authorityDiagnostics(catalog, plan) {
+    const diagnostics = [];
+    if (!sameEvidence(catalog.authority.profile, plan.authority.profile)) {
+        diagnostics.push(diagnostic("document.new.profile-authority-mismatch", plan.authority.profile.path, "The catalog profile authority does not match the applied plan."));
+    }
+    if (!sameEvidence(catalog.authority.metadataSchema, plan.authority.metadataSchema)) {
+        diagnostics.push(diagnostic("document.new.metadata-authority-mismatch", plan.authority.metadataSchema.path, "The catalog metadata authority does not match the applied plan."));
+    }
+    if (!sameEvidence(catalog.authority.ownerCatalog, plan.authority.ownerCatalog)) {
+        diagnostics.push(diagnostic("document.new.owner-authority-mismatch", plan.authority.ownerCatalog.path, "The catalog owner authority does not match the applied plan."));
+    }
+    if (catalog.projectId !== plan.projectId) {
+        diagnostics.push(diagnostic("document.new.project-mismatch", plan.destination, "The rebuilt catalog does not identify the planned project."));
+    }
+    return diagnostics;
+}
+function descriptorMatches(descriptor, plan, initialStatus, expectedTitle) {
+    return descriptor.id === plan.intent.id &&
+        descriptor.repositoryPath === plan.destination &&
+        descriptor.type === plan.intent.type &&
+        descriptor.title === expectedTitle &&
+        descriptor.owner === plan.intent.owner &&
+        descriptor.summary === plan.intent.summary &&
+        descriptor.status === initialStatus;
+}
+/** Rebuilds the catalog and proves that the applied document has one exact descriptor. */
+export class NodeDocumentStructureVerifier {
+    #catalog;
+    #profiles;
+    constructor(dependencies) {
+        this.#catalog = dependencies.catalog;
+        this.#profiles = dependencies.profiles;
+    }
+    async verify(input) {
+        const request = {
+            consumerRoot: input.consumerRoot,
+            profilePath: input.plan.authority.profile.path,
+            ...(input.signal === undefined ? {} : { signal: input.signal }),
+        };
+        const [catalog, profile] = await Promise.all([
+            this.#catalog.execute(request),
+            this.#profiles.read({
+                consumerRoot: input.consumerRoot,
+                path: input.plan.authority.profile.path,
+                ...(input.signal === undefined ? {} : { signal: input.signal }),
+            }),
+        ]);
+        const diagnostics = [...authorityDiagnostics(catalog, input.plan)];
+        if (!sameEvidence(profile.evidence, input.plan.authority.profile)) {
+            diagnostics.push(diagnostic("document.new.profile-authority-mismatch", input.plan.authority.profile.path, "The planning profile authority does not match the applied plan."));
+        }
+        if (catalog.status !== "complete") {
+            diagnostics.push(diagnostic("document.new.catalog-partial", input.plan.destination, "The post-apply documentation catalog is partial."));
+        }
+        const artifact = selectDocumentArtifact(profile, input.plan.intent.type);
+        const expectedTitle = artifact.heading.kind === "title"
+            ? input.plan.intent.title
+            : `${input.plan.intent.id}: ${input.plan.intent.title}`;
+        const candidates = catalog.documents.filter((entry) => entry.id === input.plan.intent.id ||
+            entry.repositoryPath === input.plan.destination);
+        if (candidates.length !== 1 ||
+            !descriptorMatches(candidates[0], input.plan, artifact.initialStatus, expectedTitle)) {
+            diagnostics.push(diagnostic("document.new.descriptor-mismatch", input.plan.destination, "The rebuilt catalog does not contain exactly the planned document descriptor."));
+        }
+        return Object.freeze({
+            diagnostics: Object.freeze(diagnostics),
+            valid: diagnostics.length === 0,
+        });
+    }
+}
+//# sourceMappingURL=node-document-structure-verifier.js.map

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

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

package/dist/document-authoring/adapters/node/node-document-transaction-coordinator.d.ts

@@ -0,0 +1,21 @@
+import type { DocumentTransactionCoordinator, DocumentTransactionLease, DocumentTransactionStatus } from "../../application/ports/document-transaction-coordinator.js";
+import type { FoundationTransactionLease } from "../../../transaction-coordination/application/foundation-transaction-coordinator.js";
+import type { InternalFoundationTransactionStatus } from "../../../transaction-coordination/application/model/internal-transaction-status.js";
+interface FoundationCoordinator {
+    inspect(): Promise<InternalFoundationTransactionStatus>;
+    acquire(options: {
+        readonly requestedMutation: "document-authoring";
+        readonly allowRecoveryOf?: "document-authoring";
+    }): Promise<FoundationTransactionLease>;
+}
+export declare class NodeDocumentTransactionCoordinator implements DocumentTransactionCoordinator {
+    #private;
+    constructor(coordinator: FoundationCoordinator);
+    inspect(): Promise<DocumentTransactionStatus>;
+    acquire(request: {
+        readonly mode: "apply" | "recover";
+    }): Promise<DocumentTransactionLease>;
+}
+export declare function createNodeDocumentTransactionCoordinator(consumerRoot: string): Promise<DocumentTransactionCoordinator>;
+export {};
+//# sourceMappingURL=node-document-transaction-coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-transaction-coordinator.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-transaction-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,6DAA6D,CAAC;AAErE,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,qFAAqF,CAAC;AAC7F,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,oFAAoF,CAAC;AAE9I,UAAU,qBAAqB;IAC7B,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAAC;IACxD,OAAO,CAAC,OAAO,EAAE;QACf,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;QACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,oBAAoB,CAAC;KACjD,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACzC;AAmFD,qBAAa,kCACX,YAAW,8BAA8B;;IAGzC,YAAY,WAAW,EAAE,qBAAqB,EAE7C;IAEK,OAAO,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAElD;IAEK,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;KACpC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAuBpC;CACF;AAED,wBAAsB,wCAAwC,CAC5D,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,8BAA8B,CAAC,CAIzC"}

package/dist/document-authoring/adapters/node/node-document-transaction-coordinator.js

@@ -0,0 +1,89 @@
+import { createNodeFoundationTransactionCoordinator } from "../../../transaction-coordination/adapters/node/node-foundation-transaction-coordinator.js";
+function observedProperty(value, property) {
+    return Reflect.get(value, property);
+}
+function isExactDocumentRecovery(status) {
+    return (status.state === "pending" &&
+        status.operationKind === "document-authoring" &&
+        observedProperty(status, "format") === "document-authoring-envelope-v3" &&
+        observedProperty(status.recovery, "commandId") === "docs-recover" &&
+        status.recovery.exactFoundationVersion === status.foundationVersion &&
+        status.recovery.exactFoundationBuildIdentity ===
+            status.foundationBuildIdentity &&
+        !status.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH"));
+}
+function manualReason(status) {
+    if (status.state === "manual-recovery-required") {
+        return status.reason;
+    }
+    return (status.diagnostics[0]?.message ??
+        `A ${status.operationKind} Foundation transaction blocks document authoring.`);
+}
+function toDocumentStatus(status) {
+    if (status.state === "idle") {
+        return { state: "idle" };
+    }
+    return isExactDocumentRecovery(status)
+        ? { state: "recoverable" }
+        : { state: "manual-recovery-required", reason: manualReason(status) };
+}
+function combinedReleaseFailure(inspectionError, releaseError) {
+    return new Error("Document transaction inspection and barrier retention both failed.", {
+        cause: new AggregateError([inspectionError, releaseError], "Transaction evidence inspection and operation-lock release failed.")
+    });
+}
+async function releaseSafely(options) {
+    let status;
+    try {
+        status = await options.coordinator.inspect();
+    }
+    catch (inspectionError) {
+        try {
+            await options.lease.release({ retainTransactionBarrier: true });
+        }
+        catch (releaseError) {
+            throw combinedReleaseFailure(inspectionError, releaseError);
+        }
+        throw inspectionError;
+    }
+    await options.lease.release({
+        retainTransactionBarrier: options.retainRequested || status.state !== "idle"
+    });
+}
+export class NodeDocumentTransactionCoordinator {
+    #coordinator;
+    constructor(coordinator) {
+        this.#coordinator = coordinator;
+    }
+    async inspect() {
+        return toDocumentStatus(await this.#coordinator.inspect());
+    }
+    async acquire(request) {
+        const lease = await this.#coordinator.acquire({
+            requestedMutation: "document-authoring",
+            ...(request.mode === "recover"
+                ? { allowRecoveryOf: "document-authoring" }
+                : {})
+        });
+        let held = true;
+        return {
+            status: toDocumentStatus(lease.status),
+            release: async (releaseOptions) => {
+                if (!held) {
+                    return;
+                }
+                await releaseSafely({
+                    coordinator: this.#coordinator,
+                    lease,
+                    retainRequested: releaseOptions?.retainTransactionBarrier === true
+                });
+                held = false;
+            }
+        };
+    }
+}
+export async function createNodeDocumentTransactionCoordinator(consumerRoot) {
+    const coordinator = await createNodeFoundationTransactionCoordinator(consumerRoot);
+    return new NodeDocumentTransactionCoordinator(coordinator);
+}
+//# sourceMappingURL=node-document-transaction-coordinator.js.map

package/dist/document-authoring/adapters/node/node-document-transaction-coordinator.js.map

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

package/dist/document-authoring/adapters/node/recapture-document-publication-paths.d.ts

@@ -0,0 +1,16 @@
+import type { PortablePathIdentity } from "../../../repository-mutation/application/model/path-identity.js";
+export interface RecapturedDocumentPublicationPaths {
+    readonly ancestryIdentities: readonly PortablePathIdentity[];
+    readonly destinationPath: string;
+    readonly parent: string;
+    readonly parentIdentity: PortablePathIdentity;
+    readonly root: string;
+}
+/** Recaptures strict real-directory ancestry; the result is valid only for the immediate operation. */
+export declare function recaptureDocumentPublicationPaths(request: {
+    readonly consumerRoot: string;
+    readonly destination: string;
+}): Promise<RecapturedDocumentPublicationPaths>;
+export declare function sameDocumentPhysicalIdentity(left: PortablePathIdentity, right: PortablePathIdentity): boolean;
+export declare function sameDocumentAncestry(left: readonly PortablePathIdentity[], right: readonly PortablePathIdentity[]): boolean;
+//# sourceMappingURL=recapture-document-publication-paths.d.ts.map

package/dist/document-authoring/adapters/node/recapture-document-publication-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recapture-document-publication-paths.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/recapture-document-publication-paths.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAC;AAI5G,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAgDD,uGAAuG;AACvG,wBAAsB,iCAAiC,CAAC,OAAO,EAAE;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAAC,kCAAkC,CAAC,CA0C9C;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAIT;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,oBAAoB,EAAE,EACrC,KAAK,EAAE,SAAS,oBAAoB,EAAE,GACrC,OAAO,CAIT"}