superlocalmemory 3.0.5 → 3.0.7

package/README.md

@@ -85,13 +85,35 @@ Query  ──►  Strategy Classifier  ──►  4 Parallel Channels:
 
 ---
 
+## Prerequisites
+
+| Requirement | Version | Why |
+|:-----------|:--------|:----|
+| **Node.js** | 14+ | npm package manager |
+| **Python** | 3.11+ | V3 engine runtime |
+| **pip** | Latest | Python dependency installer |
+
+> All Python dependencies are installed automatically during `npm install`. You don't need to run pip manually. If any dependency fails, the installer shows clear instructions.
+
+---
+
 ## Quick Start
 
-### Install via npm (recommended)
+### Install via npm (recommended — one command, everything included)
 
 ```bash
 npm install -g superlocalmemory
-slm setup
+```
+
+This single command:
+- Installs the V3 engine and CLI
+- Auto-installs all Python dependencies (numpy, scipy, networkx, sentence-transformers, etc.)
+- Creates the data directory at `~/.superlocalmemory/`
+- Detects and guides V2 migration if applicable
+
+Then configure:
+```bash
+slm setup    # Choose mode, configure provider
 ```
 
 ### Install via pip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "3.0.5",
+  "version": "3.0.7",
   "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/scripts/postinstall.js

@@ -2,9 +2,11 @@
 /**
  * SuperLocalMemory V3 - NPM Postinstall Script
  *
+ * ONE COMMAND INSTALL. Everything the user needs.
+ * Python deps auto-installed. Embeddings auto-downloaded.
+ *
  * Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
  * Licensed under MIT License
- * Repository: https://github.com/qualixar/superlocalmemory
  */
 
 const { spawnSync } = require('child_process');
@@ -13,7 +15,7 @@ const os = require('os');
 const fs = require('fs');
 
 console.log('\n════════════════════════════════════════════════════════════');
-console.log('  SuperLocalMemory V3 - Post-Installation');
+console.log('  SuperLocalMemory V3 — Post-Installation');
 console.log('  by Varun Pratap Bhardwaj / Qualixar');
 console.log('  https://github.com/qualixar/superlocalmemory');
 console.log('════════════════════════════════════════════════════════════\n');
@@ -29,77 +31,99 @@ if (!fs.existsSync(SLM_HOME)) {
 
 // --- Step 2: Find Python 3 ---
 function findPython() {
-    const candidates = ['python3', 'python', '/opt/homebrew/bin/python3', '/usr/local/bin/python3', '/usr/bin/python3'];
+    const candidates = [
+        'python3', 'python',
+        '/opt/homebrew/bin/python3', '/usr/local/bin/python3', '/usr/bin/python3',
+    ];
     if (os.platform() === 'win32') candidates.push('py -3');
     for (const cmd of candidates) {
         try {
             const parts = cmd.split(' ');
-            const r = spawnSync(parts[0], [...parts.slice(1), '--version'], { stdio: 'pipe', timeout: 5000 });
-            if (r.status === 0 && (r.stdout || '').toString().includes('3.')) return cmd;
+            const r = spawnSync(parts[0], [...parts.slice(1), '--version'], {
+                stdio: 'pipe', timeout: 5000,
+                env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:' + (process.env.PATH || '') },
+            });
+            if (r.status === 0 && (r.stdout || '').toString().includes('3.')) return parts;
         } catch (e) { /* next */ }
     }
     return null;
 }
 
-const python = findPython();
-if (!python) {
-    console.log('⚠ Python 3.11+ not found. Install from https://python.org/downloads/');
+const pythonParts = findPython();
+if (!pythonParts) {
+    console.log('');
+    console.log('╔══════════════════════════════════════════════════════════╗');
+    console.log('║  ⚠  Python 3.11+ Required                              ║');
+    console.log('╚══════════════════════════════════════════════════════════╝');
+    console.log('');
+    console.log('  SuperLocalMemory V3 requires Python 3.11+');
+    console.log('  Install from: https://python.org/downloads/');
     console.log('  After installing Python, run: slm setup');
+    console.log('');
     process.exit(0); // Don't fail npm install
 }
-console.log('✓ Found Python: ' + python);
+console.log('✓ Found Python: ' + pythonParts.join(' '));
+
+// --- Step 3: Install ALL Python dependencies ---
+console.log('\nInstalling Python dependencies (this may take 1-2 minutes)...\n');
+
+// Detect if --user or --break-system-packages is needed
+function pipInstall(packages, label) {
+    // Try normal install first
+    let result = spawnSync(pythonParts[0], [
+        ...pythonParts.slice(1), '-m', 'pip', 'install', '--quiet', '--disable-pip-version-check',
+        ...packages,
+    ], { stdio: 'pipe', timeout: 300000, env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:' + (process.env.PATH || '') } });
 
-// --- Step 3: Install Python dependencies ---
-console.log('\nInstalling Python dependencies...');
-const PKG_ROOT = path.join(__dirname, '..');
-const requirementsFile = path.join(PKG_ROOT, 'src', 'superlocalmemory', 'requirements-install.txt');
+    if (result.status === 0) return true;
 
-// Create a minimal requirements file for core operation
+    // If PEP 668 blocks it, try --user
+    const stderr = (result.stderr || '').toString();
+    if (stderr.includes('externally-managed') || stderr.includes('PEP 668')) {
+        result = spawnSync(pythonParts[0], [
+            ...pythonParts.slice(1), '-m', 'pip', 'install', '--quiet', '--disable-pip-version-check',
+            '--user', ...packages,
+        ], { stdio: 'pipe', timeout: 300000, env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:' + (process.env.PATH || '') } });
+        if (result.status === 0) return true;
+
+        // Last resort: --break-system-packages
+        result = spawnSync(pythonParts[0], [
+            ...pythonParts.slice(1), '-m', 'pip', 'install', '--quiet', '--disable-pip-version-check',
+            '--break-system-packages', ...packages,
+        ], { stdio: 'pipe', timeout: 300000, env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:' + (process.env.PATH || '') } });
+        return result.status === 0;
+    }
+
+    return false;
+}
+
+// Core dependencies (REQUIRED — product won't work without these)
 const coreDeps = [
-    'numpy>=1.26.0',
-    'scipy>=1.12.0',
-    'networkx>=3.0',
-    'httpx>=0.24.0',
-    'python-dateutil>=2.9.0',
-    'rank-bm25>=0.2.2',
-    'vaderSentiment>=3.3.2',
-].join('\n');
-
-// Write temp requirements file
-const tmpReq = path.join(SLM_HOME, '.install-requirements.txt');
-fs.writeFileSync(tmpReq, coreDeps);
-
-const pythonParts = python.split(' ');
-const pipResult = spawnSync(pythonParts[0], [
-    ...pythonParts.slice(1), '-m', 'pip', 'install', '--quiet', '--disable-pip-version-check',
-    '-r', tmpReq,
-], { stdio: 'inherit', timeout: 120000 });
-
-if (pipResult.status === 0) {
-    console.log('✓ Core Python dependencies installed');
+    'numpy>=1.26.0', 'scipy>=1.12.0', 'networkx>=3.0',
+    'httpx>=0.24.0', 'python-dateutil>=2.9.0',
+    'rank-bm25>=0.2.2', 'vaderSentiment>=3.3.2',
+];
+
+if (pipInstall(coreDeps, 'core')) {
+    console.log('✓ Core dependencies installed (math, search, NLP)');
 } else {
-    console.log('⚠ Some Python dependencies failed to install.');
-    console.log('  Run manually: ' + python + ' -m pip install numpy scipy networkx httpx python-dateutil rank-bm25 vaderSentiment');
+    console.log('⚠ Core dependency installation failed.');
+    console.log('  Run manually: pip install ' + coreDeps.join(' '));
 }
 
-// Clean up temp file
-try { fs.unlinkSync(tmpReq); } catch (e) { /* ok */ }
+// Search dependencies (IMPORTANT — enables semantic search, 4-channel retrieval)
+const searchDeps = ['sentence-transformers>=2.5.0', 'geoopt>=0.5.0'];
 
-// --- Step 4: Optional search dependencies (sentence-transformers) ---
-console.log('\nChecking optional search dependencies...');
-const stCheck = spawnSync(pythonParts[0], [
-    ...pythonParts.slice(1), '-c', 'import sentence_transformers; print("ok")',
-], { stdio: 'pipe', timeout: 10000 });
-
-if (stCheck.status === 0) {
-    console.log('✓ sentence-transformers already installed (semantic search enabled)');
+console.log('\nInstalling semantic search engine (downloads ~500MB on first use)...');
+if (pipInstall(searchDeps, 'search')) {
+    console.log('✓ Semantic search engine installed (sentence-transformers + Fisher-Rao)');
 } else {
-    console.log('ℹ sentence-transformers not installed (BM25-only search mode)');
-    console.log('  For semantic search, run: ' + python + ' -m pip install sentence-transformers');
-    console.log('  This downloads ~1.5GB of ML models on first use.');
+    console.log('⚠ Semantic search installation failed (BM25 keyword search still works).');
+    console.log('  For full 4-channel retrieval, run:');
+    console.log('  pip install sentence-transformers geoopt');
 }
 
-// --- Step 5: Detect V2 installation ---
+// --- 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'))) {
     console.log('');
@@ -125,5 +149,10 @@ console.log('    slm status         # Check system status');
 console.log('    slm remember "..." # Store a memory');
 console.log('    slm recall "..."   # Search memories');
 console.log('');
-console.log('  Documentation: https://github.com/qualixar/superlocalmemory/wiki');
+console.log('  Prerequisites satisfied:');
+console.log('    ✓ Python 3.11+');
+console.log('    ✓ Core math & search libraries');
+console.log('    ✓ Data directory (~/.superlocalmemory/)');
+console.log('');
+console.log('  Docs: https://github.com/qualixar/superlocalmemory/wiki');
 console.log('════════════════════════════════════════════════════════════\n');

package/src/superlocalmemory/core/embeddings.py

@@ -198,7 +198,7 @@ class EmbeddingService:
             self._available = False
             return
         model = SentenceTransformer(
-            self._config.model_name, trust_remote_code=False,
+            self._config.model_name, trust_remote_code=True,
         )
         actual_dim = model.get_sentence_embedding_dimension()
         if actual_dim != self._config.dimension:

package/src/superlocalmemory/storage/v2_migrator.py

@@ -302,6 +302,33 @@ class V2Migrator:
                 conn.commit()
             except Exception:
                 pass  # Schema handles this on engine init
+            # Step 4b: Convert V2 memories → V3 atomic_facts
+            try:
+                now = datetime.now(UTC).isoformat()
+                rows = conn.execute("SELECT memory_id, profile_id, content, created_at FROM memories").fetchall()
+                converted = 0
+                for row in rows:
+                    mid, pid, content, created = row[0], row[1], row[2], row[3]
+                    if not content or not content.strip():
+                        continue
+                    fid = f"v2_fact_{mid}"
+                    conn.execute(
+                        "INSERT OR IGNORE INTO atomic_facts "
+                        "(fact_id, memory_id, profile_id, content, fact_type, "
+                        " entities_json, canonical_entities_json, confidence, importance, "
+                        " evidence_count, access_count, source_turn_ids_json, session_id, "
+                        " lifecycle, emotional_valence, emotional_arousal, signal_type, created_at) "
+                        "VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)",
+                        (fid, mid, pid or "default", content, "factual",
+                         "[]", "[]", 0.8, 0.5, 1, 0, "[]", "",
+                         "active", 0.0, 0.0, "factual", created or now),
+                    )
+                    converted += 1
+                conn.commit()
+                stats["steps"].append(f"Converted {converted} V2 memories to V3 facts")
+            except Exception as exc:
+                stats["steps"].append(f"V2 conversion partial: {exc}")
+
             conn.close()
             stats["steps"].append("Created V3 schema")