mindlore 0.2.0 → 0.3.0

package/scripts/mindlore-fts5-search.cjs

@@ -1,119 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * mindlore-fts5-search — Search .mindlore/ knowledge base via FTS5.
- *
- * Usage: node scripts/mindlore-fts5-search.cjs "query" [path-to-mindlore-dir]
- *
- * Returns top 3 results ranked by BM25 with file path and snippet.
- */
-
-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 ────────────────────────────────────────────────────────────
-
-function extractHeadings(content, maxHeadings) {
-  const lines = content.split('\n');
-  const headings = [];
-  for (const line of lines) {
-    if (line.startsWith('#')) {
-      headings.push(line.replace(/^#+\s*/, '').trim());
-      if (headings.length >= maxHeadings) break;
-    }
-  }
-  return headings;
-}
-
-// ── Main ───────────────────────────────────────────────────────────────
-
-function main() {
-  const query = process.argv[2];
-  if (!query) {
-    console.error('Usage: node mindlore-fts5-search.cjs "query" [mindlore-dir]');
-    process.exit(1);
-  }
-
-  const baseDir = process.argv[3] || path.join(process.cwd(), '.mindlore');
-  const dbPath = path.join(baseDir, DB_NAME);
-
-  if (!fs.existsSync(dbPath)) {
-    console.error('  Database not found. Run: npx mindlore init && npm run index');
-    process.exit(1);
-  }
-
-  const db = openDatabase(dbPath, { readonly: true });
-  if (!db) {
-    console.error('  better-sqlite3 not installed.');
-    process.exit(1);
-  }
-
-  try {
-    // Sanitize query for FTS5 (escape special chars)
-    const sanitized = query.replace(/['"(){}[\]*:^~!]/g, ' ').trim();
-    if (!sanitized) {
-      console.log('  No valid search terms.');
-      process.exit(0);
-    }
-
-    const results = db
-      .prepare(
-        `SELECT path, snippet(mindlore_fts, 1, '>>>', '<<<', '...', 40) as snippet,
-                rank
-         FROM mindlore_fts
-         WHERE mindlore_fts MATCH ?
-         ORDER BY rank
-         LIMIT ?`
-      )
-      .all(sanitized, MAX_RESULTS);
-
-    if (results.length === 0) {
-      console.log(`  No results for: "${query}"`);
-      process.exit(0);
-    }
-
-    console.log(`\n  Mindlore Search: "${query}" (${results.length} results)\n`);
-
-    for (let i = 0; i < results.length; i++) {
-      const r = results[i];
-      const relativePath = path.relative(baseDir, r.path);
-      const fileName = path.basename(r.path, '.md');
-
-      // Try to get headings from the actual file
-      let headings = [];
-      if (fs.existsSync(r.path)) {
-        const content = fs.readFileSync(r.path, 'utf8');
-        headings = extractHeadings(content, 2);
-      }
-
-      console.log(`  ${i + 1}. ${relativePath}`);
-      if (headings.length > 0) {
-        console.log(`     ${headings.join(' > ')}`);
-      }
-      console.log(`     ${r.snippet || fileName}`);
-      console.log('');
-    }
-  } catch (err) {
-    // FTS5 query syntax error — try simpler query
-    if (err.message.includes('fts5')) {
-      const words = query.split(/\s+/).filter((w) => w.length >= 2);
-      if (words.length > 0) {
-        console.error(`  Search syntax error. Try simpler terms: ${words.join(' ')}`);
-      } else {
-        console.error(`  Search error: ${err.message}`);
-      }
-    } else {
-      console.error(`  Error: ${err.message}`);
-    }
-    process.exit(1);
-  } finally {
-    db.close();
-  }
-}
-
-main();

package/scripts/mindlore-health-check.cjs

@@ -1,389 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * mindlore-health-check — 16-point structural health check for .mindlore/
- *
- * Usage: node scripts/mindlore-health-check.cjs [path-to-mindlore-dir]
- *
- * Exit codes: 0 = healthy, 1 = issues found
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ── Constants ──────────────────────────────────────────────────────────
-
-const { DIRECTORIES, TYPE_TO_DIR } = require('./lib/constants.cjs');
-const { parseFrontmatter: _parseFm, getAllMdFiles: _getAllMd } = require('../hooks/lib/mindlore-common.cjs');
-
-// ── Helpers ────────────────────────────────────────────────────────────
-
-// Wrapper: shared parseFrontmatter returns { meta, body }, health-check expects flat object or null
-function parseFrontmatter(content) {
-  const { meta } = _parseFm(content);
-  return Object.keys(meta).length > 0 ? meta : null;
-}
-
-// Health check needs ALL .md files (no skip), so pass empty set
-function getAllMdFiles(dir) {
-  return _getAllMd(dir, new Set());
-}
-
-// ── Checks ─────────────────────────────────────────────────────────────
-
-class HealthChecker {
-  constructor(baseDir) {
-    this.baseDir = baseDir;
-    this.results = [];
-    this.passed = 0;
-    this.failed = 0;
-    this.warnings = 0;
-  }
-
-  check(name, fn) {
-    try {
-      const result = fn();
-      if (result.ok) {
-        this.passed++;
-        this.results.push({ name, status: 'PASS', detail: result.detail });
-      } else if (result.warn) {
-        this.warnings++;
-        this.results.push({ name, status: 'WARN', detail: result.detail });
-      } else {
-        this.failed++;
-        this.results.push({ name, status: 'FAIL', detail: result.detail });
-      }
-    } catch (err) {
-      this.failed++;
-      this.results.push({ name, status: 'FAIL', detail: err.message });
-    }
-  }
-
-  // Check 1-9: Directory existence
-  checkDirectories() {
-    for (const dir of DIRECTORIES) {
-      this.check(`Directory: ${dir}/`, () => {
-        const dirPath = path.join(this.baseDir, dir);
-        if (fs.existsSync(dirPath)) {
-          return { ok: true, detail: 'exists' };
-        }
-        return { ok: false, detail: 'missing' };
-      });
-    }
-  }
-
-  // Check 10: SCHEMA.md parseable
-  checkSchema() {
-    this.check('SCHEMA.md', () => {
-      const schemaPath = path.join(this.baseDir, 'SCHEMA.md');
-      if (!fs.existsSync(schemaPath)) {
-        return { ok: false, detail: 'missing' };
-      }
-      const content = fs.readFileSync(schemaPath, 'utf8');
-      if (content.length < 100) {
-        return { ok: false, detail: 'too short (corrupted?)' };
-      }
-      if (!content.includes('## 1. Identity')) {
-        return { warn: true, detail: 'may be outdated (missing Identity section)' };
-      }
-      return { ok: true, detail: `${content.split('\n').length} lines` };
-    });
-  }
-
-  // Check 11: INDEX.md format
-  checkIndex() {
-    this.check('INDEX.md format', () => {
-      const indexPath = path.join(this.baseDir, 'INDEX.md');
-      if (!fs.existsSync(indexPath)) {
-        return { ok: false, detail: 'missing' };
-      }
-      const content = fs.readFileSync(indexPath, 'utf8');
-      const lines = content.trim().split('\n');
-      if (lines.length > 60) {
-        return {
-          warn: true,
-          detail: `${lines.length} lines (should be ~15-60, consider trimming)`,
-        };
-      }
-      return { ok: true, detail: `${lines.length} lines` };
-    });
-  }
-
-  // Check 12: Database integrity
-  checkDatabase() {
-    this.check('mindlore.db FTS5', () => {
-      const dbPath = path.join(this.baseDir, 'mindlore.db');
-      if (!fs.existsSync(dbPath)) {
-        return { ok: false, detail: 'database missing' };
-      }
-
-      let Database;
-      try {
-        Database = require('better-sqlite3');
-      } catch (_err) {
-        return { warn: true, detail: 'better-sqlite3 not available, cannot verify' };
-      }
-
-      const db = new Database(dbPath, { readonly: true });
-      try {
-        const result = db.prepare('SELECT count(*) as cnt FROM mindlore_fts').get();
-        const hashResult = db
-          .prepare('SELECT count(*) as cnt FROM file_hashes')
-          .get();
-
-        // Verify 9-column schema (slug, description, type, category, title, content, tags, quality + path)
-        let schemaVersion = 0;
-        try {
-          db.prepare('SELECT tags, quality FROM mindlore_fts LIMIT 0').run();
-          schemaVersion = 9;
-        } catch (_err) {
-          try {
-            db.prepare('SELECT slug, description, category, title FROM mindlore_fts LIMIT 0').run();
-            schemaVersion = 7;
-          } catch (_err2) {
-            schemaVersion = 2;
-          }
-        }
-
-        if (schemaVersion < 9) {
-          return {
-            warn: true,
-            detail: `${result.cnt} indexed, ${hashResult.cnt} hashes — ${schemaVersion}-col schema (run: npx mindlore init to upgrade to 9-col)`,
-          };
-        }
-
-        return {
-          ok: true,
-          detail: `${result.cnt} indexed, ${hashResult.cnt} hashes, 9-col schema`,
-        };
-      } catch (err) {
-        return { ok: false, detail: `FTS5 error: ${err.message}` };
-      } finally {
-        db.close();
-      }
-    });
-  }
-
-  // Check 13: Orphan files (in .mindlore/ but not in FTS5)
-  checkOrphans() {
-    this.check('Orphan files', () => {
-      const dbPath = path.join(this.baseDir, 'mindlore.db');
-      if (!fs.existsSync(dbPath)) {
-        return { warn: true, detail: 'no database, cannot check' };
-      }
-
-      let Database;
-      try {
-        Database = require('better-sqlite3');
-      } catch (_err) {
-        return { warn: true, detail: 'better-sqlite3 not available' };
-      }
-
-      const mdFiles = getAllMdFiles(this.baseDir).filter(
-        (f) =>
-          !f.endsWith('INDEX.md') &&
-          !f.endsWith('SCHEMA.md') &&
-          !f.endsWith('log.md')
-      );
-
-      const db = new Database(dbPath, { readonly: true });
-      try {
-        const indexed = new Set();
-        const rows = db.prepare('SELECT path FROM file_hashes').all();
-        for (const row of rows) {
-          indexed.add(path.resolve(row.path));
-        }
-
-        const orphans = mdFiles.filter(
-          (f) => !indexed.has(path.resolve(f))
-        );
-
-        if (orphans.length === 0) {
-          return { ok: true, detail: 'no orphans' };
-        }
-        if (orphans.length <= 3) {
-          return {
-            warn: true,
-            detail: `${orphans.length} unindexed: ${orphans.map((f) => path.basename(f)).join(', ')}`,
-          };
-        }
-        return {
-          ok: false,
-          detail: `${orphans.length} unindexed files — run: npm run index`,
-        };
-      } finally {
-        db.close();
-      }
-    });
-  }
-
-  // Check 14-16: Frontmatter validation
-  checkFrontmatter() {
-    this.check('Frontmatter: slug + type', () => {
-      const mdFiles = getAllMdFiles(this.baseDir).filter(
-        (f) =>
-          !f.endsWith('INDEX.md') &&
-          !f.endsWith('SCHEMA.md') &&
-          !f.endsWith('log.md')
-      );
-
-      let missingSlug = 0;
-      let missingType = 0;
-      let wrongDir = 0;
-
-      for (const file of mdFiles) {
-        const content = fs.readFileSync(file, 'utf8').replace(/\r\n/g, '\n');
-        const fm = parseFrontmatter(content);
-
-        if (!fm) {
-          missingSlug++;
-          missingType++;
-          continue;
-        }
-
-        if (!fm.slug) missingSlug++;
-        if (!fm.type) {
-          missingType++;
-          continue;
-        }
-
-        // Check type-directory match
-        const expectedDir = TYPE_TO_DIR[fm.type];
-        if (expectedDir) {
-          const parentDir = path.basename(path.dirname(file));
-          if (parentDir !== expectedDir) {
-            wrongDir++;
-          }
-        }
-      }
-
-      const issues = [];
-      if (missingSlug > 0) issues.push(`${missingSlug} missing slug`);
-      if (missingType > 0) issues.push(`${missingType} missing type`);
-      if (wrongDir > 0) issues.push(`${wrongDir} type-dir mismatch`);
-
-      if (issues.length === 0) {
-        return {
-          ok: true,
-          detail: `${mdFiles.length} files validated`,
-        };
-      }
-      if (wrongDir > 0) {
-        return { ok: false, detail: issues.join(', ') };
-      }
-      return { warn: true, detail: issues.join(', ') };
-    });
-  }
-
-  // Check 17: Stale deltas (30+ days without archived: true)
-  checkStaleDeltas() {
-    this.check('Stale deltas', () => {
-      const diaryDir = path.join(this.baseDir, 'diary');
-      if (!fs.existsSync(diaryDir)) return { ok: true, detail: 'no diary dir' };
-
-      const now = Date.now();
-      const thirtyDays = 30 * 24 * 60 * 60 * 1000;
-      let stale = 0;
-
-      const files = fs.readdirSync(diaryDir).filter((f) => f.startsWith('delta-') && f.endsWith('.md'));
-      for (const file of files) {
-        const fullPath = path.join(diaryDir, file);
-        const content = fs.readFileSync(fullPath, 'utf8').replace(/\r\n/g, '\n');
-        const fm = parseFrontmatter(content);
-        if (fm && fm.archived === 'true') continue;
-
-        const stat = fs.statSync(fullPath);
-        if (now - stat.mtimeMs > thirtyDays) stale++;
-      }
-
-      if (stale === 0) return { ok: true, detail: `${files.length} deltas, none stale` };
-      return { warn: true, detail: `${stale} deltas older than 30 days without archived flag — run /mindlore-log reflect` };
-    });
-  }
-
-  // Check 18: Conflicting analyses (same tags, different confidence)
-  checkConflictingAnalyses() {
-    this.check('Conflicting analyses', () => {
-      const analysesDir = path.join(this.baseDir, 'analyses');
-      if (!fs.existsSync(analysesDir)) return { ok: true, detail: 'no analyses dir' };
-
-      const files = fs.readdirSync(analysesDir).filter((f) => f.endsWith('.md'));
-      if (files.length < 2) return { ok: true, detail: `${files.length} analyses, no conflict possible` };
-
-      const tagMap = {};
-      for (const file of files) {
-        const content = fs.readFileSync(path.join(analysesDir, file), 'utf8').replace(/\r\n/g, '\n');
-        const fm = parseFrontmatter(content);
-        if (!fm || !fm.tags || !fm.confidence) continue;
-
-        const tags = Array.isArray(fm.tags) ? fm.tags : String(fm.tags).split(',').map((t) => t.trim());
-        for (const tag of tags) {
-          if (!tagMap[tag]) tagMap[tag] = [];
-          tagMap[tag].push({ file, confidence: fm.confidence });
-        }
-      }
-
-      const conflicts = [];
-      for (const [tag, entries] of Object.entries(tagMap)) {
-        if (entries.length < 2) continue;
-        const confidences = new Set(entries.map((e) => e.confidence));
-        if (confidences.size > 1) {
-          conflicts.push(`${tag}: ${entries.map((e) => `${e.file}(${e.confidence})`).join(' vs ')}`);
-        }
-      }
-
-      if (conflicts.length === 0) return { ok: true, detail: `${files.length} analyses, no conflicts` };
-      return { warn: true, detail: `${conflicts.length} tag conflicts: ${conflicts.slice(0, 2).join('; ')}` };
-    });
-  }
-
-  // ── Run all ────────────────────────────────────────────────────────
-
-  run() {
-    this.checkDirectories();
-    this.checkSchema();
-    this.checkIndex();
-    this.checkDatabase();
-    this.checkOrphans();
-    this.checkFrontmatter();
-    this.checkStaleDeltas();
-    this.checkConflictingAnalyses();
-    return this;
-  }
-
-  report() {
-    console.log('\n  Mindlore Health Check\n');
-
-    for (const r of this.results) {
-      const icon =
-        r.status === 'PASS' ? '+' : r.status === 'WARN' ? '~' : '-';
-      console.log(`  [${icon}] ${r.name}: ${r.detail}`);
-    }
-
-    const total = this.passed + this.failed + this.warnings;
-    console.log(
-      `\n  Score: ${this.passed}/${total} passed, ${this.warnings} warnings, ${this.failed} failed\n`
-    );
-
-    return this.failed === 0;
-  }
-}
-
-// ── Main ───────────────────────────────────────────────────────────────
-
-function main() {
-  const baseDir = process.argv[2] || path.join(process.cwd(), '.mindlore');
-
-  if (!fs.existsSync(baseDir)) {
-    console.error(`  .mindlore/ not found at: ${baseDir}`);
-    console.error('  Run: npx mindlore init');
-    process.exit(1);
-  }
-
-  const checker = new HealthChecker(baseDir);
-  const healthy = checker.run().report();
-  process.exit(healthy ? 0 : 1);
-}
-
-main();

package/scripts/uninstall.cjs

@@ -1,186 +0,0 @@
-#!/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();