@saasontools/strauss-kb 0.1.11 → 0.1.12

package/dist/cli-main.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   runKbCli
-} from "./chunk-I3WW4F6X.js";
-import "./chunk-OVRQCQ6P.js";
+} from "./chunk-F2U2YLWV.js";
+import "./chunk-33ZCBEUV.js";
 
 // src/cli-main.ts
 runKbCli(process.argv.slice(2)).catch((error) => {

package/dist/index.cjs

@@ -1760,6 +1760,7 @@ ${answer}
     const records = adjudicated.filter((hit) => hit.standing !== "superseded");
     const superseded = adjudicated.filter((hit) => hit.standing === "superseded").map(stub);
     const approxTokens2 = records.reduce((total, hit) => total + estimateTokens(hit.record), 0) + superseded.reduce((total, entry) => total + estimateStubTokens(entry), 0);
+    const bundleDigestValue = bundleDigest(records, superseded);
     if (!options.all && approxTokens2 > budgetTokens) {
       return {
         loaded: false,
@@ -1770,7 +1771,8 @@ ${answer}
           approxTokens: approxTokens2,
           budgetTokens,
           type: options.type
-        })
+        }),
+        digest: bundleDigestValue
       };
     }
     return {
@@ -1779,7 +1781,8 @@ ${answer}
       tokensLoaded: approxTokens2,
       budgetTokens: options.all ? null : budgetTokens,
       records,
-      superseded
+      superseded,
+      digest: bundleDigestValue
     };
   }
   /** How a position was arrived at, as a timeline. See `trace.ts`. */
@@ -2096,6 +2099,22 @@ function normalizeActor(id) {
 function digest(contents) {
   return (0, import_node_crypto2.createHash)("sha256").update(contents).digest("hex");
 }
+function bundleDigest(records, superseded) {
+  const entries = [
+    ...records.map(
+      (hit) => `${hit.record.conceptId}:current:${digest(
+        stringifyMarkdownWithFrontmatter(
+          hit.record.body,
+          hit.record.frontmatter
+        )
+      )}`
+    ),
+    ...superseded.map(
+      (entry) => `${entry.conceptId}:superseded:${digest(JSON.stringify(entry))}`
+    )
+  ].sort();
+  return digest(entries.join("\n"));
+}
 
 // src/record-types.ts
 var RECORD_TYPES = {
@@ -3688,7 +3707,7 @@ var loadCommand = define({
   name: "load",
   tool: "kb_load",
   usage: "load [type] [--budget N | --all] [--repo-root PATH]",
-  description: "Loads the whole knowledge base at once, each record with its standing. Superseded records arrive as stubs (name, replacement, date); rejected and open records arrive whole. Refuses past the token budget rather than truncating \u2014 call kb_catalog, then kb_pack on the record that matters, or narrow with `type`; kb_query for a lookup by wording. `all` bypasses the budget.",
+  description: "Loads the whole knowledge base at once, each record with its standing. Superseded records arrive as stubs; rejected and open records arrive whole. Refuses past the token budget \u2014 call kb_catalog, kb_pack on it; `all` bypasses the budget. Never read record files directly. Cache-stable; `digest` is the base's content stamp \u2014 hooks use it to tell you when to reload.",
   input: import_zod14.z.object({
     bundlePath,
     type: import_zod14.z.enum(KB_RECORD_TYPES).optional(),
@@ -3931,7 +3950,7 @@ var queryCommand = define({
   name: "query",
   tool: "kb_query",
   usage: "query <text...> [--repo-root PATH]",
-  description: "Search and return each match with its standing. Results are flagged, never filtered: a superseded record comes back alongside whatever replaced it, and a rejected one is marked as something explicitly not adopted. This is the lookup-by-wording rung, and the narrowest of the three: use it when you know roughly what the record says. The decision rule around it \u2014 while the base fits kb_load's token budget, kb_load it whole, because on this package's measurements a reader holding the whole base answered eight of nine questions whose wording appears in no record where embedding search answered four; once kb_load refuses, kb_catalog for one line per record and then kb_pack on the record the work centres on; and kb_query when the question is a point lookup rather than a neighbourhood. A query cannot tell you that nothing was decided \u2014 it returns its nearest hit whatever the distance \u2014 so reach for kb_catalog when the question is what exists. Never read record files directly: this tool (with kb_load, kb_catalog, kb_pack and kb_trace) is the only supported way to read a base; a file read bypasses supersession resolution and returns replaced records as if current.",
+  description: "Search; every hit carries its standing. Flagged, never filtered: a superseded hit returns with its replacement, a rejected one is marked. Prefer kb_load when the base fits its budget \u2014 a full read beats search. Results are volatile: place them at the tail, not the cached prefix. Never read record files directly.",
   input: import_zod20.z.object({
     bundlePath,
     text: import_zod20.z.string().optional(),
@@ -4279,7 +4298,7 @@ var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 
 // src/version.ts
-var VERSION = true ? "0.1.11" : "0.0.0-dev";
+var VERSION = true ? "0.1.12" : "0.0.0-dev";
 
 // src/mcp.ts
 function createKbMcpServer() {