@agent-teams/engineering-foundation 0.15.0 → 0.16.0

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"}

package/dist/document-authoring/composition/document-command-cli.js

@@ -0,0 +1,32 @@
+export { renderDocumentCommandJson, renderDocumentCommandText, } from "../adapters/inbound/cli/document-command-renderer.js";
+export { createNodeDocumentCommands } from "./node-document-commands.js";
+import { documentMutationFailure } from "../adapters/inbound/cli/document-command-failure.js";
+import { documentFindFailure } from "../find-command.js";
+export function projectDocumentLaunchFailure(rawArguments, error) {
+    if (rawArguments[0] !== "docs") {
+        return undefined;
+    }
+    const json = rawArguments.includes("--json") || rawArguments.some((argument, index) => argument === "--format" && rawArguments[index + 1] === "json");
+    if (!json) {
+        return undefined;
+    }
+    if (rawArguments[1] === "find") {
+        const result = documentFindFailure(error);
+        return {
+            exitCode: result.exitCode,
+            stdout: `${JSON.stringify(result.envelope)}\n`
+        };
+    }
+    const requested = `docs.${rawArguments[1] ?? ""}`;
+    const command = requested === "docs.new" ||
+        requested === "docs.doctor" ||
+        requested === "docs.recover"
+        ? requested
+        : "docs.doctor";
+    const result = documentMutationFailure(command, error);
+    return {
+        exitCode: result.exitCode,
+        stdout: `${JSON.stringify(result.envelope)}\n`
+    };
+}
+//# sourceMappingURL=document-command-cli.js.map

package/dist/document-authoring/composition/document-command-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-command-cli.js","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;AAGzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,UAAU,4BAA4B,CAC1C,YAA+B,EAC/B,KAAc;IAEd,IAAI,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,IAAI,CAC/D,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAClB,QAAQ,KAAK,UAAU,IAAI,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,MAAM,CAChE,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI;SAC/C,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAClD,MAAM,OAAO,GACX,SAAS,KAAK,UAAU;QACxB,SAAS,KAAK,aAAa;QAC3B,SAAS,KAAK,cAAc;QAC1B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,aAAa,CAAC;IACpB,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI;KAC/C,CAAC;AACJ,CAAC"}

package/dist/document-authoring/composition/inspect-document-transaction.d.ts

@@ -0,0 +1,8 @@
+import { NodeFoundationTransactionSlot } from "../../transaction-coordination/adapters/node/node-foundation-transaction-slot.js";
+import type { DocumentTransactionInspectionV1 } from "../application/model/document-transaction-inspection.js";
+type ObservedTransactionStatus = Awaited<ReturnType<NodeFoundationTransactionSlot["inspect"]>>;
+export declare function projectDocumentTransactionInspectionV1(status: ObservedTransactionStatus): DocumentTransactionInspectionV1;
+/** Inspects the shared transaction slot without acquiring mutation authority. */
+export declare function inspectDocumentTransactionV1(consumerRoot: string): Promise<DocumentTransactionInspectionV1>;
+export {};
+//# sourceMappingURL=inspect-document-transaction.d.ts.map

package/dist/document-authoring/composition/inspect-document-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-document-transaction.d.ts","sourceRoot":"","sources":["../../../src/document-authoring/composition/inspect-document-transaction.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kFAAkF,CAAC;AACjI,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAG/G,KAAK,yBAAyB,GAAG,OAAO,CACtC,UAAU,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC,CACrD,CAAC;AAgHF,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,yBAAyB,GAChC,+BAA+B,CAwCjC;AAED,iFAAiF;AACjF,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,+BAA+B,CAAC,CAqC1C"}

package/dist/document-authoring/composition/inspect-document-transaction.js

@@ -0,0 +1,177 @@
+import { lstat, realpath } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { FOUNDATION_TRANSACTION_FILE, LOCAL_STATE_DIRECTORY, } from "../../foundation-state-contract.js";
+import { installedFoundationVersion } from "../../package-version.js";
+import { installedFoundationBuildIdentity } from "../../transaction-coordination/adapters/node/installed-foundation-build-identity.js";
+import { NodeFoundationTransactionSlot } from "../../transaction-coordination/adapters/node/node-foundation-transaction-slot.js";
+import { recaptureDocumentPublicationPaths } from "../adapters/node/recapture-document-publication-paths.js";
+function property(value, key) {
+    return typeof value === "object" && value !== null
+        ? Reflect.get(value, key)
+        : undefined;
+}
+function isExactDocumentRecovery(status) {
+    return status.state === "pending" &&
+        status.operationKind === "document-authoring" &&
+        property(status, "format") === "document-authoring-envelope-v3" &&
+        property(property(status, "recovery"), "commandId") === "docs-recover" &&
+        status.recovery.exactFoundationVersion === status.foundationVersion &&
+        status.recovery.exactFoundationBuildIdentity === status.foundationBuildIdentity &&
+        !status.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH");
+}
+function operationKind(status) {
+    return property(status, "operationKind");
+}
+function stringProperty(value, key) {
+    const candidate = property(value, key);
+    return typeof candidate === "string" ? candidate : undefined;
+}
+function hasVersionMismatch(status) {
+    return status.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH");
+}
+function transactionKind(status) {
+    if (hasVersionMismatch(status)) {
+        return "version-mismatch";
+    }
+    if (status.state === "pending") {
+        switch (status.operationKind) {
+            case "document-authoring": return "document";
+            case "local-mode": return "local-mode";
+            case "scaffolding": return "scaffold";
+        }
+    }
+    switch (status.reason) {
+        case "journal-transition-residue":
+        case "orphan-temporary": return "transition-residue";
+        case "corrupt-or-incompatible":
+        case "invalid-slot":
+        case "local-mode-evidence-invalid":
+        case "physical-identity-unverifiable":
+        case "unstable-slot": return "corrupt";
+        case "unsupported-schema": return "version-mismatch";
+        case "recovery-handler-unavailable":
+            switch (status.operationKind) {
+                case "document-authoring": return "document";
+                case "scaffolding": return "scaffold";
+                case undefined: return "unknown";
+            }
+            return "unknown";
+        case "multiple-transactions": return "unknown";
+    }
+}
+function exactRecovery(status) {
+    const recovery = property(status, "recovery");
+    const commandId = stringProperty(recovery, "commandId");
+    if (commandId === "detach") {
+        return { commandId, args: {} };
+    }
+    if (commandId !== "docs-recover" && commandId !== "scaffold-recover") {
+        return undefined;
+    }
+    const exactFoundationVersion = stringProperty(recovery, "exactFoundationVersion");
+    if (exactFoundationVersion === undefined) {
+        return undefined;
+    }
+    const exactFoundationBuildIdentity = stringProperty(recovery, "exactFoundationBuildIdentity");
+    return {
+        commandId,
+        args: {
+            exactFoundationVersion,
+            ...(exactFoundationBuildIdentity === undefined
+                ? {} : { exactFoundationBuildIdentity }),
+        },
+    };
+}
+export function projectDocumentTransactionInspectionV1(status) {
+    if (status.state === "idle") {
+        return { schemaVersion: 1, state: "idle", diagnostics: [] };
+    }
+    if (isExactDocumentRecovery(status)) {
+        return {
+            schemaVersion: 1,
+            state: "recoverable",
+            operationKind: "document-authoring",
+            format: status.format,
+            foundationVersion: status.foundationVersion,
+            foundationBuildIdentity: status.foundationBuildIdentity,
+            recovery: status.recovery,
+            diagnostics: status.diagnostics,
+        };
+    }
+    const kind = operationKind(status);
+    const format = stringProperty(status, "format");
+    const foundationVersion = stringProperty(status, "foundationVersion");
+    const foundationBuildIdentity = stringProperty(status, "foundationBuildIdentity");
+    const recovery = exactRecovery(status);
+    return {
+        schemaVersion: 1,
+        state: "manual-recovery-required",
+        reason: status.state === "manual-recovery-required"
+            ? status.reason
+            : status.diagnostics[0]?.message ??
+                "A foreign Foundation transaction blocks document authoring.",
+        ...(kind === undefined ? {} : { operationKind: kind }),
+        transactionKind: transactionKind(status),
+        ...(format === undefined ? {} : { format }),
+        ...(foundationVersion === undefined ? {} : { foundationVersion }),
+        ...(foundationBuildIdentity === undefined
+            ? {} : { foundationBuildIdentity }),
+        ...(recovery === undefined ? {} : { recovery }),
+        diagnostics: status.diagnostics,
+    };
+}
+/** Inspects the shared transaction slot without acquiring mutation authority. */
+export async function inspectDocumentTransactionV1(consumerRoot) {
+    const root = await realpath(resolve(consumerRoot));
+    const stateDirectory = join(root, LOCAL_STATE_DIRECTORY);
+    try {
+        await lstat(stateDirectory);
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error &&
+            error.code === "ENOENT") {
+            return { schemaVersion: 1, state: "idle", diagnostics: [] };
+        }
+        return unsafeTransactionPathInspection();
+    }
+    try {
+        // Reuse the writer's strict real-directory ancestry recapture. This rejects
+        // redirected state directories, portable aliases, and roots that escape the
+        // canonical consumer root before the shared slot is allowed to read evidence.
+        await recaptureDocumentPublicationPaths({
+            consumerRoot: root,
+            destination: `${LOCAL_STATE_DIRECTORY}/${FOUNDATION_TRANSACTION_FILE}`,
+        });
+    }
+    catch {
+        try {
+            await lstat(stateDirectory);
+        }
+        catch (error) {
+            if (error instanceof Error && "code" in error &&
+                error.code === "ENOENT") {
+                return { schemaVersion: 1, state: "idle", diagnostics: [] };
+            }
+        }
+        return unsafeTransactionPathInspection();
+    }
+    const status = await new NodeFoundationTransactionSlot({
+        consumerRoot: root,
+        installedVersion: await installedFoundationVersion(),
+        installedBuildIdentity: await installedFoundationBuildIdentity(),
+    }).inspect();
+    return projectDocumentTransactionInspectionV1(status);
+}
+function unsafeTransactionPathInspection() {
+    return {
+        schemaVersion: 1,
+        state: "manual-recovery-required",
+        reason: "Foundation transaction evidence path is redirected or cannot be inspected safely.",
+        transactionKind: "corrupt",
+        diagnostics: [{
+                code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED",
+                message: "Foundation transaction evidence path is redirected or cannot be inspected safely.",
+            }],
+    };
+}
+//# sourceMappingURL=inspect-document-transaction.js.map

package/dist/document-authoring/composition/inspect-document-transaction.js.map

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