superlocalmemory 2.8.5 → 3.0.0

package/scripts/sync-wiki.ps1

@@ -0,0 +1,127 @@
+# ============================================================================
+# SuperLocalMemory V2 - Wiki Sync Script (PowerShell)
+# Automatically syncs wiki-content/ to GitHub Wiki repository
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# ============================================================================
+
+param()
+
+$ErrorActionPreference = "Stop"
+
+# Configuration
+$REPO_DIR = $PSScriptRoot
+$WIKI_CONTENT_DIR = Join-Path $REPO_DIR "wiki-content"
+$WIKI_REPO_DIR = Join-Path $env:TEMP "SuperLocalMemoryV2.wiki"
+$WIKI_REPO_URL = "https://github.com/varun369/SuperLocalMemoryV2.wiki.git"
+
+Write-Host "╔══════════════════════════════════════════════════════════════╗"
+Write-Host "║  SuperLocalMemory V2 - Wiki Sync Tool                        ║"
+Write-Host "║  by Varun Pratap Bhardwaj                                    ║"
+Write-Host "╚══════════════════════════════════════════════════════════════╝"
+Write-Host ""
+
+# Check if wiki-content exists
+if (-not (Test-Path $WIKI_CONTENT_DIR)) {
+    Write-Host "✗ Error: wiki-content/ directory not found" -ForegroundColor Red
+    exit 1
+}
+
+# Clone or update wiki repo
+if (Test-Path $WIKI_REPO_DIR) {
+    Write-Host "📥 Updating existing wiki repository..."
+    Push-Location $WIKI_REPO_DIR
+    try {
+        $DEFAULT_BRANCH = git symbolic-ref refs/remotes/origin/HEAD 2>$null
+        if ($DEFAULT_BRANCH) {
+            $DEFAULT_BRANCH = $DEFAULT_BRANCH -replace '^refs/remotes/origin/', ''
+        } else {
+            $DEFAULT_BRANCH = "master"
+        }
+        git pull origin $DEFAULT_BRANCH
+    } finally {
+        Pop-Location
+    }
+} else {
+    Write-Host "📥 Cloning wiki repository..."
+    git clone $WIKI_REPO_URL $WIKI_REPO_DIR
+    Set-Location $WIKI_REPO_DIR
+    $DEFAULT_BRANCH = git symbolic-ref refs/remotes/origin/HEAD 2>$null
+    if ($DEFAULT_BRANCH) {
+        $DEFAULT_BRANCH = $DEFAULT_BRANCH -replace '^refs/remotes/origin/', ''
+    } else {
+        $DEFAULT_BRANCH = "master"
+    }
+}
+
+# Sync wiki files (PowerShell equivalent of rsync)
+Write-Host ""
+Write-Host "📋 Syncing wiki files..."
+
+Push-Location $WIKI_REPO_DIR
+try {
+    # Remove old files except .git and excluded files
+    $excludeFiles = @("DEPLOYMENT-CHECKLIST.md", "WIKI-UPDATE-SUMMARY.md", "NEW-PAGES-SUMMARY.md", "README.md")
+    Get-ChildItem -Path . -Recurse -File | Where-Object {
+        $_.Name -notin $excludeFiles -and $_.FullName -notlike "*\.git\*"
+    } | Remove-Item -Force
+
+    # Copy new files from wiki-content
+    Get-ChildItem -Path $WIKI_CONTENT_DIR -Recurse -File | Where-Object {
+        $_.Name -notin $excludeFiles
+    } | ForEach-Object {
+        $relativePath = $_.FullName.Substring($WIKI_CONTENT_DIR.Length + 1)
+        $targetPath = Join-Path $WIKI_REPO_DIR $relativePath
+        $targetDir = Split-Path $targetPath -Parent
+        if (-not (Test-Path $targetDir)) {
+            New-Item -ItemType Directory -Path $targetDir -Force | Out-Null
+        }
+        Copy-Item $_.FullName -Destination $targetPath -Force
+    }
+
+    # Remove old naming
+    $oldFile = Join-Path $WIKI_REPO_DIR "4-Layer-Architecture.md"
+    if (Test-Path $oldFile) {
+        Remove-Item $oldFile -Force
+    }
+
+    # Check for changes
+    $changes = git status --porcelain
+    if (-not $changes) {
+        Write-Host "✓ No changes to sync" -ForegroundColor Green
+        exit 0
+    }
+
+    # Show what changed
+    Write-Host ""
+    Write-Host "📝 Changes detected:"
+    git status --short
+
+    # Commit and push
+    Write-Host ""
+    Write-Host "💾 Committing changes..."
+    git add .
+
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm"
+    $commitMessage = @"
+Sync: Update wiki from main repo ($timestamp)
+
+Automated sync from wiki-content/ directory
+
+Created by: Varun Pratap Bhardwaj
+"@
+
+    git commit -m $commitMessage
+
+    Write-Host ""
+    Write-Host "📤 Pushing to GitHub Wiki..."
+    git push origin $DEFAULT_BRANCH
+
+    Write-Host ""
+    Write-Host "╔══════════════════════════════════════════════════════════════╗"
+    Write-Host "║  ✅ Wiki synced successfully!                                 ║"
+    Write-Host "║  View at: https://github.com/varun369/SuperLocalMemoryV2/wiki║"
+    Write-Host "╚══════════════════════════════════════════════════════════════╝"
+
+} finally {
+    Pop-Location
+}

package/scripts/sync-wiki.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+# ============================================================================
+# SuperLocalMemory V2 - Wiki Sync Script
+# Automatically syncs wiki-content/ to GitHub Wiki repository
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# ============================================================================
+
+set -e
+
+REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+WIKI_CONTENT_DIR="${REPO_DIR}/wiki-content"
+WIKI_REPO_DIR="/tmp/SuperLocalMemoryV2.wiki"
+WIKI_REPO_URL="https://github.com/varun369/SuperLocalMemoryV2.wiki.git"
+
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║  SuperLocalMemory V2 - Wiki Sync Tool                        ║"
+echo "║  by Varun Pratap Bhardwaj                                    ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Check if wiki-content exists
+if [ ! -d "${WIKI_CONTENT_DIR}" ]; then
+    echo "✗ Error: wiki-content/ directory not found"
+    exit 1
+fi
+
+# Clone or update wiki repo
+if [ -d "${WIKI_REPO_DIR}" ]; then
+    echo "📥 Updating existing wiki repository..."
+    cd "${WIKI_REPO_DIR}"
+    DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' || echo "master")
+    git pull origin "${DEFAULT_BRANCH}"
+else
+    echo "📥 Cloning wiki repository..."
+    git clone "${WIKI_REPO_URL}" "${WIKI_REPO_DIR}"
+    cd "${WIKI_REPO_DIR}"
+fi
+
+# Sync wiki files
+echo ""
+echo "📋 Syncing wiki files..."
+rsync -av --delete \
+    --exclude='.git' \
+    --exclude='DEPLOYMENT-CHECKLIST.md' \
+    --exclude='WIKI-UPDATE-SUMMARY.md' \
+    --exclude='NEW-PAGES-SUMMARY.md' \
+    --exclude='README.md' \
+    "${WIKI_CONTENT_DIR}/" "${WIKI_REPO_DIR}/"
+
+# Remove old naming
+rm -f "${WIKI_REPO_DIR}/4-Layer-Architecture.md"
+
+# Check for changes
+if [ -z "$(git status --porcelain)" ]; then
+    echo "✓ No changes to sync"
+    exit 0
+fi
+
+# Show what changed
+echo ""
+echo "📝 Changes detected:"
+git status --short
+
+# Commit and push
+echo ""
+echo "💾 Committing changes..."
+git add .
+git commit -m "Sync: Update wiki from main repo ($(date '+%Y-%m-%d %H:%M'))
+
+Automated sync from wiki-content/ directory
+
+Created by: Varun Pratap Bhardwaj"
+
+echo ""
+echo "📤 Pushing to GitHub Wiki..."
+git push origin "${DEFAULT_BRANCH:-master}"
+
+echo ""
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║  ✅ Wiki synced successfully!                                 ║"
+echo "║  View at: https://github.com/varun369/SuperLocalMemoryV2/wiki║"
+echo "╚══════════════════════════════════════════════════════════════╝"

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
+}