claude-recall 0.23.0 → 0.23.2

package/.claude/hooks/search_enforcer.py

@@ -131,10 +131,15 @@ def main():
     last_search = state.get('lastSearchAt')
 
     # FIRST TOOL CALL GATE: If rules have never been loaded this session,
-    # block on codebase-interacting tools (Read/Glob/Grep/Write/Edit/Bash/Task).
-    # This ensures Claude loads rules before forming opinions from exploration.
+    # only block mutation tools. Read-only exploration (Read/Glob/Grep) passes
+    # freely — reading a file can't bypass preferences or corrections, and
+    # gating it added 1–3 blocked calls of friction per session with no safety
+    # benefit. The guarantee that matters (load_rules before mutations) is
+    # preserved by the ENFORCE_TOOLS check below.
     if not last_search:
-        pass  # Fall through to blocking logic below
+        if tool_name not in ENFORCE_TOOLS:
+            sys.exit(0)
+        # Mutation tool on first call — fall through to blocking logic below.
     else:
         # Rules loaded at least once — only enforce on mutation tools
         if tool_name not in ENFORCE_TOOLS:

package/.claude/settings.json

@@ -41,6 +41,11 @@
             "type": "command",
             "command": "node /home/ebiarao/.nvm/versions/node/v20.19.3/lib/node_modules/claude-recall/dist/cli/claude-recall-cli.js hook run tool-outcome-watcher",
             "timeout": 3
+          },
+          {
+            "type": "command",
+            "command": "node /home/ebiarao/.nvm/versions/node/v20.19.3/lib/node_modules/claude-recall/dist/cli/claude-recall-cli.js hook run rule-injection-resolver",
+            "timeout": 3
           }
         ]
       }
@@ -52,6 +57,11 @@
             "type": "command",
             "command": "node /home/ebiarao/.nvm/versions/node/v20.19.3/lib/node_modules/claude-recall/dist/cli/claude-recall-cli.js hook run tool-failure",
             "timeout": 3
+          },
+          {
+            "type": "command",
+            "command": "node /home/ebiarao/.nvm/versions/node/v20.19.3/lib/node_modules/claude-recall/dist/cli/claude-recall-cli.js hook run rule-injection-resolver",
+            "timeout": 3
           }
         ]
       }
@@ -63,6 +73,11 @@
           {
             "type": "command",
             "command": "python3 /home/ebiarao/repos-wsl/personal-projects/claude-recall/.claude/hooks/search_enforcer.py"
+          },
+          {
+            "type": "command",
+            "command": "node /home/ebiarao/.nvm/versions/node/v20.19.3/lib/node_modules/claude-recall/dist/cli/claude-recall-cli.js hook run rule-injector",
+            "timeout": 5
           }
         ]
       }
@@ -121,5 +136,5 @@
       }
     ]
   },
-  "hooksVersion": "13.0.0"
+  "hooksVersion": "14.0.0"
 }

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

@@ -8,15 +8,15 @@ source: claude-recall
 
 # Preferences
 
-Auto-generated from 5 memories. Last updated: 2026-04-22.
+Auto-generated from 5 memories. Last updated: 2026-04-23.
 
 ## Rules
 
-- integration-fixture session 1776885821647
-- integration-fixture preference 1776885821594-2
-- integration-fixture preference 1776885821594-1
-- integration-fixture preference 1776885821594-0
-- integration-fixture memory 1776885821539
+- integration-fixture session 1776936462139
+- integration-fixture preference 1776936462057-2
+- integration-fixture preference 1776936462057-1
+- integration-fixture preference 1776936462057-0
+- integration-fixture memory 1776936461992
 
 ---
 *Auto-generated by Claude Recall. Regenerate: `npx claude-recall skills generate`*

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

@@ -1,13 +1,13 @@
 {
   "topicId": "preferences",
-  "sourceHash": "886f098b1a582616f10443d10ec5877b85152231a370636321f2f3f8dc37b2dc",
+  "sourceHash": "8f6c2515c073f67ccf01ad1386f3694b666e3f56bb1ccdeeb6aae55dfc04a477",
   "memoryCount": 5,
-  "generatedAt": "2026-04-22T19:23:41.665Z",
+  "generatedAt": "2026-04-23T09:27:42.176Z",
   "memoryKeys": [
-    "memory_1776885821648_8b5enno4p",
-    "memory_1776885821623_73b897xzl",
-    "memory_1776885821611_admiwaa2s",
-    "memory_1776885821596_ii942py46",
-    "memory_1776885821543_yk1wyjqkz"
+    "memory_1776936462141_jljtaadmy",
+    "memory_1776936462104_21zrli1a5",
+    "memory_1776936462081_4cngzrj7y",
+    "memory_1776936462058_u48oswvqh",
+    "memory_1776936461995_g769cz2vk"
   ]
 }

package/README.md

@@ -34,33 +34,22 @@ Your preferences, project structure, workflows, corrections, and coding style ar
 
 ### Install for Claude Code
 
-#### First-time install
-
-Run this **once** on your machine:
+Install the global binary once per machine:
 
 ```bash
 npm install -g claude-recall
 ```
 
-Then run these **in the project directory** where you want claude-recall active:
+Then, in each project directory where you want claude-recall active:
 
 ```bash
 claude-recall setup --install
 claude mcp add claude-recall -- claude-recall mcp start
 ```
 
-Restart Claude Code. **Verify**: ask *"Load my rules"* — Claude should call `mcp__claude-recall__load_rules`.
-
-#### Adding to another project
+Restart Claude Code. Ask *"Load my rules"* to verify — Claude should call `load_rules`.
 
-The global binary is already installed. Just `cd` into the new project and run the per-project commands:
-
-```bash
-claude-recall setup --install
-claude mcp add claude-recall -- claude-recall mcp start
-```
-
-Restart Claude Code in that project.
+> **Hit `EACCES: permission denied`?** Your global npm is owned by root. Either `sudo npm install -g claude-recall` once, or do the permanent fix described in [Upgrading](#upgrading) below.
 
 ### Install for Pi
 
@@ -68,49 +57,44 @@ Restart Claude Code in that project.
 pi install npm:claude-recall
 ```
 
-That's it. The extension registers tools and loads a skill automatically. No further configuration needed.
-
-**Verify:** Start Pi and ask *"Load my rules"* — Pi should call `recall_load_rules`.
+That's it. Ask Pi to *"Load my rules"* to verify.
 
 ### Shared Database
 
-Both agents use the same database (`~/.claude-recall/claude-recall.db`). Memories are scoped per project by working directory. A correction learned in Claude Code is available in Pi and vice versa.
+Both agents use the same database at `~/.claude-recall/claude-recall.db`, scoped per project by working directory. A correction learned in one agent is available in the other.
 
 ### Upgrading
 
-#### If you use Claude Code
-
-Run this **once** to update the global binary:
-
 ```bash
-npm install -g claude-recall
-```
-
-Then run this **in each project directory** where you use claude-recall (the binary upgrade alone isn't enough — new releases sometimes add hook events that need to be registered in each project's `.claude/settings.json`):
-
-```bash
-claude-recall setup --install
+claude-recall upgrade
 ```
 
-Restart Claude Code so the new MCP server starts (or run `claude-recall mcp restart` from the project directory to keep the current session running).
+One command. Checks the registry, refreshes the global binary, clears any running MCP servers (Claude Code respawns them on the next tool call, automatically picking up the new version). **No `claude mcp add` re-run needed** — existing registrations point at the `claude-recall` command, not a pinned path.
 
-**Verify**: `claude-recall --version` shows the new version, and asking *"Load my rules"* in Claude Code triggers `mcp__claude-recall__load_rules`.
+For Pi, run `pi update npm:claude-recall` and restart Pi.
 
-#### If you use Pi
+<details>
+<summary><b>If <code>claude-recall upgrade</code> reports <code>EACCES: permission denied</code></b></summary>
 
-Run this **once** — the `npm:` prefix is required (it matches the original install command):
+Your global npm prefix is root-owned (common with `apt install nodejs`). Pick one:
 
+**Quick** — one-time sudo:
 ```bash
-pi update npm:claude-recall
+sudo npm install -g claude-recall
 ```
 
-Restart Pi to load the updated extension.
-
-**Verify**: `pi list` shows the new `claude-recall` version, and asking *"Load my rules"* in Pi triggers `recall_load_rules`.
+**Permanent** — move the prefix to a user-owned directory, then no global install ever needs sudo again:
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix ~/.npm-global
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
 
-#### If you use both
+# now re-run
+claude-recall upgrade
+```
 
-Both upgrades are independent — run the Claude Code section AND the Pi section. Both agents share the same `~/.claude-recall/claude-recall.db`, so memories captured in either are visible to the other.
+</details>
 
 ---
 
@@ -312,6 +296,7 @@ claude-recall mcp cleanup --all          # Stop all stale MCP servers
 # ── Setup & Diagnostics ─────────────────────────────────────────────
 claude-recall setup                      # Show activation instructions
 claude-recall setup --install            # Install skills + hooks
+claude-recall upgrade                    # One-shot upgrade: global binary + clear stale MCP servers
 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

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

@@ -261,6 +261,77 @@ class ClaudeRecallCLI {
         });
         this.logger.info('CLI', 'Failures displayed', { count: displayFailures.length });
     }
+    /**
+     * One-shot upgrade: check registry, install latest globally, clean up any
+     * running MCP servers (so fresh 0.x spawns on next Claude Code tool call).
+     *
+     * Handles the common failure modes inline so users don't have to figure them out:
+     *   - EACCES on `/usr/lib/node_modules` → print sudo + permanent-prefix fix
+     *   - No npm in PATH → actionable error
+     *   - Registry unreachable → clear error, don't leave install half-done
+     */
+    async upgrade() {
+        const { execSync, spawnSync } = require('child_process');
+        // Current version from package.json shipped with the installed binary
+        let current;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+            current = pkg.version;
+        }
+        catch {
+            current = 'unknown';
+        }
+        // Latest version from registry
+        let latest;
+        try {
+            latest = execSync('npm view claude-recall version', {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+        }
+        catch (err) {
+            console.error('❌ Could not reach the npm registry.');
+            console.error(`   ${err?.stderr?.toString().trim() || err?.message || 'unknown error'}`);
+            console.error('\nCheck your connection, then run `claude-recall upgrade` again.');
+            process.exit(1);
+        }
+        console.log(`Installed: ${current}`);
+        console.log(`Latest:    ${latest}`);
+        if (current === latest) {
+            console.log('\n✓ Already up to date.');
+            return;
+        }
+        console.log(`\n📦 Upgrading ${current} → ${latest}...\n`);
+        // Run npm install -g, streaming output so the user sees progress / errors live
+        const install = spawnSync('npm', ['install', '-g', 'claude-recall@latest'], {
+            stdio: 'inherit',
+        });
+        if (install.status !== 0) {
+            // npm prints its own error — add the practical remediation on top
+            console.error('\n❌ Install failed.');
+            console.error('\nMost common cause: your global npm prefix is owned by root (EACCES).');
+            console.error('\nQuick fix:');
+            console.error('  sudo npm install -g claude-recall');
+            console.error('\nPermanent fix (no more sudo for any global install on this machine):');
+            console.error('  mkdir -p ~/.npm-global');
+            console.error("  npm config set prefix ~/.npm-global");
+            console.error("  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc");
+            console.error('  source ~/.bashrc');
+            console.error('\nThen re-run: claude-recall upgrade');
+            process.exit(install.status ?? 1);
+        }
+        // Kill any running MCP servers so Claude Code respawns them with the new binary
+        console.log('\n🧹 Cleaning up running MCP servers (Claude Code respawns them on next tool call)...');
+        try {
+            spawnSync('claude-recall', ['mcp', 'cleanup', '--all'], { stdio: 'inherit' });
+        }
+        catch {
+            // Non-fatal — the user can restart Claude Code manually if this fails
+        }
+        console.log(`\n✓ Upgraded to ${latest}. No need to re-run \`claude mcp add\` — existing`);
+        console.log('  registrations point at the `claude-recall` command and pick up the new');
+        console.log('  binary automatically. Just run any tool in Claude Code.');
+    }
     /**
      * Demote rules loaded often but never cited — excludes them from future load_rules payloads.
      * Rules remain searchable via search_memory and can be restored with `rules promote <id>`.
@@ -1613,6 +1684,15 @@ async function main() {
         cli.cleanupTestPollution({ dryRun: options.dryRun });
         process.exit(0);
     });
+    // Upgrade command: one-shot upgrade, handles EACCES inline
+    program
+        .command('upgrade')
+        .description('Upgrade claude-recall to the latest version and clear stale MCP servers')
+        .action(async () => {
+        const cli = new ClaudeRecallCLI(program.opts());
+        await cli.upgrade();
+        process.exit(0);
+    });
     // Export command
     program
         .command('export <output>')

package/package.json

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