claude-recall 0.18.9 → 0.20.0

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

@@ -8,30 +8,15 @@ source: claude-recall
 
 # Corrections
 
-Auto-generated from 20 memories. Last updated: 2026-03-22.
+Auto-generated from 5 memories. Last updated: 2026-04-02.
 
 ## Rules
 
-- CORRECTION: Memory with complex metadata
-- CORRECTION: Memory with complex metadata
-- CORRECTION: Memory with complex metadata
-- CORRECTION: Memory with complex metadata
-- CORRECTION: Memory with complex metadata
-- CORRECTION: Memory with complex metadata
-- CORRECTION: Memory with complex metadata
-- 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
-- CORRECTION: cited (loaded 5+ times): 19
-- CORRECTION: cited (loaded 5+ times): 19
 
 ---
 *Auto-generated by Claude Recall. Regenerate: `npx claude-recall skills generate`*

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

@@ -1,28 +1,13 @@
 {
   "topicId": "corrections",
-  "sourceHash": "be94895a3ad6a5999508be2c149a1a2742178fff9f9adc97b5da6185c9a30398",
-  "memoryCount": 20,
-  "generatedAt": "2026-03-22T15:58:29.733Z",
+  "sourceHash": "a88187b382c2104a20922fd98e9de60d9ef6434a0a5e25f03a011998b491290f",
+  "memoryCount": 5,
+  "generatedAt": "2026-04-02T19:49:59.553Z",
   "memoryKeys": [
-    "memory_1774195109722_gij039r4m",
-    "memory_1774191618092_vuxyvq3mw",
-    "memory_1774106331272_kg5w7ztfj",
-    "memory_1774104588311_65kg08e05",
-    "memory_1773140547102_2wmy0cfga",
-    "memory_1773065886725_rscm7v2qx",
-    "memory_1773063478046_x0ryr9bk4",
-    "memory_1773063445947_2r842dw2l",
-    "memory_1772641994141_ddvzwdkd9",
-    "memory_1772641570519_wmnb2b08w",
-    "memory_1772641026962_tqm8ow04r",
+    "memory_1775159399542_awfryrxp3",
+    "memory_1775157082825_8uvrul28i",
+    "memory_1775156381094_dr1nihes8",
     "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",
-    "hook_correction_1772633504532_l6yo1jvun",
-    "hook_correction_1772633492812_0iqsrgnl2"
+    "hook_correction_1774180805192_4ft4zhfsa"
   ]
 }

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

@@ -8,27 +8,19 @@ source: claude-recall
 
 # Failure Lessons
 
-Auto-generated from 24 memories. Last updated: 2026-03-22.
+Auto-generated from 16 memories. Last updated: 2026-04-02.
 
 ## Rules
 
 - 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: 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)
-- npm install failed: claude-recall@0.15.36 version not found in registry
-- npm package claude-recall@0.15.36 does not exist - version not found in registry
-- npm package claude-recall@0.15.36 not found - version does not exist in registry
 - Claude-recall MCP Server failed to start with npx claude-recall@latest mcp start
 - Claude-recall MCP Server failed to start with command: npx -y claude-recall@latest mcp start
 - Avoid: Command failed: npm run build 2>&1 | tail -3 && npm test 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
 - Avoid: Command failed: npx jest tests/unit/failure-detectors.test.ts 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
-- Missing dependency: better-sqlite3 module not installed
-- Missing dependency: better-sqlite3 module not installed
 - SQLite query error: LIKE clause needs proper string literal syntax with single quotes in better-sqlite3
 - Node.js syntax error: multiline strings in -e flag not properly escaped; newlines break the command parsing
-- npm package claude-recall@0.15.14 not found in registry - 404 error during installation
 - Avoid: Test command reported failures: npx jest tests/unit/failure-detectors.test.ts 2>&1 → Instead: Read test output carefully — exit code 0 does not mean all tests passed
 - Node.js -e flag cannot parse multiline strings with unescaped newlines in single quotes
 - claude-recall reconnection failed after reinstall

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

@@ -1,26 +1,18 @@
 {
   "topicId": "failure-lessons",
-  "sourceHash": "00deb7a6c6d99c26e0d29a6a707b4c303dcb19731d27a8ce41db09fd2ff3eb55",
-  "memoryCount": 24,
-  "generatedAt": "2026-03-22T15:00:18.049Z",
+  "sourceHash": "f3351c090380fb67413721e169ecee6882c991fff7f46e1bbd3b13b208e4c24b",
+  "memoryCount": 16,
+  "generatedAt": "2026-04-02T18:23:28.296Z",
   "memoryKeys": [
     "hook_failure_1772637584921_0tj4rrxnt",
     "hook_failure_non-zero-exit_1774020949485_6ubuoswae",
     "hook_failure_non-zero-exit_1773409269877_ful451241",
-    "hook_failure_1773410916808_5k1r6zo4u",
-    "hook_failure_1773410916789_xtrb8j9nw",
-    "hook_failure_1773410910825_rd25wy0tf",
-    "hook_failure_1773410885720_u05tuf2dk",
-    "hook_failure_1773410874391_kbnfssg62",
     "hook_failure_1773409616313_gmsfcbuzh",
     "hook_failure_1773409607268_83ie5yunz",
     "hook_failure_non-zero-exit_1773068793859_0z0ah0743",
     "hook_failure_non-zero-exit_1772640279977_g3gwlfoqi",
-    "hook_failure_1772637646276_ow6m7pr34",
-    "hook_failure_1772637630961_6gsnac7cw",
     "hook_failure_1772637570984_yxs8zmurp",
     "hook_failure_1772637485532_djep8eysa",
-    "hook_failure_1771937269919_jx3wvpyxq",
     "hook_failure_silent-test-failure_1772640279996_m8f3ks8fw",
     "hook_failure_1772637495154_i21dho3dv",
     "hook_failure_1773410663873_oegccxk83",

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

@@ -8,31 +8,26 @@ source: claude-recall
 
 # Preferences
 
-Auto-generated from 22 memories. Last updated: 2026-04-01.
+Auto-generated from 17 memories. Last updated: 2026-04-02.
 
 ## Rules
 
-- axios npm package was compromised in a supply chain attack (axios@1.14.1 pulled in malicious plain-crypto-js@4.2.1). Claude Recall is NOT affected — does not use axios. Verified 2026-04-01. If axios is ever added as a dependency, pin the version and audit lockfiles.
-- 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
+- Session test preference 1775159399698
+- Test preference 1775159399559-2
+- Test preference 1775159399559-1
+- Test preference 1775159399559-0
 - Test memory content
-- a normal preference
-- Session test preference 1774106331339
-- Test preference 1774106331283-2
-- Test preference 1774106331283-1
-- Test preference 1774106331283-0
+- Session test preference 1775157082982
+- Test preference 1775157082853-2
+- Test preference 1775157082853-1
+- Test preference 1775157082853-0
 - Test memory content
-- Session test preference 1774104588383
-- Test preference 1774104588325-2
-- Test preference 1774104588325-1
-- Test preference 1774104588325-0
+- Session test preference 1775156381211
+- Test preference 1775156381110-2
+- Test preference 1775156381110-1
+- Test preference 1775156381110-0
 - Test memory content
-- Session test preference 1774020789925
+- axios npm package was compromised in a supply chain attack (axios@1.14.1 pulled in malicious plain-crypto-js@4.2.1). Claude Recall is NOT affected — does not use axios. Verified 2026-04-01. If axios is ever added as a dependency, pin the version and audit lockfiles.
 - Upgrade all projects whenever a new version is pushed
 
 ---

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

@@ -1,30 +1,25 @@
 {
   "topicId": "preferences",
-  "sourceHash": "ad9e64fb51202f15dbb49b534b20617f88a6a83e890c45c794b81578a7c1374d",
-  "memoryCount": 22,
-  "generatedAt": "2026-04-01T08:07:09.378Z",
+  "sourceHash": "13276d13523c8f8ec13ae9948cfa0e2cdd8ca5cd0fd6453b544307ae47d91df5",
+  "memoryCount": 17,
+  "generatedAt": "2026-04-02T19:49:59.727Z",
   "memoryKeys": [
-    "memory_1775030829333_64gdk8kql",
-    "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",
-    "memory_1774106331284_ai62szr9y",
-    "memory_1774106331222_zjfz8zu59",
-    "memory_1774104588384_hy5yej2pk",
-    "memory_1774104588351_whsk5rvw3",
-    "memory_1774104588338_80cx2o3jv",
-    "memory_1774104588325_g4o5ksubl",
-    "memory_1774104588255_fy0wv845g",
-    "memory_1774020789927_g99mrubvu",
+    "memory_1775159399702_yg6ynd05n",
+    "memory_1775159399631_fmy4s2vhr",
+    "memory_1775159399606_xymkvcjfv",
+    "memory_1775159399561_o6vpb3fto",
+    "memory_1775159399463_0pvhuixyr",
+    "memory_1775157082984_oiyt9u65w",
+    "memory_1775157082927_29d7mm59z",
+    "memory_1775157082892_o9i0jbw76",
+    "memory_1775157082855_zlbl2ib0j",
+    "memory_1775157082743_fu07oklto",
+    "memory_1775156381212_ptlo01224",
+    "memory_1775156381158_3p6goornd",
+    "memory_1775156381132_ikx95mk0n",
+    "memory_1775156381111_1x4fxfu9n",
+    "memory_1775156381012_3tw7we7cz",
+    "memory_1775154208266_arwo2fctx",
     "hook_preference_1774106575282_45sk4ep52"
   ]
 }

package/README.md

@@ -1,10 +1,12 @@
 # Claude Recall
 
-### Persistent, local memory for Claude Code — learn from every session.
+### Persistent, local memory for coding agents — learn from every session.
 
-Claude Recall is a **local memory engine + MCP server** that gives Claude Code something it's missing by default:
+Claude Recall is a **local memory engine** that gives coding agents something they're missing by default:
 **the ability to learn from you over time.**
 
+Works with **Claude Code** (via MCP server + hooks) and **[Pi](https://github.com/mariozechner/pi)** (via native extension). Both share the same local database — a preference learned in one agent is available in the other.
+
 Your preferences, project structure, workflows, corrections, and coding style are captured automatically and applied in future sessions — **securely stored on your machine**.
 
 ---
@@ -12,9 +14,9 @@ Your preferences, project structure, workflows, corrections, and coding style ar
 ## Features
 
 - **Smart Memory Capture** — LLM-powered classification (via Claude Haiku) detects preferences and corrections from natural language, with silent regex fallback
-- **Project-Scoped Knowledge** — each project gets its own memory namespace; switch projects and Claude switches context automatically
-- **Failure Learning** — captures what failed, why, and what to do instead — so Claude doesn't repeat mistakes
-- **Outcome-Aware Learning** — tracks action outcomes (bash results, test cycles, user corrections), synthesizes candidate lessons, and promotes validated patterns into active rules automatically
+- **Project-Scoped Knowledge** — each project gets its own memory namespace; switch projects and the agent switches context automatically
+- **Failure Learning** — captures what failed, why, and what to do instead — so the agent doesn't repeat mistakes
+- **Outcome-Aware Learning** — tracks action outcomes (all tool results, test cycles, user corrections), synthesizes candidate lessons, and promotes validated patterns into active rules automatically
 - **Skill Crystallization** — auto-generates `.claude/skills/auto-*/` files from accumulated memories, using Anthropic's [Agent Skills](https://agentskills.io/) open standard
 - **Local-Only** — SQLite on your machine, no telemetry, no cloud, works fully offline
 
@@ -29,60 +31,46 @@ Your preferences, project structure, workflows, corrections, and coding style ar
 | Node.js   | **20+**                 | required for better-sqlite3 |
 | OS        | macOS / Linux / Windows | WSL supported               |
 
-### Install / Reinstall
-
-Run these from your project directory:
+### Install for Claude Code
 
 ```bash
-# 1. Remove MCP server registration (if exists)
-claude mcp remove claude-recall
-
-# 2. Clear npm cache
-npm cache clean --force
-
-# 3. Uninstall global claude-recall
-npm uninstall -g claude-recall
-
-# 4. Install global claude-recall
+# Install globally
 npm install -g claude-recall
 
-# 5. Install in local project folder
+# Set up hooks and skills in your project
 claude-recall setup --install
 
-# 6. Re-register MCP server
+# Register MCP server
 claude mcp add claude-recall -- claude-recall mcp start
 ```
 
-Then restart your Claude Code session.
+Then restart your Claude Code session. For additional projects, only the last two commands are needed.
 
-### Adding to another project
+**Verify:** Ask *"Load my rules"* — Claude should call `mcp__claude-recall__load_rules`.
 
-From the new project directory, only steps 5-6 are needed:
+### Install for Pi
 
 ```bash
-claude-recall setup --install
-claude mcp add claude-recall -- claude-recall mcp start
+pi install npm:claude-recall
 ```
 
-Memories are automatically scoped per project in a shared database (`~/.claude-recall/claude-recall.db`).
+That's it. The extension registers tools and loads a skill automatically. No further configuration needed.
 
-### Verify
+**Verify:** Start Pi and ask *"Load my rules"* — Pi should call `recall_load_rules`.
 
-In Claude Code, ask: *"Load my rules"*
+### Shared Database
 
-Claude should call `mcp__claude-recall__load_rules`. If it works, you're ready.
+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.
 
 ### Upgrading
 
-When a new version is published, update the global binary — no per-project reinstall needed:
-
 ```bash
-npm cache clean --force
-npm uninstall -g claude-recall
+# Claude Code
 npm install -g claude-recall
-```
 
-Then restart Claude Code sessions in each project to pick up the new version.
+# Pi
+pi update claude-recall
+```
 
 ---
 
@@ -90,21 +78,20 @@ Then restart Claude Code sessions in each project to pick up the new version.
 
 Once installed, Claude Recall works automatically in the background:
 
-1. **First prompt** — the `search_enforcer` hook ensures Claude loads your stored rules before taking any action
-2. **As you work** — the `correction-detector` hook classifies every prompt you type. Natural statements like *"we use tabs here"* or *"no, put tests in `__tests__/`"* are detected and stored automatically
-3. **End of turn** — the `memory-stop` hook scans recent transcript entries for corrections, preferences, failures, and devops patterns. It also creates **episodes** summarizing the session outcome, generates **candidate lessons** from detected failures, and runs a **promotion cycle** to graduate validated patterns into active rules
-4. **Bash failures** — the `bash-failure-watcher` hook captures command failures in real-time, pairs successful fixes, and writes **outcome events** for the learning pipeline
-5. **Reask detection** — the `correction-detector` hook detects user frustration signals ("still broken", "that didn't work") and records them as outcome events
-6. **Before context compression** — the `precompact-preserve` hook sweeps up to 50 entries so nothing important is lost when the context window shrinks
-7. **Rules sync to auto-memory** — the `memory-sync` hook exports active rules to `~/.claude/projects/{project}/memory/recall-rules.md` so they're available even when the MCP server is down
+1. **Session start** — active rules are loaded before the first action. In Claude Code, this happens via the `search_enforcer` hook; in Pi, rules are injected into the system prompt automatically
+2. **As you work** — every prompt is classified for corrections and preferences. Natural statements like *"we use tabs here"* or *"no, put tests in `__tests__/`"* are detected and stored
+3. **Tool outcomes** — results from all tools (Bash, Edit, Write, and more) are captured. Failures are stored as memories; Bash failures are paired with successful fixes
+4. **End of session** — session episodes are created, candidate lessons extracted from failures, and a promotion cycle graduates validated patterns into active rules
+5. **Reask detection** — frustration signals ("still broken", "that didn't work") are recorded as outcome events
+6. **Before context compression** — aggressive memory sweep captures important context before the window shrinks
+7. **Rules sync** (Claude Code only) — top 30 rules are exported as typed `.md` files to Claude Code's native memory directory
 
-All classification uses Claude Haiku (via `ANTHROPIC_API_KEY` from your Claude Code session) with silent regex fallback. No configuration needed.
+Classification uses Claude Haiku (via `ANTHROPIC_API_KEY`) with silent regex fallback. No configuration needed.
 
-**Next session:** `load_rules` returns everything captured previously — Claude applies your preferences without being told twice.
+**Next session:** `load_rules` returns everything captured previously — the agent applies your preferences without being told twice.
 
 ```bash
 # Verify it's working
-cat ~/.claude-recall/hook-logs/correction-detector.log
 claude-recall stats
 claude-recall search "preference"
 ```
@@ -113,28 +100,34 @@ claude-recall search "preference"
 
 ## How It Works
 
-Claude Recall runs as an MCP server exposing four tools, backed by a local SQLite database with WAL mode, content-hash deduplication, and automatic compaction.
+Claude Recall provides four memory tools backed by a local SQLite database with WAL mode, content-hash deduplication, and automatic compaction. The tools are exposed differently depending on the agent:
+
+- **Claude Code** — MCP server with four tools and seven prompts, plus file-system hooks for automatic capture
+- **Pi** — native extension with registered tools and event handlers, plus a skill file for behavioral guidance
+
+| Tool | Claude Code | Pi |
+| ---- | ----------- | --- |
+| Load rules | `mcp__claude-recall__load_rules` | `recall_load_rules` |
+| Store memory | `mcp__claude-recall__store_memory` | `recall_store_memory` |
+| Search memory | `mcp__claude-recall__search_memory` | `recall_search_memory` |
+| Delete memory | `mcp__claude-recall__delete_memory` | `recall_delete_memory` |
 
-### Built on Agent Skills
+### Skills
 
-Claude Recall uses Anthropic's [Agent Skills](https://agentskills.io/) open standard to teach Claude when and how to use its memory tools. A core skill (`.claude/skills/memory-management/SKILL.md`) guides Claude's memory behavior using progressive disclosure — metadata loads at startup, full instructions load only when needed. When enough memories accumulate around a topic, Claude Recall auto-generates additional skills (`.claude/skills/auto-*/`) that load natively without MCP tool calls. See Anthropic's [blog post](https://claude.com/blog/equipping-agents-for-the-real-world-with-agent-skills) for more on the Agent Skills architecture.
+Claude Recall uses skill files to teach agents when and how to use memory tools:
 
-| Tool | Purpose |
-| ---- | ------- |
-| `load_rules` | Load all active rules (preferences, corrections, failures, devops) at the start of a task |
-| `store_memory` | Save new knowledge — preferences, corrections, devops rules, failures |
-| `search_memory` | Search memories by keyword, ranked by relevance |
-| `delete_memory` | Delete a specific memory by ID |
+- **Claude Code** — uses Anthropic's [Agent Skills](https://agentskills.io/) open standard. A core skill (`.claude/skills/memory-management/SKILL.md`) guides memory behavior with progressive disclosure. Auto-generated skills (`.claude/skills/auto-*/`) crystallize from accumulated memories. See Anthropic's [blog post](https://claude.com/blog/equipping-agents-for-the-real-world-with-agent-skills) for more.
+- **Pi** — ships a `skills/memory-management.md` skill loaded via Pi's package manifest
 
-### Outcome-Aware Learning (v0.18.0)
+### Outcome-Aware Learning
 
-Claude Recall tracks what happens *after* Claude acts — not just what was said. The outcome processing pipeline:
+Claude Recall tracks what happens *after* the agent acts — not just what was said. The outcome processing pipeline:
 
 ```
 action → outcome event → episode → candidate lesson → promotion → active rule
 ```
 
-- **Outcome events** capture bash results, test outcomes, user corrections, and reask signals
+- **Outcome events** capture results from all tool types (Bash, Edit, Write, MCP), test outcomes, user corrections, and reask signals
 - **Episodes** summarize entire sessions with outcome type, severity, and confidence
 - **Candidate lessons** are extracted from failure patterns — deduplicated by Jaccard similarity
 - **Promotion engine** graduates lessons into active rules after 2+ observations (or immediately for high-severity failures), and demotes never-helpful memories
@@ -216,7 +209,7 @@ claude-recall hook run memory-sync           # Stop + PreCompact hook (syncs rul
 
 ## Project Scoping
 
-Each project gets isolated memory based on its working directory. **Project ID** is derived from the `cwd` that Claude Code passes to the MCP server. Universal memories (no project scope) are available everywhere. Switching projects switches memory automatically.
+Each project gets isolated memory based on its working directory. **Project ID** is derived from the `cwd` passed by the agent. Universal memories (no project scope) are available everywhere. Switching projects switches memory automatically.
 
 Database location: `~/.claude-recall/claude-recall.db` (shared file, scoped by `project_id` column).
 

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

@@ -693,15 +693,25 @@ async function main() {
         // This avoids registry lookups on every hook invocation.
         const cliScript = path.join(packageDir, 'dist', 'cli', 'claude-recall-cli.js');
         const hookCmd = `node ${cliScript} hook run`;
-        settings.hooksVersion = '8.0.0'; // v8 = add bash-failure-watcher PostToolUse hook
+        settings.hooksVersion = '10.0.0'; // v10 = add PostToolUseFailure for explicit error capture
         settings.hooks = {
             PostToolUse: [
                 {
-                    matcher: "Bash",
                     hooks: [
                         {
                             type: "command",
-                            command: `${hookCmd} bash-failure-watcher`,
+                            command: `${hookCmd} tool-outcome-watcher`,
+                            timeout: 3
+                        }
+                    ]
+                }
+            ],
+            PostToolUseFailure: [
+                {
+                    hooks: [
+                        {
+                            type: "command",
+                            command: `${hookCmd} tool-failure`,
                             timeout: 3
                         }
                     ]

package/dist/cli/commands/hook-commands.js

@@ -75,14 +75,25 @@ class HookCommands {
                         await handleMemorySync(input);
                         break;
                     }
+                    case 'tool-outcome-watcher': {
+                        const { handleToolOutcomeWatcher } = await Promise.resolve().then(() => __importStar(require('../../hooks/tool-outcome-watcher')));
+                        await handleToolOutcomeWatcher(input);
+                        break;
+                    }
+                    case 'tool-failure': {
+                        const { handleToolFailure } = await Promise.resolve().then(() => __importStar(require('../../hooks/tool-outcome-watcher')));
+                        await handleToolFailure(input);
+                        break;
+                    }
                     case 'bash-failure-watcher': {
-                        const { handleBashFailureWatcher } = await Promise.resolve().then(() => __importStar(require('../../hooks/bash-failure-watcher')));
+                        // Backward compat alias — routes to tool-outcome-watcher
+                        const { handleBashFailureWatcher } = await Promise.resolve().then(() => __importStar(require('../../hooks/tool-outcome-watcher')));
                         await handleBashFailureWatcher(input);
                         break;
                     }
                     default:
                         console.error(`Unknown hook: ${name}`);
-                        console.error('Available: correction-detector, memory-stop, precompact-preserve, memory-sync, bash-failure-watcher');
+                        console.error('Available: correction-detector, memory-stop, precompact-preserve, memory-sync, tool-outcome-watcher');
                 }
             }
             catch {

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

@@ -111,13 +111,16 @@ async function handleMemoryStop(input) {
     scanForCitations(transcriptPath);
     // Scan transcript for failure signals (non-zero exits, test cycles, backtracking, etc.)
     const failures = detectAndStoreFailures(transcriptPath, episodeId);
+    // Incorporate structured tool_failure events captured by PostToolUseFailure hook
+    const toolFailures = getToolFailureEvents(outcomeStorage);
+    const allFailures = [...failures, ...toolFailures];
     outcomeStorage.updateEpisode(episodeId, {
-        outcome_type: failures.length > 0 ? 'failure' : 'success',
-        severity: failures.length > 0 ? 'medium' : 'low',
-        outcome_summary: `${stored} memories, ${failures.length} failures`,
+        outcome_type: allFailures.length > 0 ? 'failure' : 'success',
+        severity: allFailures.length > 0 ? 'medium' : 'low',
+        outcome_summary: `${stored} memories, ${allFailures.length} failures (${toolFailures.length} from tool events)`,
     });
     // Generate candidate lessons from high-confidence failures
-    generateCandidateLessons(failures, episodeId, projectId);
+    generateCandidateLessons(allFailures, episodeId, projectId);
     // Run promotion cycle
     try {
         const { PromotionEngine } = await Promise.resolve().then(() => __importStar(require('../services/promotion-engine')));
@@ -312,6 +315,30 @@ function detectAndStoreFailures(transcriptPath, episodeId) {
         return [];
     }
 }
+/**
+ * Convert structured tool_failure outcome events into DetectedFailure format
+ * so they feed into the candidate lessons pipeline.
+ */
+function getToolFailureEvents(outcomeStorage) {
+    try {
+        const events = outcomeStorage.getEventsByType('tool_failure', 1); // last 1 hour
+        return events.slice(0, 5).map(e => ({
+            signal: 'tool_failure',
+            confidence: 0.8,
+            content: {
+                what_failed: e.action_summary || 'Tool failure',
+                why_failed: e.next_state_summary,
+                what_should_do: 'Check inputs and prerequisites before retrying',
+                context: `Captured by PostToolUseFailure hook`,
+                preventative_checks: ['Verify tool inputs are correct'],
+            },
+        }));
+    }
+    catch (err) {
+        (0, shared_1.hookLog)('memory-stop', `Tool failure events error: ${(0, shared_1.safeErrorMessage)(err)}`);
+        return [];
+    }
+}
 /**
  * Generate candidate lessons from high-confidence failures.
  * Deduplicates against existing lessons and increments evidence count for similar ones.