@konneal/engine 0.2.26 → 0.2.28

package/dist/{ask-YN63SADP.js → ask-KELYM6RJ.js}

@@ -1,7 +1,7 @@
 import {
   handleAsk
-} from "./chunk-ADQEM7IS.js";
-import "./chunk-WKG65DBA.js";
+} from "./chunk-INCFGVH3.js";
+import "./chunk-4G5OGWXY.js";
 import "./chunk-2RKYO3OC.js";
 import "./chunk-A3QHHUN5.js";
 import "./chunk-JGKSUSF5.js";

package/dist/{chunk-WKG65DBA.js → chunk-4G5OGWXY.js}

@@ -24405,6 +24405,7 @@ export {
   embed,
   generateOnce,
   ftsMatchQuery,
+  refCodec,
   NO_CONTEXT,
   parseContext,
   namedDocumentIn,

package/dist/{chunk-GAPT3WEN.js → chunk-5LCPKJ6V.js}

@@ -7,7 +7,7 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "./chunk-WKG65DBA.js";
+} from "./chunk-4G5OGWXY.js";
 import {
   corsHeaders,
   err,

package/dist/{chunk-ADQEM7IS.js → chunk-INCFGVH3.js}

@@ -18,6 +18,7 @@ import {
   parseContext,
   portModelRunner,
   rawSessionToken,
+  refCodec,
   resolveDocScope,
   resolveLiveAccount,
   retrievalQuery,
@@ -27,7 +28,7 @@ import {
   syntheticUnderstanding,
   telemetry,
   understandQuery
-} from "./chunk-WKG65DBA.js";
+} from "./chunk-4G5OGWXY.js";
 import {
   corsHeaders,
   err,
@@ -2014,19 +2015,16 @@ ${summary}` }] : [],
   if (aggregationVerdict) console.log("aggregation engine:", aggregationVerdict.operation, aggregationVerdict.table, "\u2192", aggregationVerdict.value);
   let boundaryNote = null;
   let boundaryBoost;
-  let modelEditionBoost;
-  if (boundModel && !boundModel.gated) {
-    const prefix = String(P().sources?.models?.standard_prefix ?? "");
-    if (prefix && boundModel.standard.startsWith(prefix)) {
-      const num3 = boundModel.standard.slice(prefix.length);
-      const family = `${prefix.slice(prefix.lastIndexOf("-") + 1).toUpperCase()}-${num3}`;
-      const row = await env.DB.prepare("SELECT edition FROM documents WHERE family = ?1 AND active = 1 ORDER BY edition DESC LIMIT 1").bind(family).first().catch(() => null);
-      if (row?.edition) modelEditionBoost = String(row.edition);
-    } else {
-      modelEditionBoost = boundModel.standard;
+  let editionBoost;
+  try {
+    const fam = understanding?.doc ? refCodec().familyOf(understanding.doc) : null;
+    if (fam) {
+      const row = await env.DB.prepare("SELECT edition FROM documents WHERE family = ?1 AND active = 1 ORDER BY edition DESC LIMIT 1").bind(fam).first().catch(() => null);
+      if (row?.edition) editionBoost = String(row.edition);
     }
+  } catch {
   }
-  const lexicalBoost = [boundaryBoost, modelEditionBoost].filter(Boolean).join(" ") || void 0;
+  const lexicalBoost = [boundaryBoost, editionBoost].filter(Boolean).join(" ") || void 0;
   if (P().sources?.licensed?.length) {
     const match = matchLicensedTopic(q.query, P().sources.licensed);
     if (match && !(standardKeys?.has(match.entry.key) ?? false)) {
@@ -2369,6 +2367,8 @@ export {
   handleMemories,
   checkQuoteAnchors,
   standardForDocNumber,
+  bindModelNode,
+  modelGroundingBlock,
   scoreJudge,
   handleAsk
 };

package/dist/{search-MSFDEFQG.js → search-4UK3RBEQ.js}

@@ -1,7 +1,7 @@
 import {
   handleSearch
-} from "./chunk-GAPT3WEN.js";
-import "./chunk-WKG65DBA.js";
+} from "./chunk-5LCPKJ6V.js";
+import "./chunk-4G5OGWXY.js";
 import "./chunk-2RKYO3OC.js";
 import "./chunk-A3QHHUN5.js";
 import "./chunk-JGKSUSF5.js";

package/dist/worker_public/src/index.js

@@ -1,13 +1,15 @@
 import {
   handleSearch
-} from "../../chunk-GAPT3WEN.js";
+} from "../../chunk-5LCPKJ6V.js";
 import {
+  bindModelNode,
   checkQuoteAnchors,
   handleAsk,
   handleMemories,
+  modelGroundingBlock,
   scoreJudge,
   standardForDocNumber
-} from "../../chunk-ADQEM7IS.js";
+} from "../../chunk-INCFGVH3.js";
 import {
   buildMessages,
   citations,
@@ -25,11 +27,12 @@ import {
   parseAppliedContext,
   portModelRunner,
   promptVars,
+  refCodec,
   retrieve,
   sessionFrom,
   telemetry,
   understandQuery
-} from "../../chunk-WKG65DBA.js";
+} from "../../chunk-4G5OGWXY.js";
 import {
   authenticate,
   corsHeaders,
@@ -390,7 +393,7 @@ function parseVerdict(text) {
 
 // workers/worker_public/src/faithfulness-context.ts
 function buildJudgeContext(passages, machine = []) {
-  const context = passages.slice(0, 8).map((p, i) => `[${i + 1}] ${p.replace(/\s+/g, " ").slice(0, 900)}`).join("\n");
+  const context = passages.slice(0, 8).map((p, i) => `[${i + 1}] ${p.replace(/\s+/g, " ").slice(0, 1400)}`).join("\n");
   const machineContext = machine.length ? "\n" + machine.slice(0, 6).map((m) => `[M] ${m.replace(/\s+/g, " ").slice(0, 400)}`).join("\n") : "";
   return context + machineContext;
 }
@@ -989,7 +992,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-YN63SADP.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-MSFDEFQG.js")).handleSearch(env, ctx, inner, tier, key);
+    const res = name === "ask" ? await (await import("../../ask-KELYM6RJ.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-4UK3RBEQ.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 });
@@ -1448,7 +1451,18 @@ async function verifyRoute(c) {
   if (!answer || !query) return err(400, "invalid_input", "answer and query are required");
   try {
     const u = await understandQuery(env.AI, roleModel(env, "understand"), query, [], []);
-    const retrieved = await retrieve(env, query, { understanding: u, standardKeys: entitlementScope(standardKeysFrom(body)) });
+    let lexicalBoost;
+    try {
+      const fam = u?.doc_number ? refCodec().familyOf(u.doc_number) : null;
+      if (fam) {
+        const row = await env.DB.prepare("SELECT edition FROM documents WHERE family = ?1 AND active = 1 ORDER BY edition DESC LIMIT 1").bind(fam).first().catch(() => null);
+        if (row?.edition) lexicalBoost = String(row.edition);
+      }
+    } catch {
+    }
+    const bound = await bindModelNode(env, { query, standardKeys: entitlementScope(standardKeysFrom(body)) });
+    const modelGrounding = bound && !bound.gated ? modelGroundingBlock(bound) : null;
+    const retrieved = await retrieve(env, query, { understanding: u, standardKeys: entitlementScope(standardKeysFrom(body)), lexicalBoost });
     const passages = retrieved.hits.map((h) => h.text);
     const anchors = checkQuoteAnchors(answer, passages);
     const refs = [...answer.matchAll(/\[\[u:([^\]]+)\]\]/g)].map((m) => m[1]);
@@ -1459,6 +1473,7 @@ async function verifyRoute(c) {
       { name: "citations_present", deterministic: true, pass: new RegExp(`\\[[^\\]]*(${P().publisher.name})[^\\]]*\\]`).test(answer), detail: "normative claims should carry a passage citation" }
     ];
     const machine = (Array.isArray(body?.blocks) ? body.blocks : []).filter((b) => b?.type === "verdict" && b?.payload).map((b) => [b.payload.check, b.payload.meaning, b.payload.definition, b.payload.violation_meaning].filter((x) => typeof x === "string" && x).join(" \u2014 ")).filter(Boolean);
+    if (modelGrounding) machine.unshift(modelGrounding);
     const faith = await scoreFaithfulness(env.AI, roleModel(env, "grader"), answer, retrieved.hits.map((h) => h.text), machine);
     return json({
       checks,

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.26",
+  "version": "0.2.28",
   "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

@@ -5,6 +5,7 @@
 
 import { LIMITS, MODELS, num, sha256Hex, roleModel, answerEffort, requestEffort, effortBudget } from "./config";
 import { portModelRunner } from "./env.ts";
+import { refCodec } from "./codecs";
 import { buildMessages, citations, retrieve, retrievalQuery, identityNote, splitHistory, listwiseRerank, refusalAnswer, Hit } from "./pipeline";
 import { sessionFrom } from "./auth";
 import { retrieveInternal } from "./internal_gateway";
@@ -858,27 +859,24 @@ async function handleAsk(
   // publication's own clause — surface for a question the document's
   // vocabulary alone would miss
   let boundaryBoost: string | undefined;
-  // the model-bound edition boost: the grounding pool tilts to the
-  // CURRENT edition's chunks (the superseded dirty-corpus editions
-  // otherwise outrank them on shared vocabulary and the answer's model
-  // values read as ungrounded against 2017 passages)
-  let modelEditionBoost: string | undefined;
-  if (boundModel && !boundModel.gated) {
-    const prefix = String(P().sources?.models?.standard_prefix ?? "");
-    if (prefix && boundModel.standard.startsWith(prefix)) {
-      // the profile's package prefix derives the graph family
-      // (<prefix><num> → family <LETTER>-<num>) and the boost is the
-      // family's ACTIVE edition
-      const num = boundModel.standard.slice(prefix.length);
-      const family = `${prefix.slice(prefix.lastIndexOf("-") + 1).toUpperCase()}-${num}`;
+  // the EDITION boost: the grounding pool tilts to the publication's
+  // ACTIVE edition (the graph's own registry) — the dirty corpus's
+  // superseded editions otherwise outrank the current ones on shared
+  // vocabulary, and the answer's current-edition values then read as
+  // ungrounded against superseded passages. The family key is the
+  // profile codec's (familyOf) — no publisher grammar here.
+  let editionBoost: string | undefined;
+  try {
+    const fam = understanding?.doc ? refCodec().familyOf(understanding.doc) : null;
+    if (fam) {
       const row = await env.DB.prepare("SELECT edition FROM documents WHERE family = ?1 AND active = 1 ORDER BY edition DESC LIMIT 1")
-        .bind(family).first<any>().catch(() => null);
-      if (row?.edition) modelEditionBoost = String(row.edition);
-    } else {
-      modelEditionBoost = boundModel.standard; // the doc number is embedded in the id
+        .bind(fam).first<any>().catch(() => null);
+      if (row?.edition) editionBoost = String(row.edition);
     }
+  } catch {
+    // a registry hiccup degrades to unsteered retrieval
   }
-  const lexicalBoost = [boundaryBoost, modelEditionBoost].filter(Boolean).join(" ") || undefined;
+  const lexicalBoost = [boundaryBoost, editionBoost].filter(Boolean).join(" ") || undefined;
   if (P().sources?.licensed?.length) {
     const match = matchLicensedTopic(q.query, P().sources.licensed);
     if (match && !(standardKeys?.has(match.entry.key) ?? false)) {

package/workers/worker_public/src/faithfulness-context.ts

@@ -7,7 +7,7 @@
 export function buildJudgeContext(passages: string[], machine: string[] = []): string {
   const context = passages
     .slice(0, 8)
-    .map((p, i) => `[${i + 1}] ${p.replace(/\s+/g, " ").slice(0, 900)}`)
+    .map((p, i) => `[${i + 1}] ${p.replace(/\s+/g, " ").slice(0, 1400)}`)
     .join("\n");
   const machineContext = machine.length
     ? "\n" + machine.slice(0, 6).map((m) => `[M] ${m.replace(/\s+/g, " ").slice(0, 400)}`).join("\n")

package/workers/worker_public/src/index.ts

@@ -13,7 +13,8 @@ import { ftsMatchQuery } from "./lexical";
 import { scoreFaithfulness } from "./faithfulness";
 import { checkQuoteAnchors } from "./anchors";
 import { namedDocumentIn } from "./context";
-import { standardForDocNumber } from "./modelplane";
+import { standardForDocNumber, bindModelNode, modelGroundingBlock } from "./modelplane";
+import { refCodec } from "./codecs";
 import { entitlementScope, standardKeysFrom } from "./requestScope";
 import type { Env } from "./env";
 export type { Env };
@@ -228,7 +229,24 @@ async function verifyRoute(c: RouteContext): Promise<Response> {
   if (!answer || !query) return err(400, "invalid_input", "answer and query are required");
   try {
     const u = await understandQuery(env.AI, roleModel(env, "understand"), query, [], []);
-    const retrieved = await retrieve(env, query, { understanding: u, standardKeys: entitlementScope(standardKeysFrom(body)) });
+    // the grounding must MIRROR the ask path's: the edition boost (the
+    // publication's active edition, the codec's family) and the model
+    // grounding — a verify that grounds against different passages than
+    // the answer used judges a different answer
+    let lexicalBoost: string | undefined;
+    try {
+      const fam = u?.doc_number ? refCodec().familyOf(u.doc_number) : null;
+      if (fam) {
+        const row = await env.DB.prepare("SELECT edition FROM documents WHERE family = ?1 AND active = 1 ORDER BY edition DESC LIMIT 1")
+          .bind(fam).first().catch(() => null);
+        if (row?.edition) lexicalBoost = String(row.edition);
+      }
+    } catch {
+      // degrade to unsteered retrieval
+    }
+    const bound = await bindModelNode(env, { query, standardKeys: entitlementScope(standardKeysFrom(body)) });
+    const modelGrounding = bound && !bound.gated ? modelGroundingBlock(bound) : null;
+    const retrieved = await retrieve(env, query, { understanding: u, standardKeys: entitlementScope(standardKeysFrom(body)), lexicalBoost });
     const passages = retrieved.hits.map((h: Hit) => h.text);
     const anchors = checkQuoteAnchors(answer, passages);
     const refs = [...answer.matchAll(/\[\[u:([^\]]+)\]\]/g)].map((m) => m[1]);
@@ -246,6 +264,7 @@ async function verifyRoute(c: RouteContext): Promise<Response> {
       .map((b: any) => [b.payload.check, b.payload.meaning, b.payload.definition, b.payload.violation_meaning]
         .filter((x: unknown) => typeof x === "string" && x).join(" — "))
       .filter(Boolean);
+    if (modelGrounding) machine.unshift(modelGrounding);
     const faith = await scoreFaithfulness(env.AI, roleModel(env, "grader"), answer, retrieved.hits.map((h: Hit) => h.text), machine);
     return json({
       checks,