grepmax 0.26.27 → 0.26.30

package/dist/commands/surprises.js

@@ -1,4 +1,37 @@
 "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;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -12,11 +45,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.surprises = void 0;
 const commander_1 = require("commander");
 const surprising_connections_1 = require("../lib/analysis/surprising-connections");
-const vector_db_1 = require("../lib/store/vector-db");
+const rows_handler_1 = require("../lib/daemon/rows-handler");
+const vector_handler_1 = require("../lib/daemon/vector-handler");
+const daemon_client_1 = require("../lib/utils/daemon-client");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 const stale_hint_1 = require("../lib/utils/stale-hint");
+const store_access_1 = require("../lib/utils/store-access");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
     bold: (s) => (useColors ? `\x1b[1m${s}\x1b[22m` : s),
@@ -108,7 +144,6 @@ exports.surprises = new commander_1.Command("surprises")
         process.exitCode = 1;
         return;
     }
-    let vectorDb = null;
     try {
         const root = (0, project_registry_1.resolveRootOrExit)(opts.root);
         if (root === null)
@@ -117,10 +152,27 @@ exports.surprises = new commander_1.Command("surprises")
         (0, stale_hint_1.maybeWarnStaleChunker)(projectRoot, { agent: opts.agent });
         (0, stale_hint_1.maybeWarnStaleEmbedding)(projectRoot, { agent: opts.agent });
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
-        vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
-        const table = yield vectorDb.ensureTable();
         const top = parseIntOption(opts.top, 20, 100);
-        const result = yield (0, surprising_connections_1.analyzeSurprisingConnections)(table, projectRoot, {
+        // --in/--exclude resolve against this process's cwd and filesystem, so
+        // they are resolved here and shipped as absolute prefixes.
+        // analyzeSurprisingConnections re-resolves them daemon-side; absolute
+        // input makes that a no-op, so both paths scan under the same scope.
+        const { resolveScope } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
+        const scope = resolveScope({
+            projectRoot,
+            in: opts.in,
+            exclude: opts.exclude,
+        });
+        const projectPrefix = projectRoot.endsWith("/")
+            ? projectRoot
+            : `${projectRoot}/`;
+        const analysisIn = scope.inPrefixes.length > 0
+            ? scope.inPrefixes
+            : scope.pathPrefix !== projectPrefix
+                ? [scope.pathPrefix]
+                : undefined;
+        const analysisExclude = scope.excludePrefixes.length > 0 ? scope.excludePrefixes : undefined;
+        const options = {
             sample: parseIntOption(opts.sample, surprising_connections_1.DEFAULT_SURPRISE_OPTIONS.sample),
             neighbors: parseIntOption(opts.neighbors, surprising_connections_1.DEFAULT_SURPRISE_OPTIONS.neighbors, 200),
             dirDepth: parseIntOption(opts.dirDepth, surprising_connections_1.DEFAULT_SURPRISE_OPTIONS.dirDepth, 20),
@@ -128,23 +180,28 @@ exports.surprises = new commander_1.Command("surprises")
             maxRows: parseIntOption(opts.maxRows, surprising_connections_1.DEFAULT_SURPRISE_OPTIONS.maxRows, surprising_connections_1.MAX_SURPRISE_ROWS),
             includeTests: Boolean(opts.includeTests),
             includeEval: Boolean(opts.includeEval),
-            in: opts.in,
-            exclude: opts.exclude,
+            in: analysisIn,
+            exclude: analysisExclude,
+        };
+        // The scan reads up to MAX_SURPRISE_ROWS rows with their vectors; the
+        // daemon runs it against its warm store and returns the summary plus the
+        // findings that will actually be printed.
+        const result = yield (0, store_access_1.withStoreRead)("surprises", {
+            daemon: () => (0, daemon_client_1.sendDaemonCommand)({ cmd: "vector.surprises", projectRoot, options, top }, { timeoutMs: 300000 }),
+            render: (resp) => resp,
+            inProcess: () => (0, rows_handler_1.withLocalStore)(paths.lancedbDir, (deps) => (0, vector_handler_1.runSurprises)(deps, { projectRoot, options, top })),
+            fallbackOnUnknownVerb: true,
         });
         console.log(opts.agent ? formatAgent(result, top) : formatHuman(result, top));
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : "Unknown error";
-        console.error("Surprises failed:", msg);
-        process.exitCode = 1;
+        if (!(0, store_access_1.reportStoreAccessRefusal)(error)) {
+            const msg = error instanceof Error ? error.message : "Unknown error";
+            console.error("Surprises failed:", msg);
+            process.exitCode = 1;
+        }
     }
     finally {
-        if (vectorDb) {
-            try {
-                yield vectorDb.close();
-            }
-            catch (_b) { }
-        }
         yield (0, exit_1.gracefulExit)();
     }
 }));

package/dist/commands/symbols.js

@@ -45,81 +45,49 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.symbols = void 0;
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
-const vector_db_1 = require("../lib/store/vector-db");
+const rows_handler_1 = require("../lib/daemon/rows-handler");
+const daemon_client_1 = require("../lib/utils/daemon-client");
 const exit_1 = require("../lib/utils/exit");
-const filter_builder_1 = require("../lib/utils/filter-builder");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
+const store_access_1 = require("../lib/utils/store-access");
 const style = {
     bold: (s) => `\x1b[1m${s}\x1b[22m`,
     dim: (s) => `\x1b[2m${s}\x1b[22m`,
     green: (s) => `\x1b[32m${s}\x1b[39m`,
 };
-function toStringArray(val) {
-    if (Array.isArray(val))
-        return val.filter((v) => typeof v === "string");
-    if (val && typeof val.toArray === "function") {
-        try {
-            const arr = val.toArray();
-            return Array.isArray(arr) ? arr.filter((v) => typeof v === "string") : [];
-        }
-        catch (_a) {
-            return [];
-        }
-    }
-    return [];
-}
+/**
+ * Ask the daemon for the symbol table; open the store only when no daemon is
+ * listening. Both branches run the same `runSymbols`, so the two paths cannot
+ * disagree — only the process the query runs in changes.
+ */
 function collectSymbols(options) {
     return __awaiter(this, void 0, void 0, function* () {
         const paths = (0, project_root_1.ensureProjectPaths)(options.projectRoot);
-        const db = new vector_db_1.VectorDB(paths.lancedbDir);
-        try {
-            const table = yield db.ensureTable();
-            let query = table
-                .query()
-                .select(["defined_symbols", "path", "start_line"])
-                .where("array_length(defined_symbols) > 0")
-                // Fetch more rows to ensure we have enough after filtering/aggregation
-                .limit(options.pattern ? 10000 : Math.max(options.limit * 50, 2000));
-            if (options.pathPrefix) {
-                // Resolve to absolute path for centralized index
-                const absPrefix = path.isAbsolute(options.pathPrefix)
-                    ? options.pathPrefix
-                    : path.resolve(options.projectRoot, options.pathPrefix);
-                query = query.where((0, filter_builder_1.pathStartsWith)((0, filter_builder_1.normalizePath)(absPrefix)));
-            }
-            const rows = yield query.toArray();
-            const map = new Map();
-            for (const row of rows) {
-                const defs = toStringArray(row.defined_symbols);
-                const path = String(row.path || "");
-                const line = Number(row.start_line || 0);
-                for (const sym of defs) {
-                    if (options.pattern &&
-                        !sym.toLowerCase().includes(options.pattern.toLowerCase())) {
-                        continue;
-                    }
-                    const existing = map.get(sym);
-                    if (existing) {
-                        existing.count += 1;
-                    }
-                    else {
-                        map.set(sym, { symbol: sym, count: 1, path, line });
-                    }
-                }
-            }
-            return Array.from(map.values())
-                .sort((a, b) => {
-                // Sort by count desc, then symbol asc
-                if (b.count !== a.count)
-                    return b.count - a.count;
-                return a.symbol.localeCompare(b.symbol);
-            })
-                .slice(0, options.limit);
-        }
-        finally {
-            yield db.close();
-        }
+        // Resolve to absolute for the centralized index. No trailing slash: the
+        // query has always matched starts_with on the bare prefix.
+        const absPrefix = options.pathPrefix
+            ? path.isAbsolute(options.pathPrefix)
+                ? options.pathPrefix
+                : path.resolve(options.projectRoot, options.pathPrefix)
+            : undefined;
+        return (0, store_access_1.withStoreRead)("symbols", {
+            daemon: () => (0, daemon_client_1.sendDaemonCommand)({
+                cmd: "rows.symbols",
+                projectRoot: options.projectRoot,
+                pathPrefix: absPrefix,
+                pattern: options.pattern,
+                limit: options.limit,
+            }, { timeoutMs: 60000 }),
+            render: (resp) => { var _a; return ((_a = resp.entries) !== null && _a !== void 0 ? _a : []); },
+            inProcess: () => (0, rows_handler_1.withLocalStore)(paths.lancedbDir, (deps) => (0, rows_handler_1.runSymbols)(deps, {
+                projectRoot: options.projectRoot,
+                pathPrefix: absPrefix,
+                pattern: options.pattern,
+                limit: options.limit,
+            })),
+            fallbackOnUnknownVerb: true,
+        });
     });
 }
 function formatTable(entries) {
@@ -182,20 +150,33 @@ exports.symbols = new commander_1.Command("symbols")
     const limit = Number.parseInt(cmd.limit, 10);
     // Auto-scope to project root; --path narrows further within it
     const pathPrefix = (_b = cmd.path) !== null && _b !== void 0 ? _b : projectRoot;
-    const entries = yield collectSymbols({
-        projectRoot,
-        limit: Number.isFinite(limit) && limit > 0 ? limit : 20,
-        pathPrefix,
-        pattern: pattern,
-    });
-    if (cmd.agent) {
-        console.log(formatAgent(entries, projectRoot));
+    try {
+        const entries = yield collectSymbols({
+            projectRoot,
+            limit: Number.isFinite(limit) && limit > 0 ? limit : 20,
+            pathPrefix,
+            pattern: pattern,
+        });
+        if (cmd.agent) {
+            console.log(formatAgent(entries, projectRoot));
+        }
+        else {
+            console.log(`${style.bold("Project")}: ${style.green(projectRoot)}\n${formatTable(entries)}`);
+        }
+        if (entries.length === 0) {
+            process.exitCode = 1;
+        }
     }
-    else {
-        console.log(`${style.bold("Project")}: ${style.green(projectRoot)}\n${formatTable(entries)}`);
+    catch (error) {
+        // `symbols` was the one read command with no catch at all, so a denied
+        // lease escaped as a raw node:fs stack trace instead of the one-line hint.
+        if (!(0, store_access_1.reportStoreAccessRefusal)(error)) {
+            const msg = error instanceof Error ? error.message : "Unknown error";
+            console.error("Symbols failed:", msg);
+            process.exitCode = 1;
+        }
     }
-    if (entries.length === 0) {
-        process.exitCode = 1;
+    finally {
+        yield (0, exit_1.gracefulExit)();
     }
-    yield (0, exit_1.gracefulExit)();
 }));

package/dist/commands/test-find.js

@@ -44,13 +44,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.testFind = void 0;
 const commander_1 = require("commander");
-const impact_1 = require("../lib/graph/impact");
+const graph_handler_1 = require("../lib/daemon/graph-handler");
 const test_hits_1 = require("../lib/graph/test-hits");
 const vector_db_1 = require("../lib/store/vector-db");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 const stale_hint_1 = require("../lib/utils/stale-hint");
+const store_access_1 = require("../lib/utils/store-access");
 exports.testFind = new commander_1.Command("test")
     .description("Find tests that exercise a symbol or file")
     .argument("<target>", "Symbol name or file path")
@@ -62,7 +63,8 @@ exports.testFind = new commander_1.Command("test")
     .action((target, opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const depth = Math.min(Math.max(Number.parseInt(opts.depth || "1", 10), 1), 3);
-    let vectorDb = null;
+    // Opened only if the daemon is unreachable; withStoreRead decides.
+    const local = { db: null };
     try {
         const root = (0, project_registry_1.resolveRootOrExit)(opts.root);
         if (root === null)
@@ -70,9 +72,31 @@ exports.testFind = new commander_1.Command("test")
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
         (0, stale_hint_1.maybeWarnStaleChunker)(projectRoot, { agent: opts.agent });
         (0, stale_hint_1.maybeWarnStaleEmbedding)(projectRoot, { agent: opts.agent });
-        const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
-        vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
-        const { symbols, resolvedAsFile, symbolFamilies } = yield (0, impact_1.resolveTargetSymbols)(target, vectorDb, projectRoot);
+        const localDb = () => {
+            var _a;
+            (_a = local.db) !== null && _a !== void 0 ? _a : (local.db = new vector_db_1.VectorDB((0, project_root_1.ensureProjectPaths)(projectRoot).lancedbDir));
+            return local.db;
+        };
+        const { resolveScope } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
+        const scope = resolveScope({
+            projectRoot,
+            in: opts.in,
+            exclude: opts.exclude,
+        });
+        const { symbols, resolvedAsFile, symbolFamilies } = yield (0, graph_handler_1.callGraphVerb)("graph.resolve", {
+            projectRoot,
+            scope,
+            payload: { target },
+            render: (resp) => {
+                var _a, _b;
+                return ({
+                    symbols: (_a = resp.symbols) !== null && _a !== void 0 ? _a : [],
+                    resolvedAsFile: resp.resolvedAsFile === true,
+                    symbolFamilies: (_b = resp.symbolFamilies) !== null && _b !== void 0 ? _b : null,
+                });
+            },
+            inProcess: () => (0, graph_handler_1.runGraphResolve)(localDb(), { target, projectRoot }),
+        });
         if (symbols.length === 0) {
             console.log(resolvedAsFile
                 ? `No symbols found in file: ${target}`
@@ -80,16 +104,22 @@ exports.testFind = new commander_1.Command("test")
             process.exitCode = 1;
             return;
         }
-        const { resolveScope } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
-        const scope = resolveScope({
-            projectRoot,
-            in: opts.in,
-            exclude: opts.exclude,
-        });
         const queryRoot = opts.in && opts.in.length > 0
             ? scope.pathPrefix.replace(/\/$/, "")
             : projectRoot;
-        const tests = yield (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes, symbolFamilies);
+        const tests = yield (0, graph_handler_1.callGraphVerb)("graph.tests", {
+            projectRoot,
+            scope,
+            payload: { symbols, depth, families: symbolFamilies },
+            render: (resp) => { var _a; return (_a = resp.hits) !== null && _a !== void 0 ? _a : []; },
+            inProcess: () => (0, graph_handler_1.runGraphTests)(localDb(), {
+                symbols,
+                queryRoot,
+                depth,
+                excludePrefixes: scope.excludePrefixes,
+                families: (0, graph_handler_1.decodeSymbolFamilies)(symbolFamilies),
+            }),
+        });
         if (tests.length === 0) {
             console.log(`No tests found for ${target}.`);
             return;
@@ -111,14 +141,18 @@ exports.testFind = new commander_1.Command("test")
         }
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : "Unknown error";
-        console.error("Test find failed:", msg);
-        process.exitCode = 1;
+        // A sandbox refusal is already one actionable line; a "Test find failed:"
+        // prefix would bury the settings key that fixes it.
+        if (!(0, store_access_1.reportStoreAccessRefusal)(error)) {
+            const msg = error instanceof Error ? error.message : "Unknown error";
+            console.error("Test find failed:", msg);
+            process.exitCode = 1;
+        }
     }
     finally {
-        if (vectorDb) {
+        if (local.db) {
             try {
-                yield vectorDb.close();
+                yield local.db.close();
             }
             catch (_b) { }
         }

package/dist/commands/trace.js

@@ -44,8 +44,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trace = void 0;
 const commander_1 = require("commander");
+const graph_handler_1 = require("../lib/daemon/graph-handler");
 const callsites_1 = require("../lib/graph/callsites");
-const graph_builder_1 = require("../lib/graph/graph-builder");
 const formatter_1 = require("../lib/output/formatter");
 const vector_db_1 = require("../lib/store/vector-db");
 const agent_errors_1 = require("../lib/utils/agent-errors");
@@ -53,6 +53,7 @@ const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 const stale_hint_1 = require("../lib/utils/stale-hint");
+const store_access_1 = require("../lib/utils/store-access");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const dim = (s) => (useColors ? `\x1b[2m${s}\x1b[22m` : s);
 const bold = (s) => (useColors ? `\x1b[1m${s}\x1b[22m` : s);
@@ -231,21 +232,31 @@ exports.trace = new commander_1.Command("trace")
     const root = (0, project_registry_1.resolveRootOrExit)(opts.root);
     if (root === null)
         return;
-    let vectorDb = null;
+    // Opened only if the daemon is unreachable; withStoreRead decides.
+    const local = { db: null };
     try {
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
         (0, stale_hint_1.maybeWarnStaleChunker)(projectRoot, { agent: opts.agent });
         (0, stale_hint_1.maybeWarnStaleEmbedding)(projectRoot, { agent: opts.agent });
-        const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
-        vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         const { resolveScope } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
         const scope = resolveScope({
             projectRoot,
             in: opts.in,
             exclude: opts.exclude,
         });
-        const graphBuilder = new graph_builder_1.GraphBuilder(vectorDb, scope.pathPrefix, scope.excludePrefixes);
-        const graph = yield graphBuilder.buildGraphMultiHop(symbol, depth);
+        // The daemon returns the graph; call-site snippets below are read from
+        // the working tree by this process, which can already see it.
+        const graph = yield (0, graph_handler_1.callGraphVerb)("graph.trace", {
+            projectRoot,
+            scope,
+            payload: { target: symbol, hops: depth },
+            render: (resp) => resp.graph,
+            inProcess: () => {
+                var _a;
+                (_a = local.db) !== null && _a !== void 0 ? _a : (local.db = new vector_db_1.VectorDB((0, project_root_1.ensureProjectPaths)(projectRoot).lancedbDir));
+                return (0, graph_handler_1.runGraphTrace)(local.db, { symbol, hops: depth, scope });
+            },
+        });
         if (opts.inbound) {
             if (!graph.center) {
                 console.log((0, agent_errors_1.symbolNotFoundLines)(symbol, { agent: opts.agent }).join("\n"));
@@ -275,14 +286,18 @@ exports.trace = new commander_1.Command("trace")
         }
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : "Unknown error";
-        console.error("Trace failed:", message);
-        process.exitCode = 1;
+        // A sandbox refusal is already one actionable line; a "Trace failed:"
+        // prefix would bury the settings key that fixes it.
+        if (!(0, store_access_1.reportStoreAccessRefusal)(error)) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            console.error("Trace failed:", message);
+            process.exitCode = 1;
+        }
     }
     finally {
-        if (vectorDb) {
+        if (local.db) {
             try {
-                yield vectorDb.close();
+                yield local.db.close();
             }
             catch (err) {
                 console.error("Failed to close VectorDB:", err);

package/dist/commands/watch.js

@@ -67,7 +67,7 @@ const IDLE_CHECK_INTERVAL_MS = 60 * 1000; // check every minute
 exports.watch = new commander_1.Command("watch")
     .description("Start background file watcher for live reindexing")
     .option("-b, --background", "Run watcher in background and exit")
-    .option("-d, --daemon", "Run as centralized daemon watching all projects")
+    .option("-d, --daemon", "Run as centralized daemon watching projects that active sessions hold")
     .option("-p, --path <dir>", "Directory to watch (defaults to project root)")
     .option("--no-idle-timeout", "Disable the 30-minute idle shutdown")
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {

package/dist/config.js

@@ -68,9 +68,14 @@ const DEFAULT_WORKER_THREADS = (() => {
     const fromEnv = Number.parseInt((_a = process.env.GMAX_WORKER_THREADS) !== null && _a !== void 0 ? _a : "", 10);
     if (Number.isFinite(fromEnv) && fromEnv > 0)
         return fromEnv;
+    // Each worker is a separate process that loads the ONNX models, peaking at
+    // ~800 MB-1 GB. The old max(4, cores/2) let a 14-core host run 7 of them;
+    // together with the daemon that froze a 48 GB machine. Four is the ceiling;
+    // two is the floor where the cores exist, so one worker can stay free for
+    // search. GMAX_WORKER_THREADS still overrides.
     const cores = os.cpus().length || 1;
-    const HARD_CAP = Math.max(4, Math.floor(cores * 0.5));
-    return Math.max(1, Math.min(HARD_CAP, cores));
+    const target = Math.min(4, Math.max(2, Math.floor(cores * 0.5)));
+    return Math.max(1, Math.min(target, cores));
 })();
 exports.CONFIG = {
     VECTOR_DIM: 384,
@@ -224,6 +229,7 @@ exports.PATHS = {
     daemonSocket: path.join(GLOBAL_ROOT, "daemon.sock"),
     daemonPidFile: path.join(GLOBAL_ROOT, "daemon.pid"),
     daemonLockFile: path.join(GLOBAL_ROOT, "daemon.lock"),
+    watchLeasesFile: path.join(GLOBAL_ROOT, "watch-leases.json"),
     // Written by a daemon while it is gracefully shutting down (draining workers,
     // closing LanceDB). A successor's killStaleProcesses() respects this so it
     // never SIGKILLs a peer mid-cleanup once the peer has already dropped its