claude-recall 0.20.9 → 0.20.11

package/.claude/settings.json

@@ -1 +1,114 @@
-{"hooks": {}, "hooksVersion": "1.0.0"}
+{
+  "hooks": {
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "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 subagent-start",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "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 subagent-stop",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "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 post-compact-reload",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "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
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "hooks": [
+          {
+            "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
+          }
+        ]
+      }
+    ],
+    "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/.nvm/versions/node/v20.19.3/lib/node_modules/claude-recall/dist/cli/claude-recall-cli.js hook run correction-detector"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "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 memory-stop",
+            "timeout": 30
+          },
+          {
+            "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 memory-sync",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "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 precompact-preserve",
+            "timeout": 60
+          },
+          {
+            "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 memory-sync",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  },
+  "hooksVersion": "12.0.0"
+}

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

@@ -8,26 +8,14 @@ source: claude-recall
 
 # Corrections
 
-Auto-generated from 16 memories. Last updated: 2026-04-06.
+Auto-generated from 4 memories. Last updated: 2026-04-06.
 
 ## 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: 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: License copyright should list your name instead of 'Claude Recall Contributors'
+- CORRECTION: Use true agentic design where agents decide when to run, not cron jobs
 
 ---
 *Auto-generated by Claude Recall. Regenerate: `npx claude-recall skills generate`*

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

@@ -1,24 +1,12 @@
 {
   "topicId": "corrections",
-  "sourceHash": "1313608fb812bd1bed85d9854e8958179f7584619e0160604c56bd40ec8cc5b0",
-  "memoryCount": 16,
-  "generatedAt": "2026-04-06T17:24:01.505Z",
+  "sourceHash": "a6c78344ee4e1fb49b692fc1361cc992b2262c5e55ac59db8242e7e8ecbf07c0",
+  "memoryCount": 4,
+  "generatedAt": "2026-04-06T18:39:00.487Z",
   "memoryKeys": [
+    "memory_1775500740471_dp5hmdxaf",
+    "memory_1775499328353_2ade6746o",
     "memory_1775496241485_1yyc5ht88",
-    "memory_1775494279035_j6uj5lzxo",
-    "memory_1775492069326_vksvzmt3f",
-    "memory_1775491767369_sepsjmg8y",
-    "memory_1775169786543_43p8to1hu",
-    "memory_1775169704632_wzwczltzu",
-    "memory_1775169639101_rmxkftqtk",
-    "memory_1775169273281_4fod7ku6f",
-    "memory_1775169256118_y7kc07y6y",
-    "memory_1775169244673_d6d0uc33a",
-    "memory_1775160781806_vnqf355e9",
-    "memory_1775159399542_awfryrxp3",
-    "memory_1775157082825_8uvrul28i",
-    "memory_1775156381094_dr1nihes8",
-    "hook_correction_1774180798682_9b5a2hadq",
-    "hook_correction_1774180805192_4ft4zhfsa"
+    "hook_correction_1775498361284_9amjuw4le"
   ]
 }

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

@@ -8,12 +8,20 @@ source: claude-recall
 
 # Failure Lessons
 
-Auto-generated from 16 memories. Last updated: 2026-04-02.
+Auto-generated from 40 memories. Last updated: 2026-04-06.
 
 ## Rules
 
+- Check command syntax, file paths, and prerequisites before running
+- Check inputs and prerequisites before retrying
 - 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
+- Fix pairing in tool-outcome-watcher fails when the original failing command and the fix command have low string similarity (low Jaccard similarity). Pattern matching is insufficient; needs LLM reasoning about command intent.
+- Avoid: Command failed: kill $(pgrep -f "node.*webui/server.js") 2>/dev/null; sleep 1; cd /home/ebiarao/repos-wsl/persona... → Instead: Check command syntax, file paths, and prerequisites before running
+- Avoid: Command failed: ls artifacts/urgent-trigger-ORACLE.json 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
+- Avoid: Command failed: node agents/shared/tools/post-comms.js '{"agent":"TEST","type":"handoff","priority":"bad","messag... → Instead: Check command syntax, file paths, and prerequisites before running
+- Avoid: Command failed: kill $(pgrep -f "node.*webui/server.js") 2>/dev/null; kill $(pgrep -f "node.*mock-eiap/server.js"... → Instead: Check command syntax, file paths, and prerequisites before running
+- Avoid: Command failed: pgrep -af "webui/server" ; curl -s http://localhost:3000/api/service-health 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
+- Avoid: Command failed: kill $(pgrep -f "node.*webui/server.js") 2>/dev/null; sleep 1; node webui/server.js > /tmp/webui.... → 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
 - 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
@@ -21,6 +29,22 @@ Auto-generated from 16 memories. Last updated: 2026-04-02.
 - Avoid: Command failed: npx jest tests/unit/failure-detectors.test.ts 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
 - 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
+- Fix pairing based on Jaccard string similarity between failing command and fix command is too weak when fixes look syntactically different from original commands (e.g. adding echo pipe vs original bash call); consider semantic matching or explicit fix linking
+- {"what_failed":"Bash command failed: bash scripts/upgrade-sandbox.sh 2>&1","why_failed":"Exit code 1\n\n\u001b[0;32m[upgrade]\u001b[0m ==========================================\n\u001b[0;32m[upgrade]\u001b[0m   NeMoClaw Sandbox Rebuild\n\u001b[0;32m[upgrade]\u001b[0m ==========================================\n\n\u001b[0;32m...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\n\n\u001b[0;32m[upgrade]\u001b[0m ==========================================\n\u001b[0;32m[upgrade]\u001b[0m   NeMoClaw Sandbox Rebuild\n\u001b[0;32m[upgrade]\u001b[0m ==========================================\n\n\u001b[0;32m...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: echo \"Waiting 2 min for next SENTINEL cron tick to fire with delivery:silent...\" && sleep 120 && ...","why_failed":"Exit code 1\nWaiting 2 min for next SENTINEL cron tick to fire with delivery:silent...\nTraceback (most recent call last):\n  File \"<string>\", line 1, in <module>\n    import json,sys;d=json.load(sys.s...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\nWaiting 2 min for next SENTINEL cron tick to fire with delivery:silent...\nTraceback (most recent call last):\n  File \"<string>\", line 1, in <module>\n    import json,sys;d=json.load(sys.s...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: pkill -f \"node.*trigger-watcher\" 2>/dev/null; sleep 1; rm -f /tmp/trigger-watcher.log artifacts/....","why_failed":"Exit code 144","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 144","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: pkill -f \"trigger-watcher\" 2>/dev/null; sleep 1; rm -f /tmp/trigger-watcher.log artifacts/.trigge...","why_failed":"Exit code 144","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 144","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: kill $(pgrep -f \"trigger-watcher.js\") 2>/dev/null; sleep 1; rm -f artifacts/.trigger-watcher-offs...","why_failed":"Exit code 144","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 144","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: openshell sandbox list 2>/dev/null; openshell status 2>/dev/null; ls ~/.openclaw-ata/cron/jobs.js...","why_failed":"Exit code 2\n\u001b[1mNAME     \u001b[0m  \u001b[1mNAMESPACE\u001b[0m  \u001b[1mCREATED            \u001b[0m  \u001b[1mPHASE\u001b[0m\nnka-telco  openshell  2026-04-06 11:22:57  \u001b[32mReady\u001b[39m\n\u001b[1m\u001b[36mServer Status\u001b[39m\u001b[0m\n\n  \u001b[2mGatewa...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 2\n\u001b[1mNAME     \u001b[0m  \u001b[1mNAMESPACE\u001b[0m  \u001b[1mCREATED            \u001b[0m  \u001b[1mPHASE\u001b[0m\nnka-telco  openshell  2026-04-06 11:22:57  \u001b[32mReady\u001b[39m\n\u001b[1m\u001b[36mServer Status\u001b[39m\u001b[0m\n\n  \u001b[2mGatewa...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: ls artifacts/urgent-trigger-ORACLE.json 2>&1","why_failed":"Exit code 2\nls: cannot access 'artifacts/urgent-trigger-ORACLE.json': No such file or directory","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 2\nls: cannot access 'artifacts/urgent-trigger-ORACLE.json': No such file or directory","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: echo \"38\" > artifacts/.trigger-watcher-offset && timeout 8 node scripts/trigger-watcher.js 2>&1","why_failed":"Exit code 124\n[trigger-watcher] 2026-04-06T18:17:44.804Z started — polling every 5s\n[trigger-watcher] 2026-04-06T18:17:44.806Z initial offset: 39 lines","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 124\n[trigger-watcher] 2026-04-06T18:17:44.804Z started — polling every 5s\n[trigger-watcher] 2026-04-06T18:17:44.806Z initial offset: 39 lines","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: node webui/server.js > /tmp/webui.log 2>&1 & sleep 3 && curl -s http://localhost:3000/api/service...","why_failed":"Exit code 7\n[1]+  Exit 1                  node webui/server.js > /tmp/webui.log 2>&1","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 7\n[1]+  Exit 1                  node webui/server.js > /tmp/webui.log 2>&1","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: sleep 2 && curl -s http://localhost:3000/api/service-health 2>&1","why_failed":"Exit code 7","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 7","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: kill $(pgrep -f \"node.*webui/server.js\") 2>/dev/null; sleep 1; cd /home/ebiarao/repos-wsl/persona...","why_failed":"Exit code 144","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 144","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: ls artifacts/urgent-trigger-ORACLE.json 2>&1","why_failed":"Exit code 2\nls: cannot access 'artifacts/urgent-trigger-ORACLE.json': No such file or directory","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 2\nls: cannot access 'artifacts/urgent-trigger-ORACLE.json': No such file or directory","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Bash command failed: node agents/shared/tools/post-comms.js '{\"agent\":\"TEST\",\"type\":\"handoff\",\"priority\":\"bad\",\"messag...","why_failed":"Exit code 1\n[post-comms] Error: priority must be \"normal\" or \"urgent\"","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\n[post-comms] Error: priority must be \"normal\" or \"urgent\"","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Read failed","why_failed":"File content (10265 tokens) exceeds maximum allowed tokens (10000). Use offset and limit parameters to read specific portions of the file, or search for specific content instead of reading the whol...","what_should_do":"Check inputs and prerequisites before retrying","context":"Error: File content (10265 tokens) exceeds maximum allowed tokens (10000). Use offset and limit parameters to read specific portions of the file, or search for specific content instead of reading the whol...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
+- {"what_failed":"Read failed","why_failed":"File content (11505 tokens) exceeds maximum allowed tokens (10000). Use offset and limit parameters to read specific portions of the file, or search for specific content instead of reading the whol...","what_should_do":"Check inputs and prerequisites before retrying","context":"Error: File content (11505 tokens) exceeds maximum allowed tokens (10000). Use offset and limit parameters to read specific portions of the file, or search for specific content instead of reading the whol...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
 - 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,11 +1,19 @@
 {
   "topicId": "failure-lessons",
-  "sourceHash": "f3351c090380fb67413721e169ecee6882c991fff7f46e1bbd3b13b208e4c24b",
-  "memoryCount": 16,
-  "generatedAt": "2026-04-02T18:23:28.296Z",
+  "sourceHash": "168f7a6d77c7a73d97228d1c554a25f923339f11fc3225feae751a4ea38101e0",
+  "memoryCount": 40,
+  "generatedAt": "2026-04-06T18:39:00.441Z",
   "memoryKeys": [
+    "promoted_1775498319002_awwrsovw6",
+    "promoted_1775499579486_bxvgjc80r",
     "hook_failure_1772637584921_0tj4rrxnt",
-    "hook_failure_non-zero-exit_1774020949485_6ubuoswae",
+    "hook_failure_1775500665745_zl6zsp7jw",
+    "hook_failure_non-zero-exit_1775499579462_n5xb6rr8r",
+    "hook_failure_non-zero-exit_1775499579440_2tv110hs9",
+    "hook_failure_non-zero-exit_1775499579425_n53js176o",
+    "hook_failure_non-zero-exit_1775498318987_pqbmsatub",
+    "hook_failure_non-zero-exit_1775498318976_mzbyvdceo",
+    "hook_failure_non-zero-exit_1775498318963_thiuiiqef",
     "hook_failure_non-zero-exit_1773409269877_ful451241",
     "hook_failure_1773409616313_gmsfcbuzh",
     "hook_failure_1773409607268_83ie5yunz",
@@ -13,6 +21,22 @@
     "hook_failure_non-zero-exit_1772640279977_g3gwlfoqi",
     "hook_failure_1772637570984_yxs8zmurp",
     "hook_failure_1772637485532_djep8eysa",
+    "hook_failure_1775500618695_6grbwpm3t",
+    "hook_failure_1775500273633_yrw798ahh",
+    "hook_failure_1775500125145_ad65bw8rs",
+    "hook_failure_1775499854068_ze23fp9gf",
+    "hook_failure_1775499797961_6ziqluf1i",
+    "hook_failure_1775499784048_qsshv04hl",
+    "hook_failure_1775499638896_pfhgi3kn5",
+    "hook_failure_1775499503779_k9vabnkif",
+    "hook_failure_1775499472886_1exmgb4ef",
+    "hook_failure_1775499266183_drme5d0j6",
+    "hook_failure_1775499258759_4unleb4yv",
+    "hook_failure_1775499252924_czqqpfsp3",
+    "hook_failure_1775499173022_pkye9oqx8",
+    "hook_failure_1775499039635_67oste4m3",
+    "hook_failure_1775498545106_8348kw22h",
+    "hook_failure_1775498542480_wc23ux8gt",
     "hook_failure_silent-test-failure_1772640279996_m8f3ks8fw",
     "hook_failure_1772637495154_i21dho3dv",
     "hook_failure_1773410663873_oegccxk83",

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

@@ -8,89 +8,30 @@ source: claude-recall
 
 # Preferences
 
-Auto-generated from 79 memories. Last updated: 2026-04-06.
+Auto-generated from 20 memories. Last updated: 2026-04-06.
 
 ## Rules
 
+- Session test preference 1775500740595
+- Test preference 1775500740495-2
+- Test preference 1775500740495-1
+- Test preference 1775500740495-0
+- Test memory content
+- Session test preference 1775499328559
+- Test preference 1775499328384-2
+- Test preference 1775499328384-1
+- Test preference 1775499328384-0
+- Test memory content
 - Session test preference 1775496241643
 - Test preference 1775496241514-2
 - Test preference 1775496241514-1
 - Test preference 1775496241514-0
 - Test memory content
 - Session test preference 1775494279149
-- Test preference 1775494279061-2
-- Test preference 1775494279061-1
-- Test preference 1775494279061-0
-- Test memory content
-- Session test preference 1775492069465
-- Test preference 1775492069353-2
-- Test preference 1775492069353-1
-- Test preference 1775492069353-0
-- Test memory content
-- Session test preference 1775491767519
-- Test preference 1775491767395-2
-- Test preference 1775491767395-1
-- Test preference 1775491767395-0
-- Test memory content
-- When planning implementation work, always divide into phases/stages. Each phase must have its own verification tests with concrete commands and expected outputs. Only proceed to the next phase when the current phase's tests pass. Never combine untested changes into a single deployment. This prevents hours of debugging cascading failures.
-- Solving issues and testing that they are solved takes priority over committing and pushing. Don't suggest committing until the fix is verified end-to-end.
-- When the user says "jam" it means "just answer me" — give a direct, concise answer without extra exploration, tool calls, or elaboration. Skip the research and just respond.
 - After each refactoring, document the changes made. Don't batch documentation to the end — write it as you go.
 - Any major refactoring requires exhaustive search to make sure nothing is missed. Always grep/search comprehensively before and after changes to verify no stale references, broken imports, or missed files remain.
-- Session test preference 1775169786712
-- Test preference 1775169786565-2
-- Test preference 1775169786565-1
-- Test preference 1775169786565-0
-- Test memory content
-- Session test preference 1775169704849
-- Test preference 1775169704668-2
-- Test preference 1775169704668-1
-- Test preference 1775169704668-0
-- Test memory content
-- Session test preference 1775169639212
-- Test preference 1775169639121-2
-- Test preference 1775169639121-1
-- Test preference 1775169639121-0
-- Test memory content
-- Session test preference 1775169273366
-- Test preference 1775169273296-2
-- Test preference 1775169273296-1
-- Test preference 1775169273296-0
-- Test memory content
-- Session test preference 1775169256189
-- Test preference 1775169256133-2
-- Test preference 1775169256133-1
-- Test preference 1775169256133-0
-- Test memory content
-- Session test preference 1775169244752
-- Test preference 1775169244686-2
-- Test preference 1775169244686-1
-- Test preference 1775169244686-0
-- Test memory content
 - Markdown documentation files should be named with the convention YYYYMMDD_<filename>.md (e.g., 20260402_nemoclaw_integration.md). Use underscores, not hyphens, in the date-prefixed filenames.
-- Never commit to git unless the user explicitly approves. Always show the commit message and wait for a clear "yes", "go ahead", "commit", or similar confirmation before running git commit.
-- Session test preference 1775160781884
-- Test preference 1775160781820-2
-- Test preference 1775160781820-1
-- Test preference 1775160781820-0
-- Test memory content
-- Session test preference 1775159399698
-- Test preference 1775159399559-2
-- Test preference 1775159399559-1
-- Test preference 1775159399559-0
-- Test memory content
-- Session test preference 1775157082982
-- Test preference 1775157082853-2
-- Test preference 1775157082853-1
-- Test preference 1775157082853-0
-- Test memory content
-- Session test preference 1775156381211
-- Test preference 1775156381110-2
-- Test preference 1775156381110-1
-- Test preference 1775156381110-0
-- Test memory content
-- 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
+- For agentic design, agents should decide when to run rather than using cron jobs for scheduling
 
 ---
 *Auto-generated by Claude Recall. Regenerate: `npx claude-recall skills generate`*

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

@@ -1,87 +1,28 @@
 {
   "topicId": "preferences",
-  "sourceHash": "1cad20b547cd1594370facfdae6b4ae8700516e9be712d8b28459462398c9276",
-  "memoryCount": 79,
-  "generatedAt": "2026-04-06T17:24:01.663Z",
+  "sourceHash": "2e99c86d7042ef4e9b0cd7c8eda4aa322d1678f9389a2a413ec9d6083db85194",
+  "memoryCount": 20,
+  "generatedAt": "2026-04-06T18:39:00.616Z",
   "memoryKeys": [
+    "memory_1775500740596_xok3iey9j",
+    "memory_1775500740545_op5713e5i",
+    "memory_1775500740519_ln1fd8ow4",
+    "memory_1775500740497_f06v303gf",
+    "memory_1775500740399_ud5aghy9a",
+    "memory_1775499328561_9m7ao3h8s",
+    "memory_1775499328480_e2zx9g5ly",
+    "memory_1775499328425_plvaaxd69",
+    "memory_1775499328386_dqcav3itu",
+    "memory_1775499328258_cilhe1owj",
     "memory_1775496241645_xtz7cwan4",
     "memory_1775496241576_j7sxxuge3",
     "memory_1775496241542_rg3hj24ud",
     "memory_1775496241516_y3inz8rlf",
     "memory_1775496241411_vwdz6igrm",
     "memory_1775494279150_n4pq7zy11",
-    "memory_1775494279108_6hbe8qoit",
-    "memory_1775494279088_nv8hjdm7s",
-    "memory_1775494279062_jx4wrwn6s",
-    "memory_1775494278982_fsc491z41",
-    "memory_1775492069467_5cturlg0a",
-    "memory_1775492069400_icg4tjivf",
-    "memory_1775492069377_goix7nu9v",
-    "memory_1775492069354_wma3zh5i7",
-    "memory_1775492069258_q9d2k28wt",
-    "memory_1775491767523_p2xtn4uak",
-    "memory_1775491767447_q1dwsdfk3",
-    "memory_1775491767421_vgntf4jt8",
-    "memory_1775491767397_f181w5lqd",
-    "memory_1775491767290_s7ntmkwpg",
-    "memory_1775491073130_p8b493ay9",
-    "memory_1775236195716_i3pb5nls7",
-    "memory_1775210227089_j433ldlva",
     "memory_1775208934902_2kovciriy",
     "memory_1775208477621_fqa3w21j1",
-    "memory_1775169786717_1zmwoe6ai",
-    "memory_1775169786630_rdudb8hbc",
-    "memory_1775169786589_zurej1v51",
-    "memory_1775169786567_3esvhc01j",
-    "memory_1775169786460_vugzw5yl0",
-    "memory_1775169704852_ezdebznpz",
-    "memory_1775169704771_ak9vkaswc",
-    "memory_1775169704739_dg78h7lte",
-    "memory_1775169704670_f1yhtrmsz",
-    "memory_1775169704515_lby33vw9c",
-    "memory_1775169639213_w3i85h357",
-    "memory_1775169639170_iewh2evi0",
-    "memory_1775169639145_x9s0519l7",
-    "memory_1775169639123_fa53agp0a",
-    "memory_1775169639037_f290kffwd",
-    "memory_1775169273368_c1e5jdl9r",
-    "memory_1775169273337_wozxe12k3",
-    "memory_1775169273319_3o1ww90na",
-    "memory_1775169273297_oqmyxziav",
-    "memory_1775169273232_eoymf3ezj",
-    "memory_1775169256190_681x8frvt",
-    "memory_1775169256164_kqderurux",
-    "memory_1775169256150_0nqbk7tx9",
-    "memory_1775169256134_ftj0m44bb",
-    "memory_1775169256069_dywd646f7",
-    "memory_1775169244754_sjfarlk41",
-    "memory_1775169244722_mavida9fg",
-    "memory_1775169244707_nmmu0s0lu",
-    "memory_1775169244688_03q4mmcky",
-    "memory_1775169244628_7kuhf5met",
     "memory_1775168901303_o8o0i4952",
-    "memory_1775162828137_l6uw5swdn",
-    "memory_1775160781885_fkbnc0s85",
-    "memory_1775160781857_gj5y299dr",
-    "memory_1775160781842_0xmv146n5",
-    "memory_1775160781821_o9ipt8nsc",
-    "memory_1775160781747_70e5gbp7j",
-    "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"
+    "hook_preference_1775498374200_6d21qj14y"
   ]
 }

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

@@ -693,8 +693,30 @@ 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 = '11.0.0'; // v11 = add SessionStart(compact) for post-compaction rule reload
+        settings.hooksVersion = '12.0.0'; // v12 = add SubagentStart/Stop for sub-agent recall integration
         settings.hooks = {
+            SubagentStart: [
+                {
+                    hooks: [
+                        {
+                            type: "command",
+                            command: `${hookCmd} subagent-start`,
+                            timeout: 5
+                        }
+                    ]
+                }
+            ],
+            SubagentStop: [
+                {
+                    hooks: [
+                        {
+                            type: "command",
+                            command: `${hookCmd} subagent-stop`,
+                            timeout: 10
+                        }
+                    ]
+                }
+            ],
             SessionStart: [
                 {
                     matcher: "compact",

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

@@ -90,6 +90,16 @@ class HookCommands {
                         await handlePostCompactReload(input);
                         break;
                     }
+                    case 'subagent-start': {
+                        const { handleSubagentStart } = await Promise.resolve().then(() => __importStar(require('../../hooks/subagent-hooks')));
+                        await handleSubagentStart(input);
+                        break;
+                    }
+                    case 'subagent-stop': {
+                        const { handleSubagentStop } = await Promise.resolve().then(() => __importStar(require('../../hooks/subagent-hooks')));
+                        await handleSubagentStop(input);
+                        break;
+                    }
                     case 'bash-failure-watcher': {
                         // Backward compat alias — routes to tool-outcome-watcher
                         const { handleBashFailureWatcher } = await Promise.resolve().then(() => __importStar(require('../../hooks/tool-outcome-watcher')));

package/dist/hooks/llm-classifier.js

@@ -149,26 +149,36 @@ async function extractHindsightHint(failureDescription, context) {
         return null;
     }
 }
-const SESSION_EXTRACTION_PROMPT = `You are analyzing a coding session transcript to extract durable project knowledge.
+const SESSION_EXTRACTION_PROMPT = `You are analyzing a coding session transcript to extract durable lessons.
 
-The transcript shows tool calls (Bash, Edit, Read, Grep, etc.) and their results, plus user and assistant messages.
+The transcript shows tool calls (Bash, Edit, Read, Grep, etc.) and their results, plus user and assistant messages. Your primary job is to identify CAUSE-AND-EFFECT patterns — what failed, why, and what fixed it.
 
-Extract ONLY facts useful in FUTURE sessions:
-- Project conventions discovered (file structure, naming patterns, build tools, test frameworks)
-- Workflow patterns that worked or failed (e.g. "tests must be run from project root")
-- Technical constraints or gotchas encountered (e.g. "this project uses ESM, not CJS")
-- Environment requirements discovered (e.g. "needs Node 20+", "uses pnpm not npm")
+PRIORITY 1 — Failure → Fix sequences:
+Look for tool calls that failed (errors, timeouts, non-zero exits) followed by a different approach that succeeded. Extract the lesson as an imperative rule.
+Examples:
+- Command timed out because of interactive prompt → "scripts/upgrade-sandbox.sh requires interactive confirmation — pipe 'y' to auto-confirm"
+- Edit failed with old_string not found → "File X uses tabs not spaces — match exact indentation when editing"
+- Build failed after dependency change → "Run npm install after modifying package.json before building"
+
+PRIORITY 2 — Project conventions discovered:
+- File structure, naming patterns, build tools, test frameworks
+- Workflow patterns (e.g. "tests must be run from project root")
+- Technical constraints or gotchas (e.g. "this project uses ESM, not CJS")
+- Environment requirements (e.g. "needs Node 20+", "uses pnpm not npm")
+
+PRIORITY 3 — User corrections applied:
+- When the user corrected the agent's approach mid-session
 
 Do NOT extract:
-- Task-specific details (what was built, which files changed this session)
-- Debugging steps unlikely to recur
-- Code patterns visible by reading the codebase
+- Task-specific details (what was built, which files changed)
+- One-off debugging steps unlikely to recur
+- Code patterns derivable from reading the codebase
 - Anything in the EXISTING MEMORIES list below
 
 Respond with ONLY valid JSON (no markdown fences):
 [{"type":"project-knowledge|preference|devops|failure","content":"<imperative statement>","confidence":0.0-1.0}]
 
-Return [] if nothing durable was learned. Max 10 items. Each content should be a concise imperative statement (e.g. "Run tests with pnpm test, not npm test").`;
+Return [] if nothing durable was learned. Max 10 items. Each content should be a concise, actionable rule (e.g. "Pipe 'y' to scripts/upgrade-sandbox.sh — it has an interactive confirmation prompt").`;
 /**
  * Extract durable session learnings from a conversation summary using Haiku.
  * Returns null if no API key or on any failure.

package/dist/hooks/subagent-hooks.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Sub-agent hooks — fires on SubagentStart and SubagentStop events.
+ *
+ * SubagentStart: injects active recall rules into the sub-agent's context
+ * via additionalContext (CC adds this as a message the sub-agent sees).
+ *
+ * SubagentStop: captures the sub-agent's outcome as an outcome event.
+ *
+ * SubagentStart input: { hook_event_name, agent_id, agent_type, session_id, cwd }
+ * SubagentStop input:  { hook_event_name, agent_id, agent_type, agent_transcript_path,
+ *                        last_assistant_message, stop_hook_active, session_id, cwd }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSubagentStart = handleSubagentStart;
+exports.handleSubagentStop = handleSubagentStop;
+const shared_1 = require("./shared");
+const memory_1 = require("../services/memory");
+const config_1 = require("../services/config");
+const outcome_storage_1 = require("../services/outcome-storage");
+function extractVal(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'object' && value !== null) {
+        return value.content || value.value || JSON.stringify(value);
+    }
+    return String(value ?? '');
+}
+function formatRulesCompact(rules) {
+    const sections = [];
+    if (rules.preferences.length > 0) {
+        sections.push('Preferences:\n' + rules.preferences.map(m => `- ${extractVal(m.value)}`).join('\n'));
+    }
+    if (rules.corrections.length > 0) {
+        sections.push('Corrections:\n' + rules.corrections.map(m => `- ${extractVal(m.value)}`).join('\n'));
+    }
+    if (rules.failures.length > 0) {
+        sections.push('Failures:\n' + rules.failures.map(m => `- ${extractVal(m.value)}`).join('\n'));
+    }
+    if (rules.devops.length > 0) {
+        sections.push('DevOps:\n' + rules.devops.map(m => `- ${extractVal(m.value)}`).join('\n'));
+    }
+    return sections.join('\n\n');
+}
+/**
+ * SubagentStart — inject recall rules into the sub-agent's context.
+ * stdout JSON with additionalContext is injected as a message the sub-agent sees.
+ */
+async function handleSubagentStart(input) {
+    try {
+        const agentType = input?.agent_type ?? 'unknown';
+        const projectId = config_1.ConfigService.getInstance().getProjectId();
+        const rules = memory_1.MemoryService.getInstance().loadActiveRules(projectId);
+        const totalRules = rules.preferences.length + rules.corrections.length +
+            rules.failures.length + rules.devops.length;
+        if (totalRules === 0)
+            return;
+        const body = formatRulesCompact(rules);
+        const context = `[Claude Recall] Apply these rules from the user's memory:\n\n${body}\n\n` +
+            'Cite each rule at the point where it influences your action: (applied from memory: <rule>)';
+        // Structured output — CC reads additionalContext and injects it
+        console.log(JSON.stringify({
+            hookEventName: 'SubagentStart',
+            additionalContext: context,
+        }));
+        // User notification via stderr (stdout is structured hook output)
+        console.error(`🤖 Recall: ${totalRules} rules loaded for sub-agent (${agentType})`);
+        (0, shared_1.hookLog)('subagent', `SubagentStart: injected ${totalRules} rules for ${agentType} (${input?.agent_id ?? '?'})`);
+    }
+    catch (err) {
+        (0, shared_1.hookLog)('subagent', `SubagentStart error: ${(0, shared_1.safeErrorMessage)(err)}`);
+    }
+}
+/**
+ * SubagentStop — capture the sub-agent's outcome.
+ */
+async function handleSubagentStop(input) {
+    try {
+        const agentType = input?.agent_type ?? 'unknown';
+        const agentId = input?.agent_id ?? 'unknown';
+        const lastMessage = input?.last_assistant_message ?? '';
+        // Record outcome event
+        try {
+            const outcomeStorage = outcome_storage_1.OutcomeStorage.getInstance();
+            outcomeStorage.createOutcomeEvent({
+                event_type: 'subagent_result',
+                actor: 'tool',
+                action_summary: `Sub-agent (${agentType}) completed`,
+                next_state_summary: lastMessage.substring(0, 300) || 'No final message',
+                tags: ['agent', 'subagent', agentType],
+            });
+        }
+        catch {
+            // Non-critical
+        }
+        console.error(`🤖 Recall: sub-agent (${agentType}) outcome captured`);
+        (0, shared_1.hookLog)('subagent', `SubagentStop: captured outcome for ${agentType} (${agentId})`);
+    }
+    catch (err) {
+        (0, shared_1.hookLog)('subagent', `SubagentStop error: ${(0, shared_1.safeErrorMessage)(err)}`);
+    }
+}

package/package.json

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