@kage-core/kage-graph-mcp 1.1.38 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kage-core/kage-graph-mcp",
-  "version": "1.1.38",
+  "version": "1.3.0",
   "description": "Local-first repo memory, code graph, and recall MCP server for coding agents",
   "main": "dist/index.js",
   "files": [

package/viewer/app.js

@@ -47,7 +47,9 @@
       lifecycle: null,
       timeline: null,
       lineage: null,
-      setup: null
+      setup: null,
+      trust: null,
+      suppressed: null
     },
     pendingPackets: [],
     reviewText: "",
@@ -183,6 +185,8 @@
     edgeCount: document.getElementById("edgeCount"),
     reviewCount: document.getElementById("reviewCount"),
     dashboardStats: document.getElementById("dashboardStats"),
+    trustHero: document.getElementById("trustHero"),
+    suppressionShelf: document.getElementById("suppressionShelf"),
     repoXray: document.getElementById("repoXray"),
     repoXrayStatus: document.getElementById("repoXrayStatus"),
     repoXrayScript: document.getElementById("repoXrayScript"),
@@ -233,8 +237,8 @@
   var PAGE_META = {
     overview: {
       eyebrow: "kage://overview",
-      title: "Repo dashboard",
-      summary: "What is safe to change next, what needs attention, and what is ready to hand off."
+      title: "Repository overview",
+      summary: "Whether this repo's agent memory can be trusted, what needs review, and what's ready to hand off."
     },
     graph: {
       eyebrow: "kage://graph",
@@ -622,6 +626,8 @@
     var timelinePath = params.get("timeline") || params.get("memoryTimeline") || params.get("memory-timeline");
     var lineagePath = params.get("lineage") || params.get("memoryLineage") || params.get("memory-lineage");
     var setupPath = params.get("setup") || params.get("setupDoctor") || params.get("setup-doctor");
+    var trustPath = params.get("trust") || params.get("trustBenchmark") || params.get("trust-benchmark");
+    var suppressedPath = params.get("suppressed") || params.get("suppressedMemory") || params.get("suppressed-memory");
     var inferredRoot = inferMemoryRoot(graphPaths[0] || "");
     if (!inboxPath && inferredRoot) inboxPath = inferredRoot + "/inbox.json";
     if (!reviewPath && inferredRoot) reviewPath = inferredRoot + "/review/memory-review.md";
@@ -648,6 +654,8 @@
       if (!timelinePath) timelinePath = inferredRoot + "/reports/timeline.json";
       if (!lineagePath) lineagePath = inferredRoot + "/reports/lineage.json";
       if (!setupPath) setupPath = inferredRoot + "/reports/setup.json";
+      if (!trustPath) trustPath = inferredRoot + "/reports/trust.json";
+      if (!suppressedPath) suppressedPath = inferredRoot + "/reports/suppressed.json";
     }
     var jobs = [];
     if (metricsPath) jobs.push(fetchJson(metricsPath).then(function (metrics) { state.metrics = metrics; }));
@@ -675,6 +683,8 @@
     if (timelinePath) jobs.push(fetchJson(timelinePath).then(function (report) { state.reports.timeline = report; }).catch(function () { state.reports.timeline = null; }));
     if (lineagePath) jobs.push(fetchJson(lineagePath).then(function (report) { state.reports.lineage = report; }).catch(function () { state.reports.lineage = null; }));
     if (setupPath) jobs.push(fetchJson(setupPath).then(function (report) { state.reports.setup = report; }).catch(function () { state.reports.setup = null; }));
+    if (trustPath) jobs.push(fetchJson(trustPath).then(function (report) { state.reports.trust = report; }).catch(function () { state.reports.trust = null; }));
+    if (suppressedPath) jobs.push(fetchJson(suppressedPath).then(function (report) { state.reports.suppressed = report; }).catch(function () { state.reports.suppressed = null; }));
     if (!graphPaths.length && !jobs.length) {
       loadHostedDefault();
       return;
@@ -723,7 +733,9 @@
       fetchJson("./data/kage/reports/lifecycle.json").catch(function () { return null; }),
       fetchJson("./data/kage/reports/timeline.json").catch(function () { return null; }),
       fetchJson("./data/kage/reports/lineage.json").catch(function () { return null; }),
-      fetchJson("./data/kage/reports/setup.json").catch(function () { return null; })
+      fetchJson("./data/kage/reports/setup.json").catch(function () { return null; }),
+      fetchJson("./data/kage/reports/trust.json").catch(function () { return null; }),
+      fetchJson("./data/kage/reports/suppressed.json").catch(function () { return null; })
     ]).then(function (items) {
       var merged = mergeNormalizedGraphs([normalizeGraph(items[0]), normalizeGraph(items[1])]);
       state.metrics = items[2];
@@ -747,6 +759,8 @@
       state.reports.timeline = items[20];
       state.reports.lineage = items[21];
       state.reports.setup = items[22];
+      state.reports.trust = items[23];
+      state.reports.suppressed = items[24];
       loadNormalizedGraph(merged, "Kage repo graph");
       setAutoLoad("Kage repo graph loaded", true);
     }).catch(function () {
@@ -2983,6 +2997,75 @@
     ].forEach(function (card) { els.debugOverview.appendChild(card); });
   }
 
+  function renderTrustHero(trust) {
+    if (!els.trustHero) return;
+    var metrics = (trust && trust.metrics) || {};
+    var score = trust && typeof trust.trust_score === "number" ? trust.trust_score : null;
+    var status = score == null ? "idle" : (score >= 90 ? "ok" : score >= 70 ? "warn" : "alert");
+    var bars = [
+      ["Hallucinated citations rejected", metrics.hallucinated_citation_rejection_rate],
+      ["Stale memory excluded from recall", metrics.stale_memory_exclusion_rate],
+      ["Live memory grounded to code", metrics.live_grounding_rate]
+    ];
+    var note = score == null
+      ? "Run <code>kage benchmark --trust</code> to score this repo."
+      : (status === "ok"
+        ? "Verified — agents recall only memory that is grounded and current."
+        : "Some memory needs review before agents should trust it.");
+    var barsHtml = bars.map(function (bar) {
+      var raw = bar[1];
+      var has = !(raw === null || raw === undefined || isNaN(raw));
+      var pct = has ? Math.max(0, Math.min(100, Number(raw))) : 0;
+      return '<div class="trust-bar">'
+        + '<span class="trust-bar-label"></span>'
+        + '<span class="trust-bar-track"><i style="width:' + pct + '%"></i></span>'
+        + '<b class="trust-bar-value">' + (has ? pct + "%" : "—") + '</b>'
+        + '</div>';
+    }).join("");
+    els.trustHero.setAttribute("data-status", status);
+    els.trustHero.innerHTML =
+      '<div class="trust-hero-score">'
+      + '<span class="trust-hero-eyebrow">Memory Trust</span>'
+      + '<div class="trust-hero-number"><strong>' + (score == null ? "—" : score) + '</strong><span>/100</span></div>'
+      + '<p class="trust-hero-note">' + note + '</p>'
+      + '</div>'
+      + '<div class="trust-hero-bars">' + barsHtml + '</div>';
+    // Set labels via textContent to avoid any HTML injection from labels.
+    var labelEls = els.trustHero.querySelectorAll(".trust-bar-label");
+    for (var i = 0; i < labelEls.length; i += 1) labelEls[i].textContent = bars[i][0];
+  }
+
+  function renderSuppressionShelf(report) {
+    if (!els.suppressionShelf) return;
+    var items = (report && report.items) || [];
+    if (!items.length) {
+      els.suppressionShelf.innerHTML = "";
+      els.suppressionShelf.hidden = true;
+      return;
+    }
+    els.suppressionShelf.hidden = false;
+    var plural = items.length === 1 ? "memory is" : "memories are";
+    els.suppressionShelf.innerHTML =
+      '<div class="suppression-head">'
+      + '<div><span class="suppression-eyebrow">Withheld from recall</span>'
+      + '<h2>' + items.length + ' ' + plural + ' being withheld from your agents</h2></div>'
+      + '<strong class="suppression-flag">Needs review</strong>'
+      + '</div>'
+      + '<p class="suppression-sub">Recall is hiding these because their cited evidence was deleted or expired. Verify, update, or supersede each before agents should trust them.</p>'
+      + '<div class="suppression-list">'
+      + items.slice(0, 8).map(function () {
+        return '<div class="suppression-item"><span class="suppression-item-title"></span><span class="suppression-item-reason"></span></div>';
+      }).join("")
+      + '</div>'
+      + (items.length > 8 ? '<p class="suppression-more">+ ' + (items.length - 8) + ' more — run <code>kage suppressed</code></p>' : '');
+    var titleEls = els.suppressionShelf.querySelectorAll(".suppression-item-title");
+    var reasonEls = els.suppressionShelf.querySelectorAll(".suppression-item-reason");
+    for (var i = 0; i < titleEls.length; i += 1) {
+      titleEls[i].textContent = items[i].title;
+      reasonEls[i].textContent = items[i].reason;
+    }
+  }
+
   function renderDashboard() {
     if (!els.dashboardStats) return;
     var metrics = state.metrics || {};
@@ -3009,6 +3092,8 @@
     var readiness = handoff || dashboardReadiness(metrics, pendingReview, staleFlags, duplicateFlags, missingContext);
     var memoryCoverage = dashboardMemoryCoverage(reports, memoryCodeEdges, memoryGraph, memoryNodes);
     var riskHealth = riskTargets.length || hotspots ? (riskTargets.length + hotspots) + " checks" : "No flags";
+    renderTrustHero(reports.trust);
+    renderSuppressionShelf(reports.suppressed);
     var statRows = [
       ["Handoff", readiness.label, readiness.detail, readiness.status],
       ["Memory", memoryCoverage.label, memoryCoverage.detail, memoryCoverage.status],
@@ -3547,6 +3632,10 @@
     return state.entities.filter(function (entity) { return entity.type === type; }).length;
   }
 
+  function numOrDash(value) {
+    return (value === null || value === undefined || isNaN(value)) ? "—" : value;
+  }
+
   function formatDashboardValue(value) {
     if (typeof value === "number" && Number.isFinite(value)) return value.toLocaleString();
     return String(value == null ? "n/a" : value);

package/viewer/index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title>Kage viewer</title>
-    <link rel="stylesheet" href="./styles.css?v=37">
+    <link rel="stylesheet" href="./styles.css?v=39">
   </head>
   <body>
     <div class="viewer-shell">
@@ -54,16 +54,18 @@
 
         <main class="layout">
       <section class="dashboard-panel" aria-label="Kage repo dashboard">
+        <div id="trustHero" class="trust-hero" aria-label="Memory trust score"></div>
+        <div id="suppressionShelf" class="suppression-shelf" aria-label="Memory withheld from recall" hidden></div>
         <div id="dashboardStats" class="dashboard-stats" aria-label="Repo dashboard stats"></div>
-        <section id="repoXray" class="repo-xray" aria-label="Repo X-Ray">
+        <section id="repoXray" class="repo-xray" aria-label="Repository map">
           <div class="repo-xray-head">
             <div>
-              <span>Repo X-Ray</span>
-              <h2>Show me what you understand</h2>
+              <span>Repository map</span>
+              <h2>What Kage understands about this repo</h2>
             </div>
             <strong id="repoXrayStatus">waiting</strong>
           </div>
-          <p id="repoXrayScript">Kage will map entry points, core files, risk, tests, and memory overlays when the X-Ray report is loaded.</p>
+          <p id="repoXrayScript">Entry points, core modules, change risk, tests, and memory overlays — mapped from the code graph.</p>
           <div id="repoXrayLayers" class="repo-xray-layers"></div>
         </section>
         <div id="dashboardCharts" class="dashboard-charts" aria-label="Repo health charts"></div>
@@ -302,6 +304,6 @@
       </section>
     </div>
 
-    <script src="./app.js?v=50"></script>
+    <script src="./app.js?v=53"></script>
   </body>
 </html>

package/viewer/styles.css

@@ -424,6 +424,103 @@ body.viewer-page-data .graph-panel {
   white-space: nowrap;
 }
 
+.trust-hero {
+  display: grid;
+  grid-template-columns: minmax(170px, 250px) minmax(0, 1fr);
+  gap: 30px;
+  align-items: center;
+  margin-bottom: 18px;
+  padding: 24px 28px;
+  border: 1px solid rgba(65, 255, 143, 0.24);
+  border-radius: 14px;
+  background:
+    radial-gradient(circle at 0 0, rgba(65, 255, 143, 0.12), transparent 380px),
+    linear-gradient(135deg, rgba(8, 17, 13, 0.96), rgba(10, 16, 22, 0.82));
+  box-shadow: var(--shadow);
+}
+.trust-hero[data-status="warn"] { border-color: rgba(255, 209, 102, 0.34); }
+.trust-hero[data-status="alert"] { border-color: rgba(255, 107, 107, 0.38); }
+.trust-hero[data-status="idle"] { border-color: var(--line); }
+.trust-hero-eyebrow {
+  display: block;
+  color: var(--terminal-dim);
+  font-size: 11px;
+  font-weight: 800;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+.trust-hero-number { display: flex; align-items: baseline; gap: 5px; margin-top: 8px; }
+.trust-hero-number strong {
+  font-size: 60px;
+  line-height: 1;
+  color: var(--terminal-strong);
+  text-shadow: 0 0 24px rgba(65, 255, 143, 0.38);
+}
+.trust-hero[data-status="warn"] .trust-hero-number strong { color: var(--warn); text-shadow: 0 0 24px rgba(255, 209, 102, 0.32); }
+.trust-hero[data-status="alert"] .trust-hero-number strong { color: var(--danger); text-shadow: 0 0 24px rgba(255, 107, 107, 0.32); }
+.trust-hero[data-status="idle"] .trust-hero-number strong { color: var(--muted); text-shadow: none; }
+.trust-hero-number span { font-size: 19px; color: var(--muted); }
+.trust-hero-note { margin: 12px 0 0; color: var(--muted); font-size: 12.5px; line-height: 1.45; max-width: 250px; }
+.trust-hero-note code { color: var(--accent); background: var(--accent-soft); padding: 1px 6px; border-radius: 5px; font-size: 11.5px; }
+.trust-hero-bars { display: grid; gap: 15px; }
+.trust-bar {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) 52px;
+  grid-template-areas: "label value" "track value";
+  align-items: center;
+  gap: 4px 14px;
+}
+.trust-bar-label { grid-area: label; color: var(--text); font-size: 13px; }
+.trust-bar-track { grid-area: track; height: 8px; border-radius: 999px; background: rgba(215, 249, 223, 0.07); overflow: hidden; }
+.trust-bar-track i { display: block; height: 100%; border-radius: 999px; background: linear-gradient(90deg, var(--brand), var(--accent)); box-shadow: 0 0 12px rgba(65, 255, 143, 0.3); transition: width 0.5s ease; }
+.trust-bar-value { grid-area: value; text-align: right; color: var(--terminal-strong); font-size: 15px; font-weight: 800; }
+@media (max-width: 860px) {
+  .trust-hero { grid-template-columns: 1fr; gap: 20px; }
+  .trust-hero-note { max-width: none; }
+}
+
+.suppression-shelf {
+  margin-bottom: 18px;
+  padding: 20px 24px;
+  border: 1px solid rgba(255, 209, 102, 0.34);
+  border-radius: 14px;
+  background:
+    radial-gradient(circle at 0 0, rgba(255, 209, 102, 0.08), transparent 360px),
+    linear-gradient(135deg, rgba(24, 18, 8, 0.92), rgba(16, 14, 10, 0.82));
+}
+.suppression-shelf[hidden] { display: none; }
+.suppression-head { display: flex; align-items: start; justify-content: space-between; gap: 16px; }
+.suppression-eyebrow { display: block; color: var(--warn); font-size: 11px; font-weight: 800; letter-spacing: 0.14em; text-transform: uppercase; }
+.suppression-head h2 { margin-top: 5px; color: var(--text); text-shadow: none; font-size: 17px; }
+.suppression-flag {
+  flex: none;
+  color: var(--warn);
+  font-size: 11px;
+  font-weight: 800;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  padding: 5px 10px;
+  border: 1px solid rgba(255, 209, 102, 0.4);
+  border-radius: 999px;
+  background: var(--warn-soft);
+}
+.suppression-sub { margin: 8px 0 14px; color: var(--muted); font-size: 12.5px; line-height: 1.45; max-width: 760px; }
+.suppression-list { display: grid; gap: 8px; }
+.suppression-item {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  align-items: center;
+  gap: 16px;
+  padding: 11px 14px;
+  border: 1px solid rgba(255, 209, 102, 0.16);
+  border-radius: 9px;
+  background: rgba(8, 17, 13, 0.5);
+}
+.suppression-item-title { color: var(--text); font-size: 13.5px; font-weight: 650; overflow-wrap: anywhere; }
+.suppression-item-reason { color: var(--warn); font-size: 12px; text-align: right; opacity: 0.92; }
+.suppression-more { margin: 12px 0 0; color: var(--muted); font-size: 12px; }
+.suppression-more code { color: var(--accent); background: var(--accent-soft); padding: 1px 5px; border-radius: 5px; }
+
 .dashboard-stats {
   display: grid;
   grid-template-columns: repeat(3, minmax(0, 1fr));
@@ -431,8 +528,8 @@ body.viewer-page-data .graph-panel {
   margin-bottom: 22px;
 }
 .dashboard-stat {
-  min-height: 142px;
-  padding: 22px;
+  min-height: 120px;
+  padding: 20px 22px;
   border: 1px solid rgba(65, 255, 143, 0.12);
   border-radius: 10px;
   background: rgba(8, 17, 13, 0.82);