superlocalmemory 3.2.0 → 3.2.1

package/CHANGELOG.md

@@ -16,6 +16,18 @@ SuperLocalMemory V3 - Intelligent local memory system for AI coding assistants.
 
 ---
 
+## [3.2.1] - 2026-03-26
+
+### Fixed
+- **Windows `slm --version` / `slm -v`** — `.bat` and `.cmd` wrappers now intercept `--version`/`-v` directly (fast path, no Python needed) and set `PYTHONPATH` to the npm package's `src/` directory before launching Python. Previously, Windows users hitting `slm.bat` instead of the Node.js wrapper got `unrecognized arguments: --version` because Python resolved an older pip-installed version without the flag.
+- **Unix bash wrapper** (`bin/slm`) — now sets `PYTHONPATH` and intercepts `--version`/`-v`, matching the Node.js wrapper's behavior. Previously relied on npm's shim always routing to `slm-npm`.
+- **`postinstall.js`** — now runs `pip install .` to install the `superlocalmemory` Python package itself (not just dependencies). Prevents stale pip-installed versions from shadowing the npm-distributed source. Falls back to `--user` for PEP 668 environments.
+- **`preuninstall.js`** — corrected version string from "V2" to "V3".
+- **Windows Python detection** — added `py -3` (Python Launcher for Windows) as a fallback candidate in `slm.bat`.
+- **Environment parity** — all three entry points (`slm-npm`, `slm`, `slm.bat`) now set identical PyTorch memory-prevention env vars (`PYTORCH_MPS_HIGH_WATERMARK_RATIO`, `TORCH_DEVICE`, etc.).
+
+---
+
 ## [3.2.0] - 2026-03-26
 
 ### Added

package/bin/slm

@@ -2,6 +2,19 @@
 # SuperLocalMemory V3 CLI
 # Part of Qualixar | https://superlocalmemory.com
 
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PKG_ROOT="$(dirname "$SCRIPT_DIR")"
+SRC_DIR="$PKG_ROOT/src"
+
+# Handle --version / -v directly (fast path)
+for arg in "$@"; do
+    if [ "$arg" = "--version" ] || [ "$arg" = "-v" ]; then
+        VER=$(grep '"version"' "$PKG_ROOT/package.json" 2>/dev/null | head -1 | sed 's/.*"\([0-9][0-9.]*\)".*/\1/')
+        echo "superlocalmemory ${VER:-unknown}"
+        exit 0
+    fi
+done
+
 # Find Python
 PYTHON=""
 for cmd in python3 python; do
@@ -12,9 +25,24 @@ for cmd in python3 python; do
 done
 
 if [ -z "$PYTHON" ]; then
-    echo "Error: Python 3 not found. Install Python 3.10+ from python.org"
+    echo "Error: Python 3 not found. Install Python 3.11+ from python.org"
     exit 1
 fi
 
+# Set PYTHONPATH so Python finds the npm package's src/ directory
+if [ -n "$PYTHONPATH" ]; then
+    export PYTHONPATH="$SRC_DIR:$PYTHONPATH"
+else
+    export PYTHONPATH="$SRC_DIR"
+fi
+
+# Prevent PyTorch Metal/MPS GPU memory reservation
+export PYTORCH_MPS_HIGH_WATERMARK_RATIO=0.0
+export PYTORCH_MPS_MEM_LIMIT=0
+export PYTORCH_ENABLE_MPS_FALLBACK=1
+export TOKENIZERS_PARALLELISM=false
+export TORCH_DEVICE=cpu
+export CUDA_VISIBLE_DEVICES=""
+
 # Run V3 CLI
 exec "$PYTHON" -m superlocalmemory.cli.main "$@"

package/bin/slm.bat

@@ -6,22 +6,60 @@ REM Repository: https://github.com/qualixar/superlocalmemory
 
 setlocal enabledelayedexpansion
 
+REM Resolve the package src/ directory for PYTHONPATH
+set "SLM_PKG_DIR=%~dp0..\src"
+
+REM Handle --version / -v directly (fast path, no Python needed)
+if "%~1"=="--version" goto :show_version
+if "%~1"=="-v" goto :show_version
+
 REM Find Python 3
-where python3 >/dev/null 2>&1
+where python3 >nul 2>&1
 if %ERRORLEVEL% EQU 0 (
     set PYTHON_CMD=python3
     goto :run
 )
-where python >/dev/null 2>&1
+where python >nul 2>&1
 if %ERRORLEVEL% EQU 0 (
     set PYTHON_CMD=python
     goto :run
 )
+where py >nul 2>&1
+if %ERRORLEVEL% EQU 0 (
+    set PYTHON_CMD=py -3
+    goto :run
+)
 
 echo Error: Python 3.11+ not found.
 echo Install from: https://python.org/downloads/
 exit /b 1
 
+:show_version
+REM Read version from package.json via findstr
+for /f "tokens=2 delims=:," %%a in ('findstr /C:"\"version\"" "%~dp0..\package.json"') do (
+    set "VER=%%~a"
+    set "VER=!VER: =!"
+    echo superlocalmemory !VER!
+    exit /b 0
+)
+echo superlocalmemory unknown
+exit /b 0
+
 :run
+REM Set PYTHONPATH so Python finds the npm package's src/ directory
+if defined PYTHONPATH (
+    set "PYTHONPATH=%SLM_PKG_DIR%;%PYTHONPATH%"
+) else (
+    set "PYTHONPATH=%SLM_PKG_DIR%"
+)
+
+REM Prevent PyTorch Metal/MPS GPU memory reservation
+set "PYTORCH_MPS_HIGH_WATERMARK_RATIO=0.0"
+set "PYTORCH_MPS_MEM_LIMIT=0"
+set "PYTORCH_ENABLE_MPS_FALLBACK=1"
+set "TOKENIZERS_PARALLELISM=false"
+set "TORCH_DEVICE=cpu"
+set "CUDA_VISIBLE_DEVICES="
+
 %PYTHON_CMD% -m superlocalmemory.cli.main %*
 exit /b %ERRORLEVEL%

package/bin/slm.cmd

@@ -1,5 +1,5 @@
 @echo off
 REM SuperLocalMemory V3 - Windows CLI (CMD variant)
-REM Calls slm.bat for compatibility
+REM Delegates to slm.bat which handles PYTHONPATH and --version
 call "%~dp0slm.bat" %*
 exit /b %ERRORLEVEL%

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "Information-geometric agent memory with mathematical guarantees. 4-channel retrieval, Fisher-Rao similarity, zero-LLM mode, EU AI Act compliant. Works with Claude, Cursor, Windsurf, and 17+ AI tools.",
   "keywords": [
     "ai-memory",

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "3.2.0"
+version = "3.2.1"
 description = "Information-geometric agent memory with mathematical guarantees"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/postinstall.js

@@ -157,6 +157,39 @@ if (pipInstall(perfDeps, 'performance')) {
     console.log('⚠ Performance deps skipped (system works fine without them).');
 }
 
+// --- Step 3b: Install the superlocalmemory package itself ---
+// This ensures `python -m superlocalmemory.cli.main` always resolves the
+// correct version, even when invoked outside the Node.js wrapper (e.g.,
+// via slm.bat on Windows or direct Python invocation).
+console.log('\nInstalling superlocalmemory Python package...');
+const pkgRoot = path.join(__dirname, '..');
+const pipInstallPkg = spawnSync(pythonParts[0], [
+    ...pythonParts.slice(1), '-m', 'pip', 'install', '--quiet', '--disable-pip-version-check',
+    pkgRoot,
+], { stdio: 'pipe', timeout: 300000, env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:' + (process.env.PATH || '') } });
+
+if (pipInstallPkg.status === 0) {
+    console.log('✓ SuperLocalMemory Python package installed');
+} else {
+    // Try with --user if PEP 668
+    const stderr = (pipInstallPkg.stderr || '').toString();
+    if (stderr.includes('externally-managed') || stderr.includes('PEP 668')) {
+        const retryResult = spawnSync(pythonParts[0], [
+            ...pythonParts.slice(1), '-m', 'pip', 'install', '--quiet', '--disable-pip-version-check',
+            '--user', pkgRoot,
+        ], { stdio: 'pipe', timeout: 300000, env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:' + (process.env.PATH || '') } });
+        if (retryResult.status === 0) {
+            console.log('✓ SuperLocalMemory Python package installed (--user)');
+        } else {
+            console.log('⚠ Could not pip install the package. The Node.js wrapper (slm-npm)');
+            console.log('  sets PYTHONPATH automatically, so CLI will still work.');
+        }
+    } else {
+        console.log('⚠ Could not pip install the package. The Node.js wrapper (slm-npm)');
+        console.log('  sets PYTHONPATH automatically, so CLI will still work.');
+    }
+}
+
 // --- Step 4: Detect V2 installation ---
 const V2_HOME = path.join(os.homedir(), '.claude-memory');
 if (fs.existsSync(V2_HOME) && fs.existsSync(path.join(V2_HOME, 'memory.db'))) {

package/scripts/preuninstall.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * SuperLocalMemory V2 - NPM Preuninstall Script
+ * SuperLocalMemory V3 - NPM Preuninstall Script
  *
  * Copyright (c) 2026 Varun Pratap Bhardwaj
  * Solution Architect & Original Creator
@@ -16,7 +16,7 @@ const os = require('os');
 const fs = require('fs');
 
 console.log('\n════════════════════════════════════════════════════════════');
-console.log('  SuperLocalMemory V2 - Uninstalling');
+console.log('  SuperLocalMemory V3 - Uninstalling');
 console.log('════════════════════════════════════════════════════════════\n');
 
 const SLM_DIR = path.join(os.homedir(), '.superlocalmemory');