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

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

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

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

@@ -0,0 +1,30 @@
+import type { DocumentCommandExecution, DocumentNewResult } from "../model/document-command.js";
+import type { DocumentPlan } from "../model/document-planning.js";
+import type { DocumentReceipt } from "../model/document-receipt.js";
+import type { DocumentTransactionInspectionV1 } 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<DocumentTransactionInspectionV1>;
+    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/document-authoring/application/use-cases/run-document-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-document-new.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/run-document-new.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AACnG,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,+BAA+B,CAAC,CAAC;IACxE,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"}

package/dist/document-authoring/application/use-cases/run-document-new.js

@@ -0,0 +1,221 @@
+import { commandExecution, projectDocumentCommandFailure, receiptOutcome } from "../policies/document-command-projection.js";
+import { projectSimilarDocumentAdvice } from "../policies/project-similar-document-advice.js";
+import { projectDocumentCommandConsumerRoot } from "../policies/document-command-consumer-root.js";
+function signalOption(signal) {
+    return signal === undefined ? {} : { signal };
+}
+function transactionDiagnostic(inspection, consumerRoot) {
+    const recovery = inspection.state === "recoverable"
+        ? {
+            commandId: "docs.recover",
+            args: {
+                consumerRoot: projectDocumentCommandConsumerRoot(consumerRoot),
+                exactFoundationVersion: inspection.recovery.exactFoundationVersion,
+                exactFoundationBuildIdentity: inspection.recovery.exactFoundationBuildIdentity
+            }
+        }
+        : inspection.recovery === undefined
+            ? undefined
+            : {
+                commandId: inspection.recovery.commandId === "docs-recover"
+                    ? "docs.recover" : inspection.recovery.commandId,
+                args: {
+                    ...inspection.recovery.args,
+                    consumerRoot: projectDocumentCommandConsumerRoot(consumerRoot)
+                },
+            };
+    return {
+        ruleId: "document.new.transaction-active",
+        severity: "error",
+        phase: "recovery",
+        subject: "document.transaction",
+        message: inspection.state === "recoverable"
+            ? "A recoverable Foundation document transaction must be completed first."
+            : inspection.reason,
+        ...(recovery === undefined ? {} : { remediation: recovery }),
+    };
+}
+function receiptDiagnostics(receipt, consumerRoot) {
+    return receipt.diagnostics.map((entry) => ({
+        ...entry,
+        ...(receipt.outcome === "recovery-required"
+            ? { remediation: {
+                    commandId: "docs.recover",
+                    args: { consumerRoot: projectDocumentCommandConsumerRoot(consumerRoot) }
+                } }
+            : receipt.outcome === "manual-recovery-required"
+                ? { remediation: {
+                        commandId: "docs.doctor",
+                        args: { consumerRoot: projectDocumentCommandConsumerRoot(consumerRoot) }
+                    } }
+                : {})
+    }));
+}
+async function similarDocumentDiagnostics(input) {
+    try {
+        const advice = await input.dependencies.similar.advise({
+            consumerRoot: input.consumerRoot,
+            profilePath: input.plan.authority.profile.path,
+            title: input.plan.intent.title,
+            ...signalOption(input.signal),
+        });
+        return projectSimilarDocumentAdvice(advice);
+    }
+    catch (error) {
+        input.signal?.throwIfAborted();
+        throw error;
+    }
+}
+export class RunDocumentNew {
+    #dependencies;
+    constructor(dependencies) {
+        this.#dependencies = dependencies;
+    }
+    async execute(request) {
+        let publicationCommitted = false;
+        let committedDocumentPath;
+        let committedWriteState;
+        let projectedReachability;
+        let advisoryDiagnostics = [];
+        try {
+            request.signal?.throwIfAborted();
+            const inspection = await this.#dependencies.inspect(request.consumerRoot);
+            request.signal?.throwIfAborted();
+            if (inspection.state !== "idle") {
+                return commandExecution({
+                    command: "docs.new",
+                    diagnostics: [transactionDiagnostic(inspection, request.consumerRoot)],
+                    outcome: "recovery-required",
+                    result: { kind: "new", reservation: "none" }
+                });
+            }
+            const plan = await this.#dependencies.plan({
+                consumerRoot: request.consumerRoot,
+                profilePath: request.profilePath,
+                intent: request.intent,
+                ...signalOption(request.signal)
+            });
+            advisoryDiagnostics = await similarDocumentDiagnostics({
+                dependencies: this.#dependencies,
+                consumerRoot: request.consumerRoot,
+                plan,
+                ...signalOption(request.signal),
+            });
+            request.signal?.throwIfAborted();
+            const reachability = await this.#dependencies.reachability.project({
+                consumerRoot: request.consumerRoot,
+                plan
+            });
+            projectedReachability = reachability;
+            request.signal?.throwIfAborted();
+            if (request.dryRun) {
+                return commandExecution({
+                    command: "docs.new",
+                    diagnostics: advisoryDiagnostics,
+                    outcome: "success",
+                    result: {
+                        kind: "new",
+                        documentPath: plan.destination,
+                        writeState: "preview",
+                        reservation: "none",
+                        reachability
+                    }
+                });
+            }
+            const receipt = await this.#dependencies.apply({
+                consumerRoot: request.consumerRoot,
+                plan,
+                ...signalOption(request.signal)
+            });
+            const outcome = receiptOutcome(receipt);
+            publicationCommitted = receipt.outcome === "applied" ||
+                receipt.outcome === "already-applied";
+            if (publicationCommitted) {
+                committedDocumentPath = plan.destination;
+                committedWriteState = receipt.outcome === "already-applied"
+                    ? "already-applied" : "applied";
+            }
+            if (outcome !== "success") {
+                return commandExecution({
+                    command: "docs.new",
+                    diagnostics: [
+                        ...advisoryDiagnostics,
+                        ...receiptDiagnostics(receipt, request.consumerRoot)
+                    ],
+                    outcome,
+                    result: {
+                        kind: "new",
+                        documentPath: plan.destination,
+                        reservation: "none",
+                        receiptOutcome: receipt.outcome,
+                        reachability
+                    }
+                });
+            }
+            const verification = await this.#dependencies.structure.verify({
+                consumerRoot: request.consumerRoot,
+                plan,
+                ...signalOption(request.signal)
+            });
+            const diagnostics = [
+                ...advisoryDiagnostics,
+                ...receiptDiagnostics(receipt, request.consumerRoot),
+                ...verification.diagnostics.map((entry) => ({
+                    ...entry,
+                    phase: "apply",
+                    severity: "error"
+                }))
+            ];
+            return commandExecution({
+                command: "docs.new",
+                diagnostics,
+                outcome: verification.valid ? "success" : "violation",
+                result: {
+                    kind: "new",
+                    documentPath: plan.destination,
+                    writeState: receipt.outcome === "already-applied"
+                        ? "already-applied" : "applied",
+                    reservation: "none",
+                    receiptOutcome: receipt.outcome,
+                    reachability
+                }
+            });
+        }
+        catch (error) {
+            if (publicationCommitted) {
+                return commandExecution({
+                    command: "docs.new",
+                    diagnostics: [...advisoryDiagnostics, {
+                            ruleId: "document.new.post-publication-verification",
+                            severity: "error",
+                            phase: "apply",
+                            subject: "document.new",
+                            message: "The document was published, but post-publication structural verification failed. The created output was preserved."
+                        }],
+                    outcome: "violation",
+                    result: {
+                        kind: "new",
+                        ...(committedDocumentPath === undefined
+                            ? {} : { documentPath: committedDocumentPath }),
+                        ...(committedWriteState === undefined
+                            ? {} : { writeState: committedWriteState }),
+                        ...(projectedReachability === undefined
+                            ? {} : { reachability: projectedReachability }),
+                        reservation: "none"
+                    }
+                });
+            }
+            const failure = projectDocumentCommandFailure({
+                command: "docs.new", error, phase: "planning", subject: "document.new",
+                allowCancellation: true
+            });
+            return commandExecution({
+                command: "docs.new",
+                diagnostics: [...advisoryDiagnostics, failure.diagnostic],
+                outcome: failure.outcome,
+                result: { kind: "new", reservation: "none" }
+            });
+        }
+    }
+}
+//# sourceMappingURL=run-document-new.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { DocumentCommandExecution, DocumentRecoverResult } from "../model/document-command.js";
+import type { DocumentReceipt } from "../model/document-receipt.js";
+import type { DocumentTransactionInspectionV1 } from "../model/document-transaction-inspection.js";
+export interface RunDocumentRecoverRequest {
+    readonly consumerRoot: string;
+    readonly signal?: AbortSignal;
+}
+interface Dependencies {
+    inspect(consumerRoot: string): Promise<DocumentTransactionInspectionV1>;
+    recover(request: {
+        readonly consumerRoot: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentReceipt>;
+}
+export declare class RunDocumentRecover {
+    #private;
+    constructor(dependencies: Dependencies);
+    execute(request: RunDocumentRecoverRequest): Promise<DocumentCommandExecution<DocumentRecoverResult>>;
+}
+export {};
+//# sourceMappingURL=run-document-recover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-document-recover.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/run-document-recover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AAQnG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,UAAU,YAAY;IACpB,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACxE,OAAO,CAAC,OAAO,EAAE;QACf,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9B;AAmDD,qBAAa,kBAAkB;;IAG7B,YAAY,YAAY,EAAE,YAAY,EAErC;IAEK,OAAO,CACX,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,qBAAqB,CAAC,CAAC,CA4E1D;CACF"}

package/dist/document-authoring/application/use-cases/run-document-recover.js

@@ -0,0 +1,126 @@
+import { commandExecution, projectDocumentCommandFailure, receiptOutcome } from "../policies/document-command-projection.js";
+import { projectDocumentCommandConsumerRoot } from "../policies/document-command-consumer-root.js";
+function manualDiagnostics(inspection, consumerRoot) {
+    return inspection.diagnostics.map((entry) => ({
+        ruleId: entry.code.toLowerCase().replaceAll("_", "."),
+        severity: "error",
+        phase: "recovery",
+        subject: "document.transaction",
+        message: entry.message,
+        ...(inspection.recovery === undefined
+            ? {}
+            : { remediation: {
+                    commandId: inspection.recovery.commandId === "docs-recover"
+                        ? "docs.recover" : inspection.recovery.commandId,
+                    args: {
+                        ...inspection.recovery.args,
+                        consumerRoot: projectDocumentCommandConsumerRoot(consumerRoot)
+                    }
+                } })
+    }));
+}
+function writeState(receipt) {
+    switch (receipt.commit.publication) {
+        case "published": return "committed";
+        case "preexisting-exact": return "already-committed";
+        case "none": return "unchanged";
+        case "unknown": return "unknown";
+    }
+}
+function recoveryState(receipt) {
+    switch (receipt.outcome) {
+        case "applied": return "recovered";
+        case "already-applied": return "already-applied";
+        case "cancelled": return "cancelled";
+        case "recovery-required": return "recovery-required";
+        case "manual-recovery-required": return "manual-required";
+        case "authority-stale":
+        case "failed-before-publication":
+        case "rejected": return "failed";
+    }
+}
+export class RunDocumentRecover {
+    #dependencies;
+    constructor(dependencies) {
+        this.#dependencies = dependencies;
+    }
+    async execute(request) {
+        try {
+            request.signal?.throwIfAborted();
+            const inspection = await this.#dependencies.inspect(request.consumerRoot);
+            request.signal?.throwIfAborted();
+            if (inspection.state === "idle") {
+                return commandExecution({
+                    command: "docs.recover", outcome: "success",
+                    result: {
+                        kind: "recover", transactionState: "no-pending-transaction",
+                        writeState: "unchanged", recoveryRequired: false
+                    }
+                });
+            }
+            if (inspection.state === "manual-recovery-required") {
+                return commandExecution({
+                    command: "docs.recover",
+                    diagnostics: manualDiagnostics(inspection, request.consumerRoot),
+                    outcome: "recovery-required",
+                    result: {
+                        kind: "recover", transactionState: "manual-required",
+                        writeState: "unknown", recoveryRequired: true,
+                        ...(inspection.recovery === undefined
+                            ? {}
+                            : { recoveryCommand: {
+                                    commandId: inspection.recovery.commandId === "docs-recover"
+                                        ? "docs.recover" : inspection.recovery.commandId,
+                                    args: {
+                                        ...inspection.recovery.args,
+                                        consumerRoot: projectDocumentCommandConsumerRoot(request.consumerRoot)
+                                    }
+                                } })
+                    }
+                });
+            }
+            const receipt = await this.#dependencies.recover({
+                consumerRoot: request.consumerRoot,
+                ...(request.signal === undefined ? {} : { signal: request.signal })
+            });
+            const outcome = receiptOutcome(receipt);
+            return commandExecution({
+                command: "docs.recover",
+                diagnostics: receipt.diagnostics.map((entry) => ({
+                    ...entry,
+                    ...(outcome === "recovery-required"
+                        ? { remediation: {
+                                commandId: "docs.doctor",
+                                args: {
+                                    consumerRoot: projectDocumentCommandConsumerRoot(request.consumerRoot)
+                                }
+                            } }
+                        : {})
+                })),
+                outcome,
+                result: {
+                    kind: "recover",
+                    transactionState: recoveryState(receipt),
+                    writeState: writeState(receipt),
+                    recoveryRequired: outcome === "recovery-required",
+                    receiptDigest: receipt.receiptDigest
+                }
+            });
+        }
+        catch (error) {
+            const failure = projectDocumentCommandFailure({
+                command: "docs.recover", error, phase: "recovery", subject: "document.transaction"
+            });
+            return commandExecution({
+                command: "docs.recover", diagnostics: [failure.diagnostic], outcome: failure.outcome,
+                result: {
+                    kind: "recover",
+                    transactionState: failure.outcome === "cancelled" ? "cancelled" : "failed",
+                    writeState: "unknown",
+                    recoveryRequired: false
+                }
+            });
+        }
+    }
+}
+//# sourceMappingURL=run-document-recover.js.map

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

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

package/dist/document-authoring/composition/document-command-cli.d.ts

@@ -0,0 +1,7 @@
+export { renderDocumentCommandJson, renderDocumentCommandText, } from "../adapters/inbound/cli/document-command-renderer.js";
+export { createNodeDocumentCommands } from "./node-document-commands.js";
+export declare function projectDocumentLaunchFailure(rawArguments: readonly string[], error: unknown): {
+    readonly exitCode: number;
+    readonly stdout: string;
+} | undefined;
+//# sourceMappingURL=document-command-cli.d.ts.map

package/dist/document-authoring/composition/document-command-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-command-cli.d.ts","sourceRoot":"","sources":["../../../src/document-authoring/composition/document-command-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAMzE,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,EAAE,OAAO,GACb;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA8BpE"}