@agent-teams/engineering-foundation 0.13.1 → 0.15.0

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

@@ -0,0 +1,275 @@
+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) {
+    return domainDigest(`${DOMAIN_PREFIX}/plan/v1`, withoutOwnDigest(plan, "planDigest"));
+}
+export function documentReceiptDigest(receipt) {
+    return domainDigest(`${DOMAIN_PREFIX}/receipt/v1`, 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 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"];
+    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")) {
+        throw new DocumentContractDigestError("Document Plan publication bindings are invalid.");
+    }
+}
+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"];
+    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 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",
+            atomicity: "single-file-atomic-create",
+            recoverability: "not-required"
+        });
+    const alreadyApplied = outcome === "already-applied" &&
+        typeof receipt["resultDigest"] === "string" &&
+        hasExactCommit(commit, {
+            state: "committed",
+            publication: "preexisting-exact",
+            atomicity: "not-applicable",
+            recoverability: "not-required"
+        });
+    const noResult = typeof outcome === "string" &&
+        noResultOutcomes.includes(outcome) &&
+        receipt["resultDigest"] === undefined &&
+        hasExactCommit(commit, {
+            state: "not-published",
+            publication: "none",
+            atomicity: "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");
+    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/document-authoring/application/policies/document-contract-digests.js.map

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

package/dist/document-authoring/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/document-authoring/application/policies/document-logical-preimage.d.ts.map

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

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

package/dist/document-authoring/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/document-authoring/application/policies/document-planning-policy-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-policy-error.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/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/document-authoring/application/policies/document-planning-policy-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-policy-error.js","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/application/policies/document-repository-path.d.ts

@@ -1,2 +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/document-authoring/application/policies/document-repository-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-repository-path.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-repository-path.ts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"document-repository-path.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/application/policies/document-repository-path.js

@@ -1,5 +1,24 @@
-const DOCUMENT_REPOSITORY_PATH = /^(?!.*(?:^|\/)\.{1,2}(?:\/|$))(?!.*\.(?:\/|$))(?!.*(?:^|\/)(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.[A-Za-z0-9._@-]*)?(?:\/|$))[A-Za-z0-9._@-]+(?:\/[A-Za-z0-9._@-]+)*$/iu;
+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) {
-    return path.length <= 512 && DOCUMENT_REPOSITORY_PATH.test(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/document-authoring/application/policies/document-repository-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-repository-path.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-repository-path.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAC5B,4KAA4K,CAAC;AAE/K,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"document-repository-path.js","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-temporary-path.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/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/document-authoring/application/policies/document-temporary-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-temporary-path.js","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/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/document-authoring/application/policies/normalize-document-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-document-intent.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/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"}

package/dist/document-authoring/application/policies/normalize-document-intent.js

@@ -0,0 +1,104 @@
+import { compareBinaryStrings } from "../../../binary-string-comparator.js";
+import { DocumentPlanningPolicyError } from "./document-planning-policy-error.js";
+const FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+const GOVERNED_KEYS = new Set([
+    "destination",
+    "id",
+    "owner",
+    "related",
+    "slug",
+    "status",
+    "summary",
+    "title",
+    "type"
+]);
+function invalidJson(message) {
+    throw new DocumentPlanningPolicyError("invalid-intent-json", message);
+}
+function normalizeString(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const unit = value.charCodeAt(index);
+        if (unit >= 0xd800 && unit <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (!Number.isInteger(next) || next < 0xdc00 || next > 0xdfff) {
+                return invalidJson("Document Intent contains a lone UTF-16 surrogate.");
+            }
+            index += 1;
+        }
+        else if (unit >= 0xdc00 && unit <= 0xdfff) {
+            return invalidJson("Document Intent contains a lone UTF-16 surrogate.");
+        }
+    }
+    return value.normalize("NFC");
+}
+function normalizeJsonObject(value) {
+    const normalized = new Map();
+    for (const [rawKey, rawValue] of Object.entries(value)) {
+        const key = normalizeString(rawKey);
+        if (FORBIDDEN_KEYS.has(key)) {
+            return invalidJson(`Document Intent contains forbidden metadata key: ${key}.`);
+        }
+        if (normalized.has(key)) {
+            return invalidJson("Document Intent metadata keys collide after NFC normalization.");
+        }
+        normalized.set(key, normalizeJson(rawValue));
+    }
+    return Object.freeze(Object.fromEntries([...normalized].toSorted(([left], [right]) => compareBinaryStrings(left, right))));
+}
+function isJsonArray(value) {
+    return Array.isArray(value);
+}
+function normalizeJson(value) {
+    if (typeof value === "string") {
+        return normalizeString(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isSafeInteger(value) || Object.is(value, -0)) {
+            return invalidJson("Document Intent numbers must be safe integers other than negative zero.");
+        }
+        return value;
+    }
+    if (value === null || typeof value === "boolean") {
+        return value;
+    }
+    if (isJsonArray(value)) {
+        return Object.freeze(value.map(normalizeJson));
+    }
+    return normalizeJsonObject(value);
+}
+function normalizeAdditionalMetadata(metadata) {
+    if (metadata === undefined) {
+        return undefined;
+    }
+    const normalized = normalizeJsonObject(metadata);
+    for (const key of Object.keys(normalized)) {
+        if (GOVERNED_KEYS.has(key)) {
+            return invalidJson(`Document Intent additional metadata replaces governed key: ${key}.`);
+        }
+    }
+    return normalized;
+}
+export function normalizeDocumentIntent(input) {
+    const related = input.related?.map(normalizeString);
+    if (related !== undefined && new Set(related).size !== related.length) {
+        throw new DocumentPlanningPolicyError("duplicate-related", "Document Intent related identifiers must remain unique after NFC normalization.");
+    }
+    const additionalMetadata = normalizeAdditionalMetadata(input.additionalMetadata);
+    return Object.freeze({
+        schemaVersion: 1,
+        type: normalizeString(input.type),
+        id: normalizeString(input.id),
+        title: normalizeString(input.title),
+        owner: normalizeString(input.owner),
+        summary: normalizeString(input.summary),
+        ...(input.slug === undefined ? {} : { slug: normalizeString(input.slug) }),
+        ...(input.destination === undefined
+            ? {}
+            : { destination: normalizeString(input.destination) }),
+        ...(related === undefined
+            ? {}
+            : { related: Object.freeze(related.toSorted(compareBinaryStrings)) }),
+        ...(additionalMetadata === undefined ? {} : { additionalMetadata })
+    });
+}
+//# sourceMappingURL=normalize-document-intent.js.map

package/dist/document-authoring/application/policies/normalize-document-intent.js.map

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