@outfitter/index 0.2.3 → 0.2.4

package/README.md

@@ -54,12 +54,12 @@ Creates an FTS5 full-text search index.
 
 ```typescript
 interface IndexOptions {
-  path: string;                   // Path to SQLite database file
-  tableName?: string;             // FTS5 table name (default: "documents")
-  tokenizer?: TokenizerType;      // Tokenizer (default: "unicode61")
-  tool?: string;                  // Tool identifier for metadata
-  toolVersion?: string;           // Tool version for metadata
-  migrations?: IndexMigrationRegistry;  // Optional migration registry
+  path: string; // Path to SQLite database file
+  tableName?: string; // FTS5 table name (default: "documents")
+  tokenizer?: TokenizerType; // Tokenizer (default: "unicode61")
+  tool?: string; // Tool identifier for metadata
+  toolVersion?: string; // Tool version for metadata
+  migrations?: IndexMigrationRegistry; // Optional migration registry
 }
 
 const index = createIndex<MyMetadata>({
@@ -71,11 +71,11 @@ const index = createIndex<MyMetadata>({
 
 ### Tokenizer Types
 
-| Tokenizer | Use Case |
-|-----------|----------|
-| `unicode61` | Default, Unicode-aware word tokenization |
-| `porter` | English text with stemming (finds "running" when searching "run") |
-| `trigram` | Substring matching, typo tolerance |
+| Tokenizer   | Use Case                                                          |
+| ----------- | ----------------------------------------------------------------- |
+| `unicode61` | Default, Unicode-aware word tokenization                          |
+| `porter`    | English text with stemming (finds "running" when searching "run") |
+| `trigram`   | Substring matching, typo tolerance                                |
 
 ### Index Methods
 
@@ -105,9 +105,9 @@ interface Index<T = unknown> {
 
 ```typescript
 interface IndexDocument {
-  id: string;                           // Unique document ID
-  content: string;                      // Searchable text
-  metadata?: Record<string, unknown>;   // Optional metadata (stored as JSON)
+  id: string; // Unique document ID
+  content: string; // Searchable text
+  metadata?: Record<string, unknown>; // Optional metadata (stored as JSON)
 }
 
 await index.add({
@@ -125,9 +125,9 @@ await index.add({
 
 ```typescript
 interface SearchQuery {
-  query: string;    // FTS5 query string
-  limit?: number;   // Max results (default: 25)
-  offset?: number;  // Skip results for pagination (default: 0)
+  query: string; // FTS5 query string
+  limit?: number; // Max results (default: 25)
+  offset?: number; // Skip results for pagination (default: 0)
 }
 
 // Simple search
@@ -145,24 +145,24 @@ const paged = await index.search({
 
 FTS5 supports powerful query syntax:
 
-| Syntax | Example | Description |
-|--------|---------|-------------|
-| Terms | `typescript bun` | Match all terms (implicit AND) |
-| Phrase | `"error handling"` | Exact phrase match |
-| OR | `ts OR typescript` | Match either term |
-| NOT | `typescript NOT javascript` | Exclude term |
-| Prefix | `type*` | Prefix matching |
-| Grouping | `(react OR vue) AND typescript` | Complex queries |
+| Syntax   | Example                         | Description                    |
+| -------- | ------------------------------- | ------------------------------ |
+| Terms    | `typescript bun`                | Match all terms (implicit AND) |
+| Phrase   | `"error handling"`              | Exact phrase match             |
+| OR       | `ts OR typescript`              | Match either term              |
+| NOT      | `typescript NOT javascript`     | Exclude term                   |
+| Prefix   | `type*`                         | Prefix matching                |
+| Grouping | `(react OR vue) AND typescript` | Complex queries                |
 
 ### Search Results
 
 ```typescript
 interface SearchResult<T = unknown> {
-  id: string;           // Document ID
-  content: string;      // Full document content
-  score: number;        // BM25 relevance (negative; closer to 0 = better match)
-  metadata?: T;         // Document metadata
-  highlights?: string[];  // Matching snippets with <b> tags
+  id: string; // Document ID
+  content: string; // Full document content
+  score: number; // BM25 relevance (negative; closer to 0 = better match)
+  metadata?: T; // Document metadata
+  highlights?: string[]; // Matching snippets with <b> tags
 }
 
 const results = await index.search({ query: "hello world" });
@@ -232,7 +232,7 @@ interface IndexMigrationRegistry {
 }
 
 interface IndexMigrationContext {
-  db: Database;  // bun:sqlite Database instance
+  db: Database; // bun:sqlite Database instance
 }
 ```
 
@@ -242,10 +242,10 @@ Indexes store metadata for tracking provenance:
 
 ```typescript
 interface IndexMetadata {
-  version: number;      // Schema version
-  created: string;      // ISO timestamp
-  tool: string;         // Creating tool identifier
-  toolVersion: string;  // Creating tool version
+  version: number; // Schema version
+  created: string; // ISO timestamp
+  tool: string; // Creating tool identifier
+  toolVersion: string; // Creating tool version
 }
 ```
 
@@ -273,6 +273,7 @@ if (result.isErr()) {
 ```
 
 Common error scenarios:
+
 - Index closed after `close()` called
 - Invalid table name or tokenizer
 - SQLite errors (disk full, permissions)

package/dist/fts5.js

@@ -1,8 +1,252 @@
 // @bun
 import {
-  createIndex
-} from "./shared/@outfitter/index-gf30ny51.js";
-import"./shared/@outfitter/index-bbzmc40h.js";
+  INDEX_META_KEY,
+  INDEX_META_TABLE,
+  INDEX_VERSION
+} from "./shared/@outfitter/index-bbzmc40h.js";
+
+// packages/index/src/fts5.ts
+import { Database } from "bun:sqlite";
+import { existsSync, mkdirSync } from "fs";
+import { dirname } from "path";
+import { Result } from "@outfitter/contracts";
+var DEFAULT_TABLE_NAME = "documents";
+var DEFAULT_TOKENIZER = "unicode61";
+var DEFAULT_LIMIT = 25;
+var DEFAULT_OFFSET = 0;
+var VALID_TOKENIZERS = {
+  unicode61: true,
+  porter: true,
+  trigram: true
+};
+var TABLE_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+var DEFAULT_TOOL = "outfitter-index";
+var DEFAULT_TOOL_VERSION = "0.0.0";
+function createStorageError(message, cause) {
+  return {
+    _tag: "StorageError",
+    message,
+    cause
+  };
+}
+function assertValidTableName(tableName) {
+  if (!TABLE_NAME_PATTERN.test(tableName)) {
+    throw new Error(`Invalid table name: ${tableName}`);
+  }
+}
+function assertValidTokenizer(tokenizer) {
+  if (!Object.hasOwn(VALID_TOKENIZERS, tokenizer)) {
+    throw new Error(`Invalid tokenizer: ${tokenizer}`);
+  }
+  return tokenizer;
+}
+function getUserVersion(db) {
+  const row = db.query("PRAGMA user_version").get();
+  return row?.user_version ?? 0;
+}
+function setUserVersion(db, version) {
+  if (!Number.isInteger(version) || version < 0) {
+    throw new Error(`Invalid user_version: ${version}`);
+  }
+  db.run(`PRAGMA user_version = ${version}`);
+}
+function ensureMetaTable(db) {
+  db.run(`CREATE TABLE IF NOT EXISTS ${INDEX_META_TABLE} (key TEXT PRIMARY KEY, value TEXT NOT NULL)`);
+}
+function readIndexMetadata(db) {
+  try {
+    const row = db.query(`SELECT value FROM ${INDEX_META_TABLE} WHERE key = ?`).get(INDEX_META_KEY);
+    if (!row) {
+      return null;
+    }
+    const parsed = JSON.parse(row.value);
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function writeIndexMetadata(db, metadata) {
+  ensureMetaTable(db);
+  db.run(`INSERT OR REPLACE INTO ${INDEX_META_TABLE} (key, value) VALUES (?, ?)`, [INDEX_META_KEY, JSON.stringify(metadata)]);
+}
+function createIndex(options) {
+  const tableName = options.tableName ?? DEFAULT_TABLE_NAME;
+  assertValidTableName(tableName);
+  const tokenizer = assertValidTokenizer(options.tokenizer ?? DEFAULT_TOKENIZER);
+  const tool = options.tool ?? DEFAULT_TOOL;
+  const toolVersion = options.toolVersion ?? DEFAULT_TOOL_VERSION;
+  const dir = dirname(options.path);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  const db = new Database(options.path);
+  db.run("PRAGMA journal_mode=WAL");
+  const currentVersion = getUserVersion(db);
+  if (currentVersion === 0) {
+    const metadata = {
+      version: INDEX_VERSION,
+      created: new Date().toISOString(),
+      tool,
+      toolVersion
+    };
+    setUserVersion(db, INDEX_VERSION);
+    writeIndexMetadata(db, metadata);
+  } else if (currentVersion !== INDEX_VERSION) {
+    if (!options.migrations) {
+      throw new Error(`Index version ${currentVersion} does not match ${INDEX_VERSION}. Provide migrations or rebuild the index.`);
+    }
+    const context = { db };
+    const result = options.migrations.migrate(context, currentVersion, INDEX_VERSION);
+    if (result.isErr()) {
+      throw new Error(`Failed to migrate index: ${result.error.message}`);
+    }
+    const existing = readIndexMetadata(db);
+    const metadata = {
+      version: INDEX_VERSION,
+      created: existing?.created ?? new Date().toISOString(),
+      tool,
+      toolVersion
+    };
+    setUserVersion(db, INDEX_VERSION);
+    writeIndexMetadata(db, metadata);
+  } else if (!readIndexMetadata(db)) {
+    const metadata = {
+      version: INDEX_VERSION,
+      created: new Date().toISOString(),
+      tool,
+      toolVersion
+    };
+    writeIndexMetadata(db, metadata);
+  }
+  db.run(`
+		CREATE VIRTUAL TABLE IF NOT EXISTS ${tableName}
+		USING fts5(
+			id UNINDEXED,
+			content,
+			metadata UNINDEXED,
+			tokenize='${tokenizer}'
+		)
+	`);
+  let isClosed = false;
+  function checkClosed() {
+    if (isClosed) {
+      return Result.err(createStorageError("Index is closed"));
+    }
+    return Result.ok(undefined);
+  }
+  return {
+    async add(doc) {
+      const closedCheck = checkClosed();
+      if (closedCheck.isErr()) {
+        return closedCheck;
+      }
+      try {
+        const metadataJson = doc.metadata ? JSON.stringify(doc.metadata) : null;
+        db.run(`DELETE FROM ${tableName} WHERE id = ?`, [doc.id]);
+        db.run(`INSERT INTO ${tableName} (id, content, metadata) VALUES (?, ?, ?)`, [doc.id, doc.content, metadataJson]);
+        return Result.ok(undefined);
+      } catch (error) {
+        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to add document", error));
+      }
+    },
+    async addMany(docs) {
+      const closedCheck = checkClosed();
+      if (closedCheck.isErr()) {
+        return closedCheck;
+      }
+      try {
+        db.run("BEGIN TRANSACTION");
+        try {
+          const deleteStmt = db.prepare(`DELETE FROM ${tableName} WHERE id = ?`);
+          const insertStmt = db.prepare(`INSERT INTO ${tableName} (id, content, metadata) VALUES (?, ?, ?)`);
+          for (const doc of docs) {
+            const metadataJson = doc.metadata ? JSON.stringify(doc.metadata) : null;
+            deleteStmt.run(doc.id);
+            insertStmt.run(doc.id, doc.content, metadataJson);
+          }
+          deleteStmt.finalize();
+          insertStmt.finalize();
+          db.run("COMMIT");
+          return Result.ok(undefined);
+        } catch (error) {
+          db.run("ROLLBACK");
+          throw error;
+        }
+      } catch (error) {
+        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to add documents", error));
+      }
+    },
+    async search(query) {
+      const closedCheck = checkClosed();
+      if (closedCheck.isErr()) {
+        return closedCheck;
+      }
+      const limit = query.limit ?? DEFAULT_LIMIT;
+      const offset = query.offset ?? DEFAULT_OFFSET;
+      try {
+        const rows = db.query(`
+					SELECT
+						id,
+						content,
+						metadata,
+						bm25(${tableName}) as score,
+						snippet(${tableName}, 1, '<b>', '</b>', '...', 32) as highlight
+					FROM ${tableName}
+					WHERE ${tableName} MATCH ?
+					ORDER BY bm25(${tableName}) ASC
+					LIMIT ? OFFSET ?
+				`).all(query.query, limit, offset);
+        const results = rows.map((row) => {
+          const result = {
+            id: row.id,
+            content: row.content,
+            score: row.score,
+            highlights: [row.highlight]
+          };
+          if (row.metadata) {
+            try {
+              result.metadata = JSON.parse(row.metadata);
+            } catch {}
+          }
+          return result;
+        });
+        return Result.ok(results);
+      } catch (error) {
+        return Result.err(createStorageError(error instanceof Error ? error.message : "Search failed", error));
+      }
+    },
+    async remove(id) {
+      const closedCheck = checkClosed();
+      if (closedCheck.isErr()) {
+        return closedCheck;
+      }
+      try {
+        db.run(`DELETE FROM ${tableName} WHERE id = ?`, [id]);
+        return Result.ok(undefined);
+      } catch (error) {
+        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to remove document", error));
+      }
+    },
+    async clear() {
+      const closedCheck = checkClosed();
+      if (closedCheck.isErr()) {
+        return closedCheck;
+      }
+      try {
+        db.run(`DELETE FROM ${tableName}`);
+        return Result.ok(undefined);
+      } catch (error) {
+        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to clear index", error));
+      }
+    },
+    close() {
+      if (!isClosed) {
+        isClosed = true;
+        db.close();
+      }
+    }
+  };
+}
 export {
   createIndex
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { createIndex } from "./shared/@outfitter/index-ykxa3yhb.js";
-import { INDEX_VERSION } from "./shared/@outfitter/index-3xe3cd6r.js";
 import { Index, IndexDocument, IndexMetadata, IndexOptions, SearchQuery, SearchResult, TokenizerType } from "./shared/@outfitter/index-011azjav.js";
+import { INDEX_VERSION } from "./shared/@outfitter/index-3xe3cd6r.js";
 import { IndexMigrationRegistry, createMigrationRegistry } from "./shared/@outfitter/index-dxk50kvh.js";
 export { createMigrationRegistry, createIndex, TokenizerType, SearchResult, SearchQuery, IndexOptions, IndexMigrationRegistry, IndexMetadata, IndexDocument, Index, INDEX_VERSION };

package/dist/index.js

@@ -1,16 +1,4 @@
-// @bun
-import {
-  createIndex
-} from "./shared/@outfitter/index-gf30ny51.js";
-import {
-  createMigrationRegistry
-} from "./shared/@outfitter/index-1me624ny.js";
-import {
-  INDEX_VERSION
-} from "./shared/@outfitter/index-bbzmc40h.js";
-import"./shared/@outfitter/index-8fwmfq7d.js";
-export {
-  createMigrationRegistry,
-  createIndex,
-  INDEX_VERSION
-};
+export { createIndex } from "./fts5.js";
+export { createMigrationRegistry } from "./migrations.js";
+export * from "./types.js";
+export { INDEX_VERSION } from "./version.js";

package/dist/migrations.js

@@ -1,7 +1,47 @@
 // @bun
-import {
-  createMigrationRegistry
-} from "./shared/@outfitter/index-1me624ny.js";
+// packages/index/src/migrations.ts
+import { Result } from "@outfitter/contracts";
+function createStorageError(message, cause) {
+  return {
+    _tag: "StorageError",
+    message,
+    cause
+  };
+}
+function createMigrationRegistry() {
+  const steps = new Map;
+  return {
+    register(fromVersion, toVersion, migrate) {
+      steps.set(fromVersion, { to: toVersion, migrate });
+    },
+    migrate(context, fromVersion, toVersion) {
+      if (fromVersion === toVersion) {
+        return Result.ok(undefined);
+      }
+      let current = fromVersion;
+      const visited = new Set;
+      while (current < toVersion) {
+        if (visited.has(current)) {
+          return Result.err(createStorageError(`Detected migration loop at version ${current}`));
+        }
+        visited.add(current);
+        const step = steps.get(current);
+        if (!step) {
+          return Result.err(createStorageError(`No migration registered from version ${current}`));
+        }
+        const result = step.migrate(context);
+        if (result.isErr()) {
+          return result;
+        }
+        current = step.to;
+      }
+      if (current !== toVersion) {
+        return Result.err(createStorageError(`Migration ended at version ${current} instead of ${toVersion}`));
+      }
+      return Result.ok(undefined);
+    }
+  };
+}
 export {
   createMigrationRegistry
 };

package/package.json

@@ -1,11 +1,26 @@
 {
   "name": "@outfitter/index",
+  "version": "0.2.4",
   "description": "SQLite FTS5 full-text search indexing for Outfitter",
-  "version": "0.2.3",
-  "type": "module",
+  "keywords": [
+    "fts5",
+    "index",
+    "outfitter",
+    "search",
+    "sqlite",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/outfitter-dev/outfitter.git",
+    "directory": "packages/index"
+  },
   "files": [
     "dist"
   ],
+  "type": "module",
+  "sideEffects": false,
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -41,39 +56,24 @@
       }
     }
   },
-  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "cd ../.. && bunup --filter @outfitter/index",
-    "lint": "biome lint ./src",
-    "lint:fix": "biome lint --write ./src",
+    "lint": "oxlint ./src",
+    "lint:fix": "oxlint --fix ./src",
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun ../../scripts/check-publish-manifest.ts"
   },
   "dependencies": {
-    "@outfitter/contracts": "0.4.1",
-    "@outfitter/file-ops": "0.2.3"
+    "@outfitter/contracts": "0.4.2",
+    "@outfitter/file-ops": "0.2.4"
   },
   "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.8.0"
-  },
-  "keywords": [
-    "outfitter",
-    "index",
-    "fts5",
-    "sqlite",
-    "search",
-    "typescript"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/outfitter-dev/outfitter.git",
-    "directory": "packages/index"
-  },
-  "publishConfig": {
-    "access": "public"
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.9.3"
   }
 }

package/dist/shared/@outfitter/index-1me624ny.js

@@ -1,46 +0,0 @@
-// @bun
-// packages/index/src/migrations.ts
-import { Result } from "@outfitter/contracts";
-function createStorageError(message, cause) {
-  return {
-    _tag: "StorageError",
-    message,
-    cause
-  };
-}
-function createMigrationRegistry() {
-  const steps = new Map;
-  return {
-    register(fromVersion, toVersion, migrate) {
-      steps.set(fromVersion, { to: toVersion, migrate });
-    },
-    migrate(context, fromVersion, toVersion) {
-      if (fromVersion === toVersion) {
-        return Result.ok(undefined);
-      }
-      let current = fromVersion;
-      const visited = new Set;
-      while (current < toVersion) {
-        if (visited.has(current)) {
-          return Result.err(createStorageError(`Detected migration loop at version ${current}`));
-        }
-        visited.add(current);
-        const step = steps.get(current);
-        if (!step) {
-          return Result.err(createStorageError(`No migration registered from version ${current}`));
-        }
-        const result = step.migrate(context);
-        if (result.isErr()) {
-          return result;
-        }
-        current = step.to;
-      }
-      if (current !== toVersion) {
-        return Result.err(createStorageError(`Migration ended at version ${current} instead of ${toVersion}`));
-      }
-      return Result.ok(undefined);
-    }
-  };
-}
-
-export { createMigrationRegistry };

package/dist/shared/@outfitter/index-gf30ny51.js

@@ -1,251 +0,0 @@
-// @bun
-import {
-  INDEX_META_KEY,
-  INDEX_META_TABLE,
-  INDEX_VERSION
-} from "./index-bbzmc40h.js";
-
-// packages/index/src/fts5.ts
-import { Database } from "bun:sqlite";
-import { existsSync, mkdirSync } from "fs";
-import { dirname } from "path";
-import { Result } from "@outfitter/contracts";
-var DEFAULT_TABLE_NAME = "documents";
-var DEFAULT_TOKENIZER = "unicode61";
-var DEFAULT_LIMIT = 25;
-var DEFAULT_OFFSET = 0;
-var VALID_TOKENIZERS = {
-  unicode61: true,
-  porter: true,
-  trigram: true
-};
-var TABLE_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
-var DEFAULT_TOOL = "outfitter-index";
-var DEFAULT_TOOL_VERSION = "0.0.0";
-function createStorageError(message, cause) {
-  return {
-    _tag: "StorageError",
-    message,
-    cause
-  };
-}
-function assertValidTableName(tableName) {
-  if (!TABLE_NAME_PATTERN.test(tableName)) {
-    throw new Error(`Invalid table name: ${tableName}`);
-  }
-}
-function assertValidTokenizer(tokenizer) {
-  if (!Object.hasOwn(VALID_TOKENIZERS, tokenizer)) {
-    throw new Error(`Invalid tokenizer: ${tokenizer}`);
-  }
-  return tokenizer;
-}
-function getUserVersion(db) {
-  const row = db.query("PRAGMA user_version").get();
-  return row?.user_version ?? 0;
-}
-function setUserVersion(db, version) {
-  if (!Number.isInteger(version) || version < 0) {
-    throw new Error(`Invalid user_version: ${version}`);
-  }
-  db.run(`PRAGMA user_version = ${version}`);
-}
-function ensureMetaTable(db) {
-  db.run(`CREATE TABLE IF NOT EXISTS ${INDEX_META_TABLE} (key TEXT PRIMARY KEY, value TEXT NOT NULL)`);
-}
-function readIndexMetadata(db) {
-  try {
-    const row = db.query(`SELECT value FROM ${INDEX_META_TABLE} WHERE key = ?`).get(INDEX_META_KEY);
-    if (!row) {
-      return null;
-    }
-    const parsed = JSON.parse(row.value);
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-function writeIndexMetadata(db, metadata) {
-  ensureMetaTable(db);
-  db.run(`INSERT OR REPLACE INTO ${INDEX_META_TABLE} (key, value) VALUES (?, ?)`, [INDEX_META_KEY, JSON.stringify(metadata)]);
-}
-function createIndex(options) {
-  const tableName = options.tableName ?? DEFAULT_TABLE_NAME;
-  assertValidTableName(tableName);
-  const tokenizer = assertValidTokenizer(options.tokenizer ?? DEFAULT_TOKENIZER);
-  const tool = options.tool ?? DEFAULT_TOOL;
-  const toolVersion = options.toolVersion ?? DEFAULT_TOOL_VERSION;
-  const dir = dirname(options.path);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  const db = new Database(options.path);
-  db.run("PRAGMA journal_mode=WAL");
-  const currentVersion = getUserVersion(db);
-  if (currentVersion === 0) {
-    const metadata = {
-      version: INDEX_VERSION,
-      created: new Date().toISOString(),
-      tool,
-      toolVersion
-    };
-    setUserVersion(db, INDEX_VERSION);
-    writeIndexMetadata(db, metadata);
-  } else if (currentVersion !== INDEX_VERSION) {
-    if (!options.migrations) {
-      throw new Error(`Index version ${currentVersion} does not match ${INDEX_VERSION}. Provide migrations or rebuild the index.`);
-    }
-    const context = { db };
-    const result = options.migrations.migrate(context, currentVersion, INDEX_VERSION);
-    if (result.isErr()) {
-      throw new Error(`Failed to migrate index: ${result.error.message}`);
-    }
-    const existing = readIndexMetadata(db);
-    const metadata = {
-      version: INDEX_VERSION,
-      created: existing?.created ?? new Date().toISOString(),
-      tool,
-      toolVersion
-    };
-    setUserVersion(db, INDEX_VERSION);
-    writeIndexMetadata(db, metadata);
-  } else if (!readIndexMetadata(db)) {
-    const metadata = {
-      version: INDEX_VERSION,
-      created: new Date().toISOString(),
-      tool,
-      toolVersion
-    };
-    writeIndexMetadata(db, metadata);
-  }
-  db.run(`
-		CREATE VIRTUAL TABLE IF NOT EXISTS ${tableName}
-		USING fts5(
-			id UNINDEXED,
-			content,
-			metadata UNINDEXED,
-			tokenize='${tokenizer}'
-		)
-	`);
-  let isClosed = false;
-  function checkClosed() {
-    if (isClosed) {
-      return Result.err(createStorageError("Index is closed"));
-    }
-    return Result.ok(undefined);
-  }
-  return {
-    async add(doc) {
-      const closedCheck = checkClosed();
-      if (closedCheck.isErr()) {
-        return closedCheck;
-      }
-      try {
-        const metadataJson = doc.metadata ? JSON.stringify(doc.metadata) : null;
-        db.run(`DELETE FROM ${tableName} WHERE id = ?`, [doc.id]);
-        db.run(`INSERT INTO ${tableName} (id, content, metadata) VALUES (?, ?, ?)`, [doc.id, doc.content, metadataJson]);
-        return Result.ok(undefined);
-      } catch (error) {
-        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to add document", error));
-      }
-    },
-    async addMany(docs) {
-      const closedCheck = checkClosed();
-      if (closedCheck.isErr()) {
-        return closedCheck;
-      }
-      try {
-        db.run("BEGIN TRANSACTION");
-        try {
-          const deleteStmt = db.prepare(`DELETE FROM ${tableName} WHERE id = ?`);
-          const insertStmt = db.prepare(`INSERT INTO ${tableName} (id, content, metadata) VALUES (?, ?, ?)`);
-          for (const doc of docs) {
-            const metadataJson = doc.metadata ? JSON.stringify(doc.metadata) : null;
-            deleteStmt.run(doc.id);
-            insertStmt.run(doc.id, doc.content, metadataJson);
-          }
-          deleteStmt.finalize();
-          insertStmt.finalize();
-          db.run("COMMIT");
-          return Result.ok(undefined);
-        } catch (error) {
-          db.run("ROLLBACK");
-          throw error;
-        }
-      } catch (error) {
-        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to add documents", error));
-      }
-    },
-    async search(query) {
-      const closedCheck = checkClosed();
-      if (closedCheck.isErr()) {
-        return closedCheck;
-      }
-      const limit = query.limit ?? DEFAULT_LIMIT;
-      const offset = query.offset ?? DEFAULT_OFFSET;
-      try {
-        const rows = db.query(`
-					SELECT
-						id,
-						content,
-						metadata,
-						bm25(${tableName}) as score,
-						snippet(${tableName}, 1, '<b>', '</b>', '...', 32) as highlight
-					FROM ${tableName}
-					WHERE ${tableName} MATCH ?
-					ORDER BY bm25(${tableName}) ASC
-					LIMIT ? OFFSET ?
-				`).all(query.query, limit, offset);
-        const results = rows.map((row) => {
-          const result = {
-            id: row.id,
-            content: row.content,
-            score: row.score,
-            highlights: [row.highlight]
-          };
-          if (row.metadata) {
-            try {
-              result.metadata = JSON.parse(row.metadata);
-            } catch {}
-          }
-          return result;
-        });
-        return Result.ok(results);
-      } catch (error) {
-        return Result.err(createStorageError(error instanceof Error ? error.message : "Search failed", error));
-      }
-    },
-    async remove(id) {
-      const closedCheck = checkClosed();
-      if (closedCheck.isErr()) {
-        return closedCheck;
-      }
-      try {
-        db.run(`DELETE FROM ${tableName} WHERE id = ?`, [id]);
-        return Result.ok(undefined);
-      } catch (error) {
-        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to remove document", error));
-      }
-    },
-    async clear() {
-      const closedCheck = checkClosed();
-      if (closedCheck.isErr()) {
-        return closedCheck;
-      }
-      try {
-        db.run(`DELETE FROM ${tableName}`);
-        return Result.ok(undefined);
-      } catch (error) {
-        return Result.err(createStorageError(error instanceof Error ? error.message : "Failed to clear index", error));
-      }
-    },
-    close() {
-      if (!isClosed) {
-        isClosed = true;
-        db.close();
-      }
-    }
-  };
-}
-
-export { createIndex };