superlocalmemory 3.6.13 → 3.6.14

package/skills/slm-switch-profile/SKILL.md

@@ -1,442 +0,0 @@
----
-name: slm-switch-profile
-description: Switch between memory profiles for context isolation and management. Use when the user wants to change profile context, separate work/personal memories, or manage multiple independent memory spaces. Each profile has its own database, graph, and patterns.
-version: "3.4.23"
-license: AGPL-3.0-or-later
-compatibility: "Requires SuperLocalMemory V2 installed at ~/.claude-memory/"
-attribution:
-  creator: Varun Pratap Bhardwaj
-  role: Solution Architect & Original Creator
-  project: SuperLocalMemory V2
----
-
-# SuperLocalMemory: Switch Profile
-
-Switch between memory profiles to maintain separate contexts for different projects or use cases.
-
-## Usage
-
-```bash
-slm switch-profile <name> [--create]
-```
-
-## What are Profiles?
-
-**Profiles = Isolated Memory Spaces**
-
-Each profile has its own:
-- ✅ **Separate database** - Zero context bleeding
-- ✅ **Independent knowledge graph** - Profile-specific relationships
-- ✅ **Unique patterns** - Different coding preferences per profile
-- ✅ **Isolated history** - No cross-contamination
-
-**Think of profiles as workspaces:**
-- `default` - General use
-- `work` - Work projects
-- `personal` - Personal projects
-- `client-acme` - Specific client work
-- `experiment` - Testing/learning
-
-## Examples
-
-### Example 1: Switch to Existing Profile
-```bash
-$ slm switch-profile work
-```
-
-**Output:**
-```
-🔄 Switching profile: default → work
-
-Profile Information:
-  Name: work
-  Created: 2026-01-20
-  Memories: 342
-  Last Used: 2026-02-05 09:15
-
-✅ Switched to profile "work"
-
-Restart your AI tools (Cursor, ChatGPT, etc.) to use the new profile.
-```
-
-### Example 2: Create New Profile
-```bash
-$ slm switch-profile client-acme --create
-```
-
-**Output:**
-```
-🆕 Creating new profile: client-acme
-
-Profile created successfully!
-  Location: ~/.claude-memory/profiles/client-acme/
-  Database: memory.db (empty)
-  Status: Active
-
-✅ Switched to profile "client-acme"
-
-Next steps:
-  • Start saving memories: slm remember "..."
-  • AI tools will use this profile automatically
-```
-
-### Example 3: List All Profiles
-```bash
-$ slm list-profiles
-```
-
-**Output:**
-```
-📁 Available Profiles (4 total)
-
-→ work (active)
-  Created: 2026-01-20
-  Memories: 342
-  Size: 1.8 MB
-  Last used: 2 minutes ago
-
-  default
-  Created: 2026-01-15
-  Memories: 1,247
-  Size: 4.2 MB
-  Last used: 3 hours ago
-
-  personal
-  Created: 2026-01-22
-  Memories: 89
-  Size: 0.4 MB
-  Last used: Yesterday
-
-  client-acme
-  Created: 2026-02-07
-  Memories: 0
-  Size: 0 KB
-  Last used: Never
-```
-
-### Example 4: Return to Default
-```bash
-$ slm switch-profile default
-```
-
-**Always works** (default profile always exists)
-
-## Arguments
-
-| Argument | Type | Required | Description |
-|----------|------|----------|-------------|
-| `<name>` | string | Yes | Profile name (lowercase, hyphens allowed) |
-| `--create` | flag | No | Create profile if doesn't exist |
-| `--force` | flag | No | Switch even if current profile has unsaved work |
-
-## Profile Naming Rules
-
-**Valid:**
-- Lowercase letters: `a-z`
-- Numbers: `0-9`
-- Hyphens: `-`
-- Length: 1-64 characters
-
-**Examples:**
-- ✅ `work`
-- ✅ `client-acme`
-- ✅ `project-2024`
-- ✅ `personal`
-
-**Invalid:**
-- ❌ `Work` (uppercase)
-- ❌ `client_acme` (underscore)
-- ❌ `client acme` (space)
-- ❌ `client.acme` (period)
-
-## Use Cases
-
-### 1. Work/Personal Separation
-```bash
-# Morning: Start work
-slm switch-profile work
-slm remember "Sprint planning: focus on auth system"
-
-# Evening: Personal projects
-slm switch-profile personal
-slm remember "Learning Rust - ownership is tricky"
-```
-
-**Benefit:** No mixing of work and personal context
-
-### 2. Multi-Client Consulting
-```bash
-# Client A project
-slm switch-profile client-a
-slm remember "Client A uses AWS, prefers TypeScript"
-
-# Client B project
-slm switch-profile client-b
-slm remember "Client B uses Azure, prefers C#"
-```
-
-**Benefit:** Client-specific preferences and patterns
-
-### 3. Experimentation
-```bash
-# Create throwaway profile for learning
-slm switch-profile experiment --create
-slm remember "Testing new framework..."
-
-# Later: delete when done
-slm delete-profile experiment
-```
-
-**Benefit:** Safe experimentation without polluting main memory
-
-### 4. Project Isolation
-```bash
-# Different tech stacks
-slm switch-profile backend-api  # Python/FastAPI
-slm switch-profile frontend-app  # React/TypeScript
-slm switch-profile ml-pipeline   # Python/PyTorch
-```
-
-**Benefit:** Pattern learning adapts to each stack
-
-### 5. Team Shared Profiles (Advanced)
-```bash
-# Sync profile to team folder
-slm export-profile work > team-shared/work-profile.db
-
-# Team members import
-slm import-profile team-shared/work-profile.db --name work
-```
-
-**Benefit:** Shared knowledge base for team
-
-## How Switching Works
-
-### Behind the Scenes
-
-**1. Profile Structure:**
-```
-~/.claude-memory/
-├── memory.db               ← Current active profile (symlink)
-├── profiles/
-│   ├── default/
-│   │   └── memory.db       ← Default profile database
-│   ├── work/
-│   │   └── memory.db       ← Work profile database
-│   └── personal/
-│       └── memory.db       ← Personal profile database
-└── current_profile         ← Text file with active profile name
-```
-
-**2. Switching Process:**
-```bash
-$ slm switch-profile work
-```
-
-- **Step 1:** Verify "work" profile exists
-- **Step 2:** Update symlink: `memory.db` → `profiles/work/memory.db`
-- **Step 3:** Write "work" to `current_profile` file
-- **Step 4:** Notify user to restart AI tools
-
-**3. AI Tools Read:**
-- MCP server reads `~/.claude-memory/memory.db`
-- Symlink automatically points to active profile
-- Transparent to AI tools
-
-## Important Notes
-
-### Restart Required
-**After switching, restart your AI tools:**
-- **Cursor:** Cmd+Q, reopen
-- **Claude Desktop:** Quit, reopen
-- **ChatGPT:** Close, reopen
-- **VS Code:** Reload window
-
-**Why:** Tools cache database connection at startup
-
-### Profile Isolation is Complete
-**Each profile has:**
-- ❌ **NO access** to other profiles' memories
-- ❌ **NO shared** knowledge graph
-- ❌ **NO cross-profile** pattern learning
-
-**This is by design** for true isolation.
-
-### Default Profile Special
-- Always exists
-- Cannot be deleted
-- Safe fallback
-
-## Advanced Usage
-
-### Profile Management
-
-**Create multiple profiles:**
-```bash
-slm switch-profile work --create
-slm switch-profile personal --create
-slm switch-profile client-a --create
-```
-
-**Backup profile:**
-```bash
-cp -r ~/.claude-memory/profiles/work ~/.claude-memory/backups/work-2026-02-07
-```
-
-**Delete profile:**
-```bash
-slm delete-profile experiment
-# Warning: This permanently deletes all memories!
-```
-
-**Rename profile:**
-```bash
-slm rename-profile old-name new-name
-```
-
-### Scripting & Automation
-
-**Auto-switch by project directory:**
-```bash
-# Add to .bashrc or .zshrc
-function cd() {
-  builtin cd "$@"
-
-  # Check for .slm-profile file
-  if [ -f ".slm-profile" ]; then
-    profile=$(cat .slm-profile)
-    slm switch-profile "$profile" --quiet
-  fi
-}
-```
-
-**Usage:**
-```bash
-# In project directory
-echo "myapp" > .slm-profile
-
-# CD into directory
-cd ~/projects/myapp
-# Automatically switches to "myapp" profile
-```
-
-**Daily profile switching:**
-```bash
-#!/bin/bash
-# cron: 0 9 * * 1-5 (Mon-Fri at 9 AM)
-
-slm switch-profile work
-echo "Switched to work profile" | notify-send "SuperLocalMemory"
-```
-
-### Profile Statistics
-
-**Compare profiles:**
-```bash
-slm list-profiles --stats
-```
-
-**Output:**
-```
-Profile          Memories  Size     Nodes  Edges  Patterns
-default          1,247     4.2 MB   892    2,134  34
-work             342       1.8 MB   256    789    12
-personal         89        0.4 MB   67     145    4
-```
-
-**Export profile summary:**
-```bash
-slm profile-summary work > work-summary.txt
-```
-
-## Troubleshooting
-
-### "Profile not found"
-
-**Cause:** Typo or profile doesn't exist
-
-**Solution:**
-```bash
-# List existing profiles
-slm list-profiles
-
-# Create if needed
-slm switch-profile myprofile --create
-```
-
-### "Switch failed: Database locked"
-
-**Cause:** AI tool still using old profile
-
-**Solution:**
-```bash
-# Kill all MCP servers
-killall python3
-
-# Try again
-slm switch-profile work
-
-# Restart AI tools
-```
-
-### "Memories disappeared after switching"
-
-**Cause:** Switched to empty/different profile (working as intended)
-
-**Solution:**
-```bash
-# Check current profile
-slm status | grep "Current Profile"
-
-# Switch back to profile with memories
-slm switch-profile default
-
-# Or list all profiles to find the right one
-slm list-profiles
-```
-
-### "AI tools still see old profile"
-
-**Cause:** Didn't restart tools
-
-**Solution:**
-```bash
-# Must completely restart (not just reload)
-# macOS: Cmd+Q, then reopen
-# Windows/Linux: Close all windows, reopen
-```
-
-## Performance
-
-| Operation | Time | Notes |
-|-----------|------|-------|
-| Switch profile | ~100ms | Instant |
-| Create profile | ~200ms | Fast |
-| List profiles | ~50ms | Very fast |
-
-**Switching is fast** because it's just updating a symlink.
-
-## Notes
-
-- **No data loss:** Switching never deletes memories
-- **Profile persistence:** Memories stay in original profile
-- **Tool transparency:** AI tools don't need special config per profile
-- **Backup-friendly:** Each profile is separate directory
-
-## Related Commands
-
-- `slm list-profiles` - Show all profiles
-- `slm delete-profile <name>` - Delete a profile
-- `slm rename-profile <old> <new>` - Rename profile
-- `slm status` - Shows current profile
-- `slm export-profile <name>` - Export to file
-- `slm import-profile <file>` - Import from file
-
----
-
-**Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
-**Project:** SuperLocalMemory V2
-**License:** MIT (see [LICENSE](../../LICENSE))
-**Repository:** https://github.com/varun369/SuperLocalMemoryV2
-
-*Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/src/superlocalmemory/cli/doctor_cmd.py

@@ -1,152 +0,0 @@
-# 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
-
-"""slm doctor — preflight and health checks.
-
-Part of Qualixar | Author: Varun Pratap Bhardwaj
-"""
-
-from __future__ import annotations
-
-import json
-import platform
-import sys
-from pathlib import Path
-from typing import Any
-
-_DEFAULT_DATA_DIR = Path.home() / ".superlocalmemory"
-
-
-def _check_python() -> dict[str, Any]:
-    v = sys.version_info
-    ok = (v.major, v.minor) >= (3, 10)
-    return {
-        "name": "python",
-        "status": "ok" if ok else "error",
-        "detail": f"Python {v.major}.{v.minor}.{v.micro}",
-        "hint": None if ok else "SLM requires Python >= 3.10",
-    }
-
-
-def _check_platform() -> dict[str, Any]:
-    return {
-        "name": "platform",
-        "status": "ok",
-        "detail": f"{platform.system()} {platform.release()} {platform.machine()}",
-        "hint": None,
-    }
-
-
-def _check_portalocker() -> dict[str, Any]:
-    try:
-        import portalocker  # noqa: F401
-        return {
-            "name": "portalocker",
-            "status": "ok",
-            "detail": "installed",
-            "hint": None,
-        }
-    except ImportError:
-        return {
-            "name": "portalocker",
-            "status": "error",
-            "detail": "not installed",
-            "hint": "pip install --upgrade superlocalmemory",
-        }
-
-
-def _check_data_dir(data_dir: Path) -> dict[str, Any]:
-    from superlocalmemory.core import safe_fs
-    try:
-        safe_fs.validate_data_dir(data_dir)
-        return {
-            "name": "data directory",
-            "status": "ok",
-            "detail": str(data_dir),
-            "hint": None,
-        }
-    except safe_fs.SafeFsError as exc:
-        return {
-            "name": "data directory",
-            "status": "error",
-            "detail": str(data_dir),
-            "hint": str(exc),
-        }
-
-
-def _check_migration(data_dir: Path) -> dict[str, Any]:
-    from superlocalmemory.migrations.v3_4_25_to_v3_4_26 import is_ready
-    ok = is_ready(data_dir)
-    return {
-        "name": "v3.4.26 migration",
-        "status": "ok" if ok else "warn",
-        "detail": "ready" if ok else "not migrated yet",
-        "hint": None if ok else
-        "Run once: python -m superlocalmemory.migrations.v3_4_25_to_v3_4_26",
-    }
-
-
-def _check_queue_db(data_dir: Path) -> dict[str, Any]:
-    queue = data_dir / "recall_queue.db"
-    if queue.exists():
-        return {
-            "name": "queue database",
-            "status": "ok",
-            "detail": f"{queue} ({queue.stat().st_size} bytes)",
-            "hint": None,
-        }
-    return {
-        "name": "queue database",
-        "status": "warn",
-        "detail": "not yet created",
-        "hint": "The daemon will create this on first use.",
-    }
-
-
-def run_checks(*, data_dir: Path | None = None) -> dict[str, Any]:
-    dd = Path(data_dir) if data_dir is not None else _DEFAULT_DATA_DIR
-    checks = [
-        _check_python(),
-        _check_platform(),
-        _check_portalocker(),
-        _check_data_dir(dd),
-        _check_migration(dd),
-        _check_queue_db(dd),
-    ]
-    has_error = any(c["status"] == "error" for c in checks)
-    exit_code = 1 if has_error else 0
-    return {
-        "data_dir": str(dd),
-        "checks": checks,
-        "exit_code": exit_code,
-    }
-
-
-def _print_report(report: dict[str, Any]) -> None:
-    glyphs = {"ok": "\u2713", "warn": "\u26a0", "error": "\u2717"}
-    print(f"SLM doctor — data dir: {report['data_dir']}\n")
-    for c in report["checks"]:
-        g = glyphs.get(c["status"], "?")
-        print(f" {g} {c['name']:<20} {c['detail']}")
-        if c.get("hint"):
-            print(f"      {c['hint']}")
-    print(f"\nExit code: {report['exit_code']}")
-
-
-def main(argv: list[str] | None = None) -> int:
-    import argparse
-    parser = argparse.ArgumentParser(prog="slm-doctor")
-    parser.add_argument("--json", action="store_true", help="JSON output")
-    parser.add_argument("--data-dir", type=Path, default=None)
-    args = parser.parse_args(argv)
-    report = run_checks(data_dir=args.data_dir)
-    if args.json:
-        print(json.dumps(report, indent=2))
-    else:
-        _print_report(report)
-    return int(report["exit_code"])
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())