mindlore 0.7.0 → 0.7.2

package/hooks/hooks.json

@@ -0,0 +1,149 @@
+{
+  "description": "Mindlore lifecycle hooks — session context injection, FTS5 search, decision detection, file sync, compaction handling, read/write guards, model routing",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-session-focus.cjs\""
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-search.cjs\""
+          }
+        ]
+      },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-decision-detector.cjs\""
+          }
+        ]
+      }
+    ],
+    "FileChanged": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-index.cjs\""
+          }
+        ]
+      },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-fts5-sync.cjs\""
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-session-end.cjs\""
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-pre-compact.cjs\""
+          }
+        ]
+      }
+    ],
+    "PostCompact": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-post-compact.cjs\""
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-read-guard.cjs\""
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-dont-repeat.cjs\""
+          }
+        ]
+      },
+      {
+        "matcher": "Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-model-router.cjs\""
+          }
+        ]
+      },
+      {
+        "matcher": "Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-research-guard.cjs\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-post-read.cjs\""
+          }
+        ]
+      }
+    ],
+    "CwdChanged": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/mindlore-cwd-changed.cjs\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/lib/mindlore-common.cjs

@@ -10,7 +10,7 @@ const path = require('path');
 const crypto = require('crypto');
 const os = require('os');
 const { EPISODE_KINDS, isValidKind, DB_BUSY_TIMEOUT_MS } = require('./constants.cjs');
-const { safeMkdir, safeWriteFile } = require('../../dist/scripts/lib/secure-io.js');
+const { safeMkdir, safeWriteFile } = require('./secure-io.cjs');
 
 const MINDLORE_DIR = '.mindlore';
 const DB_NAME = 'mindlore.db';
@@ -644,7 +644,7 @@ function resolveWin32Bin(name) {
   if (process.platform === 'win32') {
     try {
       return require('child_process')
-        .execSync(`where ${name}`, { encoding: 'utf8', timeout: 3000, windowsHide: true })
+        .execFileSync('where', [name], { encoding: 'utf8', timeout: 3000, windowsHide: true })
         .trim().split('\n')[0].trim();
     } catch (_e) { /* fall through */ }
   }

package/hooks/lib/secure-io.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+const fs = require('fs');
+
+function safeMkdir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true, mode: 0o700 });
+}
+
+function safeWriteFile(filePath, data) {
+  fs.writeFileSync(filePath, data, { encoding: 'utf8', mode: 0o600 });
+}
+
+function safeWriteJson(filePath, obj) {
+  safeWriteFile(filePath, JSON.stringify(obj, null, 2) + '\n');
+}
+
+module.exports = { safeMkdir, safeWriteFile, safeWriteJson };

package/hooks/mindlore-cwd-changed.cjs

@@ -1,57 +1,42 @@
 #!/usr/bin/env node
-'use strict';
-
-/**
- * mindlore-cwd-changed — CwdChanged hook
- *
- * Fires when user changes working directory.
- * CwdChanged has NO inject to Claude — stdout is swallowed, stderr shown to user.
- *
- * Side effects:
- *   1. Detect scope (global ~/.mindlore/ or none)
- *   2. Write scope state to .mindlore/diary/_scope.json for session-focus to read
- *   3. Show user-facing message via stderr
- */
-
-const fs = require('fs');
-const path = require('path');
-const { findMindloreDir, globalDir, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
+"use strict";
 
+// hooks/src/mindlore-cwd-changed.cjs
+var fs = require("fs");
+var path = require("path");
+var { findMindloreDir, globalDir, hookLog, withTelemetry } = require("./lib/mindlore-common.cjs");
 function main() {
   const cwd = process.cwd();
   const activeDir = findMindloreDir();
-  const scope = !activeDir ? 'none' : activeDir.startsWith(globalDir()) ? 'global' : 'project';
-
+  const scope = !activeDir ? "none" : activeDir.startsWith(globalDir()) ? "global" : "project";
   if (activeDir) {
-    const diaryDir = path.join(activeDir, 'diary');
+    const diaryDir = path.join(activeDir, "diary");
     if (!fs.existsSync(diaryDir)) {
       fs.mkdirSync(diaryDir, { recursive: true });
     }
-
-    // Dirty-check: skip write if scope hasn't changed
-    const scopePath = path.join(diaryDir, '_scope.json');
+    const scopePath = path.join(diaryDir, "_scope.json");
     if (fs.existsSync(scopePath)) {
       try {
-        const existing = JSON.parse(fs.readFileSync(scopePath, 'utf8'));
+        const existing = JSON.parse(fs.readFileSync(scopePath, "utf8"));
         if (existing.cwd === cwd && existing.scope === scope) return;
       } catch (_err) {
-        // corrupt file — overwrite
       }
     }
-
     fs.writeFileSync(scopePath, JSON.stringify({
       scope,
       dir: activeDir,
       cwd,
-      timestamp: new Date().toISOString(),
-    }, null, 2), 'utf8');
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    }, null, 2), "utf8");
   }
-
-  if (scope === 'none') {
-    process.stderr.write(`[Mindlore] Bu projede mindlore kurulu degil. npx mindlore init calistirin.\n`);
+  if (scope === "none") {
+    process.stderr.write(`[Mindlore] Bu projede mindlore kurulu degil. npx mindlore init calistirin.
+`);
   } else {
-    process.stderr.write(`[Mindlore scope: ${scope}] ${activeDir}\n`);
+    process.stderr.write(`[Mindlore scope: ${scope}] ${activeDir}
+`);
   }
 }
-
-withTelemetry('mindlore-cwd-changed', main).catch(err => { hookLog('cwd-changed', 'error', err?.message ?? String(err)); });
+withTelemetry("mindlore-cwd-changed", main).catch((err) => {
+  hookLog("cwd-changed", "error", err?.message ?? String(err));
+});

package/hooks/mindlore-decision-detector.cjs

@@ -1,29 +1,41 @@
 #!/usr/bin/env node
-'use strict';
-
-/**
- * mindlore-decision-detector — UserPromptSubmit hook
- *
- * Detects decision signals in user messages (TR + EN).
- * Outputs a suggestion to record the decision via /mindlore-decide.
- * Does NOT block (exit 0) — advisory only.
- */
-
-const { findMindloreDir, readHookStdin, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
-
-const SIGNALS_TR = [
-  'karar verdik', 'karar verildi', 'kararlastirdik', 'kararlaştırdık',
-  'şunu seçtik', 'sunu sectik', 'bunu yapmayalım', 'bunu yapmayalim',
-  'yerine', 'tercih ettik', 'onaylandi', 'onaylandı', 'kesinleşti', 'kesinlesti',
-  'vazgeçtik', 'vazgectik', 'iptal ettik',
+"use strict";
+
+// hooks/src/mindlore-decision-detector.cjs
+var { findMindloreDir, readHookStdin, hookLog, withTelemetry } = require("./lib/mindlore-common.cjs");
+var SIGNALS_TR = [
+  "karar verdik",
+  "karar verildi",
+  "kararlastirdik",
+  "kararla\u015Ft\u0131rd\u0131k",
+  "\u015Funu se\xE7tik",
+  "sunu sectik",
+  "bunu yapmayal\u0131m",
+  "bunu yapmayalim",
+  "yerine",
+  "tercih ettik",
+  "onaylandi",
+  "onayland\u0131",
+  "kesinle\u015Fti",
+  "kesinlesti",
+  "vazge\xE7tik",
+  "vazgectik",
+  "iptal ettik"
 ];
-
-const SIGNALS_EN = [
-  'decided', 'decision made', "let's go with", 'lets go with',
-  "we'll use", 'well use', 'approved', 'settled on',
-  'going with', 'chosen', 'finalized', 'rejected',
+var SIGNALS_EN = [
+  "decided",
+  "decision made",
+  "let's go with",
+  "lets go with",
+  "we'll use",
+  "well use",
+  "approved",
+  "settled on",
+  "going with",
+  "chosen",
+  "finalized",
+  "rejected"
 ];
-
 function detectDecision(text) {
   const lower = text.toLowerCase();
   for (const signal of SIGNALS_TR) {
@@ -34,21 +46,18 @@ function detectDecision(text) {
   }
   return null;
 }
-
 function main() {
   const baseDir = findMindloreDir();
   if (!baseDir) return;
-
-  const userText = readHookStdin(['prompt', 'content', 'message']);
+  const userText = readHookStdin(["prompt", "content", "message"]);
   if (!userText || userText.length < 10) return;
-
   const signal = detectDecision(userText);
   if (signal) {
-    process.stdout.write(`[Mindlore: Karar sinyali tespit edildi ("${signal}") — /mindlore-decide record ile kaydetmek ister misin?]\n`);
+    process.stdout.write(`[Mindlore: Karar sinyali tespit edildi ("${signal}") \u2014 /mindlore-decide record ile kaydetmek ister misin?]
+`);
   }
 }
-
-withTelemetry('mindlore-decision-detector', main).catch(err => {
-  hookLog('mindlore-decision-detector', 'error', err?.message ?? String(err));
+withTelemetry("mindlore-decision-detector", main).catch((err) => {
+  hookLog("mindlore-decision-detector", "error", err?.message ?? String(err));
   process.exit(0);
 });

package/hooks/mindlore-dont-repeat.cjs

@@ -1,58 +1,34 @@
 #!/usr/bin/env node
-'use strict';
-
-/**
- * mindlore-dont-repeat — PreToolUse hook (matcher: "Write|Edit")
- *
- * Checks code being written against negative rules (DON'T, NEVER, AVOID, YAPMA, etc.)
- * found in LESSONS files and Mindlore learnings/.
- *
- * Sources checked (in order):
- *   1. ~/.claude/lessons/global.md (global rules)
- *   2. ./LESSONS.md (project-level rules, if exists)
- *   3. .mindlore/learnings/*.md (Mindlore learnings, if exists)
- *
- * Advisory only (exit 0) — does not block, injects additionalContext warning.
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { findMindloreDir, getProjectName, hookLog, withTelemetrySync } = require('./lib/mindlore-common.cjs');
-
-/**
- * File-persisted pattern cache — survives across process invocations.
- * Cache file: .mindlore/diary/_pattern-cache.json
- * Each entry keyed by source file path, stores mtimeMs + extracted patterns.
- * On hit: stat only, no readFile+parse. On miss: read, parse, update cache.
- */
-
-let cacheDirty = false;
-
+"use strict";
+
+// hooks/src/mindlore-dont-repeat.cjs
+var fs = require("fs");
+var path = require("path");
+var os = require("os");
+var { findMindloreDir, getProjectName, hookLog, withTelemetrySync } = require("./lib/mindlore-common.cjs");
+var cacheDirty = false;
 function readCache(cachePath) {
   if (!cachePath) return {};
   try {
-    return JSON.parse(fs.readFileSync(cachePath, 'utf8'));
+    return JSON.parse(fs.readFileSync(cachePath, "utf8"));
   } catch (_err) {
     return {};
   }
 }
-
 function writeCache(cachePath, cache) {
   if (!cachePath || !cacheDirty) return;
   try {
-    fs.writeFileSync(cachePath, JSON.stringify(cache), 'utf8');
-  } catch (_err) { /* write failure is non-fatal */ }
+    fs.writeFileSync(cachePath, JSON.stringify(cache), "utf8");
+  } catch (_err) {
+  }
 }
-
 function loadPatterns(filePath, cache) {
   try {
     const stat = fs.statSync(filePath);
     const mtimeMs = stat.mtimeMs;
     const cached = cache[filePath];
     if (cached && cached.mtimeMs === mtimeMs) return cached.patterns;
-
-    const patterns = extractNegativePatterns(fs.readFileSync(filePath, 'utf8'));
+    const patterns = extractNegativePatterns(fs.readFileSync(filePath, "utf8"));
     cache[filePath] = { mtimeMs, patterns };
     cacheDirty = true;
     return patterns;
@@ -60,42 +36,30 @@ function loadPatterns(filePath, cache) {
     return [];
   }
 }
-
 function extractNegativePatterns(content) {
   const patterns = [];
-  const lines = content.split('\n');
-
+  const lines = content.split("\n");
   for (const line of lines) {
     const trimmed = line.trim();
-    // Multi-language: TR (YAPMA, KRITIK) + EN (DON'T, NEVER, AVOID, DO NOT)
     const isNegativeRule = /^-\s*(YAPMA|KRITIK|DON'?T|NEVER|AVOID|DO NOT):/i.test(trimmed);
     if (!isNegativeRule) continue;
-
-    // Extract backtick-quoted code patterns: `pattern`
     const backtickMatches = trimmed.match(/`([^`]+)`/g);
     if (backtickMatches) {
       for (const match of backtickMatches) {
         const pattern = match.slice(1, -1).trim();
-        // Skip short/generic patterns — too many false positives
         if (pattern.length < 8) continue;
         if (/^[^a-zA-Z0-9]+$/.test(pattern)) continue;
-        // Skip single words (too generic: "node", "bash", "any")
         if (/^\w+$/.test(pattern) && pattern.length < 12) continue;
-        // Skip file extensions and paths
         if (/^\.\w{1,5}$/.test(pattern)) continue;
-        if (pattern.startsWith('/') || pattern.startsWith('~')) continue;
-        if (pattern.includes('.md') || pattern.includes('.json')) continue;
-        // Skip common false-positive patterns
+        if (pattern.startsWith("/") || pattern.startsWith("~")) continue;
+        if (pattern.includes(".md") || pattern.includes(".json")) continue;
         if (/^(node|bash|npm|git|process|require|import|export|const|let|var)$/i.test(pattern)) continue;
-
         patterns.push({
           pattern,
-          rule: trimmed.substring(0, 120),
+          rule: trimmed.substring(0, 120)
         });
       }
     }
-
-    // Extract "quoted strings" as patterns
     const quoteMatches = trimmed.match(/"([^"]+)"/g);
     if (quoteMatches) {
       for (const match of quoteMatches) {
@@ -103,120 +67,116 @@ function extractNegativePatterns(content) {
         if (quoted.length < 4) continue;
         patterns.push({
           pattern: quoted,
-          rule: trimmed.substring(0, 120),
+          rule: trimmed.substring(0, 120)
         });
       }
     }
   }
-
   return patterns;
 }
-
+var _lessonsEnforcementCached = null;
+function hasLessonsEnforcementHook() {
+  if (_lessonsEnforcementCached !== null) return _lessonsEnforcementCached;
+  try {
+    const settingsPath = path.join(os.homedir(), ".claude", "settings.json");
+    const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    const hooks = settings.hooks || {};
+    const preToolUse = hooks.PreToolUse || [];
+    _lessonsEnforcementCached = preToolUse.some((entry) => {
+      const cmds = (entry.hooks || []).map((h) => h.command || "").concat(entry.command || "");
+      return cmds.some((c) => c.includes("lessons-enforcement"));
+    });
+  } catch (_err) {
+    _lessonsEnforcementCached = false;
+  }
+  return _lessonsEnforcementCached;
+}
 function checkContent(content, patterns) {
   const matches = [];
   for (const p of patterns) {
     try {
-      const escaped = p.pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      const regex = new RegExp(escaped, 'i');
+      const escaped = p.pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      const regex = new RegExp(escaped, "i");
       if (regex.test(content)) {
         matches.push(p);
       }
-    } catch { /* skip invalid patterns */ }
+    } catch {
+    }
   }
   return matches;
 }
-
 function main() {
-  let input = '';
-  const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-  process.stdin.setEncoding('utf8');
-  process.stdin.on('error', () => process.exit(0));
-  process.stdin.on('data', chunk => input += chunk);
-  process.stdin.on('end', () => {
+  let input = "";
+  const stdinTimeout = setTimeout(() => process.exit(0), 3e3);
+  process.stdin.setEncoding("utf8");
+  process.stdin.on("error", () => process.exit(0));
+  process.stdin.on("data", (chunk) => input += chunk);
+  process.stdin.on("end", () => {
     clearTimeout(stdinTimeout);
     try {
-      const data = JSON.parse(input || '{}');
-      const toolName = data.tool_name || '';
-
-      if (!['Write', 'Edit'].includes(toolName)) {
+      const data = JSON.parse(input || "{}");
+      const toolName = data.tool_name || "";
+      if (!["Write", "Edit"].includes(toolName)) {
         return process.exit(0);
       }
-
       const toolInput = data.tool_input || {};
-      const filePath = toolInput.file_path || '';
-
-      // Skip non-code files
+      const filePath = toolInput.file_path || "";
       if (!filePath) return process.exit(0);
       const ext = path.extname(filePath).toLowerCase();
-      const codeExts = ['.ts', '.tsx', '.js', '.jsx', '.cjs', '.mjs', '.py', '.go', '.rs', '.java', '.c', '.cpp', '.h', '.sh', '.yaml', '.yml'];
+      const codeExts = [".ts", ".tsx", ".js", ".jsx", ".cjs", ".mjs", ".py", ".go", ".rs", ".java", ".c", ".cpp", ".h", ".sh", ".yaml", ".yml"];
       if (!codeExts.includes(ext)) return process.exit(0);
-
-      // Skip rule files themselves
       const basename = path.basename(filePath);
-      if (basename === 'LESSONS.md' || basename === 'global.md' || basename === 'CLAUDE.md') {
+      if (basename === "LESSONS.md" || basename === "global.md" || basename === "CLAUDE.md") {
         return process.exit(0);
       }
-
-      // Collect content being written (skip old_string — that's code being removed, not added)
       const allContent = [
-        toolInput.content || '',
-        toolInput.new_string || '',
-      ].join('\n');
-
+        toolInput.content || "",
+        toolInput.new_string || ""
+      ].join("\n");
       if (allContent.trim().length < 10) return process.exit(0);
-
-      // Load patterns from all sources (file-persisted mtime cache)
+      if (hasLessonsEnforcementHook()) return process.exit(0);
       const mindloreDir = findMindloreDir();
-      const cachePath = mindloreDir ? path.join(mindloreDir, 'diary', `_pattern-cache-${getProjectName()}.json`) : null;
+      const cachePath = mindloreDir ? path.join(mindloreDir, "diary", `_pattern-cache-${getProjectName()}.json`) : null;
       const cache = readCache(cachePath);
       const allPatterns = [];
       const cwd = process.cwd();
-
-      // 1. Global lessons
-      allPatterns.push(...loadPatterns(path.join(os.homedir(), '.claude', 'lessons', 'global.md'), cache));
-
-      // 2. Project LESSONS.md
-      allPatterns.push(...loadPatterns(path.join(cwd, 'LESSONS.md'), cache));
-
-      // 3. Mindlore learnings/ directory
+      allPatterns.push(...loadPatterns(path.join(os.homedir(), ".claude", "lessons", "global.md"), cache));
+      allPatterns.push(...loadPatterns(path.join(cwd, "LESSONS.md"), cache));
       if (mindloreDir) {
-        const learningsDir = path.join(mindloreDir, 'learnings');
+        const learningsDir = path.join(mindloreDir, "learnings");
         try {
-          const files = fs.readdirSync(learningsDir).filter(f => f.endsWith('.md'));
+          const files = fs.readdirSync(learningsDir).filter((f) => f.endsWith(".md"));
           for (const file of files) {
             allPatterns.push(...loadPatterns(path.join(learningsDir, file), cache));
           }
-        } catch (_err) { /* learnings/ doesn't exist yet */ }
+        } catch (_err) {
+        }
       }
-
       writeCache(cachePath, cache);
-
       if (allPatterns.length === 0) return process.exit(0);
-
-      // Check content against patterns
       const matches = checkContent(allContent, allPatterns);
       if (matches.length === 0) return process.exit(0);
-
-      // Build warning — max 3 matches shown
       const shown = matches.slice(0, 3);
-      const warning = shown.map(m =>
-        `  - Pattern: \`${m.pattern}\` → ${m.rule}`
-      ).join('\n');
-      const extra = matches.length > 3 ? `\n  ... and ${matches.length - 3} more` : '';
-
-      const msg = `[Mindlore: ${matches.length} dont-repeat rule violation detected]\n${warning}${extra}`;
-
+      const warning = shown.map(
+        (m) => `  - Pattern: \`${m.pattern}\` \u2192 ${m.rule}`
+      ).join("\n");
+      const extra = matches.length > 3 ? `
+  ... and ${matches.length - 3} more` : "";
+      const msg = `[Mindlore: ${matches.length} dont-repeat rule violation detected]
+${warning}${extra}`;
       process.stdout.write(JSON.stringify({
         hookSpecificOutput: {
-          hookEventName: 'PreToolUse',
+          hookEventName: "PreToolUse",
           additionalContext: msg
         }
       }));
     } catch {
-      // Silent fail
     }
     process.exit(0);
   });
 }
-
-try { withTelemetrySync('mindlore-dont-repeat', main); } catch (err) { hookLog('dont-repeat', 'error', err?.message ?? String(err)); }
+try {
+  withTelemetrySync("mindlore-dont-repeat", main);
+} catch (err) {
+  hookLog("dont-repeat", "error", err?.message ?? String(err));
+}