superlocalmemory 3.6.13 → 3.6.14

package/scripts/install-skills.sh

@@ -1,436 +1,5 @@
 #!/bin/bash
-
-# SuperLocalMemory V2 - Universal Skills Installer
-# Installs skills for Claude Code, Codex, Gemini CLI, Antigravity, and Windsurf
-
-set -e
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Configuration
-REPO_DIR="$(cd "$(dirname "$0")" && pwd)"
-SKILLS_SOURCE="$REPO_DIR/skills"
-
-# Parse arguments
-AUTO_MODE=false
-for arg in "$@"; do
-    case $arg in
-        --auto)
-            AUTO_MODE=true
-            shift
-            ;;
-    esac
-done
-
-# Tool definitions (parallel arrays for bash 3.2 compatibility)
-TOOL_IDS=("claude_code" "codex" "gemini_cli" "antigravity" "windsurf" "cursor" "vscode_copilot")
-TOOL_NAMES=("Claude Code" "Codex" "Gemini CLI" "Antigravity" "Windsurf" "Cursor" "VS Code/Copilot")
-TOOL_DIRS=(
-    "$HOME/.claude/skills"
-    "$HOME/.codex/skills"
-    "$HOME/.gemini/skills"
-    "$HOME/.gemini/antigravity/skills"
-    "$HOME/.windsurf/skills"
-    "$HOME/.cursor/skills"
-    "$HOME/.copilot/skills"
-)
-
-# Helper function to get tool name by ID
-get_tool_name() {
-    local tool_id="$1"
-    for i in "${!TOOL_IDS[@]}"; do
-        if [ "${TOOL_IDS[$i]}" = "$tool_id" ]; then
-            echo "${TOOL_NAMES[$i]}"
-            return
-        fi
-    done
-    echo "$tool_id"
-}
-
-# Helper function to get tool directory by ID
-get_tool_dir() {
-    local tool_id="$1"
-    for i in "${!TOOL_IDS[@]}"; do
-        if [ "${TOOL_IDS[$i]}" = "$tool_id" ]; then
-            echo "${TOOL_DIRS[$i]}"
-            return
-        fi
-    done
-    echo ""
-}
-
-# Skills to install (from skills/ directory)
-SKILLS=(
-    "slm-remember"
-    "slm-recall"
-    "slm-status"
-    "slm-list-recent"
-    "slm-build-graph"
-    "slm-switch-profile"
-)
-
-echo "=========================================="
-echo "SuperLocalMemory V2 - Universal Skills Installer"
-echo "=========================================="
-echo ""
-
-# Check if SuperLocalMemory V2 is installed
-if [ ! -d "$HOME/.superlocalmemory" ]; then
-    echo -e "${YELLOW}Warning:${NC} SuperLocalMemory V2 not found at ~/.superlocalmemory/"
-    echo "Skills require SuperLocalMemory V2 to be installed first."
-    echo ""
-    if [ "$AUTO_MODE" = true ]; then
-        echo "Auto mode: continuing anyway..."
-    else
-        read -p "Do you want to continue anyway? (y/n) " -n 1 -r
-        echo ""
-        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-            echo "Installation cancelled."
-            echo "Please install SuperLocalMemory V2 first: ./install.sh"
-            exit 1
-        fi
-    fi
-fi
-
-# Check if skills source directory exists
-if [ ! -d "$SKILLS_SOURCE" ]; then
-    echo -e "${RED}Error:${NC} Skills directory not found: $SKILLS_SOURCE"
-    echo "Please run this script from the superlocalmemory-repo directory."
-    exit 1
-fi
-
-# Verify all skill directories exist
-echo "Verifying skill files..."
-MISSING_SKILLS=0
-for skill in "${SKILLS[@]}"; do
-    if [ ! -d "$SKILLS_SOURCE/$skill" ]; then
-        echo -e "${RED}✗${NC} Missing: $skill/"
-        ((MISSING_SKILLS++))
-    elif [ ! -f "$SKILLS_SOURCE/$skill/SKILL.md" ]; then
-        echo -e "${RED}✗${NC} Missing: $skill/SKILL.md"
-        ((MISSING_SKILLS++))
-    else
-        echo -e "${GREEN}✓${NC} Found: $skill/SKILL.md"
-    fi
-done
-
-if [ "$MISSING_SKILLS" -gt 0 ]; then
-    echo -e "${RED}Error:${NC} $MISSING_SKILLS skill(s) missing. Cannot proceed."
-    exit 1
-fi
-
-echo ""
-echo "Found ${#SKILLS[@]} skills to install"
-echo ""
-
-# Detect available tools
-echo "=========================================="
-echo "Detecting AI Tools"
-echo "=========================================="
-echo ""
-
-DETECTED_TOOLS=()
-
-for i in "${!TOOL_IDS[@]}"; do
-    tool_id="${TOOL_IDS[$i]}"
-    tool_name="${TOOL_NAMES[$i]}"
-    tool_dir="${TOOL_DIRS[$i]}"
-    parent_dir=$(dirname "$tool_dir")
-
-    # Check if parent directory exists (tool is installed)
-    if [ -d "$parent_dir" ]; then
-        echo -e "${GREEN}✓${NC} $tool_name detected: $tool_dir"
-        DETECTED_TOOLS+=("$tool_id")
-    else
-        echo -e "${BLUE}○${NC} $tool_name not found: $parent_dir"
-    fi
-done
-
-echo ""
-
-if [ ${#DETECTED_TOOLS[@]} -eq 0 ]; then
-    if [ "$AUTO_MODE" = true ]; then
-        echo -e "${YELLOW}Warning:${NC} No supported AI tools detected. Skipping skills installation."
-        echo ""
-        exit 0
-    fi
-    echo -e "${YELLOW}Warning:${NC} No supported AI tools detected."
-    echo ""
-    echo "Supported tools:"
-    for i in "${!TOOL_IDS[@]}"; do
-        echo "  - ${TOOL_NAMES[$i]}: ${TOOL_DIRS[$i]}"
-    done
-    echo ""
-    read -p "Do you want to continue and create directories anyway? (y/n) " -n 1 -r
-    echo ""
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-        echo "Installation cancelled."
-        exit 1
-    fi
-    # If user wants to continue, add all tools to install list
-    for tool_id in "${TOOL_IDS[@]}"; do
-        DETECTED_TOOLS+=("$tool_id")
-    done
-else
-    echo "Will install skills for ${#DETECTED_TOOLS[@]} tool(s)"
-    echo ""
-fi
-
-# Ask user for installation method
-if [ "$AUTO_MODE" = true ]; then
-    METHOD="symlink"
-    echo "Auto mode: Using symlink method..."
-else
-    echo "Installation Methods:"
-    echo "  1. Symlink (recommended) - Changes in repo reflect immediately"
-    echo "  2. Copy - Stable, requires manual updates"
-    echo ""
-    read -p "Choose installation method (1 or 2): " -n 1 -r
-    echo ""
-    echo ""
-
-    if [[ $REPLY == "1" ]]; then
-        METHOD="symlink"
-        echo "Installing via symlink..."
-    elif [[ $REPLY == "2" ]]; then
-        METHOD="copy"
-        echo "Installing via copy..."
-    else
-        echo -e "${RED}Invalid choice.${NC} Please enter 1 or 2."
-        exit 1
-    fi
-fi
-
-echo ""
-
-# Install skills for each detected tool
-TOTAL_INSTALLED=0
-TOTAL_FAILED=0
-TOTAL_SKIPPED=0
-
-for tool_id in "${DETECTED_TOOLS[@]}"; do
-    tool_name=$(get_tool_name "$tool_id")
-    echo "=========================================="
-    echo "Installing for: $tool_name"
-    echo "=========================================="
-
-    skills_dir=$(get_tool_dir "$tool_id")
-
-    # Create skills directory if it doesn't exist
-    if [ ! -d "$skills_dir" ]; then
-        echo "Creating directory: $skills_dir"
-        if mkdir -p "$skills_dir"; then
-            echo -e "${GREEN}✓${NC} Directory created"
-        else
-            echo -e "${RED}✗${NC} Failed to create directory"
-            echo ""
-            ((TOTAL_SKIPPED+=${#SKILLS[@]}))
-            continue
-        fi
-    else
-        echo "Directory exists: $skills_dir"
-    fi
-
-    echo ""
-
-    # Install each skill
-    for skill in "${SKILLS[@]}"; do
-        source_file="$SKILLS_SOURCE/$skill/SKILL.md"
-        target_file="$skills_dir/$skill.md"
-
-        # Remove existing file or symlink
-        if [ -e "$target_file" ] || [ -L "$target_file" ]; then
-            rm "$target_file"
-        fi
-
-        if [ "$METHOD" == "symlink" ]; then
-            if ln -s "$source_file" "$target_file" 2>/dev/null; then
-                echo -e "${GREEN}✓${NC} Symlinked: $skill.md"
-                ((TOTAL_INSTALLED++))
-            else
-                echo -e "${RED}✗${NC} Failed to symlink: $skill.md"
-                ((TOTAL_FAILED++))
-            fi
-        else
-            if cp "$source_file" "$target_file" 2>/dev/null; then
-                echo -e "${GREEN}✓${NC} Copied: $skill.md"
-                ((TOTAL_INSTALLED++))
-            else
-                echo -e "${RED}✗${NC} Failed to copy: $skill.md"
-                ((TOTAL_FAILED++))
-            fi
-        fi
-    done
-
-    # Make skills executable (if they have execute permissions)
-    chmod +x "$skills_dir"/*.md 2>/dev/null || true
-
-    echo ""
-done
-
-# Installation Summary
-echo "=========================================="
-echo "Installation Summary"
-echo "=========================================="
-echo ""
-echo -e "Tools configured: ${BLUE}${#DETECTED_TOOLS[@]}${NC}"
-echo -e "Skills installed: ${GREEN}$TOTAL_INSTALLED${NC}"
-if [ "$TOTAL_FAILED" -gt 0 ]; then
-    echo -e "Failed: ${RED}$TOTAL_FAILED${NC}"
-fi
-if [ "$TOTAL_SKIPPED" -gt 0 ]; then
-    echo -e "Skipped: ${YELLOW}$TOTAL_SKIPPED${NC}"
-fi
-echo "Installation method: $METHOD"
-echo ""
-
-# List installation locations
-echo "Skills installed to:"
-for tool_id in "${DETECTED_TOOLS[@]}"; do
-    tool_name=$(get_tool_name "$tool_id")
-    tool_dir=$(get_tool_dir "$tool_id")
-    if [ -d "$tool_dir" ] && [ "$(ls -A "$tool_dir"/*.md 2>/dev/null | wc -l | tr -d ' ')" -gt 0 ]; then
-        count=$(ls -1 "$tool_dir"/*.md 2>/dev/null | wc -l | tr -d ' ')
-        echo -e "  ${GREEN}✓${NC} $tool_name: $tool_dir ($count skills)"
-    fi
-done
-
-echo ""
-
-# Verify installation
-EXPECTED_TOTAL=$((${#DETECTED_TOOLS[@]} * ${#SKILLS[@]}))
-if [ "$TOTAL_INSTALLED" -eq "$EXPECTED_TOTAL" ]; then
-    echo -e "${GREEN}✓${NC} All skills installed successfully!"
-else
-    echo -e "${YELLOW}⚠${NC} Some skills failed to install."
-    echo "Expected: $EXPECTED_TOTAL, Installed: $TOTAL_INSTALLED"
-fi
-
-echo ""
-
-# List available skills
-echo "=========================================="
-echo "Available Skills"
-echo "=========================================="
-echo ""
-for skill in "${SKILLS[@]}"; do
-    echo "  • $skill"
-done
-echo ""
-
-# Legacy Claude CLI skills (from claude-skills/)
-if [ -d "$REPO_DIR/claude-skills" ] && [ -d "$HOME/.claude/skills" ]; then
-    echo "=========================================="
-    echo "Legacy Claude CLI Skills"
-    echo "=========================================="
-    echo ""
-    echo "Found legacy claude-skills/ directory for Claude CLI."
-    echo "These are different from the universal skills above."
-    echo ""
-    if [ "$AUTO_MODE" = true ]; then
-        REPLY="y"
-    else
-        read -p "Do you want to install legacy Claude CLI skills too? (y/n) " -n 1 -r
-        echo ""
-        echo ""
-    fi
-
-    if [[ $REPLY =~ ^[Yy]$ ]]; then
-        LEGACY_COUNT=0
-        for skill_file in "$REPO_DIR/claude-skills"/superlocalmemoryv2-*.md; do
-            if [ -f "$skill_file" ]; then
-                skill_name=$(basename "$skill_file")
-                target="$HOME/.claude/skills/$skill_name"
-
-                if [ -e "$target" ] || [ -L "$target" ]; then
-                    rm "$target"
-                fi
-
-                if [ "$METHOD" == "symlink" ]; then
-                    ln -s "$skill_file" "$target" 2>/dev/null && ((LEGACY_COUNT++))
-                else
-                    cp "$skill_file" "$target" 2>/dev/null && ((LEGACY_COUNT++))
-                fi
-            fi
-        done
-        echo -e "${GREEN}✓${NC} Installed $LEGACY_COUNT legacy Claude CLI skills"
-        echo ""
-    fi
-fi
-
-# Next Steps
-echo "=========================================="
-echo "Next Steps"
-echo "=========================================="
-echo ""
-echo "1. ${YELLOW}Restart your AI tool${NC} to load the new skills"
-echo ""
-echo "2. Verify skills are loaded:"
-for tool_id in "${DETECTED_TOOLS[@]}"; do
-    case "$tool_id" in
-        "claude_code")
-            echo "   ${GREEN}claude${NC} (type /skills to list)"
-            ;;
-        "codex")
-            echo "   ${GREEN}codex${NC} (type /skills to list)"
-            ;;
-        "gemini_cli")
-            echo "   ${GREEN}gemini${NC} (check available commands)"
-            ;;
-        "antigravity")
-            echo "   ${GREEN}antigravity${NC} (check available commands)"
-            ;;
-        "windsurf")
-            echo "   ${GREEN}windsurf${NC} (check available commands)"
-            ;;
-        "cursor")
-            echo "   ${GREEN}cursor${NC} (check available commands)"
-            ;;
-        "vscode_copilot")
-            echo "   ${GREEN}VS Code/Copilot${NC} (check available commands)"
-            ;;
-    esac
-done
-echo ""
-echo "3. Try your first skill:"
-echo "   ${GREEN}/slm-status${NC} or ${GREEN}/slm-remember \"test\"${NC}"
-echo ""
-echo "4. Read skill documentation:"
-echo "   Each skill has detailed docs in: $SKILLS_SOURCE/<skill-name>/SKILL.md"
-echo ""
-
-if [ "$METHOD" == "symlink" ]; then
-    echo "Note: Using symlinks. To update skills:"
-    echo "  cd $REPO_DIR"
-    echo "  git pull"
-    echo "  # Restart your AI tool"
-    echo ""
-fi
-
-if [ "$METHOD" == "copy" ]; then
-    echo "Note: Using copies. To update skills:"
-    echo "  cd $REPO_DIR"
-    echo "  git pull"
-    echo "  ./install-skills.sh"
-    echo "  # Choose option 2 again"
-    echo ""
-fi
-
-echo "=========================================="
-echo ""
-echo -e "${GREEN}✓ Universal skills installation complete!${NC}"
-echo ""
-echo "Skills installed for:"
-for tool_id in "${DETECTED_TOOLS[@]}"; do
-    tool_name=$(get_tool_name "$tool_id")
-    echo "  • $tool_name"
-done
-echo ""
-echo "Remember: Skills are OPTIONAL convenience wrappers."
-echo "SuperLocalMemory V2 works standalone via terminal commands."
-echo ""
+# DEPRECATED in v3.6.14 — skills are now delivered via the Claude Code plugin.
+# Use: claude plugin install superlocalmemory@qualixar
+echo "SLM skills are now delivered via the Claude Code plugin (/plugin install) — standalone skill install is retired in v3.6.14."
+exit 0

package/scripts/postinstall-interactive.js

@@ -689,33 +689,6 @@ async function main() {
     return 4;
   }
 
-  // S9-DASH-11: auto-install SLM skills into ~/.claude/skills/ so
-  // /slm-recall, /slm-remember, /slm-status etc. appear immediately
-  // in Claude Code without a manual step.
-  try {
-    const skillsSrc = path.join(__dirname, '..', 'skills');
-    const claudeSkillsDir = path.join(os.homedir(), '.claude', 'skills');
-    if (fs.existsSync(skillsSrc)) {
-      fs.mkdirSync(claudeSkillsDir, { recursive: true, mode: 0o700 });
-      const skillDirs = fs.readdirSync(skillsSrc);
-      let installed = 0;
-      for (const d of skillDirs) {
-        const src = path.join(skillsSrc, d, 'SKILL.md');
-        if (fs.existsSync(src)) {
-          const dst = path.join(claudeSkillsDir, d + '.md');
-          fs.copyFileSync(src, dst);
-          installed += 1;
-        }
-      }
-      if (installed > 0) {
-        console.log('SLM: installed ' + installed + ' skills → ' + claudeSkillsDir);
-        console.log('     Use /slm-recall, /slm-remember, /slm-status in Claude Code');
-      }
-    }
-  } catch (e) {
-    // Non-fatal — skills can be installed manually via install-skills.sh
-    console.log('SLM: skill install skipped (' + e.message + ')');
-  }
 
   // UX-G2: show the one-screen delta banner so upgraders see what shipped.
   printLivingBrainDelta();

package/scripts/postinstall.js

@@ -131,12 +131,31 @@ if (pipInstallPkg.status === 0) {
         if (retryResult.status === 0) {
             console.log('✓ SuperLocalMemory Python package installed (--user)');
         } else {
-            console.log('⚠ Could not pip install the package. The Node.js wrapper (slm-npm)');
-            console.log('  sets PYTHONPATH automatically, so CLI will still work.');
+            // WP-07: --user also failed — try --break-system-packages last-resort,
+            // then surface the pipx hint (PEP 668 advisory).
+            const retryBsp = spawnSync(pythonParts[0], [
+                ...pythonParts.slice(1), '-m', 'pip', 'install', '--quiet',
+                '--disable-pip-version-check', '--break-system-packages', pkgRoot,
+            ], { stdio: 'pipe', timeout: 300000, env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:' + (process.env.PATH || '') } });
+            if (retryBsp.status === 0) {
+                console.log('✓ SuperLocalMemory Python package installed (--break-system-packages)');
+            } else {
+                console.log('⚠ pip install failed (PEP 668 — externally managed Python).');
+                console.log('  The Node.js wrapper (slm-npm) sets PYTHONPATH automatically,');
+                console.log('  so the CLI will still work via npm.');
+                console.log('');
+                console.log('  To install into an isolated environment (recommended):');
+                console.log('    pipx install superlocalmemory');
+                console.log('  Last resort (may break OS packages):');
+                console.log('    pip install --break-system-packages superlocalmemory');
+            }
         }
     } else {
         console.log('⚠ Could not pip install the package. The Node.js wrapper (slm-npm)');
         console.log('  sets PYTHONPATH automatically, so CLI will still work.');
+        console.log('');
+        console.log('  If you see a PEP 668 error in future, install via:');
+        console.log('    pipx install superlocalmemory');
     }
 }
 

package/src/superlocalmemory/__init__.py

@@ -32,7 +32,7 @@ if "OMP_NUM_THREADS" not in os.environ:
     os.environ["OMP_NUM_THREADS"] = "2"
 # ---------------------------------------------------------------------------
 
-__version__ = "3.6.10"
+__version__ = "3.6.14"
 
 _REQUIRED_VERSIONS = {
     "sentence_transformers": "5.3.0",

package/src/superlocalmemory/cli/_lazy_init.py

@@ -0,0 +1,115 @@
+# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+# Licensed under AGPL-3.0-or-later - see LICENSE file
+# Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
+
+"""WP-07 — Lazy first-run initialisation (pip cross-install).
+
+stdlib-only — zero heavy imports, STDOUT-SILENT.
+
+Public API
+----------
+slm_home() -> Path
+    Resolve the SLM data directory from env aliases, falling back to
+    ~/.superlocalmemory.  Pure: no mkdir, no I/O beyond os.environ reads.
+    Priority: SLM_DATA_DIR -> SL_MEMORY_PATH -> SLM_HOME -> default.
+
+_ensure_initialized() -> None
+    Idempotent first-run guard: creates the home dir + a minimal mode-A
+    config.json if absent.  Fast-path returns immediately when both dir
+    and config exist.  Never raises, never prints to stdout.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+
+
+# ---------------------------------------------------------------------------
+# Public: home resolution
+# ---------------------------------------------------------------------------
+
+
+def slm_home() -> Path:
+    """Resolve the SLM data directory.
+
+    Resolution order (first non-empty wins):
+      1. SLM_DATA_DIR  — canonical env var
+      2. SL_MEMORY_PATH — legacy alias (setup_wizard.py)
+      3. SLM_HOME      — hook alias (hooks/_outcome_common.py)
+      4. ~/.superlocalmemory — hard default
+
+    Pure: no mkdir, no side effects.
+    """
+    for var in ("SLM_DATA_DIR", "SL_MEMORY_PATH", "SLM_HOME"):
+        val = os.environ.get(var, "").strip()
+        if val:
+            return Path(val)
+    return Path.home() / ".superlocalmemory"
+
+
+# ---------------------------------------------------------------------------
+# Public: idempotent first-run init
+# ---------------------------------------------------------------------------
+
+# Minimal mode-A config written on first-run pip install.
+# Only mode + base_dir; everything else uses SLMConfig defaults.
+_MINIMAL_CONFIG: dict = {
+    "mode": "a",
+    "version": "3.6.14",
+}
+
+
+def _ensure_initialized() -> None:
+    """Idempotent first-run guard.
+
+    Creates ~/.superlocalmemory/ (or env-overridden path) and a minimal
+    mode-A config.json if they are absent.
+
+    Contract:
+    - NEVER raises (OSError → silent degrade, AC4).
+    - NEVER prints to stdout (CRIT-3).
+    - NEVER overwrites an existing config.json (AC3).
+    - 2nd call is a no-op — mtime of config unchanged (AC2).
+    - Does NOT write the .setup-complete sentinel.
+    """
+    try:
+        home = slm_home()
+        config = home / "config.json"
+
+        # Fast path: both dir and config exist — nothing to do (AC2).
+        if home.is_dir() and config.exists():
+            return
+
+        # Ensure the directory exists.
+        home.mkdir(parents=True, exist_ok=True)
+
+        # Write config only when absent (AC3 + AC2).
+        if not config.exists():
+            _write_minimal_config(home, config)
+
+    except OSError:
+        # Read-only home or any I/O failure → degrade silently (AC4).
+        return
+
+
+def _write_minimal_config(home: Path, config: Path) -> None:
+    """Atomically write a minimal mode-A config.json inside *home*.
+
+    Uses a .tmp file inside the same directory so os.replace() is always
+    on the same filesystem (no cross-FS rename).  Never writes to /tmp.
+    """
+    # PID-namespaced tmp so two `slm` processes first-running concurrently don't
+    # clobber each other's tmp (which would make one os.replace fail mid-race).
+    tmp_path = home / f".config.json.tmp.{os.getpid()}"
+    try:
+        payload = json.dumps(_MINIMAL_CONFIG, indent=2)
+        tmp_path.write_text(payload, encoding="utf-8")
+        os.replace(str(tmp_path), str(config))
+    except OSError:
+        # Clean up tmp on failure; ignore errors — degrade silently.
+        try:
+            tmp_path.unlink(missing_ok=True)
+        except OSError:
+            pass