@agent-teams/document-authoring 0.0.0

package/dist/composition/node-document-planning.js

@@ -0,0 +1,99 @@
+import { FilesystemMarkdownRepository } from "../documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+import { installedDocumentAuthoringVersion } from "../package-version.js";
+import { installedDocumentAuthoringBuildIdentity } from "../installed-artifact-identity.js";
+import { CanonicalMarkdownError, YamlCanonicalDocumentRenderer } from "../adapters/canonical-markdown.js";
+import { NodeAuthoringProfileReaderV2 } from "../adapters/node/node-authoring-profile-reader-v2.js";
+import { NodeDocumentContractValidator } from "../adapters/node/node-document-contract-validator.js";
+import { NodeDocumentPlanningProfileReader } from "../adapters/node/node-document-planning-profile-reader.js";
+import { NodeDocumentPlanningStateReader } from "../adapters/node/node-document-planning-state-reader.js";
+import { NodeDocumentTemplateReader } from "../adapters/node/node-document-template-reader.js";
+import { NodeMetadataInstanceValidator } from "../adapters/node/node-metadata-instance-validator.js";
+import { NodeDocumentMetadataSidecarReader } from "../adapters/node/node-document-metadata-sidecar-reader.js";
+import { NodeOwnerMembershipReader } from "../adapters/node/node-owner-membership-reader.js";
+import { DocumentPlanningPolicyError } from "../application/policies/document-planning-policy-error.js";
+import { classifyDocumentLogicalPreimage, isDestinationCoveredByCatalog } from "../application/policies/document-logical-preimage.js";
+import { normalizeDocumentIntent } from "../application/policies/normalize-document-intent.js";
+import { resolveDocumentAuthoring, selectDocumentArtifact } from "../application/policies/resolve-document-authoring.js";
+import { BuildDocumentationCatalog, BuildDocumentationCatalogV2 } from "../application/use-cases/build-documentation-catalog.js";
+import { PlanDocumentationDocument } from "../application/use-cases/plan-documentation-document.js";
+import { DocumentPlanningError } from "../document-planning-error.js";
+import { describeDocumentAuthoringProfileV2, describeDocumentAuthoringProfileV3 } from "./describe-document-authoring-profile-v2.js";
+function planningPolicyFailure(error) {
+    const code = error.problem === "catalog-incomplete"
+        ? "DOCUMENT_PLANNING_CATALOG_PARTIAL"
+        : ["catalog-collision", "destination-conflict"].includes(error.problem)
+            ? "DOCUMENT_PLANNING_CONFLICT"
+            : "DOCUMENT_PLANNING_INPUT_INVALID";
+    throw new DocumentPlanningError(code, error.message, { cause: error });
+}
+/**
+ * Closed Node composition shared by public planning and Foundation-owned replay.
+ * This module is intentionally absent from the package export map.
+ */
+export async function planNodeDocumentationDocument(request) {
+    const catalogDependencies = {
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReaderV2(),
+        repository: new FilesystemMarkdownRepository(),
+        sidecar: new NodeDocumentMetadataSidecarReader()
+    };
+    const profileReader = new NodeDocumentPlanningProfileReader();
+    const catalogV1 = new BuildDocumentationCatalog(catalogDependencies);
+    const catalogV2 = new BuildDocumentationCatalogV2(catalogDependencies);
+    const catalog = {
+        async execute(input) {
+            const profile = await profileReader.read({
+                consumerRoot: input.consumerRoot,
+                path: input.profilePath,
+                ...(input.signal === undefined ? {} : { signal: input.signal })
+            });
+            return profile.schemaVersion === 2 || profile.schemaVersion === 3
+                ? catalogV2.execute(input)
+                : catalogV1.execute(input);
+        }
+    };
+    const [version, buildIdentity] = await Promise.all([
+        installedDocumentAuthoringVersion(),
+        installedDocumentAuthoringBuildIdentity()
+    ]);
+    const planner = new PlanDocumentationDocument({
+        catalog,
+        compiler: {
+            id: "@agent-teams/document-authoring",
+            version,
+            buildIdentity
+        },
+        contracts: new NodeDocumentContractValidator(),
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        policies: {
+            classifyDocumentLogicalPreimage,
+            isDestinationCoveredByCatalog,
+            normalizeDocumentIntent,
+            resolveDocumentAuthoring,
+            selectDocumentArtifact
+        },
+        profile: profileReader,
+        profileDescription: {
+            describeV2: describeDocumentAuthoringProfileV2,
+            describeV3: describeDocumentAuthoringProfileV3
+        },
+        renderer: new YamlCanonicalDocumentRenderer(),
+        state: new NodeDocumentPlanningStateReader(),
+        templates: new NodeDocumentTemplateReader()
+    });
+    try {
+        return await planner.execute(request);
+    }
+    catch (error) {
+        if (error instanceof DocumentPlanningPolicyError) {
+            planningPolicyFailure(error);
+        }
+        if (error instanceof CanonicalMarkdownError) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template authority is invalid: ${error.message}`, { cause: error });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=node-document-planning.js.map

package/dist/composition/node-document-planning.js.map

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

package/dist/composition/node-document-writing-private.d.ts

@@ -0,0 +1,15 @@
+import { type NodeDocumentPublisherOperations } from "../adapters/node/node-document-publisher.js";
+import type { DocumentReceiptContract as DocumentReceipt } from "../application/model/document-receipt.js";
+import { type ApplyDocumentPlanRequest } from "../application/use-cases/apply-document-plan.js";
+import type { DocumentTransactionFaultPoint } from "../application/use-cases/document-transaction-continuation.js";
+import { type RecoverDocumentTransactionRequest } from "../application/use-cases/recover-document-transaction.js";
+type NodeDocumentWritingFaultPoint = DocumentTransactionFaultPoint | Parameters<NonNullable<NodeDocumentPublisherOperations["faultInjector"]>>[0];
+type NodeDocumentWritingFaultInjector = (point: NodeDocumentWritingFaultPoint) => Promise<void> | void;
+export interface NodeDocumentWritingPrivateOperations {
+    readonly faultInjector?: NodeDocumentWritingFaultInjector;
+    readonly publisher?: Omit<NodeDocumentPublisherOperations, "faultInjector">;
+}
+export declare function applyNodeDocumentationPlanPrivately(request: ApplyDocumentPlanRequest, operations?: NodeDocumentWritingPrivateOperations): Promise<DocumentReceipt>;
+export declare function recoverNodeDocumentationTransactionPrivately(request: RecoverDocumentTransactionRequest, operations?: NodeDocumentWritingPrivateOperations): Promise<DocumentReceipt>;
+export {};
+//# sourceMappingURL=node-document-writing-private.d.ts.map

package/dist/composition/node-document-writing-private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-writing-private.d.ts","sourceRoot":"","sources":["../../src/composition/node-document-writing-private.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,6CAA6C,CAAC;AAKrD,OAAO,KAAK,EAAE,uBAAuB,IAAI,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3G,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAEV,6BAA6B,EAC9B,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,0DAA0D,CAAC;AAGlE,KAAK,6BAA6B,GAC9B,6BAA6B,GAC7B,UAAU,CAAC,WAAW,CAAC,+BAA+B,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjF,KAAK,gCAAgC,GAAG,CACtC,KAAK,EAAE,6BAA6B,KACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,gCAAgC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAC;CAC7E;AA+BD,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,wBAAwB,EACjC,UAAU,GAAE,oCAAyC,GACpD,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,4CAA4C,CAChE,OAAO,EAAE,iCAAiC,EAC1C,UAAU,GAAE,oCAAyC,GACpD,OAAO,CAAC,eAAe,CAAC,CAU1B"}

package/dist/composition/node-document-writing-private.js

@@ -0,0 +1,54 @@
+import { join } from "node:path";
+import { FOUNDATION_TRANSACTION_FILE, LOCAL_STATE_DIRECTORY } from "../state-contract.js";
+import { NodeDocumentContractValidator } from "../adapters/node/node-document-contract-validator.js";
+import { NodeDocumentFileState } from "../adapters/node/node-document-file-state.js";
+import { NodeDocumentJournalStore } from "../adapters/node/node-document-journal-store.js";
+import { NodeDocumentPublisher } from "../adapters/node/node-document-publisher.js";
+import { NodeDocumentParentMaterializerV2 } from "../adapters/node/node-document-parent-materializer.js";
+import { captureNodeRepositoryRootAuthority } from "../adapters/node/node-path-authority.js";
+import { createNodeDocumentTransactionCoordinator } from "../adapters/node/node-document-transaction-coordinator.js";
+import { applyDocumentPlan } from "../application/use-cases/apply-document-plan.js";
+import { recoverDocumentTransaction } from "../application/use-cases/recover-document-transaction.js";
+import { NodeDocumentAuthorityRecompiler } from "./node-document-authority-recompiler.js";
+function journalPath(consumerRoot) {
+    return join(consumerRoot, LOCAL_STATE_DIRECTORY, FOUNDATION_TRANSACTION_FILE);
+}
+async function canonicalConsumerRoot(consumerRoot) {
+    return (await captureNodeRepositoryRootAuthority(consumerRoot)).canonicalRoot;
+}
+function runtime(consumerRoot, operations) {
+    const faultInjector = operations.faultInjector;
+    return {
+        authority: new NodeDocumentAuthorityRecompiler(),
+        fileState: new NodeDocumentFileState(),
+        ...(faultInjector === undefined ? {} : { faultInjector }),
+        journal: new NodeDocumentJournalStore(journalPath(consumerRoot)),
+        parentMaterializer: new NodeDocumentParentMaterializerV2(),
+        publisher: new NodeDocumentPublisher({
+            ...operations.publisher,
+            ...(operations.faultInjector === undefined
+                ? {}
+                : { faultInjector: operations.faultInjector })
+        })
+    };
+}
+export async function applyNodeDocumentationPlanPrivately(request, operations = {}) {
+    const contractValidator = new NodeDocumentContractValidator();
+    const plan = await contractValidator.validatePlan(request.plan);
+    const consumerRoot = await canonicalConsumerRoot(request.consumerRoot);
+    const coordinator = await createNodeDocumentTransactionCoordinator(consumerRoot);
+    return applyDocumentPlan({ ...runtime(consumerRoot, operations), contractValidator, coordinator }, {
+        consumerRoot,
+        plan,
+        ...(request.signal === undefined ? {} : { signal: request.signal })
+    });
+}
+export async function recoverNodeDocumentationTransactionPrivately(request, operations = {}) {
+    const consumerRoot = await canonicalConsumerRoot(request.consumerRoot);
+    const coordinator = await createNodeDocumentTransactionCoordinator(consumerRoot);
+    return recoverDocumentTransaction({ ...runtime(consumerRoot, operations), coordinator }, {
+        consumerRoot,
+        ...(request.signal === undefined ? {} : { signal: request.signal })
+    });
+}
+//# sourceMappingURL=node-document-writing-private.js.map

package/dist/composition/node-document-writing-private.js.map

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

package/dist/composition/node-document-writing.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentReceiptContract as DocumentReceipt } from "../application/model/document-receipt.js";
+import type { ApplyDocumentPlanRequest } from "../application/use-cases/apply-document-plan.js";
+import type { RecoverDocumentTransactionRequest } from "../application/use-cases/recover-document-transaction.js";
+/** Closed Node composition for durable, create-only document publication. */
+export declare function applyNodeDocumentationPlan(request: ApplyDocumentPlanRequest): Promise<DocumentReceipt>;
+/** Closed Node composition for exact-version document transaction recovery. */
+export declare function recoverNodeDocumentationTransaction(request: RecoverDocumentTransactionRequest): Promise<DocumentReceipt>;
+//# sourceMappingURL=node-document-writing.d.ts.map

package/dist/composition/node-document-writing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-writing.d.ts","sourceRoot":"","sources":["../../src/composition/node-document-writing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,IAAI,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,0DAA0D,CAAC;AAMlH,6EAA6E;AAC7E,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED,+EAA+E;AAC/E,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,eAAe,CAAC,CAE1B"}

package/dist/composition/node-document-writing.js

@@ -0,0 +1,10 @@
+import { applyNodeDocumentationPlanPrivately, recoverNodeDocumentationTransactionPrivately } from "./node-document-writing-private.js";
+/** Closed Node composition for durable, create-only document publication. */
+export async function applyNodeDocumentationPlan(request) {
+    return applyNodeDocumentationPlanPrivately(request);
+}
+/** Closed Node composition for exact-version document transaction recovery. */
+export async function recoverNodeDocumentationTransaction(request) {
+    return recoverNodeDocumentationTransactionPrivately(request);
+}
+//# sourceMappingURL=node-document-writing.js.map

package/dist/composition/node-document-writing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-writing.js","sourceRoot":"","sources":["../../src/composition/node-document-writing.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mCAAmC,EACnC,4CAA4C,EAC7C,MAAM,oCAAoC,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAiC;IAEjC,OAAO,mCAAmC,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,OAA0C;IAE1C,OAAO,4CAA4C,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC"}

package/dist/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-catalog-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog-error.d.ts","sourceRoot":"","sources":["../src/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-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-catalog-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-catalog-error.js","sourceRoot":"","sources":["../src/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-planning-error.d.ts

@@ -0,0 +1,6 @@
+export type DocumentPlanningErrorCode = "DOCUMENT_PLANNING_AUTHORITY_CHANGED" | "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE" | "DOCUMENT_PLANNING_CATALOG_PARTIAL" | "DOCUMENT_PLANNING_CONFLICT" | "DOCUMENT_PLANNING_INPUT_INVALID" | "DOCUMENT_PLANNING_OUTPUT_INVALID" | "DOCUMENT_PLANNING_PARENT_UNAVAILABLE";
+export declare class DocumentPlanningError extends Error {
+    readonly code: DocumentPlanningErrorCode;
+    constructor(code: DocumentPlanningErrorCode, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=document-planning-error.d.ts.map

package/dist/document-planning-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-error.d.ts","sourceRoot":"","sources":["../src/document-planning-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GACjC,qCAAqC,GACrC,yCAAyC,GACzC,mCAAmC,GACnC,4BAA4B,GAC5B,iCAAiC,GACjC,kCAAkC,GAClC,sCAAsC,CAAC;AAE3C,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IAEzC,YACE,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAKvB;CACF"}

package/dist/document-planning-error.js

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

package/dist/document-planning-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-error.js","sourceRoot":"","sources":["../src/document-planning-error.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,CAA4B;IAEzC,YACE,IAA+B,EAC/B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,14 @@
+import type { MarkdownDocumentObservation } from "../../../application/model/markdown-document.js";
+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);
+    reset(): void;
+    read(context: FilesystemMarkdownRepositoryContext, absolutePath: string, signal?: AbortSignal): Promise<MarkdownDocumentObservation | undefined>;
+}
+//# sourceMappingURL=filesystem-markdown-document-reader.d.ts.map

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

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

@@ -0,0 +1,108 @@
+import { assertNotCancelled } from "../../../../strict-yaml.js";
+import { CapabilityInputError } from "../../../../capability-runtime.js";
+import { ContainedFileReadError } from "../../../../filesystem-path-safety.js";
+import { nodeFilesystemMarkdownOperations, throwMarkdownFilesystemUnavailable } from "./filesystem-markdown-filesystem.js";
+import { markdownRepositoryPath } from "./filesystem-markdown-paths.js";
+import { observeMarkdownDocument } from "./markdown-document-parser.js";
+export const MAX_MARKDOWN_BYTES = 4 * 1024 * 1024;
+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",
+        message,
+        phase: "documentation-observation",
+        retryable: false
+    });
+}
+function assertDocumentStructureWithinLimits(source) {
+    let lines = 1;
+    let referenceMarkers = 0;
+    for (const character of source) {
+        if (character === "\n") {
+            lines += 1;
+            if (lines > MAX_MARKDOWN_LINES) {
+                resourceLimit(`Markdown source exceeds ${MAX_MARKDOWN_LINES} lines.`);
+            }
+        }
+        else if (character === "[" || character === "<") {
+            referenceMarkers += 1;
+            if (referenceMarkers > MAX_MARKDOWN_REFERENCE_MARKERS) {
+                resourceLimit(`Markdown source exceeds ${MAX_MARKDOWN_REFERENCE_MARKERS} potential reference markers.`);
+            }
+        }
+    }
+}
+export class FilesystemMarkdownDocumentReader {
+    #cachedBytes = 0;
+    #documents = new Map();
+    #filesystem;
+    constructor(filesystem = nodeFilesystemMarkdownOperations) {
+        this.#filesystem = filesystem;
+    }
+    reset() {
+        this.#cachedBytes = 0;
+        this.#documents.clear();
+    }
+    async read(context, absolutePath, signal) {
+        assertNotCancelled(signal);
+        let source;
+        let sourceBytes;
+        try {
+            const bytes = await this.#filesystem.readContainedRegularFile({
+                candidate: absolutePath,
+                maxBytes: MAX_MARKDOWN_BYTES,
+                root: context.canonicalRoot
+            });
+            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;
+            }
+            throwMarkdownFilesystemUnavailable(error, "reading a Markdown source");
+        }
+        assertNotCancelled(signal);
+        const cached = this.#documents.get(absolutePath);
+        if (cached?.source === source) {
+            return cached;
+        }
+        assertDocumentStructureWithinLimits(source);
+        const previousBytes = cached === undefined
+            ? 0
+            : Buffer.byteLength(cached.source, "utf8");
+        const nextCachedBytes = this.#cachedBytes - previousBytes + sourceBytes;
+        const nextDocumentCount = this.#documents.size + (cached === undefined ? 1 : 0);
+        if (nextCachedBytes > MAX_CACHED_MARKDOWN_BYTES ||
+            nextDocumentCount > MAX_CACHED_MARKDOWN_DOCUMENTS) {
+            resourceLimit(`Markdown cache exceeds ${MAX_CACHED_MARKDOWN_DOCUMENTS} documents or ${MAX_CACHED_MARKDOWN_BYTES} bytes.`);
+        }
+        const document = observeMarkdownDocument(markdownRepositoryPath(context.canonicalRoot, absolutePath), source);
+        this.#cachedBytes = nextCachedBytes;
+        this.#documents.set(absolutePath, document);
+        return document;
+    }
+}
+//# sourceMappingURL=filesystem-markdown-document-reader.js.map

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

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

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

@@ -0,0 +1,14 @@
+import { lstat, readdir, realpath, stat } from "node:fs/promises";
+import { readContainedRegularFile } from "../../../../filesystem-path-safety.js";
+export interface FilesystemMarkdownOperations {
+    readonly lstat: typeof lstat;
+    readonly readContainedRegularFile: typeof readContainedRegularFile;
+    readonly readdir: typeof readdir;
+    readonly realpath: typeof realpath;
+    readonly stat: typeof stat;
+}
+export declare const nodeFilesystemMarkdownOperations: FilesystemMarkdownOperations;
+export declare function isMissingMarkdownFilesystemError(error: unknown): boolean;
+export declare function throwMarkdownFilesystemUnavailable(error: unknown, operation: string): never;
+export declare function markdownPathTraversesSymbolicLink(root: string, candidate: string, filesystem: FilesystemMarkdownOperations, signal?: AbortSignal): Promise<boolean>;
+//# sourceMappingURL=filesystem-markdown-filesystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-markdown-filesystem.d.ts","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIlE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAKjF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,QAAQ,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC;CAC5B;AAED,eAAO,MAAM,gCAAgC,EAAE,4BAM9C,CAAC;AAaF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGxE;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAa3F;AAED,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,4BAA4B,EACxC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

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

@@ -0,0 +1,61 @@
+import { lstat, readdir, realpath, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { CapabilityInputError } from "../../../../capability-runtime.js";
+import { readContainedRegularFile } from "../../../../filesystem-path-safety.js";
+import { assertNotCancelled } from "../../../../strict-yaml.js";
+const MISSING_FILESYSTEM_ERROR_CODES = new Set(["ENOENT", "ENOTDIR"]);
+export const nodeFilesystemMarkdownOperations = {
+    lstat,
+    readContainedRegularFile,
+    readdir,
+    realpath,
+    stat
+};
+function filesystemErrorCode(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string")
+        ? error.code
+        : undefined;
+}
+export function isMissingMarkdownFilesystemError(error) {
+    const code = filesystemErrorCode(error);
+    return code !== undefined && MISSING_FILESYSTEM_ERROR_CODES.has(code);
+}
+export function throwMarkdownFilesystemUnavailable(error, operation) {
+    if (error instanceof CapabilityInputError) {
+        throw error;
+    }
+    throw new CapabilityInputError({
+        code: "DOCUMENTATION_FILESYSTEM_UNAVAILABLE",
+        message: `Documentation filesystem is unavailable while ${operation}.`,
+        phase: "documentation-observation",
+        retryable: true
+    }, { cause: error });
+}
+export async function markdownPathTraversesSymbolicLink(root, candidate, filesystem, signal) {
+    const relation = relative(root, candidate);
+    let current = root;
+    for (const segment of relation.split(sep).filter((value) => value.length > 0)) {
+        assertNotCancelled(signal);
+        current = join(current, segment);
+        let metadata;
+        try {
+            metadata = await filesystem.lstat(current);
+        }
+        catch (error) {
+            assertNotCancelled(signal);
+            if (isMissingMarkdownFilesystemError(error)) {
+                return false;
+            }
+            throwMarkdownFilesystemUnavailable(error, "checking Markdown paths for symbolic links");
+        }
+        assertNotCancelled(signal);
+        if (metadata.isSymbolicLink()) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=filesystem-markdown-filesystem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-markdown-filesystem.js","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAUtE,MAAM,CAAC,MAAM,gCAAgC,GAAiC;IAC5E,KAAK;IACL,wBAAwB;IACxB,OAAO;IACP,QAAQ;IACR,IAAI;CACL,CAAC;AAEF,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAC/B;QACC,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,KAAc;IAC7D,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,IAAI,KAAK,SAAS,IAAI,8BAA8B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAc,EAAE,SAAiB;IAClF,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,oBAAoB,CAC5B;QACE,IAAI,EAAE,sCAAsC;QAC5C,OAAO,EAAE,iDAAiD,SAAS,GAAG;QACtE,KAAK,EAAE,2BAA2B;QAClC,SAAS,EAAE,IAAI;KAChB,EACD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,IAAY,EACZ,SAAiB,EACjB,UAAwC,EACxC,MAAoB;IAEpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9E,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC3B,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5C,OAAO,KAAK,CAAC;YACf,CAAC;YACD,kCAAkC,CAAC,KAAK,EAAE,4CAA4C,CAAC,CAAC;QAC1F,CAAC;QACD,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,8 @@
+import { type FilesystemMarkdownOperations } from "./filesystem-markdown-filesystem.js";
+export interface FilesystemMarkdownRepositoryContext {
+    readonly canonicalRoot: string;
+}
+export declare function createFilesystemMarkdownRepositoryContext(consumerRoot: string, filesystem?: FilesystemMarkdownOperations, signal?: AbortSignal): Promise<FilesystemMarkdownRepositoryContext>;
+export declare function markdownRepositoryPath(root: string, absolutePath: string): string;
+export declare function isWithinMarkdownRepository(root: string, candidate: string): boolean;
+//# sourceMappingURL=filesystem-markdown-paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-markdown-paths.d.ts","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-paths.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAC;AAE7C,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAsB,yCAAyC,CAC7D,YAAY,EAAE,MAAM,EACpB,UAAU,GAAE,4BAA+D,EAC3E,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mCAAmC,CAAC,CAiC9C;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAGT"}

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

@@ -0,0 +1,44 @@
+import { isAbsolute, relative, sep } from "node:path";
+import { CapabilityInputError } from "../../../../capability-runtime.js";
+import { assertNotCancelled } from "../../../../strict-yaml.js";
+import { isMissingMarkdownFilesystemError, nodeFilesystemMarkdownOperations, throwMarkdownFilesystemUnavailable } from "./filesystem-markdown-filesystem.js";
+export async function createFilesystemMarkdownRepositoryContext(consumerRoot, filesystem = nodeFilesystemMarkdownOperations, signal) {
+    assertNotCancelled(signal);
+    let canonicalRoot;
+    let metadata;
+    try {
+        canonicalRoot = await filesystem.realpath(consumerRoot);
+        assertNotCancelled(signal);
+        metadata = await filesystem.stat(canonicalRoot);
+    }
+    catch (error) {
+        assertNotCancelled(signal);
+        if (isMissingMarkdownFilesystemError(error)) {
+            throw new CapabilityInputError({
+                code: "DOCUMENTATION_CONSUMER_ROOT_MISSING",
+                message: "Consumer root must be an existing directory.",
+                phase: "documentation-observation",
+                retryable: false
+            }, { cause: error });
+        }
+        throwMarkdownFilesystemUnavailable(error, "accessing the consumer root");
+    }
+    assertNotCancelled(signal);
+    if (!metadata.isDirectory()) {
+        throw new CapabilityInputError({
+            code: "DOCUMENTATION_CONSUMER_ROOT_INVALID",
+            message: "Consumer root must be a directory.",
+            phase: "documentation-observation",
+            retryable: false
+        });
+    }
+    return { canonicalRoot };
+}
+export function markdownRepositoryPath(root, absolutePath) {
+    return relative(root, absolutePath).split(sep).join("/");
+}
+export function isWithinMarkdownRepository(root, candidate) {
+    const relation = relative(root, candidate);
+    return relation !== ".." && !relation.startsWith(`..${sep}`) && !isAbsolute(relation);
+}
+//# sourceMappingURL=filesystem-markdown-paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-markdown-paths.js","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,gCAAgC,EAChC,gCAAgC,EAChC,kCAAkC,EAEnC,MAAM,qCAAqC,CAAC;AAM7C,MAAM,CAAC,KAAK,UAAU,yCAAyC,CAC7D,YAAoB,EACpB,UAAU,GAAiC,gCAAgC,EAC3E,MAAoB;IAEpB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,aAAqB,CAAC;IAC1B,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxD,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,oBAAoB,CAC5B;gBACE,IAAI,EAAE,qCAAqC;gBAC3C,OAAO,EAAE,8CAA8C;gBACvD,KAAK,EAAE,2BAA2B;gBAClC,SAAS,EAAE,KAAK;aACjB,EACD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,kCAAkC,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;IAC3E,CAAC;IACD,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,oBAAoB,CAAC;YAC7B,IAAI,EAAE,qCAAqC;YAC3C,OAAO,EAAE,oCAAoC;YAC7C,KAAK,EAAE,2BAA2B;YAClC,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,YAAoB;IAEpB,OAAO,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,SAAiB;IAEjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACxF,CAAC"}

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-reference-resolver.d.ts

@@ -0,0 +1,6 @@
+import type { MarkdownReferenceResolution } from "../../../application/model/markdown-document.js";
+import type { ResolveMarkdownReferenceRequest } from "../../../application/ports/markdown-repository.js";
+import { FilesystemMarkdownDocumentReader } from "./filesystem-markdown-document-reader.js";
+import { type FilesystemMarkdownOperations } from "./filesystem-markdown-filesystem.js";
+export declare function resolveFilesystemMarkdownReference(request: ResolveMarkdownReferenceRequest, reader: FilesystemMarkdownDocumentReader, filesystem?: FilesystemMarkdownOperations): Promise<MarkdownReferenceResolution>;
+//# sourceMappingURL=filesystem-markdown-reference-resolver.d.ts.map

package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-reference-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-markdown-reference-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-reference-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AACnG,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,mDAAmD,CAAC;AACzG,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAKL,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAC;AAkN7C,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,+BAA+B,EACxC,MAAM,EAAE,gCAAgC,EACxC,UAAU,GAAE,4BAA+D,GAC1E,OAAO,CAAC,2BAA2B,CAAC,CA2CtC"}