claude-mem-lite 2.3.3 → 2.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-lite",
-  "version": "2.3.3",
+  "version": "2.5.2",
   "description": "Lightweight persistent memory system for Claude Code",
   "type": "module",
   "engines": {

package/registry-indexer.mjs

@@ -24,7 +24,7 @@ ${content}
 </content>
 
 JSON format:
-{"intent_tags":"comma-separated intent keywords (e.g. test,debug,deploy,review)","domain_tags":"comma-separated tech/language tags (e.g. javascript,react,python)","action_type":"analyze|generate|transform|validate|deploy|configure|review","trigger_patterns":"natural language describing when to use this (e.g. when user needs to write tests; when debugging errors)","capability_summary":"50-100 char description of what it does","input_type":"code|file|directory|url|text","output_type":"report|file|diff|terminal_output|analysis"}`;
+{"intent_tags":"comma-separated intent keywords (e.g. test,debug,deploy,review)","domain_tags":"comma-separated tech/language tags (e.g. javascript,react,python)","action_type":"analyze|generate|transform|validate|deploy|configure|review","trigger_patterns":"natural language describing when to use this (e.g. when user needs to write tests; when debugging errors)","capability_summary":"50-100 char description of what it does","keywords":"specific technical terms, framework names, method names not duplicating intent_tags (e.g. jest,vitest,red-green-refactor,pytest)","tech_stack":"specific frameworks and tools this works with (e.g. jest,vitest,mocha,pytest)","use_cases":"3-5 specific usage scenarios separated by semicolons","input_type":"code|file|directory|url|text","output_type":"report|file|diff|terminal_output|analysis"}`;
 }
 
 // ─── Fallback Extraction ─────────────────────────────────────────────────────
@@ -127,6 +127,9 @@ export async function indexResource(db, resource) {
     capability_summary: metadata.capability_summary || '',
     input_type: metadata.input_type || '',
     output_type: metadata.output_type || '',
+    keywords: metadata.keywords || '',
+    tech_stack: metadata.tech_stack || '',
+    use_cases: metadata.use_cases || '',
     prerequisites: typeof metadata.prerequisites === 'object'
       ? JSON.stringify(metadata.prerequisites) : '{}',
     indexed_at: now,

package/registry.mjs

@@ -106,6 +106,7 @@ const INVOCATIONS_SCHEMA = `
     adopted       INTEGER DEFAULT 0,
     outcome       TEXT CHECK(outcome IN ('success','partial','failure','skipped','ignored') OR outcome IS NULL),
     score         REAL,
+    rejection_reason TEXT CHECK(rejection_reason IN ('alternative','manual','context_switch','session_end','unknown') OR rejection_reason IS NULL),
     created_at    TEXT DEFAULT (datetime('now'))
   );
 
@@ -210,6 +211,14 @@ export function ensureRegistryDb(dbPath) {
     }
   } catch (e) { debugCatch(e, 'ensureRegistryDb-ignored-migration'); }
 
+  // Migrate: add rejection_reason column if missing
+  try {
+    const cols = db.prepare("PRAGMA table_info(invocations)").all();
+    if (!cols.some(c => c.name === 'rejection_reason')) {
+      db.exec("ALTER TABLE invocations ADD COLUMN rejection_reason TEXT");
+    }
+  } catch (e) { debugCatch(e, 'rejection_reason-migration'); }
+
   db.exec(PREINSTALLED_SCHEMA);
 
   return db;
@@ -229,7 +238,8 @@ const UPSERT_SQL = `
   VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))
   ON CONFLICT(type, name) DO UPDATE SET
     status=excluded.status, source=excluded.source, repo_url=excluded.repo_url,
-    repo_stars=excluded.repo_stars, local_path=excluded.local_path, file_hash=excluded.file_hash,
+    repo_stars=CASE WHEN excluded.repo_stars > 0 THEN excluded.repo_stars ELSE repo_stars END,
+    local_path=excluded.local_path, file_hash=excluded.file_hash,
     invocation_name=CASE WHEN excluded.invocation_name != '' THEN excluded.invocation_name ELSE invocation_name END,
     intent_tags=excluded.intent_tags, domain_tags=excluded.domain_tags,
     action_type=excluded.action_type, trigger_patterns=excluded.trigger_patterns,
@@ -369,7 +379,7 @@ export function getSessionInvocations(db, sessionId) {
  * @param {object} update Fields to update
  */
 export function updateInvocation(db, id, update) {
-  const allowed = new Set(['adopted', 'outcome', 'score']);
+  const allowed = new Set(['adopted', 'outcome', 'score', 'rejection_reason']);
   const sets = [];
   const vals = [];
   for (const [key, val] of Object.entries(update)) {

package/schema.mjs

@@ -99,6 +99,10 @@ const MIGRATIONS = [
   'ALTER TABLE observations ADD COLUMN access_count INTEGER DEFAULT 0',
   'ALTER TABLE observations ADD COLUMN compressed_into INTEGER DEFAULT NULL',
   'ALTER TABLE session_summaries ADD COLUMN remaining_items TEXT',
+  'ALTER TABLE observations ADD COLUMN lesson_learned TEXT DEFAULT NULL',
+  'ALTER TABLE observations ADD COLUMN search_aliases TEXT DEFAULT NULL',
+  'ALTER TABLE session_summaries ADD COLUMN lessons TEXT DEFAULT NULL',
+  'ALTER TABLE session_summaries ADD COLUMN key_decisions TEXT DEFAULT NULL',
 ];
 
 /**

package/server-internals.mjs

@@ -1,7 +1,7 @@
 // claude-mem-lite server internal functions
 // Extracted from server.mjs for testability (server.mjs has top-level side effects)
 
-import { debugCatch } from './utils.mjs';
+import { debugCatch, COMPRESSED_AUTO, COMPRESSED_PENDING_PURGE } from './utils.mjs';
 
 // ─── Search Re-ranking Helpers ────────────────────────────────────────────
 
@@ -193,3 +193,70 @@ export function expandQueryByConcepts(db, ftsQuery, project) {
     .slice(0, 3)
     .map(([concept]) => concept);
 }
+
+// ─── Auto-boost ─────────────────────────────────────────────────────────────
+
+/**
+ * Boost importance to 2 for observations that have been accessed multiple times
+ * (access_count >= 2) but still have default importance (1).
+ * Called after incrementing access_count in mem_get.
+ * @param {object} db better-sqlite3 database handle
+ * @param {number[]} ids Array of observation IDs to check
+ */
+export function autoBoostIfNeeded(db, ids) {
+  if (!ids || ids.length === 0) return;
+  const placeholders = ids.map(() => '?').join(',');
+  db.prepare(`
+    UPDATE observations SET importance = 2
+    WHERE id IN (${placeholders})
+      AND COALESCE(importance, 1) = 1
+      AND COALESCE(access_count, 0) >= 2
+  `).run(...ids);
+}
+
+// ─── Idle Cleanup ────────────────────────────────────────────────────────────
+
+/**
+ * Run type-differentiated idle cleanup on stale observations.
+ * Higher-value types (decision, discovery) survive longer than ephemeral types (change).
+ * - Marks low-quality (importance<=1, never accessed) as pending-purge (COMPRESSED_PENDING_PURGE).
+ * - Marks importance=1 accessed observations as auto-compressed (COMPRESSED_AUTO).
+ * @param {object} db better-sqlite3 database handle
+ * @returns {{ marked: number, compressed: number }}
+ */
+export function runIdleCleanup(db) {
+  // SAFETY: type values are hardcoded constants, not user input
+  const staleThresholds = [
+    { types: "'decision','discovery'", days: 90 },
+    { types: "'feature'", days: 60 },
+    { types: "'bugfix','refactor'", days: 30 },
+    { types: "'change'", days: 14 },
+  ];
+
+  let totalMarked = 0;
+  let totalCompressed = 0;
+
+  db.transaction(() => {
+    for (const { types, days } of staleThresholds) {
+      const cutoff = Date.now() - days * 86400000;
+
+      const marked = db.prepare(`
+        UPDATE observations SET compressed_into = ${COMPRESSED_PENDING_PURGE}
+        WHERE importance <= 1 AND COALESCE(access_count, 0) = 0
+          AND type IN (${types})
+          AND created_at_epoch < ? AND COALESCE(compressed_into, 0) = 0
+      `).run(cutoff);
+      totalMarked += marked.changes;
+
+      const compressed = db.prepare(`
+        UPDATE observations SET compressed_into = ${COMPRESSED_AUTO}
+        WHERE COALESCE(compressed_into, 0) = 0 AND importance = 1
+          AND type IN (${types})
+          AND created_at_epoch < ?
+      `).run(cutoff);
+      totalCompressed += compressed.changes;
+    }
+  })();
+
+  return { marked: totalMarked, compressed: totalCompressed };
+}

package/server.mjs

@@ -6,7 +6,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { jaccardSimilarity, truncate, typeIcon, sanitizeFtsQuery, relaxFtsQueryToOr, inferProject, computeMinHash, estimateJaccardFromMinHash, scrubSecrets, fmtDate, isoWeekKey, debugLog, debugCatch, COMPRESSED_AUTO, COMPRESSED_PENDING_PURGE } from './utils.mjs';
 import { ensureDb, DB_PATH, REGISTRY_DB_PATH } from './schema.mjs';
-import { reRankWithContext, markSuperseded, extractPRFTerms, expandQueryByConcepts } from './server-internals.mjs';
+import { reRankWithContext, markSuperseded, extractPRFTerms, expandQueryByConcepts, autoBoostIfNeeded, runIdleCleanup } from './server-internals.mjs';
 import { memSearchSchema, memTimelineSchema, memGetSchema, memDeleteSchema, memSaveSchema, memStatsSchema, memCompressSchema, memMaintainSchema, memRegistrySchema } from './tool-schemas.mjs';
 import { ensureRegistryDb, upsertResource } from './registry.mjs';
 import { createRequire } from 'module';
@@ -121,15 +121,28 @@ function safeHandler(fn) {
 
 // ─── Tool: mem_search — helper functions ────────────────────────────────────
 
+// Type-differentiated recency decay: decisions persist longer, routine changes fade fast
+const TYPE_DECAY_CASE = `(
+  CASE o.type
+    WHEN 'decision'  THEN 7776000000.0
+    WHEN 'discovery' THEN 5184000000.0
+    WHEN 'feature'   THEN 2592000000.0
+    WHEN 'bugfix'    THEN 1209600000.0
+    WHEN 'refactor'  THEN 1209600000.0
+    WHEN 'change'    THEN  604800000.0
+    ELSE 1209600000.0
+  END
+)`;
+
 // Score expression variants for FTS5 queries (see Scoring Model Constants above)
 const FULL_SCORE = `${OBS_BM25}
-  * (1.0 + EXP(-0.693 * (? - o.created_at_epoch) / ${RECENCY_HALF_LIFE_MS}.0))
+  * (1.0 + EXP(-0.693 * (? - o.created_at_epoch) / ${TYPE_DECAY_CASE}))
   * (CASE WHEN ? IS NOT NULL AND o.project = ? THEN 2.0 ELSE 1.0 END)
   * (0.5 + 0.5 * COALESCE(o.importance, 1))
   * (1.0 + 0.1 * LN(1 + COALESCE(o.access_count, 0)))`;
 
 const SIMPLE_SCORE = `${OBS_BM25}
-  * (1.0 + EXP(-0.693 * (? - o.created_at_epoch) / ${RECENCY_HALF_LIFE_MS}.0))
+  * (1.0 + EXP(-0.693 * (? - o.created_at_epoch) / ${TYPE_DECAY_CASE}))
   * (0.5 + 0.5 * COALESCE(o.importance, 1))`;
 
 /**
@@ -607,6 +620,8 @@ server.registerTool(
       db.prepare(
         `UPDATE observations SET access_count = COALESCE(access_count, 0) + 1 WHERE id IN (${placeholders})`
       ).run(...args.ids);
+      // Auto-boost importance for frequently accessed observations
+      autoBoostIfNeeded(db, args.ids);
       rows = db.prepare(`SELECT * FROM observations WHERE id IN (${placeholders}) ORDER BY created_at_epoch ASC`).all(...args.ids);
       allFields = ['id', 'type', 'title', 'subtitle', 'narrative', 'text', 'facts', 'concepts', 'files_read', 'files_modified', 'project', 'created_at', 'memory_session_id', 'prompt_number', 'importance', 'related_ids', 'access_count'];
       prefix = '#';
@@ -1249,33 +1264,10 @@ const idleTimer = setInterval(() => {
   idleCleanupRan = true;
 
   try {
-    const thirtyDaysAgo = Date.now() - 30 * 86400000;
-
-    db.transaction(() => {
-      // Mark old low-quality observations as pending-purge (importance<=1, never accessed, 30+ days).
-      // Actual deletion only happens when user confirms via mem_maintain execute purge_stale.
-      // NOTE: no project filter — MCP server is global, operates across all projects.
-      const marked = db.prepare(`
-        UPDATE observations SET compressed_into = ${COMPRESSED_PENDING_PURGE}
-        WHERE importance <= 1 AND COALESCE(access_count, 0) = 0
-          AND created_at_epoch < ? AND COALESCE(compressed_into, 0) = 0
-      `).run(thirtyDaysAgo);
-      if (marked.changes > 0) {
-        debugLog('INFO', 'idle-cleanup', `Marked ${marked.changes} stale observations as pending-purge`);
-      }
-
-      // Mark old importance=1 with access_count>0 as compressed (30+ days).
-      // Note: importance=1, access_count=0 rows were already marked pending-purge above,
-      // so this only catches importance=1 rows that HAVE been accessed.
-      const compressed = db.prepare(`
-        UPDATE observations SET compressed_into = ${COMPRESSED_AUTO}
-        WHERE COALESCE(compressed_into, 0) = 0 AND importance = 1
-          AND created_at_epoch < ?
-      `).run(thirtyDaysAgo);
-      if (compressed.changes > 0) {
-        debugLog('INFO', 'idle-cleanup', `Compressed ${compressed.changes} old observations`);
-      }
-    })();
+    // Type-differentiated cleanup: higher-value types survive longer
+    const { marked, compressed } = runIdleCleanup(db);
+    if (marked > 0) debugLog('INFO', 'idle-cleanup', `Marked ${marked} stale observations as pending-purge`);
+    if (compressed > 0) debugLog('INFO', 'idle-cleanup', `Compressed ${compressed} old observations`);
 
     // FTS5 index optimization (outside transaction — WAL-friendly)
     db.exec("INSERT INTO observations_fts(observations_fts) VALUES('optimize')");

package/utils.mjs

@@ -10,6 +10,19 @@ export const COMPRESSED_AUTO = -1;
 /** compressed_into sentinel: pending user-confirmed purge (marked by idle cleanup) */
 export const COMPRESSED_PENDING_PURGE = -2;
 
+// ─── Type-Differentiated Recency Decay ──────────────────────────────────────
+
+/** Recency half-life per observation type (in milliseconds) */
+export const DECAY_HALF_LIFE_BY_TYPE = {
+  decision:  90 * 86400000,  // 90 days — architectural decisions persist
+  discovery: 60 * 86400000,  // 60 days — learned patterns last
+  feature:   30 * 86400000,  // 30 days — feature work is mid-range
+  bugfix:    14 * 86400000,  // 14 days — bugs are usually one-off
+  refactor:  14 * 86400000,  // 14 days — code cleanup
+  change:     7 * 86400000,  //  7 days — routine changes decay fast
+};
+export const DEFAULT_DECAY_HALF_LIFE_MS = 14 * 86400000;
+
 // ─── String Utilities ────────────────────────────────────────────────────────
 
 /**
@@ -255,6 +268,57 @@ const SYNONYM_PAIRS = [
   ['debug', 'troubleshoot'],
   ['error', 'failure'],
   ['migrate', 'migration'],
+  // ─── CJK ↔ EN cross-language synonyms ───
+  // Authentication & Authorization
+  ['认证', 'auth'], ['认证', 'authentication'], ['登录', 'login'], ['登录', 'auth'],
+  ['授权', 'authorization'], ['权限', 'permission'],
+  // Deployment & Operations
+  ['部署', 'deploy'], ['部署', 'deployment'], ['发布', 'release'], ['发布', 'publish'],
+  // Data & Storage
+  ['缓存', 'cache'], ['缓存', 'caching'],
+  ['数据库', 'database'], ['数据库', 'db'],
+  // Testing & Debugging
+  ['测试', 'test'], ['测试', 'testing'],
+  ['调试', 'debug'], ['调试', 'debugging'],
+  ['修复', 'fix'], ['修复', 'bugfix'],
+  // Code Quality
+  ['重构', 'refactor'], ['重构', 'refactoring'],
+  ['配置', 'config'], ['配置', 'configuration'],
+  // API & Networking
+  ['接口', 'api'], ['接口', 'endpoint'],
+  ['路由', 'route'], ['路由', 'routing'],
+  ['中间件', 'middleware'],
+  // UI & Components
+  ['组件', 'component'], ['模板', 'template'],
+  // Database Operations
+  ['迁移', 'migration'], ['迁移', 'migrate'],
+  ['索引', 'index'], ['查询', 'query'], ['查询', 'search'],
+  ['排序', 'sort'], ['分页', 'pagination'],
+  // Validation & Security
+  ['验证', 'validate'], ['验证', 'validation'],
+  ['加密', 'encrypt'], ['加密', 'encryption'],
+  ['会话', 'session'], ['令牌', 'token'],
+  // Patterns & Architecture
+  ['钩子', 'hook'], ['回调', 'callback'],
+  ['异步', 'async'], ['同步', 'sync'],
+  ['并发', 'concurrent'], ['线程', 'thread'],
+  // Performance
+  ['性能', 'performance'], ['性能', 'perf'],
+  ['内存', 'memory'], ['泄漏', 'leak'],
+  ['超时', 'timeout'], ['重试', 'retry'],
+  // Observability
+  ['日志', 'log'], ['日志', 'logging'],
+  ['监控', 'monitor'], ['告警', 'alert'],
+  // Build & Dependencies
+  ['依赖', 'dependency'], ['构建', 'build'], ['构建', 'compile'],
+  ['打包', 'bundle'], ['类型', 'type'], ['类型', 'typescript'],
+  // Errors
+  ['错误', 'error'], ['异常', 'exception'],
+  // Infrastructure
+  ['容器', 'container'], ['容器', 'docker'],
+  ['集群', 'cluster'], ['集群', 'kubernetes'],
+  ['网关', 'gateway'], ['负载', 'load balancing'],
+  ['队列', 'queue'], ['序列化', 'serialize'],
 ];
 // Build bidirectional lookup (case-insensitive)
 for (const [abbr, full] of SYNONYM_PAIRS) {