@konneal/engine 0.2.122 → 0.2.124

package/dist/{ask-J4QFS6Q2.js → ask-XAI5SVJ7.js}

@@ -1,14 +1,14 @@
 import {
   handleAsk
-} from "./chunk-BRUHQEOT.js";
-import "./chunk-FKG5VGOL.js";
+} from "./chunk-ZO6MMKGD.js";
+import "./chunk-J6LBR6GI.js";
 import "./chunk-2JUWER2A.js";
 import "./chunk-TH5XGPD5.js";
 import "./chunk-DJ65EF5G.js";
 import "./chunk-A4A26BCV.js";
 import "./chunk-4NXH5ZI6.js";
 import "./chunk-VT7DR6NQ.js";
-import "./chunk-JZFXSTYX.js";
+import "./chunk-GBGRHXRU.js";
 import "./chunk-3FYJM7LH.js";
 export {
   handleAsk

package/dist/{certificates-CO7KX2S2.js → certificates-TMYS7XLD.js}

@@ -1,20 +1,28 @@
 import {
+  aggregateBlock,
+  aggregateNote,
   buildRegisterQuery,
   certificateLinks,
   isRegisterShaped,
   printedCertificateNumber,
   queryFamily,
+  registerAggregate,
+  registerAggregateIntent,
   registerNote,
   registerTokens,
   searchRegister
-} from "./chunk-JZFXSTYX.js";
+} from "./chunk-GBGRHXRU.js";
 import "./chunk-3FYJM7LH.js";
 export {
+  aggregateBlock,
+  aggregateNote,
   buildRegisterQuery,
   certificateLinks,
   isRegisterShaped,
   printedCertificateNumber,
   queryFamily,
+  registerAggregate,
+  registerAggregateIntent,
   registerNote,
   registerTokens,
   searchRegister

package/dist/certificates.d.ts

@@ -12,6 +12,49 @@ export interface RegisterRow {
  *  trigger the citation-graph notes already use (query-shaped notes,
  *  never a router). */
 export declare function isRegisterShaped(query: string): boolean;
+/** An AGGREGATE register question — "how many certificates are issued
+ *  for R 60:2021?", "what is the latest certificate issued for R 60" —
+ *  is served by DETERMINISTIC computation (COUNT, ORDER BY), never by
+ *  the model counting the rows a note happens to carry. The register
+ *  lane's own philosophy: the note answers the structure, the model
+ *  narrates it (TODO.sota/04's machine-checkable ground truth, applied
+ *  to the register plane 2026-10-11). */
+export declare function registerAggregateIntent(query: string): "count" | "latest" | null;
+export interface RegisterAggregate {
+    family: string;
+    count: number;
+    valid: number;
+    suspended: number;
+    latest: RegisterRow | null;
+}
+/** The family's aggregate, computed in SQL (the register is the ground
+ *  truth; editions do not appear in it — certificates are issued per
+ *  family). The latest row ranks by year then the sequence number's
+ *  tail (the -YY.NN suffix carries the actual issue ordering). */
+export declare function registerAggregate(db: any, family: string): Promise<RegisterAggregate | null>;
+/** The aggregate's authoritative note: the numbers are DATA — the
+ *  model narrates, never recomputes. The edition disclaimer rides every
+ *  family-scoped answer (the register has no edition dimension). */
+export declare function aggregateNote(agg: RegisterAggregate): string;
+/** A typed block for aggregate answers — the UI renders the count and
+ *  the latest row's link as data, never from prose. */
+export declare function aggregateBlock(agg: RegisterAggregate): {
+    type: string;
+    payload: {
+        latest?: {
+            url?: string | undefined;
+            num: string;
+            holder: string;
+            model: string;
+            year: string;
+            status: string;
+        } | undefined;
+        suspended?: number | undefined;
+        family: string;
+        count: number;
+        valid: number;
+    };
+};
 /** Search tokens: words that can identify a holder or a model — words of
  *  2+ characters that are not register question words, plus bare model
  *  numbers ("190", "HM14H1"). Upper-cased tokens match case-insensitively

package/dist/{chunk-JZFXSTYX.js → chunk-GBGRHXRU.js}

@@ -6,6 +6,62 @@ import {
 function isRegisterShaped(query) {
   return /\bcertif(ied|icates?|ication)s?\b/i.test(query) && /\b(is|are|still|currently|valid|status|suspended|revoked|was|were|have|has|hold|holds|possess|carry|got)\b/i.test(query);
 }
+function registerAggregateIntent(query) {
+  if (!/\bcertif(ied|icates?|ication)s?\b/i.test(query)) return null;
+  if (/\b(latest|most recent|newest|last)\b/i.test(query)) return "latest";
+  if (/\b(how many|count|number of|total|how much)\b/i.test(query)) return "count";
+  return null;
+}
+async function registerAggregate(db, family) {
+  try {
+    const digits = family.replace(/^[A-Za-z]+/, "");
+    const rows = await db.prepare(
+      "SELECT num, family, holder, model, year, status, pdf_key FROM certificates WHERE family = ?1 ORDER BY CAST(year AS INTEGER) DESC, num DESC LIMIT 1"
+    ).bind(digits).all();
+    const totals = await db.prepare("SELECT COUNT(*) AS n, SUM(CASE WHEN status = 'Valid' THEN 1 ELSE 0 END) AS valid, SUM(CASE WHEN status = 'Suspended' THEN 1 ELSE 0 END) AS suspended FROM certificates WHERE family = ?1").bind(digits).first();
+    if (!totals || !totals.n) return null;
+    return {
+      family: digits,
+      count: Number(totals.n),
+      valid: Number(totals.valid ?? 0),
+      suspended: Number(totals.suspended ?? 0),
+      latest: (rows.results ?? [])[0] ?? null
+    };
+  } catch {
+    return null;
+  }
+}
+function aggregateNote(agg) {
+  const latest = agg.latest ? `The latest certificate in the snapshot is ${agg.latest.num} (holder ${agg.latest.holder}, model "${agg.latest.model}"${agg.latest.year ? `, issued ${agg.latest.year}` : ""}, status ${agg.latest.status}).` : "No certificate rows are present in the snapshot.";
+  const link = agg.latest?.pdf_key ? ` Its document: https://www.oimlsmart.org/cert-pdf/${agg.latest.pdf_key}` : "";
+  return [
+    `CERTIFICATE REGISTER \u2014 THIS NOTE ANSWERS THE QUESTION. Answer from THIS note; do not refuse for want of passages (the retrieval passages are irrelevant for register questions).`,
+    `The ${agg.family} family holds ${agg.count} certificate${agg.count === 1 ? "" : "s"} (${agg.valid} valid${agg.suspended ? `, ${agg.suspended} suspended` : ""}) \u2014 computed over the register snapshot; state these numbers verbatim.`,
+    latest + link,
+    "Certificates are issued per RECOMMENDATION FAMILY \u2014 the register carries no edition dimension, so an edition named in the question (e.g. 2021) does not narrow it; say so when the question names an edition. Qualify that the register is a snapshot, and cite the register."
+  ].join("\n");
+}
+function aggregateBlock(agg) {
+  return {
+    type: "register",
+    payload: {
+      family: agg.family,
+      count: agg.count,
+      valid: agg.valid,
+      ...agg.suspended ? { suspended: agg.suspended } : {},
+      ...agg.latest ? {
+        latest: {
+          num: agg.latest.num,
+          holder: agg.latest.holder,
+          model: agg.latest.model,
+          year: agg.latest.year,
+          status: agg.latest.status,
+          ...agg.latest.pdf_key ? { url: `/cert-pdf/${agg.latest.pdf_key}` } : {}
+        }
+      } : {}
+    }
+  };
+}
 function queryFamily(query) {
   const m = /\b([RDMB])\s?-?(\d{2,3})\b/i.exec(query);
   return m ? `${m[1].toUpperCase()}${m[2].padStart(2, "0")}` : null;
@@ -14,6 +70,13 @@ function printedCertificateNumber(query) {
   const m = /\b([RDMB]\s?-?\d{2,3}\s?\/\s?\d{4}\s?-\s?[A-Z0-9]+\s?-\s?[^\s,;]+(?:\s?\.\s?\d+)?)/i.exec(query);
   return m ? m[1].replace(/\s+/g, "").replace(/-\./, ".") : null;
 }
+function editionSuffixYears(query) {
+  const years = /* @__PURE__ */ new Set();
+  for (const m of query.matchAll(/\b([RDMB])\s?-?\d{2,3}(?:-\d+)?\s?:\s?(\d{4})\b/gi)) {
+    years.add(m[2]);
+  }
+  return years;
+}
 function registerTokens(query) {
   const stop = /* @__PURE__ */ new Set([
     "the",
@@ -64,9 +127,12 @@ function registerTokens(query) {
   ]);
   const tokens = [];
   const publisherWord = P().publisher.name.toLowerCase();
+  const editionYears = editionSuffixYears(query);
+  const stop2 = /* @__PURE__ */ new Set([...stop, "many", "issued", "issue", "issued", "latest", "newest", "recent", "total", "number"]);
   for (const w of query.split(/[^A-Za-z0-9&-]+/)) {
     if (w.length < 2) continue;
-    if (stop.has(w.toLowerCase())) continue;
+    if (stop2.has(w.toLowerCase())) continue;
+    if (/^\d{4}$/.test(w) && editionYears.has(w)) continue;
     if (w.toLowerCase() === publisherWord) continue;
     if (/^\d+$/.test(w) && w.length < 2) continue;
     if (!tokens.includes(w)) tokens.push(w);
@@ -150,6 +216,10 @@ ${absent.join("\n")}`);
 
 export {
   isRegisterShaped,
+  registerAggregateIntent,
+  registerAggregate,
+  aggregateNote,
+  aggregateBlock,
   queryFamily,
   printedCertificateNumber,
   registerTokens,

package/dist/{chunk-FKG5VGOL.js → chunk-J6LBR6GI.js}

@@ -1181,7 +1181,7 @@ var certificatesSearch = {
   handler: async (env, args) => {
     const query = String(args?.query ?? "").trim().slice(0, 160);
     if (!query) return null;
-    const { searchRegister, registerNote, certificateLinks } = await import("./certificates-CO7KX2S2.js");
+    const { searchRegister, registerNote, certificateLinks } = await import("./certificates-TMYS7XLD.js");
     const reg = await searchRegister(env.DB, query, true);
     const output = reg?.rows?.length ? [registerNote(reg.rows), certificateLinks(reg.rows)].filter(Boolean).join("\n") : `No certificate was found for "${query}" in the certificates database (the register snapshot). State this as the search's result, with the searched string visible.`;
     return { name: "certificates.search", query, output };

package/dist/{chunk-BRUHQEOT.js → chunk-ZO6MMKGD.js}

@@ -22,7 +22,7 @@ import {
   tableRetyped,
   toolNote,
   verdictNote
-} from "./chunk-FKG5VGOL.js";
+} from "./chunk-J6LBR6GI.js";
 import {
   NO_CONTEXT,
   STAGE_NAMES,
@@ -100,10 +100,15 @@ import {
   sha256Hex
 } from "./chunk-VT7DR6NQ.js";
 import {
+  aggregateBlock,
+  aggregateNote,
   certificateLinks,
+  queryFamily,
+  registerAggregate,
+  registerAggregateIntent,
   registerNote,
   searchRegister
-} from "./chunk-JZFXSTYX.js";
+} from "./chunk-GBGRHXRU.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";
@@ -2066,7 +2071,24 @@ async function handleAsk(env, ctx, req, tier, key) {
     }
   }
   console.log("register-search:", JSON.stringify({ shaped: !!register, tokens: register?.tokens ?? null, rows: register?.rows?.length ?? null, first: register?.rows?.[0]?.num ?? null }));
-  const regNote = register ? [registerNote(register.rows), certificateLinks(register.rows)].filter(Boolean).join("\n") : void 0;
+  function queryFamilyForAggregate(query) {
+    return queryFamily(query);
+  }
+  let registerBlock = null;
+  let aggregateNoteText;
+  const aggIntent = registerAggregateIntent(q.query);
+  if (aggIntent) {
+    const fam = queryFamilyForAggregate(q.query);
+    if (fam) {
+      const agg = await registerAggregate(env.DB, fam);
+      if (agg) {
+        aggregateNoteText = aggregateNote(agg);
+        registerBlock = aggregateBlock(agg);
+        console.log("register aggregate:", agg.family, "count", agg.count, "latest", agg.latest?.num ?? "none");
+      }
+    }
+  }
+  const regNote = aggregateNoteText ?? (register ? [registerNote(register.rows), certificateLinks(register.rows)].filter(Boolean).join("\n") : void 0);
   const ops = await operationsLane(env.DB, q.query);
   if (understanding?.intent === "conversational") {
     const queryHash2 = await sha256Hex(q.query);
@@ -2751,7 +2773,7 @@ ${q.query}`.replace("\n\n\n\n", "\n\n") }];
       if (v.support !== "supported") console.log("entailment:", v.support, raced.score, raced.ungrounded_claims?.slice(0, 2));
     }
   }
-  const out = { answer, citations: finalCites, ...jsonQuality ? { source_quality: jsonQuality, confidence_note: entailmentNote || qualityNote(jsonQuality), ...entailment ? { entailment } : {}, ...jsonQuality === "ocr" ? { experimental_sources: experimentalSourceLabels(finalCites) } : {} } : {}, model: MODELS.member, query_hash: queryHash, follow_ups: understanding?.follow_ups ?? [], blocks: [...c2ns.blocks, ...verdictBlock ? [verdictBlock] : [], ...conditionBlock ? [conditionBlock] : [], ...aggregationBlock ? [aggregationBlock] : [], ...completionBlocks], context_applied: ctxApplied, ...liveRecords ? { records: liveRecords } : {}, ...ablate ? { ablate } : {}, route: { route: routed.route, features: routed.features } };
+  const out = { answer, citations: finalCites, ...jsonQuality ? { source_quality: jsonQuality, confidence_note: entailmentNote || qualityNote(jsonQuality), ...entailment ? { entailment } : {}, ...jsonQuality === "ocr" ? { experimental_sources: experimentalSourceLabels(finalCites) } : {} } : {}, model: MODELS.member, query_hash: queryHash, follow_ups: understanding?.follow_ups ?? [], blocks: [...c2ns.blocks, ...verdictBlock ? [verdictBlock] : [], ...conditionBlock ? [conditionBlock] : [], ...aggregationBlock ? [aggregationBlock] : [], ...registerBlock ? [registerBlock] : [], ...completionBlocks], context_applied: ctxApplied, ...liveRecords ? { records: liveRecords } : {}, ...ablate ? { ablate } : {}, route: { route: routed.route, features: routed.features } };
   const cacheable = !contextual && !declaredCtx && !ablate && !answer.includes(refusalAnswer()) && finalAnchors.violations.length === 0;
   if (cacheable) {
     const ck = exactCacheKey(env.INDEX_VERSION, gen, ns, await sha256Hex(cacheKeyMaterial(q.query, q.lang, salt)));

package/dist/{tools-CUKFOW7S.js → tools-O4JYGVSR.js}

@@ -4,7 +4,7 @@ import {
   parseToolCall,
   runTool,
   toolNote
-} from "./chunk-FKG5VGOL.js";
+} from "./chunk-J6LBR6GI.js";
 import "./chunk-TH5XGPD5.js";
 import "./chunk-4NXH5ZI6.js";
 import "./chunk-VT7DR6NQ.js";

package/dist/worker_public/src/index.js

@@ -4,12 +4,12 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-BRUHQEOT.js";
+} from "../../chunk-ZO6MMKGD.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
   modelGroundingBlock
-} from "../../chunk-FKG5VGOL.js";
+} from "../../chunk-J6LBR6GI.js";
 import {
   handleSearch
 } from "../../chunk-P6IRYZLL.js";
@@ -68,7 +68,7 @@ import {
   sha256Hex,
   today
 } from "../../chunk-VT7DR6NQ.js";
-import "../../chunk-JZFXSTYX.js";
+import "../../chunk-GBGRHXRU.js";
 import {
   P,
   setProfile
@@ -1043,13 +1043,13 @@ async function callToolOnce(env, ctx, _req, tier, key, name, args, t0) {
       // stream:false forces the JSON lane (anon defaults to SSE)
       body: JSON.stringify({ ...args, stream: false })
     });
-    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-CUKFOW7S.js");
+    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-O4JYGVSR.js");
     let payload;
     if (TOOLS_REGISTRY2.some((t) => t.name === name && t.audiences.includes("mcp"))) {
       const r = await runTool({ ...env, DB: env.DB }, { name, args }, "mcp");
       payload = r ? { tool: r.name, query: r.query, result: r.output } : { error: { message: `tool ${name} returned nothing for the given arguments` } };
     } else {
-      const res = name === "ask" ? await (await import("../../ask-J4QFS6Q2.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-OVUHVV35.js")).handleSearch(env, ctx, inner, tier, key);
+      const res = name === "ask" ? await (await import("../../ask-XAI5SVJ7.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-OVUHVV35.js")).handleSearch(env, ctx, inner, tier, key);
       payload = await res.json().catch(() => ({ error: { message: "tool transport failed", status: res.status } }));
     }
     telemetry(env, ctx, tier, `mcp:${name}`, null, !payload?.error, JSON.stringify(payload).length, await sha256Hex(`${name}:${JSON.stringify(args ?? {})}`), void 0, void 0, { durationMs: Date.now() - t0 });

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.122",
+  "version": "0.2.124",
   "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/src/ask.ts

@@ -44,7 +44,7 @@ export type { Env };
 import { json, err, corsHeaders, readJson, validateQuery, type ApiKey } from "./lib/http";
 import { chargeTokens, checkQuota, clientIp, estimateTokens, telemetry, tokenBudget, usageTotal } from "./quota";
 import { graphExpand, editionNote } from "./graph";
-import { registerNote, searchRegister, certificateLinks } from "./certificates";
+import { registerNote, searchRegister, certificateLinks, registerAggregateIntent, registerAggregate, aggregateNote, aggregateBlock, queryFamily } from "./certificates";
 import { TOOL_DECLARATION, parseToolCall, runTool, toolNote } from "./tools";
 import { operationsLane } from "./operations.ts";
 import { extractNameplate, nameplateRegisterQuery } from "./nameplate.ts";
@@ -756,7 +756,28 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
     }
   }
   console.log("register-search:", JSON.stringify({ shaped: !!register, tokens: register?.tokens ?? null, rows: register?.rows?.length ?? null, first: register?.rows?.[0]?.num ?? null }));
-  const regNote = register ? [registerNote(register.rows), certificateLinks(register.rows)].filter(Boolean).join("\n") : undefined;
+  function queryFamilyForAggregate(query: string): string | null {
+    return queryFamily(query);
+  }
+  // the AGGREGATE register intent (TODO 2026-10-11): count/latest
+  // questions are answered by deterministic computation — the numbers
+  // ride as an authoritative note AND a typed block the UI renders
+  let registerBlock: any = null;
+  let aggregateNoteText: string | undefined;
+  const aggIntent = registerAggregateIntent(q.query);
+  if (aggIntent) {
+    const fam = queryFamilyForAggregate(q.query);
+    if (fam) {
+      const agg = await registerAggregate(env.DB, fam);
+      if (agg) {
+        aggregateNoteText = aggregateNote(agg);
+        registerBlock = aggregateBlock(agg);
+        console.log("register aggregate:", agg.family, "count", agg.count, "latest", agg.latest?.num ?? "none");
+      }
+    }
+  }
+  const regNote = aggregateNoteText
+    ?? (register ? [registerNote(register.rows), certificateLinks(register.rows)].filter(Boolean).join("\n") : undefined);
   const ops = await operationsLane(env.DB, q.query);
 
   // Conversational route, decided by query UNDERSTANDING (any language, any
@@ -1735,7 +1756,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
       if (v.support !== "supported") console.log("entailment:", v.support, raced.score, raced.ungrounded_claims?.slice(0, 2));
     }
   }
-  const out = { answer, citations: finalCites, ...(jsonQuality ? { source_quality: jsonQuality, confidence_note: entailmentNote || qualityNote(jsonQuality), ...(entailment ? { entailment } : {}), ...(jsonQuality === "ocr" ? { experimental_sources: experimentalSourceLabels(finalCites) } : {}) } : {}), model: MODELS.member, query_hash: queryHash, follow_ups: understanding?.follow_ups ?? [], blocks: [...c2ns.blocks, ...(verdictBlock ? [verdictBlock] : []), ...(conditionBlock ? [conditionBlock] : []), ...(aggregationBlock ? [aggregationBlock] : []), ...completionBlocks], context_applied: ctxApplied, ...(liveRecords ? { records: liveRecords } : {}), ...(ablate ? { ablate } : {}), route: { route: routed.route, features: routed.features } };
+  const out = { answer, citations: finalCites, ...(jsonQuality ? { source_quality: jsonQuality, confidence_note: entailmentNote || qualityNote(jsonQuality), ...(entailment ? { entailment } : {}), ...(jsonQuality === "ocr" ? { experimental_sources: experimentalSourceLabels(finalCites) } : {}) } : {}), model: MODELS.member, query_hash: queryHash, follow_ups: understanding?.follow_ups ?? [], blocks: [...c2ns.blocks, ...(verdictBlock ? [verdictBlock] : []), ...(conditionBlock ? [conditionBlock] : []), ...(aggregationBlock ? [aggregationBlock] : []), ...(registerBlock ? [registerBlock] : []), ...completionBlocks], context_applied: ctxApplied, ...(liveRecords ? { records: liveRecords } : {}), ...(ablate ? { ablate } : {}), route: { route: routed.route, features: routed.features } };
   const cacheable = !contextual && !declaredCtx && !ablate && !answer.includes(refusalAnswer()) && finalAnchors.violations.length === 0;
   if (cacheable) {
     const ck = exactCacheKey(env.INDEX_VERSION, gen, ns, await sha256Hex(cacheKeyMaterial(q.query, q.lang, salt)));

package/workers/worker_public/src/certificates.ts

@@ -26,6 +26,102 @@ export function isRegisterShaped(query: string): boolean {
   return /\bcertif(ied|icates?|ication)s?\b/i.test(query) && /\b(is|are|still|currently|valid|status|suspended|revoked|was|were|have|has|hold|holds|possess|carry|got)\b/i.test(query);
 }
 
+/** An AGGREGATE register question — "how many certificates are issued
+ *  for R 60:2021?", "what is the latest certificate issued for R 60" —
+ *  is served by DETERMINISTIC computation (COUNT, ORDER BY), never by
+ *  the model counting the rows a note happens to carry. The register
+ *  lane's own philosophy: the note answers the structure, the model
+ *  narrates it (TODO.sota/04's machine-checkable ground truth, applied
+ *  to the register plane 2026-10-11). */
+export function registerAggregateIntent(query: string): "count" | "latest" | null {
+  if (!/\bcertif(ied|icates?|ication)s?\b/i.test(query)) return null;
+  if (/\b(latest|most recent|newest|last)\b/i.test(query)) return "latest";
+  if (/\b(how many|count|number of|total|how much)\b/i.test(query)) return "count";
+  return null;
+}
+
+export interface RegisterAggregate {
+  family: string;
+  count: number;
+  valid: number;
+  suspended: number;
+  latest: RegisterRow | null;
+}
+
+/** The family's aggregate, computed in SQL (the register is the ground
+ *  truth; editions do not appear in it — certificates are issued per
+ *  family). The latest row ranks by year then the sequence number's
+ *  tail (the -YY.NN suffix carries the actual issue ordering). */
+export async function registerAggregate(db: any, family: string): Promise<RegisterAggregate | null> {
+  try {
+    const digits = family.replace(/^[A-Za-z]+/, "");
+    const rows = await db
+      .prepare(
+        "SELECT num, family, holder, model, year, status, pdf_key FROM certificates WHERE family = ?1 ORDER BY CAST(year AS INTEGER) DESC, num DESC LIMIT 1",
+      )
+      .bind(digits)
+      .all();
+    const totals = await db
+      .prepare("SELECT COUNT(*) AS n, SUM(CASE WHEN status = 'Valid' THEN 1 ELSE 0 END) AS valid, SUM(CASE WHEN status = 'Suspended' THEN 1 ELSE 0 END) AS suspended FROM certificates WHERE family = ?1")
+      .bind(digits)
+      .first();
+    if (!totals || !totals.n) return null;
+    return {
+      family: digits,
+      count: Number(totals.n),
+      valid: Number(totals.valid ?? 0),
+      suspended: Number(totals.suspended ?? 0),
+      latest: ((rows.results ?? [])[0] as RegisterRow) ?? null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/** The aggregate's authoritative note: the numbers are DATA — the
+ *  model narrates, never recomputes. The edition disclaimer rides every
+ *  family-scoped answer (the register has no edition dimension). */
+export function aggregateNote(agg: RegisterAggregate): string {
+  const latest = agg.latest
+    ? `The latest certificate in the snapshot is ${agg.latest.num} (holder ${agg.latest.holder}, model "${agg.latest.model}"${agg.latest.year ? `, issued ${agg.latest.year}` : ""}, status ${agg.latest.status}).`
+    : "No certificate rows are present in the snapshot.";
+  const link = agg.latest?.pdf_key
+    ? ` Its document: https://www.oimlsmart.org/cert-pdf/${agg.latest.pdf_key}`
+    : "";
+  return [
+    `CERTIFICATE REGISTER — THIS NOTE ANSWERS THE QUESTION. Answer from THIS note; do not refuse for want of passages (the retrieval passages are irrelevant for register questions).`,
+    `The ${agg.family} family holds ${agg.count} certificate${agg.count === 1 ? "" : "s"} (${agg.valid} valid${agg.suspended ? `, ${agg.suspended} suspended` : ""}) — computed over the register snapshot; state these numbers verbatim.`,
+    latest + link,
+    "Certificates are issued per RECOMMENDATION FAMILY — the register carries no edition dimension, so an edition named in the question (e.g. 2021) does not narrow it; say so when the question names an edition. Qualify that the register is a snapshot, and cite the register.",
+  ].join("\n");
+}
+
+/** A typed block for aggregate answers — the UI renders the count and
+ *  the latest row's link as data, never from prose. */
+export function aggregateBlock(agg: RegisterAggregate) {
+  return {
+    type: "register",
+    payload: {
+      family: agg.family,
+      count: agg.count,
+      valid: agg.valid,
+      ...(agg.suspended ? { suspended: agg.suspended } : {}),
+      ...(agg.latest
+        ? {
+            latest: {
+              num: agg.latest.num,
+              holder: agg.latest.holder,
+              model: agg.latest.model,
+              year: agg.latest.year,
+              status: agg.latest.status,
+              ...(agg.latest.pdf_key ? { url: `/cert-pdf/${agg.latest.pdf_key}` } : {}),
+            },
+          }
+        : {}),
+    },
+  };
+}
+
 /** Search tokens: words that can identify a holder or a model — words of
  *  2+ characters that are not register question words, plus bare model
  *  numbers ("190", "HM14H1"). Upper-cased tokens match case-insensitively
@@ -46,6 +142,18 @@ export function printedCertificateNumber(query: string): string | null {
   return m ? m[1].replace(/\s+/g, "").replace(/-\./, ".") : null;
 }
 
+function editionSuffixYears(query: string): Set<string> {
+  // "R 60:2021", "R 60-1:2021" — the EDITION carries no register
+  // meaning (certificates key on family); its bare year token would
+  // poison the token arms (the "2021" matched nothing: issue scheme
+  // years differ from edition years). Collect them for stripping.
+  const years = new Set<string>();
+  for (const m of query.matchAll(/\b([RDMB])\s?-?\d{2,3}(?:-\d+)?\s?:\s?(\d{4})\b/gi)) {
+    years.add(m[2]!);
+  }
+  return years;
+}
+
 export function registerTokens(query: string): string[] {
   const stop = new Set([
     "the", "a", "an", "is", "are", "was", "were", "still", "currently", "in", "on", "for", "of", "and", "or",
@@ -55,9 +163,12 @@ export function registerTokens(query: string): string[] {
   ]);
   const tokens: string[] = [];
   const publisherWord = P().publisher.name.toLowerCase();
+  const editionYears = editionSuffixYears(query);
+  const stop2 = new Set([...stop, "many", "issued", "issue", "issued", "latest", "newest", "recent", "total", "number"]);
   for (const w of query.split(/[^A-Za-z0-9&-]+/)) {
     if (w.length < 2) continue;
-    if (stop.has(w.toLowerCase())) continue;
+    if (stop2.has(w.toLowerCase())) continue;
+    if (/^\d{4}$/.test(w) && editionYears.has(w)) continue; // an edition year, not an issue filter
     if (w.toLowerCase() === publisherWord) continue;
     if (/^\d+$/.test(w) && w.length < 2) continue;
     if (!tokens.includes(w)) tokens.push(w);