@kage-core/kage-graph-mcp 3.1.0 → 3.3.0

package/dist/metrics-math.js

@@ -0,0 +1,71 @@
+"use strict";
+// Pure metric and statistics helpers used by the benchmark/metrics code.
+// This is a dependency-free leaf module: it imports nothing from the kernel,
+// so pulling it out carries no circular-dependency risk. Leaf-first is the
+// safe way to decompose the kernel — extract the bottom of the dependency
+// graph first, where nothing depends back inward.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codingRecallAt = codingRecallAt;
+exports.codingPrecisionAt = codingPrecisionAt;
+exports.codingNdcgAt = codingNdcgAt;
+exports.codingMrr = codingMrr;
+exports.averageNumber = averageNumber;
+exports.percentileNumber = percentileNumber;
+exports.roundDecimal = roundDecimal;
+exports.countByKey = countByKey;
+exports.titleCase = titleCase;
+/** Recall@k: fraction of the relevant set retrieved within the top k. */
+function codingRecallAt(retrieved, relevant, k) {
+    if (!relevant.size)
+        return 0;
+    return retrieved.slice(0, k).filter((item) => relevant.has(item.packet_id)).length / relevant.size;
+}
+/** Precision@k: fraction of the top k that is relevant. */
+function codingPrecisionAt(retrieved, relevant, k) {
+    const rows = retrieved.slice(0, k);
+    return rows.length ? rows.filter((item) => relevant.has(item.packet_id)).length / rows.length : 0;
+}
+/** Normalized discounted cumulative gain at k (binary relevance). */
+function codingNdcgAt(retrieved, relevant, k) {
+    const dcg = retrieved.slice(0, k).reduce((sum, item, index) => sum + (relevant.has(item.packet_id) ? 1 / Math.log2(index + 2) : 0), 0);
+    const idealHits = Math.min(relevant.size, k);
+    let ideal = 0;
+    for (let index = 0; index < idealHits; index += 1)
+        ideal += 1 / Math.log2(index + 2);
+    return ideal ? dcg / ideal : 0;
+}
+/** Mean reciprocal rank: 1 / rank of the first relevant hit, else 0. */
+function codingMrr(retrieved, relevant) {
+    const index = retrieved.findIndex((item) => relevant.has(item.packet_id));
+    return index >= 0 ? 1 / (index + 1) : 0;
+}
+/** Arithmetic mean, 0 for an empty list. */
+function averageNumber(values) {
+    return values.length ? values.reduce((sum, value) => sum + value, 0) / values.length : 0;
+}
+/** p-th percentile (0..1) via nearest-rank, 0 for an empty list. */
+function percentileNumber(values, p) {
+    if (!values.length)
+        return 0;
+    const sorted = values.slice().sort((a, b) => a - b);
+    const index = Math.min(sorted.length - 1, Math.max(0, Math.ceil(sorted.length * p) - 1));
+    return sorted[index];
+}
+/** Round to a fixed number of decimal places. */
+function roundDecimal(value, digits = 2) {
+    const factor = 10 ** digits;
+    return Math.round(value * factor) / factor;
+}
+/** Tally rows by a string key. */
+function countByKey(rows, fn) {
+    const counts = {};
+    for (const row of rows) {
+        const key = fn(row);
+        counts[key] = (counts[key] ?? 0) + 1;
+    }
+    return counts;
+}
+/** Upper-case the first letter of each word. */
+function titleCase(value) {
+    return value.replace(/\b[a-z]/g, (match) => match.toUpperCase());
+}

package/dist/okf.js

@@ -132,8 +132,10 @@ function okfVerifiedStatus(packet) {
         return "superseded";
     if (packet.status === "deprecated")
         return "deprecated";
-    const freshness = packet.freshness;
-    return freshness && freshness.last_verified_at ? "verified" : "unverified";
+    // "verified" is earned, not born: capture provenance (repo_local_agent_capture)
+    // is not a check of the claim. Only an actual recheck (evidence-backed
+    // reverification, validation pass) may carry the label.
+    return (0, kernel_js_1.packetVerificationLabel)(packet);
 }
 // ---- packet -> OKF concept document ----
 function packetToOkfConcept(packet) {
@@ -156,7 +158,8 @@ function packetToOkfConcept(packet) {
     fm.push(`x-kage-status: ${yamlScalar(packet.status)}`);
     fm.push(`x-kage-scope: ${yamlScalar(packet.scope)}`);
     fm.push(`x-kage-visibility: ${yamlScalar(packet.visibility)}`);
-    fm.push(`x-kage-confidence: ${packet.confidence}`);
+    // No x-kage-confidence: the field was a hardcoded 0.7 nobody computed or
+    // consumed — a number that means nothing must not ship as trust metadata.
     fm.push(`x-kage-verified: ${yamlScalar(okfVerifiedStatus(packet))}`);
     if (packet.paths?.length)
         fm.push(`x-kage-paths: ${yamlList(packet.paths)}`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kage-core/kage-graph-mcp",
-  "version": "3.1.0",
-  "description": "Verified memory for coding agents, stored as a Google Open Knowledge Format (OKF) bundle and checked against your code. The verification layer OKF leaves out. MCP server, no account, no API key.",
+  "version": "3.3.0",
+  "description": "Agent memory on Google's Open Knowledge Format (OKF). Kage maintains your coding agents' OKF memory bundle in git and verifies every concept against your code, deterministically. The verification and freshness layer OKF leaves out. MCP server, no account, no API key.",
   "main": "dist/index.js",
   "files": [
     "dist/**/*.js",

package/viewer/console.js

@@ -67,7 +67,7 @@
   // ---- nav ----
   var META = {
     dashboard: ["kage://dashboard", "Dashboard", "Your team's captured knowledge — decisions, runbooks, and fixes — at a glance."],
-    gains: ["kage://gains", "What Kage saved you", "Tokens, dollars, and bad memories caught — receipts, not vibes."],
+    gains: ["kage://gains", "What Kage saved you", "Tokens saved and bad memories caught — receipts, not vibes."],
     overview: ["kage://trust", "Memory trust", "Whether this repo's agent memory can be trusted — at a glance."],
     graph: ["kage://memory-map", "Memory ↔ code map", "Each packet anchored to the files it's grounded in. Hover a node to inspect."],
     memory: ["kage://memory", "Memory", "Every packet Kage has stored, with health and grounding."],
@@ -137,12 +137,6 @@
   // value.json is the raw ledger written by recall: { totals, events[] }. Windows are
   // recomputed here with the same rules as `kage gains` (today = local midnight,
   // 7d = rolling, all-time = totals so trimmed events never lose history).
-  var DOLLARS_PER_MILLION_TOKENS = 15;
-  function dollars(tokens) { return (tokens / 1e6) * DOLLARS_PER_MILLION_TOKENS; }
-  function fmtDollars(tokens) {
-    var d = dollars(tokens);
-    return "$" + (d >= 100 ? Math.round(d) : d.toFixed(2));
-  }
   function summarizeWindow(events, cutoff) {
     var w = { tokens_saved: 0, stale_withheld: 0, recalls: 0, caller_answers: 0 };
     events.forEach(function (e) {
@@ -175,7 +169,6 @@
     var big = el("div", "big");
     big.appendChild(el("b", null, all.tokens_saved ? "0" : "—"));
     big.appendChild(el("span", "unit", "tokens saved, all time"));
-    if (all.tokens_saved) big.appendChild(el("span", "dollars", "≈ " + fmtDollars(all.tokens_saved)));
     hh.appendChild(big);
     hh.appendChild(el("p", "sub", all.tokens_saved
       ? "Context your agents did not have to re-read from source, because Kage served grounded memory instead."
@@ -186,7 +179,6 @@
       var w = el("div", "r-win");
       w.appendChild(el("div", "k", p[0]));
       w.appendChild(el("div", "v", fmt(p[1].tokens_saved) + " tok"));
-      w.appendChild(el("div", "d", "≈ " + fmtDollars(p[1].tokens_saved)));
       wins.appendChild(w);
     });
     hero.appendChild(wins);
@@ -203,13 +195,13 @@
       lines.appendChild(row);
     });
     hero.appendChild(lines);
-    hero.appendChild(el("div", "r-foot", "estimated at $" + DOLLARS_PER_MILLION_TOKENS + " per 1M input tokens · ledger: .agent_memory/reports/value.json · verify: kage gains"));
+    hero.appendChild(el("div", "r-foot", "ledger: .agent_memory/reports/value.json · verify: kage gains"));
     if (all.tokens_saved) countUp(big.querySelector("b"), all.tokens_saved, 900);
 
     if (tiles) {
       tiles.textContent = "";
       [
-        { k: "Saved (7 days)", v: fmt(week.tokens_saved), s: "≈ " + fmtDollars(week.tokens_saved) + " of context not re-read", cls: "green" },
+        { k: "Saved (7 days)", v: fmt(week.tokens_saved), s: "tokens of context not re-read", cls: "green" },
         { k: "Recalls served (7d)", v: fmt(week.recalls), s: fmt(all.recalls) + " all-time", cls: "green" },
         { k: "Stale caught", v: fmt(all.stale_withheld), s: all.stale_withheld ? "withheld before they misled an agent" : "nothing withheld yet", cls: all.stale_withheld ? "warn" : "" },
         { k: "Graph answers", v: fmt(all.caller_answers), s: "caller questions answered from the code graph", cls: "code" },

package/viewer/index.html

@@ -69,14 +69,12 @@
       .receipt .r-hero .big { display: flex; align-items: baseline; gap: 12px; flex-wrap: wrap; }
       .receipt .r-hero .big b { font: 600 64px/0.95 var(--serif); letter-spacing: -0.02em; color: var(--gain); font-variant-numeric: tabular-nums; }
       .receipt .r-hero .big .unit { color: var(--muted); font: 500 16px/1 var(--sans); }
-      .receipt .r-hero .big .dollars { color: var(--ink); font: 600 22px/1 var(--serif); }
       .receipt .r-hero .sub { margin-top: 10px; color: var(--muted); font: 400 13.5px/1.5 var(--sans); max-width: 560px; }
       .receipt .r-windows { display: grid; grid-template-columns: repeat(3, 1fr); border-top: 1px dashed var(--line-strong); }
       .receipt .r-win { padding: 16px 24px; border-left: 1px dashed var(--line-strong); }
       .receipt .r-win:first-child { border-left: 0; }
       .receipt .r-win .k { color: var(--faint); font: 600 10px/1 var(--mono); text-transform: uppercase; letter-spacing: 0.1em; }
       .receipt .r-win .v { margin-top: 8px; font: 600 24px/1 var(--serif); color: var(--ink); font-variant-numeric: tabular-nums; }
-      .receipt .r-win .d { margin-top: 5px; color: var(--gain); font: 600 12px/1 var(--mono); }
       .receipt .r-lines { border-top: 1px dashed var(--line-strong); padding: 14px 24px 16px; }
       .receipt .r-line { display: flex; align-items: baseline; gap: 10px; padding: 5px 0; font: 400 13.5px/1.5 var(--sans); color: var(--ink); }
       .receipt .r-line .dots { flex: 1; border-bottom: 1px dotted var(--line-strong); transform: translateY(-4px); }
@@ -290,7 +288,7 @@
         <header class="head">
           <span class="eyebrow" id="eyebrow">kage://gains</span>
           <h1 id="title">What Kage saved you</h1>
-          <p id="subtitle">Tokens, dollars, and bad memories caught — receipts, not vibes.</p>
+          <p id="subtitle">Tokens saved and bad memories caught — receipts, not vibes.</p>
         </header>
         <div class="wrap">
           <section class="section active" id="section-dashboard">