grepmax 0.24.0 → 0.25.0

package/dist/commands/doctor.js

@@ -48,9 +48,12 @@ const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const config_1 = require("../config");
+const embedding_status_1 = require("../lib/index/embedding-status");
 const index_config_1 = require("../lib/index/index-config");
+const doctor_status_1 = require("../lib/utils/doctor-status");
 const exit_1 = require("../lib/utils/exit");
 const lock_1 = require("../lib/utils/lock");
+const mlx_hf_cache_1 = require("../lib/utils/mlx-hf-cache");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 function formatSize(bytes) {
@@ -85,7 +88,7 @@ exports.doctor = new commander_1.Command("doctor")
     .option("--fix", "Auto-fix detected issues (compact, prune, remove stale locks)", false)
     .option("--agent", "Compact output for AI agents", false)
     .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     if (!opts.agent)
         console.log("gmax Doctor\n");
     const root = config_1.PATHS.globalRoot;
@@ -106,33 +109,29 @@ exports.doctor = new commander_1.Command("doctor")
     if (!config_1.MODEL_TIERS[globalConfig.modelTier]) {
         console.log(`WARN  Unknown model tier '${globalConfig.modelTier}', falling back to 'small'`);
     }
-    const embedModel = globalConfig.embedMode === "gpu" ? tier.mlxModel : tier.onnxModel;
+    const embedModel = globalConfig.embedMode === "gpu"
+        ? ((_b = globalConfig.mlxModel) !== null && _b !== void 0 ? _b : tier.mlxModel)
+        : tier.onnxModel;
     if (!opts.agent) {
         console.log(`\nEmbed mode: ${globalConfig.embedMode} | Model tier: ${globalConfig.modelTier} (${tier.vectorDim}d)`);
         console.log(`Embed model: ${embedModel}`);
         console.log(`ColBERT model: ${config_1.MODEL_IDS.colbert}`);
-        const modelStatuses = [embedModel, config_1.MODEL_IDS.colbert].map((id) => {
-            const modelPath = path.join(models, ...id.split("/"));
-            return { id, path: modelPath, exists: fs.existsSync(modelPath) };
-        });
-        modelStatuses.forEach(({ id, exists }) => {
-            console.log(`${exists ? "ok" : "WARN"}  ${id}: ${exists ? "downloaded" : "will download on first use"}`);
-        });
-        console.log(`\nLocal Project: ${process.cwd()}`);
-        const projectRoot = (0, project_root_1.findProjectRoot)(process.cwd());
-        if (projectRoot) {
-            console.log(`ok  Project root: ${projectRoot}`);
-            console.log(`    Centralized index at: ~/.gmax/lancedb/`);
-        }
-        else {
-            console.log(`INFO  No index found in current directory (run 'gmax index' to create one)`);
-        }
-        // Check MLX embed server
+        // Probe the MLX embed server once, up front: the gpu-mode embed model
+        // status is derived from it (the server, not the ONNX models dir, is the
+        // source of truth in gpu mode). Reused below for the "MLX Embed" line.
         let embedUp = false;
         let embedError = "";
         try {
             const res = yield fetch("http://127.0.0.1:8100/health");
-            embedUp = res.ok;
+            const health = (yield res.json());
+            embedUp =
+                res.ok && health.status === "ok" && health.model === embedModel;
+            if (res.ok && health.model !== embedModel) {
+                embedError = `wrong model ${String(health.model)}; expected ${embedModel}`;
+            }
+            else if (res.ok && health.status !== "ok") {
+                embedError = "invalid health response";
+            }
         }
         catch (err) {
             embedError =
@@ -140,6 +139,28 @@ exports.doctor = new commander_1.Command("doctor")
                     ? "connection refused"
                     : err.message || String(err);
         }
+        // Embed model availability. In gpu mode the model is served by MLX from
+        // the pinned HF cache (~/.gmax/hf), never the ONNX models dir — report
+        // from the live server / HF cache. In cpu mode it's an ONNX model in
+        // ~/.gmax/models. ColBERT is always ONNX in-worker regardless of mode.
+        const onnxExists = (id) => fs.existsSync(path.join(models, ...id.split("/")));
+        const embedStatus = globalConfig.embedMode === "gpu"
+            ? (0, doctor_status_1.gpuEmbedModelStatus)(embedModel, { up: embedUp }, (0, mlx_hf_cache_1.isMlxModelCached)(embedModel))
+            : (0, doctor_status_1.onnxModelStatus)(embedModel, onnxExists(embedModel));
+        const colbertStatus = (0, doctor_status_1.onnxModelStatus)(config_1.MODEL_IDS.colbert, onnxExists(config_1.MODEL_IDS.colbert));
+        for (const s of [embedStatus, colbertStatus]) {
+            console.log(`${s.symbol}  ${s.message}`);
+        }
+        console.log(`\nLocal Project: ${process.cwd()}`);
+        const projectRoot = (0, project_root_1.findProjectRoot)(process.cwd());
+        if (projectRoot) {
+            console.log(`ok  Project root: ${projectRoot}`);
+            console.log(`    Centralized index at: ~/.gmax/lancedb/`);
+        }
+        else {
+            console.log(`INFO  No index found in current directory (run 'gmax index' to create one)`);
+        }
+        // MLX embed server (probed once above).
         console.log(`${embedUp ? "ok" : "WARN"}  MLX Embed: ${embedUp ? "running (port 8100)" : `not running${embedError ? ` (${embedError})` : ""}`}`);
         if (embedUp) {
             try {
@@ -150,7 +171,7 @@ exports.doctor = new commander_1.Command("doctor")
                     body: JSON.stringify({ texts: ["gmax health check"] }),
                 });
                 const embedData = yield embedRes.json();
-                const dim = (_d = (_c = (_b = embedData === null || embedData === void 0 ? void 0 : embedData.vectors) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0;
+                const dim = (_e = (_d = (_c = embedData === null || embedData === void 0 ? void 0 : embedData.vectors) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0;
                 const ms = Date.now() - start;
                 const expectedDim = tier.vectorDim || 384;
                 if (dim === expectedDim) {
@@ -164,11 +185,13 @@ exports.doctor = new commander_1.Command("doctor")
                 console.log(`FAIL  Embedding: test failed (${err.message || err})`);
             }
         }
-        // Check summarizer server
+        // Check summarizer server. Down is INFO, not WARN — opt-in, respawns on
+        // demand, idles out after 10min (see summarizerServerStatus).
         const summarizerUp = yield fetch("http://127.0.0.1:8101/health")
             .then((r) => r.ok)
             .catch(() => false);
-        console.log(`${summarizerUp ? "ok" : "WARN"}  Summarizer: ${summarizerUp ? "running (port 8101)" : "not running"}`);
+        const summarizerStatus = (0, doctor_status_1.summarizerServerStatus)(summarizerUp);
+        console.log(`${summarizerStatus.symbol}  ${summarizerStatus.message}`);
     }
     // --- Index Health ---
     let needsOptimize = false;
@@ -193,9 +216,8 @@ exports.doctor = new commander_1.Command("doctor")
                 .where("length(summary) > 5")
                 .select(["id"])
                 .toArray()).length;
-            const pct = Math.round((withSummary / totalChunks) * 100);
-            const symbol = pct >= 90 ? "ok" : pct > 0 ? "WARN" : "FAIL";
-            console.log(`${symbol}  Summary coverage: ${withSummary}/${totalChunks} (${pct}%)`);
+            const coverage = (0, doctor_status_1.summaryCoverageStatus)(withSummary, totalChunks);
+            console.log(`${coverage.symbol}  ${coverage.message}`);
         }
         else if (!opts.agent && totalChunks === 0) {
             console.log("INFO  No indexed chunks yet");
@@ -251,21 +273,14 @@ exports.doctor = new commander_1.Command("doctor")
                         ? "LOW"
                         : "ok";
         }
-        catch (_g) { }
+        catch (_j) { }
         const staleChunkerProjects = projects.filter((p) => {
             var _a;
             return p.status === "indexed" &&
                 ((_a = p.chunkerVersion) !== null && _a !== void 0 ? _a : 1) < config_1.CONFIG.CHUNKER_VERSION;
         });
-        // Projects whose stored embedding model/dim no longer matches the global
-        // config. Visibility only — recovery is a manual `gmax index --reset`
-        // (a dim change can't be auto-fixed in the shared fixed-dim table; that's
-        // the deferred Phase 1B re-embed work).
         const staleEmbeddingProjects = projects.filter((p) => p.status === "indexed" &&
-            (0, config_1.describeEmbeddingGap)({ modelTier: p.modelTier, vectorDim: p.vectorDim }, {
-                modelTier: globalConfig.modelTier,
-                vectorDim: globalConfig.vectorDim,
-            }) !== null);
+            (0, embedding_status_1.projectEmbeddingStatus)(p, globalConfig).state === "stale");
         if (opts.agent) {
             const fields = [
                 "index_health",
@@ -304,35 +319,30 @@ exports.doctor = new commander_1.Command("doctor")
                 ].join("\t"));
             }
             for (const p of staleEmbeddingProjects) {
-                const gap = (0, config_1.describeEmbeddingGap)({ modelTier: p.modelTier, vectorDim: p.vectorDim }, {
-                    modelTier: globalConfig.modelTier,
-                    vectorDim: globalConfig.vectorDim,
-                });
-                if (!gap)
+                const identity = (0, embedding_status_1.projectEmbeddingStatus)(p, globalConfig);
+                if (!identity.built)
                     continue;
                 console.log([
                     "stale_embedding_project",
                     `name=${p.name || path.basename(p.root)}`,
-                    `indexed_model=${gap.fromModel}`,
-                    `current_model=${gap.toModel}`,
-                    `indexed_dim=${gap.fromDim}`,
-                    `current_dim=${gap.toDim}`,
-                    `dim_changed=${gap.dimChanged}`,
-                    `severity=${gap.severity}`,
-                    // 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})`}`,
+                    `indexed_model=${identity.built.tier}`,
+                    `current_model=${identity.configured.tier}`,
+                    `indexed_dim=${identity.built.vectorDim}`,
+                    `current_dim=${identity.configured.vectorDim}`,
+                    `indexed_fingerprint=${identity.built.fingerprint}`,
+                    `current_fingerprint=${identity.configured.fingerprint}`,
+                    "severity=breaking",
+                    "fix=gmax repair --rebuild",
                 ].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.
+            // Physical schema width mismatch remains fail-closed until the user
+            // explicitly runs the guarded whole-corpus rebuild.
             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)`);
+                console.log("       run 'gmax repair --rebuild' to rebuild the whole corpus");
             }
             else if (physicalDim) {
                 console.log(`ok  Schema: vector table is ${physicalDim}d`);
@@ -392,34 +402,13 @@ exports.doctor = new commander_1.Command("doctor")
                     console.log(`         run 'gmax index --reset' in ${p.root}`);
                 }
             }
-            // 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. 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");
-                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)
+                console.log(`WARN  Stale embedding: ${staleEmbeddingProjects.length} project(s) use a different embedding generation — run 'gmax repair --rebuild'`);
+                staleEmbeddingProjects.forEach((p) => {
+                    const identity = (0, embedding_status_1.projectEmbeddingStatus)(p, globalConfig);
+                    if (!identity.built)
                         return;
-                    const change = gap.dimChanged
-                        ? `${gap.fromDim}d→${gap.toDim}d`
-                        : `model ${gap.fromModel}→${gap.toModel}`;
-                    console.log(`       - ${p.name || path.basename(p.root)} (${change}, ${gap.severity})`);
-                    console.log(gap.dimChanged
-                        ? `         run '${config_1.REBUILD_COMMAND}'`
-                        : `         run 'gmax index --reset' in ${p.root}`);
+                    console.log(`       - ${p.name || path.basename(p.root)} (${identity.built.tier} ${identity.built.vectorDim}d → ${identity.configured.tier} ${identity.configured.vectorDim}d, breaking)`);
                 });
             }
             // Projects
@@ -452,7 +441,7 @@ exports.doctor = new commander_1.Command("doctor")
                     }
                     yield mc.close();
                 }
-                catch (_h) { }
+                catch (_k) { }
             }
         }
         // --fix auto-remediation
@@ -497,8 +486,8 @@ exports.doctor = new commander_1.Command("doctor")
                         if (!opts.agent)
                             console.log(`...  Reindexing ${name} (--reset)...`);
                         const done = yield sendStreamingCommand({ cmd: "index", root: p.root, reset: true }, () => { }).catch((e) => ({ ok: false, error: String(e) }));
-                        if (done.ok) {
-                            (0, project_registry_1.registerProject)(Object.assign(Object.assign({}, p), { status: "indexed", chunkerVersion: config_1.CONFIG.CHUNKER_VERSION, lastIndexed: new Date().toISOString(), chunkCount: (_e = done.indexed) !== null && _e !== void 0 ? _e : p.chunkCount }));
+                        if (done.ok &&
+                            (!("degraded" in done) || done.degraded !== true)) {
                             const chunks = (_f = done.indexed) !== null && _f !== void 0 ? _f : 0;
                             if (opts.agent) {
                                 console.log(`stale_chunker_reindexed\tname=${name}\tchunks=${chunks}`);
@@ -509,7 +498,11 @@ exports.doctor = new commander_1.Command("doctor")
                             fixed++;
                         }
                         else if (!opts.agent) {
-                            console.log(`FAIL  ${name}: reindex failed (${done.error})`);
+                            const degraded = "degraded" in done && done.degraded === true;
+                            const reason = degraded
+                                ? `${(_g = ("scanErrors" in done ? done.scanErrors : 0)) !== null && _g !== void 0 ? _g : 0} scan errors, ${(_h = ("failedFiles" in done ? done.failedFiles : 0)) !== null && _h !== void 0 ? _h : 0} file failures`
+                                : done.error;
+                            console.log(`FAIL  ${name}: reindex failed (${reason})`);
                         }
                     }
                 }

package/dist/commands/extract.js

@@ -51,6 +51,7 @@ const exit_1 = require("../lib/utils/exit");
 const filter_builder_1 = require("../lib/utils/filter-builder");
 const import_extractor_1 = require("../lib/utils/import-extractor");
 const language_1 = require("../lib/utils/language");
+const path_containment_1 = require("../lib/utils/path-containment");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
@@ -129,7 +130,17 @@ exports.extract = new commander_1.Command("extract")
             exclude: opts.exclude,
         });
         const where = buildScopeWhere(scope, `array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}')`);
-        const chunks = yield findSymbolChunks(vectorDb, where);
+        const indexedChunks = yield findSymbolChunks(vectorDb, where);
+        const chunks = indexedChunks.flatMap((chunk) => {
+            try {
+                return [
+                    Object.assign(Object.assign({}, chunk), { path: (0, path_containment_1.resolveContainedFile)(projectRoot, chunk.path) }),
+                ];
+            }
+            catch (_a) {
+                return [];
+            }
+        });
         if (chunks.length === 0) {
             console.log((0, agent_errors_1.symbolNotFoundLines)(symbol, {
                 agent: opts.agent,

package/dist/commands/index.js

@@ -47,7 +47,6 @@ const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const config_1 = require("../config");
 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");
@@ -71,7 +70,7 @@ Examples:
   gmax index --reset             Full re-index from scratch
 `)
     .action((_args, cmd) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     const options = cmd.optsWithGlobals();
     let vectorDb = null;
     const ac = new AbortController();
@@ -134,19 +133,12 @@ Examples:
                     spinner.succeed(`Dry run complete(${done.processed} / ${done.total}) • would have indexed ${done.indexed} `);
                     return;
                 }
-                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: (_d = done.indexed) !== null && _d !== void 0 ? _d : 0,
-                    status: "indexed",
-                    chunkerVersion: stampedChunkerVersion,
-                });
-                const failedFiles = (_e = done.failedFiles) !== null && _e !== void 0 ? _e : 0;
+                if (done.degraded === true) {
+                    spinner.warn(`Indexing incomplete • ${(_d = done.scanErrors) !== null && _d !== void 0 ? _d : 0} scan errors • ${(_e = done.failedFiles) !== null && _e !== void 0 ? _e : 0} failed`);
+                    process.exitCode = 1;
+                    return;
+                }
+                const failedFiles = (_f = done.failedFiles) !== null && _f !== void 0 ? _f : 0;
                 const failedSuffix = failedFiles > 0 ? ` • ${failedFiles} failed` : "";
                 spinner.succeed(`Indexing complete(${done.processed} / ${done.total}) • indexed ${done.indexed}${failedSuffix} `);
             }
@@ -166,7 +158,7 @@ Examples:
                 try {
                     process.kill(watcher.pid, "SIGTERM");
                 }
-                catch (_f) { }
+                catch (_g) { }
                 for (let i = 0; i < 50; i++) {
                     if (!(0, watcher_store_1.isProcessRunning)(watcher.pid))
                         break;
@@ -196,17 +188,24 @@ Examples:
                     }));
                     return;
                 }
-                const globalConfig = (0, index_config_1.readGlobalConfig)();
-                (0, project_registry_1.registerProject)({
+                if (result.degraded) {
+                    spinner.warn(`Indexing incomplete • ${result.scanErrors} scan errors • ${result.failedFiles} failed`);
+                    process.exitCode = 1;
+                    return;
+                }
+                const prefix = projectRoot.endsWith("/")
+                    ? projectRoot
+                    : `${projectRoot}/`;
+                const chunkCount = yield vectorDb.countRowsForPath(prefix);
+                (0, project_registry_1.stampProjectFullSync)({
                     root: projectRoot,
                     name: path.basename(projectRoot),
-                    vectorDim: globalConfig.vectorDim,
-                    modelTier: globalConfig.modelTier,
-                    embedMode: globalConfig.embedMode,
-                    lastIndexed: new Date().toISOString(),
-                    chunkCount: result.indexed,
-                    status: "indexed",
+                    generation: result.generation,
+                    embedMode: result.embedMode,
+                    chunkCount,
                     chunkerVersion: stampedChunkerVersion,
+                    expectedFingerprint: result.registryExpectation.embeddingFingerprint,
+                    expectedRebuildId: result.registryExpectation.rebuildId,
                 });
                 const failedSuffix = result.failedFiles > 0 ? ` • ${result.failedFiles} failed` : "";
                 spinner.succeed(`Indexing complete(${result.processed} / ${result.total}) • indexed ${result.indexed}${failedSuffix} `);

package/dist/commands/list.js

@@ -47,6 +47,7 @@ const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
+const embedding_status_1 = require("../lib/index/embedding-status");
 const index_config_1 = require("../lib/index/index-config");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
@@ -123,7 +124,7 @@ exports.list = new commander_1.Command("list")
 }));
 function showCurrentProject() {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d;
+        var _a;
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(process.cwd())) !== null && _a !== void 0 ? _a : process.cwd();
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         const entries = [
@@ -132,13 +133,17 @@ function showCurrentProject() {
         ];
         console.log(`\n${style.bold("Project")}: ${style.green(projectRoot)}`);
         console.log(`${style.dim("Data directory")}: ${paths.dataDir}\n`);
-        const config = (0, index_config_1.readIndexConfig)(paths.configPath);
-        if (config) {
-            console.log(`${style.dim("Model")}: ${(_b = config.modelTier) !== null && _b !== void 0 ? _b : "small"} (${(_c = config.vectorDim) !== null && _c !== void 0 ? _c : 384}d)`);
-            console.log(`${style.dim("Mode")}: ${(_d = config.embedMode) !== null && _d !== void 0 ? _d : "cpu"}`);
-            if (config.indexedAt) {
-                console.log(`${style.dim("Indexed")}: ${formatDate(new Date(config.indexedAt))}`);
+        const globalConfig = (0, index_config_1.readGlobalConfig)();
+        const project = (0, project_registry_1.getProject)(projectRoot);
+        if (project) {
+            const identity = (0, embedding_status_1.projectEmbeddingStatus)(project, globalConfig);
+            console.log(`${style.dim("Configured embedding")}: ${identity.configured.tier} (${identity.configured.vectorDim}d)`);
+            if (identity.built) {
+                console.log(`${style.dim("Built embedding")}: ${identity.built.tier} (${identity.built.vectorDim}d, ${identity.state})`);
             }
+            console.log(`${style.dim("Mode")}: ${globalConfig.embedMode}`);
+            if (project.lastIndexed)
+                console.log(`${style.dim("Indexed")}: ${formatDate(new Date(project.lastIndexed))}`);
             console.log();
         }
         for (const entry of entries) {
@@ -167,17 +172,21 @@ function showAllProjects() {
         // Header
         console.log(`${style.bold(pad("Project", nameWidth))}  ${style.bold(pad("Path", pathWidth))}  ${style.bold("Dims")}  ${style.bold("Status")}`);
         for (const project of projects) {
-            const dimMatch = project.vectorDim === globalConfig.vectorDim;
+            const identity = (0, embedding_status_1.projectEmbeddingStatus)(project, globalConfig);
             const dimsStr = `${project.vectorDim}d`;
-            const status = dimMatch
-                ? style.green("ok")
-                : style.yellow("reindex needed");
+            const status = identity.state === "current"
+                ? style.green("current")
+                : identity.state === "legacy"
+                    ? style.yellow("legacy")
+                    : identity.state === "stale"
+                        ? style.red("stale")
+                        : style.dim("unbuilt");
             console.log(`${pad(project.name, nameWidth)}  ${style.dim(pad(shortenPath(project.root), pathWidth))}  ${pad(dimsStr, 4)}  ${status}`);
         }
         console.log(`\n${style.dim("Global config")}: ${globalConfig.modelTier} (${globalConfig.vectorDim}d), ${globalConfig.embedMode}`);
-        const needsReindex = projects.filter((p) => p.vectorDim !== globalConfig.vectorDim);
-        if (needsReindex.length > 0) {
-            console.log(style.yellow(`\n${needsReindex.length} project(s) need reindexing. Search will auto-reindex on first use.`));
+        const stale = projects.filter((project) => (0, embedding_status_1.projectEmbeddingStatus)(project, globalConfig).state === "stale");
+        if (stale.length > 0) {
+            console.log(style.yellow(`\n${stale.length} project(s) use a stale embedding generation. Existing indexes are preserved; run 'gmax repair --rebuild' to rebuild the whole corpus.`));
         }
     });
 }