peon-mem 1.0.4 → 1.0.6

package/README.md

@@ -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

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/embedding-store.d.ts

@@ -40,4 +40,4 @@ export declare class EmbeddingStore {
 /** Serialize a vector as base64 of its float32 bytes — ~4x smaller + faster to parse than JSON float64. */
 export declare function encodeVector(vector: EmbeddingVector): string;
 /** Decode a base64 float32 vector back to number[]; null on malformed/misaligned input. */
-export declare function decodeVector(b64: string): number[] | null;
+export declare function decodeVector(b64: string): Float32Array | null;

package/dist/embedding-store.js

@@ -140,7 +140,10 @@ export function decodeVector(b64) {
         const buf = Buffer.from(b64, "base64");
         if (buf.byteLength === 0 || buf.byteLength % 4 !== 0)
             return null;
-        return Array.from(new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4));
+        // Return the Float32Array itself rather than Array.from(...): a number[] stores every
+        // dimension as a double, doubling memory and copying 28k vectors on every cold load.
+        // slice() so the vector owns its bytes instead of pinning Node's shared Buffer pool.
+        return new Float32Array(buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength));
     }
     catch {
         return null;

package/dist/embeddings.d.ts

@@ -15,7 +15,7 @@ import type { PeonConfig } from "./config.js";
  *
  *   - "off" mode: no embeddings; retrieval stays purely lexical.
  */
-export type EmbeddingVector = number[];
+export type EmbeddingVector = number[] | Float32Array;
 export declare const LOCAL_EMBEDDING_DIM = 256;
 export declare const LOCAL_EMBEDDING_MODEL = "peon-local-trigram-v1";
 export interface EmbeddingClient {

package/dist/embeddings.js

@@ -28,7 +28,10 @@ export function l2normalize(vector) {
     norm = Math.sqrt(norm);
     if (norm === 0)
         return vector.slice();
-    return vector.map((value) => value / norm);
+    const out = new Float32Array(vector.length);
+    for (let i = 0; i < vector.length; i += 1)
+        out[i] = vector[i] / norm;
+    return out;
 }
 /**
  * Deterministic local embedding: hashed character trigrams folded into a fixed
@@ -96,7 +99,8 @@ function b64decode(b64) {
         const buf = Buffer.from(b64, "base64");
         if (buf.byteLength === 0 || buf.byteLength % 4 !== 0)
             return null;
-        return Array.from(new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4));
+        // slice() to own the bytes: a view onto buf.buffer would pin Node's shared Buffer pool.
+        return new Float32Array(buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength));
     }
     catch {
         return null;

package/dist/memory-store.d.ts

@@ -1,5 +1,5 @@
 import { type PeonConfig } from "./config.js";
-import { type EmbeddingClient } from "./embeddings.js";
+import { type EmbeddingClient, type EmbeddingVector } from "./embeddings.js";
 import type { MemoryQualityReport } from "./quality.js";
 import { type MemoryPatch } from "./memory-mutations.js";
 import { type BrainAction, type Summarizer } from "./brain.js";
@@ -134,7 +134,7 @@ export declare class PeonMemoryStore {
      */
     rankRecordsReadonly(query: string | undefined, options?: {
         limit?: number;
-        queryVector?: number[];
+        queryVector?: EmbeddingVector;
     }): Promise<RankedMemoryRecord[]>;
     private buildSemanticInput;
     writeQualityReport(report: MemoryQualityReport): Promise<void>;

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:"✦" };
@@ -111,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},
@@ -503,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"; }); });
   }
 
@@ -512,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();
@@ -634,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) =====
@@ -746,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;}
@@ -1026,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>
 

package/package.json

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