From b2e08f4ceda6133947bca0ed58d86b73cde0f336 Mon Sep 17 00:00:00 2001
From: tomymaritano <tomymaritano@gmail.com>
Date: Fri, 24 Apr 2026 12:37:24 -0300
Subject: [PATCH 1/2] feat: allow disabling built-in plugins
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Previously built-in plugins were hardcoded as always enabled with the
toggle disabled. Now:

- Toggle enabled for built-in plugins (removed disabled={isBuiltIn})
- Built-in enabled state loaded from plugin_registry DB table
- onToggle handler wired for built-in plugins (same as community)
- App.tsx filters built-in plugins by enabled state before passing
  to PluginHost — disabled plugins won't load at runtime
- State re-checked on plugins:reload event

The DB infrastructure (plugin_registry table) and IPC handlers
(plugins:setEnabled/isEnabled) already existed but were unused.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 apps/desktop/src/renderer/App.tsx             | 30 ++++++++++++++++++-
 .../settings/sections/plugins/PluginCard.tsx  |  1 -
 .../pages/settings/sections/plugins/index.tsx | 16 ++++++++--
 3 files changed, 43 insertions(+), 4 deletions(-)

diff --git a/apps/desktop/src/renderer/App.tsx b/apps/desktop/src/renderer/App.tsx
index 78c096c4..8ed4acbf 100644
--- a/apps/desktop/src/renderer/App.tsx
+++ b/apps/desktop/src/renderer/App.tsx
@@ -438,12 +438,40 @@ function NotesApp() {
   // Plugin runtime: init once, React observes
   const discoveredPlugins = useStore(pluginRuntimeStore, s => s.plugins);
   const pluginErrors = useStore(pluginRuntimeStore, s => s.errors);
+  const [builtInEnabledMap, setBuiltInEnabledMap] = useState<Record<string, boolean>>({});
 
   useEffect(() => {
     void pluginRuntimeStore.getState().init();
+    // Load built-in plugin enabled states
+    void (async () => {
+      const stateList = await window.readied.plugins.listState();
+      const map: Record<string, boolean> = {};
+      for (const s of stateList) {
+        map[s.pluginId] = s.enabled;
+      }
+      setBuiltInEnabledMap(map);
+    })();
+  }, []);
+
+  // Re-check built-in enabled state when plugins reload
+  useEffect(() => {
+    const handler = () => {
+      void (async () => {
+        const stateList = await window.readied.plugins.listState();
+        const map: Record<string, boolean> = {};
+        for (const s of stateList) {
+          map[s.pluginId] = s.enabled;
+        }
+        setBuiltInEnabledMap(map);
+      })();
+    };
+    return window.readied.ipc.on('plugins:reload', handler);
   }, []);
 
-  const allPlugins = useMemo(() => [...builtInPlugins, ...discoveredPlugins], [discoveredPlugins]);
+  const allPlugins = useMemo(() => {
+    const enabledBuiltIn = builtInPlugins.filter(p => builtInEnabledMap[p.id] !== false);
+    return [...enabledBuiltIn, ...discoveredPlugins];
+  }, [discoveredPlugins, builtInEnabledMap]);
 
   const configBridge = useMemo(
     () => ({
diff --git a/apps/desktop/src/renderer/pages/settings/sections/plugins/PluginCard.tsx b/apps/desktop/src/renderer/pages/settings/sections/plugins/PluginCard.tsx
index 9bffbb85..51357077 100644
--- a/apps/desktop/src/renderer/pages/settings/sections/plugins/PluginCard.tsx
+++ b/apps/desktop/src/renderer/pages/settings/sections/plugins/PluginCard.tsx
@@ -59,7 +59,6 @@ export function PluginCard({
             id={`plugin-${name.toLowerCase().replace(/\s+/g, '-')}`}
             checked={enabled}
             onChange={checked => onToggle?.(checked)}
-            disabled={isBuiltIn}
           />
           {!isBuiltIn && onUninstall && (
             <button
diff --git a/apps/desktop/src/renderer/pages/settings/sections/plugins/index.tsx b/apps/desktop/src/renderer/pages/settings/sections/plugins/index.tsx
index 0d92c0d3..e9663f19 100644
--- a/apps/desktop/src/renderer/pages/settings/sections/plugins/index.tsx
+++ b/apps/desktop/src/renderer/pages/settings/sections/plugins/index.tsx
@@ -47,6 +47,7 @@ export function PluginsSection() {
   const [pluginsPath, setPluginsPath] = useState('');
   const [isReloading, setIsReloading] = useState(false);
   const [configValues, setConfigValues] = useState<Record<string, Record<string, unknown>>>({});
+  const [builtInEnabled, setBuiltInEnabled] = useState<Record<string, boolean>>({});
   const [refreshKey, setRefreshKey] = useState(0);
 
   // Listen for plugin install events from BrowseTab
@@ -77,6 +78,13 @@ export function PluginsSection() {
         }));
         setPlugins(pluginList);
 
+        // Load built-in plugin enabled states from DB
+        const builtInStates: Record<string, boolean> = {};
+        for (const bp of builtInPlugins) {
+          builtInStates[bp.id] = stateMap.get(bp.id) ?? true;
+        }
+        setBuiltInEnabled(builtInStates);
+
         // Load config values for all plugins with schemas (built-in + community)
         const configs: Record<string, Record<string, unknown>> = {};
 
@@ -111,11 +119,14 @@ export function PluginsSection() {
     void loadPlugins();
   }, [refreshKey]);
 
-  // Toggle plugin enabled/disabled
+  // Toggle plugin enabled/disabled (works for both built-in and community)
   const handleToggle = useCallback(async (pluginId: string, enabled: boolean) => {
     try {
       await window.readied.plugins.setEnabled(pluginId, enabled);
+      // Update community plugins state
       setPlugins(prev => prev.map(p => (p.id === pluginId ? { ...p, enabled } : p)));
+      // Update built-in plugins state
+      setBuiltInEnabled(prev => ({ ...prev, [pluginId]: enabled }));
       // Trigger reload in main window so preview updates immediately
       window.readied.plugins.requestReload();
       toast.success(`Plugin ${enabled ? 'enabled' : 'disabled'}`);
@@ -293,7 +304,8 @@ export function PluginsSection() {
                   version={plugin.version}
                   description={plugin.description}
                   isBuiltIn={true}
-                  enabled={true}
+                  enabled={builtInEnabled[plugin.id] ?? true}
+                  onToggle={enabled => handleToggle(plugin.id, enabled)}
                   configSchema={BUILT_IN_CONFIG_SCHEMAS[plugin.id]}
                   configValues={configValues[plugin.id]}
                   onConfigChange={(key, value) => handleConfigChange(plugin.id, key, value)}

From 321b0f754e80b0b2f186716a964db46c1b68af3b Mon Sep 17 00:00:00 2001
From: tomymaritano <tomymaritano@gmail.com>
Date: Fri, 24 Apr 2026 13:29:53 -0300
Subject: [PATCH 2/2] fix(mcp-server): replace sql.js with better-sqlite3 for
 FTS5 support

sql.js (WASM) lacks FTS5, causing "no such module: fts5" when MCP
write operations fire the notes_fts triggers. Since the MCP server
runs as a standalone Node.js process (not inside Electron), native
modules work without conflict.

- Switch from sql.js to better-sqlite3 for full DB feature parity
- Add FTS5 runtime check on startup (assertFts5Available)
- Enable WAL mode for safe concurrent access with the desktop app
- Remove saveDb() pattern (better-sqlite3 writes directly)
- Add regression tests for FTS5 trigger execution (INSERT/UPDATE/DELETE)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 packages/mcp-server/package.json              |   9 +-
 .../src/__tests__/fts5-triggers.test.ts       | 157 +++++++++++++
 packages/mcp-server/src/db.ts                 |  50 ++--
 packages/mcp-server/src/index.ts              |  44 ++--
 packages/mcp-server/src/sql.js.d.ts           |  23 --
 packages/mcp-server/tsconfig.json             |   3 +-
 pnpm-lock.yaml                                | 222 +++++++++++++++++-
 7 files changed, 434 insertions(+), 74 deletions(-)
 create mode 100644 packages/mcp-server/src/__tests__/fts5-triggers.test.ts
 delete mode 100644 packages/mcp-server/src/sql.js.d.ts

diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
index 54c937e4..48f1620e 100644
--- a/packages/mcp-server/package.json
+++ b/packages/mcp-server/package.json
@@ -14,16 +14,19 @@
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsx src/index.ts"
+    "dev": "tsx src/index.ts",
+    "test": "vitest run"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "sql.js": "^1.14.1",
+    "better-sqlite3": "^11.7.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^22.0.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.1"
   }
 }
diff --git a/packages/mcp-server/src/__tests__/fts5-triggers.test.ts b/packages/mcp-server/src/__tests__/fts5-triggers.test.ts
new file mode 100644
index 00000000..b9a60472
--- /dev/null
+++ b/packages/mcp-server/src/__tests__/fts5-triggers.test.ts
@@ -0,0 +1,157 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import Database from 'better-sqlite3';
+import { openDb } from '../db.js';
+
+/**
+ * Minimal schema that mirrors the real Readied database enough to
+ * exercise the FTS5 triggers that caused "no such module: fts5"
+ * when the MCP server used sql.js (which lacks FTS5).
+ */
+const SCHEMA = `
+  CREATE TABLE notes (
+    id TEXT PRIMARY KEY,
+    content TEXT NOT NULL,
+    title TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    word_count INTEGER NOT NULL DEFAULT 0,
+    notebook_id TEXT DEFAULT 'inbox',
+    is_pinned INTEGER DEFAULT 0,
+    is_deleted INTEGER DEFAULT 0,
+    status TEXT DEFAULT 'active',
+    needs_sync INTEGER DEFAULT 0,
+    local_version INTEGER DEFAULT 1,
+    sync_version INTEGER DEFAULT 0
+  );
+
+  CREATE TABLE notebooks (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    parent_id TEXT,
+    depth INTEGER NOT NULL DEFAULT 0,
+    "order" INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  );
+
+  INSERT INTO notebooks (id, name, created_at, updated_at)
+  VALUES ('inbox', 'Inbox', datetime('now'), datetime('now'));
+
+  -- FTS5 virtual table (migration 008)
+  CREATE VIRTUAL TABLE notes_fts USING fts5(
+    id UNINDEXED,
+    title,
+    content,
+    tokenize='porter unicode61'
+  );
+
+  -- Trigger: sync FTS on INSERT
+  CREATE TRIGGER notes_fts_insert AFTER INSERT ON notes
+  WHEN NEW.is_deleted = 0 OR NEW.is_deleted IS NULL
+  BEGIN
+    INSERT INTO notes_fts(id, title, content)
+    VALUES (NEW.id, NEW.title, NEW.content);
+  END;
+
+  -- Trigger: sync FTS on UPDATE (delete + re-insert)
+  CREATE TRIGGER notes_fts_update AFTER UPDATE ON notes
+  BEGIN
+    DELETE FROM notes_fts WHERE id = OLD.id;
+    INSERT INTO notes_fts(id, title, content)
+    SELECT NEW.id, NEW.title, NEW.content
+    WHERE NEW.is_deleted = 0 OR NEW.is_deleted IS NULL;
+  END;
+
+  -- Trigger: sync FTS on DELETE
+  CREATE TRIGGER notes_fts_delete AFTER DELETE ON notes
+  BEGIN
+    DELETE FROM notes_fts WHERE id = OLD.id;
+  END;
+`;
+
+describe('FTS5 trigger execution', () => {
+  let db: Database.Database;
+
+  beforeEach(() => {
+    db = new Database(':memory:');
+    db.exec(SCHEMA);
+  });
+
+  afterEach(() => {
+    db.close();
+  });
+
+  it('INSERT fires notes_fts_insert trigger without error', () => {
+    const now = new Date().toISOString();
+
+    expect(() => {
+      db.prepare(
+        `INSERT INTO notes (id, content, title, created_at, updated_at, word_count, notebook_id, status, needs_sync, local_version, sync_version)
+         VALUES (?, ?, ?, ?, ?, ?, ?, 'active', 1, 1, 0)`
+      ).run('note-1', '# Test Note\n\nHello world', 'Test Note', now, now, 2, 'inbox');
+    }).not.toThrow();
+
+    const ftsRow = db.prepare('SELECT * FROM notes_fts WHERE notes_fts MATCH ?').get('hello');
+    expect(ftsRow).toBeTruthy();
+  });
+
+  it('UPDATE fires notes_fts_update trigger without error', () => {
+    const now = new Date().toISOString();
+    db.prepare(
+      `INSERT INTO notes (id, content, title, created_at, updated_at, word_count)
+       VALUES (?, ?, ?, ?, ?, ?)`
+    ).run('note-1', '# Original\n\nOriginal content', 'Original', now, now, 2);
+
+    expect(() => {
+      db.prepare(
+        'UPDATE notes SET content = ?, title = ?, updated_at = ?, word_count = ?, needs_sync = 1, local_version = local_version + 1 WHERE id = ?'
+      ).run('# Updated\n\nBrand new content', 'Updated', now, 3, 'note-1');
+    }).not.toThrow();
+
+    const oldMatch = db.prepare('SELECT * FROM notes_fts WHERE notes_fts MATCH ?').get('original');
+    expect(oldMatch).toBeUndefined();
+
+    const newMatch = db.prepare('SELECT * FROM notes_fts WHERE notes_fts MATCH ?').get('brand');
+    expect(newMatch).toBeTruthy();
+  });
+
+  it('soft-delete UPDATE removes entry from FTS index', () => {
+    const now = new Date().toISOString();
+    db.prepare(
+      `INSERT INTO notes (id, content, title, created_at, updated_at, word_count)
+       VALUES (?, ?, ?, ?, ?, ?)`
+    ).run('note-1', '# Trashable\n\nGoing away', 'Trashable', now, now, 2);
+
+    expect(() => {
+      db.prepare(
+        'UPDATE notes SET is_deleted = 1, updated_at = ?, needs_sync = 1 WHERE id = ?'
+      ).run(now, 'note-1');
+    }).not.toThrow();
+
+    const match = db.prepare('SELECT * FROM notes_fts WHERE notes_fts MATCH ?').get('trashable');
+    expect(match).toBeUndefined();
+  });
+
+  it('DELETE fires notes_fts_delete trigger without error', () => {
+    const now = new Date().toISOString();
+    db.prepare(
+      `INSERT INTO notes (id, content, title, created_at, updated_at, word_count)
+       VALUES (?, ?, ?, ?, ?, ?)`
+    ).run('note-1', '# Deletable\n\nWill be removed', 'Deletable', now, now, 3);
+
+    expect(() => {
+      db.prepare('DELETE FROM notes WHERE id = ?').run('note-1');
+    }).not.toThrow();
+
+    const match = db.prepare('SELECT * FROM notes_fts WHERE notes_fts MATCH ?').get('deletable');
+    expect(match).toBeUndefined();
+  });
+});
+
+describe('FTS5 runtime check', () => {
+  it('openDb succeeds with an in-memory database (FTS5 available)', () => {
+    const db = openDb(':memory:');
+    expect(db).toBeTruthy();
+    db.close();
+  });
+});
diff --git a/packages/mcp-server/src/db.ts b/packages/mcp-server/src/db.ts
index 39b501be..11978bc2 100644
--- a/packages/mcp-server/src/db.ts
+++ b/packages/mcp-server/src/db.ts
@@ -1,18 +1,19 @@
 /**
  * Database connection for the MCP server.
  *
- * Opens the Readied SQLite database using sql.js (WASM-based).
- * This avoids native module conflicts with Electron's better-sqlite3.
+ * Opens the Readied SQLite database using better-sqlite3 (native).
+ * The MCP server runs as a standalone Node.js process, so native
+ * modules work without Electron conflicts. This gives full feature
+ * parity with the desktop app, including FTS5 support and WAL
+ * concurrency for safe concurrent access to the same DB file.
  */
 
-import initSqlJs, { type Database } from 'sql.js';
-import { existsSync, readFileSync, writeFileSync } from 'fs';
+import Database from 'better-sqlite3';
+import { existsSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 
-export type { Database } from 'sql.js';
-
-let dbPath: string;
+export type { Database as BetterSqlite3Database } from 'better-sqlite3';
 
 function getDbPath(): string {
   if (process.env.READIED_DB_PATH) {
@@ -49,17 +50,30 @@ function getDbPath(): string {
   );
 }
 
-export async function openDb(): Promise<Database> {
-  dbPath = getDbPath();
-  const SQL = await initSqlJs();
-  const buffer = readFileSync(dbPath);
-  return new SQL.Database(buffer);
-}
-
 /**
- * Save the database back to disk after writes.
+ * Verify that the SQLite build includes FTS5.
+ * Fails loudly at startup so the error is obvious, rather than
+ * surfacing later as a cryptic trigger failure on write operations.
  */
-export function saveDb(db: Database): void {
-  const data = db.export();
-  writeFileSync(dbPath, Buffer.from(data));
+function assertFts5Available(db: Database.Database): void {
+  try {
+    db.prepare('CREATE VIRTUAL TABLE _fts5_check USING fts5(x)').run();
+    db.prepare('DROP TABLE _fts5_check').run();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `FTS5 module is not available in this SQLite build.\n` +
+        `The Readied database uses FTS5 for full-text search triggers.\n` +
+        `Without FTS5, write operations (create/update/delete notes) will fail.\n` +
+        `Original error: ${message}`
+    );
+  }
+}
+
+export function openDb(dbPath?: string): Database.Database {
+  const resolvedPath = dbPath ?? getDbPath();
+  const db = new Database(resolvedPath);
+  db.pragma('journal_mode = WAL');
+  assertFts5Available(db);
+  return db;
 }
diff --git a/packages/mcp-server/src/index.ts b/packages/mcp-server/src/index.ts
index 176ebbb7..7e4d37e6 100644
--- a/packages/mcp-server/src/index.ts
+++ b/packages/mcp-server/src/index.ts
@@ -4,14 +4,14 @@
  * Readied MCP Server
  *
  * Exposes Readied notes to Claude Code via the Model Context Protocol.
- * Reads directly from the local SQLite database using sql.js (WASM).
+ * Reads directly from the local SQLite database using better-sqlite3.
  *
  * Tools:
  *   - readied_list_notes: List notes with optional filters
  *   - readied_read_note: Read a specific note by ID or title
  *   - readied_create_note: Create a new note
  *   - readied_update_note: Update an existing note
- *   - readied_search_notes: Search across notes
+ *   - readied_search_notes: Search across notes (FTS5)
  *   - readied_list_notebooks: List all notebooks
  *   - readied_trash_note: Move a note to trash
  */
@@ -19,37 +19,33 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { openDb, saveDb, type Database } from './db.js';
+import type Database from 'better-sqlite3';
+import { openDb } from './db.js';
 
 /** Helper: run a SELECT and return rows as objects */
-function query(db: Database, sql: string, params: unknown[] = []): Record<string, unknown>[] {
-  const stmt = db.prepare(sql);
-  stmt.bind(params);
-  const rows: Record<string, unknown>[] = [];
-  while (stmt.step()) {
-    rows.push(stmt.getAsObject());
-  }
-  stmt.free();
-  return rows;
+function query(
+  db: Database.Database,
+  sql: string,
+  params: unknown[] = []
+): Record<string, unknown>[] {
+  return db.prepare(sql).all(...params) as Record<string, unknown>[];
 }
 
 /** Helper: run a single SELECT and return first row */
 function queryOne(
-  db: Database,
+  db: Database.Database,
   sql: string,
   params: unknown[] = []
 ): Record<string, unknown> | null {
-  const rows = query(db, sql, params);
-  return rows[0] ?? null;
+  return (db.prepare(sql).get(...params) as Record<string, unknown>) ?? null;
 }
 
-/** Helper: run INSERT/UPDATE/DELETE */
-function execute(db: Database, sql: string, params: unknown[] = []): number {
-  db.run(sql, params);
-  return db.getRowsModified();
+/** Helper: run INSERT/UPDATE/DELETE and return rows changed */
+function execute(db: Database.Database, sql: string, params: unknown[] = []): number {
+  return db.prepare(sql).run(...params).changes;
 }
 
-function createServer(db: Database) {
+function createServer(db: Database.Database) {
   const server = new McpServer({
     name: 'readied',
     version: '0.1.0',
@@ -168,7 +164,6 @@ function createServer(db: Database) {
          VALUES (?, ?, ?, ?, ?, ?, ?, 'active', 1, 1, 0)`,
         [id, content, title, now, now, wordCount, notebookId]
       );
-      saveDb(db);
 
       return {
         content: [{ type: 'text' as const, text: `Note created: "${title}" (ID: ${id})` }],
@@ -203,7 +198,6 @@ function createServer(db: Database) {
         return { content: [{ type: 'text' as const, text: 'Note not found.' }] };
       }
 
-      saveDb(db);
       return { content: [{ type: 'text' as const, text: `Note updated: "${title}"` }] };
     }
   );
@@ -218,7 +212,6 @@ function createServer(db: Database) {
       limit: z.number().default(10),
     },
     async ({ query: q, limit }) => {
-      // Use LIKE search (FTS may not work with sql.js)
       const results = query(
         db,
         `SELECT id, title, substr(content, 1, 300) as snippet
@@ -281,7 +274,6 @@ function createServer(db: Database) {
         return { content: [{ type: 'text' as const, text: 'Note not found.' }] };
       }
 
-      saveDb(db);
       return { content: [{ type: 'text' as const, text: 'Note moved to trash.' }] };
     }
   );
@@ -292,7 +284,7 @@ function createServer(db: Database) {
 // ── Main ──────────────────────────────────────────────────────────────────
 
 async function main() {
-  const db = await openDb();
+  const db = openDb();
   const server = createServer(db);
   const transport = new StdioServerTransport();
   await server.connect(transport);
@@ -302,3 +294,5 @@ main().catch(err => {
   console.error('MCP server error:', err);
   process.exit(1);
 });
+
+export { createServer };
diff --git a/packages/mcp-server/src/sql.js.d.ts b/packages/mcp-server/src/sql.js.d.ts
deleted file mode 100644
index cb1afc78..00000000
--- a/packages/mcp-server/src/sql.js.d.ts
+++ /dev/null
@@ -1,23 +0,0 @@
-declare module 'sql.js' {
-  interface Database {
-    run(sql: string, params?: unknown[]): void;
-    prepare(sql: string): Statement;
-    getRowsModified(): number;
-    export(): Uint8Array;
-    close(): void;
-  }
-
-  interface Statement {
-    bind(params?: unknown[]): boolean;
-    step(): boolean;
-    getAsObject(): Record<string, unknown>;
-    free(): void;
-  }
-
-  interface SqlJsStatic {
-    Database: new (data?: ArrayLike<number>) => Database;
-  }
-
-  export type { Database, Statement, SqlJsStatic };
-  export default function initSqlJs(): Promise<SqlJsStatic>;
-}
diff --git a/packages/mcp-server/tsconfig.json b/packages/mcp-server/tsconfig.json
index 2fc587e3..756b4bcd 100644
--- a/packages/mcp-server/tsconfig.json
+++ b/packages/mcp-server/tsconfig.json
@@ -5,5 +5,6 @@
     "outDir": "dist",
     "rootDir": "src"
   },
-  "include": ["src"]
+  "include": ["src"],
+  "exclude": ["src/__tests__"]
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 3043dc58..f7d6bdb6 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -467,13 +467,16 @@ importers:
       '@modelcontextprotocol/sdk':
         specifier: ^1.29.0
         version: 1.29.0(zod@4.3.6)
-      sql.js:
-        specifier: ^1.14.1
-        version: 1.14.1
+      better-sqlite3:
+        specifier: ^11.7.0
+        version: 11.10.0
       zod:
         specifier: ^4.3.6
         version: 4.3.6
     devDependencies:
+      '@types/better-sqlite3':
+        specifier: ^7.6.0
+        version: 7.6.13
       '@types/node':
         specifier: ^22.0.0
         version: 22.19.3
@@ -483,6 +486,9 @@ importers:
       typescript:
         specifier: ^5.7.0
         version: 5.9.3
+      vitest:
+        specifier: ^3.2.1
+        version: 3.2.4(@types/debug@4.1.13)(@types/node@22.19.3)(lightningcss@1.32.0)
 
   packages/plugin-api:
     devDependencies:
@@ -3580,12 +3586,18 @@ packages:
   '@types/cacheable-request@6.0.3':
     resolution: {integrity: sha512-IQ3EbTzGxIigb1I3qPZc1rWJnH0BmSKv5QYTalEwweFvyBDLSAe24zP0le/hyi7ecGfZVlIVAg4BZqb8WBwKqw==}
 
+  '@types/chai@5.2.3':
+    resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==}
+
   '@types/connect@3.4.38':
     resolution: {integrity: sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==}
 
   '@types/debug@4.1.13':
     resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==}
 
+  '@types/deep-eql@4.0.2':
+    resolution: {integrity: sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==}
+
   '@types/estree-jsx@1.0.5':
     resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==}
 
@@ -3858,6 +3870,9 @@ packages:
   '@vitest/expect@2.1.9':
     resolution: {integrity: sha512-UJCIkTBenHeKT1TTlKMJWy1laZewsRIzYighyYiJKZreqtdxSos/S1t+ktRMQWu2CKqaarrkeszJx1cgC5tGZw==}
 
+  '@vitest/expect@3.2.4':
+    resolution: {integrity: sha512-Io0yyORnB6sikFlt8QW5K7slY4OjqNX9jmJQ02QDda8lyM6B5oNgVWoSoKPac8/kgnCUzuHQKrSLtu/uOqqrig==}
+
   '@vitest/mocker@2.1.9':
     resolution: {integrity: sha512-tVL6uJgoUdi6icpxmdrn5YNo3g3Dxv+IHJBr0GXHaEdTcw3F+cPKnsXFhli6nO+f/6SDKPHEK1UN+k+TQv0Ehg==}
     peerDependencies:
@@ -3869,21 +3884,47 @@ packages:
       vite:
         optional: true
 
+  '@vitest/mocker@3.2.4':
+    resolution: {integrity: sha512-46ryTE9RZO/rfDd7pEqFl7etuyzekzEhUbTW3BvmeO/BcCMEgq59BKhek3dXDWgAj4oMK6OZi+vRr1wPW6qjEQ==}
+    peerDependencies:
+      msw: ^2.4.9
+      vite: ^5.0.0 || ^6.0.0 || ^7.0.0-0
+    peerDependenciesMeta:
+      msw:
+        optional: true
+      vite:
+        optional: true
+
   '@vitest/pretty-format@2.1.9':
     resolution: {integrity: sha512-KhRIdGV2U9HOUzxfiHmY8IFHTdqtOhIzCpd8WRdJiE7D/HUcZVD0EgQCVjm+Q9gkUXWgBvMmTtZgIG48wq7sOQ==}
 
+  '@vitest/pretty-format@3.2.4':
+    resolution: {integrity: sha512-IVNZik8IVRJRTr9fxlitMKeJeXFFFN0JaB9PHPGQ8NKQbGpfjlTx9zO4RefN8gp7eqjNy8nyK3NZmBzOPeIxtA==}
+
   '@vitest/runner@2.1.9':
     resolution: {integrity: sha512-ZXSSqTFIrzduD63btIfEyOmNcBmQvgOVsPNPe0jYtESiXkhd8u2erDLnMxmGrDCwHCCHE7hxwRDCT3pt0esT4g==}
 
+  '@vitest/runner@3.2.4':
+    resolution: {integrity: sha512-oukfKT9Mk41LreEW09vt45f8wx7DordoWUZMYdY/cyAk7w5TWkTRCNZYF7sX7n2wB7jyGAl74OxgwhPgKaqDMQ==}
+
   '@vitest/snapshot@2.1.9':
     resolution: {integrity: sha512-oBO82rEjsxLNJincVhLhaxxZdEtV0EFHMK5Kmx5sJ6H9L183dHECjiefOAdnqpIgT5eZwT04PoggUnW88vOBNQ==}
 
+  '@vitest/snapshot@3.2.4':
+    resolution: {integrity: sha512-dEYtS7qQP2CjU27QBC5oUOxLE/v5eLkGqPE0ZKEIDGMs4vKWe7IjgLOeauHsR0D5YuuycGRO5oSRXnwnmA78fQ==}
+
   '@vitest/spy@2.1.9':
     resolution: {integrity: sha512-E1B35FwzXXTs9FHNK6bDszs7mtydNi5MIfUWpceJ8Xbfb1gBMscAnwLbEu+B44ed6W3XjL9/ehLPHR1fkf1KLQ==}
 
+  '@vitest/spy@3.2.4':
+    resolution: {integrity: sha512-vAfasCOe6AIK70iP5UD11Ac4siNUNJ9i/9PZ3NKx07sG6sUxeag1LWdNrMWeKKYBLlzuK+Gn65Yd5nyL6ds+nw==}
+
   '@vitest/utils@2.1.9':
     resolution: {integrity: sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==}
 
+  '@vitest/utils@3.2.4':
+    resolution: {integrity: sha512-fB2V0JFrQSMsCo9HiSq3Ezpdv4iYaXRG1Sx8edX3MwxfyNn83mKiGzOcH+Fkxt4MHxr3y42fQi1oeAInqgX2QA==}
+
   '@xmldom/xmldom@0.8.13':
     resolution: {integrity: sha512-KRYzxepc14G/CEpEGc3Yn+JKaAeT63smlDr+vjB8jRfgTBBI9wRj/nkQEO+ucV8p8I9bfKLWp37uHgFrbntPvw==}
     engines: {node: '>=10.0.0'}
@@ -4092,6 +4133,9 @@ packages:
   before-after-hook@4.0.0:
     resolution: {integrity: sha512-q6tR3RPqIB1pMiTRMFcZwuG5T8vwp+vUvEG0vuI6B+Rikh5BfPp2fQ82c925FOs+b0lcFQ8CFrL+KbilfZFhOQ==}
 
+  better-sqlite3@11.10.0:
+    resolution: {integrity: sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ==}
+
   better-sqlite3@12.9.0:
     resolution: {integrity: sha512-wqUv4Gm3toFpHDQmaKD4QhZm3g1DjUBI0yzS4UBl6lElUmXFYdTQmmEDpAFa5o8FiFiymURypEnfVHzILKaxqQ==}
     engines: {node: 20.x || 22.x || 23.x || 24.x || 25.x}
@@ -5950,6 +5994,9 @@ packages:
   js-tokens@4.0.0:
     resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
 
+  js-tokens@9.0.1:
+    resolution: {integrity: sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==}
+
   js-yaml@4.1.1:
     resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==}
     hasBin: true
@@ -6023,6 +6070,7 @@ packages:
 
   libsql@0.5.29:
     resolution: {integrity: sha512-8lMP8iMgiBzzoNbAPQ59qdVcj6UaE/Vnm+fiwX4doX4Narook0a4GPKWBEv+CR8a1OwbfkgL18uBfBjWdF0Fzg==}
+    cpu: [x64, arm64, wasm32, arm]
     os: [darwin, linux, win32]
 
   lie@3.3.0:
@@ -7787,6 +7835,9 @@ packages:
     resolution: {integrity: sha512-1tB5mhVo7U+ETBKNf92xT4hrQa3pm0MZ0PQvuDnWgAAGHDsfp4lPSpiS6psrSiet87wyGPh9ft6wmhOMQ0hDiw==}
     engines: {node: '>=14.16'}
 
+  strip-literal@3.1.0:
+    resolution: {integrity: sha512-8r3mkIM/2+PpjHoOtiAW8Rg3jJLHaV7xPwG+YRGrv6FP0wwk/toTpATxWYOW0BKdWwl82VT2tFYi5DlROa0Mxg==}
+
   stripe@22.0.2:
     resolution: {integrity: sha512-2/BLrQ3oB1zlNfeL/LfHFjTGx6EQn0j+ztrrTJHuDjV5VVIpk92oSDaxyKLUr3pG3dnee2LZqhFUv2Bf0G1/3g==}
     engines: {node: '>=18'}
@@ -7945,10 +7996,18 @@ packages:
     resolution: {integrity: sha512-weEDEq7Z5eTHPDh4xjX789+fHfF+P8boiFB+0vbWzpbnbsEr/GRaohi/uMKxg8RZMXnl1ItAi/IUHWMsjDV7kQ==}
     engines: {node: '>=14.0.0'}
 
+  tinyrainbow@2.0.0:
+    resolution: {integrity: sha512-op4nsTR47R6p0vMUUoYl/a+ljLFVtlfaXkLQmqfLR1qHma1h/ysYk4hEXZ880bf2CYgTskvTa/e196Vd5dDQXw==}
+    engines: {node: '>=14.0.0'}
+
   tinyspy@3.0.2:
     resolution: {integrity: sha512-n1cw8k1k0x4pgA2+9XrOkFydTerNcJ1zWCO5Nn9scWHTD+5tp8dghT2x1uduQePZTZgd3Tupf+x9BxJjeJi77Q==}
     engines: {node: '>=14.0.0'}
 
+  tinyspy@4.0.4:
+    resolution: {integrity: sha512-azl+t0z7pw/z958Gy9svOTuzqIk6xq+NSheJzn5MMWtWTFywIacg2wUlzKFGtt3cthx0r2SxMK0yzJOR0IES7Q==}
+    engines: {node: '>=14.0.0'}
+
   tmp-promise@3.0.3:
     resolution: {integrity: sha512-RwM7MoPojPxsOBYnyd2hy0bxtIlVrihNs9pj5SUvY8Zz1sQcQG2tG1hSr8PDxfgEB8RNKDhqbIlroIarSNDNsQ==}
 
@@ -8237,6 +8296,11 @@ packages:
     engines: {node: ^18.0.0 || >=20.0.0}
     hasBin: true
 
+  vite-node@3.2.4:
+    resolution: {integrity: sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg==}
+    engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
+    hasBin: true
+
   vite@5.4.21:
     resolution: {integrity: sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==}
     engines: {node: ^18.0.0 || >=20.0.0}
@@ -8336,6 +8400,34 @@ packages:
       jsdom:
         optional: true
 
+  vitest@3.2.4:
+    resolution: {integrity: sha512-LUCP5ev3GURDysTWiP47wRRUpLKMOfPh+yKTx3kVIEiu5KOMeqzpnYNsKyOoVrULivR8tLcks4+lga33Whn90A==}
+    engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0}
+    hasBin: true
+    peerDependencies:
+      '@edge-runtime/vm': '*'
+      '@types/debug': ^4.1.12
+      '@types/node': ^18.0.0 || ^20.0.0 || >=22.0.0
+      '@vitest/browser': 3.2.4
+      '@vitest/ui': 3.2.4
+      happy-dom: '*'
+      jsdom: '*'
+    peerDependenciesMeta:
+      '@edge-runtime/vm':
+        optional: true
+      '@types/debug':
+        optional: true
+      '@types/node':
+        optional: true
+      '@vitest/browser':
+        optional: true
+      '@vitest/ui':
+        optional: true
+      happy-dom:
+        optional: true
+      jsdom:
+        optional: true
+
   w3c-keyname@2.2.8:
     resolution: {integrity: sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ==}
 
@@ -11526,6 +11618,11 @@ snapshots:
       '@types/node': 22.19.3
       '@types/responselike': 1.0.3
 
+  '@types/chai@5.2.3':
+    dependencies:
+      '@types/deep-eql': 4.0.2
+      assertion-error: 2.0.1
+
   '@types/connect@3.4.38':
     dependencies:
       '@types/node': 22.19.3
@@ -11534,6 +11631,8 @@ snapshots:
     dependencies:
       '@types/ms': 2.1.0
 
+  '@types/deep-eql@4.0.2': {}
+
   '@types/estree-jsx@1.0.5':
     dependencies:
       '@types/estree': 1.0.8
@@ -11813,6 +11912,14 @@ snapshots:
       chai: 5.3.3
       tinyrainbow: 1.2.0
 
+  '@vitest/expect@3.2.4':
+    dependencies:
+      '@types/chai': 5.2.3
+      '@vitest/spy': 3.2.4
+      '@vitest/utils': 3.2.4
+      chai: 5.3.3
+      tinyrainbow: 2.0.0
+
   '@vitest/mocker@2.1.9(vite@5.4.21(@types/node@25.6.0)(lightningcss@1.32.0))':
     dependencies:
       '@vitest/spy': 2.1.9
@@ -11821,31 +11928,65 @@ snapshots:
     optionalDependencies:
       vite: 5.4.21(@types/node@25.6.0)(lightningcss@1.32.0)
 
+  '@vitest/mocker@3.2.4(vite@5.4.21(@types/node@22.19.3)(lightningcss@1.32.0))':
+    dependencies:
+      '@vitest/spy': 3.2.4
+      estree-walker: 3.0.3
+      magic-string: 0.30.21
+    optionalDependencies:
+      vite: 5.4.21(@types/node@22.19.3)(lightningcss@1.32.0)
+
   '@vitest/pretty-format@2.1.9':
     dependencies:
       tinyrainbow: 1.2.0
 
+  '@vitest/pretty-format@3.2.4':
+    dependencies:
+      tinyrainbow: 2.0.0
+
   '@vitest/runner@2.1.9':
     dependencies:
       '@vitest/utils': 2.1.9
       pathe: 1.1.2
 
+  '@vitest/runner@3.2.4':
+    dependencies:
+      '@vitest/utils': 3.2.4
+      pathe: 2.0.3
+      strip-literal: 3.1.0
+
   '@vitest/snapshot@2.1.9':
     dependencies:
       '@vitest/pretty-format': 2.1.9
       magic-string: 0.30.21
       pathe: 1.1.2
 
+  '@vitest/snapshot@3.2.4':
+    dependencies:
+      '@vitest/pretty-format': 3.2.4
+      magic-string: 0.30.21
+      pathe: 2.0.3
+
   '@vitest/spy@2.1.9':
     dependencies:
       tinyspy: 3.0.2
 
+  '@vitest/spy@3.2.4':
+    dependencies:
+      tinyspy: 4.0.4
+
   '@vitest/utils@2.1.9':
     dependencies:
       '@vitest/pretty-format': 2.1.9
       loupe: 3.2.1
       tinyrainbow: 1.2.0
 
+  '@vitest/utils@3.2.4':
+    dependencies:
+      '@vitest/pretty-format': 3.2.4
+      loupe: 3.2.1
+      tinyrainbow: 2.0.0
+
   '@xmldom/xmldom@0.8.13': {}
 
   abbrev@1.1.1: {}
@@ -12102,6 +12243,11 @@ snapshots:
 
   before-after-hook@4.0.0: {}
 
+  better-sqlite3@11.10.0:
+    dependencies:
+      bindings: 1.5.0
+      prebuild-install: 7.1.3
+
   better-sqlite3@12.9.0:
     dependencies:
       bindings: 1.5.0
@@ -14257,6 +14403,8 @@ snapshots:
 
   js-tokens@4.0.0: {}
 
+  js-tokens@9.0.1: {}
+
   js-yaml@4.1.1:
     dependencies:
       argparse: 2.0.1
@@ -16375,7 +16523,8 @@ snapshots:
   sprintf-js@1.1.3:
     optional: true
 
-  sql.js@1.14.1: {}
+  sql.js@1.14.1:
+    optional: true
 
   ssri@9.0.1:
     dependencies:
@@ -16460,6 +16609,10 @@ snapshots:
 
   strip-json-comments@5.0.3: {}
 
+  strip-literal@3.1.0:
+    dependencies:
+      js-tokens: 9.0.1
+
   stripe@22.0.2(@types/node@25.6.0):
     optionalDependencies:
       '@types/node': 25.6.0
@@ -16618,8 +16771,12 @@ snapshots:
 
   tinyrainbow@1.2.0: {}
 
+  tinyrainbow@2.0.0: {}
+
   tinyspy@3.0.2: {}
 
+  tinyspy@4.0.4: {}
+
   tmp-promise@3.0.3:
     dependencies:
       tmp: 0.2.5
@@ -16971,6 +17128,24 @@ snapshots:
       - supports-color
       - terser
 
+  vite-node@3.2.4(@types/node@22.19.3)(lightningcss@1.32.0):
+    dependencies:
+      cac: 6.7.14
+      debug: 4.4.3
+      es-module-lexer: 1.7.0
+      pathe: 2.0.3
+      vite: 5.4.21(@types/node@22.19.3)(lightningcss@1.32.0)
+    transitivePeerDependencies:
+      - '@types/node'
+      - less
+      - lightningcss
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+
   vite@5.4.21(@types/node@20.19.27)(lightningcss@1.32.0):
     dependencies:
       esbuild: 0.21.5
@@ -17137,6 +17312,45 @@ snapshots:
       - supports-color
       - terser
 
+  vitest@3.2.4(@types/debug@4.1.13)(@types/node@22.19.3)(lightningcss@1.32.0):
+    dependencies:
+      '@types/chai': 5.2.3
+      '@vitest/expect': 3.2.4
+      '@vitest/mocker': 3.2.4(vite@5.4.21(@types/node@22.19.3)(lightningcss@1.32.0))
+      '@vitest/pretty-format': 3.2.4
+      '@vitest/runner': 3.2.4
+      '@vitest/snapshot': 3.2.4
+      '@vitest/spy': 3.2.4
+      '@vitest/utils': 3.2.4
+      chai: 5.3.3
+      debug: 4.4.3
+      expect-type: 1.3.0
+      magic-string: 0.30.21
+      pathe: 2.0.3
+      picomatch: 4.0.4
+      std-env: 3.10.0
+      tinybench: 2.9.0
+      tinyexec: 0.3.2
+      tinyglobby: 0.2.16
+      tinypool: 1.1.1
+      tinyrainbow: 2.0.0
+      vite: 5.4.21(@types/node@22.19.3)(lightningcss@1.32.0)
+      vite-node: 3.2.4(@types/node@22.19.3)(lightningcss@1.32.0)
+      why-is-node-running: 2.3.0
+    optionalDependencies:
+      '@types/debug': 4.1.13
+      '@types/node': 22.19.3
+    transitivePeerDependencies:
+      - less
+      - lightningcss
+      - msw
+      - sass
+      - sass-embedded
+      - stylus
+      - sugarss
+      - supports-color
+      - terser
+
   w3c-keyname@2.2.8: {}
 
   wcwidth@1.0.1: