@agent-teams/engineering-foundation 0.13.1 → 0.15.0

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/adapters/node/read-document-authority-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-document-authority-file.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/read-document-authority-file.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,6CAA6C,CAAC;AAKrD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA4ED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA4BjC"}
+{"version":3,"file":"read-document-authority-file.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/read-document-authority-file.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,6CAA6C,CAAC;AAIrD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA6DD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA4BjC"}

package/dist/document-authoring/adapters/node/read-document-authority-file.js

@@ -1,23 +1,13 @@
 import { createHash } from "node:crypto";
-import { isAbsolute, resolve } from "node:path";
+import { resolve } from "node:path";
 import { ContainedFileReadError, readContainedRegularFile } from "../../../filesystem-path-safety.js";
+import { isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
 import { DocumentCatalogError } from "../../document-catalog-error.js";
-const WINDOWS_DEVICE_COMPONENT = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/iu;
 function inputInvalid(message, options) {
     throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", message, options);
 }
 function assertPortableDocumentAuthorityPath(path) {
-    const segments = path.split("/");
-    if (path.length === 0 ||
-        path.length > 512 ||
-        isAbsolute(path) ||
-        path.includes("\\") ||
-        !/^[A-Za-z0-9._@/-]+$/u.test(path) ||
-        segments.some((segment) => segment.length === 0 ||
-            segment === "." ||
-            segment === ".." ||
-            segment.endsWith(".") ||
-            WINDOWS_DEVICE_COMPONENT.test(segment))) {
+    if (!isDocumentRepositoryPath(path)) {
         inputInvalid("Document authority paths must use the portable repository-relative path grammar.");
     }
 }

package/dist/document-authoring/adapters/node/read-document-authority-file.js.map

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

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/authoring-profile-semantics.d.ts

@@ -0,0 +1,38 @@
+interface PlacementSemantics {
+    readonly allowedRoots?: readonly string[];
+    readonly kind: string;
+    readonly filename?: string;
+    readonly minimumSegmentsAfterRequired?: number;
+    readonly minimumSegmentsBeforeRequired?: number;
+    readonly requiredBasename?: string;
+    readonly requiredSegmentsInOrder?: readonly string[];
+    readonly root?: string;
+}
+interface ArtifactTypeSemantics {
+    readonly identity?: {
+        readonly format?: string;
+        readonly grammar?: {
+            readonly maxSuffixSegments: number;
+            readonly minSuffixSegments: number;
+            readonly prefixSegments: readonly string[];
+        };
+    };
+    readonly placement: PlacementSemantics;
+    readonly type: string;
+}
+export interface AuthoringProfileSemantics {
+    readonly authoring: {
+        readonly artifactTypes: readonly ArtifactTypeSemantics[];
+    };
+}
+export type AuthoringProfileSemanticProblem = "duplicate-artifact-type" | "incompatible-identity-placement" | "invalid-qualified-grammar-range" | "overlapping-placement-roots" | "portable-root-collision";
+export declare class AuthoringProfileSemanticError extends Error {
+    readonly problem: AuthoringProfileSemanticProblem;
+    constructor(problem: AuthoringProfileSemanticProblem);
+}
+export declare function assertAuthoringProfileSemantics(profile: AuthoringProfileSemantics): void;
+export declare function matchingPlacementRoot(repositoryPath: string, allowedRoots: readonly string[]): string | undefined;
+export declare function hasContiguousRequiredSegments(repositoryPath: string, requiredSegments: readonly string[], matchedRoot?: string): boolean;
+export declare function isRepositoryPathAllowedByPlacement(repositoryPath: string, placement: PlacementSemantics): boolean;
+export {};
+//# sourceMappingURL=authoring-profile-semantics.d.ts.map

package/dist/document-authoring/application/policies/authoring-profile-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-profile-semantics.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/authoring-profile-semantics.ts"],"names":[],"mappings":"AAEA,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IAC/C,QAAQ,CAAC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IAChD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,CAAC,EAAE;YACjB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;YACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;YACnC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;SAC5C,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,aAAa,EAAE,SAAS,qBAAqB,EAAE,CAAC;KAC1D,CAAC;CACH;AAED,MAAM,MAAM,+BAA+B,GACvC,yBAAyB,GACzB,iCAAiC,GACjC,iCAAiC,GACjC,6BAA6B,GAC7B,yBAAyB,CAAC;AAE9B,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAC;IAElD,YAAY,OAAO,EAAE,+BAA+B,EAInD;CACF;AAqBD,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CA+CxF;AAED,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAkBT;AAED,wBAAgB,kCAAkC,CAChD,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAsCT"}

package/dist/document-authoring/application/policies/authoring-profile-semantics.js

@@ -0,0 +1,122 @@
+import { isDocumentRepositoryPath } from "./document-repository-path.js";
+export class AuthoringProfileSemanticError extends Error {
+    problem;
+    constructor(problem) {
+        super(`Document authoring profile has invalid semantics: ${problem}.`);
+        this.name = "AuthoringProfileSemanticError";
+        this.problem = problem;
+    }
+}
+function portableAsciiIdentity(value) {
+    return value.replace(/[A-Z]/gu, (character) => character.toLowerCase());
+}
+function isSegmentBoundaryPrefix(prefix, candidate) {
+    return candidate === prefix || candidate.startsWith(`${prefix}/`);
+}
+function hasCompatibleIdentityPlacement(artifactType) {
+    const placement = artifactType.placement;
+    if (placement.kind === "qualified-leaf-index") {
+        return artifactType.identity?.format === "qualified";
+    }
+    if (placement.kind === "collection" && placement.filename === "numeric-id-slug") {
+        return artifactType.identity?.format === "adr-four-digits";
+    }
+    return true;
+}
+export function assertAuthoringProfileSemantics(profile) {
+    const types = new Set();
+    for (const artifactType of profile.authoring.artifactTypes) {
+        const typeIdentity = portableAsciiIdentity(artifactType.type);
+        if (types.has(typeIdentity)) {
+            throw new AuthoringProfileSemanticError("duplicate-artifact-type");
+        }
+        types.add(typeIdentity);
+        const grammar = artifactType.identity?.grammar;
+        if (grammar !== undefined &&
+            grammar.minSuffixSegments > grammar.maxSuffixSegments) {
+            throw new AuthoringProfileSemanticError("invalid-qualified-grammar-range");
+        }
+        const placement = artifactType.placement;
+        if (!hasCompatibleIdentityPlacement(artifactType)) {
+            throw new AuthoringProfileSemanticError("incompatible-identity-placement");
+        }
+        const roots = placement.kind === "qualified-leaf-index"
+            ? (placement.root === undefined ? [] : [placement.root])
+            : [...(placement.allowedRoots ?? [])];
+        const identities = roots.map(portableAsciiIdentity);
+        for (const [index, root] of roots.entries()) {
+            if (!isDocumentRepositoryPath(root)) {
+                throw new AuthoringProfileSemanticError("portable-root-collision");
+            }
+            for (let other = 0; other < index; other += 1) {
+                const previous = identities[other];
+                const current = identities[index];
+                if (previous === undefined || current === undefined) {
+                    continue;
+                }
+                if (previous === current) {
+                    throw new AuthoringProfileSemanticError("portable-root-collision");
+                }
+                if (isSegmentBoundaryPrefix(previous, current) ||
+                    isSegmentBoundaryPrefix(current, previous)) {
+                    throw new AuthoringProfileSemanticError("overlapping-placement-roots");
+                }
+            }
+        }
+    }
+}
+export function matchingPlacementRoot(repositoryPath, allowedRoots) {
+    const matches = allowedRoots.filter((root) => isSegmentBoundaryPrefix(root, repositoryPath));
+    return matches.length === 1 ? matches[0] : undefined;
+}
+export function hasContiguousRequiredSegments(repositoryPath, requiredSegments, matchedRoot) {
+    if (requiredSegments.length === 0) {
+        return true;
+    }
+    const rootIdentity = matchedRoot;
+    if (rootIdentity !== undefined &&
+        !isSegmentBoundaryPrefix(rootIdentity, repositoryPath)) {
+        return false;
+    }
+    const suffix = rootIdentity === undefined
+        ? repositoryPath
+        : repositoryPath.slice(rootIdentity.length).replace(/^\//u, "");
+    const segments = suffix.split("/");
+    return segments.some((_segment, start) => requiredSegments.every((segment, offset) => segments[start + offset] === segment));
+}
+export function isRepositoryPathAllowedByPlacement(repositoryPath, placement) {
+    if (!isDocumentRepositoryPath(repositoryPath)) {
+        return false;
+    }
+    const segments = repositoryPath.split("/");
+    const basename = segments.at(-1);
+    if (basename !== placement.requiredBasename) {
+        return false;
+    }
+    if (placement.kind === "qualified-leaf-index") {
+        if (placement.root === undefined) {
+            return false;
+        }
+        const rootSegments = placement.root.split("/");
+        return isSegmentBoundaryPrefix(placement.root, repositoryPath) &&
+            segments.length > rootSegments.length + 1;
+    }
+    if (placement.kind !== "explicit") {
+        return false;
+    }
+    const root = matchingPlacementRoot(repositoryPath, placement.allowedRoots ?? []);
+    const required = placement.requiredSegmentsInOrder ?? [];
+    if (root === undefined ||
+        required.length === 0 ||
+        placement.minimumSegmentsBeforeRequired === undefined ||
+        placement.minimumSegmentsAfterRequired === undefined) {
+        return false;
+    }
+    const suffix = repositoryPath.slice(root.length + 1).split("/");
+    const directories = suffix.slice(0, -1);
+    return directories.some((_segment, start) => start >= placement.minimumSegmentsBeforeRequired &&
+        directories.length - start - required.length >=
+            placement.minimumSegmentsAfterRequired &&
+        required.every((segment, offset) => directories[start + offset] === segment));
+}
+//# sourceMappingURL=authoring-profile-semantics.js.map

package/dist/document-authoring/application/policies/authoring-profile-semantics.js.map

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

package/dist/document-authoring/application/policies/document-contract-digests.d.ts

@@ -0,0 +1,20 @@
+import { type CanonicalJsonValue } from "../../../canonical-json.js";
+type Digest = `sha256:${string}`;
+type JsonObject = Readonly<Record<string, CanonicalJsonValue>>;
+export declare function documentIntentDigest(intent: JsonObject): Digest;
+export declare function documentOwnerMembershipDigest(ownerCatalogDigest: string, ownerId: string): Digest;
+export interface DocumentIdentityDigestEntry {
+    readonly id: string;
+    readonly repositoryPath: string;
+}
+export declare function documentIdentityProjectionDigest(entries: readonly DocumentIdentityDigestEntry[]): Digest;
+export declare function documentReferencedDocumentDigest(document: {
+    readonly id: string;
+    readonly path: string;
+}): Digest;
+export declare function documentPlanDigest(plan: JsonObject): Digest;
+export declare function documentReceiptDigest(receipt: JsonObject): Digest;
+export declare function assertDocumentPlanDigests(value: unknown): void;
+export declare function assertDocumentReceiptDigest(value: unknown, planValue?: unknown): void;
+export {};
+//# sourceMappingURL=document-contract-digests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-contract-digests.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-contract-digests.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,4BAA4B,CAAC;AAIpC,KAAK,MAAM,GAAG,UAAU,MAAM,EAAE,CAAC;AACjC,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAyC/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED,wBAAgB,6BAA6B,CAC3C,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,MAAM,GACd,MAAM,CAKR;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,SAAS,2BAA2B,EAAE,GAC9C,MAAM,CAcR;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAST;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAK3D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAKjE;AAqOD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAU9D;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,OAAO,GAClB,IAAI,CAoCN"}