grepmax 0.16.0 → 0.16.1

package/dist/commands/extract.js

@@ -50,6 +50,7 @@ const vector_db_1 = require("../lib/store/vector-db");
 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 project_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
@@ -128,6 +129,25 @@ exports.extract = new commander_1.Command("extract")
             process.exitCode = 1;
             return;
         }
+        // Cross-language disambiguation: when the symbol is defined in 2+
+        // languages, refuse to silently pick one. Listing all matches with a
+        // recovery hint avoids the dogfooded failure mode where peek picked
+        // Swift but listed TS callers.
+        const byLang = (0, language_1.groupByLanguage)(chunks);
+        if (byLang.size >= 2) {
+            const rel = (p) => p.startsWith(projectRoot) ? p.slice(projectRoot.length + 1) : p;
+            const lines = [
+                `Symbol '${symbol}' is defined in multiple languages:`,
+            ];
+            for (const [lang, group] of byLang) {
+                const c = group[0];
+                lines.push(`  ${lang.padEnd(6)} ${rel(c.path)}:${c.startLine + 1}`);
+            }
+            lines.push(`Disambiguate with --root or pin to a path: gmax extract ${symbol} --root <project-root>`);
+            console.log(lines.join("\n"));
+            process.exitCode = 1;
+            return;
+        }
         const best = pickBestMatch(chunks, symbol);
         const content = fs.readFileSync(best.path, "utf-8");
         const allLines = content.split("\n");

package/dist/commands/peek.js

@@ -50,6 +50,7 @@ const graph_builder_1 = require("../lib/graph/graph-builder");
 const vector_db_1 = require("../lib/store/vector-db");
 const exit_1 = require("../lib/utils/exit");
 const filter_builder_1 = require("../lib/utils/filter-builder");
+const language_1 = require("../lib/utils/language");
 const project_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
@@ -104,6 +105,41 @@ exports.peek = new commander_1.Command("peek")
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
+        // Cross-language disambiguation: when the symbol is defined in 2+
+        // languages, refuse to silently pick one. The graph builder otherwise
+        // picks one chunk arbitrarily and lists callers from a different
+        // language — verified failure mode.
+        {
+            const tableForCheck = yield vectorDb.ensureTable();
+            const prefixForCheck = projectRoot.endsWith("/")
+                ? projectRoot
+                : `${projectRoot}/`;
+            const allDefs = yield tableForCheck
+                .query()
+                .select(["path", "start_line"])
+                .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefixForCheck)}%'`)
+                .limit(20)
+                .toArray();
+            const chunks = allDefs.map((row) => ({
+                path: String(row.path || ""),
+                startLine: Number(row.start_line || 0),
+            }));
+            const byLang = (0, language_1.groupByLanguage)(chunks);
+            if (byLang.size >= 2) {
+                const rel = (p) => p.startsWith(projectRoot) ? p.slice(projectRoot.length + 1) : p;
+                const lines = [
+                    `Symbol '${symbol}' is defined in multiple languages:`,
+                ];
+                for (const [lang, group] of byLang) {
+                    const c = group[0];
+                    lines.push(`  ${lang.padEnd(6)} ${rel(c.path)}:${c.startLine + 1}`);
+                }
+                lines.push(`Disambiguate with --root or pin to a path: gmax peek ${symbol} --root <project-root>`);
+                console.log(lines.join("\n"));
+                process.exitCode = 1;
+                return;
+            }
+        }
         const graphBuilder = new graph_builder_1.GraphBuilder(vectorDb, projectRoot);
         const graph = yield graphBuilder.buildGraph(symbol);
         if (!graph.center) {

package/dist/commands/remove.js

@@ -43,6 +43,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.remove = void 0;
+const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const readline = __importStar(require("node:readline"));
 const commander_1 = require("commander");
@@ -68,12 +69,13 @@ function confirm(message) {
 }
 exports.remove = new commander_1.Command("remove")
     .description("Remove a project from the gmax index")
-    .argument("[dir]", "Directory to remove (defaults to current directory)")
+    .argument("[dir-or-name]", "Directory or registered project name (defaults to current directory)")
     .option("-f, --force", "Skip confirmation prompt", false)
     .addHelpText("after", `
 Examples:
   gmax remove                  Remove the current project
-  gmax remove ~/projects/app   Remove a specific project
+  gmax remove ~/projects/app   Remove a specific project by path
+  gmax remove my-app           Remove a registered project by name
   gmax remove --force          Skip confirmation
 `)
     .action((dir, opts) => __awaiter(void 0, void 0, void 0, function* () {
@@ -81,7 +83,41 @@ Examples:
     let vectorDb = null;
     let metaCache = null;
     try {
-        const targetDir = dir ? path.resolve(dir) : process.cwd();
+        // Resolve name → registered root when arg has no path separator and isn't a dir.
+        // Avoids the footgun where a typo'd name silently removed the cwd project.
+        let resolvedDir = dir;
+        if (dir &&
+            !dir.includes("/") &&
+            !dir.includes("\\") &&
+            !fs.existsSync(path.resolve(dir))) {
+            const matches = (0, project_registry_1.listProjects)().filter((p) => p.name === dir);
+            if (matches.length === 0) {
+                console.error(`No registered project named "${dir}".`);
+                const all = (0, project_registry_1.listProjects)();
+                if (all.length > 0) {
+                    console.error("Available projects:");
+                    for (const p of all) {
+                        console.error(`  ${p.name.padEnd(24)} ${p.root}`);
+                    }
+                }
+                else {
+                    console.error("No projects are currently registered.");
+                }
+                process.exitCode = 1;
+                return;
+            }
+            if (matches.length > 1) {
+                console.error(`Multiple registered projects named "${dir}":`);
+                for (const p of matches) {
+                    console.error(`  ${p.root}`);
+                }
+                console.error("Pass an absolute path to disambiguate.");
+                process.exitCode = 1;
+                return;
+            }
+            resolvedDir = matches[0].root;
+        }
+        const targetDir = resolvedDir ? path.resolve(resolvedDir) : process.cwd();
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(targetDir)) !== null && _a !== void 0 ? _a : targetDir;
         const projectName = path.basename(projectRoot);
         const project = (0, project_registry_1.getProject)(projectRoot);

package/dist/commands/search.js

@@ -743,10 +743,12 @@ Examples:
                     }
                     const sym = symbol ? ` ${symbol}` : "";
                     const rl = role ? ` [${role}]` : "";
+                    const score = r.score;
+                    const scoreCol = typeof score === "number" ? `\ts=${score.toFixed(3)}` : "";
                     const explainSuffix = options.explain && r.scoreBreakdown
                         ? `\texplain:rerank=${r.scoreBreakdown.rerank.toFixed(3)},fused=${r.scoreBreakdown.fused.toFixed(3)},boost=${r.scoreBreakdown.boost.toFixed(2)}x,score=${r.scoreBreakdown.normalized.toFixed(3)}`
                         : "";
-                    console.log(`${relPath}:${startLine}${sym}${rl}${hint}${explainSuffix}`);
+                    console.log(`${relPath}:${startLine}${scoreCol}${sym}${rl}${hint}${explainSuffix}`);
                 }
             }
             // Agent trace (compact)

package/dist/commands/skeleton.js

@@ -61,7 +61,6 @@ const setup_helpers_1 = require("../lib/setup/setup-helpers");
 const retriever_1 = require("../lib/skeleton/retriever");
 const skeletonizer_1 = require("../lib/skeleton/skeletonizer");
 const vector_db_1 = require("../lib/store/vector-db");
-const file_utils_1 = require("../lib/utils/file-utils");
 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");
@@ -156,27 +155,18 @@ Examples:
         };
         // Determine mode based on target
         const resolvedTarget = path.resolve(target);
-        // Directory mode
+        // Directory mode is unsupported. Auto-picking files from a directory
+        // was confusingly magical (and on '.' it fell through to the resolver
+        // path and skeletonized .gitignore). Refuse and point at the file form.
         if (fs.existsSync(resolvedTarget) &&
             fs.statSync(resolvedTarget).isDirectory()) {
-            const entries = fs.readdirSync(resolvedTarget, {
-                withFileTypes: true,
-            });
-            const files = entries
-                .filter((e) => e.isFile() &&
-                (0, file_utils_1.isIndexableFile)(path.join(resolvedTarget, e.name)))
-                .map((e) => path.join(resolvedTarget, e.name))
-                .slice(0, Number.parseInt(options.limit, 10));
-            if (files.length === 0) {
-                console.error(`No indexable files in ${target}`);
-                process.exitCode = 1;
-                return;
-            }
-            for (const filePath of files) {
-                const content = fs.readFileSync(filePath, "utf-8");
-                const result = yield skeletonizer.skeletonizeFile(filePath, content, skeletonOpts);
-                outputResult(result, options);
-            }
+            console.error([
+                "skeleton expects a file or symbol, not a directory.",
+                "Try:",
+                "  gmax skeleton src/foo.ts        # one file's structure",
+                '  gmax search "<topic>" --agent   # find relevant files first',
+            ].join("\n"));
+            process.exitCode = 1;
             return;
         }
         // Batch mode (comma-separated)

package/dist/lib/daemon/daemon.js

@@ -397,8 +397,22 @@ class Daemon {
                 },
             });
             this.processors.set(root, processor);
-            // Subscribe with @parcel/watcher — native backend, no polling
-            yield this.subscribeWatcher(root, processor);
+            // Subscribe with @parcel/watcher — native backend, no polling.
+            // If the kernel refuses (e.g. FSEvents slots stuck after a prior kill -9
+            // — see docs/known-limitations.md), fall straight through to poll mode.
+            // The retry/backoff path inside recoverWatcher is for transient overflows,
+            // not hard kernel-level subscribe failures, so we skip it on startup by
+            // priming failCount past MAX before invoking it.
+            try {
+                yield this.subscribeWatcher(root, processor);
+            }
+            catch (err) {
+                const name = path.basename(root);
+                console.error(`[daemon:${name}] Subscribe failed at startup (${err instanceof Error ? err.message : err}) — switching to poll mode`);
+                this.watcherFailCount.set(root, 1000); // > MAX_WATCHER_RETRIES
+                this.lastOverflowMs.set(root, Date.now());
+                this.recoverWatcher(root, processor);
+            }
             (0, watcher_store_1.registerWatcher)({
                 pid: process.pid,
                 projectRoot: root,

package/dist/lib/index/chunker.js

@@ -362,6 +362,14 @@ class TreeSitterChunker {
                 const allowedParents = ["program", "module", "source_file", "class_body", "export_statement"];
                 if (parentType && !allowedParents.includes(parentType))
                     return false;
+                // Exported declarations are part of the API surface, so always index
+                // them regardless of RHS shape. Without this, files whose only export
+                // is `export const typeDefs = gql\`...\`` (template literals, object
+                // literals, or non-PascalCase consts) had no defined_symbols entry
+                // and peek/extract returned "Symbol not found".
+                if (parentType === "export_statement" || parentType === "export_declaration") {
+                    return true;
+                }
                 const text = node.text || "";
                 if (text.includes("=>"))
                     return true;

package/dist/lib/utils/language.js

@@ -0,0 +1,91 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.languageOf = languageOf;
+exports.groupByLanguage = groupByLanguage;
+const path = __importStar(require("node:path"));
+const EXTENSION_TO_LANGUAGE = {
+    ".ts": "ts",
+    ".tsx": "ts",
+    ".js": "js",
+    ".jsx": "js",
+    ".mjs": "js",
+    ".cjs": "js",
+    ".py": "py",
+    ".swift": "swift",
+    ".kt": "kotlin",
+    ".kts": "kotlin",
+    ".go": "go",
+    ".rs": "rust",
+    ".rb": "ruby",
+    ".java": "java",
+    ".c": "c",
+    ".h": "c",
+    ".cpp": "cpp",
+    ".cc": "cpp",
+    ".hpp": "cpp",
+    ".cs": "csharp",
+    ".php": "php",
+    ".lua": "lua",
+    ".sh": "bash",
+    ".bash": "bash",
+    ".zsh": "bash",
+    ".sql": "sql",
+    ".md": "md",
+    ".mdx": "md",
+    ".json": "json",
+    ".yaml": "yaml",
+    ".yml": "yaml",
+    ".toml": "toml",
+};
+function languageOf(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (EXTENSION_TO_LANGUAGE[ext])
+        return EXTENSION_TO_LANGUAGE[ext];
+    const fallback = ext.replace(/^\./, "");
+    return fallback || "unknown";
+}
+function groupByLanguage(chunks) {
+    const out = new Map();
+    for (const c of chunks) {
+        const lang = languageOf(c.path);
+        const arr = out.get(lang);
+        if (arr)
+            arr.push(c);
+        else
+            out.set(lang, [c]);
+    }
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "author": "Robert Owens <78518764+reowens@users.noreply.github.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

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

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.16.0",
+  "version": "0.16.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

@@ -176,7 +176,7 @@ async function main() {
     hookSpecificOutput: {
       hookEventName: "SessionStart",
       additionalContext:
-        'gmax ready. Use Bash(gmax "query" --agent) for search (one line per result, 89% fewer tokens). Bash(gmax extract <symbol>) for full function body. Bash(gmax peek <symbol>) for quick overview (sig+callers+callees). Bash(gmax trace <symbol>) for call graphs. Bash(gmax skeleton <path>) for structure. Bash(gmax diff [ref]) for git changes. Bash(gmax test <symbol>) for test coverage. Bash(gmax impact <symbol>) for blast radius. Bash(gmax similar <symbol>) for similar code. Bash(gmax context "topic" --budget 4000) for topic summary. Bash(gmax status) to check indexed projects. --agent flag works on search, trace, symbols, related, recent, status, project, extract, peek, diff, test, impact, similar. If search says "not added yet", run Bash(gmax add). If results look stale, run Bash(gmax index) to repair.',
+        'gmax ready. Use Bash(gmax "query" --agent) for search (one line per result, 89% fewer tokens). Bash(gmax extract <symbol>) for full function body. Bash(gmax peek <symbol>) for quick overview (sig+callers+callees). Bash(gmax trace <symbol>) for call graphs. Bash(gmax skeleton <path>) for structure. Bash(gmax diff [ref]) for git changes. Bash(gmax test <symbol>) for test coverage. Bash(gmax impact <symbol>) for blast radius. Bash(gmax similar <symbol>) for similar code. Bash(gmax context "topic" --budget 4000) for topic summary. Bash(gmax status) to check indexed projects. Role tags in results: [DEFI]=definition, [ORCH]=orchestration, [IMPL]=implementation, [DOCS]=docs. --agent flag works on search, trace, symbols, related, recent, status, project, extract, peek, diff, test, impact, similar. If search says "not added yet", run Bash(gmax add). If results look stale, run Bash(gmax index) to repair.',
     },
   };
   process.stdout.write(JSON.stringify(response));