grepmax 0.7.8 → 0.7.9

package/dist/commands/mcp.js

@@ -120,6 +120,10 @@ 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.",
+                },
             },
             required: ["query"],
         },
@@ -174,6 +178,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 +549,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}` : "") +
@@ -590,6 +621,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 +686,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 +798,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 +814,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 +830,8 @@ exports.mcp = new commander_1.Command("mcp")
                                 count: 1,
                                 path: rowPath,
                                 line: Math.max(1, line + 1),
+                                role,
+                                exported,
                             });
                         }
                     }
@@ -780,7 +850,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.9",
   "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.9",
   "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,6 +40,7 @@ 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.
@@ -70,11 +71,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.