@strvmarv/total-recall 0.6.8-beta.3 → 0.6.8-beta.5

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "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.6.8-beta.3",
+  "version": "0.6.8-beta.5",
   "author": {
     "name": "strvmarv"
   },

package/bin/start.cjs

@@ -1,37 +1,50 @@
 'use strict';
 // Bootstrap wrapper for the total-recall MCP server.
-// Runs as plain CJS (no imports) so it works even when node_modules is absent.
-// Detects missing/incomplete node_modules and self-heals via npm install,
-// then re-execs dist/index.js with inherited stdio as a transparent passthrough.
+//
+// Why this exists: .mcp.json launches us under `node` (guaranteed present
+// wherever Claude Code runs). Since 0.6.8 the server uses `bun:sqlite`, which
+// only resolves under the Bun runtime, so this script locates bun and
+// re-execs dist/index.js under it.
+//
+// Lookup order:
+//   1. Bundled bun at ~/.total-recall/bun/<BUN_VERSION>/bun[.exe]
+//      (downloaded by scripts/postinstall.js during `npm install`)
+//   2. System bun on PATH
+//   3. Hard fail — node cannot run dist/index.js (bun:sqlite import errors)
+//
+// Kept as plain CJS (no imports) so it works even when node_modules is absent.
 
 const { existsSync } = require('fs');
-const { join, dirname } = require('path');
+const { join } = require('path');
 const { spawnSync } = require('child_process');
+const os = require('os');
 
-const root = join(__dirname, '..');
-
-// Use better-sqlite3/lib as the canary — it only exists after a successful install.
-const canary = join(root, 'node_modules', 'better-sqlite3', 'lib');
+// Keep in sync with scripts/postinstall.js BUN_VERSION.
+const BUN_VERSION = '1.2.10';
 
-if (!existsSync(canary)) {
-  process.stderr.write('[total-recall] node_modules missing or incomplete — running npm install...\n');
+const root = join(__dirname, '..');
+const entry = join(root, 'dist', 'index.js');
 
-  const npm = findNpm();
-  const install = spawnSync(npm, ['install', '--production', '--prefer-offline'], {
-    cwd: root,
-    stdio: 'inherit',
-    shell: true, // required on Windows to execute .cmd files; harmless on macOS/Linux
-  });
+if (!existsSync(entry)) {
+  process.stderr.write(
+    '[total-recall] dist/index.js not found. Run `npm install` (marketplace) or `npm run build` (git checkout).\n'
+  );
+  process.exit(1);
+}
 
-  if (install.status !== 0) {
-    process.stderr.write('[total-recall] npm install failed — see output above for details\n');
-    process.exit(1);
-  }
+const bun = findBun();
+if (!bun) {
+  process.stderr.write(
+    '[total-recall] bun runtime not found.\n' +
+      `  Expected bundled bun at ~/.total-recall/bun/${BUN_VERSION}/bun (installed by \`npm install\`).\n` +
+      '  Fix: run `npm install` inside the plugin directory, or install bun manually (https://bun.sh/install).\n'
+  );
+  process.exit(1);
 }
 
-// Re-exec dist/index.js as a subprocess with inherited stdio.
-// spawnSync blocks until the server exits, transparently passing all I/O through.
-const server = spawnSync(process.execPath, [join(root, 'dist', 'index.js')], {
+// Re-exec dist/index.js under bun with inherited stdio so the MCP JSON-RPC
+// channel passes through transparently.
+const server = spawnSync(bun, [entry], {
   stdio: 'inherit',
   env: process.env,
 });
@@ -40,18 +53,20 @@ process.exit(server.status ?? 1);
 
 // ---------------------------------------------------------------------------
 
-function findNpm() {
-  const nodeDir = dirname(process.execPath);
+function findBun() {
+  const isWin = process.platform === 'win32';
+  const ext = isWin ? '.exe' : '';
 
-  // npm installs alongside node. On Windows it's npm.cmd; on macOS/Linux it's npm.
-  const candidates = process.platform === 'win32'
-    ? [join(nodeDir, 'npm.cmd'), join(nodeDir, 'npm')]
-    : [join(nodeDir, 'npm')];
+  // 1. Bundled bun (preferred — version-pinned, matches what postinstall downloaded)
+  const bundled = join(os.homedir(), '.total-recall', 'bun', BUN_VERSION, `bun${ext}`);
+  if (existsSync(bundled)) return bundled;
 
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) return candidate;
+  // 2. System bun on PATH — let the OS resolver find it
+  const probe = spawnSync(isWin ? 'where' : 'which', ['bun'], { encoding: 'utf8' });
+  if (probe.status === 0) {
+    const first = String(probe.stdout || '').split(/\r?\n/).find(Boolean);
+    if (first && existsSync(first)) return first;
   }
 
-  // Last resort: hope npm is somewhere on PATH.
-  return 'npm';
+  return null;
 }

package/bin/total-recall.cmd

@@ -1,7 +1,8 @@
 @echo off
 SETLOCAL EnableDelayedExpansion
 :: total-recall MCP server launcher for Windows
-:: Prefers bundled Bun, falls back to system Bun, then system Node.
+:: Requires Bun — dist\index.js uses bun:sqlite, which node cannot resolve.
+:: Prefers bundled Bun (installed by scripts\postinstall.js), falls back to system Bun.
 
 SET BUN_VERSION=1.2.10
 SET BUNDLED_BUN=%USERPROFILE%\.total-recall\bun\%BUN_VERSION%\bun.exe
@@ -21,7 +22,7 @@ IF EXIST "%BUNDLED_BUN%" (
   exit /b %ERRORLEVEL%
 )
 
-:: Priority 2: system Bun (warn)
+:: Priority 2: system Bun (warn — version may not match)
 WHERE bun >nul 2>&1
 IF %ERRORLEVEL% EQU 0 (
   echo total-recall: warning: bundled bun v%BUN_VERSION% not found, using system bun. Version mismatch possible. 1>&2
@@ -30,15 +31,7 @@ IF %ERRORLEVEL% EQU 0 (
   exit /b !ERRORLEVEL!
 )
 
-:: Priority 3: system Node (warn)
-WHERE node >nul 2>&1
-IF %ERRORLEVEL% EQU 0 (
-  echo total-recall: warning: bun not found, falling back to node. ABI issues may occur. 1>&2
-  echo   Install bun (https://bun.sh/install) or re-run 'npm install' to fix this. 1>&2
-  node "%ENTRY%" %*
-  exit /b !ERRORLEVEL!
-)
-
-echo total-recall: error: neither bun nor node found. 1>&2
-echo   Install bun: https://bun.sh/install 1>&2
+echo total-recall: error: bun runtime not found. 1>&2
+echo   Expected bundled bun at %%USERPROFILE%%\.total-recall\bun\%BUN_VERSION%\bun.exe (installed by 'npm install'). 1>&2
+echo   Fix: run 'npm install' inside the plugin directory, or install bun manually (https://bun.sh/install). 1>&2
 exit /b 1

package/bin/total-recall.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 # total-recall MCP server launcher
-# Prefers bundled Bun, falls back to system Bun, then system Node.
+# Requires Bun — dist/index.js uses bun:sqlite, which node cannot resolve.
+# Prefers bundled Bun (installed by scripts/postinstall.js), falls back to system Bun.
 
 BUN_VERSION="1.2.10"
 
@@ -25,67 +26,6 @@ find_system_bun() {
   return 1
 }
 
-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
-
-  # Check nvm4w (Windows nvm — Git Bash exposes C:\ as /c/)
-  if [ -x "/c/nvm4w/nodejs/node" ]; then
-    echo "/c/nvm4w/nodejs/node"
-    return 0
-  fi
-
-  # Check MacPorts
-  if [ -x "/opt/local/bin/node" ]; then
-    echo "/opt/local/bin/node"
-    return 0
-  fi
-
-  echo ""
-  return 1
-}
-
 # Find the package entry point
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PACKAGE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
@@ -103,7 +43,7 @@ if [ -n "$RUNTIME" ]; then
   exec "$RUNTIME" "$ENTRY" "$@"
 fi
 
-# Priority 2: system Bun (warn)
+# Priority 2: system Bun (warn — version may not match)
 RUNTIME=$(find_system_bun)
 if [ -n "$RUNTIME" ]; then
   echo "total-recall: warning: bundled bun v$BUN_VERSION not found, using system bun. Version mismatch possible." >&2
@@ -111,14 +51,7 @@ if [ -n "$RUNTIME" ]; then
   exec "$RUNTIME" "$ENTRY" "$@"
 fi
 
-# Priority 3: system Node (warn)
-RUNTIME=$(find_node)
-if [ -n "$RUNTIME" ]; then
-  echo "total-recall: warning: bun not found, falling back to node. Native addon ABI issues may occur." >&2
-  echo "  Install bun (https://bun.sh/install) or re-run 'npm install' to fix this." >&2
-  exec "$RUNTIME" "$ENTRY" "$@"
-fi
-
-echo "total-recall: error: neither bun nor node found." >&2
-echo "  Install bun: https://bun.sh/install" >&2
+echo "total-recall: error: bun runtime not found." >&2
+echo "  Expected bundled bun at ~/.total-recall/bun/$BUN_VERSION/bun (installed by 'npm install')." >&2
+echo "  Fix: run 'npm install' inside the plugin directory, or install bun manually (https://bun.sh/install)." >&2
 exit 1

package/dist/index.js

@@ -8664,6 +8664,9 @@ var Embedder = class {
   }
 };
 
+// src/tools/registry.ts
+import { readFileSync as readFileSync15 } from "fs";
+
 // node_modules/zod/v3/helpers/util.js
 var util;
 (function(util2) {
@@ -25310,7 +25313,15 @@ var CopilotCliImporter = class {
 import { existsSync as existsSync7, readdirSync as readdirSync4, readFileSync as readFileSync8 } from "fs";
 import { join as join11 } from "path";
 import { homedir as homedir3 } from "os";
+import { fileURLToPath as fileURLToPath6 } from "url";
 import { Database as Database2 } from "bun:sqlite";
+function safeFileURLToPath(url2) {
+  try {
+    return fileURLToPath6(url2);
+  } catch {
+    return null;
+  }
+}
 var CursorImporter = class {
   name = "cursor";
   configPath;
@@ -25334,7 +25345,7 @@ var CursorImporter = class {
         if (!existsSync7(wsJson)) continue;
         try {
           const ws = JSON.parse(readFileSync8(wsJson, "utf8"));
-          const projectPath = ws.folder ? decodeURIComponent(new URL(ws.folder).pathname) : ws.workspace ? decodeURIComponent(new URL(ws.workspace).pathname) : null;
+          const projectPath = ws.folder ? safeFileURLToPath(ws.folder) : ws.workspace ? safeFileURLToPath(ws.workspace) : null;
           if (!projectPath) continue;
           if (existsSync7(join11(projectPath, ".cursorrules"))) knowledgeFiles++;
           const rulesDir = join11(projectPath, ".cursor", "rules");
@@ -25397,7 +25408,7 @@ var CursorImporter = class {
       if (!existsSync7(wsJson)) continue;
       try {
         const ws = JSON.parse(readFileSync8(wsJson, "utf8"));
-        const projectPath = ws.folder ? new URL(ws.folder).pathname : ws.workspace ? new URL(ws.workspace).pathname : null;
+        const projectPath = ws.folder ? safeFileURLToPath(ws.folder) : ws.workspace ? safeFileURLToPath(ws.workspace) : null;
         if (projectPath) projectPaths.add(projectPath);
       } catch {
       }
@@ -26105,10 +26116,11 @@ function collectMarkdownFiles(dirPath, files) {
 
 // src/utils/project-detect.ts
 import { execFileSync } from "child_process";
-import { basename as basename5 } from "path";
+import { basename as basename5, parse as parsePath } from "path";
+import { homedir as homedir7 } from "os";
 function detectProject(cwd) {
-  const home = process.env.HOME ?? "";
-  if (cwd === home || cwd === "/") return null;
+  if (cwd === homedir7()) return null;
+  if (cwd === parsePath(cwd).root) return null;
   try {
     const remote = execFileSync("git", ["remote", "get-url", "origin"], {
       cwd,
@@ -26127,8 +26139,8 @@ function detectProject(cwd) {
 // src/eval/smoke-test.ts
 import { resolve as resolve4, dirname as dirname6, basename as basename6 } from "path";
 import { readFileSync as readFileSync13 } from "fs";
-import { fileURLToPath as fileURLToPath6 } from "url";
-var __dirname3 = dirname6(fileURLToPath6(import.meta.url));
+import { fileURLToPath as fileURLToPath7 } from "url";
+var __dirname3 = dirname6(fileURLToPath7(import.meta.url));
 var PACKAGE_ROOT3 = basename6(__dirname3) === "dist" ? resolve4(__dirname3, "..") : resolve4(__dirname3, "..", "..");
 var SMOKE_PASS_THRESHOLD = 0.8;
 function getMetaValue(db, key) {
@@ -26875,9 +26887,13 @@ async function handleExtraTool(name, args, ctx) {
 }
 
 // src/tools/registry.ts
+function readPackageVersion() {
+  const pkg = JSON.parse(readFileSync15(pkgPath("package.json"), "utf-8"));
+  return pkg.version;
+}
 async function startServer(ctx) {
   const server = new Server(
-    { name: "total-recall", version: "0.5.9" },
+    { name: "total-recall", version: readPackageVersion() },
     { capabilities: { tools: {} } }
   );
   server.oninitialized = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strvmarv/total-recall",
-  "version": "0.6.8-beta.3",
+  "version": "0.6.8-beta.5",
   "description": "Multi-tiered memory and knowledge base plugin for TUI coding assistants",
   "type": "module",
   "main": "dist/index.js",