grepmax 0.7.9 → 0.7.11

package/dist/commands/mcp.js

@@ -124,6 +124,10 @@ const TOOLS = [
                     type: "number",
                     description: "Include N lines before and after the chunk (like grep -C). Only with detail 'code' or 'full'. Max 20.",
                 },
+                mode: {
+                    type: "string",
+                    description: "Search mode: 'default' (semantic only) or 'symbol' (semantic + call graph trace appended). Use 'symbol' when query is a function/class name.",
+                },
             },
             required: ["query"],
         },
@@ -264,6 +268,19 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: "summarize_project",
+        description: "High-level overview of an indexed project — languages, directory structure, role distribution, key symbols, and entry points. Use when first exploring a codebase.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                root: {
+                    type: "string",
+                    description: "Project root (absolute path). Defaults to current project.",
+                },
+            },
+        },
+    },
 ];
 // ---------------------------------------------------------------------------
 // Helpers
@@ -609,7 +626,50 @@ exports.mcp = new commander_1.Command("mcp")
                         return true;
                     });
                 }
-                const output = results.map((r) => r.text).join("\n\n");
+                let output = results.map((r) => r.text).join("\n\n");
+                // Symbol mode: append call graph
+                const mode = typeof args.mode === "string" ? args.mode : "default";
+                if (mode === "symbol" && !searchAll) {
+                    try {
+                        const db = getVectorDb();
+                        const builder = new graph_builder_1.GraphBuilder(db);
+                        const graph = yield builder.buildGraph(query);
+                        if (graph.center) {
+                            const traceLines = ["", "--- Call graph ---"];
+                            const centerRel = graph.center.file.startsWith(projectRoot)
+                                ? graph.center.file.slice(projectRoot.length + 1)
+                                : graph.center.file;
+                            traceLines.push(`${graph.center.symbol} [${graph.center.role}] ${centerRel}:${graph.center.line + 1}`);
+                            if (graph.callers.length > 0) {
+                                traceLines.push("Callers:");
+                                for (const caller of graph.callers) {
+                                    const rel = caller.file.startsWith(projectRoot)
+                                        ? caller.file.slice(projectRoot.length + 1)
+                                        : caller.file;
+                                    traceLines.push(`  <- ${caller.symbol} ${rel}:${caller.line + 1}`);
+                                }
+                            }
+                            if (graph.callees.length > 0) {
+                                traceLines.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;
+                                        traceLines.push(`  -> ${callee.symbol} ${rel}:${callee.line + 1}`);
+                                    }
+                                    else {
+                                        traceLines.push(`  -> ${callee.symbol} (not indexed)`);
+                                    }
+                                }
+                            }
+                            output += `\n${traceLines.join("\n")}`;
+                        }
+                    }
+                    catch (_b) {
+                        // Trace failed — return search results without trace
+                    }
+                }
                 if ((_a = result.warnings) === null || _a === void 0 ? void 0 : _a.length) {
                     return ok(`${result.warnings.join("\n")}\n\n${output}`);
                 }
@@ -951,6 +1011,130 @@ exports.mcp = new commander_1.Command("mcp")
             }
         });
     }
+    function handleSummarizeProject(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const root = typeof args.root === "string"
+                ? path.resolve(args.root)
+                : projectRoot;
+            const prefix = root.endsWith("/") ? root : `${root}/`;
+            const projectName = path.basename(root);
+            try {
+                const db = getVectorDb();
+                const table = yield db.ensureTable();
+                const rows = yield table
+                    .query()
+                    .select([
+                    "path",
+                    "role",
+                    "is_exported",
+                    "complexity",
+                    "defined_symbols",
+                    "referenced_symbols",
+                ])
+                    .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                    .limit(200000)
+                    .toArray();
+                if (rows.length === 0) {
+                    return ok(`No indexed data found for ${root}. Run: gmax index --path ${root}`);
+                }
+                const files = new Set();
+                const extCounts = new Map();
+                const dirCounts = new Map();
+                const roleCounts = new Map();
+                const symbolRefs = new Map();
+                const entryPoints = [];
+                for (const row of rows) {
+                    const p = String(row.path || "");
+                    const role = String(row.role || "IMPLEMENTATION");
+                    const exported = Boolean(row.is_exported);
+                    const complexity = Number(row.complexity || 0);
+                    const defs = toStringArray(row.defined_symbols);
+                    const refs = toStringArray(row.referenced_symbols);
+                    files.add(p);
+                    const ext = path.extname(p).toLowerCase() || path.basename(p);
+                    extCounts.set(ext, (extCounts.get(ext) || 0) + 1);
+                    const rel = p.startsWith(prefix)
+                        ? p.slice(prefix.length)
+                        : p;
+                    const parts = rel.split("/");
+                    const dir = parts.length > 2
+                        ? `${parts.slice(0, 2).join("/")}/`
+                        : parts.length > 1
+                            ? `${parts[0]}/`
+                            : "(root)";
+                    if (!dirCounts.has(dir)) {
+                        dirCounts.set(dir, { files: new Set(), chunks: 0 });
+                    }
+                    const dc = dirCounts.get(dir);
+                    dc.files.add(p);
+                    dc.chunks++;
+                    roleCounts.set(role, (roleCounts.get(role) || 0) + 1);
+                    for (const ref of refs) {
+                        symbolRefs.set(ref, (symbolRefs.get(ref) || 0) + 1);
+                    }
+                    if (exported &&
+                        role === "ORCHESTRATION" &&
+                        complexity >= 5 &&
+                        defs.length > 0) {
+                        const relPath = p.startsWith(prefix)
+                            ? p.slice(prefix.length)
+                            : p;
+                        entryPoints.push({ symbol: defs[0], path: relPath });
+                    }
+                }
+                const lines = [];
+                const projects = (0, project_registry_1.listProjects)();
+                const proj = projects.find((p) => p.root === root);
+                lines.push(`Project: ${projectName} (${root})`);
+                lines.push(`Last indexed: ${(_a = proj === null || proj === void 0 ? void 0 : proj.lastIndexed) !== null && _a !== void 0 ? _a : "unknown"} • ${rows.length} chunks • ${files.size} files`);
+                lines.push("");
+                const extEntries = Array.from(extCounts.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, 8);
+                const langLine = extEntries
+                    .map(([ext, count]) => `${ext} (${Math.round((count / rows.length) * 100)}%)`)
+                    .join(", ");
+                lines.push(`Languages: ${langLine}`);
+                lines.push("");
+                lines.push("Directory structure:");
+                const dirEntries = Array.from(dirCounts.entries())
+                    .sort((a, b) => b[1].chunks - a[1].chunks)
+                    .slice(0, 12);
+                for (const [dir, data] of dirEntries) {
+                    lines.push(`  ${dir.padEnd(25)} (${data.files.size} files, ${data.chunks} chunks)`);
+                }
+                lines.push("");
+                const roleEntries = Array.from(roleCounts.entries()).sort((a, b) => b[1] - a[1]);
+                const roleLine = roleEntries
+                    .map(([role, count]) => `${Math.round((count / rows.length) * 100)}% ${role}`)
+                    .join(", ");
+                lines.push(`Roles: ${roleLine}`);
+                lines.push("");
+                const topSymbols = Array.from(symbolRefs.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, 8);
+                if (topSymbols.length > 0) {
+                    lines.push("Key symbols (by reference count):");
+                    for (const [sym, count] of topSymbols) {
+                        lines.push(`  ${sym.padEnd(25)} (referenced ${count}x)`);
+                    }
+                    lines.push("");
+                }
+                if (entryPoints.length > 0) {
+                    lines.push("Entry points (exported orchestration):");
+                    for (const ep of entryPoints.slice(0, 10)) {
+                        lines.push(`  ${ep.symbol.padEnd(25)} ${ep.path}`);
+                    }
+                }
+                return ok(lines.join("\n"));
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return err(`Project summary failed: ${msg}`);
+            }
+        });
+    }
     // --- MCP server setup ---
     const transport = new stdio_js_1.StdioServerTransport();
     const server = new index_js_1.Server({
@@ -984,6 +1168,8 @@ exports.mcp = new commander_1.Command("mcp")
                 return handleIndexStatus();
             case "summarize_directory":
                 return handleSummarizeDirectory(toolArgs);
+            case "summarize_project":
+                return handleSummarizeProject(toolArgs);
             default:
                 return err(`Unknown tool: ${name}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.9",
+  "version": "0.7.11",
   "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.9",
+  "version": "0.7.11",
   "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, 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, Bash(gmax:*), Read"
 ---
 
 ## What gmax does
@@ -47,6 +47,7 @@ Parameters:
 - `exclude` (optional): Exclude files under this path prefix (e.g. "tests/" or "dist/")
 - `language` (optional): Filter by file extension (e.g. "ts", "py", "go"). Omit the dot.
 - `role` (optional): Filter by chunk role: "ORCHESTRATION" (logic/flow), "DEFINITION" (types), or "IMPLEMENTATION"
+- `mode` (optional): `"default"` (semantic only) or `"symbol"` (semantic + call graph appended). Use "symbol" when query is a function or class name — gets search results + callers/callees in one call.
 
 **When to use which mode:**
 - `pointer` — navigation, finding locations, understanding architecture
@@ -78,6 +79,10 @@ List indexed symbols with definition locations, role, and export status.
 
 Output: `symbolName [ORCH] exported  src/path/file.ts:42`
 
+### summarize_project
+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.
+
 ### index_status
 Check centralized index health — chunks, files, indexed directories, model info, watcher status.