grepmax 0.7.44 → 0.8.1

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,10 @@ 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})`);
-        }
-        catch (_c) {
-            console.log(`Note: could not start watcher. Run: gmax watch --path ${projectRoot} -b`);
+        // Start watcher
+        const launched = (0, watcher_launcher_1.launchWatcher)(projectRoot);
+        if (launched) {
+            console.log(`Watcher started (PID: ${launched.pid})`);
         }
     }
     catch (error) {
@@ -147,7 +169,7 @@ Examples:
             try {
                 yield vectorDb.close();
             }
-            catch (_d) { }
+            catch (_c) { }
         }
         yield (0, exit_1.gracefulExit)();
     }

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,9 @@ 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})`);
-                }
-                catch (_c) {
-                    console.log(`Note: could not restart watcher. Run: gmax watch --path ${restartWatcher.projectRoot} -b`);
+                const launched = (0, watcher_launcher_1.launchWatcher)(restartWatcher.projectRoot);
+                if (launched) {
+                    console.log(`Restarted watcher for ${path.basename(restartWatcher.projectRoot)} (PID: ${launched.pid})`);
                 }
             }
         }

package/dist/commands/mcp.js

@@ -77,7 +77,7 @@ 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_store_1 = require("../lib/utils/watcher-store");
 // ---------------------------------------------------------------------------
 // Tool definitions
 // ---------------------------------------------------------------------------
@@ -331,8 +331,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 +342,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,7 +352,10 @@ exports.mcp = new commander_1.Command("mcp")
     }
     // --- Background watcher ---
     function ensureWatcher() {
-        if ((0, watcher_registry_1.getWatcherCoveringPath)(projectRoot))
+        // Only start watcher for registered projects
+        if (!(0, project_registry_1.getProject)(projectRoot))
+            return;
+        if ((0, watcher_store_1.getWatcherCoveringPath)(projectRoot))
             return;
         const child = (0, node_child_process_1.spawn)("gmax", ["watch", "-b", "--path", projectRoot], {
             detached: true,
@@ -611,6 +614,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 +729,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 +811,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 +898,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 +1102,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 +1205,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

@@ -52,7 +52,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 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,7 +99,7 @@ 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 {
@@ -107,11 +107,11 @@ Examples:
             }
             catch (_b) { }
             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);
         }
         // Delete vectors from LanceDB
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);

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,16 +528,8 @@ 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")));
+            launchWatcher(projectRoot);
         }
         const searcher = new searcher_1.Searcher(vectorDb);
         // Use --root or fall back to project root
@@ -566,7 +570,7 @@ Examples:
                     return defs.some((d) => regex.test(d));
                 });
             }
-            catch (_w) {
+            catch (_v) {
                 // Invalid regex — skip
             }
         }
@@ -670,7 +674,7 @@ Examples:
                         }
                     }
                 }
-                catch (_x) { }
+                catch (_w) { }
             }
             return;
         }
@@ -772,7 +776,7 @@ Examples:
                     console.log(lines.join("\n"));
                 }
             }
-            catch (_y) {
+            catch (_x) {
                 // Trace failed — skip silently
             }
         }

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/verify.js

@@ -52,7 +52,7 @@ const MODEL_PATH = path.join(MODEL_DIR, "model.onnx");
 const SKIPLIST_PATH = path.join(MODEL_DIR, "skiplist.json");
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
+        var _a, _b, _c;
         console.log("🔍 Starting ColBERT Integrity Check...\n");
         // --- CHECK 1: FILES EXIST ---
         if (!fs.existsSync(MODEL_PATH))
@@ -68,19 +68,19 @@ function main() {
         // Note: We use the ID we know works from your export: 50368
         // But let's see if the tokenizer resolves "[Q] " correctly.
         const encoded = yield tokenizer(queryText, { add_special_tokens: false });
-        const inputIds = encoded.input_ids; // BigInt64Array in newer transformers versions
+        const inputIds = (_a = encoded.input_ids.data) !== null && _a !== void 0 ? _a : encoded.input_ids;
         // Convert to standard array for inspection
         const ids = Array.from(inputIds).map(Number);
         // Mixedbread expects: [CLS] [Q] ...tokens... [SEP]
         // Let's verify we can construct that.
         const Q_ID = 50368;
-        const CLS_ID = (_a = tokenizer.model.tokens_to_ids.get("[CLS]")) !== null && _a !== void 0 ? _a : 50281; // Fallback to standard if null
+        const CLS_ID = (_b = tokenizer.convert_tokens_to_ids("[CLS]")) !== null && _b !== void 0 ? _b : 50281; // Fallback to standard if null
         console.log(`\n--- Tokenizer Check ---`);
         console.log(`Query: "${queryText}"`);
         console.log(`Raw IDs:`, ids);
         // Check if tokenizer recognizes the special tokens by text
-        const qCheck = tokenizer.model.tokens_to_ids.get("[Q] ");
-        const dCheck = tokenizer.model.tokens_to_ids.get("[D] ");
+        const qCheck = tokenizer.convert_tokens_to_ids("[Q] ");
+        const dCheck = tokenizer.convert_tokens_to_ids("[D] ");
         if (qCheck === 50368 && dCheck === 50369) {
             console.log(`✅ Tokenizer Map Correct: [Q] -> ${qCheck}, [D] -> ${dCheck}`);
         }
@@ -93,8 +93,8 @@ function main() {
         console.log(`\n--- Skiplist Check ---`);
         console.log(`Skiplist size: ${skiplist.size}`);
         // Check common punctuation
-        const commaId = tokenizer.model.tokens_to_ids.get(",");
-        const dotId = tokenizer.model.tokens_to_ids.get(".");
+        const commaId = tokenizer.convert_tokens_to_ids(",");
+        const dotId = tokenizer.convert_tokens_to_ids(".");
         if (skiplist.has(commaId) && skiplist.has(dotId)) {
             console.log(`✅ Skiplist contains punctuation ('.'=${dotId}, ','=${commaId})`);
         }
@@ -110,7 +110,7 @@ function main() {
             BigInt(CLS_ID),
             BigInt(Q_ID),
             BigInt(1234),
-            BigInt((_b = tokenizer.sep_token_id) !== null && _b !== void 0 ? _b : 50282),
+            BigInt((_c = tokenizer.sep_token_id) !== null && _c !== void 0 ? _c : 50282),
         ];
         const tensorIds = new ort.Tensor("int64", new BigInt64Array(batchIds), [1, 4]);
         const tensorMask = new ort.Tensor("int64", new BigInt64Array([BigInt(1), BigInt(1), BigInt(1), BigInt(1)]), [1, 4]);

package/dist/commands/watch.js

@@ -48,14 +48,16 @@ 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 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
@@ -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;
     }
@@ -106,12 +108,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 +139,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 +166,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 +187,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 +206,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,11 +226,11 @@ 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);
+                (0, watcher_store_1.unregisterWatcher)(w.pid);
             }
             catch (_b) { }
         }
@@ -212,7 +239,7 @@ exports.watch
         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)();
@@ -220,12 +247,12 @@ exports.watch
     }
     try {
         process.kill(watcher.pid, "SIGTERM");
-        (0, watcher_registry_1.unregisterWatcher)(watcher.pid);
+        (0, watcher_store_1.unregisterWatcher)(watcher.pid);
         console.log(`Stopped watcher (PID: ${watcher.pid})`);
     }
     catch (_c) {
         console.log("Watcher process not found.");
-        (0, watcher_registry_1.unregisterWatcher)(watcher.pid);
+        (0, watcher_store_1.unregisterWatcher)(watcher.pid);
     }
     yield (0, exit_1.gracefulExit)();
 }));

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/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,46 @@
+"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");
+/**
+ * Launch a background watcher for a project.
+ *
+ * Returns { pid } on success, null if:
+ * - Project is not registered
+ * - Watcher is already running
+ * - Spawn fails
+ */
+function launchWatcher(projectRoot) {
+    var _a;
+    // 1. Project must be registered
+    const project = (0, project_registry_1.getProject)(projectRoot);
+    if (!project) {
+        return null;
+    }
+    // 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 { pid: existing.pid };
+    }
+    // 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 { pid: child.pid };
+        }
+        console.error(`[watcher-launcher] Spawn returned no PID for ${projectRoot}`);
+        return null;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[watcher-launcher] Failed to start watcher for ${projectRoot}: ${msg}`);
+        return null;
+    }
+}

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/dist/lib/workers/colbert-tokenizer.js

@@ -23,20 +23,22 @@ class ColBERTTokenizer {
     }
     init(modelPath) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            var _a, _b, _c, _d, _e, _f;
             this.tokenizer = yield transformers_1.AutoTokenizer.from_pretrained(modelPath);
             // Get special token IDs with fallbacks
             // We use the IDs we discovered in validation: [Q]=50368, [D]=50369
             // But we still try to look them up dynamically first.
             const tokenizer = this.tokenizer;
-            const get = (token) => tokenizer === null || tokenizer === void 0 ? void 0 : tokenizer.model.tokens_to_ids.get(token);
-            const specialTokens = tokenizer;
-            const clsId = (_b = get((_a = specialTokens.cls_token) !== null && _a !== void 0 ? _a : "[CLS]")) !== null && _b !== void 0 ? _b : 50281;
-            const sepId = (_d = get((_c = specialTokens.sep_token) !== null && _c !== void 0 ? _c : "[SEP]")) !== null && _d !== void 0 ? _d : 50282;
-            const padId = (_f = get((_e = specialTokens.pad_token) !== null && _e !== void 0 ? _e : "[PAD]")) !== null && _f !== void 0 ? _f : 50283;
-            const maskId = (_g = get(MASK_TOKEN)) !== null && _g !== void 0 ? _g : 50284;
-            const queryMarkerId = (_h = get(QUERY_MARKER_TOKEN)) !== null && _h !== void 0 ? _h : 50368;
-            const docMarkerId = (_j = get(DOC_MARKER_TOKEN)) !== null && _j !== void 0 ? _j : 50369;
+            const get = (token) => {
+                const id = tokenizer === null || tokenizer === void 0 ? void 0 : tokenizer.convert_tokens_to_ids(token);
+                return typeof id === "number" && id >= 0 ? id : undefined;
+            };
+            const clsId = (_a = get("[CLS]")) !== null && _a !== void 0 ? _a : 50281;
+            const sepId = (_b = get("[SEP]")) !== null && _b !== void 0 ? _b : 50282;
+            const padId = (_c = get("[PAD]")) !== null && _c !== void 0 ? _c : 50283;
+            const maskId = (_d = get(MASK_TOKEN)) !== null && _d !== void 0 ? _d : 50284;
+            const queryMarkerId = (_e = get(QUERY_MARKER_TOKEN)) !== null && _e !== void 0 ? _e : 50368;
+            const docMarkerId = (_f = get(DOC_MARKER_TOKEN)) !== null && _f !== void 0 ? _f : 50369;
             this.specialTokenIds = {
                 cls: clsId,
                 sep: sepId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.44",
+  "version": "0.8.1",
   "author": "Robert Owens <robowens@me.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {
@@ -33,9 +33,9 @@
   "description": "Semantic code search for coding agents. Local embeddings, LLM summaries, call graph tracing.",
   "dependencies": {
     "@clack/prompts": "^1.1.0",
-    "@huggingface/transformers": "^3.8.0",
-    "@lancedb/lancedb": "^0.26.2",
-    "@modelcontextprotocol/sdk": "^1.24.3",
+    "@huggingface/transformers": "^4.0.0",
+    "@lancedb/lancedb": "^0.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "apache-arrow": "^18.1.0",
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
@@ -44,23 +44,24 @@
     "dotenv": "^17.2.3",
     "fast-glob": "^3.3.3",
     "ignore": "^7.0.5",
-    "lmdb": "^3.4.4",
+    "lmdb": "^3.5.2",
     "onnxruntime-node": "1.24.3",
-    "ora": "^5.4.1",
+    "ora": "^9.3.0",
     "piscina": "^5.1.4",
     "simsimd": "^6.5.5",
     "uuid": "^13.0.0",
-    "web-tree-sitter": "^0.26.6",
+    "web-tree-sitter": "^0.26.7",
     "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.76",
-    "@biomejs/biome": "2.4.7",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.87",
+    "@biomejs/biome": "2.4.10",
     "@types/node": "^25.5.0",
     "node-gyp": "^12.1.0",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3",
-    "vitest": "^1.6.1"
+    "typescript": "^6.0.2",
+    "vite": "^8.0.3",
+    "vitest": "^4.1.2"
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
@@ -80,6 +81,6 @@
     "typecheck": "tsc --noEmit",
     "preversion": "pnpm test && pnpm typecheck",
     "version": "bash scripts/sync-versions.sh && git add -A",
-    "postversion": "git push origin main --tags && gh release create v$npm_package_version --generate-notes --title v$npm_package_version && sleep 5 && gh run watch $(gh run list --workflow=release.yml --limit 1 --json databaseId --jq '.[0].databaseId') --exit-status && sleep 30 && npm cache clean --force && npm install -g grepmax@$npm_package_version"
+    "postversion": "git push origin main && git push origin v$npm_package_version && gh release create v$npm_package_version --generate-notes --title v$npm_package_version && sleep 5 && gh run watch $(gh run list --workflow=release.yml --branch v$npm_package_version --limit 1 --json databaseId --jq '.[0].databaseId') --exit-status && sleep 30 && npm cache clean --force && npm install -g grepmax@$npm_package_version"
   }
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.44",
+  "version": "0.8.1",
   "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