@agent-teams/document-authoring 0.0.0

package/dist/application/policies/document-temporary-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-temporary-path.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-temporary-path.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAyBR"}

package/dist/application/policies/document-temporary-path.js

@@ -0,0 +1,34 @@
+import { isDocumentRepositoryPath } from "./document-repository-path.js";
+const CANONICAL_SHA256_DIGEST = /^sha256:[0-9a-f]{64}$/u;
+const TEMPORARY_PREFIX = ".foundation-document-";
+const TEMPORARY_SUFFIX = ".tmp";
+class DocumentTemporaryPathError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DocumentTemporaryPathError";
+    }
+}
+/**
+ * Derives the only transaction-owned temporary path for a Document Plan.
+ * The name is bounded independently of the destination basename and remains
+ * in the destination's already-authorized parent directory.
+ */
+export function documentTemporaryPath(destination, planDigest) {
+    if (!isDocumentRepositoryPath(destination)) {
+        throw new DocumentTemporaryPathError("Document destination is not a portable repository path.");
+    }
+    if (!CANONICAL_SHA256_DIGEST.test(planDigest)) {
+        throw new DocumentTemporaryPathError("Document Plan digest is not canonical SHA-256.");
+    }
+    const separator = destination.lastIndexOf("/");
+    const parent = separator === -1 ? "" : destination.slice(0, separator);
+    const temporaryName = `${TEMPORARY_PREFIX}${planDigest.slice("sha256:".length)}${TEMPORARY_SUFFIX}`;
+    const temporaryPath = parent.length === 0
+        ? temporaryName
+        : `${parent}/${temporaryName}`;
+    if (!isDocumentRepositoryPath(temporaryPath)) {
+        throw new DocumentTemporaryPathError("Document destination parent cannot contain the bounded transaction temporary.");
+    }
+    return temporaryPath;
+}
+//# sourceMappingURL=document-temporary-path.js.map

package/dist/application/policies/document-temporary-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-temporary-path.js","sourceRoot":"","sources":["../../../src/application/policies/document-temporary-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AACzD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,MAAM,0BAA2B,SAAQ,KAAK;IAC5C,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,UAAkB;IAElB,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,0BAA0B,CAClC,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,0BAA0B,CAClC,gDAAgD,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,GAAG,gBAAgB,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC;IACpG,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;QACvC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;IAEjC,IAAI,CAAC,wBAAwB,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,0BAA0B,CAClC,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/application/policies/document-transaction-digests.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentAuthorityDigest } from "../model/document-catalog.js";
+import type { DocumentTransactionEnvelope, DocumentTransactionJournal, DocumentTransactionJournalV3 } from "../model/document-transaction.js";
+export declare function documentTransactionPayloadDigest(journal: DocumentTransactionJournal | DocumentTransactionJournalV3): DocumentAuthorityDigest;
+export declare function documentTransactionEnvelopeDigest(envelope: DocumentTransactionEnvelope | Omit<DocumentTransactionEnvelope, "envelopeDigest">): DocumentAuthorityDigest;
+//# sourceMappingURL=document-transaction-digests.d.ts.map

package/dist/application/policies/document-transaction-digests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-digests.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-transaction-digests.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,kCAAkC,CAAC;AAM1C,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,0BAA0B,GAAG,4BAA4B,GACjE,uBAAuB,CAEzB;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EACJ,2BAA2B,GAC3B,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,CAAC,GACtD,uBAAuB,CAMzB"}

package/dist/application/policies/document-transaction-digests.js

@@ -0,0 +1,12 @@
+import { canonicalJson, sha256Json } from "../../canonical-json.js";
+function canonicalSnapshot(value) {
+    return JSON.parse(canonicalJson(value));
+}
+export function documentTransactionPayloadDigest(journal) {
+    return sha256Json(canonicalSnapshot(journal));
+}
+export function documentTransactionEnvelopeDigest(envelope) {
+    const { envelopeDigest: _ignored, ...body } = envelope;
+    return sha256Json(canonicalSnapshot(body));
+}
+//# sourceMappingURL=document-transaction-digests.js.map

package/dist/application/policies/document-transaction-digests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-digests.js","sourceRoot":"","sources":["../../../src/application/policies/document-transaction-digests.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,UAAU,EACX,MAAM,yBAAyB,CAAC;AAQjC,SAAS,iBAAiB,CAAI,KAAQ;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAsC,CAAC,CAAM,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAAkE;IAElE,OAAO,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAkC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,QAEuD;IAEvD,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GACzC,QAAuC,CAAC;IAC1C,OAAO,UAAU,CACf,iBAAiB,CAAC,IAAI,CAAkC,CACzD,CAAC;AACJ,CAAC"}

package/dist/application/policies/document-transaction-envelope-body.d.ts

@@ -0,0 +1,28 @@
+import type { DocumentParentMaterializationJournalV2 } from "../model/document-parent-materialization.js";
+import type { DocumentPhysicalIdentity } from "../model/document-physical-identity.js";
+import type { DocumentPlanV1, DocumentPlanV2 } from "../model/document-planning.js";
+import type { DocumentOwnedTemporary, DocumentTransactionEnvelopeBody } from "../model/document-transaction.js";
+export declare function envelopeBodyV3(plan: DocumentPlanV1, lifecycle: {
+    readonly state: "PREPARED";
+    readonly destination: "pending" | "preexisting";
+} | {
+    readonly state: "PUBLISHING";
+    readonly temporary: DocumentOwnedTemporary;
+} | {
+    readonly state: "PUBLISHED";
+    readonly publicationIdentity: DocumentPhysicalIdentity;
+}): DocumentTransactionEnvelopeBody;
+export declare function envelopeBodyV4(plan: DocumentPlanV2, materialization: DocumentParentMaterializationJournalV2, lifecycle: {
+    readonly state: "PREPARED";
+    readonly destination: "pending" | "preexisting";
+} | {
+    readonly state: "MATERIALIZING";
+    readonly pendingDirectory?: string;
+} | {
+    readonly state: "PUBLISHING";
+    readonly temporary: DocumentOwnedTemporary;
+} | {
+    readonly state: "PUBLISHED";
+    readonly publicationIdentity: DocumentPhysicalIdentity;
+}): DocumentTransactionEnvelopeBody;
+//# sourceMappingURL=document-transaction-envelope-body.d.ts.map

package/dist/application/policies/document-transaction-envelope-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-envelope-body.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-transaction-envelope-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,6CAA6C,CAAC;AAC1G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,KAAK,EACV,sBAAsB,EACtB,+BAA+B,EAChC,MAAM,kCAAkC,CAAC;AAE1C,wBAAgB,cAAc,CAC5B,IAAI,EAAE,cAAc,EACpB,SAAS,EACL;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,aAAa,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,CAAA;CAAE,GAC1F,+BAA+B,CAyDjC;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,cAAc,EACpB,eAAe,EAAE,sCAAsC,EACvD,SAAS,EACL;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,aAAa,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,wBAAwB,CAAA;CAAE,GAC1F,+BAA+B,CAgFjC"}

package/dist/application/policies/document-transaction-envelope-body.js

@@ -0,0 +1,140 @@
+export function envelopeBodyV3(plan, lifecycle) {
+    const base = {
+        adapterContractVersion: 1,
+        foundation: Object.freeze({
+            buildIdentity: plan.compiler.buildIdentity,
+            version: plan.compiler.version
+        }),
+        operationKind: "document-authoring",
+        payloadKind: "document-authoring-journal/v2",
+        recoveryHandler: Object.freeze({
+            contractVersion: 2,
+            id: "document-authoring"
+        }),
+        schemaVersion: 3
+    };
+    if (lifecycle.state === "PREPARED") {
+        const prepared = { ...base, state: lifecycle.state };
+        return lifecycle.destination === "pending"
+            ? {
+                ...prepared,
+                journal: {
+                    destination: { path: plan.destination, state: "pending" },
+                    plan,
+                    schemaVersion: 2
+                }
+            }
+            : {
+                ...prepared,
+                journal: {
+                    destination: { path: plan.destination, state: "preexisting" },
+                    plan,
+                    schemaVersion: 2
+                }
+            };
+    }
+    if (lifecycle.state === "PUBLISHING") {
+        return {
+            ...base,
+            journal: {
+                destination: { path: plan.destination, state: "publishing" },
+                ownedTemporary: lifecycle.temporary,
+                plan,
+                schemaVersion: 2
+            },
+            state: lifecycle.state
+        };
+    }
+    return {
+        ...base,
+        journal: {
+            destination: { path: plan.destination, state: "published" },
+            plan,
+            publicationIdentity: lifecycle.publicationIdentity,
+            schemaVersion: 2
+        },
+        state: lifecycle.state
+    };
+}
+export function envelopeBodyV4(plan, materialization, lifecycle) {
+    const parentMaterialization = Object.freeze({
+        anchorIdentity: materialization.anchorIdentity,
+        createdDirectories: materialization.createdDirectories,
+        ...(lifecycle.state === "MATERIALIZING" && lifecycle.pendingDirectory !== undefined
+            ? { pendingDirectory: lifecycle.pendingDirectory }
+            : {})
+    });
+    const base = {
+        adapterContractVersion: 1,
+        foundation: Object.freeze({
+            buildIdentity: plan.compiler.buildIdentity,
+            version: plan.compiler.version
+        }),
+        operationKind: "document-authoring",
+        payloadKind: "document-authoring-journal/v3",
+        recoveryHandler: Object.freeze({
+            contractVersion: 3,
+            id: "document-authoring"
+        }),
+        schemaVersion: 4
+    };
+    if (lifecycle.state === "PREPARED") {
+        const prepared = { ...base, state: lifecycle.state };
+        return lifecycle.destination === "pending"
+            ? {
+                ...prepared,
+                journal: {
+                    destination: { path: plan.destination, state: "pending" },
+                    parentMaterialization,
+                    plan,
+                    schemaVersion: 3
+                }
+            }
+            : {
+                ...prepared,
+                journal: {
+                    destination: { path: plan.destination, state: "preexisting" },
+                    parentMaterialization,
+                    plan,
+                    schemaVersion: 3
+                }
+            };
+    }
+    if (lifecycle.state === "MATERIALIZING") {
+        return {
+            ...base,
+            journal: {
+                destination: { path: plan.destination, state: "materializing" },
+                parentMaterialization,
+                plan,
+                schemaVersion: 3
+            },
+            state: lifecycle.state
+        };
+    }
+    if (lifecycle.state === "PUBLISHING") {
+        return {
+            ...base,
+            journal: {
+                destination: { path: plan.destination, state: "publishing" },
+                ownedTemporary: lifecycle.temporary,
+                parentMaterialization,
+                plan,
+                schemaVersion: 3
+            },
+            state: lifecycle.state
+        };
+    }
+    return {
+        ...base,
+        journal: {
+            destination: { path: plan.destination, state: "published" },
+            parentMaterialization,
+            plan,
+            publicationIdentity: lifecycle.publicationIdentity,
+            schemaVersion: 3
+        },
+        state: lifecycle.state
+    };
+}
+//# sourceMappingURL=document-transaction-envelope-body.js.map

package/dist/application/policies/document-transaction-envelope-body.js.map

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

package/dist/application/policies/document-transaction-envelope-policy.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentTransactionEnvelope, DocumentTransactionEnvelopeBody } from "../model/document-transaction.js";
+export declare function assertDocumentTransactionEnvelope(value: unknown): Promise<DocumentTransactionEnvelope>;
+export declare function createDocumentTransactionEnvelope(body: DocumentTransactionEnvelopeBody): Promise<DocumentTransactionEnvelope>;
+//# sourceMappingURL=document-transaction-envelope-policy.d.ts.map

package/dist/application/policies/document-transaction-envelope-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-envelope-policy.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-transaction-envelope-policy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,2BAA2B,EAC3B,+BAA+B,EAGhC,MAAM,kCAAkC,CAAC;AA0J1C,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,2BAA2B,CAAC,CA0DtC;AAED,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAWtC"}

package/dist/application/policies/document-transaction-envelope-policy.js

@@ -0,0 +1,159 @@
+import { canonicalJson } from "../../canonical-json.js";
+import { assertSchema } from "../../schema-catalog.js";
+import { assertNonzeroDocumentPhysicalIdentity } from "../model/document-physical-identity.js";
+import { assertDocumentPlanDigests } from "./document-contract-digests.js";
+import { documentTemporaryPath } from "./document-temporary-path.js";
+import { documentTransactionEnvelopeDigest, documentTransactionPayloadDigest } from "./document-transaction-digests.js";
+class DocumentTransactionEnvelopeError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "DocumentTransactionEnvelopeError";
+    }
+}
+function canonicalSnapshot(value) {
+    try {
+        return JSON.parse(canonicalJson(value));
+    }
+    catch (error) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope must use canonical JSON values.", { cause: error });
+    }
+}
+function deepFreezeCanonical(value) {
+    const pending = [];
+    if (value !== null && typeof value === "object") {
+        pending.push(value);
+    }
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (current === undefined || Object.isFrozen(current)) {
+            continue;
+        }
+        for (const key of Reflect.ownKeys(current)) {
+            const descriptor = Object.getOwnPropertyDescriptor(current, key);
+            const child = descriptor !== undefined && "value" in descriptor
+                ? descriptor.value
+                : undefined;
+            if (typeof child === "object" && child !== null) {
+                pending.push(child);
+            }
+        }
+        Object.freeze(current);
+    }
+    return value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasOwnedTemporary(journal) {
+    return "ownedTemporary" in journal;
+}
+function assertV4MaterializationBindings(envelope) {
+    const materialization = envelope.journal.parentMaterialization;
+    assertNonzeroDocumentPhysicalIdentity(materialization.anchorIdentity);
+    const planned = envelope.journal.plan.parentMaterialization.missingDirectories;
+    if (materialization.createdDirectories.length > planned.length ||
+        materialization.createdDirectories.some((entry, index) => {
+            assertNonzeroDocumentPhysicalIdentity(entry.identity);
+            return entry.path !== planned[index];
+        })) {
+        throw new DocumentTransactionEnvelopeError("Document transaction directory evidence is not an exact Plan prefix.");
+    }
+    const pending = materialization.pendingDirectory;
+    if (envelope.state === "PREPARED" && materialization.createdDirectories.length !== 0) {
+        throw new DocumentTransactionEnvelopeError("PREPARED must not contain created directory evidence.");
+    }
+    if (envelope.state === "MATERIALIZING" && planned.length === 0) {
+        throw new DocumentTransactionEnvelopeError("MATERIALIZING requires at least one planned directory.");
+    }
+    if (pending !== undefined &&
+        pending !== planned[materialization.createdDirectories.length]) {
+        throw new DocumentTransactionEnvelopeError("Document transaction pending directory does not bind the next Plan path.");
+    }
+    if (envelope.state !== "MATERIALIZING" && pending !== undefined) {
+        throw new DocumentTransactionEnvelopeError("Only MATERIALIZING may retain a pending directory.");
+    }
+    if ((envelope.state === "PUBLISHING" || envelope.state === "PUBLISHED") &&
+        materialization.createdDirectories.length !== planned.length) {
+        throw new DocumentTransactionEnvelopeError("Document publication requires complete directory materialization evidence.");
+    }
+}
+function assertLifecycleBindings(envelope) {
+    const { journal } = envelope;
+    const { destination } = journal;
+    if (destination.path !== journal.plan.destination ||
+        envelope.foundation.version !== journal.plan.compiler.version ||
+        envelope.foundation.buildIdentity !== journal.plan.compiler.buildIdentity) {
+        throw new DocumentTransactionEnvelopeError("Document transaction lifecycle does not bind the embedded Plan.");
+    }
+    if (hasOwnedTemporary(journal) &&
+        journal.ownedTemporary.digest !== journal.plan.output.digest) {
+        throw new DocumentTransactionEnvelopeError("Document transaction temporary does not bind the planned output.");
+    }
+    if (hasOwnedTemporary(journal)) {
+        assertNonzeroDocumentPhysicalIdentity(journal.ownedTemporary.identity);
+        if (journal.ownedTemporary.path !==
+            documentTemporaryPath(journal.plan.destination, journal.plan.planDigest)) {
+            throw new DocumentTransactionEnvelopeError("Document transaction temporary path does not bind the embedded Plan.");
+        }
+    }
+    if (envelope.state === "PUBLISHED") {
+        assertNonzeroDocumentPhysicalIdentity(envelope.journal.publicationIdentity);
+    }
+    if (envelope.schemaVersion === 4) {
+        assertV4MaterializationBindings(envelope);
+    }
+}
+export async function assertDocumentTransactionEnvelope(value) {
+    const candidate = deepFreezeCanonical(canonicalSnapshot(value));
+    if (!isRecord(candidate)) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope must be an object.");
+    }
+    const handler = candidate["recoveryHandler"];
+    if (![3, 4].includes(Number(candidate["schemaVersion"])) ||
+        candidate["operationKind"] !== "document-authoring" ||
+        !isRecord(handler) ||
+        !["document-authoring", "foundation.document-authoring"].includes(String(handler["id"])) ||
+        handler["contractVersion"] !==
+            (candidate["schemaVersion"] === 4 ? 3 : 2) ||
+        candidate["adapterContractVersion"] !== 1 ||
+        candidate["payloadKind"] !==
+            (candidate["schemaVersion"] === 4
+                ? "document-authoring-journal/v3"
+                : "document-authoring-journal/v2") ||
+        !(candidate["schemaVersion"] === 4
+            ? ["PREPARED", "MATERIALIZING", "PUBLISHING", "PUBLISHED"]
+            : ["PREPARED", "PUBLISHING", "PUBLISHED"]).includes(String(candidate["state"]))) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope constants are invalid.");
+    }
+    try {
+        await assertSchema(candidate["schemaVersion"] === 4
+            ? "foundation-transaction-envelope/v4"
+            : "foundation-transaction-envelope/v3", candidate, "document-transaction-envelope");
+    }
+    catch (error) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope does not match its closed versioned schema.", { cause: error });
+    }
+    const envelope = candidate;
+    assertDocumentPlanDigests(envelope.journal.plan);
+    assertLifecycleBindings(envelope);
+    if (envelope.payloadDigest !==
+        documentTransactionPayloadDigest(envelope.journal) ||
+        envelope.envelopeDigest !==
+            documentTransactionEnvelopeDigest(envelope)) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope digest is invalid.");
+    }
+    return envelope;
+}
+export async function createDocumentTransactionEnvelope(body) {
+    const snapshot = deepFreezeCanonical(canonicalSnapshot(body));
+    const withPayload = {
+        ...snapshot,
+        payloadDigest: documentTransactionPayloadDigest(snapshot.journal)
+    };
+    const envelope = deepFreezeCanonical({
+        ...withPayload,
+        envelopeDigest: documentTransactionEnvelopeDigest(withPayload)
+    });
+    return assertDocumentTransactionEnvelope(envelope);
+}
+//# sourceMappingURL=document-transaction-envelope-policy.js.map

package/dist/application/policies/document-transaction-envelope-policy.js.map

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

package/dist/application/policies/inspect-catalog-document.d.ts

@@ -0,0 +1,18 @@
+import { type MarkdownDocumentObservation } from "../../documentation-observation/application/model/markdown-document.js";
+import type { DocumentDescriptor, DocumentDescriptorV2, DocumentIdentityProjectionEntry, DocumentMetadataObject, DocumentationCatalogDiagnostic, DocumentSearchCorpusEntry, DocumentSearchCorpusEntryV2 } from "../model/document-catalog.js";
+import type { MetadataSchemaSnapshot } from "../ports/metadata-instance-validator.js";
+export interface InspectedCatalogDocument {
+    readonly descriptor?: DocumentDescriptor;
+    readonly diagnostic?: DocumentationCatalogDiagnostic;
+    readonly identity?: DocumentIdentityProjectionEntry;
+    readonly searchEntry?: DocumentSearchCorpusEntry;
+}
+export interface InspectedCatalogDocumentV2 {
+    readonly descriptor?: DocumentDescriptorV2;
+    readonly diagnostic?: DocumentationCatalogDiagnostic;
+    readonly identity?: DocumentIdentityProjectionEntry;
+    readonly searchEntry?: DocumentSearchCorpusEntryV2;
+}
+export declare function inspectCatalogDocument(document: MarkdownDocumentObservation, metadata: MetadataSchemaSnapshot, ownerIds: ReadonlySet<string>, source: DocumentDescriptor["source"]): InspectedCatalogDocument;
+export declare function inspectCatalogDocumentV2(document: MarkdownDocumentObservation, metadata: MetadataSchemaSnapshot, ownerIds: ReadonlySet<string>, source: DocumentDescriptor["source"], metadataOverride?: DocumentMetadataObject): InspectedCatalogDocumentV2;
+//# sourceMappingURL=inspect-catalog-document.d.ts.map

package/dist/application/policies/inspect-catalog-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-catalog-document.d.ts","sourceRoot":"","sources":["../../../src/application/policies/inspect-catalog-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,wEAAwE,CAAC;AAChF,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,+BAA+B,EAC/B,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAYtF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,8BAA8B,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,yBAAyB,CAAC;CAClD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,8BAA8B,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC;CACpD;AAMD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GACnC,wBAAwB,CAyG1B;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACpC,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,0BAA0B,CAwD5B"}

package/dist/application/policies/inspect-catalog-document.js

@@ -0,0 +1,126 @@
+import { markdownSourceWithoutFrontmatter } from "../../documentation-observation/application/model/markdown-document.js";
+import { catalogDiagnostic } from "./document-catalog-diagnostics.js";
+import { documentTitle, inspectDocumentFields, invalidDocumentPathInspection } from "./document-catalog-fields.js";
+import { CatalogMetadataProjectionError, projectCatalogMetadata } from "./project-catalog-metadata.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function inspectCatalogDocument(document, metadata, ownerIds, source) {
+    if (document.source.startsWith("\uFEFF") || document.source.includes("\u0000")) {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.source-invalid", document.repositoryPath, "Catalog Markdown must not contain a UTF-8 BOM or NUL characters.")
+        };
+    }
+    const pathInspection = invalidDocumentPathInspection(document);
+    if (pathInspection !== undefined) {
+        return pathInspection;
+    }
+    if (document.frontmatter.kind === "absent") {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.frontmatter-required", document.repositoryPath, "Catalog documents must contain strict YAML frontmatter.")
+        };
+    }
+    if (document.frontmatter.kind === "invalid") {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.frontmatter-invalid", document.repositoryPath, document.frontmatter.message)
+        };
+    }
+    if (!isRecord(document.frontmatter.value)) {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.frontmatter-invalid", document.repositoryPath, "Document frontmatter must be an object.")
+        };
+    }
+    const fieldInspection = inspectDocumentFields(document, document.frontmatter.value);
+    if (fieldInspection.fields === undefined) {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.descriptor-invalid", document.repositoryPath, "Document metadata must provide bounded id, type, status, owner, and summary strings."),
+            ...(fieldInspection.identity === undefined
+                ? {}
+                : { identity: fieldInspection.identity })
+        };
+    }
+    const { fields, identity } = fieldInspection;
+    const validation = metadata.validate(document.frontmatter.value);
+    if (!validation.valid) {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.metadata-invalid", document.repositoryPath, validation.messages.join("; ") || "Document metadata is invalid."),
+            identity
+        };
+    }
+    if (!ownerIds.has(fields.owner)) {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.owner-unknown", document.repositoryPath, `Document owner is absent from the owner catalog: ${fields.owner}.`),
+            identity
+        };
+    }
+    const title = documentTitle(document);
+    if (title === undefined) {
+        return {
+            diagnostic: catalogDiagnostic("document.catalog.title-invalid", document.repositoryPath, "Catalog documents must contain a bounded level-one heading."),
+            identity
+        };
+    }
+    const descriptor = Object.freeze({
+        ...fields,
+        repositoryPath: document.repositoryPath,
+        source,
+        title
+    });
+    return {
+        descriptor,
+        identity,
+        searchEntry: Object.freeze({
+            body: markdownSourceWithoutFrontmatter(document),
+            descriptor,
+            headings: Object.freeze(document.headings.map((heading) => heading.text))
+        })
+    };
+}
+export function inspectCatalogDocumentV2(document, metadata, ownerIds, source, metadataOverride) {
+    const inspectedDocument = metadataOverride === undefined
+        ? document
+        : Object.freeze({
+            ...document,
+            frontmatter: Object.freeze({
+                endOffset: document.frontmatter.endOffset,
+                kind: "valid",
+                value: metadataOverride
+            })
+        });
+    const inspected = inspectCatalogDocument(inspectedDocument, metadata, ownerIds, source);
+    if (inspected.descriptor === undefined || inspected.searchEntry === undefined) {
+        return Object.freeze({
+            ...(inspected.diagnostic === undefined
+                ? {}
+                : { diagnostic: inspected.diagnostic }),
+            ...(inspected.identity === undefined ? {} : { identity: inspected.identity })
+        });
+    }
+    try {
+        const projectedMetadata = projectCatalogMetadata(inspectedDocument.frontmatter.kind === "valid"
+            ? inspectedDocument.frontmatter.value
+            : undefined);
+        const descriptor = Object.freeze({
+            ...inspected.descriptor,
+            metadata: projectedMetadata
+        });
+        return Object.freeze({
+            descriptor,
+            ...(inspected.identity === undefined ? {} : { identity: inspected.identity }),
+            searchEntry: Object.freeze({
+                ...inspected.searchEntry,
+                descriptor
+            })
+        });
+    }
+    catch (error) {
+        if (!(error instanceof CatalogMetadataProjectionError)) {
+            throw error;
+        }
+        return Object.freeze({
+            diagnostic: catalogDiagnostic("document.catalog.metadata-projection-invalid", document.repositoryPath, error.message),
+            ...(inspected.identity === undefined ? {} : { identity: inspected.identity })
+        });
+    }
+}
+//# sourceMappingURL=inspect-catalog-document.js.map

package/dist/application/policies/inspect-catalog-document.js.map

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

package/dist/application/policies/normalize-document-intent.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentIntent } from "../model/document-planning.js";
+export declare function normalizeDocumentIntent(input: DocumentIntent): DocumentIntent;
+//# sourceMappingURL=normalize-document-intent.d.ts.map

package/dist/application/policies/normalize-document-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-document-intent.d.ts","sourceRoot":"","sources":["../../../src/application/policies/normalize-document-intent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,+BAA+B,CAAC;AA4FvC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAyB7E"}