mindlore 0.5.2 → 0.5.3

package/dist/tests/migrations-v053.test.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const schema_version_js_1 = require("../scripts/lib/schema-version.js");
+const migrations_js_1 = require("../scripts/lib/migrations.js");
+const migrations_v052_js_1 = require("../scripts/lib/migrations-v052.js");
+const migrations_v053_js_1 = require("../scripts/lib/migrations-v053.js");
+const ALL_MIGRATIONS = [...migrations_js_1.V050_MIGRATIONS, ...migrations_js_1.V051_MIGRATIONS, ...migrations_v052_js_1.V052_MIGRATIONS, ...migrations_v053_js_1.V053_MIGRATIONS];
+const { SQL_FTS_CREATE } = require('../hooks/lib/mindlore-common.cjs');
+function createBaseDb(dbPath) {
+    const db = new better_sqlite3_1.default(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.exec(SQL_FTS_CREATE);
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS file_hashes (
+      path TEXT PRIMARY KEY,
+      content_hash TEXT NOT NULL,
+      last_indexed TEXT NOT NULL
+    );
+  `);
+    (0, schema_version_js_1.ensureSchemaTable)(db);
+    return db;
+}
+function addEpisodesTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS episodes (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      timestamp TEXT NOT NULL,
+      summary TEXT NOT NULL,
+      project TEXT,
+      tags TEXT,
+      quality REAL DEFAULT 0.5
+    );
+  `);
+}
+describe('v0.5.3 Migrations', () => {
+    let tmpDir;
+    let dbPath;
+    beforeEach(() => {
+        tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'mindlore-v053-'));
+        dbPath = path_1.default.join(tmpDir, 'test.db');
+    });
+    afterEach(() => {
+        fs_1.default.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    test('v4 should add recall_count and last_recalled_at to file_hashes', () => {
+        const db = createBaseDb(dbPath);
+        (0, schema_version_js_1.runMigrations)(db, ALL_MIGRATIONS);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- test: pragma returns array of objects
+        const cols = db.pragma('table_info(file_hashes)');
+        const colNames = cols.map(c => c.name);
+        expect(colNames).toContain('recall_count');
+        expect(colNames).toContain('last_recalled_at');
+        expect(colNames).toContain('archived_at');
+        expect(colNames).toContain('importance');
+        db.close();
+    });
+    test('v5 should add consolidation columns to episodes', () => {
+        const db = createBaseDb(dbPath);
+        addEpisodesTable(db);
+        (0, schema_version_js_1.runMigrations)(db, ALL_MIGRATIONS);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- test: pragma returns array of objects
+        const cols = db.pragma('table_info(episodes)');
+        const colNames = cols.map(c => c.name);
+        expect(colNames).toContain('consolidation_status');
+        expect(colNames).toContain('consolidated_into');
+        expect(colNames).toContain('decay_score');
+        expect(colNames).toContain('last_decay_calc');
+        db.close();
+    });
+    test('v4+v5 should not corrupt existing data (backward compat)', () => {
+        const db = createBaseDb(dbPath);
+        addEpisodesTable(db);
+        const now = new Date().toISOString();
+        db.prepare('INSERT INTO file_hashes (path, content_hash, last_indexed) VALUES (?, ?, ?)').run('/test/file.md', 'abc123', now);
+        db.prepare('INSERT INTO episodes (session_id, timestamp, summary, project) VALUES (?, ?, ?, ?)').run('sess-1', now, 'Test episode summary', 'mindlore');
+        (0, schema_version_js_1.runMigrations)(db, ALL_MIGRATIONS);
+        // Verify existing file_hashes row intact + new column defaults
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- test: better-sqlite3 .get() returns unknown
+        const fhRow = db.prepare('SELECT * FROM file_hashes WHERE path = ?').get('/test/file.md');
+        expect(fhRow.content_hash).toBe('abc123');
+        expect(fhRow.recall_count).toBe(0);
+        expect(fhRow.importance).toBe(1.0);
+        expect(fhRow.last_recalled_at).toBeNull();
+        expect(fhRow.archived_at).toBeNull();
+        // Verify existing episodes row intact + new column defaults
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- test: better-sqlite3 .get() returns unknown
+        const epRow = db.prepare('SELECT * FROM episodes WHERE session_id = ?').get('sess-1');
+        expect(epRow.summary).toBe('Test episode summary');
+        expect(epRow.consolidation_status).toBe('raw');
+        expect(epRow.consolidated_into).toBeNull();
+        expect(epRow.decay_score).toBeNull();
+        expect(epRow.last_decay_calc).toBeNull();
+        db.close();
+    });
+    test('migrations should be idempotent', () => {
+        const db = createBaseDb(dbPath);
+        addEpisodesTable(db);
+        expect(() => {
+            (0, schema_version_js_1.runMigrations)(db, ALL_MIGRATIONS);
+            (0, schema_version_js_1.runMigrations)(db, ALL_MIGRATIONS);
+        }).not.toThrow();
+        db.close();
+    });
+});
+//# sourceMappingURL=migrations-v053.test.js.map

package/dist/tests/migrations-v053.test.js.map

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

package/dist/tests/recall-telemetry.test.d.ts

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

package/dist/tests/recall-telemetry.test.d.ts.map

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

package/dist/tests/recall-telemetry.test.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const schema_version_js_1 = require("../scripts/lib/schema-version.js");
+const migrations_js_1 = require("../scripts/lib/migrations.js");
+const migrations_v052_js_1 = require("../scripts/lib/migrations-v052.js");
+const migrations_v053_js_1 = require("../scripts/lib/migrations-v053.js");
+describe('Recall Telemetry', () => {
+    const tmpDir = path_1.default.join(os_1.default.tmpdir(), `mindlore-recall-${Date.now()}`);
+    const dbPath = path_1.default.join(tmpDir, 'mindlore.db');
+    beforeEach(() => {
+        fs_1.default.mkdirSync(tmpDir, { recursive: true });
+        const db = new better_sqlite3_1.default(dbPath);
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS file_hashes (path TEXT PRIMARY KEY, hash TEXT, last_indexed TEXT);
+      CREATE VIRTUAL TABLE IF NOT EXISTS mindlore_fts USING fts5(
+        path, slug, description, type, category, title, content, tags, quality, date_captured, project
+      );
+    `);
+        (0, schema_version_js_1.ensureSchemaTable)(db);
+        (0, schema_version_js_1.runMigrations)(db, [...migrations_js_1.V050_MIGRATIONS, ...migrations_js_1.V051_MIGRATIONS, ...migrations_v052_js_1.V052_MIGRATIONS, ...migrations_v053_js_1.V053_MIGRATIONS]);
+        db.exec(`
+      INSERT INTO file_hashes (path, hash, last_indexed, recall_count, last_recalled_at)
+      VALUES ('/test/file.md', 'abc123', '2026-01-01', 0, NULL);
+    `);
+        db.close();
+    });
+    afterEach(() => fs_1.default.rmSync(tmpDir, { recursive: true, force: true }));
+    test('incrementRecallCount should update recall_count and last_recalled_at', () => {
+        const db = new better_sqlite3_1.default(dbPath);
+        const { incrementRecallCount } = require('../hooks/lib/mindlore-common.cjs');
+        incrementRecallCount(db, '/test/file.md');
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- better-sqlite3 .get() returns unknown, narrowing to expected row shape
+        const row = db.prepare('SELECT recall_count, last_recalled_at FROM file_hashes WHERE path = ?').get('/test/file.md');
+        expect(row.recall_count).toBe(1);
+        expect(row.last_recalled_at).toBeTruthy();
+        incrementRecallCount(db, '/test/file.md');
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- better-sqlite3 .get() returns unknown, narrowing to expected row shape
+        const row2 = db.prepare('SELECT recall_count FROM file_hashes WHERE path = ?').get('/test/file.md');
+        expect(row2.recall_count).toBe(2);
+        db.close();
+    });
+    test('incrementRecallCount should not error on missing path', () => {
+        const db = new better_sqlite3_1.default(dbPath);
+        const { incrementRecallCount } = require('../hooks/lib/mindlore-common.cjs');
+        expect(() => incrementRecallCount(db, '/nonexistent.md')).not.toThrow();
+        db.close();
+    });
+});
+//# sourceMappingURL=recall-telemetry.test.js.map

package/dist/tests/recall-telemetry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-telemetry.test.js","sourceRoot":"","sources":["../../tests/recall-telemetry.test.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,4CAAoB;AACpB,oEAAsC;AACtC,wEAAoF;AACpF,gEAAgF;AAChF,0EAAoE;AACpE,0EAAoE;AAEpE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEhD,UAAU,CAAC,GAAG,EAAE;QACd,YAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,EAAE,GAAG,IAAI,wBAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,EAAE,CAAC,IAAI,CAAC;;;;;KAKP,CAAC,CAAC;QACH,IAAA,qCAAiB,EAAC,EAAE,CAAC,CAAC;QACtB,IAAA,iCAAa,EAAC,EAAE,EAAE,CAAC,GAAG,+BAAe,EAAE,GAAG,+BAAe,EAAE,GAAG,oCAAe,EAAE,GAAG,oCAAe,CAAC,CAAC,CAAC;QACpG,EAAE,CAAC,IAAI,CAAC;;;KAGP,CAAC,CAAC;QACH,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE,CAAC,YAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAErE,IAAI,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAChF,MAAM,EAAE,GAAG,IAAI,wBAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAC7E,oBAAoB,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1C,iJAAiJ;QACjJ,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,uEAAuE,CAAC,CAAC,GAAG,CAAC,eAAe,CAA8D,CAAC;QAClL,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,UAAU,EAAE,CAAC;QAC1C,oBAAoB,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1C,iJAAiJ;QACjJ,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAC,GAAG,CAAC,eAAe,CAA6B,CAAC;QAChI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uDAAuD,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,GAAG,IAAI,wBAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAAC;QAC7E,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACxE,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/skill-path-resolution.test.d.ts

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

package/dist/tests/skill-path-resolution.test.d.ts.map

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

package/dist/tests/skill-path-resolution.test.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
+describe('Skill script path resolution', () => {
+    const mindlorePkg = path_1.default.resolve(__dirname, '..');
+    const tmpDir = path_1.default.join(os_1.default.tmpdir(), `mindlore-path-res-${Date.now()}`);
+    beforeEach(() => fs_1.default.mkdirSync(tmpDir, { recursive: true }));
+    afterEach(() => fs_1.default.rmSync(tmpDir, { recursive: true, force: true }));
+    test('scripts are reachable from a different CWD via MINDLORE_PKG', () => {
+        const healthScript = path_1.default.join(mindlorePkg, 'dist', 'scripts', 'mindlore-health-check.js');
+        expect(fs_1.default.existsSync(healthScript)).toBe(true);
+        const result = (0, child_process_1.execSync)(`node "${healthScript}" "${path_1.default.join(os_1.default.homedir(), '.mindlore')}" 2>&1 || true`, { cwd: tmpDir, encoding: 'utf8', timeout: 15000 });
+        expect(result).not.toContain('Cannot find module');
+    });
+    test('skill preamble pattern resolves correctly', () => {
+        const skillBase = path_1.default.join(mindlorePkg, 'skills', 'mindlore-diary');
+        const resolvedPkg = path_1.default.resolve(skillBase, '..', '..');
+        expect(resolvedPkg).toBe(mindlorePkg);
+        expect(fs_1.default.existsSync(path_1.default.join(resolvedPkg, 'dist', 'scripts'))).toBe(true);
+    });
+    test('no bare "node dist/" or "node scripts/" references in skill files', () => {
+        const skillsDir = path_1.default.join(mindlorePkg, 'skills');
+        const skillDirs = fs_1.default.readdirSync(skillsDir).filter(d => fs_1.default.statSync(path_1.default.join(skillsDir, d)).isDirectory());
+        for (const dir of skillDirs) {
+            const skillFile = path_1.default.join(skillsDir, dir, 'SKILL.md');
+            if (!fs_1.default.existsSync(skillFile))
+                continue;
+            const content = fs_1.default.readFileSync(skillFile, 'utf8');
+            const bareNodeDist = content.match(/node dist\//g) ?? [];
+            const bareNodeScripts = content.match(/node scripts\//g) ?? [];
+            expect(bareNodeDist).toEqual([]);
+            expect(bareNodeScripts).toEqual([]);
+        }
+    });
+});
+//# sourceMappingURL=skill-path-resolution.test.js.map

package/dist/tests/skill-path-resolution.test.js.map

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

package/hooks/lib/mindlore-common.cjs

@@ -398,7 +398,9 @@ 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 hasConsolCol = db.pragma('table_info(episodes)').some(c => c.name === 'consolidation_status');
+  const consolFilter = hasConsolCol ? " AND (consolidation_status IS NULL OR consolidation_status != 'consolidated')" : '';
+  let sql = `SELECT kind, summary, created_at FROM episodes WHERE status = 'active'${consolFilter}`;
   const params = [];
 
   if (project) {
@@ -675,6 +677,8 @@ module.exports = {
   resolveWin32Bin,
   // Skeleton compression (v0.5.2)
   extractSkeleton,
+  // Recall telemetry (v0.5.3)
+  incrementRecallCount,
 };
 
 /**
@@ -706,6 +710,30 @@ function hasVecTableCjs(db) {
   }
 }
 
+/**
+ * Increment recall_count and update last_recalled_at for a file in file_hashes.
+ * No-op if column missing (old DB without v0.5.3 migration).
+ * @param {import('better-sqlite3').Database} db
+ * @param {string} filePath
+ */
+const _recallColCache = new WeakMap();
+function incrementRecallCount(db, filePath) {
+  try {
+    let hasCol = _recallColCache.get(db);
+    if (hasCol === undefined) {
+      hasCol = db.pragma('table_info(file_hashes)').some(c => c.name === 'recall_count');
+      _recallColCache.set(db, hasCol);
+    }
+    if (!hasCol) return;
+    db.prepare(`
+      UPDATE file_hashes
+      SET recall_count = COALESCE(recall_count, 0) + 1,
+          last_recalled_at = ?
+      WHERE path = ?
+    `).run(new Date().toISOString(), filePath);
+  } catch (_err) { /* graceful — old DB without columns */ }
+}
+
 // --- Hook Logging (v0.5.1) ---
 
 function hookLogPath() { return path.join(globalDir(), 'diary', '_hook-log.jsonl'); }

package/hooks/mindlore-search.cjs

@@ -10,7 +10,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { getAllDbs, requireDatabase, extractHeadings, readHookStdin, extractKeywords, sanitizeKeyword, readConfig, loadSqliteVecCjs, hasVecTableCjs, hookLog } = require('./lib/mindlore-common.cjs');
+const { getAllDbs, requireDatabase, extractHeadings, readHookStdin, extractKeywords, sanitizeKeyword, readConfig, loadSqliteVecCjs, hasVecTableCjs, hookLog, incrementRecallCount } = require('./lib/mindlore-common.cjs');
 
 const MAX_RESULTS = 3;
 const MIN_QUERY_WORDS = 3;
@@ -170,6 +170,15 @@ function main() {
   const relevant = unique.slice(0, MAX_RESULTS);
   if (relevant.length === 0) return;
 
+  try {
+    const db = new Database(dbPaths[0]);
+    const txn = db.transaction(() => {
+      for (const r of relevant) incrementRecallCount(db, r.path);
+    });
+    txn();
+    db.close();
+  } catch (_e) { /* graceful — never block search output */ }
+
   // Populate headings only for final results (avoid reading extra files)
   for (const r of relevant) {
     if (r.path && r.headings.length === 0 && fs.existsSync(r.path)) {

package/hooks/mindlore-session-focus.cjs

@@ -98,6 +98,18 @@ function main() {
           if (chains.length > 0) {
             output.push(`[Mindlore Supersedes]\n${formatSupersededChains(chains)}`);
           }
+
+          // v0.5.3: Episode consolidation reminder
+          try {
+            const rawCount = db.prepare(
+              "SELECT COUNT(*) as cnt FROM episodes WHERE consolidation_status = 'raw' OR consolidation_status IS NULL"
+            ).get();
+            const cnt = rawCount?.cnt ?? 0;
+            const consolThreshold = config?.consolidation?.threshold ?? 50;
+            if (cnt >= consolThreshold) {
+              output.push(`[Mindlore] ${cnt} raw episode birikti — \`/mindlore-maintain consolidate\` ile birleştirmeyi düşün.`);
+            }
+          } catch (_err) { /* consolidation_status column may not exist yet */ }
         }
       } finally {
         db.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindlore",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "AI-native knowledge system for Claude Code",
   "type": "commonjs",
   "bin": {
@@ -18,7 +18,8 @@
     "index": "node dist/scripts/mindlore-fts5-index.js",
     "search": "node dist/scripts/mindlore-fts5-search.js",
     "quality": "node dist/scripts/quality-populate.js",
-    "fetch-raw": "node dist/scripts/fetch-raw.js"
+    "fetch-raw": "node dist/scripts/fetch-raw.js",
+    "cc-sync": "node dist/scripts/cc-memory-bulk-sync.js"
   },
   "keywords": [
     "claude-code",

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.2",
+  "version": "0.5.3",
   "skills": [
     {
       "name": "mindlore-ingest",
@@ -47,6 +47,11 @@
       "name": "mindlore-explore",
       "path": "skills/mindlore-explore/SKILL.md",
       "description": "Discover unexpected connections between knowledge sources — undirected exploration mode. Cross-references domains, sources, analyses, and episodes to find non-obvious relationships. Identifies: shared entities across sources, pattern convergence between domains, episodic evidence supporting or contradicting domain claims. Default scope: project + global (--scope project|global|all)."
+    },
+    {
+      "name": "mindlore-maintain",
+      "path": "skills/mindlore-maintain/SKILL.md",
+      "description": "KB maintenance — decay/archive stale documents, consolidate 50+ episodes into learnings/insights, detect contradictions. Modes: decay (stale doc archive with git snapshot), consolidate (episode→file promotion), contradictions (wiki-lint + semantic), restore (undo archive). Run without flags for full report."
     }
   ],
   "agents": [

package/skills/mindlore-decide/SKILL.md

@@ -2,6 +2,15 @@
 
 Record and list decisions in the `.mindlore/decisions/` directory.
 
+## Script Resolution
+
+All script paths are relative to this skill's package root.
+Package root = 2 directories up from this skill's base directory.
+
+When CC loads this skill, it shows "Base directory for this skill: /path/to/skills/mindlore-decide".
+Compute: `MINDLORE_PKG = {base_directory}/../..`
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
 ## Scope
 
 Determine target using `getActiveMindloreDir()` logic:

package/skills/mindlore-diary/SKILL.md

@@ -3,6 +3,15 @@ name: mindlore-diary
 description: LLM-powered session analysis — decisions, discoveries, frictions, learnings. Promotes episodes to semantic knowledge.
 ---
 
+## Script Resolution
+
+All script paths are relative to this skill's package root.
+Package root = 2 directories up from this skill's base directory.
+
+When CC loads this skill, it shows "Base directory for this skill: /path/to/skills/mindlore-diary".
+Compute: `MINDLORE_PKG = {base_directory}/../..`
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
 # /mindlore-diary
 
 ## Scope
@@ -18,7 +27,7 @@ Determine target using `getActiveMindloreDir()` logic:
 ## On Start — Read skill_memory
 
 ```bash
-node dist/scripts/lib/skill-memory.js get mindlore-diary last_diary_date
+node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" get mindlore-diary last_diary_date
 ```
 If last_diary_date is today, warn: "Diary already ran today. Continue anyway?"
 
@@ -64,8 +73,8 @@ If last_diary_date is today, warn: "Diary already ran today. Continue anyway?"
 ## On End — Write skill_memory
 
 ```bash
-node dist/scripts/lib/skill-memory.js set mindlore-diary last_diary_date "$(date -I)"
-node dist/scripts/lib/skill-memory.js set mindlore-diary last_episode_count "{N}"
+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}"
 ```
 
 ## Rules

package/skills/mindlore-evolve/SKILL.md

@@ -5,6 +5,15 @@ effort: medium
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
 ---
 
+## Script Resolution
+
+All script paths are relative to this skill's package root.
+Package root = 2 directories up from this skill's base directory.
+
+When CC loads this skill, it shows "Base directory for this skill: /path/to/skills/mindlore-evolve".
+Compute: `MINDLORE_PKG = {base_directory}/../..`
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
 # /mindlore-evolve
 
 Knowledge schema co-evolution. Karpathy's 4th operation (ingest/query/health/**evolve**).
@@ -30,6 +39,20 @@ User says `/mindlore-evolve`, "knowledge evolve", "bilgi sistemi evrimle", "sema
 
 Scan all domains and sources for inconsistencies.
 
+**Pre-check (before scan):**
+
+Before spawning the agent, check KB maturity:
+```bash
+# Count domains and sources
+DOMAIN_COUNT=$(ls ~/.mindlore/domains/ 2>/dev/null | grep -c '.md$' || echo 0)
+SOURCE_COUNT=$(ls ~/.mindlore/sources/ 2>/dev/null | grep -c '.md$' || echo 0)
+```
+
+If `DOMAIN_COUNT == 0`:
+- Show: "Fresh KB detected (0 domains, N sources). Evolve works best with at least 1 domain. Run `/mindlore-ingest` to add sources, then manually create domain files to organize them."
+- If `SOURCE_COUNT < 3`: Show "Too few sources for meaningful evolution scan. Add more knowledge first." and STOP.
+- If `SOURCE_COUNT >= 3` but 0 domains: Show warning but continue scan — findings will be limited to orphan/tag checks.
+
 **Agent Delegation:** Tarama işini subagent'a delege et (context koruma).
 
 **Flow:**
@@ -84,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 dist/scripts/mindlore-fts5-index.js` for FTS5 sync
+- After changes, run `node "$MINDLORE_PKG/dist/scripts/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

@@ -5,6 +5,15 @@ effort: low
 allowed-tools: [Bash, Read]
 ---
 
+## Script Resolution
+
+All script paths are relative to this skill's package root.
+Package root = 2 directories up from this skill's base directory.
+
+When CC loads this skill, it shows "Base directory for this skill: /path/to/skills/mindlore-health".
+Compute: `MINDLORE_PKG = {base_directory}/../..`
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
 # /mindlore-health
 
 Run the 16-point structural health check on the `.mindlore/` knowledge base.
@@ -25,7 +34,7 @@ User says "health check", "mindlore health", "bilgi sistemi kontrol", "saglik ko
 
 1. Run the health check script:
    ```bash
-   node scripts/mindlore-health-check.cjs
+   node "$MINDLORE_PKG/dist/scripts/mindlore-health-check.js"
    ```
 
 2. Read the output and provide LLM interpretation:

package/skills/mindlore-ingest/SKILL.md

@@ -7,6 +7,15 @@ context: fork
 agent: coder
 ---
 
+## Script Resolution
+
+All script paths are relative to this skill's package root.
+Package root = 2 directories up from this skill's base directory.
+
+When CC loads this skill, it shows "Base directory for this skill: /path/to/skills/mindlore-ingest".
+Compute: `MINDLORE_PKG = {base_directory}/../..`
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
 # /mindlore-ingest
 
 Add a new knowledge source to the `.mindlore/` knowledge base.
@@ -31,7 +40,7 @@ User shares a URL, text, file, or says "kaynak ekle", "source ingest", "bu linki
 
 **Pre-check (before fetch):**
 ```bash
-node dist/scripts/lib/skill-memory.js get mindlore-ingest last_ingest_urls
+node "$MINDLORE_PKG/dist/scripts/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?"
 
@@ -39,7 +48,7 @@ If URL already in the list, warn user: "This URL was ingested recently. Re-inges
 
 1. **Fetch raw content (zero token):**
    ```bash
-   node dist/scripts/fetch-raw.js "$URL" --out-dir "$MINDLORE_DIR/raw"
+   node "$MINDLORE_PKG/dist/scripts/fetch-raw.js" "$URL" --out-dir "$MINDLORE_DIR/raw"
    ```
    Script output: `{ "saved": "/path/to/raw/2026-04-18-abc123.md", "chars": 14823, "method": "curl" }`
 
@@ -52,13 +61,14 @@ 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
+   - `source_type` is auto-detected from URL pattern (see Source Summary Format)
    - Write to `$MINDLORE_DIR/sources/{slug}.md`
 
 4. **Update INDEX.md** with new source entry
 
 5. **Update skill_memory:**
    ```bash
-   node dist/scripts/lib/skill-memory.js set mindlore-ingest last_ingest_urls "$URL"
+   node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-ingest last_ingest_urls "$URL"
    ```
 
 6. **Return to caller (this is all the ana session sees):**
@@ -95,6 +105,16 @@ The sources/ file should contain:
 - **Relevance to project** (why this matters)
 - **Related** links to other sources/domains in .mindlore/
 
+Required frontmatter fields include `source_type` — auto-detected:
+- `github-repo` if URL contains `github.com/{owner}/{repo}` (not a file/blob URL)
+- `docs` if URL contains `/docs/`, `/documentation/`, or `/api/`
+- `blog` if URL contains `/blog/`, `/post/`, or `/article/`
+- `video` if URL contains `youtube.com`, `youtu.be`, or `vimeo.com`
+- `url-fetch` as default fallback for all other URLs
+- `text-paste` for Text Mode
+- `pdf` for PDF Mode
+- `file` for File Mode
+
 ## Quality Assessment
 
 Assign quality automatically during ingest using this heuristic:
@@ -125,7 +145,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 dist/scripts/lib/similarity.js "<title or first 100 chars>"
+   node "$MINDLORE_PKG/dist/scripts/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.
@@ -134,11 +154,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 scripts/mindlore-fts5-search.cjs "{keyword}"` returns the new file
+6. **FTS5 indexed** — FileChanged hook auto-triggers, but verify: `node "$MINDLORE_PKG/dist/scripts/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 scripts/mindlore-health-check.cjs
+node "$MINDLORE_PKG/dist/scripts/mindlore-health-check.js"
 ```

package/skills/mindlore-log/SKILL.md

@@ -2,6 +2,15 @@
 
 Session logging, pattern extraction, and wiki updates.
 
+## Script Resolution
+
+All script paths are relative to this skill's package root.
+Package root = 2 directories up from this skill's base directory.
+
+When CC loads this skill, it shows "Base directory for this skill: /path/to/skills/mindlore-log".
+Compute: `MINDLORE_PKG = {base_directory}/../..`
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
 ## Scope
 
 Determine target using `getActiveMindloreDir()` logic: