@agent-teams/engineering-foundation 0.11.0 → 0.13.0

package/dist/document-authoring/adapters/node/node-owner-membership-reader.js

@@ -0,0 +1,62 @@
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { assertNotCancelled } from "../../../cancellation.js";
+import { compareBinaryStrings } from "../../../binary-string-comparator.js";
+import { parseStrictYamlSource } from "../../../strict-yaml.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { readDocumentAuthorityFile } from "./read-document-authority-file.js";
+const MAX_OWNER_CATALOG_BYTES = 1024 * 1024;
+const MAX_OWNER_COUNT = 4096;
+const OWNER_ID = /^[A-Za-z0-9@][A-Za-z0-9@._/-]*$/u;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalidOwnerCatalog(message, cause) {
+    throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", message, cause === undefined ? undefined : { cause });
+}
+function parseOwnerIds(source) {
+    let input;
+    try {
+        input = parseStrictYamlSource(source, "document-owner-catalog");
+    }
+    catch (error) {
+        if (error instanceof CapabilityInputError) {
+            invalidOwnerCatalog("Document owner catalog must contain strict YAML.", error);
+        }
+        throw error;
+    }
+    if (!isRecord(input)) {
+        invalidOwnerCatalog("Document owner catalog must be an object.");
+    }
+    const keys = Object.keys(input).toSorted(compareBinaryStrings);
+    if (keys.length !== 2 ||
+        keys[0] !== "owners" ||
+        keys[1] !== "version" ||
+        input.version !== 1 ||
+        !isRecord(input.owners)) {
+        invalidOwnerCatalog("Document owner catalog must contain only version 1 and an owners object.");
+    }
+    const owners = input.owners;
+    const ids = Object.keys(owners).toSorted(compareBinaryStrings);
+    if (ids.length === 0 || ids.length > MAX_OWNER_COUNT) {
+        invalidOwnerCatalog(`Document owner catalog must contain between 1 and ${MAX_OWNER_COUNT} owners.`);
+    }
+    for (const id of ids) {
+        if (id.length > 214 || !OWNER_ID.test(id) || !isRecord(owners[id])) {
+            invalidOwnerCatalog("Document owner IDs must be normalized opaque identifiers with object metadata.");
+        }
+    }
+    return Object.freeze(ids);
+}
+export class NodeOwnerMembershipReader {
+    async read(request) {
+        assertNotCancelled(request.signal);
+        const file = await readDocumentAuthorityFile({
+            consumerRoot: request.consumerRoot,
+            maxBytes: MAX_OWNER_CATALOG_BYTES,
+            path: request.path
+        });
+        assertNotCancelled(request.signal);
+        return Object.freeze({ evidence: file.evidence, ids: parseOwnerIds(file.source) });
+    }
+}
+//# sourceMappingURL=node-owner-membership-reader.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { DocumentAuthorityEvidence } from "../../application/model/document-catalog.js";
+export interface DocumentAuthorityFile {
+    readonly bytes: Buffer;
+    readonly evidence: DocumentAuthorityEvidence;
+    readonly source: string;
+}
+export declare function readDocumentAuthorityFile(request: {
+    readonly consumerRoot: string;
+    readonly maxBytes: number;
+    readonly path: string;
+}): Promise<DocumentAuthorityFile>;
+//# sourceMappingURL=read-document-authority-file.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,88 @@
+import { createHash } from "node:crypto";
+import { isAbsolute, resolve } from "node:path";
+import { ContainedFileReadError, readContainedRegularFile } from "../../../filesystem-path-safety.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))) {
+        inputInvalid("Document authority paths must use the portable repository-relative path grammar.");
+    }
+}
+function decodeAuthoritySource(bytes, path) {
+    if (bytes.length >= 3 &&
+        bytes[0] === 0xef &&
+        bytes[1] === 0xbb &&
+        bytes[2] === 0xbf) {
+        inputInvalid(`Document authority must not contain a UTF-8 BOM: ${path}.`);
+    }
+    let source;
+    try {
+        source = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch (error) {
+        inputInvalid(`Document authority must contain well-formed UTF-8: ${path}.`, {
+            cause: error
+        });
+    }
+    if (source.includes("\u0000")) {
+        inputInvalid(`Document authority must not contain NUL characters: ${path}.`);
+    }
+    return source;
+}
+function digest(bytes) {
+    return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function unavailable(path, error) {
+    const detail = error.failure === "symlink"
+        ? "cannot traverse a symbolic link"
+        : error.failure === "invalid"
+            ? "must be a bounded regular file"
+            : error.failure === "escape"
+                ? "escapes the repository"
+                : "is unavailable or changed while reading";
+    throw new DocumentCatalogError("DOCUMENT_CATALOG_AUTHORITY_UNAVAILABLE", `Document authority ${detail}: ${path}.`, { cause: error });
+}
+export async function readDocumentAuthorityFile(request) {
+    assertPortableDocumentAuthorityPath(request.path);
+    let bytes;
+    try {
+        bytes = await readContainedRegularFile({
+            candidate: resolve(request.consumerRoot, request.path),
+            maxBytes: request.maxBytes,
+            root: request.consumerRoot
+        });
+    }
+    catch (error) {
+        if (error instanceof ContainedFileReadError) {
+            unavailable(request.path, error);
+        }
+        throw error;
+    }
+    if (bytes.length === 0) {
+        inputInvalid(`Document authority must not be empty: ${request.path}.`);
+    }
+    const source = decodeAuthoritySource(bytes, request.path);
+    return Object.freeze({
+        bytes,
+        evidence: Object.freeze({
+            digest: digest(bytes),
+            path: request.path,
+            size: bytes.byteLength
+        }),
+        source
+    });
+}
+//# sourceMappingURL=read-document-authority-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-document-authority-file.js","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/read-document-authority-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,wBAAwB,GAAG,kDAAkD,CAAC;AAQpF,SAAS,YAAY,CAAC,OAAe,EAAE,OAAsB;IAC3D,MAAM,IAAI,oBAAoB,CAC5B,gCAAgC,EAChC,OAAO,EACP,OAAO,CACR,CAAC;AACJ,CAAC;AAED,SAAS,mCAAmC,CAAC,IAAY;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IACE,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,GAAG;QACjB,UAAU,CAAC,IAAI,CAAC;QAChB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnB,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,QAAQ,CAAC,IAAI,CACX,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,MAAM,KAAK,CAAC;YACpB,OAAO,KAAK,GAAG;YACf,OAAO,KAAK,IAAI;YAChB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YACrB,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CACzC,EACD,CAAC;QACD,YAAY,CACV,kFAAkF,CACnF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,IAAY;IACxD,IACE,KAAK,CAAC,MAAM,IAAI,CAAC;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EACjB,CAAC;QACD,YAAY,CAAC,oDAAoD,IAAI,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,sDAAsD,IAAI,GAAG,EAAE;YAC1E,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,YAAY,CAAC,uDAAuD,IAAI,GAAG,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAA6B;IAC9D,MAAM,MAAM,GACV,KAAK,CAAC,OAAO,KAAK,SAAS;QACzB,CAAC,CAAC,iCAAiC;QACnC,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;YAC3B,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ;gBAC1B,CAAC,CAAC,wBAAwB;gBAC1B,CAAC,CAAC,yCAAyC,CAAC;IACpD,MAAM,IAAI,oBAAoB,CAC5B,wCAAwC,EACxC,sBAAsB,MAAM,KAAK,IAAI,GAAG,EACxC,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAI/C;IACC,mCAAmC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,wBAAwB,CAAC;YACrC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC;YACtD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,YAAY;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC5C,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,YAAY,CAAC,yCAAyC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK;QACL,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;YACrB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,KAAK,CAAC,UAAU;SACvB,CAAC;QACF,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,59 @@
+export type DocumentAuthorityDigest = `sha256:${string}`;
+export interface DocumentAuthorityEvidence {
+    readonly digest: DocumentAuthorityDigest;
+    readonly path: string;
+    readonly size: number;
+}
+export interface DocumentDescriptor {
+    readonly id: string;
+    readonly owner: string;
+    readonly repositoryPath: string;
+    readonly source: "frontmatter-readme" | "markdown-tree";
+    readonly status: string;
+    readonly summary: string;
+    readonly title: string;
+    readonly type: string;
+}
+export interface DocumentIdentityProjectionEntry {
+    readonly id: string;
+    readonly repositoryPath: string;
+}
+export interface ReferencedDocumentProjection {
+    readonly id: string;
+    readonly path: string;
+}
+export interface DocumentationCatalogDiagnostic {
+    readonly message: string;
+    readonly ruleId: string;
+    readonly severity: "error";
+    readonly subject: string;
+}
+export interface DocumentationCatalogAuthority {
+    readonly metadataSchema: DocumentAuthorityEvidence;
+    readonly ownerCatalog: DocumentAuthorityEvidence;
+    readonly profile: DocumentAuthorityEvidence;
+}
+export interface DocumentationCatalogSnapshot {
+    readonly authority: DocumentationCatalogAuthority;
+    readonly diagnostics: readonly DocumentationCatalogDiagnostic[];
+    readonly documents: readonly DocumentDescriptor[];
+    readonly identityProjection: readonly DocumentIdentityProjectionEntry[];
+    readonly ownerIds: readonly string[];
+    readonly projectId: string;
+    readonly status: "complete" | "partial";
+}
+export interface DocumentSearchCorpusEntry {
+    readonly body: string;
+    readonly descriptor: DocumentDescriptor;
+    readonly headings: readonly string[];
+}
+export interface DocumentationSearchCatalogSnapshot {
+    readonly catalog: DocumentationCatalogSnapshot;
+    readonly documents: readonly DocumentSearchCorpusEntry[];
+}
+export interface ReferencedDocumentProjectionResult {
+    readonly documents: readonly ReferencedDocumentProjection[];
+    readonly missingIds: readonly string[];
+    readonly unresolvedIds: readonly string[];
+}
+//# sourceMappingURL=document-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,UAAU,MAAM,EAAE,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;CAC7C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACxE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C"}

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

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

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

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

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

@@ -0,0 +1,18 @@
+import type { DocumentDescriptor, DocumentationCatalogDiagnostic } from "./document-catalog.js";
+export interface DocumentFindFilters {
+    readonly id?: string;
+    readonly owner?: string;
+    readonly status?: string;
+    readonly type?: string;
+}
+export interface DocumentFindQuery {
+    readonly filters?: DocumentFindFilters;
+    readonly text?: string;
+}
+export interface DocumentFindResult {
+    readonly catalogStatus: "complete" | "partial";
+    readonly diagnostics: readonly DocumentationCatalogDiagnostic[];
+    readonly documents: readonly DocumentDescriptor[];
+    readonly matches: number;
+}
+//# sourceMappingURL=document-find.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-find.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

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

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

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

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

package/dist/document-authoring/application/policies/document-catalog-diagnostics.d.ts

@@ -0,0 +1,8 @@
+import type { MarkdownObservationIssue } from "../../../documentation-observation/application/model/markdown-document.js";
+import type { DocumentIdentityProjectionEntry, DocumentationCatalogDiagnostic } from "../model/document-catalog.js";
+export declare function catalogDiagnostic(ruleId: string, subject: string, message: string): DocumentationCatalogDiagnostic;
+export declare function catalogObservationDiagnostic(issue: MarkdownObservationIssue): DocumentationCatalogDiagnostic;
+export declare function catalogCollisionDiagnostics(paths: readonly string[]): readonly DocumentationCatalogDiagnostic[];
+export declare function duplicateIdentityDiagnostics(entries: readonly DocumentIdentityProjectionEntry[]): readonly DocumentationCatalogDiagnostic[];
+export declare function sortCatalogDiagnostics(diagnostics: readonly DocumentationCatalogDiagnostic[]): readonly DocumentationCatalogDiagnostic[];
+//# sourceMappingURL=document-catalog-diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog-diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-catalog-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2EAA2E,CAAC;AAC1H,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,8BAA8B,CAAC;AAEtC,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,8BAA8B,CAOhC;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,wBAAwB,GAC9B,8BAA8B,CAMhC;AAMD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,SAAS,8BAA8B,EAAE,CAiB3C;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,SAAS,+BAA+B,EAAE,GAClD,SAAS,8BAA8B,EAAE,CAgB3C;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,SAAS,8BAA8B,EAAE,GACrD,SAAS,8BAA8B,EAAE,CAO3C"}

package/dist/document-authoring/application/policies/document-catalog-diagnostics.js

@@ -0,0 +1,44 @@
+import { compareBinaryStrings } from "../../../binary-string-comparator.js";
+export function catalogDiagnostic(ruleId, subject, message) {
+    return Object.freeze({
+        message: message.slice(0, 1000),
+        ruleId,
+        severity: "error",
+        subject
+    });
+}
+export function catalogObservationDiagnostic(issue) {
+    return catalogDiagnostic(`document.catalog.${issue.kind}`, issue.repositoryPath, issue.message);
+}
+function normalizedCollisionKey(path) {
+    return path.normalize("NFC").toLowerCase();
+}
+export function catalogCollisionDiagnostics(paths) {
+    const grouped = new Map();
+    for (const path of paths) {
+        const key = normalizedCollisionKey(path);
+        const matches = grouped.get(key) ?? [];
+        matches.push(path);
+        grouped.set(key, matches);
+    }
+    return [...grouped.values()]
+        .filter((matches) => matches.length > 1)
+        .map((matches) => catalogDiagnostic("document.catalog.normalized-path-collision", matches.toSorted(compareBinaryStrings).join(","), "Document paths collide after case-folding and NFC normalization."));
+}
+export function duplicateIdentityDiagnostics(entries) {
+    const pathsById = new Map();
+    for (const entry of entries) {
+        const paths = pathsById.get(entry.id) ?? [];
+        paths.push(entry.repositoryPath);
+        pathsById.set(entry.id, paths);
+    }
+    return [...pathsById]
+        .filter(([, paths]) => paths.length > 1)
+        .map(([id, paths]) => catalogDiagnostic("document.catalog.duplicate-id", id, `Document ID occurs at multiple paths: ${paths.toSorted(compareBinaryStrings).join(", ")}.`));
+}
+export function sortCatalogDiagnostics(diagnostics) {
+    return diagnostics.toSorted((left, right) => compareBinaryStrings(left.ruleId, right.ruleId) ||
+        compareBinaryStrings(left.subject, right.subject) ||
+        compareBinaryStrings(left.message, right.message));
+}
+//# sourceMappingURL=document-catalog-diagnostics.js.map

package/dist/document-authoring/application/policies/document-catalog-diagnostics.js.map

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

package/dist/document-authoring/application/policies/document-catalog-fields.d.ts

@@ -0,0 +1,18 @@
+import type { MarkdownDocumentObservation } from "../../../documentation-observation/application/model/markdown-document.js";
+import type { DocumentDescriptor, DocumentIdentityProjectionEntry } from "../model/document-catalog.js";
+import { catalogDiagnostic } from "./document-catalog-diagnostics.js";
+type DocumentFields = Omit<DocumentDescriptor, "repositoryPath" | "source" | "title">;
+export type DocumentFieldInspection = {
+    readonly fields?: never;
+    readonly identity?: DocumentIdentityProjectionEntry;
+} | {
+    readonly fields: DocumentFields;
+    readonly identity: DocumentIdentityProjectionEntry;
+};
+export declare function inspectDocumentFields(document: MarkdownDocumentObservation, metadata: Record<string, unknown>): DocumentFieldInspection;
+export declare function documentTitle(document: MarkdownDocumentObservation): string | undefined;
+export declare function invalidDocumentPathInspection(document: MarkdownDocumentObservation): {
+    readonly diagnostic: ReturnType<typeof catalogDiagnostic>;
+} | undefined;
+export {};
+//# sourceMappingURL=document-catalog-fields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog-fields.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-catalog-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2EAA2E,CAAC;AAC7H,OAAO,KAAK,EACV,kBAAkB,EAClB,+BAA+B,EAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAMtE,KAAK,cAAc,GAAG,IAAI,CACxB,kBAAkB,EAClB,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CACtC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CACrD,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;CACpD,CAAC;AA8BN,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,uBAAuB,CAuBzB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,2BAA2B,GACpC,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,2BAA2B,GACpC;IAAE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;CAAE,GAAG,SAAS,CAU3E"}

package/dist/document-authoring/application/policies/document-catalog-fields.js

@@ -0,0 +1,62 @@
+import { catalogDiagnostic } from "./document-catalog-diagnostics.js";
+import { isDocumentRepositoryPath } from "./document-repository-path.js";
+const OPAQUE_ID = /^[A-Za-z0-9@][A-Za-z0-9@._/-]*$/u;
+const LOWER_ID = /^[a-z0-9][a-z0-9._/-]*$/u;
+function containsControlCharacter(value) {
+    for (const character of value) {
+        const code = character.codePointAt(0) ?? 0;
+        if (code <= 0x1f || code === 0x7f) {
+            return true;
+        }
+    }
+    return false;
+}
+function stringField(metadata, field, maximumLength, pattern) {
+    const value = metadata[field];
+    return (typeof value === "string" &&
+        value.length > 0 &&
+        value.length <= maximumLength &&
+        !containsControlCharacter(value) &&
+        (pattern === undefined || pattern.test(value)))
+        ? value
+        : undefined;
+}
+export function inspectDocumentFields(document, metadata) {
+    const id = stringField(metadata, "id", 214, OPAQUE_ID);
+    const type = stringField(metadata, "type", 160, LOWER_ID);
+    const status = stringField(metadata, "status", 160, LOWER_ID);
+    const owner = stringField(metadata, "owner", 214, OPAQUE_ID);
+    const summary = stringField(metadata, "summary", 1000);
+    if (id === undefined ||
+        type === undefined ||
+        status === undefined ||
+        owner === undefined ||
+        summary === undefined) {
+        return id === undefined
+            ? Object.freeze({})
+            : Object.freeze({
+                identity: Object.freeze({ id, repositoryPath: document.repositoryPath })
+            });
+    }
+    return Object.freeze({
+        fields: Object.freeze({ id, owner, status, summary, type }),
+        identity: Object.freeze({ id, repositoryPath: document.repositoryPath })
+    });
+}
+export function documentTitle(document) {
+    const title = document.headings.find((heading) => heading.depth === 1)?.text;
+    return title !== undefined &&
+        title.length > 0 &&
+        title.length <= 240 &&
+        !containsControlCharacter(title)
+        ? title
+        : undefined;
+}
+export function invalidDocumentPathInspection(document) {
+    return isDocumentRepositoryPath(document.repositoryPath)
+        ? undefined
+        : Object.freeze({
+            diagnostic: catalogDiagnostic("document.catalog.path-invalid", document.repositoryPath, "Catalog document paths must use the portable repository path grammar.")
+        });
+}
+//# sourceMappingURL=document-catalog-fields.js.map

package/dist/document-authoring/application/policies/document-catalog-fields.js.map

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

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+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;
+export function isDocumentRepositoryPath(path) {
+    return path.length <= 512 && DOCUMENT_REPOSITORY_PATH.test(path);
+}
+//# sourceMappingURL=document-repository-path.js.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-catalog-document.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/inspect-catalog-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2EAA2E,CAAC;AACnF,OAAO,KAAK,EACV,kBAAkB,EAClB,+BAA+B,EAC/B,8BAA8B,EAC9B,yBAAyB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAQtF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,8BAA8B,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,yBAAyB,CAAC;CAClD;AAMD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GACnC,wBAAwB,CAyG1B"}

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

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

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

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

package/dist/document-authoring/application/ports/authoring-profile-reader.d.ts

@@ -0,0 +1,27 @@
+import type { DocumentAuthorityEvidence } from "../model/document-catalog.js";
+export type CatalogCollection = {
+    readonly kind: "frontmatter-readme";
+    readonly roots: readonly string[];
+} | {
+    readonly kind: "markdown-tree";
+    readonly root: string;
+};
+export interface CatalogProfileSnapshot {
+    readonly collections: readonly CatalogCollection[];
+    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 AuthoringProfileReader {
+    read(request: {
+        readonly consumerRoot: string;
+        readonly path: string;
+        readonly signal?: AbortSignal;
+    }): Promise<CatalogProfileSnapshot>;
+}
+//# sourceMappingURL=authoring-profile-reader.d.ts.map

package/dist/document-authoring/application/ports/authoring-profile-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-profile-reader.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/ports/authoring-profile-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE9E,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;QAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,OAAO,EAAE;QACZ,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,sBAAsB,CAAC,CAAC;CACrC"}

package/dist/document-authoring/application/ports/authoring-profile-reader.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=authoring-profile-reader.js.map

package/dist/document-authoring/application/ports/authoring-profile-reader.js.map

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

package/dist/document-authoring/application/ports/documentation-search-catalog-reader.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentationSearchCatalogSnapshot } from "../model/document-catalog.js";
+export interface DocumentationCatalogReadRequest {
+    readonly consumerRoot: string;
+    readonly profilePath: string;
+    readonly signal?: AbortSignal;
+}
+export interface DocumentationSearchCatalogReader {
+    read(request: DocumentationCatalogReadRequest): Promise<DocumentationSearchCatalogSnapshot>;
+}
+//# sourceMappingURL=documentation-search-catalog-reader.d.ts.map