grepmax 0.8.0 → 0.8.2

package/dist/commands/add.js

@@ -43,10 +43,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.add = void 0;
-const node_child_process_1 = require("node:child_process");
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const grammar_loader_1 = require("../lib/index/grammar-loader");
+const index_config_1 = require("../lib/index/index-config");
 const sync_helpers_1 = require("../lib/index/sync-helpers");
 const syncer_1 = require("../lib/index/syncer");
 const setup_helpers_1 = require("../lib/setup/setup-helpers");
@@ -55,7 +55,7 @@ const exit_1 = require("../lib/utils/exit");
 const project_marker_1 = require("../lib/utils/project-marker");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
-const index_config_1 = require("../lib/index/index-config");
+const watcher_launcher_1 = require("../lib/utils/watcher-launcher");
 exports.add = new commander_1.Command("add")
     .description("Add a project to the gmax index")
     .argument("[dir]", "Directory to add (defaults to current directory)")
@@ -75,11 +75,27 @@ Examples:
         const projectName = path.basename(projectRoot);
         // Check if already registered
         const existing = (0, project_registry_1.getProject)(projectRoot);
-        if (existing || (0, project_marker_1.hasMarker)(projectRoot)) {
-            console.log(`${projectName} is already added (${(_b = existing === null || existing === void 0 ? void 0 : existing.chunkCount) !== null && _b !== void 0 ? _b : 0} chunks).`);
+        if (existing) {
+            console.log(`${projectName} is already added (${(_b = existing.chunkCount) !== null && _b !== void 0 ? _b : 0} chunks).`);
             console.log(`Run \`gmax index\` to re-index, or \`gmax index --reset\` for a full rebuild.`);
             return;
         }
+        // Check if a parent project already covers this path
+        const parent = (0, project_registry_1.getParentProject)(projectRoot);
+        if (parent) {
+            console.log(`Already covered by ${path.basename(parent.root)} (${parent.root}).`);
+            console.log(`Use \`gmax status\` to see indexed projects.`);
+            return;
+        }
+        // If this is a parent of existing projects, absorb them
+        const children = (0, project_registry_1.getChildProjects)(projectRoot);
+        if (children.length > 0) {
+            const names = children.map((c) => c.name).join(", ");
+            console.log(`Absorbing ${children.length} sub-project(s): ${names}`);
+            for (const child of children) {
+                (0, project_registry_1.removeProject)(child.root);
+            }
+        }
         // Create marker file
         (0, project_marker_1.createMarker)(projectRoot);
         // Register as pending
@@ -109,11 +125,21 @@ Examples:
                 projectRoot,
                 onProgress,
             });
+            // Update registry: pending → indexed
+            (0, project_registry_1.registerProject)({
+                root: projectRoot,
+                name: projectName,
+                vectorDim: globalConfig.vectorDim,
+                modelTier: globalConfig.modelTier,
+                embedMode: globalConfig.embedMode,
+                lastIndexed: new Date().toISOString(),
+                chunkCount: result.indexed,
+                status: "indexed",
+            });
             const failedSuffix = result.failedFiles > 0 ? ` · ${result.failedFiles} failed` : "";
             spinner.succeed(`Added ${projectName} (${result.total} files, ${result.indexed} chunks${failedSuffix})`);
         }
         catch (e) {
-            // Update status to error
             (0, project_registry_1.registerProject)({
                 root: projectRoot,
                 name: projectName,
@@ -127,14 +153,13 @@ Examples:
             spinner.fail(`Failed to index ${projectName}`);
             throw e;
         }
-        // Start watcher in background
-        try {
-            const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], "watch", "--path", projectRoot], { detached: true, stdio: "ignore" });
-            child.unref();
-            console.log(`Watcher started (PID: ${child.pid})`);
+        // Start watcher
+        const launched = (0, watcher_launcher_1.launchWatcher)(projectRoot);
+        if (launched.ok) {
+            console.log(`Watcher started (PID: ${launched.pid})`);
         }
-        catch (_c) {
-            console.log(`Note: could not start watcher. Run: gmax watch --path ${projectRoot} -b`);
+        else if (launched.reason === "spawn-failed") {
+            console.warn(`[add] ${launched.message}`);
         }
     }
     catch (error) {
@@ -147,7 +172,7 @@ Examples:
             try {
                 yield vectorDb.close();
             }
-            catch (_d) { }
+            catch (_c) { }
         }
         yield (0, exit_1.gracefulExit)();
     }

package/dist/commands/droid.js

@@ -130,7 +130,10 @@ function installPlugin() {
         const startScript = `
 const { spawn } = require("child_process");
 const fs = require("fs");
-const out = fs.openSync("/tmp/gmax.log", "a");
+const path = require("path");
+const logDir = path.join(require("os").homedir(), ".gmax", "logs");
+fs.mkdirSync(logDir, { recursive: true });
+const out = fs.openSync(path.join(logDir, "gmax.log"), "a");
 const child = spawn("gmax", ["serve"], { detached: true, stdio: ["ignore", out, out] });
 child.unref();
 `;

package/dist/commands/index.js

@@ -43,17 +43,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.index = void 0;
-const node_child_process_1 = require("node:child_process");
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
+const index_config_1 = require("../lib/index/index-config");
 const grammar_loader_1 = require("../lib/index/grammar-loader");
 const sync_helpers_1 = require("../lib/index/sync-helpers");
 const syncer_1 = require("../lib/index/syncer");
 const setup_helpers_1 = require("../lib/setup/setup-helpers");
 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 watcher_registry_1 = require("../lib/utils/watcher-registry");
+const watcher_launcher_1 = require("../lib/utils/watcher-launcher");
+const watcher_store_1 = require("../lib/utils/watcher-store");
 exports.index = new commander_1.Command("index")
     .description("Index the current directory and create searchable store")
     .option("-d, --dry-run", "Dry run the indexing process (no actual file syncing)", false)
@@ -87,6 +89,12 @@ Examples:
             ? path.resolve(options.path)
             : process.cwd();
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(indexRoot)) !== null && _a !== void 0 ? _a : indexRoot;
+        // Project must be registered before reindexing
+        if (!(0, project_registry_1.getProject)(projectRoot)) {
+            console.error(`This project hasn't been added yet.\n\nRun: gmax add ${projectRoot}\n`);
+            process.exitCode = 1;
+            return;
+        }
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         if (options.reset) {
@@ -97,7 +105,7 @@ Examples:
         // Ensure grammars are present before indexing (silent if already exist)
         yield (0, grammar_loader_1.ensureGrammars)(console.log, { silent: true });
         // Stop any watcher that covers this project — it holds the shared lock
-        const watcher = (0, watcher_registry_1.getWatcherCoveringPath)(projectRoot);
+        const watcher = (0, watcher_store_1.getWatcherCoveringPath)(projectRoot);
         let restartWatcher = null;
         if (watcher) {
             console.log(`Stopping watcher (PID: ${watcher.pid}) for ${path.basename(watcher.projectRoot)}...`);
@@ -107,11 +115,11 @@ Examples:
             catch (_b) { }
             // Wait for process to exit (up to 5s)
             for (let i = 0; i < 50; i++) {
-                if (!(0, watcher_registry_1.isProcessRunning)(watcher.pid))
+                if (!(0, watcher_store_1.isProcessRunning)(watcher.pid))
                     break;
                 yield new Promise((r) => setTimeout(r, 100));
             }
-            (0, watcher_registry_1.unregisterWatcher)(watcher.pid);
+            (0, watcher_store_1.unregisterWatcher)(watcher.pid);
             restartWatcher = {
                 pid: watcher.pid,
                 projectRoot: watcher.projectRoot,
@@ -138,6 +146,18 @@ Examples:
                 }));
                 return;
             }
+            // Update registry with new stats
+            const globalConfig = (0, index_config_1.readGlobalConfig)();
+            (0, project_registry_1.registerProject)({
+                root: projectRoot,
+                name: path.basename(projectRoot),
+                vectorDim: globalConfig.vectorDim,
+                modelTier: globalConfig.modelTier,
+                embedMode: globalConfig.embedMode,
+                lastIndexed: new Date().toISOString(),
+                chunkCount: result.indexed,
+                status: "indexed",
+            });
             const failedSuffix = result.failedFiles > 0 ? ` • ${result.failedFiles} failed` : "";
             spinner.succeed(`Indexing complete(${result.processed} / ${result.total}) • indexed ${result.indexed}${failedSuffix} `);
         }
@@ -148,13 +168,12 @@ Examples:
         finally {
             // Restart the watcher if we stopped one
             if (restartWatcher) {
-                try {
-                    const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], "watch", "--path", restartWatcher.projectRoot], { detached: true, stdio: "ignore" });
-                    child.unref();
-                    console.log(`Restarted watcher for ${path.basename(restartWatcher.projectRoot)} (PID: ${child.pid})`);
+                const launched = (0, watcher_launcher_1.launchWatcher)(restartWatcher.projectRoot);
+                if (launched.ok) {
+                    console.log(`Restarted watcher for ${path.basename(restartWatcher.projectRoot)} (PID: ${launched.pid})`);
                 }
-                catch (_c) {
-                    console.log(`Note: could not restart watcher. Run: gmax watch --path ${restartWatcher.projectRoot} -b`);
+                else if (launched.reason === "spawn-failed") {
+                    console.warn(`[index] ${launched.message}`);
                 }
             }
         }

package/dist/commands/mcp.js

@@ -77,7 +77,8 @@ const format_helpers_1 = require("../lib/utils/format-helpers");
 const import_extractor_1 = require("../lib/utils/import-extractor");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
-const watcher_registry_1 = require("../lib/utils/watcher-registry");
+const watcher_launcher_1 = require("../lib/utils/watcher-launcher");
+const watcher_store_1 = require("../lib/utils/watcher-store");
 // ---------------------------------------------------------------------------
 // Tool definitions
 // ---------------------------------------------------------------------------
@@ -331,8 +332,8 @@ exports.mcp = new commander_1.Command("mcp")
                 return;
             _indexing = true;
             _indexProgress = "starting...";
-            console.log("[MCP] First-time index for this project...");
-            const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], "index", "--path", projectRoot], { detached: true, stdio: "ignore" });
+            console.log("[MCP] First-time setup for this project...");
+            const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], "add", projectRoot], { detached: true, stdio: "ignore" });
             _indexChildPid = (_a = child.pid) !== null && _a !== void 0 ? _a : null;
             child.unref();
             _indexProgress = `PID ${_indexChildPid}`;
@@ -342,7 +343,7 @@ exports.mcp = new commander_1.Command("mcp")
                 _indexChildPid = null;
                 if (code === 0) {
                     _indexReady = true;
-                    console.log("[MCP] First-time indexing complete.");
+                    console.log("[MCP] First-time setup complete.");
                 }
                 else {
                     console.error(`[MCP] Indexing failed (exit code: ${code})`);
@@ -352,14 +353,10 @@ exports.mcp = new commander_1.Command("mcp")
     }
     // --- Background watcher ---
     function ensureWatcher() {
-        if ((0, watcher_registry_1.getWatcherCoveringPath)(projectRoot))
-            return;
-        const child = (0, node_child_process_1.spawn)("gmax", ["watch", "-b", "--path", projectRoot], {
-            detached: true,
-            stdio: "ignore",
-        });
-        child.unref();
-        console.log(`[MCP] Started background watcher for ${projectRoot}`);
+        const result = (0, watcher_launcher_1.launchWatcher)(projectRoot);
+        if (result.ok && !result.reused) {
+            console.log(`[MCP] Started background watcher for ${projectRoot} (PID: ${result.pid})`);
+        }
     }
     // --- Tool handlers ---
     function handleSemanticSearch(args_1) {
@@ -611,6 +608,7 @@ exports.mcp = new commander_1.Command("mcp")
     }
     function handleCodeSkeleton(args) {
         return __awaiter(this, void 0, void 0, function* () {
+            ensureWatcher();
             const target = String(args.target || "");
             if (!target)
                 return err("Missing required parameter: target");
@@ -725,6 +723,7 @@ exports.mcp = new commander_1.Command("mcp")
     }
     function handleTraceCalls(args) {
         return __awaiter(this, void 0, void 0, function* () {
+            ensureWatcher();
             const symbol = String(args.symbol || "");
             if (!symbol)
                 return err("Missing required parameter: symbol");
@@ -806,6 +805,7 @@ exports.mcp = new commander_1.Command("mcp")
     }
     function handleListSymbols(args) {
         return __awaiter(this, void 0, void 0, function* () {
+            ensureWatcher();
             const pattern = typeof args.pattern === "string" ? args.pattern : undefined;
             const limit = Math.min(Math.max(Number(args.limit) || 20, 1), 100);
             const pathPrefix = typeof args.path === "string" ? args.path : undefined;
@@ -892,7 +892,7 @@ exports.mcp = new commander_1.Command("mcp")
                 const stats = yield db.getStats();
                 const fileCount = yield db.getDistinctFileCount();
                 // Watcher status
-                const watcher = (0, watcher_registry_1.getWatcherCoveringPath)(projectRoot);
+                const watcher = (0, watcher_store_1.getWatcherCoveringPath)(projectRoot);
                 let watcherLine = "Watcher: not running";
                 if (watcher) {
                     const status = (_a = watcher.status) !== null && _a !== void 0 ? _a : "unknown";
@@ -1096,6 +1096,7 @@ exports.mcp = new commander_1.Command("mcp")
     }
     function handleRelatedFiles(args) {
         return __awaiter(this, void 0, void 0, function* () {
+            ensureWatcher();
             const file = String(args.file || "");
             if (!file)
                 return err("Missing required parameter: file");
@@ -1198,6 +1199,7 @@ exports.mcp = new commander_1.Command("mcp")
     function handleRecentChanges(args) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, e_1, _b, _c;
+            ensureWatcher();
             const limit = Math.min(Math.max(Number(args.limit) || 20, 1), 50);
             const root = typeof args.root === "string"
                 ? path.resolve(args.root)

package/dist/commands/remove.js

@@ -49,10 +49,11 @@ const commander_1 = require("commander");
 const meta_cache_1 = require("../lib/store/meta-cache");
 const vector_db_1 = require("../lib/store/vector-db");
 const exit_1 = require("../lib/utils/exit");
+const process_1 = require("../lib/utils/process");
 const project_marker_1 = require("../lib/utils/project-marker");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
-const watcher_registry_1 = require("../lib/utils/watcher-registry");
+const watcher_store_1 = require("../lib/utils/watcher-store");
 function confirm(message) {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -99,19 +100,11 @@ Examples:
             }
         }
         // Stop any watcher
-        const watcher = (0, watcher_registry_1.getWatcherForProject)(projectRoot);
+        const watcher = (0, watcher_store_1.getWatcherForProject)(projectRoot);
         if (watcher) {
             console.log(`Stopping watcher (PID: ${watcher.pid})...`);
-            try {
-                process.kill(watcher.pid, "SIGTERM");
-            }
-            catch (_b) { }
-            for (let i = 0; i < 50; i++) {
-                if (!(0, watcher_registry_1.isProcessRunning)(watcher.pid))
-                    break;
-                yield new Promise((r) => setTimeout(r, 100));
-            }
-            (0, watcher_registry_1.unregisterWatcher)(watcher.pid);
+            yield (0, process_1.killProcess)(watcher.pid);
+            (0, watcher_store_1.unregisterWatcher)(watcher.pid);
         }
         // Delete vectors from LanceDB
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
@@ -139,13 +132,13 @@ Examples:
             try {
                 metaCache.close();
             }
-            catch (_c) { }
+            catch (_b) { }
         }
         if (vectorDb) {
             try {
                 yield vectorDb.close();
             }
-            catch (_d) { }
+            catch (_c) { }
         }
         yield (0, exit_1.gracefulExit)();
     }

package/dist/commands/search.js

@@ -452,20 +452,18 @@ Examples:
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         // Propagate project root to worker processes
         process.env.GMAX_PROJECT_ROOT = projectRoot;
-        // Check if project is registered (skip for --sync which auto-indexes)
-        if (!options.sync) {
-            const checkRoot = options.root
-                ? (_c = (0, project_root_1.findProjectRoot)(path.resolve(options.root))) !== null && _c !== void 0 ? _c : path.resolve(options.root)
-                : projectRoot;
-            const project = (0, project_registry_1.getProject)(checkRoot);
-            if (!project) {
-                console.error(`This project hasn't been added to gmax yet.\n\nRun: gmax add ${checkRoot}\n`);
-                process.exitCode = 1;
-                return;
-            }
-            if (project.status === "pending") {
-                console.warn("This project is still being indexed. Results may be incomplete.\n");
-            }
+        // Check if project is registered
+        const checkRoot = options.root
+            ? (_c = (0, project_root_1.findProjectRoot)(path.resolve(options.root))) !== null && _c !== void 0 ? _c : path.resolve(options.root)
+            : projectRoot;
+        const project = (0, project_registry_1.getProject)(checkRoot);
+        if (!project) {
+            console.error(`This project hasn't been added to gmax yet.\n\nRun: gmax add ${checkRoot}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        if (project.status === "pending") {
+            console.warn("This project is still being indexed. Results may be incomplete.\n");
         }
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         // Check for active indexing lock and warn if present
@@ -506,6 +504,20 @@ Examples:
                     return;
                 }
                 yield vectorDb.createFTSIndex();
+                // Update registry after sync
+                const { readGlobalConfig } = yield Promise.resolve().then(() => __importStar(require("../lib/index/index-config")));
+                const { registerProject } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/project-registry")));
+                const gc = readGlobalConfig();
+                registerProject({
+                    root: projectRoot,
+                    name: path.basename(projectRoot),
+                    vectorDim: gc.vectorDim,
+                    modelTier: gc.modelTier,
+                    embedMode: gc.embedMode,
+                    lastIndexed: new Date().toISOString(),
+                    chunkCount: result.indexed,
+                    status: "indexed",
+                });
                 const failedSuffix = result.failedFiles > 0 ? ` • ${result.failedFiles} failed` : "";
                 spinner.succeed(`${options.sync ? "Indexing" : "Initial indexing"} complete (${result.processed}/${result.total}) • indexed ${result.indexed}${failedSuffix}`);
             }
@@ -516,15 +528,10 @@ Examples:
         }
         // Ensure a watcher is running for live reindexing
         if (!process.env.VITEST && !((_d = process.env.NODE_ENV) === null || _d === void 0 ? void 0 : _d.includes("test"))) {
-            try {
-                const { execFileSync } = yield Promise.resolve().then(() => __importStar(require("node:child_process")));
-                execFileSync("gmax", ["watch", "-b", "--path", projectRoot], {
-                    timeout: 5000,
-                    stdio: "ignore",
-                });
-            }
-            catch (_v) {
-                // Watcher may already be running — ignore
+            const { launchWatcher } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/watcher-launcher")));
+            const launched = launchWatcher(projectRoot);
+            if (!launched.ok && launched.reason === "spawn-failed") {
+                console.warn(`[search] ${launched.message}`);
             }
         }
         const searcher = new searcher_1.Searcher(vectorDb);
@@ -566,7 +573,7 @@ Examples:
                     return defs.some((d) => regex.test(d));
                 });
             }
-            catch (_w) {
+            catch (_v) {
                 // Invalid regex — skip
             }
         }
@@ -670,7 +677,7 @@ Examples:
                         }
                     }
                 }
-                catch (_x) { }
+                catch (_w) { }
             }
             return;
         }
@@ -772,7 +779,7 @@ Examples:
                     console.log(lines.join("\n"));
                 }
             }
-            catch (_y) {
+            catch (_x) {
                 // Trace failed — skip silently
             }
         }

package/dist/commands/serve.js

@@ -59,6 +59,7 @@ const setup_helpers_1 = require("../lib/setup/setup-helpers");
 const meta_cache_1 = require("../lib/store/meta-cache");
 const vector_db_1 = require("../lib/store/vector-db");
 const exit_1 = require("../lib/utils/exit");
+const log_rotate_1 = require("../lib/utils/log-rotate");
 const project_root_1 = require("../lib/utils/project-root");
 const server_registry_1 = require("../lib/utils/server-registry");
 function isMlxServerUp() {
@@ -84,8 +85,7 @@ function startMlxServer(mlxModel) {
     const serverDir = candidates.find((d) => fs.existsSync(path.join(d, "server.py")));
     if (!serverDir)
         return null;
-    const logPath = "/tmp/mlx-embed-server.log";
-    const out = fs.openSync(logPath, "a");
+    const out = (0, log_rotate_1.openRotatedLog)(path.join(config_1.PATHS.logsDir, "mlx-embed-server.log"));
     const env = Object.assign({}, process.env);
     if (mlxModel) {
         env.MLX_EMBED_MODEL = mlxModel;
@@ -121,14 +121,12 @@ exports.serve = new commander_1.Command("serve")
         const args = process.argv
             .slice(2)
             .filter((arg) => arg !== "-b" && arg !== "--background");
-        const logDir = path.join(config_1.PATHS.globalRoot, "logs");
-        fs.mkdirSync(logDir, { recursive: true });
         const safeName = path
             .basename(projectRoot)
             .replace(/[^a-zA-Z0-9._-]/g, "_");
-        const logFile = path.join(logDir, `server-${safeName}.log`);
-        const out = fs.openSync(logFile, "a");
-        const err = fs.openSync(logFile, "a");
+        const logFile = path.join(config_1.PATHS.logsDir, `server-${safeName}.log`);
+        const out = (0, log_rotate_1.openRotatedLog)(logFile);
+        const err = (0, log_rotate_1.openRotatedLog)(logFile);
         const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], ...args], {
             detached: true,
             stdio: ["ignore", out, err],

package/dist/commands/status.js

@@ -50,7 +50,7 @@ const exit_1 = require("../lib/utils/exit");
 const lock_1 = require("../lib/utils/lock");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
-const watcher_registry_1 = require("../lib/utils/watcher-registry");
+const watcher_store_1 = require("../lib/utils/watcher-store");
 const config_1 = require("../config");
 const style = {
     bold: (s) => `\x1b[1m${s}\x1b[22m`,
@@ -99,7 +99,7 @@ Examples:
     var _a;
     const globalConfig = (0, index_config_1.readGlobalConfig)();
     const projects = (0, project_registry_1.listProjects)();
-    (0, watcher_registry_1.listWatchers)(); // cleans stale entries as side effect
+    (0, watcher_store_1.listWatchers)(); // cleans stale entries as side effect
     const indexing = (0, lock_1.isLocked)(config_1.PATHS.globalRoot);
     const currentRoot = (0, project_root_1.findProjectRoot)(process.cwd());
     // Header
@@ -114,7 +114,7 @@ Examples:
     console.log();
     for (const project of projects) {
         const isCurrent = project.root === currentRoot;
-        const watcher = (0, watcher_registry_1.getWatcherForProject)(project.root);
+        const watcher = (0, watcher_store_1.getWatcherForProject)(project.root);
         // Status column
         let statusStr;
         const projectStatus = (_a = project.status) !== null && _a !== void 0 ? _a : "indexed";

package/dist/commands/watch.js

@@ -44,21 +44,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.watch = void 0;
 const node_child_process_1 = require("node:child_process");
-const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const config_1 = require("../config");
+const index_config_1 = require("../lib/index/index-config");
 const filter_builder_1 = require("../lib/utils/filter-builder");
 const syncer_1 = require("../lib/index/syncer");
 const watcher_1 = require("../lib/index/watcher");
 const meta_cache_1 = require("../lib/store/meta-cache");
 const vector_db_1 = require("../lib/store/vector-db");
 const exit_1 = require("../lib/utils/exit");
+const log_rotate_1 = require("../lib/utils/log-rotate");
+const process_1 = require("../lib/utils/process");
+const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
-const watcher_registry_1 = require("../lib/utils/watcher-registry");
+const watcher_store_1 = require("../lib/utils/watcher-store");
 const IDLE_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
 const IDLE_CHECK_INTERVAL_MS = 60 * 1000; // check every minute
-const MAX_LOG_BYTES = 5 * 1024 * 1024; // 5 MB — rotate log when exceeded
 exports.watch = new commander_1.Command("watch")
     .description("Start background file watcher for live reindexing")
     .option("-b, --background", "Run watcher in background and exit")
@@ -71,8 +73,8 @@ exports.watch = new commander_1.Command("watch")
         : (_a = (0, project_root_1.findProjectRoot)(process.cwd())) !== null && _a !== void 0 ? _a : process.cwd();
     const projectName = path.basename(projectRoot);
     // Check if watcher already running (exact match or parent covering this dir)
-    const existing = (_b = (0, watcher_registry_1.getWatcherForProject)(projectRoot)) !== null && _b !== void 0 ? _b : (0, watcher_registry_1.getWatcherCoveringPath)(projectRoot);
-    if (existing && (0, watcher_registry_1.isProcessRunning)(existing.pid)) {
+    const existing = (_b = (0, watcher_store_1.getWatcherForProject)(projectRoot)) !== null && _b !== void 0 ? _b : (0, watcher_store_1.getWatcherCoveringPath)(projectRoot);
+    if (existing && (0, watcher_store_1.isProcessRunning)(existing.pid)) {
         console.log(`Watcher already running for ${path.basename(existing.projectRoot)} (PID: ${existing.pid})`);
         return;
     }
@@ -81,20 +83,9 @@ exports.watch = new commander_1.Command("watch")
         const args = process.argv
             .slice(2)
             .filter((arg) => arg !== "-b" && arg !== "--background");
-        const logDir = path.join(config_1.PATHS.globalRoot, "logs");
-        fs.mkdirSync(logDir, { recursive: true });
         const safeName = projectName.replace(/[^a-zA-Z0-9._-]/g, "_");
-        const logFile = path.join(logDir, `watch-${safeName}.log`);
-        // Rotate log if it exceeds MAX_LOG_BYTES
-        try {
-            const logStat = fs.statSync(logFile);
-            if (logStat.size > MAX_LOG_BYTES) {
-                const prev = `${logFile}.prev`;
-                fs.renameSync(logFile, prev);
-            }
-        }
-        catch (_c) { }
-        const out = fs.openSync(logFile, "a");
+        const logFile = path.join(config_1.PATHS.logsDir, `watch-${safeName}.log`);
+        const out = (0, log_rotate_1.openRotatedLog)(logFile);
         const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], ...args], {
             detached: true,
             stdio: ["ignore", out, out],
@@ -106,12 +97,20 @@ exports.watch = new commander_1.Command("watch")
         process.exit(0);
     }
     // --- Foreground mode ---
+    // Migrate legacy watchers.json to LMDB on first use
+    (0, watcher_store_1.migrateFromJson)();
+    // Watcher requires project to be registered
+    if (!(0, project_registry_1.getProject)(projectRoot)) {
+        console.error(`[watch:${projectName}] Project not registered. Run: gmax add ${projectRoot}`);
+        process.exitCode = 1;
+        return;
+    }
     const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
     // Propagate project root to worker processes
     process.env.GMAX_PROJECT_ROOT = paths.root;
     console.log(`[watch:${projectName}] Starting...`);
     // Register early so MCP can see status
-    (0, watcher_registry_1.registerWatcher)({
+    (0, watcher_store_1.registerWatcher)({
         pid: process.pid,
         projectRoot,
         startTime: Date.now(),
@@ -129,10 +128,22 @@ exports.watch = new commander_1.Command("watch")
         .toArray();
     if (indexed.length === 0) {
         console.log(`[watch:${projectName}] No index found for ${projectRoot}, running initial sync...`);
-        yield (0, syncer_1.initialSync)({ projectRoot });
+        const syncResult = yield (0, syncer_1.initialSync)({ projectRoot });
+        // Update registry after sync
+        const globalConfig = (0, index_config_1.readGlobalConfig)();
+        (0, project_registry_1.registerProject)({
+            root: projectRoot,
+            name: projectName,
+            vectorDim: globalConfig.vectorDim,
+            modelTier: globalConfig.modelTier,
+            embedMode: globalConfig.embedMode,
+            lastIndexed: new Date().toISOString(),
+            chunkCount: syncResult.indexed,
+            status: "indexed",
+        });
         console.log(`[watch:${projectName}] Initial sync complete.`);
     }
-    (0, watcher_registry_1.updateWatcherStatus)(process.pid, "watching");
+    (0, watcher_store_1.updateWatcherStatus)(process.pid, "watching");
     // Open resources for watcher
     const metaCache = new meta_cache_1.MetaCache(paths.lmdbPath);
     // Start watching
@@ -144,10 +155,14 @@ exports.watch = new commander_1.Command("watch")
         onReindex: (files, ms) => {
             console.log(`[watch:${projectName}] Reindexed ${files} file${files !== 1 ? "s" : ""} (${(ms / 1000).toFixed(1)}s)`);
             lastActivity = Date.now();
-            (0, watcher_registry_1.updateWatcherStatus)(process.pid, "watching", Date.now());
+            (0, watcher_store_1.updateWatcherStatus)(process.pid, "watching", Date.now());
         },
     });
     console.log(`[watch:${projectName}] File watcher active`);
+    // Heartbeat — update LMDB every 60s so other processes can detect liveliness
+    const heartbeatInterval = setInterval(() => {
+        (0, watcher_store_1.heartbeat)(process.pid);
+    }, IDLE_CHECK_INTERVAL_MS);
     // Idle timeout
     let lastActivity = Date.now();
     if (options.idleTimeout !== false) {
@@ -161,13 +176,14 @@ exports.watch = new commander_1.Command("watch")
     // Graceful shutdown
     function shutdown() {
         return __awaiter(this, void 0, void 0, function* () {
+            clearInterval(heartbeatInterval);
             try {
                 yield watcher.close();
             }
             catch (_a) { }
             yield metaCache.close();
             yield vectorDb.close();
-            (0, watcher_registry_1.unregisterWatcher)(process.pid);
+            (0, watcher_store_1.unregisterWatcher)(process.pid);
             yield (0, exit_1.gracefulExit)();
         });
     }
@@ -179,7 +195,7 @@ exports.watch
     .command("status")
     .description("Show running watchers")
     .action(() => __awaiter(void 0, void 0, void 0, function* () {
-    const watchers = (0, watcher_registry_1.listWatchers)();
+    const watchers = (0, watcher_store_1.listWatchers)();
     if (watchers.length === 0) {
         console.log("No running watchers.");
         yield (0, exit_1.gracefulExit)();
@@ -199,33 +215,32 @@ exports.watch
     .action((options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     if (options.all) {
-        const watchers = (0, watcher_registry_1.listWatchers)();
+        const watchers = (0, watcher_store_1.listWatchers)();
         for (const w of watchers) {
-            try {
-                process.kill(w.pid, "SIGTERM");
-                (0, watcher_registry_1.unregisterWatcher)(w.pid);
+            const killed = yield (0, process_1.killProcess)(w.pid);
+            (0, watcher_store_1.unregisterWatcher)(w.pid);
+            if (!killed) {
+                console.warn(`Warning: PID ${w.pid} did not exit after SIGKILL`);
             }
-            catch (_b) { }
         }
         console.log(`Stopped ${watchers.length} watcher(s).`);
         yield (0, exit_1.gracefulExit)();
         return;
     }
     const projectRoot = (_a = (0, project_root_1.findProjectRoot)(process.cwd())) !== null && _a !== void 0 ? _a : process.cwd();
-    const watcher = (0, watcher_registry_1.getWatcherForProject)(projectRoot);
+    const watcher = (0, watcher_store_1.getWatcherForProject)(projectRoot);
     if (!watcher) {
         console.log("No watcher running for this project.");
         yield (0, exit_1.gracefulExit)();
         return;
     }
-    try {
-        process.kill(watcher.pid, "SIGTERM");
-        (0, watcher_registry_1.unregisterWatcher)(watcher.pid);
+    const killed = yield (0, process_1.killProcess)(watcher.pid);
+    (0, watcher_store_1.unregisterWatcher)(watcher.pid);
+    if (killed) {
         console.log(`Stopped watcher (PID: ${watcher.pid})`);
     }
-    catch (_c) {
-        console.log("Watcher process not found.");
-        (0, watcher_registry_1.unregisterWatcher)(watcher.pid);
+    else {
+        console.warn(`Warning: watcher PID ${watcher.pid} did not exit`);
     }
     yield (0, exit_1.gracefulExit)();
 }));

package/dist/config.js

@@ -93,6 +93,7 @@ exports.PATHS = {
     globalRoot: GLOBAL_ROOT,
     models: path.join(GLOBAL_ROOT, "models"),
     grammars: path.join(GLOBAL_ROOT, "grammars"),
+    logsDir: path.join(GLOBAL_ROOT, "logs"),
     // Centralized index storage — one database for all indexed directories
     lancedbDir: path.join(GLOBAL_ROOT, "lancedb"),
     cacheDir: path.join(GLOBAL_ROOT, "cache"),

package/dist/lib/index/syncer.js

@@ -61,7 +61,6 @@ const vector_db_1 = require("../store/vector-db");
 const filter_builder_1 = require("../utils/filter-builder");
 // isIndexableFile no longer used — extension check inlined for performance
 const lock_1 = require("../utils/lock");
-const project_registry_1 = require("../utils/project-registry");
 const project_root_1 = require("../utils/project-root");
 const pool_1 = require("../workers/pool");
 const index_config_1 = require("./index-config");
@@ -507,18 +506,6 @@ function initialSync(options) {
             // Write model config so future runs can detect model changes
             if (!dryRun) {
                 (0, index_config_1.writeIndexConfig)(paths.configPath);
-                // Register project in global registry
-                const globalConfig = (0, index_config_1.readGlobalConfig)();
-                (0, project_registry_1.registerProject)({
-                    root: paths.root,
-                    name: path.basename(paths.root),
-                    vectorDim: globalConfig.vectorDim,
-                    modelTier: globalConfig.modelTier,
-                    embedMode: globalConfig.embedMode,
-                    lastIndexed: new Date().toISOString(),
-                    chunkCount: indexed,
-                    status: "indexed",
-                });
             }
             // Finalize total so callers can display a meaningful summary.
             total = processed;

package/dist/lib/index/watcher.js

@@ -136,9 +136,11 @@ function startWatcher(opts) {
                 const vectors = [];
                 const metaUpdates = new Map();
                 const metaDeletes = [];
+                const attempted = new Set();
                 for (const [absPath, event] of batch) {
                     if (batchAc.signal.aborted)
                         break;
+                    attempted.add(absPath);
                     if (event === "unlink") {
                         deletes.push(absPath);
                         metaDeletes.push(absPath);
@@ -200,6 +202,12 @@ function startWatcher(opts) {
                         }
                     }
                 }
+                // Requeue files that weren't attempted (aborted or pool unhealthy)
+                for (const [absPath, event] of batch) {
+                    if (!attempted.has(absPath) && !pending.has(absPath)) {
+                        pending.set(absPath, event);
+                    }
+                }
                 // Flush to VectorDB: insert first, then delete old (preserving new)
                 const newIds = vectors.map((v) => v.id);
                 if (vectors.length > 0) {

package/dist/lib/utils/log-rotate.js

@@ -0,0 +1,55 @@
+"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.openRotatedLog = openRotatedLog;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const MAX_LOG_BYTES = 5 * 1024 * 1024; // 5 MB
+/**
+ * Open a log file with rotation. Creates parent directories if needed.
+ * Rotates {name}.log -> {name}.log.prev when size exceeds maxBytes.
+ * Returns an fd suitable for stdio redirection.
+ */
+function openRotatedLog(logPath, maxBytes = MAX_LOG_BYTES) {
+    fs.mkdirSync(path.dirname(logPath), { recursive: true });
+    try {
+        const stat = fs.statSync(logPath);
+        if (stat.size > maxBytes) {
+            fs.renameSync(logPath, `${logPath}.prev`);
+        }
+    }
+    catch (_a) { }
+    return fs.openSync(logPath, "a");
+}

package/dist/lib/utils/process.js

@@ -0,0 +1,45 @@
+"use strict";
+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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.killProcess = killProcess;
+const watcher_store_1 = require("./watcher-store");
+/**
+ * Send SIGTERM, wait up to 3s, then SIGKILL if still alive.
+ * Returns true if process is confirmed dead.
+ */
+function killProcess(pid) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch (_a) {
+            return false;
+        }
+        // Poll up to 3s for graceful exit
+        for (let i = 0; i < 30; i++) {
+            if (!(0, watcher_store_1.isProcessRunning)(pid))
+                return true;
+            yield new Promise((r) => setTimeout(r, 100));
+        }
+        // Force kill
+        try {
+            process.kill(pid, "SIGKILL");
+        }
+        catch (_b) { }
+        // Give SIGKILL a moment
+        for (let i = 0; i < 10; i++) {
+            if (!(0, watcher_store_1.isProcessRunning)(pid))
+                return true;
+            yield new Promise((r) => setTimeout(r, 100));
+        }
+        return !(0, watcher_store_1.isProcessRunning)(pid);
+    });
+}

package/dist/lib/utils/project-registry.js

@@ -43,6 +43,8 @@ exports.registerProject = registerProject;
 exports.listProjects = listProjects;
 exports.getProject = getProject;
 exports.removeProject = removeProject;
+exports.getParentProject = getParentProject;
+exports.getChildProjects = getChildProjects;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const config_1 = require("../../config");
@@ -81,3 +83,17 @@ function removeProject(root) {
     const entries = loadRegistry().filter((e) => e.root !== root);
     saveRegistry(entries);
 }
+/**
+ * Find a registered parent that covers this path, if any.
+ */
+function getParentProject(root) {
+    const resolved = root.endsWith("/") ? root : `${root}/`;
+    return loadRegistry().find((e) => e.root !== root && resolved.startsWith(e.root.endsWith("/") ? e.root : `${e.root}/`));
+}
+/**
+ * Find registered projects that are children of this path.
+ */
+function getChildProjects(root) {
+    const prefix = root.endsWith("/") ? root : `${root}/`;
+    return loadRegistry().filter((e) => e.root !== root && e.root.startsWith(prefix));
+}

package/dist/lib/utils/watcher-launcher.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Centralized watcher launch logic.
+ * Single function that all code paths use to spawn a watcher.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchWatcher = launchWatcher;
+const node_child_process_1 = require("node:child_process");
+const project_registry_1 = require("./project-registry");
+const watcher_store_1 = require("./watcher-store");
+function launchWatcher(projectRoot) {
+    var _a;
+    // 1. Project must be registered
+    const project = (0, project_registry_1.getProject)(projectRoot);
+    if (!project) {
+        return {
+            ok: false,
+            reason: "not-registered",
+            message: `Project not registered. Run: gmax add ${projectRoot}`,
+        };
+    }
+    // 2. Check if watcher already running
+    const existing = (_a = (0, watcher_store_1.getWatcherForProject)(projectRoot)) !== null && _a !== void 0 ? _a : (0, watcher_store_1.getWatcherCoveringPath)(projectRoot);
+    if (existing && (0, watcher_store_1.isProcessRunning)(existing.pid)) {
+        return { ok: true, pid: existing.pid, reused: true };
+    }
+    // 3. Spawn
+    try {
+        const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], "watch", "--path", projectRoot, "-b"], { detached: true, stdio: "ignore" });
+        child.unref();
+        if (child.pid) {
+            return { ok: true, pid: child.pid, reused: false };
+        }
+        return {
+            ok: false,
+            reason: "spawn-failed",
+            message: `Spawn returned no PID for ${projectRoot}`,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            reason: "spawn-failed",
+            message: `Failed to start watcher for ${projectRoot}: ${msg}`,
+        };
+    }
+}

package/dist/lib/utils/watcher-store.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * LMDB-backed watcher registry — replaces the JSON-based watcher-registry.ts.
+ *
+ * Provides ACID transactions for watcher state, eliminating race conditions
+ * when multiple processes (Claude sessions, MCP, CLI) read/write concurrently.
+ *
+ * Stored in ~/.gmax/cache/watchers.lmdb
+ */
+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.registerWatcher = registerWatcher;
+exports.updateWatcherStatus = updateWatcherStatus;
+exports.heartbeat = heartbeat;
+exports.unregisterWatcher = unregisterWatcher;
+exports.getWatcherForProject = getWatcherForProject;
+exports.getWatcherCoveringPath = getWatcherCoveringPath;
+exports.listWatchers = listWatchers;
+exports.migrateFromJson = migrateFromJson;
+exports.isProcessRunning = isProcessRunning;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const lmdb_1 = require("lmdb");
+const config_1 = require("../../config");
+const STORE_PATH = path.join(config_1.PATHS.cacheDir, "watchers.lmdb");
+const HEARTBEAT_STALE_MS = 5 * 60 * 1000; // 5 minutes
+let _db = null;
+function getDb() {
+    if (!_db) {
+        fs.mkdirSync(path.dirname(STORE_PATH), { recursive: true });
+        _db = (0, lmdb_1.open)({
+            path: STORE_PATH,
+            compression: true,
+        });
+    }
+    return _db;
+}
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function isAlive(info) {
+    if (!isProcessRunning(info.pid))
+        return false;
+    // If heartbeat exists and is stale, treat as dead (possibly deadlocked)
+    if (info.lastHeartbeat && Date.now() - info.lastHeartbeat > HEARTBEAT_STALE_MS) {
+        return false;
+    }
+    return true;
+}
+function registerWatcher(info) {
+    const db = getDb();
+    // Prune any existing dead entry for this project
+    const existing = db.get(info.projectRoot);
+    if (existing && !isAlive(existing)) {
+        db.remove(info.projectRoot);
+    }
+    db.put(info.projectRoot, Object.assign(Object.assign({}, info), { lastHeartbeat: Date.now() }));
+}
+function updateWatcherStatus(pid, status, lastReindex) {
+    const db = getDb();
+    // Find entry by PID (iterate since key is projectRoot)
+    for (const { key, value } of db.getRange()) {
+        if (value && value.pid === pid) {
+            db.put(String(key), Object.assign(Object.assign(Object.assign({}, value), { status, lastHeartbeat: Date.now() }), (lastReindex ? { lastReindex } : {})));
+            return;
+        }
+    }
+}
+function heartbeat(pid) {
+    const db = getDb();
+    for (const { key, value } of db.getRange()) {
+        if (value && value.pid === pid) {
+            db.put(String(key), Object.assign(Object.assign({}, value), { lastHeartbeat: Date.now() }));
+            return;
+        }
+    }
+}
+function unregisterWatcher(pid) {
+    const db = getDb();
+    for (const { key, value } of db.getRange()) {
+        if (value && value.pid === pid) {
+            db.remove(String(key));
+            return;
+        }
+    }
+}
+function getWatcherForProject(projectRoot) {
+    const db = getDb();
+    const info = db.get(projectRoot);
+    if (!info)
+        return undefined;
+    if (isAlive(info))
+        return info;
+    // Clean stale entry
+    db.remove(projectRoot);
+    return undefined;
+}
+function getWatcherCoveringPath(dir) {
+    const resolved = dir.endsWith("/") ? dir : `${dir}/`;
+    const db = getDb();
+    for (const { key, value } of db.getRange()) {
+        if (!value)
+            continue;
+        const root = String(key);
+        const prefix = root.endsWith("/") ? root : `${root}/`;
+        if (resolved.startsWith(prefix) && isAlive(value)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function listWatchers() {
+    const db = getDb();
+    const alive = [];
+    const dead = [];
+    for (const { key, value } of db.getRange()) {
+        if (!value)
+            continue;
+        if (isAlive(value)) {
+            alive.push(value);
+        }
+        else {
+            dead.push(String(key));
+        }
+    }
+    // Prune dead entries
+    for (const key of dead) {
+        db.remove(key);
+    }
+    return alive;
+}
+/**
+ * Migrate from legacy watchers.json if it exists.
+ * Call once on startup.
+ */
+function migrateFromJson() {
+    const jsonPath = path.join(config_1.PATHS.globalRoot, "watchers.json");
+    if (!fs.existsSync(jsonPath))
+        return;
+    try {
+        const raw = fs.readFileSync(jsonPath, "utf-8");
+        const entries = JSON.parse(raw);
+        const db = getDb();
+        for (const entry of entries) {
+            if (entry.projectRoot && isProcessRunning(entry.pid)) {
+                db.put(entry.projectRoot, Object.assign(Object.assign({}, entry), { lastHeartbeat: Date.now() }));
+            }
+        }
+        // Remove legacy file
+        fs.unlinkSync(jsonPath);
+    }
+    catch (_a) {
+        // Best effort — ignore
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "author": "Robert Owens <robowens@me.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

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

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

package/plugins/grepmax/hooks/start.js

@@ -45,7 +45,18 @@ function findMlxServerDir() {
 function startPythonServer(serverDir, scriptName, logName) {
   if (!serverDir) return;
 
-  const logPath = `/tmp/${logName}.log`;
+  const logDir = _path.join(require("node:os").homedir(), ".gmax", "logs");
+  fs.mkdirSync(logDir, { recursive: true });
+  const logPath = _path.join(logDir, `${logName}.log`);
+
+  // Rotate if > 5MB (same threshold as watch.ts)
+  try {
+    const stat = fs.statSync(logPath);
+    if (stat.size > 5 * 1024 * 1024) {
+      fs.renameSync(logPath, `${logPath}.prev`);
+    }
+  } catch {}
+
   const out = fs.openSync(logPath, "a");
 
   const child = spawn("uv", ["run", "python", scriptName], {
@@ -57,7 +68,23 @@ function startPythonServer(serverDir, scriptName, logName) {
   child.unref();
 }
 
+function isProjectRegistered() {
+  try {
+    const projectsPath = _path.join(
+      require("node:os").homedir(),
+      ".gmax",
+      "projects.json",
+    );
+    const projects = JSON.parse(require("node:fs").readFileSync(projectsPath, "utf-8"));
+    const cwd = process.cwd();
+    return projects.some((p) => cwd.startsWith(p.root));
+  } catch {
+    return false;
+  }
+}
+
 function startWatcher() {
+  if (!isProjectRegistered()) return;
   try {
     execFileSync("gmax", ["watch", "-b"], { timeout: 5000, stdio: "ignore" });
   } catch {

package/plugins/grepmax/skills/grepmax/SKILL.md

@@ -24,16 +24,17 @@ Bash(gmax "auth handler" --role ORCHESTRATION --lang ts --agent -m 3)
 
 ## Project management
 
-Projects must be added before they can be searched:
+Projects must be added before CLI search works. MCP tools auto-add on first use, but CLI requires an explicit step:
 
 ```
-gmax add                        # add current directory to the index
+gmax add                        # add + index current directory
 gmax add ~/projects/myapp       # add a specific project
 gmax status                     # see all indexed projects and their state
 gmax remove                     # remove current project from the index
+gmax index                      # reindex an already-added project
 ```
 
-If search returns "This project hasn't been added to gmax yet", run `gmax add` first.
+If search returns "This project hasn't been added to gmax yet", run `Bash(gmax add)` first.
 
 ## CLI commands