mindlore 0.0.1 → 0.1.0

package/scripts/init.cjs

@@ -14,7 +14,7 @@ const path = require('path');
 
 // ── Constants ──────────────────────────────────────────────────────────
 
-const { MINDLORE_DIR, DB_NAME, DIRECTORIES } = require('./lib/constants.cjs');
+const { MINDLORE_DIR, DB_NAME, DIRECTORIES, homedir } = require('./lib/constants.cjs');
 
 const TEMPLATE_FILES = ['INDEX.md', 'log.md'];
 
@@ -84,11 +84,51 @@ function copyTemplates(baseDir, packageRoot) {
 
 // ── Step 3: Create FTS5 database ───────────────────────────────────────
 
+function migrateDatabase(dbPath, Database) {
+  const db = new Database(dbPath);
+  try {
+    // Check if FTS5 table has the new schema (7 columns with slug, description, etc.)
+    const info = db.pragma('table_info(mindlore_fts)');
+    const columns = info.map((r) => r.name);
+    if (!columns.includes('slug') || !columns.includes('description')) {
+      log('Upgrading FTS5 schema (2 → 7 columns, porter stemmer)...');
+      db.exec('DROP TABLE IF EXISTS mindlore_fts');
+      db.exec(`
+        CREATE VIRTUAL TABLE mindlore_fts
+        USING fts5(path UNINDEXED, slug, description, type UNINDEXED, category, title, content, tokenize='porter unicode61');
+      `);
+      // Clear hashes so full re-index happens
+      db.exec('DELETE FROM file_hashes');
+      db.close();
+      return true;
+    }
+  } catch (_err) {
+    // table_info fails on FTS5 virtual tables in some versions — recreate
+    db.exec('DROP TABLE IF EXISTS mindlore_fts');
+    db.exec(`
+      CREATE VIRTUAL TABLE mindlore_fts
+      USING fts5(path UNINDEXED, slug, description, type UNINDEXED, category, title, content, tokenize='porter unicode61');
+    `);
+    db.exec('DELETE FROM file_hashes');
+    db.close();
+    return true;
+  }
+  db.close();
+  return false;
+}
+
 function createDatabase(baseDir) {
   const dbPath = path.join(baseDir, DB_NAME);
   if (fs.existsSync(dbPath)) {
-    log('Database already exists, skipping');
-    return false;
+    let Database;
+    try { Database = require('better-sqlite3'); } catch (_err) { return false; }
+    const migrated = migrateDatabase(dbPath, Database);
+    if (migrated) {
+      log('FTS5 schema upgraded — run index to rebuild');
+    } else {
+      log('Database already exists, schema OK');
+    }
+    return migrated;
   }
 
   let Database;
@@ -105,7 +145,7 @@ function createDatabase(baseDir) {
 
   db.exec(`
     CREATE VIRTUAL TABLE IF NOT EXISTS mindlore_fts
-    USING fts5(path, content, tokenize='unicode61');
+    USING fts5(path UNINDEXED, slug, description, type UNINDEXED, category, title, content, tokenize='porter unicode61');
   `);
 
   db.exec(`
@@ -124,7 +164,7 @@ function createDatabase(baseDir) {
 
 function mergeHooks(packageRoot) {
   const settingsPath = path.join(
-    require('./lib/constants.cjs').homedir(),
+    homedir(),
     '.claude',
     'settings.json'
   );
@@ -239,7 +279,59 @@ function addSchemaToProjectDocs() {
   return false;
 }
 
-// ── Step 6: Add .mindlore/ to .gitignore ───────────────────────────────
+// ── Step 6: Register skills ────────────────────────────────────────────
+
+function registerSkills(packageRoot, plugin) {
+  const skillsDir = path.join(homedir(), '.claude', 'skills');
+  ensureDir(skillsDir);
+
+  if (!plugin.skills || plugin.skills.length === 0) return 0;
+
+  let added = 0;
+  for (const skill of plugin.skills) {
+    const skillSrcDir = path.join(packageRoot, path.dirname(skill.path));
+    const skillDestDir = path.join(skillsDir, skill.name);
+
+    ensureDir(skillDestDir);
+    const entries = fs.readdirSync(skillSrcDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile()) continue;
+      fs.copyFileSync(
+        path.join(skillSrcDir, entry.name),
+        path.join(skillDestDir, entry.name)
+      );
+    }
+    added++;
+  }
+
+  return added;
+}
+
+// ── Step 7: Install better-sqlite3 if needed ──────────────────────────
+
+function ensureBetterSqlite3() {
+  try {
+    require('better-sqlite3');
+    return true;
+  } catch (_err) {
+    try {
+      const { execSync } = require('child_process');
+      log('Installing better-sqlite3 (native dependency)...');
+      execSync('npm install better-sqlite3 --no-save', {
+        cwd: process.cwd(),
+        stdio: 'pipe',
+        timeout: 120000,
+      });
+      return true;
+    } catch (_installErr) {
+      log('WARNING: Could not install better-sqlite3. FTS5 search disabled.');
+      log('  Run manually: npm install better-sqlite3');
+      return false;
+    }
+  }
+}
+
+// ── Step 8: Add .mindlore/ to .gitignore ───────────────────────────────
 
 function addToGitignore() {
   const gitignorePath = path.join(process.cwd(), '.gitignore');
@@ -263,9 +355,15 @@ function main() {
   const args = process.argv.slice(2);
   const command = args[0];
 
+  if (command === 'uninstall') {
+    require('./uninstall.cjs');
+    return;
+  }
+
   if (command && command !== 'init') {
     console.log(`Unknown command: ${command}`);
     console.log('Usage: npx mindlore init [--recommended]');
+    console.log('       npx mindlore uninstall [--all]');
     process.exit(1);
   }
 
@@ -291,11 +389,20 @@ function main() {
       : 'All templates already in place'
   );
 
-  // Step 3: Database
+  // Step 3: better-sqlite3 (before DB creation so it's available)
+  ensureBetterSqlite3();
+
+  // Step 4: Database
   const dbCreated = createDatabase(baseDir);
   log(dbCreated ? 'Created FTS5 database' : 'Database already exists');
 
-  // Step 4: Hooks
+  // Read plugin.json once for hooks + skills
+  const pluginPath = path.join(packageRoot, 'plugin.json');
+  const plugin = fs.existsSync(pluginPath)
+    ? JSON.parse(fs.readFileSync(pluginPath, 'utf8'))
+    : {};
+
+  // Step 5: Hooks
   const hooksAdded = mergeHooks(packageRoot);
   if (typeof hooksAdded === 'number' && hooksAdded > 0) {
     log(`Registered ${hooksAdded} hooks in ~/.claude/settings.json`);
@@ -303,7 +410,7 @@ function main() {
     log('Hooks already registered (or settings.json not found)');
   }
 
-  // Step 5: SCHEMA.md in projectDocFiles
+  // Step 6: SCHEMA.md in projectDocFiles
   const schemaAdded = addSchemaToProjectDocs();
   log(
     schemaAdded
@@ -311,7 +418,15 @@ function main() {
       : 'SCHEMA.md already in project settings'
   );
 
-  // Step 6: .gitignore
+  // Step 7: Skills
+  const skillsAdded = registerSkills(packageRoot, plugin);
+  log(
+    skillsAdded > 0
+      ? `Registered ${skillsAdded} skills in ~/.claude/skills/`
+      : 'Skills already registered'
+  );
+
+  // Step 8: .gitignore
   const gitignoreAdded = addToGitignore();
   log(
     gitignoreAdded

package/scripts/mindlore-fts5-index.cjs

@@ -13,7 +13,7 @@ const path = require('path');
 // ── Constants ──────────────────────────────────────────────────────────
 
 const { DB_NAME } = require('./lib/constants.cjs');
-const { sha256, getAllMdFiles } = require('../hooks/lib/mindlore-common.cjs');
+const { sha256, getAllMdFiles, openDatabase, parseFrontmatter, extractFtsMetadata, SQL_FTS_INSERT } = require('../hooks/lib/mindlore-common.cjs');
 
 // ── Main ───────────────────────────────────────────────────────────────
 
@@ -26,17 +26,12 @@ function main() {
     process.exit(1);
   }
 
-  let Database;
-  try {
-    Database = require('better-sqlite3');
-  } catch (_err) {
+  const db = openDatabase(dbPath);
+  if (!db) {
     console.error('  better-sqlite3 not installed. Run: npm install better-sqlite3');
     process.exit(1);
   }
 
-  const db = new Database(dbPath);
-  db.pragma('journal_mode = WAL');
-
   // Prepare statements
   const getHash = db.prepare('SELECT content_hash FROM file_hashes WHERE path = ?');
   const upsertHash = db.prepare(`
@@ -47,7 +42,7 @@ function main() {
       last_indexed = excluded.last_indexed
   `);
   const deleteFts = db.prepare('DELETE FROM mindlore_fts WHERE path = ?');
-  const insertFts = db.prepare('INSERT INTO mindlore_fts (path, content) VALUES (?, ?)');
+  const insertFts = db.prepare(SQL_FTS_INSERT);
 
   // Get all .md files
   const mdFiles = getAllMdFiles(baseDir);
@@ -71,8 +66,10 @@ function main() {
         }
 
         // Update FTS5
+        const { meta, body } = parseFrontmatter(content);
+        const { slug, description, type, category, title } = extractFtsMetadata(meta, body, filePath, baseDir);
         deleteFts.run(filePath);
-        insertFts.run(filePath, content);
+        insertFts.run(filePath, slug, description, type, category, title, body);
 
         // Update hash
         upsertHash.run(filePath, hash, now);

package/scripts/mindlore-fts5-search.cjs

@@ -13,6 +13,7 @@ const fs = require('fs');
 const path = require('path');
 
 const { DB_NAME } = require('./lib/constants.cjs');
+const { openDatabase } = require('../hooks/lib/mindlore-common.cjs');
 const MAX_RESULTS = 3;
 
 // ── Helpers ────────────────────────────────────────────────────────────
@@ -46,16 +47,12 @@ function main() {
     process.exit(1);
   }
 
-  let Database;
-  try {
-    Database = require('better-sqlite3');
-  } catch (_err) {
+  const db = openDatabase(dbPath, { readonly: true });
+  if (!db) {
     console.error('  better-sqlite3 not installed.');
     process.exit(1);
   }
 
-  const db = new Database(dbPath, { readonly: true });
-
   try {
     // Sanitize query for FTS5 (escape special chars)
     const sanitized = query.replace(/['"(){}[\]*:^~!]/g, ' ').trim();

package/scripts/mindlore-health-check.cjs

@@ -116,10 +116,10 @@ class HealthChecker {
       }
       const content = fs.readFileSync(indexPath, 'utf8');
       const lines = content.trim().split('\n');
-      if (lines.length > 30) {
+      if (lines.length > 60) {
         return {
           warn: true,
-          detail: `${lines.length} lines (should be ~15-20, consider trimming)`,
+          detail: `${lines.length} lines (should be ~15-60, consider trimming)`,
         };
       }
       return { ok: true, detail: `${lines.length} lines` };
@@ -147,9 +147,25 @@ class HealthChecker {
         const hashResult = db
           .prepare('SELECT count(*) as cnt FROM file_hashes')
           .get();
+
+        // Verify 7-column schema (slug, description, type, category, title, content + path)
+        let schemaOk = true;
+        try {
+          db.prepare('SELECT slug, description, category, title FROM mindlore_fts LIMIT 0').run();
+        } catch (_err) {
+          schemaOk = false;
+        }
+
+        if (!schemaOk) {
+          return {
+            warn: true,
+            detail: `${result.cnt} indexed, ${hashResult.cnt} hashes — OLD SCHEMA (run: npx mindlore init to upgrade)`,
+          };
+        }
+
         return {
           ok: true,
-          detail: `${result.cnt} indexed, ${hashResult.cnt} hashes`,
+          detail: `${result.cnt} indexed, ${hashResult.cnt} hashes, 7-col schema`,
         };
       } catch (err) {
         return { ok: false, detail: `FTS5 error: ${err.message}` };

package/scripts/uninstall.cjs

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * mindlore uninstall — Remove Mindlore hooks, skills, and optionally project data.
+ *
+ * Usage: npx mindlore uninstall [--all]
+ *
+ * --all: also remove .mindlore/ project data (without flag, only hooks + skills)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { homedir } = require('./lib/constants.cjs');
+
+function log(msg) {
+  console.log(`  ${msg}`);
+}
+
+// ── Remove hooks from settings.json ────────────────────────────────────
+
+function removeHooks() {
+  const settingsPath = path.join(homedir(), '.claude', 'settings.json');
+
+  if (!fs.existsSync(settingsPath)) {
+    log('No settings.json found, skipping hooks');
+    return 0;
+  }
+
+  let settings;
+  try {
+    settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+  } catch (_err) {
+    log('Could not parse settings.json, skipping hooks');
+    return 0;
+  }
+
+  if (!settings.hooks) return 0;
+
+  let removed = 0;
+  for (const event of Object.keys(settings.hooks)) {
+    const entries = settings.hooks[event];
+    if (!Array.isArray(entries)) continue;
+
+    const filtered = entries.filter((entry) => {
+      const hooks = entry.hooks || [];
+      const hasMindlore = hooks.some(
+        (h) => (h.command || '').includes('mindlore-')
+      );
+      // Also check flat format (legacy)
+      const flatMindlore = (entry.command || '').includes('mindlore-');
+
+      if (hasMindlore || flatMindlore) {
+        removed++;
+        return false;
+      }
+      return true;
+    });
+
+    settings.hooks[event] = filtered;
+
+    // Clean up empty arrays
+    if (settings.hooks[event].length === 0) {
+      delete settings.hooks[event];
+    }
+  }
+
+  if (removed > 0) {
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+  }
+
+  return removed;
+}
+
+// ── Remove skills from ~/.claude/skills/ ───────────────────────────────
+
+function removeSkills() {
+  const skillsDir = path.join(homedir(), '.claude', 'skills');
+  if (!fs.existsSync(skillsDir)) return 0;
+
+  const mindloreSkills = fs
+    .readdirSync(skillsDir)
+    .filter((d) => d.startsWith('mindlore-'));
+
+  let removed = 0;
+  for (const skill of mindloreSkills) {
+    const skillPath = path.join(skillsDir, skill);
+    fs.rmSync(skillPath, { recursive: true, force: true });
+    removed++;
+  }
+
+  return removed;
+}
+
+// ── Remove SCHEMA.md from projectDocFiles ──────────────────────────────
+
+function removeFromProjectDocs() {
+  const projectSettingsPath = path.join(process.cwd(), '.claude', 'settings.json');
+  if (!fs.existsSync(projectSettingsPath)) return false;
+
+  let settings;
+  try {
+    settings = JSON.parse(fs.readFileSync(projectSettingsPath, 'utf8'));
+  } catch (_err) {
+    return false;
+  }
+
+  if (!settings.projectDocFiles) return false;
+
+  const before = settings.projectDocFiles.length;
+  settings.projectDocFiles = settings.projectDocFiles.filter(
+    (p) => !p.includes('mindlore')
+  );
+
+  if (settings.projectDocFiles.length < before) {
+    fs.writeFileSync(
+      projectSettingsPath,
+      JSON.stringify(settings, null, 2),
+      'utf8'
+    );
+    return true;
+  }
+  return false;
+}
+
+// ── Remove .mindlore/ project data ─────────────────────────────────────
+
+function removeProjectData() {
+  const mindloreDir = path.join(process.cwd(), '.mindlore');
+  if (!fs.existsSync(mindloreDir)) {
+    log('No .mindlore/ directory in current project');
+    return false;
+  }
+
+  fs.rmSync(mindloreDir, { recursive: true, force: true });
+  return true;
+}
+
+// ── Main ───────────────────────────────────────────────────────────────
+
+function main() {
+  const args = process.argv.slice(2);
+  const removeAll = args.includes('--all');
+
+  console.log('\n  Mindlore — Uninstall\n');
+
+  // Hooks
+  const hooksRemoved = removeHooks();
+  log(
+    hooksRemoved > 0
+      ? `Removed ${hooksRemoved} hooks from ~/.claude/settings.json`
+      : 'No hooks found'
+  );
+
+  // Skills
+  const skillsRemoved = removeSkills();
+  log(
+    skillsRemoved > 0
+      ? `Removed ${skillsRemoved} skills from ~/.claude/skills/`
+      : 'No skills found'
+  );
+
+  // Project doc files
+  const docsRemoved = removeFromProjectDocs();
+  log(
+    docsRemoved
+      ? 'Removed SCHEMA.md from project settings'
+      : 'No project doc references found'
+  );
+
+  // Project data (only with --all)
+  if (removeAll) {
+    const dataRemoved = removeProjectData();
+    log(
+      dataRemoved
+        ? 'Removed .mindlore/ project data'
+        : 'No .mindlore/ directory found'
+    );
+  } else {
+    log('.mindlore/ project data kept (use --all to remove)');
+  }
+
+  console.log('\n  Done! Mindlore has been uninstalled.\n');
+}
+
+main();