grepmax 0.26.42 → 0.26.44

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.42",
+      "version": "0.26.44",
       "author": {
         "name": "Robert Owens",
         "email": "robowens@me.com"

package/NOTICE

@@ -31,3 +31,9 @@ THIRD-PARTY DEPENDENCIES
 
 This software depends on various open-source libraries. See package.json for
 a complete list of dependencies and their respective licenses.
+
+The distribution includes the unmodified JavaScript runtime from
+@lancedb/lancedb 0.38.0 (https://github.com/lancedb/lancedb), licensed under
+Apache-2.0. Its license and build provenance are included in dist/vendor/lancedb/.
+Its optional provider dependency manifest is not distributed. Platform native
+binaries are installed as separately pinned @lancedb packages.

package/README.md

@@ -126,7 +126,9 @@ Plugins auto-update when you run `npm install -g grepmax@latest` — no need to
 
 ### MCP Server
 
-`gmax mcp` starts a stdio-based MCP server for clients that support MCP but can't run shell commands (Cursor, Windsurf, custom agents). Search-backed tools use the singleton daemon when available, avoiding a separate embedding worker per MCP session, and fall back to an in-process worker only when the daemon is unavailable or does not support the request.
+MCP is local-only: the client spawns it and communicates through stdin/stdout pipes. It has no HTTP, SSE, or TCP listener and cannot be reached over the network. The daemon socket is restricted to your user account.
+
+`gmax mcp` starts a stdio-based MCP server for clients that support MCP but can't run shell commands (Cursor, Windsurf, custom agents). Search-backed tools use the singleton daemon when available, avoiding a separate embedding worker per MCP session, and use an in-process worker for supported offline/secondary-store access. An unsupported daemon command requires `gmax watch restart`.
 
 | Tool | Description |
 | --- | --- |
@@ -452,6 +454,10 @@ gmax watch restart            # Restart daemon
 
 Compaction pauses index writes, waits for pending writes to commit, and opens a fresh table snapshot for each attempt. Each optimize call makes at most two attempts. Before each attempt it checks current free space against twice the table's logical size plus the critical-space reserve (5 GB by default). If there is insufficient headroom, it skips the rewrite and logs the required space; search remains available. A successful prune can reclaim fragment copies left by failed attempts.
 
+`~/.gmax/logs/daemon.log` records compaction attempts and outcomes, including duration, logical size, disk size before/after, free space, and bytes reclaimed. `gmax status --json` exposes the last outcome under `daemon.compaction`; its `at` timestamp identifies when it was recorded. Five-minute resource snapshots track footprint, RSS, heap, external/ArrayBuffer memory, Lance cache, workers and pending work for memory investigations. Reading status uses retained snapshots and does not scan the index directory. Logs rotate to `daemon.log.prev`.
+
+`gmax doctor --fix` reports completed, skipped, failed, or unverified optimization. It exits nonzero when a requested optimization did not complete or an older daemon could not verify its outcome. A busy or failed daemon is never retried as a second writer in the CLI process.
+
 ### Known issues
 
 Some log output looks alarming but is expected and self-healing. Before filing a bug, check

package/dist/bin.js

@@ -75,6 +75,10 @@ function selectHome() {
     if (process.env.GMAX_HOME)
         return;
     const argv = process.argv.slice(2);
+    // These enumerate/route stores per request rather than pinning the process
+    // to its launch cwd's store. In particular an MCP session can serve both.
+    if (argv[0] === "mcp" || argv[0] === "status")
+        return;
     const match = (0, stores_1.matchStore)(commandTarget(argv, process.cwd()));
     if (match.kind === "primary")
         return;

package/dist/commands/doctor.js

@@ -51,12 +51,14 @@ const commander_1 = require("commander");
 const config_1 = require("../config");
 const embedding_status_1 = require("../lib/index/embedding-status");
 const index_config_1 = require("../lib/index/index-config");
+const doctor_optimize_1 = require("../lib/utils/doctor-optimize");
 const doctor_status_1 = require("../lib/utils/doctor-status");
 const exit_1 = require("../lib/utils/exit");
 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 query_timeout_1 = require("../lib/utils/query-timeout");
 const root_availability_1 = require("../lib/utils/root-availability");
 const store_access_1 = require("../lib/utils/store-access");
 function formatSize(bytes) {
@@ -343,7 +345,7 @@ exports.doctor = new commander_1.Command("doctor")
     .option("--agent", "Compact output for AI agents", false)
     .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b;
-    var _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+    var _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
     if (!opts.agent)
         console.log("gmax Doctor\n");
     const root = config_1.PATHS.globalRoot;
@@ -488,7 +490,7 @@ exports.doctor = new commander_1.Command("doctor")
                 .query()
                 .where("length(summary) > 5")
                 .select(["id"])
-                .toArray()).length;
+                .toArray(query_timeout_1.QUERY_EXECUTION_OPTIONS)).length;
             const coverage = (0, doctor_status_1.summaryCoverageStatus)(withSummary, totalChunks);
             console.log(`${coverage.symbol}  ${coverage.message}`);
         }
@@ -572,7 +574,7 @@ exports.doctor = new commander_1.Command("doctor")
                         ? "LOW"
                         : "ok";
         }
-        catch (_q) { }
+        catch (_p) { }
         const staleChunkerProjects = projects.filter((p) => { var _a; return p.status === "indexed" &&
             ((_a = p.chunkerVersion) !== null && _a !== void 0 ? _a : 1) < config_1.CONFIG.CHUNKER_VERSION; });
         const staleEmbeddingProjects = projects.filter((p) => p.status === "indexed" &&
@@ -787,7 +789,7 @@ exports.doctor = new commander_1.Command("doctor")
                         yield mc.close();
                     }
                 }
-                catch (_r) { }
+                catch (_q) { }
             }
         }
         // --fix auto-remediation
@@ -820,34 +822,22 @@ exports.doctor = new commander_1.Command("doctor")
                 // daemon up it owns compaction; without one we are the sole process
                 // and can do it in-process safely.
                 const { sendDaemonCommand } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/daemon-client")));
-                const resp = yield sendDaemonCommand({ cmd: "optimize" }, { timeoutMs: 10 * 60 * 1000 });
-                let via = "daemon";
-                if (!resp.ok) {
-                    // Only fall back when the daemon could not take it. A daemon that
-                    // answered with a real failure should surface, not be retried here
-                    // as a competing writer.
-                    const reason = String((_l = resp.error) !== null && _l !== void 0 ? _l : "");
-                    // Fall back ONLY when nothing is listening. A daemon that is merely
-                    // too old ("unknown command") or busy ("timeout") is still a live
-                    // writer on the store, so optimizing here would recreate the
-                    // two-writer case this routing exists to prevent.
-                    const daemonAbsent = reason.includes("ECONNREFUSED") || reason.includes("ENOENT");
-                    if (daemonAbsent) {
-                        yield db.optimize(3, 0);
-                        via = "in-process (no daemon)";
-                    }
-                    else if (reason.includes("unknown command")) {
-                        via = "";
-                        console.log("WARN  Optimize skipped: the running daemon predates the optimize command. Restart it (gmax watch --daemon -b) and re-run.");
+                // Release the diagnostic reader before the daemon prunes old files.
+                yield db.close();
+                const report = yield (0, doctor_optimize_1.runDoctorOptimize)(() => sendDaemonCommand({ cmd: "optimize" }, { timeoutMs: 10 * 60 * 1000 }), () => __awaiter(void 0, void 0, void 0, function* () {
+                    const repairDb = new VectorDB(config_1.PATHS.lancedbDir);
+                    try {
+                        return yield repairDb.optimize();
                     }
-                    else {
-                        via = "";
-                        console.log(`WARN  Optimize failed via daemon: ${reason}`);
+                    finally {
+                        yield repairDb.close();
                     }
-                }
-                if (via && !opts.agent)
-                    console.log(`ok  Optimize complete (${via})`);
-                fixed++;
+                }));
+                console.log((0, doctor_optimize_1.formatDoctorOptimize)(report, opts.agent));
+                if (report.status === "completed")
+                    fixed++;
+                else
+                    process.exitCode = 1;
             }
             // Only roots whose volume is mounted and whose directory is still gone
             // reach this list — projects on an unplugged drive are classified
@@ -877,7 +867,7 @@ exports.doctor = new commander_1.Command("doctor")
                         const done = yield sendStreamingCommand({ cmd: "index", root: p.root, reset: true }, () => { }).catch((e) => ({ ok: false, error: String(e) }));
                         if (done.ok &&
                             (!("degraded" in done) || done.degraded !== true)) {
-                            const chunks = (_m = done.indexed) !== null && _m !== void 0 ? _m : 0;
+                            const chunks = (_l = done.indexed) !== null && _l !== void 0 ? _l : 0;
                             if (opts.agent) {
                                 console.log(`stale_chunker_reindexed\tname=${name}\tchunks=${chunks}`);
                             }
@@ -889,14 +879,14 @@ exports.doctor = new commander_1.Command("doctor")
                         else if (!opts.agent) {
                             const degraded = "degraded" in done && done.degraded === true;
                             const reason = degraded
-                                ? `${(_o = ("scanErrors" in done ? done.scanErrors : 0)) !== null && _o !== void 0 ? _o : 0} scan errors, ${(_p = ("failedFiles" in done ? done.failedFiles : 0)) !== null && _p !== void 0 ? _p : 0} file failures`
+                                ? `${(_m = ("scanErrors" in done ? done.scanErrors : 0)) !== null && _m !== void 0 ? _m : 0} scan errors, ${(_o = ("failedFiles" in done ? done.failedFiles : 0)) !== null && _o !== void 0 ? _o : 0} file failures`
                                 : done.error;
                             console.log(`FAIL  ${name}: reindex failed (${reason})`);
                         }
                     }
                 }
             }
-            if (fixed === 0) {
+            if (fixed === 0 && !needsOptimize) {
                 if (!opts.agent)
                     console.log("ok  Nothing to fix");
             }