@noy-db/hub 0.6.0-pre.8 → 0.6.0

package/dist/{chunk-WK5XUYYF.js → chunk-JYPRZWCZ.js}

@@ -1,75 +1,84 @@
+import {
+  LinkIntegrityError,
+  declareLink,
+  isLinkCollectionName,
+  linkCollectionName,
+  linkRowKey
+} from "./chunk-PFWE7FJG.js";
 import {
   hashFields,
   validateSatelliteDeclaration
-} from "./chunk-HVQGCKY4.js";
+} from "./chunk-QVXZFJBU.js";
 import {
   resolveStaleOnRead
-} from "./chunk-4HDYQL3J.js";
+} from "./chunk-B4CRUZPR.js";
 import {
   isManifestReservedCollection
 } from "./chunk-EPFF7LOX.js";
 import {
-  LinkIntegrityError,
-  declareLink,
-  isLinkCollectionName,
-  linkCollectionName,
-  linkRowKey
-} from "./chunk-HNHCQ556.js";
+  VectorSet,
+  buildPersistedIndexCallbacks,
+  encodeVecId,
+  syncTierSearch
+} from "./chunk-M7WBE3OR.js";
 import {
   isBaseLive,
   liveBaseIdSet
 } from "./chunk-GYGLAVCX.js";
 import {
   loadFence
-} from "./chunk-6BU3L4UE.js";
+} from "./chunk-DNKVKO7K.js";
 import {
-  VectorSet,
-  buildPersistedIndexCallbacks,
-  encodeVecId,
-  syncTierSearch
-} from "./chunk-G6S5VVHP.js";
+  fallbackDerivationName,
+  jsonSchemaToFields
+} from "./chunk-KHKKD62N.js";
+import {
+  derivePersistedSchema,
+  isZod4Schema
+} from "./chunk-6NR36UNB.js";
 import {
   SchemaUpdateGate
 } from "./chunk-6LJY7X5A.js";
+import {
+  NO_ATTESTATION
+} from "./chunk-MPKP6L5E.js";
 import {
   NO_CLASSIFIED,
   guardClassifiedCompat,
   resolveClassifiedFields
-} from "./chunk-QULVCV3M.js";
+} from "./chunk-AJGGBXWA.js";
 import {
   NO_TIERS,
   classifySealedShred,
   syncDerivedOutputs
-} from "./chunk-6NVPFKN3.js";
+} from "./chunk-ZIMQDXTQ.js";
 import {
   NO_PORTABILITY
-} from "./chunk-FUHKW252.js";
+} from "./chunk-OCJ3JA4O.js";
 import {
   NO_CARGO,
   runDrainBarrier
-} from "./chunk-DG27IUVI.js";
+} from "./chunk-LC6NE4IQ.js";
 import {
   saveSealedSecret
-} from "./chunk-XWX7GL56.js";
-import {
-  fallbackDerivationName,
-  jsonSchemaToFields
-} from "./chunk-KHKKD62N.js";
-import {
-  derivePersistedSchema,
-  isZod4Schema
-} from "./chunk-Z45YRGFO.js";
+} from "./chunk-S2I5MYSA.js";
 import {
   loadPersistedSchema
-} from "./chunk-CDB2HVQW.js";
+} from "./chunk-KM6ZXG7U.js";
+import {
+  NO_SEQUENCE,
+  SEQUENCE_COLLECTION,
+  compileSequenceFormat,
+  resolveSequenceKey
+} from "./chunk-W3HAIN6U.js";
 import {
   CustodyApi,
   NO_CUSTODY
-} from "./chunk-ADW22QSB.js";
+} from "./chunk-HWI7GHJZ.js";
 import {
   DEFAULT_POSTURE,
   ViaGraph
-} from "./chunk-7TSYBD3E.js";
+} from "./chunk-65JXA63J.js";
 import {
   buildLookupAltIndex,
   buildLookupSnapshotRows,
@@ -93,33 +102,33 @@ import {
   selfWriteFieldEqual,
   touchFor,
   updateReferencingRecords
-} from "./chunk-5ZKS6ZE2.js";
+} from "./chunk-K6CPIK3R.js";
 import {
   OverlayedCollection
-} from "./chunk-OF3L2SD6.js";
+} from "./chunk-HOPNIR5R.js";
 import {
   INDEXED_STORE_POLICY,
   NO_SYNC
-} from "./chunk-55LKVALY.js";
-import {
-  NO_ATTESTATION
-} from "./chunk-VJFMXYKP.js";
+} from "./chunk-T7IR4N2S.js";
 import {
   NO_CONSENT
 } from "./chunk-PEOZ34EM.js";
 import {
   NO_PERIODS,
+  isEffectivelyReopened,
   purgeMarkersOn,
   resolvePeriodKey,
+  resolveReopenState,
   samePartition
-} from "./chunk-PXCBVDFY.js";
+} from "./chunk-5ATC6UT4.js";
 import {
   PERIODS_COLLECTION,
   PERIOD_ARCHIVES_COLLECTION,
   PERIOD_FREEZES_COLLECTION,
+  PERIOD_REOPENS_COLLECTION,
   PERIOD_TARGET_PURGES_COLLECTION,
   periodExclusiveUpperBound
-} from "./chunk-JXIDGFKS.js";
+} from "./chunk-5O5ZSW7N.js";
 import {
   NO_SHADOW
 } from "./chunk-SMY5X46Z.js";
@@ -129,7 +138,7 @@ import {
 import {
   TxContext,
   bestEffortRevert
-} from "./chunk-35EBKWQU.js";
+} from "./chunk-QH47SQLD.js";
 import {
   lazy
 } from "./chunk-5D2ALSM5.js";
@@ -137,32 +146,29 @@ import {
   InvertedIndex,
   MemoryIndexStore,
   NO_SEARCH
-} from "./chunk-3JVXVJ7L.js";
+} from "./chunk-7OBIBPCV.js";
 import {
-  NO_SEQUENCE,
-  SEQUENCE_COLLECTION,
-  compileSequenceFormat,
-  resolveSequenceKey
-} from "./chunk-7MNBICB5.js";
+  NO_SEALED_RECORD
+} from "./chunk-323MN67Z.js";
 import {
   Query,
   ScanBuilder
-} from "./chunk-3737A6EA.js";
+} from "./chunk-EHW7NLGD.js";
 import {
   EXPORT_AUDIT_COLLECTION,
   NO_BLOBS,
   createExportBlobsHandle,
   runCompaction
-} from "./chunk-WASHZV34.js";
+} from "./chunk-LIR2DJWP.js";
 import {
   LazyQuery,
   NO_INDEXING,
   decodeIdxId,
   encodeIdxId
-} from "./chunk-JIUVJ4M7.js";
+} from "./chunk-S7PM7Z4K.js";
 import {
   normalizeIndexDefs
-} from "./chunk-GQ3BX5EA.js";
+} from "./chunk-I3ISCYT7.js";
 import {
   IMPLICIT_LAZY,
   Lru,
@@ -176,13 +182,13 @@ import {
 } from "./chunk-YMUFFJCO.js";
 import {
   readPath
-} from "./chunk-IGJCYUT5.js";
+} from "./chunk-NSITFOCJ.js";
 import {
   NO_CRDT
 } from "./chunk-PVEWA2DU.js";
 import {
   dictCollectionName
-} from "./chunk-WFUIE565.js";
+} from "./chunk-FNYCT27B.js";
 import {
   NO_I18N,
   getAtPath,
@@ -190,11 +196,11 @@ import {
   isDictKeyDescriptor,
   isI18nTextDescriptor,
   isStaticDictDescriptor
-} from "./chunk-7G6VDWXB.js";
+} from "./chunk-XPEPMK4Y.js";
 import {
   isViaInstalled,
   viaBinder
-} from "./chunk-UHXCLPGC.js";
+} from "./chunk-C3XWJCG7.js";
 import {
   NO_TEAM,
   describeAllUsersAuth,
@@ -217,7 +223,7 @@ import {
   saveShamirRecoveryEntries,
   updateAuthenticator,
   writeMagicLinkGrant
-} from "./chunk-O2ERS4UJ.js";
+} from "./chunk-YTUFV7U7.js";
 import {
   assertKeyringOpenAllowed,
   buildRecipientKeyringFile,
@@ -232,32 +238,36 @@ import {
   listUsers,
   loadKeyring,
   updateKeyringIdentity
-} from "./chunk-JRKZTEZZ.js";
+} from "./chunk-J6I5VR6P.js";
 import {
   persistDirectoryConfig,
   readDirectoryConfig
-} from "./chunk-5JY5TSVY.js";
+} from "./chunk-ZJUZOJVW.js";
 import {
   NO_BROKER,
   buildCredentialBrokerHandle
-} from "./chunk-W3TVWF6N.js";
+} from "./chunk-YCGLAANM.js";
 import {
   NO_SESSION
 } from "./chunk-VKQCVU2Z.js";
 import {
   generateULID
-} from "./chunk-ZJADGNYF.js";
+} from "./chunk-4AOERLTV.js";
 import {
   NO_HISTORY
-} from "./chunk-AFHQATY4.js";
+} from "./chunk-7ZGPQOFV.js";
+import {
+  sha256Hex
+} from "./chunk-BZ3WMOYX.js";
 import {
   assertCutoverTierSafe,
   assertTierWritable,
+  dekKey,
   liveRecordIsElevated
-} from "./chunk-3FSX6LDG.js";
+} from "./chunk-D2YFQ7XG.js";
 import {
-  sha256Hex
-} from "./chunk-6SAFL5YE.js";
+  NO_VAULT_HEAD
+} from "./chunk-HK67PX4J.js";
 import {
   NO_FORGET,
   addSubjectRef,
@@ -266,34 +276,36 @@ import {
   readDottedPath,
   rebuildSubjectIndex,
   removeSubjectRef
-} from "./chunk-WLZ47GSL.js";
-import {
-  NO_SEALED_RECORD
-} from "./chunk-FAXZQ5UF.js";
+} from "./chunk-HSJBJIB2.js";
 import {
   RecordCodec,
   SEALED_CEK_NS,
+  applyRewrappedBody,
+  buildRecordAad,
   findByDet,
   hasPerRecordKey,
+  hasSealedBody,
   makeReservedEnvelopes,
   openEnvelopeJson,
   queryByDet,
   resolveStableCek,
-  validateSchemaInput
-} from "./chunk-3URQC7EH.js";
+  rewrapBodyToDek,
+  validateSchemaInput,
+  verifyRecordIdentity
+} from "./chunk-CXPOG3ZY.js";
 import {
   buildDeleteMarker,
+  buildRecordEnvelope,
   buildTombstone,
   isDeleteMarker,
   isTombstone
-} from "./chunk-7H73RIE3.js";
+} from "./chunk-FX3UIDCS.js";
 import {
   encrypt
-} from "./chunk-VCETL77O.js";
+} from "./chunk-ONPVHX2Y.js";
 import {
-  NOYDB_FORMAT_VERSION,
   SealedHandle
-} from "./chunk-YPYHVOXP.js";
+} from "./chunk-UJ4Z67UQ.js";
 import {
   AlreadyElevatedError,
   AttestationError,
@@ -336,7 +348,36 @@ import {
   UnsupportedTierCompositionError,
   ValidationError,
   isConflictError
-} from "./chunk-HNGSV2YC.js";
+} from "./chunk-Z3BZXPRO.js";
+
+// src/kernel/merge-authority.ts
+function buildMergeAuthority(keyring) {
+  return {
+    verify: async (collection, id, envelope) => {
+      const dek = keyring.deks.get(dekKey(collection, envelope._tier ?? 0));
+      if (dek === void 0) return true;
+      return verifyRecordIdentity({ collection, id }, envelope, dek);
+    },
+    advance: async (collection, id, envelope, toVersion) => {
+      if (!hasSealedBody(envelope)) return { ...envelope, _v: toVersion };
+      const dek = keyring.deks.get(dekKey(collection, envelope._tier ?? 0));
+      if (dek === void 0) {
+        throw new ValidationError(
+          `sync: cannot advance "${collection}/${id}" past the remote \u2014 no key for it, so its body cannot be re-sealed at the new version. The local copy is unchanged.`
+        );
+      }
+      const from = {
+        collection,
+        id,
+        version: envelope._v,
+        ...envelope._tier !== void 0 ? { tier: envelope._tier } : {},
+        ...envelope._by !== void 0 ? { by: envelope._by } : {}
+      };
+      const body = await rewrapBodyToDek(from, { ...from, version: toVersion }, envelope, dek, dek);
+      return { ...applyRewrappedBody(envelope, body), _v: toVersion };
+    }
+  };
+}
 
 // src/with-commit/tx/strategy.ts
 var NOT_ENABLED = new Error(
@@ -373,6 +414,7 @@ var STRATEGY_DEFAULTS = {
   custody: NO_CUSTODY,
   forget: NO_FORGET,
   history: NO_HISTORY,
+  vaultHead: NO_VAULT_HEAD,
   i18n: NO_I18N,
   indexing: NO_INDEXING,
   lazy: IMPLICIT_LAZY,
@@ -466,7 +508,7 @@ function validateSecretModeOptions(options) {
 }
 async function resolveEffectiveSecret(options, store, vault) {
   if (options.secretMode === "managed") {
-    const { resolveManagedSecret } = await import("./managed-secret-CWQ6PND5.js");
+    const { resolveManagedSecret } = await import("./managed-secret-ETDG6AAE.js");
     return resolveManagedSecret(store, vault, options.sealingKey);
   }
   return options.secret;
@@ -484,7 +526,7 @@ function ownerKeyringOptions(options, secret) {
 
 // src/port/by/default-provider.ts
 async function createDefaultCoordinationProvider(store) {
-  const { StoreCoordinationProvider } = await import("./store-coordination-provider-GFCUOBR6.js");
+  const { StoreCoordinationProvider } = await import("./store-coordination-provider-R27VRD6K.js");
   return new StoreCoordinationProvider(store);
 }
 
@@ -939,13 +981,13 @@ async function applyCutoverTransform(ctx) {
   for (const id of ids) {
     const env = await ctx.adapter.get(ctx.vault, ctx.name, id);
     if (!env || isTombstone(env, ctx.storeCiphertext) || isDeleteMarker(env)) continue;
-    const decoded = await ctx.codec.decryptRecord(env, { skipValidation: true, id });
+    const decoded = await ctx.codec.decryptRecord({ collection: ctx.name, id }, env, { skipValidation: true });
     if (decoded === null) continue;
     const record = decoded;
     const next = ctx.transform(record);
     const nextVersion = (env._v ?? 0) + 1;
     const cek = ctx.perRecordCek ? await ctx.resolveRecordCek(id) : void 0;
-    const migEnvelope = await ctx.codec.encryptRecord(next, nextVersion, cek, void 0, void 0, ctx.vdigFields !== null ? { id, prev: env } : void 0, id);
+    const migEnvelope = await ctx.codec.encryptRecord({ collection: ctx.name, id }, next, nextVersion, cek, void 0, void 0, ctx.vdigFields !== null ? { id, prev: env } : void 0);
     await ctx.adapter.put(ctx.vault, ctx.name, id, migEnvelope);
     await ctx.onRecordMutated(id, "put", "cutover");
     if (ctx.ledger) {
@@ -1051,7 +1093,7 @@ async function rebuildIndexes(ctx) {
     const envelope = await ctx.adapter.get(ctx.vault, ctx.name, recordId);
     if (!envelope) continue;
     if ((envelope._tier ?? 0) > 0) continue;
-    const record = await ctx.codec.decryptRecord(envelope, { skipValidation: true, id: recordId });
+    const record = await ctx.codec.decryptRecord({ collection: ctx.name, id: recordId }, envelope, { skipValidation: true });
     if (record === null) continue;
     await maintainPersistedIndexesOnPut(ctx, recordId, record, null, envelope._v);
   }
@@ -1085,7 +1127,7 @@ async function reconcileIndex(ctx, field, opts = {}) {
     const env = await ctx.adapter.get(ctx.vault, ctx.name, id);
     if (!env) continue;
     try {
-      const sidecarJson = await ctx.codec.decryptJsonString(env);
+      const sidecarJson = await ctx.codec.decryptJsonString({ collection: ctx.name, id }, env);
       if (sidecarJson === null) {
         sidecar.set(decoded.recordId, void 0);
       } else {
@@ -1105,7 +1147,7 @@ async function reconcileIndex(ctx, field, opts = {}) {
     const env = await ctx.adapter.get(ctx.vault, ctx.name, id);
     if (!env) continue;
     if ((env._tier ?? 0) > 0) continue;
-    const record = await ctx.codec.decryptRecord(env, { skipValidation: true, id });
+    const record = await ctx.codec.decryptRecord({ collection: ctx.name, id }, env, { skipValidation: true });
     if (record === null) continue;
     const live = readPersistedValue(record, field);
     const stored = sidecar.get(id);
@@ -1166,7 +1208,7 @@ async function maintainPersistedIndexesOnPut(ctx, id, newRecord, previousRecord,
           recordId: id,
           writtenAt: (/* @__PURE__ */ new Date()).toISOString()
         });
-        const envelope = await ctx.codec.encryptJsonString(body, version);
+        const envelope = await ctx.codec.encryptJsonString({ collection: ctx.name, id: idxId }, body, version);
         await ctx.adapter.put(ctx.vault, ctx.name, idxId, envelope);
       }
     } catch (cause) {
@@ -1235,7 +1277,7 @@ async function resolveTierSyncPrior(ctx, id, priorEnvelope) {
   const cached = ctx.cache.get(id)?.record;
   if (cached !== void 0) return cached;
   if (!ctx.lazy || !priorEnvelope || (priorEnvelope._tier ?? 0) > 0) return null;
-  return await ctx.codec.decryptRecord(priorEnvelope, { skipValidation: true, id });
+  return await ctx.codec.decryptRecord({ collection: ctx.name, id }, priorEnvelope, { skipValidation: true });
 }
 
 // src/with-lookup/search/serialize.ts
@@ -2418,7 +2460,7 @@ function resolveCollectionConfig(opts) {
 }
 
 // src/with-formula/computed/lazy.ts
-var loadComputed = lazy(() => import("./computed-6G5M3UPH.js"));
+var loadComputed = lazy(() => import("./computed-VG2PCM4L.js"));
 async function loadEvalComputedFields() {
   return (await loadComputed()).evalComputedFields;
 }
@@ -2604,7 +2646,8 @@ var Collection = class {
   fieldMeta;
   /** Collection-level descriptive metadata declared via `meta`; read by `getMeta()`, surfaced in `describe()`. */
   meta;
-  /** Outbound ref declarations (snapshot from vault refRegistry at construction time); used by `describe()`. */
+  /** Outbound ref declarations (snapshot from the vault refRegistry); read by `describe()` and
+   *  {@link _txAtomicSafe}. Mutable for {@link _attachDeclaredRefs} (#1141). */
   _refs;
   /** Money field descriptors keyed by field path, typed as the opaque {@link ViaDescriptor} marker
    *  (the kernel never inspects the concrete shape); `put()` quantizes to a scaled-int string,
@@ -2874,14 +2917,14 @@ var Collection = class {
         if (crdtMode === "yjs") {
           return local._v >= remote._v ? local : remote;
         }
-        const localJson = await this.codec.decryptJsonString(local, id);
-        const remoteJson = await this.codec.decryptJsonString(remote, id);
+        const localJson = await this.codec.decryptJsonString({ collection: this.name, id }, local);
+        const remoteJson = await this.codec.decryptJsonString({ collection: this.name, id }, remote);
         if (localJson === null) return local;
         if (remoteJson === null) return remote;
         const merged = this.strategies.crdt.mergeCrdtStates(JSON.parse(localJson), JSON.parse(remoteJson));
         const mergedVersion = Math.max(local._v, remote._v) + 1;
         const cek = this.perRecordCek ? await this.resolveRecordCek(id) : void 0;
-        return this.codec.encryptJsonString(JSON.stringify(merged), mergedVersion, cek);
+        return this.codec.encryptJsonString({ collection: this.name, id }, JSON.stringify(merged), mergedVersion, cek);
       };
       opts.onRegisterConflictResolver(this.name, crdtResolver);
     }
@@ -2922,14 +2965,14 @@ var Collection = class {
       } else {
         const mergeFn = policy;
         resolver = async (id, local, remote) => {
-          const localRecord = await this.codec.decryptRecord(local, { skipValidation: true, id });
-          const remoteRecord = await this.codec.decryptRecord(remote, { skipValidation: true, id });
+          const localRecord = await this.codec.decryptRecord({ collection: this.name, id }, local, { skipValidation: true });
+          const remoteRecord = await this.codec.decryptRecord({ collection: this.name, id }, remote, { skipValidation: true });
           if (localRecord === null) return local;
           if (remoteRecord === null) return remote;
           const merged = mergeFn(localRecord, remoteRecord);
           const mergedVersion = Math.max(local._v, remote._v) + 1;
           const cek = this.perRecordCek ? await this.resolveRecordCek(id) : void 0;
-          return this.codec.encryptRecord(merged, mergedVersion, cek, void 0, void 0, void 0, id);
+          return this.codec.encryptRecord({ collection: this.name, id }, merged, mergedVersion, cek);
         };
       }
       opts.onRegisterConflictResolver(collectionName, resolver);
@@ -3200,7 +3243,7 @@ var Collection = class {
     }
     await this.onAccess?.("find", "*");
     if (hits.length === 0) return [];
-    const { verifyDigestField } = await import("./verify-RO5RTZOJ.js");
+    const { verifyDigestField } = await import("./verify-M5LQH43C.js");
     const policy = {
       normalize: spec.verifyNormalize ?? "password",
       notLastN: spec.notLastN ?? 0,
@@ -3314,6 +3357,12 @@ var Collection = class {
   _applyMeta(meta) {
     if (this.meta === void 0) this.meta = meta;
   }
+  /** @internal #1141 — refresh the ref snapshot after a late `refs` declaration. Overwrites rather
+   *  than first-wins, deliberately: the argument is the ref registry's own merged view (see
+   *  `reconcileViaAttach`), which `RefRegistry.register` has already refused to let conflict. */
+  _attachDeclaredRefs(refs) {
+    this._refs = refs;
+  }
   /**
    * @internal — attach classified fields post-construction. See {@link _applyMoneyFields}.
    * First-wins. Note: unlike money/computed/meta, this cannot retro-seal a
@@ -3406,7 +3455,7 @@ var Collection = class {
       }
     }
     if (this.materializedViewSource !== void 0) {
-      const { resolveStaleMVOnRead } = await import("./stale-ARHFVL5U.js");
+      const { resolveStaleMVOnRead } = await import("./stale-TH7SSVRV.js");
       await resolveStaleMVOnRead(this.materializedViewSource, this.name, this.#dispatchCtx({ collection: this.name, id: "resolve-on-read" }));
     }
     let record;
@@ -3418,7 +3467,7 @@ var Collection = class {
         const envelope = await this.adapter.get(this.vault, this.name, id);
         if (!envelope) return null;
         if (isTombstone(envelope, this.storeCiphertext) || isDeleteMarker(envelope) || (envelope._tier ?? 0) > 0) return null;
-        record = await this.codec.decryptRecord(envelope, { id, sealedAsHandles: true });
+        record = await this.codec.decryptRecord({ collection: this.name, id }, envelope, { sealedAsHandles: true });
         if (record === null) return null;
         this.lru.set(id, { record, version: envelope._v }, estimateRecordBytes(record));
       }
@@ -3445,7 +3494,7 @@ var Collection = class {
     }
     const envelope = await this.adapter.get(this.vault, this.name, id);
     if (!envelope || (envelope._tier ?? 0) > 0) return null;
-    const json = await this.codec.decryptJsonString(envelope);
+    const json = await this.codec.decryptJsonString({ collection: this.name, id }, envelope);
     if (json === null) return null;
     return JSON.parse(json);
   }
@@ -3562,7 +3611,7 @@ var Collection = class {
       if (cached) return cached.record;
       const env = await this.adapter.get(this.vault, this.name, id);
       if (!env || (env._tier ?? 0) > 0) return void 0;
-      const rec = await this.codec.decryptRecord(env, { id });
+      const rec = await this.codec.decryptRecord({ collection: this.name, id }, env, {});
       return rec === null ? void 0 : rec;
     }
     await this.ensureHydrated();
@@ -3610,7 +3659,7 @@ var Collection = class {
       if (cached2) return { record: cached2.record, version: cached2.version };
       const env = await this.adapter.get(this.vault, this.name, id);
       if (!env || (env._tier ?? 0) > 0) return { record: null, version: 0 };
-      return { record: await this.codec.decryptRecord(env, { skipValidation: true, id }) ?? null, version: env._v };
+      return { record: await this.codec.decryptRecord({ collection: this.name, id }, env, { skipValidation: true }) ?? null, version: env._v };
     }
     await this.ensureHydrated();
     const cached = this.cache.get(id);
@@ -3632,7 +3681,7 @@ var Collection = class {
     if (this.sensitiveFields.size > 0 || this.via?.hasAtRestHooks === true) {
       const env = await this.adapter.get(this.vault, this.name, id);
       if (!env || isTombstone(env, this.storeCiphertext) || (env._tier ?? 0) > 0) return void 0;
-      const rec = await this.codec.decryptRecord(env, { skipValidation: true, id });
+      const rec = await this.codec.decryptRecord({ collection: this.name, id }, env, { skipValidation: true });
       return rec === null ? void 0 : { record: rec, version: env._v };
     }
     const cached = this.cache.get(id);
@@ -3644,7 +3693,7 @@ var Collection = class {
     const env = await this.adapter.get(this.vault, this.name, id);
     if (!env) return { env: null, record: null, elided: false };
     if ((env._tier ?? 0) > 0) return { env, record: null, elided: false };
-    return { env, record: await this.codec.decryptRecord(env, { skipValidation: true, id }), elided: false };
+    return { env, record: await this.codec.decryptRecord({ collection: this.name, id }, env, { skipValidation: true }), elided: false };
   }
   /**
    * Wraps {@link RecordCodec.toCacheRecord} with an additional strip for
@@ -3668,9 +3717,9 @@ var Collection = class {
    * payload that is not a CRDT state. The `lww-map` and `rga` branches each
    * carried a copy, byte-identical apart from the cast (#842).
    */
-  async #decodePriorCrdtState(envelope) {
+  async #decodePriorCrdtState(id, envelope) {
     if (!envelope) return void 0;
-    const prevJson = await this.codec.decryptJsonString(envelope);
+    const prevJson = await this.codec.decryptJsonString({ collection: this.name, id }, envelope);
     if (prevJson === null) return void 0;
     const prevParsed = JSON.parse(prevJson);
     if (prevParsed === null || typeof prevParsed !== "object" || !("_crdt" in prevParsed)) {
@@ -3707,7 +3756,8 @@ var Collection = class {
       this.vault,
       this.name,
       id,
-      await this.codec.encryptRecord(prior.record, prior.version, cek, void 0, void 0, vdigCtx, id)
+      await this.codec.encryptRecord(this.strategies.history.historyIdentity(this.name, id, prior.version), prior.record, prior.version, cek, void 0, void 0, vdigCtx)
+      // sealed against its _history STORAGE identity (#1041)
     );
     this.emitter.emit("history:save", { vault: this.vault, collection: this.name, id, version: prior.version });
     if (this.historyConfig.maxVersions) {
@@ -3817,20 +3867,20 @@ var Collection = class {
       const now = (/* @__PURE__ */ new Date()).toISOString();
       let crdtState;
       if (this.crdtMode === "lww-map") {
-        const existingState = await this.#decodePriorCrdtState(existingEnvelope);
+        const existingState = await this.#decodePriorCrdtState(id, existingEnvelope);
         crdtState = this.strategies.crdt.buildLwwMapState(record, existingState, now);
       } else if (this.crdtMode === "rga") {
-        const existingState = await this.#decodePriorCrdtState(existingEnvelope);
+        const existingState = await this.#decodePriorCrdtState(id, existingEnvelope);
         crdtState = this.strategies.crdt.buildRgaState(Array.isArray(record) ? record : [record], existingState, generateULID);
       } else {
         crdtState = { _crdt: "yjs", update: record };
       }
       const version = existingVersion + 1;
       const cek = this.perRecordCek ? await this.resolveRecordCek(id) : void 0;
-      const envelope = await this.codec.encryptJsonString(JSON.stringify(crdtState), version, cek, options?.source, options?.sourceTs);
+      const envelope = await this.codec.encryptJsonString({ collection: this.name, id }, JSON.stringify(crdtState), version, cek, options?.source, options?.sourceTs);
       await this.adapter.put(this.vault, this.name, id, envelope);
       const resolvedRecord = this.strategies.crdt.resolveCrdtSnapshot(crdtState);
-      const existingResolvedRecord = existingEnvelope ? await this.codec.decryptRecord(existingEnvelope, { skipValidation: true }) : null;
+      const existingResolvedRecord = existingEnvelope ? await this.codec.decryptRecord({ collection: this.name, id }, existingEnvelope, { skipValidation: true }) : null;
       const existingResolved = existingResolvedRecord !== null ? { record: existingResolvedRecord, version: existingVersion } : void 0;
       if (existingResolved) {
         await this.#savePriorHistory(id, existingResolved, cek, this.vdigFields !== null ? { id, prev: existingEnvelope } : void 0);
@@ -3870,7 +3920,7 @@ var Collection = class {
       if (!existing) {
         priorRaw = await this.adapter.get(this.vault, this.name, id);
         if (priorRaw) {
-          const previousRecord = await this.codec.decryptRecord(priorRaw, { id });
+          const previousRecord = await this.codec.decryptRecord({ collection: this.name, id }, priorRaw, {});
           if (previousRecord !== null) {
             existing = { record: previousRecord, version: priorRaw._v };
           }
@@ -3890,7 +3940,7 @@ var Collection = class {
     this.uniqueConstraints?.check(id, record);
     const cek = this.perRecordCek ? await this.resolveRecordCek(id) : void 0;
     const vdigCtx = this.vdigFields !== null ? { id, prev: await this.adapter.get(this.vault, this.name, id) } : void 0;
-    const envelope = await this.codec.encryptRecord(record, version, cek, options?.source, options?.sourceTs, vdigCtx, id);
+    const envelope = await this.codec.encryptRecord({ collection: this.name, id }, record, version, cek, options?.source, options?.sourceTs, vdigCtx);
     return { id, envelope, version, indexed: record, event: record, prior: existing, cek, vdigCtx, reason: options?.reason };
   }
   /**
@@ -3936,7 +3986,7 @@ var Collection = class {
    */
   async dispatchMaterializedViews(id, record, wave) {
     if (this.materializedViewSource === void 0) return;
-    const { dispatchMaterializedViews } = await import("./dispatch-FZEAWKVM.js");
+    const { dispatchMaterializedViews } = await import("./dispatch-TNM5CRLZ.js");
     return dispatchMaterializedViews(this.#mvDispatchCtx(this.materializedViewSource), id, record, wave);
   }
   /**
@@ -3964,7 +4014,7 @@ var Collection = class {
         const cached = this.lru.get(id);
         const env = await this.adapter.get(this.vault, this.name, id);
         if (!env || isTombstone(env, this.storeCiphertext) || isDeleteMarker(env)) return null;
-        raw = await this.codec.decryptRecord(env, { id });
+        raw = await this.codec.decryptRecord({ collection: this.name, id }, env, {});
         if (raw === null) return null;
         if (!cached) {
           this.lru.set(id, { record: await this.codec.toCacheRecord(raw, env, id), version: env._v }, estimateRecordBytes(raw));
@@ -3975,7 +4025,7 @@ var Collection = class {
         else {
           const env = await this.adapter.get(this.vault, this.name, id);
           if (!env || isTombstone(env, this.storeCiphertext) || isDeleteMarker(env)) return null;
-          raw = await this.codec.decryptRecord(env, { id });
+          raw = await this.codec.decryptRecord({ collection: this.name, id }, env, {});
           if (raw === null) return null;
           this.lru.set(id, { record: raw, version: env._v }, estimateRecordBytes(raw));
         }
@@ -3992,7 +4042,7 @@ var Collection = class {
   async _getStoredRecordForDispatch(id) {
     const env = await this.adapter.get(this.vault, this.name, id);
     if (!env || isTombstone(env, this.storeCiphertext) || isDeleteMarker(env)) return null;
-    const record = await this.codec.decryptRecord(env, { id });
+    const record = await this.codec.decryptRecord({ collection: this.name, id }, env, {});
     return record === null ? null : { record, version: env._v };
   }
   /**
@@ -4109,7 +4159,7 @@ var Collection = class {
    *  dispatch wave's per-target dedup; `undefined` on the local-write path (byte-identical). */
   async dispatchDerivations(id, record, version, wave) {
     if (this.derivationSource === void 0) return;
-    const { dispatchDerivations } = await import("./dispatch-MJ6SHB3Y.js");
+    const { dispatchDerivations } = await import("./dispatch-3ZA733EY.js");
     return dispatchDerivations({
       ...this.#derivationDeleteCtx(this.derivationSource),
       via: this.via,
@@ -4292,7 +4342,7 @@ var Collection = class {
       if (!existing && this.historyConfig.enabled !== false) {
         const previousEnvelope2 = await this.adapter.get(this.vault, this.name, id);
         if (previousEnvelope2) {
-          const previousRecord = await this.codec.decryptRecord(previousEnvelope2, { id });
+          const previousRecord = await this.codec.decryptRecord({ collection: this.name, id }, previousEnvelope2, {});
           if (previousRecord !== null) {
             existing = { record: previousRecord, version: previousEnvelope2._v };
           }
@@ -4307,7 +4357,7 @@ var Collection = class {
     if (this.onDirty) {
       const live = previousEnvelope;
       if (!live || isTombstone(live, this.storeCiphertext) || isDeleteMarker(live)) return null;
-      marker = buildDeleteMarker(live._v + 1, this.keyring.userId);
+      marker = buildDeleteMarker({ collection: this.name, id }, live._v + 1, this.keyring.userId);
     }
     const snapshots = existing !== void 0 && this.historyConfig.enabled !== false;
     const cek = snapshots && this.perRecordCek ? await this.resolveRecordCek(id) : void 0;
@@ -4329,7 +4379,7 @@ var Collection = class {
   async _commitDelete(prepared, persist = true) {
     const { id, internal, existing, previousPayloadHash, marker, cek, vdigCtx } = prepared;
     if (existing && this.historyConfig.enabled !== false) {
-      await this.strategies.history.saveHistory(this.adapter, this.vault, this.name, id, await this.codec.encryptRecord(existing.record, existing.version, cek, void 0, void 0, vdigCtx, id));
+      await this.strategies.history.saveHistory(this.adapter, this.vault, this.name, id, await this.codec.encryptRecord(this.strategies.history.historyIdentity(this.name, id, existing.version), existing.record, existing.version, cek, void 0, void 0, vdigCtx));
     }
     if (marker) {
       if (persist) await this.adapter.put(this.vault, this.name, id, marker);
@@ -4396,7 +4446,7 @@ var Collection = class {
    */
   async _decodeEnvelope(envelope, id) {
     try {
-      const rec = await this.codec.decryptRecord(envelope, { skipValidation: true, id });
+      const rec = await this.codec.decryptRecord({ collection: this.name, id }, envelope, { skipValidation: true });
       return rec === null ? null : rec;
     } catch {
       return null;
@@ -4405,7 +4455,7 @@ var Collection = class {
   async _writeTombstone(id, actor) {
     const live = await this.adapter.get(this.vault, this.name, id);
     if (!live || isTombstone(live, this.storeCiphertext) || isDeleteMarker(live)) return null;
-    await this.adapter.put(this.vault, this.name, id, buildTombstone(live._v, actor));
+    await this.adapter.put(this.vault, this.name, id, buildTombstone({ collection: this.name, id }, live._v, actor));
     this.cache.delete(id);
     this.lru?.remove(id);
     this.cekCache?.remove(id);
@@ -4424,7 +4474,7 @@ var Collection = class {
    */
   async dispatchArrayDerivationsOnDelete(id, eraseRecordShapeToo = false) {
     if (this.derivationSource === void 0) return 0;
-    const { dispatchArrayDerivationsOnDelete } = await import("./dispatch-MJ6SHB3Y.js");
+    const { dispatchArrayDerivationsOnDelete } = await import("./dispatch-3ZA733EY.js");
     return dispatchArrayDerivationsOnDelete(this.#derivationDeleteCtx(this.derivationSource), id, eraseRecordShapeToo);
   }
   /**
@@ -4438,7 +4488,7 @@ var Collection = class {
    */
   async dispatchMaterializedViewsOnDelete(id) {
     if (this.materializedViewSource === void 0) return { deleted: 0, residueUndecodable: [], residueDeclined: [] };
-    const { dispatchMaterializedViewsOnDelete } = await import("./dispatch-FZEAWKVM.js");
+    const { dispatchMaterializedViewsOnDelete } = await import("./dispatch-TNM5CRLZ.js");
     return dispatchMaterializedViewsOnDelete(this.#mvDispatchCtx(this.materializedViewSource), id);
   }
   /**
@@ -4458,7 +4508,7 @@ var Collection = class {
       );
     }
     if (this.materializedViewSource !== void 0) {
-      const { resolveStaleMVOnRead } = await import("./stale-ARHFVL5U.js");
+      const { resolveStaleMVOnRead } = await import("./stale-TH7SSVRV.js");
       await resolveStaleMVOnRead(this.materializedViewSource, this.name, this.#dispatchCtx({ collection: this.name, id: "resolve-on-read" }));
     }
     await this.ensureHydrated();
@@ -4792,7 +4842,7 @@ var Collection = class {
     const entries = [];
     for (const env of envelopes) {
       if ((env._tier ?? 0) > 0) continue;
-      const record = await this.codec.decryptRecord(env, { skipValidation: true, id });
+      const record = await this.codec.decryptRecord(this.strategies.history.historyIdentity(this.name, id, env._v), env, { skipValidation: true });
       if (record === null) continue;
       entries.push({
         version: env._v,
@@ -4821,7 +4871,7 @@ var Collection = class {
       version
     );
     if (!envelope || (envelope._tier ?? 0) > 0 || await liveRecordIsElevated(this.adapter, this.vault, this.name, id)) return null;
-    return this.codec.decryptRecord(envelope, { skipValidation: true, id });
+    return this.codec.decryptRecord(this.strategies.history.historyIdentity(this.name, id, envelope._v), envelope, { skipValidation: true });
   }
   /** Revert a record to a past version. Creates a new version with the old content. */
   async revert(id, version) {
@@ -4927,7 +4977,7 @@ var Collection = class {
       const id = ids[i];
       const envelope = await this.adapter.get(this.vault, this.name, id);
       if (envelope && (envelope._tier ?? 0) === 0) {
-        const record = await this.codec.decryptRecord(envelope, { id, sealedAsHandles: true });
+        const record = await this.codec.decryptRecord({ collection: this.name, id }, envelope, { sealedAsHandles: true });
         if (record === null) continue;
         items.push(record);
         if (!this.lazy && !this.cache.has(id)) {
@@ -5009,7 +5059,7 @@ var Collection = class {
     const out = [];
     for (const { id, envelope } of items) {
       if ((envelope._tier ?? 0) > 0) continue;
-      const record = await this.codec.decryptRecord(envelope, { id, sealedAsHandles: true });
+      const record = await this.codec.decryptRecord({ collection: this.name, id }, envelope, { sealedAsHandles: true });
       if (record === null) continue;
       out.push({ id, record, version: envelope._v });
     }
@@ -5070,7 +5120,7 @@ var Collection = class {
       }
       return;
     }
-    const record = await this.codec.decryptRecord(envelope, { id, sealedAsHandles: true });
+    const record = await this.codec.decryptRecord({ collection: this.name, id }, envelope, { sealedAsHandles: true });
     if (record === null) {
       this.cache.delete(id);
       if (previous) {
@@ -5166,7 +5216,7 @@ var Collection = class {
     for (const id of ids) {
       const envelope = await this.adapter.get(this.vault, this.name, id);
       if (envelope && !isTombstone(envelope, this.storeCiphertext) && !isDeleteMarker(envelope) && (envelope._tier ?? 0) === 0) {
-        const record = await this.codec.decryptRecord(envelope, { id, sealedAsHandles: true });
+        const record = await this.codec.decryptRecord({ collection: this.name, id }, envelope, { sealedAsHandles: true });
         if (record === null) continue;
         this.cache.set(id, { record, version: envelope._v });
       } else if (envelope && isDeleteMarker(envelope)) {
@@ -5185,7 +5235,7 @@ var Collection = class {
         continue;
       }
       if (isTombstone(envelope, this.storeCiphertext) || (envelope._tier ?? 0) > 0) continue;
-      const record = await this.codec.decryptRecord(envelope, { id, sealedAsHandles: true });
+      const record = await this.codec.decryptRecord({ collection: this.name, id }, envelope, { sealedAsHandles: true });
       if (record === null) continue;
       this.cache.set(id, { record, version: envelope._v });
     }
@@ -5319,7 +5369,7 @@ var Collection = class {
     for (const [id, entry] of this.cache) {
       const cek = this.perRecordCek ? await this.resolveRecordCek(id) : void 0;
       const prevForVdig = this.vdigFields !== null ? await this.adapter.get(this.vault, this.name, id) : null;
-      result[id] = await this.codec.encryptRecord(entry.record, entry.version, cek, void 0, void 0, this.vdigFields !== null ? { id, prev: prevForVdig } : void 0, id);
+      result[id] = await this.codec.encryptRecord({ collection: this.name, id }, entry.record, entry.version, cek, void 0, void 0, this.vdigFields !== null ? { id, prev: prevForVdig } : void 0);
     }
     return result;
   }
@@ -5434,7 +5484,7 @@ var Collection = class {
       const envelope = await this.adapter.get(this.vault, this.name, id);
       if (!envelope) continue;
       try {
-        const json = await this.codec.decryptJsonString(envelope);
+        const json = await this.codec.decryptJsonString({ collection: this.name, id }, envelope);
         if (json === null) continue;
         const body = JSON.parse(json);
         if (typeof body.recordId !== "string") continue;
@@ -5568,14 +5618,14 @@ var Collection = class {
   /** C-A/R10: persist the classified marker once per classified handle (store I/O in config-drift.ts). */
   async _ensureClassifiedMarker() {
     if (this._markerPersisted || this.vdigFields === null) return;
-    const { persistClassifiedMarkerForFields } = await import("./classified-marker-2KJAXRRO.js");
+    const { persistClassifiedMarkerForFields } = await import("./classified-marker-AZDSDG6V.js");
     await persistClassifiedMarkerForFields(this.adapter, this.vault, this.name, this.vdigFields, await this.getDEK(this.name));
     this._markerPersisted = true;
   }
   /** C-A/R10 drift signal — the marker's declared digest-only set, memoized to one store read per handle (see config-drift.ts). */
   async _classifiedMarkerDigestOnly() {
     if (this._markerDigestOnlyCache !== void 0) return this._markerDigestOnlyCache;
-    const { readClassifiedMarkerDigestOnly } = await import("./classified-marker-2KJAXRRO.js");
+    const { readClassifiedMarkerDigestOnly } = await import("./classified-marker-AZDSDG6V.js");
     this._markerDigestOnlyCache = await readClassifiedMarkerDigestOnly(this.adapter, this.vault, this.name, await this.getDEK(this.name));
     return this._markerDigestOnlyCache;
   }
@@ -5697,10 +5747,10 @@ var Collection = class {
     if (busActive) await this.subsystemBus.dispatch(busPoint, event);
   }
   _txAtomicSafe(opType) {
-    if (this.materializedViewSource !== void 0 && this.materializedViewSource.registry().mvsForSource(this.name).length > 0 || this.derivationSource !== void 0 && this.derivationSource.registry().strategiesForSource(this.name).length > 0 || this.crdtMode !== void 0 || this.uniqueConstraints !== null || this.writeHooks !== void 0 && this.writeHooks.hasBeforeHandlers && !this.writeHooks.suppressed) return false;
+    if (this.materializedViewSource !== void 0 && (this.materializedViewSource.registry().hasPendingPlans() || this.materializedViewSource.registry().mvsForSource(this.name).length > 0) || this.derivationSource !== void 0 && this.derivationSource.registry().strategiesForSource(this.name).length > 0 || this.crdtMode !== void 0 || this.uniqueConstraints !== null || this.writeHooks !== void 0 && this.writeHooks.hasBeforeHandlers && !this.writeHooks.suppressed) return false;
     return opType === "put" ? Object.keys(this._refs).length === 0 : this.refEnforcer === void 0 || !this.refEnforcer._deleteCascadesPossible(this.name);
   }
-  // @internal #893/#906-prep atomic-commit eligibility gate (Task 4) — false on any derivation/MV source (any lifecycle), CRDT mode, unique constraints, or refs on this write direction. Put uses precise outbound `_refs`; delete (#922) consults the enforcer's `_deleteCascadesPossible(name)` — Vault unions ALL THREE cascade sources `enforceRefsOnDelete` (with-shape/links/vault-facade.ts) fires from (lookup-ref edges, classic inbound refs, managed links); anything narrower (e.g. `getInbound` alone) would admit unsafe atomic deletes, because `_prepareDelete` runs those cascades DURING prepare. #931 narrows #906's hooks blanket: only BEFORE-hooks gate (they can REFUSE a write, which only `put()`/`delete()` honors); after-hooks and the `afterPut`/`afterDelete` observe bus cannot refuse, so the atomic path fires them itself post-finalize via `_fireAtomicAfterWrite` instead of forfeiting the batch (the pre-#931 db-global blanket cost multi-tab write-relay and forget-subject apps the atomic path entirely). See atomic-eligibility.ts.
+  // @internal #893/#906-prep atomic-commit eligibility gate (Task 4) — false on any derivation/MV source (any lifecycle), false while ANY query-form MV plan is still parked (#1139: an unplanned strategy has no `_bySource` entry, so `mvsForSource` cannot see that this collection is one of its sources — and the atomic path skips MV dispatch, which is the very thing that would replan it), CRDT mode, unique constraints, or refs on this write direction. Put uses precise outbound `_refs`; delete (#922) consults the enforcer's `_deleteCascadesPossible(name)` — Vault unions ALL THREE cascade sources `enforceRefsOnDelete` (with-shape/links/vault-facade.ts) fires from (lookup-ref edges, classic inbound refs, managed links); anything narrower (e.g. `getInbound` alone) would admit unsafe atomic deletes, because `_prepareDelete` runs those cascades DURING prepare. #931 narrows #906's hooks blanket: only BEFORE-hooks gate (they can REFUSE a write, which only `put()`/`delete()` honors); after-hooks and the `afterPut`/`afterDelete` observe bus cannot refuse, so the atomic path fires them itself post-finalize via `_fireAtomicAfterWrite` instead of forfeiting the batch (the pre-#931 db-global blanket cost multi-tab write-relay and forget-subject apps the atomic path entirely). See atomic-eligibility.ts.
   _reconcileReadState(patch) {
     if (patch.dictKeyFields) this.dictKeyFields = { ...patch.dictKeyFields, ...this.dictKeyFields };
     if (patch.i18nFields) this.i18nFields = { ...patch.i18nFields, ...this.i18nFields };
@@ -5727,8 +5777,9 @@ var Collection = class {
       syncIndexes: (id, rec, version, priorEnvelope) => syncTierIndexes(this.indexingContext(), id, rec, version, priorEnvelope),
       syncSearch: (id, rec, version) => syncTierSearch(this.searchContext(), id, rec, version),
       syncHistory: async (id, fromDek, toDek) => this.strategies.history.rewrapHistory(this.adapter, this.vault, this.name, id, fromDek, toDek, await this.getDEK(this.name)),
-      saveHistorySnapshot: async (id, envelope) => {
+      saveHistorySnapshot: async (id, version, seal) => {
         if (this.historyConfig.enabled === false) return;
+        const envelope = await seal(this.strategies.history.historyIdentity(this.name, id, version));
         await this.strategies.history.saveHistory(this.adapter, this.vault, this.name, id, envelope);
         this.emitter.emit("history:save", { vault: this.vault, collection: this.name, id, version: envelope._v });
         if (this.historyConfig.maxVersions) await this.strategies.history.pruneHistory(this.adapter, this.vault, this.name, id, { keepVersions: this.historyConfig.maxVersions });
@@ -6012,17 +6063,18 @@ var DeferredNumberingStore = class {
   async readJson(collection, id) {
     const env = await this.adapter.get(this.vault, collection, id);
     if (!env) return { env: null, value: null };
-    const json = this.encrypted ? await openEnvelopeJson(env, await this.dek(collection)) : env._data;
+    const json = this.encrypted ? await openEnvelopeJson({ collection, id }, env, await this.dek(collection)) : env._data;
     return { env, value: JSON.parse(json) };
   }
   async writeJson(collection, id, value, expectedVersion) {
     const json = JSON.stringify(value);
     let env;
     if (!this.encrypted) {
-      env = { _noydb: NOYDB_FORMAT_VERSION, _v: expectedVersion + 1, _ts: (/* @__PURE__ */ new Date()).toISOString(), _iv: "", _data: json, _by: this.actor };
+      env = buildRecordEnvelope({ collection, id, version: expectedVersion + 1 }, { iv: "", data: json });
     } else {
-      const { iv, data } = await encrypt(json, await this.dek(collection));
-      env = { _noydb: NOYDB_FORMAT_VERSION, _v: expectedVersion + 1, _ts: (/* @__PURE__ */ new Date()).toISOString(), _iv: iv, _data: data, _by: this.actor };
+      const identity = { collection, id, version: expectedVersion + 1 };
+      const { iv, data } = await encrypt(json, await this.dek(collection), buildRecordAad(identity));
+      env = buildRecordEnvelope(identity, { iv, data });
     }
     await this.adapter.put(this.vault, collection, id, env, expectedVersion);
   }
@@ -6417,7 +6469,8 @@ var VaultPeriods = class {
       if (tp) targetPurges.set(tp.period, tp);
     }
     const scoped = options === void 0 ? all : all.filter((p) => samePartition(p.partition, options.partition));
-    return scoped.map((p) => {
+    const withReopen = await this.mergeReopenState(scoped);
+    return withReopen.map((p) => {
       const f = freezes.get(p.name);
       let merged = f ? this.mergeFreeze(p, f) : p;
       const a = archives.get(p.name);
@@ -6447,8 +6500,119 @@ var VaultPeriods = class {
     if (archive) merged = this.mergeArchive(merged, archive);
     const targetPurge = await this.readReserved(PERIOD_TARGET_PURGES_COLLECTION, key);
     if (targetPurge) merged = this.mergeTargetPurge(merged, targetPurge);
+    const reopenLog = await this.readReserved(PERIOD_REOPENS_COLLECTION, key);
+    if (reopenLog) merged = { ...merged, ...resolveReopenState(reopenLog.events) };
     return merged;
   }
+  /**
+   * The full append-only reopen/reclose log for one period (#1022) — the record
+   * an audit actually asks for, in order. `[]` when never reopened.
+   */
+  async listPeriodReopens(name, options) {
+    const key = resolvePeriodKey(name, options?.partition);
+    const log = await this.readReserved(PERIOD_REOPENS_COLLECTION, key);
+    return log?.events ?? [];
+  }
+  /**
+   * Return a closed period to a writable state (#1022).
+   *
+   * Close is a three-state lifecycle in practice — open / closed / reopened —
+   * because a month gets closed and then a missing invoice arrives, or a filing
+   * is rejected and must be amended. That is routine, and it is supposed to
+   * leave a trail.
+   *
+   * The `_periods/<key>` record is NOT touched: the reopen is appended to a
+   * companion log, so the inter-period hash chain that proves the close
+   * happened survives the reopen intact. The chain reads *closed at T1,
+   * reopened at T2 by U, reclosed at T3*.
+   *
+   * A reopen withdraws the PERIOD's veto and nothing else. Record-level rules —
+   * an `immutableGuard` on a sent receipt, a frozen field — are separate gate
+   * handlers registered ahead of the period gate, so a reopened month cannot
+   * resurrect a document that is independently locked. Period state can only
+   * ever widen what the record-level rule already permits.
+   *
+   * Reopening an already-open window is allowed and appends another event: that
+   * is how a window gets extended, and the log keeps both.
+   */
+  async reopenPeriod(name, options) {
+    const existing = await this.loadPeriodsCache();
+    const period = this.findPeriod(existing, name, options);
+    if (!period) throw new ValidationError(`reopenPeriod: no period named "${name}"${scopeSuffix(options)}.`);
+    if (period.kind !== "closed") {
+      throw new ValidationError(
+        `reopenPeriod: period "${name}" is "${period.kind}"; only a closed period can be reopened.`
+      );
+    }
+    if (options?.until !== void 0 && Number.isNaN(Date.parse(options.until))) {
+      throw new ValidationError(`reopenPeriod: unparseable \`until\` "${options.until}".`);
+    }
+    return this.appendReopenEvent(period, options, {
+      op: "reopen",
+      at: (/* @__PURE__ */ new Date()).toISOString(),
+      by: this.deps.userId(),
+      ...options?.until !== void 0 && { until: options.until },
+      ...options?.reason !== void 0 && { reason: options.reason }
+    });
+  }
+  /**
+   * Seal a reopened period again (#1022), ending the window explicitly rather
+   * than waiting for an `until` to lapse. Appends to the same log, so the
+   * close → reopen → reclose sequence is recoverable in order.
+   */
+  async reclosePeriod(name, options) {
+    const existing = await this.loadPeriodsCache();
+    const period = this.findPeriod(existing, name, options);
+    if (!period) throw new ValidationError(`reclosePeriod: no period named "${name}"${scopeSuffix(options)}.`);
+    const merged = await this.mergeReopenState([period]);
+    if (!isEffectivelyReopened(merged[0], (/* @__PURE__ */ new Date()).toISOString())) {
+      throw new ValidationError(
+        `reclosePeriod: period "${name}"${scopeSuffix(options)} is not currently reopened \u2014 nothing to reclose. A period whose \`until\` has already lapsed re-sealed on its own.`
+      );
+    }
+    return this.appendReopenEvent(period, options, {
+      op: "reclose",
+      at: (/* @__PURE__ */ new Date()).toISOString(),
+      by: this.deps.userId(),
+      ...options?.reason !== void 0 && { reason: options.reason }
+    });
+  }
+  /** Append one entry to a period's reopen log, ledger it, and invalidate the guard's view. */
+  async appendReopenEvent(period, scope, event) {
+    const key = resolvePeriodKey(period.name, period.partition);
+    const prior = await this.readReserved(PERIOD_REOPENS_COLLECTION, key);
+    const record = {
+      period: period.name,
+      ...hasPartition(period.partition) && { partition: period.partition },
+      events: [...prior?.events ?? [], event]
+    };
+    const envelope = await this.writeReserved(PERIOD_REOPENS_COLLECTION, key, record);
+    await this.deps.strategy.appendPeriodLedgerEntry(
+      this.deps.getLedgerOrNull(),
+      this.deps.userId(),
+      envelope,
+      key,
+      PERIOD_REOPENS_COLLECTION
+    );
+    this.periodCache = null;
+    void scope;
+    return { ...period, ...resolveReopenState(record.events) };
+  }
+  /** Merge each period's reopen log onto it. One adapter listing, not one per period. */
+  async mergeReopenState(periods) {
+    if (periods.length === 0) return [];
+    const ids = await this.deps.adapter.list(this.deps.vault, PERIOD_REOPENS_COLLECTION);
+    if (ids.length === 0) return [...periods];
+    const byKey = /* @__PURE__ */ new Map();
+    for (const id of ids) {
+      const r = await this.readReserved(PERIOD_REOPENS_COLLECTION, id);
+      if (r) byKey.set(id, r);
+    }
+    return periods.map((p) => {
+      const log = byKey.get(resolvePeriodKey(p.name, p.partition));
+      return log ? { ...p, ...resolveReopenState(log.events) } : p;
+    });
+  }
   /** Resolve one period within the timeline named by `options` (vault-wide when absent). */
   findPeriod(all, name, options) {
     return all.find((p) => p.name === name && samePartition(p.partition, options?.partition));
@@ -6457,11 +6621,12 @@ var VaultPeriods = class {
   async assertTsWritable(existing, incoming, collection) {
     if (existing === null && incoming === null) return;
     if (this.periodCache === null) {
-      this.periodCache = await this.deps.strategy.loadPeriods(
+      const loaded = await this.deps.strategy.loadPeriods(
         this.deps.adapter,
         this.deps.vault,
-        (env) => this.decryptPeriodRecord(env)
+        (id, env) => this.decryptPeriodRecord(id, env)
       );
+      this.periodCache = await this.mergeReopenState(loaded);
     }
     if (this.periodCache.length === 0) return;
     this.deps.strategy.assertTsWritable(
@@ -6476,7 +6641,7 @@ var VaultPeriods = class {
     const loaded = await this.deps.strategy.loadPeriods(
       this.deps.adapter,
       this.deps.vault,
-      (env) => this.decryptPeriodRecord(env)
+      (id, env) => this.decryptPeriodRecord(id, env)
     );
     this.periodCache = loaded;
     return loaded;
@@ -6484,27 +6649,15 @@ var VaultPeriods = class {
   /** Generic reserved-collection writer — serves `_periods` and `_period_freezes` alike. */
   async writeReserved(collection, key, value) {
     const json = JSON.stringify(value);
+    const actor = this.deps.userId();
+    const identity = { collection, id: key, by: actor, version: 1 };
     let envelope;
     if (this.deps.encrypted) {
       const dek = await this.deps.getDEK(collection);
-      const { iv, data } = await encrypt(json, dek);
-      envelope = {
-        _noydb: NOYDB_FORMAT_VERSION,
-        _v: 1,
-        _ts: (/* @__PURE__ */ new Date()).toISOString(),
-        _iv: iv,
-        _data: data,
-        _by: this.deps.userId()
-      };
+      const { iv, data } = await encrypt(json, dek, buildRecordAad(identity));
+      envelope = buildRecordEnvelope(identity, { iv, data });
     } else {
-      envelope = {
-        _noydb: NOYDB_FORMAT_VERSION,
-        _v: 1,
-        _ts: (/* @__PURE__ */ new Date()).toISOString(),
-        _iv: "",
-        _data: json,
-        _by: this.deps.userId()
-      };
+      envelope = buildRecordEnvelope(identity, { iv: "", data: json });
     }
     await this.deps.adapter.put(this.deps.vault, collection, key, envelope);
     if (collection === PERIODS_COLLECTION && this.deps.onDirty) {
@@ -6516,14 +6669,14 @@ var VaultPeriods = class {
   async readReserved(collection, key) {
     const env = await this.deps.adapter.get(this.deps.vault, collection, key);
     if (!env) return null;
-    const json = this.deps.encrypted ? await openEnvelopeJson(env, await this.deps.getDEK(collection)) : env._data;
+    const json = this.deps.encrypted ? await openEnvelopeJson({ collection, id: key }, env, await this.deps.getDEK(collection)) : env._data;
     return JSON.parse(json);
   }
-  async decryptPeriodRecord(envelope) {
+  async decryptPeriodRecord(periodId, envelope) {
     let json;
     if (this.deps.encrypted) {
       const dek = await this.deps.getDEK(PERIODS_COLLECTION);
-      json = await openEnvelopeJson(envelope, dek);
+      json = await openEnvelopeJson({ collection: PERIODS_COLLECTION, id: periodId }, envelope, dek);
     } else {
       json = envelope._data;
     }
@@ -7098,7 +7251,7 @@ var VaultLinks = class {
 // src/with-shape/links/lazy-handle.ts
 function makeLazyLinkSetHandle(d) {
   let engine = null;
-  const load = () => engine ??= import("./link-set-E5HNY67I.js").then(
+  const load = () => engine ??= import("./link-set-5PJBBR63.js").then(
     ({ LinkSet }) => new LinkSet(d.adapter, d.vault, d.name, d.spec, d.encrypted, d.getDEK, d.actor, d.emitter, d.endpointExists)
   );
   return {
@@ -7504,6 +7657,10 @@ function reconcileViaAttach(coll, graph, name, vaultCtx, plan) {
     classifiedFields: plan.classifiedFields,
     computed: plan.computed
   }) : void 0;
+  if (plan.refs !== void 0) {
+    vaultCtx.refRegistry.register(name, plan.refs);
+    coll._attachDeclaredRefs(vaultCtx.refRegistry.getOutbound(name));
+  }
   if (plan.effectiveViaFields.moneyFields) coll._applyMoneyFields(plan.effectiveViaFields.moneyFields);
   if (plan.computed) coll._applyComputed(plan.computed);
   if (plan.fieldMeta) coll._applyFieldMeta(plan.fieldMeta);
@@ -7745,7 +7902,7 @@ function declareSatellite(ctx, collectionName, options, existingRegistry) {
   ctx.forEachSyncEngine((e) => e.remirrorPairResolvers([spec.base, spec.satellite]));
   const registry = reg;
   const baseSchema = ctx.getBaseSchema(spec.base);
-  void import("./post-register-2XSSMGEQ.js").then((m) => m.postRegister(ctx.adapter, ctx.vaultName, spec, ctx.getDEK, baseSchema, registry)).catch(() => {
+  void import("./post-register-QCJYRMIK.js").then((m) => m.postRegister(ctx.adapter, ctx.vaultName, spec, ctx.getDEK, baseSchema, registry)).catch(() => {
   });
   return reg;
 }
@@ -8065,17 +8222,6 @@ function expandRefsWithSatellites(refs, registry) {
   return anySat ? out : refs;
 }
 
-// src/with-shape/satellites/migrate-cek.ts
-async function migrateSatelliteCek(name, coll) {
-  if (coll.getConfig()?.perRecordKeys !== true) {
-    throw new SatelliteConfigError(
-      `migrateSatellitePerRecordKeys: collection "${name}" was already opened this session without perRecordKeys (construction-only); migrate before its first open, or restart the session.`
-    );
-  }
-  const migrated = await coll._applyCutoverTransform((doc) => doc);
-  return { migrated };
-}
-
 // src/with-shape/schema-update/fence-controller.ts
 function schemaBumpAuditHook(getLedger, actor) {
   return async (generation) => {
@@ -8638,6 +8784,7 @@ var Vault = class {
    *  dispatch reads/writes — from this vault's OWN privates, rather than passing `this` itself. */
   _viaReconcileCtx() {
     return {
+      refRegistry: this.refRegistry,
       i18nStrategy: this.strategies.i18n,
       locale: this.locale,
       translateText: this.translateText,
@@ -8713,6 +8860,8 @@ var Vault = class {
     if (coll) {
       reconcileViaAttach(coll, this.graph, collectionName, this._viaReconcileCtx(), {
         effectiveViaFields,
+        ...options?.refs !== void 0 ? { refs: options.refs } : {},
+        // #1141 — late `refs` declaration
         ...options?.computed !== void 0 ? { computed: options.computed } : {},
         ...options?.fieldMeta !== void 0 ? { fieldMeta: options.fieldMeta } : {},
         ...options?.meta !== void 0 ? { meta: options.meta } : {},
@@ -8728,7 +8877,7 @@ var Vault = class {
         const strategies = options.schemaUpdate ?? [];
         const work = (async () => {
           const dek = await this.getDEK(collectionName);
-          const { persistSchemaIfNeeded } = await import("./register-4EFJCVYD.js");
+          const { persistSchemaIfNeeded } = await import("./register-JBOEHTVX.js");
           const result = await persistSchemaIfNeeded({
             store: this.adapter,
             vault: this.name,
@@ -8878,7 +9027,7 @@ var Vault = class {
         const work = (async () => {
           try {
             const dek = await this.getDEK(collectionName);
-            await (await import("./register-4EFJCVYD.js")).persistSchemaIfNeeded({
+            await (await import("./register-JBOEHTVX.js")).persistSchemaIfNeeded({
               store: this.adapter,
               vault: this.name,
               collectionName,
@@ -8921,9 +9070,10 @@ var Vault = class {
    * unblocks R-S7 when a base gains forget coverage after its satellite was
    * already declared without `perRecordKeys`. Call BEFORE re-declaring with
    * `{ satelliteOf, perRecordKeys: true }` AND before this collection serves
-   * writes (unfenced walk — see {@link migrateSatelliteCek}); resumable.
+   * writes (unfenced walk — see `with-shape/satellites/migrate-cek.ts`); resumable.
    */
   async migrateSatellitePerRecordKeys(satelliteName) {
+    const { migrateSatelliteCek } = await import("./migrate-cek-V3VDRV24.js");
     return migrateSatelliteCek(satelliteName, this.collection(satelliteName, { perRecordKeys: true }));
   }
   /**
@@ -9554,16 +9704,23 @@ var Vault = class {
    */
   // eslint-disable-next-line @typescript-eslint/consistent-type-imports
   async _loadPodSigner() {
-    const { loadSigner } = await import("./signer-TA55QB6R.js");
+    const { loadSigner } = await import("./signer-53AQ3BU2.js");
     return loadSigner(this.adapter, this.name, this.getDEK);
   }
   async writeExportAudit(entry) {
     const json = JSON.stringify(entry);
+    const exportAuditIdentity = { collection: EXPORT_AUDIT_COLLECTION, id: entry.id, by: entry.actor, version: 1 };
     const envelope = this.encrypted ? await (async () => {
       const dek = await this.getDEK(EXPORT_AUDIT_COLLECTION);
-      const { iv, data } = await encrypt(json, dek);
-      return { _noydb: NOYDB_FORMAT_VERSION, _v: 1, _ts: entry.startedAt, _iv: iv, _data: data, _by: entry.actor };
-    })() : { _noydb: NOYDB_FORMAT_VERSION, _v: 1, _ts: entry.startedAt, _iv: "", _data: json, _by: entry.actor };
+      const { iv, data } = await encrypt(json, dek, buildRecordAad(exportAuditIdentity));
+      return buildRecordEnvelope(
+        exportAuditIdentity,
+        { ts: entry.startedAt, iv, data }
+      );
+    })() : buildRecordEnvelope(
+      exportAuditIdentity,
+      { ts: entry.startedAt, iv: "", data: json }
+    );
     await this.adapter.put(this.name, EXPORT_AUDIT_COLLECTION, entry.id, envelope);
   }
   canExport(tier, format) {
@@ -9577,12 +9734,12 @@ var Vault = class {
    *
    * @internal
    */
-  async _decryptEnvelopeForBundleFilter(env, collectionName) {
+  async _decryptEnvelopeForBundleFilter(env, collectionName, recordId) {
     if (!this.encrypted) {
       return JSON.parse(env._data);
     }
     const dek = await this.getDEK(collectionName);
-    const json = await openEnvelopeJson(env, dek);
+    const json = await openEnvelopeJson({ collection: collectionName, id: recordId }, env, dek);
     return JSON.parse(json);
   }
   canImport(tier, format) {
@@ -10037,7 +10194,7 @@ var Vault = class {
   async _initGuards(handles) {
     if (handles.length === 0) return;
     const [{ GuardRegistry }, { ReadOnlyVaultFacade }] = await Promise.all([
-      import("./registry-IKUR2MXD.js"),
+      import("./registry-5DYHQFJS.js"),
       import("./read-only-facade-CHCKSEPD.js")
     ]);
     const registry = new GuardRegistry();
@@ -10065,7 +10222,7 @@ var Vault = class {
   async _initDerivations(handles) {
     if (handles.length === 0) return;
     const [{ DerivationRegistry }, { ReadOnlyVaultFacade }] = await Promise.all([
-      import("./registry-4SDHHOJ7.js"),
+      import("./registry-R23SQUQH.js"),
       import("./read-only-facade-CHCKSEPD.js")
     ]);
     const registry = new DerivationRegistry();
@@ -10097,7 +10254,7 @@ var Vault = class {
    */
   async _initMaterializedViews(handles) {
     if (handles.length === 0) return;
-    const { MaterializedViewRegistry } = await import("./registry-OYTFGWVK.js");
+    const { MaterializedViewRegistry } = await import("./registry-J25H6VB4.js");
     const registry = new MaterializedViewRegistry();
     this.materializedViewRegistry = registry;
     const db = this;
@@ -10122,7 +10279,7 @@ var Vault = class {
    */
   async _initOverlayedViews(handles) {
     if (handles.length === 0) return;
-    const { OverlayedViewRegistry } = await import("./registry-CZVINVQH.js");
+    const { OverlayedViewRegistry } = await import("./registry-EANV44W2.js");
     const registry = new OverlayedViewRegistry();
     const mvRegistry = this.materializedViewRegistry;
     const overlayNames = /* @__PURE__ */ new Set();
@@ -10180,18 +10337,19 @@ var Vault = class {
     if (registry === null) {
       return { written: 0, deleted: 0, failed: 0, residueUndecodable: [], residueDeclined: [] };
     }
+    await registry.resolvePendingPlans();
     const reg = registry.byName(name);
     if (!reg) {
       throw new Error(`refreshView: no MV registered with name "${name}"`);
     }
-    const { MaterializedViewExecutor } = await import("./executor-YIQB2S6N.js");
+    const { MaterializedViewExecutor } = await import("./executor-ZUTUMTPA.js");
     const result = await MaterializedViewExecutor.refresh(reg, {
       getCollection: (n) => this.collection(n),
       getActiveTxContext: () => this.noydb._activeTxContextOrNull,
       getQueryContext: () => this,
       dispatchCtx: this._dispatchCtx({ collection: name, id: "refreshView" })
     });
-    const { clearMVStaleFully } = await import("./stale-ARHFVL5U.js");
+    const { clearMVStaleFully } = await import("./stale-TH7SSVRV.js");
     await clearMVStaleFully(this.adapter, this.name, registry, name);
     return result;
   }
@@ -10204,7 +10362,7 @@ var Vault = class {
     if (registry === null) return { derived: 0, failed: 0, skippedFrozen: 0 };
     const strategies = registry.strategiesForSource(sourceCollection);
     if (strategies.length === 0) return { derived: 0, failed: 0, skippedFrozen: 0 };
-    const { DerivationExecutor } = await import("./executor-S4QIKEHW.js");
+    const { DerivationExecutor } = await import("./executor-BBEEUFO3.js");
     const sourceColl = this.collection(sourceCollection);
     const records = await sourceColl.list();
     const ctx = { vault: this.derivationFacade ?? new (await import("./read-only-facade-CHCKSEPD.js")).ReadOnlyVaultFacade(this, "derivation") };
@@ -10231,7 +10389,7 @@ var Vault = class {
           if (!outSpec) continue;
           const outputColl = this.collection(outSpec.collection);
           if (out.kind === "array") {
-            const { loadFanoutSidecar, saveFanoutSidecar } = await import("./fanout-sidecar-NNAJQXMX.js");
+            const { loadFanoutSidecar, saveFanoutSidecar } = await import("./fanout-sidecar-3QZU7ZZX.js");
             const prior = await loadFanoutSidecar(this.adapter, this.name, spec.source, id, key, this.getDEK, this.encrypted);
             const prevKeys = new Set(prior?.keys ?? []);
             const newKeysList = out.entries.map((e) => e.key);
@@ -10458,7 +10616,7 @@ var Vault = class {
    * collection.
    */
   async delegate(opts) {
-    const { issueDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-MO7YZYJS.js");
+    const { issueDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-5F36DRDH.js");
     if (!this.keyring.kek) {
       throw new ValidationError(
         "issueDelegation: keyring.kek is null \u2014 issuing a delegation requires a tier-1 unlock. Re-authenticate at tier 1 (secret) first."
@@ -10480,7 +10638,7 @@ var Vault = class {
    * if the id does not exist.
    */
   async revokeDelegation(id) {
-    const { revokeDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-MO7YZYJS.js");
+    const { revokeDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-5F36DRDH.js");
     await revokeDelegation(this.adapter, this.name, id);
     void DELEGATIONS_COLLECTION;
   }
@@ -10576,25 +10734,18 @@ var Vault = class {
   async writeElevationAudit(entry) {
     const id = `elev-${Date.now().toString(36)}-${Math.random().toString(16).slice(2, 10)}`;
     const json = JSON.stringify({ id, ...entry });
+    const elevationAuditIdentity = { collection: ELEVATION_AUDIT_COLLECTION, id, by: entry.actor, version: 1 };
     const envelope = this.encrypted ? await (async () => {
       const dek = await this.getDEK(ELEVATION_AUDIT_COLLECTION);
-      const { iv, data } = await encrypt(json, dek);
-      return {
-        _noydb: NOYDB_FORMAT_VERSION,
-        _v: 1,
-        _ts: entry.startedAt,
-        _iv: iv,
-        _data: data,
-        _by: entry.actor
-      };
-    })() : {
-      _noydb: NOYDB_FORMAT_VERSION,
-      _v: 1,
-      _ts: entry.startedAt,
-      _iv: "",
-      _data: json,
-      _by: entry.actor
-    };
+      const { iv, data } = await encrypt(json, dek, buildRecordAad(elevationAuditIdentity));
+      return buildRecordEnvelope(
+        elevationAuditIdentity,
+        { ts: entry.startedAt, iv, data }
+      );
+    })() : buildRecordEnvelope(
+      elevationAuditIdentity,
+      { ts: entry.startedAt, iv: "", data: json }
+    );
     await this.adapter.put(this.name, ELEVATION_AUDIT_COLLECTION, id, envelope);
   }
   /**
@@ -10699,6 +10850,18 @@ var Vault = class {
   async purgePeriodTargets(name, options) {
     return this.periods.purgePeriodTargets(name, options);
   }
+  /** Return a closed period to writable (#1022); logged append-only, close chain untouched. */
+  async reopenPeriod(name, options) {
+    return this.periods.reopenPeriod(name, options);
+  }
+  /** Seal a reopened period again (#1022) rather than waiting for its `until` to lapse. */
+  async reclosePeriod(name, options) {
+    return this.periods.reclosePeriod(name, options);
+  }
+  /** The append-only reopen/reclose log for one period (#1022), in order. */
+  async listPeriodReopens(name, options) {
+    return this.periods.listPeriodReopens(name, options);
+  }
   /** @internal — called by the gate bus before put/delete. */
   async _assertTsWritable(existing, incoming, collection) {
     return this.periods.assertTsWritable(existing, incoming, collection);
@@ -10728,7 +10891,7 @@ var Vault = class {
    * @see design-history/2026-05-22-schema-dump-design.md
    */
   async dumpSchema(opts = {}) {
-    const { dumpVaultSchema } = await import("./walk-3ZECBFDA.js");
+    const { dumpVaultSchema } = await import("./walk-NABCHDZN.js");
     return dumpVaultSchema(this, opts);
   }
   /**
@@ -10823,15 +10986,15 @@ var Vault = class {
    * distinct handles, which is the right behavior — they're
    * separate vault instances now.
    */
-  async getBundleHandle() {
-    const { buildBundleHandle } = await import("./bundle-handle-GFNHT52M.js");
-    return buildBundleHandle(this.adapter, this.name);
+  async getPodHandle() {
+    const { buildPodHandle } = await import("./pod-handle-AZ3CXY5Y.js");
+    return buildPodHandle(this.adapter, this.name);
   }
   /**
    * Read the owner-curated cover for this vault (or `undefined` if
    * none is persisted). The cover lives in `_meta/public-envelope`
    * (the frozen wire name) as plaintext — readable without any KEK
-   * — so `getBundleHandle`-style callers can label a vault before
+   * — so `getPodHandle`-style callers can label a vault before
    * unlock.
    *
    * Mirrors `Noydb.getCover(vault, opts)` but scoped to a
@@ -10856,7 +11019,7 @@ var Vault = class {
    * both modes round-trip cleanly.
    */
   async dump() {
-    const { dumpVault } = await import("./backup-KULFZ2T4.js");
+    const { dumpVault } = await import("./backup-VL4GRIEW.js");
     return dumpVault(this.backupContext());
   }
   /**
@@ -10908,7 +11071,7 @@ var Vault = class {
    * — there's no chain to verify against.
    */
   async load(backupJson) {
-    const { loadVault } = await import("./backup-KULFZ2T4.js");
+    const { loadVault } = await import("./backup-VL4GRIEW.js");
     return loadVault(this.backupContext(), backupJson);
   }
   /**
@@ -10940,7 +11103,7 @@ var Vault = class {
    * way to detect tampering of an in-place vault.
    */
   async verifyBackupIntegrity() {
-    const { verifyBackupIntegrity } = await import("./backup-KULFZ2T4.js");
+    const { verifyBackupIntegrity } = await import("./backup-VL4GRIEW.js");
     return verifyBackupIntegrity(this.backupContext());
   }
   /**
@@ -11158,7 +11321,7 @@ var Vault = class {
    * is the live validator object, not a serialization of it).
    */
   async exportJSON(opts = {}) {
-    const { exportVaultJSON } = await import("./backup-KULFZ2T4.js");
+    const { exportVaultJSON } = await import("./backup-VL4GRIEW.js");
     return exportVaultJSON(this.backupContext(), opts);
   }
 };
@@ -12069,6 +12232,20 @@ var TeamFacade = class {
     this.deps.keyringCache.set(vault, keyring);
     return result;
   }
+  /** Gate + run the `verifyRoster` engine (#1121). See `Noydb.verifyRoster`. */
+  async runVerifyRoster(engine, vault) {
+    const keyring = await this.deps.getKeyringInternal(vault);
+    return engine(this.deps.options.store, vault, keyring);
+  }
+  /** Gate + run the `quarantineKeyring` engine (#1121). See `Noydb.quarantineKeyring`. */
+  async runQuarantine(engine, vault, userId, factors) {
+    this.deps.checkPolicyOperation(vault, "revoke");
+    await this.deps.checkGate(vault, "revoke-user", factors);
+    const keyring = await this.deps.getKeyringInternal(vault);
+    const result = await engine(this.deps.options.store, vault, keyring, userId);
+    this.deps.keyringCache.set(vault, keyring);
+    return result;
+  }
   // ─── Tier-2 enroll / remove ─────────────────────────────────────
   /**
    * Add a tier-2 authenticator slot to the calling user's keyring.
@@ -12974,6 +13151,7 @@ var Noydb = class {
     this.#registerGuardGate();
     this.#registerPeriodGate();
     this.#registerForgetHooks();
+    this.#registerVaultHeadObserver();
     this.resetSessionTimer();
   }
   /** @internal — resolved forget strategy (NO_FORGET when not configured). */
@@ -12990,6 +13168,22 @@ var Noydb = class {
   //   - the subsystemBus `afterDelete` observer fires on delete (onAfterWrite
   //     does NOT) — drop the ref so a deleted record never lingers in the
   //     index (RISK #2). Without it, forget() would try to shred a ghost.
+  /** #1044 — see `with-commit/vault-head/strategy.ts` for why this is an observer. */
+  #registerVaultHeadObserver() {
+    if (!this.strategies.vaultHead.enabled) return;
+    for (const point of ["afterPut", "afterDelete"]) {
+      this.subsystemBus.register(point, async (event) => {
+        const vault = this.vaultCache.get(event.vault);
+        if (!vault) return;
+        const { adapter, getDEK } = vault._introspectState();
+        await this.strategies.vaultHead.note(adapter, event.vault, getDEK, {
+          collection: event.collection,
+          id: event.docId,
+          version: event.version
+        });
+      });
+    }
+  }
   #registerForgetHooks() {
     const subjects = this.strategies.forget.subjects;
     if (Object.keys(subjects).length === 0) return;
@@ -13055,7 +13249,7 @@ var Noydb = class {
       if (!facade) return;
       const ctx = { existing, vault: facade, userId: e.userId, role: e.role };
       await registry.runChecks(e.collection, incoming, ctx);
-      const { GuardExecutor } = await import("./executor-CYJQLKKI.js");
+      const { GuardExecutor } = await import("./executor-G6G3YEWR.js");
       for (const g of guards) {
         await GuardExecutor.checkFrozenFields(g, e.docId, existing, incoming, e.computedFieldNames);
       }
@@ -13176,6 +13370,7 @@ var Noydb = class {
     if (this.options.encrypt !== false && !this.policyCache.has(name)) {
       await this.bootstrapPolicy(name);
     }
+    const mergeAuthority = buildMergeAuthority(keyring);
     let syncEngine;
     const targets = normalizeSyncTargets(this.options.sync);
     if (targets.length > 0) {
@@ -13190,11 +13385,12 @@ var Noydb = class {
         emitter: this.emitter,
         syncPolicy: effectivePolicy,
         role: primary.role,
+        mergeAuthority,
         ...primary.label !== void 0 ? { label: primary.label } : {}
       });
       this.syncEngines.set(name, syncEngine);
       if (declaredPolicy) syncEngine.startScheduler();
-      for (const target of targets) {
+      for (const [index, target] of targets.entries()) {
         if (target === primary) continue;
         const targetPolicy = target.policy ?? this.options.syncPolicy ?? INDEXED_STORE_POLICY;
         const engine = this.strategies.sync.buildSyncEngine({
@@ -13205,10 +13401,10 @@ var Noydb = class {
           emitter: this.emitter,
           syncPolicy: targetPolicy,
           role: target.role,
+          mergeAuthority,
           ...target.label !== void 0 ? { label: target.label } : {}
         });
-        const key = `${name}::${target.label ?? target.role}`;
-        this.syncEngines.set(key, engine);
+        this.syncEngines.set(`${name}::${index}`, engine);
         if (target.policy ?? this.options.syncPolicy) engine.startScheduler();
       }
     }
@@ -13429,8 +13625,8 @@ var Noydb = class {
    * collection) pair that was dropped. Re-run `grant()` for those pairs, or
    * they stay locked out.
    *
-   * Unlike `revoke({ rotateKeys: true })`, this call does not REMOVE any
-   * user from the vault — they keep membership and their other collections.
+   * Unlike `revoke()`, this call does not REMOVE any user from the vault —
+   * they keep membership and their other collections.
    * This is the "just rotate" path; "revoke and rotate" lives in `revoke()`.
    *
    * Exposed on Noydb (rather than only on the lower-level keyring
@@ -13441,6 +13637,27 @@ var Noydb = class {
   async rotate(vault, collections) {
     return this.strategies.team.rotate(this.team, vault, collections);
   }
+  /**
+   * Verify every `_keyring` file in the vault. Read-only (#1121).
+   *
+   * Names each failing file and why, so the bad one need not be found by trial.
+   * Reports `checked` too: "nothing unverified" is equally true of a sweep that
+   * examined nothing.
+   */
+  async verifyRoster(vault) {
+    return this.strategies.team.verifyRoster(this.team, vault);
+  }
+  /**
+   * Remove a `_keyring` file that cannot be authenticated, and re-key behind it
+   * (#1121). Owner-only; refuses a file that verifies (use {@link revoke}).
+   *
+   * `revoke` consults the target's own `role`, so it cannot act on a file it
+   * will not trust. This ignores every claim the file makes — which is exactly
+   * why it is restricted to files that already fail authentication.
+   */
+  async quarantineKeyring(vault, userId, factors) {
+    return this.strategies.team.quarantineKeyring(this.team, vault, userId, factors);
+  }
   /** List all users with access to a vault. */
   async listUsers(vault) {
     return listUsers(this.options.store, vault);
@@ -13834,6 +14051,21 @@ var Noydb = class {
     }
     return engine.status();
   }
+  /**
+   * Per-target sync state for `vault` (#1034) — `syncStatus()` reads only the
+   * primary engine, so it cannot express "the LAN store is behind, the cloud
+   * is current". Registration order, primary first. See {@link SyncTargetStatus}.
+   */
+  syncTargetStatus(vault) {
+    const targets = [];
+    for (const [key, engine] of this.syncEngines) {
+      if (key !== vault && !key.startsWith(`${vault}::`)) continue;
+      const { dirty, lastPush, lastPull } = engine.status();
+      const { label, role } = engine;
+      targets.push({ label, role, dirty, lastPush, lastPull, caughtUp: dirty === 0 });
+    }
+    return targets;
+  }
   /**
    * Enumerate the sync targets wired for `vault` (#948) — the primary engine
    * (keyed by vault name) plus any additional targets (keyed `vault::label`
@@ -13856,7 +14088,14 @@ var Noydb = class {
   getSyncEngine(vault) {
     const engine = this.syncEngines.get(vault);
     if (!engine) {
-      throw new ValidationError("No sync adapter configured. Pass a `sync` adapter to createNoydb().");
+      if (this.syncEngines.size === 0) {
+        throw new ValidationError(
+          "No sync adapter configured. Pass a `sync` adapter to createNoydb() \u2014 a NoydbStore, a SyncTarget (`{ store, role }`), or an array of them \u2014 and `syncStrategy: withSync()` to enable the engine."
+        );
+      }
+      throw new ValidationError(
+        `No sync engine for vault "${String(vault)}". Sync is configured, but for [${[...this.syncEngines.keys()].map((k) => `"${k}"`).join(", ")}] \u2014 an engine is built per vault when it is opened, so open this vault first. Note the vault name is a REQUIRED argument: \`db.pull(vaultName)\`, not \`db.pull()\`.`
+      );
     }
     return engine;
   }
@@ -14041,8 +14280,11 @@ var Noydb = class {
    * No-op when `vault` is not currently in cache (idempotent).
    */
   lockVault(vault) {
-    this.syncEngines.get(vault)?.stopAutoSync();
-    this.syncEngines.delete(vault);
+    for (const [key, engine] of [...this.syncEngines]) {
+      if (key !== vault && !key.startsWith(`${vault}::`)) continue;
+      engine.stopAutoSync();
+      this.syncEngines.delete(key);
+    }
     this.policyEnforcers.get(vault)?.destroy();
     this.policyEnforcers.delete(vault);
     this.vaultCache.get(vault)?._stopFenceCoordination();
@@ -14379,7 +14621,7 @@ async function createNoydb(options) {
   if (!options.store) options = { ...options, store: memoryStore() };
   validateSecretModeOptions(options);
   if (!options.coordinationStrategy) options = { ...options, coordinationStrategy: await createDefaultCoordinationProvider(options.store) };
-  if (!options.userApiFactory) options = { ...options, userApiFactory: (await import("./api-RXUMEKT3.js")).createUserApi };
+  if (!options.userApiFactory) options = { ...options, userApiFactory: (await import("./api-6X2VLZ7J.js")).createUserApi };
   if (!options.policyFactory) {
     const policyModule = await import("./policy/index.js");
     options = { ...options, policyFactory: policyModule.createNoydbPolicy, policyCheckGateFn: policyModule.checkGate };
@@ -14414,4 +14656,4 @@ export {
   Noydb,
   createNoydb
 };
-//# sourceMappingURL=chunk-WK5XUYYF.js.map
+//# sourceMappingURL=chunk-JYPRZWCZ.js.map