@strvmarv/total-recall 0.1.0 → 0.2.0

package/.claude-plugin/plugin.json

@@ -1,18 +1,19 @@
 {
   "name": "total-recall",
   "description": "Multi-tiered memory and knowledge base with semantic search, auto-compaction, and built-in evaluation. Works across Claude Code, Copilot CLI, OpenCode, Cline, and Cursor.",
-  "version": "0.1.0",
+  "version": "0.1.5",
   "author": {
     "name": "strvmarv"
   },
-  "skills": "./skills/",
-  "agents": "./agents/",
-  "hooks": "./hooks/hooks.json",
-  "mcpServers": {
-    "total-recall": {
-      "command": "node",
-      "args": ["dist/index.js"],
-      "env": {}
-    }
-  }
+  "homepage": "https://github.com/strvmarv/total-recall",
+  "repository": "https://github.com/strvmarv/total-recall",
+  "license": "MIT",
+  "keywords": [
+    "memory",
+    "knowledge-base",
+    "mcp",
+    "vector-search",
+    "sqlite",
+    "embeddings"
+  ]
 }

package/.copilot-plugin/plugin.json

@@ -5,8 +5,8 @@
   "skills": "./skills/",
   "mcpServers": {
     "total-recall": {
-      "command": "node",
-      "args": ["dist/index.js"]
+      "command": "npx",
+      "args": ["-y", "@strvmarv/total-recall"]
     }
   }
 }

package/.cursor-plugin/plugin.json

@@ -6,8 +6,8 @@
   "hooks": "./hooks/hooks-cursor.json",
   "mcpServers": {
     "total-recall": {
-      "command": "node",
-      "args": ["dist/index.js"]
+      "command": "npx",
+      "args": ["-y", "@strvmarv/total-recall"]
     }
   }
 }

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "total-recall": {
+      "command": "bash",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/bin/total-recall.sh"]
+    }
+  }
+}

package/README.md

@@ -119,27 +119,24 @@ All state lives in `~/.total-recall/db.sqlite`. The embedding model is cached at
 
 ## Commands
 
-| Command | Description |
-|---|---|
-| `/memory status` | Dashboard overview |
-| `/memory search <query>` | Semantic search across all tiers |
-| `/memory ingest <path>` | Add files/dirs to knowledge base |
-| `/memory forget <query>` | Find and delete entries |
-| `/memory compact` | Force compaction with preview |
-| `/memory inspect <id>` | Deep dive on single entry |
-| `/memory promote <id>` | Move entry to higher tier |
-| `/memory demote <id>` | Move entry to lower tier |
-| `/memory export` | Export to portable format |
-| `/memory import <file>` | Import from export file |
-| `/memory eval` | Live performance metrics |
-| `/memory eval --benchmark` | Run synthetic benchmark |
-| `/memory eval --compare <name>` | Compare configs |
-| `/memory eval --snapshot <name>` | Save current config baseline |
-| `/memory eval --grow` | Add real misses to benchmark |
-| `/memory config get <key>` | Read config value |
-| `/memory config set <key> <value>` | Update config |
-| `/memory history` | Show recent tier movements |
-| `/memory lineage <id>` | Show compaction ancestry |
+| Command | MCP Tool | Description |
+|---|---|---|
+| `/memory status` | `status` | Dashboard overview |
+| `/memory search <query>` | `memory_search` | Semantic search across all tiers |
+| `/memory ingest <path>` | `kb_ingest_file` / `kb_ingest_dir` | Add files/dirs to knowledge base |
+| `/memory forget <query>` | `memory_search` + `memory_delete` | Find and delete entries |
+| `/memory compact` | `compact_now` | Force compaction with preview |
+| `/memory inspect <id>` | `memory_inspect` | Deep dive on single entry |
+| `/memory promote <id>` | `memory_promote` | Move entry to higher tier |
+| `/memory demote <id>` | `memory_demote` | Move entry to lower tier |
+| `/memory export` | `memory_export` | Export to portable JSON format |
+| `/memory import <file>` | `memory_import` | Import from export file |
+| `/memory eval` | `eval_report` | Live performance metrics |
+| `/memory eval --benchmark` | `eval_benchmark` | Run synthetic benchmark |
+| `/memory config get <key>` | `config_get` | Read config value |
+| `/memory config set <key> <value>` | `config_set` | Update config |
+| `/memory history` | `memory_history` | Show recent tier movements |
+| `/memory lineage <id>` | `memory_lineage` | Show compaction ancestry |
 
 ---
 

package/bin/total-recall.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# total-recall MCP server launcher
+# Finds node in common locations even when not in PATH
+
+find_node() {
+  # Check PATH first
+  if command -v node &>/dev/null; then
+    echo "node"
+    return 0
+  fi
+
+  # Check nvm
+  if [ -d "$HOME/.nvm/versions/node" ]; then
+    local latest=$(ls -1d "$HOME/.nvm/versions/node"/v* 2>/dev/null | sort -V | tail -1)
+    if [ -n "$latest" ] && [ -x "$latest/bin/node" ]; then
+      echo "$latest/bin/node"
+      return 0
+    fi
+  fi
+
+  # Check fnm
+  if [ -d "$HOME/.local/share/fnm/node-versions" ]; then
+    local latest=$(ls -1d "$HOME/.local/share/fnm/node-versions"/v*/installation 2>/dev/null | sort -V | tail -1)
+    if [ -n "$latest" ] && [ -x "$latest/bin/node" ]; then
+      echo "$latest/bin/node"
+      return 0
+    fi
+  fi
+
+  # Check Homebrew
+  if [ -x "/home/linuxbrew/.linuxbrew/bin/node" ]; then
+    echo "/home/linuxbrew/.linuxbrew/bin/node"
+    return 0
+  fi
+  if [ -x "/opt/homebrew/bin/node" ]; then
+    echo "/opt/homebrew/bin/node"
+    return 0
+  fi
+  if [ -x "/usr/local/bin/node" ]; then
+    echo "/usr/local/bin/node"
+    return 0
+  fi
+
+  # Check Volta
+  if [ -x "$HOME/.volta/bin/node" ]; then
+    echo "$HOME/.volta/bin/node"
+    return 0
+  fi
+
+  echo ""
+  return 1
+}
+
+NODE=$(find_node)
+if [ -z "$NODE" ]; then
+  echo "total-recall: error: node.js not found. Install Node.js 20+ via nvm, fnm, Volta, or your package manager." >&2
+  exit 1
+fi
+
+# Find the package entry point relative to this script
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PACKAGE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+ENTRY="$PACKAGE_DIR/dist/index.js"
+
+if [ ! -f "$ENTRY" ]; then
+  echo "total-recall: error: dist/index.js not found. Run 'npm run build' first." >&2
+  exit 1
+fi
+
+exec "$NODE" "$ENTRY" "$@"

package/dist/defaults.toml

@@ -0,0 +1,28 @@
+# total-recall default configuration
+# Copy to ~/.total-recall/config.toml to override
+
+[tiers.hot]
+max_entries = 50
+token_budget = 4000
+carry_forward_threshold = 0.7
+
+[tiers.warm]
+max_entries = 10000
+retrieval_top_k = 5
+similarity_threshold = 0.65
+cold_decay_days = 30
+
+[tiers.cold]
+chunk_max_tokens = 512
+chunk_overlap_tokens = 50
+lazy_summary_threshold = 5
+
+[compaction]
+decay_half_life_hours = 168
+warm_threshold = 0.3
+promote_threshold = 0.7
+warm_sweep_interval_days = 7
+
+[embedding]
+model = "all-MiniLM-L6-v2"
+dimensions = 384