@agent-teams/engineering-foundation 0.14.0 → 0.16.0-rc.0

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

@@ -0,0 +1,59 @@
+import type { DocumentPlan } from "../model/document-planning.js";
+import type { DocumentReceipt } from "../model/document-receipt.js";
+import type { DocumentOwnedTemporary, DocumentTransactionEnvelope } from "../model/document-transaction.js";
+import type { DocumentAuthorityRecompiler } from "../ports/document-authority-recompiler.js";
+import type { DocumentFileState } from "../ports/document-file-state.js";
+import type { DocumentJournalStore, JournalAuthority } from "../ports/document-journal-store.js";
+import type { DocumentPublisher } from "../ports/document-publisher.js";
+import type { DocumentTransactionCoordinator } from "../ports/document-transaction-coordinator.js";
+import { DocumentJournalReconciliationError, removeJournalReconciled } from "./document-journal-reconciliation.js";
+export { DocumentJournalReconciliationError, removeJournalReconciled };
+export interface DocumentTransactionRuntime {
+    readonly authority: DocumentAuthorityRecompiler;
+    readonly fileState: DocumentFileState;
+    readonly faultInjector?: DocumentTransactionFaultInjector;
+    readonly journal: DocumentJournalStore;
+    readonly publisher: DocumentPublisher;
+    readonly coordinator: DocumentTransactionCoordinator;
+}
+export type DocumentTransactionFaultPoint = {
+    readonly phase: "after-prepared-journal-durable";
+} | {
+    readonly phase: "after-publishing-journal-durable";
+} | {
+    readonly phase: "after-published-journal-durable";
+} | {
+    readonly phase: "after-a1";
+} | {
+    readonly phase: "after-c1";
+} | {
+    readonly phase: "after-a2";
+} | {
+    readonly phase: "after-c2";
+} | {
+    readonly phase: "after-final-journal-removal-synced";
+};
+export type DocumentTransactionFaultInjector = (point: DocumentTransactionFaultPoint) => Promise<void> | void;
+export interface DocumentTransactionRequest {
+    readonly consumerRoot: string;
+    readonly signal?: AbortSignal;
+}
+export interface ActiveDocumentJournal {
+    readonly envelope: DocumentTransactionEnvelope;
+    readonly authority: JournalAuthority;
+}
+export declare function noPublicationReceipt(plan: DocumentPlan, outcome: "authority-stale" | "cancelled" | "failed-before-publication" | "rejected", ruleId: string, message: string, phase?: "apply" | "authority"): Promise<DocumentReceipt>;
+export declare function recoveryReceipt(plan: DocumentPlan, options: {
+    readonly manual?: boolean;
+    readonly message: string;
+    readonly publication: "none" | "published" | "unknown";
+    readonly ruleId: string;
+}): Promise<DocumentReceipt>;
+export declare function createPreparedJournal(runtime: DocumentTransactionRuntime, plan: DocumentPlan, destination: "pending" | "preexisting"): Promise<ActiveDocumentJournal>;
+/** Final A1-C1-A2-C2 observation and identity-fenced journal commit. */
+export declare function finalizeDocumentTransaction(runtime: DocumentTransactionRuntime, request: DocumentTransactionRequest, active: ActiveDocumentJournal, outcome: "already-applied" | "applied"): Promise<DocumentReceipt | undefined>;
+export declare function isCancellation(error: unknown, signal: AbortSignal | undefined): boolean;
+export declare function errorMessage(error: unknown): string;
+export declare function continuePendingPublication(runtime: DocumentTransactionRuntime, request: DocumentTransactionRequest, active: ActiveDocumentJournal, existingTemporary?: DocumentOwnedTemporary, onPublishingDurable?: () => void): Promise<DocumentReceipt>;
+export declare function completePublishedTransaction(runtime: DocumentTransactionRuntime, request: DocumentTransactionRequest, active: ActiveDocumentJournal, temporary: DocumentOwnedTemporary): Promise<DocumentReceipt>;
+//# sourceMappingURL=document-transaction-continuation.d.ts.map

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

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

package/dist/document-authoring/application/use-cases/document-transaction-continuation.js

@@ -0,0 +1,360 @@
+import { assertNonzeroDocumentPhysicalIdentity } from "../model/document-physical-identity.js";
+import { createDocumentReceipt } from "../policies/document-receipt-policy.js";
+import { createDocumentTransactionEnvelope } from "../policies/document-transaction-envelope-policy.js";
+import { createJournalReconciled, DocumentJournalReconciliationError, removeJournalReconciled, replaceJournalReconciled } from "./document-journal-reconciliation.js";
+export { DocumentJournalReconciliationError, removeJournalReconciled };
+function signalOption(signal) {
+    return signal === undefined ? {} : { signal };
+}
+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
+    };
+}
+async function successReceipt(plan, outcome) {
+    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, phase = "apply") {
+    return createDocumentReceipt({
+        ...receiptBase(plan),
+        commit: Object.freeze({
+            atomicity: "not-applicable",
+            publication: "none",
+            recoverability: "not-required",
+            state: "not-published"
+        }),
+        diagnostics: Object.freeze([diagnostic(phase, ruleId, message)]),
+        outcome
+    }, plan);
+}
+export async function recoveryReceipt(plan, options) {
+    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);
+}
+function envelopeBody(plan, lifecycle) {
+    const base = {
+        adapterContractVersion: 1,
+        foundation: Object.freeze({
+            buildIdentity: plan.compiler.buildIdentity,
+            version: plan.compiler.version
+        }),
+        operationKind: "document-authoring",
+        payloadKind: "document-authoring-journal/v2",
+        recoveryHandler: Object.freeze({
+            contractVersion: 2,
+            id: "foundation.document-authoring"
+        }),
+        schemaVersion: 3
+    };
+    if (lifecycle.state === "PREPARED") {
+        const journal = lifecycle.destination === "pending"
+            ? {
+                destination: { path: plan.destination, state: "pending" },
+                plan,
+                schemaVersion: 2
+            }
+            : {
+                destination: { path: plan.destination, state: "preexisting" },
+                plan,
+                schemaVersion: 2
+            };
+        return {
+            ...base,
+            journal,
+            state: lifecycle.state
+        };
+    }
+    if (lifecycle.state === "PUBLISHING") {
+        return {
+            ...base,
+            journal: {
+                destination: { path: plan.destination, state: "publishing" },
+                ownedTemporary: lifecycle.temporary,
+                plan,
+                schemaVersion: 2
+            },
+            state: lifecycle.state
+        };
+    }
+    return {
+        ...base,
+        journal: {
+            destination: { path: plan.destination, state: "published" },
+            plan,
+            publicationIdentity: lifecycle.publicationIdentity,
+            schemaVersion: 2
+        },
+        state: lifecycle.state
+    };
+}
+export async function createPreparedJournal(runtime, plan, destination) {
+    const envelope = await createDocumentTransactionEnvelope(envelopeBody(plan, { destination, state: "PREPARED" }));
+    const active = {
+        authority: await createJournalReconciled(runtime, envelope),
+        envelope
+    };
+    await runtime.faultInjector?.({ phase: "after-prepared-journal-durable" });
+    return active;
+}
+async function replaceWithPublishing(runtime, active, temporary) {
+    assertNonzeroDocumentPhysicalIdentity(temporary.identity);
+    const envelope = await createDocumentTransactionEnvelope(envelopeBody(active.envelope.journal.plan, {
+        state: "PUBLISHING",
+        temporary
+    }));
+    const result = {
+        authority: await replaceJournalReconciled(runtime, active, envelope),
+        envelope
+    };
+    await runtime.faultInjector?.({ phase: "after-publishing-journal-durable" });
+    return result;
+}
+async function replaceWithPublished(runtime, active, publicationIdentity) {
+    assertNonzeroDocumentPhysicalIdentity(publicationIdentity);
+    const envelope = await createDocumentTransactionEnvelope(envelopeBody(active.envelope.journal.plan, {
+        publicationIdentity,
+        state: "PUBLISHED"
+    }));
+    const result = {
+        authority: await replaceJournalReconciled(runtime, active, envelope),
+        envelope
+    };
+    await runtime.faultInjector?.({ phase: "after-published-journal-durable" });
+    return result;
+}
+async function exactCurrentAuthority(runtime, request, plan) {
+    const assessment = await runtime.authority.assess({
+        consumerRoot: request.consumerRoot,
+        plan,
+        ...signalOption(request.signal)
+    });
+    return assessment.state === "current"
+        ? { current: true }
+        : { current: false, reason: assessment.reason };
+}
+async function exactDestination(runtime, request, plan, expectedIdentity) {
+    const state = await runtime.fileState.classifyDestination({
+        consumerRoot: request.consumerRoot,
+        plan,
+        ...signalOption(request.signal)
+    });
+    if (state.state !== "exact") {
+        return { exact: false, reason: `Destination is ${state.state}.` };
+    }
+    if (expectedIdentity !== undefined &&
+        (state.identity.dev !== expectedIdentity.dev ||
+            state.identity.ino !== expectedIdentity.ino ||
+            state.identity.birthtimeNs !== expectedIdentity.birthtimeNs)) {
+        return { exact: false, reason: "Destination physical identity changed." };
+    }
+    return { exact: true };
+}
+/** Final A1-C1-A2-C2 observation and identity-fenced journal commit. */
+export async function finalizeDocumentTransaction(runtime, request, active, outcome) {
+    const plan = active.envelope.journal.plan;
+    const expectedIdentity = active.envelope.state === "PUBLISHED"
+        ? active.envelope.journal.publicationIdentity
+        : undefined;
+    const a1 = await exactCurrentAuthority(runtime, request, plan);
+    await runtime.faultInjector?.({ phase: "after-a1" });
+    if (!a1.current) {
+        return undefined;
+    }
+    const c1 = await exactDestination(runtime, request, plan, expectedIdentity);
+    await runtime.faultInjector?.({ phase: "after-c1" });
+    if (!c1.exact) {
+        return undefined;
+    }
+    const a2 = await exactCurrentAuthority(runtime, request, plan);
+    await runtime.faultInjector?.({ phase: "after-a2" });
+    if (!a2.current) {
+        return undefined;
+    }
+    const c2 = await exactDestination(runtime, request, plan, expectedIdentity);
+    await runtime.faultInjector?.({ phase: "after-c2" });
+    if (!c2.exact) {
+        return undefined;
+    }
+    await removeJournalReconciled(runtime, active);
+    await runtime.faultInjector?.({
+        phase: "after-final-journal-removal-synced"
+    });
+    return successReceipt(plan, outcome);
+}
+export function isCancellation(error, signal) {
+    return signal?.aborted === true ||
+        (error instanceof Error && error.name === "AbortError");
+}
+export function errorMessage(error) {
+    return error instanceof Error
+        ? error.message.slice(0, 1000)
+        : "Document transaction failed with an invalid error value.";
+}
+async function removeTemporaryIfPresent(runtime, request, temporary) {
+    const state = await runtime.fileState.classifyTemporary({
+        consumerRoot: request.consumerRoot,
+        temporary
+    });
+    if (state.state === "owned-exact") {
+        await runtime.publisher.removeOwnedTemporary({
+            consumerRoot: request.consumerRoot,
+            temporary
+        });
+    }
+    else if (state.state !== "absent") {
+        throw new Error("Owned temporary cannot be cleaned safely.");
+    }
+}
+export async function continuePendingPublication(runtime, request, active, existingTemporary, onPublishingDurable) {
+    const plan = active.envelope.journal.plan;
+    let current = active;
+    let temporary = existingTemporary;
+    if (temporary === undefined) {
+        temporary = await runtime.publisher.prepare({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        });
+    }
+    if (current.envelope.state === "PREPARED") {
+        current = await replaceWithPublishing(runtime, current, temporary);
+    }
+    onPublishingDurable?.();
+    const authority = await exactCurrentAuthority(runtime, request, plan);
+    if (!authority.current) {
+        return recoveryReceipt(plan, {
+            message: authority.reason,
+            publication: "none",
+            ruleId: "document.transaction.authority-stale"
+        });
+    }
+    const before = await runtime.fileState.classifyDestination({
+        consumerRoot: request.consumerRoot,
+        plan,
+        ...signalOption(request.signal)
+    });
+    if (before.state !== "absent") {
+        return recoveryReceipt(plan, {
+            manual: true,
+            message: `Publication precondition changed to ${before.state}.`,
+            publication: before.state === "exact" ? "unknown" : "none",
+            ruleId: "document.transaction.publication-precondition"
+        });
+    }
+    const publication = await runtime.publisher.publishPrepared({
+        consumerRoot: request.consumerRoot,
+        plan,
+        temporary,
+        ...signalOption(request.signal)
+    });
+    if (publication.outcome === "already-satisfied") {
+        const owned = publication.publicationIdentity.dev === temporary.identity.dev &&
+            publication.publicationIdentity.ino === temporary.identity.ino &&
+            publication.publicationIdentity.birthtimeNs === temporary.identity.birthtimeNs;
+        if (!owned) {
+            return recoveryReceipt(plan, {
+                manual: true,
+                message: "Destination became exact with a different physical identity.",
+                publication: "unknown",
+                ruleId: "document.transaction.concurrent-exact-publication"
+            });
+        }
+        return completePublishedTransaction(runtime, request, current, temporary);
+    }
+    // The publication boundary has been crossed. Cancellation is deliberately
+    // not forwarded to cleanup, verification, journaling, or final checks.
+    await removeTemporaryIfPresent(runtime, request, temporary);
+    current = await replaceWithPublished(runtime, current, publication.publicationIdentity);
+    const receipt = await finalizeDocumentTransaction(runtime, { consumerRoot: request.consumerRoot }, current, "applied");
+    return receipt ?? recoveryReceipt(plan, {
+        message: "Post-publication A1-C1-A2-C2 verification did not remain stable.",
+        publication: "published",
+        ruleId: "document.transaction.final-verification"
+    });
+}
+export async function completePublishedTransaction(runtime, request, active, temporary) {
+    const plan = active.envelope.journal.plan;
+    const completed = await runtime.publisher.completePublication({
+        consumerRoot: request.consumerRoot,
+        plan,
+        temporary
+    });
+    await removeTemporaryIfPresent(runtime, request, temporary);
+    const published = await replaceWithPublished(runtime, active, completed.publicationIdentity);
+    const receipt = await finalizeDocumentTransaction(runtime, { consumerRoot: request.consumerRoot }, published, "applied");
+    return receipt ?? recoveryReceipt(plan, {
+        message: "Recovered publication failed stable final verification.",
+        publication: "published",
+        ruleId: "document.transaction.final-verification"
+    });
+}
+//# sourceMappingURL=document-transaction-continuation.js.map

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

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

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

@@ -0,0 +1,5 @@
+export declare class DocumentTransactionUseCaseError extends Error {
+    readonly code: "DOCUMENT_TRANSACTION_COORDINATION_FAILED" | "DOCUMENT_TRANSACTION_EVIDENCE_UNAVAILABLE" | "DOCUMENT_TRANSACTION_INCONSISTENT";
+    constructor(code: "DOCUMENT_TRANSACTION_COORDINATION_FAILED" | "DOCUMENT_TRANSACTION_EVIDENCE_UNAVAILABLE" | "DOCUMENT_TRANSACTION_INCONSISTENT", message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=document-transaction-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-error.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/document-transaction-error.ts"],"names":[],"mappings":"AAAA,qBAAa,+BAAgC,SAAQ,KAAK;IAEtD,QAAQ,CAAC,IAAI,EACT,0CAA0C,GAC1C,2CAA2C,GAC3C,mCAAmC;IAJzC,YACW,IAAI,EACT,0CAA0C,GAC1C,2CAA2C,GAC3C,mCAAmC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF"}

package/dist/document-authoring/application/use-cases/document-transaction-error.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-error.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/document-transaction-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IAE7C,IAAI;IADf,YACW,IAG8B,EACvC,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAPf,IAAI;QAQb,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+import type { DocumentTransactionLease } from "../ports/document-transaction-coordinator.js";
+export interface DocumentTransactionExecution<T> {
+    readonly primaryFailure?: unknown;
+    readonly retainTransactionBarrier: boolean;
+    readonly value: T;
+}
+/** Releases a lease without allowing release control flow to replace the primary outcome. */
+export declare function executeWithDocumentTransactionLease<T>(lease: DocumentTransactionLease, operation: () => Promise<DocumentTransactionExecution<T>>, jointFailureMessage: string): Promise<T>;
+//# sourceMappingURL=document-transaction-execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-execution.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/document-transaction-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAE7F,MAAM,WAAW,4BAA4B,CAAC,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAqBD,6FAA6F;AAC7F,wBAAsB,mCAAmC,CAAC,CAAC,EACzD,KAAK,EAAE,wBAAwB,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,EACzD,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/document-authoring/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/document-authoring/application/use-cases/document-transaction-execution.js.map

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

@@ -0,0 +1,66 @@
+import type { DocumentIdentityProjectionEntry, DocumentationCatalogSnapshot } from "../model/document-catalog.js";
+import type { DocumentArtifactType, DocumentIntent, 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";
+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: DocumentationCatalogSnapshot;
+        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;
+}
+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 renderer: CanonicalDocumentRenderer;
+    readonly state: DocumentPlanningStateReader;
+    readonly templates: DocumentTemplateReader;
+}
+export declare class PlanDocumentationDocument {
+    #private;
+    constructor(dependencies: Dependencies);
+    execute(request: PlanDocumentationDocumentRequest): Promise<DocumentPlan>;
+}
+export {};
+//# sourceMappingURL=plan-documentation-document.d.ts.map

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

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