claude-mem-lite 3.50.0 → 3.51.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "3.50.0",
+      "version": "3.51.0",
       "source": "./",
       "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. Hybrid FTS5 + TF-IDF search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark)."
     }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.50.0",
+  "version": "3.51.0",
   "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. Hybrid FTS5 + TF-IDF search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark).",
   "author": {
     "name": "sdsrss"

package/hook.mjs

@@ -344,8 +344,13 @@ async function handlePostToolUse() {
   let db = null;
   const getDb = () => { if (!db) db = openDb(); return db; };
 
-  // Tier 2 G: Error-triggered recall
-  if (bashSig?.isError) {
+  // Tier 2 G: Error-triggered recall. Gated on isHardError (genuine failure
+  // fingerprint), NOT isError — the loose gate fired "Related memories found for
+  // this error" on exit-0 commands whose output merely contained the word "error"
+  // (G8, roadmap 2026-07-18), and was self-recursive: the hint string itself
+  // contains 'error', so a later command echoing it re-triggered recall.
+  // entry.isError above keeps the loose semantics on purpose (episode narrative).
+  if (bashSig?.isHardError) {
     const d = getDb();
     if (d) triggerErrorRecall(d, toolInput, resp);
   }

package/lib/deferred-work.mjs

@@ -58,6 +58,49 @@ export function listOpenWithOrdinal(db, project, limit = 10) {
   `).all(project, limit);
 }
 
+// ─── G11: list age + stale refresh hint (roadmap 2026-07-18) ─────────────────
+
+const DAY_MS = 86_400_000;
+export const DEFER_STALE_DAYS = 30;
+
+/**
+ * Render one `defer list` row (shared by CLI cmdDeferList and MCP
+ * mem_defer_list — no hand-synced twins). Age rides inside the id tag:
+ * `1. 🟡 [P2] title (D#5, 12d)`.
+ * @param {{ordinal, priority, title, id, created_at_epoch}} r
+ * @param {number} [now]
+ */
+export function formatDeferListRow(r, now = Date.now()) {
+  const pTag = r.priority === 3 ? '🔴' : r.priority === 1 ? '⚪' : '🟡';
+  const days = Math.max(0, Math.floor((now - r.created_at_epoch) / DAY_MS));
+  return `${r.ordinal}. ${pTag} [P${r.priority}] ${r.title} (D#${r.id}, ${days}d)`;
+}
+
+/**
+ * Count ALL open rows older than DEFER_STALE_DAYS in the project — deliberately
+ * not derived from the displayed list: (priority DESC, created_at ASC) ordering
+ * sinks old P1 rows past the LIMIT, and those are exactly the ones the hint
+ * exists for.
+ */
+export function countStaleOpen(db, project, now = Date.now()) {
+  return db.prepare(`
+    SELECT COUNT(*) AS n FROM deferred_work
+    WHERE project = ? AND status = 'open' AND created_at_epoch < ?
+  `).get(project, now - DEFER_STALE_DAYS * DAY_MS).n;
+}
+
+/**
+ * Tail hint for stale open items. Null when none — callers print nothing.
+ * Nudge-only by design: no auto-demote / auto-drop (defer is a commitment
+ * surface; silent cleanup would break it).
+ * @param {number} staleCount
+ * @returns {string|null}
+ */
+export function formatDeferStaleHint(staleCount) {
+  if (!staleCount || staleCount <= 0) return null;
+  return `⚠ ${staleCount} item(s) open >${DEFER_STALE_DAYS} days — refresh (still relevant?) or drop with a reason.`;
+}
+
 /**
  * Set status='dropped' with a non-empty reason. No-op when status is not 'open'.
  * @returns {{changed: number}} 1 if updated, 0 if not found or not open.

package/mem-cli.mjs

@@ -56,6 +56,7 @@ import {
   resolveDeferredIds, closeDeferredItems,
   getDeferredByIds, formatDeferredDetail,
   searchDeferredWork, formatDeferredSearchTrailer,
+  formatDeferListRow, countStaleOpen, formatDeferStaleHint,
 } from './lib/deferred-work.mjs';
 
 // ─── Commands ────────────────────────────────────────────────────────────────
@@ -1037,9 +1038,10 @@ function cmdDeferList(db, args) {
   }
   out(`[mem] Open deferred items (project "${project}"):`);
   for (const r of list) {
-    const pTag = r.priority === 3 ? '🔴' : r.priority === 1 ? '⚪' : '🟡';
-    out(`  ${r.ordinal}. ${pTag} [P${r.priority}] ${r.title} (D#${r.id})`);
+    out(`  ${formatDeferListRow(r)}`);
   }
+  const staleHint = formatDeferStaleHint(countStaleOpen(db, project));
+  if (staleHint) out(`  ${staleHint}`);
   // Affordance for the detail field — list stays title-only by design (it is
   // mirrored into the SessionStart dashboard, where detail would be noise).
   out(`  Full detail: claude-mem-lite get D#<id>`);
@@ -1212,6 +1214,9 @@ async function cmdStats(db, args) {
   }
 
   out(`[mem] Stats${project ? ` (${project})` : ''}:`);
+  // Env-aware data dir (CLAUDE_MEM_DIR || ~/.claude-mem-lite) — stated so any
+  // raw-db fallback can't guess a co-located-with-the-CLI path (D#92 chain).
+  out(`Data dir: ${DB_DIR}`);
   out(`Total: ${obsTotal.c.toLocaleString()} observations | ${sessTotal.c} sessions | ${promptTotal.c} prompts`);
   out(`Last ${days}d: ${obsRecent.c} observations | ${sessRecent.c} sessions`);
   out('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.50.0",
+  "version": "3.51.0",
   "description": "Persistent long-term memory for Claude Code via MCP — captures coding decisions, bugfixes, and context across sessions. Hybrid FTS5 + TF-IDF search with episode batching. Single SQLite DB, no external services. A lighter, lower-cost alternative to claude-mem (episode batching + a smaller model; cost savings are an internal estimate, not a measured benchmark).",
   "type": "module",
   "packageManager": "npm@10.9.2",

package/server.mjs

@@ -54,6 +54,7 @@ import {
   resolveDeferredIds, closeDeferredItems,
   getDeferredByIds, formatDeferredDetail,
   searchDeferredWork, formatDeferredSearchTrailer,
+  formatDeferListRow, countStaleOpen, formatDeferStaleHint,
 } from './lib/deferred-work.mjs';
 import { _resetVocabCache } from './tfidf.mjs';
 import { createRequire } from 'module';
@@ -846,9 +847,10 @@ server.registerTool(
     }
     const lines = [`Open deferred items (project "${project}"):`];
     for (const r of list) {
-      const pTag = r.priority === 3 ? '🔴' : r.priority === 1 ? '⚪' : '🟡';
-      lines.push(`${r.ordinal}. ${pTag} [P${r.priority}] ${r.title} (D#${r.id})`);
+      lines.push(formatDeferListRow(r));
     }
+    const staleHint = formatDeferStaleHint(countStaleOpen(db, project));
+    if (staleHint) lines.push(staleHint);
     // Affordance for the detail field — list stays title-only by design.
     lines.push(`Full detail: mem_get ids=["D#<id>"]`);
     return { content: [{ type: 'text', text: lines.join('\n') }] };
@@ -907,6 +909,8 @@ server.registerTool(
     const lines = [
       `Memory Statistics${args.project ? ` (project: ${args.project})` : ''}:`,
       '',
+      // Env-aware data dir — parity with CLI cmdStats (D#92 wrong-path chain).
+      `Data dir: ${DB_DIR}`,
       `Total: ${obsTotal.c} observations | ${sessTotal.c} sessions | ${promptTotal.c} prompts`,
       `Last ${days}d: ${obsRecent.c} observations | ${sessRecent.c} sessions`,
       '',