claude-recall 0.18.7 → 0.18.8

package/.claude/settings.json

@@ -1,48 +1 @@
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": ".*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "python3 /home/ebiarao/repos-wsl/personal-projects/claude-recall/.claude/hooks/search_enforcer.py"
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node /home/ebiarao/repos-wsl/personal-projects/claude-recall/dist/cli/claude-recall-cli.js hook run correction-detector"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node /home/ebiarao/repos-wsl/personal-projects/claude-recall/dist/cli/claude-recall-cli.js hook run memory-stop",
-            "timeout": 30
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node /home/ebiarao/repos-wsl/personal-projects/claude-recall/dist/cli/claude-recall-cli.js hook run precompact-preserve",
-            "timeout": 60
-          }
-        ]
-      }
-    ]
-  },
-  "hooksVersion": "6.0.0"
-}
+{"hooks": {}, "hooksVersion": "1.0.0"}

package/.claude/skills/auto-corrections/SKILL.md

@@ -8,7 +8,7 @@ source: claude-recall
 
 # Corrections
 
-Auto-generated from 17 memories. Last updated: 2026-03-21.
+Auto-generated from 20 memories. Last updated: 2026-03-22.
 
 ## Rules
 
@@ -22,8 +22,11 @@ Auto-generated from 17 memories. Last updated: 2026-03-21.
 - CORRECTION: Memory with complex metadata
 - CORRECTION: Memory with complex metadata
 - CORRECTION: Memory with complex metadata
+- CORRECTION: Memory with complex metadata
+- CORRECTION: License copyright should include user's name instead of 'Claude Recall Contributors'
 - CORRECTION: Replace expired access token with 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
 - CORRECTION: use spaces not tabs for indentation
+- CORRECTION: License copyright should list your name instead of 'Claude Recall Contributors'
 - CORRECTION: cited (loaded 5+ times): 19
 - CORRECTION: cited (loaded 5+ times): 19
 - CORRECTION: cited (loaded 5+ times): 19

package/.claude/skills/auto-corrections/manifest.json

@@ -1,12 +1,13 @@
 {
   "topicId": "corrections",
-  "sourceHash": "2c220ace8666e38374662c19a60f76118e125327cc273019414c6e8383e5e120",
-  "memoryCount": 17,
-  "generatedAt": "2026-03-21T15:18:51.279Z",
+  "sourceHash": "be94895a3ad6a5999508be2c149a1a2742178fff9f9adc97b5da6185c9a30398",
+  "memoryCount": 20,
+  "generatedAt": "2026-03-22T15:58:29.733Z",
   "memoryKeys": [
+    "memory_1774195109722_gij039r4m",
+    "memory_1774191618092_vuxyvq3mw",
     "memory_1774106331272_kg5w7ztfj",
     "memory_1774104588311_65kg08e05",
-    "memory_1774020789453_x9xkjhbug",
     "memory_1773140547102_2wmy0cfga",
     "memory_1773065886725_rscm7v2qx",
     "memory_1773063478046_x0ryr9bk4",
@@ -14,8 +15,10 @@
     "memory_1772641994141_ddvzwdkd9",
     "memory_1772641570519_wmnb2b08w",
     "memory_1772641026962_tqm8ow04r",
+    "hook_correction_1774180798682_9b5a2hadq",
     "hook_correction_1772101108419_le80cln1w",
     "hook_correction_1771112125882_99ihypf8x",
+    "hook_correction_1774180805192_4ft4zhfsa",
     "hook_correction_1772638229134_otn9za2il",
     "hook_correction_1772636083381_th3eluwzv",
     "hook_correction_1772635851763_y91ugnjgy",

package/.claude/skills/auto-failure-lessons/SKILL.md

@@ -8,14 +8,12 @@ source: claude-recall
 
 # Failure Lessons
 
-Auto-generated from 26 memories. Last updated: 2026-03-21.
+Auto-generated from 24 memories. Last updated: 2026-03-22.
 
 ## Rules
 
-- Check command syntax, file paths, and prerequisites before running
 - SQLite query syntax error: LIKE clause requires single quotes around string literal, not double quotes
 - Avoid: Command failed: claude-recall outcomes 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
-- Avoid: Command failed: npx jest tests/unit/outcome-storage.test.ts tests/unit/promotion-engine.test.ts tests/unit/memory... → Instead: Check command syntax, file paths, and prerequisites before running
 - Avoid: Command failed: npm whoami 2>&1 && npm config get registry 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
 - npm install -g claude-recall@0.15.36 failed with notarget error
 - claude-recall@0.15.36 does not exist on npm registry (ETARGET error)

package/.claude/skills/auto-failure-lessons/manifest.json

@@ -1,13 +1,11 @@
 {
   "topicId": "failure-lessons",
-  "sourceHash": "577fce05d7ff95d6661cf78c93b84ce7a8ff54d22964456ca73c045bac9c0986",
-  "memoryCount": 26,
-  "generatedAt": "2026-03-21T15:18:51.248Z",
+  "sourceHash": "00deb7a6c6d99c26e0d29a6a707b4c303dcb19731d27a8ce41db09fd2ff3eb55",
+  "memoryCount": 24,
+  "generatedAt": "2026-03-22T15:00:18.049Z",
   "memoryKeys": [
-    "promoted_1774019382782_acm9j0h8u",
     "hook_failure_1772637584921_0tj4rrxnt",
     "hook_failure_non-zero-exit_1774020949485_6ubuoswae",
-    "hook_failure_non-zero-exit_1773999564001_82kcdp0ag",
     "hook_failure_non-zero-exit_1773409269877_ful451241",
     "hook_failure_1773410916808_5k1r6zo4u",
     "hook_failure_1773410916789_xtrb8j9nw",

package/.claude/skills/auto-preferences/SKILL.md

@@ -8,10 +8,19 @@ source: claude-recall
 
 # Preferences
 
-Auto-generated from 16 memories. Last updated: 2026-03-21.
+Auto-generated from 21 memories. Last updated: 2026-03-22.
 
 ## Rules
 
+- Test preference 1774195109742-2
+- Test preference 1774195109742-1
+- Test preference 1774195109742-0
+- Test memory content
+- Test preference 1774191618111-2
+- Test preference 1774191618111-1
+- Test preference 1774191618111-0
+- Test memory content
+- a normal preference
 - Session test preference 1774106331339
 - Test preference 1774106331283-2
 - Test preference 1774106331283-1
@@ -23,11 +32,7 @@ Auto-generated from 16 memories. Last updated: 2026-03-21.
 - Test preference 1774104588325-0
 - Test memory content
 - Session test preference 1774020789925
-- Test preference 1774020789520-2
-- Test preference 1774020789520-1
-- Test preference 1774020789520-0
-- Test memory content
-- Session test preference 1773999187736
+- Upgrade all projects whenever a new version is pushed
 
 ---
 *Auto-generated by Claude Recall. Regenerate: `npx claude-recall skills generate`*

package/.claude/skills/auto-preferences/manifest.json

@@ -1,9 +1,18 @@
 {
   "topicId": "preferences",
-  "sourceHash": "7123394f8e4ec18013e3a3c3d5f2a4761f1a0c14c20401f566541901de6f797c",
-  "memoryCount": 16,
-  "generatedAt": "2026-03-21T15:18:51.351Z",
+  "sourceHash": "29117b36ff390c0168d551c7f821d92567c91e252995d3786e0f0fd7462fc548",
+  "memoryCount": 21,
+  "generatedAt": "2026-03-22T15:58:29.796Z",
   "memoryKeys": [
+    "memory_1774195109780_8ffmflge1",
+    "memory_1774195109763_v6olh83ct",
+    "memory_1774195109743_i79j9a9rl",
+    "memory_1774195109624_nnh3wrwca",
+    "memory_1774191618164_wefq7s9x6",
+    "memory_1774191618139_k77izvxnq",
+    "memory_1774191618112_hzi64751y",
+    "memory_1774191617980_pzspevoct",
+    "valid1",
     "memory_1774106331340_cwt88yhle",
     "memory_1774106331311_491hg2a21",
     "memory_1774106331297_0b6bvacd7",
@@ -15,10 +24,6 @@
     "memory_1774104588325_g4o5ksubl",
     "memory_1774104588255_fy0wv845g",
     "memory_1774020789927_g99mrubvu",
-    "memory_1774020789705_xhubujrxv",
-    "memory_1774020789618_m1p55yhtz",
-    "memory_1774020789521_saryqj7kw",
-    "memory_1774020789257_wla5q38wq",
-    "memory_1773999187737_qrdwbas47"
+    "hook_preference_1774106575282_45sk4ep52"
   ]
 }

package/dist/hooks/bash-failure-watcher.js

@@ -123,7 +123,7 @@ async function handleBashFailureWatcher(input) {
         }
     }
     catch (err) {
-        (0, shared_1.hookLog)(HOOK_NAME, `Error: ${err}`);
+        (0, shared_1.hookLog)(HOOK_NAME, `Error: ${(0, shared_1.safeErrorMessage)(err)}`);
         // Never throw — hooks must not block Claude
     }
 }
@@ -166,7 +166,7 @@ async function handleFailure(command, exitCode, output, sessionId) {
         });
     }
     catch (err) {
-        (0, shared_1.hookLog)(HOOK_NAME, `Outcome event error: ${err}`);
+        (0, shared_1.hookLog)(HOOK_NAME, `Outcome event error: ${(0, shared_1.safeErrorMessage)(err)}`);
     }
     (0, shared_1.hookLog)(HOOK_NAME, `Stored failure: ${truncate(command, 60)} (exit ${exitCode})`);
     // Track pending failure for fix pairing
@@ -215,14 +215,14 @@ async function handleSuccess(command, sessionId) {
                     });
                 }
                 catch (err) {
-                    (0, shared_1.hookLog)(HOOK_NAME, `Positive outcome event error: ${err}`);
+                    (0, shared_1.hookLog)(HOOK_NAME, `Positive outcome event error: ${(0, shared_1.safeErrorMessage)(err)}`);
                 }
                 (0, shared_1.hookLog)(HOOK_NAME, `Paired fix: "${truncate(command, 60)}" → ${pf.memoryKey}`);
                 matched = true;
                 // Don't add to remaining — consumed
             }
             catch (err) {
-                (0, shared_1.hookLog)(HOOK_NAME, `Fix pairing error: ${err}`);
+                (0, shared_1.hookLog)(HOOK_NAME, `Fix pairing error: ${(0, shared_1.safeErrorMessage)(err)}`);
                 remaining.push(pf);
             }
         }

package/dist/hooks/correction-detector.js

@@ -40,7 +40,7 @@ async function handleCorrectionDetector(input) {
         }
     }
     catch (err) {
-        (0, shared_1.hookLog)('correction-detector', `Reask signal detection error: ${err}`);
+        (0, shared_1.hookLog)('correction-detector', `Reask signal detection error: ${(0, shared_1.safeErrorMessage)(err)}`);
     }
     const result = await (0, shared_1.classifyContent)(prompt);
     if (!result)

package/dist/hooks/memory-stop-hook.js

@@ -127,7 +127,18 @@ async function handleMemoryStop(input) {
         }
     }
     catch (err) {
-        (0, shared_1.hookLog)('memory-stop', `Promotion error: ${err}`);
+        (0, shared_1.hookLog)('memory-stop', `Promotion error: ${(0, shared_1.safeErrorMessage)(err)}`);
+    }
+    // Prune old outcome data to prevent unbounded table growth
+    try {
+        const pruned = outcomeStorage.pruneOldData();
+        const total = pruned.episodes + pruned.events + pruned.lessons + pruned.stats;
+        if (total > 0) {
+            (0, shared_1.hookLog)('memory-stop', `Pruned: ${pruned.episodes} episodes, ${pruned.events} events, ${pruned.lessons} lessons, ${pruned.stats} orphaned stats`);
+        }
+    }
+    catch (err) {
+        (0, shared_1.hookLog)('memory-stop', `Prune error: ${(0, shared_1.safeErrorMessage)(err)}`);
     }
 }
 /**
@@ -331,7 +342,7 @@ function generateCandidateLessons(failures, episodeId, projectId) {
         }
     }
     catch (err) {
-        (0, shared_1.hookLog)('memory-stop', `Candidate lesson generation error: ${err}`);
+        (0, shared_1.hookLog)('memory-stop', `Candidate lesson generation error: ${(0, shared_1.safeErrorMessage)(err)}`);
     }
 }
 function extractTagsFromContext(context) {

package/dist/hooks/shared.js

@@ -41,6 +41,7 @@ exports.jaccardSimilarity = jaccardSimilarity;
 exports.isDuplicate = isDuplicate;
 exports.storeMemory = storeMemory;
 exports.searchExisting = searchExisting;
+exports.safeErrorMessage = safeErrorMessage;
 exports.hookLog = hookLog;
 exports.readTranscriptTail = readTranscriptTail;
 exports.isUserEntry = isUserEntry;
@@ -193,6 +194,16 @@ function searchExisting(query) {
     const memoryService = memory_1.MemoryService.getInstance();
     return memoryService.search(query);
 }
+/**
+ * Extract a safe error message without exposing stack traces or internal paths.
+ */
+function safeErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    return 'unknown error';
+}
 /**
  * Append a log line to ~/.claude-recall/hook-logs/{hookName}.log
  */

package/dist/mcp/tools/memory-tools.js

@@ -297,8 +297,23 @@ class MemoryTools {
             if (lowCompliance.length > 0) {
                 sections.push('## Rule Health\nThese rules are loaded frequently but never cited — consider rewording or removing:\n' +
                     lowCompliance.map(r => {
-                        const val = typeof r.value === 'string' ? (JSON.parse(r.value)?.content || r.value) : r.value;
-                        return `- "${String(val).substring(0, 80)}" (loaded ${r.load_count}x, cited 0x)`;
+                        let val;
+                        if (typeof r.value === 'string') {
+                            try {
+                                const parsed = JSON.parse(r.value);
+                                val = typeof parsed === 'string' ? parsed : (parsed?.content || parsed?.value || r.value);
+                            }
+                            catch {
+                                val = r.value;
+                            }
+                        }
+                        else if (typeof r.value === 'object' && r.value !== null) {
+                            val = r.value.content || r.value.value || JSON.stringify(r.value);
+                        }
+                        else {
+                            val = String(r.value ?? '');
+                        }
+                        return `- "${val.substring(0, 80)}" (loaded ${r.load_count}x, cited 0x)`;
                     }).join('\n'));
             }
             const totalRules = rules.preferences.length + rules.corrections.length +

package/dist/services/outcome-storage.js

@@ -193,6 +193,22 @@ class OutcomeStorage {
         times_unhelpful = times_unhelpful + 1
     `).run(key);
     }
+    /**
+     * Prune old data from outcome tables to prevent unbounded growth.
+     * - Episodes older than 90 days
+     * - Outcome events older than 90 days
+     * - Rejected/archived candidate lessons older than 14 days
+     * - Orphaned memory_stats entries (key no longer in memories table)
+     */
+    pruneOldData() {
+        const cutoff90 = new Date(Date.now() - 90 * 24 * 60 * 60 * 1000).toISOString();
+        const cutoff14 = new Date(Date.now() - 14 * 24 * 60 * 60 * 1000).toISOString();
+        const episodes = this.db.prepare('DELETE FROM episodes WHERE created_at < ?').run(cutoff90).changes;
+        const events = this.db.prepare('DELETE FROM outcome_events WHERE created_at < ?').run(cutoff90).changes;
+        const lessons = this.db.prepare("DELETE FROM candidate_lessons WHERE status IN ('rejected', 'archived') AND updated_at < ?").run(cutoff14).changes;
+        const stats = this.db.prepare('DELETE FROM memory_stats WHERE memory_key NOT IN (SELECT key FROM memories)').run().changes;
+        return { episodes, events, lessons, stats };
+    }
 }
 exports.OutcomeStorage = OutcomeStorage;
 // --- Helpers ---

package/dist/services/promotion-engine.js

@@ -34,13 +34,18 @@ class PromotionEngine {
         let promoted = 0;
         let archived = 0;
         for (const candidate of candidates) {
-            if (this.shouldPromote(candidate)) {
-                this.promote(candidate.id);
-                promoted++;
+            try {
+                if (this.shouldPromote(candidate)) {
+                    this.promote(candidate.id);
+                    promoted++;
+                }
+                else if (this.shouldReject(candidate)) {
+                    outcomeStorage.updateLessonStatus(candidate.id, 'rejected');
+                    archived++;
+                }
             }
-            else if (this.shouldReject(candidate)) {
-                outcomeStorage.updateLessonStatus(candidate.id, 'rejected');
-                archived++;
+            catch (err) {
+                console.error(`PromotionEngine: failed to process candidate ${candidate.id}`);
             }
         }
         // Check for demotion of existing memories
@@ -108,7 +113,13 @@ class PromotionEngine {
         // Not retrieved in 90 days with low strength
         if (stats.last_retrieved_at) {
             const daysSinceRetrieved = (Date.now() - new Date(stats.last_retrieved_at).getTime()) / (1000 * 60 * 60 * 24);
-            const strength = retrieval_1.MemoryRetrieval.computeStrength(memory);
+            let strength = 0;
+            try {
+                strength = retrieval_1.MemoryRetrieval.computeStrength(memory);
+            }
+            catch {
+                strength = 0;
+            }
             if (daysSinceRetrieved > 90 && strength < 0.2) {
                 return true;
             }
@@ -159,8 +170,8 @@ class PromotionEngine {
                 }
             }
         }
-        catch {
-            // Non-critical
+        catch (err) {
+            console.error('PromotionEngine: demotion sweep failed');
         }
         return archived;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-recall",
-  "version": "0.18.7",
+  "version": "0.18.8",
   "description": "Persistent memory for Claude Code with native Skills integration, automatic capture, failure learning, and project scoping via MCP server",
   "main": "dist/index.js",
   "bin": {