claude-recall 0.20.14 → 0.20.16

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

@@ -12,10 +12,10 @@ Auto-generated from 5 memories. Last updated: 2026-04-10.
 
 ## Rules
 
-- Session test preference 1775821892450
-- Test preference 1775821892400-2
-- Test preference 1775821892400-1
-- Test preference 1775821892400-0
+- Session test preference 1775841028541
+- Test preference 1775841028479-2
+- Test preference 1775841028479-1
+- Test preference 1775841028479-0
 - Test memory content
 
 ---

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

@@ -1,13 +1,13 @@
 {
   "topicId": "preferences",
-  "sourceHash": "9b2ae714e4bdd82091b4fcc5347c2b1a8a2a10d3be57ca57877e943e380a5457",
+  "sourceHash": "ffe036415b05cb18e9c3e65a38a2e7dedbf02dfd5463c14a03184a9c93c75799",
   "memoryCount": 5,
-  "generatedAt": "2026-04-10T11:51:32.469Z",
+  "generatedAt": "2026-04-10T17:10:28.567Z",
   "memoryKeys": [
-    "memory_1775821892451_dzjdxx6ef",
-    "memory_1775821892427_462vxb2gq",
-    "memory_1775821892416_8taocju9a",
-    "memory_1775821892402_3x8ksma5p",
-    "memory_1775821892372_4khhv0wc2"
+    "memory_1775841028543_yc9163qfd",
+    "memory_1775841028515_8bjn9exsc",
+    "memory_1775841028500_gch5kvqxl",
+    "memory_1775841028480_n2evtiegj",
+    "memory_1775841028436_w06waet05"
   ]
 }

package/README.md

@@ -142,17 +142,76 @@ action → outcome event → episode → candidate lesson → promotion → acti
 
 ## CLI Reference
 
-### Common Commands
+### Health Check (run these first)
 
 ```bash
-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
+claude-recall --version              # Confirm installed version
+claude-recall status                 # Installation health: hooks, MCP, DB path, project ID
+claude-recall stats                  # What's in the DB for this project
+claude-recall stats --global         # What's in the DB across ALL projects
+```
+
+### Inspecting Memories
+
+```bash
+claude-recall search "query"             # Search current project's memories
+claude-recall search "query" --global    # Search across all projects
+claude-recall search "query" --json      # Machine-readable output
+claude-recall search "query" --project <id>  # Search a specific project
+
+claude-recall failures                   # View failure memories (current project)
+claude-recall failures --limit 20        # Show more
+
+claude-recall outcomes                   # Outcome-aware learning status
+claude-recall outcomes --section lessons # Just candidate lessons
+claude-recall outcomes --section stats   # Retrieval/helpfulness stats per memory
+claude-recall outcomes --limit 20        # More items per section
+
+claude-recall monitor                    # Memory search monitoring stats
+```
+
+### Managing Memories
+
+```bash
+claude-recall store "content"                # Store a memory (default type: preference)
+claude-recall store "content" -t correction  # Store with specific type
+claude-recall export backup.json             # Export all memories to JSON
+claude-recall import backup.json             # Import memories from JSON
+claude-recall clear --force                  # Delete all memories (irreversible)
+```
+
+### Troubleshooting
+
+```bash
+# "Are my hooks installed?"
+claude-recall status                     # Shows hook registration status
+claude-recall hooks check                # Verify hook files exist and are valid
+
+# "Is the MCP server running?"
+claude-recall mcp status                 # Current project's server status
+claude-recall mcp ps                     # List all running servers
+
+# "Which project does this directory map to?"
+claude-recall project show               # Shows project ID for current directory
+claude-recall project list               # All registered projects
+
+# "Why do I see memories from other projects?"
+claude-recall search "query"             # Scoped to current project (default)
+claude-recall search "query" --global    # Explicitly cross-project
+
+# "How do I check what the DB actually contains?"
+sqlite3 ~/.claude-recall/claude-recall.db "SELECT type, COUNT(*) FROM memories GROUP BY type"
+sqlite3 ~/.claude-recall/claude-recall.db "SELECT type, COUNT(*) FROM memories WHERE project_id = '<id>' GROUP BY type"
+
+# "Hook logs — what did the hooks actually do?"
+tail -20 ~/.claude-recall/hook-logs/tool-outcome-watcher.log
+tail -20 ~/.claude-recall/hook-logs/memory-stop.log
+tail -20 ~/.claude-recall/hook-logs/correction-detector.log
+
+# "Something is broken, start fresh"
+claude-recall repair                     # Clean up old hooks, reinstall skills
+claude-recall setup --install            # Reinstall skills + hooks
+claude-recall mcp cleanup --all          # Stop all stale MCP servers
 ```
 
 <details>
@@ -164,11 +223,18 @@ claude-recall setup                      # Show activation instructions
 claude-recall setup --install            # Install skills + hooks
 claude-recall status                     # Installation and system status
 claude-recall repair                     # Clean up old hooks, install skills
+claude-recall hooks check                # Verify hook files exist and are valid
+claude-recall hooks test-enforcement     # Test if search enforcer hook works
 
 # ── Memory ───────────────────────────────────────────────────────────
-claude-recall stats                      # Memory statistics
-claude-recall search "query"             # Search memories
+claude-recall stats                      # Memory statistics (current project)
+claude-recall stats --global             # Memory statistics (all projects)
+claude-recall search "query"             # Search memories (current project)
+claude-recall search "query" --global    # Search memories (all projects)
+claude-recall search "query" --json      # Output as JSON
+claude-recall search "query" --project <id>  # Search specific project
 claude-recall store "content"            # Store memory directly
+claude-recall store "content" -t <type>  # Store with type (preference, correction, failure, devops, project-knowledge)
 claude-recall export backup.json         # Export memories to JSON
 claude-recall import backup.json         # Import memories from JSON
 claude-recall clear --force              # Clear all memories
@@ -176,6 +242,7 @@ 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 --section stats   # Retrieval/helpfulness stats
 claude-recall outcomes --limit 20        # More items per section
 claude-recall monitor                    # Memory search monitoring stats
 
@@ -199,8 +266,16 @@ claude-recall mcp cleanup --all          # Stop all servers
 claude-recall project show               # Current project info
 claude-recall project list               # All registered projects
 claude-recall project register           # Register current project
+claude-recall project unregister [id]    # Unregister a project
 claude-recall project clean              # Remove stale registry entries
 
+# ── Database Migration ──────────────────────────────────────────────
+claude-recall migrate check              # Check if migration needed
+claude-recall migrate schema             # Show current schema version
+claude-recall migrate export             # Export pre-migration backup
+claude-recall migrate import             # Import from backup
+claude-recall migrate complete           # Run pending migrations
+
 # ── Auto-Capture Hooks (run automatically, registered via setup --install) ──
 claude-recall hook run correction-detector   # UserPromptSubmit hook
 claude-recall hook run memory-stop           # Stop hook

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

@@ -40,6 +40,7 @@ const logging_1 = require("../services/logging");
 const commander_1 = require("commander");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const os = __importStar(require("os"));
 const pattern_service_1 = require("../services/pattern-service");
 const migrate_1 = require("./commands/migrate");
 const server_1 = require("../mcp/server");
@@ -504,11 +505,51 @@ class ClaudeRecallCLI {
      */
     async status() {
         console.log('\n🔍 Claude Recall Status\n');
-        // MCP Server status
-        console.log('MCP Server:');
-        console.log('  Mode: Model Context Protocol (MCP)');
-        console.log('  Status: Ready for integration');
-        console.log('  Command: claude mcp add claude-recall claude-recall mcp start');
+        // Detect integration context
+        const hasPi = fs.existsSync(path.join(os.homedir(), '.pi'));
+        const claudeJsonPath = path.join(os.homedir(), '.claude.json');
+        let hasMcpRegistered = false;
+        if (fs.existsSync(claudeJsonPath)) {
+            try {
+                const claudeJson = JSON.parse(fs.readFileSync(claudeJsonPath, 'utf-8'));
+                const servers = claudeJson.mcpServers || {};
+                hasMcpRegistered = Object.keys(servers).some(k => k.includes('claude-recall') || k.includes('claude_recall'));
+            }
+            catch { /* ignore parse errors */ }
+        }
+        // Show integration status per agent
+        if (hasPi) {
+            console.log('Pi Extension:');
+            try {
+                const { execSync } = require('child_process');
+                const piList = execSync('pi list 2>/dev/null', { encoding: 'utf-8' });
+                if (piList.includes('claude-recall')) {
+                    console.log('  Status: Installed ✅');
+                }
+                else {
+                    console.log('  Status: Not installed');
+                    console.log('  Install: pi install npm:claude-recall');
+                }
+            }
+            catch {
+                console.log('  Status: Pi detected but could not verify installation');
+                console.log('  Install: pi install npm:claude-recall');
+            }
+        }
+        if (hasMcpRegistered) {
+            console.log('Claude Code MCP:');
+            console.log('  Status: Registered ✅');
+        }
+        else if (!hasPi) {
+            console.log('Claude Code MCP:');
+            console.log('  Status: Not registered');
+            console.log('  Command: claude mcp add claude-recall claude-recall mcp start');
+        }
+        else {
+            // Pi is present; show Claude Code MCP as optional
+            console.log('Claude Code MCP:');
+            console.log('  Status: Not registered (optional — Pi extension handles integration)');
+        }
         // Database status
         const configService = config_1.ConfigService.getInstance();
         const dbPath = configService.getDatabasePath();

package/package.json

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