Skip to content

#1 Persistent memory for AI coding agents based on real-world benchmarks

fix(facets): cascade facet deletion on memory delete (#1591)

DimitriChrysafis4ab436e717e3
diff --git a/AGENTS.md b/AGENTS.md
index 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` extension
diff --git a/README.md b/README.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md
index 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
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 3,600+ tests
+npm test # 3,700+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/assets/tags/light/stat-tests.svg b/assets/tags/light/stat-tests.svg
index 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.svg
index 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.json
index 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.ts
index 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 = memories
diff --git a/src/functions/evict.ts b/src/functions/evict.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 (see
diff --git a/test/auto-forget.test.ts b/test/auto-forget.test.ts
index 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.ts
index 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.ts
index 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.ts
index 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 synchronously
diff --git a/test/retention.test.ts b/test/retention.test.ts
index 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"