superlocalmemory 2.8.6 → 3.0.0

package/scripts/test-dmg.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+#
+# SuperLocalMemory V2 - DMG Testing Script
+#
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# Solution Architect & Original Creator
+#
+# Licensed under MIT License (see LICENSE file)
+# Repository: https://github.com/varun369/SuperLocalMemoryV2
+#
+# ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
+#
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+log_info() {
+    echo -e "${BLUE}[TEST]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[PASS]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[FAIL]${NC} $1"
+}
+
+DMG_FILE="SuperLocalMemory-v2.1.0-macos.dmg"
+
+if [ ! -f "${DMG_FILE}" ]; then
+    log_error "DMG file not found: ${DMG_FILE}"
+    exit 1
+fi
+
+log_info "Testing DMG: ${DMG_FILE}"
+echo ""
+
+# Test 1: DMG Integrity
+log_info "Test 1: Checking DMG integrity..."
+if hdiutil verify "${DMG_FILE}" 2>&1 | grep -q "verified"; then
+    log_success "DMG integrity check passed"
+else
+    log_error "DMG integrity check failed"
+    exit 1
+fi
+
+# Test 2: Mount DMG
+log_info "Test 2: Mounting DMG..."
+MOUNT_OUTPUT=$(hdiutil attach "${DMG_FILE}" -nobrowse -readonly)
+MOUNT_POINT=$(echo "$MOUNT_OUTPUT" | grep -E '/Volumes/' | awk '{print $3}')
+
+if [ -z "$MOUNT_POINT" ]; then
+    log_error "Failed to mount DMG"
+    exit 1
+fi
+
+log_success "DMG mounted at: $MOUNT_POINT"
+
+# Test 3: Verify Contents
+log_info "Test 3: Checking DMG contents..."
+
+REQUIRED_FILES=(
+    "SuperLocalMemory/install.sh"
+    "SuperLocalMemory/src"
+    "SuperLocalMemory/bin"
+    "SuperLocalMemory/configs"
+    "SuperLocalMemory/skills"
+    "SuperLocalMemory/mcp_server.py"
+    "SuperLocalMemory/README.md"
+    "SuperLocalMemory/LICENSE"
+    "SuperLocalMemory/ATTRIBUTION.md"
+    "SuperLocalMemory/README-INSTALLATION.txt"
+    "SuperLocalMemory/INSTALL"
+    "Applications"
+)
+
+ALL_PRESENT=true
+for item in "${REQUIRED_FILES[@]}"; do
+    if [ -e "${MOUNT_POINT}/${item}" ]; then
+        log_success "  ✓ ${item}"
+    else
+        log_error "  ✗ ${item} (MISSING)"
+        ALL_PRESENT=false
+    fi
+done
+
+if [ "$ALL_PRESENT" = false ]; then
+    log_error "Some required files are missing"
+    hdiutil detach "${MOUNT_POINT}" -quiet
+    exit 1
+fi
+
+# Test 4: Check installer script
+log_info "Test 4: Checking installer script..."
+if [ -x "${MOUNT_POINT}/SuperLocalMemory/install.sh" ]; then
+    log_success "install.sh is executable"
+else
+    log_error "install.sh is not executable"
+    hdiutil detach "${MOUNT_POINT}" -quiet
+    exit 1
+fi
+
+# Test 5: Check Applications symlink
+log_info "Test 5: Checking Applications symlink..."
+if [ -L "${MOUNT_POINT}/Applications" ]; then
+    TARGET=$(readlink "${MOUNT_POINT}/Applications")
+    if [ "$TARGET" = "/Applications" ]; then
+        log_success "Applications symlink is correct"
+    else
+        log_error "Applications symlink points to wrong location: $TARGET"
+    fi
+else
+    log_error "Applications symlink not found"
+fi
+
+# Test 6: Check file sizes
+log_info "Test 6: Checking file sizes..."
+INSTALLER_SIZE=$(du -sh "${MOUNT_POINT}/SuperLocalMemory" | awk '{print $1}')
+log_success "Installer size: ${INSTALLER_SIZE}"
+
+# Test 7: Verify attribution
+log_info "Test 7: Checking attribution headers..."
+if grep -q "Varun Pratap Bhardwaj" "${MOUNT_POINT}/SuperLocalMemory/src/memory_store_v2.py"; then
+    log_success "Attribution headers present"
+else
+    log_error "Attribution headers missing"
+fi
+
+# Test 8: Check INSTALL wrapper
+log_info "Test 8: Checking INSTALL wrapper..."
+if [ -x "${MOUNT_POINT}/SuperLocalMemory/INSTALL" ]; then
+    log_success "INSTALL wrapper is executable"
+else
+    log_error "INSTALL wrapper is not executable"
+fi
+
+# Cleanup
+log_info "Unmounting DMG..."
+hdiutil detach "${MOUNT_POINT}" -quiet
+log_success "DMG unmounted"
+
+echo ""
+echo "============================================================================"
+log_success "ALL TESTS PASSED!"
+echo "============================================================================"
+echo ""
+echo "DMG is ready for distribution."
+echo ""
+echo "To test installation:"
+echo "  1. Open ${DMG_FILE}"
+echo "  2. Double-click INSTALL"
+echo "  3. Follow prompts"
+echo "  4. Run: slm status"
+echo ""

package/scripts/test-npm-package.ps1

@@ -0,0 +1,252 @@
+# ============================================================================
+# SuperLocalMemory V2 - NPM Package Testing Script (PowerShell)
+# 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
+#
+
+param()
+
+$ErrorActionPreference = "Stop"
+
+$REPO_DIR = $PSScriptRoot
+
+Write-Host "╔══════════════════════════════════════════════════════════════╗"
+Write-Host "║  SuperLocalMemory V2 - NPM Package Test                      ║"
+Write-Host "║  by Varun Pratap Bhardwaj                                    ║"
+Write-Host "╚══════════════════════════════════════════════════════════════╝"
+Write-Host ""
+
+# Step 1: Validate package.json
+Write-Host "📋 Step 1: Validating package.json..."
+$packageJsonPath = Join-Path $REPO_DIR "package.json"
+if (-not (Test-Path $packageJsonPath)) {
+    Write-Host "❌ Error: package.json not found" -ForegroundColor Red
+    exit 1
+}
+
+# Check version
+$packageJson = Get-Content $packageJsonPath | ConvertFrom-Json
+$VERSION = $packageJson.version
+Write-Host "   Version: $VERSION"
+
+# Check required fields
+$required = @("name", "version", "description", "author", "license", "repository", "bin")
+$missing = @()
+foreach ($field in $required) {
+    if (-not $packageJson.$field) {
+        $missing += $field
+    }
+}
+
+if ($missing.Count -gt 0) {
+    Write-Host "❌ Missing required fields: $($missing -join ', ')" -ForegroundColor Red
+    exit 1
+}
+Write-Host "   ✓ All required fields present"
+
+# Step 2: Check file structure
+Write-Host ""
+Write-Host "📁 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"
+)
+
+$allPresent = $true
+foreach ($file in $REQUIRED_FILES) {
+    $filePath = Join-Path $REPO_DIR $file
+    if (-not (Test-Path $filePath)) {
+        Write-Host "   ❌ Missing: $file" -ForegroundColor Red
+        $allPresent = $false
+    }
+}
+
+if (-not $allPresent) {
+    exit 1
+}
+Write-Host "   ✓ All required files present"
+
+# Step 3: Test npm pack
+Write-Host ""
+Write-Host "📦 Step 3: Testing npm pack..."
+Push-Location $REPO_DIR
+try {
+    # Remove old tarballs
+    Get-ChildItem -Filter "superlocalmemory-*.tgz" | Remove-Item -Force -ErrorAction SilentlyContinue
+
+    # Create tarball
+    $packOutput = npm pack --quiet 2>&1
+    $TARBALL = Get-ChildItem -Filter "superlocalmemory-*.tgz" | Select-Object -First 1
+
+    if (-not $TARBALL) {
+        Write-Host "   ❌ npm pack failed" -ForegroundColor Red
+        exit 1
+    }
+
+    $SIZE = [math]::Round((Get-Item $TARBALL.FullName).Length / 1MB, 2)
+    Write-Host "   ✓ Package created: $($TARBALL.Name) ($SIZE MB)"
+
+    # Check package size
+    if ($SIZE -gt 1) {
+        Write-Host "   ⚠️  Warning: Package size is large ($SIZE MB). Target: <0.5MB" -ForegroundColor Yellow
+    } else {
+        Write-Host "   ✓ Package size OK: $SIZE MB"
+    }
+
+    # Step 4: Inspect package contents
+    Write-Host ""
+    Write-Host "🔍 Step 4: Inspecting package contents..."
+    Write-Host "   Files included:"
+
+    # Extract tarball contents list (using tar if available, otherwise show warning)
+    try {
+        $tarContents = tar -tzf $TARBALL.FullName 2>$null | Select-Object -First 20
+        $tarContents | ForEach-Object { Write-Host "      $_" }
+        $fileCount = (tar -tzf $TARBALL.FullName 2>$null | Measure-Object).Count
+        Write-Host "   ... ($fileCount total files)"
+
+        # Check for unwanted files
+        $UNWANTED = @("*.pyc", "*.db", ".git", "test_*.py", "wiki-content")
+        $foundUnwanted = $false
+        foreach ($pattern in $UNWANTED) {
+            $found = tar -tzf $TARBALL.FullName 2>$null | Select-String -Pattern $pattern
+            if ($found) {
+                Write-Host "   ⚠️  Warning: Found unwanted files matching: $pattern" -ForegroundColor Yellow
+                $foundUnwanted = $true
+            }
+        }
+        if (-not $foundUnwanted) {
+            Write-Host "   ✓ No obvious unwanted files found"
+        }
+    } catch {
+        Write-Host "   ⚠️  Could not inspect tarball contents (tar not available)" -ForegroundColor Yellow
+    }
+
+    # Step 5: Test npm link (local install)
+    Write-Host ""
+    Write-Host "🔗 Step 5: Testing npm link (local install)..."
+
+    # Unlink if already linked
+    npm unlink -g superlocalmemory 2>$null
+
+    # Link
+    $linkResult = npm link --quiet 2>&1
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "   ✓ npm link successful"
+    } else {
+        Write-Host "   ❌ npm link failed" -ForegroundColor Red
+        Write-Host "   $linkResult"
+        exit 1
+    }
+
+    # Step 6: Test CLI command
+    Write-Host ""
+    Write-Host "🧪 Step 6: Testing CLI command..."
+
+    $slmCommand = Get-Command slm -ErrorAction SilentlyContinue
+    if ($slmCommand) {
+        Write-Host "   ✓ slm command found"
+
+        # Test version
+        try {
+            slm --version 2>&1 | Out-Null
+            if ($LASTEXITCODE -eq 0) {
+                Write-Host "   ✓ slm --version works"
+            } else {
+                Write-Host "   ⚠️  slm --version failed (might be OK if not installed yet)" -ForegroundColor Yellow
+            }
+        } catch {
+            Write-Host "   ⚠️  slm --version failed" -ForegroundColor Yellow
+        }
+
+        # Test help
+        try {
+            slm --help 2>&1 | Out-Null
+            if ($LASTEXITCODE -eq 0) {
+                Write-Host "   ✓ slm --help works"
+            } else {
+                Write-Host "   ⚠️  slm --help failed" -ForegroundColor Yellow
+            }
+        } catch {
+            Write-Host "   ⚠️  slm --help failed" -ForegroundColor Yellow
+        }
+    } else {
+        Write-Host "   ⚠️  slm command not found (expected for first install)" -ForegroundColor Yellow
+        Write-Host "      This is OK - postinstall will set it up"
+    }
+
+    # Step 7: Validate scripts
+    Write-Host ""
+    Write-Host "🔧 Step 7: Validating scripts..."
+
+    # Check postinstall.js
+    try {
+        node (Join-Path $REPO_DIR "scripts\postinstall.js") --help 2>&1 | Out-Null
+        Write-Host "   ✓ postinstall.js is valid Node.js"
+    } catch {
+        Write-Host "   ⚠️  postinstall.js might have issues" -ForegroundColor Yellow
+    }
+
+    # Check executables (Windows doesn't need execute bit)
+    $slmNpmPath = Join-Path $REPO_DIR "bin\slm-npm"
+    if (Test-Path $slmNpmPath) {
+        Write-Host "   ✓ bin\slm-npm exists"
+    } else {
+        Write-Host "   ❌ bin\slm-npm not found" -ForegroundColor Red
+        exit 1
+    }
+
+    # Step 8: Final summary
+    Write-Host ""
+    Write-Host "╔══════════════════════════════════════════════════════════════╗"
+    Write-Host "║  Test Summary                                                ║"
+    Write-Host "╚══════════════════════════════════════════════════════════════╝"
+    Write-Host ""
+    Write-Host "✅ Package structure: OK"
+    Write-Host "✅ File validation: OK"
+    Write-Host "✅ npm pack: OK ($SIZE MB)"
+    Write-Host "✅ npm link: OK"
+    Write-Host "✅ Scripts valid: OK"
+    Write-Host ""
+    Write-Host "📦 Package ready for testing!"
+    Write-Host ""
+    Write-Host "Next steps:"
+    Write-Host "1. Test manual install:"
+    Write-Host "   npm install -g .\$($TARBALL.Name)"
+    Write-Host "   slm status"
+    Write-Host "   npm uninstall -g superlocalmemory"
+    Write-Host ""
+    Write-Host "2. Test on Docker (recommended):"
+    Write-Host "   docker run -it --rm -v ${PWD}:/app node:18 bash"
+    Write-Host "   cd /app"
+    Write-Host "   npm install -g ./$($TARBALL.Name)"
+    Write-Host "   slm status"
+    Write-Host ""
+    Write-Host "3. When ready to publish:"
+    Write-Host "   npm login"
+    Write-Host "   npm publish"
+    Write-Host ""
+    Write-Host "Full guide: NPM-PUBLISHING-GUIDE.md"
+    Write-Host ""
+
+    # Cleanup
+    Remove-Item $TARBALL.FullName -Force
+    Write-Host "🧹 Cleaned up test tarball"
+
+} finally {
+    Pop-Location
+}

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"