claude-memory-hub 0.9.2 → 0.9.4

package/CHANGELOG.md

@@ -5,6 +5,38 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ---
 
+## [0.9.4] - 2026-04-02
+
+Windows path fix — backslashes no longer eaten by bash.
+
+### Bug Fixes
+
+- **Windows backslash paths in hooks** — `C:\Users\Admin\.bun\bin\bun.exe` was passed raw into bash commands, which stripped backslashes → `C:UsersAdmin.bunbinbun.exe`. New `shellPath()` utility converts all paths to forward slashes (`C:/Users/Admin/.bun/bin/bun.exe`) and quotes paths with spaces. Applied to: bun binary path, hook script paths, MCP server path
+- **`where` output parsing on Windows** — `where bun` returns `\r\n` line endings; now splits on `/\r?\n/` instead of `\n`
+
+---
+
+## [0.9.3] - 2026-04-02
+
+Summary quality improvements — cleaner data in, garbage data out.
+
+### Summary Quality
+
+- **Strip IDE tags from user_prompt** — `<ide_opened_file>`, `<ide_selection>`, `<system-reminder>` tags are now removed before storing `user_prompt` in L2. Summaries and search results no longer contain IDE noise
+- **Skip low-value sessions** — sessions with only `file_read` entities (browsing, no edits) and no errors/decisions/notes/observations are no longer summarized. Prevents generic "Session in project X" entries from polluting L3
+- **`hasModifiedFiles()` method** — new SessionStore method checks for `file_modified` or `file_created` entities efficiently
+
+### New CLI Command
+
+- **`prune` command** — removes low-quality summaries from L3: generic text ("Session worked on...", "Session in project..."), IDE tag noise, and empty summaries with no files/decisions/errors. Supports `--dry-run` for safe preview. Also cleans related embeddings
+
+```bash
+bunx claude-memory-hub prune --dry-run  # preview
+bunx claude-memory-hub prune            # delete
+```
+
+---
+
 ## [0.9.2] - 2026-04-02
 
 Cross-platform hook reliability — Windows/WSL no longer fails with "bun: command not found".

package/README.md

@@ -285,6 +285,7 @@ bunx claude-memory-hub reindex     # Rebuild TF-IDF + embedding indexes
 bunx claude-memory-hub export      # Export data as JSONL to stdout
 bunx claude-memory-hub import      # Import JSONL from stdin (--dry-run)
 bunx claude-memory-hub cleanup     # Remove old data (--days N, default 90)
+bunx claude-memory-hub prune       # Remove low-quality summaries (--dry-run)
 ```
 
 ### Requirements

package/dist/cli.js

@@ -110,6 +110,13 @@ var init_logger = __esm(() => {
 });
 
 // src/db/schema.ts
+var exports_schema = {};
+__export(exports_schema, {
+  initDatabase: () => initDatabase,
+  getDbPath: () => getDbPath,
+  getDatabase: () => getDatabase,
+  closeDatabase: () => closeDatabase
+});
 import { Database } from "bun:sqlite";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
 import { homedir as homedir2 } from "os";
@@ -242,6 +249,12 @@ function getDatabase() {
   }
   return _db;
 }
+function closeDatabase() {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}
 var log, CREATE_TABLES = `
 -- Migration version tracking
 CREATE TABLE IF NOT EXISTS schema_versions (
@@ -1954,29 +1967,32 @@ import { spawnSync } from "child_process";
 var CLAUDE_DIR = join5(homedir5(), ".claude");
 var SETTINGS_PATH = join5(CLAUDE_DIR, "settings.json");
 var PKG_DIR = resolve(dirname(import.meta.dir));
+function shellPath(p) {
+  const normalized = p.replace(/\\/g, "/");
+  return normalized.includes(" ") ? `"${normalized}"` : normalized;
+}
 function getBunPath() {
   const result = spawnSync(process.platform === "win32" ? "where" : "which", ["bun"], {
     encoding: "utf-8"
   });
-  const resolved = result.stdout?.trim().split(`
-`)[0]?.trim();
+  const resolved = result.stdout?.trim().split(/\r?\n/)[0]?.trim();
   if (resolved && existsSync5(resolved))
-    return resolved;
+    return shellPath(resolved);
   const candidates = [
     join5(homedir5(), ".bun", "bin", "bun"),
     join5(homedir5(), ".bun", "bin", "bun.exe")
   ];
   for (const c of candidates) {
     if (existsSync5(c))
-      return c;
+      return shellPath(c);
   }
   return "bun";
 }
 function getHookPath(hookName) {
-  return join5(PKG_DIR, "dist", "hooks", `${hookName}.js`);
+  return shellPath(join5(PKG_DIR, "dist", "hooks", `${hookName}.js`));
 }
 function getMcpServerPath() {
-  return join5(PKG_DIR, "dist", "index.js");
+  return shellPath(join5(PKG_DIR, "dist", "index.js"));
 }
 function loadSettings() {
   if (!existsSync5(SETTINGS_PATH))
@@ -2223,6 +2239,42 @@ switch (command) {
     console.log(`Deleted: ${result.sessions_deleted} sessions, ${result.entities_deleted} entities, ${result.embeddings_deleted} embeddings`);
     break;
   }
+  case "prune": {
+    const { getDatabase: getDatabase2 } = (init_schema(), __toCommonJS(exports_schema));
+    const db = getDatabase2();
+    const dryRun = process.argv.includes("--dry-run");
+    console.log(`claude-memory-hub \u2014 prune low-quality summaries${dryRun ? " (dry run)" : ""}
+`);
+    const garbage = db.query(`SELECT id, session_id, summary FROM long_term_summaries
+       WHERE length(summary) < 50
+          OR summary LIKE '%Session worked on%'
+          OR summary LIKE '%Session in project%'
+          OR summary LIKE '%<ide_%'
+          OR summary LIKE '%<system-reminder>%'
+          OR (files_touched = '[]' AND decisions = '[]' AND errors_fixed = '[]' AND length(summary) < 100)`).all();
+    if (garbage.length === 0) {
+      console.log("  No low-quality summaries found. Database is clean.");
+      break;
+    }
+    console.log(`  Found ${garbage.length} low-quality summaries:`);
+    for (const g of garbage.slice(0, 10)) {
+      console.log(`    [${g.id}] "${g.summary.slice(0, 80)}${g.summary.length > 80 ? "..." : ""}"`);
+    }
+    if (garbage.length > 10)
+      console.log(`    ... and ${garbage.length - 10} more`);
+    if (dryRun) {
+      console.log(`
+  Dry run \u2014 no changes made. Remove --dry-run to delete.`);
+    } else {
+      const ids = garbage.map((g) => g.id);
+      const placeholders = ids.map(() => "?").join(",");
+      db.run(`DELETE FROM long_term_summaries WHERE id IN (${placeholders})`, ids);
+      db.run(`DELETE FROM embeddings WHERE doc_type = 'summary' AND doc_id IN (${placeholders})`, ids.map(String));
+      console.log(`
+  Deleted ${garbage.length} summaries + related embeddings.`);
+    }
+    break;
+  }
   default:
     console.log(`claude-memory-hub \u2014 persistent memory for Claude Code
 `);
@@ -2237,6 +2289,7 @@ switch (command) {
     console.log("  export      Export data as JSONL (--since T, --table T)");
     console.log("  import      Import JSONL from stdin (--dry-run)");
     console.log("  cleanup     Remove old data (--days N, default 90)");
+    console.log("  prune       Remove low-quality summaries (--dry-run)");
     console.log(`
 Usage: npx claude-memory-hub <command>`);
     break;

package/dist/hooks/post-compact.js

@@ -407,6 +407,11 @@ class SessionStore {
          WHERE session_id = ? AND entity_type IN ('file_read','file_modified','file_created')
          ORDER BY importance DESC, created_at DESC`).all(session_id).map((r) => r.entity_value);
   }
+  hasModifiedFiles(session_id) {
+    const row = this.db.query(`SELECT COUNT(*) as c FROM entities
+         WHERE session_id = ? AND entity_type IN ('file_modified','file_created') LIMIT 1`).get(session_id);
+    return (row?.c ?? 0) > 0;
+  }
   insertNote(note) {
     this.db.run("INSERT INTO session_notes(session_id, content, created_at) VALUES (?, ?, ?)", [note.session_id, note.content, note.created_at]);
   }
@@ -658,6 +663,9 @@ class SessionSummarizer {
     const notes = this.sessionStore.getSessionNotes(session_id).map((n) => n.content);
     if (files.length === 0 && errors.length === 0 && notes.length === 0)
       return;
+    const hasModified = this.sessionStore.hasModifiedFiles(session_id);
+    if (!hasModified && errors.length === 0 && decisions.length === 0 && notes.length === 0 && observations.length === 0)
+      return;
     const obsValues = observations.slice(0, 5).map((o) => o.entity_value);
     let summaryText;
     let tier = "rule-based";
@@ -1912,6 +1920,9 @@ function safeJson2(text, fallback) {
 
 // src/capture/hook-handler.ts
 import { basename as basename3 } from "path";
+function stripIdeTags(prompt) {
+  return prompt.replace(/<ide_opened_file>[\s\S]*?<\/ide_opened_file>\s*/g, "").replace(/<ide_selection>[\s\S]*?<\/ide_selection>\s*/g, "").replace(/<system-reminder>[\s\S]*?<\/system-reminder>\s*/g, "").trim();
+}
 async function handlePostToolUse(hook, project) {
   const store = new SessionStore;
   store.upsertSession({
@@ -1947,14 +1958,15 @@ async function handlePostToolUse(hook, project) {
 async function handleUserPromptSubmit(hook, project) {
   const store = new SessionStore;
   const ltStore = new LongTermStore;
+  const cleanPrompt = stripIdeTags(hook.prompt);
   store.upsertSession({
     id: hook.session_id,
     project,
     started_at: Date.now(),
-    user_prompt: hook.prompt.slice(0, 500),
+    user_prompt: cleanPrompt.slice(0, 500) || hook.prompt.slice(0, 500),
     status: "active"
   });
-  const promptObs = extractObservationFromPrompt(hook.prompt, hook.session_id, project, 0);
+  const promptObs = extractObservationFromPrompt(cleanPrompt || hook.prompt, hook.session_id, project, 0);
   if (promptObs)
     store.insertEntity({ ...promptObs, project });
   const results = ltStore.search(hook.prompt, 3);

package/dist/hooks/post-tool-use.js

@@ -407,6 +407,11 @@ class SessionStore {
          WHERE session_id = ? AND entity_type IN ('file_read','file_modified','file_created')
          ORDER BY importance DESC, created_at DESC`).all(session_id).map((r) => r.entity_value);
   }
+  hasModifiedFiles(session_id) {
+    const row = this.db.query(`SELECT COUNT(*) as c FROM entities
+         WHERE session_id = ? AND entity_type IN ('file_modified','file_created') LIMIT 1`).get(session_id);
+    return (row?.c ?? 0) > 0;
+  }
   insertNote(note) {
     this.db.run("INSERT INTO session_notes(session_id, content, created_at) VALUES (?, ?, ?)", [note.session_id, note.content, note.created_at]);
   }
@@ -1619,6 +1624,9 @@ function safeJson2(text, fallback) {
 
 // src/capture/hook-handler.ts
 import { basename as basename3 } from "path";
+function stripIdeTags(prompt) {
+  return prompt.replace(/<ide_opened_file>[\s\S]*?<\/ide_opened_file>\s*/g, "").replace(/<ide_selection>[\s\S]*?<\/ide_selection>\s*/g, "").replace(/<system-reminder>[\s\S]*?<\/system-reminder>\s*/g, "").trim();
+}
 async function handlePostToolUse(hook, project) {
   const store = new SessionStore;
   store.upsertSession({
@@ -1654,14 +1662,15 @@ async function handlePostToolUse(hook, project) {
 async function handleUserPromptSubmit(hook, project) {
   const store = new SessionStore;
   const ltStore = new LongTermStore;
+  const cleanPrompt = stripIdeTags(hook.prompt);
   store.upsertSession({
     id: hook.session_id,
     project,
     started_at: Date.now(),
-    user_prompt: hook.prompt.slice(0, 500),
+    user_prompt: cleanPrompt.slice(0, 500) || hook.prompt.slice(0, 500),
     status: "active"
   });
-  const promptObs = extractObservationFromPrompt(hook.prompt, hook.session_id, project, 0);
+  const promptObs = extractObservationFromPrompt(cleanPrompt || hook.prompt, hook.session_id, project, 0);
   if (promptObs)
     store.insertEntity({ ...promptObs, project });
   const results = ltStore.search(hook.prompt, 3);

package/dist/hooks/pre-compact.js

@@ -407,6 +407,11 @@ class SessionStore {
          WHERE session_id = ? AND entity_type IN ('file_read','file_modified','file_created')
          ORDER BY importance DESC, created_at DESC`).all(session_id).map((r) => r.entity_value);
   }
+  hasModifiedFiles(session_id) {
+    const row = this.db.query(`SELECT COUNT(*) as c FROM entities
+         WHERE session_id = ? AND entity_type IN ('file_modified','file_created') LIMIT 1`).get(session_id);
+    return (row?.c ?? 0) > 0;
+  }
   insertNote(note) {
     this.db.run("INSERT INTO session_notes(session_id, content, created_at) VALUES (?, ?, ?)", [note.session_id, note.content, note.created_at]);
   }
@@ -658,6 +663,9 @@ class SessionSummarizer {
     const notes = this.sessionStore.getSessionNotes(session_id).map((n) => n.content);
     if (files.length === 0 && errors.length === 0 && notes.length === 0)
       return;
+    const hasModified = this.sessionStore.hasModifiedFiles(session_id);
+    if (!hasModified && errors.length === 0 && decisions.length === 0 && notes.length === 0 && observations.length === 0)
+      return;
     const obsValues = observations.slice(0, 5).map((o) => o.entity_value);
     let summaryText;
     let tier = "rule-based";
@@ -1912,6 +1920,9 @@ function safeJson2(text, fallback) {
 
 // src/capture/hook-handler.ts
 import { basename as basename3 } from "path";
+function stripIdeTags(prompt) {
+  return prompt.replace(/<ide_opened_file>[\s\S]*?<\/ide_opened_file>\s*/g, "").replace(/<ide_selection>[\s\S]*?<\/ide_selection>\s*/g, "").replace(/<system-reminder>[\s\S]*?<\/system-reminder>\s*/g, "").trim();
+}
 async function handlePostToolUse(hook, project) {
   const store = new SessionStore;
   store.upsertSession({
@@ -1947,14 +1958,15 @@ async function handlePostToolUse(hook, project) {
 async function handleUserPromptSubmit(hook, project) {
   const store = new SessionStore;
   const ltStore = new LongTermStore;
+  const cleanPrompt = stripIdeTags(hook.prompt);
   store.upsertSession({
     id: hook.session_id,
     project,
     started_at: Date.now(),
-    user_prompt: hook.prompt.slice(0, 500),
+    user_prompt: cleanPrompt.slice(0, 500) || hook.prompt.slice(0, 500),
     status: "active"
   });
-  const promptObs = extractObservationFromPrompt(hook.prompt, hook.session_id, project, 0);
+  const promptObs = extractObservationFromPrompt(cleanPrompt || hook.prompt, hook.session_id, project, 0);
   if (promptObs)
     store.insertEntity({ ...promptObs, project });
   const results = ltStore.search(hook.prompt, 3);

package/dist/hooks/session-end.js

@@ -407,6 +407,11 @@ class SessionStore {
          WHERE session_id = ? AND entity_type IN ('file_read','file_modified','file_created')
          ORDER BY importance DESC, created_at DESC`).all(session_id).map((r) => r.entity_value);
   }
+  hasModifiedFiles(session_id) {
+    const row = this.db.query(`SELECT COUNT(*) as c FROM entities
+         WHERE session_id = ? AND entity_type IN ('file_modified','file_created') LIMIT 1`).get(session_id);
+    return (row?.c ?? 0) > 0;
+  }
   insertNote(note) {
     this.db.run("INSERT INTO session_notes(session_id, content, created_at) VALUES (?, ?, ?)", [note.session_id, note.content, note.created_at]);
   }
@@ -1619,6 +1624,9 @@ function safeJson2(text, fallback) {
 
 // src/capture/hook-handler.ts
 import { basename as basename3 } from "path";
+function stripIdeTags(prompt) {
+  return prompt.replace(/<ide_opened_file>[\s\S]*?<\/ide_opened_file>\s*/g, "").replace(/<ide_selection>[\s\S]*?<\/ide_selection>\s*/g, "").replace(/<system-reminder>[\s\S]*?<\/system-reminder>\s*/g, "").trim();
+}
 async function handlePostToolUse(hook, project) {
   const store = new SessionStore;
   store.upsertSession({
@@ -1654,14 +1662,15 @@ async function handlePostToolUse(hook, project) {
 async function handleUserPromptSubmit(hook, project) {
   const store = new SessionStore;
   const ltStore = new LongTermStore;
+  const cleanPrompt = stripIdeTags(hook.prompt);
   store.upsertSession({
     id: hook.session_id,
     project,
     started_at: Date.now(),
-    user_prompt: hook.prompt.slice(0, 500),
+    user_prompt: cleanPrompt.slice(0, 500) || hook.prompt.slice(0, 500),
     status: "active"
   });
-  const promptObs = extractObservationFromPrompt(hook.prompt, hook.session_id, project, 0);
+  const promptObs = extractObservationFromPrompt(cleanPrompt || hook.prompt, hook.session_id, project, 0);
   if (promptObs)
     store.insertEntity({ ...promptObs, project });
   const results = ltStore.search(hook.prompt, 3);
@@ -1936,6 +1945,9 @@ class SessionSummarizer {
     const notes = this.sessionStore.getSessionNotes(session_id).map((n) => n.content);
     if (files.length === 0 && errors.length === 0 && notes.length === 0)
       return;
+    const hasModified = this.sessionStore.hasModifiedFiles(session_id);
+    if (!hasModified && errors.length === 0 && decisions.length === 0 && notes.length === 0 && observations.length === 0)
+      return;
     const obsValues = observations.slice(0, 5).map((o) => o.entity_value);
     let summaryText;
     let tier = "rule-based";

package/dist/hooks/user-prompt-submit.js

@@ -407,6 +407,11 @@ class SessionStore {
          WHERE session_id = ? AND entity_type IN ('file_read','file_modified','file_created')
          ORDER BY importance DESC, created_at DESC`).all(session_id).map((r) => r.entity_value);
   }
+  hasModifiedFiles(session_id) {
+    const row = this.db.query(`SELECT COUNT(*) as c FROM entities
+         WHERE session_id = ? AND entity_type IN ('file_modified','file_created') LIMIT 1`).get(session_id);
+    return (row?.c ?? 0) > 0;
+  }
   insertNote(note) {
     this.db.run("INSERT INTO session_notes(session_id, content, created_at) VALUES (?, ?, ?)", [note.session_id, note.content, note.created_at]);
   }
@@ -1619,6 +1624,9 @@ function safeJson2(text, fallback) {
 
 // src/capture/hook-handler.ts
 import { basename as basename3 } from "path";
+function stripIdeTags(prompt) {
+  return prompt.replace(/<ide_opened_file>[\s\S]*?<\/ide_opened_file>\s*/g, "").replace(/<ide_selection>[\s\S]*?<\/ide_selection>\s*/g, "").replace(/<system-reminder>[\s\S]*?<\/system-reminder>\s*/g, "").trim();
+}
 async function handlePostToolUse(hook, project) {
   const store = new SessionStore;
   store.upsertSession({
@@ -1654,14 +1662,15 @@ async function handlePostToolUse(hook, project) {
 async function handleUserPromptSubmit(hook, project) {
   const store = new SessionStore;
   const ltStore = new LongTermStore;
+  const cleanPrompt = stripIdeTags(hook.prompt);
   store.upsertSession({
     id: hook.session_id,
     project,
     started_at: Date.now(),
-    user_prompt: hook.prompt.slice(0, 500),
+    user_prompt: cleanPrompt.slice(0, 500) || hook.prompt.slice(0, 500),
     status: "active"
   });
-  const promptObs = extractObservationFromPrompt(hook.prompt, hook.session_id, project, 0);
+  const promptObs = extractObservationFromPrompt(cleanPrompt || hook.prompt, hook.session_id, project, 0);
   if (promptObs)
     store.insertEntity({ ...promptObs, project });
   const results = ltStore.search(hook.prompt, 3);

package/dist/index.js

@@ -14171,6 +14171,11 @@ class SessionStore {
          WHERE session_id = ? AND entity_type IN ('file_read','file_modified','file_created')
          ORDER BY importance DESC, created_at DESC`).all(session_id).map((r) => r.entity_value);
   }
+  hasModifiedFiles(session_id) {
+    const row = this.db.query(`SELECT COUNT(*) as c FROM entities
+         WHERE session_id = ? AND entity_type IN ('file_modified','file_created') LIMIT 1`).get(session_id);
+    return (row?.c ?? 0) > 0;
+  }
   insertNote(note) {
     this.db.run("INSERT INTO session_notes(session_id, content, created_at) VALUES (?, ?, ?)", [note.session_id, note.content, note.created_at]);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-hub",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "Persistent memory system for Claude Code. Zero API key. Zero Python. 5 hooks + MCP server + SQLite FTS5 + semantic search.",
   "type": "module",
   "main": "dist/index.js",