mindlore 0.0.1 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 mindlore
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 mindlore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -44,7 +44,7 @@ To add your first source:
 | Skill | Version | Description |
 |-------|---------|-------------|
 | `/mindlore-ingest` | v0.1 | Add knowledge sources (URL, text, file, PDF) |
-| `/mindlore-health` | v0.1 | 16-point structural health check |
+| `/mindlore-health` | v0.1 | 18-point structural health check |
 | `/mindlore-query` | v0.2 | Search and retrieve knowledge (4 modes) |
 | `/mindlore-log` | v0.2 | Session logging with reflect and status |
 | `/mindlore-decide` | v0.2 | Decision records with supersedes chain |
@@ -103,19 +103,76 @@ Also suggests installing:
 - **markitdown** — better web/document extraction (URL, DOCX, YouTube)
 - **context-mode** — token savings for large sessions
 
+## How It Works
+
+Mindlore operates through Claude Code lifecycle hooks — invisible background scripts
+that fire automatically as you work. No commands to run, no workflow changes.
+
+```
+                          ┌─────────────────────────────┐
+                          │     Claude Code Session      │
+                          └──────────────┬──────────────┘
+                                         │
+  ┌──────────────────────────────────────┼──────────────────────────────────────┐
+  │                                      │                                      │
+  ▼                                      ▼                                      ▼
+SESSION START                      DURING SESSION                         SESSION END
+  │                                      │                                      │
+  ├─ session-focus hook            ├─ search hook                         ├─ session-end hook
+  │  reads INDEX.md + last delta   │  7-col FTS5 + porter stemmer         │  writes delta to diary/
+  │  injects into context          │  per-keyword scoring, top 3 injected │
+  │                                │                                      │
+  │                                ├─ index + fts5-sync hooks             │
+  │                                │  file changes → FTS5 update          │
+  │                                │                                      │
+  │                                ├─ /mindlore-ingest skill              │
+  │                                │  URL → raw/ → sources/ → FTS5       │
+  │                                │                                      │
+  └────────────────────────────────┴──────────────────────────────────────┘
+                                         │
+                          ┌──────────────┴──────────────┐
+                          │       NEXT SESSION           │
+                          │  session-focus injects delta  │
+                          │  → knowledge compounds       │
+                          └─────────────────────────────┘
+```
+
+**Key design decisions:**
+
+- **Hooks are global** — registered in `~/.claude/settings.json`, active in all projects
+- **Data is per-project** — `.mindlore/` lives in each project directory
+- **No `.mindlore/`?** — hooks silently skip, zero overhead
+- **FTS5 search** — SQLite full-text search with BM25 ranking, no external services
+- **Content-hash dedup** — SHA256 prevents re-indexing unchanged files
+
 ## Hooks
 
-Mindlore works through 7 Claude Code lifecycle hooks (v0.1):
+9 Claude Code lifecycle hooks (v0.2):
 
 | Event | Hook | What it does |
 |-------|------|-------------|
 | SessionStart | session-focus | Injects last delta + INDEX |
-| UserPromptSubmit | search | FTS5 search, top 3 results |
+| UserPromptSubmit | search | FTS5 search, top 3 results + tags |
+| 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 | Write delta to diary/ |
+| SessionEnd | session-end | Structured delta (commits, files, reads) |
 | PreCompact | pre-compact | FTS5 flush before compaction |
 | PostCompact | post-compact | Re-inject context |
+| PreToolUse (Read) | read-guard | Repeated-read warning |
+
+## Uninstall
+
+Remove Mindlore from your system:
+
+```bash
+npx mindlore uninstall
+```
+
+This removes:
+- Hooks from `~/.claude/settings.json`
+- Skills from `~/.claude/skills/`
+- Optionally: `.mindlore/` project data (asks for confirmation)
 
 ## Inspired By
 

package/SCHEMA.md

@@ -59,14 +59,14 @@ tags: [tag1, tag2]
 
 | Type | Required Fields | Optional |
 |------|----------------|----------|
-| `raw` | slug, type, source_url | tags |
-| `source` | slug, type, title, tags, quality, source_url, ingested | date_captured |
-| `domain` | slug, type, title, tags | — |
-| `analysis` | slug, type, title, tags, confidence, sources_used | — |
-| `insight` | slug, type, title, tags | sources_used |
-| `connection` | slug, type, title, tags | sources_used |
-| `learning` | slug, type, title, tags | — |
-| `decision` | slug, type, title, tags | supersedes, status |
+| `raw` | slug, type, source_url | tags, description |
+| `source` | slug, type, title, tags, quality, source_url, ingested | date_captured, description, raw_slug |
+| `domain` | slug, type, title, tags | description, status |
+| `analysis` | slug, type, title, tags, confidence, sources_used | description |
+| `insight` | slug, type, title, tags | sources_used, description |
+| `connection` | slug, type, title, tags | sources_used, description |
+| `learning` | slug, type, title, tags | description |
+| `decision` | slug, type, title, tags | supersedes, status, description |
 | `diary` | slug, type, date | — (hook adds automatically) |
 
 ### Field Value Rules
@@ -77,6 +77,9 @@ tags: [tag1, tag2]
 - `sources_used`: list of slugs referenced in the analysis
 - `supersedes`: slug of the decision this one replaces
 - `date`: ISO 8601 date (YYYY-MM-DD)
+- `description`: one-line summary (15-30 words). Used in FTS5 search and inject output. Optional but strongly recommended for search quality
+- `raw_slug`: slug of the raw/ file this source was processed from (source→raw traceability)
+- `status`: `stub` | `active` | `archived` (domain maturity indicator)
 
 ## 4. Seven Operations
 
@@ -140,14 +143,70 @@ Discover unexpected connections between sources. Cross-reference analysis.
 - Max results: 3 per query (BM25 ranking)
 - Hook injects: file path + first 2 headings
 
+### FTS5 Columns (9-col schema, v0.2)
+
+| Column | Indexed | Source |
+|--------|---------|--------|
+| `path` | UNINDEXED | File system path |
+| `slug` | Yes | Frontmatter slug |
+| `description` | Yes | Frontmatter description |
+| `type` | UNINDEXED | Frontmatter type |
+| `category` | Yes | Parent directory name |
+| `title` | Yes | Frontmatter title or first heading |
+| `content` | Yes | Markdown body (sans frontmatter) |
+| `tags` | Yes | Frontmatter tags (comma-separated) |
+| `quality` | UNINDEXED | Frontmatter quality (NULL until 50+ sources) |
+
 ### Search Flow (UserPromptSubmit hook)
 
 1. Extract keywords from user prompt
 2. Query FTS5 with BM25 ranking
-3. Return max 3 results as stderr additionalContext
+3. Return max 3 results as stdout additionalContext
 4. Agent reads full file only if needed (progressive disclosure)
 
-## 6. Compounding
+## 6. Wiki vs Diary (Writeback Target Rules)
+
+Knowledge goes to one of two layers. The agent MUST pick the correct one.
+
+### Wiki Layer (permanent knowledge)
+
+Directories: `sources/`, `domains/`, `analyses/`, `insights/`, `connections/`, `learnings/`
+
+- Persists across sessions — reference value
+- Indexed by FTS5, discoverable via search hook
+- Updated by ingest, query writeback, reflect, evolve
+- Content should be factual, sourced, and reusable
+
+### Diary Layer (session-scoped logs)
+
+Directories: `diary/`, `decisions/`
+
+- Session-specific: deltas, logs, decision snapshots
+- diary/ entries get `archived: true` after reflect processes them
+- decisions/ are permanent but session-originated (context + rationale)
+- Patterns extracted from diary → moved to `learnings/` (wiki layer)
+
+### Selection Rule
+
+| Content Type | Target | Example |
+|-------------|--------|---------|
+| Ingested source summary | `sources/` | URL or text summary |
+| Topic wiki page | `domains/` | Consolidated knowledge on a subject |
+| Multi-source synthesis | `analyses/` | Comparison table, architecture decision |
+| Short Q&A answer | `insights/` | Query writeback (<200 lines) |
+| Cross-reference finding | `connections/` | Link between 2+ unrelated sources |
+| Persistent rule/lesson | `learnings/` | YAPMA/BEST PRACTICE from reflect |
+| Session log/delta | `diary/` | What happened this session |
+| Decision record | `decisions/` | Why X was chosen over Y |
+| Raw capture | `raw/` | Immutable original (URL dump, paste) |
+
+### Anti-patterns
+
+- Do NOT write session-specific notes to `insights/` — use `diary/`
+- Do NOT write permanent rules to `diary/` — use `learnings/`
+- Do NOT write decision rationale to `analyses/` — use `decisions/`
+
+## 7. Compounding
 
 Knowledge compounds when outputs become inputs:
 
@@ -170,7 +229,7 @@ Offer to save when:
 - Large synthesis (200+ lines, 3+ sources) → analyses/
 - Cross-cutting link → connections/
 
-## 7. Learnings
+## 8. Learnings
 
 Persistent rules extracted from reflect operations.
 Organized by topic: `git.md`, `testing.md`, `security.md`, etc.
@@ -198,7 +257,7 @@ tags: [testing, jest, mock]
 - Use `YAPMA:` / `BEST PRACTICE:` / `KRITIK:` prefixes
 - Reflect skill proposes, user approves before writing
 
-## 8. Naming Conventions
+## 9. Naming Conventions
 
 ### Files
 

package/hooks/lib/mindlore-common.cjs

@@ -41,6 +41,82 @@ function sha256(content) {
   return crypto.createHash('sha256').update(content, 'utf8').digest('hex');
 }
 
+/**
+ * Parse YAML frontmatter from markdown content.
+ * Returns { meta: { key: value }, body: string }
+ */
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return { meta: {}, body: content };
+
+  const meta = {};
+  const lines = match[1].split('\n');
+  for (const line of lines) {
+    const colonIdx = line.indexOf(':');
+    if (colonIdx === -1) continue;
+    const key = line.slice(0, colonIdx).trim();
+    let value = line.slice(colonIdx + 1).trim();
+    if (value.startsWith('[') && value.endsWith(']')) {
+      value = value.slice(1, -1).split(',').map((s) => s.trim().replace(/^["']|["']$/g, ''));
+    }
+    if (typeof value === 'string') {
+      value = value.replace(/^["']|["']$/g, '');
+    }
+    meta[key] = value;
+  }
+
+  const bodyStart = content.indexOf('---', 3);
+  const body = bodyStart !== -1 ? content.slice(bodyStart + 3).replace(/^\r?\n/, '') : content;
+
+  return { meta, body };
+}
+
+/**
+ * Extract FTS5 metadata from parsed frontmatter + file path.
+ * Returns { slug, description, type, category, title }
+ */
+function extractFtsMetadata(meta, body, filePath, baseDir) {
+  const slug = meta.slug || path.basename(filePath, '.md');
+  const description = meta.description || '';
+  const type = meta.type || '';
+  const relativePath = baseDir ? path.relative(baseDir, filePath) : filePath;
+  const category = path.dirname(relativePath).split(path.sep)[0] || 'root';
+  let title = meta.title || meta.name || '';
+  if (!title) {
+    const headingMatch = body.match(/^#\s+(.+)/m);
+    title = headingMatch ? headingMatch[1].trim() : path.basename(filePath, '.md');
+  }
+  let tags = '';
+  if (meta.tags) {
+    tags = Array.isArray(meta.tags) ? meta.tags.join(', ') : String(meta.tags);
+  }
+  const quality = meta.quality !== undefined && meta.quality !== null ? meta.quality : null;
+  return { slug, description, type, category, title, tags, quality };
+}
+
+/**
+ * Shared SQL constants to prevent drift across indexing paths.
+ */
+const SQL_FTS_CREATE =
+  "CREATE VIRTUAL TABLE IF NOT EXISTS mindlore_fts USING fts5(path UNINDEXED, slug, description, type UNINDEXED, category, title, content, tags, quality UNINDEXED, tokenize='porter unicode61')";
+
+const SQL_FTS_INSERT =
+  'INSERT INTO mindlore_fts (path, slug, description, type, category, title, content, tags, quality) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)';
+
+/**
+ * Extract headings (h1-h3) from markdown content.
+ */
+function extractHeadings(content, max) {
+  const headings = [];
+  for (const line of content.split('\n')) {
+    if (/^#{1,3}\s/.test(line)) {
+      headings.push(line.replace(/^#+\s*/, '').trim());
+      if (headings.length >= max) break;
+    }
+  }
+  return headings;
+}
+
 function requireDatabase() {
   try {
     return require('better-sqlite3');
@@ -77,6 +153,30 @@ function getAllMdFiles(dir, skip) {
   return results;
 }
 
+/**
+ * Read CC hook stdin and parse JSON envelope.
+ * Returns the value of the first matching field, or raw text as fallback.
+ * @param {string[]} fields - Priority-ordered field names to extract
+ */
+function readHookStdin(fields) {
+  let input = '';
+  try {
+    input = fs.readFileSync(0, 'utf8').trim();
+  } catch (_err) {
+    return '';
+  }
+  if (!input) return '';
+  try {
+    const parsed = JSON.parse(input);
+    for (const f of fields) {
+      if (parsed[f]) return parsed[f];
+    }
+  } catch (_err) {
+    // plain text
+  }
+  return input;
+}
+
 module.exports = {
   MINDLORE_DIR,
   DB_NAME,
@@ -84,6 +184,12 @@ module.exports = {
   findMindloreDir,
   getLatestDelta,
   sha256,
+  parseFrontmatter,
+  extractFtsMetadata,
+  readHookStdin,
+  SQL_FTS_CREATE,
+  SQL_FTS_INSERT,
+  extractHeadings,
   requireDatabase,
   openDatabase,
   getAllMdFiles,

package/hooks/mindlore-decision-detector.cjs

@@ -0,0 +1,51 @@
+#!/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 } = 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',
+];
+
+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',
+];
+
+function detectDecision(text) {
+  const lower = text.toLowerCase();
+  for (const signal of SIGNALS_TR) {
+    if (lower.includes(signal)) return signal;
+  }
+  for (const signal of SIGNALS_EN) {
+    if (lower.includes(signal)) return signal;
+  }
+  return null;
+}
+
+function main() {
+  const baseDir = findMindloreDir();
+  if (!baseDir) return;
+
+  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`);
+  }
+}
+
+main();

package/hooks/mindlore-fts5-sync.cjs

@@ -13,46 +13,33 @@
 
 const fs = require('fs');
 const path = require('path');
-const { MINDLORE_DIR, DB_NAME, sha256, requireDatabase, getAllMdFiles } = require('./lib/mindlore-common.cjs');
+const { MINDLORE_DIR, DB_NAME, sha256, openDatabase, getAllMdFiles, parseFrontmatter, extractFtsMetadata, SQL_FTS_INSERT, readHookStdin } = require('./lib/mindlore-common.cjs');
 
 function main() {
-  // Read stdin to check if this is a .mindlore/ file change
-  let input = '';
-  try {
-    input = fs.readFileSync(0, 'utf8').trim();
-  } catch (_err) {
-    // No stdin — skip
-  }
-
-  let filePath = '';
-  try {
-    const parsed = JSON.parse(input);
-    filePath = parsed.path || parsed.file_path || '';
-  } catch (_err) {
-    filePath = input;
-  }
+  const filePath = readHookStdin(['path', 'file_path']);
 
   // Only trigger on .mindlore/ changes (empty filePath = skip)
   if (!filePath || !filePath.includes(MINDLORE_DIR)) return;
 
+  // Skip if this is a single .md file change — mindlore-index.cjs handles those.
+  // This hook is for bulk changes (git pull, manual batch edits).
+  if (filePath.endsWith('.md')) return;
+
   const baseDir = path.join(process.cwd(), MINDLORE_DIR);
   if (!fs.existsSync(baseDir)) return;
 
   const dbPath = path.join(baseDir, DB_NAME);
   if (!fs.existsSync(dbPath)) return;
 
-  const Database = requireDatabase();
-  if (!Database) return;
-
-  const db = new Database(dbPath);
-  db.pragma('journal_mode = WAL');
+  const db = openDatabase(dbPath);
+  if (!db) return;
 
   const mdFiles = getAllMdFiles(baseDir);
   let synced = 0;
 
   const getHash = db.prepare('SELECT content_hash FROM file_hashes WHERE path = ?');
   const deleteFts = db.prepare('DELETE FROM mindlore_fts WHERE path = ?');
-  const insertFts = db.prepare('INSERT INTO mindlore_fts (path, content) VALUES (?, ?)');
+  const insertFts = db.prepare(SQL_FTS_INSERT);
   const upsertHash = db.prepare(`
     INSERT INTO file_hashes (path, content_hash, last_indexed)
     VALUES (?, ?, ?)
@@ -72,8 +59,10 @@ function main() {
         const existing = getHash.get(file);
         if (existing && existing.content_hash === hash) continue;
 
+        const { meta, body } = parseFrontmatter(content);
+        const { slug, description, type, category, title, tags, quality } = extractFtsMetadata(meta, body, file, baseDir);
         deleteFts.run(file);
-        insertFts.run(file, content);
+        insertFts.run(file, slug, description, type, category, title, body, tags, quality);
         upsertHash.run(file, hash, now);
         synced++;
       }
@@ -84,7 +73,7 @@ function main() {
   }
 
   if (synced > 0) {
-    process.stderr.write(`[Mindlore FTS5 Sync: ${synced} files re-indexed]\n`);
+    process.stdout.write(`[Mindlore FTS5 Sync: ${synced} files re-indexed]\n`);
   }
 }
 

package/hooks/mindlore-index.cjs

@@ -10,24 +10,10 @@
 
 const fs = require('fs');
 const path = require('path');
-const { MINDLORE_DIR, DB_NAME, SKIP_FILES, sha256, requireDatabase } = require('./lib/mindlore-common.cjs');
+const { MINDLORE_DIR, DB_NAME, SKIP_FILES, sha256, openDatabase, parseFrontmatter, extractFtsMetadata, SQL_FTS_INSERT, readHookStdin } = require('./lib/mindlore-common.cjs');
 
 function main() {
-  let input = '';
-  try {
-    input = fs.readFileSync(0, 'utf8').trim();
-  } catch (_err) {
-    return;
-  }
-
-  let filePath = '';
-  try {
-    const parsed = JSON.parse(input);
-    filePath = parsed.path || parsed.file_path || '';
-  } catch (_err) {
-    filePath = input;
-  }
-
+  const filePath = readHookStdin(['path', 'file_path']);
   if (!filePath) return;
 
   // Only process .md files inside .mindlore/
@@ -43,13 +29,10 @@ function main() {
 
   if (!fs.existsSync(dbPath)) return;
 
-  const Database = requireDatabase();
-  if (!Database) return;
-
   if (!fs.existsSync(filePath)) {
     // File was deleted — remove from index
-    const db = new Database(dbPath);
-    db.pragma('journal_mode = WAL');
+    const db = openDatabase(dbPath);
+    if (!db) return;
     try {
       db.prepare('DELETE FROM mindlore_fts WHERE path = ?').run(filePath);
       db.prepare('DELETE FROM file_hashes WHERE path = ?').run(filePath);
@@ -62,8 +45,8 @@ function main() {
   const content = fs.readFileSync(filePath, 'utf8').replace(/\r\n/g, '\n');
   const hash = sha256(content);
 
-  const db = new Database(dbPath);
-  db.pragma('journal_mode = WAL');
+  const db = openDatabase(dbPath);
+  if (!db) return;
 
   try {
     // Check if content changed
@@ -73,12 +56,13 @@ function main() {
 
     if (existing && existing.content_hash === hash) return; // Unchanged
 
+    // Parse frontmatter for rich FTS5 columns
+    const { meta, body } = parseFrontmatter(content);
+    const { slug, description, type, category, title, tags, quality } = extractFtsMetadata(meta, body, filePath, baseDir);
+
     // Update FTS5
     db.prepare('DELETE FROM mindlore_fts WHERE path = ?').run(filePath);
-    db.prepare('INSERT INTO mindlore_fts (path, content) VALUES (?, ?)').run(
-      filePath,
-      content
-    );
+    db.prepare(SQL_FTS_INSERT).run(filePath, slug, description, type, category, title, body, tags, quality);
 
     // Update hash
     db.prepare(

package/hooks/mindlore-post-compact.cjs

@@ -7,7 +7,7 @@
  * After context compaction, re-inject session context:
  * 1. Read INDEX.md
  * 2. Read latest delta
- * 3. Inject via stderr (same as session-focus)
+ * 3. Inject via stdout (same as session-focus)
  *
  * This ensures the agent has knowledge context after compaction.
  */
@@ -39,7 +39,7 @@ function main() {
   }
 
   if (output.length > 0) {
-    process.stderr.write(output.join('\n\n') + '\n');
+    process.stdout.write(output.join('\n\n') + '\n');
   }
 }
 

package/hooks/mindlore-pre-compact.cjs

@@ -42,7 +42,7 @@ function main() {
     fs.appendFileSync(logPath, entry, 'utf8');
   }
 
-  process.stderr.write('[Mindlore: pre-compact FTS5 flush complete]\n');
+  process.stdout.write('[Mindlore: pre-compact FTS5 flush complete]\n');
 }
 
 main();

package/hooks/mindlore-read-guard.cjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * mindlore-read-guard — PreToolUse hook (if: "Read")
+ *
+ * OpenWolf repeated-read pattern: detects files read multiple times
+ * in the same session and emits a soft warning.
+ * Does NOT block (exit 0) — advisory only.
+ *
+ * Storage: .mindlore/diary/_session-reads.json
+ * Cleanup: session-end hook writes stats to delta then deletes the file.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { findMindloreDir, readHookStdin } = require('./lib/mindlore-common.cjs');
+
+function main() {
+  const baseDir = findMindloreDir();
+  if (!baseDir) return;
+
+  const filePath = readHookStdin(['file_path', 'path']);
+  if (!filePath) return;
+
+  // Only track CWD-relative files, skip .mindlore/ internals
+  const cwd = process.cwd();
+  const resolved = path.resolve(filePath);
+  if (!resolved.startsWith(cwd)) return;
+  if (resolved.startsWith(path.resolve(baseDir))) return;
+
+  // Load or create session reads tracker
+  const diaryDir = path.join(baseDir, 'diary');
+  if (!fs.existsSync(diaryDir)) {
+    fs.mkdirSync(diaryDir, { recursive: true });
+  }
+
+  const readsPath = path.join(diaryDir, '_session-reads.json');
+  let reads = {};
+  if (fs.existsSync(readsPath)) {
+    try {
+      reads = JSON.parse(fs.readFileSync(readsPath, 'utf8'));
+    } catch (_err) {
+      reads = {};
+    }
+  }
+
+  const normalizedPath = path.resolve(filePath);
+  const count = (reads[normalizedPath] || 0) + 1;
+  reads[normalizedPath] = count;
+
+  // Write updated reads
+  fs.writeFileSync(readsPath, JSON.stringify(reads, null, 2), 'utf8');
+
+  // Warn on repeated reads (2nd+ time)
+  if (count > 1) {
+    const basename = path.basename(filePath);
+    process.stderr.write(`[Mindlore: ${basename} bu session'da ${count}. kez okunuyor. Değişiklik yoksa tekrar okumayı atlayabilirsin.]\n`);
+  }
+}
+
+main();