grepmax 0.7.8 → 0.7.10

package/dist/commands/mcp.js

@@ -120,6 +120,14 @@ const TOOLS = [
                     type: "string",
                     description: "Filter by chunk role: 'ORCHESTRATION' (logic/flow), 'DEFINITION' (types/classes), or 'IMPLEMENTATION'.",
                 },
+                context_lines: {
+                    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"],
         },
@@ -174,6 +182,10 @@ const TOOLS = [
                     type: "string",
                     description: "Comma-separated project names to exclude (e.g. 'capstone,power').",
                 },
+                context_lines: {
+                    type: "number",
+                    description: "Include N lines before/after chunk. Only with detail 'code' or 'full'. Max 20.",
+                },
             },
             required: ["query"],
         },
@@ -541,19 +553,42 @@ exports.mcp = new commander_1.Command("mcp")
                         ? `  ${parentStr}${callsStr}`
                         : "";
                     let snippet = "";
+                    const contextN = typeof args.context_lines === "number"
+                        ? Math.min(Math.max(args.context_lines, 0), 20)
+                        : 0;
                     if (detail === "code" || detail === "full") {
-                        const raw = typeof r.content === "string"
-                            ? r.content
-                            : typeof r.text === "string"
-                                ? r.text
-                                : "";
-                        const allLines = raw.split("\n");
-                        const linesToShow = detail === "full" ? allLines : allLines.slice(0, 4);
-                        snippet =
-                            "\n" +
-                                linesToShow
-                                    .map((l, i) => `${startLine + i + 1}│${l}`)
-                                    .join("\n");
+                        if (contextN > 0 && absPath) {
+                            // Read surrounding context from file
+                            try {
+                                const fileContent = fs.readFileSync(absPath, "utf-8");
+                                const fileLines = fileContent.split("\n");
+                                const ctxStart = Math.max(0, startLine - contextN);
+                                const ctxEnd = Math.min(fileLines.length, endLine + 1 + contextN);
+                                snippet =
+                                    "\n" +
+                                        fileLines
+                                            .slice(ctxStart, ctxEnd)
+                                            .map((l, i) => `${ctxStart + i + 1}│${l}`)
+                                            .join("\n");
+                            }
+                            catch (_o) {
+                                // Fall through to chunk content
+                            }
+                        }
+                        if (!snippet) {
+                            const raw = typeof r.content === "string"
+                                ? r.content
+                                : typeof r.text === "string"
+                                    ? r.text
+                                    : "";
+                            const allLines = raw.split("\n");
+                            const linesToShow = detail === "full" ? allLines : allLines.slice(0, 4);
+                            snippet =
+                                "\n" +
+                                    linesToShow
+                                        .map((l, i) => `${startLine + i + 1}│${l}`)
+                                        .join("\n");
+                        }
                     }
                     const text = line1 +
                         (summaryStr ? `\n${summaryStr}` : "") +
@@ -578,7 +613,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}`);
                 }
@@ -590,6 +668,31 @@ exports.mcp = new commander_1.Command("mcp")
             }
         });
     }
+    function annotateSkeletonLines(skeleton, sourceContent) {
+        const sourceLines = sourceContent.split("\n");
+        const skelLines = skeleton.split("\n");
+        const used = new Set();
+        return skelLines
+            .map((skelLine) => {
+            const trimmed = skelLine.trim();
+            if (!trimmed ||
+                trimmed.startsWith("//") ||
+                trimmed.startsWith("*") ||
+                trimmed.startsWith("/*")) {
+                return skelLine;
+            }
+            // Match against source lines using first 40 chars
+            const matchStr = trimmed.slice(0, 40);
+            for (let i = 0; i < sourceLines.length; i++) {
+                if (!used.has(i) && sourceLines[i].includes(matchStr)) {
+                    used.add(i);
+                    return `${String(i + 1).padStart(4)}│${skelLine}`;
+                }
+            }
+            return skelLine;
+        })
+            .join("\n");
+    }
     function handleCodeSkeleton(args) {
         return __awaiter(this, void 0, void 0, function* () {
             const target = String(args.target || "");
@@ -630,25 +733,35 @@ exports.mcp = new commander_1.Command("mcp")
                     parts.push(`// ${t} — file not found`);
                     continue;
                 }
+                // Read source for line annotations
+                let sourceContent = "";
+                try {
+                    sourceContent = fs.readFileSync(absPath, "utf-8");
+                }
+                catch (_a) { }
                 // 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}`);
+                        const annotated = sourceContent
+                            ? annotateSkeletonLines(cached, sourceContent)
+                            : cached;
+                        parts.push(`// ${t} (~${tokens} tokens)\n\n${annotated}`);
                         continue;
                     }
                 }
-                catch (_a) {
+                catch (_b) {
                     // Index may not exist yet — fall through to live generation
                 }
                 // Generate live
                 try {
-                    const content = fs.readFileSync(absPath, "utf-8");
+                    const content = sourceContent || 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}`);
+                        const annotated = annotateSkeletonLines(result.skeleton, content);
+                        parts.push(`// ${t} (~${result.tokenEstimate} tokens)\n\n${annotated}`);
                     }
                     else {
                         parts.push(`// ${t} — skeleton failed: ${result.error}`);
@@ -732,7 +845,7 @@ exports.mcp = new commander_1.Command("mcp")
                 const table = yield db.ensureTable();
                 let query = table
                     .query()
-                    .select(["defined_symbols", "path", "start_line"])
+                    .select(["defined_symbols", "path", "start_line", "role", "is_exported"])
                     .where("array_length(defined_symbols) > 0")
                     .limit(pattern ? 10000 : Math.max(limit * 50, 2000));
                 if (pathPrefix) {
@@ -748,6 +861,8 @@ exports.mcp = new commander_1.Command("mcp")
                     const defs = toStringArray(row.defined_symbols);
                     const rowPath = String(row.path || "");
                     const line = Number(row.start_line || 0);
+                    const role = String(row.role || "");
+                    const exported = Boolean(row.is_exported);
                     for (const sym of defs) {
                         if (pattern && !sym.toLowerCase().includes(pattern.toLowerCase())) {
                             continue;
@@ -762,6 +877,8 @@ exports.mcp = new commander_1.Command("mcp")
                                 count: 1,
                                 path: rowPath,
                                 line: Math.max(1, line + 1),
+                                role,
+                                exported,
                             });
                         }
                     }
@@ -780,7 +897,9 @@ exports.mcp = new commander_1.Command("mcp")
                     const rel = e.path.startsWith(projectRoot)
                         ? e.path.slice(projectRoot.length + 1)
                         : e.path;
-                    return `${e.symbol}\t${rel}:${e.line}`;
+                    const roleTag = e.role ? ` [${e.role.slice(0, 4)}]` : "";
+                    const expTag = e.exported ? " exported" : "";
+                    return `${e.symbol}${roleTag}${expTag}\t${rel}:${e.line}`;
                 });
                 return ok(lines.join("\n"));
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.8",
+  "version": "0.7.10",
   "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.8",
+  "version": "0.7.10",
   "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

@@ -40,12 +40,14 @@ Parameters:
 - `root` (optional): Absolute path to search a different indexed directory.
 - `path` (optional): Restrict to path prefix (e.g. "src/auth/"). Relative to the search root.
 - `detail` (optional): `"pointer"` (default), `"code"` (4-line snippets), or `"full"` (complete chunk with line numbers)
+- `context_lines` (optional): Include N lines before/after the chunk (like grep -C). Only with detail "code" or "full". Max 20.
 - `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/")
 - `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
@@ -70,11 +72,13 @@ Call graph — who calls a symbol and what it calls. Callers and callees include
 - `symbol` (required): Function/method/class name
 
 ### list_symbols
-List indexed symbols with definition locations.
+List indexed symbols with definition locations, role, and export status.
 - `pattern` (optional): Filter by name (case-insensitive substring match)
 - `limit` (optional): Max results (default 20, max 100)
 - `path` (optional): Only symbols under this path prefix
 
+Output: `symbolName [ORCH] exported  src/path/file.ts:42`
+
 ### index_status
 Check centralized index health — chunks, files, indexed directories, model info, watcher status.