@konneal/engine 0.1.3 → 0.1.4

package/dist/pipeline.d.ts

@@ -18,6 +18,9 @@ export interface Retrieved {
      *  among them (dense retrieval alone binds everyday words to the wrong
      *  term: measured "keeps drifting" → creep 0.69 vs durability 0.54) */
     glossary?: GlossaryEntry[];
+    /** structured facts stages extracted from the graph (GraphRAG) —
+     *  merged into the answer prompt's retrieval note */
+    notes?: string[];
 }
 export declare function retrievalQuery(query: string, prev?: string): string;
 export declare function retrieve(env: any, query: string, opts?: RetrieveOptions): Promise<Retrieved>;

package/dist/prompts/understanding.md

@@ -6,6 +6,7 @@ Rules:
 - docidentifier: the publication the user names, in any spelling ({{SPELLING_EXAMPLES}}, "the nonautomatic weighing instruments recommendation" → resolve to the {{PUBLISHER_NAME}} identifier you can infer; include the part ("-1", "-2") only when clearly meant). docnumber is the base number without part.
 - edition: only when the user pins a year.
 - language: only when the user asks for a specific answer language; otherwise null (the corpus is English; answering in the user's language is handled elsewhere).
+- citation questions ("what does X cite/reference/list?", "which standards does X reference?"): ALWAYS include a query variant that names the document's bibliography or normative-references section explicitly, WITHOUT edition scoping (e.g. for "What ISO standards does R 60 cite?" generate BOTH "R 60 bibliography normative references" AND "R 60 2017 bibliography ISO IEC") — bibliographies embed differently than the query's phrasing, and prior editions may carry references the current edition dropped; set edition to null for these queries so retrieval covers the whole family.
 - process_intent: true when the question is about the GOVERNING SYSTEM around publications rather than a publication's own technical content — HOW to get certified/apply/comply, OR which framework/vocabulary/{{PROCESS_VOCAB}}. Naming a Recommendation (e.g. "R 60") inside such a question does NOT make it a technical-content question: leave process_intent true and still emit docnumber when named, but the retrieval path must NOT seal to that document alone.
 - term: the defined term when the question asks what something is ("what is an accuracy class" → "accuracy class"); otherwise null.
 - defined_terms: the ESTABLISHED metrology / VIM terms this question is about, in the corpus's own terminology, EVEN WHEN the question uses everyday wording instead — match the TIME SCALE and sense carefully: "does the reading drift while a weight sits on it" (short-term, under load) → ["creep"]; "output keeps drifting over months of use" (long-term, in service) → ["span stability", "durability"]; "how many scale divisions is it allowed" → ["number of verification intervals"]. This is a terminology mapping, not a copy of the question's words. Empty when nothing maps.

package/dist/worker_public/src/index.js

@@ -432,6 +432,226 @@ var dense = {
   }
 };
 
+// workers/worker_public/src/codecs.ts
+var oimlPubid = {
+  parse(doc, edition) {
+    const m = doc.match(/^urn:oiml:pub:([rdbge]):(\d{1,3})(?:-[0-9A-Za-z]+)?(?::(\d{4}))?$/i) ?? doc.match(/^(?:OIML\s+)?([RDBGE])\s*(\d{1,3})(?:-[0-9A-Za-z]+)?(?::(\d{4}))?$/i);
+    if (!m) return null;
+    const type = m[1].toUpperCase();
+    const ed = edition ?? m[3] ?? void 0;
+    return { doc_number: m[2], ...ed ? { edition: ed } : {}, label: `OIML ${type} ${m[2]}${ed ? `:${ed}` : ""}` };
+  },
+  scanQuestion(query) {
+    const re = /\b(OIML\s+)?([RDBGE])(\s*)0*(\d{1,3})(?:\s*[-–]\s*\d+)?(?:\s*:\s*(\d{4}))?/gi;
+    for (const m of query.matchAll(re)) {
+      const [, oimlPrefix, letter, gap, digits, edition] = m;
+      if (digits.length === 1 && !oimlPrefix && !gap) continue;
+      const num2 = String(Number(digits));
+      const type = letter.toUpperCase();
+      return { doc_number: num2, ...edition ? { edition } : {}, label: `OIML ${type} ${num2}${edition ? `:${edition}` : ""}` };
+    }
+    return null;
+  },
+  graphDocNumber(nodeId) {
+    const m = nodeId.match(/^doc:OIML-[A-Z]-(\d+)-/);
+    return m ? m[1] : null;
+  },
+  familyOf(di) {
+    const m = /^(?:OIML\s+)?([A-Z])\s?(\d{1,3})(?:[-–]([0-9A-Za-z]+))?/.exec(di);
+    return m ? `${m[1]}-${m[2]}` : null;
+  }
+};
+var plainSlug = {
+  parse: () => null,
+  scanQuestion: () => null,
+  graphDocNumber: () => null,
+  familyOf: () => null
+};
+var REGISTRY = {
+  "oiml-pubid": oimlPubid,
+  "plain-slug": plainSlug
+};
+function refCodec() {
+  return REGISTRY[P().publisher.codec] ?? plainSlug;
+}
+
+// workers/worker_public/src/context.ts
+var NO_CONTEXT = { kind: "none", scoped_to: null };
+function parseContext(body) {
+  const c = body?.context;
+  if (!c || typeof c !== "object") return null;
+  if (c.kind !== "page" && c.kind !== "entity" && c.kind !== "document" && c.kind !== "account") return null;
+  const label = typeof c.label === "string" ? c.label.trim().slice(0, 120) : "";
+  const route = typeof c.route === "string" && c.route.trim() ? c.route.trim().slice(0, 200) : void 0;
+  const doc = typeof c.doc === "string" && c.doc.trim() ? c.doc.trim().slice(0, 80) : void 0;
+  const edition = typeof c.edition === "string" && /^\d{4}$/.test(c.edition.trim()) ? c.edition.trim() : void 0;
+  return { kind: c.kind, label, ...route ? { route } : {}, ...doc ? { doc } : {}, ...edition ? { edition } : {} };
+}
+function parseDocRef(doc, edition) {
+  return refCodec().parse(doc, edition);
+}
+function namedDocumentIn(query) {
+  return refCodec().scanQuestion(query);
+}
+async function resolveDocScope(env, ctx) {
+  if (!ctx.doc) return null;
+  const parsed = parseDocRef(ctx.doc, ctx.edition);
+  if (!parsed) return null;
+  try {
+    const type = parsed.label.split(" ")[1];
+    const row = await env.DB.prepare("SELECT 1 FROM documents WHERE family = ?1 LIMIT 1").bind(`${type}-${parsed.doc_number}`).first();
+    if (!row) return null;
+  } catch {
+  }
+  return parsed;
+}
+function appliedContext(declared, scope, note, live) {
+  if (!declared) return NO_CONTEXT;
+  return {
+    kind: declared.kind,
+    label: declared.label,
+    scoped_to: scope ? scope.label : null,
+    ...note ? { note } : {},
+    ...live ? { live } : {}
+  };
+}
+function parseAppliedContext(v) {
+  if (!v || typeof v !== "object") return null;
+  if (v.kind !== "page" && v.kind !== "entity" && v.kind !== "document" && v.kind !== "account" && v.kind !== "none") return null;
+  const label = typeof v.label === "string" && v.label.trim() ? v.label.trim().slice(0, 120) : void 0;
+  const scoped = typeof v.scoped_to === "string" && v.scoped_to.trim() ? v.scoped_to.trim().slice(0, 80) : null;
+  const note = v.note === "document-not-in-corpus" || v.note === "question-document-wins" || v.note === "sign-in-required" || v.note === "live-window-expired" || v.note === "live-unavailable" ? v.note : void 0;
+  const live = v.live && typeof v.live === "object" && typeof v.live.read_at === "string" && Array.isArray(v.live.stores) && typeof v.live.records === "number" ? { read_at: v.live.read_at.slice(0, 40), stores: v.live.stores.filter((s) => typeof s === "string").slice(0, 8), records: Math.min(Math.max(0, v.live.records), 999) } : void 0;
+  const model = v.model && typeof v.model === "object" && typeof v.model.node_id === "string" && typeof v.model.kind === "string" && typeof v.model.standard === "string" ? {
+    node_id: v.model.node_id.slice(0, 120),
+    kind: v.model.kind.slice(0, 40),
+    standard: v.model.standard.slice(0, 40),
+    ...typeof v.model.clause === "string" && v.model.clause.trim() ? { clause: v.model.clause.slice(0, 120) } : {}
+  } : void 0;
+  return { kind: v.kind, ...label ? { label } : {}, scoped_to: scoped, ...note ? { note } : {}, ...live ? { live } : {}, ...model ? { model } : {} };
+}
+function contextNote(declared, scope) {
+  if (!declared) return void 0;
+  if (declared.kind === "account") {
+    return void 0;
+  }
+  if (declared.kind === "page") {
+    return `Context note: the user is viewing ${declared.label || "a page"}${declared.route ? ` (${declared.route})` : ""} in the ${P().publisher.product_name} platform. The passages come from the general corpus; frame procedural guidance for that page when relevant.`;
+  }
+  if (declared.kind === "entity") {
+    return scope ? `Context note: the user is asking about ${declared.label || "an entity"} \u2014 the passages are scoped to ${scope.label}, the publication that governs it. You do NOT have the entity's own data; answer what the publication requires and say when the question needs the record itself.` : `Context note: the user is asking about ${declared.label || "an entity"}. You do NOT have the entity's own data; answer from the corpus passages and say when the question needs the record itself.`;
+  }
+  return scope ? `Context note: the user scoped this question to ${scope.label} \u2014 the passages come from that publication. If they cannot answer the question, say so instead of drawing on other documents.` : `Context note: the user named ${declared.label || declared.doc || "a document"} as context, but it is not in the indexed corpus \u2014 answer from the general corpus and say the document was not found.`;
+}
+function syntheticUnderstanding(scope) {
+  return {
+    intent: "knowledge",
+    docidentifier: scope.label,
+    doc_number: scope.doc_number,
+    edition: scope.edition ?? null,
+    language: null,
+    process_intent: false,
+    term: null,
+    defined_terms: [],
+    standalone_query: "",
+    complexity: "simple",
+    query_variants: [],
+    sub_queries: [],
+    hypothetical_answer: "",
+    follow_ups: []
+  };
+}
+
+// workers/worker_public/src/stages/citationProbe.ts
+var CITE_PATTERN = /\b(?:cite[sd]?|citing|referenc(?:e|es|ed|ing)|list[s]?|quote[sd]?)\b/i;
+var REFS_PATTERN = /\b(?:standard|publication|document|normative|bibliograph)/i;
+function citationGraphNote(docLabel, rows, cap = 30) {
+  const bySrc = /* @__PURE__ */ new Map();
+  for (const r of rows) {
+    const key = r.edition && !r.docidentifier.includes(r.edition) ? `${r.docidentifier}:${r.edition}` : r.docidentifier;
+    let e = bySrc.get(key);
+    if (!e) bySrc.set(key, e = { active: !!r.active, labels: [] });
+    if (e.labels.length < cap && !e.labels.includes(r.label)) e.labels.push(r.label);
+  }
+  if (!bySrc.size) return "";
+  const lines = [...bySrc.entries()].sort((a, b) => Number(b[1].active) - Number(a[1].active)).map(([k, v]) => `- ${k}${v.active ? " (active edition)" : ""} cites: ${v.labels.join(", ")}`);
+  return [
+    `Citation graph (authoritative \u2014 extracted from the indexed bibliographies of ${docLabel}):`,
+    ...lines,
+    `When the question asks what ${docLabel} cites or references, answer from this list, name each standard exactly as listed, and cite the bibliography passage(s) provided in the context.`
+  ].join("\n");
+}
+var citationProbe = {
+  name: "citation-probe",
+  failure: "additive",
+  when: (c) => {
+    if (!CITE_PATTERN.test(c.query) || !REFS_PATTERN.test(c.query)) return false;
+    const named = namedDocumentIn(c.query);
+    if (!named) return false;
+    c.__citeDocNum = named.doc_number;
+    c.__citeFamily = refCodec().familyOf(named.label);
+    c.__citeLabel = named.label;
+    c.__citeEdition = named.edition ?? null;
+    return true;
+  },
+  prefetch: (c) => {
+    const docNum = String(c.__citeDocNum ?? c.u?.doc_number ?? "");
+    const family = c.__citeFamily;
+    c.lane["citation-probe"] = Promise.all([
+      (async () => {
+        if (!docNum) return [];
+        try {
+          const rows = await c.env.DB.prepare(
+            "SELECT c.id FROM chunks_fts f JOIN chunks c ON c.rowid = f.rowid WHERE chunks_fts MATCH ?1 AND c.doc_number = ?2 AND (c.clause_title LIKE '%ibliograph%' OR c.clause_title LIKE '%ormative reference%') LIMIT 8"
+          ).bind("bibliography OR references", docNum).all();
+          const ids = (rows.results ?? []).map((r) => r.id).slice(0, 8);
+          if (!ids.length) return [];
+          const got = await c.env.VECTORIZE.getByIds(ids);
+          if (!got?.length) return [];
+          const ph = ids.map((_, i) => `?${i + 1}`).join(",");
+          const texts = await c.env.DB.prepare(`SELECT id, text FROM chunks WHERE id IN (${ph})`).bind(...ids).all();
+          const textById = new Map((texts.results ?? []).map((r) => [r.id, r.text]));
+          return got.filter((h) => textById.has(h.id)).map((h) => ({ ...h, score: 10, text: textById.get(h.id) }));
+        } catch {
+          return [];
+        }
+      })(),
+      // the graph's cites edges for the family — structured, edition-keyed
+      (async () => {
+        if (!family) return [];
+        try {
+          const rows = await c.env.DB.prepare(
+            "SELECT d.docidentifier, d.edition, d.active, n.label FROM graph_edges e JOIN documents d ON e.src = d.canonical_id JOIN graph_nodes n ON e.dst = n.id WHERE e.kind = 'cites' AND d.family = ?1 ORDER BY d.active DESC, d.edition DESC LIMIT 120"
+          ).bind(family).all();
+          return rows.results ?? [];
+        } catch {
+          return [];
+        }
+      })()
+    ]);
+  },
+  run: async (c) => {
+    const [probes, citeRows] = await c.lane["citation-probe"];
+    const seen = new Set(c.hits.map((m) => m.id));
+    let added = 0;
+    for (const h of probes) {
+      if (seen.has(h.id)) continue;
+      const title = String(h.metadata?.clause_title ?? "");
+      const text = String(h.text ?? "");
+      if (/bibliograph|normative reference/i.test(title + " " + text.slice(0, 300))) {
+        c.hits.push(h);
+        seen.add(h.id);
+        added++;
+      }
+    }
+    const edition = c.__citeEdition;
+    const scoped = edition ? citeRows.filter((r) => r.edition === edition) : citeRows;
+    const note = citationGraphNote(c.__citeLabel, scoped);
+    if (note) c.notes.push(note);
+    console.log("citation-probe:", added, "passages,", note ? "graph note on" : "graph note off", `(${citeRows.length} cite rows)`);
+  }
+};
+
 // workers/worker_public/src/ports/cloudflare/adapters.ts
 var EMBED_REQUEST_SHAPES = {
   // "text" first: the verified request shape for qwen3-embedding-0.6b
@@ -618,49 +838,6 @@ var glossary = {
   }
 };
 
-// workers/worker_public/src/codecs.ts
-var oimlPubid = {
-  parse(doc, edition) {
-    const m = doc.match(/^urn:oiml:pub:([rdbge]):(\d{1,3})(?:-[0-9A-Za-z]+)?(?::(\d{4}))?$/i) ?? doc.match(/^(?:OIML\s+)?([RDBGE])\s*(\d{1,3})(?:-[0-9A-Za-z]+)?(?::(\d{4}))?$/i);
-    if (!m) return null;
-    const type = m[1].toUpperCase();
-    const ed = edition ?? m[3] ?? void 0;
-    return { doc_number: m[2], ...ed ? { edition: ed } : {}, label: `OIML ${type} ${m[2]}${ed ? `:${ed}` : ""}` };
-  },
-  scanQuestion(query) {
-    const re = /\b(OIML\s+)?([RDBGE])(\s*)0*(\d{1,3})(?:\s*[-–]\s*\d+)?(?:\s*:\s*(\d{4}))?/gi;
-    for (const m of query.matchAll(re)) {
-      const [, oimlPrefix, letter, gap, digits, edition] = m;
-      if (digits.length === 1 && !oimlPrefix && !gap) continue;
-      const num2 = String(Number(digits));
-      const type = letter.toUpperCase();
-      return { doc_number: num2, ...edition ? { edition } : {}, label: `OIML ${type} ${num2}${edition ? `:${edition}` : ""}` };
-    }
-    return null;
-  },
-  graphDocNumber(nodeId) {
-    const m = nodeId.match(/^doc:OIML-[A-Z]-(\d+)-/);
-    return m ? m[1] : null;
-  },
-  familyOf(di) {
-    const m = /^(?:OIML\s+)?([A-Z])\s?(\d{1,3})(?:[-–]([0-9A-Za-z]+))?/.exec(di);
-    return m ? `${m[1]}-${m[2]}` : null;
-  }
-};
-var plainSlug = {
-  parse: () => null,
-  scanQuestion: () => null,
-  graphDocNumber: () => null,
-  familyOf: () => null
-};
-var REGISTRY = {
-  "oiml-pubid": oimlPubid,
-  "plain-slug": plainSlug
-};
-function refCodec() {
-  return REGISTRY[P().publisher.codec] ?? plainSlug;
-}
-
 // workers/worker_public/src/stages/conceptGraph.ts
 var conceptGraph = {
   name: "concept-graph",
@@ -1316,6 +1493,7 @@ var STAGES = [
   familyBoost,
   rerankStage,
   lexicalRrf,
+  citationProbe,
   corpusScope,
   editionCover,
   stdRefNudge,
@@ -1374,6 +1552,7 @@ async function retrieve(env, query, opts = {}) {
     hits: [],
     finalHits: [],
     glossary: [],
+    notes: [],
     opts,
     lane: {}
   };
@@ -1381,7 +1560,8 @@ async function retrieve(env, query, opts = {}) {
   return {
     hits: ctx.finalHits,
     filters: ctx.filters ?? {},
-    ...ctx.glossary?.length ? { glossary: ctx.glossary } : {}
+    ...ctx.glossary?.length ? { glossary: ctx.glossary } : {},
+    ...ctx.notes?.length ? { notes: ctx.notes } : {}
   };
 }
 function estTokens(s) {
@@ -2185,93 +2365,6 @@ async function handleLogout(env, req) {
   return new Response(null, { status: 302, headers });
 }
 
-// workers/worker_public/src/context.ts
-var NO_CONTEXT = { kind: "none", scoped_to: null };
-function parseContext(body) {
-  const c = body?.context;
-  if (!c || typeof c !== "object") return null;
-  if (c.kind !== "page" && c.kind !== "entity" && c.kind !== "document" && c.kind !== "account") return null;
-  const label = typeof c.label === "string" ? c.label.trim().slice(0, 120) : "";
-  const route = typeof c.route === "string" && c.route.trim() ? c.route.trim().slice(0, 200) : void 0;
-  const doc = typeof c.doc === "string" && c.doc.trim() ? c.doc.trim().slice(0, 80) : void 0;
-  const edition = typeof c.edition === "string" && /^\d{4}$/.test(c.edition.trim()) ? c.edition.trim() : void 0;
-  return { kind: c.kind, label, ...route ? { route } : {}, ...doc ? { doc } : {}, ...edition ? { edition } : {} };
-}
-function parseDocRef(doc, edition) {
-  return refCodec().parse(doc, edition);
-}
-function namedDocumentIn(query) {
-  return refCodec().scanQuestion(query);
-}
-async function resolveDocScope(env, ctx) {
-  if (!ctx.doc) return null;
-  const parsed = parseDocRef(ctx.doc, ctx.edition);
-  if (!parsed) return null;
-  try {
-    const type = parsed.label.split(" ")[1];
-    const row = await env.DB.prepare("SELECT 1 FROM documents WHERE family = ?1 LIMIT 1").bind(`${type}-${parsed.doc_number}`).first();
-    if (!row) return null;
-  } catch {
-  }
-  return parsed;
-}
-function appliedContext(declared, scope, note, live) {
-  if (!declared) return NO_CONTEXT;
-  return {
-    kind: declared.kind,
-    label: declared.label,
-    scoped_to: scope ? scope.label : null,
-    ...note ? { note } : {},
-    ...live ? { live } : {}
-  };
-}
-function parseAppliedContext(v) {
-  if (!v || typeof v !== "object") return null;
-  if (v.kind !== "page" && v.kind !== "entity" && v.kind !== "document" && v.kind !== "account" && v.kind !== "none") return null;
-  const label = typeof v.label === "string" && v.label.trim() ? v.label.trim().slice(0, 120) : void 0;
-  const scoped = typeof v.scoped_to === "string" && v.scoped_to.trim() ? v.scoped_to.trim().slice(0, 80) : null;
-  const note = v.note === "document-not-in-corpus" || v.note === "question-document-wins" || v.note === "sign-in-required" || v.note === "live-window-expired" || v.note === "live-unavailable" ? v.note : void 0;
-  const live = v.live && typeof v.live === "object" && typeof v.live.read_at === "string" && Array.isArray(v.live.stores) && typeof v.live.records === "number" ? { read_at: v.live.read_at.slice(0, 40), stores: v.live.stores.filter((s) => typeof s === "string").slice(0, 8), records: Math.min(Math.max(0, v.live.records), 999) } : void 0;
-  const model = v.model && typeof v.model === "object" && typeof v.model.node_id === "string" && typeof v.model.kind === "string" && typeof v.model.standard === "string" ? {
-    node_id: v.model.node_id.slice(0, 120),
-    kind: v.model.kind.slice(0, 40),
-    standard: v.model.standard.slice(0, 40),
-    ...typeof v.model.clause === "string" && v.model.clause.trim() ? { clause: v.model.clause.slice(0, 120) } : {}
-  } : void 0;
-  return { kind: v.kind, ...label ? { label } : {}, scoped_to: scoped, ...note ? { note } : {}, ...live ? { live } : {}, ...model ? { model } : {} };
-}
-function contextNote(declared, scope) {
-  if (!declared) return void 0;
-  if (declared.kind === "account") {
-    return void 0;
-  }
-  if (declared.kind === "page") {
-    return `Context note: the user is viewing ${declared.label || "a page"}${declared.route ? ` (${declared.route})` : ""} in the ${P().publisher.product_name} platform. The passages come from the general corpus; frame procedural guidance for that page when relevant.`;
-  }
-  if (declared.kind === "entity") {
-    return scope ? `Context note: the user is asking about ${declared.label || "an entity"} \u2014 the passages are scoped to ${scope.label}, the publication that governs it. You do NOT have the entity's own data; answer what the publication requires and say when the question needs the record itself.` : `Context note: the user is asking about ${declared.label || "an entity"}. You do NOT have the entity's own data; answer from the corpus passages and say when the question needs the record itself.`;
-  }
-  return scope ? `Context note: the user scoped this question to ${scope.label} \u2014 the passages come from that publication. If they cannot answer the question, say so instead of drawing on other documents.` : `Context note: the user named ${declared.label || declared.doc || "a document"} as context, but it is not in the indexed corpus \u2014 answer from the general corpus and say the document was not found.`;
-}
-function syntheticUnderstanding(scope) {
-  return {
-    intent: "knowledge",
-    docidentifier: scope.label,
-    doc_number: scope.doc_number,
-    edition: scope.edition ?? null,
-    language: null,
-    process_intent: false,
-    term: null,
-    defined_terms: [],
-    standalone_query: "",
-    complexity: "simple",
-    query_variants: [],
-    sub_queries: [],
-    hypothetical_answer: "",
-    follow_ups: []
-  };
-}
-
 // workers/worker_public/src/conversations.ts
 var ID_RE = /^[a-zA-Z0-9_-]{8,64}$/;
 async function ownedConversation(env, sub, id) {
@@ -2286,7 +2379,7 @@ async function handleConversations(env, sub, req, route) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   if (method === "GET" && !id) {
     const rows = await env.DB.prepare(
-      "SELECT c.id, c.title, c.updated_at, COUNT(m.id) AS messages FROM conversations c LEFT JOIN messages m ON m.conversation_id = c.id WHERE c.sub = ?1 GROUP BY c.id ORDER BY c.updated_at DESC LIMIT 50"
+      "SELECT c.id, c.title, c.updated_at, c.project_id, COUNT(m.id) AS messages FROM conversations c LEFT JOIN messages m ON m.conversation_id = c.id WHERE c.sub = ?1 GROUP BY c.id ORDER BY c.updated_at DESC LIMIT 50"
     ).bind(sub).all();
     return json({ conversations: rows.results ?? [] });
   }
@@ -2621,6 +2714,7 @@ Rules:
 - docidentifier: the publication the user names, in any spelling ({{SPELLING_EXAMPLES}}, "the nonautomatic weighing instruments recommendation" \u2192 resolve to the {{PUBLISHER_NAME}} identifier you can infer; include the part ("-1", "-2") only when clearly meant). docnumber is the base number without part.
 - edition: only when the user pins a year.
 - language: only when the user asks for a specific answer language; otherwise null (the corpus is English; answering in the user's language is handled elsewhere).
+- citation questions ("what does X cite/reference/list?", "which standards does X reference?"): ALWAYS include a query variant that names the document's bibliography or normative-references section explicitly, WITHOUT edition scoping (e.g. for "What ISO standards does R 60 cite?" generate BOTH "R 60 bibliography normative references" AND "R 60 2017 bibliography ISO IEC") \u2014 bibliographies embed differently than the query's phrasing, and prior editions may carry references the current edition dropped; set edition to null for these queries so retrieval covers the whole family.
 - process_intent: true when the question is about the GOVERNING SYSTEM around publications rather than a publication's own technical content \u2014 HOW to get certified/apply/comply, OR which framework/vocabulary/{{PROCESS_VOCAB}}. Naming a Recommendation (e.g. "R 60") inside such a question does NOT make it a technical-content question: leave process_intent true and still emit docnumber when named, but the retrieval path must NOT seal to that document alone.
 - term: the defined term when the question asks what something is ("what is an accuracy class" \u2192 "accuracy class"); otherwise null.
 - defined_terms: the ESTABLISHED metrology / VIM terms this question is about, in the corpus's own terminology, EVEN WHEN the question uses everyday wording instead \u2014 match the TIME SCALE and sense carefully: "does the reading drift while a weight sits on it" (short-term, under load) \u2192 ["creep"]; "output keeps drifting over months of use" (long-term, in service) \u2192 ["span stability", "durability"]; "how many scale divisions is it allowed" \u2192 ["number of verification intervals"]. This is a terminology mapping, not a copy of the question's words. Empty when nothing maps.
@@ -4657,7 +4751,7 @@ Answer account questions from these records ONLY: name the record when you use i
       const reordered = await listwiseRerank(env, MODELS.listwise, understanding?.standalone_query || q.query, retrieved.hits);
       if (reordered) {
         console.log("listwise: reordered", reordered[0]?.metadata?.docidentifier ?? "?", "to top");
-        retrieved = { hits: reordered, filters: retrieved.filters };
+        retrieved = { ...retrieved, hits: reordered };
       }
     }
     const grade = await gradePromise;
@@ -4695,7 +4789,8 @@ Answer account questions from these records ONLY: name the record when you use i
     hits,
     q.lang,
     keptHistory,
-    [processNote, eNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote].filter(Boolean).join("\n") || void 0,
+    // stage-extracted graph facts (GraphRAG) ride the same note channel
+    [processNote, eNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, ...retrieved.notes ?? []].filter(Boolean).join("\n") || void 0,
     summary,
     budget
   );

package/docs/INGEST-ARCHITECTURE.md

@@ -54,6 +54,7 @@ hand.
 │                 (derived status, active flags — the SSOT)         │
 │   structure     typed nodes → ChunkRecordV2 (per block type)      │
 │   derivation    registry + graph projection (relaton edges +      │
+│                 citation edges from the indexed bibliographies    │
 │                 glossarist defines edges)                         │
 │   enrichment    contextual contexts (quality-first lane, KV-      │
 │                 cached, content-hash invalidated)                 │

package/docs/projects-design.md

@@ -2,6 +2,13 @@
 
 > The question: should chats group into **projects** that share a
 > per-project contextual memory? Yes — and the parts already exist.
+>
+> **Shipped (2026-09-15)**: membership is drag-and-drop — a chat drags
+> onto a project row to file, onto the conversations list to unfile,
+> with drop-target highlights and a live hint; a per-row picker covers
+> touch/keyboard; chats carry a project badge. The conversations list
+> carries `project_id` from the server (membership stays server-truth)
+> and the move rides the server conversation id.
 > This is the design; nothing is implemented yet.
 
 ## 1. Prior art — what the best got right and wrong

package/docs/sota-mechanisms.md

@@ -97,6 +97,21 @@ unit selection, so the pin lands the object the question is about
 ranking answers from stale editions, guesses at doc scope, and never
 surfaces a typed object.
 
+### 7b. The citation graph (structured questions get graph answers)
+
+Bibliographic citations become graph edges: what each edition's
+bibliography cites is extracted at index time (the identifier grammar
+lives in the publisher codec — ISO/IEC floor generic, publisher series
+on top; ~300 cites edges across the OIML corpus), stored beside the
+publication registry, and keyed by the same normalized pubids
+everywhere ("OIML R 60", never a bare number). When a question asks
+what a publication cites or references, the answer receives the
+cited-standards list per edition as authoritative structured data
+(the `notes` channel), while the bibliography section itself is
+retrieved as the passage that grounds the answer verbatim. Structured
+questions get graph answers; semantic questions get vector answers;
+the hybrid class gets both, fused by the same rerank.
+
 ### 8. The answer contract (claims are checkable)
 Inline citations on every claim; normative values quoted verbatim from
 the cited passage; tables/formulas/figures rendered as typed objects

package/docs/spec-pipeline.md

@@ -51,18 +51,25 @@ candidate lanes → pool open → pool-level merges → refinement → window as
 | 13 | `family-boost` | boost only under `filter.doc_number`; sort always | blocking | mutates `hits[].score`, sorts | Family chunks decisively boosted for doc-scoped queries; the sort establishes the rerank-failure fallback order. |
 | 14 | `rerank` | `hits.length > 1` | additive | `hits[].rerank_score`, sorts, family pin | Cross-encoder scores; vector order is the designed fallback. Post-rerank family pin for doc-scoped queries. |
 | 15 | `lexical-rrf` | `hits.length > 1 && lexicalHits.length` | blocking | REPLACES `hits` order | RRF fusion with the full-corpus lexical ranking. Runs even when rerank failed (additive semantics preserve this). |
-| 16 | `std-ref-nudge` | query names ISO/IEC/ASTM/EN | blocking | `hits[].rerank_score`, sorts | Standard-reference nudge: chunks CARRYING such a citation get `stdRefNudgeSpread × spread` — the citing clause is the answer to "which standard does X invoke", and generic family prose otherwise fills the window (l5a measured). |
-| 17 | `edition-cover` | `!filters.edition && hits.length > 1` | additive | appends `hits` | Registry-driven cover: when a pool holds only stale editions of a document whose ACTIVE edition the documents registry knows, fetch the current edition's chunks and add at `editionCoverDiscount` — steering needs the successor present to demote. |
-| 18 | `corpus-scope` | `opts.datasetScope` | blocking | filters `hits` | Dataset scope (the sidebar toggles): drops hits whose corpus the request excludes. LAST of the pool-assembly stages — the lexical union above refills the pool after rerank, so filtering earlier let excluded corpora back in. Corpora the toggle model doesn't name pass untouched. |
-| 19 | `term-nudge` | `u.term` | blocking | `hits[].rerank_score`, sorts | Clause whose head IS the asked term gets `termNudgeSpread × spread` (decisive). |
-| 20 | `concept-steer` | `glossary.length && hits.length > 1` | blocking | `hits[].rerank_score`, sorts | Vocabulary-link families boosted (`conceptSteerSpread`). |
-| 21 | `edition-steer` | `!filters.edition && hits.length > 1` | blocking | `hits[].rerank_score`, sorts | Cross-pub recency boost + family-relative superseded-edition demotion (spread-scaled). |
-| 22 | `structural-propagate` | — | blocking | REPLACES `hits` | FABLE TreeExpansion: score blends along the clause tree. |
-| 23 | `diversity` | — | blocking | `finalHits` (from `hits`) | Per-publication caps (1 overview / 2–3 clauses; global overview cap 2/6); window cut to `rerankKeep`. FIRST writer of `finalHits`. |
-| 21 | `typed-pin` | pin families resolvable | blocking (inner parent-fetch additive) | `finalHits` | Answer-contract v2: one typed unit guaranteed a slot (+ small-to-big parent fetch at `smallToBigDiscount`). |
-| 22 | `section-descent` | a ranked depth-1 summary has children | additive | `finalHits` | Summary node → top child clauses at `sectionDescentDiscount`; the summary retires when children answer. |
-| 23 | `dedup` | — | blocking | `finalHits` | FABLE ancestor-descendant same-chain collapse (≥0.5 text overlap). |
-| 24 | `window-floor` | — | blocking | filters `finalHits` | Evidence-budget cut at `windowFloorFraction` of top; typed/family/unscored exempt; never fewer than two. |
+| 16 | `citation-probe` | citation-question shape + a document named in the TEXT | additive | appends `hits`, appends `notes` | GraphRAG: bibliography-shaped questions get (a) the family's bibliography sections as passages — FTS over the chunk store, deterministic, text fetched from D1 (getByIds returns no text), pushed to `hits` at score 10 — and (b) the graph's `cites` edges for the family as an authoritative per-edition note on the `notes` channel, identifiers codec-normalized. The graph answers the STRUCTURE; the passages ground it verbatim. |
+| 17 | `corpus-scope` | `opts.datasetScope` | blocking | filters `hits` | Dataset scope (the sidebar toggles): drops hits whose corpus the request excludes. LAST of the pool-assembly stages — the lexical union above refills the pool after rerank, so filtering earlier let excluded corpora back in. Corpora the toggle model doesn't name pass untouched. |
+| 18 | `edition-cover` | `!filters.edition && hits.length > 1` | additive | appends `hits` | Registry-driven cover: when a pool holds only stale editions of a document whose ACTIVE edition the documents registry knows, fetch the current edition's chunks and add at `editionCoverDiscount` — steering needs the successor present to demote. |
+| 19 | `std-ref-nudge` | query names ISO/IEC/ASTM/EN | blocking | `hits[].rerank_score`, sorts | Standard-reference nudge: chunks CARRYING such a citation get `stdRefNudgeSpread × spread` — the citing clause is the answer to "which standard does X invoke", and generic family prose otherwise fills the window (l5a measured). |
+| 20 | `term-nudge` | `u.term` | blocking | `hits[].rerank_score`, sorts | Clause whose head IS the asked term gets `termNudgeSpread × spread` (decisive). |
+| 21 | `concept-steer` | `glossary.length && hits.length > 1` | blocking | `hits[].rerank_score`, sorts | Vocabulary-link families boosted (`conceptSteerSpread`). |
+| 22 | `edition-steer` | `!filters.edition && hits.length > 1` | blocking | `hits[].rerank_score`, sorts | Cross-pub recency boost + family-relative superseded-edition demotion (spread-scaled). |
+| 23 | `structural-propagate` | — | blocking | REPLACES `hits` | FABLE TreeExpansion: score blends along the clause tree. |
+| 24 | `diversity` | — | blocking | `finalHits` (from `hits`) | Per-publication caps (1 overview / 2–3 clauses; global overview cap 2/6); window cut to `rerankKeep`. FIRST writer of `finalHits`. |
+| 25 | `typed-pin` | pin families resolvable | blocking (inner parent-fetch additive) | `finalHits` | Answer-contract v2: one typed unit guaranteed a slot (+ small-to-big parent fetch at `smallToBigDiscount`). |
+| 26 | `section-descent` | a ranked depth-1 summary has children | additive | `finalHits` | Summary node → top child clauses at `sectionDescentDiscount`; the summary retires when children answer. |
+| 27 | `dedup` | — | blocking | `finalHits` | FABLE ancestor-descendant same-chain collapse (≥0.5 text overlap). |
+| 28 | `window-floor` | — | blocking | filters `finalHits` | Evidence-budget cut at `windowFloorFraction` of top; typed/family/unscored exempt; never fewer than two. |
+
+The `notes` channel (the GraphRAG seam): stages may append structured
+facts to `PipelineContext.notes`; `retrieve()` returns them and the ask
+path merges them into the answer prompt's retrieval note — the same
+channel the vocabulary link rides. `citation-probe` is the first
+writer; any future graph-derived fact uses the same seam.
 
 ## Ordering dependencies (why the order is what it is)
 
@@ -77,7 +84,7 @@ candidate lanes → pool open → pool-level merges → refinement → window as
 - **`seal` before `overview-demote`/`rerank`**: the declared context is
   a hard scope, not a preference — steering and reranking happen WITHIN
   it.
-- **`rerank` before every steering stage** (16–18): steering is
+- **`rerank` before every steering stage** (19–22): steering is
   spread-scaled over rerank scores; steering before rerank would be
   erased by the re-sort.
 - **`structural-propagate` after steering, before `diversity`**:

package/package.json

@@ -31,7 +31,7 @@
     "@astrojs/markdown-satteri": "^0.4.1",
     "@astrojs/mdx": "^4.3.14"
   },
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "The Konneal engine: the publisher-agnostic build pipeline and API plane for standards intelligence (retrieval, answer contract, verdicts, evaluation).",
   "license": "BSD-3-Clause",
   "type": "module",

package/workers/worker_public/prompts/understanding.md

@@ -6,6 +6,7 @@ Rules:
 - docidentifier: the publication the user names, in any spelling ({{SPELLING_EXAMPLES}}, "the nonautomatic weighing instruments recommendation" → resolve to the {{PUBLISHER_NAME}} identifier you can infer; include the part ("-1", "-2") only when clearly meant). docnumber is the base number without part.
 - edition: only when the user pins a year.
 - language: only when the user asks for a specific answer language; otherwise null (the corpus is English; answering in the user's language is handled elsewhere).
+- citation questions ("what does X cite/reference/list?", "which standards does X reference?"): ALWAYS include a query variant that names the document's bibliography or normative-references section explicitly, WITHOUT edition scoping (e.g. for "What ISO standards does R 60 cite?" generate BOTH "R 60 bibliography normative references" AND "R 60 2017 bibliography ISO IEC") — bibliographies embed differently than the query's phrasing, and prior editions may carry references the current edition dropped; set edition to null for these queries so retrieval covers the whole family.
 - process_intent: true when the question is about the GOVERNING SYSTEM around publications rather than a publication's own technical content — HOW to get certified/apply/comply, OR which framework/vocabulary/{{PROCESS_VOCAB}}. Naming a Recommendation (e.g. "R 60") inside such a question does NOT make it a technical-content question: leave process_intent true and still emit docnumber when named, but the retrieval path must NOT seal to that document alone.
 - term: the defined term when the question asks what something is ("what is an accuracy class" → "accuracy class"); otherwise null.
 - defined_terms: the ESTABLISHED metrology / VIM terms this question is about, in the corpus's own terminology, EVEN WHEN the question uses everyday wording instead — match the TIME SCALE and sense carefully: "does the reading drift while a weight sits on it" (short-term, under load) → ["creep"]; "output keeps drifting over months of use" (long-term, in service) → ["span stability", "durability"]; "how many scale divisions is it allowed" → ["number of verification intervals"]. This is a terminology mapping, not a copy of the question's words. Empty when nothing maps.

package/workers/worker_public/src/ask.ts

@@ -733,7 +733,7 @@ async function handleAsk(
       const reordered = await listwiseRerank(env, MODELS.listwise, understanding?.standalone_query || q.query, retrieved.hits);
       if (reordered) {
         console.log("listwise: reordered", reordered[0]?.metadata?.docidentifier ?? "?", "to top");
-        retrieved = { hits: reordered, filters: retrieved.filters };
+        retrieved = { ...retrieved, hits: reordered };
       }
     }
     const grade = await gradePromise;
@@ -787,7 +787,8 @@ async function handleAsk(
     hits,
     q.lang,
     keptHistory,
-    [processNote, eNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote].filter(Boolean).join("\n") || undefined,
+    // stage-extracted graph facts (GraphRAG) ride the same note channel
+    [processNote, eNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, ...(retrieved.notes ?? [])].filter(Boolean).join("\n") || undefined,
     summary,
     budget,
   );

package/workers/worker_public/src/conversations.ts

@@ -38,7 +38,7 @@ export async function handleConversations(
 
   if (method === "GET" && !id) {
     const rows: any = await env.DB.prepare(
-      "SELECT c.id, c.title, c.updated_at, COUNT(m.id) AS messages FROM conversations c LEFT JOIN messages m ON m.conversation_id = c.id WHERE c.sub = ?1 GROUP BY c.id ORDER BY c.updated_at DESC LIMIT 50",
+      "SELECT c.id, c.title, c.updated_at, c.project_id, COUNT(m.id) AS messages FROM conversations c LEFT JOIN messages m ON m.conversation_id = c.id WHERE c.sub = ?1 GROUP BY c.id ORDER BY c.updated_at DESC LIMIT 50",
     )
       .bind(sub)
       .all();

package/workers/worker_public/src/pipeline.ts

@@ -52,6 +52,9 @@ export interface Retrieved {
    *  among them (dense retrieval alone binds everyday words to the wrong
    *  term: measured "keeps drifting" → creep 0.69 vs durability 0.54) */
   glossary?: GlossaryEntry[];
+  /** structured facts stages extracted from the graph (GraphRAG) —
+   *  merged into the answer prompt's retrieval note */
+  notes?: string[];
 }
 
 // Short follow-ups are usually elliptical ("and the limits?") — fold the
@@ -130,13 +133,14 @@ export async function retrieve(
 
   const ctx: PipelineContext = {
     env, query, rq, folded, u, filters, filter, vector, lexicalHits,
-    matches: [], hits: [], finalHits: [], glossary: [], opts, lane: {},
+    matches: [], hits: [], finalHits: [], glossary: [], notes: [], opts, lane: {},
   };
   await runStages(STAGES, ctx);
   return {
     hits: ctx.finalHits,
     filters: ctx.filters ?? {},
     ...(ctx.glossary?.length ? { glossary: ctx.glossary } : {}),
+    ...(ctx.notes?.length ? { notes: ctx.notes } : {}),
   };
 }
 

package/workers/worker_public/src/stages/citationProbe.ts

@@ -0,0 +1,145 @@
+// Citation probe (deterministic, GraphRAG): questions asking what a
+// publication CITES/REFERENCES need the bibliography chunks in the
+// pool, but the bibliography's embedding rarely matches the question's
+// phrasing — and prior editions may carry references the current one
+// dropped. This stage pattern-matches the citation question shape and
+// does two things for the named document family (all editions):
+//   1. surfaces the bibliography SECTIONS as passages (FTS over the
+//      chunk store — no embedding similarity involved), and
+//   2. injects the graph's structured `cites` edges (built at ingest
+//      from the same bibliographies) as an authoritative note — the
+//      graph answers the STRUCTURE (the list of cited standards), the
+//      passages ground it verbatim.
+// Additive: results join the pool; nothing is filtered.
+import type { Stage } from "./types.ts";
+import { namedDocumentIn } from "../context.ts";
+import { refCodec } from "../codecs.ts";
+import type { Hit } from "../../../shared/chunk.ts";
+
+const CITE_PATTERN = /\b(?:cite[sd]?|citing|referenc(?:e|es|ed|ing)|list[s]?|quote[sd]?)\b/i;
+const REFS_PATTERN = /\b(?:standard|publication|document|normative|bibliograph)/i;
+
+export interface CiteRow {
+  docidentifier: string;
+  edition: string;
+  active: number;
+  label: string;
+}
+
+/** The authoritative citation note: per edition, the cited standards in
+ * bibliography order. docLabel is the codec-normalized identifier — a
+ * bare number never appears. */
+export function citationGraphNote(docLabel: string, rows: CiteRow[], cap = 30): string {
+  const bySrc = new Map<string, { active: boolean; labels: string[] }>();
+  for (const r of rows) {
+    const key = r.edition && !r.docidentifier.includes(r.edition) ? `${r.docidentifier}:${r.edition}` : r.docidentifier;
+    let e = bySrc.get(key);
+    if (!e) bySrc.set(key, (e = { active: !!r.active, labels: [] }));
+    if (e.labels.length < cap && !e.labels.includes(r.label)) e.labels.push(r.label);
+  }
+  if (!bySrc.size) return "";
+  const lines = [...bySrc.entries()]
+    .sort((a, b) => Number(b[1].active) - Number(a[1].active))
+    .map(([k, v]) => `- ${k}${v.active ? " (active edition)" : ""} cites: ${v.labels.join(", ")}`);
+  return [
+    `Citation graph (authoritative — extracted from the indexed bibliographies of ${docLabel}):`,
+    ...lines,
+    `When the question asks what ${docLabel} cites or references, answer from this list, name each standard exactly as listed, and cite the bibliography passage(s) provided in the context.`,
+  ].join("\n");
+}
+
+export const citationProbe: Stage = {
+  name: "citation-probe",
+  failure: "additive",
+  when: (c) => {
+    if (!CITE_PATTERN.test(c.query) || !REFS_PATTERN.test(c.query)) return false;
+    // the TEXT-derived naming (namedDocumentIn), never the LLM's
+    // extraction — the understand model may omit doc_number for this
+    // query shape (measured: it did)
+    const named = namedDocumentIn(c.query);
+    if (!named) return false;
+    (c as any).__citeDocNum = named.doc_number;
+    // the family key is codec-derived (label → family), never a bare number
+    (c as any).__citeFamily = refCodec().familyOf(named.label);
+    (c as any).__citeLabel = named.label;
+    (c as any).__citeEdition = named.edition ?? null;
+    return true;
+  },
+  prefetch: (c) => {
+    // deterministic: the chunk store's own bibliography-titled chunks for
+    // this document family — no embedding similarity involved (three
+    // vector-probe iterations measured: the embedding never matched
+    // reliably)
+    const docNum = String((c as any).__citeDocNum ?? c.u?.doc_number ?? "");
+    const family = (c as any).__citeFamily as string | null;
+    c.lane["citation-probe"] = Promise.all([
+      (async () => {
+        if (!docNum) return [] as Hit[];
+        try {
+          // chunks_fts is a virtual FTS5 table over chunks.fts_text — it
+          // has NO metadata columns. The doc_number and clause_title live
+          // in the chunks content table; join them.
+          const rows = await c.env.DB.prepare(
+            "SELECT c.id FROM chunks_fts f JOIN chunks c ON c.rowid = f.rowid WHERE chunks_fts MATCH ?1 AND c.doc_number = ?2 AND (c.clause_title LIKE '%ibliograph%' OR c.clause_title LIKE '%ormative reference%') LIMIT 8",
+          )
+            .bind("bibliography OR references", docNum)
+            .all() as { results?: Array<{ id: string }> };
+          const ids = (rows.results ?? []).map((r: { id: string }) => r.id).slice(0, 8);
+          if (!ids.length) return [] as Hit[];
+          const got = await c.env.VECTORIZE.getByIds(ids);
+          if (!got?.length) return [] as Hit[];
+          // getByIds returns metadata WITHOUT the chunk text — the
+          // usedHits builder calls h.text.clipToTokens and crashes on
+          // undefined (the live 503). Fetch the text from D1 and merge.
+          const ph = ids.map((_: string, i: number) => `?${i + 1}`).join(",");
+          const texts = await c.env.DB.prepare(`SELECT id, text FROM chunks WHERE id IN (${ph})`)
+            .bind(...ids)
+            .all() as { results?: Array<{ id: string; text: string }> };
+          const textById = new Map((texts.results ?? []).map((r) => [r.id, r.text]));
+          return got
+            .filter((h: any) => textById.has(h.id))
+            .map((h: any) => ({ ...h, score: 10, text: textById.get(h.id)! }));
+        } catch {
+          return [] as Hit[];
+        }
+      })(),
+      // the graph's cites edges for the family — structured, edition-keyed
+      (async () => {
+        if (!family) return [] as CiteRow[];
+        try {
+          const rows = await c.env.DB.prepare(
+            "SELECT d.docidentifier, d.edition, d.active, n.label FROM graph_edges e JOIN documents d ON e.src = d.canonical_id JOIN graph_nodes n ON e.dst = n.id WHERE e.kind = 'cites' AND d.family = ?1 ORDER BY d.active DESC, d.edition DESC LIMIT 120",
+          )
+            .bind(family)
+            .all() as { results?: CiteRow[] };
+          return rows.results ?? [];
+        } catch {
+          return [] as CiteRow[];
+        }
+      })(),
+    ]);
+  },
+  run: async (c) => {
+    const [probes, citeRows] = (await c.lane["citation-probe"]) as [Hit[], CiteRow[]];
+    const seen = new Set(c.hits.map((m: any) => m.id));
+    let added = 0;
+    // only bibliography-shaped chunks (clause title or text mentions it)
+    for (const h of probes) {
+      if (seen.has(h.id as any)) continue;
+      const title = String((h.metadata as any)?.clause_title ?? "");
+      const text = String(h.text ?? "");
+      if (/bibliograph|normative reference/i.test(title + " " + text.slice(0, 300))) {
+        c.hits.push(h);
+        seen.add(h.id as any);
+        added++;
+      }
+    }
+    // the structured note: an edition-scoped question sees only that
+    // edition's citations; the family question sees all editions
+    const edition = (c as any).__citeEdition as string | null;
+    const scoped = edition ? citeRows.filter((r) => r.edition === edition) : citeRows;
+    const note = citationGraphNote((c as any).__citeLabel as string, scoped);
+    if (note) c.notes.push(note);
+    console.log("citation-probe:", added, "passages,", note ? "graph note on" : "graph note off", `(${citeRows.length} cite rows)`);
+  },
+};

package/workers/worker_public/src/stages/index.ts

@@ -12,6 +12,7 @@ import type { Stage } from "./types.ts";
 export { runStages } from "./types.ts";
 export type { PipelineContext, RetrieveOptions, GlossaryEntry, Stage } from "./types.ts";
 import { dense } from "./dense.ts";
+import { citationProbe } from "./citationProbe.ts";
 import { hyde } from "./hyde.ts";
 import { glossary } from "./glossary.ts";
 import { conceptGraph } from "./conceptGraph.ts";
@@ -54,6 +55,7 @@ export const STAGES: Stage[] = [
   familyBoost,
   rerankStage,
   lexicalRrf,
+  citationProbe,
   corpusScope,
   editionCover,
   stdRefNudge,

package/workers/worker_public/src/stages/types.ts

@@ -64,6 +64,10 @@ export interface PipelineContext {
   hits: Hit[]; // the ranked pool from poolOpen onward
   finalHits: Hit[]; // the answer window
   glossary: GlossaryEntry[]; // the vocabulary link (glossary stage owns)
+  /** structured facts stages contribute to the answer prompt (the
+   *  GraphRAG seam: graph-derived notes ride the same channel the
+   *  vocabulary link does — ask.ts merges them into the retrieval note) */
+  notes: string[];
   opts: RetrieveOptions;
   /** prefetch bag: stage-name → that stage's in-flight I/O promise (the
    *  stage owns its key; see Stage.prefetch) */