@agent-teams/engineering-foundation 1.0.2 → 1.1.1

package/dist/transaction-coordination/application/model/foundation-transaction-identity.d.ts

@@ -0,0 +1,11 @@
+export declare const FOUNDATION_LINK_STATE_FILE: "foundation-link.json";
+export declare const FOUNDATION_REGISTRY_BACKUP: "foundation-registry-backup";
+export declare const LOCAL_STATE_DIRECTORY: ".agent-teams-local";
+export declare const LOCAL_OPERATION_LOCK: "foundation-operation.lock";
+export declare const FOUNDATION_TRANSACTION_FILE: "scaffolding-transaction.json";
+export declare const FOUNDATION_TRANSACTION_TEMPORARY_FILE: "scaffolding-transaction.json.tmp";
+export declare const KNOWN_FILE_TRANSACTION_TEMPORARY_FILE: "scaffolding-transaction.json.known-file.tmp";
+export declare const FOUNDATION_TRANSACTION_CLEANUP_RESIDUE_PREFIX: "foundation-transaction.cleanup-residue.";
+/** Exact installed artifact digest used by transaction recovery. */
+export type FoundationBuildIdentity = `sha256:${string}`;
+//# sourceMappingURL=foundation-transaction-identity.d.ts.map

package/dist/transaction-coordination/application/model/foundation-transaction-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-identity.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/model/foundation-transaction-identity.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,EAAG,sBAA+B,CAAC;AAC1E,eAAO,MAAM,0BAA0B,EACrC,4BAAqC,CAAC;AAExC,eAAO,MAAM,qBAAqB,EAAG,oBAA6B,CAAC;AACnE,eAAO,MAAM,oBAAoB,EAAG,2BAAoC,CAAC;AACzE,eAAO,MAAM,2BAA2B,EACtC,8BAAuC,CAAC;AAC1C,eAAO,MAAM,qCAAqC,oCACH,CAAC;AAChD,eAAO,MAAM,qCAAqC,+CACQ,CAAC;AAC3D,eAAO,MAAM,6CAA6C,EACxD,yCAAkD,CAAC;AAErD,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,UAAU,MAAM,EAAE,CAAC"}

package/dist/transaction-coordination/application/model/foundation-transaction-identity.js

@@ -0,0 +1,9 @@
+export const FOUNDATION_LINK_STATE_FILE = "foundation-link.json";
+export const FOUNDATION_REGISTRY_BACKUP = "foundation-registry-backup";
+export const LOCAL_STATE_DIRECTORY = ".agent-teams-local";
+export const LOCAL_OPERATION_LOCK = "foundation-operation.lock";
+export const FOUNDATION_TRANSACTION_FILE = "scaffolding-transaction.json";
+export const FOUNDATION_TRANSACTION_TEMPORARY_FILE = `${FOUNDATION_TRANSACTION_FILE}.tmp`;
+export const KNOWN_FILE_TRANSACTION_TEMPORARY_FILE = `${FOUNDATION_TRANSACTION_FILE}.known-file.tmp`;
+export const FOUNDATION_TRANSACTION_CLEANUP_RESIDUE_PREFIX = "foundation-transaction.cleanup-residue.";
+//# sourceMappingURL=foundation-transaction-identity.js.map

package/dist/transaction-coordination/application/model/foundation-transaction-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-identity.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/model/foundation-transaction-identity.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,sBAA+B,CAAC;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GACrC,4BAAqC,CAAC;AAExC,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAA6B,CAAC;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAAoC,CAAC;AACzE,MAAM,CAAC,MAAM,2BAA2B,GACtC,8BAAuC,CAAC;AAC1C,MAAM,CAAC,MAAM,qCAAqC,GAChD,GAAG,2BAA2B,MAAe,CAAC;AAChD,MAAM,CAAC,MAAM,qCAAqC,GAChD,GAAG,2BAA2B,iBAA0B,CAAC;AAC3D,MAAM,CAAC,MAAM,6CAA6C,GACxD,yCAAkD,CAAC"}

package/dist/transaction-coordination/application/model/internal-transaction-status.d.ts

@@ -1,22 +1,22 @@
 import type { FoundationManualRecoveryReason, FoundationTransactionDiagnostic, FoundationTransactionStatus } from "./transaction-status.js";
+interface ObservedRecoveryArtifact {
+    readonly name: string;
+    readonly version: string;
+    readonly buildIdentity: string;
+}
 export type InternalFoundationManualRecoveryReason = FoundationManualRecoveryReason | "journal-transition-residue" | "physical-identity-unverifiable";
 export type InternalFoundationTransactionStatus = Exclude<FoundationTransactionStatus, {
     readonly state: "manual-recovery-required";
-}> | {
-    readonly state: "pending";
-    readonly operationKind: "document-authoring";
-    readonly format: "document-authoring-envelope-v3" | "document-authoring-envelope-v4";
-    readonly foundationVersion: string;
-    readonly foundationBuildIdentity: string;
-    readonly recovery: {
-        readonly commandId: "docs-recover";
-        readonly exactFoundationVersion: string;
-        readonly exactFoundationBuildIdentity: string;
-    };
-    readonly diagnostics: readonly FoundationTransactionDiagnostic[];
 } | {
+    readonly operationKind: "known-file-transaction";
+}> | {
     readonly state: "pending";
     readonly operationKind: "known-file-transaction";
+    readonly recoveryArtifacts?: {
+        readonly schemaVersion: number;
+        readonly ownerArtifact: ObservedRecoveryArtifact;
+        readonly kernelArtifact: ObservedRecoveryArtifact;
+    };
     readonly format: "known-file-transaction-envelope-v1";
     readonly foundationVersion: string;
     readonly foundationBuildIdentity: string;
@@ -35,4 +35,5 @@ export type InternalFoundationTransactionStatus = Exclude<FoundationTransactionS
     readonly foundationBuildIdentity?: string;
     readonly diagnostics: readonly FoundationTransactionDiagnostic[];
 };
+export {};
 //# sourceMappingURL=internal-transaction-status.d.ts.map

package/dist/transaction-coordination/application/model/internal-transaction-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-transaction-status.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/model/internal-transaction-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,2BAA2B,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,sCAAsC,GAC9C,8BAA8B,GAC9B,4BAA4B,GAC5B,gCAAgC,CAAC;AAErC,MAAM,MAAM,mCAAmC,GAC3C,OAAO,CACL,2BAA2B,EAC3B;IAAE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,CAC/C,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,gCAAgC,GAAG,gCAAgC,CAAC;IACrF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;QACnC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;KAC/C,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;QACjD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;KAC/C,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,sCAAsC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,GAAG,wBAAwB,GAAG,aAAa,CAAC;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,oCAAoC,CAAC;IACvG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,CAAC"}
+{"version":3,"file":"internal-transaction-status.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/model/internal-transaction-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,2BAA2B,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,UAAU,wBAAwB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,sCAAsC,GAC9C,8BAA8B,GAC9B,4BAA4B,GAC5B,gCAAgC,CAAC;AAErC,MAAM,MAAM,mCAAmC,GAC3C,OAAO,CACL,2BAA2B,EAC3B;IAAE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAA;CAAE,CACtG,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC;QACjD,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;KACnD,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;QACjD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;KAC/C,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,sCAAsC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,GAAG,wBAAwB,GAAG,aAAa,CAAC;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,oCAAoC,CAAC;IACvG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,CAAC"}

package/dist/transaction-coordination/application/operation-lock-failure.d.ts

@@ -0,0 +1,4 @@
+import { FoundationError } from "../../features/validation-reporting/api.js";
+export declare function operationLockAcquisitionFailure(cause: unknown, providerMessage?: string): FoundationError;
+export declare function operationLockReleaseFailure(cause: unknown): FoundationError;
+//# sourceMappingURL=operation-lock-failure.d.ts.map

package/dist/transaction-coordination/application/operation-lock-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-lock-failure.d.ts","sourceRoot":"","sources":["../../../src/transaction-coordination/application/operation-lock-failure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,eAAe,CAMzG;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAM3E"}

package/dist/transaction-coordination/application/operation-lock-failure.js

@@ -0,0 +1,8 @@
+import { FoundationError } from "../../features/validation-reporting/api.js";
+export function operationLockAcquisitionFailure(cause, providerMessage) {
+    return new FoundationError("LOCAL_STATE_INVALID", providerMessage ?? "Another Foundation operation is active or its shared mutation lock is not safely recoverable.", { cause });
+}
+export function operationLockReleaseFailure(cause) {
+    return new FoundationError("LOCAL_STATE_INVALID", "Foundation could not release the shared mutation lock without violating ownership.", { cause });
+}
+//# sourceMappingURL=operation-lock-failure.js.map

package/dist/transaction-coordination/application/operation-lock-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-lock-failure.js","sourceRoot":"","sources":["../../../src/transaction-coordination/application/operation-lock-failure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,MAAM,UAAU,+BAA+B,CAAC,KAAc,EAAE,eAAwB;IACtF,OAAO,IAAI,eAAe,CACxB,qBAAqB,EACrB,eAAe,IAAI,+FAA+F,EAClH,EAAE,KAAK,EAAE,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,OAAO,IAAI,eAAe,CACxB,qBAAqB,EACrB,oFAAoF,EACpF,EAAE,KAAK,EAAE,CACV,CAAC;AACJ,CAAC"}

package/dist/transaction-coordination/application/ports/foundation-transaction-inspection.d.ts

@@ -0,0 +1,24 @@
+import type { InternalFoundationTransactionStatus } from "../model/internal-transaction-status.js";
+export interface FoundationTransactionInspection {
+    inspect(value: unknown): Promise<InternalFoundationTransactionStatus>;
+}
+export interface InstalledFoundationInspectionIdentity {
+    readonly installedVersion: string;
+    readonly installedBuildIdentity: string;
+}
+type RecordInspection = (value: Record<string, unknown>) => InternalFoundationTransactionStatus | Promise<InternalFoundationTransactionStatus>;
+type InstalledOwnerInspection = (input: InstalledFoundationInspectionIdentity & {
+    readonly value: Record<string, unknown>;
+}) => Promise<InternalFoundationTransactionStatus>;
+/** Fixed supported owners, wired by composition; no runtime registration. */
+export interface FoundationTransactionInspectors {
+    readonly legacyScaffoldingJournal: InstalledOwnerInspection;
+    readonly legacyScaffoldingEnvelope: RecordInspection;
+    readonly legacyDocument: RecordInspection;
+    readonly document: RecordInspection;
+    readonly knownFile: RecordInspection;
+    readonly currentScaffolding: InstalledOwnerInspection;
+    readonly schema6: RecordInspection;
+}
+export {};
+//# sourceMappingURL=foundation-transaction-inspection.d.ts.map

package/dist/transaction-coordination/application/ports/foundation-transaction-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-inspection.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/ports/foundation-transaction-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,yCAAyC,CAAC;AAEnG,MAAM,WAAW,+BAA+B;IAC9C,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,KAAK,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,mCAAmC,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;AAC/I,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,qCAAqC,GAAG;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,KAAK,OAAO,CAAC,mCAAmC,CAAC,CAAC;AAEnD,6EAA6E;AAC7E,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,wBAAwB,EAAE,wBAAwB,CAAC;IAC5D,QAAQ,CAAC,yBAAyB,EAAE,gBAAgB,CAAC;IACrD,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC"}

package/dist/transaction-coordination/application/ports/foundation-transaction-inspection.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=foundation-transaction-inspection.js.map

package/dist/transaction-coordination/application/ports/foundation-transaction-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-inspection.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/ports/foundation-transaction-inspection.ts"],"names":[],"mappings":""}

package/dist/transaction-coordination/application/ports/foundation-transaction-slot-factory.d.ts

@@ -0,0 +1,10 @@
+import type { FoundationTransactionSlot } from "./foundation-transaction-slot.js";
+/** Exact installed identity and canonical operation root needed to select a slot. */
+export interface FoundationTransactionSlotFactory {
+    (options: {
+        readonly consumerRoot: string;
+        readonly installedVersion: string;
+        readonly installedBuildIdentity: string;
+    }): FoundationTransactionSlot;
+}
+//# sourceMappingURL=foundation-transaction-slot-factory.d.ts.map

package/dist/transaction-coordination/application/ports/foundation-transaction-slot-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-slot-factory.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/ports/foundation-transaction-slot-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAElF,qFAAqF;AACrF,MAAM,WAAW,gCAAgC;IAC/C,CAAC,OAAO,EAAE;QACR,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;KACzC,GAAG,yBAAyB,CAAC;CAC/B"}

package/dist/transaction-coordination/application/ports/foundation-transaction-slot-factory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=foundation-transaction-slot-factory.js.map

package/dist/transaction-coordination/application/ports/foundation-transaction-slot-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-slot-factory.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/ports/foundation-transaction-slot-factory.ts"],"names":[],"mappings":""}

package/dist/transaction-coordination/application/use-cases/inspect-foundation-transaction.d.ts

@@ -0,0 +1,3 @@
+import type { FoundationTransactionInspection, FoundationTransactionInspectors, InstalledFoundationInspectionIdentity } from "../ports/foundation-transaction-inspection.js";
+export declare function createFoundationTransactionInspection(installed: InstalledFoundationInspectionIdentity, inspectors: FoundationTransactionInspectors): FoundationTransactionInspection;
+//# sourceMappingURL=inspect-foundation-transaction.d.ts.map

package/dist/transaction-coordination/application/use-cases/inspect-foundation-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-foundation-transaction.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/use-cases/inspect-foundation-transaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,+BAA+B,EAC/B,+BAA+B,EAC/B,qCAAqC,EACtC,MAAM,+CAA+C,CAAC;AAEvD,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,qCAAqC,EAChD,UAAU,EAAE,+BAA+B,GAC1C,+BAA+B,CAEjC"}

package/dist/transaction-coordination/application/use-cases/inspect-foundation-transaction.js

@@ -0,0 +1,47 @@
+export function createFoundationTransactionInspection(installed, inspectors) {
+    return { inspect: (value) => inspectFoundationTransaction(value, installed, inspectors) };
+}
+async function inspectFoundationTransaction(value, installed, inspectors) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return {
+            state: "manual-recovery-required",
+            reason: "invalid-slot",
+            diagnostics: [{
+                    code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED",
+                    message: "The Foundation transaction slot is invalid and was preserved."
+                }]
+        };
+    }
+    const record = value;
+    const schemaVersion = typeof record["schemaVersion"] === "number"
+        ? record["schemaVersion"] : Number.NaN;
+    switch (schemaVersion) {
+        case 1:
+            return inspectors.legacyScaffoldingJournal({ value: record, ...installed });
+        case 2:
+            return record["operationKind"] === "scaffolding"
+                ? inspectors.legacyScaffoldingEnvelope(record)
+                : inspectors.legacyDocument(record);
+        case 3:
+        case 4:
+            return inspectors.document(record);
+        case 5:
+            return inspectors.knownFile(record);
+        case 6:
+            return record["operationKind"] === "scaffolding"
+                ? inspectors.currentScaffolding({
+                    value: record, ...installed
+                })
+                : inspectors.schema6(record);
+        default:
+            return {
+                state: "manual-recovery-required",
+                reason: "unsupported-schema",
+                diagnostics: [{
+                        code: "FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED",
+                        message: `Foundation transaction schema version ${String(schemaVersion)} is unsupported and was preserved.`
+                    }]
+            };
+    }
+}
+//# sourceMappingURL=inspect-foundation-transaction.js.map

package/dist/transaction-coordination/application/use-cases/inspect-foundation-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-foundation-transaction.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/use-cases/inspect-foundation-transaction.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,qCAAqC,CACnD,SAAgD,EAChD,UAA2C;IAE3C,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,4BAA4B,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,KAAc,EACd,SAAgD,EAChD,UAA2C;IAE3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO;YACL,KAAK,EAAE,0BAA0B;YACjC,MAAM,EAAE,cAAc;YACtB,WAAW,EAAE,CAAC;oBACZ,IAAI,EAAE,iDAAiD;oBACvD,OAAO,EAAE,+DAA+D;iBACzE,CAAC;SACH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,aAAa,GAAG,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,QAAQ;QAC/D,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IACzC,QAAQ,aAAa,EAAE,CAAC;QACxB,KAAK,CAAC;YACJ,OAAO,UAAU,CAAC,wBAAwB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC9E,KAAK,CAAC;YACJ,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,aAAa;gBAC9C,CAAC,CAAC,UAAU,CAAC,yBAAyB,CAAC,MAAM,CAAC;gBAC9C,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,CAAC,CAAC;QACP,KAAK,CAAC;YACJ,OAAO,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,CAAC;YACJ,OAAO,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC;YACJ,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,aAAa;gBAC9C,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC;oBAC5B,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS;iBAC5B,CAAC;gBACJ,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC;YACE,OAAO;gBACL,KAAK,EAAE,0BAA0B;gBACjC,MAAM,EAAE,oBAAoB;gBAC5B,WAAW,EAAE,CAAC;wBACZ,IAAI,EAAE,iDAAiD;wBACvD,OAAO,EAAE,yCAAyC,MAAM,CAAC,aAAa,CAAC,oCAAoC;qBAC5G,CAAC;aACH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/transaction-coordination/composition/node-coordinator.d.ts

@@ -0,0 +1,6 @@
+import { FoundationTransactionCoordinator } from "../application/foundation-transaction-coordinator.js";
+import type { FoundationTransactionSlotFactory } from "../application/ports/foundation-transaction-slot-factory.js";
+export declare function createFoundationTransactionCoordinatorFactory(createNodeFoundationTransactionSlot: FoundationTransactionSlotFactory): {
+    createNodeFoundationTransactionCoordinator(consumerRoot: string): Promise<FoundationTransactionCoordinator>;
+};
+//# sourceMappingURL=node-coordinator.d.ts.map

package/dist/transaction-coordination/composition/node-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-coordinator.d.ts","sourceRoot":"","sources":["../../../src/transaction-coordination/composition/node-coordinator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AAGxG,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,6DAA6D,CAAC;AAEpH,wBAAgB,6CAA6C,CAAC,mCAAmC,EAAE,gCAAgC;IAClH,0CAA0C,eACzC,MAAM,GACnB,OAAO,CAAC,gCAAgC,CAAC;EAe7C"}

package/dist/transaction-coordination/composition/node-coordinator.js

@@ -0,0 +1,24 @@
+import { realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+import { installedFoundationVersion } from "../adapters/node/installed-foundation-version.js";
+import { FoundationTransactionCoordinator } from "../application/foundation-transaction-coordinator.js";
+import { installedFoundationBuildIdentity } from "../adapters/node/installed-foundation-build-identity.js";
+import { NodeFoundationOperationLock } from "../adapters/node/node-foundation-operation-lock.js";
+export function createFoundationTransactionCoordinatorFactory(createNodeFoundationTransactionSlot) {
+    return { async createNodeFoundationTransactionCoordinator(consumerRoot) {
+            const canonicalRoot = await realpath(resolve(consumerRoot));
+            const [installedVersion, installedBuildIdentity] = await Promise.all([
+                installedFoundationVersion(),
+                installedFoundationBuildIdentity()
+            ]);
+            return new FoundationTransactionCoordinator({
+                lock: new NodeFoundationOperationLock(canonicalRoot),
+                slot: createNodeFoundationTransactionSlot({
+                    consumerRoot: canonicalRoot,
+                    installedVersion,
+                    installedBuildIdentity
+                })
+            });
+        } };
+}
+//# sourceMappingURL=node-coordinator.js.map

package/dist/transaction-coordination/composition/node-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-coordinator.js","sourceRoot":"","sources":["../../../src/transaction-coordination/composition/node-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAC9F,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,EAAE,gCAAgC,EAAE,MAAM,yDAAyD,CAAC;AAC3G,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAGjG,MAAM,UAAU,6CAA6C,CAAC,mCAAqE;IACjI,OAAO,EAAE,KAAK,CAAC,0CAA0C,CACvD,YAAoB;YAEpB,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;YAC5D,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACnE,0BAA0B,EAAE;gBAC5B,gCAAgC,EAAE;aACnC,CAAC,CAAC;YACH,OAAO,IAAI,gCAAgC,CAAC;gBAC1C,IAAI,EAAE,IAAI,2BAA2B,CAAC,aAAa,CAAC;gBACpD,IAAI,EAAE,mCAAmC,CAAC;oBACxC,YAAY,EAAE,aAAa;oBAC3B,gBAAgB;oBAChB,sBAAsB;iBACvB,CAAC;aACH,CAAC,CAAC;QACL,CAAC,EAAE,CAAC;AACN,CAAC"}

package/dist/transaction-coordination/composition/node-inspection.d.ts

@@ -0,0 +1,7 @@
+import { inspectLegacyDocumentTransaction } from "../adapters/node/legacy-document-transaction-status.js";
+import { type FoundationTransactionInspection, type InstalledFoundationInspectionIdentity } from "../inspection.js";
+import type { FoundationTransactionInspectors } from "../application/ports/foundation-transaction-inspection.js";
+export declare function createNodeFoundationTransactionInspection(assertSchema: Parameters<typeof inspectLegacyDocumentTransaction>[1], scaffolding: Pick<FoundationTransactionInspectors, "legacyScaffoldingJournal" | "legacyScaffoldingEnvelope" | "currentScaffolding">): {
+    createFoundationTransactionInspection(installed: InstalledFoundationInspectionIdentity): FoundationTransactionInspection;
+};
+//# sourceMappingURL=node-inspection.d.ts.map

package/dist/transaction-coordination/composition/node-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-inspection.d.ts","sourceRoot":"","sources":["../../../src/transaction-coordination/composition/node-inspection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,wDAAwD,CAAC;AAG1G,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,qCAAqC,EAC3C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2DAA2D,CAAC;AAEjH,wBAAgB,yCAAyC,CACvD,YAAY,EAAE,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC,CAAC,CAAC,EACpE,WAAW,EAAE,IAAI,CAAC,+BAA+B,EAAE,0BAA0B,GAAG,2BAA2B,GAAG,oBAAoB,CAAC;IAGjI,qCAAqC,YAAY,qCAAqC,GAAG,+BAA+B;EAY3H"}

package/dist/transaction-coordination/composition/node-inspection.js

@@ -0,0 +1,21 @@
+import { inspectDocumentTransactionStatus } from "../adapters/node/document-transaction-status.js";
+import { inspectLegacyDocumentTransaction } from "../adapters/node/legacy-document-transaction-status.js";
+import { inspectKnownFileTransactionStatus } from "../adapters/node/known-file-transaction-status.js";
+import { inspectSchema6TransactionStatus } from "../adapters/node/schema6-transaction-status.js";
+import { createFoundationTransactionInspection as createInspection } from "../inspection.js";
+export function createNodeFoundationTransactionInspection(assertSchema, scaffolding) {
+    return {
+        createFoundationTransactionInspection(installed) {
+            return createInspection(installed, {
+                legacyScaffoldingJournal: scaffolding.legacyScaffoldingJournal,
+                legacyScaffoldingEnvelope: scaffolding.legacyScaffoldingEnvelope,
+                legacyDocument: (value) => inspectLegacyDocumentTransaction(value, assertSchema),
+                document: inspectDocumentTransactionStatus,
+                knownFile: inspectKnownFileTransactionStatus,
+                currentScaffolding: scaffolding.currentScaffolding,
+                schema6: inspectSchema6TransactionStatus
+            });
+        }
+    };
+}
+//# sourceMappingURL=node-inspection.js.map

package/dist/transaction-coordination/composition/node-inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-inspection.js","sourceRoot":"","sources":["../../../src/transaction-coordination/composition/node-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AACnG,OAAO,EAAE,gCAAgC,EAAE,MAAM,wDAAwD,CAAC;AAC1G,OAAO,EAAE,iCAAiC,EAAE,MAAM,mDAAmD,CAAC;AACtG,OAAO,EAAE,+BAA+B,EAAE,MAAM,gDAAgD,CAAC;AACjG,OAAO,EACL,qCAAqC,IAAI,gBAAgB,EAG1D,MAAM,kBAAkB,CAAC;AAG1B,MAAM,UAAU,yCAAyC,CACvD,YAAoE,EACpE,WAAmI;IAEnI,OAAO;QACL,qCAAqC,CAAC,SAAgD;YACpF,OAAO,gBAAgB,CAAC,SAAS,EAAE;gBACjC,wBAAwB,EAAE,WAAW,CAAC,wBAAwB;gBAC9D,yBAAyB,EAAE,WAAW,CAAC,yBAAyB;gBAChE,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,gCAAgC,CAAC,KAAK,EAAE,YAAY,CAAC;gBAChF,QAAQ,EAAE,gCAAgC;gBAC1C,SAAS,EAAE,iCAAiC;gBAC5C,kBAAkB,EAAE,WAAW,CAAC,kBAAkB;gBAClD,OAAO,EAAE,+BAA+B;aACzC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/transaction-coordination/inspection.d.ts

@@ -0,0 +1,3 @@
+export { createFoundationTransactionInspection } from "./application/use-cases/inspect-foundation-transaction.js";
+export type { FoundationTransactionInspection, InstalledFoundationInspectionIdentity } from "./application/ports/foundation-transaction-inspection.js";
+//# sourceMappingURL=inspection.d.ts.map

package/dist/transaction-coordination/inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/transaction-coordination/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,2DAA2D,CAAC;AAClH,YAAY,EACV,+BAA+B,EAC/B,qCAAqC,EACtC,MAAM,0DAA0D,CAAC"}

package/dist/transaction-coordination/inspection.js

@@ -0,0 +1,2 @@
+export { createFoundationTransactionInspection } from "./application/use-cases/inspect-foundation-transaction.js";
+//# sourceMappingURL=inspection.js.map

package/dist/transaction-coordination/inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.js","sourceRoot":"","sources":["../../src/transaction-coordination/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,2DAA2D,CAAC"}

package/dist/transaction-coordination/node.d.ts

@@ -0,0 +1,3 @@
+export { inspectInstalledFoundationTransaction } from "./adapters/node/inspect-installed-foundation-transaction.js";
+export { ensureFoundationStateDirectory, pruneFoundationStateDirectory, syncFoundationStateDirectory } from "./adapters/node/node-foundation-state-directory.js";
+//# sourceMappingURL=node.d.ts.map

package/dist/transaction-coordination/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/transaction-coordination/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,6DAA6D,CAAC;AACpH,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/transaction-coordination/node.js

@@ -0,0 +1,3 @@
+export { inspectInstalledFoundationTransaction } from "./adapters/node/inspect-installed-foundation-transaction.js";
+export { ensureFoundationStateDirectory, pruneFoundationStateDirectory, syncFoundationStateDirectory } from "./adapters/node/node-foundation-state-directory.js";
+//# sourceMappingURL=node.js.map

package/dist/transaction-coordination/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/transaction-coordination/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,6DAA6D,CAAC;AACpH,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/transaction-coordination/schemas.d.ts

@@ -0,0 +1,8 @@
+export declare const TRANSACTION_COORDINATION_SCHEMA_IDS: readonly ["foundation-transaction-envelope/v2"];
+export declare const TRANSACTION_SCHEMA_FILES: {
+    readonly "document-plan/v1": "assets/transaction-coordination/historical/document-plan-v1.schema.json";
+};
+export declare const TRANSACTION_SCHEMA_DEPENDENCIES: {
+    readonly "foundation-transaction-envelope/v2": readonly ["document-intent/v1", "document-plan/v1", "scaffold-plan/v1", "scaffold-recovery-journal/v1"];
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/transaction-coordination/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/transaction-coordination/schemas.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mCAAmC,YAC9C,oCAAoC,CAC5B,CAAC;AAGX,eAAO,MAAM,wBAAwB;aACnC,kBAAkB,EAAE,yEAAyE;CACrF,CAAC;AAEX,eAAO,MAAM,+BAA+B;aAC1C,oCAAoC,YAClC,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,8BAA8B;CAExB,CAAC"}

package/dist/transaction-coordination/schemas.js

@@ -0,0 +1,17 @@
+// Published schema identities contributed by their semantic owner. Schema bytes stay in schemas/.
+export const TRANSACTION_COORDINATION_SCHEMA_IDS = [
+    "foundation-transaction-envelope/v2"
+];
+// The legacy envelope keeps the exact Foundation 0.21.0 dependency bytes.
+export const TRANSACTION_SCHEMA_FILES = {
+    "document-plan/v1": "assets/transaction-coordination/historical/document-plan-v1.schema.json"
+};
+export const TRANSACTION_SCHEMA_DEPENDENCIES = {
+    "foundation-transaction-envelope/v2": [
+        "document-intent/v1",
+        "document-plan/v1",
+        "scaffold-plan/v1",
+        "scaffold-recovery-journal/v1"
+    ]
+};
+//# sourceMappingURL=schemas.js.map

package/dist/transaction-coordination/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/transaction-coordination/schemas.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,oCAAoC;CAC5B,CAAC;AAEX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,kBAAkB,EAAE,yEAAyE;CACrF,CAAC;AAEX,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,oCAAoC,EAAE;QACpC,oBAAoB;QACpB,kBAAkB;QAClB,kBAAkB;QAClB,8BAA8B;KAC/B;CACO,CAAC"}

package/dist/workspace-inventory/adapters/outbound/pnpm/pnpm-package-manifest-snapshot-reader.d.ts

@@ -1,3 +1,9 @@
+import type { WorkspaceManifestFileObservation } from "../../../application/ports/workspace-input-observations.js";
 import { type CatalogEntry, type WorkspacePackage } from "../../../application/model/workspace-inventory.js";
-export declare function readPnpmPackageManifestSnapshots(consumerRoot: string, paths: readonly string[], catalogs: readonly CatalogEntry[], signal?: AbortSignal): Promise<readonly WorkspacePackage[]>;
+export declare class PnpmPackageManifestSnapshotReader {
+    private readonly files;
+    constructor(files: WorkspaceManifestFileObservation);
+    private readJsonManifest;
+    read(consumerRoot: string, paths: readonly string[], catalogs: readonly CatalogEntry[], signal?: AbortSignal): Promise<readonly WorkspacePackage[]>;
+}
 //# sourceMappingURL=pnpm-package-manifest-snapshot-reader.d.ts.map

package/dist/workspace-inventory/adapters/outbound/pnpm/pnpm-package-manifest-snapshot-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pnpm-package-manifest-snapshot-reader.d.ts","sourceRoot":"","sources":["../../../../../src/workspace-inventory/adapters/outbound/pnpm/pnpm-package-manifest-snapshot-reader.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,YAAY,EAKjB,KAAK,gBAAgB,EACtB,MAAM,mDAAmD,CAAC;AA2S3D,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CActC"}
+{"version":3,"file":"pnpm-package-manifest-snapshot-reader.d.ts","sourceRoot":"","sources":["../../../../../src/workspace-inventory/adapters/outbound/pnpm/pnpm-package-manifest-snapshot-reader.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,4DAA4D,CAAC;AAEnH,OAAO,EAEL,KAAK,YAAY,EAKjB,KAAK,gBAAgB,EACtB,MAAM,mDAAmD,CAAC;AA8J3D,qBAAa,iCAAiC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAlC,YAA6B,KAAK,EAAE,gCAAgC,EAAI;YAE1D,gBAAgB;IAsFxB,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CActC;CACF"}