@konneal/engine 0.2.92 → 0.2.94

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

@@ -1,7 +1,7 @@
 import {
   handleAsk
-} from "./chunk-EHABW23I.js";
-import "./chunk-QBWZ6HVP.js";
+} from "./chunk-2JC7GXRV.js";
+import "./chunk-64IG3ZLT.js";
 import "./chunk-3BL223VD.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-SPKPH54J.js";

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

@@ -18,7 +18,7 @@ import {
   tableRetyped,
   toolNote,
   verdictNote
-} from "./chunk-QBWZ6HVP.js";
+} from "./chunk-64IG3ZLT.js";
 import {
   NO_CONTEXT,
   answerQuality,

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

@@ -754,17 +754,17 @@ var verdictEvaluate = {
   description: "Deterministically evaluate a model-plane node's machine checks (OCL boolean expressions, threshold limits) against the quantities a question states. Returns pass/fail with every check's expression and values, or void with the missing parameter names when the question does not state enough. The machine computes; cite the node's clause.",
   params: [
     { key: "node_id", required: true, description: "the model-plane node id, e.g. /req/metrological/repeatability (node ids appear in answers' verdict blocks)" },
-    { key: "question", required: true, description: "the statement carrying the quantities, e.g. 'is mpe 0.02 with n_lc 3000 within the limit?'" }
+    { key: "question", required: true, description: "the statement carrying the quantities, e.g. 'is mpe 0.02 with n_lc 3000 within the limit?'" },
+    { key: "standard", required: false, description: "the package id when the node id indexes under several standards, as the ambiguity message names it" }
   ],
   audiences: ["mcp"],
   handler: async (env, args) => {
     const node_id = String(args?.node_id ?? "").trim();
     const question = String(args?.question ?? "").trim();
+    const standard = args?.standard ? String(args.standard).trim() : null;
     if (!node_id.startsWith("/") || question.length < 4) return null;
     try {
-      const rows = await env.DB.prepare(
-        "SELECT standard, kind, name, content FROM model_nodes WHERE node_id = ?1 LIMIT 2"
-      ).bind(node_id).all();
+      const rows = standard ? await env.DB.prepare("SELECT standard, kind, name, content FROM model_nodes WHERE node_id = ?1 AND standard = ?2 LIMIT 2").bind(node_id, standard).all() : await env.DB.prepare("SELECT standard, kind, name, content FROM model_nodes WHERE node_id = ?1 LIMIT 2").bind(node_id).all();
       const found = rows.results ?? [];
       if (found.length !== 1) {
         return {
@@ -851,6 +851,73 @@ var conditionsCheck = {
     }
   }
 };
+var bibEntry = {
+  name: "bib.entry",
+  description: "Fetch the bibliographic registry record for a citation label: every edition document under it with derived status (in-force/superseded, the ACTIVE flag), the relation edges (successor, amends, variant), and its outgoing citations. Use after graph.cites to resolve a cited label to its own record.",
+  params: [
+    { key: "label", required: true, description: "the citation label exactly as graph.cites returns it, e.g. ISO 8601" }
+  ],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const label = String(args?.label ?? "").trim();
+    if (label.length < 2) return null;
+    try {
+      const rows = await env.DB.prepare(
+        "SELECT id, kind, label FROM graph_nodes WHERE label = ?1 COLLATE NOCASE LIMIT 5"
+      ).bind(label).all();
+      let nodes = rows.results ?? [];
+      if (!nodes.length) {
+        const d = await env.DB.prepare(
+          "SELECT canonical_id, docidentifier FROM documents WHERE docidentifier = ?1 COLLATE NOCASE LIMIT 5"
+        ).bind(label).all();
+        nodes = (d.results ?? []).map((r) => ({
+          id: r.canonical_id,
+          kind: "doc",
+          label: r.docidentifier
+        }));
+      }
+      if (!nodes.length) {
+        return { name: "bib.entry", query: label, output: `No registry node carries the label "${label}". State this plainly.` };
+      }
+      const out = [];
+      for (const n of nodes) {
+        const entry = { label: n.label, kind: n.kind };
+        if (n.kind === "doc") {
+          const d = await env.DB.prepare(
+            "SELECT docidentifier, family, part, edition, derived_status, active, superseded_by, title FROM documents WHERE canonical_id = ?1"
+          ).bind(n.id).all();
+          const doc = (d.results ?? [])[0];
+          if (doc) {
+            entry.document = {
+              docidentifier: doc.docidentifier,
+              family: doc.family,
+              part: doc.part,
+              edition: doc.edition,
+              status: doc.derived_status,
+              active: !!doc.active,
+              superseded_by: doc.superseded_by,
+              title: doc.title
+            };
+          }
+        }
+        const rel = await env.DB.prepare(
+          "SELECT e.kind, n.label AS target FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 LIMIT 25"
+        ).bind(n.id).all();
+        const relations = rel.results ?? [];
+        if (relations.length) entry.relations = relations;
+        const cites = await env.DB.prepare(
+          "SELECT n.label AS cited FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 AND e.kind = 'cites' LIMIT 40"
+        ).bind(n.id).all();
+        const cited = (cites.results ?? []).map((r) => r.cited).filter(Boolean);
+        if (cited.length) entry.cites = cited;
+        out.push(entry);
+      }
+      return { name: "bib.entry", query: label, output: JSON.stringify(out) };
+    } 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.",
@@ -919,7 +986,7 @@ var certificatesSearch = {
     return { name: "certificates.search", query, output };
   }
 };
-var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck];
+var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry];
 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/{tools-PI7IXAL4.js → tools-O7OGW54R.js}

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

package/dist/tools-content.d.ts

@@ -6,4 +6,5 @@ export declare const documentsFamily: ToolSpec;
 export declare const licensedSection: ToolSpec;
 export declare const verdictEvaluate: ToolSpec;
 export declare const conditionsCheck: ToolSpec;
+export declare const bibEntry: ToolSpec;
 export declare const glossaryLookup: ToolSpec;

package/dist/worker_public/src/index.js

@@ -4,12 +4,12 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-EHABW23I.js";
+} from "../../chunk-2JC7GXRV.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
   modelGroundingBlock
-} from "../../chunk-QBWZ6HVP.js";
+} from "../../chunk-64IG3ZLT.js";
 import {
   handleSearch
 } from "../../chunk-TJTEBS4S.js";
@@ -973,12 +973,12 @@ 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 { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-PI7IXAL4.js");
+    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-O7OGW54R.js");
     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` } };
     }
-    const res = name === "ask" ? await (await import("../../ask-UG5UYRJV.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-G76DK4AF.js")).handleSearch(env, ctx, inner, tier, key);
+    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 });

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.92",
+  "version": "0.2.94",
   "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/tools-content.ts

@@ -236,21 +236,22 @@ export const verdictEvaluate: ToolSpec = {
   params: [
     { key: "node_id", required: true, description: "the model-plane node id, e.g. /req/metrological/repeatability (node ids appear in answers' verdict blocks)" },
     { key: "question", required: true, description: "the statement carrying the quantities, e.g. 'is mpe 0.02 with n_lc 3000 within the limit?'" },
+    { key: "standard", required: false, description: "the package id when the node id indexes under several standards, as the ambiguity message names it" },
   ],
   audiences: ["mcp"],
   handler: async (env, args) => {
     const node_id = String(args?.node_id ?? "").trim();
     const question = String(args?.question ?? "").trim();
+    const standard = args?.standard ? String(args.standard).trim() : null;
     if (!node_id.startsWith("/") || question.length < 4) return null;
     try {
       // the same zero-or-ambiguous rule bindModelNode applies: a node
       // id that indexes under exactly one standard resolves; several
-      // or none resolve to nothing — no silent pick
-      const rows = await env.DB.prepare(
-        "SELECT standard, kind, name, content FROM model_nodes WHERE node_id = ?1 LIMIT 2",
-      )
-        .bind(node_id)
-        .all();
+      // or none resolve to nothing — no silent pick (the standard
+      // param is the caller's disambiguator)
+      const rows = standard
+        ? await env.DB.prepare("SELECT standard, kind, name, content FROM model_nodes WHERE node_id = ?1 AND standard = ?2 LIMIT 2").bind(node_id, standard).all()
+        : await env.DB.prepare("SELECT standard, kind, name, content FROM model_nodes WHERE node_id = ?1 LIMIT 2").bind(node_id).all();
       const found = (rows.results ?? []) as { standard: string; kind: string; name: string | null; content: string }[];
       if (found.length !== 1) {
         return {
@@ -339,6 +340,94 @@ export const conditionsCheck: ToolSpec = {
   },
 };
 
+
+// The bibliography record (the owner's 2026-10-04 direction): the full
+// registry entry for one citation label — what documents exist under
+// it, their derived status, the successor/amends/variant edges, and
+// what it cites and is cited by. graph.cites names the labels; this is
+// the record behind the label, for agents that cite properly.
+export const bibEntry: ToolSpec = {
+  name: "bib.entry",
+  description:
+    "Fetch the bibliographic registry record for a citation label: every edition document under it with derived status (in-force/superseded, the ACTIVE flag), the relation edges (successor, amends, variant), and its outgoing citations. Use after graph.cites to resolve a cited label to its own record.",
+  params: [
+    { key: "label", required: true, description: "the citation label exactly as graph.cites returns it, e.g. ISO 8601" },
+  ],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const label = String(args?.label ?? "").trim();
+    if (label.length < 2) return null;
+    try {
+      const rows = await env.DB.prepare(
+        "SELECT id, kind, label FROM graph_nodes WHERE label = ?1 COLLATE NOCASE LIMIT 5",
+      )
+        .bind(label)
+        .all();
+      let nodes = ((rows.results ?? []) as { id: string; kind: string; label: string }[]);
+      if (!nodes.length) {
+        // the docidentifier form ("OIML R 60:2017") is a documents-
+        // registry key, not a graph label (labels are titles) — resolve
+        // it through the registry and synthesize the node rows
+        const d = await env.DB.prepare(
+          "SELECT canonical_id, docidentifier FROM documents WHERE docidentifier = ?1 COLLATE NOCASE LIMIT 5",
+        )
+          .bind(label)
+          .all();
+        nodes = ((d.results ?? []) as { canonical_id: string; docidentifier: string }[]).map((r) => ({
+          id: r.canonical_id,
+          kind: "doc",
+          label: r.docidentifier,
+        }));
+      }
+      if (!nodes.length) {
+        return { name: "bib.entry", query: label, output: `No registry node carries the label "${label}". State this plainly.` };
+      }
+      const out: unknown[] = [];
+      for (const n of nodes) {
+        const entry: Record<string, unknown> = { label: n.label, kind: n.kind };
+        if (n.kind === "doc") {
+          const d = await env.DB.prepare(
+            "SELECT docidentifier, family, part, edition, derived_status, active, superseded_by, title FROM documents WHERE canonical_id = ?1",
+          )
+            .bind(n.id)
+            .all();
+          const doc = (d.results ?? [])[0] as Record<string, unknown> | undefined;
+          if (doc) {
+            entry.document = {
+              docidentifier: doc.docidentifier,
+              family: doc.family,
+              part: doc.part,
+              edition: doc.edition,
+              status: doc.derived_status,
+              active: !!doc.active,
+              superseded_by: doc.superseded_by,
+              title: doc.title,
+            };
+          }
+        }
+        const rel = await env.DB.prepare(
+          "SELECT e.kind, n.label AS target FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 LIMIT 25",
+        )
+          .bind(n.id)
+          .all();
+        const relations = ((rel.results ?? []) as { kind: string; target: string }[]);
+        if (relations.length) entry.relations = relations;
+        const cites = await env.DB.prepare(
+          "SELECT n.label AS cited FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 AND e.kind = 'cites' LIMIT 40",
+        )
+          .bind(n.id)
+          .all();
+        const cited = ((cites.results ?? []) as { cited: string }[]).map((r) => r.cited).filter(Boolean);
+        if (cited.length) entry.cites = cited;
+        out.push(entry);
+      }
+      return { name: "bib.entry", query: label, output: JSON.stringify(out) };
+    } 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 } from "./tools-content.ts";
+import { unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry } from "./tools-content.ts";
 
-export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck];
+export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry];
 
 /** The agent loop's protocol declaration, GENERATED from the registry —
  *  the model's tool vocabulary is always the registry's, never a