@konneal/engine 0.2.122 → 0.2.123

package/dist/{ask-J4QFS6Q2.js → ask-2BYMHPT3.js}

@@ -1,14 +1,14 @@
 import {
   handleAsk
-} from "./chunk-BRUHQEOT.js";
-import "./chunk-FKG5VGOL.js";
+} from "./chunk-U6FXEUZP.js";
+import "./chunk-3L6TJAS6.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-IOT75KLU.js";
 import "./chunk-3FYJM7LH.js";
 export {
   handleAsk

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

@@ -1,20 +1,28 @@
 import {
+  aggregateBlock,
+  aggregateNote,
   buildRegisterQuery,
   certificateLinks,
   isRegisterShaped,
   printedCertificateNumber,
   queryFamily,
+  registerAggregate,
+  registerAggregateIntent,
   registerNote,
   registerTokens,
   searchRegister
-} from "./chunk-JZFXSTYX.js";
+} from "./chunk-IOT75KLU.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-FKG5VGOL.js → chunk-3L6TJAS6.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-TDPN7SA2.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-JZFXSTYX.js → chunk-IOT75KLU.js}

@@ -6,6 +6,61 @@ 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 (authoritative computation over the snapshot): the ${agg.family} family holds ${agg.count} certificate${agg.count === 1 ? "" : "s"} (${agg.valid} valid${agg.suspended ? `, ${agg.suspended} suspended` : ""}).`,
+    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. State the family total, qualify that the register is a snapshot, and cite these numbers verbatim."
+  ].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 +69,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 +126,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 +215,10 @@ ${absent.join("\n")}`);
 
 export {
   isRegisterShaped,
+  registerAggregateIntent,
+  registerAggregate,
+  aggregateNote,
+  aggregateBlock,
   queryFamily,
   printedCertificateNumber,
   registerTokens,

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

@@ -22,7 +22,7 @@ import {
   tableRetyped,
   toolNote,
   verdictNote
-} from "./chunk-FKG5VGOL.js";
+} from "./chunk-3L6TJAS6.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-IOT75KLU.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-EI6M4AY2.js}

@@ -4,7 +4,7 @@ import {
   parseToolCall,
   runTool,
   toolNote
-} from "./chunk-FKG5VGOL.js";
+} from "./chunk-3L6TJAS6.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-U6FXEUZP.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
   modelGroundingBlock
-} from "../../chunk-FKG5VGOL.js";
+} from "../../chunk-3L6TJAS6.js";
 import {
   handleSearch
 } from "../../chunk-P6IRYZLL.js";
@@ -68,7 +68,7 @@ import {
   sha256Hex,
   today
 } from "../../chunk-VT7DR6NQ.js";
-import "../../chunk-JZFXSTYX.js";
+import "../../chunk-IOT75KLU.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-EI6M4AY2.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-2BYMHPT3.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.123",
   "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,101 @@ 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 (authoritative computation over the snapshot): the ${agg.family} family holds ${agg.count} certificate${agg.count === 1 ? "" : "s"} (${agg.valid} valid${agg.suspended ? `, ${agg.suspended} suspended` : ""}).`,
+    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. State the family total, qualify that the register is a snapshot, and cite these numbers verbatim.",
+  ].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 +141,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 +162,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);