@agent-teams/engineering-foundation 0.11.0 → 0.12.0

package/dist/document-authoring/find-command.js

@@ -0,0 +1,180 @@
+import { CapabilityInputError } from "../capability-runtime.js";
+import { FoundationError } from "../errors.js";
+import { DocumentCatalogError } from "./document-catalog-error.js";
+import { findDocumentationDocuments } from "./index.js";
+const MAXIMUM_DOCUMENTS = 2_048;
+const MAXIMUM_DIAGNOSTICS = 256;
+function diagnostic(source, phase) {
+    return Object.freeze({
+        message: source.message.slice(0, 1_000),
+        phase,
+        ruleId: source.ruleId,
+        severity: source.severity,
+        subject: source.subject.slice(0, 512)
+    });
+}
+function boundDiagnostics(sources) {
+    if (sources.length <= MAXIMUM_DIAGNOSTICS) {
+        return Object.freeze(sources.map((source) => diagnostic(source, "query")));
+    }
+    return Object.freeze([
+        ...sources
+            .slice(0, MAXIMUM_DIAGNOSTICS - 1)
+            .map((source) => diagnostic(source, "query")),
+        Object.freeze({
+            message: `Catalog returned ${sources.length} diagnostics; JSON output includes the first ${MAXIMUM_DIAGNOSTICS - 1}.`,
+            phase: "query",
+            ruleId: "document.query.diagnostics-truncated",
+            severity: "warning",
+            subject: "document.query"
+        })
+    ]);
+}
+function envelope(input) {
+    return Object.freeze({
+        schemaVersion: 1,
+        command: "docs.find",
+        outcome: input.outcome,
+        diagnostics: Object.freeze([...(input.diagnostics ?? [])]),
+        result: Object.freeze({
+            kind: "find",
+            matches: input.matches ?? 0,
+            documents: Object.freeze([...(input.documents ?? [])])
+        })
+    });
+}
+export function documentFindFailure(error) {
+    if (error instanceof CapabilityInputError &&
+        error.problem.code === "EXECUTION_CANCELLED") {
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.problem.message,
+                        phase: "query",
+                        ruleId: "document.query.cancelled",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: "cancelled"
+            }),
+            exitCode: 130
+        });
+    }
+    if (error instanceof CapabilityInputError) {
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.problem.message.slice(0, 1_000),
+                        phase: "input",
+                        ruleId: "document.query.invalid-input",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: "invalid-input"
+            }),
+            exitCode: 2
+        });
+    }
+    if (error instanceof DocumentCatalogError) {
+        const authorityStale = error.code === "DOCUMENT_CATALOG_AUTHORITY_CHANGED";
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.message.slice(0, 1_000),
+                        phase: authorityStale ? "authority" : "input",
+                        ruleId: authorityStale
+                            ? "document.query.authority-stale"
+                            : "document.query.invalid-input",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: authorityStale ? "authority-stale" : "invalid-input"
+            }),
+            exitCode: authorityStale ? 1 : 2
+        });
+    }
+    if (error instanceof FoundationError && error.code === "CONSUMER_INVALID") {
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.message.slice(0, 1_000),
+                        phase: "input",
+                        ruleId: "document.query.invalid-input",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: "invalid-input"
+            }),
+            exitCode: 2
+        });
+    }
+    return Object.freeze({
+        envelope: envelope({
+            diagnostics: [
+                Object.freeze({
+                    message: (error instanceof Error ? error.message : String(error)).slice(0, 1_000),
+                    phase: "query",
+                    ruleId: "document.query.execution-failure",
+                    severity: "error",
+                    subject: "document.query"
+                })
+            ],
+            outcome: "execution-failure"
+        }),
+        exitCode: 3
+    });
+}
+export function documentFindSuccess(result) {
+    const partial = result.catalogStatus === "partial";
+    return Object.freeze({
+        envelope: envelope({
+            diagnostics: boundDiagnostics(result.diagnostics),
+            documents: result.documents.slice(0, MAXIMUM_DOCUMENTS),
+            matches: result.matches,
+            outcome: partial ? "partial" : "success"
+        }),
+        exitCode: partial ? 1 : 0
+    });
+}
+export async function runDocumentFindCommand(request) {
+    try {
+        const result = await findDocumentationDocuments({
+            consumerRoot: request.consumerRoot,
+            profilePath: request.profilePath,
+            query: {
+                filters: request.filters,
+                ...(request.text === undefined ? {} : { text: request.text })
+            },
+            ...(request.signal === undefined ? {} : { signal: request.signal })
+        });
+        return documentFindSuccess(result);
+    }
+    catch (error) {
+        return documentFindFailure(error);
+    }
+}
+export function renderDocumentFindText(result) {
+    const lines = [
+        `Catalog: ${result.envelope.outcome}`,
+        `Matches: ${result.envelope.result.matches}`
+    ];
+    for (const document of result.envelope.result.documents) {
+        lines.push(`${document.id} [${document.type}/${document.status}] ${document.repositoryPath}`);
+    }
+    if (result.envelope.result.documents.length < result.envelope.result.matches) {
+        lines.push(`Showing: ${result.envelope.result.documents.length} of ${result.envelope.result.matches}`);
+    }
+    for (const entry of result.envelope.diagnostics) {
+        lines.push(`${entry.severity.toUpperCase()} ${entry.ruleId} ${entry.subject}: ${entry.message}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=find-command.js.map

package/dist/document-authoring/find-command.js.map

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

package/dist/document-authoring/index.d.ts

@@ -0,0 +1,12 @@
+import { type BuildDocumentationCatalogRequest } from "./application/use-cases/build-documentation-catalog.js";
+import { type FindDocumentsRequest } from "./application/use-cases/find-documents.js";
+export type { DocumentAuthorityDigest, DocumentAuthorityEvidence, DocumentDescriptor, DocumentIdentityProjectionEntry, DocumentationCatalogAuthority, DocumentationCatalogDiagnostic, DocumentationCatalogSnapshot, ReferencedDocumentProjection, ReferencedDocumentProjectionResult } from "./application/model/document-catalog.js";
+export type { DocumentFindFilters, DocumentFindQuery, DocumentFindResult } from "./application/model/document-find.js";
+export type { BuildDocumentationCatalogRequest } from "./application/use-cases/build-documentation-catalog.js";
+export type { FindDocumentsRequest } from "./application/use-cases/find-documents.js";
+export { projectReferencedDocuments } from "./application/projections/document-catalog-projections.js";
+export { DocumentCatalogError } from "./document-catalog-error.js";
+export type { DocumentCatalogErrorCode } from "./document-catalog-error.js";
+export declare function buildDocumentationCatalog(request: BuildDocumentationCatalogRequest): Promise<import("./application/model/document-catalog.js").DocumentationCatalogSnapshot>;
+export declare function findDocumentationDocuments(request: FindDocumentsRequest): Promise<import("./application/model/document-find.js").DocumentFindResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/document-authoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document-authoring/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AAEnD,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,kCAAkC,EACnC,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,gCAAgC,EAAE,MAAM,wDAAwD,CAAC;AAC/G,YAAY,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2DAA2D,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,2FAS1C;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,8EAQ7E"}

package/dist/document-authoring/index.js

@@ -0,0 +1,27 @@
+import { FilesystemMarkdownRepository } from "../documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+import { NodeAuthoringProfileReader } from "./adapters/node/node-authoring-profile-reader.js";
+import { NodeMetadataInstanceValidator } from "./adapters/node/node-metadata-instance-validator.js";
+import { NodeOwnerMembershipReader } from "./adapters/node/node-owner-membership-reader.js";
+import { BuildDocumentationCatalog } from "./application/use-cases/build-documentation-catalog.js";
+import { FindDocuments } from "./application/use-cases/find-documents.js";
+export { projectReferencedDocuments } from "./application/projections/document-catalog-projections.js";
+export { DocumentCatalogError } from "./document-catalog-error.js";
+export async function buildDocumentationCatalog(request) {
+    const builder = new BuildDocumentationCatalog({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReader(),
+        repository: new FilesystemMarkdownRepository()
+    });
+    return builder.execute(request);
+}
+export async function findDocumentationDocuments(request) {
+    const catalog = new BuildDocumentationCatalog({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReader(),
+        repository: new FilesystemMarkdownRepository()
+    });
+    return new FindDocuments(catalog).execute(request);
+}
+//# sourceMappingURL=index.js.map

package/dist/document-authoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/document-authoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,6FAA6F,CAAC;AAC3I,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAC9F,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EACL,yBAAyB,EAE1B,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,aAAa,EAEd,MAAM,2CAA2C,CAAC;AAoBnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,2DAA2D,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAyC;IAEzC,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC;QAC5C,QAAQ,EAAE,IAAI,6BAA6B,EAAE;QAC7C,MAAM,EAAE,IAAI,yBAAyB,EAAE;QACvC,OAAO,EAAE,IAAI,0BAA0B,EAAE;QACzC,UAAU,EAAE,IAAI,4BAA4B,EAAE;KAC/C,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAA6B;IAC5E,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC;QAC5C,QAAQ,EAAE,IAAI,6BAA6B,EAAE;QAC7C,MAAM,EAAE,IAAI,yBAAyB,EAAE;QACvC,OAAO,EAAE,IAAI,0BAA0B,EAAE;QACzC,UAAU,EAAE,IAAI,4BAA4B,EAAE;KAC/C,CAAC,CAAC;IACH,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/document-command.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArguments } from "./cli-arguments.js";
+export declare function runDocumentCommand(parsed: ParsedArguments, json: boolean): Promise<boolean>;
+//# sourceMappingURL=document-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-command.d.ts","sourceRoot":"","sources":["../src/document-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM1D,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CA0ClB"}

package/dist/document-command.js

@@ -0,0 +1,44 @@
+import { renderDocumentFindText, runDocumentFindCommand } from "./document-authoring/find-command.js";
+export async function runDocumentCommand(parsed, json) {
+    if (parsed.command !== "docs.find") {
+        return false;
+    }
+    const controller = new AbortController();
+    const cancel = () => {
+        controller.abort();
+    };
+    process.once("SIGINT", cancel);
+    process.once("SIGTERM", cancel);
+    try {
+        const result = await runDocumentFindCommand({
+            consumerRoot: parsed.consumerRoot,
+            filters: {
+                ...(parsed.documentId === undefined ? {} : { id: parsed.documentId }),
+                ...(parsed.documentOwner === undefined
+                    ? {}
+                    : { owner: parsed.documentOwner }),
+                ...(parsed.documentStatus === undefined
+                    ? {}
+                    : { status: parsed.documentStatus }),
+                ...(parsed.documentType === undefined
+                    ? {}
+                    : { type: parsed.documentType })
+            },
+            profilePath: parsed.documentProfilePath,
+            signal: controller.signal,
+            ...(parsed.positional[0] === undefined
+                ? {}
+                : { text: parsed.positional[0] })
+        });
+        process.stdout.write(json
+            ? `${JSON.stringify(result.envelope)}\n`
+            : renderDocumentFindText(result));
+        process.exitCode = result.exitCode;
+    }
+    finally {
+        process.removeListener("SIGINT", cancel);
+        process.removeListener("SIGTERM", cancel);
+    }
+    return true;
+}
+//# sourceMappingURL=document-command.js.map

package/dist/document-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-command.js","sourceRoot":"","sources":["../src/document-command.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAuB,EACvB,IAAa;IAEb,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,OAAO,EAAE;gBACP,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;gBACrE,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS;oBACpC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;gBACpC,GAAG,CAAC,MAAM,CAAC,cAAc,KAAK,SAAS;oBACrC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;gBACtC,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS;oBACnC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;aACnC;YACD,WAAW,EAAE,MAAM,CAAC,mBAAmB;YACvC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI;YACF,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI;YACxC,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,CACnC,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.d.ts

@@ -2,6 +2,9 @@ import type { MarkdownDocumentObservation } from "../../../application/model/mar
 import { type FilesystemMarkdownOperations } from "./filesystem-markdown-filesystem.js";
 import type { FilesystemMarkdownRepositoryContext } from "./filesystem-markdown-paths.js";
 export declare const MAX_MARKDOWN_BYTES: number;
+export declare class MarkdownSourceInvalidError extends Error {
+    constructor(message: string);
+}
 export declare class FilesystemMarkdownDocumentReader {
     #private;
     constructor(filesystem?: FilesystemMarkdownOperations);

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-markdown-document-reader.d.ts","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AACnG,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAC;AAI1F,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAmClD,qBAAa,gCAAgC;;IAK3C,YAAY,UAAU,GAAE,4BAA+D,EAEtF;IAED,KAAK,IAAI,IAAI,CAGZ;IAEK,IAAI,CACR,OAAO,EAAE,mCAAmC,EAC5C,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAgDlD;CACF"}
+{"version":3,"file":"filesystem-markdown-document-reader.d.ts","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AACnG,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAC;AAI1F,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAMlD,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAyCD,qBAAa,gCAAgC;;IAK3C,YAAY,UAAU,GAAE,4BAA+D,EAEtF;IAED,KAAK,IAAI,IAAI,CAGZ;IAEK,IAAI,CACR,OAAO,EAAE,mCAAmC,EAC5C,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAmDlD;CACF"}

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.js

@@ -9,6 +9,20 @@ const MAX_CACHED_MARKDOWN_BYTES = 64 * 1024 * 1024;
 const MAX_CACHED_MARKDOWN_DOCUMENTS = 10_000;
 const MAX_MARKDOWN_LINES = 50_000;
 const MAX_MARKDOWN_REFERENCE_MARKERS = 25_000;
+export class MarkdownSourceInvalidError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MarkdownSourceInvalidError";
+    }
+}
+function decodeMarkdownSource(bytes) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
+    }
+    catch {
+        throw new MarkdownSourceInvalidError("Markdown source must contain well-formed UTF-8.");
+    }
+}
 function resourceLimit(message) {
     throw new CapabilityInputError({
         code: "DOCUMENTATION_RESOURCE_LIMIT_EXCEEDED",
@@ -56,11 +70,14 @@ export class FilesystemMarkdownDocumentReader {
                 maxBytes: MAX_MARKDOWN_BYTES,
                 root: context.canonicalRoot
             });
-            source = bytes.toString("utf8");
+            source = decodeMarkdownSource(bytes);
             sourceBytes = bytes.byteLength;
         }
         catch (error) {
             assertNotCancelled(signal);
+            if (error instanceof MarkdownSourceInvalidError) {
+                throw error;
+            }
             if (error instanceof ContainedFileReadError &&
                 ["escape", "invalid", "missing", "symlink"].includes(error.failure)) {
                 return undefined;

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-markdown-document-reader.js","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filesystem-markdown-document-reader.js","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.ts"],"names":[],"mappings":"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"}

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-markdown-tree-observer.d.ts","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,6BAA6B,EAC9B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,mDAAmD,CAAC;AAC1G,OAAO,EACL,gCAAgC,EAEjC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAKL,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAC;AAwR7C,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,gCAAgC,EACzC,MAAM,EAAE,gCAAgC,EACxC,UAAU,GAAE,4BAA+D,GAC1E,OAAO,CAAC,6BAA6B,CAAC,CAqCxC"}
+{"version":3,"file":"filesystem-markdown-tree-observer.d.ts","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,6BAA6B,EAC9B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,mDAAmD,CAAC;AAC1G,OAAO,EACL,gCAAgC,EAGjC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAKL,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAC;AAsT7C,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,gCAAgC,EACzC,MAAM,EAAE,gCAAgC,EACxC,UAAU,GAAE,4BAA+D,GAC1E,OAAO,CAAC,6BAA6B,CAAC,CAsCxC"}

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.js

@@ -2,7 +2,7 @@ import { extname, resolve } from "node:path";
 import { compareBinaryStrings } from "../../../../binary-string-comparator.js";
 import { CapabilityInputError } from "../../../../capability-runtime.js";
 import { assertNotCancelled } from "../../../../strict-yaml.js";
-import { FilesystemMarkdownDocumentReader, MAX_MARKDOWN_BYTES } from "./filesystem-markdown-document-reader.js";
+import { FilesystemMarkdownDocumentReader, MarkdownSourceInvalidError, MAX_MARKDOWN_BYTES } from "./filesystem-markdown-document-reader.js";
 import { isMissingMarkdownFilesystemError, markdownPathTraversesSymbolicLink, nodeFilesystemMarkdownOperations, throwMarkdownFilesystemUnavailable } from "./filesystem-markdown-filesystem.js";
 import { createFilesystemMarkdownRepositoryContext, isWithinMarkdownRepository, markdownRepositoryPath } from "./filesystem-markdown-paths.js";
 const SKIPPED_DIRECTORY_NAMES = new Set([".git", "node_modules"]);
@@ -18,6 +18,12 @@ function resourceLimit(message) {
         retryable: false
     });
 }
+function matchesRepositoryPrefix(path, prefix) {
+    return path === prefix || path.startsWith(`${prefix}/`);
+}
+function isExcludedPath(walk, path) {
+    return walk.excludedPrefixes.some((prefix) => matchesRepositoryPrefix(path, prefix));
+}
 function addIssue(collector, issue) {
     if (collector.issues.length >= MAX_MARKDOWN_ISSUES) {
         resourceLimit(`Markdown observation exceeds ${MAX_MARKDOWN_ISSUES} issues.`);
@@ -27,6 +33,9 @@ function addIssue(collector, issue) {
 async function walkConfiguredRoot(walk, root) {
     const { collector, filesystem, repository: context, signal } = walk;
     const absoluteRoot = resolve(context.canonicalRoot, root);
+    if (isExcludedPath(walk, root)) {
+        return;
+    }
     if (!isWithinMarkdownRepository(context.canonicalRoot, absoluteRoot)) {
         addIssue(collector, {
             kind: "symbolic-link",
@@ -81,6 +90,9 @@ async function walkConfiguredRoot(walk, root) {
 async function inspectDirectoryEntry(walk, candidate) {
     const { collector, filesystem, reader, repository: context, signal } = walk;
     const candidateRepositoryPath = markdownRepositoryPath(context.canonicalRoot, candidate);
+    if (isExcludedPath(walk, candidateRepositoryPath)) {
+        return;
+    }
     if (collector.documents.has(candidateRepositoryPath)) {
         return;
     }
@@ -124,7 +136,21 @@ async function inspectDirectoryEntry(walk, candidate) {
         estimatedDocumentBytes > MAX_MARKDOWN_TOTAL_BYTES) {
         resourceLimit(`Markdown observation exceeds ${MAX_MARKDOWN_DOCUMENTS} documents or ${MAX_MARKDOWN_TOTAL_BYTES} bytes.`);
     }
-    const document = await reader.read(context, candidate, signal);
+    let document;
+    try {
+        document = await reader.read(context, candidate, signal);
+    }
+    catch (error) {
+        if (error instanceof MarkdownSourceInvalidError) {
+            addIssue(collector, {
+                kind: "source-invalid",
+                message: error.message,
+                repositoryPath: candidateRepositoryPath
+            });
+            return;
+        }
+        throw error;
+    }
     if (document === undefined) {
         try {
             await filesystem.lstat(candidate);
@@ -216,6 +242,7 @@ export async function observeFilesystemMarkdownTree(request, reader, filesystem
     };
     const walk = {
         collector,
+        excludedPrefixes: (request.excludedPrefixes ?? []).toSorted(compareBinaryStrings),
         filesystem,
         reader,
         repository: context,

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-markdown-tree-observer.js","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filesystem-markdown-tree-observer.js","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAOhE,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,kCAAkC,EAEnC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,yCAAyC,EACzC,0BAA0B,EAC1B,sBAAsB,EAEvB,MAAM,gCAAgC,CAAC;AAExC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AAClE,MAAM,sBAAsB,GAAG,MAAM,CAAC;AACtC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AACxC,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAUlD,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,IAAI,oBAAoB,CAAC;QAC7B,IAAI,EAAE,uCAAuC;QAC7C,OAAO;QACP,KAAK,EAAE,2BAA2B;QAClC,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAWD,SAAS,uBAAuB,CAAC,IAAY,EAAE,MAAc;IAC3D,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,IAA6B,EAAE,IAAY;IACjE,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3C,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,CACtC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CACf,SAA2C,EAC3C,KAA+B;IAE/B,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACnD,aAAa,CAAC,gCAAgC,mBAAmB,UAAU,CAAC,CAAC;IAC/E,CAAC;IACD,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,IAA6B,EAC7B,IAAY;IAEZ,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAI,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IACD,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE,CAAC;QACrE,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,2DAA2D;YACpE,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IACE,MAAM,iCAAiC,CACrC,OAAO,CAAC,aAAa,EACrB,YAAY,EACZ,UAAU,EACV,MAAM,CACP,EACD,CAAC;QACD,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,qDAAqD;YAC9D,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,QAAQ,CAAC,SAAS,EAAE;gBAClB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,0CAA0C;gBACnD,cAAc,EAAE,IAAI;aACrB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,kCAAkC,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAC;IACrF,CAAC;IACD,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,uDAAuD;YAChE,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,+CAA+C;YACxD,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,IAA6B,EAC7B,SAAiB;IAEjB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5E,MAAM,uBAAuB,GAAG,sBAAsB,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACzF,IAAI,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,EAAE,CAAC;QAClD,OAAO;IACT,CAAC;IACD,IAAI,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,kCAAkC,CAAC,KAAK,EAAE,oCAAoC,CAAC,CAAC;IAClF,CAAC;IACD,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,uDAAuD;YAChE,cAAc,EAAE,uBAAuB;SACxC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,MAAM,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;QACrE,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,GAAG,kBAAkB,EAAE,CAAC;QACvC,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,2BAA2B,kBAAkB,SAAS;YAC/D,cAAc,EAAE,uBAAuB;SACxC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,sBAAsB,GAAG,SAAS,CAAC,sBAAsB,GAAG,QAAQ,CAAC,IAAI,CAAC;IAChF,IACE,SAAS,CAAC,SAAS,CAAC,IAAI,IAAI,sBAAsB;QAClD,sBAAsB,GAAG,wBAAwB,EACjD,CAAC;QACD,aAAa,CACX,gCAAgC,sBAAsB,iBAAiB,wBAAwB,SAAS,CACzG,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,0BAA0B,EAAE,CAAC;YAChD,QAAQ,CAAC,SAAS,EAAE;gBAClB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,cAAc,EAAE,uBAAuB;aACxC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC3B,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5C,OAAO;YACT,CAAC;YACD,kCAAkC,CAAC,KAAK,EAAE,oCAAoC,CAAC,CAAC;QAClF,CAAC;QACD,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,oCAAoC;YAC7C,cAAc,EAAE,uBAAuB;SACxC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,iBAAiB,GACrB,SAAS,CAAC,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvE,IAAI,iBAAiB,GAAG,wBAAwB,EAAE,CAAC;QACjD,aAAa,CACX,gCAAgC,wBAAwB,+BAA+B,CACxF,CAAC;IACJ,CAAC;IACD,MAAM,kBAAkB,GACtB,SAAS,CAAC,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;IAC5D,IAAI,kBAAkB,GAAG,uBAAuB,EAAE,CAAC;QACjD,aAAa,CACX,gCAAgC,uBAAuB,cAAc,CACtE,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,aAAa,GAAG,iBAAiB,CAAC;IAC5C,SAAS,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAClD,SAAS,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;IAC1D,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,IAA6B,EAC7B,SAAiB,EACjB,cAAuB;IAEvB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/C,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,IACE,MAAM,iCAAiC,CACrC,IAAI,CAAC,UAAU,CAAC,aAAa,EAC7B,SAAS,EACT,UAAU,EACV,MAAM,CACP,EACD,CAAC;QACD,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,sEAAsE;YAC/E,cAAc,EAAE,sBAAsB,CACpC,IAAI,CAAC,UAAU,CAAC,aAAa,EAC7B,SAAS,CACV;SACF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,SAAS,EAAE;oBAClB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,0CAA0C;oBACnD,cAAc,EAAE,cAAc;iBAC/B,CAAC,CAAC;YACL,CAAC;YACD,OAAO;QACT,CAAC;QACD,kCAAkC,CAAC,KAAK,EAAE,qCAAqC,CAAC,CAAC;IACnF,CAAC;IACD,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,IACE,MAAM,iCAAiC,CACrC,IAAI,CAAC,UAAU,CAAC,aAAa,EAC7B,SAAS,EACT,UAAU,EACV,MAAM,CACP,EACD,CAAC;QACD,QAAQ,CAAC,SAAS,EAAE;YAClB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,uDAAuD;YAChE,cAAc,EAAE,sBAAsB,CACpC,IAAI,CAAC,UAAU,CAAC,aAAa,EAC7B,SAAS,CACV;SACF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnD,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC5C,EAAE,CAAC;QACF,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,qBAAqB,CACzB,IAAI,EACJ,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAC/B,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAAyC,EACzC,MAAwC,EACxC,UAAU,GAAiC,gCAAgC;IAE3E,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,OAAO,GAAG,MAAM,yCAAyC,CAC7D,OAAO,CAAC,YAAY,EACpB,UAAU,EACV,OAAO,CAAC,MAAM,CACf,CAAC;IACF,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,SAAS,GAAqC;QAClD,aAAa,EAAE,CAAC;QAChB,kBAAkB,EAAE,CAAC;QACrB,sBAAsB,EAAE,CAAC;QACzB,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,MAAM,EAAE,EAAE;KACX,CAAC;IACF,MAAM,IAAI,GAA4B;QACpC,SAAS;QACT,gBAAgB,EAAE,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QACjF,UAAU;QACV,MAAM;QACN,UAAU,EAAE,OAAO;QACnB,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KACpE,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC5C,MAAM,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpE,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAChE;QACD,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAChD,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC;YAC/D,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAC5C;KACF,CAAC;AACJ,CAAC"}

package/dist/documentation-observation/application/model/markdown-document.d.ts

@@ -39,7 +39,7 @@ export interface MarkdownDocumentObservation {
     readonly repositoryPath: string;
     readonly source: string;
 }
-type MarkdownObservationIssueKind = "root-missing" | "root-not-directory" | "source-too-large" | "source-unreadable" | "symbolic-link";
+type MarkdownObservationIssueKind = "root-missing" | "root-not-directory" | "source-invalid" | "source-too-large" | "source-unreadable" | "symbolic-link";
 export interface MarkdownObservationIssue {
     readonly kind: MarkdownObservationIssueKind;
     readonly message: string;

package/dist/documentation-observation/application/model/markdown-document.d.ts.map

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

package/dist/documentation-observation/application/model/markdown-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-document.js","sourceRoot":"","sources":["../../../../src/documentation-observation/application/model/markdown-document.ts"],"names":[],"mappings":"AA8FA,MAAM,UAAU,0BAA0B,CACxC,QAAqC,EACrC,OAA8B;IAE9B,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAAqC;IAErC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"markdown-document.js","sourceRoot":"","sources":["../../../../src/documentation-observation/application/model/markdown-document.ts"],"names":[],"mappings":"AA+FA,MAAM,UAAU,0BAA0B,CACxC,QAAqC,EACrC,OAA8B;IAE9B,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAAqC;IAErC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC"}

package/dist/documentation-observation/application/ports/markdown-repository.d.ts

@@ -1,6 +1,7 @@
 import type { MarkdownDocumentObservation, MarkdownReferenceResolution, MarkdownRepositoryObservation } from "../model/markdown-document.js";
 export interface ObserveMarkdownRepositoryRequest {
     readonly consumerRoot: string;
+    readonly excludedPrefixes?: readonly string[];
     readonly roots: readonly string[];
     readonly signal?: AbortSignal;
 }

package/dist/documentation-observation/application/ports/markdown-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-repository.d.ts","sourceRoot":"","sources":["../../../../src/documentation-observation/application/ports/markdown-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CACL,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC1C,gBAAgB,CACd,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC"}
+{"version":3,"file":"markdown-repository.d.ts","sourceRoot":"","sources":["../../../../src/documentation-observation/application/ports/markdown-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CACL,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC1C,gBAAgB,CACd,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC"}

package/dist/package-self-check.d.ts

@@ -1,5 +1,5 @@
 export declare const FOUNDATION_METADATA_SCHEMA_VERSION: 1;
-export declare const FOUNDATION_REQUIRED_ARTIFACT_PATHS: readonly ["dist/cli.js", "dist/index.d.ts", "dist/index.js", "dist/public-api-surface.d.ts", "dist/local-mode/index.d.ts", "dist/local-mode/index.js", "dist/scaffolding/index.d.ts", "dist/scaffolding/index.js", "presets/oxlint/base.json", "presets/oxlint/node.json", "presets/oxlint/type-aware.json", "presets/typescript/base.json", "presets/typescript/node.json", ...string[]];
+export declare const FOUNDATION_REQUIRED_ARTIFACT_PATHS: readonly ["dist/cli.js", "dist/index.d.ts", "dist/index.js", "dist/public-api-surface.d.ts", "dist/document-authoring/index.d.ts", "dist/document-authoring/index.js", "dist/local-mode/index.d.ts", "dist/local-mode/index.js", "dist/scaffolding/index.d.ts", "dist/scaffolding/index.js", "presets/oxlint/base.json", "presets/oxlint/node.json", "presets/oxlint/type-aware.json", "presets/typescript/base.json", "presets/typescript/node.json", ...string[]];
 export interface FoundationPackageSelfCheck {
     readonly ok: true;
     readonly metadataSchemaVersion: typeof FOUNDATION_METADATA_SCHEMA_VERSION;

package/dist/package-self-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-self-check.d.ts","sourceRoot":"","sources":["../src/package-self-check.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,kCAAkC,EAAG,CAAU,CAAC;AAC7D,eAAO,MAAM,kCAAkC,2XAerC,CAAC;AAEX,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,kCAAkC,CAAC;IAC1E,QAAQ,CAAC,WAAW,EAAE,qCAAqC,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,mCAAmC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE;AA8GD,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,0BAA0B,CAAC,CA8IrC;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,0BAA0B,CA0B5B"}
+{"version":3,"file":"package-self-check.d.ts","sourceRoot":"","sources":["../src/package-self-check.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,kCAAkC,EAAG,CAAU,CAAC;AAC7D,eAAO,MAAM,kCAAkC,qcAiBrC,CAAC;AAEX,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,kCAAkC,CAAC;IAC1E,QAAQ,CAAC,WAAW,EAAE,qCAAqC,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,mCAAmC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChE;AA6JD,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,0BAA0B,CAAC,CA8GrC;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,0BAA0B,CA0B5B"}