@velvetmonkey/vault-core 2.0.136 → 2.0.138

package/dist/sqlite.js

@@ -11,639 +11,17 @@
  */
 import Database from 'better-sqlite3';
 import * as fs from 'fs';
-import * as path from 'path';
+// Re-export constants from schema
+export { SCHEMA_VERSION, STATE_DB_FILENAME, FLYWHEEL_DIR, SCHEMA_SQL } from './schema.js';
+// Re-export migrations
+export { getStateDbPath, initSchema, deleteStateDbFiles, backupStateDb, preserveCorruptedDb } from './migrations.js';
+// Re-export all query functions
+export { searchEntities, searchEntitiesPrefix, getEntityByName, getAllEntitiesFromDb, getEntityIndexFromDb, getEntitiesByAlias, recordEntityMention, getEntityRecency, getAllRecency, setWriteState, getWriteState, deleteWriteState, setFlywheelConfig, getFlywheelConfig, getAllFlywheelConfig, deleteFlywheelConfig, saveFlywheelConfigToDb, loadFlywheelConfigFromDb, recordMergeDismissal, getDismissedMergePairs, getStateDbMetadata, isEntityDataStale, escapeFts5Query, rebuildEntitiesFts, stateDbExists, deleteStateDb, saveVaultIndexCache, loadVaultIndexCache, getVaultIndexCacheInfo, clearVaultIndexCache, isVaultIndexCacheValid, loadContentHashes, saveContentHashBatch, renameContentHash, } from './queries.js';
+// Import for use in openStateDb
+import { getStateDbPath, initSchema, deleteStateDbFiles, backupStateDb, preserveCorruptedDb } from './migrations.js';
 // =============================================================================
-// Constants
+// Factory
 // =============================================================================
-/** Current schema version - bump when schema changes */
-export const SCHEMA_VERSION = 31;
-/** State database filename */
-export const STATE_DB_FILENAME = 'state.db';
-/** Directory for flywheel state */
-export const FLYWHEEL_DIR = '.flywheel';
-// =============================================================================
-// Schema
-// =============================================================================
-const SCHEMA_SQL = `
--- Schema version tracking
-CREATE TABLE IF NOT EXISTS schema_version (
-  version INTEGER PRIMARY KEY,
-  applied_at TEXT DEFAULT (datetime('now'))
-);
-
--- Metadata key-value store
-CREATE TABLE IF NOT EXISTS metadata (
-  key TEXT PRIMARY KEY,
-  value TEXT NOT NULL,
-  updated_at TEXT DEFAULT (datetime('now'))
-);
-
--- Entity index (replaces wikilink-entities.json)
-CREATE TABLE IF NOT EXISTS entities (
-  id INTEGER PRIMARY KEY,
-  name TEXT NOT NULL,
-  name_lower TEXT NOT NULL,
-  path TEXT NOT NULL,
-  category TEXT NOT NULL,
-  aliases_json TEXT,
-  hub_score INTEGER DEFAULT 0,
-  description TEXT
-);
-CREATE INDEX IF NOT EXISTS idx_entities_name_lower ON entities(name_lower);
-CREATE INDEX IF NOT EXISTS idx_entities_category ON entities(category);
-
--- FTS5 for entity search with porter stemmer
-CREATE VIRTUAL TABLE IF NOT EXISTS entities_fts USING fts5(
-  name, aliases, category,
-  content='entities', content_rowid='id',
-  tokenize='porter unicode61'
-);
-
--- Auto-sync triggers for entities_fts
-CREATE TRIGGER IF NOT EXISTS entities_ai AFTER INSERT ON entities BEGIN
-  INSERT INTO entities_fts(rowid, name, aliases, category)
-  VALUES (
-    new.id,
-    new.name,
-    COALESCE((SELECT group_concat(value, ' ') FROM json_each(new.aliases_json)), ''),
-    new.category
-  );
-END;
-
-CREATE TRIGGER IF NOT EXISTS entities_ad AFTER DELETE ON entities BEGIN
-  INSERT INTO entities_fts(entities_fts, rowid, name, aliases, category)
-  VALUES (
-    'delete',
-    old.id,
-    old.name,
-    COALESCE((SELECT group_concat(value, ' ') FROM json_each(old.aliases_json)), ''),
-    old.category
-  );
-END;
-
-CREATE TRIGGER IF NOT EXISTS entities_au AFTER UPDATE ON entities BEGIN
-  INSERT INTO entities_fts(entities_fts, rowid, name, aliases, category)
-  VALUES (
-    'delete',
-    old.id,
-    old.name,
-    COALESCE((SELECT group_concat(value, ' ') FROM json_each(old.aliases_json)), ''),
-    old.category
-  );
-  INSERT INTO entities_fts(rowid, name, aliases, category)
-  VALUES (
-    new.id,
-    new.name,
-    COALESCE((SELECT group_concat(value, ' ') FROM json_each(new.aliases_json)), ''),
-    new.category
-  );
-END;
-
--- Recency tracking (replaces entity-recency.json)
-CREATE TABLE IF NOT EXISTS recency (
-  entity_name_lower TEXT PRIMARY KEY,
-  last_mentioned_at INTEGER NOT NULL,
-  mention_count INTEGER DEFAULT 1
-);
-
--- Write state (replaces last-commit.json and other write state)
-CREATE TABLE IF NOT EXISTS write_state (
-  key TEXT PRIMARY KEY,
-  value TEXT NOT NULL,
-  updated_at TEXT DEFAULT (datetime('now'))
-);
-
--- Content search FTS5 (migrated from vault-search.db)
--- v11: Added frontmatter column for weighted search (path, title, frontmatter, content)
-CREATE VIRTUAL TABLE IF NOT EXISTS notes_fts USING fts5(
-  path, title, frontmatter, content,
-  tokenize='porter'
-);
-
--- FTS5 build metadata (consolidated from vault-search.db)
-CREATE TABLE IF NOT EXISTS fts_metadata (
-  key TEXT PRIMARY KEY,
-  value TEXT
-);
-
--- Vault index cache (for fast startup)
--- Stores serialized VaultIndex to avoid full rebuild on startup
-CREATE TABLE IF NOT EXISTS vault_index_cache (
-  id INTEGER PRIMARY KEY CHECK (id = 1),
-  data BLOB NOT NULL,
-  built_at INTEGER NOT NULL,
-  note_count INTEGER NOT NULL,
-  version INTEGER DEFAULT 1
-);
-
--- Flywheel configuration (replaces .flywheel.json)
-CREATE TABLE IF NOT EXISTS flywheel_config (
-  key TEXT PRIMARY KEY,
-  value TEXT NOT NULL,
-  updated_at TEXT DEFAULT (datetime('now'))
-);
-
--- Vault metrics (v4: growth tracking)
-CREATE TABLE IF NOT EXISTS vault_metrics (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  timestamp INTEGER NOT NULL,
-  metric TEXT NOT NULL,
-  value REAL NOT NULL
-);
-CREATE INDEX IF NOT EXISTS idx_vault_metrics_ts ON vault_metrics(timestamp);
-CREATE INDEX IF NOT EXISTS idx_vault_metrics_m ON vault_metrics(metric, timestamp);
-
--- Wikilink feedback (v4: quality tracking)
-CREATE TABLE IF NOT EXISTS wikilink_feedback (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  entity TEXT NOT NULL,
-  context TEXT NOT NULL,
-  note_path TEXT NOT NULL,
-  correct INTEGER NOT NULL,
-  confidence REAL NOT NULL DEFAULT 1.0,
-  created_at TEXT DEFAULT (datetime('now'))
-);
-CREATE INDEX IF NOT EXISTS idx_wl_feedback_entity ON wikilink_feedback(entity);
-CREATE INDEX IF NOT EXISTS idx_wl_feedback_note_path ON wikilink_feedback(note_path);
-
--- Wikilink suppressions (v4: auto-suppress false positives)
-CREATE TABLE IF NOT EXISTS wikilink_suppressions (
-  entity TEXT PRIMARY KEY,
-  false_positive_rate REAL NOT NULL,
-  updated_at TEXT DEFAULT (datetime('now'))
-);
-
--- Wikilink applications tracking (v5: implicit feedback)
-CREATE TABLE IF NOT EXISTS wikilink_applications (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  entity TEXT NOT NULL,
-  note_path TEXT NOT NULL,
-  applied_at TEXT DEFAULT (datetime('now')),
-  status TEXT DEFAULT 'applied'
-);
-CREATE UNIQUE INDEX IF NOT EXISTS idx_wl_apps_unique ON wikilink_applications(entity COLLATE NOCASE, note_path);
-
--- Index events tracking (v6: index activity history)
-CREATE TABLE IF NOT EXISTS index_events (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  timestamp INTEGER NOT NULL,
-  trigger TEXT NOT NULL,
-  duration_ms INTEGER NOT NULL,
-  success INTEGER NOT NULL DEFAULT 1,
-  note_count INTEGER,
-  files_changed INTEGER,
-  changed_paths TEXT,
-  error TEXT,
-  steps TEXT
-);
-CREATE INDEX IF NOT EXISTS idx_index_events_ts ON index_events(timestamp);
-
--- Tool invocation tracking (v7: usage analytics)
-CREATE TABLE IF NOT EXISTS tool_invocations (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  timestamp INTEGER NOT NULL,
-  tool_name TEXT NOT NULL,
-  session_id TEXT,
-  note_paths TEXT,
-  duration_ms INTEGER,
-  success INTEGER NOT NULL DEFAULT 1,
-  response_tokens INTEGER,
-  baseline_tokens INTEGER
-);
-CREATE INDEX IF NOT EXISTS idx_tool_inv_ts ON tool_invocations(timestamp);
-CREATE INDEX IF NOT EXISTS idx_tool_inv_tool ON tool_invocations(tool_name, timestamp);
-CREATE INDEX IF NOT EXISTS idx_tool_inv_session ON tool_invocations(session_id, timestamp);
-
--- Graph topology snapshots (v8: structural evolution)
-CREATE TABLE IF NOT EXISTS graph_snapshots (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  timestamp INTEGER NOT NULL,
-  metric TEXT NOT NULL,
-  value REAL NOT NULL,
-  details TEXT
-);
-CREATE INDEX IF NOT EXISTS idx_graph_snap_ts ON graph_snapshots(timestamp);
-CREATE INDEX IF NOT EXISTS idx_graph_snap_m ON graph_snapshots(metric, timestamp);
-
--- Note embeddings for semantic search (v9)
-CREATE TABLE IF NOT EXISTS note_embeddings (
-  path TEXT PRIMARY KEY,
-  embedding BLOB NOT NULL,
-  content_hash TEXT NOT NULL,
-  model TEXT NOT NULL,
-  updated_at INTEGER NOT NULL
-);
-
--- Entity embeddings for semantic entity search (v10)
-CREATE TABLE IF NOT EXISTS entity_embeddings (
-  entity_name TEXT PRIMARY KEY,
-  embedding BLOB NOT NULL,
-  source_hash TEXT NOT NULL,
-  model TEXT NOT NULL,
-  updated_at INTEGER NOT NULL
-);
-
--- Task cache for fast task queries (v12)
-CREATE TABLE IF NOT EXISTS tasks (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  path TEXT NOT NULL,
-  line INTEGER NOT NULL,
-  text TEXT NOT NULL,
-  status TEXT NOT NULL,
-  raw TEXT NOT NULL,
-  context TEXT,
-  tags_json TEXT,
-  due_date TEXT,
-  UNIQUE(path, line)
-);
-CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
-CREATE INDEX IF NOT EXISTS idx_tasks_path ON tasks(path);
-CREATE INDEX IF NOT EXISTS idx_tasks_due ON tasks(due_date);
-
--- Merge dismissals (v13: persistent merge pair suppression)
-CREATE TABLE IF NOT EXISTS merge_dismissals (
-  pair_key TEXT PRIMARY KEY,
-  source_path TEXT NOT NULL,
-  target_path TEXT NOT NULL,
-  source_name TEXT NOT NULL,
-  target_name TEXT NOT NULL,
-  reason TEXT NOT NULL,
-  dismissed_at TEXT DEFAULT (datetime('now'))
-);
-
--- Suggestion events audit log (v15: pipeline observability)
-CREATE TABLE IF NOT EXISTS suggestion_events (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  timestamp INTEGER NOT NULL,
-  note_path TEXT NOT NULL,
-  entity TEXT NOT NULL,
-  total_score REAL NOT NULL,
-  breakdown_json TEXT NOT NULL,
-  threshold REAL NOT NULL,
-  passed INTEGER NOT NULL,
-  strictness TEXT NOT NULL,
-  applied INTEGER DEFAULT 0,
-  pipeline_event_id INTEGER,
-  UNIQUE(timestamp, note_path, entity)
-);
-CREATE INDEX IF NOT EXISTS idx_suggestion_entity ON suggestion_events(entity);
-CREATE INDEX IF NOT EXISTS idx_suggestion_note ON suggestion_events(note_path);
-
--- Forward-link persistence for diff-based feedback (v16), edge weights (v22)
-CREATE TABLE IF NOT EXISTS note_links (
-  note_path TEXT NOT NULL,
-  target TEXT NOT NULL,
-  weight REAL NOT NULL DEFAULT 1.0,
-  weight_updated_at INTEGER,
-  PRIMARY KEY (note_path, target)
-);
-
--- Entity field change audit log (v17)
-CREATE TABLE IF NOT EXISTS entity_changes (
-  entity TEXT NOT NULL,
-  field TEXT NOT NULL,
-  old_value TEXT,
-  new_value TEXT,
-  changed_at TEXT NOT NULL DEFAULT (datetime('now')),
-  PRIMARY KEY (entity, field, changed_at)
-);
-
--- Note tag persistence for diff-based feedback (v18)
-CREATE TABLE IF NOT EXISTS note_tags (
-  note_path TEXT NOT NULL,
-  tag TEXT NOT NULL,
-  PRIMARY KEY (note_path, tag)
-);
-
--- Wikilink survival tracking for positive feedback signals (v19)
-CREATE TABLE IF NOT EXISTS note_link_history (
-  note_path TEXT NOT NULL,
-  target TEXT NOT NULL,
-  first_seen_at TEXT NOT NULL DEFAULT (datetime('now')),
-  edits_survived INTEGER NOT NULL DEFAULT 0,
-  last_positive_at TEXT,
-  PRIMARY KEY (note_path, target)
-);
-
--- Note move history (v20): records when files are moved/renamed to a different folder
-CREATE TABLE IF NOT EXISTS note_moves (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  old_path TEXT NOT NULL,
-  new_path TEXT NOT NULL,
-  moved_at TEXT NOT NULL DEFAULT (datetime('now')),
-  old_folder TEXT,
-  new_folder TEXT
-);
-CREATE INDEX IF NOT EXISTS idx_note_moves_old_path ON note_moves(old_path);
-CREATE INDEX IF NOT EXISTS idx_note_moves_new_path ON note_moves(new_path);
-CREATE INDEX IF NOT EXISTS idx_note_moves_moved_at ON note_moves(moved_at);
-
--- Corrections (v24): persistent correction records from user/engine feedback
-CREATE TABLE IF NOT EXISTS corrections (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  entity TEXT,
-  note_path TEXT,
-  correction_type TEXT NOT NULL,
-  description TEXT NOT NULL,
-  source TEXT NOT NULL DEFAULT 'user',
-  status TEXT DEFAULT 'pending',
-  created_at TEXT DEFAULT (datetime('now')),
-  resolved_at TEXT
-);
-CREATE INDEX IF NOT EXISTS idx_corrections_status ON corrections(status);
-CREATE INDEX IF NOT EXISTS idx_corrections_entity ON corrections(entity);
-
--- Memories (v26): lightweight key-value working memory for agents
-CREATE TABLE IF NOT EXISTS memories (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  key TEXT NOT NULL,
-  value TEXT NOT NULL,
-  memory_type TEXT NOT NULL,
-  entity TEXT,
-  entities_json TEXT,
-  source_agent_id TEXT,
-  source_session_id TEXT,
-  confidence REAL NOT NULL DEFAULT 1.0,
-  created_at INTEGER NOT NULL,
-  updated_at INTEGER NOT NULL,
-  accessed_at INTEGER NOT NULL,
-  ttl_days INTEGER,
-  superseded_by INTEGER REFERENCES memories(id),
-  visibility TEXT NOT NULL DEFAULT 'shared'
-);
-CREATE INDEX IF NOT EXISTS idx_memories_key ON memories(key);
-CREATE INDEX IF NOT EXISTS idx_memories_entity ON memories(entity);
-CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(memory_type);
-
-CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
-  key, value,
-  content=memories, content_rowid=id,
-  tokenize='porter unicode61'
-);
-
--- Auto-sync triggers for memories_fts
-CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
-  INSERT INTO memories_fts(rowid, key, value)
-  VALUES (new.id, new.key, new.value);
-END;
-
-CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
-  INSERT INTO memories_fts(memories_fts, rowid, key, value)
-  VALUES ('delete', old.id, old.key, old.value);
-END;
-
-CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN
-  INSERT INTO memories_fts(memories_fts, rowid, key, value)
-  VALUES ('delete', old.id, old.key, old.value);
-  INSERT INTO memories_fts(rowid, key, value)
-  VALUES (new.id, new.key, new.value);
-END;
-
--- Co-occurrence cache (v27): persist co-occurrence index to avoid full vault scan on restart
-CREATE TABLE IF NOT EXISTS cooccurrence_cache (
-  id INTEGER PRIMARY KEY CHECK (id = 1),
-  data TEXT NOT NULL,
-  built_at INTEGER NOT NULL,
-  entity_count INTEGER NOT NULL,
-  association_count INTEGER NOT NULL
-);
-
--- Content hashes (v28): persist watcher content hashes across restarts
-CREATE TABLE IF NOT EXISTS content_hashes (
-  path TEXT PRIMARY KEY,
-  hash TEXT NOT NULL,
-  updated_at INTEGER NOT NULL
-);
-
--- Session summaries (v26): agent session tracking
-CREATE TABLE IF NOT EXISTS session_summaries (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  session_id TEXT NOT NULL UNIQUE,
-  summary TEXT NOT NULL,
-  topics_json TEXT,
-  notes_modified_json TEXT,
-  agent_id TEXT,
-  started_at INTEGER,
-  ended_at INTEGER NOT NULL,
-  tool_count INTEGER
-);
-
--- Retrieval co-occurrence (v30): notes retrieved together build implicit edges
-CREATE TABLE IF NOT EXISTS retrieval_cooccurrence (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  note_a TEXT NOT NULL,
-  note_b TEXT NOT NULL,
-  session_id TEXT NOT NULL,
-  timestamp INTEGER NOT NULL,
-  weight REAL NOT NULL DEFAULT 1.0,
-  UNIQUE(note_a, note_b, session_id)
-);
-CREATE INDEX IF NOT EXISTS idx_retcooc_notes ON retrieval_cooccurrence(note_a, note_b);
-CREATE INDEX IF NOT EXISTS idx_retcooc_ts ON retrieval_cooccurrence(timestamp);
-
--- Deferred proactive linking queue (v31)
-CREATE TABLE IF NOT EXISTS proactive_queue (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  note_path TEXT NOT NULL,
-  entity TEXT NOT NULL,
-  score REAL NOT NULL,
-  confidence TEXT NOT NULL,
-  queued_at INTEGER NOT NULL,
-  expires_at INTEGER NOT NULL,
-  status TEXT NOT NULL DEFAULT 'pending',
-  applied_at INTEGER,
-  UNIQUE(note_path, entity)
-);
-CREATE INDEX IF NOT EXISTS idx_pq_status ON proactive_queue(status, expires_at);
-`;
-// =============================================================================
-// Database Initialization
-// =============================================================================
-/**
- * Get the database path for a vault
- */
-export function getStateDbPath(vaultPath) {
-    const flywheelDir = path.join(vaultPath, FLYWHEEL_DIR);
-    if (!fs.existsSync(flywheelDir)) {
-        fs.mkdirSync(flywheelDir, { recursive: true });
-    }
-    return path.join(flywheelDir, STATE_DB_FILENAME);
-}
-/**
- * Initialize schema and run migrations
- */
-function initSchema(db) {
-    // Enable WAL mode for better concurrent read performance
-    db.pragma('journal_mode = WAL');
-    // Enable foreign keys
-    db.pragma('foreign_keys = ON');
-    // Performance tuning
-    db.pragma('synchronous = NORMAL'); // Safe with WAL — fsync only on checkpoint, not every commit
-    db.pragma('cache_size = -64000'); // 64 MB page cache (default is ~2 MB)
-    db.pragma('temp_store = MEMORY'); // Temp tables/indices in RAM instead of disk
-    // Run schema creation
-    db.exec(SCHEMA_SQL);
-    // Guard: Verify critical tables were created
-    // This catches cases where schema execution silently failed (e.g., corrupted db)
-    const tables = db.prepare(`
-    SELECT name FROM sqlite_master
-    WHERE type='table' AND name IN ('entities', 'schema_version', 'metadata')
-  `).all();
-    if (tables.length < 3) {
-        const foundTables = tables.map(t => t.name).join(', ') || 'none';
-        throw new Error(`[vault-core] Schema validation failed: expected 3 critical tables, found ${tables.length} (${foundTables}). ` +
-            `Database may be corrupted. Delete ${db.name} and restart.`);
-    }
-    // Check and record schema version
-    const versionRow = db.prepare('SELECT MAX(version) as version FROM schema_version').get();
-    const currentVersion = versionRow?.version ?? 0;
-    if (currentVersion < SCHEMA_VERSION) {
-        // v2: Drop dead notes/links tables if they exist from v1
-        if (currentVersion < 2) {
-            db.exec('DROP TABLE IF EXISTS notes');
-            db.exec('DROP TABLE IF EXISTS links');
-        }
-        // v3: Rename crank_state → write_state
-        if (currentVersion < 3) {
-            const hasCrankState = db.prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='crank_state'`).get();
-            const hasWriteState = db.prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='write_state'`).get();
-            if (hasCrankState && !hasWriteState) {
-                db.exec('ALTER TABLE crank_state RENAME TO write_state');
-            }
-            else if (hasCrankState && hasWriteState) {
-                // Both exist (stale db) — drop the old one
-                db.exec('DROP TABLE crank_state');
-            }
-        }
-        // v4: vault_metrics, wikilink_feedback, wikilink_suppressions tables
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v5: wikilink_applications table (implicit feedback tracking)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v6: index_events table (index activity history)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v7: tool_invocations table (usage analytics)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v8: graph_snapshots table (structural evolution)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v9: note_embeddings table (semantic search)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v10: entity_embeddings table (semantic entity search)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v11: notes_fts gains frontmatter column (4-col: path, title, frontmatter, content)
-        // Virtual tables can't ALTER, so drop and recreate
-        if (currentVersion < 11) {
-            db.exec('DROP TABLE IF EXISTS notes_fts');
-            db.exec(`CREATE VIRTUAL TABLE IF NOT EXISTS notes_fts USING fts5(
-        path, title, frontmatter, content,
-        tokenize='porter'
-      )`);
-            // Clear FTS metadata to force rebuild with new schema
-            db.exec(`DELETE FROM fts_metadata WHERE key = 'last_built'`);
-        }
-        // v12: tasks cache table (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v13: merge_dismissals table (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v14: Add steps column to index_events (pipeline observability)
-        if (currentVersion < 14) {
-            const hasSteps = db.prepare(`SELECT COUNT(*) as cnt FROM pragma_table_info('index_events') WHERE name = 'steps'`).get();
-            if (hasSteps.cnt === 0) {
-                db.exec('ALTER TABLE index_events ADD COLUMN steps TEXT');
-            }
-        }
-        // v15: suggestion_events table (pipeline observability audit log)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v16: note_links table (forward-link persistence for diff-based feedback)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v17: entity_changes table (entity field change audit log)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v18: note_tags table (tag persistence for diff-based feedback)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v19: note_link_history table (wikilink survival tracking for positive feedback)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v20: note_moves table (records file renames/moves detected by the watcher)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v21: description TEXT column on entities table
-        if (currentVersion < 21) {
-            const hasDesc = db.prepare(`SELECT COUNT(*) as cnt FROM pragma_table_info('entities') WHERE name = 'description'`).get();
-            if (hasDesc.cnt === 0) {
-                db.exec('ALTER TABLE entities ADD COLUMN description TEXT');
-            }
-        }
-        // v22: Edge weight columns on note_links table
-        if (currentVersion < 22) {
-            const hasWeight = db.prepare(`SELECT COUNT(*) as cnt FROM pragma_table_info('note_links') WHERE name = 'weight'`).get();
-            if (hasWeight.cnt === 0) {
-                db.exec('ALTER TABLE note_links ADD COLUMN weight REAL NOT NULL DEFAULT 1.0');
-                db.exec('ALTER TABLE note_links ADD COLUMN weight_updated_at INTEGER');
-            }
-        }
-        // v23: Case-insensitive unique index on wikilink_applications
-        if (currentVersion < 23) {
-            db.exec('DROP INDEX IF EXISTS idx_wl_apps_unique');
-            db.exec('CREATE UNIQUE INDEX IF NOT EXISTS idx_wl_apps_unique ON wikilink_applications(entity COLLATE NOCASE, note_path)');
-        }
-        // v24: corrections table (persistent correction records)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v25: confidence column on wikilink_feedback (signal quality weighting)
-        if (currentVersion < 25) {
-            const hasConfidence = db.prepare(`SELECT COUNT(*) as cnt FROM pragma_table_info('wikilink_feedback') WHERE name = 'confidence'`).get();
-            if (hasConfidence.cnt === 0) {
-                db.exec('ALTER TABLE wikilink_feedback ADD COLUMN confidence REAL NOT NULL DEFAULT 1.0');
-            }
-        }
-        // v26: memories table, memories_fts, session_summaries table
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v27: cooccurrence_cache table (persist co-occurrence index)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v28: content_hashes table (persist watcher content hashes across restarts)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v29: index on wikilink_feedback(note_path) for temporal analysis queries
-        // (created by SCHEMA_SQL above via CREATE INDEX IF NOT EXISTS)
-        // v31: proactive_queue table (deferred proactive linking)
-        // (created by SCHEMA_SQL above via CREATE TABLE IF NOT EXISTS)
-        // v30: token economics columns on tool_invocations
-        if (currentVersion < 30) {
-            const hasResponseTokens = db.prepare(`SELECT COUNT(*) as cnt FROM pragma_table_info('tool_invocations') WHERE name = 'response_tokens'`).get();
-            if (hasResponseTokens.cnt === 0) {
-                db.exec('ALTER TABLE tool_invocations ADD COLUMN response_tokens INTEGER');
-                db.exec('ALTER TABLE tool_invocations ADD COLUMN baseline_tokens INTEGER');
-            }
-        }
-        db.prepare('INSERT OR IGNORE INTO schema_version (version) VALUES (?)').run(SCHEMA_VERSION);
-    }
-}
-function deleteStateDbFiles(dbPath) {
-    for (const suffix of ['', '-wal', '-shm']) {
-        const p = dbPath + suffix;
-        if (fs.existsSync(p))
-            fs.unlinkSync(p);
-    }
-}
-/** Back up state.db before opening (skip if missing or 0 bytes). */
-function backupStateDb(dbPath) {
-    try {
-        if (!fs.existsSync(dbPath))
-            return;
-        const stat = fs.statSync(dbPath);
-        if (stat.size === 0)
-            return;
-        fs.copyFileSync(dbPath, dbPath + '.backup');
-    }
-    catch (err) {
-        console.error(`[vault-core] Failed to back up state.db: ${err instanceof Error ? err.message : err}`);
-    }
-}
-/** Preserve a corrupted database for inspection before deleting. */
-function preserveCorruptedDb(dbPath) {
-    try {
-        if (fs.existsSync(dbPath)) {
-            fs.copyFileSync(dbPath, dbPath + '.corrupt');
-            console.error(`[vault-core] Corrupted database preserved at ${dbPath}.corrupt`);
-        }
-    }
-    catch {
-        // Best effort — don't block recovery
-    }
-}
 /**
  * Open or create the state database for a vault
  *
@@ -693,102 +71,102 @@ export function openStateDb(vaultPath) {
         vaultPath,
         dbPath,
         // Entity operations
-        insertEntity: db.prepare(`
-      INSERT INTO entities (name, name_lower, path, category, aliases_json, hub_score, description)
-      VALUES (?, ?, ?, ?, ?, ?, ?)
+        insertEntity: db.prepare(`
+      INSERT INTO entities (name, name_lower, path, category, aliases_json, hub_score, description)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
     `),
-        updateEntity: db.prepare(`
-      UPDATE entities
-      SET name = ?, name_lower = ?, path = ?, category = ?, aliases_json = ?, hub_score = ?, description = ?
-      WHERE id = ?
+        updateEntity: db.prepare(`
+      UPDATE entities
+      SET name = ?, name_lower = ?, path = ?, category = ?, aliases_json = ?, hub_score = ?, description = ?
+      WHERE id = ?
     `),
         deleteEntity: db.prepare('DELETE FROM entities WHERE id = ?'),
-        getEntityByName: db.prepare(`
-      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
-      FROM entities WHERE name_lower = ?
+        getEntityByName: db.prepare(`
+      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
+      FROM entities WHERE name_lower = ?
     `),
-        getEntityById: db.prepare(`
-      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
-      FROM entities WHERE id = ?
+        getEntityById: db.prepare(`
+      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
+      FROM entities WHERE id = ?
     `),
-        getAllEntities: db.prepare(`
-      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
-      FROM entities ORDER BY name
+        getAllEntities: db.prepare(`
+      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
+      FROM entities ORDER BY name
     `),
-        getEntitiesByCategory: db.prepare(`
-      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
-      FROM entities WHERE category = ? ORDER BY name
+        getEntitiesByCategory: db.prepare(`
+      SELECT id, name, name_lower, path, category, aliases_json, hub_score, description
+      FROM entities WHERE category = ? ORDER BY name
     `),
-        searchEntitiesFts: db.prepare(`
-      SELECT e.id, e.name, e.name_lower, e.path, e.category, e.aliases_json, e.hub_score, e.description,
-             bm25(entities_fts) as rank
-      FROM entities_fts
-      JOIN entities e ON e.id = entities_fts.rowid
-      WHERE entities_fts MATCH ?
-      ORDER BY rank
-      LIMIT ?
+        searchEntitiesFts: db.prepare(`
+      SELECT e.id, e.name, e.name_lower, e.path, e.category, e.aliases_json, e.hub_score, e.description,
+             bm25(entities_fts) as rank
+      FROM entities_fts
+      JOIN entities e ON e.id = entities_fts.rowid
+      WHERE entities_fts MATCH ?
+      ORDER BY rank
+      LIMIT ?
     `),
         clearEntities: db.prepare('DELETE FROM entities'),
         // Entity alias lookup
-        getEntitiesByAlias: db.prepare(`
-      SELECT e.id, e.name, e.name_lower, e.path, e.category, e.aliases_json, e.hub_score, e.description
-      FROM entities e
-      WHERE EXISTS (SELECT 1 FROM json_each(e.aliases_json) WHERE LOWER(value) = ?)
+        getEntitiesByAlias: db.prepare(`
+      SELECT e.id, e.name, e.name_lower, e.path, e.category, e.aliases_json, e.hub_score, e.description
+      FROM entities e
+      WHERE EXISTS (SELECT 1 FROM json_each(e.aliases_json) WHERE LOWER(value) = ?)
     `),
         // Recency operations
-        upsertRecency: db.prepare(`
-      INSERT INTO recency (entity_name_lower, last_mentioned_at, mention_count)
-      VALUES (?, ?, 1)
-      ON CONFLICT(entity_name_lower) DO UPDATE SET
-        last_mentioned_at = excluded.last_mentioned_at,
-        mention_count = mention_count + 1
+        upsertRecency: db.prepare(`
+      INSERT INTO recency (entity_name_lower, last_mentioned_at, mention_count)
+      VALUES (?, ?, 1)
+      ON CONFLICT(entity_name_lower) DO UPDATE SET
+        last_mentioned_at = excluded.last_mentioned_at,
+        mention_count = mention_count + 1
     `),
-        getRecency: db.prepare(`
-      SELECT entity_name_lower, last_mentioned_at, mention_count
-      FROM recency WHERE entity_name_lower = ?
+        getRecency: db.prepare(`
+      SELECT entity_name_lower, last_mentioned_at, mention_count
+      FROM recency WHERE entity_name_lower = ?
     `),
-        getAllRecency: db.prepare(`
-      SELECT entity_name_lower, last_mentioned_at, mention_count
-      FROM recency ORDER BY last_mentioned_at DESC
+        getAllRecency: db.prepare(`
+      SELECT entity_name_lower, last_mentioned_at, mention_count
+      FROM recency ORDER BY last_mentioned_at DESC
     `),
         clearRecency: db.prepare('DELETE FROM recency'),
         // Write state operations
-        setWriteState: db.prepare(`
-      INSERT INTO write_state (key, value, updated_at)
-      VALUES (?, ?, datetime('now'))
-      ON CONFLICT(key) DO UPDATE SET
-        value = excluded.value,
-        updated_at = datetime('now')
+        setWriteState: db.prepare(`
+      INSERT INTO write_state (key, value, updated_at)
+      VALUES (?, ?, datetime('now'))
+      ON CONFLICT(key) DO UPDATE SET
+        value = excluded.value,
+        updated_at = datetime('now')
     `),
         getWriteState: db.prepare('SELECT value FROM write_state WHERE key = ?'),
         deleteWriteState: db.prepare('DELETE FROM write_state WHERE key = ?'),
         // Flywheel config operations
-        setFlywheelConfigStmt: db.prepare(`
-      INSERT INTO flywheel_config (key, value, updated_at)
-      VALUES (?, ?, datetime('now'))
-      ON CONFLICT(key) DO UPDATE SET
-        value = excluded.value,
-        updated_at = datetime('now')
+        setFlywheelConfigStmt: db.prepare(`
+      INSERT INTO flywheel_config (key, value, updated_at)
+      VALUES (?, ?, datetime('now'))
+      ON CONFLICT(key) DO UPDATE SET
+        value = excluded.value,
+        updated_at = datetime('now')
     `),
         getFlywheelConfigStmt: db.prepare('SELECT value FROM flywheel_config WHERE key = ?'),
         getAllFlywheelConfigStmt: db.prepare('SELECT key, value FROM flywheel_config'),
         deleteFlywheelConfigStmt: db.prepare('DELETE FROM flywheel_config WHERE key = ?'),
         // Task cache operations
-        insertTask: db.prepare(`
-      INSERT OR REPLACE INTO tasks (path, line, text, status, raw, context, tags_json, due_date)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        insertTask: db.prepare(`
+      INSERT OR REPLACE INTO tasks (path, line, text, status, raw, context, tags_json, due_date)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
     `),
         deleteTasksForPath: db.prepare('DELETE FROM tasks WHERE path = ?'),
         clearAllTasks: db.prepare('DELETE FROM tasks'),
         countTasksByStatus: db.prepare('SELECT status, COUNT(*) as cnt FROM tasks GROUP BY status'),
         // Metadata operations
         getMetadataValue: db.prepare('SELECT value FROM metadata WHERE key = ?'),
-        setMetadataValue: db.prepare(`
-      INSERT INTO metadata (key, value, updated_at)
-      VALUES (?, ?, datetime('now'))
-      ON CONFLICT(key) DO UPDATE SET
-        value = excluded.value,
-        updated_at = datetime('now')
+        setMetadataValue: db.prepare(`
+      INSERT INTO metadata (key, value, updated_at)
+      VALUES (?, ?, datetime('now'))
+      ON CONFLICT(key) DO UPDATE SET
+        value = excluded.value,
+        updated_at = datetime('now')
     `),
         // Transactions
         bulkInsertEntities: db.transaction((entities, category) => {
@@ -834,472 +212,4 @@ export function openStateDb(vaultPath) {
     };
     return stateDb;
 }
-// =============================================================================
-// Entity Operations
-// =============================================================================
-/**
- * Search entities using FTS5 with porter stemming
- *
- * @param stateDb - State database instance
- * @param query - Search query (supports FTS5 syntax)
- * @param limit - Maximum results to return
- * @returns Array of matching entities with relevance scores
- */
-export function searchEntities(stateDb, query, limit = 20) {
-    const escapedQuery = escapeFts5Query(query);
-    // Handle empty query - return empty results
-    if (!escapedQuery) {
-        return [];
-    }
-    const rows = stateDb.searchEntitiesFts.all(escapedQuery, limit);
-    return rows.map(row => ({
-        id: row.id,
-        name: row.name,
-        nameLower: row.name_lower,
-        path: row.path,
-        category: row.category,
-        aliases: row.aliases_json ? JSON.parse(row.aliases_json) : [],
-        hubScore: row.hub_score,
-        description: row.description ?? undefined,
-        rank: row.rank,
-    }));
-}
-/**
- * Search entities by prefix for autocomplete
- *
- * @param stateDb - State database instance
- * @param prefix - Prefix to search for
- * @param limit - Maximum results to return
- */
-export function searchEntitiesPrefix(stateDb, prefix, limit = 20) {
-    return searchEntities(stateDb, `${escapeFts5Query(prefix)}*`, limit);
-}
-/**
- * Get entity by exact name (case-insensitive)
- */
-export function getEntityByName(stateDb, name) {
-    const row = stateDb.getEntityByName.get(name.toLowerCase());
-    if (!row)
-        return null;
-    return {
-        id: row.id,
-        name: row.name,
-        nameLower: row.name_lower,
-        path: row.path,
-        category: row.category,
-        aliases: row.aliases_json ? JSON.parse(row.aliases_json) : [],
-        hubScore: row.hub_score,
-        description: row.description ?? undefined,
-        rank: 0,
-    };
-}
-/**
- * Get all entities from the database
- */
-export function getAllEntitiesFromDb(stateDb) {
-    const rows = stateDb.getAllEntities.all();
-    return rows.map(row => ({
-        id: row.id,
-        name: row.name,
-        nameLower: row.name_lower,
-        path: row.path,
-        category: row.category,
-        aliases: row.aliases_json ? JSON.parse(row.aliases_json) : [],
-        hubScore: row.hub_score,
-        description: row.description ?? undefined,
-        rank: 0,
-    }));
-}
-/**
- * Convert database entities back to EntityIndex format
- */
-export function getEntityIndexFromDb(stateDb) {
-    const entities = getAllEntitiesFromDb(stateDb);
-    const index = {
-        technologies: [],
-        acronyms: [],
-        people: [],
-        projects: [],
-        organizations: [],
-        locations: [],
-        concepts: [],
-        animals: [],
-        media: [],
-        events: [],
-        documents: [],
-        vehicles: [],
-        health: [],
-        finance: [],
-        food: [],
-        hobbies: [],
-        periodical: [],
-        other: [],
-        _metadata: {
-            total_entities: entities.length,
-            generated_at: new Date().toISOString(),
-            vault_path: stateDb.vaultPath,
-            source: 'vault-core sqlite',
-        },
-    };
-    for (const entity of entities) {
-        const entityObj = {
-            name: entity.name,
-            path: entity.path,
-            aliases: entity.aliases,
-            hubScore: entity.hubScore,
-            description: entity.description,
-        };
-        index[entity.category].push(entityObj);
-    }
-    return index;
-}
-/**
- * Get entities that have a given alias (case-insensitive)
- *
- * @param stateDb - State database instance
- * @param alias - Alias to search for (case-insensitive)
- * @returns Array of matching entities
- */
-export function getEntitiesByAlias(stateDb, alias) {
-    const rows = stateDb.getEntitiesByAlias.all(alias.toLowerCase());
-    return rows.map(row => ({
-        id: row.id,
-        name: row.name,
-        nameLower: row.name_lower,
-        path: row.path,
-        category: row.category,
-        aliases: row.aliases_json ? JSON.parse(row.aliases_json) : [],
-        hubScore: row.hub_score,
-        description: row.description ?? undefined,
-        rank: 0,
-    }));
-}
-// =============================================================================
-// Recency Operations
-// =============================================================================
-/**
- * Record a mention of an entity
- */
-export function recordEntityMention(stateDb, entityName, mentionedAt = new Date()) {
-    stateDb.upsertRecency.run(entityName.toLowerCase(), mentionedAt.getTime());
-}
-/**
- * Get recency info for an entity
- */
-export function getEntityRecency(stateDb, entityName) {
-    const row = stateDb.getRecency.get(entityName.toLowerCase());
-    if (!row)
-        return null;
-    return {
-        entityNameLower: row.entity_name_lower,
-        lastMentionedAt: row.last_mentioned_at,
-        mentionCount: row.mention_count,
-    };
-}
-/**
- * Get all recency data ordered by most recent
- */
-export function getAllRecency(stateDb) {
-    const rows = stateDb.getAllRecency.all();
-    return rows.map(row => ({
-        entityNameLower: row.entity_name_lower,
-        lastMentionedAt: row.last_mentioned_at,
-        mentionCount: row.mention_count,
-    }));
-}
-// =============================================================================
-// Write State Operations
-// =============================================================================
-/**
- * Set a write state value
- */
-export function setWriteState(stateDb, key, value) {
-    stateDb.setWriteState.run(key, JSON.stringify(value));
-}
-/**
- * Get a write state value
- */
-export function getWriteState(stateDb, key) {
-    const row = stateDb.getWriteState.get(key);
-    if (!row)
-        return null;
-    return JSON.parse(row.value);
-}
-/**
- * Delete a write state key
- */
-export function deleteWriteState(stateDb, key) {
-    stateDb.deleteWriteState.run(key);
-}
-/**
- * Set a flywheel config value
- */
-export function setFlywheelConfig(stateDb, key, value) {
-    stateDb.setFlywheelConfigStmt.run(key, JSON.stringify(value));
-}
-/**
- * Get a flywheel config value
- */
-export function getFlywheelConfig(stateDb, key) {
-    const row = stateDb.getFlywheelConfigStmt.get(key);
-    if (!row)
-        return null;
-    return JSON.parse(row.value);
-}
-/**
- * Get all flywheel config values as an object
- */
-export function getAllFlywheelConfig(stateDb) {
-    const rows = stateDb.getAllFlywheelConfigStmt.all();
-    const config = {};
-    for (const row of rows) {
-        try {
-            config[row.key] = JSON.parse(row.value);
-        }
-        catch {
-            config[row.key] = row.value;
-        }
-    }
-    return config;
-}
-/**
- * Delete a flywheel config key
- */
-export function deleteFlywheelConfig(stateDb, key) {
-    stateDb.deleteFlywheelConfigStmt.run(key);
-}
-/**
- * Save entire Flywheel config object to database
- * Stores each top-level key as a separate row
- */
-export function saveFlywheelConfigToDb(stateDb, config) {
-    const transaction = stateDb.db.transaction(() => {
-        for (const [key, value] of Object.entries(config)) {
-            if (value !== undefined) {
-                setFlywheelConfig(stateDb, key, value);
-            }
-        }
-    });
-    transaction();
-}
-/**
- * Load Flywheel config from database and reconstruct as typed object
- */
-export function loadFlywheelConfigFromDb(stateDb) {
-    const config = getAllFlywheelConfig(stateDb);
-    if (Object.keys(config).length === 0) {
-        return null;
-    }
-    return config;
-}
-// =============================================================================
-// Merge Dismissal Operations
-// =============================================================================
-/**
- * Record a merge dismissal so the pair never reappears in suggestions.
- */
-export function recordMergeDismissal(db, sourcePath, targetPath, sourceName, targetName, reason) {
-    const pairKey = [sourcePath, targetPath].sort().join('::');
-    db.db.prepare(`INSERT OR IGNORE INTO merge_dismissals
-    (pair_key, source_path, target_path, source_name, target_name, reason)
-    VALUES (?, ?, ?, ?, ?, ?)`)
-        .run(pairKey, sourcePath, targetPath, sourceName, targetName, reason);
-}
-/**
- * Get all dismissed merge pair keys for filtering.
- */
-export function getDismissedMergePairs(db) {
-    const rows = db.db.prepare('SELECT pair_key FROM merge_dismissals').all();
-    return new Set(rows.map(r => r.pair_key));
-}
-// =============================================================================
-// Metadata Operations
-// =============================================================================
-/**
- * Get database metadata
- */
-export function getStateDbMetadata(stateDb) {
-    const schemaRow = stateDb.db.prepare('SELECT MAX(version) as version FROM schema_version').get();
-    const entitiesBuiltRow = stateDb.getMetadataValue.get('entities_built_at');
-    const entityCountRow = stateDb.getMetadataValue.get('entity_count');
-    const notesBuiltRow = stateDb.getMetadataValue.get('notes_built_at');
-    const noteCountRow = stateDb.getMetadataValue.get('note_count');
-    return {
-        schemaVersion: schemaRow?.version ?? 0,
-        entitiesBuiltAt: entitiesBuiltRow?.value ?? null,
-        entityCount: entityCountRow ? parseInt(entityCountRow.value, 10) : 0,
-        notesBuiltAt: notesBuiltRow?.value ?? null,
-        noteCount: noteCountRow ? parseInt(noteCountRow.value, 10) : 0,
-    };
-}
-/**
- * Check if entity data is stale (older than threshold)
- */
-export function isEntityDataStale(stateDb, thresholdMs = 60 * 60 * 1000 // 1 hour default
-) {
-    const metadata = getStateDbMetadata(stateDb);
-    if (!metadata.entitiesBuiltAt) {
-        return true;
-    }
-    const builtAt = new Date(metadata.entitiesBuiltAt).getTime();
-    const age = Date.now() - builtAt;
-    return age > thresholdMs;
-}
-// =============================================================================
-// Utility Functions
-// =============================================================================
-/**
- * Escape special FTS5 characters in a query
- */
-export function escapeFts5Query(query) {
-    // Handle empty query
-    if (!query || !query.trim()) {
-        return '';
-    }
-    // Remove or escape FTS5 special characters
-    // Keep * for prefix matching, escape others
-    return query
-        .replace(/"/g, '""') // Escape quotes
-        .replace(/[(){}[\]^~:-]/g, ' ') // Remove special operators including hyphen
-        .replace(/\s+/g, ' ') // Normalize whitespace
-        .trim();
-}
-/**
- * Rebuild the entities_fts index from the entities table.
- * Uses FTS5's built-in 'rebuild' command to resynchronize.
- * Call this if the FTS index gets out of sync (e.g., T.aliases errors).
- */
-export function rebuildEntitiesFts(stateDb) {
-    stateDb.db.exec(`INSERT INTO entities_fts(entities_fts) VALUES('rebuild')`);
-}
-/**
- * Check if the state database exists for a vault
- */
-export function stateDbExists(vaultPath) {
-    const dbPath = getStateDbPath(vaultPath);
-    return fs.existsSync(dbPath);
-}
-/**
- * Delete the state database (for testing or reset)
- */
-export function deleteStateDb(vaultPath) {
-    const dbPath = getStateDbPath(vaultPath);
-    if (fs.existsSync(dbPath)) {
-        fs.unlinkSync(dbPath);
-    }
-    // Also remove WAL and SHM files if they exist
-    const walPath = dbPath + '-wal';
-    const shmPath = dbPath + '-shm';
-    if (fs.existsSync(walPath))
-        fs.unlinkSync(walPath);
-    if (fs.existsSync(shmPath))
-        fs.unlinkSync(shmPath);
-}
-/**
- * Save VaultIndex to cache
- *
- * @param stateDb - State database instance
- * @param indexData - Serialized VaultIndex data
- */
-export function saveVaultIndexCache(stateDb, indexData) {
-    const data = JSON.stringify(indexData);
-    const stmt = stateDb.db.prepare(`
-    INSERT OR REPLACE INTO vault_index_cache (id, data, built_at, note_count, version)
-    VALUES (1, ?, ?, ?, 1)
-  `);
-    stmt.run(data, indexData.builtAt, indexData.notes.length);
-}
-/**
- * Load VaultIndex from cache
- *
- * @param stateDb - State database instance
- * @returns Cached VaultIndex data or null if not found
- */
-export function loadVaultIndexCache(stateDb) {
-    const stmt = stateDb.db.prepare(`
-    SELECT data, built_at, note_count FROM vault_index_cache WHERE id = 1
-  `);
-    const row = stmt.get();
-    if (!row)
-        return null;
-    try {
-        return JSON.parse(row.data);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Get cache metadata without loading full data
- */
-export function getVaultIndexCacheInfo(stateDb) {
-    const stmt = stateDb.db.prepare(`
-    SELECT built_at, note_count, version FROM vault_index_cache WHERE id = 1
-  `);
-    const row = stmt.get();
-    if (!row)
-        return null;
-    return {
-        builtAt: new Date(row.built_at),
-        noteCount: row.note_count,
-        version: row.version,
-    };
-}
-/**
- * Clear the vault index cache
- */
-export function clearVaultIndexCache(stateDb) {
-    stateDb.db.prepare('DELETE FROM vault_index_cache').run();
-}
-/**
- * Check if cache is valid (not too old and note count matches)
- *
- * @param stateDb - State database instance
- * @param actualNoteCount - Current number of notes in vault
- * @param maxAgeMs - Maximum cache age in milliseconds (default 24 hours)
- */
-export function isVaultIndexCacheValid(stateDb, actualNoteCount, maxAgeMs = 24 * 60 * 60 * 1000) {
-    const info = getVaultIndexCacheInfo(stateDb);
-    if (!info)
-        return false;
-    // Check note count matches (quick validation)
-    if (info.noteCount !== actualNoteCount)
-        return false;
-    // Check age
-    const age = Date.now() - info.builtAt.getTime();
-    if (age > maxAgeMs)
-        return false;
-    return true;
-}
-// =============================================================================
-// Content Hash Operations
-// =============================================================================
-/** Load all persisted content hashes */
-export function loadContentHashes(stateDb) {
-    const rows = stateDb.db.prepare('SELECT path, hash FROM content_hashes').all();
-    const map = new Map();
-    for (const row of rows) {
-        map.set(row.path, row.hash);
-    }
-    return map;
-}
-/** Persist hash changes from a watcher batch (upserts + deletes in one transaction) */
-export function saveContentHashBatch(stateDb, upserts, deletes) {
-    const upsertStmt = stateDb.db.prepare('INSERT OR REPLACE INTO content_hashes (path, hash, updated_at) VALUES (?, ?, ?)');
-    const deleteStmt = stateDb.db.prepare('DELETE FROM content_hashes WHERE path = ?');
-    const now = Date.now();
-    const runBatch = stateDb.db.transaction(() => {
-        for (const { path, hash } of upserts) {
-            upsertStmt.run(path, hash, now);
-        }
-        for (const p of deletes) {
-            deleteStmt.run(p);
-        }
-    });
-    runBatch();
-}
-/** Rename a hash entry (for file renames) */
-export function renameContentHash(stateDb, oldPath, newPath) {
-    stateDb.db.prepare('UPDATE content_hashes SET path = ?, updated_at = ? WHERE path = ?').run(newPath, Date.now(), oldPath);
-}
 //# sourceMappingURL=sqlite.js.map