@pimzino/sgrep 1.3.39 → 1.3.44

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

@@ -1,188 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-const { execSync } = require("child_process");
-const os = require("os");
-
-const DEBUG_ENABLED = process.env.SGREP_DEBUG === "1" || process.env.SGREP_DEBUG === "true";
-const DEBUG_LOG_FILE = process.env.SGREP_ENHANCE_LOG || path.join(os.tmpdir(), "sgrep-enhance.log");
-
-// Lightweight reminder injected with every prompt (exploits recency bias)
-const SGREP_REMINDER = `<tool-guidance scope="local-codebase-only">
-<condition>Question is about code in THIS repository</condition>
-<action>Load sgrep skill via Skill tool, then execute sgrep commands</action>
-<condition>Question is about external APIs, libraries, documentation, or general knowledge</condition>
-<action>Use WebSearch or WebFetch instead - sgrep cannot answer these</action>
-</tool-guidance>`;
-
-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`);
-}
-
-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);
-      }
-    });
-  });
-}
-
-/**
- * Determine if enhancement should proceed.
- * Auto-confirms on all platforms (no user prompting).
- */
-function shouldEnhance(prompt) {
-  debugLog("Auto-confirming enhancement (prompting disabled on all platforms)");
-  return true;
-}
-
-/**
- * Output the hook response with optional enhanced context and mandatory reminder.
- * Always includes the sgrep reminder to exploit recency bias.
- */
-function outputResponse(enhancedContext = null) {
-  const parts = [];
-
-  if (enhancedContext) {
-    parts.push(`[sgrep enhanced context]\n${enhancedContext}`);
-  }
-
-  // Always append the reminder (exploits recency bias - appears fresh with every prompt)
-  parts.push(SGREP_REMINDER);
-
-  const response = {
-    hookSpecificOutput: {
-      hookEventName: "UserPromptSubmit",
-      additionalContext: parts.join("\n\n")
-    }
-  };
-
-  debugLogSection("HOOK RESPONSE", JSON.stringify(response, null, 2));
-  console.log(JSON.stringify(response));
-}
-
-async function main() {
-  debugLog("\n\n====================================================");
-  debugLog("SGREP ENHANCE HOOK TRIGGERED - UserPromptSubmit");
-  debugLog("====================================================");
-
-  const payload = await readHookInput();
-  if (!payload) {
-    debugLog("ERROR: No payload received - exiting");
-    process.exit(0);
-  }
-
-  // Log all payload fields
-  debugLog(`Hook Event: ${payload.hook_event_name || 'unknown'}`);
-  debugLog(`Session ID: ${payload.session_id || 'unknown'}`);
-  debugLog(`CWD: ${payload.cwd || 'unknown'}`);
-  debugLog(`Permission Mode: ${payload.permission_mode || 'unknown'}`);
-
-  const prompt = payload.prompt || "";
-  debugLogSection("ORIGINAL PROMPT", prompt);
-
-  // Skip enhancement for very short prompts or slash commands, but still inject reminder
-  if (prompt.length < 10) {
-    debugLog("SKIP enhancement: Prompt too short (< 10 chars), but injecting reminder");
-    outputResponse(null);
-    debugLog("====================================================\n");
-    process.exit(0);
-  }
-  if (prompt.startsWith("/")) {
-    debugLog("SKIP enhancement: Prompt is a slash command, but injecting reminder");
-    outputResponse(null);
-    debugLog("====================================================\n");
-    process.exit(0);
-  }
-
-  // Check if enhancement should proceed (auto-confirms on all platforms)
-  debugLog("Checking if enhancement should proceed...");
-  const shouldProceed = shouldEnhance(prompt);
-  debugLog(`Enhancement decision: ${shouldProceed ? 'proceeding' : 'skipped'}`);
-
-  if (!shouldProceed) {
-    debugLog("SKIP enhancement: Not proceeding, but injecting reminder");
-    outputResponse(null);
-    debugLog("====================================================\n");
-    process.exit(0);
-  }
-
-  let enhancedContext = null;
-
-  try {
-    // Call sgrep enhance with JSON output
-    debugLog("Calling: sgrep enhance --json \"<prompt>\"");
-
-    // Escape the prompt for shell
-    const escapedPrompt = prompt.replace(/"/g, '\\"').replace(/\n/g, ' ');
-
-    const result = execSync(`sgrep enhance --json "${escapedPrompt}"`, {
-      encoding: "utf8",
-      timeout: 60000, // 60 second timeout
-      stdio: ["pipe", "pipe", "pipe"],
-    });
-
-    debugLogSection("SGREP ENHANCE RAW RESULT", result);
-
-    // Parse the JSON result
-    const parsed = JSON.parse(result);
-    const enhanced = parsed.enhanced || null;
-
-    if (enhanced && enhanced !== prompt) {
-      debugLogSection("ENHANCED PROMPT", enhanced);
-      enhancedContext = enhanced;
-      debugLog("SUCCESS: Enhancement complete");
-    } else {
-      debugLog("SKIP: No enhanced prompt or same as original");
-    }
-  } catch (e) {
-    debugLog(`ERROR: Enhancement failed - ${e.message}`);
-    if (e.stderr) {
-      debugLog(`STDERR: ${e.stderr}`);
-    }
-    // Continue to output reminder even on error
-  }
-
-  // Always output response with reminder (and enhanced context if available)
-  outputResponse(enhancedContext);
-
-  debugLog("====================================================\n");
-  process.exit(0);
-}
-
-main();

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

@@ -1,236 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * sgrep_project_summary.js - Injects project context into Claude Code sessions
- *
- * Runs on SessionStart (startup, compact) to provide Claude with immediate
- * understanding of the project's tech stack, architecture, and key patterns.
- *
- * Features:
- * - Runs `sgrep ask` with a structured prompt
- * - Falls back to instructions if query fails
- * - Waits for index to build before querying
- */
-
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-const { execSync } = require("child_process");
-
-// Configuration
-const QUERY_TIMEOUT_MS = 25000; // 25 seconds
-const WATCH_READY_WAIT_MS = 10000; // Wait up to 10s for watch to be ready
-const INDEX_READY_WAIT_MS = 60000; // Wait up to 60s for index to be ready
-
-const DEBUG_ENABLED = process.env.SGREP_DEBUG === "1" || process.env.SGREP_DEBUG === "true";
-const DEBUG_LOG_FILE = process.env.SGREP_PROJECT_LOG || path.join(os.tmpdir(), "sgrep-project-summary.log");
-
-// Structured prompt optimized for agentic LLM context
-const PROJECT_SUMMARY_PROMPT = `You are briefing an AI coding agent that is about to work on this codebase for the first time. Provide the information that will save it the most tool calls and prevent mistakes. Be concise and specific — no filler.
-
-FORMAT YOUR RESPONSE EXACTLY AS:
-
-**What This Project Does:** [1-2 sentences: the domain problem, who uses it, what it produces. NOT the tech stack.]
-
-**Core Concepts:** [The 3-6 key domain abstractions/entities and how they relate. e.g., "Users own Workspaces, which contain Projects. Projects have Deployments."]
-
-**How It's Wired Together:**
-- Entry point(s): [exact file paths]
-- Request/data flow: [e.g., "Routes → Controllers → Services → Repositories" or "CLI parses commands → each command module handles execution"]
-- State management: [where state lives, how it flows]
-
-**Conventions (match these when writing code):**
-- File naming: [e.g., kebab-case, PascalCase for components]
-- File organization: [e.g., co-located tests, barrel exports, feature folders]
-- Import style: [e.g., path aliases like @/, relative imports, barrel re-exports]
-- Error handling pattern: [e.g., Result types, thrown exceptions, error boundaries]
-- Any other strong patterns the agent should follow
-
-**Commands:**
-- Build: [exact command]
-- Test: [exact command, plus how to run a single test]
-- Dev/Run: [exact command]
-- Lint/Format: [exact command, if applicable]
-
-**Gotchas:** [Non-obvious things that would trip up a newcomer: required env vars, unusual build steps, files that are auto-generated and shouldn't be edited, quirky patterns, etc.]
-
-Only include sections where you have concrete information. Omit rather than guess.`;
-
-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);
-      }
-    });
-  });
-}
-
-function waitForWatchReady(sessionId) {
-  const pidFile = path.join(os.tmpdir(), `sgrep-watch-pid-${sessionId}.txt`);
-  debugLog(`Waiting for watch process (PID file: ${pidFile})`);
-
-  const startTime = Date.now();
-  while (Date.now() - startTime < WATCH_READY_WAIT_MS) {
-    if (fs.existsSync(pidFile)) {
-      const pid = fs.readFileSync(pidFile, "utf8").trim();
-      if (pid && pid !== "0") {
-        debugLog(`Watch process ready with PID: ${pid}`);
-        return true;
-      }
-    }
-    // Small sync sleep
-    const waitUntil = Date.now() + 200;
-    while (Date.now() < waitUntil) {
-      // Busy wait (not ideal but works for short durations)
-    }
-  }
-
-  debugLog("Watch process not ready within timeout");
-  return false;
-}
-
-function waitForIndexReady(sessionId) {
-  // Watch writes a ready marker file when indexing completes
-  // The file is named sgrep-watch-ready-{sessionId}.txt (derived from PID file)
-  const readyFile = path.join(os.tmpdir(), `sgrep-watch-ready-${sessionId}.txt`);
-  debugLog(`Waiting for index ready (ready file: ${readyFile})`);
-
-  const startTime = Date.now();
-
-  while (Date.now() - startTime < INDEX_READY_WAIT_MS) {
-    if (fs.existsSync(readyFile)) {
-      try {
-        const content = fs.readFileSync(readyFile, "utf8").trim();
-        debugLog(`Index ready! Files indexed: ${content}`);
-        return true;
-      } catch (e) {
-        debugLog(`Error reading ready file: ${e.message}`);
-      }
-    }
-
-    // Small sync sleep - check every 200ms
-    const waitUntil = Date.now() + 200;
-    while (Date.now() < waitUntil) {
-      // Busy wait
-    }
-  }
-
-  debugLog("Index ready timeout - proceeding anyway");
-  return false;
-}
-
-function runSgrepAsk(cwd) {
-  debugLog("Running sgrep ask for project summary");
-
-  try {
-    // Find sgrep executable
-    const isWindows = process.platform === "win32";
-    let sgrepPath = "sgrep";
-
-    try {
-      const whichCmd = isWindows ? "where sgrep" : "which sgrep";
-      sgrepPath = execSync(whichCmd, { encoding: "utf8", timeout: 5000 })
-        .trim()
-        .split(/\r?\n/)[0];
-      debugLog(`Found sgrep at: ${sgrepPath}`);
-    } catch (e) {
-      debugLog("Could not find sgrep in PATH, using 'sgrep' directly");
-    }
-
-    // Run sgrep ask with the structured prompt
-    const result = execSync(`"${sgrepPath}" ask "${PROJECT_SUMMARY_PROMPT.replace(/"/g, '\\"')}"`, {
-      encoding: "utf8",
-      timeout: QUERY_TIMEOUT_MS,
-      cwd,
-      stdio: ["pipe", "pipe", "pipe"],
-    });
-
-    debugLog(`sgrep ask completed, output length: ${result.length}`);
-    return result.trim();
-  } catch (e) {
-    debugLog(`sgrep ask failed: ${e.message}`);
-    return null;
-  }
-}
-
-function getFallbackInstruction() {
-  return `<action>Execute via Bash: sgrep "What is the tech stack, frameworks, and architecture of this project?"</action>`;
-}
-
-async function main() {
-  debugLog("\n====================================================");
-  debugLog("SGREP PROJECT SUMMARY 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";
-  const source = payload.source || "unknown";
-  const cwd = payload.cwd || process.cwd();
-  const sessionId = payload.session_id || "default";
-
-  debugLog(`Event: ${eventName}, Source: ${source}`);
-  debugLog(`CWD: ${cwd}`);
-
-  // Wait for watch process to be ready
-  const watchReady = waitForWatchReady(sessionId);
-  if (!watchReady) {
-    debugLog("Watch not ready, outputting fallback instruction");
-    console.log(getFallbackInstruction());
-    process.exit(0);
-  }
-
-  // Wait for index to be built by monitoring watch output
-  const indexReady = waitForIndexReady(sessionId);
-  if (!indexReady) {
-    debugLog("Index ready timeout, but proceeding with query anyway");
-  }
-
-  // Run sgrep ask
-  const summary = runSgrepAsk(cwd);
-  if (summary) {
-    console.log(`[Project Context]\n${summary}`);
-  } else {
-    debugLog("Query failed, outputting fallback instruction");
-    console.log(getFallbackInstruction());
-  }
-
-  debugLog("====================================================\n");
-  process.exit(0);
-}
-
-main();

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

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * sgrep_tool_reminder.js - Friendly reminder when search tools are used
- *
- * Runs on PreToolUse for Grep and Glob to nudge the agent toward using
- * the sgrep skill for codebase navigation and understanding.
- *
- * Does NOT block the tool - just injects a reminder as context.
- */
-
-const REMINDER = [
-  "Tip: For codebase navigation and understanding, the sgrep skill provides",
-  "semantic search that finds code by meaning rather than patterns.",
-  "Use the Skill tool with skill=\"sgrep\" for questions about architecture,",
-  "finding implementations, or understanding how systems work.",
-  "Grep/Glob are fine for exact-match lookups - but sgrep saves time",
-  "when you're exploring or need to understand functionality."
-].join(" ");
-
-function main() {
-  let data = "";
-  process.stdin.setEncoding("utf8");
-  process.stdin.on("data", (chunk) => {
-    data += chunk;
-  });
-  process.stdin.on("end", () => {
-    // Output reason without decision - tool proceeds, model sees the hint
-    console.log(JSON.stringify({ reason: REMINDER }));
-    process.exit(0);
-  });
-}
-
-main();