@danielsimonjr/memory-mcp 12.8.3 → 12.9.0

package/README.md

@@ -178,14 +178,14 @@ git clone https://github.com/danielsimonjr/memory-mcp.git
 cd memory-mcp
 
 # Install and build
-npm install
-npm run build
+bun install
+bun run build
 
-# Run tests (791 tests, ~85% statement coverage)
-npm test
+# Run tests (794 tests, ~85% statement coverage)
+bun run test
 
 # Type check
-npm run typecheck
+bun run typecheck
 ```
 
 ### Claude Desktop Configuration
@@ -774,20 +774,20 @@ node dist/migrate-from-jsonl-to-sqlite.js --from memory.db --to memory.jsonl
 
 ### Prerequisites
 
-- Node.js 18+
-- npm 9+
-- TypeScript 5.6+
+- Bun 1.4+ (install + scripts; `bun.lock` is authoritative)
+- Node.js 22+ (shipped runtime — CI smokes `dist/` under Node)
+- TypeScript 7+
 
 ### Build Commands
 
 ```bash
-npm install           # Install dependencies
-npm run build         # Build TypeScript
-npm test              # Run tests (791 tests across 36 files; ~85% coverage)
-npm run typecheck     # Strict type checking
-npm run watch         # Development watch mode
-npm run clean         # Remove dist/ directory
-npm run docs:deps     # Generate dependency graph
+bun install           # Install dependencies
+bun run build         # Build TypeScript
+bun run test          # Run tests (794 tests across 37 files; ~85% coverage)
+bun run typecheck     # Strict type checking
+bun run watch         # Development watch mode
+bun run clean         # Remove dist/ directory
+bun run docs:deps     # Generate dependency graph
 ```
 
 ### Architecture

package/dist/server/toolHandlers.d.ts

@@ -8,6 +8,15 @@
  * @module server/toolHandlers
  */
 import { formatToolResponse, type ManagerContext } from '@danielsimonjr/memoryjs';
+/**
+ * Read the active project scope for a context.
+ *
+ * The scope is per-context session state set by the `set_project_scope` tool.
+ * It is held in a WeakMap because `ctx.defaultProjectId` is readonly.
+ *
+ * @param ctx - The manager context to read the scope from.
+ * @returns The active project id, or `undefined` when no scope is set.
+ */
 export declare function getActiveProjectScope(ctx: ManagerContext): string | undefined;
 /**
  * Tool response type for MCP SDK compatibility.

package/dist/server/toolHandlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolHandlers.d.ts","sourceRoot":"","sources":["../../src/server/toolHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,kBAAkB,EA2ClB,KAAK,cAAc,EAyBpB,MAAM,yBAAyB,CAAC;AAyBjC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE7E;AAgFD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;AAiF3B,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAuuGpD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAiBvB"}
+{"version":3,"file":"toolHandlers.d.ts","sourceRoot":"","sources":["../../src/server/toolHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,kBAAkB,EA2ClB,KAAK,cAAc,EAyBpB,MAAM,yBAAyB,CAAC;AAyBjC;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE7E;AAgFD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;AAiF3B,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAkvGpD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAiBvB"}

package/dist/server/toolHandlers.js

@@ -29,6 +29,15 @@ const queryCostEstimatorMap = new WeakMap();
 // `set_project_scope` tool; handlers may consult `getActiveProjectScope(ctx)`
 // when they want to auto-apply the scope.
 const projectScopeMap = new WeakMap();
+/**
+ * Read the active project scope for a context.
+ *
+ * The scope is per-context session state set by the `set_project_scope` tool.
+ * It is held in a WeakMap because `ctx.defaultProjectId` is readonly.
+ *
+ * @param ctx - The manager context to read the scope from.
+ * @returns The active project id, or `undefined` when no scope is set.
+ */
 export function getActiveProjectScope(ctx) {
     return projectScopeMap.get(ctx);
 }
@@ -1244,6 +1253,17 @@ export const toolHandlers = {
             return formatTextResponse('No active consolidation scheduler found. Start one first with start_consolidation.');
         }
         scheduler.stop();
+        // `stop()` clears the interval but cannot cancel a cycle already running:
+        // `runConsolidationCycle` checks `running` only on entry, then awaits a full
+        // graph save. `start()` fires one cycle IMMEDIATELY -- it does not wait for
+        // the interval, which defaults to an hour -- so a start/stop pair always
+        // leaves a write in flight. Returning "stopped" there is a lie the caller
+        // acts on: teardown that deletes the storage directory races the write and
+        // logs `ConsolidationScheduler cycle error: ENOENT ... memory.jsonl.tmp.*`.
+        // memoryjs 4.2.0 exposes that cycle as `initialCyclePromise`; awaiting it
+        // makes "stopped" mean quiesced. The cycle handles its own errors, so this
+        // settles rather than rejects.
+        await scheduler.initialCyclePromise;
         return formatTextResponse('Consolidation scheduler stopped');
     },
     run_consolidation_now: async (ctx) => {

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@danielsimonjr/memory-mcp",
-  "version": "12.8.3",
+  "version": "12.9.0",
   "description": "Enhanced MCP memory server with hierarchies, compression, archiving, graph algorithms, semantic search, temporal KG, RBAC, bitemporal validity, OCC, procedural memory, causal reasoning, world model, do_not_remember exclusions, decision rationale, project context, heuristic guidelines, tool affordance + observer, observation dedup, spell correction, event memory, reconstructive memory, relation consolidation, agent reflection, and 241 advanced tools",
   "license": "MIT",
+  "packageManager": "bun@1.4.2",
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.0.0",
+    "bun": ">=1.4.2"
   },
   "author": "Daniel Simon Jr. (https://github.com/danielsimonjr)",
   "homepage": "https://github.com/danielsimonjr/memory-mcp",
@@ -48,7 +50,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepare": "npm run build",
+    "prepare": "tsc",
     "watch": "tsc --watch",
     "test": "vitest run --coverage",
     "typecheck": "tsc --noEmit --noUnusedLocals --noUnusedParameters --strict",
@@ -58,20 +60,20 @@
     "tools:build": "cd tools/chunking-for-files && npm run build && cd ../compress-for-context && npm run build && cd ../create-dependency-graph && npm run build && cd ../migrate-from-jsonl-to-sqlite && npm run build"
   },
   "dependencies": {
-    "@danielsimonjr/memoryjs": "^3.3.1",
+    "@danielsimonjr/memoryjs": "^4.2.0",
     "@modelcontextprotocol/core": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
-    "zod": "^4.4.3"
+    "zod": "^4.6.2"
   },
   "overrides": {
-    "better-sqlite3": "^12.11.1"
+    "better-sqlite3": "^13.0.3"
   },
   "devDependencies": {
     "@types/node": "^26",
-    "@vitest/coverage-v8": "^4.1.11",
+    "@vitest/coverage-v8": "^5.0.0",
     "esbuild": "^0.28.2",
     "shx": "^0.4.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.5"
+    "vitest": "^5.0.0"
   }
 }