mindlore 0.7.0 → 0.7.2

package/hooks/mindlore-research-guard.cjs

@@ -1,63 +1,46 @@
 #!/usr/bin/env node
-'use strict';
-
-/**
- * mindlore-research-guard — PreToolUse (Agent) hook
- *
- * Before spawning a researcher agent, checks FTS5 for existing knowledge.
- * - High quality + recent (30 days) match → exit 2 (block)
- * - Old or low quality match → exit 0 with warning (additionalContext)
- * - No match → silent pass
- *
- * Prevents redundant web research when knowledge already exists in DB.
- */
-
-const fs = require('fs');
-const path = require('path');
-const { getAllDbs, requireDatabase, extractKeywords, sanitizeKeyword, hookLog, withTelemetrySync } = require('./lib/mindlore-common.cjs');
-
-// Keywords that signal a research/web-search intent in agent prompts
-// Note: entries with dots/stars are regex patterns, rest are literals
-const RESEARCH_SIGNALS = [
-  'research', 'araştır', 'arastir', 'investigate', 'search for',
-  'web search', 'websearch', 'webfetch', 'fetch.*url', 'look up',
-  'find out', 'check.*docs', 'documentation.*for',
+"use strict";
+
+// hooks/src/mindlore-research-guard.cjs
+var fs = require("fs");
+var path = require("path");
+var { getAllDbs, requireDatabase, extractKeywords, sanitizeKeyword, hookLog, withTelemetrySync } = require("./lib/mindlore-common.cjs");
+var RESEARCH_SIGNALS = [
+  "research",
+  "ara\u015Ft\u0131r",
+  "arastir",
+  "investigate",
+  "search for",
+  "web search",
+  "websearch",
+  "webfetch",
+  "fetch.*url",
+  "look up",
+  "find out",
+  "check.*docs",
+  "documentation.*for"
 ];
-const RESEARCH_REGEX = new RegExp(RESEARCH_SIGNALS.join('|'), 'i');
-
-// Exclude ingest/internal operations (they intentionally fetch URLs)
-const EXCLUDE_REGEX = /\[mindlore:|\bmindlore-ingest\b|ingest.*url|save.*raw|\[research-override\]/i;
-
-const MAX_AGE_DAYS = 30;
-
+var RESEARCH_REGEX = new RegExp(RESEARCH_SIGNALS.join("|"), "i");
+var EXCLUDE_REGEX = /\[mindlore:|\bmindlore-ingest\b|ingest.*url|save.*raw|\[research-override\]/i;
+var MAX_AGE_DAYS = 30;
 function isRecent(dateStr) {
   if (!dateStr) return false;
   const d = new Date(dateStr);
   if (isNaN(d.getTime())) return false;
-  const diff = (Date.now() - d.getTime()) / (1000 * 60 * 60 * 24);
+  const diff = (Date.now() - d.getTime()) / (1e3 * 60 * 60 * 24);
   return diff <= MAX_AGE_DAYS;
 }
-
-/**
- * Search FTS5 using a single OR query instead of per-path×keyword loop.
- * Returns top matches with quality and date from FTS5 columns (no file I/O).
- */
 function searchDbs(keywords) {
   const Database = requireDatabase();
   if (!Database) return [];
-
   const sanitized = keywords.map(sanitizeKeyword).filter(Boolean);
   if (sanitized.length === 0) return [];
-
-  const matchQuery = sanitized.join(' OR ');
+  const matchQuery = sanitized.join(" OR ");
   const dbPaths = getAllDbs();
   const results = [];
-
   for (const dbPath of dbPaths) {
     try {
       const db = new Database(dbPath, { readonly: true });
-
-      // Single FTS5 query — O(1) instead of O(paths × keywords)
       const rows = db.prepare(
         `SELECT path, slug, title, description, quality, date_captured, rank
          FROM mindlore_fts
@@ -65,112 +48,91 @@ function searchDbs(keywords) {
          ORDER BY rank
          LIMIT 10`
       ).all(matchQuery);
-
       for (const row of rows) {
-        const quality = (row.quality || 'medium').toLowerCase();
+        const quality = (row.quality || "medium").toLowerCase();
         const date_captured = row.date_captured || null;
-
         results.push({
-          slug: row.slug || path.basename(row.path, '.md'),
-          title: row.title || row.description || row.slug || '',
+          slug: row.slug || path.basename(row.path, ".md"),
+          title: row.title || row.description || row.slug || "",
           quality,
           date_captured,
           recent: isRecent(date_captured),
-          rank: row.rank,
+          rank: row.rank
         });
       }
-
       db.close();
-    } catch (_err) { /* db open or query failed */ }
+    } catch (_err) {
+    }
   }
-
-  // Sort by rank (lower = better match in FTS5)
   results.sort((a, b) => a.rank - b.rank);
   return results.slice(0, 5);
 }
-
 function main() {
   let input;
   try {
-    const raw = fs.readFileSync(0, 'utf8').trim();
+    const raw = fs.readFileSync(0, "utf8").trim();
     if (!raw) return;
     input = JSON.parse(raw);
   } catch (_err) {
     return;
   }
-
-  const toolName = input.tool_name || '';
-  if (toolName !== 'Agent') return;
-
+  const toolName = input.tool_name || "";
+  if (toolName !== "Agent") return;
   const toolInput = input.tool_input || {};
-
-  // Only block agents with web access — let local-only agents pass
-  const WEB_CAPABLE_TYPES = ['researcher', 'general-purpose'];
+  const WEB_CAPABLE_TYPES = ["researcher", "general-purpose"];
   const LOCAL_ONLY_TYPES = [
-    'Explore', 'coder', 'code-reviewer', 'Plan',
-    'bug-analyzer', 'security-reviewer', 'contrarian',
-    'scope-guardian', 'quality-gate', 'test-runner',
+    "Explore",
+    "coder",
+    "code-reviewer",
+    "Plan",
+    "bug-analyzer",
+    "security-reviewer",
+    "contrarian",
+    "scope-guardian",
+    "quality-gate",
+    "test-runner"
   ];
-  const subagentType = toolInput.subagent_type || '';
-  const description = (toolInput.description || '').toLowerCase();
-
-  // Known local-only agent → always pass
+  const subagentType = toolInput.subagent_type || "";
+  const description = (toolInput.description || "").toLowerCase();
   if (LOCAL_ONLY_TYPES.includes(subagentType)) return;
-
-  // Known web-capable agent → continue to FTS5 check
-  // Unknown or empty subagent_type → check description for research intent
   if (subagentType && !WEB_CAPABLE_TYPES.includes(subagentType)) return;
-
-  // If no subagent_type, check description for web research intent (reuse RESEARCH_REGEX)
   if (!subagentType && !RESEARCH_REGEX.test(description)) return;
-
-  const prompt = (toolInput.prompt || '') + ' ' + (toolInput.description || '');
-
-  // Skip mindlore internal operations and explicit overrides
+  const prompt = (toolInput.prompt || "") + " " + (toolInput.description || "");
   if (EXCLUDE_REGEX.test(prompt)) return;
-
-  // If subagent_type is a known research type, skip prompt-level regex check
-  // Otherwise require research signals in the prompt text
   const isKnownResearchType = WEB_CAPABLE_TYPES.includes(subagentType);
   if (!isKnownResearchType && !RESEARCH_REGEX.test(prompt)) return;
-
   const keywords = extractKeywords(prompt, 10);
   if (keywords.length < 2) return;
-
   const matches = searchDbs(keywords);
   if (matches.length === 0) return;
-
-  // Prevents false positives like "claude-code-repo" matching on generic words
   const lcKeywords = keywords.map((k) => k.toLowerCase());
   const relevantMatches = matches.filter((m) => {
     const haystack = `${m.slug} ${m.title}`.toLowerCase();
     const overlap = lcKeywords.filter((k) => haystack.includes(k));
     return overlap.length >= 2;
   });
-
   if (relevantMatches.length === 0) return;
-
-  // Check for high-quality recent matches among relevant ones
-  const strongMatches = relevantMatches.filter((m) => m.quality === 'high' && m.recent);
-
+  const strongMatches = relevantMatches.filter((m) => m.quality === "high" && m.recent);
   if (strongMatches.length > 0) {
-    const slugList = strongMatches.map((m) => `  - ${m.slug} (${m.title})`).join('\n');
-    const msg = `[mindlore-research-guard] BLOK: Bu konuda guncel, yuksek kaliteli bilgi DB'de zaten var.\n` +
-      `Once mevcut bilgiyi oku:\n${slugList}\n` +
-      `Eger bilgi yetersizse, prompt'a "[research-override]" ekleyerek tekrar dene.`;
+    const slugList2 = strongMatches.map((m) => `  - ${m.slug} (${m.title})`).join("\n");
+    const msg = `[mindlore-research-guard] BLOK: Bu konuda guncel, yuksek kaliteli bilgi DB'de zaten var.
+Once mevcut bilgiyi oku:
+${slugList2}
+Eger bilgi yetersizse, prompt'a "[research-override]" ekleyerek tekrar dene.`;
     process.stderr.write(msg);
     process.exit(2);
   }
-
-  // WARN: relevant but old or low-quality matches exist
-  const slugList = relevantMatches.map((m) => `${m.slug} (${m.quality}, ${m.date_captured || 'tarih yok'})`).join(', ');
+  const slugList = relevantMatches.map((m) => `${m.slug} (${m.quality}, ${m.date_captured || "tarih yok"})`).join(", ");
   const output = {
     hookSpecificOutput: {
-      hookEventName: 'PreToolUse',
-      additionalContext: `[mindlore-research-guard] DB'de ilgili bilgi var ama eski/dusuk kalite: ${slugList}. Guncelleme gerekebilir — arastirma sonrasi DB'yi guncelle.`,
-    },
+      hookEventName: "PreToolUse",
+      additionalContext: `[mindlore-research-guard] DB'de ilgili bilgi var ama eski/dusuk kalite: ${slugList}. Guncelleme gerekebilir \u2014 arastirma sonrasi DB'yi guncelle.`
+    }
   };
   process.stdout.write(JSON.stringify(output));
 }
-
-try { withTelemetrySync('mindlore-research-guard', main); } catch (err) { hookLog('research-guard', 'error', err?.message ?? String(err)); }
+try {
+  withTelemetrySync("mindlore-research-guard", main);
+} catch (err) {
+  hookLog("research-guard", "error", err?.message ?? String(err));
+}