claude-recall 0.20.11 → 0.20.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/skills/auto-corrections/SKILL.md +4 -1
- package/.claude/skills/auto-corrections/manifest.json +8 -5
- package/.claude/skills/auto-failure-lessons/SKILL.md +49 -1
- package/.claude/skills/auto-failure-lessons/manifest.json +50 -3
- package/.claude/skills/auto-preferences/SKILL.md +9 -6
- package/.claude/skills/auto-preferences/manifest.json +11 -8
- package/README.md +2 -2
- package/dist/hooks/correction-detector.js +2 -2
- package/dist/hooks/llm-classifier.js +2 -2
- package/dist/hooks/memory-stop-hook.js +2 -2
- package/dist/hooks/tool-outcome-watcher.js +4 -1
- package/dist/shared/event-processors.js +6 -3
- package/package.json +1 -1
|
@@ -8,14 +8,17 @@ source: claude-recall
|
|
|
8
8
|
|
|
9
9
|
# Corrections
|
|
10
10
|
|
|
11
|
-
Auto-generated from
|
|
11
|
+
Auto-generated from 7 memories. Last updated: 2026-04-06.
|
|
12
12
|
|
|
13
13
|
## Rules
|
|
14
14
|
|
|
15
15
|
- CORRECTION: Memory with complex metadata
|
|
16
|
+
- CORRECTION: Never delete claude-recall memories without asking the user first. Show what you plan to delete and get explicit approval before running delete_memory.
|
|
16
17
|
- CORRECTION: Memory with complex metadata
|
|
17
18
|
- CORRECTION: Memory with complex metadata
|
|
19
|
+
- CORRECTION: i just want you tellme what you observe claude recall has done lately
|
|
18
20
|
- CORRECTION: Use true agentic design where agents decide when to run, not cron jobs
|
|
21
|
+
- CORRECTION: delete without asking first
|
|
19
22
|
|
|
20
23
|
---
|
|
21
24
|
*Auto-generated by Claude Recall. Regenerate: `npx claude-recall skills generate`*
|
|
@@ -1,12 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"topicId": "corrections",
|
|
3
|
-
"sourceHash": "
|
|
4
|
-
"memoryCount":
|
|
5
|
-
"generatedAt": "2026-04-
|
|
3
|
+
"sourceHash": "c3bf72dbbe482ded411952a50d3c0d6bb04f7c0a8d8ee76c01992ed8f27c8fcd",
|
|
4
|
+
"memoryCount": 7,
|
|
5
|
+
"generatedAt": "2026-04-06T21:44:03.092Z",
|
|
6
6
|
"memoryKeys": [
|
|
7
|
+
"memory_1775511843079_fzzjymikj",
|
|
8
|
+
"memory_1775511566528_2zqlbeiyy",
|
|
7
9
|
"memory_1775500740471_dp5hmdxaf",
|
|
8
10
|
"memory_1775499328353_2ade6746o",
|
|
9
|
-
"
|
|
10
|
-
"hook_correction_1775498361284_9amjuw4le"
|
|
11
|
+
"hook_correction_1775511596163_oj20xa10q",
|
|
12
|
+
"hook_correction_1775498361284_9amjuw4le",
|
|
13
|
+
"hook_correction_1775511572913_yq1y9tvlo"
|
|
11
14
|
]
|
|
12
15
|
}
|
|
@@ -8,13 +8,34 @@ source: claude-recall
|
|
|
8
8
|
|
|
9
9
|
# Failure Lessons
|
|
10
10
|
|
|
11
|
-
Auto-generated from
|
|
11
|
+
Auto-generated from 87 memories. Last updated: 2026-04-06.
|
|
12
12
|
|
|
13
13
|
## Rules
|
|
14
14
|
|
|
15
15
|
- Check command syntax, file paths, and prerequisites before running
|
|
16
16
|
- Check inputs and prerequisites before retrying
|
|
17
|
+
- OpenClaw gateway websocket connection fails from root user context in sandbox; this is a known pairing regression. CLI cannot communicate with gateway from inside the container.
|
|
17
18
|
- SQLite query syntax error: LIKE clause requires single quotes around string literal, not double quotes
|
|
19
|
+
- Fault injection into mock-eiap/world-state.json on host will not be visible to sandbox agents until collect.sh runs and pushes updated signals.json into the sandbox. Verify data propagation by checking signals.json inside sandbox, not just host files.
|
|
20
|
+
- Session extraction prompt design flaw: fix pairing relies on string similarity between commands, but problem fixes often look structurally different from the failing command (e.g. bash script vs echo piped to bash); causes failure→fix patterns to not be recognized
|
|
21
|
+
- Missing shared tool files in sandbox caused SENTINEL's full chain to fail silently — always verify all tool dependencies (check-delta.js, post-comms.js, self-assess.js, update-run-state.js) are deployed before running agent cycles
|
|
22
|
+
- When collect.sh fails with 'EIAP endpoint unreachable' inside sandbox, check if EIAP_URL env var is set. If empty, the script should auto-detect sandbox environment and default to http://host.openshell.internal:8090 instead of localhost.
|
|
23
|
+
- Avoid: Command failed: git commit -m "$(cat <<'EOF'
|
|
24
|
+
Event-driven agent cascade + direct EIAP polling — two breakthroughs... → Instead: Check command syntax, file paths, and prerequisites before running
|
|
25
|
+
- Avoid: Command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- ls -la /sandbox/.op... → Instead: Check command syntax, file paths, and prerequisites before running
|
|
26
|
+
- Avoid: Command failed: cat /tmp/claude-1000/-home-ebiarao-repos-wsl-personal-projects-openclaw-autonomous-telco-agents/5... → Instead: Check command syntax, file paths, and prerequisites before running
|
|
27
|
+
- Avoid: Command failed: openshell sandbox list 2>/dev/null; curl -s http://localhost:3000/api/service-health 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
|
|
28
|
+
- When agent tasks complete but downstream verifications report missing output files, check if required shared tools were uploaded during sandbox initialization — re-push missing files with 'docker exec ... kubectl cp' rather than restarting the sandbox.
|
|
29
|
+
- Exit code 7 from Bash commands in this project context often indicates timing issues (services not fully up) or missing sandboxes during rebuild — retry after confirming 'openshell sandbox list' shows 'Ready' state.
|
|
30
|
+
- Background command 'Verify services and cron message' failed with exit code 7
|
|
31
|
+
- Background command 'Verify services and cron message' failed with exit code 7
|
|
32
|
+
- Avoid: Command failed: openshell status 2>/dev/null | head -5; openshell sandbox list 2>/dev/null → Instead: Check command syntax, file paths, and prerequisites before running
|
|
33
|
+
- SENTINEL verify task failed - collect.sh not running after rebuild (exit code 1)
|
|
34
|
+
- When tool outputs succeed but dependent processes don't trigger, check for stale state like file offsets — trigger-watcher set initial offset from old pre-rebuild state, causing it to miss new entries after rebuild+resync
|
|
35
|
+
- Avoid: Command failed: curl -s http://localhost:3000/api/service-health 2>&1; echo ""; docker exec openshell-cluster-nem... → Instead: Check command syntax, file paths, and prerequisites before running
|
|
36
|
+
- Avoid: Command failed: bash scripts/upgrade-sandbox.sh 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
|
|
37
|
+
- Avoid: Command failed: echo "Waiting 2 min for next SENTINEL cron tick to fire with delivery:silent..." && sleep 120 && ... → Instead: Check command syntax, file paths, and prerequisites before running
|
|
38
|
+
- Avoid: Command failed: kill $(pgrep -f "trigger-watcher.js") 2>/dev/null; sleep 1; rm -f artifacts/.trigger-watcher-offs... → Instead: Check command syntax, file paths, and prerequisites before running
|
|
18
39
|
- 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.
|
|
19
40
|
- 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
|
|
20
41
|
- Avoid: Command failed: ls artifacts/urgent-trigger-ORACLE.json 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
|
|
@@ -29,6 +50,29 @@ Auto-generated from 40 memories. Last updated: 2026-04-06.
|
|
|
29
50
|
- Avoid: Command failed: npx jest tests/unit/failure-detectors.test.ts 2>&1 → Instead: Check command syntax, file paths, and prerequisites before running
|
|
30
51
|
- SQLite query error: LIKE clause needs proper string literal syntax with single quotes in better-sqlite3
|
|
31
52
|
- Node.js syntax error: multiline strings in -e flag not properly escaped; newlines break the command parsing
|
|
53
|
+
- {"what_failed":"Bash command failed: git commit -m \"$(cat <<'EOF'\nEvent-driven agent cascade + direct EIAP polling — two breakthroughs...","why_failed":"Exit code 128\nerror: gpg failed to sign the data:\n[GNUPG:] KEY_CONSIDERED F3CE7255442A2E7886375262B810E846921AD84F 2\n[GNUPG:] BEGIN_SIGNING H10\n[GNUPG:] USERID_HINT B810E846921AD84F Raoul Biagioni ...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 128\nerror: gpg failed to sign the data:\n[GNUPG:] KEY_CONSIDERED F3CE7255442A2E7886375262B810E846921AD84F 2\n[GNUPG:] BEGIN_SIGNING H10\n[GNUPG:] USERID_HINT B810E846921AD84F Raoul Biagioni ...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
54
|
+
- {"what_failed":"Bash command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- ls -la /sandbox/.op...","why_failed":"Exit code 1\nfile missing","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\nfile missing","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
55
|
+
- {"what_failed":"Bash command failed: cat /tmp/claude-1000/-home-ebiarao-repos-wsl-personal-projects-openclaw-autonomous-telco-agents/5...","why_failed":"Exit code 7\n\u001b[1mNAME \u001b[0m \u001b[1mNAMESPACE\u001b[0m \u001b[1mCREATED \u001b[0m \u001b[1mPHASE\u001b[0m\nnka-telco openshell 2026-04-06 21:16:26 \u001b[32mReady\u001b[39m\n\u001b[1mNAME \u001b[0m \u001b[1mNAMESPACE\u001b[0m \u001b[1mCRE...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 7\n\u001b[1mNAME \u001b[0m \u001b[1mNAMESPACE\u001b[0m \u001b[1mCREATED \u001b[0m \u001b[1mPHASE\u001b[0m\nnka-telco openshell 2026-04-06 21:16:26 \u001b[32mReady\u001b[39m\n\u001b[1mNAME \u001b[0m \u001b[1mNAMESPACE\u001b[0m \u001b[1mCRE...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
56
|
+
- {"what_failed":"Bash command failed: openshell sandbox list 2>/dev/null; curl -s http://localhost:3000/api/service-health 2>&1","why_failed":"Exit code 7\nNo sandboxes found.","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 7\nNo sandboxes found.","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
57
|
+
- {"what_failed":"Bash command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- bash -c 'echo $EIAP...","why_failed":"Exit code 1\n\n---\n[collect] fetching EIAP endpoints at 2026-04-06T20:58:54Z\ncommand terminated with exit code 1","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\n\n---\n[collect] fetching EIAP endpoints at 2026-04-06T20:58:54Z\ncommand terminated with exit code 1","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
58
|
+
- {"what_failed":"Bash command failed: openshell status 2>/dev/null | head -5; openshell sandbox list 2>/dev/null","why_failed":"Exit code 1\n\u001b[1m\u001b[36mGateway Status\u001b[39m\u001b[0m\n\n \u001b[2mStatus:\u001b[0m No gateway configured.\n\nDeploy a gateway with: \u001b[2mopenshell gateway start\u001b[0m","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\n\u001b[1m\u001b[36mGateway Status\u001b[39m\u001b[0m\n\n \u001b[2mStatus:\u001b[0m No gateway configured.\n\nDeploy a gateway with: \u001b[2mopenshell gateway start\u001b[0m","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
59
|
+
- {"what_failed":"Read failed","why_failed":"File content (12314 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 (12314 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"]}
|
|
60
|
+
- {"what_failed":"Bash command failed: B64=$(base64 -w0 < agents/shared/tools/post-comms.js) && ssh -q -o StrictHostKeyChecking=no -o Us...","why_failed":"Exit code 1","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
61
|
+
- {"what_failed":"Read failed","why_failed":"File does not exist. Note: your current working directory is /home/ebiarao/repos-wsl/personal-projects/openclaw-autonomous-telco-agents.","what_should_do":"Check inputs and prerequisites before retrying","context":"Error: File does not exist. Note: your current working directory is /home/ebiarao/repos-wsl/personal-projects/openclaw-autonomous-telco-agents.","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
62
|
+
- {"what_failed":"Bash command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- tail -10 /sandbox/....","why_failed":"Exit code 1\nTraceback (most recent call last):\n File \"<string>\", line 6, in <module>\n d=json.loads(line)\n File \"/home/ebiarao/miniconda3/lib/python3.13/json/__init__.py\", line 346, in loads\n ...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\nTraceback (most recent call last):\n File \"<string>\", line 6, in <module>\n d=json.loads(line)\n File \"/home/ebiarao/miniconda3/lib/python3.13/json/__init__.py\", line 346, in loads\n ...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
63
|
+
- {"what_failed":"Bash command failed: pgrep -af trigger-watcher; echo \"---\"; cat artifacts/trigger-log.jsonl 2>/dev/null || echo \"no tr...","why_failed":"Exit code 1\n3180787 node /home/ebiarao/repos-wsl/personal-projects/openclaw-autonomous-telco-agents/scripts/trigger-watcher.js\n3233721 /bin/bash -c source /home/ebiarao/.claude/shell-snapshots/snap...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\n3180787 node /home/ebiarao/repos-wsl/personal-projects/openclaw-autonomous-telco-agents/scripts/trigger-watcher.js\n3233721 /bin/bash -c source /home/ebiarao/.claude/shell-snapshots/snap...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
64
|
+
- {"what_failed":"Bash command failed: cat artifacts/trigger-log.jsonl 2>/dev/null || echo \"(no triggers yet)\"; echo \"===\"; tail -5 arti...","why_failed":"Exit code 1\n(no triggers yet)\n===","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\n(no triggers yet)\n===","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
65
|
+
- {"what_failed":"Bash command failed: pwd; ls agents/nka/scripts/collect.sh 2>/dev/null","why_failed":"Exit code 2\n/home/ebiarao/repos-wsl/personal-projects/openclaw-autonomous-telco-agents/webui/client","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 2\n/home/ebiarao/repos-wsl/personal-projects/openclaw-autonomous-telco-agents/webui/client","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
66
|
+
- {"what_failed":"Bash command failed: ls artifacts/ 2>/dev/null; mkdir -p artifacts && EIAP_URL=http://127.0.0.1:8090 bash agents/nka/s...","why_failed":"Exit code 127\nbash: agents/nka/scripts/collect.sh: No such file or directory","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 127\nbash: agents/nka/scripts/collect.sh: No such file or directory","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
67
|
+
- {"what_failed":"Bash command failed: cat artifacts/state.json","why_failed":"Exit code 1\ncat: artifacts/state.json: No such file or directory","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\ncat: artifacts/state.json: No such file or directory","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
68
|
+
- {"what_failed":"Bash command failed: sleep 3 && curl -s http://localhost:3000/api/service-health","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"]}
|
|
69
|
+
- {"what_failed":"Bash command failed: cd /home/ebiarao/repos-wsl/personal-projects/openclaw-autonomous-telco-agents && kill $(pgrep -f ...","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"]}
|
|
70
|
+
- {"what_failed":"Bash command failed: node -e \"\nconst fs = require('fs');\nconst wsFile = 'mock-eiap/world/world-state.json';\nconst ws =...","why_failed":"Exit code 1\nnode:fs:449\n return binding.readFileUtf8(path, stringToFlags(options.flag));\n ^\n\nError: ENOENT: no such file or directory, open 'mock-eiap/world/world-state.json'\n ...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\nnode:fs:449\n return binding.readFileUtf8(path, stringToFlags(options.flag));\n ^\n\nError: ENOENT: no such file or directory, open 'mock-eiap/world/world-state.json'\n ...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
71
|
+
- {"what_failed":"Bash command failed: curl -s http://localhost:3000/api/service-health 2>&1; echo \"\"; docker exec openshell-cluster-nem...","why_failed":"Exit code 1\n{\"eiap\":true,\"dataStale\":false,\"signalsAge\":3,\"checkedAt\":\"2026-04-06T18:54:08.040Z\"}\nTraceback (most recent call last):\n File \"<string>\", line 6, in <module>\n print(f\"{j['name']:12...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\n{\"eiap\":true,\"dataStale\":false,\"signalsAge\":3,\"checkedAt\":\"2026-04-06T18:54:08.040Z\"}\nTraceback (most recent call last):\n File \"<string>\", line 6, in <module>\n print(f\"{j['name']:12...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
72
|
+
- {"what_failed":"Bash command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- bash -c 'openclaw c...","why_failed":"Exit code 1\nError: gateway closed (1006 abnormal closure (no close frame)): no close reason\nGateway target: ws://127.0.0.1:18789\nSource: local loopback\nConfig: /root/.openclaw/openclaw.json\nBind: l...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\nError: gateway closed (1006 abnormal closure (no close frame)): no close reason\nGateway target: ws://127.0.0.1:18789\nSource: local loopback\nConfig: /root/.openclaw/openclaw.json\nBind: l...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
73
|
+
- {"what_failed":"Bash command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- bash -c 'ps aux | g...","why_failed":"Exit code 1\nbash: line 1: ps: command not found\ncommand terminated with exit code 1","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\nbash: line 1: ps: command not found\ncommand terminated with exit code 1","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
74
|
+
- {"what_failed":"Bash command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- bash -c 'openclaw c...","why_failed":"Exit code 1\nError: gateway closed (1006 abnormal closure (no close frame)): no close reason\nGateway target: ws://127.0.0.1:18789\nSource: local loopback\nConfig: /root/.openclaw/openclaw.json\nBind: l...","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\nError: gateway closed (1006 abnormal closure (no close frame)): no close reason\nGateway target: ws://127.0.0.1:18789\nSource: local loopback\nConfig: /root/.openclaw/openclaw.json\nBind: l...","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
75
|
+
- {"what_failed":"Bash command failed: docker exec openshell-cluster-nemoclaw kubectl exec -n openshell nka-telco -- bash -c 'openclaw c...","why_failed":"Exit code 1\ncommand terminated with exit code 1","what_should_do":"Check inputs and prerequisites before retrying","context":"Bash error: Exit code 1\ncommand terminated with exit code 1","preventative_checks":["Verify tool inputs are correct","Check preconditions"]}
|
|
32
76
|
- 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
|
|
33
77
|
- {"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"]}
|
|
34
78
|
- {"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"]}
|
|
@@ -47,10 +91,14 @@ Auto-generated from 40 memories. Last updated: 2026-04-06.
|
|
|
47
91
|
- {"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"]}
|
|
48
92
|
- 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
|
|
49
93
|
- Node.js -e flag cannot parse multiline strings with unescaped newlines in single quotes
|
|
94
|
+
- Grep with escaped quotes (pattern="SESSION_EXTRACTION_PROMPT\"") returns no matches — use unescaped pattern="SESSION_EXTRACTION_PROMPT" instead
|
|
95
|
+
- Gateway token mismatch error — requires verifying token in Control UI settings via dashboard URL
|
|
50
96
|
- claude-recall reconnection failed after reinstall
|
|
51
97
|
- claude-recall reconnection failed after reinstall attempt
|
|
52
98
|
- Output is showing '>' instead of expected response
|
|
53
99
|
- Code output returns '>' instead of expected response
|
|
100
|
+
- Background command 'Wait one more SENTINEL cycle' failed with exit code 1
|
|
101
|
+
- Avoid: Claude backtracked: "Let me try another" → Instead: Consider the problem more carefully before starting. Check for similar past failures.
|
|
54
102
|
- Avoid: Claude backtracked: "let me try a different approach" → Instead: Consider the problem more carefully before starting. Check for similar past failures.
|
|
55
103
|
|
|
56
104
|
---
|
|
@@ -1,12 +1,32 @@
|
|
|
1
1
|
{
|
|
2
2
|
"topicId": "failure-lessons",
|
|
3
|
-
"sourceHash": "
|
|
4
|
-
"memoryCount":
|
|
5
|
-
"generatedAt": "2026-04-
|
|
3
|
+
"sourceHash": "0a433bc57da8ed5c3137f8676cae1ec253e4a5037b115400d0e0c9e394789440",
|
|
4
|
+
"memoryCount": 87,
|
|
5
|
+
"generatedAt": "2026-04-06T21:44:03.038Z",
|
|
6
6
|
"memoryKeys": [
|
|
7
7
|
"promoted_1775498319002_awwrsovw6",
|
|
8
8
|
"promoted_1775499579486_bxvgjc80r",
|
|
9
|
+
"hook_failure_1775502039213_k4yusuan1",
|
|
9
10
|
"hook_failure_1772637584921_0tj4rrxnt",
|
|
11
|
+
"hook_failure_1775503464385_vz5vdzxvs",
|
|
12
|
+
"hook_failure_1775500959351_j74owpvko",
|
|
13
|
+
"hook_failure_1775511109813_ly4cjtde6",
|
|
14
|
+
"hook_failure_1775509498191_f79imbrs4",
|
|
15
|
+
"hook_failure_non-zero-exit_1775511575363_nen5eyl3b",
|
|
16
|
+
"hook_failure_non-zero-exit_1775510785418_2xm52g5q8",
|
|
17
|
+
"hook_failure_non-zero-exit_1775510309712_olv4egt1g",
|
|
18
|
+
"hook_failure_non-zero-exit_1775510309694_1cipsasft",
|
|
19
|
+
"hook_failure_1775510785331_kxr1uoozx",
|
|
20
|
+
"hook_failure_1775510309605_z58f30w5t",
|
|
21
|
+
"hook_failure_1775510305548_qq8hdyk12",
|
|
22
|
+
"hook_failure_1775510298887_aoeh4m2cl",
|
|
23
|
+
"hook_failure_non-zero-exit_1775508193513_ms20rhkf1",
|
|
24
|
+
"hook_failure_1775509104206_lg9fvtipb",
|
|
25
|
+
"hook_failure_1775504451387_fmycaea7m",
|
|
26
|
+
"hook_failure_non-zero-exit_1775503134951_mq2x1hj77",
|
|
27
|
+
"hook_failure_non-zero-exit_1775502651250_4ah16usm4",
|
|
28
|
+
"hook_failure_non-zero-exit_1775502651238_l0c5dkykp",
|
|
29
|
+
"hook_failure_non-zero-exit_1775501919378_s3j17tkr3",
|
|
10
30
|
"hook_failure_1775500665745_zl6zsp7jw",
|
|
11
31
|
"hook_failure_non-zero-exit_1775499579462_n5xb6rr8r",
|
|
12
32
|
"hook_failure_non-zero-exit_1775499579440_2tv110hs9",
|
|
@@ -21,6 +41,29 @@
|
|
|
21
41
|
"hook_failure_non-zero-exit_1772640279977_g3gwlfoqi",
|
|
22
42
|
"hook_failure_1772637570984_yxs8zmurp",
|
|
23
43
|
"hook_failure_1772637485532_djep8eysa",
|
|
44
|
+
"hook_failure_1775511332509_3mxf5vtg3",
|
|
45
|
+
"hook_failure_1775510710817_sn23160zp",
|
|
46
|
+
"hook_failure_1775510222535_o2t7vm7qp",
|
|
47
|
+
"hook_failure_1775510141049_oo7v7htpv",
|
|
48
|
+
"hook_failure_1775509134627_wu9wz6w1p",
|
|
49
|
+
"hook_failure_1775508183011_gy3nzxwiy",
|
|
50
|
+
"hook_failure_1775505258754_l50o6be33",
|
|
51
|
+
"hook_failure_1775503921254_zyjka5vj9",
|
|
52
|
+
"hook_failure_1775503659141_1fh62brao",
|
|
53
|
+
"hook_failure_1775503198240_qzmm07ves",
|
|
54
|
+
"hook_failure_1775503190006_k5mdxukzl",
|
|
55
|
+
"hook_failure_1775503183507_rs20xzomb",
|
|
56
|
+
"hook_failure_1775503035650_efta0k28k",
|
|
57
|
+
"hook_failure_1775503031427_e9070twhb",
|
|
58
|
+
"hook_failure_1775503009947_ea2euap40",
|
|
59
|
+
"hook_failure_1775502961298_snolsqnu9",
|
|
60
|
+
"hook_failure_1775502951488_hyvabjgp1",
|
|
61
|
+
"hook_failure_1775502809370_icsa9nxsy",
|
|
62
|
+
"hook_failure_1775501648406_78lsvrrb1",
|
|
63
|
+
"hook_failure_1775501136927_v2zesbrwh",
|
|
64
|
+
"hook_failure_1775501122267_ejvqdr0id",
|
|
65
|
+
"hook_failure_1775501085124_c92qa38u7",
|
|
66
|
+
"hook_failure_1775501078345_pryhog20w",
|
|
24
67
|
"hook_failure_1775500618695_6grbwpm3t",
|
|
25
68
|
"hook_failure_1775500273633_yrw798ahh",
|
|
26
69
|
"hook_failure_1775500125145_ad65bw8rs",
|
|
@@ -39,10 +82,14 @@
|
|
|
39
82
|
"hook_failure_1775498542480_wc23ux8gt",
|
|
40
83
|
"hook_failure_silent-test-failure_1772640279996_m8f3ks8fw",
|
|
41
84
|
"hook_failure_1772637495154_i21dho3dv",
|
|
85
|
+
"hook_failure_1775511713477_psti3hr7y",
|
|
86
|
+
"hook_failure_1775502085189_pnbd0kkg1",
|
|
42
87
|
"hook_failure_1773410663873_oegccxk83",
|
|
43
88
|
"hook_failure_1773410656672_kno1aw8wf",
|
|
44
89
|
"hook_failure_1772637391602_cjj3esg33",
|
|
45
90
|
"hook_failure_1772637376157_hvco6jbm4",
|
|
91
|
+
"hook_failure_1775509857057_847nm61ld",
|
|
92
|
+
"hook_failure_backtracking_1775508193524_54wn8o688",
|
|
46
93
|
"hook_failure_backtracking_1772640280006_snb0x5cgg"
|
|
47
94
|
]
|
|
48
95
|
}
|
|
@@ -8,10 +8,15 @@ source: claude-recall
|
|
|
8
8
|
|
|
9
9
|
# Preferences
|
|
10
10
|
|
|
11
|
-
Auto-generated from
|
|
11
|
+
Auto-generated from 23 memories. Last updated: 2026-04-06.
|
|
12
12
|
|
|
13
13
|
## Rules
|
|
14
14
|
|
|
15
|
+
- Session test preference 1775511843229
|
|
16
|
+
- Test preference 1775511843109-2
|
|
17
|
+
- Test preference 1775511843109-1
|
|
18
|
+
- Test preference 1775511843109-0
|
|
19
|
+
- Test memory content
|
|
15
20
|
- Session test preference 1775500740595
|
|
16
21
|
- Test preference 1775500740495-2
|
|
17
22
|
- Test preference 1775500740495-1
|
|
@@ -23,14 +28,12 @@ Auto-generated from 20 memories. Last updated: 2026-04-06.
|
|
|
23
28
|
- Test preference 1775499328384-0
|
|
24
29
|
- Test memory content
|
|
25
30
|
- Session test preference 1775496241643
|
|
26
|
-
- Test preference 1775496241514-2
|
|
27
|
-
- Test preference 1775496241514-1
|
|
28
|
-
- Test preference 1775496241514-0
|
|
29
|
-
- Test memory content
|
|
30
|
-
- Session test preference 1775494279149
|
|
31
31
|
- After each refactoring, document the changes made. Don't batch documentation to the end — write it as you go.
|
|
32
32
|
- 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.
|
|
33
33
|
- 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.
|
|
34
|
+
- Always ask before deleting anything
|
|
35
|
+
- When user questions the scope or complexity of a solution mid-session, pause and clarify the reusable abstractions extracted from the implementation. Identify generalizable patterns (e.g., trigger-watcher, signal-based coordination) that justify the engineering effort beyond the immediate use case.
|
|
36
|
+
- When discovering architectural issues, create comprehensive documentation immediately (host/sandbox duality) and add redesign work to TODO list for later iteration.
|
|
34
37
|
- For agentic design, agents should decide when to run rather than using cron jobs for scheduling
|
|
35
38
|
|
|
36
39
|
---
|
|
@@ -1,9 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"topicId": "preferences",
|
|
3
|
-
"sourceHash": "
|
|
4
|
-
"memoryCount":
|
|
5
|
-
"generatedAt": "2026-04-
|
|
3
|
+
"sourceHash": "819c9fa966f5ffabe7b065fa6290958f1601072fb16e47d162bd513228ec08d5",
|
|
4
|
+
"memoryCount": 23,
|
|
5
|
+
"generatedAt": "2026-04-06T21:44:03.259Z",
|
|
6
6
|
"memoryKeys": [
|
|
7
|
+
"memory_1775511843231_at7wjj6kf",
|
|
8
|
+
"memory_1775511843181_7ruo2iof1",
|
|
9
|
+
"memory_1775511843150_vdcha6qwp",
|
|
10
|
+
"memory_1775511843112_mmaq6zmrn",
|
|
11
|
+
"memory_1775511842984_cn67mk6m3",
|
|
7
12
|
"memory_1775500740596_xok3iey9j",
|
|
8
13
|
"memory_1775500740545_op5713e5i",
|
|
9
14
|
"memory_1775500740519_ln1fd8ow4",
|
|
@@ -15,14 +20,12 @@
|
|
|
15
20
|
"memory_1775499328386_dqcav3itu",
|
|
16
21
|
"memory_1775499328258_cilhe1owj",
|
|
17
22
|
"memory_1775496241645_xtz7cwan4",
|
|
18
|
-
"memory_1775496241576_j7sxxuge3",
|
|
19
|
-
"memory_1775496241542_rg3hj24ud",
|
|
20
|
-
"memory_1775496241516_y3inz8rlf",
|
|
21
|
-
"memory_1775496241411_vwdz6igrm",
|
|
22
|
-
"memory_1775494279150_n4pq7zy11",
|
|
23
23
|
"memory_1775208934902_2kovciriy",
|
|
24
24
|
"memory_1775208477621_fqa3w21j1",
|
|
25
25
|
"memory_1775168901303_o8o0i4952",
|
|
26
|
+
"hook_preference_1775511561137_rjm92h4o3",
|
|
27
|
+
"hook_preference_1775508193449_aphyh28z9",
|
|
28
|
+
"hook_preference_1775503672864_weqgjstda",
|
|
26
29
|
"hook_preference_1775498374200_6d21qj14y"
|
|
27
30
|
]
|
|
28
31
|
}
|
package/README.md
CHANGED
|
@@ -84,11 +84,11 @@ Once installed, Claude Recall works automatically in the background:
|
|
|
84
84
|
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
|
|
85
85
|
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
|
|
86
86
|
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
|
|
87
|
-
4. **End of session** — session episodes are created, candidate lessons extracted from failures, and a promotion cycle graduates validated patterns into active rules. A session extraction pass sends the last 50 transcript entries to Haiku to
|
|
87
|
+
4. **End of session** — session episodes are created, candidate lessons extracted from failures, and a promotion cycle graduates validated patterns into active rules. A session extraction pass sends the last 50 transcript entries to Haiku to identify cause-and-effect patterns: what failed, why, and what fixed it
|
|
88
88
|
5. **Reask detection** — frustration signals ("still broken", "that didn't work") are recorded as outcome events
|
|
89
89
|
6. **Before context compression** — aggressive memory sweep captures important context before the window shrinks
|
|
90
90
|
7. **After context compression** (Claude Code only) — rules are automatically re-injected into context so they're not lost when the window shrinks
|
|
91
|
-
8. **
|
|
91
|
+
8. **Sub-agent recall** (Claude Code only) — when sub-agents are spawned, active rules are injected into their context automatically. Sub-agent outcomes (completed/failed/killed) are captured as events
|
|
92
92
|
9. **Rules sync** (Claude Code only) — top 30 rules are exported as typed `.md` files to Claude Code's native memory directory
|
|
93
93
|
|
|
94
94
|
Classification uses Claude Haiku (via `ANTHROPIC_API_KEY`) with silent regex fallback. No configuration needed.
|
|
@@ -48,8 +48,8 @@ async function handleCorrectionDetector(input) {
|
|
|
48
48
|
// Reject short/garbage extracts and raw dumps (not clean rules)
|
|
49
49
|
if (result.extract.length < 10 || result.extract.length > 200)
|
|
50
50
|
return;
|
|
51
|
-
// Corrections and
|
|
52
|
-
if ((result.type === 'correction' || result.type === 'preference') && result.confidence < 0.
|
|
51
|
+
// Corrections, preferences, and devops need high confidence to prevent noise
|
|
52
|
+
if ((result.type === 'correction' || result.type === 'preference' || result.type === 'devops') && result.confidence < 0.75)
|
|
53
53
|
return;
|
|
54
54
|
if (result.confidence < 0.6)
|
|
55
55
|
return;
|
|
@@ -18,7 +18,7 @@ const SYSTEM_PROMPT = `You are a memory classifier for a developer tool. Classif
|
|
|
18
18
|
- correction: User correcting a mistake ("no, use X not Y", "wrong, it should be...")
|
|
19
19
|
- preference: User stating a clear, reusable directive about how they want things done going forward ("we use tabs", "always use TypeScript", "I prefer X"). Must be a rule that applies beyond this conversation. NOT observations, complaints, questions, debugging statements, or one-off instructions like "fix this" or "tell me about X"
|
|
20
20
|
- failure: Something broke or failed ("build failed", "error in deployment")
|
|
21
|
-
- devops: CI/CD, deployment, Docker, git workflow patterns
|
|
21
|
+
- devops: CI/CD, deployment, Docker, git workflow patterns. ONLY durable rules — not transient operational events like "sandbox rebuilt" or "background task exited"
|
|
22
22
|
- project-knowledge: Architecture, stack, database, API patterns
|
|
23
23
|
- none: Casual conversation, questions, code snippets, or anything not worth remembering
|
|
24
24
|
|
|
@@ -39,7 +39,7 @@ const BATCH_SYSTEM_PROMPT = `You are a memory classifier for a developer tool. Y
|
|
|
39
39
|
- correction: User correcting a mistake ("no, use X not Y", "wrong, it should be...")
|
|
40
40
|
- preference: User stating a clear, reusable directive about how they want things done going forward ("we use tabs", "always use TypeScript", "I prefer X"). Must be a rule that applies beyond this conversation. NOT observations, complaints, questions, debugging statements, or one-off instructions like "fix this" or "tell me about X"
|
|
41
41
|
- failure: Something broke or failed ("build failed", "error in deployment")
|
|
42
|
-
- devops: CI/CD, deployment, Docker, git workflow patterns
|
|
42
|
+
- devops: CI/CD, deployment, Docker, git workflow patterns. ONLY durable rules — not transient operational events like "sandbox rebuilt" or "background task exited"
|
|
43
43
|
- project-knowledge: Architecture, stack, database, API patterns
|
|
44
44
|
- none: Casual conversation, questions, code snippets, or anything not worth remembering
|
|
45
45
|
|
|
@@ -94,8 +94,8 @@ async function handleMemoryStop(input) {
|
|
|
94
94
|
// Reject extracts that are too short or too long (not clean rules)
|
|
95
95
|
if (result.extract.length < 10 || result.extract.length > 200)
|
|
96
96
|
continue;
|
|
97
|
-
// Corrections and
|
|
98
|
-
if ((result.type === 'correction' || result.type === 'preference') && result.confidence < 0.
|
|
97
|
+
// Corrections, preferences, and devops need higher confidence to prevent noise
|
|
98
|
+
if ((result.type === 'correction' || result.type === 'preference' || result.type === 'devops') && result.confidence < 0.75)
|
|
99
99
|
continue;
|
|
100
100
|
if (result.confidence < 0.6)
|
|
101
101
|
continue;
|
|
@@ -235,7 +235,10 @@ async function handleBashFailure(command, exitCode, output, sessionId) {
|
|
|
235
235
|
const memoryService = memory_1.MemoryService.getInstance();
|
|
236
236
|
memoryService.store({
|
|
237
237
|
key,
|
|
238
|
-
value:
|
|
238
|
+
value: {
|
|
239
|
+
content: `${failureContent.what_failed}. ${failureContent.why_failed}`,
|
|
240
|
+
...failureContent,
|
|
241
|
+
},
|
|
239
242
|
type: 'failure',
|
|
240
243
|
context: { timestamp: Date.now() },
|
|
241
244
|
relevanceScore: 0.85,
|
|
@@ -206,7 +206,10 @@ function storeToolFailure(toolName, toolInput, output, sessionId) {
|
|
|
206
206
|
const key = `hook_failure_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
|
|
207
207
|
memory_1.MemoryService.getInstance().store({
|
|
208
208
|
key,
|
|
209
|
-
value:
|
|
209
|
+
value: {
|
|
210
|
+
content: `${failureContent.what_failed}. ${failureContent.why_failed}`,
|
|
211
|
+
...failureContent,
|
|
212
|
+
},
|
|
210
213
|
type: 'failure',
|
|
211
214
|
context: { timestamp: Date.now() },
|
|
212
215
|
relevanceScore: 0.75,
|
|
@@ -278,7 +281,7 @@ async function processUserInput(text, sessionId) {
|
|
|
278
281
|
return null;
|
|
279
282
|
if (result.extract.length < 10 || result.extract.length > 200)
|
|
280
283
|
return null;
|
|
281
|
-
if ((result.type === 'correction' || result.type === 'preference') && result.confidence < 0.
|
|
284
|
+
if ((result.type === 'correction' || result.type === 'preference' || result.type === 'devops') && result.confidence < 0.75)
|
|
282
285
|
return null;
|
|
283
286
|
if (result.confidence < 0.6)
|
|
284
287
|
return null;
|
|
@@ -325,7 +328,7 @@ async function processSessionEnd(userTexts, sessionId, projectId, maxStore = 3)
|
|
|
325
328
|
continue;
|
|
326
329
|
if (result.extract.length < 10 || result.extract.length > 200)
|
|
327
330
|
continue;
|
|
328
|
-
if ((result.type === 'correction' || result.type === 'preference') && result.confidence < 0.
|
|
331
|
+
if ((result.type === 'correction' || result.type === 'preference' || result.type === 'devops') && result.confidence < 0.75)
|
|
329
332
|
continue;
|
|
330
333
|
if (result.confidence < 0.6)
|
|
331
334
|
continue;
|
package/package.json
CHANGED