grepmax 0.7.10 → 0.7.11

package/dist/commands/mcp.js

@@ -268,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
@@ -998,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({
@@ -1031,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.10",
+  "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.10",
+  "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
@@ -79,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.