claude-mem-lite 3.76.0 → 3.76.1

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem-lite",
-      "version": "3.76.0",
+      "version": "3.76.1",
       "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.76.0",
+  "version": "3.76.1",
   "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/lib/maintain-core.mjs

@@ -397,6 +397,20 @@ export function boostAccessed(db, { projectFilter, baseParams, opCap = OP_CAP })
 // background machinery must not quietly dispose of one.
 const NO_LESSON_SQL = "(lesson_learned IS NULL OR lesson_learned = '' OR lesson_learned = 'none')";
 
+// The floor demotePinned writes, and therefore also the bound that decides whether a row
+// still HAS anything to demote. One home: v3.76.0 shipped with the floor here and the
+// forecast in maintenanceStats still hard-coded `importance > 1`, so a lesson row already
+// at 2 was counted as pinned forever while every execute reported "Demoted 0" — the exact
+// scan-forecast-vs-execute drift the decayAndMarkIdle comment below exists to prevent.
+const PINNED_FLOOR_SQL = `(CASE WHEN ${NO_LESSON_SQL} THEN 1 ELSE 2 END)`;
+// Shared by the op and its forecast. Callers add their own compressed_into/project filter.
+// Module-private on purpose: nothing outside this file consumes it, and exporting by habit
+// is how the knip baseline drifts (cf. the v3.70.0 DEFAULT_MARKETPLACE trio).
+const PINNED_PREDICATE_SQL = `
+  COALESCE(injection_count, 0) >= ${PINNED_INJ_THRESHOLD}
+  AND COALESCE(cited_count, 0) = 0
+  AND COALESCE(importance, 1) > ${PINNED_FLOOR_SQL}`;
+
 /**
  * Repair the citation-decay blind spot: heavy-injection + zero-citation rows that
  * decay protects (injection_count>0) stay pinned at max importance forever. Floor
@@ -421,15 +435,12 @@ const NO_LESSON_SQL = "(lesson_learned IS NULL OR lesson_learned = '' OR lesson_
  * report phantom demotions on every run forever.
  */
 export function demotePinned(db, { projectFilter, baseParams, opCap = OP_CAP }) {
-  const floor = `(CASE WHEN ${NO_LESSON_SQL} THEN 1 ELSE 2 END)`;
   return db.prepare(`
-    UPDATE observations SET importance = ${floor}
+    UPDATE observations SET importance = ${PINNED_FLOOR_SQL}
     WHERE id IN (
       SELECT id FROM observations
       WHERE COALESCE(compressed_into, 0) = 0
-        AND COALESCE(injection_count, 0) >= ${PINNED_INJ_THRESHOLD}
-        AND COALESCE(cited_count, 0) = 0
-        AND COALESCE(importance, 1) > ${floor}
+        AND ${PINNED_PREDICATE_SQL}
         ${projectFilter} LIMIT ${opCap}
     )
   `).run(...baseParams).changes;
@@ -603,9 +614,7 @@ export function maintenanceStats(db, { projectFilter, baseParams, staleAge }) {
                THEN 1 ELSE 0 END), 0) as broken,
       COALESCE(SUM(CASE WHEN COALESCE(access_count, 0) > 3 AND COALESCE(importance, 1) < 3
                THEN 1 ELSE 0 END), 0) as boostable,
-      COALESCE(SUM(CASE WHEN COALESCE(injection_count, 0) >= ${PINNED_INJ_THRESHOLD}
-                    AND COALESCE(cited_count, 0) = 0 AND COALESCE(importance, 1) > 1
-               THEN 1 ELSE 0 END), 0) as pinned
+      COALESCE(SUM(CASE WHEN ${PINNED_PREDICATE_SQL} THEN 1 ELSE 0 END), 0) as pinned
     FROM observations
     WHERE COALESCE(compressed_into, 0) = 0 ${projectFilter}
   `).get(staleAge, ...baseParams);

package/mem-cli.mjs

@@ -2012,7 +2012,7 @@ function cmdMaintain(db, args) {
     out(`  Stale (>30d, imp=1, no access, never injected): ${stats.stale}`);
     out(`  Broken (no title/narrative): ${stats.broken}`);
     out(`  Boostable (accessed>3, imp<3): ${stats.boostable}`);
-    out(`  Pinned-but-uncited (inj>=${PINNED_INJ_THRESHOLD}, cited=0, imp>1): ${stats.pinned} — cleared by the default maintain set since v3.76.0 (opt out: CLAUDE_MEM_SKIP_DEMOTE_PINNED=1)`);
+    out(`  Pinned-but-uncited (inj>=${PINNED_INJ_THRESHOLD}, cited=0, above floor): ${stats.pinned} — floored by the default maintain set since v3.76.0, no lesson → 1, lesson → 2 (opt out: CLAUDE_MEM_SKIP_DEMOTE_PINNED=1)`);
     out(formatPendingPurgeLine(stats.pendingPurge));
     if (duplicates.length > 0) {
       const autoMergeable = duplicates.filter(d => parseFloat(d.similarity) >= AUTO_MERGE_THRESHOLD);

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.76.0",
+  "version": "3.76.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "claude-mem-lite",
-      "version": "3.76.0",
+      "version": "3.76.1",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.26.0",
         "better-sqlite3": "^12.6.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "3.76.0",
+  "version": "3.76.1",
   "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

@@ -19,7 +19,7 @@ import {
   recoverOrphanedChildren, recoverBuriedLessons, sweepDeferredWorkOrphans,
   purgeStale, purgeStalePreview, findDuplicates, maintenanceStats, rebuildVectors, vacuum,
   hardDeleteCandidateCount,
-  OP_CAP, STALE_AGE_MS, resolveDefaultMaintainOps,
+  OP_CAP, STALE_AGE_MS, resolveDefaultMaintainOps, DEFAULT_MAINTAIN_OPS,
 } from './lib/maintain-core.mjs';
 import { snapshotDb } from './lib/db-backup.mjs';
 import { deleteObservations, previewDeleteRows } from './lib/delete-core.mjs';
@@ -1152,7 +1152,7 @@ server.registerTool(
       // T2-P1-A: reject explicit empty array (vs. omitted → defaults above). Empty-array
       // callers are almost always mistakes; silently running only FTS5 optimize hides the error.
       if (args.operations && args.operations.length === 0) {
-        return { content: [{ type: 'text', text: 'operations array is empty. Pass a non-empty list (e.g. ["cleanup","decay","boost"]) or omit operations to use the default set.' }], isError: true };
+        return { content: [{ type: 'text', text: `operations array is empty. Pass a non-empty list (e.g. ${JSON.stringify(DEFAULT_MAINTAIN_OPS)}) or omit operations to use the default set.` }], isError: true };
       }
       const results = [];
       const staleAge = Date.now() - STALE_AGE_MS;