mindlore 0.5.8 → 0.6.0

package/hooks/lib/mindlore-common.cjs

@@ -62,6 +62,16 @@ function getProjectName() {
   return path.basename(process.cwd());
 }
 
+function resolveProject(ftsProject, filePath, cwdFallback) {
+  if (ftsProject) return ftsProject;
+  const normalized = filePath.replace(/\\/g, '/');
+  const sessionMatch = normalized.match(/raw\/sessions\/([^/]+)\//);
+  if (sessionMatch) return sessionMatch[1];
+  const diaryMatch = normalized.match(/diary\/([^/]+)\//);
+  if (diaryMatch) return diaryMatch[1];
+  return cwdFallback;
+}
+
 function getLatestDelta(diaryDir) {
   if (!fs.existsSync(diaryDir)) return null;
 
@@ -131,7 +141,8 @@ function extractFtsMetadata(meta, body, filePath, baseDir) {
   }
   const quality = meta.quality !== undefined && meta.quality !== null ? meta.quality : null;
   const dateCaptured = meta.date_captured || meta.date || null;
-  return { slug, description, type, category, title, tags, quality, dateCaptured };
+  const project = meta.project || null;
+  return { slug, description, type, category, title, tags, quality, dateCaptured, project };
 }
 
 /**
@@ -629,6 +640,65 @@ const extractSkeleton = (() => {
   }
 })();
 
+const TELEMETRY_KEEP_LINES = 200;
+
+function _rotateFile(filePath, maxBytes, keepLines) {
+  try {
+    const stat = fs.statSync(filePath);
+    if (stat.size > maxBytes) {
+      const lines = fs.readFileSync(filePath, 'utf8').trim().split('\n');
+      fs.writeFileSync(filePath, lines.slice(-keepLines).join('\n') + '\n');
+    }
+  } catch { /* file may not exist yet */ }
+}
+
+let _telDirEnsured = false;
+
+function _writeTelemetry(hookName, duration_ms, ok) {
+  try {
+    if (!_telDirEnsured) {
+      fs.mkdirSync(GLOBAL_MINDLORE_DIR, { recursive: true });
+      _telDirEnsured = true;
+    }
+    const telPath = path.join(GLOBAL_MINDLORE_DIR, 'telemetry.jsonl');
+    const line = JSON.stringify({ ts: new Date().toISOString(), hook: hookName, duration_ms, ok }) + '\n';
+    _rotateFile(telPath, HOOK_LOG_MAX_BYTES, TELEMETRY_KEEP_LINES);
+    fs.appendFileSync(telPath, line);
+  } catch { /* silent — telemetry must never crash hook */ }
+}
+
+async function withTelemetry(hookName, fn) {
+  const start = Date.now();
+  let ok = true;
+  let result;
+  let thrown;
+  try {
+    result = await fn();
+  } catch (err) {
+    ok = false;
+    thrown = err;
+  }
+  _writeTelemetry(hookName, Date.now() - start, ok);
+  if (thrown) throw thrown;
+  return result;
+}
+
+function withTelemetrySync(hookName, fn) {
+  const start = Date.now();
+  let ok = true;
+  let result;
+  let thrown;
+  try {
+    result = fn();
+  } catch (err) {
+    ok = false;
+    thrown = err;
+  }
+  _writeTelemetry(hookName, Date.now() - start, ok);
+  if (thrown) throw thrown;
+  return result;
+}
+
 module.exports = {
   MINDLORE_DIR,
   GLOBAL_MINDLORE_DIR,
@@ -653,6 +723,7 @@ module.exports = {
   readConfig,
   detectSchemaVersion,
   getProjectName,
+  resolveProject,
   DEFAULT_MODELS,
   // Episodes (v0.4.1)
   EPISODE_KINDS_CJS,
@@ -689,6 +760,9 @@ module.exports = {
   isDaemonRunning,
   getDaemonPortFile,
   getDaemonPidFile,
+  // Telemetry (v0.6.0)
+  withTelemetry,
+  withTelemetrySync,
 };
 
 function isDaemonRunning(pidFile) {
@@ -789,14 +863,7 @@ function hookLog(hook, level, message) {
       msg: message,
       pid: process.pid,
     });
-    // Rotate if file exceeds threshold (at most once per hook — each runs as separate process)
-    try {
-      const stat = fs.statSync(logFile);
-      if (stat.size > HOOK_LOG_MAX_BYTES) {
-        const lines = fs.readFileSync(logFile, 'utf8').trim().split('\n');
-        fs.writeFileSync(logFile, lines.slice(-HOOK_LOG_KEEP_LINES).join('\n') + '\n');
-      }
-    } catch (_rotateErr) { /* file may not exist yet */ }
+    _rotateFile(logFile, HOOK_LOG_MAX_BYTES, HOOK_LOG_KEEP_LINES);
     fs.appendFileSync(logFile, entry + '\n');
   } catch (_err) {
     // Best effort — never crash a hook for logging

package/hooks/mindlore-cwd-changed.cjs

@@ -15,7 +15,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findMindloreDir, globalDir, hookLog } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, globalDir, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 function main() {
   const cwd = process.cwd();
@@ -54,4 +54,4 @@ function main() {
   }
 }
 
-try { 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

@@ -9,7 +9,7 @@
  * Does NOT block (exit 0) — advisory only.
  */
 
-const { findMindloreDir, readHookStdin, hookLog } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, readHookStdin, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 const SIGNALS_TR = [
   'karar verdik', 'karar verildi', 'kararlastirdik', 'kararlaştırdık',
@@ -48,4 +48,7 @@ function main() {
   }
 }
 
-try { main(); } catch (err) { hookLog('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

@@ -18,7 +18,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
-const { findMindloreDir, getProjectName, hookLog } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, getProjectName, hookLog, withTelemetrySync } = require('./lib/mindlore-common.cjs');
 
 /**
  * File-persisted pattern cache — survives across process invocations.
@@ -219,4 +219,4 @@ function main() {
   });
 }
 
-try { 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)); }

package/hooks/mindlore-fts5-sync.cjs

@@ -13,7 +13,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { MINDLORE_DIR, DB_NAME, sha256, openDatabase, getAllMdFiles, parseFrontmatter, extractFtsMetadata, insertFtsRow, readHookStdin, getActiveMindloreDir, getProjectName, hookLog } = require('./lib/mindlore-common.cjs');
+const { MINDLORE_DIR, DB_NAME, sha256, openDatabase, getAllMdFiles, parseFrontmatter, extractFtsMetadata, insertFtsRow, readHookStdin, getActiveMindloreDir, getProjectName, resolveProject, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 function main() {
   const filePath = readHookStdin(['path', 'file_path']);
@@ -60,9 +60,9 @@ function main() {
         if (existing && existing.content_hash === hash) continue;
 
         const { meta, body } = parseFrontmatter(content);
-        const { slug, description, type, category, title, tags, quality, dateCaptured } = extractFtsMetadata(meta, body, file, baseDir);
+        const { slug, description, type, category, title, tags, quality, dateCaptured, project: ftsProject } = extractFtsMetadata(meta, body, file, baseDir);
         deleteFts.run(file);
-        insertFtsRow(db, { path: file, slug, description, type, category, title, content: body, tags, quality, dateCaptured, project });
+        insertFtsRow(db, { path: file, slug, description, type, category, title, content: body, tags, quality, dateCaptured, project: resolveProject(ftsProject, file, project) });
         upsertHash.run(file, hash, now);
       }
     });
@@ -75,4 +75,7 @@ function main() {
   // process.stdout.write kaldırıldı (kimse görmüyor)
 }
 
-try { main(); } catch (err) { hookLog('fts5-sync', 'error', err?.message ?? String(err)); }
+withTelemetry('mindlore-fts5-sync', main).catch(err => {
+  hookLog('mindlore-fts5-sync', 'error', err?.message ?? String(err));
+  process.exit(0);
+});

package/hooks/mindlore-index.cjs

@@ -10,7 +10,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { MINDLORE_DIR, DB_NAME, SKIP_FILES, sha256, openDatabase, parseFrontmatter, extractFtsMetadata, insertFtsRow, readHookStdin, getProjectName, globalDir, hookLog } = require('./lib/mindlore-common.cjs');
+const { MINDLORE_DIR, DB_NAME, SKIP_FILES, sha256, openDatabase, parseFrontmatter, extractFtsMetadata, insertFtsRow, readHookStdin, getProjectName, resolveProject, globalDir, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 function main() {
   const filePath = readHookStdin(['path', 'file_path']);
@@ -77,12 +77,12 @@ function main() {
 
     // Parse frontmatter for rich FTS5 columns
     const { meta, body } = parseFrontmatter(content);
-    const { slug, description, type, category, title, tags, quality, dateCaptured } = extractFtsMetadata(meta, body, filePath, baseDir);
+    const { slug, description, type, category, title, tags, quality, dateCaptured, project: ftsProject } = extractFtsMetadata(meta, body, filePath, baseDir);
 
     // 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() });
+      insertFtsRow(db, { path: filePath, slug, description, type, category, title, content: body, tags, quality, dateCaptured, project: resolveProject(ftsProject, filePath, getProjectName()) });
       db.prepare(
         `INSERT INTO file_hashes (path, content_hash, last_indexed)
          VALUES (?, ?, ?)
@@ -197,7 +197,7 @@ function catchUpScan(baseDir, dbPath) {
 
         const update = db.transaction(() => {
           db.prepare('DELETE FROM mindlore_fts WHERE path = ?').run(filePath);
-          insertFtsRow(db, { path: filePath, ...ftsData, project: getProjectName() });
+          insertFtsRow(db, { path: filePath, ...ftsData, project: resolveProject(ftsData.project, filePath, getProjectName()) });
           db.prepare(
             `INSERT INTO file_hashes (path, content_hash, last_indexed)
              VALUES (?, ?, ?)
@@ -218,4 +218,7 @@ function catchUpScan(baseDir, dbPath) {
   }
 }
 
-main();
+withTelemetry('mindlore-index', main).catch(err => {
+  hookLog('mindlore-index', 'error', err?.message ?? String(err));
+  process.exit(0);
+});

package/hooks/mindlore-model-router.cjs

@@ -6,7 +6,7 @@
  */
 
 const fs = require('fs');
-const { findMindloreDir, readConfig, DEFAULT_MODELS, hookLog } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, readConfig, DEFAULT_MODELS, hookLog, withTelemetrySync } = require('./lib/mindlore-common.cjs');
 
 const SKILL_KEYS = Object.keys(DEFAULT_MODELS).filter((k) => k !== 'default');
 const MARKER_REGEX = new RegExp(`\\[mindlore:(${SKILL_KEYS.join('|')})\\]`);
@@ -51,4 +51,4 @@ function main() {
   process.stdout.write(JSON.stringify(output));
 }
 
-try { main(); } catch (err) { hookLog('model-router', 'error', err?.message ?? String(err)); }
+try { withTelemetrySync('mindlore-model-router', main); } catch (err) { hookLog('model-router', 'error', err?.message ?? String(err)); }

package/hooks/mindlore-post-compact.cjs

@@ -14,7 +14,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findMindloreDir, getLatestDelta, hookLog } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, getLatestDelta, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 function main() {
   const baseDir = findMindloreDir();
@@ -43,4 +43,7 @@ function main() {
   }
 }
 
-try { main(); } catch (err) { hookLog('post-compact', 'error', err?.message ?? String(err)); }
+withTelemetry('mindlore-post-compact', main).catch(err => {
+  hookLog('mindlore-post-compact', 'error', err?.message ?? String(err));
+  process.exit(0);
+});

package/hooks/mindlore-post-read.cjs

@@ -13,7 +13,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findMindloreDir, getProjectName, hookLog } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, getProjectName, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 const CODE_EXTS = new Set(['.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go', '.java', '.c', '.cpp', '.h', '.css', '.scss', '.sql', '.sh', '.yaml', '.yml', '.json', '.toml', '.xml', '.cjs', '.mjs']);
 const PROSE_EXTS = new Set(['.md', '.txt', '.rst', '.adoc']);
@@ -103,4 +103,4 @@ function main() {
   });
 }
 
-try { main(); } catch (err) { hookLog('post-read', 'error', err?.message ?? String(err)); }
+withTelemetry('mindlore-post-read', main).catch(err => { hookLog('post-read', 'error', err?.message ?? String(err)); });

package/hooks/mindlore-pre-compact.cjs

@@ -11,7 +11,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findMindloreDir, hookLog } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, hookLog, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 function main() {
   const baseDir = findMindloreDir();
@@ -63,4 +63,7 @@ function main() {
   process.stdout.write('[Mindlore: pre-compact FTS5 flush complete]\n');
 }
 
-try { main(); } catch (err) { hookLog('pre-compact', 'error', err?.message ?? String(err)); }
+withTelemetry('mindlore-pre-compact', main).catch(err => {
+  hookLog('mindlore-pre-compact', 'error', err?.message ?? String(err));
+  process.exit(0);
+});

package/hooks/mindlore-read-guard.cjs

@@ -14,7 +14,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findMindloreDir, readHookStdin, getProjectName, hookLog, extractSkeleton } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, readHookStdin, getProjectName, hookLog, extractSkeleton, withTelemetrySync } = require('./lib/mindlore-common.cjs');
 
 function main() {
   const baseDir = findMindloreDir();
@@ -102,4 +102,4 @@ function main() {
   }
 }
 
-try { main(); } catch (err) { hookLog('read-guard', 'error', err?.message ?? String(err)); }
+try { withTelemetrySync('mindlore-read-guard', main); } catch (err) { hookLog('read-guard', 'error', err?.message ?? String(err)); }

package/hooks/mindlore-research-guard.cjs

@@ -14,7 +14,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { getAllDbs, requireDatabase, extractKeywords, sanitizeKeyword, hookLog } = require('./lib/mindlore-common.cjs');
+const { getAllDbs, requireDatabase, extractKeywords, sanitizeKeyword, hookLog, withTelemetrySync } = require('./lib/mindlore-common.cjs');
 
 // Keywords that signal a research/web-search intent in agent prompts
 // Note: entries with dots/stars are regex patterns, rest are literals
@@ -173,4 +173,4 @@ function main() {
   process.stdout.write(JSON.stringify(output));
 }
 
-try { main(); } catch (err) { hookLog('research-guard', 'error', err?.message ?? String(err)); }
+try { withTelemetrySync('mindlore-research-guard', main); } catch (err) { hookLog('research-guard', 'error', err?.message ?? String(err)); }

package/hooks/mindlore-search.cjs

@@ -10,7 +10,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { getAllDbs, openDatabase, extractHeadings, readHookStdin, extractKeywords, sanitizeKeyword, readConfig, loadSqliteVecCjs, hasVecTableCjs, hookLog, incrementRecallCount, getDaemonPortFile } = require('./lib/mindlore-common.cjs');
+const { getAllDbs, openDatabase, extractHeadings, readHookStdin, extractKeywords, sanitizeKeyword, readConfig, loadSqliteVecCjs, hasVecTableCjs, hookLog, incrementRecallCount, getDaemonPortFile, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 const { execFileSync } = require('child_process');
 
@@ -307,4 +307,7 @@ function main() {
   }
 }
 
-try { main(); } catch (err) { hookLog('search', 'error', err?.message ?? String(err)); }
+withTelemetry('mindlore-search', main).catch(err => {
+  hookLog('mindlore-search', 'error', err?.message ?? String(err));
+  process.exit(0);
+});

package/hooks/mindlore-session-end.cjs

@@ -13,7 +13,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const { execSync, execFileSync, spawn } = require('child_process');
-const { findMindloreDir, globalDir, getProjectName, openDatabase, ensureEpisodesTable, hasEpisodesTable, insertBareEpisode, insertFtsRow, hookLog, SHARED_EXPORT_DIRS, resolveWin32Bin } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, globalDir, getProjectName, openDatabase, ensureEpisodesTable, hasEpisodesTable, insertBareEpisode, insertFtsRow, hookLog, SHARED_EXPORT_DIRS, resolveWin32Bin, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 const EXPORT_DIRS = SHARED_EXPORT_DIRS;
 
@@ -369,19 +369,25 @@ function writeEpisodeFile(baseDir, project, commits, changedFiles, reads) {
   fs.writeFileSync(filePath, lines.join('\n'), 'utf8');
 }
 
+let _obsidianHelpersCache = undefined; // undefined = not yet attempted
 /**
  * Load obsidian-helpers from compiled dist (single source of truth for wikilink conversion).
  * Returns null if helpers not available (e.g. dev environment without build).
+ * Result is cached — require() runs at most once per process.
  */
-function loadObsidianHelpers() {
+function getObsidianHelpers() {
+  if (_obsidianHelpersCache !== undefined) return _obsidianHelpersCache;
   try {
-    // Resolve from package root (hooks/ is sibling to dist/)
     const hookDir = __dirname;
     const pkgRoot = path.dirname(hookDir);
     const helpersPath = path.join(pkgRoot, 'dist', 'scripts', 'lib', 'obsidian-helpers.js');
-    if (!fs.existsSync(helpersPath)) return null;
-    return require(helpersPath);
-  } catch (_err) {
+    _obsidianHelpersCache = require(helpersPath);
+    return _obsidianHelpersCache;
+  } catch (err) {
+    if (process.env.MINDLORE_DEBUG === '1') {
+      process.stderr.write(`[mindlore] obsidian-helpers not available: ${err.message}\n`);
+    }
+    _obsidianHelpersCache = null;
     return null;
   }
 }
@@ -419,7 +425,7 @@ function syncObsidian(baseDir) {
     if (!vaultPath || typeof vaultPath !== 'string') return;
     if (!fs.existsSync(vaultPath)) return;
 
-    const helpers = loadObsidianHelpers();
+    const helpers = getObsidianHelpers();
     // Fallback regex if helpers unavailable (strips path prefixes like the canonical version)
     const convertFn = helpers?.convertToWikilinks
       ?? ((c) => c.replace(/\[([^\]]+)\]\((?:\.\.?\/)?(?:[\w-]+\/)*([^/)]+)\.md\)/g, '[[$2]]'));
@@ -503,5 +509,8 @@ function syncGlobalRepo() {
 }
 
 if (!process.argv.includes('--worker')) {
-  main();
+  withTelemetry('mindlore-session-end', main).catch(err => {
+    hookLog('mindlore-session-end', 'error', err?.message ?? String(err));
+    process.exit(0);
+  });
 }

package/hooks/mindlore-session-focus.cjs

@@ -10,7 +10,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findMindloreDir, readConfig, openDatabase, hasEpisodesTable, querySupersededChains, formatSupersededChains, hookLog, getProjectName, parseFrontmatter, isDaemonRunning, getDaemonPidFile } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, readConfig, openDatabase, hasEpisodesTable, querySupersededChains, formatSupersededChains, hookLog, getProjectName, parseFrontmatter, isDaemonRunning, getDaemonPidFile, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 function main() {
   const baseDir = findMindloreDir();
@@ -166,4 +166,7 @@ function main() {
   }
 }
 
-main();
+withTelemetry('mindlore-session-focus', main).catch(err => {
+  hookLog('mindlore-session-focus', 'error', err?.message ?? String(err));
+  process.exit(0);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindlore",
-  "version": "0.5.8",
+  "version": "0.6.0",
   "description": "AI-native knowledge system for Claude Code",
   "type": "commonjs",
   "bin": {
@@ -19,7 +19,8 @@
     "search": "node dist/scripts/mindlore-fts5-search.js",
     "quality": "node dist/scripts/quality-populate.js",
     "fetch-raw": "node dist/scripts/fetch-raw.js",
-    "cc-sync": "node dist/scripts/cc-memory-bulk-sync.js"
+    "cc-sync": "node dist/scripts/cc-memory-bulk-sync.js",
+    "cleanup": "node dist/scripts/maintain-cleanup.js"
   },
   "keywords": [
     "claude-code",
@@ -45,7 +46,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "better-sqlite3": "^11.10.0",
+    "better-sqlite3": "^12.9.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
@@ -54,7 +55,7 @@
     "@types/node": "^25.6.0",
     "@typescript-eslint/eslint-plugin": "^8.58.1",
     "@typescript-eslint/parser": "^8.58.1",
-    "@xenova/transformers": "^2.17.2",
+    "@huggingface/transformers": "^4.2.0",
     "eslint": "^10.2.0",
     "globals": "^17.5.0",
     "jest": "^30.3.0",
@@ -63,6 +64,7 @@
     "typescript": "^6.0.2"
   },
   "files": [
+    "agents/",
     "dist/",
     "hooks/",
     "skills/",

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.5.8",
+  "version": "0.6.0",
   "skills": [
     {
       "name": "mindlore-ingest",

package/skills/mindlore-ingest/SKILL.md

@@ -21,16 +21,36 @@ Add a new knowledge source to the `.mindlore/` knowledge base.
 
 ## Scope
 
-Determine target directory using `getActiveMindloreDir()` logic:
-- If CWD has `.mindlore/` → write to project scope
-- Otherwise → write to global `~/.mindlore/`
-- `--global` flag: force write to `~/.mindlore/` even if project scope exists
-- Never hardcode `.mindlore/` path — always resolve dynamically
+Tüm ingest işlemleri global `~/.mindlore/` dizinine yazılır.
+Proje ayrımı frontmatter'daki `project` alanı ile yapılır.
+`raw/` altına proje bazlı klasörleme yapılmaz (session sync hariç).
+Frontmatter'a `project: {CWD project adı}` otomatik eklenir.
 
 ## Trigger
 
 User shares a URL, text, file, or says "kaynak ekle", "source ingest", "bu linki kaydet", "knowledge ingest".
 
+## Multi-URL Support
+
+Birden fazla URL verildiğinde (boşluk veya virgülle ayrılmış):
+
+1. URL'leri parse et — boşluk veya virgülle split
+2. Her URL için sırayla mevcut URL Mode pipeline'ını çalıştır:
+   - Fetch → raw/ yazımı → sources/ dönüşümü → INDEX.md güncelle → log → FTS5 sync
+3. Her URL için ayrı `skill-memory` dedup kontrolü yap
+4. Her URL sonrası 7-point quality gate uygula
+5. Hata olan URL'yi raporla ama sonrakine devam et (fail-forward)
+6. Tüm URL'ler bittikten sonra toplu rapor döndür:
+
+```json
+{ "processed": 3, "failed": 0, "skipped": 1, "sources": ["slug1", "slug2", "slug3"] }
+```
+
+Örnek kullanım:
+```
+/mindlore-ingest https://docs.aws.amazon.com/lambda/latest/dg/best-practices.html https://docs.aws.amazon.com/dynamodb/latest/developerguide/best-practices.html
+```
+
 ## Modes
 
 ### URL Mode (v0.5.2 — Zero-Token Pipeline)
@@ -60,6 +80,7 @@ If URL already in the list, warn user: "This URL was ingested recently. Re-inges
 3. **Write sources/ summary from truncated content:**
    - Extract: title, description (first paragraph), key topics
    - Generate frontmatter: slug, type: source, source_url, date_captured, tags, quality
+   - `project: {path.basename(process.cwd()) ile CWD'den alınan proje adı}`
    - `source_type` is auto-detected from URL pattern (see Source Summary Format)
    - Write to `$MINDLORE_DIR/sources/{slug}.md`
 
@@ -148,7 +169,7 @@ After every ingest, verify all 7 checkpoints before reporting success:
    ```
    Eğer score > 0.7 olan sonuç varsa KULLANICIYA SOR: "Bu içerik '${slug}' ile benzer görünüyor. Yine de eklensin mi?"
    Kullanıcı onaylarsa devam et, yoksa atla.
-1. **raw/ file exists** — immutable capture written with frontmatter (slug, type, source_url)
+1. **raw/ file exists** — immutable capture written with frontmatter (slug, type, source_url, project)
 2. **sources/ summary exists** — processed summary with full frontmatter (slug, type, title, tags, quality, description)
 3. **INDEX.md updated** — stats line incremented, Recent section has new entry
 4. **Domain updated** — if relevant domain exists, new finding added (max 1 domain per ingest)