@konneal/engine 0.2.97 → 0.2.99

package/dist/ask-W6NUC3MG.js

@@ -0,0 +1,15 @@
+import {
+  handleAsk
+} from "./chunk-2SWMTCVX.js";
+import "./chunk-QNLFNEI4.js";
+import "./chunk-TXPWLKCI.js";
+import "./chunk-KNCRYAX3.js";
+import "./chunk-DTW4UW2E.js";
+import "./chunk-A3QHHUN5.js";
+import "./chunk-U4ERFUOK.js";
+import "./chunk-BOAITSVV.js";
+import "./chunk-JZFXSTYX.js";
+import "./chunk-3FYJM7LH.js";
+export {
+  handleAsk
+};

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

@@ -18,7 +18,7 @@ import {
   tableRetyped,
   toolNote,
   verdictNote
-} from "./chunk-AJU6LMY3.js";
+} from "./chunk-QNLFNEI4.js";
 import {
   NO_CONTEXT,
   answerQuality,
@@ -56,20 +56,20 @@ import {
   tokenBudget,
   understandQuery,
   usageTotal
-} from "./chunk-PTCDEFI3.js";
+} from "./chunk-TXPWLKCI.js";
 import {
   embed,
   generateOnce,
   portModelRunner,
   portStore
-} from "./chunk-LOBYXEVD.js";
+} from "./chunk-KNCRYAX3.js";
 import {
   corsHeaders,
   err,
   json,
   readJson,
   validateQuery
-} from "./chunk-SPKPH54J.js";
+} from "./chunk-DTW4UW2E.js";
 import {
   canonicalRefusal,
   refusalAnswer
@@ -79,7 +79,7 @@ import {
   requestSalt,
   resolveRequestScope,
   standardKeysFrom
-} from "./chunk-LVZTWUVJ.js";
+} from "./chunk-U4ERFUOK.js";
 import {
   LIMITS,
   MODELS,
@@ -90,7 +90,7 @@ import {
   requestEffort,
   roleModel,
   sha256Hex
-} from "./chunk-2PCUAJJO.js";
+} from "./chunk-BOAITSVV.js";
 import {
   certificateLinks,
   registerNote,

package/dist/{chunk-2PCUAJJO.js → chunk-BOAITSVV.js}

@@ -65,6 +65,7 @@ var THRESHOLDS = {
    *  pool below the primary dense lane; they must earn their window
    *  slot under the cross-encoder, not by graph membership alone. */
   graphLaneDiscount: 0.75,
+  licensedLaneScore: 0.5,
   /** The entailment gate (TODO.new-era/10): the faithfulness scorer
    *  promoted from eval-only onto the serving path. The confidence line
    *  then states a measurement — claim support in the cited passages —

package/dist/{chunk-SPKPH54J.js → chunk-DTW4UW2E.js}

@@ -1,7 +1,7 @@
 import {
   LIMITS,
   sha256Hex
-} from "./chunk-2PCUAJJO.js";
+} from "./chunk-BOAITSVV.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";

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

@@ -6,27 +6,27 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "./chunk-PTCDEFI3.js";
+} from "./chunk-TXPWLKCI.js";
 import {
   portModelRunner
-} from "./chunk-LOBYXEVD.js";
+} from "./chunk-KNCRYAX3.js";
 import {
   corsHeaders,
   err,
   json,
   readJson,
   validateQuery
-} from "./chunk-SPKPH54J.js";
+} from "./chunk-DTW4UW2E.js";
 import {
   entitlementScope,
   standardKeysFrom
-} from "./chunk-LVZTWUVJ.js";
+} from "./chunk-U4ERFUOK.js";
 import {
   LIMITS,
   MODELS,
   num,
   sha256Hex
-} from "./chunk-2PCUAJJO.js";
+} from "./chunk-BOAITSVV.js";
 
 // workers/worker_public/src/search.ts
 async function handleSearch(env, ctx, req, tier, key) {

package/dist/{chunk-LOBYXEVD.js → chunk-KNCRYAX3.js}

@@ -1,7 +1,7 @@
 import {
   answerEffort,
   effortBudget
-} from "./chunk-2PCUAJJO.js";
+} from "./chunk-BOAITSVV.js";
 
 // workers/worker_public/src/ai.ts
 var delay = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{chunk-AJU6LMY3.js → chunk-QNLFNEI4.js}

@@ -2,14 +2,15 @@ import {
   embed,
   hasLane,
   portIndex,
-  portModelRunner
-} from "./chunk-LOBYXEVD.js";
+  portModelRunner,
+  portStore
+} from "./chunk-KNCRYAX3.js";
 import {
   standardKeysFrom
-} from "./chunk-LVZTWUVJ.js";
+} from "./chunk-U4ERFUOK.js";
 import {
   THRESHOLDS
-} from "./chunk-2PCUAJJO.js";
+} from "./chunk-BOAITSVV.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";
@@ -920,6 +921,140 @@ var bibEntry = {
     }
   }
 };
+async function unitByTerm(store, term) {
+  const t = term.trim();
+  if (!t) return null;
+  const q = (where, bind) => store.prepare(`SELECT * FROM units_db WHERE ${where} LIMIT 1`).bind(...bind).all().catch(() => ({ results: [] }));
+  const exact = await q("code = ?1 OR short = ?1 OR LOWER(name_en) = LOWER(?1)", [t]);
+  let rows = exact.results ?? [];
+  if (rows.length) return rows[0];
+  const sym = await q("LOWER(json_extract(symbols, '$.ascii')) = LOWER(?1)", [t]);
+  rows = sym.results ?? [];
+  if (rows.length) return rows[0];
+  const like = await q("LOWER(short) LIKE LOWER(?1) OR LOWER(name_en) LIKE LOWER(?1)", [`%${t}%`]);
+  rows = like.results ?? [];
+  return rows[0] ?? null;
+}
+async function resolveWithPrefix(store, term) {
+  const direct = await unitByTerm(store, term);
+  if (direct) return { unit: direct, prefixFactor: 1, prefixName: null };
+  const t = term.trim();
+  for (let cut = 1; cut < Math.min(t.length, 3); cut++) {
+    const pSym = t.slice(0, cut);
+    const rest = t.slice(cut);
+    if (!rest) continue;
+    const pres = await store.prepare("SELECT id, name_en, symbol, base, power FROM unit_prefixes WHERE symbol = ?1 AND base IS NOT NULL AND power IS NOT NULL").bind(pSym).all().catch(() => ({ results: [] }));
+    const prefix = (pres.results ?? [])[0];
+    if (!prefix) continue;
+    const unit = await unitByTerm(store, rest);
+    if (unit) return { unit, prefixFactor: Math.pow(prefix.base, prefix.power), prefixName: prefix.name_en };
+  }
+  return null;
+}
+var unitsLookup = {
+  name: "units.lookup",
+  description: "Look up a measurement unit in the unitsdb plane: its names and symbols, its dimension, its quantity kinds, and its SI decomposition. Bind a symbol or an everyday unit name to the dataset's canonical unit before computing with it.",
+  params: [{ key: "term", required: true, description: "a unit's code, short name, symbol or plain name, e.g. m, Pa, pascal, meter per second" }],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const term = String(args?.term ?? "").trim();
+    if (term.length < 1) return null;
+    try {
+      const store = portStore(env);
+      const unit = await unitByTerm(store, term);
+      if (!unit) {
+        return { name: "units.lookup", query: term, output: `No unit matches "${term}" in the unitsdb plane. State this plainly.` };
+      }
+      const qtyNames = [];
+      for (const qid of JSON.parse(unit.quantity_ids || "[]")) {
+        const r = await store.prepare("SELECT name_en FROM unit_quantities WHERE id = ?1").bind(qid).all().catch(() => ({ results: [] }));
+        const n = (r.results ?? [])[0]?.name_en;
+        if (n) qtyNames.push(n);
+      }
+      const roots = JSON.parse(unit.root_units || "[]");
+      const rootNames = await Promise.all(
+        roots.map(async (r) => {
+          const row = await unitByTerm(store, r.code);
+          return `${row?.short ?? r.code}^${r.power}`;
+        })
+      );
+      const symbols = JSON.parse(unit.symbols || "null");
+      return {
+        name: "units.lookup",
+        query: term,
+        output: JSON.stringify({
+          code: unit.code,
+          name_en: unit.name_en,
+          name_fr: unit.name_fr,
+          symbol: symbols?.ascii ?? null,
+          si_root: !!unit.root,
+          unit_system: unit.unit_system,
+          dimension: unit.dimension_ascii,
+          quantities: qtyNames.slice(0, 4),
+          si_decomposition: rootNames,
+          scale: unit.scale
+        })
+      };
+    } catch {
+      return null;
+    }
+  }
+};
+var unitsConvert = {
+  name: "units.convert",
+  description: "Convert a value between two measurement units through the unitsdb plane. SI-coherent units convert exactly (prefix powers over the same dimension); a non-SI unit is stated honestly \u2014 the dataset defines a ratio scale for it, not a factor, and none is invented.",
+  params: [
+    { key: "value", required: true, description: "the numeric value to convert" },
+    { key: "from_unit", required: true, description: "the source unit, e.g. kPa, km, m" },
+    { key: "to_unit", required: true, description: "the target unit, e.g. Pa, m" }
+  ],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const value = Number(args?.value);
+    const fromTerm = String(args?.from_unit ?? "").trim();
+    const toTerm = String(args?.to_unit ?? "").trim();
+    if (!Number.isFinite(value) || !fromTerm || !toTerm) return null;
+    try {
+      const store = portStore(env);
+      const from = await resolveWithPrefix(store, fromTerm);
+      const to = await resolveWithPrefix(store, toTerm);
+      if (!from || !to) {
+        const missing = !from ? fromTerm : toTerm;
+        return { name: "units.convert", query: `${value} ${fromTerm} \u2192 ${toTerm}`, output: `No unit matches "${missing}" in the unitsdb plane. State this plainly.` };
+      }
+      if ((from.unit.dimension_ascii ?? "") !== (to.unit.dimension_ascii ?? "")) {
+        return {
+          name: "units.convert",
+          query: `${value} ${fromTerm} \u2192 ${toTerm}`,
+          output: `Not convertible: ${fromTerm} carries dimension ${from.unit.dimension_ascii ?? "unknown"} and ${toTerm} carries ${to.unit.dimension_ascii ?? "unknown"}. State this plainly.`
+        };
+      }
+      const coherent = (u) => !!u.unit_system && u.unit_system.toLowerCase().startsWith("si");
+      if (!coherent(from.unit) || !coherent(to.unit)) {
+        const nonSi = !coherent(from.unit) ? fromTerm : toTerm;
+        return {
+          name: "units.convert",
+          query: `${value} ${fromTerm} \u2192 ${toTerm}`,
+          output: `The dataset defines no numeric factor for ${nonSi} (a non-SI unit carried on a ${from.unit.scale ?? to.unit.scale ?? "ratio"} scale) \u2014 no factor is invented. State this plainly; the caller may supply the factor itself.`
+        };
+      }
+      const result = value * from.prefixFactor / to.prefixFactor;
+      return {
+        name: "units.convert",
+        query: `${value} ${fromTerm} \u2192 ${toTerm}`,
+        output: JSON.stringify({
+          value,
+          from: `${from.prefixName ? from.prefixName + " " : ""}${from.unit.name_en}`,
+          to: `${to.prefixName ? to.prefixName + " " : ""}${to.unit.name_en}`,
+          dimension: from.unit.dimension_ascii,
+          result
+        })
+      };
+    } catch {
+      return null;
+    }
+  }
+};
 var glossaryLookup = {
   name: "glossary.lookup",
   description: "Look up a defined term in the terminology datasets \u2014 the concept's definition and its defining publication. Bind everyday words to the defined term before interpreting a question.",
@@ -988,7 +1123,7 @@ var certificatesSearch = {
     return { name: "certificates.search", query, output };
   }
 };
-var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry];
+var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry, unitsLookup, unitsConvert];
 var TOOL_DECLARATION = [
   "You may use one tool before answering, by writing a single line:",
   ...TOOLS_REGISTRY.filter((t) => t.audiences.includes("agent")).map((t) => {

package/dist/{chunk-PTCDEFI3.js → chunk-TXPWLKCI.js}

@@ -3,12 +3,13 @@ import {
   hasLane,
   portIndex,
   portModelRunner,
+  portStore,
   rerank
-} from "./chunk-LOBYXEVD.js";
+} from "./chunk-KNCRYAX3.js";
 import {
   bubbleConfirmPage,
   isAllowedBubbleOrigin
-} from "./chunk-SPKPH54J.js";
+} from "./chunk-DTW4UW2E.js";
 import {
   DATASETS,
   LIMITS,
@@ -18,7 +19,7 @@ import {
   processExpansion,
   sha256Hex,
   today
-} from "./chunk-2PCUAJJO.js";
+} from "./chunk-BOAITSVV.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";
@@ -22523,29 +22524,35 @@ var graphLane = {
 };
 
 // workers/worker_public/src/stages/licensedLane.ts
+var sha1Hex = async (s8) => {
+  const digest = await crypto.subtle.digest("SHA-1", new TextEncoder().encode(s8));
+  return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
+};
 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 } }
-    });
-  },
+  when: (c) => !!c.opts.licensedDocNumbers?.length,
   run: async (c) => {
-    const g = await c.lane["licensed-lane"];
+    const standards = c.opts.licensedDocNumbers;
+    const placeholders = standards.map((_, i) => `?${i + 1}`).join(",");
+    const rows = await portStore(c.env).prepare(`SELECT standard, node_id FROM model_nodes WHERE standard IN (${placeholders}) LIMIT 40`).bind(...standards).all().catch(() => ({ results: [] }));
+    const ids = await Promise.all(
+      (rows.results ?? []).map(
+        async (r) => "m" + (await sha1Hex(`${r.standard}|${r.node_id}`)).slice(0, 16)
+      )
+    );
+    if (!ids.length) return;
+    const matches = await portIndex(c.env, "public").getByIds(ids);
     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 });
+    for (const m of matches) {
+      if (m.metadata && !seenIds.has(m.id)) {
+        c.matches.push({ id: m.id, score: THRESHOLDS.licensedLaneScore, metadata: m.metadata });
         seenIds.add(m.id);
         merged++;
       }
     }
-    console.log("licensed lane:", g?.length ?? 0, "hits,", merged, "merged");
+    console.log("licensed lane:", ids.length, "units,", matches.length, "vectors,", merged, "merged");
   }
 };
 

package/dist/{chunk-LVZTWUVJ.js → chunk-U4ERFUOK.js}

@@ -1,7 +1,7 @@
 import {
   DATASETS,
   datasetAllowed
-} from "./chunk-2PCUAJJO.js";
+} from "./chunk-BOAITSVV.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";

package/dist/config.d.ts

@@ -37,6 +37,7 @@ export declare const THRESHOLDS: {
      *  pool below the primary dense lane; they must earn their window
      *  slot under the cross-encoder, not by graph membership alone. */
     readonly graphLaneDiscount: 0.75;
+    readonly licensedLaneScore: 0.5;
     /** The entailment gate (TODO.new-era/10): the faithfulness scorer
      *  promoted from eval-only onto the serving path. The confidence line
      *  then states a measurement — claim support in the cited passages —

package/dist/search-EQAOPFCC.js

@@ -0,0 +1,13 @@
+import {
+  handleSearch
+} from "./chunk-GY33RTEO.js";
+import "./chunk-TXPWLKCI.js";
+import "./chunk-KNCRYAX3.js";
+import "./chunk-DTW4UW2E.js";
+import "./chunk-A3QHHUN5.js";
+import "./chunk-U4ERFUOK.js";
+import "./chunk-BOAITSVV.js";
+import "./chunk-3FYJM7LH.js";
+export {
+  handleSearch
+};

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

@@ -4,10 +4,10 @@ import {
   parseToolCall,
   runTool,
   toolNote
-} from "./chunk-AJU6LMY3.js";
-import "./chunk-LOBYXEVD.js";
-import "./chunk-LVZTWUVJ.js";
-import "./chunk-2PCUAJJO.js";
+} from "./chunk-QNLFNEI4.js";
+import "./chunk-KNCRYAX3.js";
+import "./chunk-U4ERFUOK.js";
+import "./chunk-BOAITSVV.js";
 import "./chunk-3FYJM7LH.js";
 export {
   TOOLS_REGISTRY,

package/dist/tools-content.d.ts

@@ -7,4 +7,6 @@ export declare const licensedSection: ToolSpec;
 export declare const verdictEvaluate: ToolSpec;
 export declare const conditionsCheck: ToolSpec;
 export declare const bibEntry: ToolSpec;
+export declare const unitsLookup: ToolSpec;
+export declare const unitsConvert: ToolSpec;
 export declare const glossaryLookup: ToolSpec;

package/dist/worker_mcp/src/index.js

@@ -1,7 +1,7 @@
 import {
   authenticate
-} from "../../chunk-SPKPH54J.js";
-import "../../chunk-2PCUAJJO.js";
+} from "../../chunk-DTW4UW2E.js";
+import "../../chunk-BOAITSVV.js";
 import {
   P,
   setProfile

package/dist/worker_public/src/config.js

@@ -16,7 +16,7 @@ import {
   roleModel,
   sha256Hex,
   today
-} from "../../chunk-2PCUAJJO.js";
+} from "../../chunk-BOAITSVV.js";
 import "../../chunk-3FYJM7LH.js";
 export {
   DATASETS,

package/dist/worker_public/src/index.js

@@ -4,15 +4,15 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-CX3OVN3V.js";
+} from "../../chunk-2SWMTCVX.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
   modelGroundingBlock
-} from "../../chunk-AJU6LMY3.js";
+} from "../../chunk-QNLFNEI4.js";
 import {
   handleSearch
-} from "../../chunk-ZLQMRQOV.js";
+} from "../../chunk-GY33RTEO.js";
 import {
   buildMessages,
   citations,
@@ -34,13 +34,13 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "../../chunk-PTCDEFI3.js";
+} from "../../chunk-TXPWLKCI.js";
 import {
   cfBlobs,
   embed,
   generateOnce,
   portModelRunner
-} from "../../chunk-LOBYXEVD.js";
+} from "../../chunk-KNCRYAX3.js";
 import {
   authenticate,
   corsHeaders,
@@ -49,14 +49,14 @@ import {
   readJson,
   validateQuery,
   withCors
-} from "../../chunk-SPKPH54J.js";
+} from "../../chunk-DTW4UW2E.js";
 import {
   canonicalRefusal
 } from "../../chunk-A3QHHUN5.js";
 import {
   entitlementScope,
   standardKeysFrom
-} from "../../chunk-LVZTWUVJ.js";
+} from "../../chunk-U4ERFUOK.js";
 import {
   LIMITS,
   MODELS,
@@ -67,7 +67,7 @@ import {
   roleModel,
   sha256Hex,
   today
-} from "../../chunk-2PCUAJJO.js";
+} from "../../chunk-BOAITSVV.js";
 import "../../chunk-JZFXSTYX.js";
 import {
   P,
@@ -990,13 +990,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-Z4HQH3QU.js");
+    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-ZNQY6ZMC.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-KKOQH7HK.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-CGQFGYTR.js")).handleSearch(env, ctx, inner, tier, key);
+      const res = name === "ask" ? await (await import("../../ask-W6NUC3MG.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-EQAOPFCC.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/dist/worker_public/src/requestScope.js

@@ -4,8 +4,8 @@ import {
   requestSalt,
   resolveRequestScope,
   standardKeysFrom
-} from "../../chunk-LVZTWUVJ.js";
-import "../../chunk-2PCUAJJO.js";
+} from "../../chunk-U4ERFUOK.js";
+import "../../chunk-BOAITSVV.js";
 import "../../chunk-3FYJM7LH.js";
 export {
   entitlementScope,

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.97",
+  "version": "0.2.99",
   "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/config.ts

@@ -62,6 +62,7 @@ export const THRESHOLDS = {
    *  pool below the primary dense lane; they must earn their window
    *  slot under the cross-encoder, not by graph membership alone. */
   graphLaneDiscount: 0.75,
+  licensedLaneScore: 0.5,
   /** The entailment gate (TODO.new-era/10): the faithfulness scorer
    *  promoted from eval-only onto the serving path. The confidence line
    *  then states a measurement — claim support in the cited passages —

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

@@ -1,38 +1,56 @@
 // 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).
+// merged into the pool before rerank — the public restatements stop
+// out-ranking the licensed package's own machinery (the rank-order gap
+// the quality ledger has documented on every damp-heat run since the
+// eleven-standard wave).
+//
+// Identity, not similarity: the units are resolved from the model
+// plane's own registry (D1 model_nodes by standard) and turned into
+// index ids with the exporter's hash — `m` + sha1(standard|node_id)
+// truncated to 16 — then fetched by id. Vectorize metadata filtering
+// plays no part (measured: REST and binding filters on this index
+// return empty even for values proven present), and no similarity
+// search is needed — the package's units are the package's units, and
+// the pool's cross-encoder ranks them against the question like every
+// other candidate.
 import { THRESHOLDS } from "../config.ts";
-import { portIndex } from "../env.ts";
+import { portIndex, portStore } from "../env.ts";
 import type { Stage } from "./types.ts";
 
+const sha1Hex = async (s: string) => {
+  const digest = await crypto.subtle.digest("SHA-1", new TextEncoder().encode(s));
+  return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, "0")).join("");
+};
+
 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 } },
-    });
-  },
+  when: (c) => !!c.opts.licensedDocNumbers?.length,
   run: async (c) => {
-    const g = (await c.lane["licensed-lane"]!) as any;
+    const standards = c.opts.licensedDocNumbers!;
+    const placeholders = standards.map((_, i) => `?${i + 1}`).join(",");
+    const rows = await portStore(c.env)
+      .prepare(`SELECT standard, node_id FROM model_nodes WHERE standard IN (${placeholders}) LIMIT 40`)
+      .bind(...standards)
+      .all()
+      .catch(() => ({ results: [] }));
+    const ids = await Promise.all(
+      ((rows.results ?? []) as { standard: string; node_id: string }[]).map(async (r) =>
+        "m" + (await sha1Hex(`${r.standard}|${r.node_id}`)).slice(0, 16),
+      ),
+    );
+    if (!ids.length) return;
+    const matches = await portIndex(c.env, "public").getByIds(ids);
     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 });
+    for (const m of matches) {
+      if (m.metadata && !seenIds.has(m.id)) {
+        c.matches.push({ id: m.id, score: THRESHOLDS.licensedLaneScore, metadata: m.metadata });
         seenIds.add(m.id);
         merged++;
       }
     }
-    console.log("licensed lane:", g?.length ?? 0, "hits,", merged, "merged");
+    console.log("licensed lane:", ids.length, "units,", matches.length, "vectors,", merged, "merged");
   },
 };

package/workers/worker_public/src/tools-content.ts

@@ -7,7 +7,7 @@
 // tool-selection quality degrades with menu size.
 import type { ToolSpec } from "./tools.ts";
 import { resolveBlocks } from "./refs.ts";
-import { portIndex, portModelRunner, hasLane } from "./env.ts";
+import { portIndex, portModelRunner, hasLane, portStore } from "./env.ts";
 import { embed } from "./ai.ts";
 import { THRESHOLDS } from "./config.ts";
 import { standardKeysFrom } from "./requestScope.ts";
@@ -428,6 +428,178 @@ export const bibEntry: ToolSpec = {
   },
 };
 
+
+// The unitsdb plane (the owner's 2026-10-05 direction): measurement
+// units as machine-shaped data — the dataset's typed projection in D1
+// (units_db / unit_quantities / unit_prefixes), served as tools agents
+// compute with. Conversion is honest about its scope: SI-coherent
+// units convert through prefix powers; the dataset defines no numeric
+// factors for non-SI units (foot, pound) — a ratio scale is not a
+// factor — and the tool says so instead of inventing one.
+
+interface UnitRow {
+  code: string;
+  short: string | null;
+  name_en: string | null;
+  name_fr: string | null;
+  root: number;
+  symbols: string | null;
+  root_units: string | null;
+  dimension_id: string | null;
+  dimension_ascii: string | null;
+  quantity_ids: string | null;
+  unit_system: string | null;
+  scale: string | null;
+}
+
+async function unitByTerm(store: any, term: string): Promise<UnitRow | null> {
+  const t = term.trim();
+  if (!t) return null;
+  const q = (where: string, bind: unknown[]) =>
+    store.prepare(`SELECT * FROM units_db WHERE ${where} LIMIT 1`).bind(...bind).all().catch(() => ({ results: [] }));
+  const exact = await q("code = ?1 OR short = ?1 OR LOWER(name_en) = LOWER(?1)", [t]);
+  let rows = (exact.results ?? []) as UnitRow[];
+  if (rows.length) return rows[0]!;
+  const sym = await q("LOWER(json_extract(symbols, '$.ascii')) = LOWER(?1)", [t]);
+  rows = (sym.results ?? []) as UnitRow[];
+  if (rows.length) return rows[0]!;
+  const like = await q("LOWER(short) LIKE LOWER(?1) OR LOWER(name_en) LIKE LOWER(?1)", [`%${t}%`]);
+  rows = (like.results ?? []) as UnitRow[];
+  return rows[0] ?? null;
+}
+
+/** A prefixed input ("kPa", "km"): the first symbols name a prefix,
+ *  the remainder a unit — the dataset does not enumerate prefixed
+ *  variants, they are derived. Returns the factor the prefix carries. */
+async function resolveWithPrefix(store: any, term: string): Promise<{ unit: UnitRow; prefixFactor: number; prefixName: string | null } | null> {
+  const direct = await unitByTerm(store, term);
+  if (direct) return { unit: direct, prefixFactor: 1, prefixName: null };
+  const t = term.trim();
+  for (let cut = 1; cut < Math.min(t.length, 3); cut++) {
+    const pSym = t.slice(0, cut);
+    const rest = t.slice(cut);
+    if (!rest) continue;
+    const pres = await store
+      .prepare("SELECT id, name_en, symbol, base, power FROM unit_prefixes WHERE symbol = ?1 AND base IS NOT NULL AND power IS NOT NULL")
+      .bind(pSym)
+      .all()
+      .catch(() => ({ results: [] }));
+    const prefix = (pres.results ?? [])[0] as { id: string; name_en: string | null; symbol: string; base: number; power: number } | undefined;
+    if (!prefix) continue;
+    const unit = await unitByTerm(store, rest);
+    if (unit) return { unit, prefixFactor: Math.pow(prefix.base, prefix.power), prefixName: prefix.name_en };
+  }
+  return null;
+}
+
+export const unitsLookup: ToolSpec = {
+  name: "units.lookup",
+  description:
+    "Look up a measurement unit in the unitsdb plane: its names and symbols, its dimension, its quantity kinds, and its SI decomposition. Bind a symbol or an everyday unit name to the dataset's canonical unit before computing with it.",
+  params: [{ key: "term", required: true, description: "a unit's code, short name, symbol or plain name, e.g. m, Pa, pascal, meter per second" }],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const term = String(args?.term ?? "").trim();
+    if (term.length < 1) return null;
+    try {
+      const store = portStore(env);
+      const unit = await unitByTerm(store, term);
+      if (!unit) {
+        return { name: "units.lookup", query: term, output: `No unit matches "${term}" in the unitsdb plane. State this plainly.` };
+      }
+      const qtyNames: string[] = [];
+      for (const qid of JSON.parse(unit.quantity_ids || "[]") as string[]) {
+        const r = await store.prepare("SELECT name_en FROM unit_quantities WHERE id = ?1").bind(qid).all().catch(() => ({ results: [] }));
+        const n = ((r.results ?? [])[0] as any)?.name_en;
+        if (n) qtyNames.push(n);
+      }
+      const roots: { code: string; power: number }[] = JSON.parse(unit.root_units || "[]");
+      const rootNames = await Promise.all(
+        roots.map(async (r) => {
+          const row = await unitByTerm(store, r.code);
+          return `${row?.short ?? r.code}^${r.power}`;
+        }),
+      );
+      const symbols = JSON.parse(unit.symbols || "null");
+      return {
+        name: "units.lookup",
+        query: term,
+        output: JSON.stringify({
+          code: unit.code,
+          name_en: unit.name_en,
+          name_fr: unit.name_fr,
+          symbol: symbols?.ascii ?? null,
+          si_root: !!unit.root,
+          unit_system: unit.unit_system,
+          dimension: unit.dimension_ascii,
+          quantities: qtyNames.slice(0, 4),
+          si_decomposition: rootNames,
+          scale: unit.scale,
+        }),
+      };
+    } catch {
+      return null;
+    }
+  },
+};
+
+export const unitsConvert: ToolSpec = {
+  name: "units.convert",
+  description:
+    "Convert a value between two measurement units through the unitsdb plane. SI-coherent units convert exactly (prefix powers over the same dimension); a non-SI unit is stated honestly — the dataset defines a ratio scale for it, not a factor, and none is invented.",
+  params: [
+    { key: "value", required: true, description: "the numeric value to convert" },
+    { key: "from_unit", required: true, description: "the source unit, e.g. kPa, km, m" },
+    { key: "to_unit", required: true, description: "the target unit, e.g. Pa, m" },
+  ],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const value = Number(args?.value);
+    const fromTerm = String(args?.from_unit ?? "").trim();
+    const toTerm = String(args?.to_unit ?? "").trim();
+    if (!Number.isFinite(value) || !fromTerm || !toTerm) return null;
+    try {
+      const store = portStore(env);
+      const from = await resolveWithPrefix(store, fromTerm);
+      const to = await resolveWithPrefix(store, toTerm);
+      if (!from || !to) {
+        const missing = !from ? fromTerm : toTerm;
+        return { name: "units.convert", query: `${value} ${fromTerm} → ${toTerm}`, output: `No unit matches "${missing}" in the unitsdb plane. State this plainly.` };
+      }
+      if ((from.unit.dimension_ascii ?? "") !== (to.unit.dimension_ascii ?? "")) {
+        return {
+          name: "units.convert",
+          query: `${value} ${fromTerm} → ${toTerm}`,
+          output: `Not convertible: ${fromTerm} carries dimension ${from.unit.dimension_ascii ?? "unknown"} and ${toTerm} carries ${to.unit.dimension_ascii ?? "unknown"}. State this plainly.`,
+        };
+      }
+      const coherent = (u: UnitRow) => !!u.unit_system && u.unit_system.toLowerCase().startsWith("si");
+      if (!coherent(from.unit) || !coherent(to.unit)) {
+        const nonSi = !coherent(from.unit) ? fromTerm : toTerm;
+        return {
+          name: "units.convert",
+          query: `${value} ${fromTerm} → ${toTerm}`,
+          output: `The dataset defines no numeric factor for ${nonSi} (a non-SI unit carried on a ${from.unit.scale ?? to.unit.scale ?? "ratio"} scale) — no factor is invented. State this plainly; the caller may supply the factor itself.`,
+        };
+      }
+      const result = (value * from.prefixFactor) / to.prefixFactor;
+      return {
+        name: "units.convert",
+        query: `${value} ${fromTerm} → ${toTerm}`,
+        output: JSON.stringify({
+          value,
+          from: `${from.prefixName ? from.prefixName + " " : ""}${from.unit.name_en}`,
+          to: `${to.prefixName ? to.prefixName + " " : ""}${to.unit.name_en}`,
+          dimension: from.unit.dimension_ascii,
+          result,
+        }),
+      };
+    } catch {
+      return null;
+    }
+  },
+};
+
 export const glossaryLookup: ToolSpec = {
   name: "glossary.lookup",
   description:

package/workers/worker_public/src/tools.ts

@@ -64,9 +64,9 @@ const certificatesSearch: ToolSpec = {
   },
 };
 
-import { unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry } from "./tools-content.ts";
+import { unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry, unitsLookup, unitsConvert } from "./tools-content.ts";
 
-export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry];
+export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry, unitsLookup, unitsConvert];
 
 /** The agent loop's protocol declaration, GENERATED from the registry —
  *  the model's tool vocabulary is always the registry's, never a

package/dist/ask-KKOQH7HK.js

@@ -1,15 +0,0 @@
-import {
-  handleAsk
-} from "./chunk-CX3OVN3V.js";
-import "./chunk-AJU6LMY3.js";
-import "./chunk-PTCDEFI3.js";
-import "./chunk-LOBYXEVD.js";
-import "./chunk-SPKPH54J.js";
-import "./chunk-A3QHHUN5.js";
-import "./chunk-LVZTWUVJ.js";
-import "./chunk-2PCUAJJO.js";
-import "./chunk-JZFXSTYX.js";
-import "./chunk-3FYJM7LH.js";
-export {
-  handleAsk
-};

package/dist/search-CGQFGYTR.js

@@ -1,13 +0,0 @@
-import {
-  handleSearch
-} from "./chunk-ZLQMRQOV.js";
-import "./chunk-PTCDEFI3.js";
-import "./chunk-LOBYXEVD.js";
-import "./chunk-SPKPH54J.js";
-import "./chunk-A3QHHUN5.js";
-import "./chunk-LVZTWUVJ.js";
-import "./chunk-2PCUAJJO.js";
-import "./chunk-3FYJM7LH.js";
-export {
-  handleSearch
-};