grepmax 0.26.13 → 0.26.14

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "grepmax",
       "source": "./plugins/grepmax",
       "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
-      "version": "0.26.13",
+      "version": "0.26.14",
       "author": {
         "name": "Robert Owens",
         "email": "robowens@me.com"

package/dist/commands/doctor.js

@@ -56,6 +56,7 @@ const lock_1 = require("../lib/utils/lock");
 const mlx_hf_cache_1 = require("../lib/utils/mlx-hf-cache");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
+const root_availability_1 = require("../lib/utils/root-availability");
 function formatSize(bytes) {
     if (bytes < 1024)
         return `${bytes} B`;
@@ -197,6 +198,7 @@ exports.doctor = new commander_1.Command("doctor")
     let needsOptimize = false;
     let staleLock = false;
     const orphanedProjects = [];
+    const unavailableProjects = [];
     try {
         const { VectorDB, findStaleLanceTempFiles, sweepStaleLanceTempFiles } = yield Promise.resolve().then(() => __importStar(require("../lib/store/vector-db")));
         const db = new VectorDB(config_1.PATHS.lancedbDir);
@@ -250,12 +252,21 @@ exports.doctor = new commander_1.Command("doctor")
         // Daemon status
         const { isDaemonRunning } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/daemon-client")));
         const daemonUp = yield isDaemonRunning();
-        // Project registry health
+        // Project registry health.
+        //
+        // A root can be unreadable for two very different reasons, and only one of
+        // them is the project's fault. An unplugged external drive or a downed
+        // network share leaves the project perfectly intact — deregistering it
+        // would strand its vectors in the shared table with no owning project and
+        // would not come back when the volume returns. Only a root whose volume is
+        // mounted, and whose directory is still gone, is actually orphaned.
         const projects = (0, project_registry_1.listProjects)();
         for (const p of projects) {
-            if (!fs.existsSync(p.root)) {
+            const availability = (0, root_availability_1.classifyRoot)(p.root);
+            if (availability === "missing")
                 orphanedProjects.push(p.root);
-            }
+            else if (availability === "unavailable")
+                unavailableProjects.push(p.root);
         }
         // Compute warning flags
         //
@@ -313,6 +324,7 @@ exports.doctor = new commander_1.Command("doctor")
                 `lock=${lockStatus.split(" ")[0]}`,
                 `daemon=${daemonUp ? "running" : "stopped"}`,
                 `orphaned=${orphanedProjects.length}`,
+                `offline=${unavailableProjects.length}`,
                 `stale_temp=${staleTempFiles.length}`,
                 `stale_temp_bytes=${staleTempBytes}`,
                 `stale_chunker=${staleChunkerProjects.length}`,
@@ -455,13 +467,19 @@ exports.doctor = new commander_1.Command("doctor")
             if (legacyNotice)
                 console.log(legacyNotice);
             // Projects
+            if (unavailableProjects.length > 0) {
+                console.log(`INFO  Offline projects: ${unavailableProjects.length} (volume not mounted — kept, reconnect to resume)`);
+                for (const up of unavailableProjects) {
+                    console.log(`       - ${up}`);
+                }
+            }
             if (orphanedProjects.length > 0) {
                 console.log(`WARN  Orphaned projects: ${orphanedProjects.length} (directories no longer exist)`);
                 for (const op of orphanedProjects) {
                     console.log(`       - ${op}`);
                 }
             }
-            else if (projects.length > 0) {
+            else if (projects.length > 0 && unavailableProjects.length === 0) {
                 console.log(`ok  Projects: ${projects.length} registered, all directories exist`);
             }
             // Cache Coherence
@@ -563,6 +581,9 @@ exports.doctor = new commander_1.Command("doctor")
                     console.log(`ok  Optimize complete (${via})`);
                 fixed++;
             }
+            // Only roots whose volume is mounted and whose directory is still gone
+            // reach this list — projects on an unplugged drive are classified
+            // `unavailable` and never enter it, so --fix cannot deregister them.
             if (orphanedProjects.length > 0) {
                 for (const op of orphanedProjects) {
                     (0, project_registry_1.removeProject)(op);

package/dist/lib/daemon/daemon.js

@@ -67,6 +67,7 @@ const logger_1 = require("../utils/logger");
 const operation_coordinator_1 = require("../utils/operation-coordinator");
 const process_1 = require("../utils/process");
 const project_registry_1 = require("../utils/project-registry");
+const root_availability_1 = require("../utils/root-availability");
 const watcher_store_1 = require("../utils/watcher-store");
 const pool_1 = require("../workers/pool");
 const ipc_handler_1 = require("./ipc-handler");
@@ -352,7 +353,10 @@ class Daemon {
             const indexed = allProjects.filter((p) => p.status === "indexed");
             for (const p of indexed) {
                 if (!fs.existsSync(p.root)) {
-                    console.log(`[daemon] Skipping ${path.basename(p.root)} — directory not found`);
+                    // Skipping is already the safe behavior — the project keeps its registry
+                    // entry and its vectors either way. Naming the reason keeps an unplugged
+                    // drive from reading like data loss in the log.
+                    console.log(`[daemon] Skipping ${path.basename(p.root)} — ${(0, root_availability_1.describeRoot)(p.root)}`);
                     continue;
                 }
                 try {

package/dist/lib/utils/root-availability.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyRoot = classifyRoot;
+exports.isRootUnavailable = isRootUnavailable;
+exports.describeRoot = describeRoot;
+const fs = __importStar(require("node:fs"));
+/**
+ * Directories that hold mount points rather than user data, with how many path
+ * segments below them the mount point itself sits.
+ *
+ * `mountDepth` errs high where a platform is ambiguous (Linux uses both
+ * `/media/<volume>` and `/media/<user>/<volume>`). Overshooting biases the
+ * classifier toward `unavailable`, which is the safe direction: a wrong
+ * `unavailable` only means we decline to auto-remove a genuinely dead project,
+ * while a wrong `missing` silently deregisters a live one.
+ */
+const MOUNT_CONTAINERS = [
+    { prefix: "/Volumes", mountDepth: 1 }, // macOS
+    { prefix: "/run/media", mountDepth: 2 }, // Linux, udisks2
+    { prefix: "/media", mountDepth: 2 },
+    { prefix: "/mnt", mountDepth: 1 },
+    { prefix: "/net", mountDepth: 1 }, // autofs network mounts
+];
+function exists(p) {
+    try {
+        fs.statSync(p);
+        return true;
+    }
+    catch (_a) {
+        // A disconnected network mount can throw EIO/ETIMEDOUT rather than ENOENT.
+        // Either way the path is not readable, and the caller's container check
+        // decides whether that means unavailable or missing.
+        return false;
+    }
+}
+/**
+ * Classify a project root that may live on removable or network storage.
+ *
+ * Longest matching container wins, so `/run/media` is not shadowed by `/media`.
+ */
+function classifyRoot(root) {
+    if (exists(root))
+        return "present";
+    const container = MOUNT_CONTAINERS.filter((c) => root === c.prefix || root.startsWith(`${c.prefix}/`)).sort((a, b) => b.prefix.length - a.prefix.length)[0];
+    if (!container)
+        return "missing";
+    // The mount point is the container plus `mountDepth` segments. If it is
+    // absent, nothing is mounted there and the project is merely out of reach.
+    const rest = root.slice(container.prefix.length).split("/").filter(Boolean);
+    if (rest.length < container.mountDepth)
+        return "missing";
+    const mountPoint = `${container.prefix}/${rest.slice(0, container.mountDepth).join("/")}`;
+    return exists(mountPoint) ? "missing" : "unavailable";
+}
+/**
+ * True when the root is absent only because its volume is not mounted.
+ * Callers that delete or rewrite persistent state must check this first.
+ */
+function isRootUnavailable(root) {
+    return classifyRoot(root) === "unavailable";
+}
+/** Human-readable reason for a non-present root, for logs and doctor output. */
+function describeRoot(root) {
+    switch (classifyRoot(root)) {
+        case "present":
+            return "available";
+        case "unavailable":
+            return "volume not mounted";
+        case "missing":
+            return "directory not found";
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.26.13",
+  "version": "0.26.14",
   "author": "Robert Owens <78518764+reowens@users.noreply.github.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

package/plugins/grepmax/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.26.13",
+  "version": "0.26.14",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",