@strvmarv/total-recall 0.1.5 → 0.2.1

package/.claude-plugin/plugin.json

@@ -1,17 +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.2.1",
   "author": {
     "name": "strvmarv"
   },
-  "skills": "./skills/",
-  "agents": "./agents/",
-  "hooks": "./hooks/hooks.json",
-  "mcpServers": {
-    "total-recall": {
-      "command": "npx",
-      "args": ["-y", "@strvmarv/total-recall"]
-    }
-  }
+  "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/.mcp.json

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

package/bin/total-recall.sh

@@ -0,0 +1,84 @@
+#!/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
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PACKAGE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+ENTRY="$PACKAGE_DIR/dist/index.js"
+
+# Strategy 1: Local dist/index.js (source install or npm install)
+if [ -f "$ENTRY" ]; then
+  exec "$NODE" "$ENTRY" "$@"
+fi
+
+# Strategy 2: Global install (npm install -g @strvmarv/total-recall)
+if command -v total-recall &>/dev/null; then
+  exec total-recall "$@"
+fi
+
+# Strategy 3: Find entry point in global node_modules
+NODE_DIR="$(dirname "$NODE")"
+GLOBAL_ENTRY=$("$NODE_DIR/npm" root -g 2>/dev/null)/@strvmarv/total-recall/dist/index.js
+if [ -f "$GLOBAL_ENTRY" ]; then
+  exec "$NODE" "$GLOBAL_ENTRY" "$@"
+fi
+
+echo "total-recall: error: could not find dist/index.js or total-recall binary." >&2
+echo "  Run 'npm run build' (git clone) or 'npm install -g @strvmarv/total-recall'." >&2
+exit 1

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

package/dist/index.js

@@ -228,9 +228,18 @@ import { writeFile } from "fs/promises";
 import { join as join3 } from "path";
 var HF_BASE_URL = "https://huggingface.co";
 var HF_REVISION = "main";
-function getModelPath(modelName) {
+function getBundledModelPath(modelName) {
+  const distDir = new URL(".", import.meta.url).pathname;
+  return join3(distDir, "..", "models", modelName);
+}
+function getUserModelPath(modelName) {
   return join3(getDataDir(), "models", modelName);
 }
+function getModelPath(modelName) {
+  const bundled = getBundledModelPath(modelName);
+  if (isModelDownloaded(bundled)) return bundled;
+  return getUserModelPath(modelName);
+}
 function isModelDownloaded(modelPath) {
   if (!existsSync3(modelPath)) return false;
   try {
@@ -253,12 +262,23 @@ async function validateDownload(modelPath) {
   }
 }
 async function downloadModel(modelName) {
-  const modelPath = getModelPath(modelName);
+  const modelPath = getUserModelPath(modelName);
   mkdirSync2(modelPath, { recursive: true });
-  const files = ["model.onnx", "tokenizer.json", "tokenizer_config.json"];
-  const repoUrl = `${HF_BASE_URL}/sentence-transformers/${modelName}/resolve/${HF_REVISION}/onnx`;
-  for (const file of files) {
-    const url = `${repoUrl}/${file}`;
+  const fileUrls = [
+    {
+      file: "model.onnx",
+      url: `${HF_BASE_URL}/sentence-transformers/${modelName}/resolve/${HF_REVISION}/onnx/model.onnx`
+    },
+    {
+      file: "tokenizer.json",
+      url: `${HF_BASE_URL}/sentence-transformers/${modelName}/resolve/${HF_REVISION}/tokenizer.json`
+    },
+    {
+      file: "tokenizer_config.json",
+      url: `${HF_BASE_URL}/sentence-transformers/${modelName}/resolve/${HF_REVISION}/tokenizer_config.json`
+    }
+  ];
+  for (const { file, url } of fileUrls) {
     const dest = join3(modelPath, file);
     const response = await fetch(url);
     if (!response.ok) {

package/models/all-MiniLM-L6-v2/model.onnx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6fd5d72fe4589f189f8ebc006442dbb529bb7ce38f8082112682524616046452
+size 90405214