superlocalmemory 2.8.6 → 3.0.1

package/bin/slm

@@ -1,452 +1,20 @@
-#!/bin/bash
-# slm - Universal CLI wrapper for SuperLocalMemory V2
-# Simple commands that work in any terminal or script
-#
-# Copyright (c) 2026 Varun Pratap Bhardwaj
-# Licensed under MIT License
-#
-# This is a CONVENIENCE wrapper. Original commands still work:
-#   superlocalmemoryv2-remember, superlocalmemoryv2-recall, etc.
-
-set -e
-
-SLM_DIR="${SL_MEMORY_PATH:-${HOME}/.claude-memory}"
-
-# Check if SuperLocalMemory is installed
-if [ ! -d "$SLM_DIR" ]; then
-    echo "Error: SuperLocalMemory V2 not installed at $SLM_DIR"
-    echo "Please run: ./install.sh"
+#!/usr/bin/env bash
+# SuperLocalMemory V3 CLI
+# Part of Qualixar | https://superlocalmemory.com
+
+# Find Python
+PYTHON=""
+for cmd in python3 python; do
+    if command -v "$cmd" &>/dev/null; then
+        PYTHON="$cmd"
+        break
+    fi
+done
+
+if [ -z "$PYTHON" ]; then
+    echo "Error: Python 3 not found. Install Python 3.10+ from python.org"
     exit 1
 fi
 
-# Main command dispatcher
-case "$1" in
-    remember|save|store)
-        shift
-        # Calls existing command - no duplicate logic
-        "$SLM_DIR/bin/superlocalmemoryv2-remember" "$@"
-        ;;
-
-    recall|search|find)
-        shift
-        # Calls existing command - no duplicate logic
-        "$SLM_DIR/bin/superlocalmemoryv2-recall" "$@"
-        ;;
-
-    list|ls)
-        shift
-        # Convert positional number to --limit flag
-        # e.g., "slm list 5" becomes "--limit 5"
-        if [ -n "$1" ] && [[ "$1" =~ ^[0-9]+$ ]]; then
-            "$SLM_DIR/bin/superlocalmemoryv2-list" --limit "$1"
-        else
-            "$SLM_DIR/bin/superlocalmemoryv2-list" "$@"
-        fi
-        ;;
-
-    status|info|stats)
-        # Calls existing command - no duplicate logic
-        "$SLM_DIR/bin/superlocalmemoryv2-status"
-        ;;
-
-    profile)
-        shift
-        # Calls existing command - no duplicate logic
-        "$SLM_DIR/bin/superlocalmemoryv2-profile" "$@"
-        ;;
-
-    switch-profile)
-        shift
-        # Convenience alias: "slm switch-profile <name>" -> "slm profile switch <name>"
-        "$SLM_DIR/bin/superlocalmemoryv2-profile" switch "$@"
-        ;;
-
-    list-profiles)
-        # Convenience alias: "slm list-profiles" -> "slm profile list"
-        "$SLM_DIR/bin/superlocalmemoryv2-profile" list
-        ;;
-
-    create-profile)
-        shift
-        # Convenience alias: "slm create-profile <name>" -> "slm profile create <name>"
-        "$SLM_DIR/bin/superlocalmemoryv2-profile" create "$@"
-        ;;
-
-    reset)
-        shift
-        # Calls existing command - no duplicate logic
-        "$SLM_DIR/bin/superlocalmemoryv2-reset" "$@"
-        ;;
-
-    ui|dashboard)
-        PORT="${2:-8765}"
-        echo "Starting SuperLocalMemory Web Dashboard..."
-        echo "URL: http://localhost:$PORT"
-        echo "API Docs: http://localhost:$PORT/api/docs"
-        echo ""
-        python3 "$SLM_DIR/ui_server.py" --port "$PORT"
-        ;;
-
-    serve|server)
-        PORT="${2:-8417}"
-        echo "Starting SuperLocalMemory MCP HTTP server..."
-        echo "Endpoint: http://localhost:$PORT"
-        echo ""
-        echo "For ChatGPT/remote access:"
-        echo "  1. In another terminal: ngrok http $PORT"
-        echo "  2. Copy the HTTPS URL"
-        echo "  3. Add to ChatGPT: Settings -> Apps & Connectors -> Developer Mode"
-        echo ""
-        exec python3 "$SLM_DIR/mcp_server.py" --transport http --port "$PORT"
-        ;;
-
-    context)
-        # NEW: Get context for current directory/project
-        project=$(basename "$PWD")
-        "$SLM_DIR/bin/superlocalmemoryv2-recall" "$project" --limit 5
-        ;;
-
-    graph)
-        shift
-        subcommand="$1"
-        shift
-        case "$subcommand" in
-            build)
-                python3 "$SLM_DIR/graph_engine.py" build "$@"
-                ;;
-            stats)
-                python3 "$SLM_DIR/graph_engine.py" stats "$@"
-                ;;
-            *)
-                echo "Usage: slm graph {build|stats}"
-                exit 1
-                ;;
-        esac
-        ;;
-
-    patterns)
-        shift
-        subcommand="$1"
-        shift
-        case "$subcommand" in
-            update)
-                python3 "$SLM_DIR/pattern_learner.py" update "$@"
-                ;;
-            list)
-                python3 "$SLM_DIR/pattern_learner.py" list "$@"
-                ;;
-            context)
-                python3 "$SLM_DIR/pattern_learner.py" context "$@"
-                ;;
-            correct)
-                # slm patterns correct <id> <new_value>
-                pattern_id="$1"
-                new_value="$2"
-                if [ -z "$pattern_id" ] || [ -z "$new_value" ]; then
-                    echo "Usage: slm patterns correct <pattern_id> <new_value>"
-                    exit 1
-                fi
-                python3 -c "
-import sys
-sys.path.insert(0, '${SLM_DIR}')
-sys.path.insert(0, '$(dirname "${SLM_DIR}")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
-try:
-    from learning import get_learning_db
-    ldb = get_learning_db()
-    if ldb:
-        conn = ldb._get_connection()
-        cursor = conn.cursor()
-        cursor.execute('SELECT * FROM transferable_patterns WHERE id = ?', (int(sys.argv[1]),))
-        p = cursor.fetchone()
-        conn.close()
-        if p:
-            ldb.upsert_transferable_pattern(
-                pattern_type=p['pattern_type'], key=p['key'],
-                value=sys.argv[2], confidence=1.0,
-                evidence_count=p['evidence_count']+1,
-                profiles_seen=p['profiles_seen'],
-                contradictions=[f\"Corrected from '{p['value']}' to '{sys.argv[2]}'\"],
-            )
-            print(f\"Pattern '{p['key']}' corrected: '{p['value']}' -> '{sys.argv[2]}'\")
-        else:
-            print(f'Pattern #{sys.argv[1]} not found')
-    else:
-        print('Learning database not available')
-except ImportError:
-    print('Learning features not available')
-except Exception as e:
-    print(f'Error: {e}')
-" "$pattern_id" "$new_value"
-                ;;
-            *)
-                echo "Usage: slm patterns {update|list|context|correct}"
-                exit 1
-                ;;
-        esac
-        ;;
-
-    useful)
-        shift
-        # Mark memory IDs as useful (v2.7 learning feedback)
-        if [ -z "$1" ]; then
-            echo "Usage: slm useful <memory_id> [memory_id...]"
-            echo "  Mark recalled memories as useful to improve future ranking"
-            exit 1
-        fi
-        python3 -c "
-import sys
-sys.path.insert(0, '${SLM_DIR}')
-sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
-try:
-    from learning.feedback_collector import FeedbackCollector
-    fc = FeedbackCollector()
-    ids = [int(x) for x in sys.argv[1:]]
-    fc.record_cli_useful(ids, query='cli-feedback')
-    print(f'Marked {len(ids)} memor{\"y\" if len(ids)==1 else \"ies\"} as useful')
-except ImportError:
-    print('Learning features not available. Install: pip3 install lightgbm scipy')
-except Exception as e:
-    print(f'Error: {e}')
-" "$@"
-        ;;
-
-    learning)
-        shift
-        subcommand="${1:-status}"
-        shift 2>/dev/null || true
-        case "$subcommand" in
-            status)
-                python3 -c "
-import sys, json
-sys.path.insert(0, '${SLM_DIR}')
-sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
-try:
-    from learning import get_status
-    status = get_status()
-    print('SuperLocalMemory v2.7 — Learning System Status')
-    print('=' * 50)
-    deps = status['dependencies']
-    print(f'LightGBM:  {\"installed (\" + deps[\"lightgbm\"][\"version\"] + \")\" if deps[\"lightgbm\"][\"installed\"] else \"not installed\"}')
-    print(f'SciPy:     {\"installed (\" + deps[\"scipy\"][\"version\"] + \")\" if deps[\"scipy\"][\"installed\"] else \"not installed\"}')
-    print(f'ML Ranking:  {\"available\" if status[\"ml_ranking_available\"] else \"unavailable\"}')
-    print(f'Full Learning: {\"available\" if status[\"learning_available\"] else \"unavailable\"}')
-    if status.get('learning_db_stats'):
-        s = status['learning_db_stats']
-        print(f'')
-        print(f'Feedback signals: {s[\"feedback_count\"]}')
-        print(f'Unique queries:   {s[\"unique_queries\"]}')
-        print(f'Patterns learned: {s[\"transferable_patterns\"]} ({s[\"high_confidence_patterns\"]} high confidence)')
-        print(f'Workflow patterns: {s[\"workflow_patterns\"]}')
-        print(f'Sources tracked:  {s[\"tracked_sources\"]}')
-        print(f'Models trained:   {s[\"models_trained\"]}')
-        print(f'Learning DB size: {s[\"db_size_kb\"]} KB')
-except ImportError:
-    print('Learning features not available. Install: pip3 install lightgbm scipy')
-except Exception as e:
-    print(f'Error: {e}')
-"
-                ;;
-            retrain)
-                python3 -c "
-import sys
-sys.path.insert(0, '${SLM_DIR}')
-sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
-try:
-    from learning import get_adaptive_ranker
-    ranker = get_adaptive_ranker()
-    if ranker:
-        result = ranker.train(force=True)
-        if result:
-            print(f'Model retrained successfully')
-        else:
-            print('Insufficient data for training (need 200+ feedback signals)')
-    else:
-        print('Adaptive ranker not available')
-except ImportError:
-    print('Learning features not available. Install: pip3 install lightgbm scipy')
-except Exception as e:
-    print(f'Error: {e}')
-"
-                ;;
-            reset)
-                python3 -c "
-import sys
-sys.path.insert(0, '${SLM_DIR}')
-sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
-try:
-    from learning import get_learning_db
-    ldb = get_learning_db()
-    if ldb:
-        ldb.reset()
-        print('All learning data reset. Memories in memory.db preserved.')
-    else:
-        print('Learning database not available')
-except ImportError:
-    print('Learning features not available')
-except Exception as e:
-    print(f'Error: {e}')
-"
-                ;;
-            *)
-                echo "Usage: slm learning {status|retrain|reset}"
-                exit 1
-                ;;
-        esac
-        ;;
-
-    engagement)
-        python3 -c "
-import sys
-sys.path.insert(0, '${SLM_DIR}')
-sys.path.insert(0, '$(dirname \"${SLM_DIR}\")/Documents/AGENTIC_Official/SuperLocalMemoryV2-repo/src')
-try:
-    from learning.engagement_tracker import EngagementTracker
-    tracker = EngagementTracker()
-    print(tracker.format_for_cli())
-except ImportError:
-    print('Learning features not available. Install: pip3 install lightgbm scipy')
-except Exception as e:
-    print(f'Error: {e}')
-"
-        ;;
-
-    attribution)
-        python3 -c "
-import sys
-sys.path.insert(0, '${SLM_DIR}')
-try:
-    from memory_store_v2 import MemoryStoreV2
-    store = MemoryStoreV2()
-    attr = store.get_attribution()
-    print('SuperLocalMemory — Attribution')
-    print('=' * 45)
-    print(f\"Creator:  {attr.get('creator_name', 'Varun Pratap Bhardwaj')}\")
-    print(f\"Role:     {attr.get('creator_role', 'Solution Architect')}\")
-    print(f\"Platform: {attr.get('platform', 'Qualixar')}\")
-    print(f\"License:  {attr.get('license', 'MIT')}\")
-    print(f\"Website:  {attr.get('website', 'https://superlocalmemory.com')}\")
-    print(f\"Author:   {attr.get('author_website', 'https://varunpratap.com')}\")
-    print('=' * 45)
-    try:
-        from qualixar_attribution import QualixarSigner
-        from qualixar_watermark import encode_watermark
-        print('Layer 1 (Visible):        Active')
-        print('Layer 2 (Cryptographic):  Active')
-        print('Layer 3 (Steganographic): Active')
-    except ImportError:
-        print('Layer 1 (Visible):        Active')
-        print('Layer 2 (Cryptographic):  Not available')
-        print('Layer 3 (Steganographic): Not available')
-except Exception as e:
-    print(f'Error: {e}')
-"
-        ;;
-
-    help|--help|-h)
-        cat <<EOF
-SuperLocalMemory V2 - Universal CLI
-
-SIMPLE COMMANDS:
-  slm remember <content>    Save to memory
-  slm recall <query>        Search memories
-  slm list [N]             List N recent memories (default 10)
-  slm status               System status and statistics
-  slm context              Project context for current directory
-
-PROFILE MANAGEMENT:
-  slm profile list         List all profiles
-  slm profile create <name> Create new profile
-  slm profile switch <name> Switch to profile
-  slm profile delete <name> Delete profile
-  slm profile current      Show current profile
-  slm switch-profile <name> Shortcut for profile switch
-  slm list-profiles         Shortcut for profile list
-  slm create-profile <name> Shortcut for profile create
-
-KNOWLEDGE GRAPH:
-  slm graph build          Build/rebuild knowledge graph
-  slm graph stats          Show graph statistics
-
-PATTERN LEARNING:
-  slm patterns update      Learn patterns from memories
-  slm patterns list [threshold]  List learned patterns
-  slm patterns context [threshold]  Get coding identity context
-  slm patterns correct <id> <value>  Correct a learned pattern
-
-LEARNING (v2.7):
-  slm useful <id> [id...]  Mark memories as useful (ranking feedback)
-  slm learning status      Learning system status
-  slm learning retrain     Force model retrain
-  slm learning reset       Delete all learning data (memories preserved)
-  slm engagement           Show engagement metrics
-
-WEB DASHBOARD:
-  slm ui [PORT]            Start web dashboard (default port 8765)
-                           Opens at http://localhost:PORT
-
-HTTP SERVER (MCP):
-  slm serve [PORT]         Start MCP HTTP server (default port 8417)
-                           For ChatGPT/remote: ngrok http PORT
-
-ATTRIBUTION:
-  slm attribution          Show creator attribution and provenance status
-
-ADVANCED:
-  slm reset soft           Soft reset (clear memories)
-  slm reset hard --confirm Hard reset (nuclear option)
-
-ORIGINAL COMMANDS (still work):
-  superlocalmemoryv2-remember <content>
-  superlocalmemoryv2-recall <query>
-  superlocalmemoryv2-list [N]
-  superlocalmemoryv2-status
-  superlocalmemoryv2-profile <command>
-  superlocalmemoryv2-reset <type>
-
-EXAMPLES:
-  slm remember "Use FastAPI for REST APIs" --tags python,backend
-  slm recall "FastAPI patterns" --limit 5
-  slm context
-  slm graph build
-  slm patterns update
-  slm status
-
-DOCUMENTATION:
-  README: https://github.com/varun369/SuperLocalMemoryV2
-  Docs: ~/.claude-memory/docs/
-
-VERSION: 2.7.0
-EOF
-        ;;
-
-    version|--version|-v)
-        echo "SuperLocalMemory V2 - Universal CLI"
-        echo "Version: 2.7.0"
-        echo "Database: $SLM_DIR/memory.db"
-        ;;
-
-    *)
-        echo "SuperLocalMemory V2 - Universal CLI"
-        echo ""
-        echo "Usage: slm <command> [args]"
-        echo ""
-        echo "Commands:"
-        echo "  remember  - Save to memory"
-        echo "  recall    - Search memories"
-        echo "  list      - List recent memories"
-        echo "  status    - System status"
-        echo "  context   - Project context"
-        echo "  ui        - Start web dashboard"
-        echo "  serve     - Start MCP HTTP server"
-        echo "  profile   - Manage profiles"
-        echo "  graph     - Knowledge graph operations"
-        echo "  patterns  - Pattern learning"
-        echo "  useful    - Mark memories as useful"
-        echo "  learning  - Learning system management"
-        echo "  engagement - Show engagement metrics"
-        echo "  help      - Show detailed help"
-        echo ""
-        echo "Run 'slm help' for more information"
-        exit 1
-        ;;
-esac
+# Run V3 CLI
+exec "$PYTHON" -m superlocalmemory.cli.main "$@"

package/bin/slm-npm

@@ -1,14 +1,10 @@
 #!/usr/bin/env node
 /**
- * SuperLocalMemory V2 - NPM Global CLI Wrapper
- *
- * Copyright (c) 2026 Varun Pratap Bhardwaj
- * Solution Architect & Original Creator
+ * SuperLocalMemory V3 - NPM Global CLI Wrapper
  *
+ * Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
  * Licensed under MIT License (see LICENSE file)
- * Repository: https://github.com/varun369/SuperLocalMemoryV2
- *
- * ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
+ * Repository: https://github.com/qualixar/superlocalmemory
  */
 
 const { spawnSync } = require('child_process');
@@ -16,58 +12,76 @@ const path = require('path');
 const os = require('os');
 const fs = require('fs');
 
-// Installation directory (SL_MEMORY_PATH overrides default)
-const SLM_DIR = process.env.SL_MEMORY_PATH || path.join(os.homedir(), '.claude-memory');
+// V3 package root (where src/superlocalmemory/ lives)
+const PKG_ROOT = path.join(__dirname, '..');
+const SRC_DIR = path.join(PKG_ROOT, 'src');
+const CLI_MODULE = 'superlocalmemory.cli.main';
 
-// Check if SuperLocalMemory is installed
-if (!fs.existsSync(SLM_DIR)) {
-    console.error('Error: SuperLocalMemory V2 not installed at ' + SLM_DIR);
-    console.error('Installation should have run automatically via postinstall script.');
-    console.error('Please run manually:');
+// Find Python 3 binary (robust multi-fallback detection)
+function findPython() {
+    const candidates = [
+        'python3',
+        'python',
+        '/opt/homebrew/bin/python3',
+        '/usr/local/bin/python3',
+        '/usr/bin/python3',
+    ];
 
+    // On Windows, also check common locations
     if (os.platform() === 'win32') {
-        console.error('  powershell -ExecutionPolicy Bypass -File "' + path.join(__dirname, '..', 'install.ps1') + '"');
-    } else {
-        console.error('  bash "' + path.join(__dirname, '..', 'install.sh') + '"');
+        candidates.push(
+            'py -3',
+            path.join(process.env.LOCALAPPDATA || '', 'Programs', 'Python', 'Python312', 'python.exe'),
+            path.join(process.env.LOCALAPPDATA || '', 'Programs', 'Python', 'Python311', 'python.exe'),
+        );
     }
-    process.exit(1);
-}
 
-// Platform-specific slm script path
-let slmScript;
-if (os.platform() === 'win32') {
-    slmScript = path.join(SLM_DIR, 'bin', 'slm.cmd');
-    if (!fs.existsSync(slmScript)) {
-        slmScript = path.join(SLM_DIR, 'bin', 'slm');
+    for (const candidate of candidates) {
+        try {
+            const parts = candidate.split(' ');
+            const result = spawnSync(parts[0], [...parts.slice(1), '--version'], {
+                stdio: 'pipe',
+                timeout: 5000,
+            });
+            if (result.status === 0) {
+                const version = (result.stdout || '').toString().trim();
+                if (version.includes('3.')) {
+                    return candidate;
+                }
+            }
+        } catch (e) {
+            // Try next candidate
+        }
     }
-} else {
-    slmScript = path.join(SLM_DIR, 'bin', 'slm');
+    return null;
 }
 
-// Check if slm script exists
-if (!fs.existsSync(slmScript)) {
-    console.error('Error: SLM CLI not found at ' + slmScript);
-    console.error('Installation may be incomplete. Please run install script manually.');
+// Ensure ~/.superlocalmemory/ exists
+const SLM_HOME = process.env.SL_MEMORY_PATH || path.join(os.homedir(), '.superlocalmemory');
+if (!fs.existsSync(SLM_HOME)) {
+    fs.mkdirSync(SLM_HOME, { recursive: true });
+}
+
+// Find Python
+const python = findPython();
+if (!python) {
+    console.error('Error: Python 3.11+ not found.');
+    console.error('Install Python from https://python.org/downloads/');
     process.exit(1);
 }
 
-// Pass all arguments to the real slm command
+// Launch V3 CLI via Python module
 const args = process.argv.slice(2);
+const pythonParts = python.split(' ');
+const result = spawnSync(pythonParts[0], [
+    ...pythonParts.slice(1),
+    '-m', CLI_MODULE, ...args
+], {
+    stdio: 'inherit',
+    env: {
+        ...process.env,
+        PYTHONPATH: SRC_DIR + (process.env.PYTHONPATH ? path.delimiter + process.env.PYTHONPATH : ''),
+    },
+});
 
-// Use spawnSync for secure execution (no shell injection risk)
-let result;
-if (os.platform() === 'win32') {
-    // Windows: Use cmd or PowerShell
-    result = spawnSync(slmScript, args, {
-        stdio: 'inherit',
-        shell: true
-    });
-} else {
-    // Mac/Linux: Direct bash execution
-    result = spawnSync('bash', [slmScript, ...args], {
-        stdio: 'inherit'
-    });
-}
-
-// Exit with the same code as the child process
 process.exit(result.status || 0);

package/conftest.py

@@ -0,0 +1,5 @@
+"""Root conftest — ensures src/ is on PYTHONPATH for test discovery."""
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent / "src"))