@lotargo/memory_plugin 1.5.3 → 1.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +138 -0
- package/README.md +406 -352
- package/mcp-server/admin/auth.js +13 -4
- package/mcp-server/admin/snapshot.js +24 -7
- package/mcp-server/boot.js +43 -0
- package/mcp-server/cli/direct_commands.js +334 -313
- package/mcp-server/cli/handlers/engine_actions.js +41 -0
- package/mcp-server/cli/handlers/storage_actions.js +58 -0
- package/mcp-server/cli/secret_input.js +44 -0
- package/mcp-server/cli/ui.js +564 -565
- package/mcp-server/cli.js +356 -324
- package/mcp-server/cli_boot.js +37 -0
- package/mcp-server/config/auth_store.js +74 -16
- package/mcp-server/config/config_manager.js +4 -0
- package/mcp-server/db/database.js +33 -14
- package/mcp-server/db/sync_queue.js +9 -19
- package/mcp-server/index.js +112 -42
- package/mcp-server/ingest/normalizer.js +116 -29
- package/mcp-server/ingest/pipeline.js +94 -6
- package/mcp-server/logger.js +49 -0
- package/mcp-server/memory.js +6 -9
- package/mcp-server/ml/gpu_monitor.js +169 -166
- package/mcp-server/ml/model_manager.js +17 -4
- package/mcp-server/preinstall.js +23 -2
- package/mcp-server/retrieval/retriever.js +35 -15
- package/mcp-server/security/path_guard.js +67 -0
- package/mcp-server/setup.js +10 -2
- package/mcp-server/storage/blob_store.js +15 -2
- package/mcp-server/tools/core/memory_core.js +393 -0
- package/mcp-server/tools/helpers.js +59 -39
- package/mcp-server/tools/memory_tools.js +123 -516
- package/mcp-server/tools/rag_tools.js +49 -1
- package/opencode-plugin/index.js +94 -397
- package/package.json +13 -4
- package/skills/using-memory/SKILL.md +7 -2
package/package.json
CHANGED
|
@@ -1,20 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lotargo/memory_plugin",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.6.1",
|
|
4
4
|
"description": "100% local hybrid RAG memory for AI coding agents (OpenCode, Claude Code, Codex, Antigravity). MCP server + plugin: persistent user facts, document ingestion, vector + SQLite FTS5 retrieval across sessions.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "opencode-plugin/index.js",
|
|
7
7
|
"scripts": {
|
|
8
8
|
"preinstall": "node mcp-server/preinstall.js || true",
|
|
9
9
|
"test": "node tests/run_all.js",
|
|
10
|
+
"smoke": "node tests/smoke/e2e_real_embeddings.test.js",
|
|
10
11
|
"benchmark": "node mcp-server/benchmarks/run_benchmarks.js"
|
|
11
12
|
},
|
|
12
13
|
"bin": {
|
|
13
|
-
"memory_plugin": "mcp-server/
|
|
14
|
-
"memory-agent": "mcp-server/
|
|
15
|
-
"memory-cli": "mcp-server/
|
|
14
|
+
"memory_plugin": "mcp-server/boot.js",
|
|
15
|
+
"memory-agent": "mcp-server/boot.js",
|
|
16
|
+
"memory-cli": "mcp-server/cli_boot.js"
|
|
16
17
|
},
|
|
17
18
|
"files": [
|
|
19
|
+
"CHANGELOG.md",
|
|
18
20
|
"opencode-plugin",
|
|
19
21
|
"mcp-server/admin",
|
|
20
22
|
"mcp-server/cli",
|
|
@@ -24,12 +26,16 @@
|
|
|
24
26
|
"mcp-server/ingest",
|
|
25
27
|
"mcp-server/ml",
|
|
26
28
|
"mcp-server/retrieval",
|
|
29
|
+
"mcp-server/security",
|
|
27
30
|
"mcp-server/storage",
|
|
28
31
|
"mcp-server/tools",
|
|
32
|
+
"mcp-server/boot.js",
|
|
33
|
+
"mcp-server/cli_boot.js",
|
|
29
34
|
"mcp-server/cli.js",
|
|
30
35
|
"mcp-server/index.js",
|
|
31
36
|
"mcp-server/fact_format.js",
|
|
32
37
|
"mcp-server/identity.js",
|
|
38
|
+
"mcp-server/logger.js",
|
|
33
39
|
"mcp-server/memory.js",
|
|
34
40
|
"mcp-server/setup.js",
|
|
35
41
|
"mcp-server/preinstall.js",
|
|
@@ -64,6 +70,9 @@
|
|
|
64
70
|
],
|
|
65
71
|
"author": "Lotargo",
|
|
66
72
|
"license": "MIT",
|
|
73
|
+
"engines": {
|
|
74
|
+
"node": ">=22.5.0"
|
|
75
|
+
},
|
|
67
76
|
"publishConfig": {
|
|
68
77
|
"access": "public"
|
|
69
78
|
},
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: using-memory
|
|
3
|
-
description: Comprehensive guide for using the Memory, Hybrid RAG Knowledge Engine & MCP Helper tools (remember, recall, get_fact, forget, update_fact, memory_info, link_knowledge, link_project_memory, unlink_project_memory, relink_project_memory, ingest_document, query_knowledge_base, manage_knowledge_base, list-mcp-tools, mcp-reminder). Trigger proactively whenever user preferences, project conventions, technology stack choices, or architecture decisions are introduced, or when querying ingested documentation, indexing files/repos, managing persistent knowledge, or looking up available MCP tool integrations.
|
|
3
|
+
description: Comprehensive guide for using the Memory, Hybrid RAG Knowledge Engine & MCP Helper tools (remember, recall, get_fact, forget, update_fact, memory_info, link_knowledge, link_project_memory, unlink_project_memory, relink_project_memory, ingest_document, query_knowledge_base, manage_knowledge_base, reindex_knowledge_base, list-mcp-tools, mcp-reminder). Trigger proactively whenever user preferences, project conventions, technology stack choices, or architecture decisions are introduced, or when querying ingested documentation, indexing files/repos, managing persistent knowledge, or looking up available MCP tool integrations.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Using Memory, Hybrid RAG Knowledge Engine & MCP Helper Tools
|
|
@@ -34,6 +34,7 @@ You have access to a persistent dual-layer memory engine supercharged with an **
|
|
|
34
34
|
| User asks a complex question about indexed docs or code | `query_knowledge_base` | `query`, `limit`, `instruction`, `generateEmbeddings` |
|
|
35
35
|
| Read full raw content of an ambiguous/abstract document | `manage_knowledge_base` | `action: "read_document"`, `docId` |
|
|
36
36
|
| View DB stats, list indexed docs, read/delete docs, export/import snapshots | `manage_knowledge_base` | `action` ("stats", "list", "read_document", "delete", "export_snapshot", "import_snapshot"), `docId`, `snapshotPath` |
|
|
37
|
+
| Re-embed all documents after switching embedding model / dimension | `reindex_knowledge_base` | `model`, `dimension` (optional; defaults to active config) |
|
|
37
38
|
| Discover available MCP servers and their specific purposes | `list-mcp-tools` | — |
|
|
38
39
|
| Ask which MCP tool / server is suitable for a specific task | `mcp-reminder` | `task` (string, e.g., "db migration") |
|
|
39
40
|
|
|
@@ -114,7 +115,7 @@ Project stores are bound to Git-based project identities (`git:remote` or `git:l
|
|
|
114
115
|
|
|
115
116
|
---
|
|
116
117
|
|
|
117
|
-
## 3. Layer 2: RAG Knowledge Base (`ingest_document`, `query_knowledge_base`, `manage_knowledge_base`)
|
|
118
|
+
## 3. Layer 2: RAG Knowledge Base (`ingest_document`, `query_knowledge_base`, `manage_knowledge_base`, `reindex_knowledge_base`)
|
|
118
119
|
|
|
119
120
|
### Document Ingestion (`ingest_document`)
|
|
120
121
|
Use this tool when adding technical documentation, API specs, architectural documents, or code repos into the searchable knowledge base.
|
|
@@ -177,6 +178,10 @@ In such cases, use the **Full Raw Document Reading** mechanism:
|
|
|
177
178
|
- Use `action: "export_snapshot"` with `snapshotPath` to export a JSON backup of the RAG base.
|
|
178
179
|
- Use `action: "import_snapshot"` with `snapshotPath` to import and merge a JSON backup into the current database.
|
|
179
180
|
|
|
181
|
+
### Re-Indexing Embeddings (`reindex_knowledge_base`)
|
|
182
|
+
Use this tool AFTER changing the embedding model or vector dimension so previously ingested documents remain vector-searchable.
|
|
183
|
+
- Both `model` and `dimension` are optional and default to the active configuration; vectors are recomputed in batches while documents, sections, FTS index, graph edges, and fact links are preserved.
|
|
184
|
+
|
|
180
185
|
---
|
|
181
186
|
|
|
182
187
|
## 4. General MCP Helpers (`list-mcp-tools`, `mcp-reminder`)
|