crispy-recall 0.2.0 → 0.2.1

package/README.md

@@ -6,6 +6,22 @@ Searchable memory for your Claude Code and Codex sessions. Local, fast, no daemo
 
 A standalone spin-off of the recall feature from [Crispy](https://github.com/TheSylvester/crispy). See the parent project for the broader multi-agent orchestration GUI.
 
+## What's new in 0.2.1
+
+- **macOS install support.** 0.2.0's native SQLite engine shipped without ever
+  running on Apple hardware; 0.2.1 fixes the macOS install path and validates it
+  end-to-end on Apple Silicon. Fixes: a pre-flight macOS-version check (the
+  bundled llama.cpp embedding binaries need macOS 14+ on arm64, 13.7+ on Intel),
+  a Node path that stays valid across `brew upgrade node` during in-place
+  upgrades (it previously pinned a Homebrew Cellar path that a later upgrade
+  removes), an up-front rejection of Node 23 (no prebuilt SQLite binding) with an
+  explanation instead of a late failure, and a load-check of the staged SQLite
+  binding before the installer trusts it. Non-macOS installs are unaffected.
+- **`recall install` no longer hangs during setup.** Extraction of the embedding
+  binaries is now time-boxed with a fallback to the OS unzip tool
+  (`unzip`/`ditto`/`Expand-Archive`), so a stalled extract can no longer wedge
+  the installer.
+
 ## What's new in 0.2.0
 
 - **Native SQLite engine with real WAL.** The database now runs on
@@ -13,7 +29,8 @@ A standalone spin-off of the recall feature from [Crispy](https://github.com/The
   binding — which never actually engaged WAL and could silently corrupt the
   index when multiple processes wrote at once. That failure mode is eliminated
   at the root. `recall doctor` gains a SQLite-binding health section.
-  **Node.js ≥ 22.16 is now required.**
+  **Node.js 22 LTS (≥ 22.16) or 24+ is now required** (Node 23 has no prebuilt
+  SQLite binding).
 - **Git provenance: `--commit` and `--blame`.** `recall --commit <hash>` lists
   the session(s) that produced a commit; `recall --blame <path>[:line[-line]]`
   traces a file or line range back to the conversations responsible. Matching
@@ -65,13 +82,19 @@ Run it in the environment where you actually use Claude Code: **WSL and
 Windows-native are separate installs.** If you use both, run the install in each
 — the installer only configures the environment it is invoked in.
 
+> **macOS: use Node 22 LTS or 24+.** Node 23 has no prebuilt SQLite binding, so
+> `npm install -g` would fall back to compiling it and fail without Xcode
+> Command Line Tools. macOS 14+ (Apple Silicon) / 13.7+ (Intel) is required for
+> the bundled semantic-embedding binaries.
+
 > **Don't install via `npx`.** recall must stay resident. `npx` runs from an
 > ephemeral cache and leaves no `recall` command on your PATH, so follow-up
 > commands (`recall status` / `doctor` / `repair` / `uninstall`) and the
 > installed skill's command contract have nothing to call. Use the global
 > install above.
 
-Prerequisites: Node ≥ 22.16 and Claude Code installed. If Codex is detected
+Prerequisites: Node 22 LTS (≥ 22.16) or 24+ — Node 23 is unsupported (no
+prebuilt SQLite binding) — and Claude Code installed. If Codex is detected
 (`~/.codex/` exists), recall installs the `recall` skill into Codex (so the
 agent can search) and you can index your Codex history with
 `recall backfill --vendor codex`. Real-time per-turn Codex indexing is **not

package/dist/embed-pending.js

@@ -3466,10 +3466,18 @@ var require_extract_zip = __commonJS({
   }
 });
 
+// src/installer/stable-node.ts
+var init_stable_node = __esm({
+  "src/installer/stable-node.ts"() {
+    "use strict";
+  }
+});
+
 // src/installer/settings-merge.ts
 var init_settings_merge = __esm({
   "src/installer/settings-merge.ts"() {
     "use strict";
+    init_stable_node();
   }
 });
 
@@ -3513,15 +3521,21 @@ var init_config = __esm({
 // src/recall/embedder.ts
 var embedder_exports = {};
 __export(embedder_exports, {
+  LLAMA_RELEASE_TAG: () => LLAMA_RELEASE_TAG,
+  MACOS_MIN_VERSION: () => MACOS_MIN_VERSION,
+  buildUnzipInvocations: () => buildUnzipInvocations,
   disposeEmbedder: () => disposeEmbedder,
   embed: () => embed,
   embedBatch: () => embedBatch,
   ensureBinary: () => ensureBinary,
   ensureModel: () => ensureModel,
+  extractArchive: () => extractArchive,
   getBinaryPath: () => getBinaryPath,
   getModelPath: () => getModelPath,
   hasNvidiaGpu: () => hasNvidiaGpu,
-  initEmbedder: () => initEmbedder
+  initEmbedder: () => initEmbedder,
+  installExtractedBinaries: () => installExtractedBinaries,
+  withTimeout: () => withTimeout
 });
 function gpuRuntime() {
   if (_gpuRuntime === void 0) {
@@ -3695,6 +3709,82 @@ async function performBinaryDownload(binPath) {
   }
   throw new Error("No suitable llama-embedding binary found");
 }
+function withTimeout(promise, ms, label) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(
+      () => reject(new Error(`${label} timed out after ${Math.round(ms / 1e3)}s`)),
+      ms
+    );
+  });
+  promise.catch(() => {
+  });
+  return Promise.race([promise, timeout]).finally(() => {
+    if (timer)
+      clearTimeout(timer);
+  });
+}
+function psQuote(p) {
+  return p.replace(/'/g, "''");
+}
+function buildUnzipInvocations(plat, archivePath, dir) {
+  if (plat === "win32") {
+    return [{
+      cmd: "powershell",
+      args: [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `Expand-Archive -LiteralPath '${psQuote(archivePath)}' -DestinationPath '${psQuote(dir)}' -Force`
+      ]
+    }];
+  }
+  const unzip = { cmd: "unzip", args: ["-o", "-q", archivePath, "-d", dir] };
+  return plat === "darwin" ? [unzip, { cmd: "ditto", args: ["-x", "-k", archivePath, dir] }] : [unzip];
+}
+async function osUnzip(archivePath, dir) {
+  (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
+  const invocations = buildUnzipInvocations((0, import_node_os2.platform)(), archivePath, dir);
+  let lastErr;
+  for (const { cmd, args } of invocations) {
+    try {
+      await execFileAsync(cmd, args, { timeout: EXTRACT_TIMEOUT_MS, windowsHide: true });
+      return;
+    } catch (err) {
+      lastErr = err;
+    }
+  }
+  throw lastErr instanceof Error ? lastErr : new Error(`Native unzip failed for ${archivePath}`);
+}
+async function extractArchive(archivePath, baseDir, assetName, timeoutMs = EXTRACT_TIMEOUT_MS) {
+  try {
+    await withTimeout((0, import_extract_zip.default)(archivePath, { dir: baseDir }), timeoutMs, `Extracting ${assetName}`);
+    return baseDir;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    log({
+      source: "recall-catchup",
+      level: "warn",
+      summary: `Bundled unzip failed for ${assetName} (${msg}); falling back to system unzip`
+    });
+    const fallbackDir = (0, import_node_path4.join)(baseDir, "__os_unzip__");
+    await osUnzip(archivePath, fallbackDir);
+    return fallbackDir;
+  }
+}
+async function installExtractedBinaries(extractedDir, destDir = binDir()) {
+  const buildBinDir = (0, import_node_path4.join)(extractedDir, "build", "bin");
+  const sourceDir = (0, import_node_fs4.existsSync)(buildBinDir) ? buildBinDir : extractedDir;
+  (0, import_node_fs4.mkdirSync)(destDir, { recursive: true });
+  let copiedCount = 0;
+  for (const file of await (0, import_promises.readdir)(sourceDir)) {
+    if (!isWantedFile(file))
+      continue;
+    await (0, import_promises.cp)((0, import_node_path4.join)(sourceDir, file), (0, import_node_path4.join)(destDir, file), { force: true });
+    copiedCount++;
+  }
+  return copiedCount;
+}
 async function downloadAndExtract(assetName, binPath) {
   const url = `https://github.com/ggml-org/llama.cpp/releases/download/${LLAMA_RELEASE_TAG}/${assetName}`;
   const isGpu = assetName.includes("cuda") || assetName.includes("vulkan");
@@ -3715,18 +3805,8 @@ async function downloadAndExtract(assetName, binPath) {
     const tmpExtractDir = (0, import_node_path4.join)((0, import_node_os2.tmpdir)(), `llama-extract-${Date.now()}`);
     (0, import_node_fs4.mkdirSync)(tmpExtractDir, { recursive: true });
     try {
-      await (0, import_extract_zip.default)(archivePath, { dir: tmpExtractDir });
-      const buildBinDir = (0, import_node_path4.join)(tmpExtractDir, "build", "bin");
-      const sourceDir = (0, import_node_fs4.existsSync)(buildBinDir) ? buildBinDir : tmpExtractDir;
-      let copiedCount = 0;
-      for (const file of await (0, import_promises.readdir)(sourceDir)) {
-        if (!isWantedFile(file))
-          continue;
-        const src = (0, import_node_path4.join)(sourceDir, file);
-        const dest = (0, import_node_path4.join)(binDir(), file);
-        await (0, import_promises.cp)(src, dest, { force: true });
-        copiedCount++;
-      }
+      const extractedDir = await extractArchive(archivePath, tmpExtractDir, assetName);
+      const copiedCount = await installExtractedBinaries(extractedDir);
       if (copiedCount === 0) {
         throw new Error(`No binaries found in archive ${assetName}`);
       }
@@ -4350,7 +4430,7 @@ async function embedBatchInner(texts) {
 async function disposeEmbedder() {
   await killServer();
 }
-var import_node_child_process, import_node_fs4, import_promises, import_node_http, import_node_path4, import_node_os2, import_node_util, import_extract_zip, execFileAsync, _gpuRuntime, MODEL_FILENAME, MODEL_URL, EXPECTED_DIMS, BATCH_SEPARATOR, MAX_ARG_BYTES, LLAMA_RELEASE_TAG, BIN_NAME, SERVER_BIN_NAME, SERVER_SUPPORTED, SERVER_THRESHOLD, IDLE_TIMEOUT_MS, HEALTH_POLL_INTERVAL_MS, HEALTH_POLL_TIMEOUT_MS, HTTP_REQUEST_TIMEOUT_MS, SERVER_KILL_TIMEOUT_MS, SERVER_COOLDOWN_MS, embedQueue, embedRunning, binaryPath, downloadPromise, binaryDownloadPromise, serverProcess, activeSocketPath, idleTimer, serverStartPromise, serverCooldownUntil, serverRetryPromise, activeServerRequests, WANTED_FILES, WANTED_LIB_PATTERNS;
+var import_node_child_process, import_node_fs4, import_promises, import_node_http, import_node_path4, import_node_os2, import_node_util, import_extract_zip, execFileAsync, _gpuRuntime, MODEL_FILENAME, MODEL_URL, EXPECTED_DIMS, BATCH_SEPARATOR, MAX_ARG_BYTES, LLAMA_RELEASE_TAG, MACOS_MIN_VERSION, BIN_NAME, SERVER_BIN_NAME, SERVER_SUPPORTED, SERVER_THRESHOLD, IDLE_TIMEOUT_MS, HEALTH_POLL_INTERVAL_MS, HEALTH_POLL_TIMEOUT_MS, HTTP_REQUEST_TIMEOUT_MS, SERVER_KILL_TIMEOUT_MS, SERVER_COOLDOWN_MS, EXTRACT_TIMEOUT_MS, embedQueue, embedRunning, binaryPath, downloadPromise, binaryDownloadPromise, serverProcess, activeSocketPath, idleTimer, serverStartPromise, serverCooldownUntil, serverRetryPromise, activeServerRequests, WANTED_FILES, WANTED_LIB_PATTERNS;
 var init_embedder = __esm({
   "src/recall/embedder.ts"() {
     "use strict";
@@ -4372,6 +4452,7 @@ var init_embedder = __esm({
     BATCH_SEPARATOR = "<#sep#>";
     MAX_ARG_BYTES = (0, import_node_os2.platform)() === "win32" ? 0 : 1e5;
     LLAMA_RELEASE_TAG = "b5300";
+    MACOS_MIN_VERSION = { arm64: "14.0", x64: "13.7" };
     BIN_NAME = (0, import_node_os2.platform)() === "win32" ? "llama-embedding.exe" : "llama-embedding";
     SERVER_BIN_NAME = (0, import_node_os2.platform)() === "win32" ? "llama-server.exe" : "llama-server";
     SERVER_SUPPORTED = (0, import_node_os2.platform)() !== "win32";
@@ -4382,6 +4463,7 @@ var init_embedder = __esm({
     HTTP_REQUEST_TIMEOUT_MS = 12e4;
     SERVER_KILL_TIMEOUT_MS = 5e3;
     SERVER_COOLDOWN_MS = 6e4;
+    EXTRACT_TIMEOUT_MS = 12e4;
     embedQueue = [];
     embedRunning = false;
     binaryPath = null;
@@ -4681,7 +4763,10 @@ var BindingLoadError = class extends Error {
   constructor(dbPath2, cause) {
     super(
       `recall: failed to load the better-sqlite3 native binding while opening ${dbPath2}: ${cause.message}
-The binding is ABI-locked to the Node it was built for \u2014 run \`recall doctor\` (usually fixed by re-running \`recall install\`).`
+The native SQLite binding is ABI-locked to the Node it was built for. This is usually one of:
+  \u2022 recall is running under a different Node than the one npm installed it with (e.g. Homebrew node vs nvm) \u2014 reinstall with \`npm install -g crispy-recall\` using the node on your PATH, then \`recall install\`.
+  \u2022 no prebuilt binary matched your Node version and it could not compile \u2014 use Node 22 LTS or 24+ (Node 23 has no prebuilt SQLite binding), and on macOS make sure Xcode Command Line Tools are installed (\`xcode-select --install\`).
+Run \`recall doctor\` for details.`
     );
     this.dbPath = dbPath2;
     this.cause = cause;