@agent-teams/engineering-foundation 0.14.0 → 0.15.0

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

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

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

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

package/dist/document-authoring/adapters/node/node-document-template-reader.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentTemplateSnapshot } from "../../application/model/document-planning.js";
+import type { DocumentTemplateReader } from "../../application/ports/document-template-reader.js";
+export declare class NodeDocumentTemplateReader implements DocumentTemplateReader {
+    read(request: {
+        readonly consumerRoot: string;
+        readonly path: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentTemplateSnapshot>;
+}
+//# sourceMappingURL=node-document-template-reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-template-reader.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-template-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAOlG,qBAAa,0BAA2B,YAAW,sBAAsB;IACjE,IAAI,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA6BpC;CACF"}

package/dist/document-authoring/adapters/node/node-document-template-reader.js

@@ -0,0 +1,32 @@
+import { assertNotCancelled } from "../../../cancellation.js";
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+import { readDocumentAuthorityFile } from "./read-document-authority-file.js";
+const MAX_TEMPLATE_BYTES = 256 * 1024;
+export class NodeDocumentTemplateReader {
+    async read(request) {
+        assertNotCancelled(request.signal);
+        try {
+            const file = await readDocumentAuthorityFile({
+                consumerRoot: request.consumerRoot,
+                maxBytes: MAX_TEMPLATE_BYTES,
+                path: request.path
+            });
+            assertNotCancelled(request.signal);
+            return Object.freeze({ evidence: file.evidence, source: file.source });
+        }
+        catch (error) {
+            if (error instanceof CapabilityInputError || error instanceof DocumentPlanningError) {
+                throw error;
+            }
+            if (error instanceof DocumentCatalogError) {
+                throw new DocumentPlanningError(error.code === "DOCUMENT_CATALOG_INPUT_INVALID"
+                    ? "DOCUMENT_PLANNING_INPUT_INVALID"
+                    : "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template is unavailable or invalid: ${request.path}.`, { cause: error });
+            }
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template is unavailable or invalid: ${request.path}.`, { cause: error });
+        }
+    }
+}
+//# sourceMappingURL=node-document-template-reader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-template-reader.js","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-template-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEtC,MAAM,OAAO,0BAA0B;IACrC,KAAK,CAAC,IAAI,CAAC,OAIV;QACC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAAC;gBAC3C,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YACH,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAoB,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBACpF,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;gBAC1C,MAAM,IAAI,qBAAqB,CAC7B,KAAK,CAAC,IAAI,KAAK,gCAAgC;oBAC7C,CAAC,CAAC,iCAAiC;oBACnC,CAAC,CAAC,yCAAyC,EAC7C,gDAAgD,OAAO,CAAC,IAAI,GAAG,EAC/D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,qBAAqB,CAC7B,yCAAyC,EACzC,gDAAgD,OAAO,CAAC,IAAI,GAAG,EAC/D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/document-authoring/application/model/document-planning.d.ts

@@ -0,0 +1,171 @@
+import type { DocumentAuthorityDigest, DocumentAuthorityEvidence, DocumentIdentityProjectionEntry, DocumentationCatalogSnapshot } from "./document-catalog.js";
+export type DocumentJsonPrimitive = boolean | null | number | string;
+export interface DocumentJsonObject {
+    readonly [key: string]: DocumentJsonValue;
+}
+export type DocumentJsonValue = DocumentJsonPrimitive | readonly DocumentJsonValue[] | DocumentJsonObject;
+export interface DocumentIntent {
+    readonly schemaVersion: 1;
+    readonly type: string;
+    readonly id: string;
+    readonly title: string;
+    readonly owner: string;
+    readonly summary: string;
+    readonly slug?: string;
+    readonly destination?: string;
+    readonly related?: readonly string[];
+    readonly additionalMetadata?: Readonly<Record<string, DocumentJsonValue>>;
+}
+export type DocumentIdentityStrategy = {
+    readonly kind: "explicit";
+    readonly format: "adr-four-digits" | "open-decision-three-digits";
+} | {
+    readonly kind: "explicit";
+    readonly format: "qualified";
+    readonly grammar: {
+        readonly prefixSegments: readonly string[];
+        readonly minSuffixSegments: number;
+        readonly maxSuffixSegments: number;
+    };
+};
+export type DocumentPlacementStrategy = {
+    readonly kind: "collection";
+    readonly directory: string;
+    readonly filename: "numeric-id-slug" | "id-slug" | "slug" | "README.md";
+} | {
+    readonly kind: "qualified-leaf-index";
+    readonly root: string;
+    readonly requiredBasename: "README.md";
+} | {
+    readonly kind: "explicit";
+    readonly allowedRoots: readonly string[];
+    readonly requiredSegmentsInOrder: readonly string[];
+    readonly requiredBasename: "README.md";
+    readonly minimumSegmentsBeforeRequired: number;
+    readonly minimumSegmentsAfterRequired: number;
+};
+export interface DocumentArtifactType {
+    readonly type: string;
+    readonly initialStatus: string;
+    readonly identity: DocumentIdentityStrategy;
+    readonly placement: DocumentPlacementStrategy;
+    readonly template: {
+        readonly kind: "fenced-markdown-body";
+        readonly path: string;
+    };
+    readonly heading: {
+        readonly kind: "id-colon-title" | "title";
+    };
+}
+export type DocumentCatalogCollection = {
+    readonly kind: "frontmatter-readme";
+    readonly roots: readonly string[];
+} | {
+    readonly kind: "markdown-tree";
+    readonly root: string;
+};
+export interface DocumentPlanningProfileSnapshot {
+    readonly artifactTypes: readonly DocumentArtifactType[];
+    readonly collections: readonly DocumentCatalogCollection[];
+    readonly evidence: DocumentAuthorityEvidence;
+    readonly excludedPrefixes: readonly string[];
+    readonly metadataSchemaPath: string;
+    readonly ownerCatalog: {
+        readonly contract: "foundation.owner-map/v1";
+        readonly path: string;
+    };
+    readonly projectId: string;
+}
+export interface DocumentTemplateSnapshot {
+    readonly evidence: DocumentAuthorityEvidence;
+    readonly source: string;
+}
+export interface DocumentCompilerIdentity {
+    readonly id: "@agent-teams/engineering-foundation";
+    readonly version: string;
+    readonly buildIdentity: DocumentAuthorityDigest;
+}
+type DocumentDestinationObservation = {
+    readonly state: "absent";
+} | {
+    readonly state: "regular-file";
+    readonly bytes: Uint8Array;
+} | {
+    readonly state: "conflict";
+    readonly kind: "directory" | "portable-name-collision" | "special-file";
+};
+export interface DocumentPlanningStateSnapshot {
+    readonly destination: DocumentDestinationObservation;
+    readonly expectedParent: {
+        readonly path: string;
+        readonly state: "directory";
+        readonly ancestry: "real-directories";
+    };
+}
+export interface DocumentPlanDiagnostic {
+    readonly ruleId: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly phase: "authority" | "input" | "planning" | "policy";
+    readonly subject: string;
+    readonly message: string;
+}
+export interface DocumentPlan {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly compiler: DocumentCompilerIdentity;
+    readonly projectId: string;
+    readonly intent: DocumentIntent;
+    readonly intentDigest: DocumentAuthorityDigest;
+    readonly authority: {
+        readonly profile: DocumentAuthorityEvidence;
+        readonly metadataSchema: DocumentAuthorityEvidence;
+        readonly ownerCatalog: DocumentAuthorityEvidence;
+        readonly template: DocumentAuthorityEvidence;
+    };
+    readonly selectedOwner: {
+        readonly id: string;
+        readonly membershipDigest: DocumentAuthorityDigest;
+    };
+    readonly identityProjection: {
+        readonly entryCount: number;
+        readonly digest: DocumentAuthorityDigest;
+    };
+    readonly referencedDocuments: readonly {
+        readonly id: string;
+        readonly path: string;
+        readonly projectionDigest: DocumentAuthorityDigest;
+    }[];
+    readonly destination: string;
+    readonly expectedParent: {
+        readonly path: string;
+        readonly state: "directory";
+        readonly ancestry: "real-directories";
+    };
+    readonly destinationPrecondition: {
+        readonly state: "absent";
+    };
+    readonly output: {
+        readonly digest: DocumentAuthorityDigest;
+        readonly size: number;
+        readonly mode: "0644";
+        readonly mediaType: "text/markdown; charset=utf-8";
+        readonly contentBase64: string;
+    };
+    readonly requiredAdapterCapabilities: readonly ["create-file-no-replace/v1"];
+    readonly diagnostics: readonly DocumentPlanDiagnostic[];
+    readonly planDigest: DocumentAuthorityDigest;
+}
+export interface DocumentPlanningCompilationInput {
+    readonly catalog: DocumentationCatalogSnapshot;
+    readonly compiler: DocumentCompilerIdentity;
+    readonly identityProjection: readonly DocumentIdentityProjectionEntry[];
+    readonly intent: DocumentIntent;
+    readonly metadataSchema: DocumentAuthorityEvidence;
+    readonly ownerCatalog: DocumentAuthorityEvidence;
+    readonly profile: DocumentPlanningProfileSnapshot;
+    readonly state: DocumentPlanningStateSnapshot;
+    readonly template: DocumentTemplateSnapshot;
+    readonly output: string;
+}
+export {};
+//# sourceMappingURL=document-planning.d.ts.map

package/dist/document-authoring/application/model/document-planning.d.ts.map

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

package/dist/document-authoring/application/model/document-planning.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-planning.js.map

package/dist/document-authoring/application/model/document-planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-planning.ts"],"names":[],"mappings":""}

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