grepmax 0.7.4 → 0.7.6

package/dist/commands/mcp.js

@@ -61,6 +61,7 @@ const searcher_1 = require("../lib/search/searcher");
 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 filter_builder_1 = require("../lib/utils/filter-builder");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
@@ -103,6 +104,14 @@ const TOOLS = [
                     type: "number",
                     description: "Max results per file (default: no cap). Useful to get diversity across files.",
                 },
+                file: {
+                    type: "string",
+                    description: "Filter to files matching this name (e.g. 'syncer.ts'). Matches the filename, not the full path.",
+                },
+                exclude: {
+                    type: "string",
+                    description: "Exclude files under this path prefix (e.g. 'tests/' or 'dist/').",
+                },
             },
             required: ["query"],
         },
@@ -133,19 +142,31 @@ const TOOLS = [
                     type: "number",
                     description: "Max results per file (default: no cap).",
                 },
+                file: {
+                    type: "string",
+                    description: "Filter to files matching this name (e.g. 'syncer.ts').",
+                },
+                exclude: {
+                    type: "string",
+                    description: "Exclude files under this path prefix (e.g. 'tests/').",
+                },
             },
             required: ["query"],
         },
     },
     {
         name: "code_skeleton",
-        description: "Show the structure of a source file — all function/class/method signatures with bodies collapsed. Useful for understanding large files without reading every line. Returns ~4x fewer tokens than the full file.",
+        description: "Show the structure of source files — signatures with bodies collapsed (~4x fewer tokens). Accepts a file path, a directory path, or comma-separated file paths.",
         inputSchema: {
             type: "object",
             properties: {
                 target: {
                     type: "string",
-                    description: "File path relative to project root (e.g. 'src/services/booking.ts')",
+                    description: "File path, directory path (e.g. 'src/lib/search/'), or comma-separated files (e.g. 'src/a.ts,src/b.ts'). Relative to project root.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max files for directory mode (default 10, max 20). Ignored for single files.",
                 },
             },
             required: ["target"],
@@ -422,7 +443,14 @@ exports.mcp = new commander_1.Command("mcp")
                             pathPrefix += "/";
                     }
                 }
-                const result = yield searcher.search(query, limit, { rerank: true }, undefined, pathPrefix);
+                const filters = {};
+                if (typeof args.file === "string" && args.file) {
+                    filters.file = args.file;
+                }
+                if (typeof args.exclude === "string" && args.exclude) {
+                    filters.exclude = args.exclude;
+                }
+                const result = yield searcher.search(query, limit, { rerank: true }, Object.keys(filters).length > 0 ? filters : undefined, pathPrefix);
                 if (!result.data || result.data.length === 0) {
                     return ok("No matches found.");
                 }
@@ -510,36 +538,71 @@ exports.mcp = new commander_1.Command("mcp")
             const target = String(args.target || "");
             if (!target)
                 return err("Missing required parameter: target");
-            const absPath = path.resolve(projectRoot, target);
-            if (!fs.existsSync(absPath)) {
-                return err(`File not found: ${target}`);
+            const fileLimit = Math.min(Math.max(Number(args.limit) || 10, 1), 20);
+            // Determine targets: comma-separated, directory, or single file
+            let targets;
+            if (target.includes(",")) {
+                targets = target
+                    .split(",")
+                    .map((t) => t.trim())
+                    .filter(Boolean);
             }
-            // Try cached skeleton first (stored with absolute path)
-            try {
-                const db = getVectorDb();
-                const cached = yield (0, retriever_1.getStoredSkeleton)(db, absPath);
-                if (cached) {
-                    const tokens = Math.ceil(cached.length / 4);
-                    return ok(`// ${target} (~${tokens} tokens)\n\n${cached}`);
+            else {
+                const absPath = path.resolve(projectRoot, target);
+                if (fs.existsSync(absPath) && fs.statSync(absPath).isDirectory()) {
+                    const entries = fs.readdirSync(absPath, { withFileTypes: true });
+                    targets = entries
+                        .filter((e) => e.isFile() &&
+                        (0, file_utils_1.isIndexableFile)(path.join(absPath, e.name)))
+                        .map((e) => path.relative(projectRoot, path.join(absPath, e.name)))
+                        .slice(0, fileLimit);
+                    if (targets.length === 0) {
+                        return err(`No indexable files found in ${target}`);
+                    }
                 }
-            }
-            catch (_a) {
-                // Index may not exist yet — fall through to live generation
-            }
-            // Generate skeleton from file
-            try {
-                const content = fs.readFileSync(absPath, "utf-8");
-                const skel = yield getSkeletonizer();
-                const result = yield skel.skeletonizeFile(absPath, content);
-                if (!result.success && result.error) {
-                    return err(`Skeleton generation failed: ${result.error}`);
+                else {
+                    targets = [target];
                 }
-                return ok(`// ${target} (~${result.tokenEstimate} tokens)\n\n${result.skeleton}`);
             }
-            catch (e) {
-                const msg = e instanceof Error ? e.message : String(e);
-                return err(`Skeleton failed: ${msg}`);
+            // Generate skeletons for all targets
+            const parts = [];
+            const skel = yield getSkeletonizer();
+            for (const t of targets) {
+                const absPath = path.resolve(projectRoot, t);
+                if (!fs.existsSync(absPath)) {
+                    parts.push(`// ${t} — file not found`);
+                    continue;
+                }
+                // Try cached skeleton first
+                try {
+                    const db = getVectorDb();
+                    const cached = yield (0, retriever_1.getStoredSkeleton)(db, absPath);
+                    if (cached) {
+                        const tokens = Math.ceil(cached.length / 4);
+                        parts.push(`// ${t} (~${tokens} tokens)\n\n${cached}`);
+                        continue;
+                    }
+                }
+                catch (_a) {
+                    // Index may not exist yet — fall through to live generation
+                }
+                // Generate live
+                try {
+                    const content = fs.readFileSync(absPath, "utf-8");
+                    const result = yield skel.skeletonizeFile(absPath, content);
+                    if (result.success) {
+                        parts.push(`// ${t} (~${result.tokenEstimate} tokens)\n\n${result.skeleton}`);
+                    }
+                    else {
+                        parts.push(`// ${t} — skeleton failed: ${result.error}`);
+                    }
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    parts.push(`// ${t} — error: ${msg}`);
+                }
             }
+            return ok(parts.join("\n\n---\n\n"));
         });
     }
     function handleTraceCalls(args) {
@@ -570,11 +633,23 @@ exports.mcp = new commander_1.Command("mcp")
                 else {
                     lines.push("Callers: none");
                 }
-                // Callees (cap at 15)
+                // Callees with file paths
                 if (graph.callees.length > 0) {
-                    const capped = graph.callees.slice(0, 15);
-                    const suffix = graph.callees.length > 15 ? ` (+${graph.callees.length - 15} more)` : "";
-                    lines.push(`Calls: ${capped.join(", ")}${suffix}`);
+                    lines.push("Calls:");
+                    for (const callee of graph.callees.slice(0, 15)) {
+                        if (callee.file) {
+                            const rel = callee.file.startsWith(projectRoot)
+                                ? callee.file.slice(projectRoot.length + 1)
+                                : callee.file;
+                            lines.push(`  -> ${callee.symbol} ${rel}:${callee.line + 1}`);
+                        }
+                        else {
+                            lines.push(`  -> ${callee.symbol} (not indexed)`);
+                        }
+                    }
+                    if (graph.callees.length > 15) {
+                        lines.push(`  (+${graph.callees.length - 15} more)`);
+                    }
                 }
                 else {
                     lines.push("Calls: none");
@@ -695,7 +770,23 @@ exports.mcp = new commander_1.Command("mcp")
                     indexingLine,
                     "",
                     "Indexed directories:",
-                    ...projects.map((p) => { var _a; return `  ${p.name}\t${p.root}\t${(_a = p.lastIndexed) !== null && _a !== void 0 ? _a : "unknown"}`; }),
+                    ...(yield Promise.all(projects.map((p) => __awaiter(this, void 0, void 0, function* () {
+                        var _a, _b;
+                        const prefix = p.root.endsWith("/") ? p.root : `${p.root}/`;
+                        try {
+                            const table = yield db.ensureTable();
+                            const rows = yield table
+                                .query()
+                                .select(["id"])
+                                .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                                .limit(100000)
+                                .toArray();
+                            return `  ${p.name}\t${p.root}\t${(_a = p.lastIndexed) !== null && _a !== void 0 ? _a : "unknown"}\t(${rows.length} chunks)`;
+                        }
+                        catch (_c) {
+                            return `  ${p.name}\t${p.root}\t${(_b = p.lastIndexed) !== null && _b !== void 0 ? _b : "unknown"}`;
+                        }
+                    })))),
                 ].filter(Boolean);
                 return ok(lines.join("\n"));
             }

package/dist/lib/graph/graph-builder.js

@@ -69,9 +69,40 @@ class GraphBuilder {
                 : null;
             // 2. Get Callers
             const callers = yield this.getCallers(symbol);
-            // 3. Get Callees (from center)
-            const callees = center ? center.calls : [];
-            return { center, callers, callees };
+            // 3. Get Callees — resolve each to a GraphNode with file:line
+            const calleeNames = center ? center.calls.slice(0, 15) : [];
+            const calleeNodes = [];
+            for (const name of calleeNames) {
+                const esc = (0, filter_builder_1.escapeSqlString)(name);
+                const rows = yield table
+                    .query()
+                    .where(`array_contains(defined_symbols, '${esc}')`)
+                    .select([
+                    "path",
+                    "start_line",
+                    "defined_symbols",
+                    "referenced_symbols",
+                    "role",
+                    "parent_symbol",
+                    "complexity",
+                ])
+                    .limit(1)
+                    .toArray();
+                if (rows.length > 0) {
+                    calleeNodes.push(this.mapRowToNode(rows[0], name, "center"));
+                }
+                else {
+                    calleeNodes.push({
+                        symbol: name,
+                        file: "",
+                        line: 0,
+                        role: "",
+                        calls: [],
+                        calledBy: [],
+                    });
+                }
+            }
+            return { center, callers, callees: calleeNodes };
         });
     }
     mapRowToNode(row, targetSymbol, type) {

package/dist/lib/output/formatter.js

@@ -151,7 +151,12 @@ function formatTrace(graph) {
     if (graph.callees.length > 0) {
         lines.push(style.bold("Callees (What does this call?):"));
         graph.callees.forEach((callee) => {
-            lines.push(`  ${style.cyan("↓")} ${callee}`);
+            if (callee.file) {
+                lines.push(`  ${style.cyan("↓")} ${style.green(callee.symbol)} ${style.dim(`(${callee.file}:${callee.line})`)}`);
+            }
+            else {
+                lines.push(`  ${style.cyan("↓")} ${callee.symbol} ${style.dim("(not indexed)")}`);
+            }
         });
     }
     else {

package/dist/lib/search/searcher.js

@@ -277,6 +277,19 @@ class Searcher {
             if (pathPrefix) {
                 whereClauseParts.push(`path LIKE '${(0, filter_builder_1.escapeSqlString)((0, filter_builder_1.normalizePath)(pathPrefix))}%'`);
             }
+            // Handle file name filter
+            const fileFilter = _filters === null || _filters === void 0 ? void 0 : _filters.file;
+            if (typeof fileFilter === "string" && fileFilter) {
+                whereClauseParts.push(`path LIKE '%/${(0, filter_builder_1.escapeSqlString)(fileFilter)}'`);
+            }
+            // Handle exclude filter
+            const excludeFilter = _filters === null || _filters === void 0 ? void 0 : _filters.exclude;
+            if (typeof excludeFilter === "string" && excludeFilter) {
+                const absExclude = pathPrefix
+                    ? (0, filter_builder_1.normalizePath)(pathPrefix + excludeFilter)
+                    : excludeFilter;
+                whereClauseParts.push(`path NOT LIKE '${(0, filter_builder_1.escapeSqlString)(absExclude)}%'`);
+            }
             // Handle --def (definition) filter
             const defFilter = _filters === null || _filters === void 0 ? void 0 : _filters.def;
             if (typeof defFilter === "string" && defFilter) {

package/package.json

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

@@ -42,6 +42,8 @@ Parameters:
 - `detail` (optional): `"pointer"` (default) or `"code"`
 - `min_score` (optional): Filter by minimum relevance score (0-1)
 - `max_per_file` (optional): Cap results per file for diversity
+- `file` (optional): Filter to files matching this name (e.g. "syncer.ts"). Matches filename, not full path.
+- `exclude` (optional): Exclude files under this path prefix (e.g. "tests/" or "dist/")
 
 **When to use which mode:**
 - `pointer` — navigation, finding locations, understanding architecture
@@ -53,11 +55,12 @@ Search ALL indexed code across every directory. Same parameters as semantic_sear
 Use sparingly. Prefer `semantic_search` when you know which directory to search.
 
 ### code_skeleton
-File structure — signatures with bodies collapsed (~4x fewer tokens).
-- `target` (required): File path relative to project root
+File or directory structure — signatures with bodies collapsed (~4x fewer tokens).
+- `target` (required): File path, directory path (e.g. "src/lib/search/"), or comma-separated files
+- `limit` (optional): Max files for directory mode (default 10, max 20)
 
 ### trace_calls
-Call graph — who calls a symbol and what it calls. Unscoped — follows calls across all indexed directories.
+Call graph — who calls a symbol and what it calls. Callers and callees include file:line locations. Unscoped — follows calls across all indexed directories.
 - `symbol` (required): Function/method/class name
 
 ### list_symbols