@agent-teams/document-authoring 0.0.0

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

@@ -0,0 +1,361 @@
+import { classifyDocumentRecovery } from "../policies/classify-document-recovery.js";
+import { completePublishedTransaction, continuePendingPublication, errorMessage, finalizeDocumentTransaction, isCancellation, materializeDocumentParentDirectories } from "./document-transaction-continuation.js";
+import { directoryReceiptEvidence, recoveryReceipt } from "./document-transaction-receipts.js";
+import { DocumentTransactionUseCaseError } from "./document-transaction-error.js";
+import { assertNonzeroDocumentPhysicalIdentity } from "../model/document-physical-identity.js";
+import { executeWithDocumentTransactionLease } from "./document-transaction-execution.js";
+function signalOption(signal) {
+    return signal === undefined ? {} : { signal };
+}
+function transactionFailure(error) {
+    if (error instanceof DocumentTransactionUseCaseError) {
+        return error;
+    }
+    return new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_INCONSISTENT", `Document recovery could not establish a truthful outcome: ${errorMessage(error)}`, { cause: error });
+}
+function nonzero(identity) {
+    return identity.birthtimeNs !== "0" && identity.dev !== "0" && identity.ino !== "0";
+}
+function sameIdentity(left, right) {
+    return left.birthtimeNs === right.birthtimeNs &&
+        left.dev === right.dev && left.ino === right.ino;
+}
+function destinationObservation(active, state) {
+    if (state.state !== "exact") {
+        return state;
+    }
+    if (!nonzero(state.identity)) {
+        return { identity: "zero-identity", state: "exact" };
+    }
+    if (active.envelope.state === "PUBLISHING") {
+        return {
+            identity: sameIdentity(state.identity, active.envelope.journal.ownedTemporary.identity)
+                ? "bound-temporary"
+                : "different",
+            state: "exact"
+        };
+    }
+    if (active.envelope.state === "PUBLISHED") {
+        return {
+            identity: sameIdentity(state.identity, active.envelope.journal.publicationIdentity)
+                ? "bound-publication"
+                : "different",
+            state: "exact"
+        };
+    }
+    return { identity: "unbound", state: "exact" };
+}
+function temporaryObservation(active, state, exactState) {
+    if (active.envelope.state !== "PUBLISHING") {
+        return state.state === "absent"
+            ? { state: "absent" }
+            : state.state === "unverifiable"
+                ? { state: "unverifiable" }
+                : nonzero(state.identity)
+                    ? { identity: "nonzero", state: "replaced" }
+                    : { state: "zero-identity" };
+    }
+    if (!nonzero(active.envelope.journal.ownedTemporary.identity)) {
+        return { state: "zero-identity" };
+    }
+    if (exactState?.state === "absent") {
+        return { state: "absent" };
+    }
+    if (exactState?.state === "owned-exact") {
+        return { identity: "nonzero", state: "exact" };
+    }
+    if (exactState?.state === "unverifiable") {
+        return { state: "unverifiable" };
+    }
+    return { identity: "nonzero", state: "replaced" };
+}
+async function observe(dependencies, request, active) {
+    const plan = active.envelope.journal.plan;
+    if (active.envelope.state === "MATERIALIZING") {
+        throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_INCONSISTENT", "Materializing recovery must be resumed before file publication observation.");
+    }
+    const [destination, derived] = await Promise.all([
+        dependencies.fileState.classifyDestination({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        }),
+        dependencies.fileState.classifyDerivedTemporary({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        })
+    ]);
+    const temporary = active.envelope.state === "PUBLISHING"
+        ? active.envelope.journal.ownedTemporary
+        : undefined;
+    const exactTemporary = temporary === undefined
+        ? undefined
+        : await dependencies.fileState.classifyTemporary({
+            consumerRoot: request.consumerRoot,
+            temporary,
+            ...signalOption(request.signal)
+        });
+    const journal = active.envelope.state === "PREPARED"
+        ? {
+            boundIdentity: "none",
+            fileIdentity: nonzero(active.authority.identity) ? "nonzero" : "zero-identity",
+            lifecycle: "PREPARED",
+            preparedState: active.envelope.journal.destination.state,
+            version: "v2"
+        }
+        : active.envelope.state === "PUBLISHING"
+            ? {
+                boundIdentity: nonzero(active.envelope.journal.ownedTemporary.identity)
+                    ? "temporary" : "zero-identity",
+                fileIdentity: nonzero(active.authority.identity) ? "nonzero" : "zero-identity",
+                lifecycle: "PUBLISHING",
+                version: "v2"
+            }
+            : {
+                boundIdentity: nonzero(active.envelope.journal.publicationIdentity)
+                    ? "publication" : "zero-identity",
+                fileIdentity: nonzero(active.authority.identity) ? "nonzero" : "zero-identity",
+                lifecycle: "PUBLISHED",
+                version: "v2"
+            };
+    return {
+        observation: {
+            destination: destinationObservation(active, destination),
+            journal,
+            temporary: temporaryObservation(active, derived, exactTemporary)
+        },
+        ...(temporary === undefined ? {} : { temporary })
+    };
+}
+async function readActiveJournal(dependencies) {
+    let stored;
+    try {
+        stored = await dependencies.journal.read();
+    }
+    catch (error) {
+        throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_EVIDENCE_UNAVAILABLE", "Document recovery evidence cannot be trusted; no Receipt can be bound safely.", { cause: error });
+    }
+    if (stored === undefined) {
+        throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_EVIDENCE_UNAVAILABLE", "Coordinator reported recovery but the trusted document journal is absent.");
+    }
+    return { authority: stored.authority, envelope: stored.envelope };
+}
+async function activeRecoveryReceipt(dependencies, request, active, options) {
+    let evidence = directoryReceiptEvidence(active.envelope);
+    if (active.envelope.schemaVersion === 4) {
+        try {
+            const inspection = await dependencies.parentMaterializer.inspect({
+                consumerRoot: request.consumerRoot,
+                journal: {
+                    anchorIdentity: active.envelope.journal.parentMaterialization.anchorIdentity,
+                    createdDirectories: active.envelope.journal.parentMaterialization.createdDirectories,
+                    plan: active.envelope.journal.plan.parentMaterialization,
+                    schemaVersion: 2
+                }
+            });
+            if (inspection.state !== "current") {
+                evidence = evidence === undefined ? undefined : {
+                    observedCreatedDirectories: evidence.observedCreatedDirectories,
+                    state: "preserved-unknown"
+                };
+            }
+        }
+        catch {
+            evidence = evidence === undefined ? undefined : {
+                observedCreatedDirectories: evidence.observedCreatedDirectories,
+                state: "preserved-unknown"
+            };
+        }
+    }
+    return recoveryReceipt(active.envelope.journal.plan, {
+        ...options,
+        ...(evidence === undefined ? {} : { directoryEvidence: evidence })
+    });
+}
+async function executeRecoveryDecision(dependencies, request, active, observed, action) {
+    switch (action) {
+        case "resume-prepare":
+            return continuePendingPublication(dependencies, request, active);
+        case "resume-publish":
+            if (observed.temporary === undefined) {
+                throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_INCONSISTENT", "Recovery classifier requested publication without a bound temporary.");
+            }
+            return continuePendingPublication(dependencies, request, active, observed.temporary);
+        case "complete-publication":
+            if (observed.temporary === undefined) {
+                throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_INCONSISTENT", "Recovery classifier requested completion without temporary evidence.");
+            }
+            return completePublishedTransaction(dependencies, request, active, observed.temporary, { authority: "persisted-plan" });
+        case "finalize-checks": {
+            assertNonzeroDocumentPhysicalIdentity(active.envelope.state === "PUBLISHED"
+                ? active.envelope.journal.publicationIdentity : undefined);
+            const finalized = await finalizeDocumentTransaction(dependencies, { consumerRoot: request.consumerRoot }, active, "applied", { authority: "persisted-plan" });
+            return finalized ?? activeRecoveryReceipt(dependencies, request, active, {
+                message: "Recovered publication failed stable final verification.",
+                publication: "published",
+                ruleId: "document.transaction.final-verification"
+            });
+        }
+        case "already-applied": {
+            const finalized = await finalizeDocumentTransaction(dependencies, request, active, "already-applied");
+            return finalized ?? activeRecoveryReceipt(dependencies, request, active, {
+                message: "Preexisting exact output failed stable final verification.",
+                publication: "none",
+                ruleId: "document.transaction.final-verification"
+            });
+        }
+    }
+}
+async function resumeV4ParentMaterialization(dependencies, request, active) {
+    if (active.envelope.schemaVersion !== 4 ||
+        (active.envelope.state !== "PREPARED" &&
+            active.envelope.state !== "MATERIALIZING")) {
+        return undefined;
+    }
+    const plan = active.envelope.journal.plan;
+    const authority = await dependencies.authority.assess({
+        consumerRoot: request.consumerRoot,
+        plan,
+        ...signalOption(request.signal)
+    });
+    request.signal?.throwIfAborted();
+    if (authority.state !== "current") {
+        return activeRecoveryReceipt(dependencies, request, active, {
+            message: authority.reason,
+            publication: "none",
+            ruleId: "document.transaction.recovery-authority"
+        });
+    }
+    if (active.envelope.state === "PREPARED" &&
+        active.envelope.journal.destination.state === "preexisting") {
+        const finalized = await finalizeDocumentTransaction(dependencies, request, active, "already-applied");
+        return finalized ?? activeRecoveryReceipt(dependencies, request, active, {
+            message: "Preexisting exact output failed stable final verification.",
+            publication: "none",
+            ruleId: "document.transaction.final-verification"
+        });
+    }
+    let current = active;
+    try {
+        current = await materializeDocumentParentDirectories(dependencies, request, active, (durable) => { current = durable; });
+    }
+    catch (error) {
+        return activeRecoveryReceipt(dependencies, request, current, {
+            manual: true,
+            message: `Directory materialization cannot resume safely: ${errorMessage(error)}`,
+            publication: "none",
+            ruleId: "document.transaction.directory-materialization"
+        });
+    }
+    const [destination, temporary] = await Promise.all([
+        dependencies.fileState.classifyDestination({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        }),
+        dependencies.fileState.classifyDerivedTemporary({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        })
+    ]);
+    request.signal?.throwIfAborted();
+    if (destination.state !== "absent" || temporary.state !== "absent") {
+        return activeRecoveryReceipt(dependencies, request, current, {
+            manual: true,
+            message: `Prepublication v4 evidence is not empty: destination=${destination.state}, temporary=${temporary.state}.`,
+            publication: destination.state === "exact" ? "unknown" : "none",
+            ruleId: "document.transaction.orphan-temporary"
+        });
+    }
+    return continuePendingPublication(dependencies, request, current);
+}
+async function runRecovery(dependencies, request) {
+    const active = await readActiveJournal(dependencies);
+    const plan = active.envelope.journal.plan;
+    const resumedMaterialization = await resumeV4ParentMaterialization(dependencies, request, active);
+    if (resumedMaterialization !== undefined) {
+        return resumedMaterialization;
+    }
+    if (active.envelope.schemaVersion === 4) {
+        const inspection = await dependencies.parentMaterializer.inspect({
+            consumerRoot: request.consumerRoot,
+            journal: {
+                anchorIdentity: active.envelope.journal.parentMaterialization.anchorIdentity,
+                createdDirectories: active.envelope.journal.parentMaterialization.createdDirectories,
+                plan: active.envelope.journal.plan.parentMaterialization,
+                schemaVersion: 2
+            }
+        });
+        if (inspection.state !== "current" || inspection.nextDirectory !== undefined) {
+            return activeRecoveryReceipt(dependencies, request, active, {
+                manual: true,
+                message: inspection.state === "current"
+                    ? "Directory materialization evidence is incomplete."
+                    : `Directory materialization evidence is unsafe: ${inspection.reason}.`,
+                publication: active.envelope.state === "PUBLISHED" ? "published" : "unknown",
+                ruleId: "document.transaction.directory-evidence"
+            });
+        }
+    }
+    const observed = await observe(dependencies, request, active);
+    // Read-only adapters may observe cancellation and still return a value.
+    // Recheck before interpreting evidence or entering any recovery mutation.
+    request.signal?.throwIfAborted();
+    const decision = classifyDocumentRecovery(observed.observation);
+    if (decision.action === "manual") {
+        return activeRecoveryReceipt(dependencies, request, active, {
+            manual: true,
+            message: `Automatic recovery is unsafe: ${decision.reason}.`,
+            publication: active.envelope.state === "PUBLISHED" ? "published" : "unknown",
+            ruleId: `document.transaction.${decision.reason}`
+        });
+    }
+    if (decision.action === "resume-prepare" || decision.action === "resume-publish" ||
+        decision.action === "already-applied") {
+        const authority = await dependencies.authority.assess({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        });
+        // Mutable profile authority is relevant only before publication. Once the
+        // identity-bound publication boundary is crossed, the exact-build journal
+        // and persisted Plan are the recovery authority.
+        request.signal?.throwIfAborted();
+        if (authority.state !== "current") {
+            return activeRecoveryReceipt(dependencies, request, active, {
+                message: authority.reason,
+                publication: "none",
+                ruleId: "document.transaction.recovery-authority"
+            });
+        }
+    }
+    return executeRecoveryDecision(dependencies, request, active, observed, decision.action);
+}
+async function executeRecovery(dependencies, request) {
+    try {
+        const value = await runRecovery(dependencies, request);
+        return {
+            retainTransactionBarrier: value.outcome !== "applied" &&
+                value.outcome !== "already-applied",
+            value
+        };
+    }
+    catch (error) {
+        const failure = isCancellation(error, request.signal)
+            ? error : transactionFailure(error);
+        throw failure;
+    }
+}
+/** Recovers only a current, strictly validated v3/v2 transaction. */
+export async function recoverDocumentTransaction(dependencies, request) {
+    const lease = await dependencies.coordinator.acquire({ mode: "recover" });
+    return executeWithDocumentTransactionLease(lease, async () => {
+        if (lease.status.state !== "recoverable") {
+            throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_COORDINATION_FAILED", "Document recovery requires a coordinator-qualified recoverable transaction.");
+        }
+        return executeRecovery(dependencies, request);
+    }, "Document recovery and transaction lease release both failed.");
+}
+//# sourceMappingURL=recover-document-transaction.js.map

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

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

package/dist/application/use-cases/run-document-doctor.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentCommandExecution, DocumentDoctorResult } from "../model/document-command.js";
+import type { DocumentTransactionInspection } from "../model/document-transaction-inspection.js";
+import type { DocumentEnvironmentInspector } from "../ports/document-environment-inspector.js";
+export interface RunDocumentDoctorRequest {
+    readonly consumerRoot: string;
+    readonly signal?: AbortSignal;
+}
+interface Dependencies {
+    readonly environment: DocumentEnvironmentInspector;
+    inspect(consumerRoot: string): Promise<DocumentTransactionInspection>;
+}
+export declare class RunDocumentDoctor {
+    #private;
+    constructor(dependencies: Dependencies);
+    execute(request: RunDocumentDoctorRequest): Promise<DocumentCommandExecution<DocumentDoctorResult>>;
+}
+export {};
+//# sourceMappingURL=run-document-doctor.d.ts.map

package/dist/application/use-cases/run-document-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-document-doctor.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/run-document-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,4CAA4C,CAAC;AAOpD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;CACvE;AAmFD,qBAAa,iBAAiB;;IAG5B,YAAY,YAAY,EAAE,YAAY,EAErC;IAEK,OAAO,CACX,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,wBAAwB,CAAC,oBAAoB,CAAC,CAAC,CAuGzD;CACF"}

package/dist/application/use-cases/run-document-doctor.js

@@ -0,0 +1,171 @@
+import { commandExecution, projectDocumentCommandFailure } from "../policies/document-command-projection.js";
+import { projectDocumentCommandConsumerRoot } from "../policies/document-command-consumer-root.js";
+function environmentResult(environment) {
+    return {
+        filesystem: environment.filesystem,
+        installedFoundationBuildIdentity: environment.installedFoundationBuildIdentity,
+        installedFoundationVersion: environment.installedFoundationVersion
+    };
+}
+function unsupportedDurabilityDiagnostic() {
+    return {
+        ruleId: "document.environment.strict-directory-durability-unsupported",
+        severity: "error",
+        phase: "authority",
+        subject: "filesystem.directory-durability",
+        message: "Strict directory durability is unsupported for this consumer repository; document publication is unavailable on this filesystem."
+    };
+}
+function inspectionDiagnostics(inspection, consumerRoot) {
+    if (inspection.state === "idle") {
+        return [];
+    }
+    return inspection.diagnostics.map((entry) => ({
+        ruleId: entry.code.toLowerCase().replaceAll("_", "."),
+        severity: "error",
+        phase: "recovery",
+        subject: "document.transaction",
+        message: entry.message,
+        ...(inspection.state === "recoverable"
+            ? { remediation: {
+                    commandId: "docs.recover",
+                    args: {
+                        consumerRoot: projectDocumentCommandConsumerRoot(consumerRoot),
+                        exactFoundationVersion: inspection.recovery.exactFoundationVersion,
+                        exactFoundationBuildIdentity: inspection.recovery.exactFoundationBuildIdentity
+                    }
+                } }
+            : inspection.recovery === undefined
+                ? {}
+                : { remediation: {
+                        commandId: inspection.recovery.commandId === "docs-recover"
+                            ? "docs.recover" : inspection.recovery.commandId,
+                        args: {
+                            ...inspection.recovery.args,
+                            consumerRoot: projectDocumentCommandConsumerRoot(consumerRoot)
+                        }
+                    } })
+    }));
+}
+function manualTransactionState(inspection) {
+    if (inspection.transactionKind !== undefined) {
+        return inspection.transactionKind;
+    }
+    if (inspection.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH")) {
+        return "version-mismatch";
+    }
+    switch (inspection.operationKind) {
+        case "document-authoring": return "document";
+        case "local-mode": return "local-mode";
+        case "scaffolding": return "scaffold";
+        case undefined: return "unknown";
+    }
+    return "unknown";
+}
+export class RunDocumentDoctor {
+    #dependencies;
+    constructor(dependencies) {
+        this.#dependencies = dependencies;
+    }
+    async execute(request) {
+        let environment;
+        try {
+            request.signal?.throwIfAborted();
+            environment = await this.#dependencies.environment.inspect(request.consumerRoot, request.signal);
+            const inspection = await this.#dependencies.inspect(request.consumerRoot);
+            request.signal?.throwIfAborted();
+            if (inspection.state === "idle") {
+                if (environment.filesystem.strictDirectoryDurability ===
+                    "platform-unsupported") {
+                    return commandExecution({
+                        command: "docs.doctor",
+                        diagnostics: [unsupportedDurabilityDiagnostic()],
+                        outcome: "violation",
+                        result: {
+                            kind: "doctor",
+                            ...environmentResult(environment),
+                            transactionState: "none",
+                            recoveryClass: "not-required"
+                        }
+                    });
+                }
+                return commandExecution({
+                    command: "docs.doctor", outcome: "success",
+                    result: {
+                        kind: "doctor", ...environmentResult(environment),
+                        transactionState: "none", recoveryClass: "not-required"
+                    }
+                });
+            }
+            if (inspection.state === "recoverable") {
+                return commandExecution({
+                    command: "docs.doctor",
+                    diagnostics: inspectionDiagnostics(inspection, request.consumerRoot),
+                    outcome: "recovery-required",
+                    result: {
+                        kind: "doctor", ...environmentResult(environment),
+                        transactionState: "document",
+                        protocolKind: "document-authoring",
+                        foundationVersion: inspection.foundationVersion,
+                        foundationBuildIdentity: inspection.foundationBuildIdentity,
+                        recoveryClass: "auto-recoverable",
+                        recoveryCommand: {
+                            commandId: "docs.recover",
+                            args: {
+                                consumerRoot: projectDocumentCommandConsumerRoot(request.consumerRoot),
+                                exactFoundationVersion: inspection.recovery.exactFoundationVersion,
+                                exactFoundationBuildIdentity: inspection.recovery.exactFoundationBuildIdentity
+                            }
+                        }
+                    }
+                });
+            }
+            const exactRecovery = inspection.recovery;
+            return commandExecution({
+                command: "docs.doctor",
+                diagnostics: inspectionDiagnostics(inspection, request.consumerRoot),
+                outcome: "recovery-required",
+                result: {
+                    kind: "doctor",
+                    ...environmentResult(environment),
+                    transactionState: manualTransactionState(inspection),
+                    ...(inspection.operationKind === "document-authoring" ||
+                        inspection.operationKind === "local-mode" ||
+                        inspection.operationKind === "scaffolding"
+                        ? { protocolKind: inspection.operationKind }
+                        : { protocolKind: "unknown" }),
+                    ...(inspection.foundationVersion === undefined
+                        ? {} : { foundationVersion: inspection.foundationVersion }),
+                    ...(inspection.foundationBuildIdentity === undefined
+                        ? {} : { foundationBuildIdentity: inspection.foundationBuildIdentity }),
+                    recoveryClass: "manual",
+                    ...(exactRecovery === undefined
+                        ? {}
+                        : { recoveryCommand: {
+                                commandId: exactRecovery.commandId === "docs-recover"
+                                    ? "docs.recover" : exactRecovery.commandId,
+                                args: {
+                                    ...exactRecovery.args,
+                                    consumerRoot: projectDocumentCommandConsumerRoot(request.consumerRoot)
+                                }
+                            } })
+                }
+            });
+        }
+        catch (error) {
+            const failure = projectDocumentCommandFailure({
+                command: "docs.doctor", error, phase: "recovery", subject: "document.transaction"
+            });
+            return commandExecution({
+                command: "docs.doctor", diagnostics: [failure.diagnostic], outcome: failure.outcome,
+                result: {
+                    kind: "doctor",
+                    ...(environment === undefined ? {} : environmentResult(environment)),
+                    transactionState: "unknown", protocolKind: "unknown",
+                    recoveryClass: "manual"
+                }
+            });
+        }
+    }
+}
+//# sourceMappingURL=run-document-doctor.js.map

package/dist/application/use-cases/run-document-doctor.js.map

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

package/dist/application/use-cases/run-document-new.d.ts

@@ -0,0 +1,30 @@
+import type { DocumentCommandExecution, DocumentNewResult } from "../model/document-command.js";
+import type { DocumentPlanContract as DocumentPlan } from "../model/document-planning.js";
+import type { DocumentReceiptContract as DocumentReceipt } from "../model/document-receipt.js";
+import type { DocumentTransactionInspection } from "../model/document-transaction-inspection.js";
+import type { DocumentReachabilityProjector } from "../ports/document-reachability-projector.js";
+import type { DocumentStructureVerifier } from "../ports/document-structure-verifier.js";
+import type { SimilarDocumentAdvisor } from "../ports/similar-document-advisor.js";
+import type { PlanDocumentationDocumentRequest } from "./plan-documentation-document.js";
+export interface RunDocumentNewRequest extends PlanDocumentationDocumentRequest {
+    readonly dryRun: boolean;
+}
+interface Dependencies {
+    apply(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentReceipt>;
+    inspect(consumerRoot: string): Promise<DocumentTransactionInspection>;
+    plan(request: PlanDocumentationDocumentRequest): Promise<DocumentPlan>;
+    readonly similar: SimilarDocumentAdvisor;
+    readonly reachability: DocumentReachabilityProjector;
+    readonly structure: DocumentStructureVerifier;
+}
+export declare class RunDocumentNew {
+    #private;
+    constructor(dependencies: Dependencies);
+    execute(request: RunDocumentNewRequest): Promise<DocumentCommandExecution<DocumentNewResult>>;
+}
+export {};
+//# sourceMappingURL=run-document-new.d.ts.map

package/dist/application/use-cases/run-document-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-document-new.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/run-document-new.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,IAAI,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,uBAAuB,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AASzF,MAAM,WAAW,qBAAsB,SAAQ,gCAAgC;IAC7E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,OAAO,EAAE;QACb,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C;AAiFD,qBAAa,cAAc;;IAGzB,YAAY,YAAY,EAAE,YAAY,EAErC;IAEK,OAAO,CACX,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,iBAAiB,CAAC,CAAC,CAkJtD;CACF"}