From e73424b7855d3c1da7eabc78d147aa404f9d56ad Mon Sep 17 00:00:00 2001 From: leduclinh Date: Mon, 2 Feb 2026 17:44:30 +0900 Subject: [PATCH 1/4] chore: restrict Node.js to LTS versions (18, 20, 22) better-sqlite3 only has prebuilt binaries for LTS versions. Non-LTS versions (19, 21, 23) require Visual Studio Build Tools on Windows. --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 43311ea..7a85802 100644 --- a/package.json +++ b/package.json @@ -77,6 +77,6 @@ ], "license": "MIT", "engines": { - "node": ">=18.0.0" + "node": "^18.0.0 || ^20.0.0 || ^22.0.0" } } From a24cae085bad21cc0cd7d375d025beb941c0391b Mon Sep 17 00:00:00 2001 From: leduclinh Date: Mon, 2 Feb 2026 17:51:44 +0900 Subject: [PATCH 2/4] feat: update package version to 2.0.1 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 7a85802..4544486 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@aitytech/agentkits-memory", - "version": "2.0.0", + "version": "2.0.1", "type": "module", "description": "Persistent memory system for AI coding assistants via MCP. Works with Claude Code, Cursor, Copilot, Windsurf, Cline.", "main": "dist/index.js", From 728c409937f2abcce2d2809e62a6fa3c71bd4cdb Mon Sep 17 00:00:00 2001 From: leduclinh Date: Mon, 2 Feb 2026 17:55:07 +0900 Subject: [PATCH 3/4] docs: add Node.js version requirements and build tools guide - Document LTS version requirements (18, 20, 22) - Add table showing which versions have prebuilt binaries - Include Windows build tools installation options for non-LTS versions - Link to node-gyp documentation --- README.md | 36 +++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ffbce7c..d45adc8 100644 --- a/README.md +++ b/README.md @@ -314,9 +314,43 @@ interface ProjectMemoryConfig { ## Requirements -- Node.js >= 18.0.0 +- **Node.js LTS**: 18.x, 20.x, or 22.x (recommended) - MCP-compatible AI coding assistant +### Node.js Version Notes + +This package uses `better-sqlite3` which requires native binaries. **Prebuilt binaries are available for LTS versions only**. + +| Node Version | Status | Notes | +|--------------|--------|-------| +| 18.x LTS | ✅ Works | Prebuilt binaries | +| 20.x LTS | ✅ Works | Prebuilt binaries | +| 22.x LTS | ✅ Works | Prebuilt binaries | +| 19.x, 21.x, 23.x | ⚠️ Requires build tools | No prebuilt binaries | + +### Using Non-LTS Versions (Windows) + +If you must use a non-LTS version (19, 21, 23), install build tools first: + +**Option 1: Visual Studio Build Tools** +```powershell +# Download and install from: +# https://visualstudio.microsoft.com/visual-cpp-build-tools/ +# Select "Desktop development with C++" workload +``` + +**Option 2: windows-build-tools (npm)** +```powershell +npm install --global windows-build-tools +``` + +**Option 3: Chocolatey** +```powershell +choco install visualstudio2022-workload-vctools +``` + +See [node-gyp Windows guide](https://github.com/nodejs/node-gyp#on-windows) for more details. + --- ## AgentKits Ecosystem From 8dcf25dc24af47a7754e2b6624f6cb060ac5cbe4 Mon Sep 17 00:00:00 2001 From: leduclinh Date: Mon, 2 Feb 2026 17:58:02 +0900 Subject: [PATCH 4/4] feat: update version to 2.0.2 and adjust Node.js engine requirements --- package-lock.json | 6 +++--- package.json | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/package-lock.json b/package-lock.json index 62d05f2..1495652 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@aitytech/agentkits-memory", - "version": "2.0.0", + "version": "2.0.2", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@aitytech/agentkits-memory", - "version": "2.0.0", + "version": "2.0.2", "license": "MIT", "dependencies": { "better-sqlite3": "^11.0.0" @@ -27,7 +27,7 @@ "vitest": "^4.0.16" }, "engines": { - "node": ">=18.0.0" + "node": "^18.0.0 || ^20.0.0 || ^22.0.0" }, "optionalDependencies": { "@xenova/transformers": "^2.17.0" diff --git a/package.json b/package.json index 4544486..3b8287e 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@aitytech/agentkits-memory", - "version": "2.0.1", + "version": "2.0.2", "type": "module", "description": "Persistent memory system for AI coding assistants via MCP. Works with Claude Code, Cursor, Copilot, Windsurf, Cline.", "main": "dist/index.js",