@konneal/engine 0.2.94 → 0.2.96

package/dist/{ask-HCKUKBPB.js → ask-KKOQH7HK.js}

@@ -1,8 +1,8 @@
 import {
   handleAsk
-} from "./chunk-2JC7GXRV.js";
-import "./chunk-64IG3ZLT.js";
-import "./chunk-3BL223VD.js";
+} from "./chunk-CX3OVN3V.js";
+import "./chunk-AJU6LMY3.js";
+import "./chunk-PTCDEFI3.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-SPKPH54J.js";
 import "./chunk-A3QHHUN5.js";

package/dist/{chunk-64IG3ZLT.js → chunk-AJU6LMY3.js}

@@ -148,9 +148,11 @@ async function bindModelNode(env, opts) {
   };
   if (opts.standard) return gate(await fetchNode(env, opts.standard, nodeId));
   try {
-    const rows = await env.DB.prepare("SELECT standard FROM model_nodes WHERE node_id = ?1 LIMIT 2").bind(nodeId).all();
-    const standards = (rows?.results ?? []).map((r) => String(r.standard));
-    if (standards.length === 1) return gate(await fetchNode(env, standards[0], nodeId));
+    const rows = await env.DB.prepare(
+      "SELECT n.standard AS standard FROM model_nodes n LEFT JOIN model_plane_meta m ON m.standard = n.standard WHERE n.node_id = ?1 ORDER BY m.indexed_at DESC, n.standard DESC LIMIT 1"
+    ).bind(nodeId).all();
+    const standard = (rows?.results ?? []).map((r) => String(r.standard))[0];
+    if (standard) return gate(await fetchNode(env, standard, nodeId));
     return null;
   } catch {
     return null;

package/dist/{chunk-2JC7GXRV.js → chunk-CX3OVN3V.js}

@@ -18,7 +18,7 @@ import {
   tableRetyped,
   toolNote,
   verdictNote
-} from "./chunk-64IG3ZLT.js";
+} from "./chunk-AJU6LMY3.js";
 import {
   NO_CONTEXT,
   answerQuality,
@@ -56,7 +56,7 @@ import {
   tokenBudget,
   understandQuery,
   usageTotal
-} from "./chunk-3BL223VD.js";
+} from "./chunk-PTCDEFI3.js";
 import {
   embed,
   generateOnce,
@@ -2166,6 +2166,7 @@ ${summary}` }] : [],
   if (aggregationVerdict) console.log("aggregation engine:", aggregationVerdict.operation, aggregationVerdict.table, "\u2192", aggregationVerdict.value);
   let boundaryNote = null;
   let boundaryBoost;
+  let licensedDocNumbers;
   let editionBoost;
   try {
     const fam = understanding?.doc ? refCodec().familyOf(understanding.doc) : null;
@@ -2178,7 +2179,9 @@ ${summary}` }] : [],
   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)) {
+    if (match && (standardKeys?.has(match.entry.key) ?? false)) {
+      licensedDocNumbers = match.entry.package ? [match.entry.package] : void 0;
+    } else if (match && !(standardKeys?.has(match.entry.key) ?? false)) {
       const docNum = match.entry.doc_number ?? "";
       boundaryBoost = docNum || void 0;
       let citing = [];
@@ -2227,7 +2230,8 @@ Answer account questions from these records ONLY: name the record when you use i
       optimisticVec,
       datasetScope: narrowed ? corpora : null,
       standardKeys,
-      lexicalBoost
+      lexicalBoost,
+      licensedDocNumbers
     });
     stageTiming["retrieve-core"] = Date.now() - tR;
     console.log("stage: retrieve", Date.now() - tR, "ms");

package/dist/{chunk-3BL223VD.js → chunk-PTCDEFI3.js}

@@ -22522,6 +22522,33 @@ var graphLane = {
   }
 };
 
+// workers/worker_public/src/stages/licensedLane.ts
+var licensedLane = {
+  name: "licensed-lane",
+  failure: "additive",
+  when: (c) => !!c.opts.licensedDocNumbers?.length && c.vector.length > 0,
+  prefetch: (c) => {
+    c.lane["licensed-lane"] = portIndex(c.env, "public").query({
+      vector: c.vector,
+      topK: 12,
+      filter: { standard: { $in: c.opts.licensedDocNumbers } }
+    });
+  },
+  run: async (c) => {
+    const g = await c.lane["licensed-lane"];
+    const seenIds = new Set(c.matches.map((m) => m.id));
+    let merged = 0;
+    for (const m of (g ?? []).slice(0, 10)) {
+      if (!seenIds.has(m.id)) {
+        c.matches.push({ id: m.id, score: m.score * THRESHOLDS.graphLaneDiscount, metadata: m.metadata });
+        seenIds.add(m.id);
+        merged++;
+      }
+    }
+    console.log("licensed lane:", g?.length ?? 0, "hits,", merged, "merged");
+  }
+};
+
 // workers/worker_public/src/stages/multiQuery.ts
 var RRF_K = 60;
 var multiQuery = {
@@ -23133,6 +23160,7 @@ var STAGES = [
   glossary,
   conceptGraph,
   graphLane,
+  licensedLane,
   multiQuery,
   subQuery,
   poolOpen,

package/dist/{chunk-TJTEBS4S.js → chunk-ZLQMRQOV.js}

@@ -6,7 +6,7 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "./chunk-3BL223VD.js";
+} from "./chunk-PTCDEFI3.js";
 import {
   portModelRunner
 } from "./chunk-LOBYXEVD.js";

package/dist/{search-G76DK4AF.js → search-CGQFGYTR.js}

@@ -1,7 +1,7 @@
 import {
   handleSearch
-} from "./chunk-TJTEBS4S.js";
-import "./chunk-3BL223VD.js";
+} from "./chunk-ZLQMRQOV.js";
+import "./chunk-PTCDEFI3.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-SPKPH54J.js";
 import "./chunk-A3QHHUN5.js";

package/dist/{tools-O7OGW54R.js → tools-Z4HQH3QU.js}

@@ -4,7 +4,7 @@ import {
   parseToolCall,
   runTool,
   toolNote
-} from "./chunk-64IG3ZLT.js";
+} from "./chunk-AJU6LMY3.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-LVZTWUVJ.js";
 import "./chunk-2PCUAJJO.js";

package/dist/worker_public/src/index.js

@@ -4,15 +4,15 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-2JC7GXRV.js";
+} from "../../chunk-CX3OVN3V.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
   modelGroundingBlock
-} from "../../chunk-64IG3ZLT.js";
+} from "../../chunk-AJU6LMY3.js";
 import {
   handleSearch
-} from "../../chunk-TJTEBS4S.js";
+} from "../../chunk-ZLQMRQOV.js";
 import {
   buildMessages,
   citations,
@@ -34,7 +34,7 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "../../chunk-3BL223VD.js";
+} from "../../chunk-PTCDEFI3.js";
 import {
   cfBlobs,
   embed,
@@ -967,26 +967,41 @@ async function handleMcp(env, ctx, req, tier, key) {
   const method = typeof body?.method === "string" ? body.method : null;
   const id = body?.id ?? null;
   const out = await dispatch(method, body?.params, async (name, args) => {
+    const t0 = Date.now();
+    try {
+      return await callToolOnce(env, ctx, req, tier, key, name, args, t0);
+    } catch (e) {
+      telemetry(env, ctx, tier, `mcp:${name}`, null, false, 0, await sha256Hex(`${name}:${JSON.stringify(args ?? {})}`), void 0, void 0, { durationMs: Date.now() - t0 });
+      throw e;
+    }
+  });
+  if (out.ok && "accepted" in out) return new Response(null, { status: 202 });
+  if (out.ok) {
+    if (out.result?.serverInfo) out.result.serverInfo.name = `${P().publisher.id}-rag`;
+    return json({ jsonrpc: "2.0", id, result: out.result });
+  }
+  return json({ jsonrpc: "2.0", id, error: { code: out.code, message: out.message } });
+}
+async function callToolOnce(env, ctx, _req, tier, key, name, args, t0) {
+  {
     const inner = new Request("https://internal/mcp", {
       method: "POST",
       headers: { "content-type": "application/json" },
       // 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-O7OGW54R.js");
+    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-Z4HQH3QU.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");
-      return r ? { tool: r.name, query: r.query, result: r.output } : { error: { message: `tool ${name} returned nothing for the given arguments` } };
+      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-KKOQH7HK.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-CGQFGYTR.js")).handleSearch(env, ctx, inner, tier, key);
+      payload = await res.json().catch(() => ({ error: { message: "tool transport failed", status: res.status } }));
     }
-    const res = name === "ask" ? await (await import("../../ask-HCKUKBPB.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-G76DK4AF.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 });
-  if (out.ok) {
-    if (out.result?.serverInfo) out.result.serverInfo.name = `${P().publisher.id}-rag`;
-    return json({ jsonrpc: "2.0", id, result: out.result });
+    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 });
+    return payload;
   }
-  return json({ jsonrpc: "2.0", id, error: { code: out.code, message: out.message } });
 }
 
 // workers/shared/router.ts

package/package.json

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

@@ -1017,6 +1017,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
   // publication's own clause — surface for a question the document's
   // vocabulary alone would miss
   let boundaryBoost: string | undefined;
+  let licensedDocNumbers: string[] | undefined;
   // 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
@@ -1037,7 +1038,11 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
   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)) {
+    if (match && (standardKeys?.has(match.entry.key) ?? false)) {
+      // the entitled caller: the licensed lane pulls the package's own
+      // units so they compete with (and outrank) the public restatements
+      licensedDocNumbers = match.entry.package ? [match.entry.package] : undefined;
+    } else if (match && !(standardKeys?.has(match.entry.key) ?? false)) {
       const docNum = match.entry.doc_number ?? "";
       boundaryBoost = docNum || undefined;
       let citing: string[] = [];
@@ -1106,7 +1111,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
     // publications there).
     retrieved = await retrieve(env, q.query, { prev, understanding, federate, warmEmbed, graphDocNumbers,
       sealScope: declaredScoped ? docScope : null, optimisticHits, optimisticVec,
-      datasetScope: narrowed ? corpora : null, standardKeys, lexicalBoost });
+      datasetScope: narrowed ? corpora : null, standardKeys, lexicalBoost, licensedDocNumbers });
     stageTiming["retrieve-core"] = Date.now() - tR;
     console.log("stage: retrieve", Date.now() - tR, "ms");
     // ── TTFT surgery: the two post-retrieval LLM calls run IN PARALLEL —

package/workers/worker_public/src/mcp.ts

@@ -6,6 +6,8 @@
 // mcp-proto.ts (dependency-free, unit-tested). The internal-audience
 // server federates both indexes and lives in its own worker, never here.
 import { json, readJson, type ApiKey } from "./lib/http";
+import { sha256Hex } from "./config.ts";
+import { telemetry } from "./quota.ts";
 import { P } from "./profile.ts";
 import { dispatch } from "./mcp-proto.ts";
 import type { Env } from "./env.ts";
@@ -24,6 +26,37 @@ export async function handleMcp(
   const id = body?.id ?? null;
 
   const out = await dispatch(method, body?.params, async (name, args) => {
+    const t0 = Date.now();
+    try {
+      return await callToolOnce(env, ctx, req, tier, key, name, args, t0);
+    } catch (e) {
+      telemetry(env, ctx, tier, `mcp:${name}`, null, false, 0, await sha256Hex(`${name}:${JSON.stringify(args ?? {})}`), undefined, undefined, { durationMs: Date.now() - t0 });
+      throw e;
+    }
+  });
+
+  if (out.ok && "accepted" in out) return new Response(null, { status: 202 });
+  if (out.ok) {
+    if ((out.result as any)?.serverInfo) (out.result as any).serverInfo.name = `${P().publisher.id}-rag`;
+    return json({ jsonrpc: "2.0", id, result: out.result });
+  }
+  return json({ jsonrpc: "2.0", id, error: { code: out.code, message: out.message } });
+}
+
+/** One tools/call dispatch, measured: every MCP surface's tool usage
+ *  lands in the queries table under the mcp:<tool> route — which tools
+ *  agents actually call becomes countable, per tier, per key. */
+async function callToolOnce(
+  env: Env,
+  ctx: Background,
+  _req: Request,
+  tier: "anon" | "key" | "member",
+  key: ApiKey | null,
+  name: string,
+  args: Record<string, unknown>,
+  t0: number,
+) {
+  {
     const inner = new Request("https://internal/mcp", {
       method: "POST",
       headers: { "content-type": "application/json" },
@@ -35,20 +68,17 @@ export async function handleMcp(
     // registry tools (certificates.search, units.get, …) dispatch through
     // the SAME handlers the API would — the no-drift rule, now structural
     const { runTool, TOOLS_REGISTRY } = await import("./tools.ts");
+    let payload: any;
     if (TOOLS_REGISTRY.some((t) => t.name === name && t.audiences.includes("mcp"))) {
       const r = await runTool({ ...env, DB: (env as any).DB }, { name, args }, "mcp");
-      return r ? { tool: r.name, query: r.query, result: r.output } : { error: { message: `tool ${name} returned nothing for the given arguments` } };
+      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")).handleAsk(env, ctx as any, inner, tier, key)
+        : await (await import("./search")).handleSearch(env, ctx as any, inner, tier, key);
+      payload = await res.json().catch(() => ({ error: { message: "tool transport failed", status: res.status } }));
     }
-    const res = name === "ask"
-      ? await (await import("./ask")).handleAsk(env, ctx as any, inner, tier, key)
-      : await (await import("./search")).handleSearch(env, ctx as any, 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 });
-  if (out.ok) {
-    if ((out.result as any)?.serverInfo) (out.result as any).serverInfo.name = `${P().publisher.id}-rag`;
-    return json({ jsonrpc: "2.0", id, result: out.result });
+    telemetry(env, ctx, tier, `mcp:${name}`, null, !payload?.error, JSON.stringify(payload).length, await sha256Hex(`${name}:${JSON.stringify(args ?? {})}`), undefined, undefined, { durationMs: Date.now() - t0 });
+    return payload;
   }
-  return json({ jsonrpc: "2.0", id, error: { code: out.code, message: out.message } });
 }

package/workers/worker_public/src/modelplane.ts

@@ -196,10 +196,22 @@ export async function bindModelNode(
   };
   if (opts.standard) return gate(await fetchNode(env, opts.standard, nodeId));
   try {
-    const rows = await env.DB.prepare("SELECT standard FROM model_nodes WHERE node_id = ?1 LIMIT 2").bind(nodeId).all();
-    const standards = (rows?.results ?? []).map((r: any) => String(r.standard));
-    if (standards.length === 1) return gate(await fetchNode(env, standards[0]!, nodeId));
-    return null; // zero (not indexed) or ambiguous (several standards) — no silent pick
+    // The MECE flip left the retired standards' nodes beside their
+    // successors' (the same node id under oiml-r60 and oiml-r60-lml),
+    // so ambiguity is the COMMON case now. The plane's own registry
+    // breaks the tie: the standard loaded most recently is the
+    // canonical layer for that id (the flip's law — the layer owns its
+    // units), standard name descending as the deterministic second key;
+    // a standard with no meta row (orphaned) sorts last. An id under
+    // zero standards still binds to nothing.
+    const rows = await env.DB.prepare(
+      "SELECT n.standard AS standard FROM model_nodes n LEFT JOIN model_plane_meta m ON m.standard = n.standard WHERE n.node_id = ?1 ORDER BY m.indexed_at DESC, n.standard DESC LIMIT 1",
+    )
+      .bind(nodeId)
+      .all();
+    const standard = (rows?.results ?? []).map((r: any) => String(r.standard))[0];
+    if (standard) return gate(await fetchNode(env, standard, nodeId));
+    return null; // not indexed
   } catch {
     return null;
   }

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

@@ -17,6 +17,7 @@ import { hyde } from "./hyde.ts";
 import { glossary } from "./glossary.ts";
 import { conceptGraph } from "./conceptGraph.ts";
 import { graphLane } from "./graphLane.ts";
+import { licensedLane } from "./licensedLane.ts";
 import { multiQuery } from "./multiQuery.ts";
 import { subQuery } from "./subQuery.ts";
 import { poolOpen } from "./poolOpen.ts";
@@ -46,6 +47,7 @@ export const STAGES: Stage[] = [
   glossary,
   conceptGraph,
   graphLane,
+  licensedLane,
   multiQuery,
   subQuery,
   poolOpen,

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

@@ -0,0 +1,38 @@
+// Licensed lane (additive): an entitled caller whose question is
+// topically about a licensed standard gets that standard's typed units
+// merged into the pool at the graph lane's discount — the public
+// restatements (the Recommendations' own annexes citing the standard)
+// stop out-ranking the licensed package's own units, the rank-order
+// gap the quality ledger has documented on every damp-heat run since
+// the eleven-standard wave. Unentitled callers never see this lane
+// (license-scope would strip the units anyway — the lane simply does
+// not fire).
+import { THRESHOLDS } from "../config.ts";
+import { portIndex } from "../env.ts";
+import type { Stage } from "./types.ts";
+
+export const licensedLane: Stage = {
+  name: "licensed-lane",
+  failure: "additive",
+  when: (c) => !!c.opts.licensedDocNumbers?.length && c.vector.length > 0,
+  prefetch: (c) => {
+    c.lane["licensed-lane"] = portIndex(c.env, "public").query({
+      vector: c.vector,
+      topK: 12,
+      filter: { standard: { $in: c.opts.licensedDocNumbers } },
+    });
+  },
+  run: async (c) => {
+    const g = (await c.lane["licensed-lane"]!) as any;
+    const seenIds = new Set(c.matches.map((m: any) => m.id));
+    let merged = 0;
+    for (const m of (g ?? []).slice(0, 10)) {
+      if (!seenIds.has(m.id)) {
+        c.matches.push({ id: m.id, score: m.score * THRESHOLDS.graphLaneDiscount, metadata: m.metadata });
+        seenIds.add(m.id);
+        merged++;
+      }
+    }
+    console.log("licensed lane:", g?.length ?? 0, "hits,", merged, "merged");
+  },
+};

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

@@ -20,6 +20,10 @@ export interface RetrieveOptions {
   federate?: (query: string) => Promise<Hit[]>;
   warmEmbed?: Promise<number[] | null>;
   graphDocNumbers?: string[];
+  /** The licensed standards the entitled, topically-matched question
+   *  pulls (the licensed lane's metadata filter — the package ids, e.g.
+   *  iec-60068-2-30). Empty/absent for everyone else. */
+  licensedDocNumbers?: string[];
   /** The declared context's HARD seal (TODO.ai-platform/02): when the
    *  panel's chip declares a document scope, the CANDIDATE POOL is cut
    *  to the publication family before rerank + the top-N cut — the