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

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

package/dist/document-authoring/composition/node-document-authority-recompiler.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentPlan } from "../application/model/document-planning.js";
+import type { DocumentAuthorityAssessment, DocumentAuthorityRecompiler } from "../application/ports/document-authority-recompiler.js";
+/** Closed Node replay of the exact planner from the Plan-embedded Intent and profile path. */
+export declare class NodeDocumentAuthorityRecompiler implements DocumentAuthorityRecompiler {
+    assess(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentAuthorityAssessment>;
+}
+//# sourceMappingURL=node-document-authority-recompiler.d.ts.map

package/dist/document-authoring/composition/node-document-authority-recompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-authority-recompiler.d.ts","sourceRoot":"","sources":["../../../src/document-authoring/composition/node-document-authority-recompiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,uDAAuD,CAAC;AAe/D,8FAA8F;AAC9F,qBAAa,+BACb,YAAW,2BAA2B;IAC9B,MAAM,CAAC,OAAO,EAAE;QACpB,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,2BAA2B,CAAC,CA0CvC;CACF"}

package/dist/document-authoring/composition/node-document-authority-recompiler.js

@@ -0,0 +1,62 @@
+import { canonicalJson } from "../../canonical-json.js";
+import { assertNotCancelled } from "../../cancellation.js";
+import { assertDocumentPlanDigests } from "../application/policies/document-contract-digests.js";
+import { DocumentPlanningError } from "../document-planning-error.js";
+import { NodeDocumentContractValidator } from "../adapters/node/node-document-contract-validator.js";
+import { planNodeDocumentationDocument } from "./node-document-planning.js";
+function exactPlan(left, right) {
+    return canonicalJson(left) ===
+        canonicalJson(right);
+}
+function reason(error) {
+    return error instanceof Error ? error.message : "Document authority failed with an invalid error value.";
+}
+/** Closed Node replay of the exact planner from the Plan-embedded Intent and profile path. */
+export class NodeDocumentAuthorityRecompiler {
+    async assess(request) {
+        let validatedPlan;
+        try {
+            assertNotCancelled(request.signal);
+            validatedPlan = await new NodeDocumentContractValidator().validatePlan(request.plan);
+            assertDocumentPlanDigests(validatedPlan);
+        }
+        catch (error) {
+            assertNotCancelled(request.signal);
+            return {
+                state: "unverifiable",
+                reason: `Document Plan evidence cannot be validated safely: ${reason(error)}`
+            };
+        }
+        try {
+            const replayed = await planNodeDocumentationDocument({
+                consumerRoot: request.consumerRoot,
+                profilePath: validatedPlan.authority.profile.path,
+                intent: validatedPlan.intent,
+                ...(request.signal === undefined ? {} : { signal: request.signal })
+            });
+            assertDocumentPlanDigests(replayed);
+            assertNotCancelled(request.signal);
+            return exactPlan(replayed, validatedPlan)
+                ? { state: "current", plan: replayed }
+                : {
+                    state: "stale",
+                    reason: "Current consumer authority reproduces a different exact Document Plan."
+                };
+        }
+        catch (error) {
+            assertNotCancelled(request.signal);
+            if (error instanceof DocumentPlanningError &&
+                error.code !== "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE") {
+                return {
+                    state: "stale",
+                    reason: `Current consumer authority no longer admits the supplied Document Plan: ${error.message}`
+                };
+            }
+            return {
+                state: "unverifiable",
+                reason: `Document Plan authority cannot be reproduced safely: ${reason(error)}`
+            };
+        }
+    }
+}
+//# sourceMappingURL=node-document-authority-recompiler.js.map

package/dist/document-authoring/composition/node-document-authority-recompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-authority-recompiler.js","sourceRoot":"","sources":["../../../src/document-authoring/composition/node-document-authority-recompiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAM3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AACrG,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAE5E,SAAS,SAAS,CAAC,IAAkB,EAAE,KAAmB;IACxD,OAAO,aAAa,CAAC,IAAqC,CAAC;QACzD,aAAa,CAAC,KAAsC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wDAAwD,CAAC;AAC3G,CAAC;AAED,8FAA8F;AAC9F,MAAM,OAAO,+BAA+B;IAE1C,KAAK,CAAC,MAAM,CAAC,OAIZ;QACC,IAAI,aAA2B,CAAC;QAChC,IAAI,CAAC;YACH,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,aAAa,GAAG,MAAM,IAAI,6BAA6B,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrF,yBAAyB,CAAC,aAAa,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO;gBACL,KAAK,EAAE,cAAc;gBACrB,MAAM,EAAE,sDAAsD,MAAM,CAAC,KAAK,CAAC,EAAE;aAC9E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC;gBACnD,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,WAAW,EAAE,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI;gBACjD,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;aACpE,CAAC,CAAC;YACH,yBAAyB,CAAC,QAAQ,CAAC,CAAC;YACpC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC;gBACvC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACtC,CAAC,CAAC;oBACE,KAAK,EAAE,OAAO;oBACd,MAAM,EAAE,wEAAwE;iBACjF,CAAC;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,KAAK,YAAY,qBAAqB;gBACxC,KAAK,CAAC,IAAI,KAAK,yCAAyC,EAAE,CAAC;gBAC3D,OAAO;oBACL,KAAK,EAAE,OAAO;oBACd,MAAM,EAAE,2EAA2E,KAAK,CAAC,OAAO,EAAE;iBACnG,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,cAAc;gBACrB,MAAM,EAAE,wDAAwD,MAAM,CAAC,KAAK,CAAC,EAAE;aAChF,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/document-authoring/composition/node-document-commands.d.ts

@@ -0,0 +1,10 @@
+import { RunDocumentDoctor } from "../application/use-cases/run-document-doctor.js";
+import { RunDocumentNew } from "../application/use-cases/run-document-new.js";
+import { RunDocumentRecover } from "../application/use-cases/run-document-recover.js";
+/** Closed Node composition for the document mutation command family. */
+export declare function createNodeDocumentCommands(): Readonly<{
+    readonly doctor: RunDocumentDoctor;
+    readonly newDocument: RunDocumentNew;
+    readonly recover: RunDocumentRecover;
+}>;
+//# sourceMappingURL=node-document-commands.d.ts.map

package/dist/document-authoring/composition/node-document-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-commands.d.ts","sourceRoot":"","sources":["../../../src/document-authoring/composition/node-document-commands.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AAQtF,wEAAwE;AACxE,wBAAgB,0BAA0B,IAAI,QAAQ,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC,CAAC,CAiDD"}

package/dist/document-authoring/composition/node-document-commands.js

@@ -0,0 +1,68 @@
+import { FilesystemMarkdownRepository } from "../../documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+import { installedFoundationVersion } from "../../package-version.js";
+import { installedFoundationBuildIdentity } from "../../transaction-coordination/adapters/node/installed-foundation-build-identity.js";
+import { NodeAuthoringProfileReader } from "../adapters/node/node-authoring-profile-reader.js";
+import { NodeDocumentPlanningProfileReader } from "../adapters/node/node-document-planning-profile-reader.js";
+import { NodeDocumentReachabilityProjector } from "../adapters/node/node-document-reachability-projector.js";
+import { NodeDocumentStructureVerifier } from "../adapters/node/node-document-structure-verifier.js";
+import { NodeMetadataInstanceValidator } from "../adapters/node/node-metadata-instance-validator.js";
+import { NodeOwnerMembershipReader } from "../adapters/node/node-owner-membership-reader.js";
+import { NodeDocumentEnvironmentInspector } from "../adapters/node/node-document-environment-inspector.js";
+import { BuildDocumentationCatalog } from "../application/use-cases/build-documentation-catalog.js";
+import { RunDocumentDoctor } from "../application/use-cases/run-document-doctor.js";
+import { FindDocuments } from "../application/use-cases/find-documents.js";
+import { RunDocumentNew } from "../application/use-cases/run-document-new.js";
+import { RunDocumentRecover } from "../application/use-cases/run-document-recover.js";
+import { inspectDocumentTransactionV1 } from "./inspect-document-transaction.js";
+import { planNodeDocumentationDocument } from "./node-document-planning.js";
+import { applyNodeDocumentationPlan, recoverNodeDocumentationTransaction, } from "./node-document-writing.js";
+/** Closed Node composition for the document mutation command family. */
+export function createNodeDocumentCommands() {
+    const inspect = inspectDocumentTransactionV1;
+    const planningProfiles = new NodeDocumentPlanningProfileReader();
+    const catalog = new BuildDocumentationCatalog({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReader(),
+        repository: new FilesystemMarkdownRepository(),
+    });
+    const find = new FindDocuments(catalog);
+    return Object.freeze({
+        doctor: new RunDocumentDoctor({
+            environment: new NodeDocumentEnvironmentInspector({
+                buildIdentity: installedFoundationBuildIdentity,
+                version: installedFoundationVersion
+            }),
+            inspect
+        }),
+        newDocument: new RunDocumentNew({
+            apply: applyNodeDocumentationPlan,
+            inspect,
+            plan: planNodeDocumentationDocument,
+            reachability: new NodeDocumentReachabilityProjector(planningProfiles),
+            similar: {
+                async advise(request) {
+                    const result = await find.execute({
+                        consumerRoot: request.consumerRoot,
+                        profilePath: request.profilePath,
+                        query: { text: request.title },
+                        ...(request.signal === undefined ? {} : { signal: request.signal }),
+                    });
+                    return Object.freeze({
+                        matches: Object.freeze(result.documents.map(({ id, repositoryPath }) => Object.freeze({ id, repositoryPath }))),
+                        query: request.title,
+                    });
+                },
+            },
+            structure: new NodeDocumentStructureVerifier({
+                catalog,
+                profiles: planningProfiles,
+            }),
+        }),
+        recover: new RunDocumentRecover({
+            inspect,
+            recover: recoverNodeDocumentationTransaction,
+        }),
+    });
+}
+//# sourceMappingURL=node-document-commands.js.map

package/dist/document-authoring/composition/node-document-commands.js.map

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

package/dist/document-authoring/composition/node-document-planning.d.ts

@@ -0,0 +1,7 @@
+import { type PlanDocumentationDocumentRequest } from "../application/use-cases/plan-documentation-document.js";
+/**
+ * Closed Node composition shared by public planning and Foundation-owned replay.
+ * This module is intentionally absent from the package export map.
+ */
+export declare function planNodeDocumentationDocument(request: PlanDocumentationDocumentRequest): Promise<import("../index.js").DocumentPlan>;
+//# sourceMappingURL=node-document-planning.d.ts.map

package/dist/document-authoring/composition/node-document-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-planning.d.ts","sourceRoot":"","sources":["../../../src/document-authoring/composition/node-document-planning.ts"],"names":[],"mappings":"AAyBA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,yDAAyD,CAAC;AAYjE;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,gCAAgC,+CAiD1C"}

package/dist/document-authoring/composition/node-document-planning.js

@@ -0,0 +1,77 @@
+import { FilesystemMarkdownRepository } from "../../documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+import { installedFoundationVersion } from "../../package-version.js";
+import { installedFoundationBuildIdentity } from "../../transaction-coordination/adapters/node/installed-foundation-build-identity.js";
+import { CanonicalMarkdownError, YamlCanonicalDocumentRenderer } from "../adapters/canonical-markdown.js";
+import { NodeAuthoringProfileReader } from "../adapters/node/node-authoring-profile-reader.js";
+import { NodeDocumentContractValidator } from "../adapters/node/node-document-contract-validator.js";
+import { NodeDocumentPlanningProfileReader } from "../adapters/node/node-document-planning-profile-reader.js";
+import { NodeDocumentPlanningStateReader } from "../adapters/node/node-document-planning-state-reader.js";
+import { NodeDocumentTemplateReader } from "../adapters/node/node-document-template-reader.js";
+import { NodeMetadataInstanceValidator } from "../adapters/node/node-metadata-instance-validator.js";
+import { NodeOwnerMembershipReader } from "../adapters/node/node-owner-membership-reader.js";
+import { DocumentPlanningPolicyError } from "../application/policies/document-planning-policy-error.js";
+import { classifyDocumentLogicalPreimage, isDestinationCoveredByCatalog } from "../application/policies/document-logical-preimage.js";
+import { normalizeDocumentIntent } from "../application/policies/normalize-document-intent.js";
+import { resolveDocumentAuthoring, selectDocumentArtifact } from "../application/policies/resolve-document-authoring.js";
+import { BuildDocumentationCatalog } from "../application/use-cases/build-documentation-catalog.js";
+import { PlanDocumentationDocument } from "../application/use-cases/plan-documentation-document.js";
+import { DocumentPlanningError } from "../document-planning-error.js";
+function planningPolicyFailure(error) {
+    const code = error.problem === "catalog-incomplete"
+        ? "DOCUMENT_PLANNING_CATALOG_PARTIAL"
+        : ["catalog-collision", "destination-conflict"].includes(error.problem)
+            ? "DOCUMENT_PLANNING_CONFLICT"
+            : "DOCUMENT_PLANNING_INPUT_INVALID";
+    throw new DocumentPlanningError(code, error.message, { cause: error });
+}
+/**
+ * Closed Node composition shared by public planning and Foundation-owned replay.
+ * This module is intentionally absent from the package export map.
+ */
+export async function planNodeDocumentationDocument(request) {
+    const catalog = new BuildDocumentationCatalog({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReader(),
+        repository: new FilesystemMarkdownRepository()
+    });
+    const [version, buildIdentity] = await Promise.all([
+        installedFoundationVersion(),
+        installedFoundationBuildIdentity()
+    ]);
+    const planner = new PlanDocumentationDocument({
+        catalog,
+        compiler: {
+            id: "@agent-teams/engineering-foundation",
+            version,
+            buildIdentity
+        },
+        contracts: new NodeDocumentContractValidator(),
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        policies: {
+            classifyDocumentLogicalPreimage,
+            isDestinationCoveredByCatalog,
+            normalizeDocumentIntent,
+            resolveDocumentAuthoring,
+            selectDocumentArtifact
+        },
+        profile: new NodeDocumentPlanningProfileReader(),
+        renderer: new YamlCanonicalDocumentRenderer(),
+        state: new NodeDocumentPlanningStateReader(),
+        templates: new NodeDocumentTemplateReader()
+    });
+    try {
+        return await planner.execute(request);
+    }
+    catch (error) {
+        if (error instanceof DocumentPlanningPolicyError) {
+            planningPolicyFailure(error);
+        }
+        if (error instanceof CanonicalMarkdownError) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template authority is invalid: ${error.message}`, { cause: error });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=node-document-planning.js.map

package/dist/document-authoring/composition/node-document-planning.js.map

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

package/dist/document-authoring/composition/node-document-writing-private.d.ts

@@ -0,0 +1,15 @@
+import { type NodeDocumentPublisherOperations } from "../adapters/node/node-document-publisher.js";
+import type { DocumentReceipt } from "../application/model/document-receipt.js";
+import { type ApplyDocumentPlanRequest } from "../application/use-cases/apply-document-plan.js";
+import type { DocumentTransactionFaultPoint } from "../application/use-cases/document-transaction-continuation.js";
+import { type RecoverDocumentTransactionRequest } from "../application/use-cases/recover-document-transaction.js";
+type NodeDocumentWritingFaultPoint = DocumentTransactionFaultPoint | Parameters<NonNullable<NodeDocumentPublisherOperations["faultInjector"]>>[0];
+type NodeDocumentWritingFaultInjector = (point: NodeDocumentWritingFaultPoint) => Promise<void> | void;
+export interface NodeDocumentWritingPrivateOperations {
+    readonly faultInjector?: NodeDocumentWritingFaultInjector;
+    readonly publisher?: Omit<NodeDocumentPublisherOperations, "faultInjector">;
+}
+export declare function applyNodeDocumentationPlanPrivately(request: ApplyDocumentPlanRequest, operations?: NodeDocumentWritingPrivateOperations): Promise<DocumentReceipt>;
+export declare function recoverNodeDocumentationTransactionPrivately(request: RecoverDocumentTransactionRequest, operations?: NodeDocumentWritingPrivateOperations): Promise<DocumentReceipt>;
+export {};
+//# sourceMappingURL=node-document-writing-private.d.ts.map

package/dist/document-authoring/composition/node-document-writing-private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-writing-private.d.ts","sourceRoot":"","sources":["../../../src/document-authoring/composition/node-document-writing-private.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,6CAA6C,CAAC;AAGrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAEV,6BAA6B,EAC9B,MAAM,+DAA+D,CAAC;AACvE,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,0DAA0D,CAAC;AAGlE,KAAK,6BAA6B,GAC9B,6BAA6B,GAC7B,UAAU,CAAC,WAAW,CAAC,+BAA+B,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjF,KAAK,gCAAgC,GAAG,CACtC,KAAK,EAAE,6BAA6B,KACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,aAAa,CAAC,EAAE,gCAAgC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAC;CAC7E;AA8BD,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,wBAAwB,EACjC,UAAU,GAAE,oCAAyC,GACpD,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,4CAA4C,CAChE,OAAO,EAAE,iCAAiC,EAC1C,UAAU,GAAE,oCAAyC,GACpD,OAAO,CAAC,eAAe,CAAC,CAU1B"}

package/dist/document-authoring/composition/node-document-writing-private.js

@@ -0,0 +1,52 @@
+import { realpath } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { FOUNDATION_TRANSACTION_FILE, LOCAL_STATE_DIRECTORY } from "../../foundation-state-contract.js";
+import { NodeDocumentContractValidator } from "../adapters/node/node-document-contract-validator.js";
+import { NodeDocumentFileState } from "../adapters/node/node-document-file-state.js";
+import { NodeDocumentJournalStore } from "../adapters/node/node-document-journal-store.js";
+import { NodeDocumentPublisher } from "../adapters/node/node-document-publisher.js";
+import { createNodeDocumentTransactionCoordinator } from "../adapters/node/node-document-transaction-coordinator.js";
+import { applyDocumentPlan } from "../application/use-cases/apply-document-plan.js";
+import { recoverDocumentTransaction } from "../application/use-cases/recover-document-transaction.js";
+import { NodeDocumentAuthorityRecompiler } from "./node-document-authority-recompiler.js";
+function journalPath(consumerRoot) {
+    return join(consumerRoot, LOCAL_STATE_DIRECTORY, FOUNDATION_TRANSACTION_FILE);
+}
+async function canonicalConsumerRoot(consumerRoot) {
+    return realpath(resolve(consumerRoot));
+}
+function runtime(consumerRoot, operations) {
+    const faultInjector = operations.faultInjector;
+    return {
+        authority: new NodeDocumentAuthorityRecompiler(),
+        fileState: new NodeDocumentFileState(),
+        ...(faultInjector === undefined ? {} : { faultInjector }),
+        journal: new NodeDocumentJournalStore(journalPath(consumerRoot)),
+        publisher: new NodeDocumentPublisher({
+            ...operations.publisher,
+            ...(operations.faultInjector === undefined
+                ? {}
+                : { faultInjector: operations.faultInjector })
+        })
+    };
+}
+export async function applyNodeDocumentationPlanPrivately(request, operations = {}) {
+    const contractValidator = new NodeDocumentContractValidator();
+    const plan = await contractValidator.validatePlan(request.plan);
+    const consumerRoot = await canonicalConsumerRoot(request.consumerRoot);
+    const coordinator = await createNodeDocumentTransactionCoordinator(consumerRoot);
+    return applyDocumentPlan({ ...runtime(consumerRoot, operations), contractValidator, coordinator }, {
+        consumerRoot,
+        plan,
+        ...(request.signal === undefined ? {} : { signal: request.signal })
+    });
+}
+export async function recoverNodeDocumentationTransactionPrivately(request, operations = {}) {
+    const consumerRoot = await canonicalConsumerRoot(request.consumerRoot);
+    const coordinator = await createNodeDocumentTransactionCoordinator(consumerRoot);
+    return recoverDocumentTransaction({ ...runtime(consumerRoot, operations), coordinator }, {
+        consumerRoot,
+        ...(request.signal === undefined ? {} : { signal: request.signal })
+    });
+}
+//# sourceMappingURL=node-document-writing-private.js.map

package/dist/document-authoring/composition/node-document-writing-private.js.map

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

package/dist/document-authoring/composition/node-document-writing.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentReceipt } from "../application/model/document-receipt.js";
+import type { ApplyDocumentPlanRequest } from "../application/use-cases/apply-document-plan.js";
+import type { RecoverDocumentTransactionRequest } from "../application/use-cases/recover-document-transaction.js";
+/** Closed Node composition for durable, create-only document publication. */
+export declare function applyNodeDocumentationPlan(request: ApplyDocumentPlanRequest): Promise<DocumentReceipt>;
+/** Closed Node composition for exact-version document transaction recovery. */
+export declare function recoverNodeDocumentationTransaction(request: RecoverDocumentTransactionRequest): Promise<DocumentReceipt>;
+//# sourceMappingURL=node-document-writing.d.ts.map

package/dist/document-authoring/composition/node-document-writing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-writing.d.ts","sourceRoot":"","sources":["../../../src/document-authoring/composition/node-document-writing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,0DAA0D,CAAC;AAMlH,6EAA6E;AAC7E,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED,+EAA+E;AAC/E,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,eAAe,CAAC,CAE1B"}

package/dist/document-authoring/composition/node-document-writing.js

@@ -0,0 +1,10 @@
+import { applyNodeDocumentationPlanPrivately, recoverNodeDocumentationTransactionPrivately } from "./node-document-writing-private.js";
+/** Closed Node composition for durable, create-only document publication. */
+export async function applyNodeDocumentationPlan(request) {
+    return applyNodeDocumentationPlanPrivately(request);
+}
+/** Closed Node composition for exact-version document transaction recovery. */
+export async function recoverNodeDocumentationTransaction(request) {
+    return recoverNodeDocumentationTransactionPrivately(request);
+}
+//# sourceMappingURL=node-document-writing.js.map