peon-mem 1.0.3 → 1.0.5

package/README.md

@@ -1,6 +1,6 @@
 # 🧠 Peon — a memory brain for your AI coding agents
 
-[![npm](https://img.shields.io/npm/v/peon-mem)](https://www.npmjs.com/package/peon-mem) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![tests](https://img.shields.io/badge/tests-passing-brightgreen)](test/)
+[![npm](https://img.shields.io/npm/v/peon-mem)](https://www.npmjs.com/package/peon-mem) [![downloads](https://img.shields.io/npm/dm/peon-mem)](https://www.npmjs.com/package/peon-mem) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![tests](https://img.shields.io/badge/tests-passing-brightgreen)](test/) [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-6b4fbb)](https://registry.modelcontextprotocol.io) [![Star on GitHub](https://img.shields.io/github/stars/VineetV2/peon-mem?style=social)](https://github.com/VineetV2/peon-mem)
 
 **Local-first, hierarchical, self-improving memory for Claude Code, Codex, and any MCP client.**
 
@@ -20,8 +20,9 @@ prompt. It runs as a daemon on your machine, and nothing leaves it.
   tools. Each project gets an isolated child brain. Every injection carries both.
 - **Two memory layers, honestly measured.** Consolidated *beliefs* (decisions, preferences,
   facts, artifacts) give you the gist. An *episodic* verbatim layer recovers the exact details
-  that lossy summaries drop. On LongMemEval, raw-episodic recall scored 61% where belief-only
-  scored 17%.
+  that lossy summaries drop. In my own LongMemEval run, raw-episodic recall scored 61% where
+  belief-only scored 17% — self-measured, not an independent benchmark; reproduce it with
+  `npm run eval`.
 - **Automatic capture and injection.** Claude Code hooks record messages and events, then
   inject a query-ranked memory block (with an `⚠ MOST RELEVANT` headline) into every prompt.
   You never have to remember to save anything.
@@ -73,7 +74,7 @@ upstairs (the global brain). Quiet clerk. Perfect memory. The office runs on him
 | Hierarchy | **global parent brain → per-project child brains, inherited on every prompt** | user/agent/session scopes | per-agent | per-user | per-project file |
 | Capture | **automatic via hooks** (zero effort) | SDK calls you write | agent-managed | SDK calls | agent must remember to write |
 | Conflict handling | supersede/merge, **recoverable — never hard-deletes** | LLM may DELETE | self-edit | invalidation | overwrite |
-| Exact recall | episodic layer regression-tested (61% vs 17% belief-only, LongMemEval) | gist only | gist only | graph facts | whatever was written |
+| Exact recall | episodic layer regression-tested (61% vs 17% belief-only on LongMemEval, self-measured) | gist only | gist only | graph facts | whatever was written |
 | Observability | **live Neural Universe monitor + daily self-audit (STL) + serve telemetry** | dashboard | — | — | — |
 | Verification | **committed eval ledger; negative results kept** | vendor benchmarks | — | vendor benchmarks | — |
 
@@ -122,7 +123,7 @@ The guided setup asks four things:
 3. Installs the **daemon** as an auto-start service (launchd on macOS, systemd user unit on Linux)
 4. **Detects your AI apps** and wires the MCP server (plus hooks for Claude Code) into the
    ones you pick. Auto-configured: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor,
-   Windsurf, VS Code (Copilot MCP), Zed, LM Studio. Detected with in-app instructions: ChatGPT
+   Windsurf, Cline, VS Code (Copilot MCP), Zed, LM Studio. Detected with in-app instructions: ChatGPT
    Desktop, Perplexity Desktop. Every touched config gets a `.peon-backup`.
 
 That builds the package, starts the daemon as a service, wires your Claude Code hooks + MCP
@@ -433,3 +434,12 @@ or send a PR directly.
 Rules of the house: every retrieval/quality change ships with a test and an eval-ledger run
 (`npm run eval`); negative results get documented, not deleted; nothing may hard-delete user
 memory. `npm test` must stay green.
+
+---
+
+<div align="center">
+
+**If Peon is useful to you, [★ star it on GitHub](https://github.com/VineetV2/peon-mem)** — it is
+how other people building with coding agents find it.
+
+</div>

package/bin/peon-mem.mjs

@@ -48,6 +48,11 @@ function backupWrite(file, content) {
 // wire kinds: hooks+CLI (claude code) · toml (codex) · mcpServers JSON (most apps) ·
 // vscode "servers" JSON · zed context_servers · manual (UI-configured apps get instructions)
 const APP_SUPPORT = MAC ? join(HOME, "Library", "Application Support") : join(HOME, ".config");
+const CODE_USER = join(APP_SUPPORT, "Code", "User");
+const CLINE_EXTENSION_HOME = join(CODE_USER, "globalStorage", "saoudrizwan.claude-dev");
+const CLINE_EXTENSION_FILE = join(CLINE_EXTENSION_HOME, "settings", "cline_mcp_settings.json");
+const CLINE_CLI_HOME = join(HOME, ".cline");
+const CLINE_CLI_FILE = join(CLINE_CLI_HOME, "data", "settings", "cline_mcp_settings.json");
 function detectApps() {
   return [
     { id: "claude",   name: "Claude Code",    kind: "claude-code",
@@ -66,9 +71,12 @@ function detectApps() {
     { id: "windsurf", name: "Windsurf",       kind: "json",
       file: join(HOME, ".codeium", "windsurf", "mcp_config.json"),
       found: existsSync(join(HOME, ".codeium", "windsurf")) || existsSync("/Applications/Windsurf.app") },
+    { id: "cline",    name: "Cline",          kind: "json",
+      file: existsSync(CLINE_EXTENSION_HOME) ? CLINE_EXTENSION_FILE : CLINE_CLI_FILE,
+      found: existsSync(CLINE_EXTENSION_HOME) || which("cline") || existsSync(CLINE_CLI_HOME) },
     { id: "vscode",   name: "VS Code (Copilot MCP)", kind: "vscode",
-      file: MAC ? join(APP_SUPPORT, "Code", "User", "mcp.json") : join(HOME, ".config", "Code", "User", "mcp.json"),
-      found: which("code") || existsSync(MAC ? join(APP_SUPPORT, "Code") : join(HOME, ".config", "Code")) },
+      file: join(CODE_USER, "mcp.json"),
+      found: which("code") || existsSync(join(APP_SUPPORT, "Code")) },
     { id: "zed",      name: "Zed",            kind: "zed",
       file: join(HOME, ".config", "zed", "settings.json"),
       found: existsSync(join(HOME, ".config", "zed")) || existsSync("/Applications/Zed.app") },
@@ -272,7 +280,14 @@ if (cmd === "install") {
     log("\n" + ((await health()) ? "✔ daemon healthy — http://127.0.0.1:3737" : "⚠ daemon not answering — check " + memoryHome + "/daemon.err.log"));
   }
   log("🌌 Monitor (the Neural Universe): http://127.0.0.1:3737/monitor");
-  log("Memory lives in <project>/.peon/ (child brains) + " + memoryHome + " (global brain)\n");
+  log("Memory lives in <project>/.peon/ (child brains) + " + memoryHome + " (global brain)");
+  // People who just installed are the ones most able to say whether this works. Ask once, here —
+  // never nag from the daemon or the hooks, which run constantly and would become noise.
+  log("");
+  log("  Peon is built by one person. Two things that genuinely help:");
+  log("    ★ star it, so others find it   https://github.com/VineetV2/peon-mem");
+  log("    ✎ tell me what broke or felt confusing — that is a bug report");
+  log("      https://github.com/VineetV2/peon-mem/issues\n");
   rl?.close();
 } else if (cmd === "uninstall") {
   if (MAC && existsSync(PLIST)) act("stop + remove daemon service", () => spawnSync("launchctl", ["unload", PLIST], { stdio: "ignore" }));
@@ -288,7 +303,7 @@ if (cmd === "install") {
       s.hooks[ev] = s.hooks[ev].filter((h) => !JSON.stringify(h).includes("claude-peon-hook.mjs"));
     act("remove Peon hooks from " + settings, () => backupWrite(settings, JSON.stringify(s, null, 2) + "\n"));
   } catch {}
-  log("Remove [mcp_servers.peon] / mcpServers.peon from Codex/Gemini/Cursor configs if you added them.");
+  log("Remove [mcp_servers.peon] / mcpServers.peon from Codex/Gemini/Cursor/Cline configs if you added them.");
   log("Memory data untouched: <project>/.peon/ and " + DEFAULT_HOME);
   rl?.close();
 } else if (cmd === "daemon") {

package/dist/monitor.js

@@ -27,6 +27,10 @@ const CLIENT_SCRIPT = String.raw `
   var ui = { project:"", filter:"all", search:null, focus:null, editing:null };
   var latest = null, overview = null, network = null, dash = null, busy = false;
   var ovLoadedAt = 0, netLoadedAt = 0, dashLoadedAt = 0, HEAVY_TTL = 12000;
+  // Load state for the heavy endpoints. Without this, a page renders its EMPTY state while data is
+  // still in flight — /network takes seconds on a large brain, so "No projects yet" was shown as
+  // fact for the whole wait, and stayed forever if the request failed (the catch was silent).
+  var loadState = { net:"idle", ov:"idle", dash:"idle" };  // idle | loading | ok | error
   var seenActivity = {}, activityFirstLoad = true, recentActivity = []; // for live popups
   function freshNow(){ try{ return Date.now(); }catch(e){ return 0; } }
   var KIND_ICON = { resolve_conflict:"⚖", merge_duplicate:"⛓", compress_cluster:"🗜", reinforce:"✦" };
@@ -58,6 +62,8 @@ const CLIENT_SCRIPT = String.raw `
 
   function esc(v){ return String(v==null?"":v).replace(/[&<>"']/g,function(c){return {"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"}[c];}); }
   function clip(v,n){ var s=String(v==null?"":v).trim(); return s.length>n?s.slice(0,n)+"…":s; }
+  // "summary" → "summaries", "fact" → "facts". Belief type names are user-visible in search results.
+  function plural(w,n){ if(n===1) return w; return /(s|x|z|ch|sh)$/.test(w)?w+"es":/[^aeiou]y$/.test(w)?w.slice(0,-1)+"ies":w+"s"; }
   function fmt(n){ return (Number(n)||0).toLocaleString("en-US"); }
   function tm(iso){ try{ return new Date(iso).toLocaleTimeString([], {hour:"2-digit",minute:"2-digit",second:"2-digit"}); }catch(e){ return ""; } }
   function name(p){ return String(p||"").split("/").filter(Boolean).pop()||"project"; }
@@ -109,7 +115,15 @@ const CLIENT_SCRIPT = String.raw `
   async function loadDashboard(force){
     if(!force && (freshNow()-dashLoadedAt)<HEAVY_TTL) return;
     dashLoadedAt=freshNow();
-    try{ dash=await fetch("/global/dashboard",{cache:"no-store"}).then(function(r){return r.json();}); renderBrainHome(); }catch(e){}
+    loadState.dash="loading";
+    try{
+      dash=await fetch("/global/dashboard",{cache:"no-store"}).then(function(r){
+        if(!r.ok) throw new Error("HTTP "+r.status);
+        return r.json();
+      });
+      loadState.dash="ok";
+    }catch(e){ loadState.dash="error"; dashLoadedAt=0; }  // failed load retries on next visit
+    renderBrainHome();
   }
   // ===== NEURAL UNIVERSE — every real belief is a star; projects are galaxies =====
   var UNI = { nodes:[], clusters:[], grid:{}, cell:46, cam:{x:0,y:0,z:1}, tx:{x:0,y:0,z:1},
@@ -316,6 +330,96 @@ const CLIENT_SCRIPT = String.raw `
     UNI.hits=set;
     if(hitsEl) hitsEl.textContent=m?(m+" MATCH"+(m>1?"ES":"")):"NO MATCH";
     if(m){ UNI.tx.x=sx/m; UNI.tx.y=sy/m; UNI.tx.z=Math.max(UNI.cam.z, m<20?1.1:0.55); }
+    uniResults(q, toks);
+  }
+
+  /* Readable answer for a query: an EXTRACTIVE summary (no model call — works with AI off) plus
+     the ranked hits. Flaring stars tell you a match exists; this tells you what it says. */
+  function uniResults(q, toks){
+    var el=EL("uni-results"); if(!el) return;
+    if(!q||!UNI.hits||!UNI.hits.size){ el.hidden=true; el.innerHTML=""; return; }
+    // Dedupe by record id: the same belief can be drawn as more than one star (a global belief
+    // also appears under a project galaxy), and counting/listing it twice would misreport memory.
+    var seen={}, hits=[];
+    UNI.nodes.forEach(function(n){
+      if(!UNI.hits.has(n.id)||seen[n.id]) return;
+      seen[n.id]=1; hits.push(n);
+    });
+    // Rank: query-term density, then belief strength/importance, then recency.
+    hits.forEach(function(n){
+      var hay=(n.rec.content+" "+(n.rec.entities||[]).join(" ")).toLowerCase(), d=0;
+      toks.forEach(function(t){ var i=0; while((i=hay.indexOf(t,i))>=0){ d++; i+=t.length; } });
+      var imp=(n.rec.score&&n.rec.score.importance)||0;
+      n._r=d*2 + imp*3 + (n.rec.strength||0) + (n.rec.recallCount||0)*0.2;
+      // Current truth outranks history: a superseded/archived phrasing must never sit above the
+      // active belief that replaced it (same reasoning as stale-shadow demotion in retrieval).
+      if(n.rec.status&&n.rec.status!=="active") n._r-=6;
+      if(n.rec.pinned) n._r+=3;
+      // Prefer beliefs that ANSWER the question over pointers to where an answer lives: a bare
+      // file path matching on its filename is not a summary. Prose types lead; paths sink.
+      var c=n.rec.content||"";
+      var pathish=/^[~/.]|^[A-Za-z]:\\/.test(c.trim()) && c.trim().split(/\s+/).length<=3;
+      if(pathish) n._r-=4;
+      if(n.rec.type==="decision"||n.rec.type==="fact"||n.rec.type==="preference") n._r+=1.5;
+    });
+    hits.sort(function(a,b){ return b._r-a._r; });
+
+    // Facets: what KIND of memory answered, and where it lives.
+    var byType={}, byProj={}, ents={}, oldest=null, newest=null;
+    hits.forEach(function(n){
+      var r=n.rec;
+      byType[r.type]=(byType[r.type]||0)+1;
+      byProj[n.cl.name]=(byProj[n.cl.name]||0)+1;
+      (r.entities||[]).forEach(function(e){ ents[e]=(ents[e]||0)+1; });
+      var t=r.updatedAt||r.createdAt;
+      if(t){ if(!oldest||t<oldest) oldest=t; if(!newest||t>newest) newest=t; }
+    });
+    var topEnts=Object.keys(ents).sort(function(a,b){ return ents[b]-ents[a]; }).slice(0,6);
+    var typeStr=Object.keys(byType).sort(function(a,b){ return byType[b]-byType[a]; })
+      .map(function(t){ return byType[t]+" "+plural(t.replace(/_/g," "),byType[t]); }).join(" · ");
+    var projStr=Object.keys(byProj).sort(function(a,b){ return byProj[b]-byProj[a]; }).slice(0,3).join(", ");
+
+    // The summary line: the single strongest belief, verbatim, plus the shape of the rest.
+    // Beliefs recorded against a file often read "<absolute path>: <the actual point>" — the path
+    // is provenance (kept in the hit list), so lead with the point instead of the filename.
+    var lead=String(hits[0].rec.content||"").replace(/^\s*[~/][^\s:]{12,}:\s*/,"");
+    var summary='<b>'+esc(clip(lead,260))+'</b>';
+    if(hits.length>1) summary+='<br><span style="color:var(--muted)">+ '+(hits.length-1)+' more across '+esc(projStr)+
+      (newest?', last updated '+esc(ago(newest)):'')+'.</span>';
+
+    var facets='<span class="ur-facet">'+esc(typeStr)+'</span>'+
+      topEnts.map(function(e){ return '<span class="ur-facet">'+esc(e)+'</span>'; }).join("");
+
+    var SHOW=12;
+    var list=hits.slice(0,SHOW).map(function(n,i){
+      var r=n.rec, meta=[];
+      if(r.status&&r.status!=="active") meta.push(r.status);
+      meta.push(n.cl.name);
+      if(r.recallCount) meta.push("recalled "+r.recallCount+"×");
+      if(r.updatedAt) meta.push(ago(r.updatedAt));
+      return '<button class="ur-hit" data-i="'+i+'">'+
+        '<div class="h-t" style="color:'+n.c+'">'+esc(r.type)+'</div>'+
+        esc(clip(r.content,180))+
+        '<div class="h-m">'+esc(meta.join(" · "))+'</div></button>';
+    }).join("");
+
+    el.hidden=false;
+    el.innerHTML='<button class="ui-x" id="ur-x">✕</button>'+
+      '<div class="ur-head">'+hits.length+' belief'+(hits.length>1?"s":"")+' answer "'+esc(clip(q,40))+'"</div>'+
+      '<div class="ur-sum">'+summary+'</div>'+
+      '<div class="ur-facets">'+facets+'</div>'+
+      '<div class="ur-list">'+list+'</div>'+
+      (hits.length>SHOW?'<div class="ur-more">showing top '+SHOW+' of '+hits.length+'</div>':"");
+
+    var x=EL("ur-x"); if(x) x.addEventListener("click",function(){ el.hidden=true; });
+    Array.prototype.forEach.call(el.querySelectorAll(".ur-hit"),function(b){
+      b.addEventListener("click",function(){
+        var n=hits[Number(b.getAttribute("data-i"))];
+        if(!n) return;
+        uniInspect(n);                                   // full detail + provenance
+        UNI.tx.x=n.x; UNI.tx.y=n.y; UNI.tx.z=Math.max(1.6,UNI.cam.z);  // fly to the star
+      });
+    });
   }
   function uniInspect(n){
     var el=EL("uni-inspect"); if(!el) return;
@@ -329,7 +433,19 @@ const CLIENT_SCRIPT = String.raw `
         '<span class="g">IMP <b>'+pct(r.score&&r.score.importance)+'</b><i class="bar"><i style="width:'+pct(r.score&&r.score.importance)+'%"></i></i></span>'+
         '<span class="g">CONF <b>'+pct(r.score&&r.score.confidence)+'</b><i class="bar"><i class="b2" style="width:'+pct(r.score&&r.score.confidence)+'%"></i></i></span></div>'+
       ((r.entities&&r.entities.length)?'<div class="ui-ents">'+r.entities.slice(0,8).map(function(e){return '<span class="ent mono">'+esc(e)+'</span>';}).join("")+'</div>':"")+
-      '<div class="ui-proj mono">'+esc(n.cl.name)+(r.updatedAt?' · '+esc(ago(r.updatedAt)):'')+'</div>'+
+      // Provenance: where this belief came from and how it has been used. Answers "why does my
+      // agent believe this, and is it still current?" without opening the JSONL by hand.
+      '<div class="ui-proj mono">'+(function(){
+        var p=[];
+        if(r.createdAt) p.push("learned "+ago(r.createdAt));
+        if(r.updatedAt&&r.updatedAt!==r.createdAt) p.push("updated "+ago(r.updatedAt));
+        if(r.recallCount) p.push("recalled "+r.recallCount+"×"+(r.lastRecalledAt?" (last "+ago(r.lastRecalledAt)+")":""));
+        if(r.pinned) p.push("pinned");
+        if(r.summarizedBy) p.push("folded into a summary");
+        if(r.source&&r.source.reason) p.push("via "+clip(r.source.reason,48));
+        if(r.provenance&&r.provenance.ref) p.push("source: "+clip(r.provenance.ref,44));
+        return esc(n.cl.name)+(p.length?' · '+esc(p.join(" · ")):'');
+      })()+'</div>'+
       (n.cl.path?'<button class="btn sm" id="ui-open">OPEN IN MEMORY BANKS →</button>':"");
     var x=EL("ui-x"); if(x) x.addEventListener("click",function(){ uniInspect(null); });
     var op=EL("ui-open"); if(op) op.addEventListener("click",function(){
@@ -399,7 +515,13 @@ const CLIENT_SCRIPT = String.raw `
         '<div class="pcname">'+esc(p.projectName)+dis+'</div>'+
         '<div class="pcstats"><span class="pcg">'+p.active+'</span> active beliefs'+(p.pinned?' · '+p.pinned+' pinned':'')+'</div>'+
         '<div class="pcgo">open insights →</div></button>';
-    }).join(""):'<div class="empty">No projects yet</div>';
+    }).join(""):(
+      // Never claim "no projects" while we are still asking, or when the ask failed — on a large
+      // brain /network takes seconds, and a silent failure used to look identical to an empty box.
+      loadState.net==="loading" ? '<div class="empty">Reading project brains…</div>' :
+      loadState.net==="error"   ? '<div class="empty">Could not reach the daemon. <button class="btn sm" id="proj-retry">Retry</button></div>' :
+                                  '<div class="empty">No projects yet</div>');
+    var pr=EL("proj-retry"); if(pr) pr.addEventListener("click",function(){ loadNetwork(true); });
     Array.prototype.forEach.call(document.querySelectorAll(".pcard"),function(b){ b.addEventListener("click",function(){ ui.project=b.getAttribute("data-p"); ui.search=null; ui.focus=null; overview=null; syncSwitcher(); location.hash="#/overview"; }); });
   }
 
@@ -408,7 +530,15 @@ const CLIENT_SCRIPT = String.raw `
     if(!ui.project) return;
     if(!force && (freshNow()-ovLoadedAt)<HEAVY_TTL) return; // throttle the heavy endpoint
     ovLoadedAt=freshNow();
-    try{ overview=await fetch("/overview?projectPath="+encodeURIComponent(ui.project),{cache:"no-store"}).then(function(r){return r.json();}); renderOverviewPage(); }catch(e){}
+    loadState.ov="loading";
+    try{
+      overview=await fetch("/overview?projectPath="+encodeURIComponent(ui.project),{cache:"no-store"}).then(function(r){
+        if(!r.ok) throw new Error("HTTP "+r.status);
+        return r.json();
+      });
+      loadState.ov="ok";
+    }catch(e){ loadState.ov="error"; ovLoadedAt=0; }  // failed load retries on next visit
+    renderOverviewPage();
   }
   function renderOverviewPage(){
     var sel=selected();
@@ -530,7 +660,18 @@ const CLIENT_SCRIPT = String.raw `
   async function loadNetwork(force){
     if(!force && (freshNow()-netLoadedAt)<HEAVY_TTL) return; // throttle the heavy endpoint
     netLoadedAt=freshNow();
-    try{ network=await fetch("/network",{cache:"no-store"}).then(function(r){return r.json();}); renderProjectsGrid(); }catch(e){}
+    loadState.net="loading"; renderProjectsGrid();
+    try{
+      network=await fetch("/network",{cache:"no-store"}).then(function(r){
+        if(!r.ok) throw new Error("HTTP "+r.status);
+        return r.json();
+      });
+      loadState.net="ok";
+    }catch(e){
+      loadState.net="error";
+      netLoadedAt=0;  // a failed load must not be throttled — let the next visit retry
+    }
+    renderProjectsGrid();
   }
 
   // ===== OPS (tokens + activity) =====
@@ -642,6 +783,10 @@ const DOCUMENT = String.raw `<!doctype html>
     box-shadow:0 0 18px -4px rgba(89,227,255,.7), inset 0 0 12px rgba(89,227,255,.12); text-shadow:0 0 10px rgba(89,227,255,.8);}
   .switcher{background:rgba(5,18,32,.9); border:1px solid var(--line2); color:var(--cyan-ink); clip-path:var(--cham);
     padding:7px 12px; max-width:230px; font-size:12px; font-family:var(--mono);}
+  /* Quiet star link — same weight as the status text, never competes with the field. */
+  .ghlink{flex:none; font-family:var(--mono); font-size:10px; letter-spacing:.12em; text-transform:uppercase;
+    color:var(--muted); text-decoration:none; border:1px solid rgba(89,227,255,.25); padding:4px 9px; clip-path:var(--cham);}
+  .ghlink:hover{color:var(--cyan); border-color:var(--cyan); box-shadow:0 0 16px -6px rgba(89,227,255,.8);}
   .live{display:flex; align-items:center; gap:8px; font-size:10.5px; color:var(--muted); flex:none;
     font-family:var(--mono); text-transform:uppercase; letter-spacing:.14em;}
   .dot{width:8px; height:8px; border-radius:50%; background:var(--cyan); box-shadow:0 0 12px var(--cyan); animation:beat 2s infinite;}
@@ -873,6 +1018,26 @@ const DOCUMENT = String.raw `<!doctype html>
   .ui-meta{display:flex; gap:14px; margin-bottom:9px;}
   .ui-ents{display:flex; flex-wrap:wrap; gap:5px; margin-bottom:10px;}
   .ui-proj{color:var(--faint); font-size:10px; margin-bottom:11px;}
+  /* Search RESULTS panel (right side, mirrors .uni-inspect on the left): the readable answer to
+     a query — an extractive summary of what memory says, then the ranked hits you can click. */
+  .uni-results{position:absolute; top:60px; right:14px; z-index:8; width:360px; max-height:calc(100% - 130px); overflow:auto;
+    background:linear-gradient(165deg, rgba(8,26,42,.96), rgba(4,14,26,.96)); border:1px solid var(--cyan); clip-path:var(--cham);
+    padding:16px; box-shadow:0 0 34px -8px rgba(89,227,255,.5);}
+  .ur-head{font-family:var(--mono); font-size:10px; letter-spacing:.18em; text-transform:uppercase; color:var(--cyan);
+    margin-bottom:10px; text-shadow:0 0 10px rgba(89,227,255,.6);}
+  .ur-sum{font-size:12px; line-height:1.6; color:var(--ink); border-left:2px solid var(--cyan);
+    padding:2px 0 2px 10px; margin-bottom:12px;}
+  .ur-sum b{color:var(--cyan-ink);}
+  .ur-facets{display:flex; flex-wrap:wrap; gap:5px; margin-bottom:12px;}
+  .ur-facet{font-family:var(--mono); font-size:9.5px; letter-spacing:.08em; text-transform:uppercase;
+    border:1px solid rgba(89,227,255,.35); color:var(--muted); padding:2px 6px; clip-path:var(--cham);}
+  .ur-list{display:flex; flex-direction:column; gap:7px;}
+  .ur-hit{text-align:left; width:100%; background:rgba(6,20,34,.7); border:1px solid rgba(89,227,255,.18);
+    padding:8px 10px; clip-path:var(--cham); cursor:pointer; color:var(--ink); font-size:11.5px; line-height:1.5;}
+  .ur-hit:hover{border-color:var(--cyan); background:rgba(10,30,48,.9);}
+  .ur-hit .h-t{font-family:var(--mono); font-size:9px; letter-spacing:.12em; text-transform:uppercase; color:var(--cyan); margin-bottom:3px;}
+  .ur-hit .h-m{font-family:var(--mono); font-size:9px; color:var(--faint); margin-top:4px;}
+  .ur-more{font-family:var(--mono); font-size:9.5px; color:var(--faint); margin-top:9px; text-align:center;}
   .uni-ticker{position:absolute; left:0; right:0; bottom:0; z-index:6; padding:8px 16px 10px;
     background:linear-gradient(180deg, transparent, rgba(2,8,16,.9) 40%); font-family:var(--mono); font-size:10px; color:var(--muted);}
   .utk{padding:2px 0; white-space:nowrap; overflow:hidden; text-overflow:ellipsis;}
@@ -902,6 +1067,8 @@ const DOCUMENT = String.raw `<!doctype html>
     <a id="nav-ops" href="#/ops">Systems</a>
   </nav>
   <select class="switcher" id="switcher" aria-label="Active project"></select>
+  <a class="ghlink" href="https://github.com/VineetV2/peon-mem" target="_blank" rel="noopener noreferrer"
+     title="Peon is open source — star it so others find it">★ Star</a>
   <div class="live"><span class="dot" id="dot"></span><span id="status">linking…</span></div>
 </header>
 
@@ -918,6 +1085,7 @@ const DOCUMENT = String.raw `<!doctype html>
       <div class="uni-legend" id="uni-legend"></div>
       <div class="uni-tip mono" id="uni-tip" hidden></div>
       <div class="uni-inspect" id="uni-inspect" hidden></div>
+      <div class="uni-results" id="uni-results" hidden></div>
       <div class="uni-ticker" id="uni-ticker"></div>
     </div>
     <div id="bh-body"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peon-mem",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "type": "module",
   "main": "dist/index.js",
   "bin": {