@agent-teams/engineering-foundation 0.10.0 → 0.12.0

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

@@ -0,0 +1,24 @@
+import { compareBinaryStrings } from "../../../binary-string-comparator.js";
+export function projectReferencedDocuments(snapshot, referencedIds) {
+    const byId = new Map(snapshot.documents.map((document) => [document.id, document]));
+    const identityCountById = new Map();
+    for (const identity of snapshot.identityProjection) {
+        identityCountById.set(identity.id, (identityCountById.get(identity.id) ?? 0) + 1);
+    }
+    const uniqueIds = [...new Set(referencedIds)].toSorted(compareBinaryStrings);
+    const documents = uniqueIds.flatMap((id) => {
+        const document = byId.get(id);
+        return document === undefined || identityCountById.get(id) !== 1
+            ? []
+            : [{ id: document.id, path: document.repositoryPath }];
+    });
+    const missingIds = uniqueIds.filter((id) => !identityCountById.has(id));
+    const resolvedIds = new Set(documents.map((document) => document.id));
+    const unresolvedIds = uniqueIds.filter((id) => identityCountById.has(id) && !resolvedIds.has(id));
+    return Object.freeze({
+        documents: Object.freeze(documents.map((document) => Object.freeze(document))),
+        missingIds: Object.freeze(missingIds),
+        unresolvedIds: Object.freeze(unresolvedIds)
+    });
+}
+//# sourceMappingURL=document-catalog-projections.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog-projections.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/projections/document-catalog-projections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAM5E,MAAM,UAAU,0BAA0B,CACxC,QAAsC,EACtC,aAAgC;IAEhC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpD,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QACnD,iBAAiB,CAAC,GAAG,CACnB,QAAQ,CAAC,EAAE,EACX,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAC9C,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,OAAO,QAAQ,KAAK,SAAS,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;YAC9D,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CACpC,CAAC,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAC1D,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9E,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QACrC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC"}

package/dist/document-authoring/application/use-cases/build-documentation-catalog.d.ts

@@ -0,0 +1,23 @@
+import type { MarkdownRepository } from "../../../documentation-observation/application/ports/markdown-repository.js";
+import type { DocumentationCatalogSnapshot, DocumentationSearchCatalogSnapshot } from "../model/document-catalog.js";
+import type { DocumentationCatalogReadRequest, DocumentationSearchCatalogReader } from "../ports/documentation-search-catalog-reader.js";
+import type { AuthoringProfileReader } from "../ports/authoring-profile-reader.js";
+import type { MetadataInstanceValidator } from "../ports/metadata-instance-validator.js";
+import type { OwnerMembershipReader } from "../ports/owner-membership-reader.js";
+export interface BuildDocumentationCatalogRequest {
+    readonly consumerRoot: string;
+    readonly profilePath: string;
+    readonly signal?: AbortSignal;
+}
+export declare class BuildDocumentationCatalog implements DocumentationSearchCatalogReader {
+    #private;
+    constructor(dependencies: {
+        readonly metadata: MetadataInstanceValidator;
+        readonly owners: OwnerMembershipReader;
+        readonly profile: AuthoringProfileReader;
+        readonly repository: MarkdownRepository;
+    });
+    execute(request: BuildDocumentationCatalogRequest): Promise<DocumentationCatalogSnapshot>;
+    read(request: DocumentationCatalogReadRequest): Promise<DocumentationSearchCatalogSnapshot>;
+}
+//# sourceMappingURL=build-documentation-catalog.d.ts.map

package/dist/document-authoring/application/use-cases/build-documentation-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-documentation-catalog.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/build-documentation-catalog.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6EAA6E,CAAC;AACtH,OAAO,KAAK,EAAkH,4BAA4B,EAAE,kCAAkC,EAA6B,MAAM,8BAA8B,CAAC;AAChQ,OAAO,KAAK,EAAE,+BAA+B,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AACzI,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,qCAAqC,CAAC;AAW7C,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AA0TD,qBAAa,yBAA0B,YAAW,gCAAgC;;IAMhF,YAAY,YAAY,EAAE;QACxB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;QAC7C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;QACvC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;QACzC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;KACzC,EAKA;IAEK,OAAO,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAE9F;IAEK,IAAI,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAehG;CACF"}

package/dist/document-authoring/application/use-cases/build-documentation-catalog.js

@@ -0,0 +1,204 @@
+import { compareBinaryStrings } from "../../../binary-string-comparator.js";
+import {} from "../../../documentation-observation/application/model/markdown-document.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { catalogCollisionDiagnostics, catalogDiagnostic, catalogObservationDiagnostic, duplicateIdentityDiagnostics, sortCatalogDiagnostics } from "../policies/document-catalog-diagnostics.js";
+import { inspectCatalogDocument } from "../policies/inspect-catalog-document.js";
+const matchesPrefix = (path, prefix) => path === prefix || path.startsWith(`${prefix}/`);
+function collectionContainsPath(collection, repositoryPath) {
+    if (collection.kind === "markdown-tree") {
+        return matchesPrefix(repositoryPath, collection.root);
+    }
+    return (repositoryPath.split("/").at(-1) === "README.md" &&
+        collection.roots.some((root) => matchesPrefix(repositoryPath, root)));
+}
+function isCatalogDocumentPath(profile, repositoryPath) {
+    return profile.collections.some((collection) => collectionContainsPath(collection, repositoryPath));
+}
+function catalogDocumentSource(profile, repositoryPath) {
+    return profile.collections.some((collection) => collection.kind === "frontmatter-readme" &&
+        collectionContainsPath(collection, repositoryPath))
+        ? "frontmatter-readme"
+        : "markdown-tree";
+}
+function catalogObservation(observation, profile) {
+    const rootIssues = new Set(["root-missing", "root-not-directory"]);
+    return {
+        documents: observation.documents.filter((document) => isCatalogDocumentPath(profile, document.repositoryPath)),
+        issues: observation.issues.filter((issue) => rootIssues.has(issue.kind) ||
+            isCatalogDocumentPath(profile, issue.repositoryPath))
+    };
+}
+function sameObservation(left, right) {
+    if (left.documents.length !== right.documents.length ||
+        left.issues.length !== right.issues.length) {
+        return false;
+    }
+    for (const [index, document] of left.documents.entries()) {
+        const candidate = right.documents[index];
+        if (candidate === undefined ||
+            document.repositoryPath !== candidate.repositoryPath ||
+            document.source !== candidate.source) {
+            return false;
+        }
+    }
+    for (const [index, issue] of left.issues.entries()) {
+        const candidate = right.issues[index];
+        if (candidate === undefined ||
+            issue.kind !== candidate.kind ||
+            issue.message !== candidate.message ||
+            issue.repositoryPath !== candidate.repositoryPath) {
+            return false;
+        }
+    }
+    return true;
+}
+function sameEvidence(left, right) {
+    return (left.path === right.path &&
+        left.digest === right.digest &&
+        left.size === right.size);
+}
+function assertAuthorityStable(input) {
+    if (!sameEvidence(input.metadataBefore.evidence, input.metadataAfter.evidence) ||
+        !sameEvidence(input.ownersBefore.evidence, input.ownersAfter.evidence) ||
+        !sameEvidence(input.profileBefore.evidence, input.profileAfter.evidence)) {
+        throw new DocumentCatalogError("DOCUMENT_CATALOG_AUTHORITY_CHANGED", "Document catalog authority changed while the repository was observed.");
+    }
+}
+function repositoryRoots(profile) {
+    return Object.freeze([...new Set(profile.collections.flatMap((collection) => collection.kind === "markdown-tree" ? [collection.root] : collection.roots))].toSorted(compareBinaryStrings));
+}
+function signalOption(signal) {
+    return signal === undefined ? {} : { signal };
+}
+async function loadCatalogAuthority(dependencies, request) {
+    const profile = await dependencies.profile.read({
+        consumerRoot: request.consumerRoot,
+        path: request.profilePath,
+        ...signalOption(request.signal)
+    });
+    const [owners, metadata] = await Promise.all([
+        dependencies.owners.read({
+            consumerRoot: request.consumerRoot,
+            contract: profile.ownerCatalog.contract,
+            path: profile.ownerCatalog.path,
+            ...signalOption(request.signal)
+        }),
+        dependencies.metadata.load({
+            consumerRoot: request.consumerRoot,
+            path: profile.metadataSchemaPath,
+            ...signalOption(request.signal)
+        })
+    ]);
+    return { metadata, owners, profile };
+}
+async function observeCatalogTwice(repository, authority, request) {
+    const observationRequest = {
+        consumerRoot: request.consumerRoot,
+        excludedPrefixes: authority.profile.excludedPrefixes,
+        roots: repositoryRoots(authority.profile),
+        ...signalOption(request.signal)
+    };
+    const first = catalogObservation(await repository.observe(observationRequest), authority.profile);
+    const second = catalogObservation(await repository.observe(observationRequest), authority.profile);
+    return [first, second];
+}
+async function assertAuthorityRemainedStable(dependencies, request, before) {
+    let after;
+    try {
+        after = await loadCatalogAuthority(dependencies, request);
+    }
+    catch (error) {
+        if (error instanceof DocumentCatalogError) {
+            throw new DocumentCatalogError("DOCUMENT_CATALOG_AUTHORITY_CHANGED", "Document catalog authority became unavailable while the repository was observed.", { cause: error });
+        }
+        throw error;
+    }
+    assertAuthorityStable({
+        metadataAfter: after.metadata,
+        metadataBefore: before.metadata,
+        ownersAfter: after.owners,
+        ownersBefore: before.owners,
+        profileAfter: after.profile,
+        profileBefore: before.profile
+    });
+}
+function createCatalogSnapshot(authority, first, second) {
+    const diagnostics = second.issues.map(catalogObservationDiagnostic);
+    if (!sameObservation(first, second)) {
+        diagnostics.push(catalogDiagnostic("document.catalog.corpus-changed", authority.profile.projectId, "Documentation corpus changed between stable observation passes."));
+    }
+    const documents = [];
+    const searchDocuments = [];
+    const identityProjection = [];
+    const ownerIds = new Set(authority.owners.ids);
+    for (const document of second.documents) {
+        const inspected = inspectCatalogDocument(document, authority.metadata, ownerIds, catalogDocumentSource(authority.profile, document.repositoryPath));
+        if (inspected.descriptor !== undefined) {
+            documents.push(inspected.descriptor);
+        }
+        if (inspected.searchEntry !== undefined) {
+            searchDocuments.push(inspected.searchEntry);
+        }
+        if (inspected.identity !== undefined) {
+            identityProjection.push(inspected.identity);
+        }
+        if (inspected.diagnostic !== undefined) {
+            diagnostics.push(inspected.diagnostic);
+        }
+    }
+    const sortedIdentity = identityProjection.toSorted((left, right) => compareBinaryStrings(left.id, right.id) ||
+        compareBinaryStrings(left.repositoryPath, right.repositoryPath));
+    diagnostics.push(...duplicateIdentityDiagnostics(sortedIdentity));
+    diagnostics.push(...catalogCollisionDiagnostics([...new Set([
+            ...second.documents.map((document) => document.repositoryPath),
+            ...second.issues
+                .filter((issue) => !["root-missing", "root-not-directory"].includes(issue.kind))
+                .map((issue) => issue.repositoryPath)
+        ])]));
+    const sortedDiagnostics = sortCatalogDiagnostics(diagnostics);
+    const catalog = Object.freeze({
+        authority: Object.freeze({
+            metadataSchema: authority.metadata.evidence,
+            ownerCatalog: authority.owners.evidence,
+            profile: authority.profile.evidence
+        }),
+        diagnostics: Object.freeze(sortedDiagnostics),
+        documents: Object.freeze(documents.toSorted((left, right) => compareBinaryStrings(left.repositoryPath, right.repositoryPath))),
+        identityProjection: Object.freeze(sortedIdentity),
+        ownerIds: Object.freeze([...authority.owners.ids]),
+        projectId: authority.profile.projectId,
+        status: sortedDiagnostics.length === 0 ? "complete" : "partial"
+    });
+    return Object.freeze({
+        catalog,
+        documents: Object.freeze(searchDocuments.toSorted((left, right) => compareBinaryStrings(left.descriptor.repositoryPath, right.descriptor.repositoryPath)))
+    });
+}
+export class BuildDocumentationCatalog {
+    #metadata;
+    #owners;
+    #profile;
+    #repository;
+    constructor(dependencies) {
+        this.#metadata = dependencies.metadata;
+        this.#owners = dependencies.owners;
+        this.#profile = dependencies.profile;
+        this.#repository = dependencies.repository;
+    }
+    async execute(request) {
+        return (await this.read(request)).catalog;
+    }
+    async read(request) {
+        const dependencies = {
+            metadata: this.#metadata,
+            owners: this.#owners,
+            profile: this.#profile,
+            repository: this.#repository
+        };
+        const authority = await loadCatalogAuthority(dependencies, request);
+        const [first, second] = await observeCatalogTwice(this.#repository, authority, request);
+        await assertAuthorityRemainedStable(dependencies, request, authority);
+        return createCatalogSnapshot(authority, first, second);
+    }
+}
+//# sourceMappingURL=build-documentation-catalog.js.map

package/dist/document-authoring/application/use-cases/build-documentation-catalog.js.map

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

package/dist/document-authoring/application/use-cases/find-documents.d.ts

@@ -0,0 +1,14 @@
+import type { DocumentFindQuery, DocumentFindResult } from "../model/document-find.js";
+import type { DocumentationSearchCatalogReader } from "../ports/documentation-search-catalog-reader.js";
+export interface FindDocumentsRequest {
+    readonly consumerRoot: string;
+    readonly profilePath: string;
+    readonly query?: DocumentFindQuery;
+    readonly signal?: AbortSignal;
+}
+export declare class FindDocuments {
+    #private;
+    constructor(catalog: DocumentationSearchCatalogReader);
+    execute(request: FindDocumentsRequest): Promise<DocumentFindResult>;
+}
+//# sourceMappingURL=find-documents.d.ts.map

package/dist/document-authoring/application/use-cases/find-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-documents.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/find-documents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,iDAAiD,CAAC;AAOzD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAwHD,qBAAa,aAAa;;IAGxB,YAAY,OAAO,EAAE,gCAAgC,EAEpD;IAEK,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAQxE;CACF"}

package/dist/document-authoring/application/use-cases/find-documents.js

@@ -0,0 +1,95 @@
+import { compareBinaryStrings } from "../../../binary-string-comparator.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+const OPAQUE_ID = /^[A-Za-z0-9@][A-Za-z0-9@._/-]*$/u;
+const LOWER_ID = /^[a-z0-9][a-z0-9._/-]*$/u;
+const MAXIMUM_TEXT_LENGTH = 1_000;
+function invalidQuery(message) {
+    throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", `Document query is invalid: ${message}`);
+}
+function containsUnsafeCharacter(value) {
+    for (const character of value) {
+        const code = character.codePointAt(0) ?? 0;
+        if (code <= 0x1f ||
+            code === 0x7f ||
+            (code >= 0xd800 && code <= 0xdfff)) {
+            return true;
+        }
+    }
+    return false;
+}
+function validateFilter(value, name, maximumLength, pattern) {
+    if (value === undefined) {
+        return;
+    }
+    if (value.length === 0 ||
+        value.length > maximumLength ||
+        containsUnsafeCharacter(value) ||
+        !pattern.test(value)) {
+        invalidQuery(`${name} does not use the bounded document identifier grammar.`);
+    }
+}
+function compileDocumentFindQuery(query) {
+    const filters = query?.filters ?? {};
+    validateFilter(filters.id, "id", 214, OPAQUE_ID);
+    validateFilter(filters.owner, "owner", 214, OPAQUE_ID);
+    validateFilter(filters.status, "status", 160, LOWER_ID);
+    validateFilter(filters.type, "type", 160, LOWER_ID);
+    const text = query?.text;
+    if (text !== undefined &&
+        (text.length > MAXIMUM_TEXT_LENGTH || containsUnsafeCharacter(text))) {
+        invalidQuery("text must be a bounded Unicode string without control characters.");
+    }
+    return Object.freeze({
+        filters: Object.freeze({ ...filters }),
+        ...(text === undefined
+            ? {}
+            : { normalizedText: text.normalize("NFC").toLowerCase() })
+    });
+}
+function matchesFilters(entry, filters) {
+    const { descriptor } = entry;
+    return ((filters.id === undefined || descriptor.id === filters.id) &&
+        (filters.owner === undefined || descriptor.owner === filters.owner) &&
+        (filters.status === undefined || descriptor.status === filters.status) &&
+        (filters.type === undefined || descriptor.type === filters.type));
+}
+function normalizedSearchFields(entry) {
+    return [
+        entry.descriptor.id,
+        entry.descriptor.title,
+        entry.descriptor.summary,
+        ...entry.headings,
+        entry.body
+    ].map((value) => value.normalize("NFC").toLowerCase());
+}
+function findInSnapshot(snapshot, query) {
+    const documents = snapshot.documents
+        .filter((entry) => matchesFilters(entry, query.filters) &&
+        (query.normalizedText === undefined ||
+            normalizedSearchFields(entry).some((field) => field.includes(query.normalizedText ?? ""))))
+        .map((entry) => entry.descriptor)
+        .toSorted((left, right) => compareBinaryStrings(left.id, right.id) ||
+        compareBinaryStrings(left.repositoryPath, right.repositoryPath));
+    return Object.freeze({
+        catalogStatus: snapshot.catalog.status,
+        diagnostics: snapshot.catalog.diagnostics,
+        documents: Object.freeze(documents),
+        matches: documents.length
+    });
+}
+export class FindDocuments {
+    #catalog;
+    constructor(catalog) {
+        this.#catalog = catalog;
+    }
+    async execute(request) {
+        const query = compileDocumentFindQuery(request.query);
+        const snapshot = await this.#catalog.read({
+            consumerRoot: request.consumerRoot,
+            profilePath: request.profilePath,
+            ...(request.signal === undefined ? {} : { signal: request.signal })
+        });
+        return findInSnapshot(snapshot, query);
+    }
+}
+//# sourceMappingURL=find-documents.js.map

package/dist/document-authoring/application/use-cases/find-documents.js.map

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

package/dist/document-authoring/document-catalog-error.d.ts

@@ -0,0 +1,6 @@
+export type DocumentCatalogErrorCode = "DOCUMENT_CATALOG_AUTHORITY_CHANGED" | "DOCUMENT_CATALOG_AUTHORITY_UNAVAILABLE" | "DOCUMENT_CATALOG_INPUT_INVALID";
+export declare class DocumentCatalogError extends Error {
+    readonly code: DocumentCatalogErrorCode;
+    constructor(code: DocumentCatalogErrorCode, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=document-catalog-error.d.ts.map

package/dist/document-authoring/document-catalog-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog-error.d.ts","sourceRoot":"","sources":["../../src/document-authoring/document-catalog-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,oCAAoC,GACpC,wCAAwC,GACxC,gCAAgC,CAAC;AAErC,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IAExC,YACE,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAKvB;CACF"}

package/dist/document-authoring/document-catalog-error.js

@@ -0,0 +1,9 @@
+export class DocumentCatalogError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "DocumentCatalogError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=document-catalog-error.js.map

package/dist/document-authoring/document-catalog-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog-error.js","sourceRoot":"","sources":["../../src/document-authoring/document-catalog-error.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAA2B;IAExC,YACE,IAA8B,EAC9B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/document-authoring/find-command.d.ts

@@ -0,0 +1,37 @@
+import type { DocumentDescriptor } from "./application/model/document-catalog.js";
+import type { DocumentFindFilters, DocumentFindResult } from "./application/model/document-find.js";
+interface CommandDiagnostic {
+    readonly message: string;
+    readonly phase: "authority" | "input" | "query";
+    readonly ruleId: string;
+    readonly severity: "error" | "warning";
+    readonly subject: string;
+}
+interface DocumentFindEnvelope {
+    readonly command: "docs.find";
+    readonly diagnostics: readonly CommandDiagnostic[];
+    readonly outcome: "authority-stale" | "cancelled" | "execution-failure" | "invalid-input" | "partial" | "success";
+    readonly result: {
+        readonly documents: readonly DocumentDescriptor[];
+        readonly kind: "find";
+        readonly matches: number;
+    };
+    readonly schemaVersion: 1;
+}
+export interface DocumentFindCommandRequest {
+    readonly consumerRoot: string;
+    readonly filters: DocumentFindFilters;
+    readonly profilePath: string;
+    readonly signal?: AbortSignal;
+    readonly text?: string;
+}
+export interface DocumentFindCommandResult {
+    readonly envelope: DocumentFindEnvelope;
+    readonly exitCode: 0 | 1 | 2 | 3 | 130;
+}
+export declare function documentFindFailure(error: unknown): DocumentFindCommandResult;
+export declare function documentFindSuccess(result: DocumentFindResult): DocumentFindCommandResult;
+export declare function runDocumentFindCommand(request: DocumentFindCommandRequest): Promise<DocumentFindCommandResult>;
+export declare function renderDocumentFindText(result: DocumentFindCommandResult): string;
+export {};
+//# sourceMappingURL=find-command.d.ts.map

package/dist/document-authoring/find-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-command.d.ts","sourceRoot":"","sources":["../../src/document-authoring/find-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAO9C,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EACZ,iBAAiB,GACjB,WAAW,GACX,mBAAmB,GACnB,eAAe,GACf,SAAS,GACT,SAAS,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;CACxC;AAsDD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,yBAAyB,CA6F3B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GACzB,yBAAyB,CAW3B;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAepC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAuBhF"}