mindlore 0.7.3 → 0.7.5

package/hooks/mindlore-session-focus.cjs

@@ -5,6 +5,38 @@ var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 
+// hooks/lib/reflect-trigger.cjs
+var require_reflect_trigger = __commonJS({
+  "hooks/lib/reflect-trigger.cjs"(exports2, module2) {
+    "use strict";
+    var REFLECT_THRESHOLD_DAYS = 7;
+    var NUDGE_COOLDOWN_HOURS = 24;
+    function isValidDate(iso) {
+      if (!iso) return false;
+      const d = new Date(iso);
+      return !isNaN(d.getTime());
+    }
+    function shouldNudgeReflect2(lastReflectIso, lastNudgeIso, now = /* @__PURE__ */ new Date()) {
+      let needsReflect;
+      if (!lastReflectIso) {
+        needsReflect = true;
+      } else if (!isValidDate(lastReflectIso)) {
+        return false;
+      } else {
+        const daysSince = (now.getTime() - new Date(lastReflectIso).getTime()) / 864e5;
+        needsReflect = daysSince >= REFLECT_THRESHOLD_DAYS;
+      }
+      if (!needsReflect) return false;
+      if (lastNudgeIso && isValidDate(lastNudgeIso)) {
+        const hoursSinceNudge = (now.getTime() - new Date(lastNudgeIso).getTime()) / 36e5;
+        if (hoursSinceNudge < NUDGE_COOLDOWN_HOURS) return false;
+      }
+      return true;
+    }
+    module2.exports = { shouldNudgeReflect: shouldNudgeReflect2, REFLECT_THRESHOLD_DAYS, NUDGE_COOLDOWN_HOURS };
+  }
+});
+
 // dist/scripts/lib/session-payload.js
 var require_session_payload = __commonJS({
   "dist/scripts/lib/session-payload.js"(exports2) {
@@ -14,35 +46,23 @@ var require_session_payload = __commonJS({
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.buildSessionPayload = buildSessionPayload;
-    var fs_1 = __importDefault(require("fs"));
-    var path_1 = __importDefault(require("path"));
     var crypto_1 = __importDefault(require("crypto"));
     var CHARS_PER_TOKEN = 4;
     function estimateTokens(text) {
       return Math.ceil(text.length / CHARS_PER_TOKEN);
     }
-    function buildSessionSummary(baseDir, latestDeltaContent) {
-      if (latestDeltaContent) {
-        const lines2 = latestDeltaContent.split("\n").filter((l) => l.startsWith("- ") || l.startsWith("# "));
-        return lines2.slice(0, 10).join("\n") || "No previous session data.";
-      }
-      const diaryDir = path_1.default.join(baseDir, "diary");
-      if (!fs_1.default.existsSync(diaryDir))
+    function buildSessionSummary(_baseDir, latestDeltaContent) {
+      if (!latestDeltaContent)
         return "No previous session data.";
-      const deltas = fs_1.default.readdirSync(diaryDir).filter((f) => f.startsWith("delta-")).sort();
-      if (deltas.length === 0)
-        return "No previous session data.";
-      const latestFile = deltas[deltas.length - 1] ?? "";
-      const latest = fs_1.default.readFileSync(path_1.default.join(diaryDir, latestFile), "utf8");
-      const lines = latest.split("\n").filter((l) => l.startsWith("- ") || l.startsWith("# "));
-      return lines.slice(0, 10).join("\n");
+      const lines = latestDeltaContent.split("\n").filter((l) => l.startsWith("- ") || l.startsWith("# "));
+      return lines.slice(0, 10).join("\n") || "No previous session data.";
     }
     function buildEpisodeSections(db, project, sessionId) {
       const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1e3).toISOString();
       const dedupClause = sessionId ? "AND rowid NOT IN (SELECT episode_id FROM episode_inject_log WHERE session_id = ?)" : "";
       const query = `SELECT rowid, kind, summary, created_at FROM episodes
      WHERE status = 'active' AND project = ?
-       AND kind IN ('decision', 'friction', 'learning')
+       AND kind IN ('decision', 'friction')
        AND created_at >= ?
        ${dedupClause}
      ORDER BY kind, created_at DESC`;
@@ -58,18 +78,17 @@ var require_session_payload = __commonJS({
           }
         })();
       }
-      const grouped = { decision: [], friction: [], learning: [] };
+      const grouped = { decision: [], friction: [] };
       for (const row of rows) {
         const kind = row.kind;
-        if (kind === "decision" || kind === "friction" || kind === "learning") {
+        if (kind === "decision" || kind === "friction") {
           grouped[kind].push(row);
         }
       }
       const fmt = (items, limit) => items.slice(0, limit).map((r) => `- ${r.summary} (${r.created_at.slice(0, 10)})`).join("\n");
       return {
         decisions: grouped.decision.length > 0 ? fmt(grouped.decision, 5) : "No recent decisions.",
-        friction: grouped.friction.length > 0 ? fmt(grouped.friction, 3) : "No active friction points.",
-        learnings: grouped.learning.length > 0 ? fmt(grouped.learning, 5) : "No recent learnings."
+        friction: grouped.friction.length > 0 ? fmt(grouped.friction, 3) : "No active friction points."
       };
     }
     function buildSessionPayload(opts) {
@@ -80,7 +99,6 @@ var require_session_payload = __commonJS({
       const episodes = buildEpisodeSections(db, project, sessionId);
       sections.push({ label: "Decisions", content: episodes.decisions, tokens: estimateTokens(episodes.decisions) });
       sections.push({ label: "Friction", content: episodes.friction, tokens: estimateTokens(episodes.friction) });
-      sections.push({ label: "Learnings", content: episodes.learnings, tokens: estimateTokens(episodes.learnings) });
       try {
         const summaries = db.prepare(`SELECT session_summary, created_at FROM episodes
        WHERE kind = 'session-summary' AND project = ? AND session_summary IS NOT NULL
@@ -597,7 +615,9 @@ var require_all_migrations = __commonJS({
 // hooks/src/mindlore-session-focus.cjs
 var fs = require("fs");
 var path = require("path");
-var { findMindloreDir, readConfig, openDatabase, hasEpisodesTable, querySupersededChains, formatSupersededChains, hookLog, getProjectName, parseFrontmatter, withTelemetry, withTimeoutDb, listSnapshots, isCorruptionError, recoverCorruptDb, getNominationCounts } = require("./lib/mindlore-common.cjs");
+var { findMindloreDir, readConfig, openDatabase, hasEpisodesTable, querySupersededChains, formatSupersededChains, hookLog, getProjectName, parseFrontmatter, withTelemetry, withTimeoutDb, listSnapshots, isCorruptionError, recoverCorruptDb, getNominationCounts, resolveMindloreHome } = require("./lib/mindlore-common.cjs");
+var { loadLearningsBlock } = require("./lib/learnings-loader.cjs");
+var { shouldNudgeReflect } = require_reflect_trigger();
 function truncateSection(content, sectionRegex, keepCount, label) {
   const match = content.match(sectionRegex);
   if (!match) return content;
@@ -614,7 +634,7 @@ function truncateChangedFiles(content) {
   return truncateSection(content, /(## Changed Files\n)((?:- [^\n]+\n?)+)/, 10, "dosya");
 }
 function tryOpenDb(dbPath) {
-  return openDatabase(dbPath, { readonly: true });
+  return openDatabase(dbPath, { readonly: false }) || openDatabase(dbPath, { readonly: true });
 }
 function getEpisodeStats(db, config, project) {
   const chains = querySupersededChains(db, { project, days: 7, limit: 5 });
@@ -622,8 +642,11 @@ function getEpisodeStats(db, config, project) {
   try {
     const rawCount = withTimeoutDb(
       db,
-      "SELECT COUNT(*) as cnt FROM episodes WHERE consolidation_status = 'raw' OR consolidation_status IS NULL",
-      [],
+      `SELECT COUNT(*) as cnt FROM episodes
+       WHERE (consolidation_status = 'raw' OR consolidation_status IS NULL)
+         AND kind IN ('learning','discovery','friction','decision','nomination')
+         AND project = ?`,
+      [project],
       { mode: "get" }
     );
     const cnt = rawCount?.cnt ?? 0;
@@ -681,6 +704,9 @@ ${formatSupersededChains(chains)}`);
   timings.db_stale = Date.now() - tStale;
   try {
     const counts = getNominationCounts(db, project);
+    if (counts.staged > 0) {
+      output.push(`[Mindlore Nomination] ${counts.staged} karar bekliyor \u2014 /mindlore-reflect ile onayla`);
+    }
     if (counts.staged >= (config?.graduation?.reflectThreshold ?? 5)) {
       output.push(`[Mindlore] ${counts.staged} bekleyen nomination var \u2014 \`/mindlore-reflect\` \xE7al\u0131\u015Ft\u0131r`);
     }
@@ -725,11 +751,11 @@ ${content}`);
         const latestPath = path.join(diaryDir, latestName);
         const deltaContent = fs.readFileSync(latestPath, "utf8").trim();
         sourceChars += deltaContent.length;
-        latestDeltaContent = deltaContent;
         const { meta } = parseFrontmatter(deltaContent);
         const deltaProject = meta.project || null;
         const currentProject = getProjectName();
         if (!deltaProject || deltaProject.toLowerCase() === currentProject.toLowerCase()) {
+          latestDeltaContent = deltaContent;
           output.push(`[Mindlore Delta: ${latestName}]
 ${truncateChangedFiles(truncateCommits(deltaContent))}`);
         }
@@ -778,6 +804,24 @@ ${truncateChangedFiles(truncateCommits(deltaContent))}`);
         }
         timings.schema_check = Date.now() - tSchema;
         loadDbContent({ db, baseDir, config, output, timings, latestDeltaContent, sessionId });
+        try {
+          const reflectRow = db.prepare(
+            "SELECT value FROM skill_memory WHERE skill_name = 'mindlore-reflect' AND key = 'last_reflect_date'"
+          ).get();
+          const nudgeRow = db.prepare(
+            "SELECT value FROM skill_memory WHERE skill_name = 'mindlore-reflect' AND key = 'last_nudge_date'"
+          ).get();
+          if (shouldNudgeReflect(reflectRow?.value ?? null, nudgeRow?.value ?? null, /* @__PURE__ */ new Date())) {
+            output.push("[Mindlore] 7+ g\xFCn reflect yap\u0131lmad\u0131 \u2014 `/mindlore-reflect` \xE7al\u0131\u015Ft\u0131r");
+            const nowIso = (/* @__PURE__ */ new Date()).toISOString();
+            db.prepare(`
+              INSERT INTO skill_memory (skill_name, key, value, updated_at)
+              VALUES ('mindlore-reflect', 'last_nudge_date', ?, ?)
+              ON CONFLICT(skill_name, key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at
+            `).run(nowIso, nowIso);
+          }
+        } catch (_err) {
+        }
       } catch (err) {
         if (isCorruptionError(err)) {
           recoverCorruptDb(db, dbPath, "session-focus");
@@ -794,6 +838,16 @@ ${truncateChangedFiles(truncateCommits(deltaContent))}`);
   const outputLenAfterDb = output.reduce((s, o) => s + o.length, 0);
   sourceChars += outputLenAfterDb - outputLenBeforeDb;
   timings.db_total = Date.now() - tDb;
+  try {
+    const mindloreDir = resolveMindloreHome();
+    const project = getProjectName();
+    const learningsBlock = loadLearningsBlock(mindloreDir, project);
+    if (learningsBlock) {
+      output.push(learningsBlock);
+      sourceChars += learningsBlock.length;
+    }
+  } catch (_err) {
+  }
   timings.total = Date.now() - t0;
   hookLog("session-focus", "info", `timings: ${JSON.stringify(timings)}`);
   const budgetConfig = config?.tokenBudget ?? {};

package/hooks/src/lib/mindlore-common.cjs

@@ -26,6 +26,10 @@ function globalDir() {
   return path.join(os.homedir(), MINDLORE_DIR);
 }
 
+function resolveMindloreHome() {
+  return globalDir();
+}
+
 // Convenience export — snapshot at load time for simple references.
 const GLOBAL_MINDLORE_DIR = globalDir();
 
@@ -773,6 +777,7 @@ module.exports = {
   MINDLORE_DIR,
   GLOBAL_MINDLORE_DIR,
   globalDir,
+  resolveMindloreHome,
   DB_NAME,
   SKIP_FILES,
   findMindloreDir,

package/hooks/src/mindlore-fts5-sync.cjs

@@ -15,17 +15,18 @@ const fs = require('fs');
 const path = require('path');
 const { DB_NAME, sha256, openDatabase, getAllMdFiles, parseFrontmatter, extractFtsMetadata, insertFtsRow, readHookStdin, getActiveMindloreDir, getProjectName, resolveProject, hookLog, withTelemetry, SQL_FTS_SESSIONS_INSERT, isSessionCategory, isInsideMindloreDir } = require('./lib/mindlore-common.cjs');
 
+function shouldIndexFile(filePath) {
+  return !!(filePath && filePath.endsWith('.md'));
+}
+
 function main() {
   const filePath = readHookStdin(['path', 'file_path']);
 
   if (!filePath) return;
+  if (!shouldIndexFile(filePath)) return;
   const resolved = path.resolve(filePath);
   if (!isInsideMindloreDir(resolved)) 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 = getActiveMindloreDir();
   if (!fs.existsSync(baseDir)) return;
 
@@ -92,6 +93,8 @@ function main() {
 
 }
 
+module.exports = { shouldIndexFile };
+
 withTelemetry('mindlore-fts5-sync', main).catch(err => {
   hookLog('mindlore-fts5-sync', 'error', err?.message ?? String(err));
   process.exit(0);

package/hooks/src/mindlore-search.cjs

@@ -11,7 +11,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { getAllDbs, openDatabase, extractHeadings, readHookStdin, readConfig, hookLog, incrementRecallCount, withTelemetry } = require('./lib/mindlore-common.cjs');
+const { getAllDbs, openDatabase, extractHeadings, readConfig, hookLog, incrementRecallCount, withTelemetry } = require('./lib/mindlore-common.cjs');
 
 const MAX_RESULTS = 3;
 const MIN_QUERY_WORDS = 3;
@@ -30,9 +30,23 @@ try {
   // search-cache not built yet
 }
 
+function parseStdin() {
+  try {
+    const raw = fs.readFileSync(0, 'utf8').trim();
+    if (!raw) return { userMessage: '', sessionId: 'unknown' };
+    const parsed = JSON.parse(raw);
+    const userMessage = parsed.prompt || parsed.content || parsed.message || parsed.query || raw;
+    const sessionId = parsed.session_id || 'unknown';
+    return { userMessage, sessionId };
+  } catch (_err) {
+    return { userMessage: '', sessionId: 'unknown' };
+  }
+}
+
 function main() {
-  const userMessage = readHookStdin(['prompt', 'content', 'message', 'query']);
+  const { userMessage, sessionId } = parseStdin();
   if (!userMessage || userMessage.length < MIN_QUERY_WORDS) return;
+  let searchMs = 0;
 
   const dbPaths = getAllDbs();
   if (dbPaths.length === 0) return;
@@ -46,15 +60,6 @@ function main() {
   const config = readConfig(path.dirname(dbPaths[0]));
   const synonyms = (config && config.synonyms) ? config.synonyms : {};
 
-  // Read session_id from stdin for throttling
-  let sessionId;
-  try {
-    const stdinData = JSON.parse(process.env.CLAUDE_HOOK_STDIN || '{}');
-    sessionId = stdinData.session_id || 'unknown';
-  } catch (_) {
-    sessionId = 'unknown';
-  }
-
   const allResults = [];
   for (const dbPath of dbPaths) {
     const db = openDatabase(dbPath);
@@ -82,11 +87,13 @@ function main() {
         }
       }
 
+      const t0 = Date.now();
       const results = searchEngineMod.search(db, userMessage, {
         project,
         maxResults: effectiveMax,
         synonyms,
       });
+      searchMs += Date.now() - t0;
 
       if (cache) cache.set(userMessage, results);
 
@@ -192,6 +199,7 @@ function main() {
 
     process.stdout.write(outputStr);
   }
+  return { search_ms: searchMs, result_count: relevant.length };
 }
 
 withTelemetry('mindlore-search', main).catch(err => {

package/hooks/src/mindlore-session-focus.cjs

@@ -10,7 +10,9 @@
 
 const fs = require('fs');
 const path = require('path');
-const { findMindloreDir, readConfig, openDatabase, hasEpisodesTable, querySupersededChains, formatSupersededChains, hookLog, getProjectName, parseFrontmatter, withTelemetry, withTimeoutDb, listSnapshots, isCorruptionError, recoverCorruptDb, getNominationCounts } = require('./lib/mindlore-common.cjs');
+const { findMindloreDir, readConfig, openDatabase, hasEpisodesTable, querySupersededChains, formatSupersededChains, hookLog, getProjectName, parseFrontmatter, withTelemetry, withTimeoutDb, listSnapshots, isCorruptionError, recoverCorruptDb, getNominationCounts, resolveMindloreHome } = require('./lib/mindlore-common.cjs');
+const { loadLearningsBlock } = require('./lib/learnings-loader.cjs');
+const { shouldNudgeReflect } = require('../lib/reflect-trigger.cjs');
 
 function truncateSection(content, sectionRegex, keepCount, label) {
   const match = content.match(sectionRegex);
@@ -30,7 +32,7 @@ function truncateChangedFiles(content) {
 }
 
 function tryOpenDb(dbPath) {
-  return openDatabase(dbPath, { readonly: true });
+  return openDatabase(dbPath, { readonly: false }) || openDatabase(dbPath, { readonly: true });
 }
 
 function getEpisodeStats(db, config, project) {
@@ -38,8 +40,11 @@ function getEpisodeStats(db, config, project) {
   let consolidationMsg = null;
   try {
     const rawCount = withTimeoutDb(db,
-      "SELECT COUNT(*) as cnt FROM episodes WHERE consolidation_status = 'raw' OR consolidation_status IS NULL",
-      [], { mode: 'get' });
+      `SELECT COUNT(*) as cnt FROM episodes
+       WHERE (consolidation_status = 'raw' OR consolidation_status IS NULL)
+         AND kind IN ('learning','discovery','friction','decision','nomination')
+         AND project = ?`,
+      [project], { mode: 'get' });
     const cnt = rawCount?.cnt ?? 0;
     const consolThreshold = config?.consolidation?.threshold ?? 50;
     if (cnt >= consolThreshold) {
@@ -63,7 +68,7 @@ function checkStaleContent(db) {
 
 function loadDbContent({ db, baseDir, config, output, timings, latestDeltaContent, sessionId }) {
   const project = path.basename(process.cwd());
-  // Session payload: Session summary, Decisions, Friction, Learnings
+  // Session payload: Session summary, Decisions, Friction (Learnings via file-based loadLearningsBlock)
   const tPayload = Date.now();
   try {
     const { buildSessionPayload } = require('../dist/scripts/lib/session-payload.js');
@@ -101,6 +106,9 @@ function loadDbContent({ db, baseDir, config, output, timings, latestDeltaConten
   // Auto reflect trigger (Q1) + Graduated lesson count (Q3)
   try {
     const counts = getNominationCounts(db, project);
+    if (counts.staged > 0) {
+      output.push(`[Mindlore Nomination] ${counts.staged} karar bekliyor — /mindlore-reflect ile onayla`);
+    }
     if (counts.staged >= (config?.graduation?.reflectThreshold ?? 5)) {
       output.push(`[Mindlore] ${counts.staged} bekleyen nomination var — \`/mindlore-reflect\` çalıştır`);
     }
@@ -150,11 +158,11 @@ function main() {
         const latestPath = path.join(diaryDir, latestName);
         const deltaContent = fs.readFileSync(latestPath, 'utf8').trim();
         sourceChars += deltaContent.length;
-        latestDeltaContent = deltaContent;
         const { meta } = parseFrontmatter(deltaContent);
         const deltaProject = meta.project || null;
         const currentProject = getProjectName();
         if (!deltaProject || deltaProject.toLowerCase() === currentProject.toLowerCase()) {
+          latestDeltaContent = deltaContent;
           output.push(`[Mindlore Delta: ${latestName}]\n${truncateChangedFiles(truncateCommits(deltaContent))}`);
         }
       }
@@ -209,6 +217,27 @@ function main() {
         timings.schema_check = Date.now() - tSchema;
 
         loadDbContent({ db, baseDir, config, output, timings, latestDeltaContent, sessionId });
+
+        // Auto-reflect nudge (7-day threshold + 24h cooldown)
+        try {
+          const reflectRow = db.prepare(
+            "SELECT value FROM skill_memory WHERE skill_name = 'mindlore-reflect' AND key = 'last_reflect_date'"
+          ).get();
+          const nudgeRow = db.prepare(
+            "SELECT value FROM skill_memory WHERE skill_name = 'mindlore-reflect' AND key = 'last_nudge_date'"
+          ).get();
+          if (shouldNudgeReflect(reflectRow?.value ?? null, nudgeRow?.value ?? null, new Date())) {
+            output.push('[Mindlore] 7+ gün reflect yapılmadı — `/mindlore-reflect` çalıştır');
+            const nowIso = new Date().toISOString();
+            db.prepare(`
+              INSERT INTO skill_memory (skill_name, key, value, updated_at)
+              VALUES ('mindlore-reflect', 'last_nudge_date', ?, ?)
+              ON CONFLICT(skill_name, key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at
+            `).run(nowIso, nowIso);
+          }
+        } catch (_err) {
+          // never block session-start on nudge failure
+        }
       } catch (err) {
         if (isCorruptionError(err)) {
           recoverCorruptDb(db, dbPath, 'session-focus');
@@ -222,6 +251,19 @@ function main() {
   sourceChars += (outputLenAfterDb - outputLenBeforeDb);
   timings.db_total = Date.now() - tDb;
 
+  // Inject [Mindlore Learnings] block
+  try {
+    const mindloreDir = resolveMindloreHome();
+    const project = getProjectName();
+    const learningsBlock = loadLearningsBlock(mindloreDir, project);
+    if (learningsBlock) {
+      output.push(learningsBlock);
+      sourceChars += learningsBlock.length;
+    }
+  } catch (_err) {
+    // never block session-start on lessons loader failure
+  }
+
   timings.total = Date.now() - t0;
   hookLog('session-focus', 'info', `timings: ${JSON.stringify(timings)}`);
 

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "mindlore",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "AI-native knowledge system for Claude Code",
   "type": "commonjs",
   "bin": {
-    "mindlore": "dist/scripts/init.js"
+    "mindlore": "dist/scripts/init.js",
+    "mindlore-clean-cache": "dist/scripts/mindlore-clean-cache.js"
   },
   "scripts": {
     "build": "tsc",
@@ -27,7 +28,7 @@
     "bundle:hooks": "npx tsx scripts/bundle-hooks.ts",
     "bundle:mcp": "npx esbuild scripts/mcp-server.ts --bundle --platform=node --target=node20 --format=cjs --outfile=mcp-server.cjs --external:better-sqlite3",
     "bundle": "npm run bundle:hooks && npm run bundle:mcp",
-    "postinstall": "npm rebuild better-sqlite3"
+    "postinstall": "npm run build && npm rebuild better-sqlite3"
   },
   "keywords": [
     "claude-code",
@@ -55,6 +56,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "better-sqlite3": "^12.9.0",
+    "sqlite-vec": "^0.1.9",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/plugin.json

@@ -2,7 +2,7 @@
   "manifestVersion": 2,
   "name": "mindlore",
   "description": "AI-native knowledge system for Claude Code. Persistent, searchable, evolving knowledge base with FTS5 and Knowledge Graph.",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "skills": [
     {
       "name": "mindlore-ingest",

package/skills/mindlore-decide/SKILL.md

@@ -15,7 +15,7 @@ Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
 1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-decide" → `MINDLORE_PKG = {base_directory}/../..`
 2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
 
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+Use: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-decide <script> [args...]` for all script commands.
 
 ## Scope
 

package/skills/mindlore-diary/SKILL.md

@@ -10,7 +10,7 @@ Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
 1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-diary" → `MINDLORE_PKG = {base_directory}/../..`
 2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
 
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+Use: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-diary <script> [args...]` for all script commands.
 
 # /mindlore-diary
 
@@ -27,7 +27,7 @@ Determine target using `getActiveMindloreDir()` logic:
 ## On Start — Read skill_memory
 
 ```bash
-node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" get mindlore-diary last_diary_date
+node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-diary lib/skill-memory.js get mindlore-diary last_diary_date
 ```
 If last_diary_date is today, warn: "Diary already ran today. Continue anyway?"
 
@@ -73,8 +73,8 @@ If last_diary_date is today, warn: "Diary already ran today. Continue anyway?"
 ## On End — Write skill_memory
 
 ```bash
-node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-diary last_diary_date "$(date -I)"
-node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-diary last_episode_count "{N}"
+node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-diary lib/skill-memory.js set mindlore-diary last_diary_date "$(date -I)"
+node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-diary lib/skill-memory.js set mindlore-diary last_episode_count "{N}"
 ```
 
 ## Rules

package/skills/mindlore-evolve/SKILL.md

@@ -12,7 +12,7 @@ Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
 1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-evolve" → `MINDLORE_PKG = {base_directory}/../..`
 2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
 
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+Use: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-evolve <script> [args...]` for all script commands.
 
 # /mindlore-evolve
 
@@ -107,7 +107,7 @@ Apply suggested changes with user approval.
 **Rules:**
 - NEVER make automatic changes — always require user approval
 - Show diff preview before applying
-- After changes, run `node "$MINDLORE_PKG/dist/scripts/mindlore-fts5-index.js"` for FTS5 sync
+- After changes, run `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-evolve mindlore-fts5-index.js` for FTS5 sync
 - Log every change to log.md with timestamp
 - The `[mindlore:evolve]` marker in the Agent prompt is required — it triggers the model-router hook to use the cost-optimized model (sonnet by default)
 

package/skills/mindlore-health/SKILL.md

@@ -11,7 +11,7 @@ allowed-tools: [Bash, Read]
 Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
 1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-health" → `MINDLORE_PKG = {base_directory}/../..`
 2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+Use: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-health <script> [args...]` for all script commands.
 
 # /mindlore-health
 
@@ -33,7 +33,7 @@ User says "health check", "mindlore health", "bilgi sistemi kontrol", "saglik ko
 
 1. Run the health check script:
    ```bash
-   node "$MINDLORE_PKG/dist/scripts/mindlore-health-check.js"
+   node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-health mindlore-health-check.js
    ```
 
 2. Read the output and provide LLM interpretation:

package/skills/mindlore-ingest/SKILL.md

@@ -13,7 +13,7 @@ Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
 1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-ingest" → `MINDLORE_PKG = {base_directory}/../..`
 2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
 
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+Use: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-ingest <script> [args...]` for all script commands.
 
 # /mindlore-ingest
 
@@ -59,7 +59,7 @@ Birden fazla URL verildiğinde (boşluk veya virgülle ayrılmış):
 
 **Pre-check (before fetch):**
 ```bash
-node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" get mindlore-ingest last_ingest_urls
+node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-ingest lib/skill-memory.js get mindlore-ingest last_ingest_urls
 ```
 If URL already in the list, warn user: "This URL was ingested recently. Re-ingest?"
 
@@ -67,7 +67,7 @@ If URL already in the list, warn user: "This URL was ingested recently. Re-inges
 
 1. **Fetch raw content (zero token):**
    ```bash
-   node "$MINDLORE_PKG/dist/scripts/fetch-raw.js" "$URL" --out-dir "$MINDLORE_DIR/raw"
+   node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-ingest fetch-raw.js "$URL" --out-dir "$MINDLORE_DIR/raw"
    ```
    Script output: `{ "saved": "/path/to/raw/2026-04-18-abc123.md", "chars": 14823, "method": "curl" }`
 
@@ -88,7 +88,7 @@ If URL already in the list, warn user: "This URL was ingested recently. Re-inges
 
 5. **Update skill_memory:**
    ```bash
-   node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-ingest last_ingest_urls "$URL"
+   node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-ingest lib/skill-memory.js set mindlore-ingest last_ingest_urls "$URL"
    ```
 
 6. **Return to caller (this is all the ana session sees):**
@@ -176,7 +176,7 @@ After every ingest, verify all 7 checkpoints before reporting success:
 
 0. **Duplicate check** — Ingest öncesi mevcut DB'de benzer içerik ara:
    ```bash
-   node "$MINDLORE_PKG/dist/scripts/lib/similarity.js" "<title or first 100 chars>"
+   node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-ingest lib/similarity.js "<title or first 100 chars>"
    ```
    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.
@@ -185,11 +185,11 @@ After every ingest, verify all 7 checkpoints before reporting success:
 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)
 5. **log.md entry** — append `| {date} | ingest | {slug}.md |`
-6. **FTS5 indexed** — FileChanged hook auto-triggers, but verify: `node "$MINDLORE_PKG/dist/scripts/mindlore-fts5-search.js" "{keyword}"` returns the new file
+6. **FTS5 indexed** — FileChanged hook auto-triggers, but verify: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-ingest mindlore-fts5-search.js "{keyword}"` returns the new file
 
 If any checkpoint fails, fix it before reporting "ingest complete". Do NOT skip steps.
 
 Optional: run full health check for structural integrity:
 ```bash
-node "$MINDLORE_PKG/dist/scripts/mindlore-health-check.js"
+node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-ingest mindlore-health-check.js
 ```

package/skills/mindlore-log/SKILL.md

@@ -15,7 +15,7 @@ Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
 1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-log" → `MINDLORE_PKG = {base_directory}/../..`
 2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
 
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+Use: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-log <script> [args...]` for all script commands.
 
 ## Scope
 

package/skills/mindlore-maintain/SKILL.md

@@ -12,7 +12,7 @@ Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
 1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-maintain" → `MINDLORE_PKG = {base_directory}/../..`
 2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
 
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+Use: `node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-maintain <script> [args...]` for all script commands.
 
 # /mindlore-maintain
 
@@ -97,7 +97,7 @@ KB bakım skill'i. Reflect düşünür, maintain temizler.
 
 1. Deterministic wiki-lint:
    ```bash
-   node "$MINDLORE_PKG/dist/scripts/mindlore-health-check.js" ~/.mindlore 2>/dev/null | grep -A 5 'contradiction'
+   node "$MINDLORE_PKG/dist/scripts/lib/skill-runner.js" mindlore-maintain mindlore-health-check.js ~/.mindlore 2>/dev/null | grep -A 5 'contradiction'
    ```
 
 2. Semantic analiz (opsiyonel, token harcar)