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 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 43311ea..3b8287e 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@aitytech/agentkits-memory", - "version": "2.0.0", + "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", @@ -77,6 +77,6 @@ ], "license": "MIT", "engines": { - "node": ">=18.0.0" + "node": "^18.0.0 || ^20.0.0 || ^22.0.0" } }