@agent-teams/engineering-foundation 0.16.1 → 0.17.0-rc.1

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

@@ -0,0 +1,8 @@
+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;
+//# sourceMappingURL=known-file-transaction-status.d.ts.map

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

@@ -0,0 +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,CAoBlD"}

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

@@ -0,0 +1,50 @@
+import { assertKnownFileTransactionEnvelope } from "../../../repository-mutation/application/policies/known-file-transaction-envelope.js";
+function pendingKnownFileTransaction(options) {
+    const exactBuild = options.foundationVersion === options.installedVersion &&
+        options.foundationBuildIdentity === options.installedBuildIdentity;
+    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
+        },
+        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.`
+            }]
+    };
+}
+export function inspectKnownFileTransactionStatus(options) {
+    if (options.schemaVersion !== 5) {
+        return undefined;
+    }
+    try {
+        assertKnownFileTransactionEnvelope(options.value);
+    }
+    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

@@ -0,0 +1 @@
+{"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,kCAAkC,EAAE,MAAM,sFAAsF,CAAC;AAE1I,SAAS,2BAA2B,CAAC,OAKpC;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,iBAAiB,KAAK,OAAO,CAAC,gBAAgB;QACvE,OAAO,CAAC,uBAAuB,KAAK,OAAO,CAAC,sBAAsB,CAAC;IACrE,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,aAAa,EAAE,wBAAwB;QACvC,MAAM,EAAE,oCAAoC;QAC5C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,QAAQ,EAAE;YACR,SAAS,EAAE,4BAA4B;YACvC,sBAAsB,EAAE,OAAO,CAAC,iBAAiB;YACjD,4BAA4B,EAAE,OAAO,CAAC,uBAAuB;SAC9D;QACD,WAAW,EAAE,CAAC;gBACZ,IAAI,EAAE,UAAU;oBACd,CAAC,CAAC,+BAA+B;oBACjC,CAAC,CAAC,yCAAyC;gBAC7C,OAAO,EAAE,UAAU;oBACjB,CAAC,CAAC,kGAAkG;oBACpG,CAAC,CAAC,cAAc,OAAO,CAAC,iBAAiB,KAAK,OAAO,CAAC,uBAAuB,oEAAoE,OAAO,CAAC,gBAAgB,KAAK,OAAO,CAAC,sBAAsB,+BAA+B;aAC9O,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,OAKjD;IACC,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAAA,OAAO,SAAS,CAAC;IAAA,CAAC;IACpD,IAAI,CAAC;QACH,kCAAkC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,KAAK,EAAE,0BAA0B;YACjC,MAAM,EAAE,yBAAyB;YACjC,WAAW,EAAE,CAAC;oBACZ,IAAI,EAAE,iDAAiD;oBACvD,OAAO,EAAE,yGAAyG;iBACnH,CAAC;SACH,CAAC;IACJ,CAAC;IACD,OAAO,2BAA2B,CAAC;QACjC,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO;QACnD,uBAAuB,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa;QAC/D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;KACvD,CAAC,CAAC;AACL,CAAC"}

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":"AAuBA,OAAO,KAAK,EAEV,mCAAmC,EACpC,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AAmXxG,qBAAa,6BAA8B,YAAW,yBAAyB;;IAM7E,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,EAMA;IA6CK,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":"AAwBA,OAAO,KAAK,EAEV,mCAAmC,EACpC,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AAmWxG,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"}

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

@@ -1,7 +1,7 @@
 import { readdir } 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, LOCAL_STATE_DIRECTORY } from "../../../foundation-state-contract.js";
+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 { sha256Json as sha256DocumentJson } from "../../../canonical-json.js";
 import { assertAuthorityScaffoldJournal } from "../../../scaffolding/kernel/authority-journal-validation.js";
@@ -11,6 +11,8 @@ import { readBoundedRegularFile } from "../../../repository-mutation/adapters/no
 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";
 const maximumTransactionBytes = 32 * 1024 * 1024;
 const maximumLinkStateBytes = 64 * 1024;
 const maximumStateDirectoryEntries = 1024;
@@ -64,33 +66,6 @@ function pending(options) {
         diagnostics
     };
 }
-function pendingDocument(options) {
-    const exactBuild = options.foundationVersion === options.installedVersion &&
-        options.foundationBuildIdentity === options.installedBuildIdentity;
-    return {
-        state: "pending",
-        operationKind: "document-authoring",
-        format: "document-authoring-envelope-v3",
-        foundationVersion: options.foundationVersion,
-        foundationBuildIdentity: options.foundationBuildIdentity,
-        recovery: {
-            commandId: "docs-recover",
-            exactFoundationVersion: options.foundationVersion,
-            exactFoundationBuildIdentity: options.foundationBuildIdentity
-        },
-        diagnostics: [
-            exactBuild
-                ? {
-                    code: "FOUNDATION_TRANSACTION_ACTIVE",
-                    message: "A pending document-authoring transaction must be recovered before another Foundation mutation can start."
-                }
-                : {
-                    code: "FOUNDATION_TRANSACTION_VERSION_MISMATCH",
-                    message: `Foundation ${options.foundationVersion} (${options.foundationBuildIdentity}) must recover the pending document-authoring transaction before package ${options.installedVersion} (${options.installedBuildIdentity}) can mutate this repository.`
-                }
-        ]
-    };
-}
 function localModePending(message) {
     return {
         state: "pending",
@@ -201,14 +176,15 @@ async function inspectLegacyScaffoldingJournal(options) {
         installedBuildIdentity: options.installedBuildIdentity
     });
 }
+function transactionSchemaVersion(value) {
+    const schemaVersion = value["schemaVersion"];
+    return typeof schemaVersion === "number" ? schemaVersion : Number.NaN;
+}
 async function inspectParsedTransaction(value, installedVersion, installedBuildIdentity) {
     if (!isRecord(value)) {
         return manual("invalid-slot", "The Foundation transaction slot is invalid and was preserved.");
     }
-    const schemaVersion = value["schemaVersion"];
-    if (typeof schemaVersion !== "number") {
-        return manual("invalid-slot", "The Foundation transaction slot is invalid and was preserved.");
-    }
+    const schemaVersion = transactionSchemaVersion(value);
     switch (schemaVersion) {
         case 1:
             return inspectLegacyScaffoldingJournal({
@@ -218,7 +194,17 @@ async function inspectParsedTransaction(value, installedVersion, installedBuildI
             });
         case 3:
             return inspectCurrentDocumentEnvelope({
-                value, installedVersion, installedBuildIdentity, pending: pendingDocument
+                value, installedVersion, installedBuildIdentity, pending: pendingDocumentTransaction
+            });
+        case 4:
+            return inspectCurrentDocumentEnvelope({
+                value,
+                installedVersion,
+                installedBuildIdentity,
+                pending: (identity) => pendingDocumentTransaction({
+                    ...identity,
+                    format: "document-authoring-envelope-v4"
+                })
             });
         case 2: {
             const legacyDocumentEnvelope = isKnownLegacyDocumentEnvelope(value);
@@ -282,7 +268,12 @@ async function inspectParsedTransaction(value, installedVersion, installedBuildI
             };
         }
         default:
-            return manual("unsupported-schema", `Foundation transaction schema version ${String(schemaVersion)} is unsupported and was preserved.`);
+            return inspectKnownFileTransactionStatus({
+                value,
+                schemaVersion,
+                installedVersion,
+                installedBuildIdentity
+            }) ?? manual("unsupported-schema", `Foundation transaction schema version ${String(schemaVersion)} is unsupported and was preserved.`);
     }
 }
 export class NodeFoundationTransactionSlot {
@@ -290,12 +281,14 @@ export class NodeFoundationTransactionSlot {
     #installedVersion;
     #stateDirectory;
     #slotPath;
+    #knownFileTemporaryPath;
     constructor(options) {
         this.#installedBuildIdentity = options.installedBuildIdentity;
         this.#installedVersion = options.installedVersion;
         const stateDirectory = join(options.consumerRoot, LOCAL_STATE_DIRECTORY);
         this.#stateDirectory = stateDirectory;
         this.#slotPath = join(stateDirectory, FOUNDATION_TRANSACTION_FILE);
+        this.#knownFileTemporaryPath = join(stateDirectory, KNOWN_FILE_TRANSACTION_TEMPORARY_FILE);
     }
     async #inspectTransactionEvidence() {
         const transitionEvidence = await inspectFoundationTransitionEvidence(this.#stateDirectory);
@@ -308,9 +301,22 @@ export class NodeFoundationTransactionSlot {
         }
         catch (error) {
             if (isMissing(error)) {
-                return { state: "idle", diagnostics: [] };
+                try {
+                    record = await readBoundedRegularFile(this.#knownFileTemporaryPath, maximumTransactionBytes);
+                }
+                catch (temporaryError) {
+                    if (isMissing(temporaryError)) {
+                        return { state: "idle", diagnostics: [] };
+                    }
+                    return manual("invalid-slot", "The Foundation known-file transaction transition could not be read safely and was preserved.");
+                }
+                if (record.outcome !== "read") {
+                    return manual("unstable-slot", "The Foundation known-file transaction transition is not a stable bounded regular file and was preserved.");
+                }
+            }
+            else {
+                return manual("invalid-slot", "The Foundation transaction slot could not be read safely and was preserved.");
             }
-            return manual("invalid-slot", "The Foundation transaction slot could not be read safely and was preserved.");
         }
         if (record.outcome !== "read") {
             return manual("unstable-slot", "The Foundation transaction slot is not a stable bounded regular file and was preserved.");

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

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

package/dist/transaction-coordination/application/foundation-transaction-coordinator.d.ts

@@ -17,7 +17,7 @@ export declare class FoundationTransactionCoordinator {
     inspect(): Promise<InternalFoundationTransactionStatus>;
     acquire(options: {
         readonly requestedMutation: FoundationMutationKind;
-        readonly allowRecoveryOf?: "document-authoring" | "local-mode" | "scaffolding";
+        readonly allowRecoveryOf?: "document-authoring" | "known-file-transaction" | "local-mode" | "scaffolding";
     }): Promise<FoundationTransactionLease>;
 }
 //# sourceMappingURL=foundation-transaction-coordinator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"foundation-transaction-coordinator.d.ts","sourceRoot":"","sources":["../../../src/transaction-coordination/application/foundation-transaction-coordinator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,wCAAwC,CAAC;AAClG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AA4DxF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,mCAAmC,CAAC;IACrD,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED,qBAAa,gCAAgC;;IAI3C,YAAY,OAAO,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;QACvC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;KAC1C,EAGA;IAEK,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAE5D;IAEK,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;QACnD,QAAQ,CAAC,eAAe,CAAC,EAAE,oBAAoB,GAAG,YAAY,GAAG,aAAa,CAAC;KAChF,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAkDtC;CACF"}
+{"version":3,"file":"foundation-transaction-coordinator.d.ts","sourceRoot":"","sources":["../../../src/transaction-coordination/application/foundation-transaction-coordinator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,wCAAwC,CAAC;AAClG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AA8ExF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,mCAAmC,CAAC;IACrD,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AAED,qBAAa,gCAAgC;;IAI3C,YAAY,OAAO,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;QACvC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;KAC1C,EAGA;IAEK,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAE5D;IAEK,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;QACnD,QAAQ,CAAC,eAAe,CAAC,EAAE,oBAAoB,GAAG,wBAAwB,GAAG,YAAY,GAAG,aAAa,CAAC;KAC3G,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAoDtC;CACF"}

package/dist/transaction-coordination/application/foundation-transaction-coordinator.js

@@ -22,7 +22,7 @@ function observedStatusFormat(status) {
 function isDocumentRecoveryAllowed(status, options) {
     return (status.state === "pending" &&
         status.operationKind === "document-authoring" &&
-        observedStatusFormat(status) === "document-authoring-envelope-v3" &&
+        ["document-authoring-envelope-v3", "document-authoring-envelope-v4"].includes(String(observedStatusFormat(status))) &&
         status.recovery.exactFoundationVersion === status.foundationVersion &&
         status.recovery.exactFoundationBuildIdentity ===
             status.foundationBuildIdentity &&
@@ -30,6 +30,15 @@ function isDocumentRecoveryAllowed(status, options) {
         options.requestedMutation === "document-authoring" &&
         !status.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH"));
 }
+function isKnownFileRecoveryAllowed(status, options) {
+    return status.state === "pending" &&
+        status.operationKind === "known-file-transaction" &&
+        status.recovery.exactFoundationVersion === status.foundationVersion &&
+        status.recovery.exactFoundationBuildIdentity === status.foundationBuildIdentity &&
+        options.allowRecoveryOf === "known-file-transaction" &&
+        options.requestedMutation === "known-file-transaction" &&
+        !status.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH");
+}
 export class FoundationTransactionCoordinator {
     #lock;
     #slot;
@@ -57,10 +66,12 @@ export class FoundationTransactionCoordinator {
                 options.allowRecoveryOf === "local-mode" &&
                 options.requestedMutation === "detach";
             const documentRecoveryAllowed = isDocumentRecoveryAllowed(status, options);
+            const knownFileRecoveryAllowed = isKnownFileRecoveryAllowed(status, options);
             if (status.state !== "idle" &&
                 !scaffoldingRecoveryAllowed &&
                 !localModeRecoveryAllowed &&
-                !documentRecoveryAllowed) {
+                !documentRecoveryAllowed &&
+                !knownFileRecoveryAllowed) {
                 throw new FoundationTransactionError({
                     requestedMutation: options.requestedMutation,
                     status

package/dist/transaction-coordination/application/foundation-transaction-coordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"foundation-transaction-coordinator.js","sourceRoot":"","sources":["../../../src/transaction-coordination/application/foundation-transaction-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAQ/E,SAAS,sBAAsB,CAC7B,cAAuB,EACvB,cAAuB;IAEvB,IAAI,CAAC,CAAC,cAAc,YAAY,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,cAAc,CACvB,CAAC,cAAc,EAAE,cAAc,CAAC,EAChC,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,CAAC;IAC3C,MAAM,eAAe,GACnB,aAAa,KAAK,SAAS;QACzB,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,IAAI,cAAc,CAChB,CAAC,aAAa,EAAE,cAAc,CAAC,EAC/B,mEAAmE,CACpE,CAAC;IACR,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE;QAC/D,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,eAAe;QACtB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,OAAO,QAAQ;QACb,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,IAAI,cAAc,CAChB,CAAC,cAAc,EAAE,cAAc,CAAC,EAChC,gEAAgE,CACjE,CAAC;AACR,CAAC;AAED,SAAS,oBAAoB,CAAC,MAA2C;IACvE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAY,CAAC;AAClD,CAAC;AAED,SAAS,yBAAyB,CAChC,MAA2C,EAC3C,OAGC;IAED,OAAO,CACL,MAAM,CAAC,KAAK,KAAK,SAAS;QAC1B,MAAM,CAAC,aAAa,KAAK,oBAAoB;QAC7C,oBAAoB,CAAC,MAAM,CAAC,KAAK,gCAAgC;QACjE,MAAM,CAAC,QAAQ,CAAC,sBAAsB,KAAK,MAAM,CAAC,iBAAiB;QACnE,MAAM,CAAC,QAAQ,CAAC,4BAA4B;YAC1C,MAAM,CAAC,uBAAuB;QAChC,OAAO,CAAC,eAAe,KAAK,oBAAoB;QAChD,OAAO,CAAC,iBAAiB,KAAK,oBAAoB;QAClD,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CACtB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,yCAAyC,CACjE,CACF,CAAC;AACJ,CAAC;AAOD,MAAM,OAAO,gCAAgC;IAClC,KAAK,CAA0B;IAC/B,KAAK,CAA4B;IAE1C,YAAY,OAGX;QACC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAGb;QACC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,0BAA0B,GAC9B,MAAM,CAAC,KAAK,KAAK,SAAS;gBAC1B,MAAM,CAAC,aAAa,KAAK,aAAa;gBACtC,oBAAoB,CAAC,MAAM,CAAC,KAAK,uBAAuB;gBACxD,OAAO,CAAC,eAAe,KAAK,MAAM,CAAC,aAAa;gBAChD,OAAO,CAAC,iBAAiB,KAAK,MAAM,CAAC,aAAa;gBAClD,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CACtB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,yCAAyC,CACjE,CAAC;YACJ,MAAM,wBAAwB,GAC5B,MAAM,CAAC,KAAK,KAAK,SAAS;gBAC1B,MAAM,CAAC,aAAa,KAAK,YAAY;gBACrC,oBAAoB,CAAC,MAAM,CAAC,KAAK,eAAe;gBAChD,OAAO,CAAC,eAAe,KAAK,YAAY;gBACxC,OAAO,CAAC,iBAAiB,KAAK,QAAQ,CAAC;YACzC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC3E,IACE,MAAM,CAAC,KAAK,KAAK,MAAM;gBACvB,CAAC,0BAA0B;gBAC3B,CAAC,wBAAwB;gBACzB,CAAC,uBAAuB,EACxB,CAAC;gBACD,MAAM,IAAI,0BAA0B,CAAC;oBACnC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;oBAC5C,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;YACD,OAAO;gBACL,MAAM;gBACN,KAAK,CAAC,OAAO,CAAC,cAAc;oBAC1B,IAAI,IAAI,EAAE,CAAC;wBACT,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;wBAC9B,IAAI,GAAG,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,IAAI,GAAG,KAAK,CAAC;YACf,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACtB,MAAM,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"foundation-transaction-coordinator.js","sourceRoot":"","sources":["../../../src/transaction-coordination/application/foundation-transaction-coordinator.ts"],"names":[],"mappings":"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"}

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

@@ -5,7 +5,7 @@ export type InternalFoundationTransactionStatus = Exclude<FoundationTransactionS
 }> | {
     readonly state: "pending";
     readonly operationKind: "document-authoring";
-    readonly format: "document-authoring-envelope-v3";
+    readonly format: "document-authoring-envelope-v3" | "document-authoring-envelope-v4";
     readonly foundationVersion: string;
     readonly foundationBuildIdentity: string;
     readonly recovery: {
@@ -14,11 +14,23 @@ export type InternalFoundationTransactionStatus = Exclude<FoundationTransactionS
         readonly exactFoundationBuildIdentity: string;
     };
     readonly diagnostics: readonly FoundationTransactionDiagnostic[];
+} | {
+    readonly state: "pending";
+    readonly operationKind: "known-file-transaction";
+    readonly format: "known-file-transaction-envelope-v1";
+    readonly foundationVersion: string;
+    readonly foundationBuildIdentity: string;
+    readonly recovery: {
+        readonly commandId: "replace-known-file-recover";
+        readonly exactFoundationVersion: string;
+        readonly exactFoundationBuildIdentity: string;
+    };
+    readonly diagnostics: readonly FoundationTransactionDiagnostic[];
 } | {
     readonly state: "manual-recovery-required";
     readonly reason: InternalFoundationManualRecoveryReason;
-    readonly operationKind?: "document-authoring" | "scaffolding";
-    readonly format?: "envelope-v2" | "envelope-v3";
+    readonly operationKind?: "document-authoring" | "known-file-transaction" | "scaffolding";
+    readonly format?: "envelope-v2" | "envelope-v3" | "envelope-v4" | "known-file-transaction-envelope-v1";
     readonly foundationVersion?: string;
     readonly foundationBuildIdentity?: string;
     readonly diagnostics: readonly FoundationTransactionDiagnostic[];

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,CAAC;IAClD,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,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,sCAAsC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC;IAChD,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,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"}

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

@@ -1,10 +1,14 @@
-export type FoundationMutationKind = "attach" | "detach" | "document-authoring" | "scaffolding";
+export type FoundationMutationKind = "attach" | "detach" | "document-authoring" | "known-file-transaction" | "scaffolding";
 export type FoundationRecoveryRoute = {
     readonly commandId: "scaffold-recover";
     readonly exactFoundationVersion: string;
     readonly exactFoundationBuildIdentity?: string;
 } | {
     readonly commandId: "detach";
+} | {
+    readonly commandId: "replace-known-file-recover";
+    readonly exactFoundationVersion: string;
+    readonly exactFoundationBuildIdentity: string;
 };
 export type FoundationTransactionDiagnostic = {
     readonly code: "FOUNDATION_TRANSACTION_ACTIVE";
@@ -38,7 +42,7 @@ export type FoundationTransactionStatus = {
 } | {
     readonly state: "manual-recovery-required";
     readonly reason: FoundationManualRecoveryReason;
-    readonly operationKind?: "document-authoring" | "scaffolding";
+    readonly operationKind?: "document-authoring" | "known-file-transaction" | "scaffolding";
     readonly format?: "envelope-v2";
     readonly foundationVersion?: string;
     readonly foundationBuildIdentity?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"transaction-status.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/model/transaction-status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,QAAQ,GACR,oBAAoB,GACpB,aAAa,CAAC;AAElB,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAC;CAChD,GACD;IACE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,+BAA+B,GACvC;IACE,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,iDAAiD,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,yCAAyC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,8BAA8B,GACtC,yBAAyB,GACzB,cAAc,GACd,6BAA6B,GAC7B,uBAAuB,GACvB,kBAAkB,GAClB,8BAA8B,GAC9B,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAA;KAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,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":"transaction-status.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/model/transaction-status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,QAAQ,GACR,oBAAoB,GACpB,wBAAwB,GACxB,aAAa,CAAC;AAElB,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAC;CAChD,GACD;IACE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;IACjD,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;CAC/C,CAAC;AAEN,MAAM,MAAM,+BAA+B,GACvC;IACE,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,iDAAiD,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,yCAAyC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,8BAA8B,GACtC,yBAAyB,GACzB,cAAc,GACd,6BAA6B,GAC7B,uBAAuB,GACvB,kBAAkB,GAClB,8BAA8B,GAC9B,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAA;KAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAClE,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,GAAG,wBAAwB,GAAG,aAAa,CAAC;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.16.1",
+  "version": "0.17.0-rc.1",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",
@@ -17,10 +17,18 @@
       "types": "./dist/document-authoring/index.d.ts",
       "import": "./dist/document-authoring/index.js"
     },
+    "./document-authoring/qualification": {
+      "types": "./dist/document-authoring/qualification/index.d.ts",
+      "import": "./dist/document-authoring/qualification/index.js"
+    },
     "./local-mode": {
       "types": "./dist/local-mode/index.d.ts",
       "import": "./dist/local-mode/index.js"
     },
+    "./mutation": {
+      "types": "./dist/mutation/index.d.ts",
+      "import": "./dist/mutation/index.js"
+    },
     "./scaffolding": {
       "types": "./dist/scaffolding/index.d.ts",
       "import": "./dist/scaffolding/index.js"
@@ -45,19 +53,27 @@
     "schemas/contract-protobuf-evolution-baseline/v1.schema.json",
     "schemas/contract-protobuf-evolution/v1.schema.json",
     "schemas/document-authoring-profile/v1.schema.json",
+    "schemas/document-authoring-profile/v2.schema.json",
     "schemas/document-command-envelope/v1.schema.json",
     "schemas/document-command-envelope/v2.schema.json",
     "schemas/document-intent/v1.schema.json",
+    "schemas/document-parent-materialization/v2.schema.json",
     "schemas/document-plan/v1.schema.json",
+    "schemas/document-plan/v2.schema.json",
     "schemas/document-receipt/v1.schema.json",
+    "schemas/document-receipt/v2.schema.json",
     "schemas/documentation-local-references/v1.schema.json",
     "schemas/foundation-command-error/v1.schema.json",
     "schemas/foundation-config/v1.schema.json",
     "schemas/foundation-check-report/v1.schema.json",
     "schemas/foundation-transaction-envelope/v2.schema.json",
     "schemas/foundation-transaction-envelope/v3.schema.json",
+    "schemas/foundation-transaction-envelope/v4.schema.json",
+    "schemas/foundation-transaction-envelope/v5.schema.json",
     "schemas/governance-architecture-decision-baseline/v1.schema.json",
     "schemas/governance-architecture-decisions/v1.schema.json",
+    "schemas/known-file-transaction-plan/v1.schema.json",
+    "schemas/known-file-transaction-receipt/v1.schema.json",
     "schemas/package-public-api-baseline/v1.schema.json",
     "schemas/package-public-api-compatibility/v1.schema.json",
     "schemas/quality-executable-specification-catalog/v1.schema.json",