@konneal/engine 0.2.69 → 0.2.71

package/dist/{ask-UC5IVQDH.js → ask-OUNG3JIC.js}

@@ -1,6 +1,6 @@
 import {
   handleAsk
-} from "./chunk-PENTOBUO.js";
+} from "./chunk-EOQVQBS6.js";
 import "./chunk-TPV5GPY2.js";
 import "./chunk-SPKPH54J.js";
 import "./chunk-A3QHHUN5.js";

package/dist/{chunk-PENTOBUO.js → chunk-EOQVQBS6.js}

@@ -1906,17 +1906,59 @@ ${r.output}`;
 function isOperationIntent(query) {
   return /\b(operations?|endpoints?)\b/i.test(query);
 }
+var ACTION_STEMS = [
+  "updat",
+  "upsert",
+  "writ",
+  "put",
+  "delet",
+  "remov",
+  "read",
+  "fetch",
+  "get",
+  "creat",
+  "declar",
+  "confirm",
+  "approv",
+  "declin",
+  "decide",
+  "revok",
+  "grant",
+  "notify",
+  "advanc",
+  "announc",
+  "download"
+];
+function matchOperations(query, rows) {
+  const q = query.toLowerCase();
+  const stems = ACTION_STEMS.filter((s) => q.includes(s));
+  if (!stems.length) return [];
+  const scored = [];
+  for (const r of rows) {
+    const hay = `${r.anchor} ${r.text}`.toLowerCase();
+    const score = stems.filter((s) => hay.includes(s)).length;
+    if (score > 0) scored.push({ ...r, score });
+  }
+  return scored.sort((a, b) => b.score - a.score).slice(0, 4);
+}
 function catalogNote(anchors) {
   if (!anchors.length) return "";
-  return `The platform's indexed operations (the COMPLETE surface \u2014 every operation the system exposes; the answer must name the operation from this list when one matches the question):
+  return `The COMPLETE name index of the platform's operations:
 ${anchors.map((a) => `- ${a}`).join("\n")}`;
 }
 async function operationsCatalogNote(db, query) {
   if (!isOperationIntent(query)) return void 0;
   try {
-    const rows = (await db.prepare("SELECT clause_anchor FROM chunks WHERE corpus = 'smart-ops' AND clause_anchor IS NOT NULL ORDER BY clause_anchor").all()).results ?? [];
-    const note = catalogNote(rows.map((r) => r.clause_anchor).filter(Boolean));
-    return note || void 0;
+    const rows = (await db.prepare("SELECT clause_anchor AS anchor, substr(text, 1, 220) AS text FROM chunks WHERE corpus = 'smart-ops' AND clause_anchor IS NOT NULL ORDER BY clause_anchor").all()).results ?? [];
+    const opRows = rows.map((r) => ({ anchor: String(r.anchor ?? ""), text: String(r.text ?? "") })).filter((r) => r.anchor);
+    const matched = matchOperations(query, opRows);
+    const parts = [];
+    if (matched.length) {
+      parts.push(`Operations whose description matches the question's action (AUTHORITATIVE \u2014 if one matches, the answer MUST name it and cite its line; never answer that the information is missing):
+${matched.map((m) => `- ${m.text}`).join("\n")}`);
+    }
+    parts.push(catalogNote(opRows.map((r) => r.anchor)));
+    return parts.filter(Boolean).join("\n\n") || void 0;
   } catch {
     return void 0;
   }
@@ -2686,7 +2728,7 @@ Answer account questions from these records ONLY: name the record when you use i
     q.lang,
     keptHistory,
     // stage-extracted graph facts (GraphRAG) ride the same note channel
-    [processNote, eNote, regNote, opsCatalog, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...retrieved.notes ?? []].filter(Boolean).join("\n") || void 0,
+    [opsCatalog, processNote, eNote, regNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...retrieved.notes ?? []].filter(Boolean).join("\n") || void 0,
     summary,
     budget
   );

package/dist/operations.d.ts

@@ -1,3 +1,10 @@
 export declare function isOperationIntent(query: string): boolean;
+export declare function matchOperations(query: string, rows: {
+    anchor: string;
+    text: string;
+}[]): {
+    anchor: string;
+    text: string;
+}[];
 export declare function catalogNote(anchors: string[]): string;
 export declare function operationsCatalogNote(db: any, query: string): Promise<string | undefined>;

package/dist/worker_public/src/index.js

@@ -6,7 +6,7 @@ import {
   modelGroundingBlock,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-PENTOBUO.js";
+} from "../../chunk-EOQVQBS6.js";
 import {
   handleSearch
 } from "../../chunk-FLNX4O7C.js";
@@ -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-UC5IVQDH.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-PBOODCMQ.js")).handleSearch(env, ctx, inner, tier, key);
+    const res = name === "ask" ? await (await import("../../ask-OUNG3JIC.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-PBOODCMQ.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.69",
+  "version": "0.2.71",
   "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

@@ -1148,7 +1148,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
     q.lang,
     keptHistory,
     // stage-extracted graph facts (GraphRAG) ride the same note channel
-    [processNote, eNote, regNote, opsCatalog, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...(retrieved.notes ?? [])].filter(Boolean).join("\n") || undefined,
+    [opsCatalog, processNote, eNote, regNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...(retrieved.notes ?? [])].filter(Boolean).join("\n") || undefined,
     summary,
     budget,
   );

package/workers/worker_public/src/operations.ts

@@ -1,26 +1,53 @@
 // The operations catalog lane (TODO.new-era/6's platform surface): the
-// smart-ops corpus is SMALL (169 operations) and name-addressable. When
-// a question is operation-intent, the ENTIRE operation-name index rides
-// the notes channel — the model matches "updates an entity record" to
-// putEntityRecord semantically from the complete surface, instead of
-// gambling on which sibling passage retrieval happens to surface.
+// smart-ops corpus is SMALL (169 operations) and name-addressable. An
+// operation-intent question gets (1) the operations whose description
+// matches the question's action stems — with their full lines, and (2)
+// the complete name index. The note is AUTHORITATIVE: the model must
+// name the operation from it, never answer from the passages' silence.
 // Pure composition lives here; the D1 call is a thin wrapper.
 
 export function isOperationIntent(query: string): boolean {
   return /\b(operations?|endpoints?)\b/i.test(query);
 }
 
+/** The action stems the register's descriptions use, mapped from the
+ *  words a question actually asks ("updates" → updat; "upserts" shares
+ *  the stem). */
+const ACTION_STEMS = [
+  "updat", "upsert", "writ", "put", "delet", "remov", "read", "fetch", "get", "creat", "declar",
+  "confirm", "approv", "declin", "decide", "revok", "grant", "notify", "advanc", "announc", "download",
+];
+
+export function matchOperations(query: string, rows: { anchor: string; text: string }[]): { anchor: string; text: string }[] {
+  const q = query.toLowerCase();
+  const stems = ACTION_STEMS.filter((s) => q.includes(s));
+  if (!stems.length) return [];
+  const scored: { anchor: string; text: string; score: number }[] = [];
+  for (const r of rows) {
+    const hay = `${r.anchor} ${r.text}`.toLowerCase();
+    const score = stems.filter((s) => hay.includes(s)).length;
+    if (score > 0) scored.push({ ...r, score });
+  }
+  return scored.sort((a, b) => b.score - a.score).slice(0, 4);
+}
+
 export function catalogNote(anchors: string[]): string {
   if (!anchors.length) return "";
-  return `The platform's indexed operations (the COMPLETE surface — every operation the system exposes; the answer must name the operation from this list when one matches the question):\n${anchors.map((a) => `- ${a}`).join("\n")}`;
+  return `The COMPLETE name index of the platform's operations:\n${anchors.map((a) => `- ${a}`).join("\n")}`;
 }
 
 export async function operationsCatalogNote(db: any, query: string): Promise<string | undefined> {
   if (!isOperationIntent(query)) return undefined;
   try {
-    const rows = (await db.prepare("SELECT clause_anchor FROM chunks WHERE corpus = 'smart-ops' AND clause_anchor IS NOT NULL ORDER BY clause_anchor").all()).results ?? [];
-    const note = catalogNote((rows as any[]).map((r) => r.clause_anchor).filter(Boolean));
-    return note || undefined;
+    const rows = (await db.prepare("SELECT clause_anchor AS anchor, substr(text, 1, 220) AS text FROM chunks WHERE corpus = 'smart-ops' AND clause_anchor IS NOT NULL ORDER BY clause_anchor").all()).results ?? [];
+    const opRows = (rows as any[]).map((r) => ({ anchor: String(r.anchor ?? ""), text: String(r.text ?? "") })).filter((r) => r.anchor);
+    const matched = matchOperations(query, opRows);
+    const parts: string[] = [];
+    if (matched.length) {
+      parts.push(`Operations whose description matches the question's action (AUTHORITATIVE — if one matches, the answer MUST name it and cite its line; never answer that the information is missing):\n${matched.map((m) => `- ${m.text}`).join("\n")}`);
+    }
+    parts.push(catalogNote(opRows.map((r) => r.anchor)));
+    return parts.filter(Boolean).join("\n\n") || undefined;
   } catch {
     return undefined; // the lane is optional
   }