clawmem 0.1.4 → 0.1.6
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/AGENTS.md +7 -5
- package/CLAUDE.md +7 -5
- package/README.md +9 -2
- package/SKILL.md +8 -5
- package/package.json +1 -1
- package/src/watcher.ts +4 -1
package/AGENTS.md
CHANGED
|
@@ -630,11 +630,13 @@ Symptom: CLI reindex/update falls back to node-llama-cpp Vulkan (not GPU server)
|
|
|
630
630
|
|
|
631
631
|
Symptom: "UserPromptSubmit hook error" on context-surfacing hook (intermittent)
|
|
632
632
|
→ SQLite contention between the watcher and the hook. The watcher processes filesystem events
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
633
|
+
and holds brief write locks. If the hook fires during a lock, it can exceed its timeout.
|
|
634
|
+
More likely during active conversations with frequent file changes.
|
|
635
|
+
→ v0.1.6 fix: watcher no longer processes session transcript .jsonl files (only .beads/*.jsonl),
|
|
636
|
+
eliminating the most common source of contention.
|
|
637
|
+
→ Default hook timeout is 8s (since v0.1.1). If you have an older install, re-run
|
|
638
|
+
`clawmem setup hooks`. If persistent, restart the watcher: `systemctl --user restart
|
|
639
|
+
clawmem-watcher.service`. Healthy memory is under 100MB — if 400MB+, restart clears it.
|
|
638
640
|
```
|
|
639
641
|
|
|
640
642
|
## CLI Reference
|
package/CLAUDE.md
CHANGED
|
@@ -630,11 +630,13 @@ Symptom: CLI reindex/update falls back to node-llama-cpp Vulkan (not GPU server)
|
|
|
630
630
|
|
|
631
631
|
Symptom: "UserPromptSubmit hook error" on context-surfacing hook (intermittent)
|
|
632
632
|
→ SQLite contention between the watcher and the hook. The watcher processes filesystem events
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
633
|
+
and holds brief write locks. If the hook fires during a lock, it can exceed its timeout.
|
|
634
|
+
More likely during active conversations with frequent file changes.
|
|
635
|
+
→ v0.1.6 fix: watcher no longer processes session transcript .jsonl files (only .beads/*.jsonl),
|
|
636
|
+
eliminating the most common source of contention.
|
|
637
|
+
→ Default hook timeout is 8s (since v0.1.1). If you have an older install, re-run
|
|
638
|
+
`clawmem setup hooks`. If persistent, restart the watcher: `systemctl --user restart
|
|
639
|
+
clawmem-watcher.service`. Healthy memory is under 100MB — if 400MB+, restart clears it.
|
|
638
640
|
```
|
|
639
641
|
|
|
640
642
|
## CLI Reference
|
package/README.md
CHANGED
|
@@ -606,7 +606,7 @@ clawmem doctor Full health check
|
|
|
606
606
|
clawmem status Quick index status
|
|
607
607
|
```
|
|
608
608
|
|
|
609
|
-
## MCP Tools (
|
|
609
|
+
## MCP Tools (28)
|
|
610
610
|
|
|
611
611
|
Registered by `clawmem setup mcp`. Available to any MCP-compatible client.
|
|
612
612
|
|
|
@@ -652,6 +652,13 @@ Registered by `clawmem setup mcp`. Available to any MCP-compatible client.
|
|
|
652
652
|
|---|---|
|
|
653
653
|
| `beads_sync` | Sync Beads issues from Dolt backend (`bd` CLI) into memory: creates docs, bridges all dep types to `memory_relations`, runs A-MEM enrichment |
|
|
654
654
|
|
|
655
|
+
### Vault Management
|
|
656
|
+
|
|
657
|
+
| Tool | Description |
|
|
658
|
+
|---|---|
|
|
659
|
+
| `list_vaults` | Show configured vault names and paths. Empty in single-vault mode. |
|
|
660
|
+
| `vault_sync` | Index markdown from a directory into a named vault. Restricted-path validation rejects sensitive directories. |
|
|
661
|
+
|
|
655
662
|
### Memory Management & Lifecycle
|
|
656
663
|
|
|
657
664
|
| Tool | Description |
|
|
@@ -998,7 +1005,7 @@ Manual layers benefit from periodic re-indexing — a cron job running `clawmem
|
|
|
998
1005
|
|
|
999
1006
|
Three-tier retrieval architecture: infrastructure (watcher + embed timer) → hooks (~90%) → agent MCP (~10%). Works out of the box without a dedicated GPU (all models auto-download via `node-llama-cpp`, uses Metal on Apple Silicon). For best performance, run three `llama-server` instances — see [GPU Services](#gpu-services) for model tiers (SOTA vs QMD native) and [Cloud Embedding](#option-c-cloud-embedding-api) for cloud embedding alternatives.
|
|
1000
1007
|
|
|
1001
|
-
Key services: `clawmem-watcher` (auto-index on file change + beads sync), `clawmem-embed` timer (daily embedding sweep),
|
|
1008
|
+
Key services: `clawmem-watcher` (auto-index on file change + beads sync), `clawmem-embed` timer (daily embedding sweep), 7 Claude Code hooks installed by default (context injection, curator nudge, compaction support, decision extraction, handoffs, feedback). Optional `clawmem-curator` agent for on-demand lifecycle triage, retrieval health checks, and maintenance (`clawmem setup curator`).
|
|
1002
1009
|
|
|
1003
1010
|
## Acknowledgments
|
|
1004
1011
|
|
package/SKILL.md
CHANGED
|
@@ -634,11 +634,14 @@ Symptom: CLI reindex/update falls back to node-llama-cpp
|
|
|
634
634
|
-> Fixed: bin/clawmem wrapper exports CLAWMEM_EMBED_URL/LLM_URL/RERANK_URL defaults.
|
|
635
635
|
|
|
636
636
|
Symptom: "UserPromptSubmit hook error" on context-surfacing hook (intermittent)
|
|
637
|
-
-> SQLite contention between watcher and hook. Watcher processes filesystem events
|
|
638
|
-
|
|
639
|
-
during
|
|
640
|
-
->
|
|
641
|
-
the
|
|
637
|
+
-> SQLite contention between watcher and hook. Watcher processes filesystem events and holds
|
|
638
|
+
brief write locks. If the hook fires during a lock, it can exceed its timeout. More likely
|
|
639
|
+
during active conversations with frequent file changes.
|
|
640
|
+
-> v0.1.6 fix: watcher no longer processes session transcript .jsonl files (only .beads/*.jsonl),
|
|
641
|
+
eliminating the most common source of contention.
|
|
642
|
+
-> Default hook timeout is 8s (since v0.1.1). If you have an older install, re-run
|
|
643
|
+
`clawmem setup hooks`. If persistent, restart the watcher: `systemctl --user restart
|
|
644
|
+
clawmem-watcher.service`. Healthy memory is under 100MB — if 400MB+, restart clears it.
|
|
642
645
|
```
|
|
643
646
|
|
|
644
647
|
---
|
package/package.json
CHANGED
package/src/watcher.ts
CHANGED
|
@@ -23,7 +23,10 @@ export function startWatcher(
|
|
|
23
23
|
try {
|
|
24
24
|
const watcher = watch(dir, { recursive: true }, (event, filename) => {
|
|
25
25
|
if (!filename) return;
|
|
26
|
-
|
|
26
|
+
// Accept .md files (indexing) and .jsonl only within .beads/ (Dolt backend)
|
|
27
|
+
const isMd = filename.endsWith(".md");
|
|
28
|
+
const isBeadsJsonl = filename.endsWith(".jsonl") && filename.includes(".beads/");
|
|
29
|
+
if (!isMd && !isBeadsJsonl) return;
|
|
27
30
|
if (shouldExclude(filename)) return;
|
|
28
31
|
|
|
29
32
|
const fullPath = `${dir}/${filename}`;
|