@agent-teams/document-authoring 0.0.0

package/dist/application/use-cases/document-transaction-execution.js

@@ -0,0 +1,40 @@
+async function settle(operation) {
+    try {
+        return { execution: await operation(), state: "fulfilled" };
+    }
+    catch (error) {
+        return { error, state: "rejected" };
+    }
+}
+function primaryFailure(settled) {
+    return settled.state === "rejected"
+        ? settled.error
+        : settled.execution.primaryFailure;
+}
+/** Releases a lease without allowing release control flow to replace the primary outcome. */
+export async function executeWithDocumentTransactionLease(lease, operation, jointFailureMessage) {
+    const settled = await settle(operation);
+    const retainTransactionBarrier = settled.state === "rejected" ||
+        settled.execution.retainTransactionBarrier;
+    let releaseFailure;
+    try {
+        await lease.release({ retainTransactionBarrier });
+    }
+    catch (error) {
+        releaseFailure = error;
+    }
+    const primary = primaryFailure(settled);
+    if (releaseFailure !== undefined && primary !== undefined) {
+        throw new AggregateError([primary, releaseFailure], jointFailureMessage, {
+            cause: primary
+        });
+    }
+    if (releaseFailure !== undefined) {
+        return Promise.reject(releaseFailure);
+    }
+    if (settled.state === "rejected") {
+        return Promise.reject(settled.error);
+    }
+    return settled.execution.value;
+}
+//# sourceMappingURL=document-transaction-execution.js.map

package/dist/application/use-cases/document-transaction-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-execution.js","sourceRoot":"","sources":["../../../src/application/use-cases/document-transaction-execution.ts"],"names":[],"mappings":"AAYA,KAAK,UAAU,MAAM,CAAI,SAAyD;IAEhF,IAAI,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAI,OAA4B;IACrD,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU;QACjC,CAAC,CAAC,OAAO,CAAC,KAAK;QACf,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC;AACvC,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,KAA+B,EAC/B,SAAyD,EACzD,mBAA2B;IAE3B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,wBAAwB,GAAG,OAAO,CAAC,KAAK,KAAK,UAAU;QAC3D,OAAO,CAAC,SAAS,CAAC,wBAAwB,CAAC;IAC7C,IAAI,cAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,cAAc,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1D,MAAM,IAAI,cAAc,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,mBAAmB,EAAE;YACvE,KAAK,EAAE,OAAO;SACf,CAAC,CAAC;IACL,CAAC;IACD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;AACjC,CAAC"}

package/dist/application/use-cases/document-transaction-receipts.d.ts

@@ -0,0 +1,21 @@
+import type { DocumentPlanContract as DocumentPlan } from "../model/document-planning.js";
+import type { DocumentReceiptContract as DocumentReceipt } from "../model/document-receipt.js";
+import type { DocumentTransactionEnvelope } from "../model/document-transaction.js";
+export interface DocumentDirectoryReceiptEvidence {
+    readonly observedCreatedDirectories: readonly string[];
+    readonly state: "none-created" | "created-and-retained" | "preserved-unknown";
+}
+export declare function directoryReceiptEvidence(envelope: DocumentTransactionEnvelope): DocumentDirectoryReceiptEvidence | undefined;
+export declare function successReceipt(plan: DocumentPlan, outcome: "already-applied" | "applied"): Promise<DocumentReceipt>;
+export declare function noPublicationReceipt(plan: DocumentPlan, outcome: "authority-stale" | "cancelled" | "failed-before-publication" | "rejected", ruleId: string, message: string, options?: {
+    readonly directoryEvidence?: DocumentDirectoryReceiptEvidence;
+    readonly phase?: "apply" | "authority";
+}): Promise<DocumentReceipt>;
+export declare function recoveryReceipt(plan: DocumentPlan, options: {
+    readonly directoryEvidence?: DocumentDirectoryReceiptEvidence;
+    readonly manual?: boolean;
+    readonly message: string;
+    readonly publication: "none" | "published" | "unknown";
+    readonly ruleId: string;
+}): Promise<DocumentReceipt>;
+//# sourceMappingURL=document-transaction-receipts.d.ts.map

package/dist/application/use-cases/document-transaction-receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-receipts.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/document-transaction-receipts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,IAAI,YAAY,EAAkB,MAAM,+BAA+B,CAAC;AAC1G,OAAO,KAAK,EAAE,uBAAuB,IAAI,eAAe,EAAuB,MAAM,8BAA8B,CAAC;AACpH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAGpF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,0BAA0B,EAAE,SAAS,MAAM,EAAE,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;CAC/E;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,2BAA2B,GACpC,gCAAgC,GAAG,SAAS,CAkB9C;AA0DD,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,iBAAiB,GAAG,SAAS,GACrC,OAAO,CAAC,eAAe,CAAC,CA8C1B;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,iBAAiB,GAAG,WAAW,GAAG,2BAA2B,GAAG,UAAU,EACnF,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CACnC,GACL,OAAO,CAAC,eAAe,CAAC,CA6B1B;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE;IACP,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,eAAe,CAAC,CAoD1B"}

package/dist/application/use-cases/document-transaction-receipts.js

@@ -0,0 +1,180 @@
+import { createDocumentReceipt } from "../policies/document-receipt-policy.js";
+export function directoryReceiptEvidence(envelope) {
+    if (envelope.schemaVersion !== 4) {
+        return undefined;
+    }
+    const materialization = envelope.journal.parentMaterialization;
+    const observedCreatedDirectories = Object.freeze(materialization.createdDirectories.map(({ path }) => path));
+    const pendingUnbound = materialization.pendingDirectory !== undefined &&
+        !observedCreatedDirectories.includes(materialization.pendingDirectory);
+    return Object.freeze({
+        observedCreatedDirectories,
+        state: pendingUnbound
+            ? "preserved-unknown"
+            : observedCreatedDirectories.length === 0
+                ? "none-created"
+                : "created-and-retained"
+    });
+}
+function diagnostic(phase, ruleId, message) {
+    return Object.freeze({
+        message: message.slice(0, 1000),
+        phase,
+        ruleId,
+        severity: "error",
+        subject: "document-transaction"
+    });
+}
+function receiptBase(plan) {
+    return {
+        adapter: Object.freeze({
+            contractVersion: 1,
+            id: "foundation.filesystem/v1"
+        }),
+        destination: plan.destination,
+        diagnostics: Object.freeze([]),
+        planDigest: plan.planDigest,
+        protocolVersion: 1,
+        schemaVersion: 1
+    };
+}
+function receiptBaseV2(plan, state, observedCreatedDirectories) {
+    if (state === "created-and-retained" && observedCreatedDirectories.length === 0) {
+        throw new TypeError("Created-and-retained directory evidence requires at least one observation.");
+    }
+    return {
+        adapter: Object.freeze({
+            contractVersion: 1,
+            id: "foundation.filesystem/v1"
+        }),
+        destination: plan.destination,
+        diagnostics: Object.freeze([]),
+        directoryMaterialization: Object.freeze({
+            observedCreatedDirectories: Object.freeze([...observedCreatedDirectories]),
+            plannedDirectories: plan.parentMaterialization.missingDirectories,
+            state
+        }),
+        planDigest: plan.planDigest,
+        protocolVersion: 2,
+        schemaVersion: 2
+    };
+}
+export async function successReceipt(plan, outcome) {
+    if (plan.schemaVersion === 2) {
+        const applied = outcome === "applied";
+        const created = applied && plan.parentMaterialization.missingDirectories.length > 0;
+        return createDocumentReceipt({
+            ...receiptBaseV2(plan, created ? "created-and-retained" : "none-created", created ? plan.parentMaterialization.missingDirectories : []),
+            commit: Object.freeze({
+                fileAtomicity: applied
+                    ? "single-file-atomic-create"
+                    : "not-applicable",
+                publication: applied ? "published" : "preexisting-exact",
+                recoverability: "not-required",
+                state: "committed"
+            }),
+            outcome,
+            resultDigest: plan.output.digest
+        }, plan);
+    }
+    if (outcome === "applied") {
+        return createDocumentReceipt({
+            ...receiptBase(plan),
+            commit: Object.freeze({
+                atomicity: "single-file-atomic-create",
+                publication: "published",
+                recoverability: "not-required",
+                state: "committed"
+            }),
+            outcome,
+            resultDigest: plan.output.digest
+        }, plan);
+    }
+    return createDocumentReceipt({
+        ...receiptBase(plan),
+        commit: Object.freeze({
+            atomicity: "not-applicable",
+            publication: "preexisting-exact",
+            recoverability: "not-required",
+            state: "committed"
+        }),
+        outcome,
+        resultDigest: plan.output.digest
+    }, plan);
+}
+export async function noPublicationReceipt(plan, outcome, ruleId, message, options = {}) {
+    if (plan.schemaVersion === 2) {
+        return createDocumentReceipt({
+            ...receiptBaseV2(plan, options.directoryEvidence?.state ?? "none-created", options.directoryEvidence?.observedCreatedDirectories ?? []),
+            commit: Object.freeze({
+                fileAtomicity: "not-applicable",
+                publication: "none",
+                recoverability: "not-required",
+                state: "not-published"
+            }),
+            diagnostics: Object.freeze([diagnostic(options.phase ?? "apply", ruleId, message)]),
+            outcome
+        }, plan);
+    }
+    return createDocumentReceipt({
+        ...receiptBase(plan),
+        commit: Object.freeze({
+            atomicity: "not-applicable",
+            publication: "none",
+            recoverability: "not-required",
+            state: "not-published"
+        }),
+        diagnostics: Object.freeze([diagnostic(options.phase ?? "apply", ruleId, message)]),
+        outcome
+    }, plan);
+}
+export async function recoveryReceipt(plan, options) {
+    if (plan.schemaVersion === 2) {
+        const state = options.manual === true
+            ? "manual-recovery-required"
+            : "recovery-required";
+        return createDocumentReceipt({
+            ...receiptBaseV2(plan, options.directoryEvidence?.state ?? "preserved-unknown", options.directoryEvidence?.observedCreatedDirectories ?? []),
+            commit: Object.freeze({
+                fileAtomicity: options.publication === "published"
+                    ? "single-file-atomic-create"
+                    : "not-applicable",
+                publication: options.publication,
+                recoverability: "preserved-for-recovery",
+                state
+            }),
+            diagnostics: Object.freeze([diagnostic("recovery", options.ruleId, options.message)]),
+            outcome: state
+        }, plan);
+    }
+    const common = {
+        ...receiptBase(plan),
+        diagnostics: Object.freeze([diagnostic("recovery", options.ruleId, options.message)])
+    };
+    const atomicity = options.publication === "published"
+        ? "single-file-atomic-create"
+        : "not-applicable";
+    if (options.manual === true) {
+        return createDocumentReceipt({
+            ...common,
+            commit: Object.freeze({
+                atomicity,
+                publication: options.publication,
+                recoverability: "preserved-for-recovery",
+                state: "manual-recovery-required"
+            }),
+            outcome: "manual-recovery-required"
+        }, plan);
+    }
+    return createDocumentReceipt({
+        ...common,
+        commit: Object.freeze({
+            atomicity,
+            publication: options.publication,
+            recoverability: "preserved-for-recovery",
+            state: "recovery-required"
+        }),
+        outcome: "recovery-required"
+    }, plan);
+}
+//# sourceMappingURL=document-transaction-receipts.js.map

package/dist/application/use-cases/document-transaction-receipts.js.map

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

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

@@ -0,0 +1,20 @@
+import type { DocumentFindQuery, DocumentFindResult, DocumentFindResultV2 } from "../model/document-find.js";
+import type { DocumentationSearchCatalogReader } from "../ports/documentation-search-catalog-reader.js";
+import type { DocumentationSearchCatalogReaderV2 } from "../ports/documentation-search-catalog-reader-v2.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>;
+}
+export declare class FindDocumentsV2 {
+    #private;
+    constructor(catalog: DocumentationSearchCatalogReaderV2);
+    execute(request: FindDocumentsRequest): Promise<DocumentFindResultV2>;
+}
+//# sourceMappingURL=find-documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-documents.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/find-documents.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,gCAAgC,EACjC,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,oDAAoD,CAAC;AAO7G,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;AAoID,qBAAa,aAAa;;IAGxB,YAAY,OAAO,EAAE,gCAAgC,EAEpD;IAEK,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAQxE;CACF;AAED,qBAAa,eAAe;;IAG1B,YAAY,OAAO,EAAE,kCAAkC,EAEtD;IAEK,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAY1E;CACF"}

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

@@ -0,0 +1,114 @@
+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);
+    }
+}
+export class FindDocumentsV2 {
+    #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 })
+        });
+        const result = findInSnapshot(snapshot, query);
+        return Object.freeze({
+            ...result,
+            catalogSemanticDigest: snapshot.catalog.semanticDigest
+        });
+    }
+}
+//# sourceMappingURL=find-documents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-documents.js","sourceRoot":"","sources":["../../../src/application/use-cases/find-documents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAiBzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,SAAS,GAAG,kCAAkC,CAAC;AACrD,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAC5C,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAclC,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,IAAI,oBAAoB,CAC5B,gCAAgC,EAChC,8BAA8B,OAAO,EAAE,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3C,IACE,IAAI,IAAI,IAAI;YACZ,IAAI,KAAK,IAAI;YACb,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,EAClC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CACrB,KAAyB,EACzB,IAAY,EACZ,aAAqB,EACrB,OAAe;IAEf,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,aAAa;QAC5B,uBAAuB,CAAC,KAAK,CAAC;QAC9B,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,YAAY,CAAC,GAAG,IAAI,wDAAwD,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAoC;IAEpC,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;IACrC,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACjD,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACvD,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxD,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC;IACzB,IACE,IAAI,KAAK,SAAS;QAClB,CAAC,IAAI,CAAC,MAAM,GAAG,mBAAmB,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC,EACpE,CAAC;QACD,YAAY,CAAC,mEAAmE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,KAAK,SAAS;YACpB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CACrB,KAAgC,EAChC,OAA4B;IAE5B,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAC7B,OAAO,CACL,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,UAAU,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;QAC1D,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC;QACnE,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;QACtE,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAgC;IAC9D,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,EAAE;QACnB,KAAK,CAAC,UAAU,CAAC,KAAK;QACtB,KAAK,CAAC,UAAU,CAAC,OAAO;QACxB,GAAG,KAAK,CAAC,QAAQ;QACjB,KAAK,CAAC,IAAI;KACX,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACzD,CAAC;AAYD,SAAS,cAAc,CACrB,QAAoC,EACpC,KAAgC;IAIhC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS;SACjC,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;QACpC,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS;YACjC,sBAAsB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3C,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAC3C,CAAC,CACP;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;SAChC,QAAQ,CACP,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;QACvC,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAClE,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;QACtC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW;QACzC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,OAAO,EAAE,SAAS,CAAC,MAAM;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,aAAa;IACf,QAAQ,CAAmC;IAEpD,YAAY,OAAyC;QACnD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA6B;QACzC,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACxC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACpE,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IACjB,QAAQ,CAAqC;IAEtD,YAAY,OAA2C;QACrD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA6B;QACzC,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAyC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC9E,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACpE,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,MAAM;YACT,qBAAqB,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc;SACvD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/application/use-cases/load-v2-profile-description.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentAuthoringProfileDescriptionV2, DocumentAuthoringProfileDescriptionV3 } from "../model/document-authoring-profile-description.js";
+import type { DocumentPlanningProfileSnapshot } from "../model/document-planning.js";
+export interface DocumentProfileDescriptionReader {
+    describeV2(request: {
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentAuthoringProfileDescriptionV2>;
+    describeV3(request: {
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentAuthoringProfileDescriptionV3>;
+}
+export declare function loadV2ProfileDescription(reader: DocumentProfileDescriptionReader | undefined, profile: DocumentPlanningProfileSnapshot, request: {
+    readonly consumerRoot: string;
+    readonly profilePath: string;
+    readonly signal?: AbortSignal;
+}): Promise<DocumentAuthoringProfileDescriptionV2 | DocumentAuthoringProfileDescriptionV3 | undefined>;
+//# sourceMappingURL=load-v2-profile-description.d.ts.map

package/dist/application/use-cases/load-v2-profile-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-v2-profile-description.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/load-v2-profile-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qCAAqC,EACrC,qCAAqC,EACtC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAGrF,MAAM,WAAW,gCAAgC;IAC/C,UAAU,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAAC;IACnD,UAAU,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAAC;CACpD;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,gCAAgC,GAAG,SAAS,EACpD,OAAO,EAAE,+BAA+B,EACxC,OAAO,EAAE;IACP,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,GACA,OAAO,CACN,qCAAqC,GACrC,qCAAqC,GACrC,SAAS,CACZ,CAcA"}

package/dist/application/use-cases/load-v2-profile-description.js

@@ -0,0 +1,14 @@
+import { DocumentPlanningError } from "../../document-planning-error.js";
+export async function loadV2ProfileDescription(reader, profile, request) {
+    if (profile.schemaVersion !== 2 && profile.schemaVersion !== 3) {
+        return undefined;
+    }
+    const description = profile.schemaVersion === 3
+        ? await reader?.describeV3(request)
+        : await reader?.describeV2(request);
+    if (description === undefined) {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", "Document Plan v2 requires a stable profile semantic description.");
+    }
+    return description;
+}
+//# sourceMappingURL=load-v2-profile-description.js.map

package/dist/application/use-cases/load-v2-profile-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-v2-profile-description.js","sourceRoot":"","sources":["../../../src/application/use-cases/load-v2-profile-description.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAezE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAoD,EACpD,OAAwC,EACxC,OAIC;IAMD,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,KAAK,CAAC;QAC7C,CAAC,CAAC,MAAM,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;QACnC,CAAC,CAAC,MAAM,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,qBAAqB,CAC7B,yCAAyC,EACzC,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/application/use-cases/plan-documentation-document.d.ts

@@ -0,0 +1,74 @@
+import type { DocumentIdentityProjectionEntry, DocumentationCatalogSnapshotContract } from "../model/document-catalog.js";
+import type { DocumentArtifactType, DocumentIntent, DocumentPlanContract as DocumentPlan, DocumentPlanningProfileSnapshot } from "../model/document-planning.js";
+import type { CanonicalDocumentRenderer } from "../ports/canonical-document-renderer.js";
+import type { DocumentContractValidator } from "../ports/document-contract-validator.js";
+import type { DocumentPlanningProfileReader } from "../ports/document-planning-profile-reader.js";
+import type { DocumentPlanningStateReader } from "../ports/document-planning-state-reader.js";
+import type { DocumentTemplateReader } from "../ports/document-template-reader.js";
+import type { DocumentationCatalogReader } from "../ports/documentation-catalog-reader.js";
+import type { MetadataInstanceValidator } from "../ports/metadata-instance-validator.js";
+import type { OwnerMembershipReader } from "../ports/owner-membership-reader.js";
+import { type DocumentProfileDescriptionReader } from "./load-v2-profile-description.js";
+interface ResolvedDocumentAuthoring {
+    readonly artifact: DocumentArtifactType;
+    readonly slug?: string;
+    readonly destination: string;
+    readonly heading: string;
+}
+interface DocumentLogicalPreimage {
+    readonly identityProjection: readonly DocumentIdentityProjectionEntry[];
+    readonly isExactSelf: boolean;
+}
+/**
+ * Closed pure policy surface consumed by the read-only orchestration use case.
+ * Implementations live in the policy layer; consumer code cannot supply it from
+ * the public composition root.
+ */
+interface DocumentPlanningPolicies {
+    normalizeDocumentIntent(input: DocumentIntent): DocumentIntent;
+    selectDocumentArtifact(profile: DocumentPlanningProfileSnapshot, type: string): DocumentArtifactType;
+    resolveDocumentAuthoring(input: {
+        readonly artifact: DocumentArtifactType;
+        readonly intent: DocumentIntent;
+    }): ResolvedDocumentAuthoring;
+    isDestinationCoveredByCatalog(destination: string, collections: DocumentPlanningProfileSnapshot["collections"], excludedPrefixes: readonly string[]): boolean;
+    classifyDocumentLogicalPreimage(input: {
+        readonly catalog: DocumentationCatalogSnapshotContract;
+        readonly id: string;
+        readonly destination: string;
+        readonly observedBytes?: Uint8Array;
+        readonly expectedBytes: Uint8Array;
+    }): DocumentLogicalPreimage;
+}
+export interface PlanDocumentationDocumentRequest {
+    readonly consumerRoot: string;
+    readonly profilePath: string;
+    readonly intent: unknown;
+    readonly signal?: AbortSignal;
+}
+export interface PlanDocumentationDocumentRequestV2 extends PlanDocumentationDocumentRequest {
+    readonly parentPolicy: "create-missing-real-directories";
+}
+export type PlanDocumentationDocumentRequestContract = PlanDocumentationDocumentRequest & {
+    readonly parentPolicy?: "create-missing-real-directories";
+};
+interface Dependencies {
+    readonly catalog: DocumentationCatalogReader;
+    readonly compiler: DocumentPlan["compiler"];
+    readonly contracts: DocumentContractValidator;
+    readonly metadata: MetadataInstanceValidator;
+    readonly owners: OwnerMembershipReader;
+    readonly policies: DocumentPlanningPolicies;
+    readonly profile: DocumentPlanningProfileReader;
+    readonly profileDescription?: DocumentProfileDescriptionReader;
+    readonly renderer: CanonicalDocumentRenderer;
+    readonly state: DocumentPlanningStateReader;
+    readonly templates: DocumentTemplateReader;
+}
+export declare class PlanDocumentationDocument {
+    #private;
+    constructor(dependencies: Dependencies);
+    execute(request: PlanDocumentationDocumentRequestContract): Promise<DocumentPlan>;
+}
+export {};
+//# sourceMappingURL=plan-documentation-document.d.ts.map

package/dist/application/use-cases/plan-documentation-document.d.ts.map

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