grepmax 0.11.2 → 0.11.3

package/dist/commands/opencode.js

@@ -19,7 +19,8 @@ const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const commander_1 = require("commander");
 const TOOL_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".config", "opencode", "tool", "gmax.ts");
-const PLUGIN_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".config", "opencode", "plugin", "gmax.ts");
+const PLUGIN_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".config", "opencode", "plugins", "gmax.ts");
+const LEGACY_PLUGIN_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".config", "opencode", "plugin", "gmax.ts");
 const CONFIG_PATH = node_path_1.default.join(node_os_1.default.homedir(), ".config", "opencode", "opencode.json");
 function resolveGmaxBin() {
     try {
@@ -42,85 +43,65 @@ const SKILL = \`
 ---
 name: gmax
 description: Semantic code search. Use alongside grep - grep for exact strings, gmax for concepts.
-allowed-tools: "Bash(gmax:*), Read"
 ---
 
-## What gmax does
+## When to use what
 
-Finds code by meaning. When you'd ask a colleague "where do we handle auth?", use gmax.
-
-- grep/ripgrep: exact string match, fast
-- gmax: concept match, finds code you couldn't grep for
+- **Know the exact string/symbol?** → grep/ripgrep (fastest)
+- **Know the file already?** → Read tool directly
+- **Searching by concept/behavior?** → gmax "query" --agent (semantic search)
+- **Need full function body?** → gmax extract <symbol> (complete source)
+- **Quick symbol overview?** → gmax peek <symbol> (signature + callers + callees)
+- **Need file structure?** → gmax skeleton <path>
+- **Need call flow?** → gmax trace <symbol>
 
 ## Primary command
 
-gmax "where do we validate user permissions"
-
-
-Returns ~10 results with code snippets (15+ lines each). Usually enough to understand what's happening.
-
-## Output explained
-
-ORCHESTRATION src/auth/handler.ts:45
-Defines: handleAuth | Calls: validate, checkRole, respond | Score: .94
-
-export async function handleAuth(req: Request) {
-  const token = req.headers.get("Authorization");
-  const claims = await validateToken(token);
-  if (!claims) return unauthorized();
-  const allowed = await checkRole(claims.role, req.path);
-  ...
-
-- **ORCHESTRATION** = contains logic, coordinates other code
-- **DEFINITION** = types, interfaces, classes
-- **Score** = relevance (1 = best match)
-- **Calls** = what this code calls (helps you trace flow)
-
-## When to Read more
-
-The snippet often has enough context. But if you need more:
-
-# gmax found src/auth/handler.ts:45-90 as ORCH
-Read src/auth/handler.ts:45-120
+Use --agent for compact, token-efficient output (one line per result):
 
+gmax "where do we handle authentication" --agent
+gmax "database connection pooling" --role ORCHESTRATION --agent -m 5
+gmax "error handling" --lang ts --exclude tests/ --agent
 
-Read the specific line range, not the whole file.
+Output: file:line symbol [ROLE] — signature_hint
 
-## Other commands
+All search flags: --agent -m <n> --per-file <n> --root <dir> --file <name> --exclude <prefix> --lang <ext> --role <role> --symbol --imports --name <regex> -C <n> --skeleton --explain --context-for-llm --budget <tokens>
 
-# Trace call graph (who calls X, what X calls)
-gmax trace handleAuth
+## Commands
 
-# Skeleton of a huge file (to find which ranges to read)
-gmax skeleton src/giant-2000-line-file.ts
+### Core
+gmax "query" --agent              # semantic search (compact output)
+gmax extract <symbol>             # full function body with line numbers
+gmax peek <symbol>                # signature + callers + callees
+gmax trace <symbol> -d 2          # call graph (multi-hop)
+gmax skeleton <path>              # file structure (signatures only)
+gmax symbols --agent              # list all indexed symbols
 
-# Just file paths when you only need locations
-gmax "authentication" --compact
+### Analysis
+gmax diff [ref] --agent           # search scoped to git changes
+gmax test <symbol> --agent        # find tests via reverse call graph
+gmax impact <symbol> --agent      # dependents + affected tests
+gmax similar <symbol> --agent     # vector-to-vector similarity
+gmax context "topic" --budget 4k  # token-budgeted topic summary
 
+### Project
+gmax project --agent              # languages, structure, key symbols
+gmax related <file> --agent       # dependencies + dependents
+gmax recent --agent               # recently modified files
+gmax status --agent               # all indexed projects
 
-## Workflow: architecture questions
-
-# 1. Find entry points
-gmax "where do requests enter the server"
-# Review the ORCH results - code is shown
-
-# 2. If you need deeper context on a specific function
-Read src/server/handler.ts:45-120
-
-# 3. Trace to understand call flow
-gmax trace handleRequest
+### Management
+gmax add                          # add + index current directory
+gmax index                        # reindex current project
+gmax doctor --fix                 # health check + auto-repair
 
 ## Tips
 
-- More words = better results. "auth" is vague. "where does the server validate JWT tokens" is specific.
-- ORCH results contain the logic - prioritize these
-- Don't read entire files. Use the line ranges gmax gives you.
-- If results seem off, rephrase your query like you'd ask a teammate
-
-## If Index is Building
-
-If you see "Indexing" or "Syncing": STOP. Tell the user the index is building. Ask if they want to wait or proceed with partial results.
-
+- Be specific. "auth" is vague. "where does the server validate JWT tokens" is specific.
+- Use --role ORCHESTRATION to skip type definitions and find actual logic.
+- Use --symbol when the query is a function/class name — gets search + trace in one shot.
+- Don't search for exact strings — use grep for that. gmax finds concepts.
+- If search returns nothing, run: gmax add
 \`;
 
 const GMAX_BIN = "${gmaxBin}";
@@ -129,7 +110,7 @@ export default tool({
   description: SKILL,
   args: {
     argv: tool.schema.array(tool.schema.string())
-      .describe("Arguments for gmax, e.g. ['search', 'user auth']")
+      .describe("Arguments for gmax, e.g. ['search', 'user auth', '--agent']")
   },
   async execute({ argv }) {
     try {
@@ -142,7 +123,7 @@ export default tool({
 Output so far:
 \${text.trim()}
 
-PLEASE READ THE "Indexing" WARNING IN MY SKILL DESCRIPTION.\`;
+Please wait for indexing to complete before searching.\`;
       }
       return text.trim();
     } catch (err) {
@@ -151,17 +132,62 @@ PLEASE READ THE "Indexing" WARNING IN MY SKILL DESCRIPTION.\`;
   },
 })`;
 }
+function buildPluginContent(gmaxBin) {
+    return `import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+const GMAX_BIN = "${gmaxBin}";
+
+function isProjectRegistered() {
+  try {
+    const projectsPath = join(homedir(), ".gmax", "projects.json");
+    const projects = JSON.parse(readFileSync(projectsPath, "utf-8"));
+    const cwd = process.cwd();
+    return projects.some((p) => cwd.startsWith(p.root));
+  } catch {
+    return false;
+  }
+}
+
+export const GmaxPlugin = async () => {
+  // Start daemon on session creation if project is indexed
+  if (isProjectRegistered()) {
+    try {
+      execFileSync(GMAX_BIN, ["watch", "--daemon", "-b"], {
+        timeout: 5000,
+        stdio: "ignore",
+      });
+    } catch {}
+  }
+
+  return {
+    "session.created": async () => {
+      if (!isProjectRegistered()) return;
+      try {
+        execFileSync(GMAX_BIN, ["watch", "--daemon", "-b"], {
+          timeout: 5000,
+          stdio: "ignore",
+        });
+      } catch {}
+    },
+  };
+};
+`;
+}
 function install() {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
         try {
             // 1. Delete legacy plugin
-            if (node_fs_1.default.existsSync(PLUGIN_PATH)) {
-                try {
-                    node_fs_1.default.unlinkSync(PLUGIN_PATH);
-                    console.log("Deleted legacy plugin at", PLUGIN_PATH);
-                }
-                catch (e) {
-                    console.warn("mnt: Failed to delete legacy plugin:", e);
+            for (const legacy of [LEGACY_PLUGIN_PATH]) {
+                if (node_fs_1.default.existsSync(legacy)) {
+                    try {
+                        node_fs_1.default.unlinkSync(legacy);
+                        console.log("Deleted legacy plugin at", legacy);
+                    }
+                    catch (_b) { }
                 }
             }
             // 2. Resolve absolute path to gmax binary
@@ -171,23 +197,22 @@ function install() {
             node_fs_1.default.mkdirSync(node_path_1.default.dirname(TOOL_PATH), { recursive: true });
             node_fs_1.default.writeFileSync(TOOL_PATH, buildShimContent(gmaxBin));
             console.log("✅ Created tool shim at", TOOL_PATH);
-            // 4. Register MCP
-            if (!node_fs_1.default.existsSync(CONFIG_PATH)) {
-                node_fs_1.default.mkdirSync(node_path_1.default.dirname(CONFIG_PATH), { recursive: true });
-                node_fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify({}, null, 2));
+            // 4. Create plugin for daemon startup
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(PLUGIN_PATH), { recursive: true });
+            node_fs_1.default.writeFileSync(PLUGIN_PATH, buildPluginContent(gmaxBin));
+            console.log("✅ Created plugin at", PLUGIN_PATH);
+            // 5. Clean up stale MCP registration if present
+            if (node_fs_1.default.existsSync(CONFIG_PATH)) {
+                try {
+                    const config = JSON.parse(node_fs_1.default.readFileSync(CONFIG_PATH, "utf-8") || "{}");
+                    if ((_a = config.mcp) === null || _a === void 0 ? void 0 : _a.gmax) {
+                        delete config.mcp.gmax;
+                        node_fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+                        console.log("✅ Removed stale MCP registration from", CONFIG_PATH);
+                    }
+                }
+                catch (_c) { }
             }
-            const config = JSON.parse(node_fs_1.default.readFileSync(CONFIG_PATH, "utf-8") || "{}");
-            if (!config.$schema)
-                config.$schema = "https://opencode.ai/config.json";
-            if (!config.mcp)
-                config.mcp = {};
-            config.mcp.gmax = {
-                type: "local",
-                command: [gmaxBin, "mcp"],
-                enabled: true,
-            };
-            node_fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
-            console.log("✅ Registered MCP server in", CONFIG_PATH);
         }
         catch (err) {
             console.error("❌ Installation failed:", err);
@@ -198,25 +223,30 @@ function uninstall() {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         try {
-            // 1. Remove shim
+            // 1. Remove tool shim
             if (node_fs_1.default.existsSync(TOOL_PATH)) {
                 node_fs_1.default.unlinkSync(TOOL_PATH);
                 console.log("✅ Removed tool shim.");
             }
-            // 2. Unregister MCP
+            // 2. Remove plugin
+            if (node_fs_1.default.existsSync(PLUGIN_PATH)) {
+                node_fs_1.default.unlinkSync(PLUGIN_PATH);
+                console.log("✅ Removed plugin.");
+            }
+            // 3. Clean up legacy paths
+            if (node_fs_1.default.existsSync(LEGACY_PLUGIN_PATH)) {
+                node_fs_1.default.unlinkSync(LEGACY_PLUGIN_PATH);
+                console.log("✅ Cleaned up legacy plugin.");
+            }
+            // 4. Clean up MCP registration if present
             if (node_fs_1.default.existsSync(CONFIG_PATH)) {
                 const config = JSON.parse(node_fs_1.default.readFileSync(CONFIG_PATH, "utf-8") || "{}");
                 if ((_a = config.mcp) === null || _a === void 0 ? void 0 : _a.gmax) {
                     delete config.mcp.gmax;
                     node_fs_1.default.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
-                    console.log("✅ Unregistered MCP server.");
+                    console.log("✅ Removed MCP registration.");
                 }
             }
-            // Cleanup plugin just in case
-            if (node_fs_1.default.existsSync(PLUGIN_PATH)) {
-                node_fs_1.default.unlinkSync(PLUGIN_PATH);
-                console.log("✅ Cleaned up plugin file.");
-            }
         }
         catch (err) {
             console.error("❌ Uninstall failed:", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "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.11.2",
+  "version": "0.11.3",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",