@kage-core/kage-graph-mcp 2.2.7 → 2.3.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kage-core/kage-graph-mcp",
-  "version": "2.2.7",
-  "description": "Local-first repo memory, code graph, and recall MCP server for coding agents",
+  "version": "2.3.1",
+  "description": "Team memory for coding agents: captures the decisions, runbooks, and bug fixes that get lost, verified against your code and shared via git. MCP server, zero deps, no account.",
   "main": "dist/index.js",
   "files": [
     "dist/**/*.js",

package/viewer/console.js

@@ -66,6 +66,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."],
     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."],
@@ -90,8 +91,29 @@
   });
 
   // ---- load ----
+  // Showcase mode: the bundled demo dataset (docs/viewer/data) carries showcase:true.
+  // Its timestamps are frozen, so we slide them forward to "now" on load — the daily
+  // chart and the feed stay current instead of aging into an empty 14-day window.
+  // Real daemon data has no showcase flag and is never touched.
+  function rebaseShowcase(activity, value) {
+    if (!activity || !activity.showcase) return;
+    var allAt = [];
+    (activity.events || []).forEach(function (e) { if (e.at) allAt.push(Date.parse(e.at)); });
+    if (value && value.events) value.events.forEach(function (e) { if (e.at) allAt.push(Date.parse(e.at)); });
+    var latest = allAt.length ? Math.max.apply(null, allAt) : 0;
+    if (!latest) return;
+    var delta = Date.now() - latest;
+    var dayDelta = Math.round(delta / 86400000);
+    function shift(e) { if (e && e.at) e.at = new Date(Date.parse(e.at) + delta).toISOString(); }
+    (activity.events || []).forEach(shift);
+    if (value && value.events) value.events.forEach(shift);
+    (activity.daily || []).forEach(function (d) {
+      if (d.day) d.day = new Date(Date.parse(d.day + "T00:00:00Z") + dayDelta * 86400000).toISOString().slice(0, 10);
+    });
+  }
+
   Promise.all([getJSON(paths.trust), getJSON(paths.suppressed), getJSON(paths.lifecycle), getJSON(paths.metrics), getJSON(paths.activity), getJSON(paths.value)])
-    .then(function (r) { render(r[0], r[1], r[2], r[3], r[4], r[5]); })
+    .then(function (r) { rebaseShowcase(r[4], r[5]); render(r[0], r[1], r[2], r[3], r[4], r[5]); })
     .catch(function () { render(null, null, null, null, null, null); });
 
   function render(trust, suppressed, lifecycle, metrics, activity, value) {
@@ -102,12 +124,13 @@
     renderGains(value);
     renderHero(trust);
     renderTiles(metrics, state.items);
+    renderDashboard(metrics, state.items, value);
     renderAttention(state.items, suppressed);
     renderChips(); renderList();
     renderInsights(metrics, state.items);
     renderActivity(activity);
     var start = (location.hash || "").replace("#", "");
-    show(META[start] ? start : "gains");
+    show(META[start] ? start : "dashboard");
   }
 
   // ---- gains (value ledger receipts) ----
@@ -320,6 +343,50 @@
   function counts(items) {
     var c = {}; items.forEach(function (i) { c[i.health] = (c[i.health] || 0) + 1; }); return c;
   }
+  // ---- dashboard (landing overview: what the team has captured, at a glance) ----
+  function renderDashboard(metrics, items, value) {
+    var cg = (metrics && metrics.code_graph) || {};
+    var c = counts(items);
+    var types = {}; items.forEach(function (i) { var t = i.type || "memory"; types[t] = (types[t] || 0) + 1; });
+    var ev = (value && value.events) || [];
+    var totals = (value && value.totals) || summarizeWindow(ev, 0);
+    var box = document.getElementById("dashTiles");
+    if (box) {
+      box.textContent = "";
+      [
+        { k: "Memory packets", v: fmt(items.length), s: (c.hot || 0) + " hot · " + (c.healthy || 0) + " healthy", cls: "memory" },
+        { k: "Decisions", v: fmt(types.decision || 0), s: "why the code is the way it is", cls: "code" },
+        { k: "Runbooks & fixes", v: fmt((types.runbook || 0) + (types.bug_fix || 0) + (types.workflow || 0)), s: "how to run it · how it broke", cls: "green" },
+        { k: "Recalls served", v: fmt(totals.recalls || 0), s: (totals.recalls ? "memory reused, not re-derived" : "recall to start the ledger"), cls: "green" },
+      ].forEach(function (d) { var t = el("div", "tile"); t.appendChild(el("div", "k", d.k)); t.appendChild(el("div", "v " + (d.cls || ""), d.v)); t.appendChild(el("div", "s", d.s)); box.appendChild(t); });
+    }
+    var cap = document.getElementById("dashCaptures");
+    if (cap) {
+      cap.textContent = "";
+      // Prefer human-readable captures: skip auto-distilled packets whose titles are
+      // raw ids / JSON fragments (start with a non-letter, or contain { } < >).
+      var clean = items.filter(function (i) { var t = (i.title || "").trim(); return /^[A-Za-z]/.test(t) && !/[{}<>]/.test(t); });
+      var pool = clean.length >= 5 ? clean : items;
+      var recent = pool.slice().sort(function (a, b) {
+        return (Date.parse(b.created_at || b.updated_at || 0) || 0) - (Date.parse(a.created_at || a.updated_at || 0) || 0);
+      }).slice(0, 7);
+      if (!recent.length) cap.appendChild(el("div", "empty", "No memory captured yet. As your agents work, decisions and fixes land here."));
+      else recent.forEach(function (i) { cap.appendChild(memoryRow(i)); });
+    }
+    var tb = document.getElementById("dashTypeBars");
+    if (tb) {
+      tb.textContent = "";
+      var arr = Object.keys(types).map(function (k) { return [k, types[k]]; }).sort(function (a, b) { return b[1] - a[1]; }).slice(0, 7);
+      var max = arr.length ? arr[0][1] : 1;
+      if (!arr.length) tb.appendChild(el("div", "empty", "No memory yet."));
+      arr.forEach(function (p) {
+        var row = el("div", "hbar"); row.appendChild(el("span", "n", p[0]));
+        var t = el("span", "t"), f = el("i"); t.appendChild(f); row.appendChild(t); row.appendChild(el("span", "c", String(p[1])));
+        tb.appendChild(row); setTimeout(function () { f.style.width = (p[1] / max * 100) + "%"; }, 80);
+      });
+    }
+  }
+
   function renderTiles(metrics, items) {
     var cg = (metrics && metrics.code_graph) || {};
     var act = (state.activity && state.activity.totals) || {};

package/viewer/index.html

@@ -270,7 +270,8 @@
         <div class="brand"><span class="mark">K</span> Kage</div>
         <div class="repocard"><span class="eyebrow">Repository</span><strong id="repo">loading…</strong></div>
         <nav class="nav" id="nav">
-          <button data-section="gains" aria-current="true"><span class="ic">⊕</span> Gains</button>
+          <button data-section="dashboard" aria-current="true"><span class="ic">⊞</span> Dashboard</button>
+          <button data-section="gains"><span class="ic">⊕</span> Gains</button>
           <button data-section="overview"><span class="ic">◎</span> Trust</button>
           <button data-section="graph"><span class="ic">⬡</span> Memory map</button>
           <button data-section="memory"><span class="ic">▤</span> Memory</button>
@@ -292,7 +293,15 @@
           <p id="subtitle">Tokens, dollars, and bad memories caught — receipts, not vibes.</p>
         </header>
         <div class="wrap">
-          <section class="section active" id="section-gains">
+          <section class="section active" id="section-dashboard">
+            <div class="tiles" id="dashTiles"></div>
+            <div class="ins-grid">
+              <div class="panel"><h2>Recent captures <span class="sub">— newest knowledge your agents saved</span></h2><div id="dashCaptures"></div></div>
+              <div class="panel"><h2>Memory by type</h2><div class="hbars" id="dashTypeBars"></div></div>
+            </div>
+          </section>
+
+          <section class="section" id="section-gains">
             <div class="receipt" id="gainsHero"></div>
             <div class="tiles" id="gainsTiles"></div>
             <div class="panel" id="livePanel" hidden><h2><span class="livedot" aria-hidden="true"></span>Live <span class="sub">— memories and value events as they happen</span></h2><div id="liveFeed"></div></div>
@@ -359,6 +368,6 @@
     </div>
     <div class="drawer-backdrop" id="detailBackdrop"></div>
     <aside class="drawer" id="detail" aria-hidden="true"></aside>
-    <script src="./console.js?v=17"></script>
+    <script src="./console.js?v=18"></script>
   </body>
 </html>