@konneal/engine 0.2.75 → 0.2.77

package/dist/{ask-AJJCWGW6.js → ask-DKYIVPNV.js}

@@ -1,12 +1,12 @@
 import {
   handleAsk
-} from "./chunk-XJPJO376.js";
+} from "./chunk-GOYFWC3N.js";
 import "./chunk-7HWJOFTQ.js";
 import "./chunk-SPKPH54J.js";
 import "./chunk-A3QHHUN5.js";
 import "./chunk-LVZTWUVJ.js";
 import "./chunk-2PCUAJJO.js";
-import "./chunk-VGVTIPFW.js";
+import "./chunk-7AQM3GSO.js";
 import "./chunk-3FYJM7LH.js";
 export {
   handleAsk

package/dist/{certificates-DNRUOYRF.js → certificates-YFL4K7O3.js}

@@ -2,16 +2,18 @@ import {
   buildRegisterQuery,
   certificateLinks,
   isRegisterShaped,
+  printedCertificateNumber,
   queryFamily,
   registerNote,
   registerTokens,
   searchRegister
-} from "./chunk-VGVTIPFW.js";
+} from "./chunk-7AQM3GSO.js";
 import "./chunk-3FYJM7LH.js";
 export {
   buildRegisterQuery,
   certificateLinks,
   isRegisterShaped,
+  printedCertificateNumber,
   queryFamily,
   registerNote,
   registerTokens,

package/dist/certificates.d.ts

@@ -20,6 +20,10 @@ export declare function isRegisterShaped(query: string): boolean;
  *  search filters to it, so a question about R 60 never presents R 76
  *  rows. */
 export declare function queryFamily(query: string): string | null;
+/** A PRINTED certificate number on a nameplate ("R76/2006-A-GB1-18.08")
+ *  names the exact register row — it must not be shredded into word
+ *  tokens that compete with it. */
+export declare function printedCertificateNumber(query: string): string | null;
 export declare function registerTokens(query: string): string[];
 /** The register query for a token set. Numeric tokens (a model number
  *  like "190") must match as a STANDALONE value — `LIKE '%190%'` also

package/dist/{chunk-VGVTIPFW.js → chunk-7AQM3GSO.js}

@@ -10,6 +10,10 @@ 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;
 }
+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 registerTokens(query) {
   const stop = /* @__PURE__ */ new Set([
     "the",
@@ -90,6 +94,19 @@ function buildRegisterQuery(tokens) {
 }
 async function searchRegister(db, query, force = false) {
   if (!force && !isRegisterShaped(query)) return null;
+  const printed = printedCertificateNumber(query);
+  if (printed) {
+    try {
+      const seq = printed.replace(/\.\d+$/, "");
+      const res = await db.prepare(`SELECT num, family, holder, model, year, status, pdf_key FROM certificates WHERE REPLACE(num, ' ', '') = ?1 OR REPLACE(num, ' ', '') LIKE ?2 || '%' ORDER BY num LIMIT 6`).bind(printed, seq).all();
+      if ((res.results ?? []).length) {
+        console.log(`register-search: printed-number hit ${printed} \u2192 ${(res.results ?? []).length} rows`);
+        return { rows: res.results ?? [], tokens: [printed] };
+      }
+      console.log(`register-search: printed number ${printed} missed the register \u2014 falling back to tokens`);
+    } catch {
+    }
+  }
   const tokens = registerTokens(query);
   if (!tokens.length) return null;
   const built = buildRegisterQuery(tokens);
@@ -129,6 +146,7 @@ ${links.join("\n")}` : "";
 export {
   isRegisterShaped,
   queryFamily,
+  printedCertificateNumber,
   registerTokens,
   buildRegisterQuery,
   searchRegister,

package/dist/{chunk-XJPJO376.js → chunk-GOYFWC3N.js}

@@ -72,7 +72,7 @@ import {
   certificateLinks,
   registerNote,
   searchRegister
-} from "./chunk-VGVTIPFW.js";
+} from "./chunk-7AQM3GSO.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";
@@ -1896,7 +1896,7 @@ async function runTool(db, call) {
   if (call.name !== "register_search") return null;
   const query = String(call.args?.query ?? "").trim().slice(0, 160);
   if (!query) return null;
-  const { searchRegister: searchRegister2, registerNote: registerNote2 } = await import("./certificates-DNRUOYRF.js");
+  const { searchRegister: searchRegister2, registerNote: registerNote2 } = await import("./certificates-YFL4K7O3.js");
   const reg = await searchRegister2(db, query, true);
   const output = reg?.rows?.length ? registerNote2(reg.rows) : `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: call.name, query, output };
@@ -2020,14 +2020,18 @@ ${matched.map((m) => `- ${m.text}`).join("\n")}`);
 }
 
 // workers/worker_public/prompts/nameplate.md
-var nameplate_default = `You read instrument nameplates. From the photograph, extract the
-manufacturer's name exactly as printed and the model designation exactly
-as printed. Answer with ONLY a JSON object on one line:
+var nameplate_default = `You read instrument nameplates. From the photograph, extract:
 
-{"manufacturer": "\u2026", "model": "\u2026"}
+{"manufacturer": "\u2026", "model": "\u2026", "certificate_number": "\u2026"}
 
-If the photograph shows no manufacturer or no model, use null for the
-missing value. Never guess beyond what is printed.
+- manufacturer: the manufacturer's name exactly as printed, else null.
+- model: the model designation exactly as printed, else null.
+- certificate_number: the OIML certificate number if one is printed
+  (it looks like R76/2006-A-GB1-18.08 \u2014 a family, an edition year, an
+  authority code, a year and a sequence), exactly as printed, else null.
+
+Answer with ONLY the JSON object on one line. Never guess beyond what is
+printed.
 `;
 
 // workers/worker_public/src/nameplate-parse.ts
@@ -2037,36 +2041,52 @@ function parseNameplate(text) {
   try {
     const j = JSON.parse(m[0]);
     const clean = (v) => typeof v === "string" && v.trim() ? v.trim().slice(0, 80) : null;
-    const out = { manufacturer: clean(j.manufacturer), model: clean(j.model) };
-    return out.manufacturer || out.model ? out : null;
+    const out = {
+      manufacturer: clean(j.manufacturer),
+      model: clean(j.model),
+      certificate_number: clean(j.certificate_number)
+    };
+    return out.manufacturer || out.model || out.certificate_number ? out : null;
   } catch {
     return null;
   }
 }
 function nameplateRegisterQuery(np, question) {
   const fam = /\b([RDMB])\s?-?(\d{2,3})\b/i.exec(question);
-  return [np.manufacturer, np.model, fam ? `${fam[1]} ${fam[2]}` : null].filter(Boolean).join(" ");
+  return [np.certificate_number, np.manufacturer, np.model, fam ? `${fam[1]} ${fam[2]}` : null].filter(Boolean).join(" ");
 }
 
 // workers/worker_public/src/nameplate.ts
 async function extractNameplate(ai, model, image) {
-  try {
-    const res = await ai.run(model, {
-      messages: [
-        { role: "system", content: nameplate_default.trimEnd() },
-        { role: "user", content: [{ type: "image_url", image_url: { url: image } }] }
-      ],
-      max_tokens: 512,
-      reasoning_effort: "low"
-    });
-    const text = typeof res?.response === "string" ? res.response : res?.choices?.[0]?.message?.content;
-    const np = parseNameplate(text ?? "");
-    console.log(`nameplate-extract: ${np ? `${np.manufacturer} / ${np.model}` : `no parse (${(text ?? "").slice(0, 120)})`}`);
-    return np;
-  } catch (e) {
-    console.log(`nameplate-extract: FAILED ${String(e).slice(0, 160)}`);
-    return null;
+  for (let attempt = 0; attempt < 2; attempt++) {
+    try {
+      const res = await ai.run(model, {
+        messages: [
+          { role: "system", content: nameplate_default.trimEnd() },
+          { role: "user", content: [{ type: "image_url", image_url: { url: image } }] }
+        ],
+        // the budget rises with the retry's effort — elevated effort under
+        // a flat budget starves the answer on this model (measured,
+        // 2026-09-18: 5/38 at medium with the flat budget); the
+        // temperature is a READING temperature — a transcription task at
+        // default sampling hallucinated brands on a low-res plate
+        // (observed live 2026-10-03: "Tektronix" on a CAS label)
+        max_tokens: attempt === 0 ? 512 : 1536,
+        reasoning_effort: attempt === 0 ? "low" : "medium",
+        temperature: 0.15
+      });
+      const text = typeof res?.response === "string" ? res.response : res?.choices?.[0]?.message?.content;
+      const np = parseNameplate(text ?? "");
+      if (np) {
+        console.log(`nameplate-extract: ${np.manufacturer} / ${np.model}${attempt ? " (on retry)" : ""}`);
+        return np;
+      }
+      console.log(`nameplate-extract: no parse on attempt ${attempt + 1} (${(text ?? "").slice(0, 120)})`);
+    } catch (e) {
+      console.log(`nameplate-extract: FAILED attempt ${attempt + 1} ${String(e).slice(0, 160)}`);
+    }
   }
+  return null;
 }
 
 // workers/worker_public/src/ask.ts

package/dist/nameplate-parse.d.ts

@@ -1,8 +1,10 @@
 export interface Nameplate {
     manufacturer: string | null;
     model: string | null;
+    certificate_number?: string | null;
 }
 export declare function parseNameplate(text: string): Nameplate | null;
-/** The register query the extraction feeds: the nameplate's tokens lead,
- *  the question's family (if named) scopes. */
+/** The register query the extraction feeds: a PRINTED CERTIFICATE NUMBER
+ *  leads (it names the exact row), then the nameplate's tokens, then the
+ *  question's family (if named) scopes. */
 export declare function nameplateRegisterQuery(np: Nameplate, question: string): string;

package/dist/prompts/nameplate.md

@@ -1,8 +1,12 @@
-You read instrument nameplates. From the photograph, extract the
-manufacturer's name exactly as printed and the model designation exactly
-as printed. Answer with ONLY a JSON object on one line:
+You read instrument nameplates. From the photograph, extract:
 
-{"manufacturer": "…", "model": "…"}
+{"manufacturer": "…", "model": "…", "certificate_number": "…"}
 
-If the photograph shows no manufacturer or no model, use null for the
-missing value. Never guess beyond what is printed.
+- manufacturer: the manufacturer's name exactly as printed, else null.
+- model: the model designation exactly as printed, else null.
+- certificate_number: the OIML certificate number if one is printed
+  (it looks like R76/2006-A-GB1-18.08 — a family, an edition year, an
+  authority code, a year and a sequence), exactly as printed, else null.
+
+Answer with ONLY the JSON object on one line. Never guess beyond what is
+printed.

package/dist/worker_public/src/index.js

@@ -6,7 +6,7 @@ import {
   modelGroundingBlock,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-XJPJO376.js";
+} from "../../chunk-GOYFWC3N.js";
 import {
   handleSearch
 } from "../../chunk-KO6DRI7C.js";
@@ -63,7 +63,7 @@ import {
   sha256Hex,
   today
 } from "../../chunk-2PCUAJJO.js";
-import "../../chunk-VGVTIPFW.js";
+import "../../chunk-7AQM3GSO.js";
 import {
   P,
   setProfile
@@ -959,7 +959,7 @@ async function handleMcp(env, ctx, req, tier, key) {
       // stream:false forces the JSON lane (anon defaults to SSE)
       body: JSON.stringify({ ...args, stream: false })
     });
-    const res = name === "ask" ? await (await import("../../ask-AJJCWGW6.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-LVUQLA3C.js")).handleSearch(env, ctx, inner, tier, key);
+    const res = name === "ask" ? await (await import("../../ask-DKYIVPNV.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-LVUQLA3C.js")).handleSearch(env, ctx, inner, tier, key);
     return res.json().catch(() => ({ error: { message: "tool transport failed", status: res.status } }));
   });
   if (out.ok && "accepted" in out) return new Response(null, { status: 202 });

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.75",
+  "version": "0.2.77",
   "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/nameplate.md

@@ -1,8 +1,12 @@
-You read instrument nameplates. From the photograph, extract the
-manufacturer's name exactly as printed and the model designation exactly
-as printed. Answer with ONLY a JSON object on one line:
+You read instrument nameplates. From the photograph, extract:
 
-{"manufacturer": "…", "model": "…"}
+{"manufacturer": "…", "model": "…", "certificate_number": "…"}
 
-If the photograph shows no manufacturer or no model, use null for the
-missing value. Never guess beyond what is printed.
+- manufacturer: the manufacturer's name exactly as printed, else null.
+- model: the model designation exactly as printed, else null.
+- certificate_number: the OIML certificate number if one is printed
+  (it looks like R76/2006-A-GB1-18.08 — a family, an edition year, an
+  authority code, a year and a sequence), exactly as printed, else null.
+
+Answer with ONLY the JSON object on one line. Never guess beyond what is
+printed.

package/workers/worker_public/src/certificates.ts

@@ -38,6 +38,14 @@ export function queryFamily(query: string): string | null {
   return m ? `${m[1].toUpperCase()}${m[2].padStart(2, "0")}` : null;
 }
 
+/** A PRINTED certificate number on a nameplate ("R76/2006-A-GB1-18.08")
+ *  names the exact register row — it must not be shredded into word
+ *  tokens that compete with it. */
+export function printedCertificateNumber(query: string): string | null {
+  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;
+}
+
 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",
@@ -93,6 +101,26 @@ export async function searchRegister(db: any, query: string, force = false): Pro
   // the shaping gate exists for ASK questions (is this a register
   // question?); a TOOL invocation already decided — skip the gate
   if (!force && !isRegisterShaped(query)) return null;
+  // a PRINTED certificate number names the row: query it first, and only
+  // fall back to the token arms when it misses (an extraction may drop a
+  // character; the prefix up to the sequence still scopes the family)
+  const printed = printedCertificateNumber(query);
+  if (printed) {
+    try {
+      const seq = printed.replace(/\.\d+$/, "");
+      const res = await db
+        .prepare(`SELECT num, family, holder, model, year, status, pdf_key FROM certificates WHERE REPLACE(num, ' ', '') = ?1 OR REPLACE(num, ' ', '') LIKE ?2 || '%' ORDER BY num LIMIT 6`)
+        .bind(printed, seq)
+        .all();
+      if ((res.results ?? []).length) {
+        console.log(`register-search: printed-number hit ${printed} → ${(res.results ?? []).length} rows`);
+        return { rows: (res.results ?? []) as RegisterRow[], tokens: [printed] };
+      }
+      console.log(`register-search: printed number ${printed} missed the register — falling back to tokens`);
+    } catch {
+      // fall through to the token arms
+    }
+  }
   const tokens = registerTokens(query);
   if (!tokens.length) return null;
   const built = buildRegisterQuery(tokens);

package/workers/worker_public/src/nameplate-parse.ts

@@ -6,24 +6,30 @@
 export interface Nameplate {
   manufacturer: string | null;
   model: string | null;
+  certificate_number?: string | null;
 }
 
 export function parseNameplate(text: string): Nameplate | null {
   const m = /\{[^{}]*\}/.exec(String(text ?? ""));
   if (!m) return null;
   try {
-    const j = JSON.parse(m[0]) as { manufacturer?: unknown; model?: unknown };
+    const j = JSON.parse(m[0]) as { manufacturer?: unknown; model?: unknown; certificate_number?: unknown };
     const clean = (v: unknown) => (typeof v === "string" && v.trim() ? v.trim().slice(0, 80) : null);
-    const out = { manufacturer: clean(j.manufacturer), model: clean(j.model) };
-    return out.manufacturer || out.model ? out : null;
+    const out = {
+      manufacturer: clean(j.manufacturer),
+      model: clean(j.model),
+      certificate_number: clean(j.certificate_number),
+    };
+    return out.manufacturer || out.model || out.certificate_number ? out : null;
   } catch {
     return null;
   }
 }
 
-/** The register query the extraction feeds: the nameplate's tokens lead,
- *  the question's family (if named) scopes. */
+/** The register query the extraction feeds: a PRINTED CERTIFICATE NUMBER
+ *  leads (it names the exact row), then the nameplate's tokens, then the
+ *  question's family (if named) scopes. */
 export function nameplateRegisterQuery(np: Nameplate, question: string): string {
   const fam = /\b([RDMB])\s?-?(\d{2,3})\b/i.exec(question);
-  return [np.manufacturer, np.model, fam ? `${fam[1]} ${fam[2]}` : null].filter(Boolean).join(" ");
+  return [np.certificate_number, np.manufacturer, np.model, fam ? `${fam[1]} ${fam[2]}` : null].filter(Boolean).join(" ");
 }

package/workers/worker_public/src/nameplate.ts

@@ -14,23 +14,40 @@ export type { Nameplate };
 export { nameplateRegisterQuery };
 
 export async function extractNameplate(ai: any, model: string, image: string): Promise<Nameplate | null> {
-  try {
-    const res: any = await ai.run(model, {
-      messages: [
-        { role: "system", content: nameplatePrompt.trimEnd() },
-        { role: "user", content: [{ type: "image_url", image_url: { url: image } }] },
-      ],
-      max_tokens: 512,
-      reasoning_effort: "low",
-    });
-    const text = typeof res?.response === "string" ? res.response : res?.choices?.[0]?.message?.content;
-    const np = parseNameplate(text ?? "");
-    console.log(`nameplate-extract: ${np ? `${np.manufacturer} / ${np.model}` : `no parse (${(text ?? "").slice(0, 120)})`}`);
-    return np;
-  } catch (e) {
-    console.log(`nameplate-extract: FAILED ${String(e).slice(0, 160)}`);
-    return null; // the bridge is optional — the ask never depends on it
+  // one retry, decided on the RESULT not the error: the observed live
+  // failure (2026-10-03) is a structurally valid response carrying null
+  // fields — the same image the answer model read perfectly a moment
+  // later. A transient vision-call miss must not strand a certificate
+  // question with no register rows.
+  for (let attempt = 0; attempt < 2; attempt++) {
+    try {
+      const res: any = await ai.run(model, {
+        messages: [
+          { role: "system", content: nameplatePrompt.trimEnd() },
+          { role: "user", content: [{ type: "image_url", image_url: { url: image } }] },
+        ],
+        // the budget rises with the retry's effort — elevated effort under
+        // a flat budget starves the answer on this model (measured,
+        // 2026-09-18: 5/38 at medium with the flat budget); the
+        // temperature is a READING temperature — a transcription task at
+        // default sampling hallucinated brands on a low-res plate
+        // (observed live 2026-10-03: "Tektronix" on a CAS label)
+        max_tokens: attempt === 0 ? 512 : 1536,
+        reasoning_effort: attempt === 0 ? "low" : "medium",
+        temperature: 0.15,
+      });
+      const text = typeof res?.response === "string" ? res.response : res?.choices?.[0]?.message?.content;
+      const np = parseNameplate(text ?? "");
+      if (np) {
+        console.log(`nameplate-extract: ${np.manufacturer} / ${np.model}${attempt ? " (on retry)" : ""}`);
+        return np;
+      }
+      console.log(`nameplate-extract: no parse on attempt ${attempt + 1} (${(text ?? "").slice(0, 120)})`);
+    } catch (e) {
+      console.log(`nameplate-extract: FAILED attempt ${attempt + 1} ${String(e).slice(0, 160)}`);
+    }
   }
+  return null; // the bridge is optional — the ask never depends on it
 }
 
 export const nameplateModel = () => MODELS.member;