grepmax 0.19.0 → 0.21.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "grepmax",
+  "owner": {
+    "name": "Robert Owens",
+    "email": "robowens@me.com"
+  },
+  "plugins": [
+    {
+      "name": "grepmax",
+      "source": "./plugins/grepmax",
+      "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
+      "version": "0.21.0",
+      "author": {
+        "name": "Robert Owens",
+        "email": "robowens@me.com"
+      },
+      "skills": [
+        "./skills/grepmax"
+      ]
+    }
+  ]
+}

package/README.md

@@ -61,7 +61,7 @@ gmax "where do we handle auth?" --agent  # Semantic search (compact output)
 gmax extract handleAuth                  # Full function body with line numbers
 gmax peek handleAuth                     # Signature + callers + callees
 gmax trace handleAuth -d 2              # Call graph (2-hop)
-gmax skeleton src/lib/search/           # File structure (bodies collapsed)
+gmax skeleton src/lib/auth.ts           # File structure (bodies collapsed)
 gmax symbols auth                       # List indexed symbols
 ```
 

package/dist/commands/codex.js

@@ -69,8 +69,11 @@ function writeSkillToAgents(skill) {
 function installPlugin() {
     return __awaiter(this, void 0, void 0, function* () {
         try {
-            // 1. Register MCP tool
-            yield execAsync("codex mcp add gmax gmax mcp", {
+            // 1. Register MCP tool. Codex requires the stdio command after `--`:
+            //   codex mcp add [OPTIONS] <NAME> -- <COMMAND>...
+            // Without the separator the launch command is misparsed. AGENTS.md is only
+            // written after this resolves, so a failed registration leaves it untouched.
+            yield execAsync("codex mcp add gmax -- gmax mcp", {
                 shell,
                 env: process.env,
             });

package/dist/commands/context.js

@@ -316,7 +316,7 @@ exports.context = new commander_1.Command("context")
                 allSymbols.add(s);
         }
         if (allSymbols.size > 0) {
-            const pathScope = `path LIKE '${(0, filter_builder_1.escapeSqlString)(projectRoot)}/%'`;
+            const pathScope = (0, filter_builder_1.pathStartsWith)(`${projectRoot}/`);
             const relatedCounts = new Map();
             const searchedFiles = new Set(uniqueFiles);
             for (const sym of [...allSymbols].slice(0, 20)) {

package/dist/commands/doctor.js

@@ -179,6 +179,13 @@ exports.doctor = new commander_1.Command("doctor")
         const db = new VectorDB(config_1.PATHS.lancedbDir);
         const table = yield db.ensureTable();
         const totalChunks = yield table.countRows();
+        // Physical schema-width check: the shared `chunks` table is fixed-width at
+        // creation, so a tier/dim change strands it at the old width and every
+        // write throws. This is independent of the per-project registry drift
+        // checked below — the table can match the registry yet still be physically
+        // stranded — so we surface it as its own line.
+        const physicalDim = yield db.getSchemaVectorDim();
+        const schemaGap = (0, config_1.describeSchemaDimGap)(physicalDim, globalConfig.vectorDim);
         // Summary coverage (existing check)
         if (!opts.agent && totalChunks > 0) {
             const withSummary = (yield table
@@ -275,8 +282,13 @@ exports.doctor = new commander_1.Command("doctor")
                 `orphaned=${orphanedProjects.length}`,
                 `stale_chunker=${staleChunkerProjects.length}`,
                 `stale_embedding=${staleEmbeddingProjects.length}`,
+                `schema_dim=${physicalDim !== null && physicalDim !== void 0 ? physicalDim : "none"}`,
+                `schema_dim_ok=${schemaGap ? "false" : "true"}`,
             ];
             console.log(fields.join("\t"));
+            if (schemaGap) {
+                console.log((0, config_1.schemaDimAgentRow)(schemaGap));
+            }
             for (const p of staleChunkerProjects) {
                 const gap = (0, config_1.describeChunkerGap)(p.chunkerVersion);
                 if (!gap)
@@ -307,12 +319,24 @@ exports.doctor = new commander_1.Command("doctor")
                     `current_dim=${gap.toDim}`,
                     `dim_changed=${gap.dimChanged}`,
                     `severity=${gap.severity}`,
-                    `fix=gmax index --reset (in ${p.root})`,
+                    // A dim change can't be fixed by a per-project reset (the shared
+                    // table is fixed-width) — point at the global rebuild instead.
+                    `fix=${gap.dimChanged ? config_1.REBUILD_COMMAND : `gmax index --reset (in ${p.root})`}`,
                 ].join("\t"));
             }
         }
         else {
             console.log("\nIndex Health\n");
+            // Physical schema width — a mismatch means every write throws until a
+            // global rebuild (the shared fixed-width table can't be reshaped by a
+            // per-project reset). Surfaced first because it's the most severe.
+            if (schemaGap) {
+                console.log(`FAIL  Schema: vector table is ${schemaGap.tableDim}d, config expects ${schemaGap.configDim}d`);
+                console.log(`       run '${config_1.REBUILD_COMMAND}' (drops + reindexes all projects at the new width)`);
+            }
+            else if (physicalDim) {
+                console.log(`ok  Schema: vector table is ${physicalDim}d`);
+            }
             // Disk space
             if (diskLevel !== "ok") {
                 console.log(`WARN  Disk: ${formatSize(availBytes)} available (${diskLevel})`);
@@ -370,17 +394,21 @@ exports.doctor = new commander_1.Command("doctor")
             }
             // Index built with a different embedding model/dim than the current
             // config. A dim change is breaking (search scores are invalid until a
-            // re-embed); a same-dim model swap is additive. Unlike the stale-chunker
-            // case this is NOT auto-fixed by `--fix`: a dim change can't coexist in
-            // the shared fixed-dim table (deferred Phase 1B), so we point at the
-            // manual reset instead.
+            // re-embed); a same-dim model swap is additive. Recovery differs by kind:
+            // a same-dim model swap is fixed by a per-project `gmax index --reset`,
+            // but a dim change can't be — the shared table is fixed-width, so it
+            // needs the global rebuild (see the Schema check above).
             if (staleEmbeddingProjects.length > 0) {
                 const gaps = staleEmbeddingProjects.map((p) => (0, config_1.describeEmbeddingGap)({ modelTier: p.modelTier, vectorDim: p.vectorDim }, {
                     modelTier: globalConfig.modelTier,
                     vectorDim: globalConfig.vectorDim,
                 }));
                 const anyBreaking = gaps.some((g) => (g === null || g === void 0 ? void 0 : g.severity) === "breaking");
-                console.log(`${anyBreaking ? "WARN" : "INFO"}  Stale embedding: ${staleEmbeddingProjects.length} project(s) indexed with a different embedding model/dim — run 'gmax index --reset' per project`);
+                const anyDimChange = gaps.some((g) => g === null || g === void 0 ? void 0 : g.dimChanged);
+                const headerFix = anyDimChange
+                    ? `run '${config_1.REBUILD_COMMAND}' (dim change needs a full rebuild)`
+                    : "run 'gmax index --reset' per project";
+                console.log(`${anyBreaking ? "WARN" : "INFO"}  Stale embedding: ${staleEmbeddingProjects.length} project(s) indexed with a different embedding model/dim — ${headerFix}`);
                 staleEmbeddingProjects.forEach((p, i) => {
                     const gap = gaps[i];
                     if (!gap)
@@ -389,7 +417,9 @@ exports.doctor = new commander_1.Command("doctor")
                         ? `${gap.fromDim}d→${gap.toDim}d`
                         : `model ${gap.fromModel}→${gap.toModel}`;
                     console.log(`       - ${p.name || path.basename(p.root)} (${change}, ${gap.severity})`);
-                    console.log(`         run 'gmax index --reset' in ${p.root}`);
+                    console.log(gap.dimChanged
+                        ? `         run '${config_1.REBUILD_COMMAND}'`
+                        : `         run 'gmax index --reset' in ${p.root}`);
                 });
             }
             // Projects

package/dist/commands/droid.js

@@ -69,17 +69,50 @@ function parseJsonWithComments(content) {
         .split("\n")
         .map((line) => line.replace(/^\s*\/\/.*$/, ""))
         .join("\n");
-    try {
-        return JSON.parse(stripped);
-    }
-    catch (_a) {
+    // An empty / whitespace-only file is a legitimate "no settings yet" -> {}.
+    // Anything else that fails to parse is a real, user-owned file we must NOT
+    // silently coerce to {} (that would clobber it on the next save) — let the
+    // caller decide.
+    if (stripped.trim() === "")
         return {};
-    }
+    return JSON.parse(stripped);
 }
 function loadSettings(settingsPath) {
     if (!node_fs_1.default.existsSync(settingsPath))
         return {};
-    return parseJsonWithComments(node_fs_1.default.readFileSync(settingsPath, "utf-8"));
+    const raw = node_fs_1.default.readFileSync(settingsPath, "utf-8");
+    try {
+        return parseJsonWithComments(raw);
+    }
+    catch (err) {
+        throw new Error(`Refusing to touch ${settingsPath}: it contains invalid JSON ` +
+            `(${err.message}). Fix or remove the file, then re-run.`);
+    }
+}
+/** True when a hook entry was installed by gmax — its command points at our
+ *  hooks dir. Used to remove only gmax entries on uninstall. */
+function isGmaxHookEntry(entry, hooksDir) {
+    var _a, _b;
+    return (_b = (_a = entry.hooks) === null || _a === void 0 ? void 0 : _a.some((h) => { var _a; return (_a = h.command) === null || _a === void 0 ? void 0 : _a.includes(hooksDir); })) !== null && _b !== void 0 ? _b : false;
+}
+/** Strip gmax hook entries from settings.hooks in place, preserving unrelated
+ *  user hooks. Returns true if anything was removed. */
+function removeGmaxHooks(settings, hooksDir) {
+    if (!settings.hooks)
+        return false;
+    let changed = false;
+    for (const [event, entries] of Object.entries(settings.hooks)) {
+        const kept = entries.filter((e) => !isGmaxHookEntry(e, hooksDir));
+        if (kept.length !== entries.length)
+            changed = true;
+        if (kept.length > 0)
+            settings.hooks[event] = kept;
+        else
+            delete settings.hooks[event];
+    }
+    if (Object.keys(settings.hooks).length === 0)
+        delete settings.hooks;
+    return changed;
 }
 function saveSettings(settingsPath, settings) {
     node_fs_1.default.mkdirSync(node_path_1.default.dirname(settingsPath), { recursive: true });
@@ -103,10 +136,14 @@ function mergeHooks(existing, incoming) {
 function installPlugin() {
     return __awaiter(this, void 0, void 0, function* () {
         const root = resolveDroidRoot();
+        const settingsPath = node_path_1.default.join(root, "settings.json");
+        // Validate/parse settings BEFORE writing anything. A malformed, user-owned
+        // settings.json aborts the install here — otherwise we'd either clobber it
+        // with {} or leave half-written hook scripts behind on the failure path.
+        const settings = loadSettings(settingsPath);
         const gmaxBin = resolveGmaxBin();
         const hooksDir = node_path_1.default.join(root, "hooks", "gmax");
         const skillsDir = node_path_1.default.join(root, "skills", "gmax");
-        const settingsPath = node_path_1.default.join(root, "settings.json");
         // 1. Install hook scripts (start/stop daemon)
         const startScript = `
 const { execFileSync } = require("child_process");
@@ -166,7 +203,6 @@ try { execFileSync("gmax", ["watch", "stop", "--all"], { stdio: "ignore", timeou
                 },
             ],
         };
-        const settings = loadSettings(settingsPath);
         settings.enableHooks = true;
         settings.allowBackgroundProcesses = true;
         settings.hooks = mergeHooks(settings.hooks, hookConfig);
@@ -179,12 +215,28 @@ function uninstallPlugin() {
         const root = resolveDroidRoot();
         const hooksDir = node_path_1.default.join(root, "hooks", "gmax");
         const skillsDir = node_path_1.default.join(root, "skills", "gmax");
+        const settingsPath = node_path_1.default.join(root, "settings.json");
         if (node_fs_1.default.existsSync(hooksDir))
             node_fs_1.default.rmSync(hooksDir, { recursive: true, force: true });
         if (node_fs_1.default.existsSync(skillsDir))
             node_fs_1.default.rmSync(skillsDir, { recursive: true, force: true });
+        // Remove only gmax hook entries from settings.json, preserving unrelated user
+        // hooks. enableHooks/allowBackgroundProcesses are left alone — other hooks may
+        // depend on them.
+        if (node_fs_1.default.existsSync(settingsPath)) {
+            try {
+                const settings = loadSettings(settingsPath);
+                if (removeGmaxHooks(settings, hooksDir)) {
+                    saveSettings(settingsPath, settings);
+                    console.log("✅ Removed gmax hooks from settings.json");
+                }
+            }
+            catch (err) {
+                // Don't clobber an invalid settings file on uninstall either.
+                console.warn(`⚠️  Skipped settings cleanup: ${err.message}`);
+            }
+        }
         console.log("✅ gmax removed from Factory Droid");
-        console.log("NOTE: You may want to manually clean up 'hooks' in ~/.factory/settings.json");
     });
 }
 exports.installDroid = new commander_1.Command("install-droid")

package/dist/commands/mcp.js

@@ -773,7 +773,7 @@ exports.mcp = new commander_1.Command("mcp")
                     "is_exported",
                     "defined_symbols",
                 ])
-                    .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                    .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND ${(0, filter_builder_1.pathStartsWith)(prefix)}`)
                     .limit(10)
                     .toArray();
                 if (rows.length === 0) {
@@ -867,7 +867,7 @@ exports.mcp = new commander_1.Command("mcp")
                 const metaRows = yield table
                     .query()
                     .select(["is_exported", "start_line", "end_line"])
-                    .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                    .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND ${(0, filter_builder_1.pathStartsWith)(prefix)}`)
                     .limit(1)
                     .toArray();
                 const exported = metaRows.length > 0 && Boolean(metaRows[0].is_exported);
@@ -982,7 +982,7 @@ exports.mcp = new commander_1.Command("mcp")
                 const defRows = yield table
                     .query()
                     .select(["path", "start_line", "is_exported"])
-                    .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                    .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND ${(0, filter_builder_1.pathStartsWith)(prefix)}`)
                     .limit(1)
                     .toArray();
                 if (defRows.length === 0) {
@@ -1037,7 +1037,7 @@ exports.mcp = new commander_1.Command("mcp")
                     "referenced_symbols",
                     "is_exported",
                 ])
-                    .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                    .where((0, filter_builder_1.pathStartsWith)(prefix))
                     .limit(500000)
                     .toArray();
                 if (rows.length === 0) {
@@ -1221,7 +1221,7 @@ exports.mcp = new commander_1.Command("mcp")
                     const absPrefix = path.isAbsolute(pathPrefix)
                         ? pathPrefix
                         : path.resolve(projectRoot, pathPrefix);
-                    query = query.where(`path LIKE '${(0, filter_builder_1.escapeSqlString)((0, filter_builder_1.normalizePath)(absPrefix))}%'`);
+                    query = query.where((0, filter_builder_1.pathStartsWith)((0, filter_builder_1.normalizePath)(absPrefix)));
                 }
                 const rows = yield query.toArray();
                 const map = new Map();
@@ -1388,7 +1388,7 @@ exports.mcp = new commander_1.Command("mcp")
                     "defined_symbols",
                     "referenced_symbols",
                 ])
-                    .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                    .where((0, filter_builder_1.pathStartsWith)(prefix))
                     .limit(200000)
                     .toArray();
                 if (rows.length === 0) {
@@ -1829,7 +1829,7 @@ exports.mcp = new commander_1.Command("mcp")
                     "role",
                     "_distance",
                 ])
-                    .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(projectRoot)}/%'`)
+                    .where((0, filter_builder_1.pathStartsWith)(`${projectRoot}/`))
                     .limit(limit + 5)
                     .toArray();
                 let filtered = results.filter((r) => !(r.path === source.path && r.start_line === source.start_line));

package/dist/commands/plugin.js

@@ -43,6 +43,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.plugin = void 0;
+exports.installAll = installAll;
 const node_child_process_1 = require("node:child_process");
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
@@ -139,6 +140,39 @@ function getClients() {
         },
     ];
 }
+/**
+ * Install gmax plugins for every detected client; returns the number installed.
+ * Deliberately does NOT call gracefulExit — callers decide how to finish. This
+ * lets `gmax setup` keep running (and print its outro) after installing, while
+ * the `add` subcommand still exits the process itself.
+ */
+function installAll() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const clients = getClients();
+        console.log("gmax plugin add — detecting clients...\n");
+        let installed = 0;
+        for (const client of clients) {
+            if (!client.detect()) {
+                console.log(`  skip  ${client.name} — not found`);
+                continue;
+            }
+            try {
+                yield client.install();
+                installed++;
+            }
+            catch (err) {
+                console.error(`  FAIL  ${client.name} — ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        if (installed === 0) {
+            console.log("\nNo supported clients found. Install one of: claude, opencode, codex, droid");
+        }
+        else {
+            console.log(`\n${installed} plugin(s) installed.`);
+        }
+        return installed;
+    });
+}
 // --- Subcommands ---
 const addCmd = new commander_1.Command("add")
     .description("Install or update gmax plugins")
@@ -164,27 +198,7 @@ const addCmd = new commander_1.Command("add")
         return;
     }
     // Install all detected
-    console.log("gmax plugin add — detecting clients...\n");
-    let installed = 0;
-    for (const client of clients) {
-        if (!client.detect()) {
-            console.log(`  skip  ${client.name} — not found`);
-            continue;
-        }
-        try {
-            yield client.install();
-            installed++;
-        }
-        catch (err) {
-            console.error(`  FAIL  ${client.name} — ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    if (installed === 0) {
-        console.log("\nNo supported clients found. Install one of: claude, opencode, codex, droid");
-    }
-    else {
-        console.log(`\n${installed} plugin(s) installed.`);
-    }
+    yield installAll();
     yield (0, exit_1.gracefulExit)();
 }));
 const removeCmd = new commander_1.Command("remove")

package/dist/commands/project.js

@@ -79,7 +79,7 @@ exports.project = new commander_1.Command("project")
             "defined_symbols",
             "referenced_symbols",
         ])
-            .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+            .where((0, filter_builder_1.pathStartsWith)(prefix))
             .limit(200000)
             .toArray();
         if (rows.length === 0) {

package/dist/commands/remove.js

@@ -133,10 +133,17 @@ Examples:
                 (0, watcher_store_1.unregisterWatcher)(watcher.pid);
             }
             const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
+            // Slash-terminate so removing /repo/app can't also delete the sibling
+            // /repo/app2 — VectorDB matches `path LIKE prefix%` and MetaCache
+            // matches `key.startsWith(prefix)`, both of which bleed across siblings
+            // without the trailing slash. Mirrors the daemon remove path.
+            const rootPrefix = projectRoot.endsWith("/")
+                ? projectRoot
+                : `${projectRoot}/`;
             vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
-            yield vectorDb.deletePathsWithPrefix(projectRoot);
+            yield vectorDb.deletePathsWithPrefix(rootPrefix);
             metaCache = new meta_cache_1.MetaCache(paths.lmdbPath);
-            const keys = yield metaCache.getKeysWithPrefix(projectRoot);
+            const keys = yield metaCache.getKeysWithPrefix(rootPrefix);
             for (const key of keys) {
                 metaCache.delete(key);
             }

package/dist/commands/repair.js

@@ -0,0 +1,186 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repair = void 0;
+const readline = __importStar(require("node:readline"));
+const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
+const config_1 = require("../config");
+const index_config_1 = require("../lib/index/index-config");
+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");
+function confirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${message} [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y");
+        });
+    });
+}
+exports.repair = new commander_1.Command("repair")
+    .description("Repair the centralized index (recover from a schema mismatch)")
+    .option("--rebuild", "Drop the shared vector table and re-index every project at the configured embedding dim", false)
+    .option("-y, --yes", "Skip the confirmation prompt", false)
+    .addHelpText("after", `
+The shared LanceDB \`chunks\` table is fixed-width at creation. Switching model
+tiers (e.g. small 384d -> standard 768d) strands the table at the old width, so
+every write then fails. A per-project \`gmax index --reset\` only deletes rows —
+it can't change the table width. \`${config_1.REBUILD_COMMAND}\` drops the table and
+re-embeds all projects at the current dim.
+
+Examples:
+  gmax repair             Show schema status and what a rebuild would do
+  gmax repair --rebuild   Drop the table and re-index every project
+  gmax repair --rebuild -y  Rebuild without the confirmation prompt
+`)
+    .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    try {
+        const globalConfig = (0, index_config_1.readGlobalConfig)();
+        const configDim = globalConfig.vectorDim;
+        // Physical width of the on-disk table (null if no table yet). Opened
+        // read-only; safe to inspect even while the daemon holds the table.
+        let physicalDim = null;
+        const probe = new vector_db_1.VectorDB(config_1.PATHS.lancedbDir);
+        try {
+            physicalDim = yield probe.getSchemaVectorDim();
+        }
+        finally {
+            yield probe.close();
+        }
+        const projects = (0, project_registry_1.listProjects)().filter((p) => p.status === "indexed" || p.status === "pending");
+        const dimLine = physicalDim == null
+            ? "Vector table: none yet"
+            : physicalDim === configDim
+                ? `Vector table: ${physicalDim}d (matches config)`
+                : `Vector table: ${physicalDim}d, config expects ${configDim}d (MISMATCH)`;
+        console.log(dimLine);
+        if (!opts.rebuild) {
+            if (physicalDim != null && physicalDim !== configDim) {
+                console.log(`\nRun '${config_1.REBUILD_COMMAND}' to drop the table and re-index ` +
+                    `${projects.length} project(s) at ${configDim}d.`);
+            }
+            else {
+                console.log(`\nNothing to repair. Pass --rebuild to force a full drop + re-index anyway.`);
+            }
+            return;
+        }
+        if (projects.length === 0) {
+            console.log("\nNo indexed projects to rebuild.");
+            return;
+        }
+        const totalChunks = projects.reduce((sum, p) => { var _a; return sum + ((_a = p.chunkCount) !== null && _a !== void 0 ? _a : 0); }, 0);
+        console.log(`\nThis will DROP the shared vector table and re-embed ${projects.length} project(s)` +
+            (totalChunks > 0
+                ? ` (~${totalChunks.toLocaleString()} chunks).`
+                : "."));
+        for (const p of projects) {
+            console.log(`  - ${p.name}`);
+        }
+        if (!opts.yes) {
+            const ok = yield confirm("\nContinue?");
+            if (!ok) {
+                console.log("Cancelled.");
+                return;
+            }
+        }
+        // The rebuild must run through the daemon — it is the single writer for
+        // the shared table. Refuse rather than risk a torn drop alongside a
+        // daemon mid-flush.
+        const { ensureDaemonRunning, sendStreamingCommand } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/daemon-client")));
+        if (!(yield ensureDaemonRunning())) {
+            console.error("Could not start the gmax daemon. Start it with 'gmax watch --daemon -b' and retry.");
+            process.exitCode = 1;
+            return;
+        }
+        const spinner = (0, ora_1.default)({
+            text: "Dropping vector table...",
+            isSilent: !process.stdout.isTTY,
+        }).start();
+        try {
+            const done = yield sendStreamingCommand({ cmd: "repair" }, (msg) => {
+                var _a, _b, _c, _d;
+                if (msg.phase === "drop") {
+                    spinner.text = "Dropping vector table...";
+                }
+                else if (msg.phase === "reindex") {
+                    const doneN = (_a = msg.projectsDone) !== null && _a !== void 0 ? _a : 0;
+                    const totalN = (_b = msg.projectsTotal) !== null && _b !== void 0 ? _b : projects.length;
+                    const processed = (_c = msg.processed) !== null && _c !== void 0 ? _c : 0;
+                    const total = (_d = msg.total) !== null && _d !== void 0 ? _d : 0;
+                    const counts = total > 0 ? ` ${processed}/${total}` : "";
+                    spinner.text = `Re-indexing ${msg.project} (${doneN + 1}/${totalN})${counts}`;
+                }
+            });
+            if (!done.ok) {
+                spinner.fail("Rebuild failed");
+                throw new Error((_a = done.error) !== null && _a !== void 0 ? _a : "daemon repair failed");
+            }
+            const rebuilt = (_b = done.projects) !== null && _b !== void 0 ? _b : 0;
+            const indexed = (_c = done.indexed) !== null && _c !== void 0 ? _c : 0;
+            spinner.succeed(`Rebuilt ${rebuilt} project(s) at ${configDim}d • ${indexed.toLocaleString()} chunks`);
+        }
+        catch (e) {
+            if (spinner.isSpinning)
+                spinner.fail("Rebuild failed");
+            throw e;
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        console.error("Failed to repair:", message);
+        process.exitCode = 1;
+    }
+    finally {
+        yield (0, exit_1.gracefulExit)();
+    }
+}));

package/dist/commands/search-run.js

@@ -130,7 +130,18 @@ function runSearch(params) {
                 if (!indexState && (locked || projectStatus === "pending")) {
                     indexState = { indexing: true, pendingFiles: 0 };
                 }
-                const hasRows = yield vectorDb.hasAnyRows();
+                // Decide first-run auto-index by whether the project being searched has
+                // rows — NOT whether the shared store has any rows at all. The store is
+                // centralized, so a global hasAnyRows() lets a sibling project's rows
+                // suppress this project's first-run index. Cross-project mode keeps the
+                // global check: it spans already-indexed projects and must not first-run
+                // a single directory just because the cwd happens to be unindexed.
+                const crossProject = !!options.allProjects ||
+                    !!options.projects ||
+                    !!options.excludeProjects;
+                const hasRows = crossProject
+                    ? yield vectorDb.hasAnyRows()
+                    : yield vectorDb.hasRowsForPath(effectiveRoot);
                 const needsSync = options.sync || !hasRows;
                 if (needsSync) {
                     const isTTY = process.stdout.isTTY;

package/dist/commands/setup.js

@@ -154,8 +154,10 @@ exports.setup = new commander_1.Command("setup")
         initialValue: true,
     });
     if (!p.isCancel(installPlugins) && installPlugins) {
-        const { plugin: pluginCmd } = yield Promise.resolve().then(() => __importStar(require("./plugin")));
-        yield pluginCmd.parseAsync(["node", "gmax"]);
+        // Call installAll() directly, not `plugin` (bare status) or the `add`
+        // subcommand — both gracefulExit() before setup's outro can run.
+        const { installAll } = yield Promise.resolve().then(() => __importStar(require("./plugin")));
+        yield installAll();
     }
     p.outro(`Ready — ${selectedTier.label}, ${embedMode === "gpu" ? "GPU" : "CPU"} mode`);
     yield (0, exit_1.gracefulExit)();