grepmax 0.7.5 → 0.7.7

package/dist/commands/mcp.js

@@ -61,6 +61,7 @@ const searcher_1 = require("../lib/search/searcher");
 const retriever_1 = require("../lib/skeleton/retriever");
 const skeletonizer_1 = require("../lib/skeleton/skeletonizer");
 const vector_db_1 = require("../lib/store/vector-db");
+const file_utils_1 = require("../lib/utils/file-utils");
 const filter_builder_1 = require("../lib/utils/filter-builder");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
@@ -93,7 +94,7 @@ const TOOLS = [
                 },
                 detail: {
                     type: "string",
-                    description: "Output detail: 'pointer' (default, metadata only — symbol, location, role, calls) or 'code' (include 4-line code snippets)",
+                    description: "Output detail: 'pointer' (default, metadata only), 'code' (4-line snippets), or 'full' (complete chunk content with line numbers)",
                 },
                 min_score: {
                     type: "number",
@@ -111,6 +112,14 @@ const TOOLS = [
                     type: "string",
                     description: "Exclude files under this path prefix (e.g. 'tests/' or 'dist/').",
                 },
+                language: {
+                    type: "string",
+                    description: "Filter by file extension (e.g. 'ts', 'py', 'go'). Omit the dot.",
+                },
+                role: {
+                    type: "string",
+                    description: "Filter by chunk role: 'ORCHESTRATION' (logic/flow), 'DEFINITION' (types/classes), or 'IMPLEMENTATION'.",
+                },
             },
             required: ["query"],
         },
@@ -131,7 +140,7 @@ const TOOLS = [
                 },
                 detail: {
                     type: "string",
-                    description: "Output detail: 'pointer' (default) or 'code' (include snippets)",
+                    description: "Output detail: 'pointer' (default), 'code' (snippets), or 'full' (complete content)",
                 },
                 min_score: {
                     type: "number",
@@ -149,19 +158,31 @@ const TOOLS = [
                     type: "string",
                     description: "Exclude files under this path prefix (e.g. 'tests/').",
                 },
+                language: {
+                    type: "string",
+                    description: "Filter by file extension (e.g. 'ts', 'py').",
+                },
+                role: {
+                    type: "string",
+                    description: "Filter by role: 'ORCHESTRATION', 'DEFINITION', or 'IMPLEMENTATION'.",
+                },
             },
             required: ["query"],
         },
     },
     {
         name: "code_skeleton",
-        description: "Show the structure of a source file — all function/class/method signatures with bodies collapsed. Useful for understanding large files without reading every line. Returns ~4x fewer tokens than the full file.",
+        description: "Show the structure of source files — signatures with bodies collapsed (~4x fewer tokens). Accepts a file path, a directory path, or comma-separated file paths.",
         inputSchema: {
             type: "object",
             properties: {
                 target: {
                     type: "string",
-                    description: "File path relative to project root (e.g. 'src/services/booking.ts')",
+                    description: "File path, directory path (e.g. 'src/lib/search/'), or comma-separated files (e.g. 'src/a.ts,src/b.ts'). Relative to project root.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max files for directory mode (default 10, max 20). Ignored for single files.",
                 },
             },
             required: ["target"],
@@ -445,6 +466,12 @@ exports.mcp = new commander_1.Command("mcp")
                 if (typeof args.exclude === "string" && args.exclude) {
                     filters.exclude = args.exclude;
                 }
+                if (typeof args.language === "string" && args.language) {
+                    filters.language = args.language;
+                }
+                if (typeof args.role === "string" && args.role) {
+                    filters.role = args.role;
+                }
                 const result = yield searcher.search(query, limit, { rerank: true }, Object.keys(filters).length > 0 ? filters : undefined, pathPrefix);
                 if (!result.data || result.data.length === 0) {
                     return ok("No matches found.");
@@ -480,16 +507,17 @@ exports.mcp = new commander_1.Command("mcp")
                         ? `  ${parentStr}${callsStr}`
                         : "";
                     let snippet = "";
-                    if (detail === "code") {
+                    if (detail === "code" || detail === "full") {
                         const raw = typeof r.content === "string"
                             ? r.content
                             : typeof r.text === "string"
                                 ? r.text
                                 : "";
-                        const lines = raw.split("\n").slice(0, 4);
+                        const allLines = raw.split("\n");
+                        const linesToShow = detail === "full" ? allLines : allLines.slice(0, 4);
                         snippet =
                             "\n" +
-                                lines
+                                linesToShow
                                     .map((l, i) => `${startLine + i + 1}│${l}`)
                                     .join("\n");
                     }
@@ -533,36 +561,71 @@ exports.mcp = new commander_1.Command("mcp")
             const target = String(args.target || "");
             if (!target)
                 return err("Missing required parameter: target");
-            const absPath = path.resolve(projectRoot, target);
-            if (!fs.existsSync(absPath)) {
-                return err(`File not found: ${target}`);
+            const fileLimit = Math.min(Math.max(Number(args.limit) || 10, 1), 20);
+            // Determine targets: comma-separated, directory, or single file
+            let targets;
+            if (target.includes(",")) {
+                targets = target
+                    .split(",")
+                    .map((t) => t.trim())
+                    .filter(Boolean);
             }
-            // Try cached skeleton first (stored with absolute path)
-            try {
-                const db = getVectorDb();
-                const cached = yield (0, retriever_1.getStoredSkeleton)(db, absPath);
-                if (cached) {
-                    const tokens = Math.ceil(cached.length / 4);
-                    return ok(`// ${target} (~${tokens} tokens)\n\n${cached}`);
+            else {
+                const absPath = path.resolve(projectRoot, target);
+                if (fs.existsSync(absPath) && fs.statSync(absPath).isDirectory()) {
+                    const entries = fs.readdirSync(absPath, { withFileTypes: true });
+                    targets = entries
+                        .filter((e) => e.isFile() &&
+                        (0, file_utils_1.isIndexableFile)(path.join(absPath, e.name)))
+                        .map((e) => path.relative(projectRoot, path.join(absPath, e.name)))
+                        .slice(0, fileLimit);
+                    if (targets.length === 0) {
+                        return err(`No indexable files found in ${target}`);
+                    }
                 }
-            }
-            catch (_a) {
-                // Index may not exist yet — fall through to live generation
-            }
-            // Generate skeleton from file
-            try {
-                const content = fs.readFileSync(absPath, "utf-8");
-                const skel = yield getSkeletonizer();
-                const result = yield skel.skeletonizeFile(absPath, content);
-                if (!result.success && result.error) {
-                    return err(`Skeleton generation failed: ${result.error}`);
+                else {
+                    targets = [target];
                 }
-                return ok(`// ${target} (~${result.tokenEstimate} tokens)\n\n${result.skeleton}`);
             }
-            catch (e) {
-                const msg = e instanceof Error ? e.message : String(e);
-                return err(`Skeleton failed: ${msg}`);
+            // Generate skeletons for all targets
+            const parts = [];
+            const skel = yield getSkeletonizer();
+            for (const t of targets) {
+                const absPath = path.resolve(projectRoot, t);
+                if (!fs.existsSync(absPath)) {
+                    parts.push(`// ${t} — file not found`);
+                    continue;
+                }
+                // 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}`);
+                        continue;
+                    }
+                }
+                catch (_a) {
+                    // Index may not exist yet — fall through to live generation
+                }
+                // Generate live
+                try {
+                    const content = 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}`);
+                    }
+                    else {
+                        parts.push(`// ${t} — skeleton failed: ${result.error}`);
+                    }
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    parts.push(`// ${t} — error: ${msg}`);
+                }
             }
+            return ok(parts.join("\n\n---\n\n"));
         });
     }
     function handleTraceCalls(args) {

package/dist/lib/search/searcher.js

@@ -290,6 +290,17 @@ class Searcher {
                     : excludeFilter;
                 whereClauseParts.push(`path NOT LIKE '${(0, filter_builder_1.escapeSqlString)(absExclude)}%'`);
             }
+            // Handle language filter (by file extension)
+            const langFilter = _filters === null || _filters === void 0 ? void 0 : _filters.language;
+            if (typeof langFilter === "string" && langFilter) {
+                const ext = langFilter.startsWith(".") ? langFilter : `.${langFilter}`;
+                whereClauseParts.push(`path LIKE '%${(0, filter_builder_1.escapeSqlString)(ext)}'`);
+            }
+            // Handle role filter
+            const roleFilter = _filters === null || _filters === void 0 ? void 0 : _filters.role;
+            if (typeof roleFilter === "string" && roleFilter) {
+                whereClauseParts.push(`role = '${(0, filter_builder_1.escapeSqlString)(roleFilter)}'`);
+            }
             // Handle --def (definition) filter
             const defFilter = _filters === null || _filters === void 0 ? void 0 : _filters.def;
             if (typeof defFilter === "string" && defFilter) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "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.5",
+  "version": "0.7.7",
   "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

@@ -39,11 +39,13 @@ Parameters:
 - `limit` (optional): Max results (default 3, max 50)
 - `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) or `"code"`
+- `detail` (optional): `"pointer"` (default), `"code"` (4-line snippets), or `"full"` (complete chunk with line numbers)
 - `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"
 
 **When to use which mode:**
 - `pointer` — navigation, finding locations, understanding architecture
@@ -55,8 +57,9 @@ Search ALL indexed code across every directory. Same parameters as semantic_sear
 Use sparingly. Prefer `semantic_search` when you know which directory to search.
 
 ### code_skeleton
-File structure — signatures with bodies collapsed (~4x fewer tokens).
-- `target` (required): File path relative to project root
+File or directory structure — signatures with bodies collapsed (~4x fewer tokens).
+- `target` (required): File path, directory path (e.g. "src/lib/search/"), or comma-separated files
+- `limit` (optional): Max files for directory mode (default 10, max 20)
 
 ### trace_calls
 Call graph — who calls a symbol and what it calls. Callers and callees include file:line locations. Unscoped — follows calls across all indexed directories.