@hawkeyexl/manni 4.10.0 → 4.12.0

package/dist/{chunk-2W34HX2U.js → chunk-PS257NIU.js}

@@ -1,54 +1,75 @@
 #!/usr/bin/env node
+import {
+  externalWriteWarning,
+  externalWriteWarnings,
+  manifestKeyLine,
+  mergeMetaProvenance,
+  offerExternalHomes
+} from "./chunk-2OZF2VUB.js";
+import {
+  formatList,
+  render
+} from "./chunk-SGR7ZAVE.js";
 import {
   DERIVED_ROWS,
   DERIVED_VIEW,
+  RESOLVED_VIEW,
+  assertSourcesAvailable,
+  commandsOf,
+  createDerivedView,
+  createResolvedView,
+  deriveForTable,
+  deriveMetadata,
+  derivedColumns,
+  fieldsForSql,
+  machinesOf,
+  mapConcurrent,
+  mentionsDerived,
+  mentionsResolved,
+  provenanceFenced,
+  provenanceManifests,
+  provenancePlace,
+  readerManifests,
+  readerPlace,
+  stampManifests
+} from "./chunk-QEAGL4V5.js";
+import {
   ENCRYPTED_PLACEHOLDER,
   ENCRYPTION_KEY_ENV,
   EncryptionRefusal,
   META_CONTEXT,
   PATH_JOIN,
   RESERVED,
-  RESOLVED_VIEW,
   STDIN_REQUIRES_AS,
   SYSTEM_COLUMNS,
+  TERM_KEYWORD,
   Validator,
   applyRelocation,
   assertSingleStatement,
-  assertSourcesAvailable,
   bindValue,
   collectCollections,
   collectNamedParameters,
   collectionNames,
-  commandsOf,
   committedKeyWarning,
   compareProvenance,
   compileWithFormats,
   corpusDataColumns,
   createCollectionViews,
-  createDerivedView,
   createDocsTable,
-  createResolvedView,
-  deriveForTable,
-  deriveMetadata,
-  derivedColumns,
   encryptionView,
   externalMetadataJoin,
-  fieldsForSql,
   heldManifest,
   isAtOrUnder,
   isIgnoredByGit,
   isMissing,
+  isTermMark,
   keyHome,
   lazyKey,
   lineSpec,
   loadExternalMetadata,
   loadSqlite,
-  machinesOf,
-  mapConcurrent,
   marksValidator,
   memberOf,
-  mentionsDerived,
-  mentionsResolved,
   mergeExternalMetadata,
   mergeWithMarks,
   offerPrompt,
@@ -61,22 +82,16 @@ import {
   planRelocation,
   pointerOf,
   provenanceEntries,
-  provenanceFenced,
   provenanceFindings,
-  provenanceManifests,
-  provenancePlace,
   rangeResults,
   readManifestValue,
   readProvenancePage,
-  readerManifests,
-  readerPlace,
   rebaseable,
   rebaseline,
   redactForModel,
   redactedDerived,
   registerLineFor,
   relocationContext,
-  relocationOffers,
   removeManifestKey,
   renameManifestEntry,
   renderProvenanceValue,
@@ -87,22 +102,21 @@ import {
   skipComment,
   skipStringOrIdent,
   spliceManifestValue,
-  stampManifests,
   startsComment,
   startsStringOrIdent,
   stringFormatNames,
   stripLeadingTrivia,
+  termScheme,
   topLevelKeyOf,
   unreadableMessage,
   validatesFormat,
   valueAt,
   withValueAt,
   writeEncryptionKey
-} from "./chunk-KBG463UK.js";
+} from "./chunk-SMHAYK6I.js";
 import {
-  formatList,
-  render
-} from "./chunk-QBVP3SQP.js";
+  termLabelSource
+} from "./chunk-DSWKBZWW.js";
 import {
   DERIVABLE_FIELDS,
   DERIVE_SOURCES,
@@ -156,21 +170,21 @@ import {
   urlManifestMessage,
   urlManifestOwning,
   writeFileAtomic
-} from "./chunk-G7XD4QH5.js";
-import {
-  palette
-} from "./chunk-RNVYGWIC.js";
+} from "./chunk-RGLFV4KO.js";
 import {
   escapeWorkflowCommandMessage,
   escapeWorkflowCommandProperty
 } from "./chunk-MNH7QO4Z.js";
+import {
+  palette
+} from "./chunk-RNVYGWIC.js";
 import {
   decryptValue,
   encryptValue,
   generateEncryptionKey,
   isEncryptedValue,
   isMember
-} from "./chunk-6M5VJOC2.js";
+} from "./chunk-OTJOBZJ5.js";
 import {
   warn
 } from "./chunk-HX44GB4Z.js";
@@ -179,69 +193,16 @@ import {
   assertLocalFlag,
   assertModelHasProvider,
   localNotice,
+  noOfflineModel,
+  offlineIdentity,
   providerSpecFor,
   resolveIdentity,
   selectProvider
-} from "./chunk-QCHVR4ZM.js";
+} from "./chunk-VM7VAFJW.js";
 import {
   errorMessage
 } from "./chunk-G3T47CFV.js";
 
-// src/shared/prompt.ts
-import { createInterface } from "node:readline";
-function readlineConfirm(input, output) {
-  return (question) => new Promise((resolvePromise) => {
-    const rl = createInterface({ input, output });
-    let settled = false;
-    const finish2 = (answer, endLine) => {
-      if (settled) return;
-      settled = true;
-      if (endLine) output.write("\n");
-      rl.close();
-      resolvePromise(answer);
-    };
-    rl.on("close", () => {
-      finish2(false, true);
-    });
-    rl.on("SIGINT", () => {
-      finish2(false, true);
-    });
-    rl.question(`${question}[y/N] `, (answer) => {
-      finish2(/^y(?:es)?$/i.test(answer.trim()), false);
-    });
-  });
-}
-function terminalConfirm() {
-  if (!process.stdin.isTTY || !process.stderr.isTTY) {
-    return void 0;
-  }
-  return readlineConfirm(process.stdin, process.stderr);
-}
-async function ensureEncryptionKey(opts) {
-  const { subject, cwd, file, confirm, notice, toError } = opts;
-  const resolved = resolveEncryptionKey({ env: opts.env, file, toError });
-  if (resolved.key !== void 0) return { key: resolved.key };
-  const missing = `${subject} must be encrypted, and no encryption key is available.`;
-  const refusal = `${missing} Run \`manni key set\`, or set ${ENCRYPTION_KEY_ENV}.`;
-  if (confirm === void 0) throw toError(refusal);
-  notice(missing);
-  const key = generateEncryptionKey();
-  const target = await writeEncryptionKey({ file, key, cwd, toError, dryRun: true });
-  if (isIgnoredByGit(target.path) === false) {
-    notice(committedKeyWarning(target.source));
-  }
-  if (!await confirm(`Generate a key and write it to ${target.source}? `)) {
-    throw toError(refusal);
-  }
-  const written = await writeEncryptionKey({ file, key, cwd, toError });
-  process.stderr.write(
-    written.created ? `Created ${written.source} with an encryption key.
-` : `Encryption key written to ${written.source}.
-`
-  );
-  return { key, written: { source: written.source, created: written.created } };
-}
-
 // src/meta/commands/get.ts
 import { readFile } from "node:fs/promises";
 import { resolve, extname } from "node:path";
@@ -518,10 +479,10 @@ import { existsSync } from "node:fs";
 import { mkdir, readFile as readFile2 } from "node:fs/promises";
 import { dirname, extname as extname2, isAbsolute, join, relative, resolve as resolve2, sep } from "node:path";
 import { parseDocument, parse as parseYaml, stringify } from "yaml";
-function getSchemasInfo(registered2) {
+function getSchemasInfo(registered) {
   return {
     builtins: listBuiltins(),
-    registered: [...registered2?.values() ?? []].map(({ id, file }) => ({ id, file })),
+    registered: [...registered?.values() ?? []].map(({ id, file }) => ({ id, file })),
     formats: listFormats()
   };
 }
@@ -955,115 +916,67 @@ async function runInferSchema(opts) {
   };
 }
 
-// src/meta/commands/query.ts
-import { randomBytes } from "node:crypto";
-import { existsSync as existsSync2 } from "node:fs";
-import { mkdir as mkdir2, open, readFile as readFile3, rename, rm } from "node:fs/promises";
-import { dirname as dirname2, isAbsolute as isAbsolute2, resolve as resolve3, extname as extname3, sep as sep2 } from "node:path";
-import { parseDocument as parseDocument3, isMap as isMap2, isSeq, isScalar as isScalar2 } from "yaml";
-
-// src/meta/core/location-writes.ts
-import { LineCounter, isMap, isNode, isScalar, parseDocument as parseDocument2 } from "yaml";
-var dedupe = (xs) => [...new Set(xs)];
-var pages = (n) => `${String(n)} page${n === 1 ? "" : "s"}`;
-async function offerExternalHomes(ctx, writes, hooks) {
-  const applied = /* @__PURE__ */ new Set();
-  const groups = /* @__PURE__ */ new Map();
-  for (const w of writes) {
-    if (w.home.kind !== "collection") continue;
-    const group = groups.get(w.home.collection) ?? [];
-    group.push(w);
-    groups.set(w.home.collection, group);
-  }
-  for (const [collection, group] of groups) {
-    const require2 = /* @__PURE__ */ new Map();
-    for (const w of group) {
-      const keys = require2.get(w.label) ?? [];
-      if (!keys.includes(w.key)) keys.push(w.key);
-      require2.set(w.label, keys);
-    }
-    const plan = await planRelocation(ctx, {
-      files: [...require2.keys()],
-      fields: dedupe(group.map((w) => w.key)),
-      require: require2
+// src/shared/prompt.ts
+import { createInterface } from "node:readline";
+function readlineConfirm(input, output) {
+  return (question) => new Promise((resolvePromise) => {
+    const rl = createInterface({ input, output });
+    let settled = false;
+    const finish2 = (answer, endLine) => {
+      if (settled) return;
+      settled = true;
+      if (endLine) output.write("\n");
+      rl.close();
+      resolvePromise(answer);
+    };
+    rl.on("close", () => {
+      finish2(false, true);
     });
-    const offers = relocationOffers(plan);
-    if (offers.length === 0) continue;
-    let yes = true;
-    for (const offer of offers) {
-      const { notice, question } = offerPrompt(offer, "write");
-      hooks.onNotice?.(notice);
-      if (!await hooks.confirm(question)) {
-        yes = false;
-        break;
-      }
-    }
-    if (!yes) continue;
-    const result = await applyRelocation(ctx, plan);
-    hooks.onRelocated?.(result);
-    applied.add(collection);
-  }
-  return applied;
+    rl.on("SIGINT", () => {
+      finish2(false, true);
+    });
+    rl.question(`${question}[y/N] `, (answer) => {
+      finish2(/^y(?:es)?$/i.test(answer.trim()), false);
+    });
+  });
 }
-function externalWriteWarnings(writes, dryRun) {
-  const verb = dryRun ? "would write" : "wrote";
-  const groups = /* @__PURE__ */ new Map();
-  const groupOf = (w) => w.home.kind === "collection" ? `c:${w.home.collection}` : `n:${w.home.reason}`;
-  for (const w of writes) {
-    const id = groupOf(w);
-    groups.set(id, [...groups.get(id) ?? [], w]);
-  }
-  const out = [];
-  for (const group of groups.values()) {
-    const [first] = group;
-    if (first === void 0) continue;
-    out.push(
-      externalWriteWarning({
-        verb,
-        keys: dedupe(group.map((w) => w.key)),
-        pages: new Set(group.map((w) => w.label)).size,
-        home: first.home,
-        createsHome: group.some(
-          (w) => w.home.kind === "collection" && (w.home.createsCollection || w.home.addsPath !== void 0)
-        )
-      })
-    );
+function terminalConfirm() {
+  if (!process.stdin.isTTY || !process.stderr.isTTY) {
+    return void 0;
   }
-  return out;
+  return readlineConfirm(process.stdin, process.stderr);
 }
-function externalWriteWarning(line) {
-  const { verb, keys, home } = line;
-  const one = keys.length === 1;
-  const head = `${verb} ${keys.join(", ")} to ${pages(line.pages)}`;
-  const prefer = one ? "the schema prefers external metadata" : "their schemas prefer external metadata";
-  const them = one ? "it" : "them";
-  if (home.kind === "collection") {
-    if (!line.createsHome) {
-      return `${head} in collection ${home.collection}; ${prefer}, and no manifest owns ${them}. Run manni meta relocate to move ${them}.`;
-    }
-    return home.createsCollection || home.createsManifest ? `${head}; ${prefer}. Run manni meta relocate to give ${them} a manifest.` : `${head}; ${prefer}. Run manni meta relocate to add ${them} to collection ${home.collection}.`;
-  }
-  return home.reason === "no-config" ? `${head}; ${prefer}, and --no-config leaves ${them} no manifest.` : `${head} that ${line.pages === 1 ? "is" : "are"} in none of the ${String(home.collections)} collections; ${prefer}, and only a collection has a manifest.`;
-}
-function manifestKeyLine(text, entry, key, join3) {
-  const norm = (e) => join3 === PATH_JOIN ? e.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+/g, "/") : e;
-  const lc = new LineCounter();
-  const doc = parseDocument2(text, { lineCounter: lc, uniqueKeys: false });
-  const root = doc.contents;
-  if (!isMap(root)) return void 0;
-  for (const pair of root.items) {
-    const spelled = isScalar(pair.key) ? String(pair.key.value) : String(pair.key);
-    if (norm(spelled) !== norm(entry) || !isMap(pair.value)) continue;
-    for (const kv of pair.value.items) {
-      const name = isScalar(kv.key) ? String(kv.key.value) : String(kv.key);
-      const range = isNode(kv.key) ? kv.key.range : void 0;
-      if (name === key && range) return lc.linePos(range[0]).line;
-    }
+async function ensureEncryptionKey(opts) {
+  const { subject, cwd, file, confirm, notice, toError } = opts;
+  const resolved = resolveEncryptionKey({ env: opts.env, file, toError });
+  if (resolved.key !== void 0) return { key: resolved.key };
+  const missing = `${subject} must be encrypted, and no encryption key is available.`;
+  const refusal = `${missing} Run \`manni key set\`, or set ${ENCRYPTION_KEY_ENV}.`;
+  if (confirm === void 0) throw toError(refusal);
+  notice(missing);
+  const key = generateEncryptionKey();
+  const target = await writeEncryptionKey({ file, key, cwd, toError, dryRun: true });
+  if (isIgnoredByGit(target.path) === false) {
+    notice(committedKeyWarning(target.source));
   }
-  return void 0;
+  if (!await confirm(`Generate a key and write it to ${target.source}? `)) {
+    throw toError(refusal);
+  }
+  const written = await writeEncryptionKey({ file, key, cwd, toError });
+  process.stderr.write(
+    written.created ? `Created ${written.source} with an encryption key.
+` : `Encryption key written to ${written.source}.
+`
+  );
+  return { key, written: { source: written.source, created: written.created } };
 }
 
 // src/meta/commands/query.ts
+import { randomBytes } from "node:crypto";
+import { existsSync as existsSync2 } from "node:fs";
+import { mkdir as mkdir2, open, readFile as readFile3, rename, rm } from "node:fs/promises";
+import { dirname as dirname2, isAbsolute as isAbsolute2, resolve as resolve3, extname as extname3, sep as sep2 } from "node:path";
+import { parseDocument as parseDocument2, isMap, isSeq, isScalar } from "yaml";
 async function runQuery(opts) {
   const cwd = opts.cwd ?? process.cwd();
   const sql = opts.sql.trim();
@@ -1894,8 +1807,8 @@ async function loadSetMembers(refs, ctx) {
   const seenFiles = /* @__PURE__ */ new Set();
   const seenBuiltins = /* @__PURE__ */ new Set();
   for (const ref of refs) {
-    const registered2 = ctx.config?.registered?.get(ref);
-    const { kind } = registered2 !== void 0 ? { kind: "file" } : classifyRef(ref);
+    const registered = ctx.config?.registered?.get(ref);
+    const { kind } = registered !== void 0 ? { kind: "file" } : classifyRef(ref);
     if (kind === "url" && !isPublishedBuiltinUrl(ref)) {
       throw new DocmetaError(
         `"${ref}" in the resolved schema set is a URL \u2014 DDL edits local schemas only. Vendor it first (manni meta schemas vendor), then evolve the local copy.`
@@ -1913,7 +1826,7 @@ async function loadSetMembers(refs, ctx) {
       });
       continue;
     }
-    const abs = registered2?.path ?? resolve3(ctx.cwd, ref);
+    const abs = registered?.path ?? resolve3(ctx.cwd, ref);
     const canon = foldPath(abs);
     if (seenFiles.has(canon)) continue;
     seenFiles.add(canon);
@@ -2277,11 +2190,11 @@ async function planConfigEdit(ctx, edit, runRefs) {
     return { changes: [], repointed: false };
   }
   const text = await readFile3(configPath, "utf8");
-  const doc = parseDocument3(stripBom(text));
+  const doc = parseDocument2(stripBom(text));
   const display = displayPath(ctx, configPath);
   const rawRefOf = (item) => {
-    if (isScalar2(item) && typeof item.value === "string") return item.value;
-    if (isMap2(item)) {
+    if (isScalar(item) && typeof item.value === "string") return item.value;
+    if (isMap(item)) {
       const ref = item.get("ref");
       if (typeof ref === "string") return ref;
     }
@@ -2303,10 +2216,10 @@ async function planConfigEdit(ctx, edit, runRefs) {
     for (const item of node.items) {
       const raw = rawRefOf(item);
       if (raw === void 0 || !wants(raw)) continue;
-      if (isScalar2(item)) {
+      if (isScalar(item)) {
         item.value = spec.newRef;
         n += 1;
-      } else if (isMap2(item)) {
+      } else if (isMap(item)) {
         item.set("ref", spec.newRef);
         n += 1;
       }
@@ -2314,13 +2227,13 @@ async function planConfigEdit(ctx, edit, runRefs) {
     return n;
   };
   const root = ctx.configSection === void 0 ? doc : doc.get(ctx.configSection, true);
-  const keyOf2 = (key) => root === doc ? doc.get(key, true) : isMap2(root) ? root.get(key, true) : void 0;
+  const keyOf2 = (key) => root === doc ? doc.get(key, true) : isMap(root) ? root.get(key, true) : void 0;
   const topSeq = keyOf2("schemas");
   let repointCount = repoint(topSeq);
   const overrides = keyOf2("overrides");
   if (isSeq(overrides)) {
     for (const entry of overrides.items) {
-      if (isMap2(entry)) repointCount += repoint(entry.get("schemas", true));
+      if (isMap(entry)) repointCount += repoint(entry.get("schemas", true));
     }
   }
   const repointed = repointCount > 0;
@@ -2329,7 +2242,7 @@ async function planConfigEdit(ctx, edit, runRefs) {
   if (edit.integrity && isSeq(topSeq)) {
     const wantPath = foldPath(edit.integrity.path);
     for (const item of topSeq.items) {
-      if (!isMap2(item)) continue;
+      if (!isMap(item)) continue;
       const raw = rawRefOf(item);
       if (raw === void 0 || classifyRef(raw).kind !== "file") continue;
       const abs = isAbsolute2(raw) ? raw : resolve3(configDir, raw);
@@ -3874,22 +3787,67 @@ function fieldHints(candidates, offer) {
   add(PAGE_FIELDS, "page", offer.pages);
   return hints;
 }
+function termMarksIn(candidate, defs) {
+  const out = [];
+  const marked = /* @__PURE__ */ new Set();
+  const stack = /* @__PURE__ */ new Set();
+  const walk = (node, path) => {
+    if (typeof node !== "object" || node === null || Array.isArray(node) || stack.has(node)) return;
+    stack.add(node);
+    const schema = node;
+    const mark = schema[TERM_KEYWORD];
+    if (isTermMark(mark)) {
+      const key = JSON.stringify([path, mark.under ?? null]);
+      if (!marked.has(key)) {
+        marked.add(key);
+        out.push({ path, ...mark.under === void 0 ? {} : { under: mark.under } });
+      }
+    }
+    if (typeof schema.$ref === "string") walk(resolvePointer(schema.$ref, defs), path);
+    for (const keyword of ["allOf", "anyOf", "oneOf"]) {
+      const branches = schema[keyword];
+      if (Array.isArray(branches)) for (const branch of branches) walk(branch, path);
+    }
+    walk(schema.items, path);
+    const properties = schema.properties;
+    if (typeof properties === "object" && properties !== null) {
+      for (const [key, sub] of Object.entries(properties)) walk(sub, [...path, key]);
+    }
+    stack.delete(node);
+  };
+  walk(candidate.subschema, [candidate.key]);
+  return out;
+}
+function termMarkHints(marks, index, schemas) {
+  return marks.flatMap(({ path, under }) => {
+    const branch = under === void 0 ? void 0 : index.scheme.below(under);
+    if (under !== void 0 && branch === void 0) {
+      throw new DocmetaError(`${schemas}: ${TERM_KEYWORD} under "${under}" names no term.`);
+    }
+    const labels = branch === void 0 ? index.labels : index.scheme.labels(branch);
+    const values = offered(labels);
+    if (values === void 0) return [];
+    const accepts = [...labels, ...branch === void 0 ? index.ids : branch];
+    return [{ path, kind: "term", values, accepts, ...under === void 0 ? {} : { under } }];
+  });
+}
 function termValueCheck(hints, index) {
   const fold = (value) => value.toLowerCase();
   const labels = new Set(index.labels.map(fold));
   const either = /* @__PURE__ */ new Set([...labels, ...index.ids.map(fold)]);
   const terms = hints.filter((hint) => hint.kind === "term");
   return (key, value) => terms.filter((hint) => hint.path[0] === key).flatMap((hint) => {
-    const accepted = CONCEPT_FIELDS.some((path) => samePath(path, hint.path)) ? labels : either;
+    const accepted = hint.accepts !== void 0 ? new Set(hint.accepts.map(fold)) : CONCEPT_FIELDS.some((path) => samePath(path, hint.path)) ? labels : either;
+    const refusal = hint.under === void 0 ? NOT_A_TERM : `${NOT_A_TERM} under "${hint.under}"`;
     const pointer = fieldPointer(hint.path);
     const held = valueAt2(value, hint.path.slice(1));
     if (typeof held === "string") {
-      return accepted.has(fold(held)) ? [] : [`${pointer}: ${NOT_A_TERM}`];
+      return accepted.has(fold(held)) ? [] : [`${pointer}: ${refusal}`];
     }
     if (!Array.isArray(held)) return [];
     const items = held;
     return items.flatMap(
-      (item, i) => typeof item === "string" && !accepted.has(fold(item)) ? [`${pointer}/${String(i)}: ${NOT_A_TERM}`] : []
+      (item, i) => typeof item === "string" && !accepted.has(fold(item)) ? [`${pointer}/${String(i)}: ${refusal}`] : []
     );
   });
 }
@@ -3940,15 +3898,6 @@ async function readIds(collection, opts) {
   return ids;
 }
 
-// src/shared/term-labels.ts
-var registered;
-function registerTermLabelSource(source) {
-  registered = source;
-}
-function termLabelSource() {
-  return registered;
-}
-
 // src/meta/core/manifest-writes.ts
 import { readFile as readFile5 } from "node:fs/promises";
 var manifestCodec = {
@@ -4140,51 +4089,6 @@ function buildUserPrompt(params, before = []) {
   ].join("\n");
 }
 
-// src/meta/core/meta-provenance.ts
-function isPlainRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function mergeMetaProvenance(held, model, key, proposed) {
-  if (held !== void 0 && !Array.isArray(held)) return void 0;
-  const list = held === void 0 ? [] : [...held];
-  const at = list.findIndex((e) => isPlainRecord(e) && e["generated-by"] === model);
-  const prior = list[at];
-  const kept = isPlainRecord(prior) ? prior : {};
-  const priorNames = kept[key];
-  const names = Array.isArray(priorNames) ? priorNames.filter((p) => typeof p === "string") : [];
-  const confidence = {};
-  if (isPlainRecord(kept.confidence)) {
-    for (const [k, v] of Object.entries(kept.confidence)) {
-      if (typeof v === "number") confidence[k] = v;
-    }
-  }
-  for (const p of proposed) {
-    if (!names.includes(p.name)) names.push(p.name);
-    confidence[p.name] = p.confidence;
-  }
-  const entry = {
-    ...kept,
-    "generated-by": model,
-    [key]: names,
-    confidence
-  };
-  if (at === -1) list.push(entry);
-  else list[at] = entry;
-  return { list, entry, names };
-}
-function metaProvenanceEntries(value) {
-  if (!Array.isArray(value)) return [];
-  const strings = (list) => Array.isArray(list) ? list.filter((s) => typeof s === "string") : [];
-  const out = [];
-  for (const item of value) {
-    if (!isPlainRecord(item)) continue;
-    const machine = item["generated-by"];
-    if (typeof machine !== "string" || machine === "") continue;
-    out.push({ "generated-by": machine, fields: strings(item.fields), evals: strings(item.evals) });
-  }
-  return out;
-}
-
 // src/meta/commands/fill.ts
 var META_PROVENANCE_KEY = "meta-provenance";
 var PROVENANCE_KEYS = /* @__PURE__ */ new Set(["provenance", META_PROVENANCE_KEY]);
@@ -4270,7 +4174,8 @@ async function runFill(opts) {
   const dryRun = Boolean(opts.dryRun);
   const only = opts.fields != null ? new Set(opts.fields) : void 0;
   const managed = new Set(managedFields(config?.derive));
-  const flags = { provider: opts.provider, model: opts.model, local: opts.local };
+  const offline = opts.offline ?? config?.offline ?? false;
+  const flags = { provider: opts.provider, model: opts.model, local: opts.local, offline };
   assertLocalFlag(flags, toDocmetaError);
   const family = configFile?.providers ?? {};
   const selection = selectProvider(flags, [
@@ -4280,7 +4185,7 @@ async function runFill(opts) {
   const { provider: providerName, model } = selection;
   assertKnownProvider2(providerName);
   assertModelHasProvider2(providerName, model);
-  const replaced = localNotice(selection);
+  const replaced = localNotice(selection, flags);
   if (replaced !== void 0) opts.onNotice?.(replaced);
   const spec = providerSpecFor(family, { provider: providerName, model: model ?? null });
   const fileInputs = inputs.filter((i) => i !== STDIN_TOKEN);
@@ -4313,12 +4218,16 @@ async function runFill(opts) {
   });
   let identity;
   let construct;
+  const offlineResolved = offline ? await offlineIdentity(spec, toDocmetaError) : void 0;
+  if (offline && offlineResolved === void 0) {
+    throw new DocmetaError(noOfflineModel("fill cannot propose values"));
+  }
   if (opts.inferenceProvider) {
     const injected = opts.inferenceProvider;
     identity = { provider: injected.provider(), model: injected.modelName() };
     construct = () => injected;
   } else {
-    const resolved = await resolveIdentity2(spec);
+    const resolved = offlineResolved ?? await resolveIdentity2(spec);
     identity = resolved;
     const concrete = providerSpecFor(family, resolved);
     construct = () => makeProvider(concrete);
@@ -4370,7 +4279,10 @@ async function runFill(opts) {
   let externalMetadata = await loadManifests();
   let termbase;
   const readTermbase = async () => {
-    if (opts.termLabels !== void 0) return { labels: [...opts.termLabels], ids: [] };
+    if (opts.termLabels !== void 0) {
+      const labels = [...opts.termLabels];
+      return { labels, ids: [], scheme: termScheme(labels.map((label) => ({ label, id: label }))) };
+    }
     const source = termLabelSource();
     if (source === void 0) return void 0;
     try {
@@ -4379,7 +4291,8 @@ async function runFill(opts) {
         ...opts.configPath === void 0 ? {} : { configPath: opts.configPath },
         ...opts.noConfig === true ? { noConfig: true } : {}
       });
-      return { labels: terms.map((t) => t.label), ids: terms.map((t) => t.id) };
+      if (terms.length === 0) return void 0;
+      return { labels: terms.map((t) => t.label), ids: terms.map((t) => t.id), scheme: termScheme(terms) };
     } catch (err) {
       opts.onNotice?.(
         `The termbase could not be read, so fill offers no glossary labels: ${errorMessage(err)}`
@@ -4393,15 +4306,20 @@ async function runFill(opts) {
     configDir: configDir ?? cwd,
     ...respectGitignore === void 0 ? {} : { respectGitignore }
   });
-  const hintsFor = async (label, candidates) => {
+  const hintsFor = async (label, candidates, schemas, schemaSet) => {
     const keys = new Set(candidates.map((c) => c.key));
     const wants = (fields) => fields.some(([key]) => key !== void 0 && keys.has(key));
-    const termIndex = wants(TERM_FIELDS) ? await (termbase ??= readTermbase()) : void 0;
-    const pages2 = wants(PAGE_FIELDS) ? await pageIds(resolve5(base, label), mergeMembersFor(label)) : [];
-    const hints = fieldHints(candidates, {
-      terms: termIndex === void 0 ? void 0 : offered(termIndex.labels),
-      pages: offered(pages2)
-    });
+    const defs = collectDefs(schemas);
+    const marks2 = candidates.flatMap((c) => termMarksIn(c, defs));
+    const termIndex = wants(TERM_FIELDS) || marks2.length > 0 ? await (termbase ??= readTermbase()) : void 0;
+    const pages = wants(PAGE_FIELDS) ? await pageIds(resolve5(base, label), mergeMembersFor(label)) : [];
+    const hints = [
+      ...fieldHints(candidates, {
+        terms: termIndex === void 0 ? void 0 : offered(termIndex.labels),
+        pages: offered(pages)
+      }),
+      ...termIndex === void 0 ? [] : termMarkHints(marks2, termIndex, schemaSet.join(", "))
+    ];
     return { hints, termIndex };
   };
   const noticed = /* @__PURE__ */ new Set();
@@ -4696,7 +4614,7 @@ async function runFill(opts) {
     } = ready;
     const firstSealed = inPlace[0]?.pointer ?? (sealedCandidates[0] === void 0 ? void 0 : pointerOf(sealedCandidates[0].key));
     if (firstSealed !== void 0 && !dryRun) await writeKey(firstSealed);
-    const { hints, termIndex } = candidates.length > 0 ? await hintsFor(label, candidates) : { hints: [], termIndex: void 0 };
+    const { hints, termIndex } = candidates.length > 0 ? await hintsFor(label, candidates, schemas, schemaSet) : { hints: [], termIndex: void 0 };
     const cacheKey = buildCacheKey([
       identity.provider,
       identity.model,
@@ -5694,7 +5612,7 @@ async function runDerive(opts) {
       runFields = union2;
     }
     const provenanceRoot = configDir ?? cwd;
-    const pages2 = files.map((label) => resolve6(base, label));
+    const pages = files.map((label) => resolve6(base, label));
     const manifests = runFields.includes(PROVENANCE_FIELD) ? provenanceManifests(declaredCollections, provenanceRoot, base) : [];
     const provenanceCollections = declaredCollections.map((c) => ({
       ...c,
@@ -5702,7 +5620,7 @@ async function runDerive(opts) {
         (m) => m.keys === void 0 ? classifyRef(m.file).kind !== "url" : m.keys.includes(PROVENANCE_FIELD)
       )
     })).filter((c) => c.externalMetadata.length > 0);
-    const provenanceIndex = manifests.length === 0 ? null : await loadExternalMetadata(provenanceCollections, { configDir: provenanceRoot, base, pages: pages2 });
+    const provenanceIndex = manifests.length === 0 ? null : await loadExternalMetadata(provenanceCollections, { configDir: provenanceRoot, base, pages });
     const places2 = /* @__PURE__ */ new Map();
     for (const doc of loaded2.values()) {
       const dated = fieldsOf(doc.label).filter((f) => f === "created" || f === "last-updated");
@@ -5744,7 +5662,7 @@ async function runDerive(opts) {
         (m.keys === void 0 || m.keys.some((k) => k !== PROVENANCE_FIELD && runFields.includes(k)))
       )
     })).filter((c) => c.externalMetadata.length > 0);
-    const ownedIndex = ownedCollections.length === 0 ? null : await loadExternalMetadata(ownedCollections, { configDir: provenanceRoot, base, pages: pages2 });
+    const ownedIndex = ownedCollections.length === 0 ? null : await loadExternalMetadata(ownedCollections, { configDir: provenanceRoot, base, pages });
     const derived2 = await deriveMetadata([...loaded2.values()], {
       cwd,
       base,
@@ -6282,6 +6200,94 @@ function shiftEntries(entries, shift) {
   });
 }
 
+// src/meta/commands/relocate.ts
+async function runRelocate(opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  if (opts.inputs.includes(STDIN_TOKEN)) {
+    throw new DocmetaError(
+      "relocate moves values between documents and a collection's manifest, and stdin is not a document on disk."
+    );
+  }
+  if (opts.noConfig === true) {
+    throw new DocmetaError(
+      "relocate writes collections: and externalMetadata: to the config file, and --no-config rules one out."
+    );
+  }
+  const run = await resolveRunConfig({
+    cwd,
+    ...opts.configPath !== void 0 ? { configPath: opts.configPath } : {},
+    inputs: opts.inputs,
+    ...opts.collections !== void 0 ? { collections: opts.collections } : {},
+    ...opts.onConfigLoaded !== void 0 ? { onConfigLoaded: opts.onConfigLoaded } : {}
+  });
+  const { config, inputs, base, configDir, collections, fromCollections } = run;
+  if (inputs.length === 0) {
+    throw new DocmetaError(
+      "No files to relocate. Pass paths/globs, or declare a collection under `collections:` in manni.config.yaml."
+    );
+  }
+  const forced = opts.as !== void 0 ? extractorByName(opts.as) : void 0;
+  if (opts.as !== void 0 && forced === void 0) {
+    throw new DocmetaError(
+      `Unknown format "${opts.as}". Known formats: ${listFormats().map((f) => f.name).join(", ")}.`
+    );
+  }
+  const allowEmpty = opts.allowEmpty ?? config?.allowEmpty;
+  const exts = opts.exts ?? forced?.extensions;
+  const exclude = opts.exclude ?? [];
+  const membersFor = (label) => memberOf(collections, configDir ?? cwd, base, label);
+  const { files: walked, gitignoreSkipped } = await resolveTargetSet({
+    inputs,
+    ...exts !== void 0 ? { exts } : {},
+    exclude,
+    cwd: base,
+    ...allowEmpty !== void 0 ? { allowEmpty } : {},
+    ...gitignoreOptions({
+      ...opts.respectGitignore !== void 0 ? { flag: opts.respectGitignore } : {},
+      ...config?.respectGitignore !== void 0 ? { configured: config.respectGitignore } : {},
+      ...opts.onNotice !== void 0 ? { onNotice: opts.onNotice } : {}
+    })
+  });
+  const files = fromCollections ? retainMembers(walked, membersFor) : walked;
+  assertNonEmpty({
+    files,
+    inputs,
+    usingStdin: false,
+    ...allowEmpty !== void 0 ? { allowEmpty } : {},
+    exclude,
+    ...exts !== void 0 ? { exts } : {},
+    gitignoreSkipped,
+    action: "relocated"
+  });
+  const validator = new Validator(
+    schemaLoadOptions({
+      root: configDir ?? cwd,
+      fileBase: cwd,
+      ttlHours: config?.schemaCache?.ttlHours,
+      offline: config?.offline,
+      pins: collectSchemaPins(config),
+      registered: config?.registered
+    })
+  );
+  const ctx = relocationContext(run, {
+    cwd,
+    // A config-fallback run named no targets: its pages are already members.
+    targets: fromCollections ? [] : opts.inputs,
+    validator,
+    ...opts.cliSchemas !== void 0 && opts.cliSchemas.length > 0 ? { cliSchemas: opts.cliSchemas } : {},
+    ...opts.as !== void 0 ? { as: opts.as } : {},
+    ...opts.respectGitignore !== void 0 ? { respectGitignore: opts.respectGitignore } : {},
+    ...opts.env !== void 0 ? { env: opts.env } : {},
+    ...opts.onNotice !== void 0 ? { onNotice: opts.onNotice } : {}
+  });
+  const plan = await planRelocation(ctx, {
+    files,
+    ...opts.fields !== void 0 ? { fields: opts.fields } : {}
+  });
+  if (opts.dryRun === true) return plan.result;
+  return applyRelocation(ctx, plan);
+}
+
 // src/meta/reporters/fill.ts
 var FILL_FORMATS = ["pretty", "json", "github"];
 var FILL_FORMAT_LIST = formatList(FILL_FORMATS);
@@ -6594,94 +6600,6 @@ function fmt(value) {
   return toJsonText(value) ?? String(value);
 }
 
-// src/meta/commands/relocate.ts
-async function runRelocate(opts) {
-  const cwd = opts.cwd ?? process.cwd();
-  if (opts.inputs.includes(STDIN_TOKEN)) {
-    throw new DocmetaError(
-      "relocate moves values between documents and a collection's manifest, and stdin is not a document on disk."
-    );
-  }
-  if (opts.noConfig === true) {
-    throw new DocmetaError(
-      "relocate writes collections: and externalMetadata: to the config file, and --no-config rules one out."
-    );
-  }
-  const run = await resolveRunConfig({
-    cwd,
-    ...opts.configPath !== void 0 ? { configPath: opts.configPath } : {},
-    inputs: opts.inputs,
-    ...opts.collections !== void 0 ? { collections: opts.collections } : {},
-    ...opts.onConfigLoaded !== void 0 ? { onConfigLoaded: opts.onConfigLoaded } : {}
-  });
-  const { config, inputs, base, configDir, collections, fromCollections } = run;
-  if (inputs.length === 0) {
-    throw new DocmetaError(
-      "No files to relocate. Pass paths/globs, or declare a collection under `collections:` in manni.config.yaml."
-    );
-  }
-  const forced = opts.as !== void 0 ? extractorByName(opts.as) : void 0;
-  if (opts.as !== void 0 && forced === void 0) {
-    throw new DocmetaError(
-      `Unknown format "${opts.as}". Known formats: ${listFormats().map((f) => f.name).join(", ")}.`
-    );
-  }
-  const allowEmpty = opts.allowEmpty ?? config?.allowEmpty;
-  const exts = opts.exts ?? forced?.extensions;
-  const exclude = opts.exclude ?? [];
-  const membersFor = (label) => memberOf(collections, configDir ?? cwd, base, label);
-  const { files: walked, gitignoreSkipped } = await resolveTargetSet({
-    inputs,
-    ...exts !== void 0 ? { exts } : {},
-    exclude,
-    cwd: base,
-    ...allowEmpty !== void 0 ? { allowEmpty } : {},
-    ...gitignoreOptions({
-      ...opts.respectGitignore !== void 0 ? { flag: opts.respectGitignore } : {},
-      ...config?.respectGitignore !== void 0 ? { configured: config.respectGitignore } : {},
-      ...opts.onNotice !== void 0 ? { onNotice: opts.onNotice } : {}
-    })
-  });
-  const files = fromCollections ? retainMembers(walked, membersFor) : walked;
-  assertNonEmpty({
-    files,
-    inputs,
-    usingStdin: false,
-    ...allowEmpty !== void 0 ? { allowEmpty } : {},
-    exclude,
-    ...exts !== void 0 ? { exts } : {},
-    gitignoreSkipped,
-    action: "relocated"
-  });
-  const validator = new Validator(
-    schemaLoadOptions({
-      root: configDir ?? cwd,
-      fileBase: cwd,
-      ttlHours: config?.schemaCache?.ttlHours,
-      offline: config?.offline,
-      pins: collectSchemaPins(config),
-      registered: config?.registered
-    })
-  );
-  const ctx = relocationContext(run, {
-    cwd,
-    // A config-fallback run named no targets: its pages are already members.
-    targets: fromCollections ? [] : opts.inputs,
-    validator,
-    ...opts.cliSchemas !== void 0 && opts.cliSchemas.length > 0 ? { cliSchemas: opts.cliSchemas } : {},
-    ...opts.as !== void 0 ? { as: opts.as } : {},
-    ...opts.respectGitignore !== void 0 ? { respectGitignore: opts.respectGitignore } : {},
-    ...opts.env !== void 0 ? { env: opts.env } : {},
-    ...opts.onNotice !== void 0 ? { onNotice: opts.onNotice } : {}
-  });
-  const plan = await planRelocation(ctx, {
-    files,
-    ...opts.fields !== void 0 ? { fields: opts.fields } : {}
-  });
-  if (opts.dryRun === true) return plan.result;
-  return applyRelocation(ctx, plan);
-}
-
 // src/meta/reporters/get.ts
 function stringifyValue(value) {
   if (value === void 0) return "(unset)";
@@ -6846,27 +6764,25 @@ function cellFrom(value) {
 }
 
 export {
-  terminalConfirm,
-  ensureEncryptionKey,
+  CONCEPT_FIELDS,
+  TERM_RELATION_FIELDS,
+  fieldPointer,
+  valueAt2 as valueAt,
   runGet,
   getSchemasInfo,
   DEFAULT_VENDOR_DIR,
   vendorFileName,
   runVendorSchema,
   runInferSchema,
-  offerExternalHomes,
-  externalWriteWarnings,
+  terminalConfirm,
+  ensureEncryptionKey,
   runQuery,
-  CONCEPT_FIELDS,
-  TERM_RELATION_FIELDS,
-  fieldPointer,
-  valueAt2 as valueAt,
-  registerTermLabelSource,
-  mergeMetaProvenance,
-  metaProvenanceEntries,
+  DEFAULT_CHUNK_CHARS,
+  splitBody,
   runFill,
   runDerive,
   deriveFailed,
+  runRelocate,
   FILL_FORMATS,
   FILL_FORMAT_LIST,
   isFillFormat,
@@ -6876,10 +6792,9 @@ export {
   DERIVE_FORMAT_LIST,
   isDeriveFormat,
   renderDerive,
-  runRelocate,
   stringifyValue,
   renderGet,
   renderQuery,
   renderQueryCsv
 };
-//# sourceMappingURL=chunk-2W34HX2U.js.map
+//# sourceMappingURL=chunk-PS257NIU.js.map