@hawkeyexl/manni 4.11.0 → 4.12.1

package/dist/{chunk-2DRHT73U.js → chunk-CVZMKWZ5.js}

@@ -1,41 +1,34 @@
 #!/usr/bin/env node
 import {
-  LOCALIZATIONS_FILENAME,
-  STDIN,
-  UNDETERMINED,
-  analyzeDoc,
-  assertInputFormat,
-  canonicalLanguageTag,
+  canonicalLanguage,
   deriveGraph,
-  documentBase,
-  documentSetPatterns,
-  emitLocalizations,
-  extractorFor,
-  formatOf,
-  isLanguageTag,
-  isSafeRelativePath,
-  mergePage,
-  metadataOf,
-  mintTreeSections,
-  openMetaView,
-  parseLocalizations,
-  parseTree,
-  resolveDocumentSet,
-  routesFrom,
-  searchIndexFilename,
-  vectorIndexFilename
-} from "./chunk-2IAZEB45.js";
+  termIndex
+} from "./chunk-WGMFDG6U.js";
 import {
+  EmbedderUnavailableError,
+  GraphIndex,
+  bodyOf,
+  buildSearchIndex,
   bundledShapesPath,
   compactIri,
+  createLocalEmbedder,
+  createMockEmbedder,
+  createTrace,
+  documentsByLanguage,
+  emitSearchIndex,
+  encodeVectorIndex,
   expandTerm,
+  exportSampleQuestions,
+  freshness,
   loadGraph,
+  matchList,
+  partitionByLanguage,
   storeToQuads,
   validateGraph
-} from "./chunk-EFW7CAG4.js";
+} from "./chunk-KCB5JCK4.js";
 import {
+  COPIED_SHARE,
   COVERAGE_FIELDS,
-  DEFAULT_MODEL,
   GRAPH_NOT_APPLICABLE_TO_VARIANT,
   GRAPH_NOT_SOFTWARE_SUBJECT,
   GraphError,
@@ -59,32 +52,65 @@ import {
   IIRDS_SOURCE,
   IIRDS_TITLE,
   IIRDS_TOPIC,
+  LOCALIZATIONS_FILENAME,
   NS,
   PREFIXES,
   RDF_TYPE,
   SECTION_COVERAGE_FIELDS,
   SOFTWARE_SUBJECT_IRIS,
+  STDIN,
   STDIN_PATH,
+  UNIFORM_COVERAGE_FIELD_NAMES,
   VCARD_NS,
   VCARD_ORGANIZATION,
   VCARD_ORGANIZATION_NAME,
+  analyzeDoc,
+  assertInputFormat,
   byCodeUnit,
+  canonicalLanguageTag,
+  copiedPairs,
+  documentBase,
+  documentSetPatterns,
+  emitLocalizations,
+  extractorFor,
+  formatOf,
+  isLanguageTag,
+  isSafeRelativePath,
   loadRunConfig,
-  profileFor,
-  withPrefix
-} from "./chunk-JROBZ7JA.js";
+  mergePage,
+  metadataOf,
+  openMetaView,
+  parseLocalizations,
+  questionKey,
+  readQuestionFile,
+  resolveDocumentSet,
+  routesFrom,
+  searchIndexFilename,
+  vectorIndexFilename
+} from "./chunk-Q2QC5AZB.js";
+import {
+  splitBody
+} from "./chunk-VQYGLU4C.js";
 import {
   mergeMetaProvenance
-} from "./chunk-M42DZCOU.js";
+} from "./chunk-7FCLXEAQ.js";
 import {
+  findWindows,
   isMissing,
+  lineSpec,
+  parseLines,
+  pinOfLines,
+  spellLines,
   spliceManifestValue
-} from "./chunk-GV56WGL2.js";
+} from "./chunk-WO4JYWZK.js";
+import {
+  termLabelSource
+} from "./chunk-DSWKBZWW.js";
 import {
   DocmetaError,
   urlManifestMessage,
   writeFileAtomic
-} from "./chunk-VSEBFHAY.js";
+} from "./chunk-KFKL4VTL.js";
 import {
   noticeOnce,
   warn
@@ -94,18 +120,20 @@ import {
   assertLocalFlag,
   assertModelHasProvider,
   localNotice,
+  noOfflineModel,
+  offlineIdentity,
   providerSpecFor,
   resolveIdentity,
   selectProvider
-} from "./chunk-QCHVR4ZM.js";
+} from "./chunk-VM7VAFJW.js";
 import {
   errorMessage
 } from "./chunk-G3T47CFV.js";
 
 // src/graph/commands/export.ts
 import { createHash } from "node:crypto";
-import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
-import { dirname, join, resolve as resolve3 } from "node:path";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve as resolve2 } from "node:path";
 
 // src/graph/core/emit-jsonld.ts
 var XSD_STRING = `${NS.xsd}string`;
@@ -115,7 +143,17 @@ function renderValue(term) {
       value: { "@id": term.value },
       kind: 0,
       primary: term.value,
-      datatype: ""
+      datatype: "",
+      language: ""
+    };
+  }
+  if (term.language) {
+    return {
+      value: { "@value": term.value, "@language": term.language },
+      kind: 1,
+      primary: term.value,
+      datatype: "",
+      language: term.language
     };
   }
   if (term.datatype && term.datatype !== XSD_STRING) {
@@ -123,16 +161,17 @@ function renderValue(term) {
       value: { "@value": term.value, "@type": compactIri(term.datatype) },
       kind: 1,
       primary: term.value,
-      datatype: term.datatype
+      datatype: term.datatype,
+      language: ""
     };
   }
-  return { value: term.value, kind: 1, primary: term.value, datatype: "" };
+  return { value: term.value, kind: 1, primary: term.value, datatype: "", language: "" };
 }
 function compareRendered(a, b) {
   if (a.kind !== b.kind) return a.kind - b.kind;
   const p = byCodeUnit(a.primary, b.primary);
   if (p !== 0) return p;
-  return byCodeUnit(a.datatype, b.datatype);
+  return byCodeUnit(a.datatype, b.datatype) || byCodeUnit(a.language, b.language);
 }
 function collapse(values) {
   const rendered = [...values].sort(compareRendered).map((v) => v.value);
@@ -200,7 +239,9 @@ function compareTerms(a, b) {
   if (v !== 0) return v;
   const da = a.kind === "literal" ? a.datatype ?? "" : "";
   const db = b.kind === "literal" ? b.datatype ?? "" : "";
-  return byCodeUnit(da, db);
+  const la = a.kind === "literal" ? a.language ?? "" : "";
+  const lb = b.kind === "literal" ? b.language ?? "" : "";
+  return byCodeUnit(da, db) || byCodeUnit(la, lb);
 }
 function emitRdfXml(quads, prefixes) {
   const sortedPrefixes = Object.entries(prefixes).sort(
@@ -241,6 +282,10 @@ function emitRdfXml(quads, prefixes) {
           lines.push(
             `    <${qname} rdf:resource="${escapeAttr(term.value)}"/>`
           );
+        } else if (term.language) {
+          lines.push(
+            `    <${qname} xml:lang="${escapeAttr(term.language)}">${escapeText(term.value)}</${qname}>`
+          );
         } else if (term.datatype && term.datatype !== XSD_STRING2) {
           lines.push(
             `    <${qname} rdf:datatype="${escapeAttr(term.datatype)}">${escapeText(term.value)}</${qname}>`
@@ -275,17 +320,17 @@ function writeZip(entries) {
   const locals = [];
   const centrals = [];
   let offset = 0;
-  for (const entry2 of entries) {
-    if (escapesArchiveRoot(entry2.name)) {
+  for (const entry of entries) {
+    if (escapesArchiveRoot(entry.name)) {
       throw new GraphError(
-        `Refusing ZIP entry "${entry2.name}": an archive entry may not be absolute or climb above the archive root.`
+        `Refusing ZIP entry "${entry.name}": an archive entry may not be absolute or climb above the archive root.`
       );
     }
-    const name = Buffer.from(entry2.name, "utf8");
+    const name = Buffer.from(entry.name, "utf8");
     const flags = name.some((b) => b > 127) ? 2048 : 0;
-    const method = entry2.store ? 0 : 8;
-    const stored = entry2.store ? entry2.data : deflateRawSync(entry2.data);
-    const crc = crc32(entry2.data) >>> 0;
+    const method = entry.store ? 0 : 8;
+    const stored = entry.store ? entry.data : deflateRawSync(entry.data);
+    const crc = crc32(entry.data) >>> 0;
     const local = Buffer.alloc(30);
     local.writeUInt32LE(67324752, 0);
     local.writeUInt16LE(VERSION, 4);
@@ -295,7 +340,7 @@ function writeZip(entries) {
     local.writeUInt16LE(DOS_DATE, 12);
     local.writeUInt32LE(crc, 14);
     local.writeUInt32LE(stored.length, 18);
-    local.writeUInt32LE(entry2.data.length, 22);
+    local.writeUInt32LE(entry.data.length, 22);
     local.writeUInt16LE(name.length, 26);
     local.writeUInt16LE(0, 28);
     locals.push(local, name, stored);
@@ -309,7 +354,7 @@ function writeZip(entries) {
     central.writeUInt16LE(DOS_DATE, 14);
     central.writeUInt32LE(crc, 16);
     central.writeUInt32LE(stored.length, 20);
-    central.writeUInt32LE(entry2.data.length, 24);
+    central.writeUInt32LE(entry.data.length, 24);
     central.writeUInt16LE(name.length, 28);
     central.writeUInt16LE(0, 30);
     central.writeUInt16LE(0, 32);
@@ -424,7 +469,9 @@ function projectPackage(store, opts, cwd) {
         null
       )) {
         const o = q.object;
-        if (o.termType === "Literal") {
+        if (o.termType === "Literal" && o.language !== "") {
+          add(doc, pred, { kind: "literal", value: o.value, language: o.language });
+        } else if (o.termType === "Literal") {
           const dt = o.datatype.value;
           add(doc, pred, lit(o.value, dt !== XSD_STRING3 ? dt : void 0));
         } else {
@@ -449,655 +496,8 @@ function projectPackage(store, opts, cwd) {
   return { quads, prefixes, contentFiles, warnings };
 }
 
-// src/graph/core/search-index.ts
-import { existsSync as existsSync2, readFileSync } from "node:fs";
-import { resolve as resolve2 } from "node:path";
-
-// src/graph/runtime/resolve.ts
-var GRAPH_PATH = `${NS.graph}path`;
-var DCTERMS_TITLE = `${NS.dcterms}title`;
-var DCTERMS_HAS_PART = `${NS.dcterms}hasPart`;
-var GRAPH_LEVEL = `${NS.graph}level`;
-var GRAPH_ORDER = `${NS.graph}order`;
-function splitFragment(iri2) {
-  const hash = iri2.indexOf("#");
-  return hash < 0 ? { doc: iri2 } : { doc: iri2.slice(0, hash), fragment: iri2.slice(hash + 1) };
-}
-function fencedLines(lines) {
-  const mask = new Array(lines.length).fill(false);
-  let open;
-  for (const [i, line] of lines.entries()) {
-    const m = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
-    const delimiter = m?.[1];
-    const info = m?.[2];
-    const isFence = delimiter !== void 0 && info !== void 0;
-    if (open === void 0) {
-      if (isFence && !(delimiter.startsWith("`") && info.includes("`"))) {
-        open = delimiter;
-        mask[i] = true;
-      }
-      continue;
-    }
-    mask[i] = true;
-    if (isFence && delimiter[0] === open[0] && delimiter.length >= open.length && info.trim() === "") {
-      open = void 0;
-    }
-  }
-  return mask;
-}
-var ATX = /^ {0,3}(#{1,6})(?:[ \t]+(.*?))?[ \t]*$/;
-var SETEXT_UNDERLINE = /^ {0,3}(=+|-+)[ \t]*$/;
-function isParagraphLine(line) {
-  if (line.trim() === "") return false;
-  if (ATX.test(line)) return false;
-  if (/^ {0,3}([-+*]|\d{1,9}[.)])([ \t]|$)/.test(line)) return false;
-  if (/^ {0,3}>/.test(line)) return false;
-  if (/^ {0,3}([-*_])([ \t]*\1){2,}[ \t]*$/.test(line)) return false;
-  return !/^ {4}/.test(line);
-}
-function frontmatterLength(lines) {
-  if (lines[0]?.trim() !== "---") return 0;
-  for (let i = 1; i < lines.length; i++) {
-    const line = lines[i]?.trim();
-    if (line === "---" || line === "...") return i + 1;
-  }
-  return 0;
-}
-function sourceHeadings(lines) {
-  const fenced = fencedLines(lines);
-  const skip = frontmatterLength(lines);
-  const headings = [];
-  let paragraph = -1;
-  for (const [i, line] of lines.entries()) {
-    if (i < skip || fenced[i]) {
-      paragraph = -1;
-      continue;
-    }
-    const atx = ATX.exec(line);
-    const hashes = atx?.[1];
-    if (hashes !== void 0) {
-      const text = (atx?.[2] ?? "").replace(/(^|[ \t]+)#+$/, "");
-      headings.push({ start: i, level: hashes.length, text });
-      paragraph = -1;
-      continue;
-    }
-    const underline = SETEXT_UNDERLINE.exec(line)?.[1];
-    if (underline !== void 0 && paragraph >= 0) {
-      headings.push({
-        start: paragraph,
-        level: underline.startsWith("=") ? 1 : 2,
-        text: lines.slice(paragraph, i).join("\n")
-      });
-      paragraph = -1;
-      continue;
-    }
-    if (isParagraphLine(line)) {
-      if (paragraph < 0) paragraph = i;
-    } else {
-      paragraph = -1;
-    }
-  }
-  return headings;
-}
-var ENTITIES = {
-  amp: "&",
-  lt: "<",
-  gt: ">",
-  quot: '"',
-  apos: "'",
-  nbsp: "\xA0"
-};
-function decodeEntities(text) {
-  return text.replace(
-    /&(#x[0-9a-f]+|#[0-9]+|[a-z]+);/gi,
-    (whole, name) => {
-      if (name.startsWith("#")) {
-        const hex = name[1] === "x" || name[1] === "X";
-        const code = Number.parseInt(name.slice(hex ? 2 : 1), hex ? 16 : 10);
-        return Number.isNaN(code) || code > 1114111 ? whole : String.fromCodePoint(code);
-      }
-      return ENTITIES[name.toLowerCase()] ?? whole;
-    }
-  );
-}
-function headingKey(text) {
-  return text.replace(/[`*_~\\[\]]/g, "").replace(/\s+/g, " ").trim().toLowerCase();
-}
-function stripInline(raw) {
-  return decodeEntities(
-    raw.replace(/!?\[([^\]]*)\]\((?:[^()]|\([^()]*\))*\)/g, "$1").replace(/!?\[([^\]]*)\]\[[^\]]*\]/g, "$1").replace(/<((?:https?|mailto):[^>\s]+)>/gi, "$1")
-  );
-}
-function documentSectionOrder(graph, docIri) {
-  const ordered = [];
-  const seen = /* @__PURE__ */ new Set();
-  const childrenOf = (iri2) => graph.out(iri2, DCTERMS_HAS_PART).map((e) => e.target).sort((a, b) => {
-    const oa = Number.parseInt(graph.literal(a, GRAPH_ORDER) ?? "", 10);
-    const ob = Number.parseInt(graph.literal(b, GRAPH_ORDER) ?? "", 10);
-    if (Number.isNaN(oa) || Number.isNaN(ob) || oa === ob) {
-      return a < b ? -1 : a > b ? 1 : 0;
-    }
-    return oa - ob;
-  });
-  const walk = (iri2) => {
-    for (const child of childrenOf(iri2)) {
-      if (seen.has(child)) continue;
-      seen.add(child);
-      ordered.push(child);
-      walk(child);
-    }
-  };
-  walk(docIri);
-  return ordered;
-}
-function sectionOccurrences(graph, docIri) {
-  const occurrences = /* @__PURE__ */ new Map();
-  const counts = /* @__PURE__ */ new Map();
-  for (const section of documentSectionOrder(graph, docIri)) {
-    const rawTitle = graph.literal(section, DCTERMS_TITLE);
-    if (rawTitle === void 0) {
-      occurrences.set(section, 0);
-      continue;
-    }
-    const title = headingKey(rawTitle);
-    const level = graph.literal(section, GRAPH_LEVEL) ?? "";
-    let byLevel = counts.get(title);
-    if (!byLevel) {
-      byLevel = /* @__PURE__ */ new Map();
-      counts.set(title, byLevel);
-    }
-    const seen = byLevel.get(level) ?? 0;
-    occurrences.set(section, seen);
-    byLevel.set(level, seen + 1);
-  }
-  return occurrences;
-}
-function sectionOccurrence(graph, sectionIri) {
-  const { doc } = splitFragment(sectionIri);
-  return sectionOccurrences(graph, doc).get(sectionIri) ?? 0;
-}
-function documentPreamble(markdown) {
-  const lines = markdown.split(/\r?\n/);
-  const end = sourceHeadings(lines)[0]?.start ?? lines.length;
-  const text = lines.slice(0, end).join("\n").trim();
-  return text === "" ? void 0 : text;
-}
-function sliceSection(markdown, title, level, occurrence = 0) {
-  return slice(markdown, title, level, occurrence, false);
-}
-function sectionOwnText(markdown, title, level, occurrence = 0) {
-  return slice(markdown, title, level, occurrence, true);
-}
-function slice(markdown, title, level, occurrence, ownTextOnly) {
-  const lines = markdown.split(/\r?\n/);
-  const headings = sourceHeadings(lines);
-  const wanted = headingKey(title);
-  let remaining = occurrence;
-  let found = -1;
-  for (const [n, heading] of headings.entries()) {
-    if (level !== void 0 && heading.level !== level) continue;
-    if (headingKey(stripInline(heading.text)) !== wanted) continue;
-    if (remaining > 0) {
-      remaining -= 1;
-      continue;
-    }
-    found = n;
-    break;
-  }
-  const match = headings[found];
-  if (match === void 0) return void 0;
-  const next = headings.slice(found + 1).find((h) => ownTextOnly || h.level <= match.level);
-  const end = next?.start ?? lines.length;
-  return lines.slice(match.start, end).join("\n").trimEnd();
-}
-function createFetchResolver(graph, options = {}) {
-  const doFetch = options.fetch ?? ((url) => globalThis.fetch(url));
-  const toUrl = options.pathToUrl ?? ((path2) => `${options.baseUrl ?? ""}${path2}`);
-  const cache = /* @__PURE__ */ new Map();
-  const occurrenceCache = /* @__PURE__ */ new Map();
-  const occurrenceOf = (docIri, sectionIri) => {
-    let map = occurrenceCache.get(docIri);
-    if (!map) {
-      map = sectionOccurrences(graph, docIri);
-      occurrenceCache.set(docIri, map);
-    }
-    return map.get(sectionIri) ?? 0;
-  };
-  const fetchDoc = (url) => {
-    let pending = cache.get(url);
-    if (!pending) {
-      pending = doFetch(url).then((r) => r.ok ? r.text() : void 0).catch(() => void 0);
-      cache.set(url, pending);
-    }
-    return pending;
-  };
-  return {
-    async resolve(iri2) {
-      const { doc, fragment } = splitFragment(iri2);
-      const path2 = graph.literal(doc, GRAPH_PATH);
-      if (!path2) return void 0;
-      const sourceUrl = toUrl(path2);
-      const body = await fetchDoc(sourceUrl);
-      const title = graph.literal(iri2, DCTERMS_TITLE);
-      if (body === void 0) {
-        options.trace?.resolutions.push({
-          iri: iri2,
-          sourceUrl,
-          ok: false,
-          error: "fetch failed"
-        });
-        return void 0;
-      }
-      let text = body;
-      if (fragment) {
-        const levelText = graph.literal(iri2, GRAPH_LEVEL);
-        const level = levelText ? Number.parseInt(levelText, 10) : void 0;
-        const slice2 = title === void 0 ? void 0 : sliceSection(
-          body,
-          title,
-          Number.isNaN(level) ? void 0 : level,
-          occurrenceOf(doc, iri2)
-        );
-        if (slice2 === void 0) {
-          options.trace?.resolutions.push({
-            iri: iri2,
-            sourceUrl,
-            ok: false,
-            error: "section heading not found"
-          });
-          return void 0;
-        }
-        text = slice2;
-      }
-      options.trace?.resolutions.push({ iri: iri2, sourceUrl, ok: true });
-      return { iri: iri2, text, sourceUrl, title };
-    }
-  };
-}
-
-// src/graph/core/search-index.ts
-var GRAPH_DOCUMENT2 = `${NS.graph}Document`;
-var GRAPH_SECTION = `${NS.graph}Section`;
-var SKOS_CONCEPT = `${NS.skos}Concept`;
-var GRAPH_PATH2 = `${NS.graph}path`;
-var GRAPH_LEVEL2 = `${NS.graph}level`;
-var DCTERMS_TITLE2 = `${NS.dcterms}title`;
-var DCTERMS_DESCRIPTION = `${NS.dcterms}description`;
-var SKOS_PREF_LABEL = `${NS.skos}prefLabel`;
-var SKOS_ALT_LABEL = `${NS.skos}altLabel`;
-var DCTERMS_LANGUAGE = `${NS.dcterms}language`;
-function joinLabels(values) {
-  const seen = /* @__PURE__ */ new Map();
-  for (const v of values) {
-    const key = v.trim().toLowerCase();
-    if (key && !seen.has(key)) seen.set(key, v.trim());
-  }
-  const out = [...seen.values()].sort(byCodeUnit);
-  return out.length > 0 ? out.join(" ") : void 0;
-}
-var FRONTMATTER = /^---[ \t]*\r?\n(?:[\s\S]*?\r?\n)?(?:---|\.\.\.)[ \t]*(?:\r?\n|$)(?:\r?\n)*/;
-function stripFrontmatter(markdown) {
-  return markdown.replace(FRONTMATTER, "");
-}
-function plainText(nodes) {
-  return nodes.map((n) => n.text.replace(/\r\n/g, "\n").trim()).filter((t) => t !== "");
-}
-function treeText(source, path2) {
-  const format = formatOf(path2);
-  if (format === "markdown" || format === "mdx") return void 0;
-  const minted = mintTreeSections(parseTree(source, path2, format).sections);
-  const sections = /* @__PURE__ */ new Map();
-  for (const [n, section] of minted.sections.entries()) {
-    const own = plainText(minted.owned[n] ?? []);
-    sections.set(section.slug, [section.title, ...own].join("\n\n"));
-  }
-  const lead = plainText(minted.unowned);
-  return { doc: lead.length > 0 ? lead.join("\n\n") : void 0, sections };
-}
-function entry(id, type, fields) {
-  const out = { id, type };
-  if (fields.title !== void 0) out.title = fields.title;
-  if (fields.labels !== void 0) out.labels = fields.labels;
-  if (fields.description !== void 0) out.description = fields.description;
-  if (fields.text !== void 0) out.text = fields.text;
-  return out;
-}
-function buildSearchIndex(graph, cwd, options = {}) {
-  const warnings = options.warnings ?? [];
-  const readDoc = options.readDoc ?? ((path2) => {
-    const abs = resolve2(cwd, path2);
-    return existsSync2(abs) ? readFileSync(abs, "utf8") : void 0;
-  });
-  const entries = [];
-  const sourceOf = /* @__PURE__ */ new Map();
-  const treeTextOf = /* @__PURE__ */ new Map();
-  const allSections = graph.instancesOf(GRAPH_SECTION);
-  const sectionsOf = /* @__PURE__ */ new Map();
-  for (const section of allSections) {
-    const hash = section.indexOf("#");
-    if (hash < 0) continue;
-    const doc = section.slice(0, hash);
-    const siblings = sectionsOf.get(doc);
-    if (siblings) siblings.push(section);
-    else sectionsOf.set(doc, [section]);
-  }
-  for (const doc of graph.instancesOf(GRAPH_DOCUMENT2)) {
-    const path2 = graph.literal(doc, GRAPH_PATH2);
-    const source = path2 === void 0 ? void 0 : readDoc(path2);
-    sourceOf.set(doc, source);
-    if (path2 !== void 0 && source === void 0) {
-      warnings.push(
-        `Source not found for ${path2} \u2014 indexed without body text.`
-      );
-    }
-    const tree = source === void 0 || path2 === void 0 ? void 0 : treeText(source, path2);
-    if (tree) treeTextOf.set(doc, tree);
-    const body = source === void 0 ? void 0 : stripFrontmatter(source).replace(/\r\n/g, "\n");
-    const text = tree ? tree.doc : body === void 0 ? void 0 : (sectionsOf.get(doc)?.length ?? 0) > 0 ? documentPreamble(body) : body;
-    entries.push(
-      entry(doc, compactIri(GRAPH_DOCUMENT2), {
-        title: graph.literal(doc, DCTERMS_TITLE2),
-        description: graph.literal(doc, DCTERMS_DESCRIPTION),
-        text
-      })
-    );
-  }
-  const occurrencesOf = /* @__PURE__ */ new Map();
-  for (const section of allSections) {
-    const hash = section.indexOf("#");
-    const doc = hash < 0 ? section : section.slice(0, hash);
-    const title = graph.literal(section, DCTERMS_TITLE2);
-    const source = sourceOf.get(doc);
-    const levelText = graph.literal(section, GRAPH_LEVEL2);
-    const parsed = levelText === void 0 ? NaN : Number.parseInt(levelText, 10);
-    const level = Number.isNaN(parsed) ? void 0 : parsed;
-    let occurrences = occurrencesOf.get(doc);
-    if (!occurrences) {
-      occurrences = sectionOccurrences(graph, doc);
-      occurrencesOf.set(doc, occurrences);
-    }
-    const tree = treeTextOf.get(doc);
-    const text = tree ? tree.sections.get(section.slice(hash + 1)) : source !== void 0 && title !== void 0 ? sectionOwnText(source, title, level, occurrences.get(section) ?? 0) : void 0;
-    entries.push(entry(section, compactIri(GRAPH_SECTION), { title, text }));
-  }
-  for (const concept of graph.instancesOf(SKOS_CONCEPT)) {
-    const pref = graph.literals(concept, SKOS_PREF_LABEL);
-    const alt = graph.literals(concept, SKOS_ALT_LABEL);
-    entries.push(
-      entry(concept, compactIri(SKOS_CONCEPT), {
-        title: pref[0],
-        labels: joinLabels([...pref, ...alt])
-      })
-    );
-  }
-  entries.sort((a, b) => byCodeUnit(a.id, b.id));
-  return { version: 1, entries };
-}
-function emitSearchIndex(doc) {
-  return `${JSON.stringify(doc, null, 2)}
-`;
-}
-function partitionByLanguage(graph, index) {
-  const documentType = compactIri(GRAPH_DOCUMENT2);
-  const sectionType = compactIri(GRAPH_SECTION);
-  const languageOf = (entry2) => {
-    if (entry2.type !== documentType && entry2.type !== sectionType) {
-      return void 0;
-    }
-    const hash = entry2.id.indexOf("#");
-    const doc = hash === -1 ? entry2.id : entry2.id.slice(0, hash);
-    return languageOfDocument(graph, doc);
-  };
-  const out = /* @__PURE__ */ new Map();
-  const shared = [];
-  for (const entry2 of index.entries) {
-    const language = languageOf(entry2);
-    if (language === void 0) {
-      shared.push(entry2);
-      continue;
-    }
-    const bucket = out.get(language);
-    if (bucket) bucket.entries.push(entry2);
-    else out.set(language, { version: 1, entries: [entry2] });
-  }
-  if (out.size === 0 && shared.length > 0) {
-    out.set(UNDETERMINED, { version: 1, entries: [] });
-  }
-  for (const bucket of out.values()) {
-    bucket.entries.push(...shared);
-    bucket.entries.sort((a, b) => byCodeUnit(a.id, b.id));
-  }
-  return out;
-}
-function languageOfDocument(graph, doc) {
-  const tag = graph.literal(doc, DCTERMS_LANGUAGE);
-  return tag === void 0 ? UNDETERMINED : canonicalLanguageTag(tag);
-}
-function documentsByLanguage(graph) {
-  const out = /* @__PURE__ */ new Map();
-  for (const doc of graph.instancesOf(GRAPH_DOCUMENT2)) {
-    const language = languageOfDocument(graph, doc);
-    out.set(language, (out.get(language) ?? 0) + 1);
-  }
-  return out;
-}
-
-// src/graph/runtime/graph.ts
-var XSD_STRING4 = "http://www.w3.org/2001/XMLSchema#string";
-function compareValues(a, b) {
-  if (a.kind !== b.kind) return a.kind === "iri" ? -1 : 1;
-  const v = byCodeUnit(a.value, b.value);
-  if (v !== 0) return v;
-  const da = a.kind === "literal" ? a.datatype ?? "" : "";
-  const db = b.kind === "literal" ? b.datatype ?? "" : "";
-  return byCodeUnit(da, db);
-}
-var GraphIndex = class _GraphIndex {
-  nodes = /* @__PURE__ */ new Map();
-  /** subject → predicate → object IRIs (sorted). */
-  outbound = /* @__PURE__ */ new Map();
-  /** object → predicate → subject IRIs (sorted). */
-  inbound = /* @__PURE__ */ new Map();
-  /** class IRI → instance IRIs (sorted). */
-  byType = /* @__PURE__ */ new Map();
-  /** prefix → namespace, from the artifact's own `@context`. */
-  context;
-  constructor(context) {
-    this.context = context;
-  }
-  /**
-   * Build from a `graph.jsonld` document — a JSON string or the parsed object.
-   * CURIE keys and `@type` values are expanded using the document's own
-   * `@context`, so the index is self-describing.
-   */
-  static fromJsonLd(input) {
-    const doc = typeof input === "string" ? JSON.parse(input) : input;
-    const context = doc["@context"] ?? {};
-    const index = new _GraphIndex({ ...context });
-    for (const raw of doc["@graph"] ?? []) {
-      index.addJsonLdNode(raw);
-    }
-    index.finalize();
-    return index;
-  }
-  /** Build from dockg's internal quad shape (the Node/CLI path). */
-  static fromQuads(quads, context = {}) {
-    const index = new _GraphIndex({ ...context });
-    for (const q of quads) {
-      const o = q.o;
-      const value = o.kind === "iri" ? { kind: "iri", value: o.value } : o.datatype && o.datatype !== XSD_STRING4 ? { kind: "literal", value: o.value, datatype: o.datatype } : { kind: "literal", value: o.value };
-      index.addTriple(q.s, q.p, value);
-    }
-    index.finalize();
-    return index;
-  }
-  /** Expand a CURIE (`dcterms:title`) to a full IRI using `@context`. */
-  expand(term) {
-    const colon = term.indexOf(":");
-    if (colon <= 0) return term;
-    const ns = this.context[term.slice(0, colon)];
-    return ns ? `${ns}${term.slice(colon + 1)}` : term;
-  }
-  /** Compact a full IRI to a CURIE when a context namespace matches. */
-  compact(iri2) {
-    let best = iri2;
-    let bestNs = "";
-    for (const [prefix, ns] of Object.entries(this.context)) {
-      if (iri2.startsWith(ns) && iri2.length > ns.length && ns.length > bestNs.length) {
-        best = `${prefix}:${iri2.slice(ns.length)}`;
-        bestNs = ns;
-      }
-    }
-    return best;
-  }
-  addJsonLdNode(raw) {
-    const id = typeof raw["@id"] === "string" ? this.expand(raw["@id"]) : "";
-    if (!id) return;
-    this.ensureNode(id);
-    const rawTypes = raw["@type"];
-    for (const t of toArray(rawTypes)) {
-      if (typeof t === "string") {
-        this.addTriple(id, RDF_TYPE, { kind: "iri", value: this.expand(t) });
-      }
-    }
-    for (const [key, rawValue] of Object.entries(raw)) {
-      if (key === "@id" || key === "@type") continue;
-      const predicate = this.expand(key);
-      for (const v of toArray(rawValue)) {
-        const value = this.toValue(v);
-        if (value) this.addTriple(id, predicate, value);
-      }
-    }
-  }
-  toValue(v) {
-    if (typeof v === "string") return { kind: "literal", value: v };
-    if (typeof v === "number" || typeof v === "boolean") {
-      return { kind: "literal", value: String(v) };
-    }
-    if (v && typeof v === "object") {
-      const o = v;
-      if (typeof o["@id"] === "string") {
-        return { kind: "iri", value: this.expand(o["@id"]) };
-      }
-      if (o["@value"] !== void 0) {
-        const raw = o["@value"];
-        const lexical = typeof raw === "string" ? raw : JSON.stringify(raw);
-        const dt = typeof o["@type"] === "string" ? this.expand(o["@type"]) : void 0;
-        return dt && dt !== XSD_STRING4 ? { kind: "literal", value: lexical, datatype: dt } : { kind: "literal", value: lexical };
-      }
-    }
-    return void 0;
-  }
-  ensureNode(id) {
-    let node = this.nodes.get(id);
-    if (!node) {
-      node = { id, types: [], props: /* @__PURE__ */ new Map() };
-      this.nodes.set(id, node);
-    }
-    return node;
-  }
-  addTriple(s, p, o) {
-    const node = this.ensureNode(s);
-    let values = node.props.get(p);
-    if (!values) {
-      values = [];
-      node.props.set(p, values);
-    }
-    values.push(o);
-    if (p === RDF_TYPE && o.kind === "iri") {
-      node.types.push(o.value);
-      const instances = this.byType.get(o.value);
-      if (instances) instances.push(s);
-      else this.byType.set(o.value, [s]);
-    }
-    if (o.kind === "iri") {
-      addEdge(this.outbound, s, p, o.value);
-      addEdge(this.inbound, o.value, p, s);
-      this.ensureNode(o.value);
-    }
-  }
-  /** Sort every collection so traversal order is deterministic. */
-  finalize() {
-    for (const node of this.nodes.values()) {
-      node.types.sort(byCodeUnit);
-      for (const values of node.props.values()) values.sort(compareValues);
-    }
-    for (const instances of this.byType.values()) instances.sort(byCodeUnit);
-    for (const map of [this.outbound, this.inbound]) {
-      for (const preds of map.values()) {
-        for (const targets of preds.values()) targets.sort(byCodeUnit);
-      }
-    }
-  }
-  /** Every node IRI, sorted. */
-  ids() {
-    return [...this.nodes.keys()].sort(byCodeUnit);
-  }
-  size() {
-    return this.nodes.size;
-  }
-  node(iri2) {
-    return this.nodes.get(iri2);
-  }
-  has(iri2) {
-    return this.nodes.has(iri2);
-  }
-  /** Class IRIs of a node, sorted. */
-  types(iri2) {
-    return this.nodes.get(iri2)?.types ?? [];
-  }
-  /** Instances of a class, sorted. */
-  instancesOf(classIri) {
-    return this.byType.get(classIri) ?? [];
-  }
-  /** All values for a predicate, sorted. */
-  values(iri2, predicate) {
-    return this.nodes.get(iri2)?.props.get(predicate) ?? [];
-  }
-  /** Literal lexical forms for a predicate, sorted. */
-  literals(iri2, predicate) {
-    return this.values(iri2, predicate).filter((v) => v.kind === "literal").map((v) => v.value);
-  }
-  /** The first literal for a predicate, if any. */
-  literal(iri2, predicate) {
-    return this.literals(iri2, predicate)[0];
-  }
-  /** Outbound IRI targets: all predicates, or one. Sorted. */
-  out(iri2, predicate) {
-    return edges(this.outbound, iri2, predicate);
-  }
-  /** Inbound IRI sources (who points at this node). Sorted. */
-  in(iri2, predicate) {
-    return edges(this.inbound, iri2, predicate);
-  }
-};
-function addEdge(map, key, predicate, target) {
-  let preds = map.get(key);
-  if (!preds) {
-    preds = /* @__PURE__ */ new Map();
-    map.set(key, preds);
-  }
-  const targets = preds.get(predicate);
-  if (targets) targets.push(target);
-  else preds.set(predicate, [target]);
-}
-function edges(map, iri2, predicate) {
-  const preds = map.get(iri2);
-  if (!preds) return [];
-  const out = [];
-  const keys = predicate ? [predicate] : [...preds.keys()].sort(byCodeUnit);
-  for (const p of keys) {
-    for (const target of preds.get(p) ?? []) out.push({ predicate: p, target });
-  }
-  return out;
-}
-function toArray(v) {
-  if (v === void 0 || v === null) return [];
-  return Array.isArray(v) ? v : [v];
-}
-
 // src/graph/commands/export.ts
-var EXPORT_TARGETS = ["jsonld", "iirds", "search"];
+var EXPORT_TARGETS = ["jsonld", "iirds", "search", "questions"];
 var EXTENSION = {
   jsonld: ".jsonld",
   iirds: ".iirds"
@@ -1110,7 +510,7 @@ function runJsonLd(cwd, graphPath, out) {
   const quads = storeToQuads(store);
   const serialized = emitJsonLd(quads);
   const nodes = new Set(quads.map((q) => q.s)).size;
-  const outPath = out ? resolve3(cwd, out) : withExtension(graphPath, EXTENSION.jsonld);
+  const outPath = out ? resolve2(cwd, out) : withExtension(graphPath, EXTENSION.jsonld);
   mkdirSync(dirname(outPath), { recursive: true });
   writeFileSync(outPath, serialized, "utf8");
   return { outPath, format: "jsonld", nodes, warnings: [] };
@@ -1128,7 +528,7 @@ function runIirds(cwd, sources, graphPath, iirds, baseIri, out) {
     sources
   );
   const metadata = emitRdfXml(projection.quads, projection.prefixes);
-  const content = [...projection.contentFiles].sort((a, b) => byCodeUnit(a.zipPath, b.zipPath)).map((f) => ({ name: f.zipPath, data: readFileSync2(f.absPath) }));
+  const content = [...projection.contentFiles].sort((a, b) => byCodeUnit(a.zipPath, b.zipPath)).map((f) => ({ name: f.zipPath, data: readFileSync(f.absPath) }));
   const entries = [
     {
       name: "mimetype",
@@ -1138,7 +538,7 @@ function runIirds(cwd, sources, graphPath, iirds, baseIri, out) {
     { name: "META-INF/metadata.rdf", data: Buffer.from(metadata, "utf8") },
     ...content
   ];
-  const outPath = out ? resolve3(cwd, out) : withExtension(graphPath, EXTENSION.iirds);
+  const outPath = out ? resolve2(cwd, out) : withExtension(graphPath, EXTENSION.iirds);
   mkdirSync(dirname(outPath), { recursive: true });
   writeFileSync(outPath, writeZip(entries));
   const nodes = new Set(projection.quads.map((q) => q.s)).size;
@@ -1157,7 +557,7 @@ function runSearchIndex(cwd, sources, graphPath, out) {
   const index = buildSearchIndex(graph, sources, { warnings });
   const byLanguage = partitionByLanguage(graph, index);
   const docCounts = documentsByLanguage(graph);
-  const outDir = out ? resolve3(cwd, out) : dirname(graphPath);
+  const outDir = out ? resolve2(cwd, out) : dirname(graphPath);
   mkdirSync(outDir, { recursive: true });
   const languages = [];
   for (const [language, doc] of byLanguage) {
@@ -1192,12 +592,24 @@ function runSearchIndex(cwd, sources, graphPath, out) {
     warnings
   };
 }
-function runExport(opts) {
-  return new Promise((ok) => {
-    ok(exportOnce(opts));
-  });
+async function runQuestions(cwd, sources, graphPath, config, source, out) {
+  const { lines, stale } = await exportSampleQuestions(
+    loadGraph(graphPath),
+    sources,
+    { source, cwd },
+    config.questionFiles,
+    config.configDir
+  );
+  const outPath = out ? resolve2(cwd, out) : join(dirname(graphPath), "questions.jsonl");
+  mkdirSync(dirname(outPath), { recursive: true });
+  writeFileSync(outPath, lines.map((l) => `${l}
+`).join(""), "utf8");
+  const warnings = stale === 0 ? [] : [
+    stale === 1 ? "1 answer changed since it was pinned, so it is exported as it reads now, marked stale." : `${String(stale)} answers changed since they were pinned, so they are exported as they read now, marked stale.`
+  ];
+  return { outPath, format: "questions", nodes: lines.length, warnings };
 }
-function exportOnce(opts) {
+async function runExport(opts) {
   const cwd = opts.cwd ?? process.cwd();
   if (!EXPORT_TARGETS.includes(opts.format)) {
     throw new GraphError(
@@ -1211,12 +623,25 @@ function exportOnce(opts) {
     },
     cwd
   );
-  const graphPath = resolve3(cwd, opts.graph ?? config.out);
+  const graphPath = resolve2(cwd, opts.graph ?? config.out);
   const sources = documentBase(config, {}, cwd);
   if (opts.format === "jsonld") return runJsonLd(cwd, graphPath, opts.out);
   if (opts.format === "search") {
     return runSearchIndex(cwd, sources, graphPath, opts.out);
   }
+  if (opts.format === "questions") {
+    return runQuestions(
+      cwd,
+      sources,
+      graphPath,
+      config,
+      {
+        ...opts.config === void 0 ? {} : { configPath: opts.config },
+        ...opts.noConfig === void 0 ? {} : { noConfig: opts.noConfig }
+      },
+      opts.out
+    );
+  }
   return runIirds(
     cwd,
     sources,
@@ -1228,7 +653,7 @@ function exportOnce(opts) {
 }
 
 // src/graph/commands/query.ts
-import { resolve as resolve4 } from "node:path";
+import { resolve as resolve3 } from "node:path";
 import { DataFactory as DataFactory2 } from "n3";
 function runQuery(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
@@ -1239,7 +664,7 @@ function runQuery(opts = {}) {
     },
     cwd
   );
-  const store = loadGraph(resolve4(cwd, opts.graph ?? config.out));
+  const store = loadGraph(resolve3(cwd, opts.graph ?? config.out));
   const s = opts.s ? DataFactory2.namedNode(expandTerm(opts.s)) : null;
   const p = opts.p ? DataFactory2.namedNode(expandTerm(opts.p)) : null;
   const oValue = opts.o ? expandTerm(opts.o) : null;
@@ -1253,12 +678,13 @@ function runQuery(opts = {}) {
       o: obj.termType === "Literal" ? {
         kind: "literal",
         value: obj.value,
-        ...obj.datatype.value !== "http://www.w3.org/2001/XMLSchema#string" ? { datatype: obj.datatype.value } : {}
+        ...obj.language !== "" ? { language: obj.language } : {},
+        ...obj.language === "" && obj.datatype.value !== "http://www.w3.org/2001/XMLSchema#string" ? { datatype: obj.datatype.value } : {}
       } : { kind: "iri", value: obj.value }
     });
   }
   matches.sort(
-    (a, b) => byCodeUnit(a.s, b.s) || byCodeUnit(a.p, b.p) || byCodeUnit(a.o.kind, b.o.kind) || byCodeUnit(a.o.value, b.o.value)
+    (a, b) => byCodeUnit(a.s, b.s) || byCodeUnit(a.p, b.p) || byCodeUnit(a.o.kind, b.o.kind) || byCodeUnit(a.o.value, b.o.value) || byCodeUnit(a.o.language ?? "", b.o.language ?? "")
   );
   return { matches };
 }
@@ -1266,7 +692,7 @@ function renderQuery(result, format) {
   if (format === "json") return JSON.stringify(result, null, 2);
   if (result.matches.length === 0) return "No matches.";
   const lines = result.matches.map((m) => {
-    const o = m.o.kind === "iri" ? `<${m.o.value}>` : `"${m.o.value}"${m.o.datatype ? `^^${compactIri(m.o.datatype)}` : ""}`;
+    const o = m.o.kind === "iri" ? `<${m.o.value}>` : `"${m.o.value}"${m.o.language ? `@${m.o.language}` : m.o.datatype ? `^^${compactIri(m.o.datatype)}` : ""}`;
     return `<${m.s}> ${compactIri(m.p)} ${o}`;
   });
   lines.push(`
@@ -1275,12 +701,20 @@ ${result.matches.length} match(es)`);
 }
 
 // src/graph/commands/fill.ts
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { resolve as resolve6 } from "node:path";
 
 // src/graph/core/frontmatter-edit.ts
-import { Document, YAMLMap, YAMLSeq, isMap, parseDocument } from "yaml";
+import {
+  Document,
+  YAMLMap,
+  YAMLSeq,
+  isCollection,
+  isMap,
+  parseDocument,
+  visit
+} from "yaml";
 var GRAPH_KEY = "graph";
 function frontmatterKind(content) {
   const body = content.charCodeAt(0) === 65279 ? content.slice(1) : content;
@@ -1354,7 +788,7 @@ function applyGraphFields(content, path2, values, options = {}) {
     });
     const graph2 = doc2.get("graph", true);
     if (isMap(graph2)) flowSeqs(graph2);
-    let block = doc2.toString();
+    let block = doc2.toString({ lineWidth: 0 });
     if (eol === "\r\n") block = block.replace(/(?<!\r)\n/g, "\r\n");
     return {
       content: `---${eol}${block}---${eol}${eol}${content}`,
@@ -1384,10 +818,26 @@ function applyGraphFields(content, path2, values, options = {}) {
   if (applied.length === 0 && pageEntries.length === 0) {
     return { content, applied, skipped };
   }
-  let newBlock = doc.toString();
+  let newBlock = doc.toString({
+    flowCollectionPadding: flowPadding(doc, split.block),
+    lineWidth: 0
+  });
   if (split.eol === "\r\n") newBlock = newBlock.replace(/(?<!\r)\n/g, "\r\n");
   return { content: split.open + newBlock + split.suffix, applied, skipped };
 }
+function flowPadding(doc, block) {
+  let padded;
+  visit(doc, (_key, node) => {
+    if (!isCollection(node) || node.flow !== true || node.items.length === 0) {
+      return;
+    }
+    if (!node.range) return;
+    const start = node.range[0];
+    padded = /^[[{][ \t]/.test(block.slice(start, start + 2));
+    return visit.BREAK;
+  });
+  return padded ?? true;
+}
 function writable(values) {
   return Object.entries(values).filter(
     ([, v]) => v !== void 0 && v !== null && !(Array.isArray(v) && v.length === 0)
@@ -1483,8 +933,8 @@ function existingGraphFields(content) {
 }
 
 // src/graph/core/fill-guard.ts
-import { readFileSync as readFileSync3 } from "node:fs";
-import { resolve as resolve5 } from "node:path";
+import { readFileSync as readFileSync2 } from "node:fs";
+import { resolve as resolve4 } from "node:path";
 import { DataFactory as DataFactory3, Store } from "n3";
 var GUARDED_FIELDS = [
   "label",
@@ -1510,7 +960,7 @@ function toStore(quads) {
         DataFactory3.namedNode(q.p),
         q.o.kind === "iri" ? DataFactory3.namedNode(q.o.value) : DataFactory3.literal(
           q.o.value,
-          q.o.datatype ? DataFactory3.namedNode(q.o.datatype) : void 0
+          q.o.language ?? (q.o.datatype ? DataFactory3.namedNode(q.o.datatype) : void 0)
         )
       )
     );
@@ -1573,7 +1023,7 @@ var FillGuard = class _FillGuard {
         guard.models.set(
           path2,
           analyzeDoc(
-            inline.get(path2) ?? readFileSync3(resolve5(cwd, path2), "utf8"),
+            inline.get(path2) ?? readFileSync2(resolve4(cwd, path2), "utf8"),
             path2,
             guard.allPaths,
             inputs.has(path2) ? guard.analyzeOptions : byExtension
@@ -1722,6 +1172,7 @@ import { JsonCache, buildCacheKey, sha256 } from "@hawkeyexl/inference";
 
 // src/graph/llm/prompt.ts
 var PROMPT_VERSION = 4;
+var QUESTION_PROMPT_VERSION = 1;
 var TOPIC_TYPES = [
   "task",
   "concept",
@@ -1917,6 +1368,73 @@ function buildUserPrompt(doc, body, fields, options = {}) {
     body.slice(0, EXCERPT_CHARS)
   ].join("\n");
 }
+var QUESTION_SYSTEM_PROMPT = [
+  "You write and answer the questions a reader asks of a documentation page.",
+  "Every answer is a passage quoted VERBATIM from the page text you are given:",
+  "copy it exactly, as one contiguous run of the text, and quote no more than",
+  "the passage that answers. Never paraphrase a quote.",
+  "",
+  "For each numbered question, quote the passage that answers it, or an empty",
+  "string when no passage in this text does. Draft only as many new questions",
+  "as asked. Ask them as a reader would, in a reader's own words rather than",
+  "the page's, and only questions this text answers. For every pair and draft,",
+  "give a `confidence` (0..1) that the quote answers the question. Score",
+  "honestly and conservatively."
+].join("\n");
+function buildQuestionPrompt(request, chunk) {
+  const concepts = request.concepts.map(
+    (c) => c.altLabels.length > 0 ? `- ${c.label} (also: ${c.altLabels.join(", ")})` : `- ${c.label}`
+  );
+  return [
+    `Path: ${request.path}`,
+    `Title: ${request.title}`,
+    ...concepts.length > 0 ? ["", "Concepts this page is about:", ...concepts] : [],
+    "",
+    request.pair.length > 0 ? `Questions to pair, by number:
+${request.pair.map((q, i) => `${String(i + 1)}. ${q}`).join("\n")}` : "Questions to pair: none.",
+    "",
+    request.draft > 0 ? `Draft ${String(request.draft)} new question${request.draft === 1 ? "" : "s"}, each with the quote that answers it.` : "Draft no new questions.",
+    "",
+    "Page text:",
+    chunk
+  ].join("\n");
+}
+function questionSchema(lenient = false) {
+  const confidence = lenient ? {} : { type: "number", minimum: 0, maximum: 1 };
+  const item = (properties, optional = []) => ({
+    type: "object",
+    additionalProperties: false,
+    required: Object.keys(properties).filter((k) => !lenient || !optional.includes(k)),
+    properties
+  });
+  return item(
+    {
+      pairs: {
+        type: "array",
+        items: item(
+          {
+            index: { type: "integer", minimum: 1, description: "The question's number." },
+            quote: { type: "string", description: "The verbatim passage that answers it, or an empty string." },
+            confidence
+          },
+          ["confidence"]
+        )
+      },
+      drafts: {
+        type: "array",
+        items: item(
+          {
+            question: { type: "string", minLength: 1, description: "A question a reader would ask." },
+            quote: { type: "string", minLength: 1, description: "The verbatim passage that answers it." },
+            confidence
+          },
+          ["confidence"]
+        )
+      }
+    },
+    ["pairs", "drafts"]
+  );
+}
 
 // src/graph/llm/cache.ts
 function cacheKey(provider, model, content, fields, sections = false) {
@@ -1933,6 +1451,16 @@ function cacheKey(provider, model, content, fields, sections = false) {
     sections ? "sections" : "doc-only"
   ]);
 }
+function questionCacheKey(provider, model, chunk, request) {
+  return buildCacheKey([
+    provider,
+    model,
+    `q${QUESTION_PROMPT_VERSION}`,
+    sha256(chunk),
+    "questions",
+    sha256(JSON.stringify(request))
+  ]);
+}
 var FillCache = class extends JsonCache {
   constructor(dir, enabled = true) {
     super(dir, enabled, "manni");
@@ -1960,8 +1488,8 @@ function selectProvider2(config, flags = {}) {
     }
   ]);
 }
-function announceSelection(selection) {
-  const message = localNotice(selection);
+function announceSelection(selection, flags = {}) {
+  const message = localNotice(selection, flags);
   if (message !== void 0) noticeOnce(message);
 }
 function assertProviderSelection(selection) {
@@ -1976,16 +1504,19 @@ function assertProviderSelection(selection) {
 function providerSpecFor2(config, selection) {
   return providerSpecFor(config.providers, selection);
 }
-async function resolveProviderIdentity(config, flags = {}) {
+function selectedSpec(config, flags) {
   const selection = selectProvider2(config, flags);
   const { provider, model } = selection;
   assertKnownProvider(provider, toGraphError);
   assertModelHasProvider(provider, model, CONFIG_KEY, toGraphError);
-  announceSelection(selection);
-  return resolveIdentity(
-    providerSpecFor2(config, { provider, model: model ?? null }),
-    toGraphError
-  );
+  announceSelection(selection, flags);
+  return providerSpecFor2(config, { provider, model: model ?? null });
+}
+async function resolveProviderIdentity(config, flags = {}) {
+  return resolveIdentity(selectedSpec(config, flags), toGraphError);
+}
+async function resolveOfflineIdentity(config, flags) {
+  return offlineIdentity(selectedSpec(config, flags), toGraphError);
 }
 function constructProvider(config, identity) {
   try {
@@ -1998,33 +1529,408 @@ async function makeProvider(config, flags = {}) {
   return constructProvider(config, await resolveProviderIdentity(config, flags));
 }
 
-// src/graph/commands/fill.ts
-var TURN_BUDGET_REASON = "turn budget";
-var RELATION_FIELDS = [
-  "alt-labels",
-  "broader",
-  "narrower",
-  "related-concepts"
-];
-function numberMap(v) {
-  const out = {};
-  if (v && typeof v === "object" && !Array.isArray(v)) {
-    for (const [k, val] of Object.entries(v)) {
-      if (typeof val === "number" && val >= 0 && val <= 1) out[k] = val;
-    }
-  }
-  return out;
+// src/graph/commands/fill-questions.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { resolve as resolve5 } from "node:path";
+import { isMap as isMap2, isSeq, parseDocument as parseDocument2 } from "yaml";
+var QUESTIONS_KEY = "sample-questions";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function stringMap(v) {
-  const out = {};
-  if (v && typeof v === "object" && !Array.isArray(v)) {
-    for (const [k, val] of Object.entries(v)) {
-      if (typeof val === "string") out[k] = val;
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function score(value) {
+  return typeof value === "number" && value >= 0 && value <= 1 ? value : 0;
+}
+function linesOf(pin) {
+  const spec = pin.lines;
+  return typeof spec === "number" || typeof spec === "string" ? parseLines(spec) : void 0;
+}
+function readProposal(value) {
+  const list = (v) => Array.isArray(v) ? v.filter(isRecord) : [];
+  return {
+    pairs: list(value.pairs).flatMap(
+      (p) => typeof p.index === "number" && typeof p.quote === "string" ? [{ index: p.index, quote: p.quote, confidence: score(p.confidence) }] : []
+    ),
+    drafts: list(value.drafts).flatMap(
+      (d) => typeof d.question === "string" && d.question.trim() !== "" && typeof d.quote === "string" ? [{ question: d.question.trim(), quote: d.quote, confidence: score(d.confidence) }] : []
+    )
+  };
+}
+function locateQuote(body, quote) {
+  const wanted = quote.replace(/\s+/gu, " ").trim();
+  if (wanted === "") return void 0;
+  const text = body.join("\n");
+  let folded = "";
+  const at = [];
+  let space = false;
+  for (let i = 0; i < text.length; i++) {
+    const ch = text.charAt(i);
+    if (/\s/u.test(ch)) {
+      if (!space && folded !== "") {
+        folded += " ";
+        at.push(i);
+      }
+      space = true;
+    } else {
+      folded += ch;
+      at.push(i);
+      space = false;
+    }
+  }
+  const found = folded.indexOf(wanted);
+  if (found < 0) return void 0;
+  const lineAt = (offset) => text.slice(0, offset).split("\n").length;
+  const start = at[found];
+  const end = at[found + wanted.length - 1];
+  if (start === void 0 || end === void 0) return void 0;
+  const twice = folded.indexOf(wanted, found + wanted.length) >= 0;
+  return { start: lineAt(start), end: lineAt(end), ...twice ? { ambiguous: true } : {} };
+}
+function twiceWarning(path2, question, lines) {
+  return `${path2}: the answer to "${question}" appears more than once, so ${spellLines(lines)} is pinned; check it is the right one.`;
+}
+function pinFor(body, lines) {
+  return { lines: lineSpec(lines), integrity: pinOfLines(body, lines) };
+}
+function relocate(pins, before, after) {
+  const delta = after.length - before.length;
+  let moved = false;
+  for (const pin of pins) {
+    const lines = linesOf(pin);
+    const integrity = pin.integrity;
+    if (lines === void 0 || typeof integrity !== "string") continue;
+    if (pinOfLines(after, lines) === integrity) continue;
+    const length = lines.end - lines.start + 1;
+    const around = lines.start + delta;
+    const { starts } = findWindows(after, length, integrity, void 0, { around });
+    const [first, ...rest] = starts;
+    if (first === void 0) continue;
+    const nearest = rest.reduce(
+      (best, s) => Math.abs(s - around) < Math.abs(best - around) ? s : best,
+      first
+    );
+    pin.lines = lineSpec({ start: nearest, end: nearest + length - 1 });
+    moved = true;
+  }
+  return moved;
+}
+function settle(tracked) {
+  return tracked.map(({ pin, ...outcome }) => {
+    const lines = pin === void 0 ? void 0 : linesOf(pin);
+    return lines === void 0 ? outcome : { ...outcome, lines: spellLines(lines) };
+  });
+}
+async function fillPageQuestions(input) {
+  const { path: path2, format, content, settings, asker, known } = input;
+  const { body } = bodyOf(content, format);
+  const held = metadataOf(content, path2, format).data[QUESTIONS_KEY];
+  const raw = Array.isArray(held) ? held : held === void 0 ? [] : [held];
+  const tracked = [];
+  const warnings = [];
+  const items = [];
+  const pins = [];
+  const needs = [];
+  let questions = 0;
+  let changed = false;
+  for (const value of raw) {
+    if (typeof value === "string" && value !== "") {
+      questions++;
+      needs.push({ at: items.length, question: value, stale: /* @__PURE__ */ new Set() });
+      items.push(value);
+      continue;
+    }
+    if (!isRecord(value) || typeof value.question !== "string" || value.question === "") {
+      items.push(value);
+      continue;
+    }
+    questions++;
+    const question = value.question;
+    const answers = Array.isArray(value.answers) ? value.answers.map((a) => isRecord(a) ? { ...a } : a) : [];
+    const item = { ...value };
+    if (Array.isArray(value.answers)) item.answers = answers;
+    const stale = /* @__PURE__ */ new Set();
+    for (const answer of answers) {
+      if (!isRecord(answer)) continue;
+      const lines = linesOf(answer);
+      if (lines === void 0) continue;
+      const integrity = answer.integrity;
+      if (typeof integrity !== "string") {
+        const minted = pinOfLines(body, lines);
+        if (minted === void 0) {
+          stale.add(answer);
+          continue;
+        }
+        answer.integrity = minted;
+        pins.push(answer);
+        tracked.push({ action: "re-pinned", question, pin: answer });
+        changed = true;
+        continue;
+      }
+      const fresh = freshness(body, { lines, integrity, reviewed: true });
+      if (fresh.state === "changed") {
+        stale.add(answer);
+        continue;
+      }
+      pins.push(answer);
+      const [range] = fresh.ranges;
+      if (fresh.state === "moved" && range !== void 0) {
+        answer.lines = lineSpec(range);
+        tracked.push({ action: "re-pinned", question, from: spellLines(lines), pin: answer });
+        changed = true;
+      } else if (fresh.state === "ambiguous") {
+        warnings.push(
+          `${path2}: the answer to "${question}" moved, and ${matchList(fresh.ranges)}, so pin one of them by hand.`
+        );
+      }
+    }
+    if (answers.length === 0 || stale.size > 0) {
+      needs.push({ at: items.length, question, stale });
+    }
+    items.push(item);
+  }
+  const draft = Math.max(0, settings.perPage - questions);
+  let state = "complete";
+  let skipped;
+  if (needs.length > 0 || draft > 0) {
+    const proposals = asker === void 0 ? "offline" : await ask(asker);
+    if (typeof proposals === "string" || asker === void 0) {
+      skipped = typeof proposals === "string" ? proposals : "offline";
+      state = "skipped";
+    } else {
+      state = "unchanged";
+      if (pair(proposals)) changed = true;
+      if (drafts(proposals, asker)) changed = true;
+    }
+  }
+  if (!changed) {
+    return { content, outcomes: settle(tracked), state, ...skipped ? { skipped } : {}, warnings };
+  }
+  const write = () => writeGraphFields(content, path2, format, {}, { page: { [QUESTIONS_KEY]: items } }).content;
+  let next = write();
+  let before = body;
+  for (let round = 0; ; round++) {
+    const after = bodyOf(next, format).body;
+    if (!relocate(pins, before, after)) break;
+    if (round === 2) {
+      next = write();
+      warnings.push(`${path2}: the answer pins did not settle, so check their lines.`);
+      break;
+    }
+    before = after;
+    next = write();
+  }
+  return {
+    content: next,
+    outcomes: settle(tracked),
+    state: "changed",
+    ...skipped ? { skipped } : {},
+    warnings
+  };
+  async function ask(model) {
+    const request = {
+      path: path2,
+      title: input.title,
+      concepts: await input.concepts(),
+      pair: needs.map((n) => n.question),
+      draft
+    };
+    const out = [];
+    for (const chunk of splitBody(body.join("\n"), settings.chunkChars)) {
+      const answer = await model.ask(request, chunk);
+      if (answer === void 0) return "turn budget";
+      out.push(readProposal(answer));
+    }
+    return out;
+  }
+  function pair(proposals) {
+    let wrote = false;
+    for (const [n, need] of needs.entries()) {
+      const action = need.stale.size > 0 ? "re-paired" : "paired";
+      const question = need.question;
+      const candidates = proposals.flatMap((p) => p.pairs.filter((c) => c.index === n + 1 && c.quote.trim() !== "")).sort((a, b) => b.confidence - a.confidence);
+      if (candidates.length === 0) {
+        tracked.push({ action: "not-paired", question, reason: "no passage answers it" });
+        continue;
+      }
+      let found;
+      for (const c of candidates) {
+        const lines = locateQuote(body, c.quote);
+        if (lines !== void 0) {
+          if (lines.ambiguous) warnings.push(twiceWarning(path2, question, lines));
+          found = { lines: { start: lines.start, end: lines.end }, confidence: c.confidence };
+          break;
+        }
+      }
+      if (found === void 0) {
+        tracked.push({ action: "not-paired", question, reason: "answer not on page" });
+        continue;
+      }
+      const confidence = round2(found.confidence);
+      if (found.confidence < settings.confidenceThreshold) {
+        tracked.push({ action: "not-paired", question, confidence, reason: "low confidence, not written" });
+        continue;
+      }
+      const pin = { ...pinFor(body, found.lines), reviewed: false };
+      pins.push(pin);
+      const item = items[need.at];
+      if (typeof item === "string") {
+        items[need.at] = { question: item, answers: [pin] };
+      } else if (isRecord(item)) {
+        const kept = Array.isArray(item.answers) ? item.answers.filter((a) => !need.stale.has(a)) : [];
+        item.answers = [...kept, pin];
+      }
+      tracked.push({ action, question, confidence, pin });
+      wrote = true;
+    }
+    return wrote;
+  }
+  function drafts(proposals, model) {
+    const pool = proposals.flatMap((p) => p.drafts).sort((a, b) => b.confidence - a.confidence);
+    let accepted = 0;
+    for (const d of pool) {
+      if (accepted >= draft) break;
+      const question = d.question;
+      const confidence = round2(d.confidence);
+      const located = locateQuote(body, d.quote);
+      if (located === void 0) {
+        tracked.push({ action: "dropped", question, reason: "answer not on page" });
+        continue;
+      }
+      if (located.ambiguous) warnings.push(twiceWarning(path2, question, located));
+      const lines = { start: located.start, end: located.end };
+      const key = questionKey(question);
+      const asked = key === "" ? void 0 : known.get(key);
+      if (asked !== void 0) {
+        tracked.push({ action: "dropped", question, reason: `duplicate of ${asked}` });
+        continue;
+      }
+      const copied = copiedPairs(question, body.slice(lines.start - 1, lines.end).join("\n"));
+      if (copied && copied.copied / copied.of > COPIED_SHARE) {
+        tracked.push({
+          action: "dropped",
+          question,
+          reason: `copies its answer (${String(copied.copied)} of ${String(copied.of)} word pairs)`
+        });
+        continue;
+      }
+      if (d.confidence < settings.confidenceThreshold) {
+        tracked.push({ action: "dropped", question, confidence, reason: "low confidence, not written" });
+        continue;
+      }
+      const pin = pinFor(body, lines);
+      pins.push(pin);
+      items.push({
+        question,
+        answers: [pin],
+        ...settings.writeProvenance ? { "generated-by": model.generatedBy, confidence } : {},
+        reviewed: false
+      });
+      if (key !== "") known.set(key, path2);
+      tracked.push({ action: "drafted", question, confidence, pin });
+      accepted++;
+    }
+    return accepted > 0;
+  }
+}
+function questionsIn(content, path2, format) {
+  const held = metadataOf(content, path2, format).data[QUESTIONS_KEY];
+  const raw = Array.isArray(held) ? held : held === void 0 ? [] : [held];
+  return raw.flatMap(
+    (v) => typeof v === "string" ? [v] : isRecord(v) && typeof v.question === "string" ? [v.question] : []
+  );
+}
+function questionsInFile(abs, label) {
+  return readQuestionFile(abs, label).map((q) => q.question);
+}
+function repinQuestionFile(abs, label, configDir, dryRun) {
+  const text = existsSync2(abs) ? readFileSync3(abs, "utf8") : void 0;
+  readQuestionFile(abs, label, text);
+  const doc = parseDocument2(text ?? "");
+  const outcomes = [];
+  const warnings = [];
+  const bodies = /* @__PURE__ */ new Map();
+  const bodyAt = (file) => {
+    if (!bodies.has(file)) {
+      const page = resolve5(configDir, file);
+      bodies.set(
+        file,
+        existsSync2(page) ? bodyOf(readFileSync3(page, "utf8"), formatOf(file)).body : void 0
+      );
+    }
+    return bodies.get(file);
+  };
+  let changed = false;
+  const seq = doc.contents;
+  for (const node of isSeq(seq) ? seq.items : []) {
+    if (!isMap2(node)) continue;
+    const question = node.get("question");
+    const answers = node.get("answers", true);
+    if (typeof question !== "string" || !isSeq(answers)) continue;
+    for (const answer of answers.items) {
+      if (!isMap2(answer)) continue;
+      const file = answer.get("file");
+      const spec = answer.get("lines");
+      const lines = typeof spec === "number" || typeof spec === "string" ? parseLines(spec) : void 0;
+      if (typeof file !== "string" || lines === void 0) continue;
+      const body = bodyAt(file);
+      if (body === void 0) continue;
+      const integrity = answer.get("integrity");
+      if (typeof integrity !== "string") {
+        const minted = pinOfLines(body, lines);
+        if (minted === void 0) continue;
+        answer.set("integrity", minted);
+        outcomes.push({ action: "re-pinned", question, file, lines: spellLines(lines) });
+        changed = true;
+        continue;
+      }
+      const fresh = freshness(body, { lines, integrity, reviewed: true });
+      if (fresh.state === "changed") continue;
+      const [range] = fresh.ranges;
+      if (fresh.state === "moved" && range !== void 0) {
+        answer.set("lines", lineSpec(range));
+        outcomes.push({ action: "re-pinned", question, file, from: spellLines(lines), lines: spellLines(range) });
+        changed = true;
+      } else if (fresh.state === "ambiguous") {
+        warnings.push(
+          `${label}: the answer to "${question}" in ${file} moved, and ${matchList(fresh.ranges)}, so pin one of them by hand.`
+        );
+      }
+    }
+  }
+  if (changed && !dryRun) writeFileSync2(abs, doc.toString(), "utf8");
+  return { changed, outcomes, warnings };
+}
+
+// src/graph/commands/fill.ts
+var TURN_BUDGET_REASON = "turn budget";
+var OFFLINE_REASON = "offline";
+var RELATION_FIELDS = [
+  "alt-labels",
+  "broader",
+  "narrower",
+  "related-concepts"
+];
+function numberMap(v) {
+  const out = {};
+  if (v && typeof v === "object" && !Array.isArray(v)) {
+    for (const [k, val] of Object.entries(v)) {
+      if (typeof val === "number" && val >= 0 && val <= 1) out[k] = val;
     }
   }
   return out;
 }
-function round2(n) {
+function stringMap(v) {
+  const out = {};
+  if (v && typeof v === "object" && !Array.isArray(v)) {
+    for (const [k, val] of Object.entries(v)) {
+      if (typeof val === "string") out[k] = val;
+    }
+  }
+  return out;
+}
+function round22(n) {
   return Math.round(n * 100) / 100;
 }
 var META_PROVENANCE_KEY = "meta-provenance";
@@ -2042,10 +1948,12 @@ async function runFill(opts = {}) {
     },
     cwd
   );
+  const offline = opts.offline ?? config.fill.offline;
   const flags = {
     ...opts.provider === void 0 ? {} : { provider: opts.provider },
     ...opts.model === void 0 ? {} : { model: opts.model },
-    ...opts.local === void 0 ? {} : { local: opts.local }
+    ...opts.local === void 0 ? {} : { local: opts.local },
+    ...offline ? { offline: true } : {}
   };
   const selection = selectProvider2(config, flags);
   assertProviderSelection(selection);
@@ -2077,11 +1985,20 @@ async function runFill(opts = {}) {
   };
   let identity;
   let construct;
-  if (opts.providerInstance) {
+  if (offline) {
+    const local = await resolveOfflineIdentity(config, flags);
+    const injected = opts.providerInstance;
+    identity = local === void 0 || injected === void 0 ? local : { provider: injected.provider(), model: injected.modelName() };
+    construct = () => {
+      if (injected !== void 0) return injected;
+      if (local === void 0) throw new GraphError(noOfflineModel("nothing was proposed"));
+      return constructProvider(config, local);
+    };
+  } else if (opts.providerInstance) {
     const injected = opts.providerInstance;
     identity = { provider: injected.provider(), model: injected.modelName() };
     construct = () => injected;
-    announceSelection(selection);
+    announceSelection(selection, flags);
   } else {
     const resolved = await resolveProviderIdentity(config, flags);
     identity = resolved;
@@ -2089,7 +2006,11 @@ async function runFill(opts = {}) {
   }
   let provider;
   const getProvider = () => provider ??= construct();
-  const fields = opts.fields ?? config.fill.fields;
+  const configured = opts.fields ?? config.fill.fields;
+  const withQuestions = configured.includes("sample-questions");
+  const fields = configured.filter(
+    (f) => f !== "sample-questions"
+  );
   const withSections = opts.sections ?? config.fill.sections;
   const sectionFields = withSections ? fields.filter((f) => SECTION_FILL_FIELDS.includes(f)) : void 0;
   const validateProposal = validatorFor(
@@ -2178,6 +2099,93 @@ async function runFill(opts = {}) {
       );
     }
   }
+  const questionSettings = {
+    perPage: config.fill.questions.perPage,
+    confidenceThreshold,
+    chunkChars: opts.chunkChars ?? config.fill.chunkChars,
+    writeProvenance: config.fill.writeProvenance
+  };
+  const known = /* @__PURE__ */ new Map();
+  if (withQuestions) {
+    const asked = [
+      ...[...mergedTexts].sort(([a], [b]) => byCodeUnit(a, b)),
+      ...stdinContent === void 0 ? [] : [[STDIN_PATH, stdinContent]]
+    ];
+    for (const [path2, text] of asked) {
+      for (const q of questionsIn(text, path2, formatOf(path2, formatFor(path2)))) {
+        const key = questionKey(q);
+        if (key !== "" && !known.has(key)) known.set(key, path2);
+      }
+    }
+    for (const label of config.questionFiles) {
+      for (const q of questionsInFile(resolve6(config.configDir, label), label)) {
+        const key = questionKey(q);
+        if (key !== "" && !known.has(key)) known.set(key, label);
+      }
+    }
+  }
+  const questionValidator = validatorFor(questionSchema(true));
+  const questionRequestSchema = questionSchema();
+  const asker = identity === void 0 ? void 0 : questionAsker(identity);
+  function questionAsker(id) {
+    return {
+      generatedBy: `${id.provider}/${id.model}`,
+      ask: async (request, chunk) => {
+        const key = questionCacheKey(id.provider, id.model, chunk, request);
+        const hit = cache.get(key);
+        if (hit !== void 0 && questionValidator(hit)) return hit;
+        if (maxTurns !== null && turnsUsed >= maxTurns) return void 0;
+        turnsUsed++;
+        const run = await completeValidatedJSON({
+          provider: getProvider(),
+          system: QUESTION_SYSTEM_PROMPT,
+          user: buildQuestionPrompt(request, chunk),
+          schema: questionRequestSchema,
+          validate: questionValidator,
+          temperature: config.fill.temperature
+        });
+        if (run.result === void 0) {
+          throw new Error(run.error ?? "provider returned no questions");
+        }
+        cache.set(key, run.result);
+        return run.result;
+      }
+    };
+  }
+  let terms;
+  const termsOnce = () => terms ??= (async () => {
+    const source = termLabelSource();
+    if (!config.build.derive.includes("terms") || source === void 0) return void 0;
+    try {
+      return termIndex(
+        await source({
+          cwd,
+          ...opts.config === void 0 ? {} : { configPath: opts.config },
+          ...opts.noConfig === true ? { noConfig: true } : {}
+        })
+      );
+    } catch {
+      return void 0;
+    }
+  })();
+  async function conceptsOf(data) {
+    const strings = (v) => typeof v === "string" ? [v] : Array.isArray(v) ? v.filter((s) => typeof s === "string") : [];
+    const block = data[GRAPH_KEY2];
+    const graph = block !== null && typeof block === "object" && !Array.isArray(block) ? block : {};
+    const out = /* @__PURE__ */ new Map();
+    for (const label of strings(graph["label"])) out.set(label, strings(graph["alt-labels"]));
+    const named = strings(graph["concepts"] ?? data["concepts"]);
+    const index = named.length > 0 ? await termsOnce() : void 0;
+    const language = typeof data["language"] === "string" ? canonicalLanguage(data["language"]) : void 0;
+    for (const label of named) {
+      const id = index?.resolve(label, language);
+      const group = id === void 0 ? void 0 : index?.groups.get(id);
+      const term = group?.find((t) => canonicalLanguage(t.language) === language) ?? group?.[0];
+      if (term === void 0) out.set(label, out.get(label) ?? []);
+      else out.set(term.label, [...term.altLabels ?? []]);
+    }
+    return [...out].map(([label, altLabels]) => ({ label, altLabels }));
+  }
   for (const path2 of files) {
     const absPath = resolve6(base2, path2);
     let content;
@@ -2189,7 +2197,7 @@ async function runFill(opts = {}) {
       );
     }
     try {
-      results.push(await fillOne(path2, absPath, content));
+      results.push(await fillPage(path2, absPath, content));
     } catch (e) {
       results.push({
         path: path2,
@@ -2204,7 +2212,7 @@ async function runFill(opts = {}) {
   let stdinDocument;
   if (stdinContent !== void 0) {
     try {
-      const result = await fillOne(STDIN_PATH, void 0, stdinContent);
+      const result = await fillPage(STDIN_PATH, void 0, stdinContent);
       results.push(result);
       stdinDocument = result.filledContent ?? stdinContent;
       Reflect.deleteProperty(result, "filledContent");
@@ -2219,6 +2227,32 @@ async function runFill(opts = {}) {
       });
     }
   }
+  if (withQuestions) {
+    for (const label of config.questionFiles) {
+      const repinned = repinQuestionFile(
+        resolve6(config.configDir, label),
+        label,
+        config.configDir,
+        opts.dryRun ?? false
+      );
+      warnings.push(...repinned.warnings);
+      results.push({
+        path: label,
+        status: repinned.changed ? opts.dryRun ? "proposed" : "filled" : "complete",
+        fields: repinned.changed ? [QUESTIONS_KEY] : [],
+        preserved: [],
+        cached: false,
+        ...repinned.outcomes.length > 0 ? { questions: repinned.outcomes } : {}
+      });
+    }
+  }
+  if (offline && identity === void 0 && results.some((r) => r.reason === OFFLINE_REASON)) {
+    warnings.push(
+      noOfflineModel(
+        withQuestions ? "only answer pins were updated, and nothing was drafted or proposed" : "nothing was proposed"
+      )
+    );
+  }
   if (sectionsUnrecorded.length > 0) {
     warnings.push(
       "Section metadata was written but is NOT recorded in meta-provenance: /graph/sections is one of the three hand-curated pointers graph refuses, with /graph/revision-of and /graph/derived-from, so recording it would make `manni graph check` report an error. Review section values by hand \u2014 the review queue will not list them."
@@ -2233,6 +2267,45 @@ async function runFill(opts = {}) {
     exitCode: hasErrors ? 1 : 0,
     ...stdinDocument === void 0 ? {} : { stdinDocument }
   };
+  async function fillPage(path2, absPath, content) {
+    const { after, merged, ...result } = await fillOne(path2, absPath, content);
+    if (!withQuestions) return result;
+    const pageFormat = formatOf(path2, format);
+    const data = metadataOf(merged ?? mergedTexts.get(path2) ?? content, path2, pageFormat).data;
+    const pass = await fillPageQuestions({
+      path: path2,
+      format: pageFormat,
+      content: after ?? content,
+      title: typeof data["title"] === "string" ? data["title"] : path2,
+      concepts: () => conceptsOf(data),
+      settings: questionSettings,
+      asker,
+      known
+    });
+    warnings.push(...pass.warnings);
+    const outcomes = pass.outcomes.length > 0 ? { questions: pass.outcomes } : {};
+    if (pass.state === "changed") {
+      if (!opts.dryRun) {
+        if (absPath === void 0) result.filledContent = pass.content;
+        else writeFileSync3(absPath, pass.content, "utf8");
+      }
+      return {
+        ...result,
+        status: opts.dryRun ? "proposed" : "filled",
+        fields: [...result.fields, QUESTIONS_KEY],
+        ...pass.skipped === void 0 ? {} : { reason: pass.skipped },
+        ...outcomes
+      };
+    }
+    const idle = result.status === "complete" || result.status === "nothing-proposed";
+    if (idle && pass.state === "skipped") {
+      return { ...result, status: "skipped", ...pass.skipped === void 0 ? {} : { reason: pass.skipped }, ...outcomes };
+    }
+    if (result.status === "complete" && pass.state === "unchanged") {
+      return { ...result, status: "nothing-proposed", ...outcomes };
+    }
+    return { ...result, ...outcomes };
+  }
   async function fillOne(path2, absPath, content) {
     const pageFormat = formatOf(path2, format);
     if ((pageFormat === "markdown" || pageFormat === "mdx") && frontmatterKind(content) === "unsupported") {
@@ -2262,7 +2335,7 @@ async function runFill(opts = {}) {
       heldGraph !== null && typeof heldGraph === "object" && !Array.isArray(heldGraph) ? Object.keys(heldGraph) : []
     );
     const missing = opts.force ? fields : fields.filter((f) => !present.has(f));
-    if (missing.length === 0 && !withSections) {
+    if (fields.length === 0 || missing.length === 0 && !withSections) {
       return {
         path: path2,
         status: "complete",
@@ -2271,6 +2344,16 @@ async function runFill(opts = {}) {
         cached: false
       };
     }
+    if (identity === void 0) {
+      return {
+        path: path2,
+        status: "skipped",
+        reason: OFFLINE_REASON,
+        fields: [],
+        preserved: [],
+        cached: false
+      };
+    }
     const key = cacheKey(
       identity.provider,
       identity.model,
@@ -2321,15 +2404,15 @@ async function runFill(opts = {}) {
     const unknownSlugs = [];
     if (withSections) {
       const realSlugs = new Set(doc().sections.map((s) => s.slug));
-      for (const entry2 of Array.isArray(proposal["sections"]) ? proposal["sections"] : []) {
-        const slug = typeof entry2["slug"] === "string" ? entry2["slug"] : "";
+      for (const entry of Array.isArray(proposal["sections"]) ? proposal["sections"] : []) {
+        const slug = typeof entry["slug"] === "string" ? entry["slug"] : "";
         if (!realSlugs.has(slug)) {
           if (slug) unknownSlugs.push(slug);
           continue;
         }
-        const entryConfidence = numberMap(entry2["confidence"]);
-        const entryReasoning = stringMap(entry2["reasoning"]);
-        for (const [field, value] of Object.entries(entry2)) {
+        const entryConfidence = numberMap(entry["confidence"]);
+        const entryReasoning = stringMap(entry["reasoning"]);
+        for (const [field, value] of Object.entries(entry)) {
           if (!SECTION_FILL_FIELDS.includes(field)) continue;
           if (!fields.includes(field)) continue;
           const name = `sections.${slug}.${field}`;
@@ -2401,7 +2484,7 @@ async function runFill(opts = {}) {
         const c = confidence[f];
         return {
           name,
-          confidence: c === void 0 ? priorConfidence[name] ?? 0 : round2(c)
+          confidence: c === void 0 ? priorConfidence[name] ?? 0 : round22(c)
         };
       });
       const unscored = recordable.map((f) => [f, graphPointer(f)]).filter(
@@ -2474,7 +2557,7 @@ async function runFill(opts = {}) {
     }
     const manifests = await spliceAll(manifestWrites);
     if (!opts.dryRun && absPath !== void 0) {
-      if (pageContent !== content) writeFileSync2(absPath, pageContent, "utf8");
+      if (pageContent !== content) writeFileSync3(absPath, pageContent, "utf8");
       for (const m of manifests) {
         if (m.text !== m.before) {
           await writeFileAtomic(m.absPath, m.text, { createParents: true });
@@ -2483,6 +2566,8 @@ async function runFill(opts = {}) {
     }
     guard?.commit(path2, applied.content);
     return {
+      after: pageContent,
+      merged: applied.content,
       path: path2,
       status: opts.dryRun ? "proposed" : "filled",
       fields: reportedFields,
@@ -2573,6 +2658,17 @@ async function openMetaViewPerPage(source, cwd, paths, base2, failures) {
     return openMetaView(source, cwd, readable, base2);
   }
 }
+function questionLine(q) {
+  const score2 = q.confidence === void 0 ? "" : ` (${q.confidence.toFixed(2)})`;
+  let detail;
+  if (q.reason !== void 0) {
+    detail = `${q.reason}${q.reason.startsWith("low confidence") ? score2 : ""}`;
+  } else {
+    const where = `${q.file === void 0 ? "" : `${q.file} `}lines ${q.from ?? q.lines ?? ""}`;
+    detail = q.action === "re-pinned" ? `${where}${q.from === void 0 || q.lines === void 0 ? "" : ` to ${q.lines}`}` : `${where}${score2}`;
+  }
+  return `${q.action.padEnd(11)}"${q.question}"  ${detail}`;
+}
 function renderFill(report, format) {
   if (format === "json") {
     return JSON.stringify({ ...report, stdinDocument: void 0 }, null, 2);
@@ -2608,6 +2704,7 @@ function renderFill(report, format) {
         lines.push(`error     ${r.path}: ${r.error ?? ""}`);
         break;
     }
+    for (const q of r.questions ?? []) lines.push(`            ${questionLine(q)}`);
   }
   if (report.maxTurns !== null && report.results.some((r) => r.status === "skipped")) {
     lines.push(
@@ -2620,196 +2717,10 @@ function renderFill(report, format) {
 
 // src/graph/commands/embed.ts
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
 import path, { dirname as dirname2, join as join2, resolve as resolve7 } from "node:path";
-
-// src/graph/core/vector-index.ts
-var MAGIC = new Uint8Array([77, 71, 82, 86]);
-var FORMAT_VERSION = 2;
-var HEADER_OFFSET = 12;
-var VectorIndexError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "VectorIndexError";
-  }
-};
-function normalize(vector) {
-  let sum = 0;
-  for (const value of vector) sum += value * value;
-  if (sum === 0) return vector;
-  const inv = 1 / Math.sqrt(sum);
-  vector.set(vector.map((value) => value * inv));
-  return vector;
-}
-function encodeVectorIndex(entries, meta) {
-  const sorted = [...entries].sort((a, b) => byCodeUnit(a.id, b.id));
-  const dims = sorted[0]?.vector.length ?? 0;
-  for (const entry2 of sorted) {
-    if (entry2.vector.length !== dims) {
-      throw new VectorIndexError(
-        `Inconsistent vector dimensions: ${entry2.id} has ${entry2.vector.length}, expected ${dims}.`
-      );
-    }
-  }
-  const header = {
-    model: meta.model,
-    dtype: meta.dtype,
-    dims,
-    count: sorted.length,
-    ids: sorted.map((e) => e.id),
-    source: meta.source,
-    language: meta.language
-  };
-  const headerBytes = new TextEncoder().encode(JSON.stringify(header));
-  const payloadBytes = sorted.length * dims * 4;
-  const out = new Uint8Array(HEADER_OFFSET + headerBytes.length + payloadBytes);
-  const view = new DataView(out.buffer);
-  out.set(MAGIC, 0);
-  view.setUint32(4, FORMAT_VERSION, true);
-  view.setUint32(8, headerBytes.length, true);
-  out.set(headerBytes, HEADER_OFFSET);
-  let offset = HEADER_OFFSET + headerBytes.length;
-  for (const entry2 of sorted) {
-    const vector = normalize(Float32Array.from(entry2.vector));
-    for (const value of vector) {
-      view.setFloat32(offset, value, true);
-      offset += 4;
-    }
-  }
-  return out;
-}
-function decodeVectorIndex(bytes) {
-  if (bytes.length < HEADER_OFFSET) {
-    throw new VectorIndexError("Not a manni graph vector index: file is too short.");
-  }
-  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-  if (!MAGIC.every((byte, i) => bytes[i] === byte)) {
-    throw new VectorIndexError(
-      "Not a manni graph vector index: bad magic \u2014 is this the right file?"
-    );
-  }
-  const version = view.getUint32(4, true);
-  if (version !== FORMAT_VERSION) {
-    throw new VectorIndexError(
-      `Unsupported vector index version ${version} (this build reads ${FORMAT_VERSION}) \u2014 re-run \`manni graph embed\`.`
-    );
-  }
-  const headerLength = view.getUint32(8, true);
-  if (HEADER_OFFSET + headerLength > bytes.length) {
-    throw new VectorIndexError("Vector index is truncated: header overruns.");
-  }
-  let header;
-  try {
-    header = JSON.parse(
-      new TextDecoder().decode(
-        bytes.subarray(HEADER_OFFSET, HEADER_OFFSET + headerLength)
-      )
-    );
-  } catch {
-    throw new VectorIndexError("Vector index header is not valid JSON.");
-  }
-  if (!Array.isArray(header.ids) || typeof header.dims !== "number" || header.ids.length !== header.count) {
-    throw new VectorIndexError("Vector index header is malformed.");
-  }
-  const start = HEADER_OFFSET + headerLength;
-  const expected = header.count * header.dims * 4;
-  if (bytes.length - start !== expected) {
-    throw new VectorIndexError(
-      `Vector index is truncated: expected ${expected} payload bytes, found ${bytes.length - start}.`
-    );
-  }
-  const vectors = new Float32Array(header.count * header.dims);
-  for (let i = 0; i < vectors.length; i++) {
-    vectors[i] = view.getFloat32(start + i * 4, true);
-  }
-  return { header, vectors };
-}
-
-// src/graph/embed/local.ts
-var EmbedderUnavailableError = class extends Error {
-  constructor(detail) {
-    super(
-      `Local embeddings need @huggingface/transformers, which is an optional peer dependency.
-  Install it:  npm install @huggingface/transformers
-  (${detail})`
-    );
-    this.name = "EmbedderUnavailableError";
-  }
-};
-async function loadTransformers(injected) {
-  if (injected) return injected;
-  try {
-    return await import("@huggingface/transformers");
-  } catch (e) {
-    throw new EmbedderUnavailableError(
-      errorMessage(e)
-    );
-  }
-}
-async function createLocalEmbedder(options = {}) {
-  const model = options.model ?? DEFAULT_MODEL;
-  const dtype = options.dtype ?? "q8";
-  const role = options.role ?? "passage";
-  const profile = profileFor(model);
-  const transformers = await loadTransformers(options.transformers);
-  if (transformers.env?.backends?.onnx?.wasm) {
-    transformers.env.backends.onnx.wasm.numThreads = 1;
-  }
-  const extractor = await transformers.pipeline("feature-extraction", model, {
-    // No `device`: its accepted values are disjoint across platforms, so any
-    // hardcoded choice throws on one of them (ADR 01025).
-    ...options.device === void 0 ? {} : { device: options.device },
-    dtype
-  });
-  let dims = 0;
-  return {
-    model,
-    dtype,
-    get dims() {
-      return dims;
-    },
-    async embed(text) {
-      const output = await extractor(withPrefix(profile, role, text), {
-        pooling: "mean",
-        normalize: true
-      });
-      const data = Float32Array.from(output.data);
-      dims = data.length;
-      return data;
-    }
-  };
-}
-
-// src/graph/embed/mock.ts
-function fnv1a(text, seed) {
-  let hash = (2166136261 ^ seed) >>> 0;
-  for (let i = 0; i < text.length; i++) {
-    hash = (hash ^ text.charCodeAt(i)) >>> 0;
-    hash = hash + ((hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24)) >>> 0;
-  }
-  return hash >>> 0;
-}
-function createMockEmbedder(options = {}) {
-  const dims = options.dims ?? 8;
-  const model = options.model ?? "mock";
-  const dtype = options.dtype ?? "mock";
-  return {
-    model,
-    dtype,
-    dims,
-    embed(text) {
-      const vector = new Float32Array(dims);
-      for (let i = 0; i < dims; i++) {
-        vector[i] = fnv1a(text, i) / 4294967296 * 2 - 1;
-      }
-      return Promise.resolve(vector);
-    }
-  };
-}
-
-// src/graph/commands/embed.ts
-function embedText(entry2) {
-  return [entry2.title, entry2.labels, entry2.description, entry2.text].filter((part) => part !== void 0 && part !== "").join("\n\n");
+function embedText(entry) {
+  return [entry.title, entry.labels, entry.description, entry.text].filter((part) => part !== void 0 && part !== "").join("\n\n");
 }
 function sha2562(text) {
   return createHash2("sha256").update(text, "utf8").digest("hex");
@@ -2838,7 +2749,7 @@ var VectorCache = class {
   set(key, vector) {
     if (!this.enabled) return;
     mkdirSync2(this.dir, { recursive: true });
-    writeFileSync3(this.path(key), JSON.stringify([...vector]), "utf8");
+    writeFileSync4(this.path(key), JSON.stringify([...vector]), "utf8");
   }
 };
 async function makeEmbedder(opts, model, dtype) {
@@ -2906,8 +2817,8 @@ async function runEmbed(opts = {}) {
   };
   const languages = [];
   const updated = [];
-  for (const entry2 of manifest.languages) {
-    const indexPath = join2(indexDir, entry2.search.path);
+  for (const entry of manifest.languages) {
+    const indexPath = join2(indexDir, entry.search.path);
     if (!existsSync3(indexPath)) {
       throw new GraphError(
         `Search index not found: ${indexPath} \u2014 the manifest names it; re-run \`manni graph export search\`.`
@@ -2915,9 +2826,9 @@ async function runEmbed(opts = {}) {
     }
     const raw = readFileSync5(indexPath, "utf8");
     const source = `sha256:${sha2562(raw)}`;
-    if (entry2.search.digest !== source) {
+    if (entry.search.digest !== source) {
       throw new GraphError(
-        `Stale manifest: ${entry2.search.path} does not match the digest recorded for "${entry2.language}" \u2014 re-run \`manni graph export search\`.`
+        `Stale manifest: ${entry.search.path} does not match the digest recorded for "${entry.language}" \u2014 re-run \`manni graph export search\`.`
       );
     }
     let parsed;
@@ -2934,7 +2845,7 @@ async function runEmbed(opts = {}) {
         `Not a manni graph search index: ${indexPath} \u2014 expected an \`entries\` array.`
       );
     }
-    const wanted = canonicalLanguageTag(entry2.language);
+    const wanted = canonicalLanguageTag(entry.language);
     const perLanguage = Object.entries(config.embed.byLanguage).find(
       ([tag]) => canonicalLanguageTag(tag) === wanted
     )?.[1];
@@ -2960,21 +2871,21 @@ async function runEmbed(opts = {}) {
       }
       vectors.push({ id: item.id, vector });
     }
-    const filename = vectorIndexFilename(entry2.language);
+    const filename = vectorIndexFilename(entry.language);
     const outPath = join2(outDir, filename);
     const manifestRelative = manifestRelativePath(indexDir, outPath);
-    writeFileSync3(
+    writeFileSync4(
       outPath,
       encodeVectorIndex(vectors, {
         model: identity.model,
         dtype: identity.dtype,
         source,
-        language: entry2.language
+        language: entry.language
       })
     );
     const dims = vectors[0]?.vector.length ?? 0;
     languages.push({
-      language: entry2.language,
+      language: entry.language,
       outPath,
       model: identity.model,
       dims,
@@ -2983,7 +2894,7 @@ async function runEmbed(opts = {}) {
       total: vectors.length
     });
     updated.push({
-      ...entry2,
+      ...entry,
       vectors: {
         path: manifestRelative,
         model: identity.model,
@@ -2993,7 +2904,7 @@ async function runEmbed(opts = {}) {
       }
     });
   }
-  writeFileSync3(
+  writeFileSync4(
     manifestPath,
     emitLocalizations({ version: 1, languages: updated }),
     "utf8"
@@ -3022,397 +2933,8 @@ function renderEmbed(report, format) {
   ].join("\n");
 }
 
-// src/graph/commands/search.ts
-import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync4, readFileSync as readFileSync6 } from "node:fs";
-import { dirname as dirname3, join as join3, resolve as resolve8 } from "node:path";
-
-// src/graph/runtime/vector.ts
-var VectorMismatchError = class extends Error {
-  reason;
-  constructor(mismatch) {
-    super(mismatch.detail);
-    this.name = "VectorMismatchError";
-    this.reason = mismatch.reason;
-  }
-};
-async function searchIndexDigest2(raw) {
-  const webCrypto = globalThis.crypto;
-  const subtle = webCrypto?.subtle;
-  if (!subtle) {
-    throw new Error(
-      "searchIndexDigest needs Web Crypto (globalThis.crypto.subtle), which is unavailable here \u2014 a page served over plain HTTP does not get it."
-    );
-  }
-  const digest = await subtle.digest("SHA-256", new TextEncoder().encode(raw));
-  const hex = [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
-  return `sha256:${hex}`;
-}
-function createVectorIndex(bytes) {
-  const { header, vectors } = decodeVectorIndex(bytes);
-  const { dims, ids } = header;
-  return {
-    model: header.model,
-    dtype: header.dtype,
-    dims,
-    source: header.source,
-    size: () => ids.length,
-    idAt: (row) => ids[row],
-    check(expected) {
-      if (expected.model !== void 0 && expected.model !== header.model) {
-        return {
-          reason: "model",
-          detail: `Vector index was built with ${header.model}, but the embedder is ${expected.model}. Re-run \`manni graph embed\`.`
-        };
-      }
-      if (expected.dtype !== void 0 && expected.dtype !== header.dtype) {
-        return {
-          reason: "dtype",
-          detail: `Vector index was built at dtype ${header.dtype}, but the embedder is at ${expected.dtype} \u2014 different weights are a different function. Re-run \`manni graph embed\`.`
-        };
-      }
-      if (expected.dims !== void 0 && expected.dims !== dims) {
-        return {
-          reason: "dims",
-          detail: `Vector index has ${dims} dimensions, but the embedder produces ${expected.dims}.`
-        };
-      }
-      if (expected.source !== void 0 && expected.source !== header.source) {
-        return {
-          reason: "stale-source",
-          detail: "Vector index was built from a different search index \u2014 the corpus changed. Re-run `manni graph embed`."
-        };
-      }
-      return void 0;
-    },
-    search(query, options = {}) {
-      if (dims === 0 || ids.length === 0) return [];
-      if (query.length !== dims) {
-        throw new VectorMismatchError({
-          reason: "dims",
-          detail: `Query vector has ${query.length} dimensions, but the index has ${dims}.`
-        });
-      }
-      const limit = normalizeLimit(options.limit);
-      if (limit === 0) return [];
-      const minScore = options.minScore ?? 0;
-      const q = normalize(Float32Array.from(query));
-      const scored = [];
-      for (const [row, iri2] of ids.entries()) {
-        const stored = vectors.subarray(row * dims, (row + 1) * dims);
-        let score = 0;
-        for (const [i, value] of q.entries()) score += value * (stored[i] ?? 0);
-        if (score >= minScore) {
-          scored.push({ iri: iri2, score, via: "vector" });
-        }
-      }
-      scored.sort(
-        (a, b) => a.score === b.score ? byCodeUnit(a.iri, b.iri) : b.score - a.score
-      );
-      return scored.slice(0, limit);
-    }
-  };
-}
-function normalizeLimit(limit) {
-  return typeof limit === "number" && Number.isInteger(limit) && limit >= 0 ? limit : 10;
-}
-
-// src/graph/runtime/trace.ts
-function createTrace() {
-  return { entry: [], hops: [], exclusions: [], resolutions: [] };
-}
-function reachedNodes(trace) {
-  const reached = /* @__PURE__ */ new Set();
-  for (const e of trace.entry) reached.add(e.iri);
-  for (const h of trace.hops) reached.add(h.to);
-  return reached;
-}
-
-// src/graph/runtime/entry.ts
-function rrfMerge(rankings, k = 60) {
-  const fused = /* @__PURE__ */ new Map();
-  for (const ranking of rankings) {
-    ranking.forEach((candidate, i) => {
-      const current = fused.get(candidate.iri) ?? {
-        score: 0,
-        vias: /* @__PURE__ */ new Set()
-      };
-      current.score += 1 / (k + i + 1);
-      current.vias.add(candidate.via);
-      fused.set(candidate.iri, current);
-    });
-  }
-  return [...fused.entries()].map(([iri2, { score, vias }]) => {
-    const [only] = vias;
-    return {
-      iri: iri2,
-      score,
-      via: vias.size === 1 && only !== void 0 ? only : "hybrid"
-    };
-  }).sort(
-    (a, b) => a.score === b.score ? byCodeUnit(a.iri, b.iri) : b.score - a.score
-  );
-}
-async function findEntry(query, options) {
-  const trace = options.trace ?? createTrace();
-  const limit = typeof options.limit === "number" && Number.isInteger(options.limit) && options.limit >= 0 ? options.limit : 10;
-  const lexical = options.lexical.search(query, { limit });
-  const embedder = options.embedder;
-  const embed = embedder ? (q) => embedder.embed(q) : options.embedQuery;
-  let vector = [];
-  if (options.vectors && embed && query.trim() !== "") {
-    const mismatch = options.vectors.check({
-      ...options.embedder ? { model: options.embedder.model, dtype: options.embedder.dtype } : {},
-      // Staleness is checked whichever way the query is embedded — it is a
-      // property of the corpus, not of the embedder, so even the unverified
-      // `embedQuery` path gets it when the caller supplies a digest.
-      ...options.source === void 0 ? {} : { source: options.source }
-    });
-    if (mismatch) throw new VectorMismatchError(mismatch);
-    const queryVector = await embed(query);
-    vector = options.vectors.search(queryVector, { limit });
-  }
-  const rankings = vector.length > 0 ? [lexical, vector] : [lexical];
-  const candidates = rrfMerge(rankings).slice(0, limit);
-  for (const candidate of candidates) trace.entry.push(candidate);
-  return { candidates, lexical, vector, trace };
-}
-
-// src/graph/runtime/lexical.ts
-import MiniSearch from "minisearch";
-function createLexicalIndex(input) {
-  const doc = typeof input === "string" ? JSON.parse(input) : input;
-  const entries = Array.isArray(doc?.entries) ? doc.entries : [];
-  const mini = new MiniSearch({
-    fields: ["title", "labels", "description", "text"],
-    storeFields: ["id"],
-    idField: "id",
-    // Titles and labels are the strongest signal that a node *is* the subject;
-    // body text is evidence it merely mentions it.
-    searchOptions: {
-      boost: { title: 3, labels: 2, description: 1.5 },
-      prefix: true,
-      fuzzy: 0.2
-    }
-  });
-  mini.addAll(entries);
-  const byIri = new Map(entries.map((e) => [e.id, e]));
-  return {
-    size: () => entries.length,
-    entry: (iri2) => byIri.get(iri2),
-    search(query, options = {}) {
-      const trimmed = query.trim();
-      if (trimmed === "") return [];
-      const hits = mini.search(trimmed);
-      hits.sort(
-        (a, b) => a.score === b.score ? byCodeUnit(String(a.id), String(b.id)) : b.score - a.score
-      );
-      return hits.slice(0, options.limit ?? 10).map((h) => ({ iri: String(h.id), score: h.score, via: "lexical" }));
-    }
-  };
-}
-
-// src/graph/commands/search.ts
-var SEARCH_MODES = ["lexical", "hybrid", "vector"];
-function loadSearchIndex(indexPath) {
-  const raw = readFileSync6(indexPath, "utf8");
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch (e) {
-    throw new GraphError(
-      `Failed to parse ${indexPath}: ${errorMessage(e)} \u2014 re-run \`manni graph export search\`.`
-    );
-  }
-  const entries = parsed?.entries;
-  if (!Array.isArray(entries)) {
-    throw new GraphError(
-      `Not a manni graph search index: ${indexPath} \u2014 expected an \`entries\` array; re-run \`manni graph export search\`.`
-    );
-  }
-  return {
-    doc: parsed,
-    // Same recipe `manni graph embed` uses, so the two digests are comparable.
-    source: `sha256:${createHash3("sha256").update(raw, "utf8").digest("hex")}`
-  };
-}
-function resolveLocalization(indexDir, lang) {
-  const manifestPath = join3(indexDir, LOCALIZATIONS_FILENAME);
-  if (!existsSync4(manifestPath)) {
-    throw new GraphError(
-      `Localization manifest not found: ${manifestPath} \u2014 run \`manni graph export search\` first.`
-    );
-  }
-  const manifest = parseLocalizations(readFileSync6(manifestPath, "utf8"));
-  if (!manifest) {
-    throw new GraphError(
-      `Not a manni graph localization manifest: ${manifestPath} \u2014 re-run \`manni graph export search\`.`
-    );
-  }
-  const available = manifest.languages.map((l) => l.language);
-  if (lang !== void 0) {
-    const wanted = canonicalLanguageTag(lang);
-    const hit = manifest.languages.find(
-      (l) => canonicalLanguageTag(l.language) === wanted
-    );
-    if (!hit) {
-      throw new GraphError(
-        `No index for language "${lang}" \u2014 this corpus has ${available.join(", ") || "none"}.`
-      );
-    }
-    return hit;
-  }
-  const only = manifest.languages[0];
-  if (!only) {
-    throw new GraphError(
-      `The localization manifest lists no languages: ${manifestPath} \u2014 re-run \`manni graph export search\`.`
-    );
-  }
-  if (manifest.languages.length > 1) {
-    throw new GraphError(
-      `This corpus has more than one localization (${available.join(", ")}) \u2014 pass --lang to choose one.`
-    );
-  }
-  return only;
-}
-async function runSearch(opts) {
-  const cwd = opts.cwd ?? process.cwd();
-  const config = loadRunConfig(
-    {
-      ...opts.config === void 0 ? {} : { configPath: opts.config },
-      ...opts.noConfig === void 0 ? {} : { noConfig: opts.noConfig }
-    },
-    cwd
-  );
-  const graphPath = resolve8(cwd, opts.graph ?? config.out);
-  const indexDir = opts.index ? resolve8(cwd, opts.index) : dirname3(graphPath);
-  const localization = resolveLocalization(indexDir, opts.lang);
-  const indexPath = join3(indexDir, localization.search.path);
-  if (!existsSync4(indexPath)) {
-    throw new GraphError(
-      `Search index not found: ${indexPath} \u2014 the manifest names it; re-run \`manni graph export search\`.`
-    );
-  }
-  const { doc, source } = loadSearchIndex(indexPath);
-  if (localization.search.digest !== source) {
-    throw new GraphError(
-      `Stale manifest: ${localization.search.path} does not match the digest recorded for "${localization.language}". Re-run \`manni graph export search\`.`
-    );
-  }
-  const lexical = createLexicalIndex(doc);
-  const explicitVectors = opts.vectors !== void 0 && opts.vectors !== "" ? opts.vectors : void 0;
-  const wantsVector = opts.mode === "vector" || opts.mode === "hybrid" || explicitVectors !== void 0 && opts.mode !== "lexical";
-  const vectorsPath = explicitVectors ? resolve8(cwd, explicitVectors) : localization.vectors ? resolve8(indexDir, localization.vectors.path) : void 0;
-  let vectors;
-  if (opts.mode !== "lexical" && vectorsPath !== void 0 && existsSync4(vectorsPath)) {
-    try {
-      vectors = createVectorIndex(readFileSync6(vectorsPath));
-    } catch (e) {
-      if (e instanceof VectorIndexError) {
-        throw new GraphError(
-          `${e.message} (${vectorsPath}) \u2014 re-run \`manni graph embed\`, or use \`--mode lexical\`.`
-        );
-      }
-      throw e;
-    }
-    const stale = vectors.check({ source });
-    if (stale && wantsVector) throw new GraphError(stale.detail);
-    if (stale) {
-      warn(`${stale.detail} Falling back to lexical.`);
-      vectors = void 0;
-    }
-  } else if (wantsVector) {
-    const named = vectorsPath ?? `no sidecar recorded for "${localization.language}"`;
-    throw new GraphError(
-      `Vector index not found: ${named} \u2014 run \`manni graph embed\` first, or use \`--mode lexical\`.`
-    );
-  }
-  let embedder;
-  if (vectors) {
-    const requireEmbedder = opts.mode === "vector" || opts.mode === "hybrid";
-    embedder = await resolveEmbedder(opts, vectors, requireEmbedder);
-  }
-  const entry2 = await findEntry(opts.query, {
-    lexical,
-    // Pass the embedder, not a bare function: findEntry then verifies it
-    // against the index itself rather than trusting the CLI to have done so.
-    ...embedder && vectors ? { vectors, embedder } : {},
-    limit: opts.limit
-  }).catch((e) => {
-    if (e instanceof VectorMismatchError) {
-      throw new GraphError(`${e.message} Re-run \`manni graph embed\`.`);
-    }
-    throw e;
-  });
-  const decorate = (c) => {
-    const found = lexical.entry(c.iri);
-    return {
-      iri: c.iri,
-      score: c.score,
-      via: c.via,
-      ...found?.type === void 0 ? {} : { type: found.type },
-      ...found?.title === void 0 ? {} : { title: found.title }
-    };
-  };
-  const mode = opts.mode ?? (embedder && vectors ? "hybrid" : "lexical");
-  const results = opts.mode === "vector" ? entry2.vector : entry2.candidates;
-  if (opts.mode === "vector") {
-    entry2.trace.entry.length = 0;
-    entry2.trace.entry.push(...entry2.vector);
-  }
-  return {
-    query: opts.query,
-    mode,
-    results: results.map(decorate),
-    lexical: entry2.lexical.map(decorate),
-    vector: entry2.vector.map(decorate),
-    trace: entry2.trace
-  };
-}
-async function resolveEmbedder(opts, vectors, required) {
-  const { model, dtype } = vectors;
-  try {
-    const embedder = opts.embedder ?? (model === "mock" ? createMockEmbedder({ dtype }) : await createLocalEmbedder({ model, dtype, role: "query" }));
-    const mismatch = vectors.check({
-      model: embedder.model,
-      dtype: embedder.dtype,
-      // Defense in depth: a future model that changes output size without
-      // changing its id would otherwise only surface deep inside search().
-      ...embedder.dims > 0 ? { dims: embedder.dims } : {}
-    });
-    if (mismatch) throw new GraphError(mismatch.detail);
-    return embedder;
-  } catch (e) {
-    if (e instanceof GraphError) throw e;
-    if (e instanceof EmbedderUnavailableError) {
-      if (required) throw new GraphError(e.message);
-      return void 0;
-    }
-    throw new GraphError(
-      `Failed to load embedding model ${model}: ${errorMessage(e)}`
-    );
-  }
-}
-function renderSearch(report, format) {
-  if (format === "json") return JSON.stringify(report, null, 2);
-  const lines = [];
-  for (const r of report.results) {
-    const label = r.title ? ` \u2014 ${r.title}` : "";
-    const type = r.type ? ` [${r.type}]` : "";
-    lines.push(`${r.score.toFixed(4)}  ${compactIri(r.iri)}${type}${label}`);
-  }
-  if (report.results.length === 0) {
-    lines.push("(no matches)");
-  }
-  lines.push("");
-  lines.push(
-    `${report.results.length} result${report.results.length === 1 ? "" : "s"} (${report.mode})`
-  );
-  return lines.join("\n");
-}
-
 // src/graph/commands/stats.ts
-import { resolve as resolve9 } from "node:path";
+import { resolve as resolve8 } from "node:path";
 import { DataFactory as DataFactory4 } from "n3";
 function subjectsOfType(store, typeIri) {
   return store.getQuads(null, DataFactory4.namedNode(RDF_TYPE), DataFactory4.namedNode(typeIri), null).map((q) => q.subject.value).sort();
@@ -3433,7 +2955,7 @@ function runStats(opts = {}) {
     },
     cwd
   );
-  const store = loadGraph(resolve9(cwd, opts.graph ?? config.out));
+  const store = loadGraph(resolve8(cwd, opts.graph ?? config.out));
   const top = opts.top ?? 5;
   const docIris = subjectsOfType(store, `${NS.graph}Document`);
   const docSet = new Set(docIris);
@@ -3538,8 +3060,18 @@ function runStats(opts = {}) {
       };
     })
   };
+  const asked = /* @__PURE__ */ new Set();
+  for (const q of store.getQuads(null, DataFactory4.namedNode(`${NS.graph}sampleQuestion`), null, null)) {
+    if (!docSet.has(q.subject.value)) continue;
+    for (const p of [`${NS.foaf}primaryTopic`, `${NS.dcterms}subject`]) {
+      for (const t of store.getQuads(q.subject, DataFactory4.namedNode(p), null, null)) {
+        asked.add(t.object.value);
+      }
+    }
+  }
+  const conceptsWithoutQuestions = subjectsOfType(store, `${NS.skos}Concept`).filter((c) => !asked.has(c)).sort(byCodeUnit);
   const uniform = opts.coverageThreshold;
-  const thresholds = uniform != null ? Object.fromEntries(coverage.map((c) => [c.field, uniform])) : config.stats.coverageThreshold;
+  const thresholds = uniform != null ? Object.fromEntries(UNIFORM_COVERAGE_FIELD_NAMES.map((f) => [f, uniform])) : config.stats.coverageThreshold;
   const coverageFindings = coverage.flatMap((c) => {
     const threshold = thresholds[c.field];
     if (threshold === void 0) return [];
@@ -3571,13 +3103,21 @@ function runStats(opts = {}) {
     coverage,
     sectionCoverage,
     localization,
+    conceptsWithoutQuestions,
+    conceptLabels: Object.fromEntries(
+      conceptsWithoutQuestions.map((c) => [c, conceptLabel(store, c)])
+    ),
     coverageFindings,
     exitCode: failed ? 1 : 0
   };
 }
+function conceptLabel(store, iri2) {
+  const labels = store.getQuads(DataFactory4.namedNode(iri2), DataFactory4.namedNode(`${NS.skos}prefLabel`), null, null).map((q) => q.object.value).sort(byCodeUnit);
+  return labels[0] ?? compactIri(iri2);
+}
 function renderStats(report, format) {
   if (format === "json") {
-    const { exitCode: _exitCode, ...rest } = report;
+    const { exitCode: _exitCode, conceptLabels: _labels, ...rest } = report;
     return JSON.stringify(rest, null, 2);
   }
   const lines = [
@@ -3639,16 +3179,22 @@ function renderStats(report, format) {
     }
     lines.push(`  no language: ${report.localization.unlabelled}`);
   }
+  if (report.concepts > 0) {
+    const unasked = report.conceptsWithoutQuestions;
+    lines.push("", `Concepts with no question (${String(unasked.length)}):`);
+    for (const c of unasked) lines.push(`  ${report.conceptLabels[c] ?? compactIri(c)}`);
+    if (unasked.length === 0) lines.push("  (none)");
+  }
   return lines.join("\n");
 }
 
 // src/graph/commands/traverse.ts
-import { resolve as resolve10 } from "node:path";
+import { resolve as resolve9 } from "node:path";
 
 // src/graph/runtime/traverse.ts
-var DCTERMS_TITLE3 = `${NS.dcterms}title`;
+var DCTERMS_TITLE = `${NS.dcterms}title`;
 var DCTERMS_REFERENCES = `${NS.dcterms}references`;
-var DCTERMS_LANGUAGE2 = `${NS.dcterms}language`;
+var DCTERMS_LANGUAGE = `${NS.dcterms}language`;
 function documentOf(iri2) {
   const hash = iri2.indexOf("#");
   return hash === -1 ? iri2 : iri2.slice(0, hash);
@@ -3658,7 +3204,7 @@ function resolveVariant(graph, input) {
   const wanted = input.toLowerCase();
   const variants = graph.instancesOf(`${NS.iirds}ProductVariant`);
   for (const v of variants) {
-    if (graph.literal(v, DCTERMS_TITLE3)?.toLowerCase() === wanted) return v;
+    if (graph.literal(v, DCTERMS_TITLE)?.toLowerCase() === wanted) return v;
   }
   for (const v of variants) {
     if (v.slice(v.lastIndexOf("/") + 1).toLowerCase() === wanted) return v;
@@ -3680,7 +3226,7 @@ function scopeExclusion(graph, iri2, scope) {
       "iri"
     ],
     [scope.subjectIri, IIRDS_HAS_SUBJECT, GRAPH_NOT_SOFTWARE_SUBJECT, "iri"],
-    [scope.language, DCTERMS_LANGUAGE2, void 0, "literal"]
+    [scope.language, DCTERMS_LANGUAGE, void 0, "literal"]
   ];
   for (const [target, positive, negative, kind] of checks) {
     if (!target) continue;
@@ -3688,7 +3234,7 @@ function scopeExclusion(graph, iri2, scope) {
       const denied = graph.values(iri2, negative).some((v) => v.kind === kind && v.value === target);
       if (denied) return { node: iri2, rule: negative, value: target };
     }
-    const subject = positive === DCTERMS_LANGUAGE2 ? documentOf(iri2) : iri2;
+    const subject = positive === DCTERMS_LANGUAGE ? documentOf(iri2) : iri2;
     const claimed = graph.values(subject, positive);
     if (claimed.length > 0) {
       const matches = claimed.some(
@@ -3807,7 +3353,7 @@ function runTraverse(opts) {
     },
     cwd
   );
-  const store = loadGraph(resolve10(cwd, opts.graph ?? config.out));
+  const store = loadGraph(resolve9(cwd, opts.graph ?? config.out));
   const quads = storeToQuads(store);
   const graph = GraphIndex.fromQuads(quads, Object.fromEntries(PREFIXES));
   const node = expandTerm(opts.node);
@@ -3897,19 +3443,6 @@ export {
   emitRdfXml,
   writeZip,
   projectPackage,
-  splitFragment,
-  documentSectionOrder,
-  sectionOccurrences,
-  sectionOccurrence,
-  documentPreamble,
-  sliceSection,
-  sectionOwnText,
-  createFetchResolver,
-  buildSearchIndex,
-  emitSearchIndex,
-  partitionByLanguage,
-  documentsByLanguage,
-  GraphIndex,
   EXPORT_TARGETS,
   runExport,
   runQuery,
@@ -3926,27 +3459,9 @@ export {
   makeProvider,
   runFill,
   renderFill,
-  VectorIndexError,
-  normalize,
-  encodeVectorIndex,
-  decodeVectorIndex,
-  EmbedderUnavailableError,
-  createLocalEmbedder,
-  createMockEmbedder,
   embedText,
   runEmbed,
   renderEmbed,
-  VectorMismatchError,
-  searchIndexDigest2 as searchIndexDigest,
-  createVectorIndex,
-  createTrace,
-  reachedNodes,
-  rrfMerge,
-  findEntry,
-  createLexicalIndex,
-  SEARCH_MODES,
-  runSearch,
-  renderSearch,
   runStats,
   renderStats,
   resolveVariant,
@@ -3958,4 +3473,4 @@ export {
   runTraverse,
   renderTraverse
 };
-//# sourceMappingURL=chunk-2DRHT73U.js.map
+//# sourceMappingURL=chunk-CVZMKWZ5.js.map