mindlore 0.3.5 → 0.4.1

package/dist/tests/supersedes-chain.test.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const db_js_1 = require("./helpers/db.js");
+const episodes_js_1 = require("../scripts/lib/episodes.js");
+const { querySupersededChains, formatSupersededChains, } = require('../hooks/lib/mindlore-common.cjs');
+let env;
+let db;
+beforeEach(() => {
+    env = (0, db_js_1.createEpisodesTestEnv)('supersedes-chain');
+    db = env.db;
+});
+afterEach(() => {
+    (0, db_js_1.destroyEpisodesTestEnv)(env);
+});
+describe('supersedes chain query', () => {
+    test('returns empty array when no superseded episodes', () => {
+        const result = querySupersededChains(db, { project: 'test-project' });
+        expect(result).toEqual([]);
+    });
+    test('returns chain when episode supersedes another', () => {
+        const old = (0, episodes_js_1.createEpisode)(db, {
+            kind: 'decision',
+            summary: 'JSONL kullanacagiz',
+            project: 'test-project',
+            source: 'decide',
+        });
+        (0, episodes_js_1.supersede)(db, old.id, {
+            kind: 'decision',
+            summary: 'SQLite\'a gectik',
+            body: '## Reason\nQuery gucu daha yuksek',
+            project: 'test-project',
+            source: 'decide',
+        });
+        const chains = querySupersededChains(db, { project: 'test-project' });
+        expect(chains).toHaveLength(1);
+        expect(chains[0]?.current).toBe('SQLite\'a gectik');
+        expect(chains[0]?.previous).toBe('JSONL kullanacagiz');
+        expect(chains[0]?.reason).toBe('Query gucu daha yuksek');
+    });
+    test('respects limit parameter', () => {
+        for (let i = 0; i < 3; i++) {
+            const old = (0, episodes_js_1.createEpisode)(db, {
+                kind: 'decision',
+                summary: `Old decision ${i}`,
+                project: 'test-project',
+                source: 'decide',
+            });
+            (0, episodes_js_1.supersede)(db, old.id, {
+                kind: 'decision',
+                summary: `New decision ${i}`,
+                project: 'test-project',
+                source: 'decide',
+            });
+        }
+        const chains = querySupersededChains(db, { project: 'test-project', limit: 2 });
+        expect(chains).toHaveLength(2);
+    });
+    test('filters by project', () => {
+        const old = (0, episodes_js_1.createEpisode)(db, {
+            kind: 'decision',
+            summary: 'Other project decision',
+            project: 'other-project',
+            source: 'decide',
+        });
+        (0, episodes_js_1.supersede)(db, old.id, {
+            kind: 'decision',
+            summary: 'Other project new',
+            project: 'other-project',
+            source: 'decide',
+        });
+        const chains = querySupersededChains(db, { project: 'test-project' });
+        expect(chains).toHaveLength(0);
+    });
+    test('parses reason from body ## Reason section', () => {
+        const old = (0, episodes_js_1.createEpisode)(db, {
+            kind: 'decision',
+            summary: 'Old way',
+            project: 'test-project',
+            source: 'decide',
+        });
+        (0, episodes_js_1.supersede)(db, old.id, {
+            kind: 'decision',
+            summary: 'New way',
+            body: '## Context\nSome context\n\n## Reason\nPerformance 3x better\n\n## Notes\nExtra info',
+            project: 'test-project',
+            source: 'decide',
+        });
+        const chains = querySupersededChains(db, { project: 'test-project' });
+        expect(chains[0]?.reason).toBe('Performance 3x better');
+    });
+});
+describe('supersedes chain format', () => {
+    test('formats chain as "current <- previous (Reason: ...)"', () => {
+        const chains = [
+            { current: 'SQLite\'a gectik', previous: 'JSONL kullanacagiz', reason: 'Query gucu' },
+            { current: 'FTS5 11-col', previous: '7-col', reason: null },
+        ];
+        const formatted = formatSupersededChains(chains);
+        expect(formatted).toContain('SQLite\'a gectik');
+        expect(formatted).toContain('JSONL kullanacagiz');
+        expect(formatted).toContain('Reason: Query gucu');
+        expect(formatted).toContain('FTS5 11-col');
+        expect(formatted).toContain('7-col');
+    });
+    test('returns empty string for no chains', () => {
+        expect(formatSupersededChains([])).toBe('');
+    });
+});
+//# sourceMappingURL=supersedes-chain.test.js.map

package/dist/tests/supersedes-chain.test.js.map

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

package/hooks/lib/mindlore-common.cjs

@@ -87,12 +87,13 @@ function parseFrontmatter(content) {
   const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
   if (!match) return { meta: {}, body: content };
 
-  const meta = {};
+  const meta = Object.create(null);
   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();
+    if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue;
     let value = line.slice(colonIdx + 1).trim();
     if (value.startsWith('[') && value.endsWith(']')) {
       value = value.slice(1, -1).split(',').map((s) => s.trim().replace(/^["']|["']$/g, ''));
@@ -287,6 +288,250 @@ const DEFAULT_MODELS = {
   default: 'haiku',
 };
 
+// ── Episodes (v0.4.0) ─────────────────────────────────────────────
+
+const SQL_EPISODES_CREATE = `
+CREATE TABLE IF NOT EXISTS episodes (
+  id TEXT PRIMARY KEY,
+  kind TEXT NOT NULL,
+  scope TEXT NOT NULL DEFAULT 'project',
+  project TEXT,
+  summary TEXT NOT NULL,
+  body TEXT,
+  tags TEXT,
+  entities TEXT,
+  parent_id TEXT,
+  status TEXT NOT NULL DEFAULT 'active',
+  supersedes TEXT,
+  source TEXT,
+  created_at TEXT NOT NULL
+)`;
+
+/**
+ * Valid episode kinds. CO-EVOLUTION: mirrors EPISODE_KINDS in scripts/lib/episodes.ts
+ */
+// ~500 tokens context budget for multi-session inject
+const MULTI_SESSION_TOKEN_CAP_CHARS = 2500;
+
+const EPISODE_KINDS_CJS = ['session', 'decision', 'event', 'preference', 'learning', 'friction', 'discovery', 'nomination'];
+
+/**
+ * Valid episode statuses. CO-EVOLUTION: mirrors EPISODE_STATUSES in scripts/lib/episodes.ts
+ */
+const EPISODE_STATUSES_CJS = ['active', 'superseded', 'deleted', 'staged', 'reviewed', 'approved', 'rejected'];
+
+const SQL_EPISODES_INDEXES = [
+  'CREATE INDEX IF NOT EXISTS idx_episodes_kind ON episodes(kind, status)',
+  'CREATE INDEX IF NOT EXISTS idx_episodes_project ON episodes(project, status)',
+  'CREATE INDEX IF NOT EXISTS idx_episodes_created ON episodes(created_at DESC)',
+];
+
+/**
+ * Ensure episodes table + indexes exist. Idempotent.
+ * @param {import('better-sqlite3').Database} db
+ */
+function ensureEpisodesTable(db) {
+  db.exec(SQL_EPISODES_CREATE);
+  for (const idx of SQL_EPISODES_INDEXES) {
+    db.exec(idx);
+  }
+}
+
+/**
+ * Check if episodes table exists in the database.
+ * @param {import('better-sqlite3').Database} db
+ * @returns {boolean}
+ */
+function hasEpisodesTable(db) {
+  const row = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='episodes'").get();
+  return row !== undefined;
+}
+
+/**
+ * Generate a time-sortable episode ID.
+ * Format: ep-{base36-timestamp}-{12-hex-random}
+ */
+function generateEpisodeId() {
+  const timestamp = Date.now().toString(36);
+  const random = crypto.randomBytes(6).toString('hex');
+  return `ep-${timestamp}-${random}`;
+}
+
+/**
+ * Insert a bare episode from hook context (no LLM needed).
+ * @param {import('better-sqlite3').Database} db
+ * @param {object} entry
+ * @returns {string} episode id
+ */
+function insertBareEpisode(db, entry) {
+  const id = entry.id || generateEpisodeId();
+  const now = new Date().toISOString();
+
+  db.prepare(`
+    INSERT INTO episodes (id, kind, scope, project, summary, body, tags, entities, parent_id, status, supersedes, source, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'active', ?, ?, ?)
+  `).run(
+    id,
+    entry.kind || 'session',
+    entry.scope || 'project',
+    entry.project || null,
+    entry.summary || '',
+    entry.body || null,
+    entry.tags || null,
+    entry.entities ? JSON.stringify(entry.entities) : null,
+    entry.parent_id || null,
+    entry.supersedes || null,
+    entry.source || 'hook',
+    now,
+  );
+
+  return id;
+}
+
+/**
+ * Query recent episodes for session-focus injection.
+ * @param {import('better-sqlite3').Database} db
+ * @param {object} opts - { project, limit, maxChars }
+ * @returns {Array<{kind: string, summary: string, created_at: string}>}
+ */
+function queryRecentEpisodes(db, opts) {
+  const project = opts.project || null;
+  const limit = opts.limit || 3;
+
+  let sql = "SELECT kind, summary, created_at FROM episodes WHERE status = 'active'";
+  const params = [];
+
+  if (project) {
+    sql += ' AND project = ?';
+    params.push(project);
+  }
+
+  sql += ' ORDER BY created_at DESC LIMIT ?';
+  params.push(limit);
+
+  return db.prepare(sql).all(...params);
+}
+
+/**
+ * Query superseded episode chains for session-focus display.
+ * CO-EVOLUTION: Uses episodes table schema from SQL_EPISODES_CREATE
+ * @param {import('better-sqlite3').Database} db
+ * @param {{ project: string, days?: number, limit?: number }} opts
+ * @returns {Array<{current: string, previous: string, reason: string|null}>}
+ */
+function querySupersededChains(db, opts) {
+  const days = opts.days ?? 7;
+  const limit = opts.limit ?? 5;
+  const modifier = `-${days} days`;
+  const rows = db.prepare(`
+    SELECT new_ep.summary AS current_summary, old_ep.summary AS previous_summary, new_ep.body
+    FROM episodes new_ep
+    JOIN episodes old_ep ON new_ep.supersedes = old_ep.id
+    WHERE new_ep.project = ?
+      AND new_ep.created_at > datetime('now', ?)
+      AND old_ep.status = 'superseded'
+    ORDER BY new_ep.created_at DESC
+    LIMIT ?
+  `).all(opts.project, modifier, limit);
+
+  return rows.map(row => ({
+    current: row.current_summary,
+    previous: row.previous_summary,
+    reason: parseReason(row.body),
+  }));
+}
+
+/**
+ * Parse ## Reason section from episode body.
+ * @param {string|null} body
+ * @returns {string|null}
+ */
+function parseReason(body) {
+  if (!body) return null;
+  const match = body.match(/## Reason\n(.+?)(?:\n##|\n*$)/s);
+  if (!match) return null;
+  return match[1].trim().split('\n')[0];
+}
+
+/**
+ * Format superseded chains for session-focus inject.
+ * @param {Array<{current: string, previous: string, reason: string|null}>} chains
+ * @returns {string}
+ */
+function formatSupersededChains(chains) {
+  if (chains.length === 0) return '';
+  const lines = chains.map(c => {
+    const base = `- ${c.current} \u2190 ${c.previous}`;
+    return c.reason ? `${base} (Reason: ${c.reason})` : base;
+  });
+  return lines.join('\n');
+}
+
+/**
+ * Query episodes across multiple sessions for enriched inject.
+ * Excludes bare session episodes and nominations.
+ * CO-EVOLUTION: Uses episodes table schema from SQL_EPISODES_CREATE
+ * @param {import('better-sqlite3').Database} db
+ * @param {{ project: string, days?: number, limit?: number }} opts
+ */
+function queryMultiSessionEpisodes(db, opts) {
+  const days = opts.days ?? 3;
+  const limit = opts.limit ?? 20;
+  const modifier = `-${days} days`;
+  return db.prepare(`
+    SELECT kind, summary, created_at
+    FROM episodes
+    WHERE project = ?
+      AND status = 'active'
+      AND kind != 'session'
+      AND kind != 'nomination'
+      AND created_at > datetime('now', ?)
+    ORDER BY created_at DESC
+    LIMIT ?
+  `).all(opts.project, modifier, limit);
+}
+
+/**
+ * Format multi-session episodes for inject.
+ * Groups by date. If too many per date, collapses to count-per-kind.
+ * @param {Array<{kind: string, summary: string, created_at: string}>} episodes
+ * @returns {string}
+ */
+function formatMultiSessionEpisodes(episodes) {
+  if (episodes.length === 0) return '';
+
+  const byDate = {};
+  for (const ep of episodes) {
+    const date = (ep.created_at || '').slice(0, 10);
+    if (!byDate[date]) byDate[date] = [];
+    byDate[date].push(ep);
+  }
+
+  const lines = [];
+  let totalChars = 0;
+
+  for (const [date, eps] of Object.entries(byDate).sort((a, b) => b[0].localeCompare(a[0]))) {
+    if (totalChars > MULTI_SESSION_TOKEN_CAP_CHARS) break;
+    if (eps.length <= 5) {
+      for (const ep of eps) {
+        const line = `- [${date}] ${ep.kind}: ${String(ep.summary).slice(0, 100)}`;
+        totalChars += line.length;
+        if (totalChars > MULTI_SESSION_TOKEN_CAP_CHARS) break;
+        lines.push(line);
+      }
+    } else {
+      const kindCounts = {};
+      for (const ep of eps) {
+        kindCounts[ep.kind] = (kindCounts[ep.kind] || 0) + 1;
+      }
+      const counts = Object.entries(kindCounts).map(([k, c]) => `${c} ${k}`).join(', ');
+      lines.push(`- [${date}] ${counts}`);
+    }
+  }
+
+  return lines.join('\n');
+}
+
 module.exports = {
   MINDLORE_DIR,
   GLOBAL_MINDLORE_DIR,
@@ -312,4 +557,18 @@ module.exports = {
   detectSchemaVersion,
   getProjectName,
   DEFAULT_MODELS,
+  // Episodes (v0.4.1)
+  EPISODE_KINDS_CJS,
+  EPISODE_STATUSES_CJS,
+  SQL_EPISODES_CREATE,
+  SQL_EPISODES_INDEXES,
+  ensureEpisodesTable,
+  hasEpisodesTable,
+  generateEpisodeId,
+  insertBareEpisode,
+  queryRecentEpisodes,
+  querySupersededChains,
+  formatSupersededChains,
+  queryMultiSessionEpisodes,
+  formatMultiSessionEpisodes,
 };

package/hooks/mindlore-index.cjs

@@ -16,8 +16,10 @@ function main() {
   const filePath = readHookStdin(['path', 'file_path']);
   if (!filePath) return;
 
-  // Only process .md files inside .mindlore/
-  if (!filePath.includes(MINDLORE_DIR) || !filePath.endsWith('.md')) return;
+  // Only process .md files inside .mindlore/ (resolved path check prevents traversal)
+  if (!filePath.endsWith('.md')) return;
+  const resolvedFile = path.resolve(filePath);
+  if (!resolvedFile.includes(path.sep + MINDLORE_DIR + path.sep) && !resolvedFile.includes(path.sep + MINDLORE_DIR)) return;
 
   const fileName = path.basename(filePath);
   if (SKIP_FILES.has(fileName)) return;
@@ -60,18 +62,19 @@ function main() {
     const { meta, body } = parseFrontmatter(content);
     const { slug, description, type, category, title, tags, quality, dateCaptured } = extractFtsMetadata(meta, body, filePath, baseDir);
 
-    // Update FTS5
-    db.prepare('DELETE FROM mindlore_fts WHERE path = ?').run(filePath);
-    insertFtsRow(db, { path: filePath, slug, description, type, category, title, content: body, tags, quality, dateCaptured, project: getProjectName() });
-
-    // Update hash
-    db.prepare(
-      `INSERT INTO file_hashes (path, content_hash, last_indexed)
-       VALUES (?, ?, ?)
-       ON CONFLICT(path) DO UPDATE SET
-         content_hash = excluded.content_hash,
-         last_indexed = excluded.last_indexed`
-    ).run(filePath, hash, new Date().toISOString());
+    // Update FTS5 + hash atomically
+    const updateIndex = db.transaction(() => {
+      db.prepare('DELETE FROM mindlore_fts WHERE path = ?').run(filePath);
+      insertFtsRow(db, { path: filePath, slug, description, type, category, title, content: body, tags, quality, dateCaptured, project: getProjectName() });
+      db.prepare(
+        `INSERT INTO file_hashes (path, content_hash, last_indexed)
+         VALUES (?, ?, ?)
+         ON CONFLICT(path) DO UPDATE SET
+           content_hash = excluded.content_hash,
+           last_indexed = excluded.last_indexed`
+      ).run(filePath, hash, new Date().toISOString());
+    });
+    updateIndex();
   } finally {
     db.close();
   }

package/hooks/mindlore-post-read.cjs

@@ -7,8 +7,8 @@
  * After a file is read, estimate its token count
  * and store in _session-reads.json for the read-guard to reference.
  *
- * Does NOT output anything (pure bookkeeping).
- * PostToolUse stdout goes to debug log only — no inject needed.
+ * Outputs token estimate via additionalContext JSON.
+ * Also stores token info in _session-reads.json for read-guard.
  */
 
 const fs = require('fs');
@@ -87,6 +87,15 @@ function main() {
       }
 
       fs.writeFileSync(readsPath, JSON.stringify(reads, null, 2), 'utf8');
+
+      // Output token estimate to Claude via additionalContext
+      const basename = path.basename(filePath);
+      process.stdout.write(JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: 'PostToolUse',
+          additionalContext: `[Mindlore: ${basename} — ~${tokens} token (${charCount} char). Edit etmeyeceksen ctx_execute_file kullan.]`
+        }
+      }));
     } catch {
       // Silent fail
     }

package/hooks/mindlore-pre-compact.cjs

@@ -21,8 +21,8 @@ function main() {
   const indexScript = path.join(__dirname, '..', 'scripts', 'mindlore-fts5-index.cjs');
   if (fs.existsSync(indexScript)) {
     try {
-      const { execSync } = require('child_process');
-      execSync(`node "${indexScript}" "${baseDir}"`, {
+      const { spawnSync } = require('child_process');
+      spawnSync('node', [indexScript, baseDir], {
         timeout: 10000,
         stdio: 'pipe',
       });

package/hooks/mindlore-read-guard.cjs

@@ -68,15 +68,23 @@ function main() {
   // Write updated reads
   fs.writeFileSync(readsPath, JSON.stringify(reads, null, 2), 'utf8');
 
-  // Warn on repeated reads (2nd+ time)
+  const basename = path.basename(filePath);
+  const tokenInfo = tokens > 0 ? ` (~${tokens} token)` : '';
+
+  // Block on 3+ repeated reads (exit 2 = block tool call)
+  if (count >= 3) {
+    const totalWaste = tokens > 0 ? ` Toplam israf: ~${tokens * (count - 1)} token.` : '';
+    process.stderr.write(`[Mindlore BLOCK] ${basename}${tokenInfo} bu session'da ${count}. kez okunuyor.${totalWaste} Edit icin gerekiyorsa once degisikligini yap, sonra tekrar oku. Analiz icin ctx_execute_file kullan.`);
+    process.exit(2);
+  }
+
+  // Warn on 2nd read (exit 0 = allow but warn)
   if (count > 1) {
-    const basename = path.basename(filePath);
-    const tokenInfo = tokens > 0 ? ` (~${tokens} token)` : '';
     const totalWaste = tokens > 0 ? ` Toplam tekrar: ~${tokens * (count - 1)} token.` : '';
     process.stdout.write(JSON.stringify({
       hookSpecificOutput: {
         hookEventName: 'PreToolUse',
-        additionalContext: `[Mindlore: ${basename}${tokenInfo} bu session'da ${count}. kez okunuyor.${totalWaste} Değişiklik yoksa tekrar okumayı atlayabilirsin.]`
+        additionalContext: `[Mindlore: ${basename}${tokenInfo} bu session'da ${count}. kez okunuyor.${totalWaste} Bir sonraki okuma engellenecek — Edit gerekiyorsa simdi yap.]`
       }
     }));
   }

package/hooks/mindlore-search.cjs

@@ -80,7 +80,9 @@ function searchDb(dbPath, keywords, Database) {
 
       for (const kw of keywords) {
         try {
-          const r = matchStmt.get(row.path, '"' + kw + '"');
+          const sanitized = kw.replace(/["*(){}[\]^~:]/g, '');
+          if (!sanitized) continue;
+          const r = matchStmt.get(row.path, '"' + sanitized + '"');
           if (r) {
             hits++;
             totalRank += r.rank;
@@ -104,6 +106,27 @@ function searchDb(dbPath, keywords, Database) {
   return results;
 }
 
+/**
+ * Search episodes via FTS5 mirror (type = 'episode').
+ * Reuses an already-open DB handle — no extra sqlite3_open.
+ */
+function searchEpisodesFts(db, keywords) {
+  try {
+    const ftsQuery = keywords.map(kw => '"' + kw.replace(/["*(){}[\]^~:]/g, '') + '"').filter(q => q !== '""').join(' OR ');
+    const rows = db.prepare(
+      "SELECT title, category, slug, tags FROM mindlore_fts WHERE type = 'episode' AND mindlore_fts MATCH ? LIMIT 2"
+    ).all(ftsQuery);
+
+    return rows.map(r => {
+      const tags = r.tags || '';
+      const kind = tags.split(',')[0]?.trim() || 'episode';
+      return `[episode] ${kind}: ${r.title || r.slug}`;
+    });
+  } catch (_err) {
+    return [];
+  }
+}
+
 function main() {
   const userMessage = readHookStdin(['prompt', 'content', 'message', 'query']);
   if (!userMessage || userMessage.length < MIN_QUERY_WORDS) return;
@@ -162,6 +185,21 @@ function main() {
     );
   }
 
+  // v0.4.0: Search episode mirrors in FTS5 (reuses searchDb's DB path, no extra open)
+  if (relevant.length < MAX_RESULTS) {
+    for (const dbPath of dbPaths) {
+      try {
+        const db = new Database(dbPath, { readonly: true });
+        const episodeResults = searchEpisodesFts(db, keywords);
+        db.close();
+        if (episodeResults.length > 0) {
+          output.push(`[Mindlore Episodes]\n${episodeResults.join('\n')}`);
+          break;
+        }
+      } catch (_err) { /* skip */ }
+    }
+  }
+
   if (output.length > 0) {
     process.stdout.write(output.join('\n\n') + '\n');
   }