@pimzino/sgrep 1.3.40 → 1.3.44

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

@@ -1,32 +1,20 @@
 {
-  "description": "sgrep semantic search hooks - enhances prompts and manages index",
+  "description": "sgrep hooks - prompt hint, index watcher, and watcher cleanup",
   "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Grep|Glob",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_tool_reminder.js",
-            "timeout": 5
-          }
-        ]
-      }
-    ],
     "UserPromptSubmit": [
       {
         "hooks": [
           {
             "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_enhance.js",
-            "timeout": 60
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/sgrep_prompt_hint.js",
+            "timeout": 5
           }
         ]
       }
     ],
     "SessionStart": [
       {
-        "matcher": "startup|resume",
+        "matcher": "startup|resume|clear",
         "hooks": [
           {
             "type": "command",
@@ -34,37 +22,6 @@
             "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": [

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

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * sgrep_prompt_hint.js - UserPromptSubmit hook
+ *
+ * Appends a short reminder to every prompt so the model knows
+ * sgrep is available for codebase search and understanding.
+ */
+
+let data = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => (data += chunk));
+process.stdin.on("end", () => {
+  console.log(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "UserPromptSubmit",
+        additionalContext:
+          'Before making changes, gather context: use sgrep "query" for codebase search/understanding.',
+      },
+    })
+  );
+});

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

@@ -1,169 +1,169 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-const { execSync } = require("child_process");
-
-const DEBUG_ENABLED = process.env.SGREP_DEBUG === "1" || process.env.SGREP_DEBUG === "true";
-const DEBUG_LOG_FILE = process.env.SGREP_WATCH_KILL_LOG || path.join(os.tmpdir(), "sgrep-watch-kill.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 debugLogSection(title, content) {
-  debugLog(`\n========== ${title} ==========`);
-  debugLog(content);
-  debugLog(`========== END ${title} ==========\n`);
-}
-
-/**
- * Kill a process by PID, with platform-specific handling
- */
-function killProcess(pid) {
-  debugLog(`Attempting to kill process with PID: ${pid}`);
-
-  // First try Node.js process.kill
-  try {
-    process.kill(pid, "SIGTERM");
-    debugLog(`SUCCESS: Sent SIGTERM to process ${pid}`);
-    return true;
-  } catch (e) {
-    if (e.code === "ESRCH") {
-      debugLog(`INFO: Process ${pid} already exited`);
-      return true; // Consider success if already gone
-    }
-    debugLog(`process.kill failed: ${e.message} (code: ${e.code})`);
-  }
-
-  // On Windows, try taskkill as fallback
-  if (process.platform === "win32") {
-    try {
-      execSync(`taskkill /PID ${pid} /F`, {
-        encoding: "utf8",
-        timeout: 5000,
-        stdio: ["pipe", "pipe", "pipe"],
-      });
-      debugLog(`SUCCESS: Killed process ${pid} using taskkill`);
-      return true;
-    } catch (e) {
-      debugLog(`taskkill failed: ${e.message}`);
-    }
-  }
-
-  return false;
-}
-
-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);
-        debugLogSection("RAW HOOK INPUT", JSON.stringify(parsed, null, 2));
-        resolve(parsed);
-      } catch (e) {
-        debugLog(`Failed to decode JSON: ${e.message}`);
-        debugLog(`Raw data: ${data}`);
-        resolve(null);
-      }
-    });
-  });
-}
-
-async function main() {
-  debugLog("\n\n====================================================");
-  debugLog("SGREP WATCH KILL HOOK TRIGGERED - SessionEnd");
-  debugLog("====================================================");
-
-  const payload = await readHookInput();
-  if (!payload) {
-    debugLog("ERROR: No payload received - exiting with error");
-    process.exit(1);
-  }
-
-  // Log all payload fields for debugging
-  debugLog(`Hook Event: ${payload.hook_event_name || 'unknown'}`);
-  debugLog(`Session ID: ${payload.session_id || 'unknown'}`);
-  debugLog(`Reason: ${payload.reason || 'unknown'} (clear/logout/prompt_input_exit/other)`);
-  debugLog(`CWD: ${payload.cwd || 'unknown'}`);
-  debugLog(`Permission Mode: ${payload.permission_mode || 'unknown'}`);
-  debugLog(`Transcript Path: ${payload.transcript_path || 'unknown'}`);
-
-  const sessionId = payload.session_id || "default";
-  const pidFile = path.join(os.tmpdir(), `sgrep-watch-pid-${sessionId}.txt`);
-
-  debugLog(`Looking for PID file: ${pidFile}`);
-
-  if (!fs.existsSync(pidFile)) {
-    debugLog(`SKIP: PID file not found - sgrep watch may not have been started`);
-    process.exit(0); // Not an error - process may not have been started
-  }
-
-  let killed = false;
-
-  try {
-    const pidContent = fs.readFileSync(pidFile, "utf8").trim();
-    debugLog(`PID file content: "${pidContent}"`);
-
-    const pid = parseInt(pidContent, 10);
-    debugLog(`Parsed PID: ${pid}`);
-
-    if (!isNaN(pid) && pid > 0) {
-      killed = killProcess(pid);
-    } else {
-      debugLog(`WARNING: Invalid PID (${pid}), cannot kill process`);
-    }
-  } catch (e) {
-    debugLog(`ERROR reading PID file: ${e.message}`);
-  }
-
-  // Clean up PID file (sgrep watch should also clean it up on exit, but be safe)
-  try {
-    if (fs.existsSync(pidFile)) {
-      fs.unlinkSync(pidFile);
-      debugLog(`SUCCESS: Removed PID file: ${pidFile}`);
-    }
-  } catch (cleanupErr) {
-    debugLog(`Failed to clean up PID file: ${cleanupErr.message}`);
-  }
-
-  // Clean up ready marker file
-  const readyFile = path.join(os.tmpdir(), `sgrep-watch-ready-${sessionId}.txt`);
-  try {
-    if (fs.existsSync(readyFile)) {
-      fs.unlinkSync(readyFile);
-      debugLog(`SUCCESS: Removed ready file: ${readyFile}`);
-    }
-  } catch (cleanupErr) {
-    debugLog(`Failed to clean up ready file: ${cleanupErr.message}`);
-  }
-
-  debugLog(`Kill operation completed. Success: ${killed}`);
-
-
-  debugLog("====================================================\n");
-  process.exit(0);
-}
-
-main();
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { execSync } = require("child_process");
+
+const DEBUG_ENABLED = process.env.SGREP_DEBUG === "1" || process.env.SGREP_DEBUG === "true";
+const DEBUG_LOG_FILE = process.env.SGREP_WATCH_KILL_LOG || path.join(os.tmpdir(), "sgrep-watch-kill.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 debugLogSection(title, content) {
+  debugLog(`\n========== ${title} ==========`);
+  debugLog(content);
+  debugLog(`========== END ${title} ==========\n`);
+}
+
+/**
+ * Kill a process by PID, with platform-specific handling
+ */
+function killProcess(pid) {
+  debugLog(`Attempting to kill process with PID: ${pid}`);
+
+  // First try Node.js process.kill
+  try {
+    process.kill(pid, "SIGTERM");
+    debugLog(`SUCCESS: Sent SIGTERM to process ${pid}`);
+    return true;
+  } catch (e) {
+    if (e.code === "ESRCH") {
+      debugLog(`INFO: Process ${pid} already exited`);
+      return true; // Consider success if already gone
+    }
+    debugLog(`process.kill failed: ${e.message} (code: ${e.code})`);
+  }
+
+  // On Windows, try taskkill as fallback
+  if (process.platform === "win32") {
+    try {
+      execSync(`taskkill /PID ${pid} /F`, {
+        encoding: "utf8",
+        timeout: 5000,
+        stdio: ["pipe", "pipe", "pipe"],
+      });
+      debugLog(`SUCCESS: Killed process ${pid} using taskkill`);
+      return true;
+    } catch (e) {
+      debugLog(`taskkill failed: ${e.message}`);
+    }
+  }
+
+  return false;
+}
+
+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);
+        debugLogSection("RAW HOOK INPUT", JSON.stringify(parsed, null, 2));
+        resolve(parsed);
+      } catch (e) {
+        debugLog(`Failed to decode JSON: ${e.message}`);
+        debugLog(`Raw data: ${data}`);
+        resolve(null);
+      }
+    });
+  });
+}
+
+async function main() {
+  debugLog("\n\n====================================================");
+  debugLog("SGREP WATCH KILL HOOK TRIGGERED - SessionEnd");
+  debugLog("====================================================");
+
+  const payload = await readHookInput();
+  if (!payload) {
+    debugLog("ERROR: No payload received - exiting with error");
+    process.exit(1);
+  }
+
+  // Log all payload fields for debugging
+  debugLog(`Hook Event: ${payload.hook_event_name || 'unknown'}`);
+  debugLog(`Session ID: ${payload.session_id || 'unknown'}`);
+  debugLog(`Reason: ${payload.reason || 'unknown'} (clear/logout/prompt_input_exit/other)`);
+  debugLog(`CWD: ${payload.cwd || 'unknown'}`);
+  debugLog(`Permission Mode: ${payload.permission_mode || 'unknown'}`);
+  debugLog(`Transcript Path: ${payload.transcript_path || 'unknown'}`);
+
+  const sessionId = payload.session_id || "default";
+  const pidFile = path.join(os.tmpdir(), `sgrep-watch-pid-${sessionId}.txt`);
+
+  debugLog(`Looking for PID file: ${pidFile}`);
+
+  if (!fs.existsSync(pidFile)) {
+    debugLog(`SKIP: PID file not found - sgrep watch may not have been started`);
+    process.exit(0); // Not an error - process may not have been started
+  }
+
+  let killed = false;
+
+  try {
+    const pidContent = fs.readFileSync(pidFile, "utf8").trim();
+    debugLog(`PID file content: "${pidContent}"`);
+
+    const pid = parseInt(pidContent, 10);
+    debugLog(`Parsed PID: ${pid}`);
+
+    if (!isNaN(pid) && pid > 0) {
+      killed = killProcess(pid);
+    } else {
+      debugLog(`WARNING: Invalid PID (${pid}), cannot kill process`);
+    }
+  } catch (e) {
+    debugLog(`ERROR reading PID file: ${e.message}`);
+  }
+
+  // Clean up PID file (sgrep watch should also clean it up on exit, but be safe)
+  try {
+    if (fs.existsSync(pidFile)) {
+      fs.unlinkSync(pidFile);
+      debugLog(`SUCCESS: Removed PID file: ${pidFile}`);
+    }
+  } catch (cleanupErr) {
+    debugLog(`Failed to clean up PID file: ${cleanupErr.message}`);
+  }
+
+  // Clean up ready marker file
+  const readyFile = path.join(os.tmpdir(), `sgrep-watch-ready-${sessionId}.txt`);
+  try {
+    if (fs.existsSync(readyFile)) {
+      fs.unlinkSync(readyFile);
+      debugLog(`SUCCESS: Removed ready file: ${readyFile}`);
+    }
+  } catch (cleanupErr) {
+    debugLog(`Failed to clean up ready file: ${cleanupErr.message}`);
+  }
+
+  debugLog(`Kill operation completed. Success: ${killed}`);
+
+
+  debugLog("====================================================\n");
+  process.exit(0);
+}
+
+main();

package/build/plugins/sgrep/skills/sgrep/SKILL.md

@@ -1,90 +1,32 @@
 ---
 name: sgrep
-description: "Semantic grep - search code by meaning, not just text. 1 sgrep call replaces 5-10 grep/glob calls. Ask natural language questions about architecture, find implementations by functionality, and get AI-explained code with file references. Use as your FIRST tool for codebase exploration, understanding, and navigation. This skill must be invoked at the start of every session."
+description: "Semantic codebase search and understanding. Use when exploring code, finding where something is implemented, understanding architecture or patterns, locating how a feature works, or answering any question about this repository. Invoke BEFORE reading or editing files to gather context. Replaces multiple grep/glob calls with a single semantic query."
 ---
 
-## Tool Definition
+## How to Use
 
-sgrep (semantic grep) searches and explains code in the LOCAL repository using AI. It understands code semantics, not just text patterns.
-
-## Execution Method
-
-Execute sgrep commands via Bash tool. Always run from project root directory.
+Run via Bash from the project root:
 
 ```bash
-# Ask questions about this codebase (DEFAULT)
-sgrep "how does authentication work in this project?"
-
-# Search for code by meaning
-sgrep search "error handling logic"
+# Ask about the codebase (default - returns explanations with file references)
+sgrep "how does authentication work?"
+sgrep "where are API routes defined?"
+sgrep "what does the build pipeline do?"
+
+# Search for code snippets by meaning
+sgrep search "error handling middleware"
+sgrep search "database connection setup"
 ```
 
-## Decision Logic
-
-<use-sgrep>
-- Question targets code that EXISTS in this repository
-- Need to understand this project's architecture or patterns
-- Exploring this codebase before making changes
-- Finding implementations within this repository
-</use-sgrep>
-
-<do-not-use-sgrep>
-- External API documentation (Microsoft Graph, AWS SDK, etc.)
-- Library/framework docs (React hooks, Express middleware, etc.)
-- General programming concepts (dependency injection, OAuth, etc.)
-- Third-party CLI usage (kubectl, az, gh, etc.)
-- Best practices not specific to this codebase
-- Any knowledge that exists outside this repository
-</do-not-use-sgrep>
-
-<decision-rule>
-IF answer requires knowledge from outside this repository THEN use WebSearch/WebFetch
-IF answer is in the code files of this project THEN use sgrep
-</decision-rule>
-
-## Commands
+## When to Use
 
-### Default: Ask (explanations with code references)
-
-```bash
-sgrep "how does the caching layer work?"
-sgrep "what patterns are used for API endpoints?"
-sgrep "where is user validation handled?"
-```
-
-### Search (raw code snippets only)
-
-```bash
-sgrep search "authentication middleware"
-sgrep search "database connection handling"
-```
+- Before editing code, to understand what exists and where
+- When asked to find, locate, or explain any code in this repo
+- To understand architecture, patterns, or how features connect
+- When exploring unfamiliar parts of the codebase
 
 ## Constraints
 
-- ALWAYS execute from project root directory
-- NEVER cd into subdirectories before running sgrep
-- For exact text matching, use Grep tool instead
-
-## Examples
-
-### Correct Usage
-
-```bash
-sgrep "how does this project handle routing?"      # Local codebase question
-sgrep "where is the config loaded?"                # Local implementation
-sgrep search "HashRouter configuration"            # Local code search
-```
-
-### Incorrect Usage (use WebSearch instead)
-
-```bash
-# WRONG - these require external knowledge
-sgrep "How do Microsoft Graph cmdlets work?"       # External API
-sgrep "What are React best practices?"             # General knowledge
-sgrep "How to use kubectl?"                        # External CLI docs
-sgrep "What is OAuth 2.0?"                         # General concept
-```
-
-## Keywords
-
-codebase questions, local code, repository code, project architecture, code understanding, semantic search, find implementations
+- Run from project root (never cd into subdirectories first)
+- For exact text/symbol matching, use Grep instead
+- For external docs or general knowledge, use WebSearch instead

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pimzino/sgrep",
-  "version": "1.3.40",
+  "version": "1.3.44",
   "description": "Semantic grep - search codebases by meaning using the Augment SDK",
   "type": "module",
   "main": "build/index.js",

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

@@ -1,91 +0,0 @@
-#!/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();