claude-recall 0.18.1 → 0.18.2

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

@@ -8,7 +8,7 @@ source: claude-recall
 
 # Corrections
 
-Auto-generated from 22 memories. Last updated: 2026-03-20.
+Auto-generated from 23 memories. Last updated: 2026-03-20.
 
 ## Rules
 
@@ -27,6 +27,7 @@ Auto-generated from 22 memories. Last updated: 2026-03-20.
 - CORRECTION: Memory with complex metadata
 - CORRECTION: Memory with complex metadata
 - CORRECTION: Memory with complex metadata
+- CORRECTION: Memory with complex metadata
 - CORRECTION: Replace expired access token with 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
 - CORRECTION: use spaces not tabs for indentation
 - CORRECTION: cited (loaded 5+ times): 19

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

@@ -1,9 +1,10 @@
 {
   "topicId": "corrections",
-  "sourceHash": "71d234bd5cea462bcfc192c4b421fc4d28d920f188c8393f0b3621e86092febe",
-  "memoryCount": 22,
-  "generatedAt": "2026-03-20T09:33:07.652Z",
+  "sourceHash": "2508acf74409f4f19e47ba4a5c159b28afa9db68dc70fceb90fc1cc90a806538",
+  "memoryCount": 23,
+  "generatedAt": "2026-03-20T15:33:09.502Z",
   "memoryKeys": [
+    "memory_1774020789453_x9xkjhbug",
     "memory_1773999187635_v9sxfphej",
     "memory_1773740608781_ae2bn7zos",
     "memory_1773659723317_o738xfbyw",

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

@@ -8,11 +8,13 @@ source: claude-recall
 
 # Failure Lessons
 
-Auto-generated from 25 memories. Last updated: 2026-03-20.
+Auto-generated from 27 memories. Last updated: 2026-03-20.
 
 ## 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: 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: npx jest tests/unit/bash-failure-watcher.test.ts 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
 - Avoid: Command failed: npx jest tests/unit/memory-sync-hook.test.ts 2>&1 → 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

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

@@ -1,10 +1,12 @@
 {
   "topicId": "failure-lessons",
-  "sourceHash": "81c103e377f0523953c7512cbd3e06f5773ac5d57ddb8ec52e23b1effea1d1fe",
-  "memoryCount": 25,
-  "generatedAt": "2026-03-20T09:33:07.603Z",
+  "sourceHash": "22208b1347904abc47e0ee6878777d047cd32a0593385ead5ca666cbc2960fe6",
+  "memoryCount": 27,
+  "generatedAt": "2026-03-20T15:33:09.349Z",
   "memoryKeys": [
+    "promoted_1774019382782_acm9j0h8u",
     "hook_failure_1772637584921_0tj4rrxnt",
+    "hook_failure_non-zero-exit_1773999564001_82kcdp0ag",
     "hook_failure_non-zero-exit_1773784543398_siidzp55g",
     "hook_failure_non-zero-exit_1773669669860_9mcdbx51y",
     "hook_failure_non-zero-exit_1773409269877_ful451241",

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

@@ -8,10 +8,15 @@ source: claude-recall
 
 # Preferences
 
-Auto-generated from 98 memories. Last updated: 2026-03-20.
+Auto-generated from 103 memories. Last updated: 2026-03-20.
 
 ## Rules
 
+- Session test preference 1774020789925
+- Test preference 1774020789520-2
+- Test preference 1774020789520-1
+- Test preference 1774020789520-0
+- Test memory content
 - Session test preference 1773999187736
 - Test preference 1773999187658-2
 - Test preference 1773999187658-1

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

@@ -1,9 +1,14 @@
 {
   "topicId": "preferences",
-  "sourceHash": "e48e55f7de632696ce32c04f23c2e470a590547bb8541501214650efe670496e",
-  "memoryCount": 98,
-  "generatedAt": "2026-03-20T09:33:07.756Z",
+  "sourceHash": "e03fbec0a2b07a6eaa355b96d76fedae8a5908955d2d2eb02fd15c60fbc87788",
+  "memoryCount": 103,
+  "generatedAt": "2026-03-20T15:33:09.994Z",
   "memoryKeys": [
+    "memory_1774020789927_g99mrubvu",
+    "memory_1774020789705_xhubujrxv",
+    "memory_1774020789618_m1p55yhtz",
+    "memory_1774020789521_saryqj7kw",
+    "memory_1774020789257_wla5q38wq",
     "memory_1773999187737_qrdwbas47",
     "memory_1773999187696_gymxhasno",
     "memory_1773999187680_p6rxtp38v",

package/README.md

@@ -129,6 +129,8 @@ action → outcome event → episode → candidate lesson → promotion → acti
 claude-recall stats                  # Memory statistics
 claude-recall search "query"         # Search memories
 claude-recall failures               # View failure memories
+claude-recall outcomes               # Outcome-aware learning status
+claude-recall outcomes --section lessons  # Just candidate lessons
 claude-recall export backup.json     # Export memories to JSON
 claude-recall import backup.json     # Import memories from JSON
 claude-recall --version              # Check version
@@ -153,6 +155,9 @@ claude-recall import backup.json         # Import memories from JSON
 claude-recall clear --force              # Clear all memories
 claude-recall failures                   # View failure memories
 claude-recall failures --limit 20        # Limit results
+claude-recall outcomes                   # Outcome-aware learning status
+claude-recall outcomes --section lessons # Just candidate lessons
+claude-recall outcomes --limit 20        # More items per section
 claude-recall monitor                    # Memory search monitoring stats
 
 # ── Skills ───────────────────────────────────────────────────────────

package/dist/cli/claude-recall-cli.js

@@ -261,6 +261,90 @@ class ClaudeRecallCLI {
         });
         this.logger.info('CLI', 'Failures displayed', { count: displayFailures.length });
     }
+    /**
+     * Show outcome-aware learning status: episodes, outcome events, candidate lessons, memory stats
+     */
+    showOutcomes(options) {
+        const limit = options.limit || 10;
+        const section = options.section;
+        const db = this.memoryService.getDatabase();
+        // Check if outcome tables exist
+        const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name IN ('episodes','outcome_events','candidate_lessons','memory_stats')").all();
+        const tableNames = new Set(tables.map((t) => t.name));
+        if (tableNames.size < 4) {
+            console.log('\n⚠️  Outcome tables not found. Upgrade to v0.18.0+ and restart the MCP server.\n');
+            return;
+        }
+        console.log('\n📊 Outcome-Aware Learning Status\n');
+        // Summary counts
+        const episodeCount = db.prepare('SELECT COUNT(*) as c FROM episodes').get().c;
+        const eventCount = db.prepare('SELECT COUNT(*) as c FROM outcome_events').get().c;
+        const candidateCount = db.prepare('SELECT COUNT(*) as c FROM candidate_lessons').get().c;
+        const promotedCount = db.prepare("SELECT COUNT(*) as c FROM candidate_lessons WHERE status = 'promoted'").get().c;
+        const statsCount = db.prepare('SELECT COUNT(*) as c FROM memory_stats').get().c;
+        console.log(`  Episodes:          ${episodeCount}`);
+        console.log(`  Outcome events:    ${eventCount}`);
+        console.log(`  Candidate lessons: ${candidateCount} (${promotedCount} promoted)`);
+        console.log(`  Tracked memories:  ${statsCount}`);
+        console.log('');
+        // Episodes
+        if (!section || section === 'episodes') {
+            const episodes = db.prepare('SELECT id, outcome_type, severity, outcome_summary, source, created_at FROM episodes ORDER BY created_at DESC LIMIT ?').all(limit);
+            if (episodes.length > 0) {
+                console.log(`── Recent Episodes (${episodes.length}) ──\n`);
+                for (const ep of episodes) {
+                    const icon = ep.outcome_type === 'failure' ? '❌' : ep.outcome_type === 'success' ? '✅' : '⚪';
+                    const time = new Date(ep.created_at).toLocaleString();
+                    console.log(`  ${icon} [${ep.outcome_type || 'unclear'}] ${ep.outcome_summary || 'No summary'}`);
+                    console.log(`     severity: ${ep.severity || '-'}  source: ${ep.source || '-'}  ${time}`);
+                }
+                console.log('');
+            }
+        }
+        // Outcome events
+        if (!section || section === 'events') {
+            const events = db.prepare('SELECT event_type, actor, exit_code, substr(next_state_summary, 1, 100) as summary, created_at FROM outcome_events ORDER BY created_at DESC LIMIT ?').all(limit);
+            if (events.length > 0) {
+                console.log(`── Recent Outcome Events (${events.length}) ──\n`);
+                for (const ev of events) {
+                    const exitStr = ev.exit_code !== null ? ` (exit ${ev.exit_code})` : '';
+                    const time = new Date(ev.created_at).toLocaleString();
+                    console.log(`  [${ev.event_type}] ${ev.actor}${exitStr}: ${ev.summary}`);
+                    console.log(`     ${time}`);
+                }
+                console.log('');
+            }
+        }
+        // Candidate lessons
+        if (!section || section === 'lessons') {
+            const lessons = db.prepare('SELECT status, evidence_count, confidence, lesson_kind, substr(lesson_text, 1, 100) as text, created_at FROM candidate_lessons ORDER BY created_at DESC LIMIT ?').all(limit);
+            if (lessons.length > 0) {
+                console.log(`── Candidate Lessons (${lessons.length}) ──\n`);
+                for (const l of lessons) {
+                    const icon = l.status === 'promoted' ? '⬆️' : l.status === 'rejected' ? '⬇️' : '⏳';
+                    console.log(`  ${icon} [${l.status}] (${l.evidence_count}x, ${(l.confidence * 100).toFixed(0)}%) ${l.text}`);
+                    console.log(`     kind: ${l.lesson_kind}  ${new Date(l.created_at).toLocaleString()}`);
+                }
+                console.log('');
+            }
+        }
+        // Memory stats (top helpful)
+        if (!section || section === 'stats') {
+            const memStats = db.prepare('SELECT memory_key, times_retrieved, times_helpful, times_unhelpful, last_confirmed_at FROM memory_stats WHERE times_retrieved > 0 ORDER BY times_helpful DESC, times_retrieved DESC LIMIT ?').all(limit);
+            if (memStats.length > 0) {
+                console.log(`── Memory Stats — Top Retrieved (${memStats.length}) ──\n`);
+                for (const s of memStats) {
+                    const ratio = s.times_retrieved > 0 ? ((s.times_helpful / s.times_retrieved) * 100).toFixed(0) : '0';
+                    console.log(`  ${s.memory_key}`);
+                    console.log(`     retrieved: ${s.times_retrieved}  helpful: ${s.times_helpful}  unhelpful: ${s.times_unhelpful}  (${ratio}% helpful)`);
+                }
+                console.log('');
+            }
+        }
+        if (episodeCount === 0 && eventCount === 0) {
+            console.log('No outcome data yet. Use Claude Code normally — outcomes are captured automatically.\n');
+        }
+    }
     /**
      * Search memories by query
      */
@@ -1179,6 +1263,20 @@ async function main() {
         });
         process.exit(0);
     });
+    // Outcomes command (v0.18.0)
+    program
+        .command('outcomes')
+        .description('Show outcome-aware learning status: episodes, events, lessons, stats')
+        .option('--limit <number>', 'Maximum items per section', '10')
+        .option('--section <name>', 'Show only one section: episodes, events, lessons, stats')
+        .action((options) => {
+        const cli = new ClaudeRecallCLI(program.opts());
+        cli.showOutcomes({
+            limit: parseInt(options.limit),
+            section: options.section
+        });
+        process.exit(0);
+    });
     // Export command
     program
         .command('export <output>')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-recall",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "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": {