grepmax 0.7.13 → 0.7.15

package/dist/commands/mcp.js

@@ -293,6 +293,24 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: "related_files",
+        description: "Find files related to a given file by shared symbol references. Shows dependencies (what this file calls) and dependents (what calls this file).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "File path relative to project root (e.g. 'src/lib/index/syncer.ts')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max related files per direction (default 10)",
+                },
+            },
+            required: ["file"],
+        },
+    },
 ];
 // ---------------------------------------------------------------------------
 // Helpers
@@ -1210,6 +1228,107 @@ exports.mcp = new commander_1.Command("mcp")
             }
         });
     }
+    function handleRelatedFiles(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const file = String(args.file || "");
+            if (!file)
+                return err("Missing required parameter: file");
+            const limit = Math.min(Math.max(Number(args.limit) || 10, 1), 25);
+            const absPath = path.resolve(projectRoot, file);
+            try {
+                const db = getVectorDb();
+                const table = yield db.ensureTable();
+                const fileChunks = yield table
+                    .query()
+                    .select(["defined_symbols", "referenced_symbols"])
+                    .where(`path = '${(0, filter_builder_1.escapeSqlString)(absPath)}'`)
+                    .toArray();
+                if (fileChunks.length === 0) {
+                    return ok(`File not found in index: ${file}`);
+                }
+                const definedHere = new Set();
+                const referencedHere = new Set();
+                for (const chunk of fileChunks) {
+                    for (const s of toStringArray(chunk.defined_symbols))
+                        definedHere.add(s);
+                    for (const s of toStringArray(chunk.referenced_symbols))
+                        referencedHere.add(s);
+                }
+                // Dependencies: files that DEFINE symbols this file REFERENCES
+                const depCounts = new Map();
+                for (const sym of referencedHere) {
+                    if (definedHere.has(sym))
+                        continue;
+                    const rows = yield table
+                        .query()
+                        .select(["path"])
+                        .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(sym)}')`)
+                        .limit(3)
+                        .toArray();
+                    for (const row of rows) {
+                        const p = String(row.path || "");
+                        if (p === absPath)
+                            continue;
+                        depCounts.set(p, (depCounts.get(p) || 0) + 1);
+                    }
+                }
+                // Dependents: files that REFERENCE symbols this file DEFINES
+                const revCounts = new Map();
+                for (const sym of definedHere) {
+                    const rows = yield table
+                        .query()
+                        .select(["path"])
+                        .where(`array_contains(referenced_symbols, '${(0, filter_builder_1.escapeSqlString)(sym)}')`)
+                        .limit(20)
+                        .toArray();
+                    for (const row of rows) {
+                        const p = String(row.path || "");
+                        if (p === absPath)
+                            continue;
+                        revCounts.set(p, (revCounts.get(p) || 0) + 1);
+                    }
+                }
+                const lines = [];
+                lines.push(`Related files for ${file}:\n`);
+                const topDeps = Array.from(depCounts.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, limit);
+                if (topDeps.length > 0) {
+                    lines.push("Dependencies (files this imports/calls):");
+                    for (const [p, count] of topDeps) {
+                        const rel = p.startsWith(`${projectRoot}/`)
+                            ? p.slice(projectRoot.length + 1)
+                            : p;
+                        lines.push(`  ${rel.padEnd(40)} (${count} shared symbol${count > 1 ? "s" : ""})`);
+                    }
+                }
+                else {
+                    lines.push("Dependencies: none found");
+                }
+                lines.push("");
+                const topRevs = Array.from(revCounts.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, limit);
+                if (topRevs.length > 0) {
+                    lines.push("Dependents (files that call this):");
+                    for (const [p, count] of topRevs) {
+                        const rel = p.startsWith(`${projectRoot}/`)
+                            ? p.slice(projectRoot.length + 1)
+                            : p;
+                        lines.push(`  ${rel.padEnd(40)} (${count} shared symbol${count > 1 ? "s" : ""})`);
+                    }
+                }
+                else {
+                    lines.push("Dependents: none found");
+                }
+                return ok(lines.join("\n"));
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return err(`Related files failed: ${msg}`);
+            }
+        });
+    }
     // --- MCP server setup ---
     const transport = new stdio_js_1.StdioServerTransport();
     const server = new index_js_1.Server({
@@ -1245,6 +1364,8 @@ exports.mcp = new commander_1.Command("mcp")
                 return handleSummarizeDirectory(toolArgs);
             case "summarize_project":
                 return handleSummarizeProject(toolArgs);
+            case "related_files":
+                return handleRelatedFiles(toolArgs);
             default:
                 return err(`Unknown tool: ${name}`);
         }

package/dist/lib/index/syncer.js

@@ -58,7 +58,7 @@ const logger_1 = require("../utils/logger");
 const meta_cache_1 = require("../store/meta-cache");
 const vector_db_1 = require("../store/vector-db");
 const filter_builder_1 = require("../utils/filter-builder");
-const file_utils_1 = require("../utils/file-utils");
+// 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");
@@ -329,19 +329,13 @@ function initialSync(options) {
                         break;
                     }
                     const absPath = path.join(paths.root, relPath);
-                    // Check real path to avoid duplicates and loops
-                    try {
-                        const realPath = fs.realpathSync(absPath);
-                        if (visitedRealPaths.has(realPath))
-                            continue;
-                        visitedRealPaths.add(realPath);
-                    }
-                    catch (_g) {
-                        // Skip broken symlinks or inaccessible files
+                    // Extension check only — no stat syscall
+                    const ext = path.extname(absPath).toLowerCase();
+                    const basename = path.basename(absPath).toLowerCase();
+                    if (!config_1.INDEXABLE_EXTENSIONS.has(ext) &&
+                        !config_1.INDEXABLE_EXTENSIONS.has(basename)) {
                         continue;
                     }
-                    if (!(0, file_utils_1.isIndexableFile)(absPath))
-                        continue;
                     walkedFiles++;
                     yield schedule(() => __awaiter(this, void 0, void 0, function* () {
                         if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
@@ -349,8 +343,20 @@ function initialSync(options) {
                             return;
                         }
                         try {
-                            const stats = yield fs.promises.stat(absPath);
-                            if (!(0, file_utils_1.isIndexableFile)(absPath, stats.size)) {
+                            // Stat + symlink dedup (lstat to detect symlinks without resolving)
+                            const stats = yield fs.promises.lstat(absPath);
+                            if (stats.isSymbolicLink()) {
+                                try {
+                                    const realPath = yield fs.promises.realpath(absPath);
+                                    if (visitedRealPaths.has(realPath))
+                                        return;
+                                    visitedRealPaths.add(realPath);
+                                }
+                                catch (_a) {
+                                    return; // Broken symlink
+                                }
+                            }
+                            if (!stats.isFile() || stats.size === 0 || stats.size > config_1.MAX_FILE_SIZE_BYTES) {
                                 return;
                             }
                             // Use absolute path as the key for MetaCache

package/package.json

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

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

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

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

@@ -1,7 +1,7 @@
 ---
 name: grepmax
 description: Semantic code search. Use alongside grep - grep for exact strings, gmax for concepts.
-allowed-tools: "mcp__grepmax__semantic_search, mcp__grepmax__search_all, mcp__grepmax__code_skeleton, mcp__grepmax__trace_calls, mcp__grepmax__list_symbols, mcp__grepmax__index_status, mcp__grepmax__summarize_directory, mcp__grepmax__summarize_project, Bash(gmax:*), Read"
+allowed-tools: "mcp__grepmax__semantic_search, mcp__grepmax__search_all, mcp__grepmax__code_skeleton, mcp__grepmax__trace_calls, mcp__grepmax__list_symbols, mcp__grepmax__index_status, mcp__grepmax__summarize_directory, mcp__grepmax__summarize_project, mcp__grepmax__related_files, Bash(gmax:*), Read"
 ---
 
 ## What gmax does
@@ -85,6 +85,11 @@ Output: `symbolName [ORCH] exported  src/path/file.ts:42`
 High-level project overview — languages, directory structure, role distribution, key symbols, entry points. Use when first exploring a new codebase.
 - `root` (optional): Project root path. Defaults to current project.
 
+### related_files
+Find files related to a given file by shared symbol references. Shows dependencies (what this file calls) and dependents (what calls this file).
+- `file` (required): File path relative to project root
+- `limit` (optional): Max results per direction (default 10)
+
 ### index_status
 Check centralized index health — chunks, files, indexed directories, model info, watcher status.