#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
fix(facets): cascade facet deletion on memory delete (#1591)
DimitriChrysafis4ab436e717e3
diff --git a/AGENTS.md b/AGENTS.mdindex 8c1bfc2e..df4575ab 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -101,7 +101,7 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).## Testing-- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (3,600+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests.+- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (3,700+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests.- Before any npm publish: `npm run release:gate` must pass. It installs the packed tarballs into a clean home and runs capture, recovery, restart, export/import, MCP and status checks against the installed CLI (see CONTRIBUTING.md, Release process)- Mock pattern: `vi.mock("iii-sdk")` with mock `sdk.trigger`, `kv.get/set/list`- Test files go in `test/` with `.test.ts` extensiondiff --git a/README.md b/README.mdindex 18695707..e6de23e0 100644--- a/README.md+++ b/README.md@@ -72,7 +72,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tools.svg"><img src="assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-hooks.svg"><img src="assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-deps.svg"><img src="assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1867,7 +1867,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.mdindex bd28c468..2f6d16d3 100644--- a/READMEs/README.ar-SA.md+++ b/READMEs/README.ar-SA.md@@ -73,7 +73,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1439,7 +1439,7 @@ fi| Prometheus / Grafana | OTEL في iii + مراقب الحالة الصحية || أنظمة إضافات مخصصة | `iii worker add <name>` |-**242 ملف مصدري · ~55,000 سطر برمجي · 3,600+ اختبار · 324 دالة · 67 نطاق KV**، كل ذلك على ثلاث بنى أساسية. لا يوجد أمر `agentmemory plugin install`. نظام الإضافات هو iii نفسه.+**242 ملف مصدري · ~55,000 سطر برمجي · 3,700+ اختبار · 324 دالة · 67 نطاق KV**، كل ذلك على ثلاث بنى أساسية. لا يوجد أمر `agentmemory plugin install`. نظام الإضافات هو iii نفسه.---@@ -1863,7 +1863,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.mdindex 4886b94c..e80f39a1 100644--- a/READMEs/README.bn-BD.md+++ b/READMEs/README.bn-BD.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP টুল" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 অটো হুক" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 এক্সটার্নাল ডিবি" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ টেস্ট পাস" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ টেস্ট পাস" height="38" /></picture></p><p align="center">@@ -1861,7 +1861,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.mdindex dc94f6a4..08188124 100644--- a/READMEs/README.cs-CZ.md+++ b/READMEs/README.cs-CZ.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP nástrojů" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automatických hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 externích databází" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ testů úspěšně proběhlo" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ testů úspěšně proběhlo" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.mdindex 0c53d6be..c9370da5 100644--- a/READMEs/README.da-DK.md+++ b/READMEs/README.da-DK.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP-værktøjer" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automatiske hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 eksterne databaser" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ beståede tests" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ beståede tests" height="38" /></picture></p><p align="center">@@ -1860,7 +1860,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.mdindex 95d5cb58..aa2cb305 100644--- a/READMEs/README.de-DE.md+++ b/READMEs/README.de-DE.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP-Tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 Auto-Hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 externe DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ bestandene Tests" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ bestandene Tests" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.mdindex 2169d418..cf1c986d 100644--- a/READMEs/README.el-GR.md+++ b/READMEs/README.el-GR.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 εργαλεία MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 αυτόματα hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 εξωτερικές βάσεις δεδομένων" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ επιτυχημένες δοκιμές" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ επιτυχημένες δοκιμές" height="38" /></picture></p><p align="center">@@ -1862,7 +1862,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.mdindex dce73f85..def07055 100644--- a/READMEs/README.es-ES.md+++ b/READMEs/README.es-ES.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 tools MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 hooks automáticos" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 bases de datos externas" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests superados" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests superados" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.mdindex 42e9a5e0..902c97e5 100644--- a/READMEs/README.fi-FI.md+++ b/READMEs/README.fi-FI.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP-työkalua" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automaattista hookia" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 ulkoista tietokantaa" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ testiä läpäisty" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ testiä läpäisty" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.mdindex d2dde35a..a0808a60 100644--- a/READMEs/README.fr-FR.md+++ b/READMEs/README.fr-FR.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1448,7 +1448,7 @@ fi| Prometheus / Grafana | iii OTEL + moniteur de santé || Systèmes de plugins custom | `iii worker add <name>` |-**242 fichiers sources · ~55,000 LOC · 3,600+ tests · 324 fonctions · 67 scopes KV**, tout sur trois primitives. Pas de `agentmemory plugin install`. Le système de plugins, c'est iii lui-même.+**242 fichiers sources · ~55,000 LOC · 3,700+ tests · 324 fonctions · 67 scopes KV**, tout sur trois primitives. Pas de `agentmemory plugin install`. Le système de plugins, c'est iii lui-même.---@@ -1872,7 +1872,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.mdindex 91f065d3..dcc6c2b5 100644--- a/READMEs/README.he-IL.md+++ b/READMEs/README.he-IL.md@@ -73,7 +73,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 כלי MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 hooks אוטומטיים" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 מסדי נתונים חיצוניים" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ בדיקות עוברות" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ בדיקות עוברות" height="38" /></picture></p><p align="center">@@ -1863,7 +1863,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.mdindex 927d6d55..b7efe48a 100644--- a/READMEs/README.hi-IN.md+++ b/READMEs/README.hi-IN.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1873,7 +1873,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.mdindex 046e91fb..a7ddb97f 100644--- a/READMEs/README.hu-HU.md+++ b/READMEs/README.hu-HU.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP eszköz" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automatikus hook" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 külső adatbázis" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ sikeres teszt" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ sikeres teszt" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.mdindex 5503f72e..875a8210 100644--- a/READMEs/README.id-ID.md+++ b/READMEs/README.id-ID.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 tool MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 hook otomatis" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 DB eksternal" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ pengujian lolos" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ pengujian lolos" height="38" /></picture></p><p align="center">@@ -1447,7 +1447,7 @@ fi| Prometheus / Grafana | iii OTEL + health monitor || Sistem plugin custom | `iii worker add <name>` |-**242 file sumber · ~55,000 LOC · 3,600+ pengujian · 324 fungsi · 67 scope KV**, semua di atas tiga primitif. Tidak ada `agentmemory plugin install`. Sistem plugin-nya adalah iii itu sendiri.+**242 file sumber · ~55,000 LOC · 3,700+ pengujian · 324 fungsi · 67 scope KV**, semua di atas tiga primitif. Tidak ada `agentmemory plugin install`. Sistem plugin-nya adalah iii itu sendiri.---@@ -1871,7 +1871,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.mdindex 3f881f37..ce079b75 100644--- a/READMEs/README.it-IT.md+++ b/READMEs/README.it-IT.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.mdindex e6160b75..c9276b81 100644--- a/READMEs/README.ja-JP.md+++ b/READMEs/README.ja-JP.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP ツール" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 自動 hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="外部 DB 0 個" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ 件のテストが成功" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ 件のテストが成功" height="38" /></picture></p><p align="center">@@ -1869,7 +1869,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.mdindex 2b806c19..cb239a45 100644--- a/READMEs/README.ko-KR.md+++ b/READMEs/README.ko-KR.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.mdindex 31e07c3e..57e08d1e 100644--- a/READMEs/README.nb-NO.md+++ b/READMEs/README.nb-NO.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1871,7 +1871,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.mdindex 09778266..295cffcb 100644--- a/READMEs/README.nl-NL.md+++ b/READMEs/README.nl-NL.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.mdindex 2e3255c9..f1c6536c 100644--- a/READMEs/README.pl-PL.md+++ b/READMEs/README.pl-PL.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 narzędzia MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automatycznych hooków" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 zewnętrznych baz danych" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ zaliczonych testów" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ zaliczonych testów" height="38" /></picture></p><p align="center">@@ -1446,7 +1446,7 @@ fi| Prometheus / Grafana | iii OTEL + monitor stanu || Niestandardowe systemy pluginów | `iii worker add <name>` |-**242 pliki źródłowe · ~55,000 LOC · 3,600+ testów · 324 funkcje · 67 zakresów KV**, wszystko na trzech prymitywach. Nie ma `agentmemory plugin install`. Systemem pluginów jest sam iii.+**242 pliki źródłowe · ~55,000 LOC · 3,700+ testów · 324 funkcje · 67 zakresów KV**, wszystko na trzech prymitywach. Nie ma `agentmemory plugin install`. Systemem pluginów jest sam iii.---@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.mdindex 7fa780c8..e2425f36 100644--- a/READMEs/README.pt-BR.md+++ b/READMEs/README.pt-BR.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1871,7 +1871,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.mdindex bd099331..0c08f3a0 100644--- a/READMEs/README.pt-PT.md+++ b/READMEs/README.pt-PT.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 ferramentas MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 hooks automáticos" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 bases de dados externas" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ testes aprovados" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ testes aprovados" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.mdindex c41760f0..aceba5e9 100644--- a/READMEs/README.ro-RO.md+++ b/READMEs/README.ro-RO.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 de instrumente MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 hook-uri automate" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 baze de date externe" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ teste trecute" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ teste trecute" height="38" /></picture></p><p align="center">@@ -1430,7 +1430,7 @@ fi| Prometheus / Grafana | iii OTEL + monitor de sănătate || Sisteme de plugin-uri personalizate | `iii worker add <name>` |-**242 de fișiere sursă · ~55,000 LOC · 3,600+ de teste · 324 de funcții · 67 de domenii KV**, toate pe trei primitive. Niciun `agentmemory plugin install`. Sistemul de plugin-uri este chiar iii.+**242 de fișiere sursă · ~55,000 LOC · 3,700+ de teste · 324 de funcții · 67 de domenii KV**, toate pe trei primitive. Niciun `agentmemory plugin install`. Sistemul de plugin-uri este chiar iii.---@@ -1854,7 +1854,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.mdindex 0e9423eb..82e5c214 100644--- a/READMEs/README.ru-RU.md+++ b/READMEs/README.ru-RU.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.mdindex fc1104b6..66afefdf 100644--- a/READMEs/README.sv-SE.md+++ b/READMEs/README.sv-SE.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP-verktyg" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 automatiska hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 externa databaser" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ godkända tester" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ godkända tester" height="38" /></picture></p><p align="center">@@ -1861,7 +1861,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.mdindex d17b0cd2..10873ea1 100644--- a/READMEs/README.th-TH.md+++ b/READMEs/README.th-TH.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 เครื่องมือ MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 hook อัตโนมัติ" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="ไม่ต้องพึ่ง external DB เลย" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="ผ่านการทดสอบ 3,600+ รายการ" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="ผ่านการทดสอบ 3,700+ รายการ" height="38" /></picture></p><p align="center">@@ -1868,7 +1868,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.mdindex 1ac0b7d0..1c235f09 100644--- a/READMEs/README.tl-PH.md+++ b/READMEs/README.tl-PH.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tool" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 awtomatikong hook" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 panlabas na DB" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ pumapasang test" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ pumapasang test" height="38" /></picture></p><p align="center">@@ -1870,7 +1870,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.mdindex 7fb8e85a..50c0957e 100644--- a/READMEs/README.tr-TR.md+++ b/READMEs/README.tr-TR.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1861,7 +1861,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.mdindex 8bc2c90b..acef4a80 100644--- a/READMEs/README.uk-UA.md+++ b/READMEs/README.uk-UA.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 інструменти MCP" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 автоматичних хуків" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 зовнішніх БД" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ тестів пройдено" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ тестів пройдено" height="38" /></picture></p><p align="center">@@ -1871,7 +1871,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.mdindex aa903888..d7c4d654 100644--- a/READMEs/README.ur-PK.md+++ b/READMEs/README.ur-PK.md@@ -73,7 +73,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP ٹولز" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 خودکار ہکس" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 خارجی ڈیٹابیسز" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ ٹیسٹس پاس ہو رہے ہیں" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ ٹیسٹس پاس ہو رہے ہیں" height="38" /></picture></p><p align="center">@@ -1432,7 +1432,7 @@ fi| Prometheus / Grafana | iii OTEL + health monitor || کسٹم plugin سسٹمز | `iii worker add <name>` |-**242 سورس فائلز · ~55,000 لائنز کوڈ · 3,600+ ٹیسٹس · 324 فنکشنز · 67 KV اسکوپس**، سب تین primitives پر۔ کوئی `agentmemory plugin install` نہیں۔ plugin سسٹم خود iii ہی ہے۔+**242 سورس فائلز · ~55,000 لائنز کوڈ · 3,700+ ٹیسٹس · 324 فنکشنز · 67 KV اسکوپس**، سب تین primitives پر۔ کوئی `agentmemory plugin install` نہیں۔ plugin سسٹم خود iii ہی ہے۔---@@ -1854,7 +1854,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.mdindex ef7bb14e..534c1960 100644--- a/READMEs/README.vi-VN.md+++ b/READMEs/README.vi-VN.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 MCP tools" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ tests passing" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ tests passing" height="38" /></picture></p><p align="center">@@ -1861,7 +1861,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.mdindex 8a98022c..ab6a0e71 100644--- a/READMEs/README.zh-CN.md+++ b/READMEs/README.zh-CN.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 个 MCP 工具" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 个自动 hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 个外部数据库" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ 项测试通过" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ 项测试通过" height="38" /></picture></p><p align="center">@@ -1868,7 +1868,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.mdindex 4fb78bc4..180fb759 100644--- a/READMEs/README.zh-TW.md+++ b/READMEs/README.zh-TW.md@@ -71,7 +71,7 @@<picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tools.svg"><img src="../assets/tags/stat-tools.svg" alt="54 個 MCP 工具" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-hooks.svg"><img src="../assets/tags/stat-hooks.svg" alt="12 個自動 hooks" height="38" /></picture><picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-deps.svg"><img src="../assets/tags/stat-deps.svg" alt="0 個外部資料庫" height="38" /></picture>- <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,600+ 測試通過" height="38" /></picture>+ <picture><source media="(prefers-color-scheme: dark)" srcset="../assets/tags/light/stat-tests.svg"><img src="../assets/tags/stat-tests.svg" alt="3,700+ 測試通過" height="38" /></picture></p><p align="center">@@ -1854,7 +1854,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Content-Type: a```bashnpm run dev # Hot reloadnpm run build # Production build-npm test # 3,600+ tests+npm test # 3,700+ testsnpm run test:integration # API tests (requires running services)```diff --git a/assets/tags/light/stat-tests.svg b/assets/tags/light/stat-tests.svgindex 1a99e20a..ff8bd863 100644--- a/assets/tags/light/stat-tests.svg+++ b/assets/tags/light/stat-tests.svg@@ -1,5 +1,5 @@-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 140 48" fill="none" role="img" aria-label="TESTS PASSING: 3600+">+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 140 48" fill="none" role="img" aria-label="TESTS PASSING: 3700+"><rect x="0" y="0" width="140" height="48" rx="10" fill="#FFFFFF" stroke="#E5E7EB" stroke-width="1"/>- <text x="70" y="24" fill="#16A34A" font-family='ui-sans-serif, -apple-system, "Segoe UI", Inter, system-ui, sans-serif' font-size="18" font-weight="900" text-anchor="middle" letter-spacing="-0.3">3600+</text>+ <text x="70" y="24" fill="#16A34A" font-family='ui-sans-serif, -apple-system, "Segoe UI", Inter, system-ui, sans-serif' font-size="18" font-weight="900" text-anchor="middle" letter-spacing="-0.3">3700+</text><text x="70" y="38" fill="#64748B" font-family='ui-sans-serif, -apple-system, "Segoe UI", Inter, system-ui, sans-serif' font-size="9" font-weight="600" text-anchor="middle" letter-spacing="1.5">TESTS PASSING</text></svg>diff --git a/assets/tags/stat-tests.svg b/assets/tags/stat-tests.svgindex 7ca382fa..cec98231 100644--- a/assets/tags/stat-tests.svg+++ b/assets/tags/stat-tests.svg@@ -1,5 +1,5 @@-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 140 48" fill="none" role="img" aria-label="TESTS PASSING: 3600+">+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 140 48" fill="none" role="img" aria-label="TESTS PASSING: 3700+"><rect x="0" y="0" width="140" height="48" rx="10" fill="#1A1A1A" stroke="#2A2A2A" stroke-width="1"/>- <text x="70" y="24" fill="#00D26A" font-family='ui-sans-serif, -apple-system, "Segoe UI", Inter, system-ui, sans-serif' font-size="18" font-weight="900" text-anchor="middle" letter-spacing="-0.3">3600+</text>+ <text x="70" y="24" fill="#00D26A" font-family='ui-sans-serif, -apple-system, "Segoe UI", Inter, system-ui, sans-serif' font-size="18" font-weight="900" text-anchor="middle" letter-spacing="-0.3">3700+</text><text x="70" y="38" fill="#9CA3AF" font-family='ui-sans-serif, -apple-system, "Segoe UI", Inter, system-ui, sans-serif' font-size="9" font-weight="600" text-anchor="middle" letter-spacing="1.5">TESTS PASSING</text></svg>diff --git a/scripts/docs-sync.state.json b/scripts/docs-sync.state.jsonindex 5b38ec02..42fad90d 100644--- a/scripts/docs-sync.state.json+++ b/scripts/docs-sync.state.json@@ -20,7 +20,7 @@"12"],"tests": [- "3600+"+ "3700+"],"functions": ["324"@@ -29,7 +29,7 @@"242"],"loc": [- "56000"+ "57000"],"kvScopes": ["67"diff --git a/src/functions/auto-forget.ts b/src/functions/auto-forget.tsindex 11170781..022b739c 100644--- a/src/functions/auto-forget.ts+++ b/src/functions/auto-forget.ts@@ -7,6 +7,7 @@ import { withKeyedLock } from "../state/keyed-mutex.js";import { unindexObservationSession } from "../state/obs-index.js";import { recordAudit } from "./audit.js";import { deleteAccessLog } from "./access-tracker.js";+import { deleteFacetsForTargets } from "./facets.js";import { getSearchIndex, vectorIndexRemove, flushIndexSave } from "./search.js";import { logger } from "../logger.js";@@ -40,28 +41,34 @@ export function registerAutoForgetFunction(sdk: IIIClient, kv: StateKV): void {const memories = await kv.list<Memory>(KV.memories);const deletedIds = new Set<string>();- for (const mem of memories) {- if (mem.forgetAfter) {- const expiry = new Date(mem.forgetAfter).getTime();- if (now > expiry) {- result.ttlExpired.push(mem.id);- deletedIds.add(mem.id);- if (!dryRun) {- if (mem.imageRef) {- await decrementImageRef(kv, sdk, mem.imageRef);+ const facetIds = new Set<string>();+ try {+ for (const mem of memories) {+ if (mem.forgetAfter) {+ const expiry = new Date(mem.forgetAfter).getTime();+ if (now > expiry) {+ result.ttlExpired.push(mem.id);+ deletedIds.add(mem.id);+ if (!dryRun) {+ if (mem.imageRef) {+ await decrementImageRef(kv, sdk, mem.imageRef);+ }+ await kv.delete(KV.memories, mem.id);+ facetIds.add(mem.id);+ await recordAudit(kv, "delete", "mem::auto-forget", [mem.id], {+ resource: "memory",+ reason: "auto-forget TTL",+ timestamp: mem.forgetAfter,+ });+ await deleteAccessLog(kv, mem.id);+ getSearchIndex().remove(mem.id);+ vectorIndexRemove(mem.id);}- await kv.delete(KV.memories, mem.id);- await recordAudit(kv, "delete", "mem::auto-forget", [mem.id], {- resource: "memory",- reason: "auto-forget TTL",- timestamp: mem.forgetAfter,- });- await deleteAccessLog(kv, mem.id);- getSearchIndex().remove(mem.id);- vectorIndexRemove(mem.id);}}}+ } finally {+ await deleteFacetsForTargets(kv, facetIds);}const latestMemories = memoriesdiff --git a/src/functions/evict.ts b/src/functions/evict.tsindex fa228c08..a452d749 100644--- a/src/functions/evict.ts+++ b/src/functions/evict.ts@@ -15,6 +15,7 @@ import { unindexObservationSession } from "../state/obs-index.js";import { isConsolidationEnabled } from "../config.js";import { recordAudit } from "./audit.js";import { deleteAccessLog } from "./access-tracker.js";+import { deleteFacetsForTargets } from "./facets.js";import { getSearchIndex, vectorIndexRemove, flushIndexSave } from "./search.js";import { logger } from "../logger.js";@@ -333,74 +334,81 @@ export function registerEvictFunction(sdk: IIIClient, kv: StateKV): void {const memories = await kv.list<Memory>(KV.memories).catch(() => []);const evictedMemIds = new Set<string>();- for (const mem of memories) {- if (mem.forgetAfter) {- const expiry = new Date(mem.forgetAfter).getTime();- if (now > expiry) {- if (dryRun) {- stats.expiredMemories++;- evictedMemIds.add(mem.id);- } else {- try {- await kv.delete(KV.memories, mem.id);+ const deletedMemIds = new Set<string>();+ try {+ for (const mem of memories) {+ if (mem.forgetAfter) {+ const expiry = new Date(mem.forgetAfter).getTime();+ if (now > expiry) {+ if (dryRun) {stats.expiredMemories++;evictedMemIds.add(mem.id);- } catch (err) {- logger.warn("Eviction delete failed", {+ } else {+ try {+ await kv.delete(KV.memories, mem.id);+ deletedMemIds.add(mem.id);+ stats.expiredMemories++;+ evictedMemIds.add(mem.id);+ } catch (err) {+ logger.warn("Eviction delete failed", {+ resource: "memory",+ id: mem.id,+ reason: "expired_memory",+ error: err instanceof Error ? err.message : String(err),+ });+ continue;+ }+ if (mem.imageRef) {+ await decrementImageRef(kv, sdk, mem.imageRef);+ }+ await recordAudit(kv, "delete", "mem::evict", [mem.id], {resource: "memory",- id: mem.id,reason: "expired_memory",- error: err instanceof Error ? err.message : String(err),+ dryRun,});- continue;- }- if (mem.imageRef) {- await decrementImageRef(kv, sdk, mem.imageRef);+ await deleteAccessLog(kv, mem.id);}- await recordAudit(kv, "delete", "mem::evict", [mem.id], {- resource: "memory",- reason: "expired_memory",- dryRun,- });- await deleteAccessLog(kv, mem.id);}}- }- if (- !evictedMemIds.has(mem.id) &&- mem.isLatest === false &&- mem.createdAt- ) {- const age = now - new Date(mem.createdAt).getTime();- if (age > cfg.lowImportanceMaxDays * MS_PER_DAY) {- if (dryRun) {- stats.nonLatestMemories++;- } else {- try {- await kv.delete(KV.memories, mem.id);+ if (+ !evictedMemIds.has(mem.id) &&+ mem.isLatest === false &&+ mem.createdAt+ ) {+ const age = now - new Date(mem.createdAt).getTime();+ if (age > cfg.lowImportanceMaxDays * MS_PER_DAY) {+ if (dryRun) {stats.nonLatestMemories++;- } catch (err) {- logger.warn("Eviction delete failed", {+ } else {+ try {+ await kv.delete(KV.memories, mem.id);+ deletedMemIds.add(mem.id);+ stats.nonLatestMemories++;+ } catch (err) {+ logger.warn("Eviction delete failed", {+ resource: "memory",+ id: mem.id,+ reason: "old_non_latest_memory",+ error: err instanceof Error ? err.message : String(err),+ });+ continue;+ }+ if (mem.imageRef) {+ await decrementImageRef(kv, sdk, mem.imageRef);+ }+ await recordAudit(kv, "delete", "mem::evict", [mem.id], {resource: "memory",- id: mem.id,reason: "old_non_latest_memory",- error: err instanceof Error ? err.message : String(err),+ dryRun,});- continue;- }- if (mem.imageRef) {- await decrementImageRef(kv, sdk, mem.imageRef);+ await deleteAccessLog(kv, mem.id);}- await recordAudit(kv, "delete", "mem::evict", [mem.id], {- resource: "memory",- reason: "old_non_latest_memory",- dryRun,- });- await deleteAccessLog(kv, mem.id);}}}+ } finally {+ await deleteFacetsForTargets(kv, deletedMemIds);}if (indexCleaned) await flushIndexSave();diff --git a/src/functions/facets.ts b/src/functions/facets.tsindex 430d0a32..bdd90a15 100644--- a/src/functions/facets.ts+++ b/src/functions/facets.ts@@ -2,6 +2,53 @@ import type { IIIClient } from "iii-sdk";import type { StateKV } from "../state/kv.js";import { KV, generateId } from "../state/schema.js";import type { Facet } from "../types.js";+import { logger } from "../logger.js";++export async function deleteFacetsForTargets(+ kv: StateKV,+ targetIds: Iterable<string>,+): Promise<void> {+ const ids = new Set(targetIds);+ ids.delete("");+ if (ids.size === 0) return;+ try {+ const live = new Set<string>();+ await Promise.all(+ [...ids].map(async (id) => {+ for (let attempt = 0; attempt < 2; attempt++) {+ try {+ const [mem, sem] = await Promise.all([+ kv.get(KV.memories, id),+ kv.get(KV.semantic, id),+ ]);+ if (mem || sem) live.add(id);+ return;+ } catch {+ if (attempt === 1) {+ live.add(id);+ logger.warn("Facet cleanup skipped unverifiable target", {+ targetId: id,+ });+ }+ }+ }+ }),+ );+ const all = await kv.list<Facet>(KV.facets);+ const matches = all.filter(+ (f) =>+ ids.has(f.targetId) &&+ !live.has(f.targetId) &&+ f.targetType === "memory",+ );+ await Promise.all(matches.map((f) => kv.delete(KV.facets, f.id)));+ } catch (err) {+ logger.warn("Facet cleanup failed", {+ targetIds: ids.size,+ error: err instanceof Error ? err.message : String(err),+ });+ }+}export function registerFacetsFunction(sdk: IIIClient, kv: StateKV): void {sdk.registerFunction("mem::facet-tag",diff --git a/src/functions/governance.ts b/src/functions/governance.tsindex cde04314..1c48d655 100644--- a/src/functions/governance.ts+++ b/src/functions/governance.ts@@ -4,6 +4,7 @@ import { KV } from "../state/schema.js";import type { StateKV } from "../state/kv.js";import { recordAudit, safeAudit, queryAudit } from "./audit.js";import { deleteAccessLog } from "./access-tracker.js";+import { deleteFacetsForTargets } from "./facets.js";import { getSearchIndex, vectorIndexRemove, flushIndexSave } from "./search.js";import { logger } from "../logger.js";@@ -59,6 +60,11 @@ export function registerGovernanceFunction(sdk: IIIClient, kv: StateKV): void {}}+ // Sweeping notFound ids too lets a retried delete clean up after a+ // partial failure or an older version; the helper itself skips ids that+ // still resolve in either memory scope.+ await deleteFacetsForTargets(kv, [...deletedIds, ...notFound]);+const deleted = deletedIds.length;if (deleted > 0) await flushIndexSave();@@ -193,6 +199,8 @@ export function registerGovernanceFunction(sdk: IIIClient, kv: StateKV): void {});}+ await deleteFacetsForTargets(kv, [...successfulIds, ...notFound]);+if (successfulIds.length > 0) await flushIndexSave();if (successfulIds.length > 0 || failures.length > 0) {diff --git a/src/functions/remember.ts b/src/functions/remember.tsindex cb06f90c..3bd395b1 100644--- a/src/functions/remember.ts+++ b/src/functions/remember.ts@@ -8,6 +8,7 @@ import { removeSessionFromProjectIndex } from "../state/session-index.js";import { unindexObservationSession } from "../state/obs-index.js";import { memoryToObservation } from "../state/memory-utils.js";import { deleteAccessLog } from "./access-tracker.js";+import { deleteFacetsForTargets } from "./facets.js";import { recordAudit } from "./audit.js";import { getSearchIndex, getVectorIndex, isMemoryIndexReady, scheduleIndexSave, vectorIndexAddGuarded, vectorIndexRemove, flushIndexSave } from "./search.js";import { getAgentId } from "../config.js";@@ -333,15 +334,19 @@ export function registerRememberFunction(sdk: IIIClient, kv: StateKV): void {const memoryId = data.memoryId;await attempt(memoryId, async () => {const mem = await kv.get<Memory>(KV.memories, memoryId);- if (!mem) return false;+ if (!mem) {+ await deleteFacetsForTargets(kv, [memoryId]);+ return false;+ }await kv.delete(KV.memories, memoryId);deletedMemoryIds.push(memoryId);getSearchIndex().remove(memoryId);vectorIndexRemove(memoryId);indexCleaned = true;await cleanup(memoryId, async () => {- if (mem.imageRef) await decrementImageRef(kv, sdk, mem.imageRef);await deleteAccessLog(kv, memoryId);+ await deleteFacetsForTargets(kv, [memoryId]);+ if (mem.imageRef) await decrementImageRef(kv, sdk, mem.imageRef);});return true;});diff --git a/src/functions/retention.ts b/src/functions/retention.tsindex ebe5a564..74feb1d9 100644--- a/src/functions/retention.ts+++ b/src/functions/retention.ts@@ -14,6 +14,7 @@ import {normalizeAccessLog,} from "./access-tracker.js";import { recordAudit, runAuditRetentionSweep } from "./audit.js";+import { deleteFacetsForTargets } from "./facets.js";import { getSearchIndex, vectorIndexRemove, flushIndexSave } from "./search.js";import { logger } from "../logger.js";import { getAuditRetentionMonths } from "../config.js";@@ -329,52 +330,68 @@ export function registerRetentionFunctions(let evictedEpisodic = 0;let evictedSemantic = 0;const evictedIds: string[] = [];+ const missingIds: string[] = [];for (const candidate of candidates) {try {let scope: string | null = null;let resolvedSource: "episodic" | "semantic" | null = null;+ let mem: Memory | null = null;if (candidate.source === "semantic") {- scope = KV.semantic;- resolvedSource = "semantic";+ mem = await kv.get<Memory>(KV.semantic, candidate.memoryId);+ if (mem) {+ scope = KV.semantic;+ resolvedSource = "semantic";+ }} else if (candidate.source === "episodic") {- scope = KV.memories;- resolvedSource = "episodic";- } else {- const episodic = await kv.get(KV.memories, candidate.memoryId);- if (episodic !== null) {+ mem = await kv.get<Memory>(KV.memories, candidate.memoryId);+ if (mem) {+ scope = KV.memories;+ resolvedSource = "episodic";+ }+ }+ if (!mem && !candidate.source) {+ mem = await kv.get<Memory>(KV.memories, candidate.memoryId);+ if (mem) {scope = KV.memories;resolvedSource = "episodic";} else {- const semantic = await kv.get(KV.semantic, candidate.memoryId);- if (semantic !== null) {+ mem = await kv.get<Memory>(KV.semantic, candidate.memoryId);+ if (mem) {scope = KV.semantic;resolvedSource = "semantic";}}}- if (!scope || !resolvedSource) {+ if (!scope || !mem) {+ if (candidate.source) {+ const other =+ candidate.source === "semantic" ? KV.memories : KV.semantic;+ if (await kv.get(other, candidate.memoryId)) continue;+ }+ missingIds.push(candidate.memoryId);continue;}- const mem = await kv.get<Memory>(scope, candidate.memoryId);- if (mem && mem.imageRef) {+ if (mem.imageRef) {await decrementImageRef(kv, sdk, mem.imageRef);}await kv.delete(scope, candidate.memoryId);+ evictedIds.push(candidate.memoryId);+ evicted++;+ if (resolvedSource === "semantic") evictedSemantic++;+ else evictedEpisodic++;await kv.delete(KV.retentionScores, candidate.memoryId);await deleteAccessLog(kv, candidate.memoryId);getSearchIndex().remove(candidate.memoryId);vectorIndexRemove(candidate.memoryId);- evicted++;- evictedIds.push(candidate.memoryId);- if (resolvedSource === "semantic") evictedSemantic++;- else evictedEpisodic++;} catch {continue;}}+ await deleteFacetsForTargets(kv, [...evictedIds, ...missingIds]);+// Retention eviction is a structural delete path that removes// memories, retention scores, and access logs, so it needs to// emit an audit record per the repo's audit-coverage policy (seediff --git a/test/auto-forget.test.ts b/test/auto-forget.test.tsindex 0f104eb3..4182ab93 100644--- a/test/auto-forget.test.ts+++ b/test/auto-forget.test.ts@@ -10,7 +10,7 @@ import {setIndexPersistence,} from "../src/functions/search.js";import { memoryToObservation } from "../src/state/memory-utils.js";-import type { Memory, CompressedObservation, Session } from "../src/types.js";+import type { Memory, CompressedObservation, Session, Facet } from "../src/types.js";function mockKV() {const store = new Map<string, Map<string, unknown>>();@@ -95,6 +95,40 @@ describe("Auto-Forget Function", () => {expect(deleted).toBeNull();});+ it("removes facets pointing at a TTL-expired memory", async () => {+ const expired = makeMemory({+ id: "mem_expired",+ forgetAfter: "2020-01-01T00:00:00Z",+ });+ const kept = makeMemory({ id: "mem_kept" });+ await kv.set("mem:memories", "mem_expired", expired);+ await kv.set("mem:memories", "mem_kept", kept);+ await kv.set("mem:facets", "fct_1", {+ id: "fct_1",+ targetId: "mem_expired",+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2020-01-01T00:00:00Z",+ });+ await kv.set("mem:facets", "fct_2", {+ id: "fct_2",+ targetId: "mem_kept",+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2020-01-01T00:00:00Z",+ });++ const result = (await sdk.trigger("mem::auto-forget", {})) as {+ ttlExpired: string[];+ };++ expect(result.ttlExpired).toContain("mem_expired");+ const remaining = await kv.list<Facet>("mem:facets");+ expect(remaining.map((f) => f.id)).toEqual(["fct_2"]);+ });+it("detects contradiction between very similar memories", async () => {const mem1 = makeMemory({id: "mem_1",diff --git a/test/evict.test.ts b/test/evict.test.tsindex 85572834..91d43be5 100644--- a/test/evict.test.ts+++ b/test/evict.test.ts@@ -3,6 +3,7 @@ import type {CompressedObservation,RawObservation,Session,+ Memory,} from "../src/types.js";import { registerEvictFunction } from "../src/functions/evict.js";import { KV } from "../src/state/schema.js";@@ -365,3 +366,116 @@ describe("mem::evict stale sessions", () => {);});});++describe("mem::evict memory cleanup", () => {+ function makeEvictMemory(overrides: Partial<Memory>): Memory {+ return {+ id: "mem_1",+ createdAt: daysAgo(31),+ updatedAt: daysAgo(31),+ type: "fact",+ title: "Evicted memory",+ content: "evicted",+ concepts: [],+ files: [],+ sessionIds: ["ses_1"],+ strength: 1,+ version: 1,+ isLatest: true,+ ...overrides,+ };+ }++ function makeEvictFacet(id: string, targetId: string) {+ return {+ id,+ targetId,+ targetType: "memory" as const,+ dimension: "probe",+ value: "value",+ createdAt: daysAgo(1),+ };+ }++ function registerEvictStubs(+ sdk: ReturnType<typeof mockSdk>["sdk"],+ kv: ReturnType<typeof mockKV>,+ ) {+ registerEvictFunction(sdk as never, kv as never);+ sdk.registerFunction("event::session::stopped", () => ({+ success: true,+ }));+ sdk.registerFunction("mem::consolidate-pipeline", () => ({+ success: true,+ }));+ sdk.registerFunction("mem::auto-crystallize", () => ({ success: true }));+ }++ it("removes facets that point at an expired memory", async () => {+ const kv = mockKV(new Map());+ const { sdk } = mockSdk();++ const memory = makeEvictMemory({ id: "mem_expired", forgetAfter: daysAgo(1) });+ const survivor = makeEvictMemory({ id: "mem_survivor" });+ await kv.set(KV.memories, memory.id, memory);+ await kv.set(KV.memories, survivor.id, survivor);+ await kv.set(KV.facets, "fct_1", makeEvictFacet("fct_1", memory.id));+ await kv.set(KV.facets, "fct_2", makeEvictFacet("fct_2", memory.id));+ await kv.set(KV.facets, "fct_3", makeEvictFacet("fct_3", survivor.id));++ registerEvictStubs(sdk, kv);+ const result = (await sdk.trigger({+ function_id: "mem::evict",+ payload: {},+ })) as { expiredMemories: number };++ expect(result.expiredMemories).toBe(1);+ const remaining = await kv.list<{ id: string }>(KV.facets);+ expect(remaining.map((f) => f.id)).toEqual(["fct_3"]);+ });++ it("removes facets that point at an old non-latest memory", async () => {+ const kv = mockKV(new Map());+ const { sdk } = mockSdk();++ const memory = makeEvictMemory({+ id: "mem_stale",+ createdAt: daysAgo(120),+ updatedAt: daysAgo(120),+ isLatest: false,+ });+ const survivor = makeEvictMemory({ id: "mem_survivor" });+ await kv.set(KV.memories, memory.id, memory);+ await kv.set(KV.memories, survivor.id, survivor);+ await kv.set(KV.facets, "fct_1", makeEvictFacet("fct_1", memory.id));+ await kv.set(KV.facets, "fct_2", makeEvictFacet("fct_2", survivor.id));++ registerEvictStubs(sdk, kv);+ const result = (await sdk.trigger({+ function_id: "mem::evict",+ payload: {},+ })) as { nonLatestMemories: number };++ expect(result.nonLatestMemories).toBe(1);+ const remaining = await kv.list<{ id: string }>(KV.facets);+ expect(remaining.map((f) => f.id)).toEqual(["fct_2"]);+ });++ it("keeps facets in dryRun", async () => {+ const kv = mockKV(new Map());+ const { sdk } = mockSdk();++ const memory = makeEvictMemory({ id: "mem_expired", forgetAfter: daysAgo(1) });+ await kv.set(KV.memories, memory.id, memory);+ await kv.set(KV.facets, "fct_1", makeEvictFacet("fct_1", memory.id));++ registerEvictStubs(sdk, kv);+ const result = (await sdk.trigger({+ function_id: "mem::evict",+ payload: { dryRun: true },+ })) as { expiredMemories: number };++ expect(result.expiredMemories).toBe(1);+ expect(await kv.list(KV.facets)).toHaveLength(1);+ });+});diff --git a/test/governance.test.ts b/test/governance.test.tsindex b1efd21a..2c156569 100644--- a/test/governance.test.ts+++ b/test/governance.test.ts@@ -10,7 +10,7 @@ import {setIndexPersistence,} from "../src/functions/search.js";import { memoryToObservation } from "../src/state/memory-utils.js";-import type { Memory, AuditEntry } from "../src/types.js";+import type { Memory, AuditEntry, Facet } from "../src/types.js";function mockKV() {const store = new Map<string, Map<string, unknown>>();@@ -68,6 +68,17 @@ function makeMemory(id: string, type: Memory["type"] = "pattern"): Memory {};}+function makeFacet(id: string, targetId: string): Facet {+ return {+ id,+ targetId,+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2026-02-01T00:00:00Z",+ };+}+describe("Governance Functions", () => {let sdk: ReturnType<typeof mockSdk>;let kv: ReturnType<typeof mockKV>;@@ -138,6 +149,64 @@ describe("Governance Functions", () => {expect(remaining.length).toBe(3);});+ it("governance-delete removes facets pointing at the deleted memory", async () => {+ await kv.set("mem:facets", "fct_1", makeFacet("fct_1", "mem_1"));+ await kv.set("mem:facets", "fct_2", makeFacet("fct_2", "mem_2"));++ const result = (await sdk.trigger("mem::governance-delete", {+ memoryIds: ["mem_1"],+ })) as { success: boolean; deleted: number };++ expect(result.deleted).toBe(1);+ const remaining = await kv.list<Facet>("mem:facets");+ expect(remaining.map((f) => f.id)).toEqual(["fct_2"]);+ });++ it("governance-delete sweeps facets for already-missing memories", async () => {+ await kv.set("mem:facets", "fct_1", makeFacet("fct_1", "mem_gone"));+ await kv.set("mem:facets", "fct_2", makeFacet("fct_2", "mem_2"));+ await kv.set("mem:facets", "fct_obs", {+ ...makeFacet("fct_obs", "obs_1"),+ targetType: "observation",+ });++ const result = (await sdk.trigger("mem::governance-delete", {+ memoryIds: ["mem_gone", "obs_1"],+ })) as { success: boolean; deleted: number; notFound: string[] };++ expect(result.deleted).toBe(0);+ expect(result.notFound).toEqual(["mem_gone", "obs_1"]);+ const remaining = await kv.list<Facet>("mem:facets");+ expect(remaining.map((f) => f.id).sort()).toEqual(["fct_2", "fct_obs"]);+ });++ it("governance-delete keeps facets on live semantic records", async () => {+ await kv.set("mem:semantic", "sem_1", { id: "sem_1", content: "x" });+ await kv.set("mem:facets", "fct_s", makeFacet("fct_s", "sem_1"));++ const result = (await sdk.trigger("mem::governance-delete", {+ memoryIds: ["sem_1"],+ })) as { notFound: string[] };++ expect(result.notFound).toEqual(["sem_1"]);+ const remaining = await kv.list<Facet>("mem:facets");+ expect(remaining.map((f) => f.id)).toEqual(["fct_s"]);+ });++ it("governance-bulk removes facets for every deleted memory", async () => {+ await kv.set("mem:facets", "fct_1", makeFacet("fct_1", "mem_1"));+ await kv.set("mem:facets", "fct_2", makeFacet("fct_2", "mem_2"));+ await kv.set("mem:facets", "fct_3", makeFacet("fct_3", "mem_3"));++ const result = (await sdk.trigger("mem::governance-bulk", {+ type: ["pattern"],+ })) as { success: boolean; deleted: number };++ expect(result.deleted).toBe(2);+ const remaining = await kv.list<Facet>("mem:facets");+ expect(remaining.map((f) => f.id)).toEqual(["fct_2"]);+ });+// Delete paths must tear down the BM25 index entry and trigger an// IndexPersistence save so a hard process exit can't restore a stale// snapshot at next boot.diff --git a/test/remember-forget-audit.test.ts b/test/remember-forget-audit.test.tsindex 848391a4..20f8b60d 100644--- a/test/remember-forget-audit.test.ts+++ b/test/remember-forget-audit.test.ts@@ -162,6 +162,39 @@ describe("mem::forget audit coverage", () => {const auditRows = await kv.list(currentAuditScope());expect(auditRows).toHaveLength(0);});++ it("removes facets that point at the forgotten memory", async () => {+ const sdk = mockSdk();+ const kv = mockKV();+ registerRememberFunction(sdk as never, kv as never);++ await kv.set("mem:memories", "mem_a", { id: "mem_a", content: "x" });+ await kv.set("mem:memories", "mem_b", { id: "mem_b", content: "y" });+ await kv.set("mem:facets", "fct_1", {+ id: "fct_1",+ targetId: "mem_a",+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2026-01-01T00:00:00Z",+ });+ await kv.set("mem:facets", "fct_2", {+ id: "fct_2",+ targetId: "mem_b",+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2026-01-01T00:00:00Z",+ });++ const result = await sdk.trigger({+ function_id: "mem::forget",+ payload: { memoryId: "mem_a" },+ });+ expect((result as { deleted: number }).deleted).toBe(1);+ const remaining = await kv.list<{ id: string }>("mem:facets");+ expect(remaining.map((f) => f.id)).toEqual(["fct_2"]);+ });});// Delete paths must tear down the BM25 index entry and synchronouslydiff --git a/test/retention.test.ts b/test/retention.test.tsindex 04677334..fa411f86 100644--- a/test/retention.test.ts+++ b/test/retention.test.ts@@ -329,6 +329,67 @@ describe("RetentionScoring", () => {expect(remainingScores).toHaveLength(0);});+ it("mem::retention-evict removes facets pointing at evicted memories", async () => {+ const { registerRetentionFunctions } = await import(+ "../src/functions/retention.js"+ );++ const sdk = mockSdk();+ const kv = mockKV(+ [makeMemory("mem_evict", "fact", 500), makeMemory("mem_keep", "architecture", 1)],+ [makeSemanticMemory("sem_evict", 500, 0)],+ );+ registerRetentionFunctions(sdk as never, kv as never);++ const scoreRow = (memoryId: string, source: "episodic" | "semantic", score: number) => ({+ memoryId,+ source,+ score,+ salience: score,+ temporalDecay: score,+ reinforcementBoost: 0,+ lastAccessed: new Date().toISOString(),+ accessCount: 0,+ });+ await kv.set("mem:retention", "mem_evict", scoreRow("mem_evict", "episodic", 0.01));+ await kv.set("mem:retention", "sem_evict", scoreRow("sem_evict", "semantic", 0.01));+ await kv.set("mem:retention", "mem_keep", scoreRow("mem_keep", "episodic", 0.99));++ await kv.set("mem:facets", "fct_mem", {+ id: "fct_mem",+ targetId: "mem_evict",+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2026-01-01T00:00:00Z",+ });+ await kv.set("mem:facets", "fct_sem", {+ id: "fct_sem",+ targetId: "sem_evict",+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2026-01-01T00:00:00Z",+ });+ await kv.set("mem:facets", "fct_keep", {+ id: "fct_keep",+ targetId: "mem_keep",+ targetType: "memory",+ dimension: "probe",+ value: "value",+ createdAt: "2026-01-01T00:00:00Z",+ });++ const result = (await sdk.trigger({+ function_id: "mem::retention-evict",+ payload: { threshold: 0.9 },+ })) as any;++ expect(result.evicted).toBe(2);+ const remaining = await kv.list<{ id: string }>("mem:facets");+ expect(remaining.map((f) => f.id)).toEqual(["fct_keep"]);+ });+it("mem::retention-evict emits a single batched audit record on success (audit policy)", async () => {const { registerRetentionFunctions } = await import("../src/functions/retention.js"