superlocalmemory 2.8.5 → 3.0.0

package/scripts/test-npm-package.sh

@@ -0,0 +1,207 @@
+#!/bin/bash
+# ============================================================================
+# SuperLocalMemory V2 - NPM Package Testing Script
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# Licensed under MIT License
+# Repository: https://github.com/varun369/SuperLocalMemoryV2
+# ============================================================================
+#
+# Tests the NPM package locally before publishing
+# Run this BEFORE npm publish
+#
+
+set -e
+
+REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║  SuperLocalMemory V2 - NPM Package Test                      ║"
+echo "║  by Varun Pratap Bhardwaj                                    ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Step 1: Validate package.json
+echo "📋 Step 1: Validating package.json..."
+if [ ! -f "$REPO_DIR/package.json" ]; then
+    echo "❌ Error: package.json not found"
+    exit 1
+fi
+
+# Check version
+VERSION=$(node -e "console.log(require('$REPO_DIR/package.json').version)")
+echo "   Version: $VERSION"
+
+# Check required fields
+node -e "
+const pkg = require('$REPO_DIR/package.json');
+const required = ['name', 'version', 'description', 'author', 'license', 'repository', 'bin'];
+const missing = required.filter(f => !pkg[f]);
+if (missing.length > 0) {
+    console.error('❌ Missing required fields:', missing.join(', '));
+    process.exit(1);
+}
+console.log('   ✓ All required fields present');
+"
+
+# Step 2: Check file structure
+echo ""
+echo "📁 Step 2: Checking file structure..."
+
+REQUIRED_FILES=(
+    "bin/slm-npm"
+    "scripts/postinstall.js"
+    "scripts/preuninstall.js"
+    "src/memory_store_v2.py"
+    "mcp_server.py"
+    "install.sh"
+    "install.ps1"
+    "README.md"
+    "LICENSE"
+    "ATTRIBUTION.md"
+)
+
+for file in "${REQUIRED_FILES[@]}"; do
+    if [ ! -f "$REPO_DIR/$file" ]; then
+        echo "   ❌ Missing: $file"
+        exit 1
+    fi
+done
+echo "   ✓ All required files present"
+
+# Step 3: Test npm pack
+echo ""
+echo "📦 Step 3: Testing npm pack..."
+cd "$REPO_DIR"
+rm -f superlocalmemory-*.tgz
+npm pack --quiet
+TARBALL=$(ls superlocalmemory-*.tgz 2>/dev/null | head -1)
+
+if [ -z "$TARBALL" ]; then
+    echo "   ❌ npm pack failed"
+    exit 1
+fi
+
+SIZE=$(du -h "$TARBALL" | cut -f1)
+echo "   ✓ Package created: $TARBALL ($SIZE)"
+
+# Check package size
+SIZE_KB=$(du -k "$TARBALL" | cut -f1)
+if [ "$SIZE_KB" -gt 1024 ]; then
+    echo "   ⚠️  Warning: Package size is large (${SIZE}). Target: <500KB"
+else
+    echo "   ✓ Package size OK: $SIZE"
+fi
+
+# Step 4: Inspect package contents
+echo ""
+echo "🔍 Step 4: Inspecting package contents..."
+echo "   Files included:"
+tar -tzf "$TARBALL" | head -20
+FILE_COUNT=$(tar -tzf "$TARBALL" | wc -l)
+echo "   ... ($FILE_COUNT total files)"
+
+# Check for unwanted files
+UNWANTED=("*.pyc" "*.db" ".git" "test_*.py" "wiki-content")
+for pattern in "${UNWANTED[@]}"; do
+    if tar -tzf "$TARBALL" | grep -q "$pattern"; then
+        echo "   ⚠️  Warning: Found unwanted files matching: $pattern"
+    fi
+done
+echo "   ✓ No obvious unwanted files found"
+
+# Step 5: Test npm link (local install)
+echo ""
+echo "🔗 Step 5: Testing npm link (local install)..."
+
+# Unlink if already linked
+npm unlink -g superlocalmemory 2>/dev/null || true
+
+# Link
+if npm link --quiet; then
+    echo "   ✓ npm link successful"
+else
+    echo "   ❌ npm link failed"
+    exit 1
+fi
+
+# Step 6: Test CLI command
+echo ""
+echo "🧪 Step 6: Testing CLI command..."
+
+if command -v slm &> /dev/null; then
+    echo "   ✓ slm command found"
+
+    # Test version
+    if slm --version &> /dev/null; then
+        echo "   ✓ slm --version works"
+    else
+        echo "   ⚠️  slm --version failed (might be OK if not installed yet)"
+    fi
+
+    # Test help
+    if slm --help &> /dev/null; then
+        echo "   ✓ slm --help works"
+    else
+        echo "   ⚠️  slm --help failed"
+    fi
+else
+    echo "   ⚠️  slm command not found (expected for first install)"
+    echo "      This is OK - postinstall will set it up"
+fi
+
+# Step 7: Validate scripts
+echo ""
+echo "🔧 Step 7: Validating scripts..."
+
+# Check postinstall.js
+if node "$REPO_DIR/scripts/postinstall.js" --help &> /dev/null; then
+    echo "   ✓ postinstall.js is valid Node.js"
+else
+    echo "   ⚠️  postinstall.js might have issues"
+fi
+
+# Check executables
+if [ -x "$REPO_DIR/bin/slm-npm" ]; then
+    echo "   ✓ bin/slm-npm is executable"
+else
+    echo "   ❌ bin/slm-npm is not executable"
+    echo "      Run: chmod +x $REPO_DIR/bin/slm-npm"
+    exit 1
+fi
+
+# Step 8: Final summary
+echo ""
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║  Test Summary                                                ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+echo "✅ Package structure: OK"
+echo "✅ File validation: OK"
+echo "✅ npm pack: OK ($SIZE)"
+echo "✅ npm link: OK"
+echo "✅ Scripts valid: OK"
+echo ""
+echo "📦 Package ready for testing!"
+echo ""
+echo "Next steps:"
+echo "1. Test manual install:"
+echo "   npm install -g ./$TARBALL"
+echo "   slm status"
+echo "   npm uninstall -g superlocalmemory"
+echo ""
+echo "2. Test on Docker (recommended):"
+echo "   docker run -it --rm -v \$(pwd):/app node:18 bash"
+echo "   cd /app"
+echo "   npm install -g ./$TARBALL"
+echo "   slm status"
+echo ""
+echo "3. When ready to publish:"
+echo "   npm login"
+echo "   npm publish"
+echo ""
+echo "Full guide: NPM-PUBLISHING-GUIDE.md"
+echo ""
+
+# Cleanup
+rm -f "$TARBALL"
+echo "🧹 Cleaned up test tarball"

package/scripts/verify-install.ps1

@@ -0,0 +1,294 @@
+# ============================================================================
+# SuperLocalMemory - Installation Verification Script (PowerShell)
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# Licensed under MIT License
+# ============================================================================
+
+$ErrorActionPreference = "Continue"
+
+$INSTALL_DIR = Join-Path $env:USERPROFILE ".claude-memory"
+
+# Print banner
+Write-Host ""
+Write-Host "=================================================================="
+Write-Host "  SuperLocalMemory - Installation Verification            "
+Write-Host "  by Varun Pratap Bhardwaj                                       "
+Write-Host "=================================================================="
+Write-Host ""
+
+# Track status
+$CORE_OK = $true
+$SEARCH_OK = $false
+$UI_OK = $false
+$ERRORS = @()
+
+# ============================================================================
+# CORE INSTALLATION CHECK
+# ============================================================================
+
+Write-Host "================================================================"
+Write-Host "1. Core Installation"
+Write-Host "================================================================"
+Write-Host ""
+
+# Check Python version
+Write-Host -NoNewline "Python 3.8+               "
+try {
+    $pythonVersion = & python -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')" 2>&1
+    $pythonMajor = & python -c "import sys; print(sys.version_info.major)" 2>&1
+    $pythonMinor = & python -c "import sys; print(sys.version_info.minor)" 2>&1
+    
+    if ([int]$pythonMajor -lt 3 -or ([int]$pythonMajor -eq 3 -and [int]$pythonMinor -lt 8)) {
+        Write-Host "FAIL (found $pythonVersion)" -ForegroundColor Red
+        $CORE_OK = $false
+        $ERRORS += "Python 3.8+ required"
+    } else {
+        Write-Host "OK (v$pythonVersion)" -ForegroundColor Green
+    }
+} catch {
+    Write-Host "FAIL (Python not found)" -ForegroundColor Red
+    $CORE_OK = $false
+    $ERRORS += "Python not installed"
+}
+
+# Check installation directory
+Write-Host -NoNewline "Installation directory    "
+if (Test-Path $INSTALL_DIR) {
+    Write-Host "OK ($INSTALL_DIR)" -ForegroundColor Green
+} else {
+    Write-Host "FAIL (not found)" -ForegroundColor Red
+    $CORE_OK = $false
+    $ERRORS += "Installation directory missing"
+}
+
+# Check core files
+Write-Host -NoNewline "Core scripts              "
+$coreFiles = @("memory_store_v2.py", "graph_engine.py", "pattern_learner.py")
+$missingFiles = @()
+foreach ($file in $coreFiles) {
+    $filePath = Join-Path $INSTALL_DIR $file
+    if (-not (Test-Path $filePath)) {
+        $missingFiles += $file
+    }
+}
+
+if ($missingFiles.Count -eq 0) {
+    Write-Host "OK" -ForegroundColor Green
+} else {
+    Write-Host "FAIL (missing: $($missingFiles -join ', '))" -ForegroundColor Red
+    $CORE_OK = $false
+    $ERRORS += "Core scripts missing"
+}
+
+# Check CLI wrappers
+Write-Host -NoNewline "CLI wrappers              "
+$binDir = Join-Path $INSTALL_DIR "bin"
+if (Test-Path $binDir) {
+    Write-Host "OK" -ForegroundColor Green
+} else {
+    Write-Host "FAIL" -ForegroundColor Red
+    $CORE_OK = $false
+    $ERRORS += "CLI wrappers missing"
+}
+
+# Check PATH configuration
+Write-Host -NoNewline "PATH configuration        "
+$userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
+if ($userPath -like "*$binDir*") {
+    Write-Host "OK (commands globally available)" -ForegroundColor Green
+} else {
+    Write-Host "WARNING (not in PATH)" -ForegroundColor Yellow
+    $ERRORS += "PATH not configured - add manually or re-run installer"
+}
+
+# Check database
+Write-Host -NoNewline "Database                  "
+$dbPath = Join-Path $INSTALL_DIR "memory.db"
+if (Test-Path $dbPath) {
+    $dbSize = [math]::Round((Get-Item $dbPath).Length / 1KB, 2)
+    Write-Host "OK ($dbSize KB)" -ForegroundColor Green
+} else {
+    Write-Host "NOT CREATED (will be created on first use)" -ForegroundColor Yellow
+}
+
+# Check config
+Write-Host -NoNewline "Configuration             "
+$configPath = Join-Path $INSTALL_DIR "config.json"
+if (Test-Path $configPath) {
+    Write-Host "OK" -ForegroundColor Green
+} else {
+    Write-Host "WARNING (using defaults)" -ForegroundColor Yellow
+}
+
+Write-Host ""
+
+# ============================================================================
+# OPTIONAL FEATURES CHECK
+# ============================================================================
+
+Write-Host "================================================================"
+Write-Host "2. Optional Features"
+Write-Host "================================================================"
+Write-Host ""
+
+# Advanced Search
+Write-Host -NoNewline "Advanced Search           "
+try {
+    & python -c "import sentence_transformers; import hnswlib" 2>$null
+    Write-Host "ENABLED" -ForegroundColor Green
+    $SEARCH_OK = $true
+} catch {
+    Write-Host "DISABLED" -ForegroundColor Yellow
+    Write-Host "  Install: pip install -r requirements-search.txt"
+}
+
+# Web Dashboard
+Write-Host -NoNewline "Web Dashboard             "
+try {
+    & python -c "import fastapi; import uvicorn" 2>$null
+    Write-Host "ENABLED" -ForegroundColor Green
+    $UI_OK = $true
+    $apiServerPath = Join-Path $INSTALL_DIR "api_server.py"
+    if (Test-Path $apiServerPath) {
+        Write-Host "  Start: python $apiServerPath"
+        Write-Host "  URL:   http://127.0.0.1:8000"
+    }
+} catch {
+    Write-Host "DISABLED" -ForegroundColor Yellow
+    Write-Host "  Install: pip install -r requirements-ui.txt"
+}
+
+Write-Host ""
+
+# ============================================================================
+# PERFORMANCE QUICK TEST
+# ============================================================================
+
+if ($CORE_OK) {
+    Write-Host "================================================================"
+    Write-Host "3. Performance Quick Test"
+    Write-Host "================================================================"
+    Write-Host ""
+
+    # Test memory store initialization
+    Write-Host -NoNewline "Memory store init         "
+    try {
+        & python -c "import sys; sys.path.insert(0, '$INSTALL_DIR'); from memory_store_v2 import MemoryStoreV2; store = MemoryStoreV2()" 2>$null
+        Write-Host "OK" -ForegroundColor Green
+    } catch {
+        Write-Host "FAIL" -ForegroundColor Red
+        $ERRORS += "Memory store initialization failed"
+    }
+
+    # Test database query
+    Write-Host -NoNewline "Database query            "
+    $startTime = Get-Date
+    try {
+        & python -c "import sys; sys.path.insert(0, '$INSTALL_DIR'); from memory_store_v2 import MemoryStoreV2; store = MemoryStoreV2(); list(store.list_all(limit=1))" 2>$null
+        $endTime = Get-Date
+        $duration = [math]::Round(($endTime - $startTime).TotalMilliseconds, 0)
+        Write-Host "OK ($duration ms)" -ForegroundColor Green
+    } catch {
+        Write-Host "FAIL" -ForegroundColor Red
+        $ERRORS += "Database query failed"
+    }
+
+    Write-Host ""
+}
+
+# ============================================================================
+# SUMMARY
+# ============================================================================
+
+Write-Host "================================================================"
+Write-Host "4. Summary"
+Write-Host "================================================================"
+Write-Host ""
+
+if ($CORE_OK) {
+    Write-Host "Core Installation:      WORKING" -ForegroundColor Green
+} else {
+    Write-Host "Core Installation:      FAILED" -ForegroundColor Red
+}
+
+if ($SEARCH_OK) {
+    Write-Host "Advanced Search:        ENABLED" -ForegroundColor Green
+} else {
+    Write-Host "Advanced Search:        DISABLED (optional)" -ForegroundColor Yellow
+}
+
+if ($UI_OK) {
+    Write-Host "Web Dashboard:          ENABLED" -ForegroundColor Green
+} else {
+    Write-Host "Web Dashboard:          DISABLED (optional)" -ForegroundColor Yellow
+}
+
+Write-Host ""
+
+# Feature Status
+Write-Host "Feature Status:"
+if ($CORE_OK) {
+    Write-Host "  - Basic CLI commands:    Available" -ForegroundColor Green
+    Write-Host "  - MCP Server:            Available" -ForegroundColor Green
+    Write-Host "  - Skills:                Available" -ForegroundColor Green
+} else {
+    Write-Host "  - Basic CLI commands:    Not available" -ForegroundColor Red
+    Write-Host "  - MCP Server:            Not available" -ForegroundColor Red
+    Write-Host "  - Skills:                Not available" -ForegroundColor Red
+}
+
+if ($SEARCH_OK) {
+    Write-Host "  - Semantic Search:       Enabled" -ForegroundColor Green
+} else {
+    Write-Host "  - Semantic Search:       Disabled" -ForegroundColor Yellow
+}
+
+if ($UI_OK) {
+    Write-Host "  - Web Interface:         Enabled" -ForegroundColor Green
+} else {
+    Write-Host "  - Web Interface:         Disabled" -ForegroundColor Yellow
+}
+
+Write-Host ""
+
+# Errors
+if ($ERRORS.Count -gt 0) {
+    Write-Host "Errors detected:" -ForegroundColor Yellow
+    foreach ($error in $ERRORS) {
+        Write-Host "  - $error"
+    }
+    Write-Host ""
+}
+
+# Next Steps
+Write-Host "Next Steps:"
+Write-Host ""
+
+if ($CORE_OK) {
+    Write-Host "  Try it now:"
+    Write-Host "    python $INSTALL_DIR\memory_store_v2.py"
+    Write-Host ""
+
+    if (-not $SEARCH_OK -and -not $UI_OK) {
+        Write-Host "  Install optional features:"
+        Write-Host "    pip install -r requirements-search.txt  # Advanced search"
+        Write-Host "    pip install -r requirements-ui.txt      # Web dashboard"
+        Write-Host "    pip install -r requirements-full.txt    # Everything"
+        Write-Host ""
+    }
+} else {
+    Write-Host "  Fix installation issues:"
+    Write-Host "    Run: .\install.ps1"
+    Write-Host ""
+}
+
+# Exit code
+if ($CORE_OK) {
+    Write-Host "Installation verification PASSED" -ForegroundColor Green
+    Write-Host ""
+    exit 0
+} else {
+    Write-Host "Installation verification FAILED" -ForegroundColor Red
+    Write-Host ""
+    exit 1
+}