@pimzino/sgrep 1.3.21 → 1.3.26

package/build/plugins/sgrep/hooks/hooks.json

@@ -1,70 +1,70 @@
-{
-  "description": "sgrep semantic search hooks - enhances prompts and manages index",
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_enhance.js",
-            "timeout": 60
-          }
-        ]
-      }
-    ],
-    "SessionStart": [
-      {
-        "matcher": "startup|resume",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_watch.js",
-            "timeout": 15
-          }
-        ]
-      },
-      {
-        "matcher": "startup|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_project_summary.js",
-            "timeout": 90
-          }
-        ]
-      },
-      {
-        "matcher": "resume|clear",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_context.js",
-            "timeout": 5
-          }
-        ]
-      }
-    ],
-    "SubagentStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_context.js",
-            "timeout": 5
-          }
-        ]
-      }
-    ],
-    "SessionEnd": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_watch_kill.js",
-            "timeout": 10
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "description": "sgrep semantic search hooks - enhances prompts and manages index",
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_enhance.js",
+            "timeout": 60
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_watch.js",
+            "timeout": 15
+          }
+        ]
+      },
+      {
+        "matcher": "startup|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_project_summary.js",
+            "timeout": 90
+          }
+        ]
+      },
+      {
+        "matcher": "resume|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_context.js",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_context.js",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_watch_kill.js",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/build/plugins/sgrep/hooks/sgrep_context.js

@@ -1,91 +1,107 @@
-#!/usr/bin/env node
-
-/**
- * sgrep_context.js - Injects sgrep awareness into Claude Code sessions and subagents
- *
- * This hook runs on:
- * - SessionStart (startup, resume, clear, compact) - main session context
- * - SubagentStart - subagent (Task tool) context
- *
- * Ensures Claude is always aware of the sgrep semantic search tool.
- */
-
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-
-const DEBUG_ENABLED = process.env.SGREP_DEBUG === "1" || process.env.SGREP_DEBUG === "true";
-const DEBUG_LOG_FILE = process.env.SGREP_CONTEXT_LOG || path.join(os.tmpdir(), "sgrep-context.log");
-
-function debugLog(message) {
-  if (!DEBUG_ENABLED) return;
-  try {
-    const dir = path.dirname(DEBUG_LOG_FILE);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-    const stamp = new Date().toISOString();
-    fs.appendFileSync(DEBUG_LOG_FILE, `[${stamp}] ${message}\n`);
-  } catch (e) {
-    // Ignore errors
-  }
-}
-
-function readHookInput() {
-  return new Promise((resolve) => {
-    let data = "";
-    process.stdin.setEncoding("utf8");
-    process.stdin.on("data", (chunk) => {
-      data += chunk;
-    });
-    process.stdin.on("end", () => {
-      if (!data.trim()) {
-        debugLog("No input data received from stdin");
-        resolve(null);
-        return;
-      }
-      try {
-        const parsed = JSON.parse(data);
-        debugLog(`Received hook input: ${JSON.stringify(parsed, null, 2)}`);
-        resolve(parsed);
-      } catch (e) {
-        debugLog(`Failed to decode JSON: ${e.message}`);
-        resolve(null);
-      }
-    });
-  });
-}
-
-async function main() {
-  debugLog("\n====================================================");
-  debugLog("SGREP CONTEXT HOOK TRIGGERED");
-  debugLog("====================================================");
-
-  const payload = await readHookInput();
-  if (!payload) {
-    debugLog("ERROR: No payload received - exiting with error");
-    process.exit(1);
-  }
-
-  const eventName = payload.hook_event_name || "unknown";
-  debugLog(`Hook event: ${eventName}`);
-
-  // Log event-specific info
-  if (eventName === "SessionStart") {
-    debugLog(`Session source: ${payload.source || "unknown"}`);
-  } else if (eventName === "SubagentStart") {
-    debugLog(`Subagent ID: ${payload.agent_id || "unknown"}`);
-    debugLog(`Subagent type: ${payload.agent_type || "unknown"}`);
-  }
-
-  // Same context message for both session and subagents
-  // Make it directive - tell Claude to USE sgrep, not just that it exists
-  const sgrepInstruction = `CODEBASE EXPLORATION: Before using Grep, Glob, or Read to explore code, run \`sgrep "your query"\` first via Bash. sgrep uses semantic search to find code by meaning (e.g., \`sgrep "authentication logic"\`, \`sgrep "database queries"\`). For questions about the codebase, use \`sgrep ask "how does X work?"\`. This is faster and more accurate than pattern matching.`;
-
-  debugLog(`Outputting context: ${sgrepInstruction}`);
-  console.log(sgrepInstruction);
-  debugLog("====================================================\n");
-  process.exit(0);
-}
-
-main();
+#!/usr/bin/env node
+
+/**
+ * sgrep_context.js - Injects sgrep awareness into Claude Code sessions
+ *
+ * This hook runs on SessionStart (startup, resume, clear, compact) to ensure
+ * Claude is always aware of the sgrep semantic search tool after any context reset.
+ *
+ * Separated from sgrep_watch.js which handles the background watch process.
+ */
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const DEBUG_ENABLED = process.env.SGREP_DEBUG === "1" || process.env.SGREP_DEBUG === "true";
+const DEBUG_LOG_FILE = process.env.SGREP_CONTEXT_LOG || path.join(os.tmpdir(), "sgrep-context.log");
+
+function debugLog(message) {
+  if (!DEBUG_ENABLED) return;
+  try {
+    const dir = path.dirname(DEBUG_LOG_FILE);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    const stamp = new Date().toISOString();
+    fs.appendFileSync(DEBUG_LOG_FILE, `[${stamp}] ${message}\n`);
+  } catch (e) {
+    // Ignore errors
+  }
+}
+
+function readHookInput() {
+  return new Promise((resolve) => {
+    let data = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      data += chunk;
+    });
+    process.stdin.on("end", () => {
+      if (!data.trim()) {
+        debugLog("No input data received from stdin");
+        resolve(null);
+        return;
+      }
+      try {
+        const parsed = JSON.parse(data);
+        debugLog(`Received hook input: ${JSON.stringify(parsed, null, 2)}`);
+        resolve(parsed);
+      } catch (e) {
+        debugLog(`Failed to decode JSON: ${e.message}`);
+        resolve(null);
+      }
+    });
+  });
+}
+
+async function main() {
+  debugLog("\n====================================================");
+  debugLog("SGREP CONTEXT HOOK TRIGGERED");
+  debugLog("====================================================");
+
+  const payload = await readHookInput();
+  if (!payload) {
+    debugLog("ERROR: No payload received - exiting with error");
+    process.exit(1);
+  }
+
+  const source = payload.source || "unknown";
+  debugLog(`Session source: ${source}`);
+
+  // Output the sgrep awareness context with XML structure for better model compliance
+  const sgrepInstruction = `
+<sgrep-skill-instruction>
+<priority>CRITICAL - Execute before other codebase exploration tools</priority>
+<action>INVOKE the /sgrep skill using the Skill tool at the START of every session</action>
+<requirement>
+You MUST use sgrep as your PRIMARY tool for codebase exploration and understanding.
+Before using Grep, Glob, Read, or Task(Explore), you MUST first try sgrep.
+</requirement>
+<commands>
+<command name="search">sgrep "natural language query" - Find code by meaning/functionality</command>
+<command name="ask">sgrep ask "question" - Get explanations about the codebase</command>
+</commands>
+<use-cases>
+- Finding code by functionality (e.g., "authentication handling", "database queries")
+- Understanding how features work
+- Locating related files across the codebase
+- Exploring unfamiliar architecture
+</use-cases>
+<advantage>sgrep searches by MEANING, not text patterns - far more effective than grep/glob for understanding code</advantage>
+</sgrep-skill-instruction>`.trim();
+
+  const response = {
+    hookSpecificOutput: {
+      hookEventName: "SessionStart",
+      additionalContext: sgrepInstruction,
+    },
+  };
+
+  debugLog(`Outputting context: ${JSON.stringify(response, null, 2)}`);
+  console.log(JSON.stringify(response));
+  debugLog("====================================================\n");
+  process.exit(0);
+}
+
+main();