grepmax 0.7.10 → 0.7.12

package/dist/commands/mcp.js

@@ -128,6 +128,10 @@ const TOOLS = [
                     type: "string",
                     description: "Search mode: 'default' (semantic only) or 'symbol' (semantic + call graph trace appended). Use 'symbol' when query is a function/class name.",
                 },
+                include_imports: {
+                    type: "boolean",
+                    description: "Prepend the file's import/require statements to each result. Deduped per file.",
+                },
             },
             required: ["query"],
         },
@@ -186,6 +190,10 @@ const TOOLS = [
                     type: "number",
                     description: "Include N lines before/after chunk. Only with detail 'code' or 'full'. Max 20.",
                 },
+                include_imports: {
+                    type: "boolean",
+                    description: "Prepend file's import statements to each result.",
+                },
             },
             required: ["query"],
         },
@@ -268,6 +276,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
@@ -444,6 +465,49 @@ exports.mcp = new commander_1.Command("mcp")
         child.unref();
         console.log(`[MCP] Started background watcher for ${projectRoot}`);
     }
+    // --- Utilities ---
+    function extractImports(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            const lines = content.split("\n");
+            const importLines = [];
+            let inMultiLine = false;
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (inMultiLine) {
+                    importLines.push(line);
+                    if (trimmed === ")" || trimmed === ");")
+                        inMultiLine = false;
+                    continue;
+                }
+                if (!trimmed ||
+                    trimmed.startsWith("//") ||
+                    trimmed.startsWith("#") ||
+                    trimmed.startsWith("*") ||
+                    trimmed.startsWith("/*")) {
+                    continue;
+                }
+                if (trimmed.startsWith("import ") ||
+                    trimmed.startsWith("from ") ||
+                    (trimmed.startsWith("const ") && trimmed.includes("require(")) ||
+                    trimmed.startsWith("require(") ||
+                    trimmed.startsWith("use ") ||
+                    trimmed.startsWith("using ") ||
+                    trimmed.startsWith("package ")) {
+                    importLines.push(line);
+                    if (trimmed.includes("(") && !trimmed.includes(")")) {
+                        inMultiLine = true;
+                    }
+                    continue;
+                }
+                break;
+            }
+            return importLines.length > 0 ? importLines.join("\n") : "";
+        }
+        catch (_a) {
+            return "";
+        }
+    }
     // --- Tool handlers ---
     function handleSemanticSearch(args_1) {
         return __awaiter(this, arguments, void 0, function* (args, searchAll = false) {
@@ -525,6 +589,8 @@ exports.mcp = new commander_1.Command("mcp")
                 const minScore = typeof args.min_score === "number" ? args.min_score : 0;
                 const maxPerFile = typeof args.max_per_file === "number" ? args.max_per_file : 0;
                 const detail = typeof args.detail === "string" ? args.detail : "pointer";
+                const includeImports = Boolean(args.include_imports);
+                const importCache = new Map();
                 let results = result.data.map((r) => {
                     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
                     const absPath = (_c = (_a = r.path) !== null && _a !== void 0 ? _a : (_b = r.metadata) === null || _b === void 0 ? void 0 : _b.path) !== null && _c !== void 0 ? _c : "";
@@ -590,10 +656,19 @@ exports.mcp = new commander_1.Command("mcp")
                                         .join("\n");
                         }
                     }
-                    const text = line1 +
+                    let text = line1 +
                         (summaryStr ? `\n${summaryStr}` : "") +
                         (line2 ? `\n${line2}` : "") +
                         snippet;
+                    if (includeImports && absPath) {
+                        if (!importCache.has(absPath)) {
+                            importCache.set(absPath, extractImports(absPath));
+                        }
+                        const imports = importCache.get(absPath);
+                        if (imports) {
+                            text = `imports:\n${imports}\n\n${text}`;
+                        }
+                    }
                     return {
                         absPath,
                         text,
@@ -998,6 +1073,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 +1230,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.12",
   "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.12",
   "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
@@ -48,6 +48,7 @@ Parameters:
 - `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.
+- `include_imports` (optional): Prepend file's import/require statements to each result. Deduped per file — see dependencies at a glance.
 
 **When to use which mode:**
 - `pointer` — navigation, finding locations, understanding architecture
@@ -79,6 +80,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.