@konneal/engine 0.2.115 → 0.2.117

package/dist/{ask-RLMNWTHA.js → ask-2XVGJYUK.js}

@@ -1,8 +1,8 @@
 import {
   handleAsk
-} from "./chunk-MUAY4BXY.js";
+} from "./chunk-ABHZUXZ5.js";
 import "./chunk-32UDKBA2.js";
-import "./chunk-A6YQYN3O.js";
+import "./chunk-KRSSSTMV.js";
 import "./chunk-TH5XGPD5.js";
 import "./chunk-DJ65EF5G.js";
 import "./chunk-A3QHHUN5.js";

package/dist/{chunk-MUAY4BXY.js → chunk-ABHZUXZ5.js}

@@ -60,7 +60,7 @@ import {
   tokenBudget,
   understandQuery,
   usageTotal
-} from "./chunk-A6YQYN3O.js";
+} from "./chunk-KRSSSTMV.js";
 import {
   embed,
   generateOnce,

package/dist/{chunk-ZD7SNNGW.js → chunk-CTUT57OK.js}

@@ -6,7 +6,7 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "./chunk-A6YQYN3O.js";
+} from "./chunk-KRSSSTMV.js";
 import {
   portModelRunner
 } from "./chunk-TH5XGPD5.js";

package/dist/{chunk-A6YQYN3O.js → chunk-KRSSSTMV.js}

@@ -22694,15 +22694,35 @@ var federate = {
 };
 
 // workers/worker_public/src/stages/seal.ts
+async function familyChunks(env, familyNumber, query, keep) {
+  const match2 = ftsMatchQuery(query) ?? `"${familyNumber}"`;
+  const rows = await portStore(env).prepare(
+    "SELECT id, doc_id, docidentifier, doctype, doc_number, edition, language, clause_anchor, clause_title, status, superseded_by, corpus, tier, text, unit_id, block, bm25(chunks_fts) AS rank FROM chunks_fts JOIN chunks c ON c.rowid = chunks_fts.rowid WHERE chunks_fts MATCH ?1 AND c.doc_number = ?2 ORDER BY rank LIMIT ?3"
+  ).bind(match2, familyNumber, keep * 4).all().catch(() => ({ results: [] }));
+  return (rows.results ?? []).map((r) => ({
+    id: String(r.id),
+    score: 0,
+    metadata: r,
+    text: String(r.text ?? "")
+  }));
+}
 var seal = {
   name: "seal",
   when: (c) => !!c.opts.sealScope || !!c.opts.editionSteer || !!c.opts.editionExclude,
-  run: (c) => {
+  run: async (c) => {
     const before = c.hits.length;
     const scope = c.opts.sealScope;
     if (scope) {
       c.hits = c.hits.filter((h) => matchesDocScope(h.metadata, scope.doc_number) && (!scope.edition || h.metadata.edition === scope.edition));
       console.log("context seal:", before, "\u2192", c.hits.length, "candidates within", `doc#${scope.doc_number}${scope.edition ? "@" + scope.edition : ""}`);
+      if (c.hits.length === 0) {
+        const familyNumber = scope.doc_number.includes("-") ? scope.doc_number.split("-")[0] : scope.doc_number;
+        const pulled = (await familyChunks(c.env, familyNumber, c.rq || c.query, 12)).filter((h) => matchesDocScope(h.metadata, scope.doc_number) && (!scope.edition || h.metadata.edition === scope.edition)).slice(0, 8).map((h) => ({ ...h, score: 0.5 }));
+        if (pulled.length) {
+          c.hits = pulled;
+          console.log("context seal: pool empty \u2014 pulled", pulled.length, "family chunks from the corpus for", `doc#${scope.doc_number}`);
+        }
+      }
       return;
     }
     const exclude = c.opts.editionExclude;

package/dist/{search-AH4A4SFJ.js → search-GGSBFGQ5.js}

@@ -1,7 +1,7 @@
 import {
   handleSearch
-} from "./chunk-ZD7SNNGW.js";
-import "./chunk-A6YQYN3O.js";
+} from "./chunk-CTUT57OK.js";
+import "./chunk-KRSSSTMV.js";
 import "./chunk-TH5XGPD5.js";
 import "./chunk-DJ65EF5G.js";
 import "./chunk-A3QHHUN5.js";

package/dist/worker_public/src/index.js

@@ -4,7 +4,7 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-MUAY4BXY.js";
+} from "../../chunk-ABHZUXZ5.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
@@ -12,7 +12,7 @@ import {
 } from "../../chunk-32UDKBA2.js";
 import {
   handleSearch
-} from "../../chunk-ZD7SNNGW.js";
+} from "../../chunk-CTUT57OK.js";
 import {
   buildMessages,
   citations,
@@ -34,7 +34,7 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "../../chunk-A6YQYN3O.js";
+} from "../../chunk-KRSSSTMV.js";
 import {
   cfBlobs,
   embed,
@@ -1000,7 +1000,7 @@ async function callToolOnce(env, ctx, _req, tier, key, name, args, t0) {
       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-RLMNWTHA.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-AH4A4SFJ.js")).handleSearch(env, ctx, inner, tier, key);
+      const res = name === "ask" ? await (await import("../../ask-2XVGJYUK.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-GGSBFGQ5.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/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.115",
+  "version": "0.2.117",
   "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/stages/seal.ts

@@ -3,17 +3,60 @@
 // outside the declared family competes for the window; everything
 // inside it does.
 import { matchesDocScope } from "../context.ts";
+import { portStore } from "../env.ts";
+import { ftsMatchQuery } from "../lexical.ts";
+import type { ChunkMeta, Hit } from "../../../shared/chunk";
 import type { Stage } from "./types.ts";
 
+/** The sealed family's chunks, from the D1 corpus directly (the l6a
+ *  law): the declared context's guarantee is that the publication CAN
+ *  answer — a generic question's global ranking need not contain the
+ *  family at all, so an emptied pool pulls the family's own text. */
+async function familyChunks(env: any, familyNumber: string, query: string, keep: number): Promise<Hit[]> {
+  // ftsMatchQuery's OR shape: FTS5's implicit AND over a question's
+  // tokens matches nothing on standards prose (measured: 0 rows for
+  // the exact ask that needed this pull; the OR shape returns the
+  // family). Fetch wide — the edition filter downstream keeps only the
+  // declared edition, and the ranking then does its work.
+  const match = ftsMatchQuery(query) ?? `"${familyNumber}"`;
+  const rows = await portStore(env).prepare(
+    "SELECT id, doc_id, docidentifier, doctype, doc_number, edition, language, clause_anchor, clause_title, status, superseded_by, corpus, tier, text, unit_id, block, bm25(chunks_fts) AS rank FROM chunks_fts JOIN chunks c ON c.rowid = chunks_fts.rowid WHERE chunks_fts MATCH ?1 AND c.doc_number = ?2 ORDER BY rank LIMIT ?3",
+  )
+    .bind(match, familyNumber, keep * 4)
+    .all()
+    .catch(() => ({ results: [] }));
+  return (rows.results ?? []).map((r: any) => ({
+    id: String(r.id),
+    score: 0,
+    metadata: r as unknown as ChunkMeta,
+    text: String(r.text ?? ""),
+  }));
+}
+
 export const seal: Stage = {
   name: "seal",
   when: (c) => !!c.opts.sealScope || !!c.opts.editionSteer || !!c.opts.editionExclude,
-  run: (c) => {
+  run: async (c) => {
     const before = c.hits.length;
     const scope = c.opts.sealScope!;
     if (scope) {
         c.hits = c.hits.filter((h) => matchesDocScope(h.metadata, scope.doc_number) && (!scope.edition || h.metadata.edition === scope.edition));
       console.log("context seal:", before, "→", c.hits.length, "candidates within", `doc#${scope.doc_number}${scope.edition ? "@" + scope.edition : ""}`);
+      if (c.hits.length === 0) {
+        // the declared-context guarantee: the family's own text enters
+        // even when no global ranking carried it — the FTS ranking over
+        // the family grain (the part identity steers by docidentifier
+        // downstream, the same grain law matchesDocScope enforces)
+        const familyNumber = scope.doc_number.includes("-") ? scope.doc_number.split("-")[0] : scope.doc_number;
+        const pulled = (await familyChunks(c.env, familyNumber, c.rq || c.query, 12))
+          .filter((h) => matchesDocScope(h.metadata, scope.doc_number) && (!scope.edition || h.metadata.edition === scope.edition))
+          .slice(0, 8)
+          .map((h) => ({ ...h, score: 0.5 }));
+        if (pulled.length) {
+          c.hits = pulled;
+          console.log("context seal: pool empty — pulled", pulled.length, "family chunks from the corpus for", `doc#${scope.doc_number}`);
+        }
+      }
       return;
     }
     const exclude = c.opts.editionExclude!;