@noy-db/hub 0.2.0-pre.29 → 0.2.0-pre.30

package/dist/{chunk-ZDW22N3E.js → chunk-BVKLJBJJ.js}

@@ -10,7 +10,7 @@ import {
 import {
   TxContext,
   revertExecuted
-} from "./chunk-BITB3T5Z.js";
+} from "./chunk-ZPJSQPQH.js";
 import {
   OverlayedCollection
 } from "./chunk-MPIZQGFA.js";
@@ -67,11 +67,11 @@ import {
 } from "./chunk-LXKBG52H.js";
 import {
   PERIODS_COLLECTION
-} from "./chunk-553CK4E2.js";
+} from "./chunk-OCYFFBZS.js";
 import {
   isDictCollectionName,
   isStaticDictDescriptor
-} from "./chunk-REHF3HSJ.js";
+} from "./chunk-K4JID2ZE.js";
 import {
   getAtPath,
   resolvePolicy,
@@ -470,6 +470,89 @@ function formatPath(path) {
   ).join(".");
 }
 
+// src/persisted-schemas/canonicalize.ts
+function canonicalize(value) {
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return "[" + value.map(canonicalize).join(",") + "]";
+  }
+  const obj = value;
+  const keys = Object.keys(obj).sort();
+  const parts = keys.map((k) => JSON.stringify(k) + ":" + canonicalize(obj[k]));
+  return "{" + parts.join(",") + "}";
+}
+
+// src/persisted-schemas/derive.ts
+function isZodSchema(value) {
+  if (value === null || typeof value !== "object") return false;
+  const std = value["~standard"];
+  if (std && typeof std === "object" && std.vendor === "zod") return true;
+  const def = value._def;
+  if (!def || typeof def !== "object") return false;
+  return typeof def.typeName === "string" && def.typeName.startsWith("Zod");
+}
+function detectKind(validator) {
+  if (isZodSchema(validator)) return "Zod";
+  return "Unknown";
+}
+function isZod4Schema(value) {
+  if (value === null || typeof value !== "object") return false;
+  return "_zod" in value;
+}
+async function loadZodToJsonSchemaConverter() {
+  try {
+    const mod = await import("zod-to-json-schema");
+    if (!mod.zodToJsonSchema) {
+      throw new Error("zod-to-json-schema export missing");
+    }
+    return mod.zodToJsonSchema;
+  } catch (err) {
+    throw new Error(
+      `persistJsonSchema requires the optional peer-dep \`zod-to-json-schema\`. Install it: \`pnpm add zod-to-json-schema\` (or npm/yarn equivalent). Original error: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+async function loadZodV4Converter() {
+  try {
+    const mod = await import("./zod-HAJM7LMS.js");
+    if (typeof mod.toJSONSchema !== "function") {
+      throw new Error("zod.toJSONSchema not available (zod v4 required)");
+    }
+    return mod.toJSONSchema;
+  } catch (err) {
+    throw new Error(
+      `persistJsonSchema with a Zod v4 schema requires zod@4 with toJSONSchema. Original error: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+async function derivePersistedSchema(validator) {
+  const kind = detectKind(validator);
+  const derivedAt = (/* @__PURE__ */ new Date()).toISOString();
+  if (kind === "Zod") {
+    let jsonSchema;
+    if (isZod4Schema(validator)) {
+      const convert = await loadZodV4Converter();
+      jsonSchema = convert(validator);
+    } else {
+      const convert = await loadZodToJsonSchemaConverter();
+      jsonSchema = convert(validator);
+    }
+    const canonical = canonicalize(jsonSchema);
+    const hash = await sha256Hex(new TextEncoder().encode(canonical));
+    return { _noydb_schema: 1, kind, jsonSchema, hash, derivedAt };
+  }
+  return {
+    _noydb_schema: 1,
+    kind,
+    jsonSchema: null,
+    hash: null,
+    reason: `derivation not yet supported for kind=${kind} (v0 supports Zod only)`,
+    derivedAt
+  };
+}
+
 // src/history/strategy.ts
 function notEnabled2(op) {
   return new Error(
@@ -1048,6 +1131,385 @@ function buildUniqueConstraintSet(collectionName, indexes, mode) {
   return new UniqueConstraintSet(collectionName, uniqueDefs);
 }
 
+// src/introspection/field-meta.ts
+var FieldMetaUnknownFieldError = class extends Error {
+  constructor(collection, key) {
+    super(`fieldMeta for collection "${collection}" references unknown field "${key}". Declare it in the schema/config or remove the fieldMeta entry.`);
+    this.collection = collection;
+    this.key = key;
+    this.name = "FieldMetaUnknownFieldError";
+  }
+  collection;
+  key;
+};
+function validateFieldMetaKeys(collection, fieldMeta, knownFields) {
+  for (const key of Object.keys(fieldMeta)) {
+    if (!knownFields.has(key)) throw new FieldMetaUnknownFieldError(collection, key);
+  }
+}
+function humanizeFieldKey(key) {
+  return key.replace(/[_-]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").trim().split(/\s+/).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+function resolveFieldMeta(key, inputs) {
+  const { channel, zodMeta, inferred } = inputs;
+  const pick = (k) => channel?.[k] ?? zodMeta?.[k] ?? inferred?.[k];
+  const description = pick("description");
+  const semanticType = pick("semanticType");
+  const unit = pick("unit");
+  const sensitivity = pick("sensitivity");
+  const aggregate = pick("aggregate");
+  const aliases = pick("aliases");
+  const displayFor = pick("displayFor");
+  const widget = pick("widget");
+  return {
+    label: pick("label") ?? humanizeFieldKey(key),
+    ...description !== void 0 ? { description } : {},
+    ...semanticType !== void 0 ? { semanticType } : {},
+    ...unit !== void 0 ? { unit } : {},
+    ...sensitivity !== void 0 ? { sensitivity } : {},
+    ...aggregate !== void 0 ? { aggregate } : {},
+    ...aliases !== void 0 ? { aliases } : {},
+    ...displayFor !== void 0 ? { displayFor } : {},
+    ...widget !== void 0 ? { widget } : {}
+  };
+}
+
+// src/introspection/fields.ts
+function jsonSchemaType(node) {
+  if (Array.isArray(node.type)) {
+    const non = node.type.filter((t) => t !== "null");
+    return non[0] ?? "opaque";
+  }
+  if (node.enum && Array.isArray(node.enum)) return "enum";
+  if (node.const !== void 0) return "enum";
+  if (typeof node.type === "string") return node.type;
+  return "opaque";
+}
+function constraintsFor(node) {
+  const out = {};
+  if (node.enum) out.values = node.enum;
+  if (node.const !== void 0) out.values = [node.const];
+  if (node.minLength !== void 0) out.minLength = node.minLength;
+  if (node.maxLength !== void 0) out.maxLength = node.maxLength;
+  if (node.pattern !== void 0) out.pattern = node.pattern;
+  if (node.format !== void 0) out.format = node.format;
+  if (node.minimum !== void 0) out.minimum = node.minimum;
+  if (node.maximum !== void 0) out.maximum = node.maximum;
+  if (node.exclusiveMinimum !== void 0) out.gt = node.exclusiveMinimum;
+  if (node.exclusiveMaximum !== void 0) out.lt = node.exclusiveMaximum;
+  return Object.keys(out).length === 0 ? void 0 : out;
+}
+function extractObjectFields(obj, source, refs) {
+  const required = new Set(Array.isArray(obj.required) ? obj.required : []);
+  const fields = {};
+  if (!obj.properties || typeof obj.properties !== "object") return { fields, required };
+  for (const [name, node] of Object.entries(obj.properties)) {
+    const descriptor = {
+      type: jsonSchemaType(node),
+      source,
+      ...required.has(name) ? {} : { optional: true },
+      ...refs?.[name] ? { references: `${refs[name].target}.id` } : {}
+    };
+    const constraints = constraintsFor(node);
+    if (constraints) descriptor.constraints = constraints;
+    fields[name] = descriptor;
+  }
+  return { fields, required };
+}
+function mergeUnionMembers(members, source, refs) {
+  if (members.length === 0) return {};
+  const extracted = members.filter((m) => m.properties && typeof m.properties === "object").map((m) => extractObjectFields(m, source, refs));
+  if (extracted.length === 0) return {};
+  const allNames = /* @__PURE__ */ new Set();
+  for (const { fields } of extracted) {
+    for (const name of Object.keys(fields)) allNames.add(name);
+  }
+  const memberCount = extracted.length;
+  const out = {};
+  for (const name of allNames) {
+    const presentIn = extracted.filter(({ fields }) => name in fields);
+    const requiredInAll = presentIn.length === memberCount && presentIn.every(({ required }) => required.has(name));
+    const base = presentIn[0].fields[name];
+    const allValues = [];
+    for (const { fields } of presentIn) {
+      const fd = fields[name];
+      if (fd?.constraints?.values && Array.isArray(fd.constraints.values)) {
+        for (const v of fd.constraints.values) {
+          if (!allValues.includes(v)) allValues.push(v);
+        }
+      }
+    }
+    const mergedConstraints = allValues.length > 0 ? { ...base.constraints ?? {}, values: allValues } : base.constraints;
+    const descriptor = {
+      type: base.type,
+      source,
+      ...requiredInAll ? {} : { optional: true },
+      ...base.references ? { references: base.references } : {}
+    };
+    if (mergedConstraints) {
+      descriptor.constraints = mergedConstraints;
+    }
+    out[name] = descriptor;
+  }
+  return out;
+}
+function jsonSchemaToFields(jsonSchema, source, refs) {
+  if (!jsonSchema || typeof jsonSchema !== "object") return {};
+  const root = jsonSchema;
+  const unionMembers = root.anyOf ?? root.oneOf;
+  if (Array.isArray(unionMembers) && unionMembers.length > 0) {
+    return mergeUnionMembers(unionMembers, source, refs);
+  }
+  if (!root.properties || typeof root.properties !== "object") return {};
+  const { fields } = extractObjectFields(root, source, refs);
+  return fields;
+}
+
+// src/introspection/describe.ts
+var ZOD_META_KEYS = /* @__PURE__ */ new Set([
+  "label",
+  "description",
+  "unit",
+  "semanticType",
+  "sensitivity",
+  "aggregate",
+  "aliases",
+  "displayFor"
+]);
+async function deriveZodFields(schema) {
+  const envelope = await derivePersistedSchema(schema);
+  if (!envelope.jsonSchema) return {};
+  const isZod4 = isZod4Schema(schema);
+  const jsonSchema = envelope.jsonSchema;
+  const fieldDescriptors = jsonSchemaToFields(jsonSchema, "live-validator");
+  const propertiesRaw = jsonSchema["properties"];
+  const result = {};
+  for (const [key, descriptor] of Object.entries(fieldDescriptors)) {
+    let meta;
+    if (isZod4 && propertiesRaw) {
+      const prop = propertiesRaw[key];
+      if (prop) {
+        const extracted = {};
+        let hasAny = false;
+        for (const mk of ZOD_META_KEYS) {
+          if (mk in prop) {
+            extracted[mk] = prop[mk];
+            hasAny = true;
+          }
+        }
+        if (hasAny) meta = extracted;
+      }
+    }
+    result[key] = {
+      type: descriptor.type,
+      optional: descriptor.optional === true,
+      ...descriptor.constraints !== void 0 ? { constraints: descriptor.constraints } : {},
+      ...meta !== void 0 ? { meta } : {}
+    };
+  }
+  return result;
+}
+function deriveWidget(opts) {
+  if (opts.resolvedWidget !== void 0) return opts.resolvedWidget;
+  switch (opts.semanticType) {
+    case "date":
+    case "datetime":
+      return "date";
+    case "currency":
+      return "money";
+    case "entity":
+      return "ref-select";
+    case "url":
+      return "url";
+    case "email":
+      return "email";
+    case "percent":
+      return "number";
+  }
+  if (opts.dict !== void 0) return "select";
+  if (opts.type === "boolean") return "checkbox";
+  if (opts.type === "number") return "number";
+  return "text";
+}
+function buildDescription(input) {
+  const { collection, fieldMeta, moneyFields, dictKeyFields, computed, refs, zodFields, dictLabels, meta, i18nFields } = input;
+  if (zodFields !== void 0 && Object.keys(zodFields).length > 0 && fieldMeta !== void 0) {
+    const knownFields = /* @__PURE__ */ new Set([
+      ...Object.keys(moneyFields ?? {}),
+      ...Object.keys(dictKeyFields ?? {}),
+      ...Object.keys(refs),
+      ...Object.keys(computed ?? {}),
+      ...Object.keys(zodFields),
+      ...Object.keys(i18nFields ?? {})
+    ]);
+    validateFieldMetaKeys(collection, fieldMeta, knownFields);
+  }
+  const allKeys = /* @__PURE__ */ new Set([
+    ...Object.keys(moneyFields ?? {}),
+    ...Object.keys(dictKeyFields ?? {}),
+    ...Object.keys(refs),
+    ...Object.keys(computed ?? {}),
+    ...Object.keys(fieldMeta ?? {}),
+    ...Object.keys(zodFields ?? {}),
+    ...Object.keys(i18nFields ?? {})
+  ]);
+  const fields = [];
+  for (const key of [...allKeys].sort()) {
+    const zod = zodFields?.[key];
+    const money = moneyFields?.[key];
+    const dict = dictKeyFields?.[key];
+    const refDesc = refs[key];
+    const isComputed = computed !== void 0 && key in computed;
+    const i18nDesc = i18nFields?.[key];
+    let type = zod?.type ?? "unknown";
+    const inferred = {};
+    let moneyBlock;
+    let dictBlock;
+    let refBlock;
+    if (money) {
+      type = "number";
+      inferred.semanticType = "currency";
+      inferred.aggregate = "sum";
+      const currency = money.soleCurrency();
+      const scale = currency !== void 0 ? money.scaleFor(currency) : void 0;
+      moneyBlock = {
+        mode: money.mode,
+        ...currency !== void 0 ? { currency } : {},
+        ...scale !== void 0 ? { scale } : {},
+        ...money.rounding !== void 0 ? { rounding: money.rounding } : {}
+      };
+    } else if (refDesc) {
+      type = refDesc.isArray ? "array" : "string";
+      inferred.semanticType = "entity";
+      refBlock = {
+        target: refDesc.target,
+        mode: refDesc.mode,
+        ...refDesc.isArray ? { isArray: true } : {}
+      };
+    } else if (dict) {
+      type = "enum";
+      if (isStaticDictDescriptor(dict)) {
+        const displayLocale = dict.displayLocale;
+        const values = dict.keys.map((k) => {
+          const localeMap = dict.table[k];
+          const label = displayLocale !== void 0 ? localeMap?.[displayLocale] ?? void 0 : void 0;
+          return label !== void 0 ? { value: k, label } : { value: k };
+        });
+        dictBlock = { name: dict.name, static: true, values };
+      } else {
+        const labelMap = dictLabels?.[dict.name];
+        const labelMapHasEntries = labelMap !== void 0 && Object.keys(labelMap).length > 0;
+        if (labelMapHasEntries) {
+          const values = Object.entries(labelMap).map(([value, label]) => ({ value, label }));
+          dictBlock = { name: dict.name, static: false, values };
+        } else if (dict.keys !== void 0) {
+          const values = dict.keys.map((k) => {
+            const label = dict.labels?.[k];
+            return label !== void 0 ? { value: k, label } : { value: k };
+          });
+          dictBlock = { name: dict.name, static: false, values };
+        } else {
+          dictBlock = { name: dict.name, static: false };
+        }
+      }
+    } else if (i18nDesc) {
+      type = "string";
+    } else if (isComputed) {
+    }
+    const channelEntry = fieldMeta?.[key];
+    const zodMeta = zod?.meta;
+    const resolved = resolveFieldMeta(key, {
+      ...channelEntry !== void 0 ? { channel: channelEntry } : {},
+      ...zodMeta !== void 0 ? { zodMeta } : {},
+      inferred
+    });
+    let i18nBlock;
+    if (i18nDesc !== void 0) {
+      const locales = i18nDesc.options.languages;
+      const densify = i18nDesc.options.densifyOnWrite;
+      i18nBlock = {
+        ...locales !== void 0 ? { locales } : {},
+        ...densify !== void 0 ? { densify } : {}
+      };
+    }
+    const widget = deriveWidget({
+      type,
+      ...resolved.semanticType !== void 0 ? { semanticType: resolved.semanticType } : {},
+      ...dictBlock !== void 0 ? { dict: dictBlock } : {},
+      ...resolved.widget !== void 0 ? { resolvedWidget: resolved.widget } : {}
+    });
+    const editable = !isComputed && key !== "id";
+    const field = {
+      key,
+      type,
+      optional: zod?.optional ?? false,
+      label: resolved.label,
+      ...resolved.description !== void 0 ? { description: resolved.description } : {},
+      ...resolved.semanticType !== void 0 ? { semanticType: resolved.semanticType } : {},
+      ...resolved.unit !== void 0 ? { unit: resolved.unit } : {},
+      ...resolved.sensitivity !== void 0 ? { sensitivity: resolved.sensitivity } : {},
+      ...resolved.aggregate !== void 0 ? { aggregate: resolved.aggregate } : {},
+      ...resolved.aliases !== void 0 ? { aliases: resolved.aliases } : {},
+      ...resolved.displayFor !== void 0 ? { displayFor: resolved.displayFor } : {},
+      ...refBlock !== void 0 ? { ref: refBlock } : {},
+      ...moneyBlock !== void 0 ? { money: moneyBlock } : {},
+      ...dictBlock !== void 0 ? { dict: dictBlock } : {},
+      ...isComputed ? { computed: true } : {},
+      ...i18nBlock !== void 0 ? { i18n: i18nBlock } : {},
+      widget,
+      editable
+    };
+    fields.push(field);
+  }
+  const collectionMeta = {
+    ...meta,
+    label: meta?.label ?? humanizeFieldKey(collection)
+  };
+  return {
+    collection,
+    fields,
+    meta: collectionMeta
+  };
+}
+
+// src/introspection/json-schema.ts
+function jsonType(t) {
+  switch (t) {
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "array":
+      return "array";
+    case "object":
+      return "object";
+    default:
+      return "string";
+  }
+}
+function buildJsonSchema(desc, base) {
+  const baseProps = base?.["properties"] ?? {};
+  const properties = {};
+  for (const f of desc.fields) {
+    const prop = { ...baseProps[f.key] ?? { type: jsonType(f.type) } };
+    prop["x-label"] = f.label;
+    if (f.unit !== void 0) prop["x-unit"] = f.unit;
+    if (f.semanticType !== void 0) prop["x-semanticType"] = f.semanticType;
+    if (f.sensitivity !== void 0) prop["x-sensitivity"] = f.sensitivity;
+    if (f.widget !== void 0) prop["x-widget"] = f.widget;
+    if (f.editable === false) prop["x-readonly"] = true;
+    if (f.money !== void 0) prop["x-money"] = f.money;
+    if (f.ref !== void 0) prop["x-ref"] = f.ref.target;
+    if (f.dict?.values) {
+      const labels = {};
+      for (const v of f.dict.values) if (v.label !== void 0) labels[v.value] = v.label;
+      if (Object.keys(labels).length) prop["x-enumLabels"] = labels;
+    }
+    properties[f.key] = prop;
+  }
+  return base != null && typeof base === "object" ? { ...base, properties } : { type: "object", properties };
+}
+
 // src/cache/lru.ts
 var Lru = class {
   entries = /* @__PURE__ */ new Map();
@@ -1270,7 +1732,7 @@ async function resolveStaleOnRead(accessor, outputCollection, id) {
     }
     const sourceWithId = { ...source, id };
     if (DerivationExecutor === null) {
-      ({ DerivationExecutor } = await import("./executor-DWVP4BSJ.js"));
+      ({ DerivationExecutor } = await import("./executor-KYSKFJ2R.js"));
     }
     const ctx = { vault: accessor.getReadOnlyFacade() };
     const result = await DerivationExecutor.run(spec, sourceWithId, 0, strategyHash, ctx);
@@ -1342,6 +1804,8 @@ var Collection = class {
   getDEK;
   onDirty;
   historyConfig;
+  /** True when the caller explicitly provided a `historyConfig` option (vs. inheriting the vault default). */
+  historyConfigExplicit;
   /**
    * tree-shake seam — the strategy that backs `collection.blob(id)`.
    * Defaults to `NO_BLOBS`, a ~10-line stub that throws with an actionable
@@ -1501,6 +1965,21 @@ var Collection = class {
    * fields when a locale is requested.
    */
   dictKeyFields;
+  /**
+   * Consumer-neutral per-field descriptors declared via the `fieldMeta`
+   * collection option. Read by `getFieldMeta()`; merged by `collection.describe()`.
+   */
+  fieldMeta;
+  /**
+   * Collection-level descriptive metadata declared via the `meta` collection
+   * option. Read by `getMeta()`; surfaced in `collection.describe()`.
+   */
+  meta;
+  /**
+   * Outbound ref declarations for this collection (snapshot from vault
+   * refRegistry at construction time). Used by `describe()` (sync, config-only).
+   */
+  _refs;
   /**
    * Money field descriptors keyed by field path. Declared via the
    * `moneyFields` collection option: `put()` quantizes to a scaled-int
@@ -1682,6 +2161,7 @@ var Collection = class {
     this.getDEK = opts.getDEK;
     this.onDirty = opts.onDirty;
     this.historyConfig = opts.historyConfig ?? { enabled: true };
+    this.historyConfigExplicit = opts.historyConfigExplicit ?? false;
     this.schema = opts.schema;
     this.ledger = opts.ledger;
     this.refEnforcer = opts.refEnforcer;
@@ -1701,6 +2181,9 @@ var Collection = class {
     this.embeddings = opts.embeddings;
     this.vectorSet = opts.embeddings ? new VectorSet() : void 0;
     this.dictKeyFields = opts.dictKeyFields;
+    this.fieldMeta = opts.fieldMeta;
+    this.meta = opts.meta;
+    this._refs = opts.declaredRefs ?? {};
     if (opts.moneyFields) validateMoneyFieldPaths(opts.moneyFields);
     this.moneyFields = opts.moneyFields;
     this.computed = opts.computed;
@@ -1838,6 +2321,113 @@ var Collection = class {
   getSchema() {
     return this.schema;
   }
+  /** The declared consumer-neutral field metadata channel (canonical). */
+  getFieldMeta() {
+    return this.fieldMeta;
+  }
+  /** The collection's declared descriptive metadata. */
+  getMeta() {
+    return this.meta;
+  }
+  /**
+   * Aggregate all collection-level configuration options that are actively set
+   * into a {@link CollectionConfig} snapshot. Returns `undefined` when no options
+   * are configured (omitting the `config` block from `dumpSchema()` output).
+   * Consumed by `walk.ts` to populate `CollectionDescriptor.config`.
+   */
+  getConfig() {
+    const i18nFields = this.i18nFields !== void 0 ? Object.keys(this.i18nFields) : void 0;
+    const embeddings = this.embeddings !== void 0 ? {
+      source: this.embeddings.source,
+      dim: this.embeddings.dim,
+      ...this.embeddings.model !== void 0 ? { model: this.embeddings.model } : {}
+    } : void 0;
+    const textIndexes = this.textIndexes !== void 0 && this.textIndexes.length > 0 ? this.textIndexes : void 0;
+    const textIndexPersist = this.searchIndexStore instanceof PersistedIndexStore ? true : void 0;
+    const perRecordKeys = this.perRecordCek ? true : void 0;
+    const provenance = this.provenance ? true : void 0;
+    const tiers = this.tiers !== null ? Array.from(this.tiers) : void 0;
+    const tierMode = this.tiers !== null ? this.tierMode : void 0;
+    const crdt = this.crdtMode !== void 0 ? this.crdtMode : void 0;
+    const history = this.historyConfigExplicit && this.historyConfig.enabled !== false ? true : void 0;
+    const hasAny = i18nFields !== void 0 || embeddings !== void 0 || textIndexes !== void 0 || textIndexPersist !== void 0 || perRecordKeys !== void 0 || provenance !== void 0 || tiers !== void 0 || crdt !== void 0 || history !== void 0;
+    if (!hasAny) return void 0;
+    return {
+      ...i18nFields !== void 0 ? { i18nFields } : {},
+      ...embeddings !== void 0 ? { embeddings } : {},
+      ...textIndexes !== void 0 ? { textIndexes } : {},
+      ...textIndexPersist !== void 0 ? { textIndexPersist } : {},
+      ...perRecordKeys !== void 0 ? { perRecordKeys } : {},
+      ...provenance !== void 0 ? { provenance } : {},
+      ...tiers !== void 0 ? { tiers } : {},
+      ...tierMode !== void 0 ? { tierMode } : {},
+      ...crdt !== void 0 ? { crdt } : {},
+      ...history !== void 0 ? { history } : {}
+    };
+  }
+  describe(opts) {
+    if (opts) {
+      return this.describeAsync(opts);
+    }
+    return buildDescription({
+      collection: this.name,
+      fieldMeta: this.fieldMeta,
+      moneyFields: this.moneyFields,
+      dictKeyFields: this.dictKeyFields,
+      computed: this.computed,
+      refs: this._refs,
+      zodFields: void 0,
+      ...this.meta !== void 0 ? { meta: this.meta } : {},
+      ...this.i18nFields !== void 0 ? { i18nFields: this.i18nFields } : {}
+    });
+  }
+  /**
+   * Async describe implementation (#483 Task 4).
+   * Derives validator-exact types via deriveZodFields (lazy, no static zod import),
+   * optionally resolves dynamic-dict labels from vault.dictionary(name).list(),
+   * then delegates to buildDescription which also runs fieldMeta key-validation.
+   */
+  async describeAsync(opts) {
+    const zodFields = this.schema !== void 0 ? await deriveZodFields(this.schema) : void 0;
+    let dictLabels;
+    if (opts.resolveDictLabels === true && this.dictKeyFields !== void 0) {
+      dictLabels = {};
+      for (const [, desc] of Object.entries(this.dictKeyFields)) {
+        if (!isStaticDictDescriptor(desc) && this.getDictionary !== void 0) {
+          const handle = await this.getDictionary(desc.name);
+          const entries = await handle.list();
+          const valueToLabel = {};
+          for (const entry of entries) {
+            const label = Object.values(entry.labels)[0];
+            if (label !== void 0) valueToLabel[entry.key] = label;
+          }
+          dictLabels[desc.name] = valueToLabel;
+        }
+      }
+    }
+    return buildDescription({
+      collection: this.name,
+      fieldMeta: this.fieldMeta,
+      moneyFields: this.moneyFields,
+      dictKeyFields: this.dictKeyFields,
+      computed: this.computed,
+      refs: this._refs,
+      zodFields,
+      ...dictLabels !== void 0 ? { dictLabels } : {},
+      ...this.meta !== void 0 ? { meta: this.meta } : {},
+      ...this.i18nFields !== void 0 ? { i18nFields: this.i18nFields } : {}
+    });
+  }
+  /** JSON Schema for this collection with describe() metadata as x- extensions. */
+  async toJSONSchema() {
+    const desc = await this.describe({});
+    let base = null;
+    if (this.schema !== void 0) {
+      const env = await derivePersistedSchema(this.schema);
+      base = env.jsonSchema ?? null;
+    }
+    return buildJsonSchema(desc, base);
+  }
   /**
    * @internal — attach money descriptors post-construction. MV dependency
    * analysis auto-creates a source collection (without options) during
@@ -1853,6 +2443,14 @@ var Collection = class {
   _applyComputed(computed) {
     if (this.computed === void 0) this.computed = computed;
   }
+  /** @internal — attach fieldMeta post-construction. See {@link _applyMoneyFields}. First-wins. */
+  _applyFieldMeta(fieldMeta) {
+    if (this.fieldMeta === void 0) this.fieldMeta = fieldMeta;
+  }
+  /** @internal — attach collection-level meta post-construction. See {@link _applyMoneyFields}. First-wins. */
+  _applyMeta(meta) {
+    if (this.meta === void 0) this.meta = meta;
+  }
   /**
    * Get a single record by ID.
    *
@@ -1874,7 +2472,7 @@ var Collection = class {
       }
     }
     if (this.materializedViewSource !== void 0) {
-      const { resolveStaleMVOnRead } = await import("./stale-IIIGOHBW.js");
+      const { resolveStaleMVOnRead } = await import("./stale-J3TUF5C5.js");
       await resolveStaleMVOnRead(this.materializedViewSource, this.name);
     }
     let record;
@@ -2400,7 +2998,7 @@ var Collection = class {
       if (mode === "eager") {
         if (executor === null) {
           ;
-          ({ MaterializedViewExecutor: executor } = await import("./executor-HB2YMIYC.js"));
+          ({ MaterializedViewExecutor: executor } = await import("./executor-VDTDGWO6.js"));
         }
         await executor.refresh(reg, {
           getCollection: (name) => this.materializedViewSource.getCollection(name),
@@ -2409,7 +3007,7 @@ var Collection = class {
         });
       } else if (mode === "lazy") {
         if (staleHelpers === null) {
-          staleHelpers = await import("./stale-IIIGOHBW.js");
+          staleHelpers = await import("./stale-J3TUF5C5.js");
         }
         staleHelpers.markMVStale(registry, reg.spec.name);
       }
@@ -2583,7 +3181,7 @@ var Collection = class {
         continue;
       }
       if (DerivationExecutor === null) {
-        ({ DerivationExecutor } = await import("./executor-DWVP4BSJ.js"));
+        ({ DerivationExecutor } = await import("./executor-KYSKFJ2R.js"));
       }
       for (const run of runs) {
         const ctx = { vault: this.derivationSource.getReadOnlyFacade() };
@@ -2602,7 +3200,7 @@ var Collection = class {
           const outputCollection = this.derivationSource.getCollection(outSpec.collection);
           const txCtx = this.derivationSource.getActiveTxContext();
           if (out.kind === "array") {
-            const { loadFanoutSidecar, saveFanoutSidecar } = await import("./fanout-sidecar-BMT7I6FI.js");
+            const { loadFanoutSidecar, saveFanoutSidecar } = await import("./fanout-sidecar-AZALISHB.js");
             const prior = await loadFanoutSidecar(
               this.adapter,
               this.vault,
@@ -2966,7 +3564,7 @@ var Collection = class {
       for (const [outputKey, outSpec] of Object.entries(spec.outputs)) {
         if (outSpec.shape !== "array") continue;
         if (helpers === null) {
-          helpers = await import("./fanout-sidecar-BMT7I6FI.js");
+          helpers = await import("./fanout-sidecar-AZALISHB.js");
         }
         const sidecar = await helpers.loadFanoutSidecar(
           this.adapter,
@@ -3006,7 +3604,7 @@ var Collection = class {
       if (mode === "eager") {
         if (executor === null) {
           ;
-          ({ MaterializedViewExecutor: executor } = await import("./executor-HB2YMIYC.js"));
+          ({ MaterializedViewExecutor: executor } = await import("./executor-VDTDGWO6.js"));
         }
         await executor.refresh(reg, {
           getCollection: (name) => this.materializedViewSource.getCollection(name),
@@ -3015,7 +3613,7 @@ var Collection = class {
         });
       } else if (mode === "lazy") {
         if (staleHelpers === null) {
-          staleHelpers = await import("./stale-IIIGOHBW.js");
+          staleHelpers = await import("./stale-J3TUF5C5.js");
         }
         staleHelpers.markMVStale(registry, reg.spec.name);
       }
@@ -3038,7 +3636,7 @@ var Collection = class {
       );
     }
     if (this.materializedViewSource !== void 0) {
-      const { resolveStaleMVOnRead } = await import("./stale-IIIGOHBW.js");
+      const { resolveStaleMVOnRead } = await import("./stale-J3TUF5C5.js");
       await resolveStaleMVOnRead(this.materializedViewSource, this.name);
     }
     await this.ensureHydrated();
@@ -6527,64 +7125,6 @@ async function listOperationalCollections(vault) {
   return [...keyring.deks.keys()].filter((c) => !c.startsWith("_"));
 }
 
-// src/persisted-schemas/canonicalize.ts
-function canonicalize(value) {
-  if (value === null || typeof value !== "object") {
-    return JSON.stringify(value);
-  }
-  if (Array.isArray(value)) {
-    return "[" + value.map(canonicalize).join(",") + "]";
-  }
-  const obj = value;
-  const keys = Object.keys(obj).sort();
-  const parts = keys.map((k) => JSON.stringify(k) + ":" + canonicalize(obj[k]));
-  return "{" + parts.join(",") + "}";
-}
-
-// src/persisted-schemas/derive.ts
-function isZodSchema(value) {
-  if (value === null || typeof value !== "object") return false;
-  const def = value._def;
-  if (!def || typeof def !== "object") return false;
-  return typeof def.typeName === "string" && def.typeName.startsWith("Zod");
-}
-function detectKind(validator) {
-  if (isZodSchema(validator)) return "Zod";
-  return "Unknown";
-}
-async function loadZodConverter() {
-  try {
-    const mod = await import("zod-to-json-schema");
-    if (!mod.zodToJsonSchema) {
-      throw new Error("zod-to-json-schema export missing");
-    }
-    return mod.zodToJsonSchema;
-  } catch (err) {
-    throw new Error(
-      `persistJsonSchema requires the optional peer-dep \`zod-to-json-schema\`. Install it: \`pnpm add zod-to-json-schema\` (or npm/yarn equivalent). Original error: ${err instanceof Error ? err.message : String(err)}`
-    );
-  }
-}
-async function derivePersistedSchema(validator) {
-  const kind = detectKind(validator);
-  const derivedAt = (/* @__PURE__ */ new Date()).toISOString();
-  if (kind === "Zod") {
-    const convert = await loadZodConverter();
-    const jsonSchema = convert(validator);
-    const canonical = canonicalize(jsonSchema);
-    const hash = await sha256Hex(new TextEncoder().encode(canonical));
-    return { _noydb_schema: 1, kind, jsonSchema, hash, derivedAt };
-  }
-  return {
-    _noydb_schema: 1,
-    kind,
-    jsonSchema: null,
-    hash: null,
-    reason: `derivation not yet supported for kind=${kind} (v0 supports Zod only)`,
-    derivedAt
-  };
-}
-
 // src/schema-update/delta.ts
 function computeSchemaDelta(stored, fresh, collection) {
   const a = stored;
@@ -6832,97 +7372,6 @@ var FenceWatcher = class {
   }
 };
 
-// src/introspection/fields.ts
-function jsonSchemaType(node) {
-  if (Array.isArray(node.type)) {
-    const non = node.type.filter((t) => t !== "null");
-    return non[0] ?? "opaque";
-  }
-  if (node.enum && Array.isArray(node.enum)) return "enum";
-  if (node.const !== void 0) return "enum";
-  if (typeof node.type === "string") return node.type;
-  return "opaque";
-}
-function constraintsFor(node) {
-  const out = {};
-  if (node.enum) out.values = node.enum;
-  if (node.const !== void 0) out.values = [node.const];
-  if (node.minLength !== void 0) out.minLength = node.minLength;
-  if (node.maxLength !== void 0) out.maxLength = node.maxLength;
-  if (node.pattern !== void 0) out.pattern = node.pattern;
-  if (node.format !== void 0) out.format = node.format;
-  if (node.minimum !== void 0) out.minimum = node.minimum;
-  if (node.maximum !== void 0) out.maximum = node.maximum;
-  if (node.exclusiveMinimum !== void 0) out.gt = node.exclusiveMinimum;
-  if (node.exclusiveMaximum !== void 0) out.lt = node.exclusiveMaximum;
-  return Object.keys(out).length === 0 ? void 0 : out;
-}
-function extractObjectFields(obj, source, refs) {
-  const required = new Set(Array.isArray(obj.required) ? obj.required : []);
-  const fields = {};
-  if (!obj.properties || typeof obj.properties !== "object") return { fields, required };
-  for (const [name, node] of Object.entries(obj.properties)) {
-    const descriptor = {
-      type: jsonSchemaType(node),
-      source,
-      ...required.has(name) ? {} : { optional: true },
-      ...refs?.[name] ? { references: `${refs[name].target}.id` } : {}
-    };
-    const constraints = constraintsFor(node);
-    if (constraints) descriptor.constraints = constraints;
-    fields[name] = descriptor;
-  }
-  return { fields, required };
-}
-function mergeUnionMembers(members, source, refs) {
-  if (members.length === 0) return {};
-  const extracted = members.filter((m) => m.properties && typeof m.properties === "object").map((m) => extractObjectFields(m, source, refs));
-  if (extracted.length === 0) return {};
-  const allNames = /* @__PURE__ */ new Set();
-  for (const { fields } of extracted) {
-    for (const name of Object.keys(fields)) allNames.add(name);
-  }
-  const memberCount = extracted.length;
-  const out = {};
-  for (const name of allNames) {
-    const presentIn = extracted.filter(({ fields }) => name in fields);
-    const requiredInAll = presentIn.length === memberCount && presentIn.every(({ required }) => required.has(name));
-    const base = presentIn[0].fields[name];
-    const allValues = [];
-    for (const { fields } of presentIn) {
-      const fd = fields[name];
-      if (fd?.constraints?.values && Array.isArray(fd.constraints.values)) {
-        for (const v of fd.constraints.values) {
-          if (!allValues.includes(v)) allValues.push(v);
-        }
-      }
-    }
-    const mergedConstraints = allValues.length > 0 ? { ...base.constraints ?? {}, values: allValues } : base.constraints;
-    const descriptor = {
-      type: base.type,
-      source,
-      ...requiredInAll ? {} : { optional: true },
-      ...base.references ? { references: base.references } : {}
-    };
-    if (mergedConstraints) {
-      descriptor.constraints = mergedConstraints;
-    }
-    out[name] = descriptor;
-  }
-  return out;
-}
-function jsonSchemaToFields(jsonSchema, source, refs) {
-  if (!jsonSchema || typeof jsonSchema !== "object") return {};
-  const root = jsonSchema;
-  const unionMembers = root.anyOf ?? root.oneOf;
-  if (Array.isArray(unionMembers) && unionMembers.length > 0) {
-    return mergeUnionMembers(unionMembers, source, refs);
-  }
-  if (!root.properties || typeof root.properties !== "object") return {};
-  const { fields } = extractObjectFields(root, source, refs);
-  return fields;
-}
-
 // src/introspection/walk.ts
 var INTERNAL_PREFIX = "_";
 var KNOWN_INTERNAL_NAMES = ["_keyring", "_ledger", "_meta", "_schemas", "_deltas"];
@@ -6955,6 +7404,7 @@ async function dumpVaultSchema(vault, opts) {
     vault: state.name,
     emittedAt: (/* @__PURE__ */ new Date()).toISOString(),
     subsystems: state.subsystems,
+    ...state.vaultMeta !== void 0 ? { meta: state.vaultMeta } : {},
     collections,
     materializedViews,
     overlayViews,
@@ -6990,9 +7440,9 @@ async function describeCollection(state, collectionName, sampleSize, withStats)
     }
   } catch {
   }
+  const liveColl = state.collectionCache.get(collectionName);
   if (!validator) {
-    const coll = state.collectionCache.get(collectionName);
-    const schema = coll?.getSchema();
+    const schema = liveColl?.getSchema();
     if (schema) {
       try {
         const derived = await derivePersistedSchema(schema);
@@ -7006,11 +7456,26 @@ async function describeCollection(state, collectionName, sampleSize, withStats)
   }
   if (Object.keys(fields).length === 0 && sampleSize > 0) {
   }
+  const collMeta = liveColl?.getMeta();
+  const collConfig = liveColl?.getConfig();
+  const archivePresent = state.hasCollectionArchive?.(collectionName) === true;
+  const schemaUpdateNames = state.getCollectionSchemaUpdateNames?.(collectionName);
+  const hasSchemaUpdate = schemaUpdateNames !== void 0 && schemaUpdateNames.length > 0;
+  let mergedConfig;
+  if (collConfig !== void 0 || archivePresent || hasSchemaUpdate) {
+    mergedConfig = {
+      ...collConfig ?? {},
+      ...archivePresent ? { archive: true } : {},
+      ...hasSchemaUpdate ? { schemaUpdate: schemaUpdateNames } : {}
+    };
+  }
   const descriptor = {
     fields,
     indexes: [],
     refs,
-    ...validator ? { validator } : {}
+    ...validator ? { validator } : {},
+    ...collMeta !== void 0 ? { meta: collMeta } : {},
+    ...mergedConfig !== void 0 ? { config: mergedConfig } : {}
   };
   if (withStats) {
     const stats = await statsForCollection(state.adapter, state.name, collectionName);
@@ -7335,6 +7800,12 @@ var Vault = class {
    * `get()`/`list()` calls.
    */
   locale;
+  /**
+   * Vault-level descriptive metadata. Set once at construction via
+   * `openVault(name, { meta })`. First-wins: re-opening a cached vault
+   * with different meta leaves the original untouched.
+   */
+  vaultMeta;
   /**
    * Current consent scope. Set by `withConsent()` and
    * restored in its finally block. When non-null, every collection
@@ -7446,6 +7917,7 @@ var Vault = class {
     this.historyConfig = opts.historyConfig ?? { enabled: true };
     this.reloadKeyring = opts.reloadKeyring;
     this.locale = opts.locale;
+    this.vaultMeta = opts.meta;
     this.translateText = opts.plaintextTranslator;
     this.getDEK = this.makeGetDEK();
     this.user = new UserApi(
@@ -7540,6 +8012,12 @@ var Vault = class {
     if (coll && options?.computed) {
       coll._applyComputed(options.computed);
     }
+    if (coll && options?.fieldMeta) {
+      coll._applyFieldMeta(options.fieldMeta);
+    }
+    if (coll && options?.meta) {
+      coll._applyMeta(options.meta);
+    }
     if (!coll) {
       if (options?.refs) {
         this.refRegistry.register(collectionName, options.refs);
@@ -7621,6 +8099,7 @@ var Vault = class {
         getDEK: this.getDEK,
         onDirty: this.onDirty,
         historyConfig: effectiveHistoryConfig,
+        historyConfigExplicit: options?.historyConfig !== void 0,
         // thread the vault-wide blob strategy into every
         // collection. `undefined` is intentionally preserved so the
         // Collection constructor uses its NO_BLOBS default.
@@ -7727,6 +8206,15 @@ var Vault = class {
       if (options?.i18nFields !== void 0 && this.translateText) {
         collOpts.autoTranslateHook = this.translateText;
       }
+      if (options?.fieldMeta !== void 0) {
+        collOpts.fieldMeta = options.fieldMeta;
+      }
+      if (options?.meta !== void 0) {
+        collOpts.meta = options.meta;
+      }
+      if (options?.refs !== void 0) {
+        collOpts.declaredRefs = this.refRegistry.getOutbound(collectionName);
+      }
       coll = new Collection(collOpts);
       this.collectionCache.set(collectionName, coll);
       if (options?.warmIndexOnOpen === true && options.prefetch !== false) {
@@ -8154,6 +8642,10 @@ var Vault = class {
   getLocale() {
     return this.locale;
   }
+  /** Return the vault-level descriptive metadata (set-once at construction). */
+  getMeta() {
+    return this.vaultMeta;
+  }
   /**
    * The user id of the keyring backing this vault session. Useful for
    * UI affordances ("you are alice"), audit trails, and orchestration
@@ -8398,12 +8890,12 @@ var Vault = class {
     if (!fieldSchema) {
       throw new AttestationError(`issueAttestation: collection '${collectionName}' has no attestation field-schema. Declare it via vault.collection('${collectionName}', { attestation: { fields: [...] } }).`);
     }
-    const { issueAttestationCore } = await import("./issue-FZRTVGRE.js");
+    const { issueAttestationCore } = await import("./issue-DPHRF2TI.js");
     const out = await issueAttestationCore(this.makeIssueContext(), { collection: collectionName, id, fieldSchema });
     return { docId: out.docId, qr: out.qr, keyId: out.keyId, publicKeyB64: out.publicKeyB64 };
   }
   async getDocumentSigningPublicKey() {
-    const { loadSigner, loadOrCreateSigner } = await import("./signer-JMK6W2Y6.js");
+    const { loadSigner, loadOrCreateSigner } = await import("./signer-UB5TQOZ6.js");
     const existing = await loadSigner(this.adapter, this.name, this.getDEK);
     if (existing) return { keyId: existing.keyId, publicKeyB64: existing.publicKeyB64 };
     if (this.keyring.role !== "owner") {
@@ -8429,19 +8921,19 @@ var Vault = class {
     };
   }
   async revokeAttestation(docId) {
-    const { revokeDocCore } = await import("./revoke-AOCAVR56.js");
+    const { revokeDocCore } = await import("./revoke-5PUOZPJJ.js");
     await revokeDocCore(this.makeRevokeContext(), docId);
   }
   async unrevokeAttestation(docId) {
-    const { unrevokeDocCore } = await import("./revoke-AOCAVR56.js");
+    const { unrevokeDocCore } = await import("./revoke-5PUOZPJJ.js");
     await unrevokeDocCore(this.makeRevokeContext(), docId);
   }
   async getRevokedDocIds() {
-    const { getRevokedDocIdsCore } = await import("./revoke-AOCAVR56.js");
+    const { getRevokedDocIdsCore } = await import("./revoke-5PUOZPJJ.js");
     return getRevokedDocIdsCore(this.makeRevokeContext());
   }
   async publishRevocationList() {
-    const { publishRevocationListCore } = await import("./revoke-AOCAVR56.js");
+    const { publishRevocationListCore } = await import("./revoke-5PUOZPJJ.js");
     return publishRevocationListCore(this.makeRevokeContext());
   }
   makeRevokeContext() {
@@ -9084,8 +9576,8 @@ var Vault = class {
   async _initGuards(handles) {
     if (handles.length === 0) return;
     const [{ GuardRegistry }, { ReadOnlyVaultFacade }] = await Promise.all([
-      import("./registry-DKEXOJVO.js"),
-      import("./read-only-facade-EX6WZZBP.js")
+      import("./registry-IX5WKK4F.js"),
+      import("./read-only-facade-3OQRZ3VS.js")
     ]);
     const registry = new GuardRegistry();
     for (const h of handles) registry.register(h.spec);
@@ -9112,8 +9604,8 @@ var Vault = class {
   async _initDerivations(handles) {
     if (handles.length === 0) return;
     const [{ DerivationRegistry }, { ReadOnlyVaultFacade }] = await Promise.all([
-      import("./registry-IEU6ATO7.js"),
-      import("./read-only-facade-EX6WZZBP.js")
+      import("./registry-TXCKWH26.js"),
+      import("./read-only-facade-3OQRZ3VS.js")
     ]);
     const registry = new DerivationRegistry();
     for (const h of handles) {
@@ -9143,7 +9635,7 @@ var Vault = class {
    */
   async _initMaterializedViews(handles) {
     if (handles.length === 0) return;
-    const { MaterializedViewRegistry } = await import("./registry-53A55ZZE.js");
+    const { MaterializedViewRegistry } = await import("./registry-LMHO5265.js");
     const registry = new MaterializedViewRegistry();
     this.materializedViewRegistry = registry;
     const db = this;
@@ -9167,7 +9659,7 @@ var Vault = class {
    */
   async _initOverlayedViews(handles) {
     if (handles.length === 0) return;
-    const { OverlayedViewRegistry } = await import("./registry-FKL4SLU4.js");
+    const { OverlayedViewRegistry } = await import("./registry-VFEDQSYV.js");
     const registry = new OverlayedViewRegistry();
     const mvRegistry = this.materializedViewRegistry;
     const overlayNames = /* @__PURE__ */ new Set();
@@ -9214,13 +9706,13 @@ var Vault = class {
     if (!reg) {
       throw new Error(`refreshView: no MV registered with name "${name}"`);
     }
-    const { MaterializedViewExecutor } = await import("./executor-HB2YMIYC.js");
+    const { MaterializedViewExecutor } = await import("./executor-VDTDGWO6.js");
     const result = await MaterializedViewExecutor.refresh(reg, {
       getCollection: (n) => this.collection(n),
       getActiveTxContext: () => this.noydb._activeTxContextOrNull,
       getQueryContext: () => this
     });
-    const { clearMVStale } = await import("./stale-IIIGOHBW.js");
+    const { clearMVStale } = await import("./stale-J3TUF5C5.js");
     clearMVStale(registry, name);
     return result;
   }
@@ -9236,10 +9728,10 @@ var Vault = class {
     if (registry === null) return { derived: 0, failed: 0 };
     const strategies = registry.strategiesForSource(sourceCollection);
     if (strategies.length === 0) return { derived: 0, failed: 0 };
-    const { DerivationExecutor } = await import("./executor-DWVP4BSJ.js");
+    const { DerivationExecutor } = await import("./executor-KYSKFJ2R.js");
     const sourceColl = this.collection(sourceCollection);
     const records = await sourceColl.list();
-    const ctx = { vault: this.derivationFacade ?? new (await import("./read-only-facade-EX6WZZBP.js")).ReadOnlyVaultFacade(this, "derivation") };
+    const ctx = { vault: this.derivationFacade ?? new (await import("./read-only-facade-3OQRZ3VS.js")).ReadOnlyVaultFacade(this, "derivation") };
     let derived = 0;
     let failed = 0;
     for (const record of records) {
@@ -9261,7 +9753,7 @@ var Vault = class {
           if (!outSpec) continue;
           const outputColl = this.collection(outSpec.collection);
           if (out.kind === "array") {
-            const { loadFanoutSidecar, saveFanoutSidecar } = await import("./fanout-sidecar-BMT7I6FI.js");
+            const { loadFanoutSidecar, saveFanoutSidecar } = await import("./fanout-sidecar-AZALISHB.js");
             const prior = await loadFanoutSidecar(this.adapter, this.name, spec.source, id, key);
             const prevKeys = new Set(prior?.keys ?? []);
             const newKeysList = out.entries.map((e) => e.key);
@@ -9483,7 +9975,7 @@ var Vault = class {
    * collection.
    */
   async delegate(opts) {
-    const { issueDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-ZEH4LKEM.js");
+    const { issueDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-BQTRJATI.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 (passphrase) first."
@@ -9505,7 +9997,7 @@ var Vault = class {
    * if the id does not exist.
    */
   async revokeDelegation(id) {
-    const { revokeDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-ZEH4LKEM.js");
+    const { revokeDelegation, DELEGATIONS_COLLECTION } = await import("./delegation-BQTRJATI.js");
     await revokeDelegation(this.adapter, this.name, id);
     void DELEGATIONS_COLLECTION;
   }
@@ -9895,9 +10387,18 @@ var Vault = class {
         materializedViews: this.materializedViewRegistry !== null,
         overlayViews: this.overlayedViewRegistry !== null
       },
+      ...this.vaultMeta !== void 0 ? { vaultMeta: this.vaultMeta } : {},
       mvRegistry: this.materializedViewRegistry,
       overlayRegistry: this.overlayedViewRegistry,
-      derivationRegistry: this.derivationRegistry
+      derivationRegistry: this.derivationRegistry,
+      // Thread vault-level per-collection registries into the walker so
+      // walk.ts can project archive/schemaUpdate into CollectionDescriptor.config
+      // without coupling the walker to Vault internals.
+      getCollectionSchemaUpdateNames: (col) => {
+        const names = this.#schemaUpdateNames.get(col);
+        return names !== void 0 && names.length > 0 ? names : void 0;
+      },
+      hasCollectionArchive: (col) => this.archiveRegistry.has(col)
     };
   }
   /**
@@ -9949,7 +10450,7 @@ var Vault = class {
       } catch {
       }
     }
-    const { generateULID: generateULID2 } = await import("./ulid-COREQ2RQ.js");
+    const { generateULID: generateULID2 } = await import("./ulid-KEPZMD2N.js");
     const handle = generateULID2();
     const envelope = {
       _noydb: NOYDB_FORMAT_VERSION,
@@ -9975,7 +10476,7 @@ var Vault = class {
    * @see docs/subsystems/public-envelope.md
    */
   async getPublicEnvelope(opts = {}) {
-    const { readPublicEnvelope: readPublicEnvelope2 } = await import("./public-envelope-S2S2VR3F.js");
+    const { readPublicEnvelope: readPublicEnvelope2 } = await import("./public-envelope-MFMBFJLZ.js");
     return readPublicEnvelope2(this.adapter, this.name, opts);
   }
   /**
@@ -11695,7 +12196,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-HO3SIRSF.js");
+      const { GuardExecutor } = await import("./executor-M7W3NEKR.js");
       for (const g of guards) {
         await GuardExecutor.checkFrozenFields(g, e.docId, existing, incoming, e.computedFieldNames);
       }
@@ -11807,6 +12308,7 @@ var Noydb = class {
    * @param opts.locale  Default locale for i18n/dictKey field resolution
    *. Set here to avoid passing `{ locale }`
    *                     on every individual `get()`/`list()` call.
+   * @param opts.meta    Vault descriptive metadata (label, description, etc.). First-wins: applied on first open, ignored on subsequent opens.
    */
   async openVault(name, opts) {
     if (this.closed) throw new ValidationError("Instance is closed");
@@ -11891,6 +12393,7 @@ var Noydb = class {
       ...this.options.numbering !== void 0 ? { numberingConfigs: this.options.numbering } : {},
       forgetStrategy: this.forgetStrategy,
       locale: opts?.locale,
+      ...opts?.meta !== void 0 ? { meta: opts.meta } : {},
       // Thread the translator hook so Collection.put() can invoke it
       plaintextTranslator: this.options.plaintextTranslator ? (text, from, to, field, collection) => this.invokeTranslator(text, from, to, field, collection) : void 0,
       // Refresh callback used by Vault.load() to re-derive
@@ -13865,6 +14368,8 @@ export {
   evalComputedFields,
   validateSchemaInput,
   validateSchemaOutput,
+  isZodSchema,
+  derivePersistedSchema,
   tokenize,
   Lru,
   parseBytes,
@@ -13886,8 +14391,6 @@ export {
   loadDeedMarker,
   isDeedVault,
   liberateVault,
-  isZodSchema,
-  derivePersistedSchema,
   persistSchemaIfNeeded,
   Vault,
   ELEVATION_AUDIT_COLLECTION,
@@ -13902,4 +14405,4 @@ export {
   Noydb,
   createNoydb
 };
-//# sourceMappingURL=chunk-ZDW22N3E.js.map
+//# sourceMappingURL=chunk-BVKLJBJJ.js.map