rag-memory-epf-mcp 6.0.1 → 6.3.0

package/README.md

@@ -16,7 +16,7 @@ A **project-local RAG memory** MCP server — knowledge graph + multilingual vec
 - **38 MCP tools** — knowledge graph CRUD, observation lifecycle (correct / retract / history), document pipeline, hybrid search, multi-hop traversal, graph analytics (centrality / community detection / structure), export/import, temporal queries
 - **Observations that hold their history** — corrections supersede instead of overwrite, search returns only current facts, and every revision keeps its provenance
 - **Structure-anchored chunking (c1, v5)** — boundaries anchor to markdown structure (fence-aware, H1–H4 first, block-greedy, exact-token fallback), so editing the top of a file no longer re-embeds the whole document: unchanged text reuses its stored vectors at sync time. Chunk offsets are Unicode codepoints, language-neutral across SQL `substr`, Python slicing, and JS `[...str]` iteration; a publish-time invariant gate locks the gap-free partition. `overlap` is retired (omit or 0).
-- **SQLite optimized** — WAL mode, 32MB cache, 256MB mmap, FTS5 triggers, 7 indexes
+- **SQLite optimized** — WAL mode, 32MB cache, FTS5 triggers, 7 indexes; mmap is opt-in (`RAG_MEMORY_MMAP_SIZE`, default 0 since 6.3.0 — see Environment Variables)
 - **MCP SDK 1.27.1** — Tool Annotations (readOnly/destructive/idempotent), latest protocol 2025-11-25
 
 ## Quick Start
@@ -145,7 +145,8 @@ storeDocument(id, content, metadata)
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `DB_FILE_PATH` | `rag-memory.db` (server dir) | Path to project-local SQLite database |
+| `DB_FILE_PATH` | `rag-memory.db` (server dir) | Path to project-local SQLite database. A **relative** path resolves against the server's working directory (since 6.3.0; before that it resolved against the package install directory, which under `npx` is the npm cache) |
+| `RAG_MEMORY_MMAP_SIZE` | `0` | SQLite `mmap_size` in bytes. **Off by default since 6.3.0** — with mmap on, one writer + two readers on a Google Drive folder (Windows) produced `database disk image is malformed` reads; set e.g. `268435456` to restore the previous behaviour. The applied value is printed in the boot banner (`| mmap <n>`) |
 | `EMBEDDING_MODEL` | `Xenova/bge-m3` | HuggingFace model ID for embeddings |
 | `RAG_MEMORY_EMBEDDINGS` | `lazy` | Boot mode: `lazy` (connect instantly, model loads in background), `eager` (wait for model + reconciliation, pre-3.6 behavior), `off` (never load the model — FTS5-only, zero download) |
 | `RAG_MEMORY_MODEL_CACHE_DIR` | OS user cache | Version-independent model cache location (see `docs/UPDATING.md`) |
@@ -153,6 +154,44 @@ storeDocument(id, content, metadata)
 
 ## Changelog
 
+### v6.3.0 (2026-09-16)
+
+- **Changed — a relative `DB_FILE_PATH` now resolves against the server's working directory.** It used
+  to resolve against the package install directory, which under `npx` is the npm cache: a relative
+  value opened a database in a place nobody looks, with no error. Absolute paths and the unset default
+  are unchanged. (Framework spec 2026-09-14 §11-1.) If you relied on the old install-directory
+  resolution of a relative path, set an absolute path.
+- **Changed — SQLite `mmap_size` is opt-in, default 0.** Measured 2026-09-15 on a Google Drive folder
+  (Windows, WAL): with mmap 256 MB, one writer + two readers produced 373,684 `database disk image is
+  malformed` reads in 20 s; with mmap 0, none. `RAG_MEMORY_MMAP_SIZE=<bytes>` restores it; the boot
+  banner reports the applied value. (Spec §11-2.)
+
+### v6.1.0
+
+**Versioning note.** This content was tagged `v6.0.2` locally before release, but npm never received
+a 6.0.2 — it published as **6.1.0**. Coming from any 6.0.x, upgrading to 6.1.0 brings exactly this
+fix.
+
+- **Fixed — a failure mid-deletion could leave partial state.** Deleting an entity ran its cleanup
+  steps (embeddings → chunk associations → relationships → the entity row) with no wrapping
+  transaction, so a failure in the middle committed the earlier steps: embeddings and links purged
+  while the entity itself survived. Each entity's deletion is now one transaction — any step fails,
+  that entity's whole sequence rolls back. Batch semantics are unchanged: other entities still
+  proceed when one fails.
+- **Fixed — deleting an entity left its knowledge-graph chunks behind.** Two gaps compounded: the
+  delete path never invoked the entity-chunk sweeper, and KG relationship chunks are keyed by
+  `relationship_id`, so once the relationship rows were deleted their ids could no longer be found
+  and those chunks dangled forever — still vector-searchable after both of their endpoints were
+  gone. Deletion now captures relationship ids *before* removing the rows and sweeps both: stale
+  entity chunks via the existing `deleteStaleKgChunks`, captured relationship chunks via the new
+  `deleteKgRelationshipChunks` projection helper. Practical exposure today is bounded — the chunk
+  generation path is dormant (not tool-exposed) — but once seeded these chunks stay retrievable
+  unless swept here.
+- Regression: `test/delete-entities-kg-hygiene.test.mjs` (registered in `verify:engine`) covers both,
+  verified RED before the fix; a mutation check confirms that removing the transaction reproduces the
+  partial state (`entities_alive=1` with `relationships_left=0`). Full suite green (`npm test`,
+  46-call chain).
+
 ### v6.0.1
 
 **Versioning note.** Both changes below stop links from being created that should never have been

package/dist/index.d.ts

@@ -4,6 +4,8 @@ import { EmbeddingGate } from './src/embeddingGate.js';
 import type { EmbedPriority } from './src/embeddingGate.js';
 import { BackfillCoordinator } from './src/backfillCoordinator.js';
 export declare function compileFtsLiteralQuery(q: string): string | null;
+export declare function resolveDbFilePath(envValue: string | undefined, cwd: string, serverDir: string): string;
+export declare function parseMmapSize(raw: string | undefined): number;
 interface Entity {
     name: string;
     entityType: string;
@@ -71,6 +73,7 @@ export declare class RAGKnowledgeGraphManager {
     grandfatherAllowed: boolean;
     coordinator: BackfillCoordinator | null;
     readonly calendarTimeZone: string;
+    mmapApplied: number;
     private embeddingCache;
     private readonly EMBEDDING_CACHE_MAX;
     private dictionaryCache;

package/dist/index.js

@@ -22,7 +22,7 @@ import { getAllMCPTools, validateToolArgs, getSystemInfo } from './src/tools/too
 // Import migration system
 import { MigrationManager } from './src/migrations/migration-manager.js';
 import { backupBeforeMigration } from './src/backup/preflight.js';
-import { rebuildProjection, deleteStaleKgChunks } from './src/observations/projection.js';
+import { rebuildProjection, deleteStaleKgChunks, deleteKgRelationshipChunks } from './src/observations/projection.js';
 import { addRevision, correctRevision, transitionStatus, linkSources, nextProjectionOrder } from './src/observations/lifecycle.js';
 import { getObservationHistory } from './src/observations/history.js';
 // Import chunk text algorithm (extracted for publish-time invariant testing)
@@ -59,7 +59,7 @@ function sanitizeErrorMessage(msg) {
 }
 // v3.6: startup self-report banner (version reliability — spec §8).
 function printBanner(opts) {
-    console.error(`🚀 rag-memory-epf-mcp v${PKG_VERSION} | node v${process.versions.node} | model ${opts.model}@${opts.revision} (${opts.dtype}) | cache ${opts.cachePath} | db ${opts.dbPath}`);
+    console.error(`🚀 rag-memory-epf-mcp v${PKG_VERSION} | node v${process.versions.node} | model ${opts.model}@${opts.revision} (${opts.dtype}) | cache ${opts.cachePath} | db ${opts.dbPath} | mmap ${opts.mmap}`);
 }
 // v3.6 (spec §5): ONE FTS5 literal-query compiler shared by chunk and entity
 // search — raw user input can never produce MATCH syntax errors or trigger
@@ -79,13 +79,36 @@ export function compileFtsLiteralQuery(q) {
 if (env.backends?.onnx?.wasm) {
     env.backends.onnx.wasm.wasmPaths = './node_modules/@huggingface/transformers/dist/';
 }
-// Define database file path using environment variable with fallback
-const defaultDbPath = path.join(path.dirname(fileURLToPath(import.meta.url)), 'rag-memory.db');
-const DB_FILE_PATH = process.env.DB_FILE_PATH
-    ? path.isAbsolute(process.env.DB_FILE_PATH)
-        ? process.env.DB_FILE_PATH
-        : path.join(path.dirname(fileURLToPath(import.meta.url)), process.env.DB_FILE_PATH)
-    : defaultDbPath;
+// Define database file path using environment variable with fallback.
+// Next release (major candidate; the version is set at release time — framework spec
+// 2026-09-14-universal-mcp-config-design §11-1): a RELATIVE DB_FILE_PATH
+// resolves against the server's working directory (process.cwd()), the way every other CLI tool
+// reads a relative path. Before this it resolved against the package's own install directory —
+// under npx that is the npm cache, so a relative value silently opened a database nobody could
+// find (measured 2026-09-14 on 6.1.0 dist/index.js:83-88) and every framework config had to carry
+// a machine-specific absolute path. The UNSET default is deliberately unchanged (README contract:
+// `rag-memory.db` next to the server); the framework always sets DB_FILE_PATH explicitly instead.
+// Exported so the contract is unit-testable without writing a database into dist/.
+export function resolveDbFilePath(envValue, cwd, serverDir) {
+    if (!envValue)
+        return path.join(serverDir, 'rag-memory.db');
+    return path.isAbsolute(envValue) ? envValue : path.resolve(cwd, envValue);
+}
+const DB_FILE_PATH = resolveDbFilePath(process.env.DB_FILE_PATH, process.cwd(), path.dirname(fileURLToPath(import.meta.url)));
+// Next release (spec §11-2): SQLite mmap is opt-in, default 0 (off). Measured 2026-09-15 (Windows, Google
+// Drive G:, WAL, mmap 256 MB): one writer + two readers -> 373,684 `database disk image is
+// malformed` reads in 20 s; mmap 0 -> 0 errors; local disk -> 0 either way. On macOS Drive the same
+// probe read clean but the WAL grew to ~4 GB in 20 s with mmap on (n=1). The framework opens one
+// DB from several CLIs on synced folders, so correctness wins over an unmeasured read-speed gain.
+// RAG_MEMORY_MMAP_SIZE=<bytes> turns it back on; garbage or negative values count as 0. The value
+// SQLite actually applied is read back and printed in the boot banner (`| mmap <n>`).
+export function parseMmapSize(raw) {
+    if (raw === undefined || raw.trim() === '')
+        return 0;
+    const n = Number(raw);
+    return Number.isFinite(n) && n >= 0 ? Math.floor(n) : 0;
+}
+const MMAP_SIZE = parseMmapSize(process.env.RAG_MEMORY_MMAP_SIZE);
 const EMBEDDING_MODEL = process.env.EMBEDDING_MODEL || 'Xenova/bge-m3';
 // v3.5 default model config — grandfathering legacy vectors is only automatic
 // when the current config matches this (spec §6b custom-model guard). An
@@ -183,6 +206,8 @@ export class RAGKnowledgeGraphManager {
     // The calendar that date-only human labels are written in. Resolved once, here, so an invalid
     // zone fails at construction instead of quietly writing wrong days for weeks.
     calendarTimeZone = resolveCalendarTimeZone(process.env.RAG_MEMORY_CALENDAR_TZ);
+    // The mmap_size SQLite actually applied at initialize() (-1 until then). Banner-only.
+    mmapApplied = -1;
     embeddingCache = new Map();
     EMBEDDING_CACHE_MAX = 500;
     dictionaryCache = null;
@@ -201,7 +226,10 @@ export class RAGKnowledgeGraphManager {
         this.db.pragma('busy_timeout = 5000');
         this.db.pragma('cache_size = -32000');
         this.db.pragma('temp_store = MEMORY');
-        this.db.pragma('mmap_size = 268435456');
+        // Opt-in mmap (see MMAP_SIZE above). Read the applied value back so the banner reports
+        // what SQLite did, not what we asked for (a compile-time cap can lower it silently).
+        this.db.pragma(`mmap_size = ${MMAP_SIZE}`);
+        this.mmapApplied = Number(this.db.pragma('mmap_size', { simple: true }));
         this.db.pragma('foreign_keys = ON');
         // spec §5.2: 관찰 lifecycle 의 무결성은 전부 FK CASCADE 를 전제한다 — root 를 지우면
         // revision 이, revision 을 지우면 source 가 따라가야 history 가 고아로 남지 않는다.
@@ -843,58 +871,76 @@ export class RAGKnowledgeGraphManager {
         console.error(`🗑️ Deleting entities: ${entityNames.join(', ')}`);
         for (const name of entityNames) {
             const entityId = `entity_${name.toLowerCase().replace(/[^\p{L}\p{N}]/gu, '_')}`;
+            // One entity = one transaction. The four deletion steps are a single unit:
+            // a mid-sequence failure must roll back, not leave embeddings/links purged while
+            // the entity itself survives (2026-08-24 audit finding; regression =
+            // test/delete-entities-kg-hygiene.test.mjs ⓒ). Batch semantics are preserved —
+            // other entities still proceed when one fails.
             try {
-                // Check if entity exists first
-                const entityExists = this.db.prepare(`
-          SELECT id FROM entities WHERE id = ?
-        `).get(entityId);
-                if (!entityExists) {
-                    console.warn(`⚠️ Entity '${name}' not found, skipping`);
-                    continue;
-                }
-                // Step 0: Delete entity embeddings
-                const embeddingMetadata = this.db.prepare(`
-          SELECT rowid FROM entity_embedding_metadata WHERE entity_id = ?
-        `).get(entityId);
-                if (embeddingMetadata) {
-                    const embeddings = this.db.prepare(`
-            DELETE FROM entity_embeddings WHERE rowid = ?
-          `).run(embeddingMetadata.rowid);
-                    const metadata = this.db.prepare(`
-            DELETE FROM entity_embedding_metadata WHERE entity_id = ?
-          `).run(entityId);
-                    if (embeddings.changes > 0 || metadata.changes > 0) {
-                        console.error(`  ├─ Removed entity embeddings for '${name}'`);
+                const deleted = this.db.transaction((eid) => {
+                    // Check if entity exists first
+                    const entityExists = this.db.prepare(`
+            SELECT id FROM entities WHERE id = ?
+          `).get(eid);
+                    if (!entityExists)
+                        return false;
+                    // Step 0: Delete entity embeddings
+                    const embeddingMetadata = this.db.prepare(`
+            SELECT rowid FROM entity_embedding_metadata WHERE entity_id = ?
+          `).get(eid);
+                    if (embeddingMetadata) {
+                        const embeddings = this.db.prepare(`
+              DELETE FROM entity_embeddings WHERE rowid = ?
+            `).run(embeddingMetadata.rowid);
+                        const metadata = this.db.prepare(`
+              DELETE FROM entity_embedding_metadata WHERE entity_id = ?
+            `).run(eid);
+                        if (embeddings.changes > 0 || metadata.changes > 0) {
+                            console.error(`  ├─ Removed entity embeddings for '${name}'`);
+                        }
                     }
-                }
-                // Step 1: Delete chunk-entity associations
-                const chunkAssociations = this.db.prepare(`
-          DELETE FROM chunk_entities WHERE entity_id = ?
-        `).run(entityId);
-                if (chunkAssociations.changes > 0) {
-                    console.error(`  ├─ Removed ${chunkAssociations.changes} chunk associations for '${name}'`);
-                }
-                // Step 2: Delete relationships where this entity is involved
-                const relationships = this.db.prepare(`
-          DELETE FROM relationships 
-          WHERE source_entity = ? OR target_entity = ?
-        `).run(entityId, entityId);
-                if (relationships.changes > 0) {
-                    console.error(`  ├─ Removed ${relationships.changes} relationships for '${name}'`);
-                }
-                // Step 3: Finally delete the entity itself
-                const entity = this.db.prepare(`
-          DELETE FROM entities WHERE id = ?
-        `).run(entityId);
-                if (entity.changes > 0) {
+                    // Step 1: Delete chunk-entity associations
+                    const chunkAssociations = this.db.prepare(`
+            DELETE FROM chunk_entities WHERE entity_id = ?
+          `).run(eid);
+                    if (chunkAssociations.changes > 0) {
+                        console.error(`  ├─ Removed ${chunkAssociations.changes} chunk associations for '${name}'`);
+                    }
+                    // Step 2: Capture relationship ids BEFORE deleting the rows — KG relationship
+                    // chunks are keyed by relationship_id, so after the DELETE they could no
+                    // longer be found and would dangle forever.
+                    const relIds = this.db.prepare(`
+            SELECT id FROM relationships
+            WHERE source_entity = ? OR target_entity = ?
+          `).all(eid, eid);
+                    const relationships = this.db.prepare(`
+            DELETE FROM relationships
+            WHERE source_entity = ? OR target_entity = ?
+          `).run(eid, eid);
+                    if (relationships.changes > 0) {
+                        console.error(`  ├─ Removed ${relationships.changes} relationships for '${name}'`);
+                    }
+                    // Step 2b: KG hygiene — sweep stale entity chunks and chunks of the captured
+                    // relationships. The generation path is dormant today (generateKnowledgeGraphChunks
+                    // is not tool-exposed), but once seeded these chunks stay vector-searchable after
+                    // deletion unless swept here (same fail-closed rationale as deleteStaleKgChunks).
+                    deleteStaleKgChunks(this.db, eid);
+                    deleteKgRelationshipChunks(this.db, relIds.map(r => r.id));
+                    // Step 3: Finally delete the entity itself (FK CASCADE takes observation lifecycle rows)
+                    const entity = this.db.prepare(`
+            DELETE FROM entities WHERE id = ?
+          `).run(eid);
+                    return entity.changes > 0;
+                })(entityId);
+                if (deleted) {
                     console.error(`  └─ Deleted entity '${name}' successfully`);
                 }
                 else {
-                    console.warn(`  └─ Entity '${name}' was not deleted (possibly already removed)`);
+                    console.warn(`⚠️ Entity '${name}' not found, skipping`);
                 }
             }
             catch (error) {
-                console.error(`❌ Failed to delete entity '${name}':`, error);
+                console.error(`❌ Failed to delete entity '${name}' (transaction rolled back, continuing):`, error);
                 // Continue with other entities instead of failing completely
             }
         }
@@ -4157,6 +4203,7 @@ async function main() {
             model: EMBEDDING_MODEL, revision: MODEL_REVISION, dtype: MODEL_DTYPE,
             cachePath: resolveModelCacheDir(process.env, process.platform, os.homedir()),
             dbPath: DB_FILE_PATH,
+            mmap: ragKgManager.mmapApplied,
         });
         if (ragKgManager.embeddingsMode === 'eager') {
             // eager = wait for BOTH the first model load attempt and reconciliation to

package/dist/src/observations/projection.d.ts

@@ -1,3 +1,4 @@
 import type Database from 'better-sqlite3';
 export declare function rebuildProjection(db: Database.Database, entityId: string): void;
 export declare function deleteStaleKgChunks(db: Database.Database, entityId: string): number;
+export declare function deleteKgRelationshipChunks(db: Database.Database, relationshipIds: string[]): number;

package/dist/src/observations/projection.js

@@ -29,3 +29,20 @@ export function deleteStaleKgChunks(db, entityId) {
     }
     return n;
 }
+// relationship 청크는 relationship_id 키라 엔티티 삭제만으로는 잡을 수 없다 —
+// 호출자가 relationships 행을 지우기 전에 id 를 캡처해서 넘겨야 한다(deleteEntities 계약).
+// 넘어온 id 중 이미 없는 것은 무시한다(멱등). 벡터 행을 먼저 지우는 것은 deleteStaleKgChunks 와 같다.
+export function deleteKgRelationshipChunks(db, relationshipIds) {
+    if (relationshipIds.length === 0)
+        return 0;
+    let n = 0;
+    for (const rid of relationshipIds) {
+        const chunks = db.prepare(`SELECT rowid FROM chunk_metadata WHERE chunk_type = 'relationship' AND relationship_id = ?`).all(rid);
+        for (const c of chunks) {
+            db.exec(`DELETE FROM chunks WHERE rowid = ${Number(c.rowid)}`);
+            db.prepare(`DELETE FROM chunk_metadata WHERE rowid = ?`).run(c.rowid);
+            n++;
+        }
+    }
+    return n;
+}

package/package.json

@@ -1,71 +1,71 @@
 {
-  "name": "rag-memory-epf-mcp",
-  "version": "6.0.1",
-  "engines": {
-    "node": ">=24"
-  },
-  "description": "Project-local RAG memory MCP server — knowledge graph + multilingual vector + FTS5 in a single SQLite file. Per-project isolation, 38 MCP tools, codepoint-safe chunking (Korean/CJK/emoji).",
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "rag",
-    "knowledge-graph",
-    "vector-search",
-    "fts5",
-    "sqlite",
-    "embeddings",
-    "bge-m3",
-    "multilingual",
-    "korean",
-    "claude-code",
-    "gemini-cli",
-    "codex-cli",
-    "memory",
-    "agent-memory"
-  ],
-  "license": "MIT",
-  "author": "bripin123",
-  "homepage": "https://github.com/bripin123/rag-memory-epf-mcp",
-  "bugs": "https://github.com/bripin123/rag-memory-epf-mcp/issues",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/bripin123/rag-memory-epf-mcp.git"
-  },
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "rag-memory-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "docs/UPDATING.md"
-  ],
-  "scripts": {
-    "build": "tsc && shx chmod +x dist/*.js",
-    "prepare": "npm run build",
-    "watch": "tsc --watch",
-    "verify:invariants": "node test/chunk-invariants.test.mjs",
-    "verify:engine": "node test/engine-smoke.test.mjs && node test/launch-smoke.test.mjs && node test/sync-atomicity.test.mjs && node test/dedup.test.mjs && node test/search-degradation.test.mjs && node test/entity-embed-cap.test.mjs && node test/migration12.test.mjs && node test/model-cache.test.mjs && node test/embedding-gate.test.mjs && node test/lazy-boot.test.mjs && node test/reconciliation.test.mjs && node test/backfill.test.mjs && node test/fts-query.test.mjs && node test/search-contracts.test.mjs && node test/tool-contracts.test.mjs && node test/bounded-exit.test.mjs && node test/observation-schema.test.mjs && node test/search-graph-default.test.mjs && node test/observation-migration.test.mjs && node test/observation-lifecycle.test.mjs && node test/observation-contracts.test.mjs && node test/observation-search.test.mjs && node test/observation-cascade.test.mjs && node test/observation-realdata.test.mjs && node test/chunker-c.test.mjs && node test/migration14.test.mjs && node test/chunk-params-validation.test.mjs && node test/vector-reuse.test.mjs && node test/entity-range-linking.test.mjs && node test/alias-link-gate.test.mjs && node test/entity-name-boundary.test.mjs && node test/stats-chunking.test.mjs && node test/migration14-realdata.test.mjs && node test/migration14-realdata-sync.test.mjs && node test/search-summaries-off.test.mjs && node test/document-return-contracts.test.mjs && node test/observation-date-prefix.test.mjs && node test/delete-entities-cascade.test.mjs && node test/backup-publish-portable.test.mjs && node test/graph-context-explain.test.mjs && node test/eval-graph-role-libs.test.mjs && node test/eval-graph-role-t5b.test.mjs && node --test test/eval-graph-role-t8-fix.test.mjs && node --test test/eval-graph-role-t7-upstream.test.mjs && node --test test/eval-graph-role-t11-decision.test.mjs && node --test test/eval-graph-role-prereq-fix.test.mjs",
-    "test": "npm run build && npm run verify:invariants && npm run verify:engine",
-    "prepublishOnly": "npm run build && npm run verify:invariants && npm run verify:engine"
-  },
-  "dependencies": {
-    "@huggingface/transformers": "^3.5.1",
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "better-sqlite3": "^12.8.0",
-    "graphology": "^0.26.0",
-    "graphology-communities-louvain": "^2.0.2",
-    "graphology-metrics": "^2.4.0",
-    "graphology-shortest-path": "^2.1.0",
-    "graphology-types": "^0.24.8",
-    "sqlite-vec": "^0.1.7",
-    "tiktoken": "^1.0.17",
-    "zod": "^3.25.28"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.12",
-    "@types/node": "^24",
-    "shx": "^0.3.4",
-    "typescript": "^5.6.2"
-  }
+ "name": "rag-memory-epf-mcp",
+ "version": "6.3.0",
+ "engines": {
+  "node": ">=24"
+ },
+ "description": "Project-local RAG memory MCP server — knowledge graph + multilingual vector + FTS5 in a single SQLite file. Per-project isolation, 38 MCP tools, codepoint-safe chunking (Korean/CJK/emoji).",
+ "keywords": [
+  "mcp",
+  "model-context-protocol",
+  "rag",
+  "knowledge-graph",
+  "vector-search",
+  "fts5",
+  "sqlite",
+  "embeddings",
+  "bge-m3",
+  "multilingual",
+  "korean",
+  "claude-code",
+  "gemini-cli",
+  "codex-cli",
+  "memory",
+  "agent-memory"
+ ],
+ "license": "MIT",
+ "author": "bripin123",
+ "homepage": "https://github.com/bripin123/rag-memory-epf-mcp",
+ "bugs": "https://github.com/bripin123/rag-memory-epf-mcp/issues",
+ "repository": {
+  "type": "git",
+  "url": "git+https://github.com/bripin123/rag-memory-epf-mcp.git"
+ },
+ "type": "module",
+ "main": "dist/index.js",
+ "bin": {
+  "rag-memory-mcp": "dist/index.js"
+ },
+ "files": [
+  "dist",
+  "docs/UPDATING.md"
+ ],
+ "scripts": {
+  "build": "tsc && shx chmod +x dist/*.js",
+  "prepare": "npm run build",
+  "watch": "tsc --watch",
+  "verify:invariants": "node test/chunk-invariants.test.mjs",
+  "verify:engine": "node test/engine-smoke.test.mjs && node test/launch-smoke.test.mjs && node test/sync-atomicity.test.mjs && node test/dedup.test.mjs && node test/search-degradation.test.mjs && node test/entity-embed-cap.test.mjs && node test/migration12.test.mjs && node test/model-cache.test.mjs && node test/embedding-gate.test.mjs && node test/lazy-boot.test.mjs && node test/reconciliation.test.mjs && node test/backfill.test.mjs && node test/fts-query.test.mjs && node test/search-contracts.test.mjs && node test/tool-contracts.test.mjs && node test/bounded-exit.test.mjs && node test/observation-schema.test.mjs && node test/search-graph-default.test.mjs && node test/observation-migration.test.mjs && node test/observation-lifecycle.test.mjs && node test/observation-contracts.test.mjs && node test/observation-search.test.mjs && node test/observation-cascade.test.mjs && node test/observation-realdata.test.mjs && node test/chunker-c.test.mjs && node test/migration14.test.mjs && node test/chunk-params-validation.test.mjs && node test/vector-reuse.test.mjs && node test/entity-range-linking.test.mjs && node test/alias-link-gate.test.mjs && node test/entity-name-boundary.test.mjs && node test/stats-chunking.test.mjs && node test/migration14-realdata.test.mjs && node test/migration14-realdata-sync.test.mjs && node test/search-summaries-off.test.mjs && node test/document-return-contracts.test.mjs && node test/observation-date-prefix.test.mjs && node test/delete-entities-cascade.test.mjs && node test/delete-entities-kg-hygiene.test.mjs && node test/backup-publish-portable.test.mjs && node test/graph-context-explain.test.mjs && node test/eval-graph-role-libs.test.mjs && node test/eval-graph-role-t5b.test.mjs && node --test test/eval-graph-role-t8-fix.test.mjs && node --test test/eval-graph-role-t7-upstream.test.mjs && node --test test/eval-graph-role-t11-decision.test.mjs && node --test test/eval-graph-role-prereq-fix.test.mjs && node test/db-path.test.mjs && node test/mmap-option.test.mjs",
+  "test": "npm run build && npm run verify:invariants && npm run verify:engine",
+  "prepublishOnly": "npm run build && npm run verify:invariants && npm run verify:engine"
+ },
+ "dependencies": {
+  "@huggingface/transformers": "^3.5.1",
+  "@modelcontextprotocol/sdk": "^1.27.1",
+  "better-sqlite3": "^12.8.0",
+  "graphology": "^0.26.0",
+  "graphology-communities-louvain": "^2.0.2",
+  "graphology-metrics": "^2.4.0",
+  "graphology-shortest-path": "^2.1.0",
+  "graphology-types": "^0.24.8",
+  "sqlite-vec": "^0.1.7",
+  "tiktoken": "^1.0.17",
+  "zod": "^3.25.28"
+ },
+ "devDependencies": {
+  "@types/better-sqlite3": "^7.6.12",
+  "@types/node": "^24",
+  "shx": "^0.3.4",
+  "typescript": "^5.6.2"
+ }
 }