@jacebenson/jsn 4.3.11 → 4.3.12-dev.70

package/src/commands/docs/docs.js

@@ -4,16 +4,6 @@ import fs from 'node:fs';
 import path from 'node:path';
 import net from 'node:net';
 import process from 'node:process';
-import {
-  getDocsDbPath, getDocsSourceDir, getDocsSourceMarkdownDir, docsDbExists,
-  openDocsDb, closeDocsDb, getDocsIndexStats,
-} from './db.js';
-import { syncDocs } from './sync.js';
-import { refreshDocs } from './refresh.js';
-import { embedDocs } from './embed.js';
-import { searchDocs, getDocByIdOrPath } from './search.js';
-import { serveDocs } from './serve.js';
-import { syncCommunity, listCommunityDocs } from './community.js';
 import { declareCapabilities } from '../../capabilities.js';
 import { formatCommandList } from '../../helpers.js';
 
@@ -39,6 +29,8 @@ export function docsCmd(wrap) {
             .option('no-embed', { type: 'boolean', describe: 'Skip HRR semantic embeddings' })
             .option('no-ingest', { type: 'boolean', describe: 'Clone/pull only; do not rebuild index' }),
           handler: wrap(async (argv, app) => {
+            const { getDocsDbPath, getDocsSourceMarkdownDir } = await import('./db.js');
+            const { syncDocs } = await import('./sync.js');
             const result = syncDocs({
               markdownDir: getDocsSourceMarkdownDir(),
               dbPath: getDocsDbPath(),
@@ -52,6 +44,7 @@ export function docsCmd(wrap) {
           command: 'status',
           describe: 'Show docs database status',
           handler: wrap(async (argv, app) => {
+            const { getDocsDbPath, getDocsSourceDir, getDocsSourceMarkdownDir, docsDbExists, withDocsDb, getDocsIndexStats } = await import('./db.js');
             const dbPath = getDocsDbPath();
             const repoDir = getDocsSourceDir();
             const markdownDir = getDocsSourceMarkdownDir();
@@ -60,12 +53,10 @@ export function docsCmd(wrap) {
 
             let state, embedded, documents, bundles, docTypes, syncedAt, dbSize;
             if (dbExists) {
-              const db = openDocsDb();
-              const stats = getDocsIndexStats(db);
+              const stats = withDocsDb({}, (db) => getDocsIndexStats(db));
               ({ documents, bundles, docTypes, syncedAt } = stats);
               const stat = fs.statSync(dbPath);
               dbSize = stat.size;
-              closeDocsDb(db);
 
               embedded = stats.embeddedCount >= documents && documents > 0;
               if (embedded) state = 'ready';
@@ -108,6 +99,7 @@ export function docsCmd(wrap) {
             .option('doc-type', { type: 'string', describe: 'Filter by doc type' })
             .option('mode', { type: 'string', choices: ['keyword', 'hybrid'], default: 'hybrid', describe: 'Search mode' }),
           handler: wrap(async (argv, app) => {
+            const { searchDocs } = await import('./search.js');
             const result = searchDocs({
               query: argv.query,
               limit: argv.limit,
@@ -154,6 +146,7 @@ export function docsCmd(wrap) {
             .positional('id-or-path', { type: 'string', describe: 'Document id (number) or file path' })
             .option('lines', { type: 'number', default: 80, describe: 'Lines of body to show in terminal (use --json for full content)' }),
           handler: wrap(async (argv, app) => {
+            const { getDocByIdOrPath } = await import('./search.js');
             const idOrPath = argv['id-or-path'];
             const row = getDocByIdOrPath(idOrPath);
 
@@ -192,6 +185,7 @@ export function docsCmd(wrap) {
             .option('host', { type: 'string', default: '127.0.0.1', describe: 'Bind address' })
             .option('expose', { type: 'boolean', default: false, describe: 'Bind to 0.0.0.0 to expose on the network' }),
           handler: wrap(async (argv, _app) => {
+            const { serveDocs } = await import('./serve.js');
             try {
               const host = argv.expose ? '0.0.0.0' : argv.host;
               await serveDocs({ port: argv.port, host });
@@ -205,6 +199,7 @@ export function docsCmd(wrap) {
           command: 'embed',
           describe: 'Backfill or refresh HRR semantic embeddings',
           handler: wrap(async (argv, app) => {
+            const { embedDocs } = await import('./embed.js');
             const result = embedDocs();
             app.ok(result, { summary: `Embedded ${result.embedded} of ${result.total} docs` });
           }),
@@ -213,6 +208,8 @@ export function docsCmd(wrap) {
           command: 'refresh',
           describe: 'Incrementally refresh docs.db from existing source clone',
           handler: wrap(async (argv, app) => {
+            const { getDocsSourceMarkdownDir } = await import('./db.js');
+            const { refreshDocs } = await import('./refresh.js');
             const result = refreshDocs({ docsDir: getDocsSourceMarkdownDir() });
             app.ok(result, { summary: `Refresh complete: +${result.added} ~${result.updated} -${result.removed} =${result.unchanged}` });
           }),
@@ -230,6 +227,7 @@ export function docsCmd(wrap) {
                 .option('sources', { type: 'string', describe: 'Path to a community-sources.json (default: bundled)' })
                 .option('delay-ms', { type: 'number', describe: 'Delay between article fetches (default: 500)' }),
               handler: wrap(async (argv, app) => {
+                const { syncCommunity } = await import('./community.js');
                 const result = await syncCommunity({
                   sourcesFile: argv.sources,
                   expand: argv.expand === true,
@@ -245,6 +243,7 @@ export function docsCmd(wrap) {
               command: 'list',
               describe: 'List community docs currently in the index',
               handler: wrap(async (argv, app) => {
+                const { listCommunityDocs } = await import('./community.js');
                 const result = listCommunityDocs();
                 const lines = result.docs.map((d) => `[${d.id}] ${d.title || d.path} (${d.doc_type})`);
                 app.ok({
@@ -258,6 +257,7 @@ export function docsCmd(wrap) {
         });
     },
     handler: wrap(async (argv, app) => {
+      const { getDocsDbPath } = await import('./db.js');
       const subcommands = argv.subcommands || [];
       const summary = 'jsn docs — ServiceNow documentation search (sync, status, search, show, serve).';
       app.ok({

package/src/commands/docs/embed.js

@@ -1,7 +1,7 @@
 // Populate HRR phase-vector embeddings for semantic reranking.
 
 import fs from 'node:fs';
-import { openDocsDb, closeDocsDb, getDocsDbPath } from './db.js';
+import { withDocsDb, getDocsDbPath } from './db.js';
 import { encodeText, phasesToBytes, docSurface, DEFAULT_DIM } from './hrr.js';
 
 export function embedDocs(opts = {}) {
@@ -11,36 +11,36 @@ export function embedDocs(opts = {}) {
     throw new Error(`Database not found: ${dbPath}. Run "jsn docs sync" first.`);
   }
 
-  const db = openDocsDb({ dbPath });
-
-  const cols = db.prepare('PRAGMA table_info(docs)').all();
-  if (!cols.some((c) => c.name === 'hrr_vector')) {
-    db.exec('ALTER TABLE docs ADD COLUMN hrr_vector BLOB');
-  }
-
-  db.exec("CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT)");
-  db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('hrr_dim', ?)").run(String(DEFAULT_DIM));
-
-  const rows = db.prepare('SELECT id, title, body FROM docs WHERE hrr_vector IS NULL').all();
-  const total = db.prepare('SELECT COUNT(*) AS n FROM docs').get().n;
-
-  const update = db.prepare('UPDATE docs SET hrr_vector = ? WHERE id = ?');
-  const started = Date.now();
-  let n = 0;
-
-  db.exec('BEGIN');
-  for (const row of rows) {
-    const surface = docSurface(row.title, row.body);
-    const vec = encodeText(surface, DEFAULT_DIM);
-    update.run(phasesToBytes(vec), row.id);
-    n++;
-    if (n % 5000 === 0) process.stderr.write(`  ...${n}\n`);
-  }
-  db.exec('COMMIT');
-  db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
-  db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('embeddings', ?)").run('true');
-  closeDocsDb(db);
-
-  const secs = ((Date.now() - started) / 1000).toFixed(1);
-  return { embedded: n, total, secs, dbPath };
+  return withDocsDb({ dbPath }, (db) => {
+
+    const cols = db.prepare('PRAGMA table_info(docs)').all();
+    if (!cols.some((c) => c.name === 'hrr_vector')) {
+      db.exec('ALTER TABLE docs ADD COLUMN hrr_vector BLOB');
+    }
+
+    db.exec("CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT)");
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('hrr_dim', ?)").run(String(DEFAULT_DIM));
+
+    const rows = db.prepare('SELECT id, title, body FROM docs WHERE hrr_vector IS NULL').all();
+    const total = db.prepare('SELECT COUNT(*) AS n FROM docs').get().n;
+
+    const update = db.prepare('UPDATE docs SET hrr_vector = ? WHERE id = ?');
+    const started = Date.now();
+    let n = 0;
+
+    db.exec('BEGIN');
+    for (const row of rows) {
+      const surface = docSurface(row.title, row.body);
+      const vec = encodeText(surface, DEFAULT_DIM);
+      update.run(phasesToBytes(vec), row.id);
+      n++;
+      if (n % 5000 === 0) process.stderr.write(`  ...${n}\n`);
+    }
+    db.exec('COMMIT');
+    db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('embeddings', ?)").run('true');
+
+    const secs = ((Date.now() - started) / 1000).toFixed(1);
+    return { embedded: n, total, secs, dbPath };
+  });
 }

package/src/commands/docs/ingest.js

@@ -3,7 +3,7 @@
 import fs from 'node:fs';
 import { createHash } from 'node:crypto';
 import { parseFrontmatter } from '../../frontmatter.js';
-import { openDocsDb, closeDocsDb, initDocsSchema, getDocsDbPath, walkDocs, defaultDocsRoots } from './db.js';
+import { withDocsDb, initDocsSchema, getDocsDbPath, walkDocs, defaultDocsRoots } from './db.js';
 import { encodeText, phasesToBytes, docSurface, DEFAULT_DIM } from './hrr.js';
 
 export function ingestDocs(opts = {}) {
@@ -14,69 +14,69 @@ export function ingestDocs(opts = {}) {
   // Fresh build each run.
   if (fs.existsSync(dbPath)) fs.rmSync(dbPath);
 
-  const db = openDocsDb({ dbPath });
-  initDocsSchema(db);
+  return withDocsDb({ dbPath }, (db) => {
+    initDocsSchema(db);
 
-  const insert = db.prepare(`
-    INSERT INTO docs (path, title, release, bundle, doc_type, locale, frontmatter, body, size, mtime, hash, hrr_vector)
-    VALUES (@path, @title, @release, @bundle, @doc_type, @locale, @frontmatter, @body, @size, @mtime, @hash, @hrr_vector)
-  `);
+    const insert = db.prepare(`
+      INSERT INTO docs (path, title, release, bundle, doc_type, locale, frontmatter, body, size, mtime, hash, hrr_vector)
+      VALUES (@path, @title, @release, @bundle, @doc_type, @locale, @frontmatter, @body, @size, @mtime, @hash, @hrr_vector)
+    `);
 
-  let count = 0;
-  let errors = 0;
-  const startedAt = Date.now();
+    let count = 0;
+    let errors = 0;
+    const startedAt = Date.now();
 
-  db.exec('BEGIN');
-  for (const { file, rel } of walkDocs(roots)) {
-    try {
-      const stat = fs.statSync(file);
-      const raw = fs.readFileSync(file, 'utf8');
-      const hash = createHash('sha256').update(raw).digest('hex');
-      let data = {};
-      let body = raw;
+    db.exec('BEGIN');
+    for (const { file, rel } of walkDocs(roots)) {
       try {
-        const parsed = parseFrontmatter(raw);
-        data = parsed.data || {};
-        body = parsed.content || '';
-      } catch {
-        // Malformed frontmatter: keep raw body, empty metadata.
+        const stat = fs.statSync(file);
+        const raw = fs.readFileSync(file, 'utf8');
+        const hash = createHash('sha256').update(raw).digest('hex');
+        let data = {};
+        let body = raw;
+        try {
+          const parsed = parseFrontmatter(raw);
+          data = parsed.data || {};
+          body = parsed.content || '';
+        } catch {
+          // Malformed frontmatter: keep raw body, empty metadata.
+        }
+        const hrr = embed
+          ? phasesToBytes(encodeText(docSurface(data.title ?? null, body), DEFAULT_DIM))
+          : null;
+        insert.run({
+          path: rel,
+          title: data.title ?? null,
+          release: data.release ?? null,
+          bundle: data.bundle ?? null,
+          doc_type: data.doc_type ?? null,
+          locale: data.locale ?? null,
+          frontmatter: JSON.stringify(data),
+          body,
+          size: stat.size,
+          mtime: Math.floor(stat.mtimeMs),
+          hash,
+          hrr_vector: hrr,
+        });
+        count++;
+        if (count % 5000 === 0) {
+          process.stderr.write(`  ...${count} files\n`);
+        }
+      } catch (err) {
+        errors++;
+        if (errors <= 10) process.stderr.write(`Skipped ${file}: ${err.message}\n`);
       }
-      const hrr = embed
-        ? phasesToBytes(encodeText(docSurface(data.title ?? null, body), DEFAULT_DIM))
-        : null;
-      insert.run({
-        path: rel,
-        title: data.title ?? null,
-        release: data.release ?? null,
-        bundle: data.bundle ?? null,
-        doc_type: data.doc_type ?? null,
-        locale: data.locale ?? null,
-        frontmatter: JSON.stringify(data),
-        body,
-        size: stat.size,
-        mtime: Math.floor(stat.mtimeMs),
-        hash,
-        hrr_vector: hrr,
-      });
-      count++;
-      if (count % 5000 === 0) {
-        process.stderr.write(`  ...${count} files\n`);
-      }
-    } catch (err) {
-      errors++;
-      if (errors <= 10) process.stderr.write(`Skipped ${file}: ${err.message}\n`);
     }
-  }
-  db.exec('COMMIT');
+    db.exec('COMMIT');
 
-  db.exec("INSERT INTO docs_fts(docs_fts) VALUES('optimize');");
-  db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
-  db.exec("CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT)");
-  db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('hrr_dim', ?)").run(String(DEFAULT_DIM));
-  db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('synced_at', ?)").run(String(Date.now()));
-  db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('embeddings', ?)").run(String(embed));
-  closeDocsDb(db);
+    db.exec("INSERT INTO docs_fts(docs_fts) VALUES('optimize');");
+    db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
+    db.exec("CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT)");
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('hrr_dim', ?)").run(String(DEFAULT_DIM));
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('synced_at', ?)").run(String(Date.now()));
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('embeddings', ?)").run(String(embed));
 
-  const secs = ((Date.now() - startedAt) / 1000).toFixed(1);
-  return { count, errors, secs, dbPath, embedded: embed };
+    const secs = ((Date.now() - startedAt) / 1000).toFixed(1);
+    return { count, errors, secs, dbPath, embedded: embed };
+  });
 }

package/src/commands/docs/refresh.js

@@ -4,7 +4,7 @@
 import fs from 'node:fs';
 import { createHash } from 'node:crypto';
 import { parseFrontmatter } from '../../frontmatter.js';
-import { openDocsDb, closeDocsDb, getDocsDbPath, walkDocs, defaultDocsRoots } from './db.js';
+import { withDocsDb, getDocsDbPath, walkDocs, defaultDocsRoots } from './db.js';
 import { encodeText, phasesToBytes, docSurface, DEFAULT_DIM } from './hrr.js';
 
 export function refreshDocs(opts = {}) {
@@ -15,108 +15,108 @@ export function refreshDocs(opts = {}) {
     throw new Error(`Database not found: ${dbPath}. Run "jsn docs sync" first for the initial build.`);
   }
 
-  const db = openDocsDb({ dbPath });
-  db.exec('PRAGMA journal_mode = WAL');
+  return withDocsDb({ dbPath }, (db) => {
+    db.exec('PRAGMA journal_mode = WAL');
 
-  const cols = db.prepare('PRAGMA table_info(docs)').all().map((c) => c.name);
-  if (!cols.includes('hash')) db.exec('ALTER TABLE docs ADD COLUMN hash TEXT');
-  if (!cols.includes('hrr_vector')) db.exec('ALTER TABLE docs ADD COLUMN hrr_vector BLOB');
+    const cols = db.prepare('PRAGMA table_info(docs)').all().map((c) => c.name);
+    if (!cols.includes('hash')) db.exec('ALTER TABLE docs ADD COLUMN hash TEXT');
+    if (!cols.includes('hrr_vector')) db.exec('ALTER TABLE docs ADD COLUMN hrr_vector BLOB');
 
-  const embeddingsEnabled =
-    db.prepare('SELECT COUNT(*) AS n FROM docs WHERE hrr_vector IS NOT NULL').get().n > 0 ||
-    !cols.includes('hrr_vector');
+    const embeddingsEnabled =
+      db.prepare('SELECT COUNT(*) AS n FROM docs WHERE hrr_vector IS NOT NULL').get().n > 0 ||
+      !cols.includes('hrr_vector');
 
-  const isBackfill = db.prepare('SELECT COUNT(*) AS n FROM docs WHERE hash IS NOT NULL').get().n === 0
-    && db.prepare('SELECT COUNT(*) AS n FROM docs').get().n > 0;
-  const setHash = db.prepare('UPDATE docs SET hash = ? WHERE id = ?');
+    const isBackfill = db.prepare('SELECT COUNT(*) AS n FROM docs WHERE hash IS NOT NULL').get().n === 0
+      && db.prepare('SELECT COUNT(*) AS n FROM docs').get().n > 0;
+    const setHash = db.prepare('UPDATE docs SET hash = ? WHERE id = ?');
 
-  const existing = new Map();
-  for (const row of db.prepare('SELECT id, path, hash FROM docs').all()) {
-    existing.set(row.path, { id: row.id, hash: row.hash });
-  }
+    const existing = new Map();
+    for (const row of db.prepare('SELECT id, path, hash FROM docs').all()) {
+      existing.set(row.path, { id: row.id, hash: row.hash });
+    }
 
-  const upsert = db.prepare(`
-    INSERT INTO docs (path, title, release, bundle, doc_type, locale, frontmatter, body, size, mtime, hash, hrr_vector)
-    VALUES (@path, @title, @release, @bundle, @doc_type, @locale, @frontmatter, @body, @size, @mtime, @hash, @hrr_vector)
-    ON CONFLICT(path) DO UPDATE SET
-      title=@title, release=@release, bundle=@bundle, doc_type=@doc_type, locale=@locale,
-      frontmatter=@frontmatter, body=@body, size=@size, mtime=@mtime, hash=@hash, hrr_vector=@hrr_vector
-  `);
-  const del = db.prepare('DELETE FROM docs WHERE id = ?');
-
-  let added = 0, updated = 0, removed = 0, unchanged = 0, errors = 0;
-  const seen = new Set();
-  const started = Date.now();
-
-  const files = [...walkDocs(roots)];
-
-  db.exec('BEGIN');
-  for (const { file, rel } of files) {
-    try {
-      seen.add(rel);
-      const raw = fs.readFileSync(file, 'utf8');
-      const hash = createHash('sha256').update(raw).digest('hex');
-
-      const prev = existing.get(rel);
-      if (prev && prev.hash === hash) {
-        unchanged++;
-        continue;
-      }
+    const upsert = db.prepare(`
+      INSERT INTO docs (path, title, release, bundle, doc_type, locale, frontmatter, body, size, mtime, hash, hrr_vector)
+      VALUES (@path, @title, @release, @bundle, @doc_type, @locale, @frontmatter, @body, @size, @mtime, @hash, @hrr_vector)
+      ON CONFLICT(path) DO UPDATE SET
+        title=@title, release=@release, bundle=@bundle, doc_type=@doc_type, locale=@locale,
+        frontmatter=@frontmatter, body=@body, size=@size, mtime=@mtime, hash=@hash, hrr_vector=@hrr_vector
+    `);
+    const del = db.prepare('DELETE FROM docs WHERE id = ?');
 
-      if (isBackfill && prev) {
-        setHash.run(hash, prev.id);
-        unchanged++;
-        continue;
-      }
+    let added = 0, updated = 0, removed = 0, unchanged = 0, errors = 0;
+    const seen = new Set();
+    const started = Date.now();
+
+    const files = [...walkDocs(roots)];
 
-      const stat = fs.statSync(file);
-      let data = {}, body = raw;
+    db.exec('BEGIN');
+    for (const { file, rel } of files) {
       try {
-        const parsed = parseFrontmatter(raw);
-        data = parsed.data || {};
-        body = parsed.content || '';
-      } catch {
-        // keep raw body on malformed frontmatter
+        seen.add(rel);
+        const raw = fs.readFileSync(file, 'utf8');
+        const hash = createHash('sha256').update(raw).digest('hex');
+
+        const prev = existing.get(rel);
+        if (prev && prev.hash === hash) {
+          unchanged++;
+          continue;
+        }
+
+        if (isBackfill && prev) {
+          setHash.run(hash, prev.id);
+          unchanged++;
+          continue;
+        }
+
+        const stat = fs.statSync(file);
+        let data = {}, body = raw;
+        try {
+          const parsed = parseFrontmatter(raw);
+          data = parsed.data || {};
+          body = parsed.content || '';
+        } catch {
+          // keep raw body on malformed frontmatter
+        }
+
+        const hrr = embeddingsEnabled
+          ? phasesToBytes(encodeText(docSurface(data.title ?? null, body), DEFAULT_DIM))
+          : null;
+
+        upsert.run({
+          path: rel,
+          title: data.title ?? null,
+          release: data.release ?? null,
+          bundle: data.bundle ?? null,
+          doc_type: data.doc_type ?? null,
+          locale: data.locale ?? null,
+          frontmatter: JSON.stringify(data),
+          body,
+          size: stat.size,
+          mtime: Math.floor(stat.mtimeMs),
+          hash,
+          hrr_vector: hrr,
+        });
+        if (prev) updated++; else added++;
+      } catch (err) {
+        errors++;
+        if (errors <= 10) process.stderr.write(`Skipped ${file}: ${err.message}\n`);
       }
-
-      const hrr = embeddingsEnabled
-        ? phasesToBytes(encodeText(docSurface(data.title ?? null, body), DEFAULT_DIM))
-        : null;
-
-      upsert.run({
-        path: rel,
-        title: data.title ?? null,
-        release: data.release ?? null,
-        bundle: data.bundle ?? null,
-        doc_type: data.doc_type ?? null,
-        locale: data.locale ?? null,
-        frontmatter: JSON.stringify(data),
-        body,
-        size: stat.size,
-        mtime: Math.floor(stat.mtimeMs),
-        hash,
-        hrr_vector: hrr,
-      });
-      if (prev) updated++; else added++;
-    } catch (err) {
-      errors++;
-      if (errors <= 10) process.stderr.write(`Skipped ${file}: ${err.message}\n`);
     }
-  }
 
-  for (const [rel, row] of existing) {
-    if (!seen.has(rel)) {
-      del.run(row.id);
-      removed++;
+    for (const [rel, row] of existing) {
+      if (!seen.has(rel)) {
+        del.run(row.id);
+        removed++;
+      }
     }
-  }
-  db.exec('COMMIT');
+    db.exec('COMMIT');
 
-  db.exec("INSERT INTO docs_fts(docs_fts) VALUES('optimize');");
-  db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
-  db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('synced_at', ?)").run(String(Date.now()));
-  closeDocsDb(db);
+    db.exec("INSERT INTO docs_fts(docs_fts) VALUES('optimize');");
+    db.exec('PRAGMA wal_checkpoint(TRUNCATE)');
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('synced_at', ?)").run(String(Date.now()));
 
-  const secs = ((Date.now() - started) / 1000).toFixed(1);
-  return { added, updated, removed, unchanged, errors, secs, dbPath, embeddingsEnabled };
+    const secs = ((Date.now() - started) / 1000).toFixed(1);
+    return { added, updated, removed, unchanged, errors, secs, dbPath, embeddingsEnabled };
+  });
 }