@agent-teams/document-authoring 0.0.0

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

@@ -0,0 +1,329 @@
+import { compareBinaryStrings } from "../../binary-string-comparator.js";
+import { canonicalJson, sha256Bytes, sha256Json } from "../../canonical-json.js";
+import { documentTemporaryPath } from "./document-temporary-path.js";
+import { documentRepositoryParentPath } from "./document-repository-path.js";
+const DOMAIN_PREFIX = "agent-teams.foundation.document-authoring";
+class DocumentContractDigestError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "DocumentContractDigestError";
+    }
+}
+function domainDigest(domain, payload) {
+    return sha256Json({ domain, payload });
+}
+function withoutOwnDigest(value, field) {
+    const snapshot = JSON.parse(canonicalJson(value));
+    const result = Object.create(null);
+    for (const key of Reflect.ownKeys(snapshot)) {
+        if (key === field) {
+            continue;
+        }
+        if (typeof key !== "string") {
+            throw new DocumentContractDigestError("Document digest input must not contain symbolic properties.");
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(snapshot, key);
+        if (descriptor === undefined || !("value" in descriptor)) {
+            throw new DocumentContractDigestError("Document digest input must contain only own data properties.");
+        }
+        result[key] = descriptor.value;
+    }
+    return result;
+}
+export function documentIntentDigest(intent) {
+    return domainDigest(`${DOMAIN_PREFIX}/intent/v1`, intent);
+}
+export function documentOwnerMembershipDigest(ownerCatalogDigest, ownerId) {
+    return domainDigest(`${DOMAIN_PREFIX}/owner-membership/v1`, {
+        ownerCatalogDigest,
+        ownerId
+    });
+}
+export function documentIdentityProjectionDigest(entries) {
+    const snapshot = JSON.parse(canonicalJson(entries));
+    const normalized = snapshot
+        .map(({ id, repositoryPath }) => ({ id, repositoryPath }))
+        .toSorted((left, right) => compareBinaryStrings(left.id, right.id) ||
+        compareBinaryStrings(left.repositoryPath, right.repositoryPath));
+    return domainDigest(`${DOMAIN_PREFIX}/identity-projection/v1`, {
+        entries: normalized
+    });
+}
+export function documentReferencedDocumentDigest(document) {
+    const snapshot = JSON.parse(canonicalJson(document));
+    return domainDigest(`${DOMAIN_PREFIX}/referenced-document/v1`, {
+        id: snapshot.id,
+        path: snapshot.path
+    });
+}
+export function documentPlanDigest(plan) {
+    const version = plan["schemaVersion"] === 2 && plan["protocolVersion"] === 2
+        ? 2
+        : 1;
+    return domainDigest(`${DOMAIN_PREFIX}/plan/v${version}`, withoutOwnDigest(plan, "planDigest"));
+}
+export function documentReceiptDigest(receipt) {
+    const version = receipt["schemaVersion"] === 2 &&
+        receipt["protocolVersion"] === 2 ? 2 : 1;
+    return domainDigest(`${DOMAIN_PREFIX}/receipt/v${version}`, withoutOwnDigest(receipt, "receiptDigest"));
+}
+function record(value, subject) {
+    if (value === null || Array.isArray(value) || typeof value !== "object") {
+        throw new DocumentContractDigestError(`${subject} must be a JSON object.`);
+    }
+    return value;
+}
+function validatedRecord(value, subject) {
+    const candidate = record(value, subject);
+    try {
+        return JSON.parse(canonicalJson(candidate));
+    }
+    catch (error) {
+        throw new DocumentContractDigestError(`${subject} must use the closed canonical JSON data model.`, { cause: error });
+    }
+}
+function assertV2ParentMaterialization(plan, expectedParentPath) {
+    const materialization = record(plan["parentMaterialization"], "Document Plan parent materialization");
+    const missing = materialization["missingDirectories"];
+    if (materialization["policy"] !== "create-missing-real-directories" ||
+        materialization["finalParent"] !== expectedParentPath ||
+        !Array.isArray(missing)) {
+        throw new DocumentContractDigestError("Document Plan parent materialization binding is invalid.");
+    }
+    const anchor = materialization["deepestExistingDirectory"];
+    const finalParent = materialization["finalParent"];
+    if (typeof anchor !== "string" ||
+        typeof finalParent !== "string" ||
+        !missing.every((entry) => typeof entry === "string")) {
+        throw new DocumentContractDigestError("Document Plan parent materialization paths are invalid.");
+    }
+    const finalSegments = finalParent
+        .split("/").filter((segment) => segment !== ".");
+    const anchorSegments = anchor.split("/").filter((segment) => segment !== ".");
+    const expectedMissing = finalSegments.slice(anchorSegments.length).map((_segment, index) => finalSegments.slice(0, anchorSegments.length + index + 1).join("/"));
+    if (anchorSegments.some((segment, index) => segment !== finalSegments[index]) ||
+        expectedMissing.length !== missing.length ||
+        expectedMissing.some((entry, index) => entry !== missing[index])) {
+        throw new DocumentContractDigestError("Document Plan missing directory chain is invalid.");
+    }
+}
+function assertPublicationBindings(plan) {
+    const destination = plan["destination"];
+    const expectedParent = record(plan["expectedParent"], "Document Plan expected parent");
+    const precondition = record(plan["destinationPrecondition"], "Document Plan destination precondition");
+    const capabilities = plan["requiredAdapterCapabilities"];
+    const v2 = plan["schemaVersion"] === 2 && plan["protocolVersion"] === 2;
+    let hasTemporaryCapacity = false;
+    if (typeof destination === "string" && typeof plan["planDigest"] === "string") {
+        try {
+            documentTemporaryPath(destination, plan["planDigest"]);
+            hasTemporaryCapacity = true;
+        }
+        catch {
+            // The single publication error below is the stable public failure surface.
+        }
+    }
+    if (typeof destination !== "string" ||
+        !hasTemporaryCapacity ||
+        expectedParent["path"] !== documentRepositoryParentPath(destination) ||
+        expectedParent["state"] !== "directory" ||
+        expectedParent["ancestry"] !== "real-directories" ||
+        precondition["state"] !== "absent" ||
+        !Array.isArray(capabilities) ||
+        !capabilities.some((capability) => capability === "create-file-no-replace/v1") ||
+        (v2 && !capabilities.some((capability) => capability === "create-directories-no-replace/v1")) ||
+        (!v2 && (plan["schemaVersion"] !== 1 || plan["protocolVersion"] !== 1))) {
+        throw new DocumentContractDigestError("Document Plan publication bindings are invalid.");
+    }
+    if (v2) {
+        assertV2ParentMaterialization(plan, expectedParent["path"]);
+    }
+    else if (plan["parentMaterialization"] !== undefined) {
+        throw new DocumentContractDigestError("Document Plan v1 must not contain parent materialization.");
+    }
+}
+function assertIntentDigest(plan) {
+    const intent = record(plan["intent"], "Document Plan Intent");
+    if (plan["intentDigest"] !== documentIntentDigest(intent)) {
+        throw new DocumentContractDigestError("Document Plan Intent digest is invalid.");
+    }
+}
+function assertOwnerMembershipDigest(plan) {
+    const intent = record(plan["intent"], "Document Plan Intent");
+    const authority = record(plan["authority"], "Document Plan authority");
+    const ownerCatalog = record(authority["ownerCatalog"], "Document Plan owner catalog authority");
+    const selectedOwner = record(plan["selectedOwner"], "Document Plan selected owner");
+    if (typeof ownerCatalog["digest"] !== "string" ||
+        typeof intent["owner"] !== "string" ||
+        typeof selectedOwner["id"] !== "string" ||
+        selectedOwner["id"] !== intent["owner"] ||
+        selectedOwner["membershipDigest"] !==
+            documentOwnerMembershipDigest(ownerCatalog["digest"], selectedOwner["id"])) {
+        throw new DocumentContractDigestError("Document Plan owner membership digest is invalid.");
+    }
+}
+function hasExactCommit(commit, expected) {
+    return Object.entries(expected).every(([field, value]) => commit[field] === value);
+}
+function isRecoveryCommit(outcome, commit) {
+    const publication = commit["publication"];
+    const atomicity = commit["atomicity"] ?? commit["fileAtomicity"];
+    return (commit["state"] === outcome &&
+        ["none", "published", "unknown"].includes(publication) &&
+        ["not-applicable", "single-file-atomic-create"].includes(atomicity) &&
+        (publication !== "published" || atomicity === "single-file-atomic-create") &&
+        (publication !== "none" || atomicity === "not-applicable") &&
+        commit["recoverability"] === "preserved-for-recovery");
+}
+function assertReceiptOutcomeCommit(receipt) {
+    const outcome = receipt["outcome"];
+    const commit = record(receipt["commit"], "Document Receipt commit observation");
+    const atomicityField = receipt["schemaVersion"] === 2
+        ? "fileAtomicity"
+        : "atomicity";
+    const noResultOutcomes = [
+        "authority-stale",
+        "rejected",
+        "failed-before-publication",
+        "cancelled"
+    ];
+    const recoveryOutcomes = ["recovery-required", "manual-recovery-required"];
+    const applied = outcome === "applied" &&
+        typeof receipt["resultDigest"] === "string" &&
+        hasExactCommit(commit, {
+            state: "committed",
+            publication: "published",
+            [atomicityField]: "single-file-atomic-create",
+            recoverability: "not-required"
+        });
+    const alreadyApplied = outcome === "already-applied" &&
+        typeof receipt["resultDigest"] === "string" &&
+        hasExactCommit(commit, {
+            state: "committed",
+            publication: "preexisting-exact",
+            [atomicityField]: "not-applicable",
+            recoverability: "not-required"
+        });
+    const noResult = typeof outcome === "string" &&
+        noResultOutcomes.includes(outcome) &&
+        receipt["resultDigest"] === undefined &&
+        hasExactCommit(commit, {
+            state: "not-published",
+            publication: "none",
+            [atomicityField]: "not-applicable",
+            recoverability: "not-required"
+        });
+    const recovery = typeof outcome === "string" &&
+        recoveryOutcomes.includes(outcome) &&
+        receipt["resultDigest"] === undefined &&
+        isRecoveryCommit(outcome, commit);
+    if (!applied && !alreadyApplied && !noResult && !recovery) {
+        throw new DocumentContractDigestError("Document Receipt outcome and commit observation are incompatible.");
+    }
+}
+function assertReferencedDocumentDigests(plan) {
+    const references = plan["referencedDocuments"];
+    if (!Array.isArray(references)) {
+        throw new DocumentContractDigestError("Document Plan referenced documents must be an array.");
+    }
+    for (const referenceValue of references) {
+        const reference = record(referenceValue, "Document Plan referenced document");
+        if (typeof reference["id"] !== "string" ||
+            typeof reference["path"] !== "string" ||
+            reference["projectionDigest"] !==
+                documentReferencedDocumentDigest({
+                    id: reference["id"],
+                    path: reference["path"]
+                })) {
+            throw new DocumentContractDigestError("Document Plan referenced-document digest is invalid.");
+        }
+    }
+}
+function assertOutputDigest(plan) {
+    const output = record(plan["output"], "Document Plan output");
+    if (typeof output["contentBase64"] !== "string") {
+        throw new DocumentContractDigestError("Document Plan output content must be canonical Base64.");
+    }
+    const bytes = Buffer.from(output["contentBase64"], "base64");
+    if (bytes.toString("base64") !== output["contentBase64"] ||
+        output["size"] !== bytes.byteLength ||
+        output["digest"] !== sha256Bytes(bytes)) {
+        throw new DocumentContractDigestError("Document Plan output digest is invalid.");
+    }
+    if (bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {
+        throw new DocumentContractDigestError("Document Plan output must not start with a UTF-8 BOM.");
+    }
+    let source;
+    try {
+        source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch (error) {
+        throw new DocumentContractDigestError("Document Plan output is not well-formed UTF-8.", { cause: error });
+    }
+    if (source.startsWith("\uFEFF") ||
+        source.includes("\u0000") ||
+        source.includes("\r") ||
+        !source.endsWith("\n") ||
+        source.endsWith("\n\n") ||
+        output["mode"] !== "0644" ||
+        output["mediaType"] !== "text/markdown; charset=utf-8") {
+        throw new DocumentContractDigestError("Document Plan output violates the canonical Markdown byte contract.");
+    }
+}
+export function assertDocumentPlanDigests(value) {
+    const plan = validatedRecord(value, "Document Plan");
+    assertIntentDigest(plan);
+    assertOwnerMembershipDigest(plan);
+    assertReferencedDocumentDigests(plan);
+    assertOutputDigest(plan);
+    assertPublicationBindings(plan);
+    if (plan["planDigest"] !== documentPlanDigest(plan)) {
+        throw new DocumentContractDigestError("Document Plan digest is invalid.");
+    }
+}
+export function assertDocumentReceiptDigest(value, planValue) {
+    const receipt = validatedRecord(value, "Document Receipt");
+    if (receipt["receiptDigest"] !== documentReceiptDigest(receipt)) {
+        throw new DocumentContractDigestError("Document Receipt digest is invalid.");
+    }
+    assertReceiptOutcomeCommit(receipt);
+    if (planValue === undefined) {
+        return;
+    }
+    assertDocumentPlanDigests(planValue);
+    const plan = validatedRecord(planValue, "Document Plan");
+    if ((plan["schemaVersion"] === 2) !== (receipt["schemaVersion"] === 2)) {
+        throw new DocumentContractDigestError("Document Receipt version does not match the referenced Plan.");
+    }
+    if (plan["schemaVersion"] === 2) {
+        const planMaterialization = record(plan["parentMaterialization"], "Document Plan parent materialization");
+        const receiptMaterialization = record(receipt["directoryMaterialization"], "Document Receipt directory materialization");
+        if (canonicalJson(receiptMaterialization["plannedDirectories"]) !==
+            canonicalJson(planMaterialization["missingDirectories"]) ||
+            !Array.isArray(receiptMaterialization["observedCreatedDirectories"])) {
+            throw new DocumentContractDigestError("Document Receipt directory evidence does not bind the referenced Plan.");
+        }
+    }
+    const output = record(plan["output"], "Document Plan output");
+    const outcome = receipt["outcome"];
+    const hasProvenOutput = outcome === "applied" || outcome === "already-applied";
+    const supportedOutcomes = new Set([
+        "applied",
+        "already-applied",
+        "authority-stale",
+        "rejected",
+        "recovery-required",
+        "manual-recovery-required",
+        "failed-before-publication",
+        "cancelled"
+    ]);
+    if (typeof outcome !== "string" ||
+        !supportedOutcomes.has(outcome) ||
+        receipt["planDigest"] !== plan["planDigest"] ||
+        receipt["destination"] !== plan["destination"] ||
+        (hasProvenOutput && receipt["resultDigest"] !== output["digest"]) ||
+        (!hasProvenOutput && receipt["resultDigest"] !== undefined)) {
+        throw new DocumentContractDigestError("Document Receipt result evidence does not bind the referenced Plan.");
+    }
+}
+//# sourceMappingURL=document-contract-digests.js.map

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

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

package/dist/application/policies/document-logical-preimage.d.ts

@@ -0,0 +1,14 @@
+import type { DocumentCatalogCollection } from "../model/document-planning.js";
+import type { DocumentIdentityProjectionEntry, DocumentationCatalogSnapshot } from "../model/document-catalog.js";
+export declare function isDestinationCoveredByCatalog(destination: string, collections: readonly DocumentCatalogCollection[], excludedPrefixes: readonly string[]): boolean;
+export declare function classifyDocumentLogicalPreimage(input: {
+    readonly catalog: DocumentationCatalogSnapshot;
+    readonly destination: string;
+    readonly expectedBytes: Uint8Array;
+    readonly id: string;
+    readonly observedBytes?: Uint8Array;
+}): {
+    readonly identityProjection: readonly DocumentIdentityProjectionEntry[];
+    readonly isExactSelf: boolean;
+};
+//# sourceMappingURL=document-logical-preimage.d.ts.map

package/dist/application/policies/document-logical-preimage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-logical-preimage.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-logical-preimage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,+BAA+B,EAC/B,4BAA4B,EAC7B,MAAM,8BAA8B,CAAC;AAOtC,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,SAAS,yBAAyB,EAAE,EACjD,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,OAAO,CAUT;AAqBD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC;CACrC,GAAG;IACF,QAAQ,CAAC,kBAAkB,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACxE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,CA8CA"}

package/dist/application/policies/document-logical-preimage.js

@@ -0,0 +1,61 @@
+import { compareBinaryStrings } from "../../binary-string-comparator.js";
+import { DocumentPlanningPolicyError } from "./document-planning-policy-error.js";
+function isPrefix(prefix, path) {
+    return path === prefix || path.startsWith(`${prefix}/`);
+}
+export function isDestinationCoveredByCatalog(destination, collections, excludedPrefixes) {
+    if (excludedPrefixes.some((prefix) => isPrefix(prefix, destination))) {
+        return false;
+    }
+    return collections.some((collection) => collection.kind === "markdown-tree"
+        ? isPrefix(collection.root, destination)
+        : destination.endsWith("/README.md") &&
+            collection.roots.some((root) => isPrefix(root, destination)));
+}
+function sameBytes(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function portablePath(path) {
+    return path.normalize("NFC").toLowerCase();
+}
+function sortedProjection(entries) {
+    return Object.freeze(entries
+        .map((entry) => Object.freeze({ id: entry.id, repositoryPath: entry.repositoryPath }))
+        .toSorted((left, right) => compareBinaryStrings(left.id, right.id) ||
+        compareBinaryStrings(left.repositoryPath, right.repositoryPath)));
+}
+export function classifyDocumentLogicalPreimage(input) {
+    if (input.catalog.status !== "complete") {
+        throw new DocumentPlanningPolicyError("catalog-incomplete", "Document planning requires a complete catalog.");
+    }
+    const entries = input.catalog.identityProjection;
+    const ids = new Set();
+    const paths = new Set();
+    for (const entry of entries) {
+        const path = portablePath(entry.repositoryPath);
+        if (ids.has(entry.id) || paths.has(path)) {
+            throw new DocumentPlanningPolicyError("catalog-collision", "Document catalog contains an identity or portable path collision.");
+        }
+        ids.add(entry.id);
+        paths.add(path);
+    }
+    const exactDescriptor = input.catalog.documents.filter((document) => document.id === input.id && document.repositoryPath === input.destination);
+    const exactEntry = entries.filter((entry) => entry.id === input.id && entry.repositoryPath === input.destination);
+    const isExactSelf = input.observedBytes !== undefined &&
+        sameBytes(input.observedBytes, input.expectedBytes) &&
+        exactDescriptor.length === 1 &&
+        exactEntry.length === 1;
+    const idCollision = entries.some((entry) => entry.id === input.id && !(isExactSelf && entry.repositoryPath === input.destination));
+    const pathCollision = entries.some((entry) => portablePath(entry.repositoryPath) === portablePath(input.destination) &&
+        !(isExactSelf && entry.repositoryPath === input.destination && entry.id === input.id));
+    if (idCollision || pathCollision || (input.observedBytes !== undefined && !isExactSelf)) {
+        throw new DocumentPlanningPolicyError("destination-conflict", "Document identity or destination conflicts with the logical preimage.");
+    }
+    return Object.freeze({
+        identityProjection: sortedProjection(isExactSelf
+            ? entries.filter((entry) => !(entry.id === input.id && entry.repositoryPath === input.destination))
+            : entries),
+        isExactSelf
+    });
+}
+//# sourceMappingURL=document-logical-preimage.js.map

package/dist/application/policies/document-logical-preimage.js.map

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

package/dist/application/policies/document-planning-policy-error.d.ts

@@ -0,0 +1,6 @@
+export type DocumentPlanningPolicyProblem = "catalog-collision" | "catalog-incomplete" | "destination-conflict" | "destination-not-covered" | "duplicate-related" | "invalid-artifact-type" | "invalid-destination" | "invalid-identity" | "invalid-intent-json" | "invalid-slug" | "missing-destination" | "missing-slug";
+export declare class DocumentPlanningPolicyError extends Error {
+    readonly problem: DocumentPlanningPolicyProblem;
+    constructor(problem: DocumentPlanningPolicyProblem, message: string);
+}
+//# sourceMappingURL=document-planning-policy-error.d.ts.map

package/dist/application/policies/document-planning-policy-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-policy-error.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-planning-policy-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,GACrC,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,yBAAyB,GACzB,mBAAmB,GACnB,uBAAuB,GACvB,qBAAqB,GACrB,kBAAkB,GAClB,qBAAqB,GACrB,cAAc,GACd,qBAAqB,GACrB,cAAc,CAAC;AAEnB,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;IAEhD,YAAY,OAAO,EAAE,6BAA6B,EAAE,OAAO,EAAE,MAAM,EAIlE;CACF"}

package/dist/application/policies/document-planning-policy-error.js

@@ -0,0 +1,9 @@
+export class DocumentPlanningPolicyError extends Error {
+    problem;
+    constructor(problem, message) {
+        super(message);
+        this.name = "DocumentPlanningPolicyError";
+        this.problem = problem;
+    }
+}
+//# sourceMappingURL=document-planning-policy-error.js.map

package/dist/application/policies/document-planning-policy-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-policy-error.js","sourceRoot":"","sources":["../../../src/application/policies/document-planning-policy-error.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,OAAO,CAAgC;IAEhD,YAAY,OAAsC,EAAE,OAAe;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/application/policies/document-receipt-policy.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentReceipt, DocumentReceiptContract, DocumentReceiptBody } from "../model/document-receipt.js";
+import type { DocumentPlanContract as DocumentPlan } from "../model/document-planning.js";
+export declare function createDocumentReceipt(body: DocumentReceiptBody, plan: DocumentPlan | undefined): Promise<DocumentReceiptContract>;
+export declare function assertDocumentReceipt(receipt: unknown, plan: DocumentPlan | undefined): Promise<DocumentReceipt>;
+//# sourceMappingURL=document-receipt-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-receipt-policy.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-receipt-policy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA4F1F,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAiBlC;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO,CAAC,eAAe,CAAC,CAgB1B"}

package/dist/application/policies/document-receipt-policy.js

@@ -0,0 +1,92 @@
+import { canonicalJson } from "../../canonical-json.js";
+import { assertSchema } from "../../schema-catalog.js";
+import { assertDocumentReceiptDigest, documentReceiptDigest } from "./document-contract-digests.js";
+function snapshotBody(body) {
+    return JSON.parse(canonicalJson(body));
+}
+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 requireDocumentPlan(plan) {
+    if (plan === undefined) {
+        throw new TypeError("Document Receipt requires the exact referenced Plan.");
+    }
+}
+function assertDirectoryPrefix(receipt, plan) {
+    const evidence = receipt.directoryMaterialization;
+    const planned = plan.parentMaterialization.missingDirectories;
+    if (evidence.plannedDirectories.length !== planned.length ||
+        evidence.plannedDirectories.some((path, index) => path !== planned[index]) ||
+        evidence.observedCreatedDirectories.length > planned.length ||
+        evidence.observedCreatedDirectories.some((path, index) => path !== planned[index])) {
+        throw new TypeError("Document Receipt directory evidence must bind the exact ordered Plan prefix.");
+    }
+}
+function inconsistentDirectoryOutcome(receipt, plan) {
+    const evidence = receipt.directoryMaterialization;
+    const planned = plan.parentMaterialization.missingDirectories;
+    return (evidence.state === "none-created" &&
+        evidence.observedCreatedDirectories.length !== 0) ||
+        (evidence.state === "preserved-unknown" &&
+            receipt.outcome !== "recovery-required" &&
+            receipt.outcome !== "manual-recovery-required") ||
+        (receipt.outcome === "already-applied" && evidence.state !== "none-created") ||
+        (receipt.outcome === "applied" && planned.length === 0 &&
+            evidence.state !== "none-created") ||
+        (receipt.outcome === "applied" && planned.length > 0 &&
+            (evidence.state !== "created-and-retained" ||
+                evidence.observedCreatedDirectories.length !== planned.length));
+}
+function assertV2DirectoryReceipt(receipt, plan) {
+    if (receipt.schemaVersion !== 2 || plan.schemaVersion !== 2) {
+        return;
+    }
+    assertDirectoryPrefix(receipt, plan);
+    if (inconsistentDirectoryOutcome(receipt, plan)) {
+        throw new TypeError("Document Receipt directory materialization outcome is inconsistent.");
+    }
+}
+export async function createDocumentReceipt(body, plan) {
+    const snapshot = deepFreezeCanonical(snapshotBody(body));
+    const receipt = deepFreezeCanonical({
+        ...snapshot,
+        receiptDigest: documentReceiptDigest(snapshot)
+    });
+    await assertSchema(receipt.schemaVersion === 2 ? "document-receipt/v2" : "document-receipt/v1", receipt, "document-receipt");
+    requireDocumentPlan(plan);
+    assertV2DirectoryReceipt(receipt, plan);
+    assertDocumentReceiptDigest(receipt, plan);
+    return receipt;
+}
+export async function assertDocumentReceipt(receipt, plan) {
+    const snapshot = deepFreezeCanonical(JSON.parse(canonicalJson(receipt)));
+    await assertSchema(snapshot.schemaVersion === 2
+        ? "document-receipt/v2"
+        : "document-receipt/v1", snapshot, "document-receipt");
+    requireDocumentPlan(plan);
+    const documentReceipt = snapshot;
+    assertV2DirectoryReceipt(documentReceipt, plan);
+    assertDocumentReceiptDigest(documentReceipt, plan);
+    return documentReceipt;
+}
+//# sourceMappingURL=document-receipt-policy.js.map

package/dist/application/policies/document-receipt-policy.js.map

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

package/dist/application/policies/document-repository-path.d.ts

@@ -0,0 +1,3 @@
+export declare function isDocumentRepositoryPath(path: string): boolean;
+export declare function documentRepositoryParentPath(path: string): string;
+//# sourceMappingURL=document-repository-path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-repository-path.d.ts","sourceRoot":"","sources":["../../../src/application/policies/document-repository-path.ts"],"names":[],"mappings":"AAIA,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmB9D;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjE"}

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

@@ -0,0 +1,24 @@
+const DOCUMENT_REPOSITORY_SEGMENT = /^[A-Za-z0-9._@-]+$/u;
+const WINDOWS_RESERVED_NAMES = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/iu;
+const utf8 = new TextEncoder();
+export function isDocumentRepositoryPath(path) {
+    if (utf8.encode(path).byteLength > 512 ||
+        path.startsWith("/") ||
+        path.includes("\\")) {
+        return false;
+    }
+    const segments = path.split("/");
+    return segments.every((segment) => segment.length > 0 &&
+        segment !== "." &&
+        segment !== ".." &&
+        utf8.encode(segment).byteLength <= 255 &&
+        !segment.endsWith(".") &&
+        !segment.endsWith(" ") &&
+        !WINDOWS_RESERVED_NAMES.test(segment) &&
+        DOCUMENT_REPOSITORY_SEGMENT.test(segment));
+}
+export function documentRepositoryParentPath(path) {
+    const separator = path.lastIndexOf("/");
+    return separator === -1 ? "." : path.slice(0, separator);
+}
+//# sourceMappingURL=document-repository-path.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-repository-path.js","sourceRoot":"","sources":["../../../src/application/policies/document-repository-path.ts"],"names":[],"mappings":"AAAA,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AAC1D,MAAM,sBAAsB,GAAG,kDAAkD,CAAC;AAClF,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAE/B,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,IACE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,GAAG;QAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,KAAK,GAAG;QACf,OAAO,KAAK,IAAI;QAChB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,IAAI,GAAG;QACtC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC;QACrC,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * 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 declare function documentTemporaryPath(destination: string, planDigest: string): string;
+//# sourceMappingURL=document-temporary-path.d.ts.map