@agent-teams/engineering-foundation 1.0.2 → 1.1.0

package/dist/transaction-coordination/adapters/node/installed-foundation-transaction-artifacts.js

@@ -0,0 +1,28 @@
+import { installedRepositoryMutationBuildIdentity, installedRepositoryMutationVersion, REPOSITORY_MUTATION_PACKAGE_NAME } from "@agent-teams/repository-mutation";
+import { installedFoundationVersion } from "./installed-foundation-version.js";
+import { installedFoundationBuildIdentity } from "./installed-foundation-build-identity.js";
+let installedArtifacts;
+export async function resolveInstalledFoundationTransactionArtifacts() {
+    installedArtifacts ??= (async () => {
+        const [ownerVersion, ownerBuildIdentity, kernelVersion, kernelBuildIdentity] = await Promise.all([
+            installedFoundationVersion(),
+            installedFoundationBuildIdentity(),
+            installedRepositoryMutationVersion(),
+            installedRepositoryMutationBuildIdentity()
+        ]);
+        return {
+            owner: {
+                name: "@agent-teams/engineering-foundation",
+                version: ownerVersion,
+                buildIdentity: ownerBuildIdentity
+            },
+            kernel: {
+                name: REPOSITORY_MUTATION_PACKAGE_NAME,
+                version: kernelVersion,
+                buildIdentity: kernelBuildIdentity
+            }
+        };
+    })();
+    return installedArtifacts;
+}
+//# sourceMappingURL=installed-foundation-transaction-artifacts.js.map

package/dist/transaction-coordination/adapters/node/installed-foundation-transaction-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-foundation-transaction-artifacts.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/installed-foundation-transaction-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wCAAwC,EACxC,kCAAkC,EAClC,gCAAgC,EAEjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAO5F,IAAI,kBAAmE,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,8CAA8C;IAClE,kBAAkB,KAAK,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,CAAC,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,CAAC,GAC1E,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,0BAA0B,EAAE;YAC5B,gCAAgC,EAAE;YAClC,kCAAkC,EAAE;YACpC,wCAAwC,EAAE;SAC3C,CAAC,CAAC;QACL,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,qCAAqC;gBAC3C,OAAO,EAAE,YAAY;gBACrB,aAAa,EAAE,kBAAkB;aAClC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,gCAAgC;gBACtC,OAAO,EAAE,aAAa;gBACtB,aAAa,EAAE,mBAAmB;aACnC;SACF,CAAC;IACJ,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/transaction-coordination/adapters/node/installed-foundation-version.d.ts

@@ -0,0 +1,2 @@
+export declare function installedFoundationVersion(): Promise<string>;
+//# sourceMappingURL=installed-foundation-version.d.ts.map

package/dist/transaction-coordination/adapters/node/installed-foundation-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-foundation-version.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/installed-foundation-version.ts"],"names":[],"mappings":"AAGA,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAWlE"}

package/dist/transaction-coordination/adapters/node/installed-foundation-version.js

@@ -0,0 +1,10 @@
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+export async function installedFoundationVersion() {
+    const manifest = JSON.parse(await readFile(fileURLToPath(new URL("../../../../package.json", import.meta.url)), "utf8"));
+    if (typeof manifest.version !== "string") {
+        throw new Error("Installed Foundation package version is unavailable.");
+    }
+    return manifest.version;
+}
+//# sourceMappingURL=installed-foundation-version.js.map

package/dist/transaction-coordination/adapters/node/installed-foundation-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-foundation-version.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/installed-foundation-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,MAAM,QAAQ,CACZ,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EACnE,MAAM,CACP,CACgC,CAAC;IACpC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC"}

package/dist/transaction-coordination/adapters/node/known-file-transaction-status.d.ts

@@ -1,8 +1,4 @@
 import type { InternalFoundationTransactionStatus } from "../../application/model/internal-transaction-status.js";
-export declare function inspectKnownFileTransactionStatus(options: {
-    readonly value: Record<string, unknown>;
-    readonly schemaVersion: number;
-    readonly installedVersion: string;
-    readonly installedBuildIdentity: string;
-}): InternalFoundationTransactionStatus | undefined;
+/** Schema5 is opaque historical evidence, never a split-package recovery lease. */
+export declare function inspectKnownFileTransactionStatus(value: Record<string, unknown>): InternalFoundationTransactionStatus;
 //# sourceMappingURL=known-file-transaction-status.d.ts.map

package/dist/transaction-coordination/adapters/node/known-file-transaction-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"known-file-transaction-status.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/known-file-transaction-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,wDAAwD,CAAC;AAiClH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC,GAAG,mCAAmC,GAAG,SAAS,CA4ClD"}
+{"version":3,"file":"known-file-transaction-status.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/known-file-transaction-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,wDAAwD,CAAC;AAGlH,mFAAmF;AACnF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,mCAAmC,CASrC"}

package/dist/transaction-coordination/adapters/node/known-file-transaction-status.js

@@ -1,80 +1,13 @@
-import { sha256Json } from "@agent-teams/repository-mutation";
-function pendingKnownFileTransaction(options) {
-    const exactBuild = options.foundationVersion === options.installedVersion &&
-        options.foundationBuildIdentity === options.installedBuildIdentity;
+import { claimedArtifactCoordinate } from "./claimed-artifact-coordinate.js";
+/** Schema5 is opaque historical evidence, never a split-package recovery lease. */
+export function inspectKnownFileTransactionStatus(value) {
     return {
-        state: "pending",
-        operationKind: "known-file-transaction",
-        format: "known-file-transaction-envelope-v1",
-        foundationVersion: options.foundationVersion,
-        foundationBuildIdentity: options.foundationBuildIdentity,
-        recovery: {
-            commandId: "replace-known-file-recover",
-            exactFoundationVersion: options.foundationVersion,
-            exactFoundationBuildIdentity: options.foundationBuildIdentity
-        },
+        state: "manual-recovery-required",
+        reason: "recovery-handler-unavailable",
         diagnostics: [{
-                code: exactBuild
-                    ? "FOUNDATION_TRANSACTION_ACTIVE"
-                    : "FOUNDATION_TRANSACTION_VERSION_MISMATCH",
-                message: exactBuild
-                    ? "A pending known-file transaction must be recovered before another Foundation mutation can start."
-                    : `Foundation ${options.foundationVersion} (${options.foundationBuildIdentity}) must recover the pending known-file transaction before package ${options.installedVersion} (${options.installedBuildIdentity}) can mutate this repository.`
+                code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED",
+                message: `Untrusted Foundation schema5 evidence was preserved. Claimed @agent-teams/engineering-foundation coordinate: ${claimedArtifactCoordinate(value["foundation"])}. Only the exact recorded historical Foundation artifact can validate its supported ./mutation recovery route externally; this package cannot authorize recovery.`
             }]
     };
 }
-export function inspectKnownFileTransactionStatus(options) {
-    if (options.schemaVersion === 6) {
-        const owner = options.value["ownerArtifact"];
-        if (typeof owner !== "object" || owner === null || Array.isArray(owner)) {
-            return undefined;
-        }
-        const identity = owner;
-        if (typeof identity["version"] !== "string" ||
-            typeof identity["buildIdentity"] !== "string") {
-            return undefined;
-        }
-        return pendingKnownFileTransaction({
-            foundationVersion: identity["version"],
-            foundationBuildIdentity: identity["buildIdentity"],
-            installedVersion: options.installedVersion,
-            installedBuildIdentity: options.installedBuildIdentity
-        });
-    }
-    if (options.schemaVersion !== 5) {
-        return undefined;
-    }
-    try {
-        const foundation = options.value["foundation"];
-        if (typeof foundation !== "object" || foundation === null || Array.isArray(foundation)) {
-            throw new Error("invalid identity");
-        }
-        const identity = foundation;
-        const digest = options.value["envelopeDigest"];
-        const body = { ...options.value };
-        delete body["envelopeDigest"];
-        if (Object.keys(identity).toSorted().join(",") !== "buildIdentity,version" ||
-            typeof identity["version"] !== "string" ||
-            !/^sha256:[0-9a-f]{64}$/u.test(String(identity["buildIdentity"])) ||
-            digest !== sha256Json(body)) {
-            throw new Error("invalid legacy envelope");
-        }
-    }
-    catch {
-        return {
-            state: "manual-recovery-required",
-            reason: "corrupt-or-incompatible",
-            diagnostics: [{
-                    code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED",
-                    message: "The Foundation known-file transaction envelope is corrupt, tampered, or incompatible; it was preserved."
-                }]
-        };
-    }
-    return pendingKnownFileTransaction({
-        foundationVersion: options.value["foundation"]["version"],
-        foundationBuildIdentity: options.value["foundation"]["buildIdentity"],
-        installedVersion: options.installedVersion,
-        installedBuildIdentity: options.installedBuildIdentity
-    });
-}
 //# sourceMappingURL=known-file-transaction-status.js.map

package/dist/transaction-coordination/adapters/node/known-file-transaction-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"known-file-transaction-status.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/known-file-transaction-status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"known-file-transaction-status.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/known-file-transaction-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,mFAAmF;AACnF,MAAM,UAAU,iCAAiC,CAC/C,KAA8B;IAE9B,OAAO;QACL,KAAK,EAAE,0BAA0B;QACjC,MAAM,EAAE,8BAA8B;QACtC,WAAW,EAAE,CAAC;gBACZ,IAAI,EAAE,iDAAiD;gBACvD,OAAO,EAAE,gHAAgH,yBAAyB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,mKAAmK;aAC3U,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/transaction-coordination/adapters/node/legacy-document-transaction-status.d.ts

@@ -0,0 +1,3 @@
+import type { InternalFoundationTransactionStatus } from "../../application/model/internal-transaction-status.js";
+export declare function inspectLegacyDocumentTransaction(value: Record<string, unknown>, assertSchema: (schemaId: "foundation-transaction-envelope/v2", input: unknown, phase: string) => Promise<void>): Promise<InternalFoundationTransactionStatus>;
+//# sourceMappingURL=legacy-document-transaction-status.d.ts.map

package/dist/transaction-coordination/adapters/node/legacy-document-transaction-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-document-transaction-status.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/legacy-document-transaction-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,wDAAwD,CAAC;AASlH,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,YAAY,EAAE,CAAC,QAAQ,EAAE,oCAAoC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7G,OAAO,CAAC,mCAAmC,CAAC,CAgE9C"}

package/dist/transaction-coordination/adapters/node/legacy-document-transaction-status.js

@@ -0,0 +1,65 @@
+import { assertEnvelopeDigests } from "./legacy-envelope-digests.js";
+import { assertLegacyDocumentEnvelope, isKnownLegacyDocumentEnvelope } from "./legacy-document-envelope-v2.js";
+import { inspectDocumentTransactionBindings } from "./document-envelope-bindings.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export async function inspectLegacyDocumentTransaction(value, assertSchema) {
+    const legacyDocumentEnvelope = isKnownLegacyDocumentEnvelope(value);
+    if (legacyDocumentEnvelope) {
+        assertLegacyDocumentEnvelope(value);
+    }
+    else {
+        await assertSchema("foundation-transaction-envelope/v2", value, "foundation-transaction-slot");
+        assertEnvelopeDigests(value);
+    }
+    const foundation = value["foundation"];
+    const operationKind = value["operationKind"];
+    const journal = value["journal"];
+    if (!isRecord(foundation) ||
+        typeof foundation["version"] !== "string" ||
+        typeof foundation["buildIdentity"] !== "string" ||
+        !isRecord(journal) ||
+        !["document-authoring", "scaffolding"].includes(String(operationKind))) {
+        throw new Error("Foundation transaction envelope binding is invalid.");
+    }
+    const plan = journal["plan"];
+    if (!isRecord(plan)) {
+        throw new Error("Foundation transaction Plan binding is invalid.");
+    }
+    const compiler = plan["compiler"];
+    if (!isRecord(compiler) ||
+        compiler["version"] !== foundation["version"] ||
+        (operationKind === "document-authoring" &&
+            compiler["buildIdentity"] !== foundation["buildIdentity"])) {
+        throw new Error("Foundation transaction compiler binding is invalid.");
+    }
+    if (operationKind === "document-authoring") {
+        const documentStatus = inspectDocumentTransactionBindings({
+            foundation,
+            journal,
+            journalVersion: 1,
+            legacyDigestSemantics: legacyDocumentEnvelope,
+            plan,
+            state: value["state"]
+        });
+        if (documentStatus !== undefined) {
+            return documentStatus;
+        }
+    }
+    return {
+        state: "manual-recovery-required",
+        reason: "recovery-handler-unavailable",
+        operationKind: operationKind,
+        format: "envelope-v2",
+        foundationVersion: foundation["version"],
+        foundationBuildIdentity: foundation["buildIdentity"],
+        diagnostics: [
+            {
+                code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED",
+                message: `A verified ${String(operationKind)} envelope v2 from Foundation ${foundation["version"]} (${foundation["buildIdentity"]}) was preserved, but this release does not yet provide its recovery handler.`
+            }
+        ]
+    };
+}
+//# sourceMappingURL=legacy-document-transaction-status.js.map

package/dist/transaction-coordination/adapters/node/legacy-document-transaction-status.js.map

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

package/dist/transaction-coordination/adapters/node/legacy-envelope-digests.d.ts

@@ -0,0 +1,2 @@
+export declare function assertEnvelopeDigests(envelope: Record<string, unknown>): void;
+//# sourceMappingURL=legacy-envelope-digests.d.ts.map

package/dist/transaction-coordination/adapters/node/legacy-envelope-digests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-envelope-digests.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/legacy-envelope-digests.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAa7E"}

package/dist/transaction-coordination/adapters/node/legacy-envelope-digests.js

@@ -0,0 +1,16 @@
+import { sha256Json as sha256DocumentJson } from "@agent-teams/repository-mutation";
+import { legacyFoundationEnvelopeSha256Json } from "./legacy-document-envelope-v2.js";
+export function assertEnvelopeDigests(envelope) {
+    const sha256EnvelopeJson = (value) => envelope["operationKind"] === "scaffolding"
+        ? legacyFoundationEnvelopeSha256Json(value)
+        : sha256DocumentJson(value);
+    const journal = envelope["journal"];
+    if (envelope["payloadDigest"] !== sha256EnvelopeJson(journal)) {
+        throw new Error("Foundation transaction payload digest is invalid.");
+    }
+    const { envelopeDigest, ...body } = envelope;
+    if (envelopeDigest !== sha256EnvelopeJson(body)) {
+        throw new Error("Foundation transaction envelope digest is invalid.");
+    }
+}
+//# sourceMappingURL=legacy-envelope-digests.js.map

package/dist/transaction-coordination/adapters/node/legacy-envelope-digests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-envelope-digests.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/legacy-envelope-digests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAA2B,MAAM,kCAAkC,CAAC;AAC7G,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAEtF,MAAM,UAAU,qBAAqB,CAAC,QAAiC;IACrE,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAU,EAAE,CACpD,QAAQ,CAAC,eAAe,CAAC,KAAK,aAAa;QACzC,CAAC,CAAC,kCAAkC,CAAC,KAAK,CAAC;QAC3C,CAAC,CAAC,kBAAkB,CAAC,KAA2B,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,QAAQ,CAAC,eAAe,CAAC,KAAK,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;IAC7C,IAAI,cAAc,KAAK,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/transaction-coordination/adapters/node/node-foundation-cleanup-transition.js

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { mkdir, open, rename } from "node:fs/promises";
 import { join } from "node:path";
-import { FOUNDATION_TRANSACTION_CLEANUP_RESIDUE_PREFIX } from "../../../foundation-state-contract.js";
+import { FOUNDATION_TRANSACTION_CLEANUP_RESIDUE_PREFIX } from "../../application/model/foundation-transaction-identity.js";
 import { assertTerminalEvidenceDirectory, captureFileHandleIdentity, ensureTerminalEvidenceDirectory, readBoundedRegularFile } from "@agent-teams/repository-mutation/node";
 import { ensureFoundationStateDirectory, syncFoundationStateDirectoryStrictly } from "./node-foundation-state-directory.js";
 const nodeOperations = {

package/dist/transaction-coordination/adapters/node/node-foundation-cleanup-transition.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-foundation-cleanup-transition.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-cleanup-transition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-foundation-cleanup-transition.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-cleanup-transition.ts"],"names":[],"mappings":"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"}

package/dist/transaction-coordination/adapters/node/node-foundation-operation-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-foundation-operation-lock.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-operation-lock.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,sDAAsD,CAAC;AAG9D,qBAAa,2BAA4B,YAAW,uBAAuB;;IAGzE,YAAY,YAAY,EAAE,MAAM,EAE/B;IAEK,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,iCAAiC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CA4BvF;CACF"}
+{"version":3,"file":"node-foundation-operation-lock.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-operation-lock.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EAClC,MAAM,sDAAsD,CAAC;AAG9D,qBAAa,2BAA4B,YAAW,uBAAuB;;IAGzE,YAAY,YAAY,EAAE,MAAM,EAE/B;IAEK,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,iCAAiC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAkBvF;CACF"}

package/dist/transaction-coordination/adapters/node/node-foundation-operation-lock.js

@@ -1,6 +1,6 @@
 import { acquireMutationLease, releaseMutationLease, retainMutationBarrier } from "@agent-teams/repository-mutation/node";
 import { RepositoryMutationError } from "@agent-teams/repository-mutation";
-import { FoundationError } from "../../../errors.js";
+import { operationLockAcquisitionFailure, operationLockReleaseFailure } from "../../application/operation-lock-failure.js";
 export class NodeFoundationOperationLock {
     #consumerRoot;
     constructor(consumerRoot) {
@@ -12,9 +12,7 @@ export class NodeFoundationOperationLock {
             lease = await acquireMutationLease(this.#consumerRoot);
         }
         catch (error) {
-            throw new FoundationError("LOCAL_STATE_INVALID", error instanceof RepositoryMutationError
-                ? error.message
-                : "Another Foundation operation is active or its shared mutation lock is not safely recoverable.", { cause: error });
+            throw operationLockAcquisitionFailure(error, error instanceof RepositoryMutationError ? error.message : undefined);
         }
         let released = false;
         return async (options = {}) => {
@@ -28,7 +26,7 @@ export class NodeFoundationOperationLock {
                 await releaseMutationLease(lease);
             }
             catch (error) {
-                throw new FoundationError("LOCAL_STATE_INVALID", "Foundation could not release the shared mutation lock without violating ownership.", { cause: error });
+                throw operationLockReleaseFailure(error);
             }
             released = true;
         };

package/dist/transaction-coordination/adapters/node/node-foundation-operation-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-foundation-operation-lock.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-operation-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAM3E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,OAAO,2BAA2B;IAC7B,aAAa,CAAS;IAE/B,YAAY,YAAoB;QAC9B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,KAAoB,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,eAAe,CACvB,qBAAqB,EACrB,KAAK,YAAY,uBAAuB;gBACtC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,+FAA+F,EACnG,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;YAC5B,IAAI,QAAQ,EAAE,CAAC;gBAAA,OAAO;YAAA,CAAC;YACvB,IAAI,OAAO,CAAC,wBAAwB,KAAK,IAAI,EAAE,CAAC;gBAAA,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAAA,CAAC;YAC9E,IAAI,CAAC;gBACH,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,eAAe,CACvB,qBAAqB,EACrB,oFAAoF,EACpF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"node-foundation-operation-lock.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-operation-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAM3E,OAAO,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE3H,MAAM,OAAO,2BAA2B;IAC7B,aAAa,CAAS;IAE/B,YAAY,YAAoB;QAC9B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,KAAoB,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,+BAA+B,CAAC,KAAK,EAAE,KAAK,YAAY,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,KAAK,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;YAC5B,IAAI,QAAQ,EAAE,CAAC;gBAAA,OAAO;YAAA,CAAC;YACvB,IAAI,OAAO,CAAC,wBAAwB,KAAK,IAAI,EAAE,CAAC;gBAAA,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAAA,CAAC;YAC9E,IAAI,CAAC;gBACH,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,2BAA2B,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC;CACF"}

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-slot.d.ts

@@ -1,11 +1,11 @@
 import type { InternalFoundationTransactionStatus } from "../../application/model/internal-transaction-status.js";
 import type { FoundationTransactionSlot } from "../../application/ports/foundation-transaction-slot.js";
+import type { FoundationTransactionInspection } from "../../application/ports/foundation-transaction-inspection.js";
 export declare class NodeFoundationTransactionSlot implements FoundationTransactionSlot {
     #private;
     constructor(options: {
         readonly consumerRoot: string;
-        readonly installedBuildIdentity: string;
-        readonly installedVersion: string;
+        readonly inspection: FoundationTransactionInspection;
     });
     inspect(): Promise<InternalFoundationTransactionStatus>;
 }

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-slot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-foundation-transaction-slot.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-transaction-slot.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAEV,mCAAmC,EACpC,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AAwXxG,qBAAa,6BAA8B,YAAW,yBAAyB;;IAO7E,YAAY,OAAO,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;KACnC,EAUA;IAiEK,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAY5D;CACF"}
+{"version":3,"file":"node-foundation-transaction-slot.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/adapters/node/node-foundation-transaction-slot.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,mCAAmC,EACpC,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AACxG,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,8DAA8D,CAAC;AAyKpH,qBAAa,6BAA8B,YAAW,yBAAyB;;IAM7E,YAAY,OAAO,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,+BAA+B,CAAC;KACtD,EASA;IA6DK,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAY5D;CACF"}

package/dist/transaction-coordination/adapters/node/node-foundation-transaction-slot.js

@@ -1,18 +1,11 @@
 import { opendir } from "node:fs/promises";
 import { join } from "node:path";
 import { TextDecoder } from "node:util";
-import { FOUNDATION_TRANSACTION_FILE, FOUNDATION_LINK_STATE_FILE, FOUNDATION_REGISTRY_BACKUP, KNOWN_FILE_TRANSACTION_TEMPORARY_FILE, LOCAL_STATE_DIRECTORY } from "../../../foundation-state-contract.js";
-import { assertSchema } from "../../../schema-catalog.js";
-import { parseStrictJson } from "../../../strict-json.js";
+import { FOUNDATION_LINK_STATE_FILE, FOUNDATION_REGISTRY_BACKUP, FOUNDATION_TRANSACTION_FILE, KNOWN_FILE_TRANSACTION_TEMPORARY_FILE, LOCAL_STATE_DIRECTORY } from "../../application/model/foundation-transaction-identity.js";
+import { parseStrictJson } from "@agent-teams/repository-mutation/serialization";
 import { readBoundedRegularFile } from "@agent-teams/repository-mutation/node";
 import { portableRepositoryPathIdentity } from "@agent-teams/repository-mutation";
-import { assertLegacyDocumentEnvelope, isKnownLegacyDocumentEnvelope } from "./legacy-document-envelope-v2.js";
-import { inspectCurrentDocumentEnvelope, inspectDocumentTransactionBindings } from "./document-envelope-bindings.js";
 import { inspectFoundationTransitionEvidence } from "./foundation-transition-evidence.js";
-import { inspectKnownFileTransactionStatus } from "./known-file-transaction-status.js";
-import { pendingDocumentTransaction } from "./document-transaction-status.js";
-import { inspectSchema6TransactionStatus } from "./schema6-transaction-status.js";
-import { assertEnvelopeDigests, assertLegacyScaffoldingJournal } from "./legacy-scaffolding-transaction-validation.js";
 const maximumTransactionBytes = 32 * 1024 * 1024;
 const maximumLinkStateBytes = 64 * 1024;
 const maximumStateDirectoryEntries = 1024;
@@ -37,35 +30,6 @@ function manual(reason, message) {
         ]
     };
 }
-function recoveryRoute(exactFoundationVersion) {
-    return {
-        commandId: "scaffold-recover",
-        exactFoundationVersion
-    };
-}
-function pending(options) {
-    const diagnostics = [];
-    if (options.foundationVersion !== options.installedVersion) {
-        diagnostics.push({
-            code: "FOUNDATION_TRANSACTION_VERSION_MISMATCH",
-            message: `Foundation ${options.foundationVersion} must recover the pending ${options.operationKind} transaction before package ${options.installedVersion} (${options.installedBuildIdentity}) can mutate this repository.`
-        });
-    }
-    else {
-        diagnostics.push({
-            code: "FOUNDATION_TRANSACTION_ACTIVE",
-            message: `A pending ${options.operationKind} transaction must be recovered before another Foundation mutation can start.`
-        });
-    }
-    return {
-        state: "pending",
-        operationKind: options.operationKind,
-        format: options.format,
-        foundationVersion: options.foundationVersion,
-        recovery: recoveryRoute(options.foundationVersion),
-        diagnostics
-    };
-}
 function localModePending(message) {
     return {
         state: "pending",
@@ -165,141 +129,13 @@ async function inspectLocalModeEvidence(stateDirectory) {
         return manual("local-mode-evidence-invalid", "Foundation local-mode recovery evidence is invalid and was preserved.");
     }
 }
-async function inspectLegacyScaffoldingJournal(options) {
-    await assertSchema("scaffold-recovery-journal/v1", options.value, "foundation-transaction-slot");
-    const journal = options.value;
-    assertLegacyScaffoldingJournal(options.value);
-    const compiler = journal.plan["compiler"];
-    if (!isRecord(compiler) || typeof compiler["version"] !== "string") {
-        throw new Error("Legacy scaffolding journal compiler version is invalid.");
-    }
-    return pending({
-        operationKind: "scaffolding",
-        format: "legacy-scaffolding-v1",
-        foundationVersion: compiler["version"],
-        installedVersion: options.installedVersion,
-        installedBuildIdentity: options.installedBuildIdentity
-    });
-}
-function transactionSchemaVersion(value) {
-    const schemaVersion = value["schemaVersion"];
-    return typeof schemaVersion === "number" ? schemaVersion : Number.NaN;
-}
-function inspectUnsupportedTransaction(options) {
-    return inspectKnownFileTransactionStatus(options) ?? manual("unsupported-schema", `Foundation transaction schema version ${String(options.schemaVersion)} is unsupported and was preserved.`);
-}
-async function inspectParsedTransaction(value, installedVersion, installedBuildIdentity) {
-    if (!isRecord(value)) {
-        return manual("invalid-slot", "The Foundation transaction slot is invalid and was preserved.");
-    }
-    const schemaVersion = transactionSchemaVersion(value);
-    switch (schemaVersion) {
-        case 1:
-            return inspectLegacyScaffoldingJournal({
-                value,
-                installedVersion,
-                installedBuildIdentity
-            });
-        case 3:
-            return inspectCurrentDocumentEnvelope({
-                value, installedVersion, installedBuildIdentity, pending: pendingDocumentTransaction
-            });
-        case 4:
-            return inspectCurrentDocumentEnvelope({
-                value,
-                installedVersion,
-                installedBuildIdentity,
-                pending: (identity) => pendingDocumentTransaction({
-                    ...identity,
-                    format: "document-authoring-envelope-v4"
-                })
-            });
-        case 6: {
-            return inspectSchema6TransactionStatus({
-                value,
-                installedFoundationVersion: installedVersion,
-                installedFoundationBuildIdentity: installedBuildIdentity
-            });
-        }
-        case 2: {
-            const legacyDocumentEnvelope = isKnownLegacyDocumentEnvelope(value);
-            if (legacyDocumentEnvelope) {
-                assertLegacyDocumentEnvelope(value);
-            }
-            else {
-                await assertSchema("foundation-transaction-envelope/v2", value, "foundation-transaction-slot");
-                assertEnvelopeDigests(value);
-            }
-            const foundation = value["foundation"];
-            const operationKind = value["operationKind"];
-            const journal = value["journal"];
-            if (!isRecord(foundation) ||
-                typeof foundation["version"] !== "string" ||
-                typeof foundation["buildIdentity"] !== "string" ||
-                !isRecord(journal) ||
-                !["document-authoring", "scaffolding"].includes(String(operationKind))) {
-                throw new Error("Foundation transaction envelope binding is invalid.");
-            }
-            const plan = journal["plan"];
-            if (!isRecord(plan)) {
-                throw new Error("Foundation transaction Plan binding is invalid.");
-            }
-            const compiler = plan["compiler"];
-            if (!isRecord(compiler) ||
-                compiler["version"] !== foundation["version"] ||
-                (operationKind === "document-authoring" &&
-                    compiler["buildIdentity"] !== foundation["buildIdentity"])) {
-                throw new Error("Foundation transaction compiler binding is invalid.");
-            }
-            if (operationKind === "document-authoring") {
-                const documentStatus = inspectDocumentTransactionBindings({
-                    foundation,
-                    journal,
-                    journalVersion: 1,
-                    legacyDigestSemantics: legacyDocumentEnvelope,
-                    plan,
-                    state: value["state"]
-                });
-                if (documentStatus !== undefined) {
-                    return documentStatus;
-                }
-            }
-            else {
-                assertLegacyScaffoldingJournal(journal);
-            }
-            return {
-                state: "manual-recovery-required",
-                reason: "recovery-handler-unavailable",
-                operationKind: operationKind,
-                format: "envelope-v2",
-                foundationVersion: foundation["version"],
-                foundationBuildIdentity: foundation["buildIdentity"],
-                diagnostics: [
-                    {
-                        code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED",
-                        message: `A verified ${String(operationKind)} envelope v2 from Foundation ${foundation["version"]} (${foundation["buildIdentity"]}) was preserved, but this release does not yet provide its recovery handler.`
-                    }
-                ]
-            };
-        }
-        default:
-            return inspectUnsupportedTransaction({
-                value,
-                schemaVersion,
-                installedVersion,
-                installedBuildIdentity
-            });
-    }
-}
 export class NodeFoundationTransactionSlot {
-    #installedBuildIdentity;
-    #installedVersion;
+    #inspection;
     #stateDirectory;
     #slotPath;
     #knownFileTemporaryPath;
     constructor(options) {
-        this.#installedBuildIdentity = options.installedBuildIdentity;
-        this.#installedVersion = options.installedVersion;
+        this.#inspection = options.inspection;
         const stateDirectory = join(options.consumerRoot, LOCAL_STATE_DIRECTORY);
         this.#stateDirectory = stateDirectory;
         this.#slotPath = join(stateDirectory, FOUNDATION_TRANSACTION_FILE);
@@ -338,7 +174,7 @@ export class NodeFoundationTransactionSlot {
         }
         try {
             const source = strictUtf8.decode(record.bytes);
-            return await inspectParsedTransaction(parseStrictJson(source), this.#installedVersion, this.#installedBuildIdentity);
+            return await this.#inspection.inspect(parseStrictJson(source));
         }
         catch {
             return manual("corrupt-or-incompatible", "The Foundation transaction slot is corrupt, tampered, or incompatible; it was preserved.");