mindlore 0.4.2 → 0.4.3

package/README.md

@@ -184,7 +184,7 @@ Skills spawn subagents with `[mindlore:SKILL]` markers — the model-router hook
 
 ## Hooks
 
-13 Claude Code lifecycle hooks (v0.4.2):
+14 Claude Code lifecycle hooks (v0.4.3):
 
 | Event | Hook | What it does |
 |-------|------|-------------|
@@ -193,7 +193,7 @@ Skills spawn subagents with `[mindlore:SKILL]` markers — the model-router hook
 | UserPromptSubmit | decision-detector | TR+EN decision signal detection |
 | FileChanged | index | Sync changed files to FTS5 |
 | FileChanged | fts5-sync | Incremental batch re-index |
-| SessionEnd | session-end | Structured delta + bare episode + FTS5 mirror + git sync |
+| SessionEnd | session-end | Structured delta + bare episode + FTS5 mirror + detached git sync |
 | PreCompact | pre-compact | FTS5 flush before compaction |
 | PostCompact | post-compact | Re-inject context |
 | PreToolUse (Read) | read-guard | Repeated-read warning, blocks 3+ repeats |
@@ -201,6 +201,7 @@ Skills spawn subagents with `[mindlore:SKILL]` markers — the model-router hook
 | PreToolUse (Write\|Edit) | dont-repeat | LESSONS/learnings rule enforcement |
 | CwdChanged | cwd-changed | Scope detection + _scope.json write |
 | PreToolUse (Agent) | model-router | Cost-optimized model routing via markers |
+| PreToolUse (Agent) | research-guard | FTS5 check before research — blocks if recent+high quality exists |
 
 ## Uninstall
 

package/dist/tests/hook-smoke.test.js

@@ -48,11 +48,11 @@ describe('Hook Smoke Tests', () => {
             expect(file).toMatch(/\.cjs$/);
         }
     });
-    test('hook count should match plan (13 hooks: 7 v0.1 + 2 v0.2 + 3 v0.3 + 1 v0.3.1)', () => {
+    test('hook count should match plan (14 hooks)', () => {
         const hookFiles = fs_1.default
             .readdirSync(HOOKS_DIR)
             .filter((f) => f.startsWith('mindlore-') && f.endsWith('.cjs'));
-        expect(hookFiles).toHaveLength(13);
+        expect(hookFiles).toHaveLength(14);
     });
 });
 //# sourceMappingURL=hook-smoke.test.js.map

package/dist/tests/hook-smoke.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-smoke.test.js","sourceRoot":"","sources":["../../tests/hook-smoke.test.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,4CAAoB;AAEpB,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAEtD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,aAAa,GAAG;QACpB,4BAA4B;QAC5B,qBAAqB;QACrB,oBAAoB;QACpB,wBAAwB;QACxB,0BAA0B;QAC1B,0BAA0B;QAC1B,2BAA2B;KAC5B,CAAC;IAEF,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC9C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAElD,2EAA2E;YAC3E,MAAM,CAAC,GAAG,EAAE;gBACV,IAAI,YAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAChD,MAAM,SAAS,GAAG,YAAE;aACjB,WAAW,CAAC,SAAS,CAAC;aACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;QAE5C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACxF,MAAM,SAAS,GAAG,YAAE;aACjB,WAAW,CAAC,SAAS,CAAC;aACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAElE,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"hook-smoke.test.js","sourceRoot":"","sources":["../../tests/hook-smoke.test.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,4CAAoB;AAEpB,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAEtD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,aAAa,GAAG;QACpB,4BAA4B;QAC5B,qBAAqB;QACrB,oBAAoB;QACpB,wBAAwB;QACxB,0BAA0B;QAC1B,0BAA0B;QAC1B,2BAA2B;KAC5B,CAAC;IAEF,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC9C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAElD,2EAA2E;YAC3E,MAAM,CAAC,GAAG,EAAE;gBACV,IAAI,YAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAChD,MAAM,SAAS,GAAG,YAAE;aACjB,WAAW,CAAC,SAAS,CAAC;aACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;QAE5C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACnD,MAAM,SAAS,GAAG,YAAE;aACjB,WAAW,CAAC,SAAS,CAAC;aACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAElE,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/research-guard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=research-guard.test.d.ts.map

package/dist/tests/research-guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-guard.test.d.ts","sourceRoot":"","sources":["../../tests/research-guard.test.ts"],"names":[],"mappings":""}

package/dist/tests/research-guard.test.js

@@ -0,0 +1,143 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const db_1 = require("./helpers/db");
+const HOOK_PATH = path_1.default.join(__dirname, '..', 'hooks', 'mindlore-research-guard.cjs');
+let tmpDir;
+let dbPath;
+beforeAll(() => {
+    // Create isolated .mindlore/ with test DB
+    tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'mindlore-rg-'));
+    dbPath = path_1.default.join(tmpDir, 'mindlore.db');
+    const db = (0, db_1.createTestDb)(dbPath);
+    // Insert a high-quality recent source
+    (0, db_1.insertFts)(db, {
+        path: 'sources/cc-hooks-reference.md',
+        slug: 'cc-hooks-reference',
+        description: 'Claude Code Hooks Reference',
+        type: 'source',
+        category: 'sources',
+        title: 'Claude Code Hooks — Comprehensive Reference',
+        content: 'Claude Code hooks SessionEnd timeout behavior exit code PreToolUse PostToolUse lifecycle',
+        tags: 'claude-code, hooks, timeout, SessionEnd',
+        quality: 'high',
+        dateCaptured: new Date().toISOString().slice(0, 10),
+        project: 'mindlore',
+    });
+    // Insert a medium-quality source
+    (0, db_1.insertFts)(db, {
+        path: 'sources/obsidian-integration.md',
+        slug: 'obsidian-integration',
+        description: 'Obsidian integration notes',
+        type: 'source',
+        category: 'sources',
+        title: 'Obsidian Vault Integration',
+        content: 'obsidian vault wikilinks export integration markdown',
+        tags: 'obsidian, vault, export',
+        quality: 'medium',
+        dateCaptured: new Date().toISOString().slice(0, 10),
+        project: 'mindlore',
+    });
+    db.close();
+});
+afterAll(() => {
+    fs_1.default.rmSync(tmpDir, { recursive: true, force: true });
+});
+function runHook(input) {
+    const result = (0, child_process_1.spawnSync)('node', [HOOK_PATH], {
+        input: JSON.stringify(input),
+        encoding: 'utf8',
+        timeout: 10000,
+        env: { ...process.env, MINDLORE_HOME: tmpDir },
+    });
+    return {
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+        exitCode: result.status ?? 1,
+    };
+}
+describe('mindlore-research-guard', () => {
+    test('should pass silently for non-Agent tools', () => {
+        const result = runHook({ tool_name: 'Read', tool_input: { file_path: '/tmp/test.md' } });
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toBe('');
+    });
+    test('should pass silently for non-research Agent prompts', () => {
+        const result = runHook({
+            tool_name: 'Agent',
+            tool_input: { prompt: 'Fix the bug in auth module', description: 'coder fix' },
+        });
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toBe('');
+    });
+    test('should pass silently for mindlore ingest operations', () => {
+        const result = runHook({
+            tool_name: 'Agent',
+            tool_input: { prompt: '[mindlore:ingest] Fetch URL and save to raw/', description: 'ingest' },
+        });
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toBe('');
+    });
+    test('should pass silently for [research-override] bypass', () => {
+        const result = runHook({
+            tool_name: 'Agent',
+            tool_input: {
+                prompt: '[research-override] Research the Claude Code hooks timeout',
+                description: 'research',
+            },
+        });
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toBe('');
+    });
+    test('should block (exit 2) when high-quality recent match exists', () => {
+        const result = runHook({
+            tool_name: 'Agent',
+            tool_input: {
+                prompt: 'Research the Claude Code SessionEnd hook timeout behavior',
+                description: 'SessionEnd hook research',
+            },
+        });
+        expect(result.exitCode).toBe(2);
+        expect(result.stderr).toContain('BLOK');
+        expect(result.stderr).toContain('cc-hooks-reference');
+    });
+    test('should pass silently when keywords are too few', () => {
+        const result = runHook({
+            tool_name: 'Agent',
+            tool_input: { prompt: 'Research it', description: 'research' },
+        });
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).toBe('');
+    });
+    test('should return additionalContext for medium-quality matches', () => {
+        const result = runHook({
+            tool_name: 'Agent',
+            tool_input: {
+                prompt: 'Research obsidian vault integration wikilinks export',
+                description: 'obsidian research',
+            },
+        });
+        expect(result.exitCode).toBe(0);
+        if (result.stdout) {
+            const parsed = JSON.parse(result.stdout);
+            expect(parsed.hookSpecificOutput).toBeDefined();
+            expect(parsed.hookSpecificOutput.additionalContext).toContain('mindlore-research-guard');
+        }
+    });
+    test('should handle empty stdin gracefully', () => {
+        const result = (0, child_process_1.spawnSync)('node', [HOOK_PATH], {
+            input: '',
+            encoding: 'utf8',
+            timeout: 5000,
+            env: { ...process.env, MINDLORE_HOME: tmpDir },
+        });
+        expect(result.status).toBe(0);
+    });
+});
+//# sourceMappingURL=research-guard.test.js.map

package/dist/tests/research-guard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-guard.test.js","sourceRoot":"","sources":["../../tests/research-guard.test.ts"],"names":[],"mappings":"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"}

package/hooks/lib/mindlore-common.cjs

@@ -532,6 +532,64 @@ function formatMultiSessionEpisodes(episodes) {
   return lines.join('\n');
 }
 
+// Shared FTS5 search utilities (used by mindlore-search + mindlore-research-guard)
+const STOP_WORDS = new Set([
+  // English
+  'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+  'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+  'should', 'may', 'might', 'can', 'shall', 'to', 'of', 'in', 'for',
+  'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
+  'it', 'its', 'this', 'that', 'these', 'those', 'what', 'which', 'who',
+  'whom', 'how', 'when', 'where', 'why', 'not', 'no', 'nor', 'so',
+  'if', 'or', 'but', 'all', 'each', 'every', 'both', 'few', 'more',
+  'most', 'other', 'some', 'such', 'only', 'own', 'same', 'than',
+  'and', 'about', 'between', 'after', 'before', 'above', 'below',
+  'up', 'down', 'out', 'very', 'just', 'also', 'now', 'then',
+  'here', 'there', 'too', 'yet', 'my', 'your', 'his', 'her', 'our',
+  'their', 'me', 'him', 'us', 'them', 'i', 'you', 'he', 'she', 'we', 'they',
+  // Turkish
+  'bir', 'bu', 'su', 'ne', 'nasil', 'neden', 'var', 'yok', 'mi', 'mu',
+  'ile', 'icin', 'de', 'da', 've', 'veya', 'ama', 'ise', 'hem',
+  'bakalim', 'gel', 'git', 'yap', 'et', 'al', 'ver',
+  'evet', 'hayir', 'tamam', 'ok', 'oldu', 'olur', 'dur',
+  'simdi', 'sonra', 'once', 'hemen', 'biraz',
+  'lan', 'ya', 'ki', 'abi', 'hadi', 'hey', 'selam',
+  'olarak', 'olan', 'gibi', 'kadar', 'daha', 'cok', 'hem',
+  'bunu', 'buna', 'icinde', 'uzerinde', 'arasinda',
+  'sonucu', 'tarafindan', 'zaten', 'gayet',
+  'acaba', 'nedir', 'midir', 'mudur',
+  // Generic technical (appears everywhere, not distinctive)
+  'hook', 'file', 'dosya', 'kullan', 'ekle', 'yaz', 'oku', 'calistir',
+  'kontrol', 'test', 'check', 'run', 'add', 'update', 'config',
+  'setup', 'install', 'start', 'stop', 'create', 'delete', 'remove', 'set',
+  'get', 'list', 'show', 'view', 'open', 'close', 'save', 'load',
+]);
+
+/**
+ * Extract topic keywords from text. Preserves Turkish chars.
+ * @param {string} text - Input text
+ * @param {number} [maxKeywords=8] - Max keywords to return
+ * @returns {string[]} Unique keywords
+ */
+function extractKeywords(text, maxKeywords = 8) {
+  const words = text
+    .toLowerCase()
+    .replace(/[^\w\s\u00e7\u011f\u0131\u00f6\u015f\u00fc-]/g, ' ')
+    .split(/\s+/)
+    .filter((w) => w.length >= 3 && !STOP_WORDS.has(w) && !/^\d+$/.test(w));
+  return [...new Set(words)].slice(0, maxKeywords);
+}
+
+/**
+ * Sanitize keyword for FTS5 MATCH — strip special chars, quote-wrap.
+ * @param {string} kw - Raw keyword
+ * @returns {string|null} Quoted keyword or null if too short
+ */
+function sanitizeKeyword(kw) {
+  const clean = kw.replace(/["*(){}[\]^~:]/g, '').replace(/-/g, ' ').trim();
+  return clean.length >= 2 ? `"${clean}"` : null;
+}
+
 module.exports = {
   MINDLORE_DIR,
   GLOBAL_MINDLORE_DIR,
@@ -571,4 +629,8 @@ module.exports = {
   formatSupersededChains,
   queryMultiSessionEpisodes,
   formatMultiSessionEpisodes,
+  // FTS5 search utilities (v0.4.3)
+  STOP_WORDS,
+  extractKeywords,
+  sanitizeKeyword,
 };

package/hooks/mindlore-research-guard.cjs

@@ -0,0 +1,144 @@
+#!/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 } = 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',
+];
+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;
+
+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);
+  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 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
+         WHERE mindlore_fts MATCH ?
+         ORDER BY rank
+         LIMIT 10`
+      ).all(matchQuery);
+
+      for (const row of rows) {
+        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 || '',
+          quality,
+          date_captured,
+          recent: isRecent(date_captured),
+          rank: row.rank,
+        });
+      }
+
+      db.close();
+    } catch (_err) { /* db open or query failed */ }
+  }
+
+  // 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();
+    if (!raw) return;
+    input = JSON.parse(raw);
+  } catch (_err) {
+    return;
+  }
+
+  const toolName = input.tool_name || '';
+  if (toolName !== 'Agent') return;
+
+  const toolInput = input.tool_input || {};
+  const prompt = (toolInput.prompt || '') + ' ' + (toolInput.description || '');
+
+  // Skip mindlore internal operations and explicit overrides
+  if (EXCLUDE_REGEX.test(prompt)) return;
+
+  // Only trigger on research-intent agents
+  if (!RESEARCH_REGEX.test(prompt)) return;
+
+  const keywords = extractKeywords(prompt, 10);
+  if (keywords.length < 2) return;
+
+  const matches = searchDbs(keywords);
+  if (matches.length === 0) return;
+
+  // Check for high-quality recent matches
+  const strongMatches = matches.filter((m) => m.quality === 'high' && m.recent);
+
+  if (strongMatches.length > 0) {
+    // BLOCK: high quality + recent knowledge exists
+    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.`;
+    process.stderr.write(msg);
+    process.exit(2);
+  }
+
+  // WARN: old or low-quality matches exist
+  const slugList = matches.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.`,
+    },
+  };
+  process.stdout.write(JSON.stringify(output));
+}
+
+main();

package/hooks/mindlore-search.cjs

@@ -10,55 +10,12 @@
 
 const fs = require('fs');
 const path = require('path');
-const { getAllDbs, requireDatabase, extractHeadings, readHookStdin } = require('./lib/mindlore-common.cjs');
+const { getAllDbs, requireDatabase, extractHeadings, readHookStdin, extractKeywords } = require('./lib/mindlore-common.cjs');
 
 const MAX_RESULTS = 3;
 const MIN_QUERY_WORDS = 3;
 const MIN_KEYWORD_HITS = 2;
 
-// Extended stop words (~70 TR + EN) matching old knowledge system
-const STOP_WORDS = new Set([
-  // English
-  'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
-  'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
-  'should', 'may', 'might', 'can', 'shall', 'to', 'of', 'in', 'for',
-  'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
-  'it', 'its', 'this', 'that', 'these', 'those', 'what', 'which', 'who',
-  'whom', 'how', 'when', 'where', 'why', 'not', 'no', 'nor', 'so',
-  'if', 'or', 'but', 'all', 'each', 'every', 'both', 'few', 'more',
-  'most', 'other', 'some', 'such', 'only', 'own', 'same', 'than',
-  'and', 'about', 'between', 'after', 'before', 'above', 'below',
-  'up', 'down', 'out', 'very', 'just', 'also', 'now', 'then',
-  'here', 'there', 'too', 'yet', 'my', 'your', 'his', 'her', 'our',
-  'their', 'me', 'him', 'us', 'them', 'i', 'you', 'he', 'she', 'we', 'they',
-  // Turkish
-  'bir', 'bu', 'su', 'ne', 'nasil', 'neden', 'var', 'yok', 'mi', 'mu',
-  'ile', 'icin', 'de', 'da', 've', 'veya', 'ama', 'ise', 'hem',
-  'bakalim', 'gel', 'git', 'yap', 'et', 'al', 'ver',
-  'evet', 'hayir', 'tamam', 'ok', 'oldu', 'olur', 'dur',
-  'simdi', 'sonra', 'once', 'hemen', 'biraz',
-  'lan', 'ya', 'ki', 'abi', 'hadi', 'hey', 'selam',
-  'olarak', 'olan', 'gibi', 'kadar', 'daha', 'cok', 'hem',
-  'bunu', 'buna', 'icinde', 'uzerinde', 'arasinda',
-  'sonucu', 'tarafindan', 'zaten', 'gayet',
-  'acaba', 'nedir', 'midir', 'mudur',
-  // Generic technical (appears everywhere, not distinctive)
-  'hook', 'file', 'dosya', 'kullan', 'ekle', 'yaz', 'oku', 'calistir',
-  'kontrol', 'test', 'check', 'run', 'add', 'update', 'config',
-  'setup', 'install', 'start', 'stop', 'create', 'delete', 'remove', 'set',
-  'get', 'list', 'show', 'view', 'open', 'close', 'save', 'load',
-]);
-
-function extractKeywords(text) {
-  const words = text
-    .toLowerCase()
-    .replace(/[^\w\s\u00e7\u011f\u0131\u00f6\u015f\u00fc-]/g, ' ')
-    .split(/\s+/)
-    .filter((w) => w.length >= 3 && !STOP_WORDS.has(w) && !/^\d+$/.test(w));
-
-  return [...new Set(words)].slice(0, 8);
-}
-
 /**
  * Search a single DB and return scored results with their baseDir.
  */

package/hooks/mindlore-session-end.cjs

@@ -11,9 +11,26 @@
 
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
+const os = require('os');
+const { execSync, spawn } = require('child_process');
 const { findMindloreDir, globalDir, getProjectName, openDatabase, ensureEpisodesTable, hasEpisodesTable, insertBareEpisode, insertFtsRow } = require('./lib/mindlore-common.cjs');
 
+// --worker mode: heavy ops run in detached child process (survives parent exit)
+if (process.argv.includes('--worker')) {
+  const dataPath = process.argv[process.argv.indexOf('--worker') + 1];
+  try {
+    const raw = fs.readFileSync(dataPath, 'utf8');
+    fs.unlinkSync(dataPath); // cleanup temp file before any processing
+    const { baseDir, project, commits, changedFiles, reads } = JSON.parse(raw);
+    writeBareEpisode(baseDir, project, commits, changedFiles, reads);
+    syncObsidian(baseDir);
+    syncGlobalRepo();
+  } catch (_err) {
+    // Graceful fail — worker errors are silent
+  }
+  process.exit(0);
+}
+
 function formatDate(date) {
   const y = date.getFullYear();
   const m = String(date.getMonth() + 1).padStart(2, '0');
@@ -140,14 +157,25 @@ function main() {
     fs.appendFileSync(logPath, logEntry, 'utf8');
   }
 
-  // v0.4.0: Write bare episode to episodes table
-  writeBareEpisode(baseDir, project, commits, changedFiles, reads);
-
-  // Obsidian auto-export (if vault configured)
-  syncObsidian(baseDir);
-
-  // Git auto-commit + push for global ~/.mindlore/ only
-  syncGlobalRepo();
+  // Heavy ops: detach into child process so CC can exit immediately.
+  // Fixes "Hook cancelled" when CC kills the hook before completion.
+  // See: https://github.com/anthropics/claude-code/issues/41577
+  try {
+    const workerData = JSON.stringify({ baseDir, project, commits, changedFiles, reads });
+    const tmpFile = path.join(os.tmpdir(), `mindlore-worker-${Date.now()}.json`);
+    fs.writeFileSync(tmpFile, workerData, 'utf8');
+    const child = spawn(process.execPath, [__filename, '--worker', tmpFile], {
+      detached: true,
+      stdio: 'ignore',
+      cwd: process.cwd(),
+    });
+    child.unref();
+  } catch (_err) {
+    // Fallback: run inline if spawn fails
+    writeBareEpisode(baseDir, project, commits, changedFiles, reads);
+    syncObsidian(baseDir);
+    syncGlobalRepo();
+  }
 }
 
 /**
@@ -204,7 +232,7 @@ function writeBareEpisode(baseDir, project, commits, changedFiles, reads) {
           description: truncatedSummary,
           type: 'episode',
           category: 'episodes',
-          title: truncatedSummary.slice(0, 100),
+          title: truncatedSummary,
           content: [truncatedSummary, body ?? ''].join('\n').trim(),
           tags: 'session',
           quality: null,
@@ -218,8 +246,8 @@ function writeBareEpisode(baseDir, project, commits, changedFiles, reads) {
     writeBoth();
 
     db.close();
-  } catch (_err) {
-    // Graceful fail — never break session end
+  } catch (err) {
+    process.stderr.write(`[mindlore] episode write failed: ${err?.message ?? err}\n`);
   }
 }
 
@@ -332,7 +360,7 @@ function syncGlobalRepo() {
 
     if (!status) return; // nothing to commit
 
-    execSync('git add -A', { cwd: gDir, timeout: 5000, stdio: 'pipe' });
+    execSync('git add *.md mindlore.db config.json diary/ sources/ domains/ analyses/ decisions/ raw/ connections/ insights/ learnings/', { cwd: gDir, timeout: 5000, stdio: 'pipe' });
     const now = new Date().toISOString().slice(0, 19);
     execSync(`git commit -m "mindlore auto-sync ${now}"`, {
       cwd: gDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindlore",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "AI-native knowledge system for Claude Code",
   "type": "commonjs",
   "bin": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mindlore",
   "description": "AI-native knowledge system for Claude Code. Persistent, searchable, evolving knowledge base with FTS5.",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "skills": [
     {
       "name": "mindlore-ingest",
@@ -94,6 +94,11 @@
       "event": "PreToolUse",
       "script": "hooks/mindlore-model-router.cjs",
       "if": "Agent"
+    },
+    {
+      "event": "PreToolUse",
+      "script": "hooks/mindlore-research-guard.cjs",
+      "if": "Agent"
     }
   ]
 }

package/templates/config.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.4.2",
+  "version": "0.4.3",
   "models": {
     "ingest": "haiku",
     "evolve": "sonnet",