sensemaking 0.19.1 → 0.20.0

package/dist/esm/store/open.d.ts

@@ -0,0 +1,15 @@
+import type { ResolvedConfig } from '../config/index.js';
+import type { Builder } from './builder.js';
+import type { OpenDialect, Store } from './types.js';
+export interface OpenResult {
+    store: Store;
+    cfg: ResolvedConfig;
+    dbPath: string;
+    parsed: number;
+    warnings: string[];
+}
+export declare function openWithDialect<Handle>(cfg: ResolvedConfig, dialect: OpenDialect<Handle>): Promise<OpenResult>;
+export declare function openWithBuilder<Handle>(cfg: ResolvedConfig, dialect: OpenDialect<Handle>): Promise<OpenResult & {
+    builder: Builder;
+}>;
+export declare function docCount(store: Store): Promise<number>;

package/dist/esm/store/open.js

@@ -0,0 +1,137 @@
+import { mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { featureSignature, STATE_DIR } from '../config/index.js';
+import { rekeyChunkText } from '../embed/handoff.js';
+import { FEATURES } from '../features/index.js';
+import { createBuilder } from './builder.js';
+import { clearCache } from './cache.js';
+import { getMeta, setMeta } from './shared.js';
+import { changedSignatureKeys, embedIdentityAdopted, signatureDiff } from './signature.js';
+async function connectWithDialect(cfg, dialect, keepBuilderOpen) {
+    const stateDir = join(cfg.baseDir, STATE_DIR);
+    mkdirSync(stateDir, {
+        recursive: true
+    });
+    const dbPath = join(stateDir, dialect.filename);
+    const { handle, conn } = await dialect.connect(dbPath, cfg);
+    // A throw below must release this handle, or the leaked WAL makes the cache file undeletable on
+    // Windows. `closed` keeps the catch from double-closing a handle a rebuild branch already closed.
+    let closed = false;
+    // Created here, not inside reconcile(): its pool must survive across every build() call this
+    // connection sees (a watcher's repeated ticks), not just the one below.
+    const builder = createBuilder(conn, cfg, cfg.baseDir, dialect.reconcileDialect);
+    try {
+        await conn.exec('CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT)');
+        // Schema-version or feature-set mismatch: reconcile only reparses changed files, so an
+        // old cache can't be patched incrementally -- rebuild instead (cheap: nothing expensive lives here).
+        const version = await getMeta(conn, 'schema_version');
+        const features = await getMeta(conn, 'features');
+        const wantFeatures = featureSignature(cfg, FEATURES);
+        let tokenizeOnlyRebuild = false;
+        if (version !== null && version !== dialect.schemaVersion || features !== null && features !== wantFeatures) {
+            // Indexing derives from presets, so a config edit rebuilding the cache must say so and
+            // name what changed -- silent rebuilds make derived indexing look like a hang or a bug.
+            if (version !== null && version !== dialect.schemaVersion) {
+                console.error('sense: cache format changed (new sensemaking version); rebuilding the index');
+                // Close before clearCache deletes the files out from under the still-open handle.
+                closed = true;
+                await dialect.close(handle);
+                clearCache(cfg);
+                return connectWithDialect(cfg, dialect, keepBuilderOpen);
+            }
+            const changedKeys = changedSignatureKeys(features !== null && features !== void 0 ? features : '', wantFeatures);
+            // Only a dialect-owned carve-out (sqlite's tokenizer) skips the rebuild below with its own
+            // partial DDL swap; every other single- or multi-segment change takes it.
+            if (dialect.partialRebuild && await dialect.partialRebuild(handle, conn, cfg, changedKeys)) {
+                tokenizeOnlyRebuild = true;
+            } else if (changedKeys.size === 1 && changedKeys.has('embed') && embedIdentityAdopted(features !== null && features !== void 0 ? features : '', wantFeatures)) {
+                // First sight of a resolved weight identity: the model itself hasn't changed, so
+                // adopt it into meta with no rebuild and no re-embed, mirroring the tokenize precedent.
+                console.error("sense: recorded the embedding model's resolved identity; vectors are unaffected");
+                await setMeta(conn, 'features', wantFeatures);
+            } else {
+                const changed = signatureDiff(features !== null && features !== void 0 ? features : '', wantFeatures);
+                console.error(`sense: config change (${changed}) rebuilds the index`);
+                closed = true;
+                await dialect.close(handle);
+                clearCache(cfg);
+                return connectWithDialect(cfg, dialect, keepBuilderOpen);
+            }
+        }
+        // A rebuild trigger independent of the signature comparison above (sqlite: the content
+        // table's own DDL no longer matches the resolved tokenizer).
+        const extraReason = dialect.extraRebuildReason ? dialect.extraRebuildReason(handle) : null;
+        if (extraReason !== null) {
+            console.error(`sense: ${extraReason}; rebuilding the index`);
+            closed = true;
+            await dialect.close(handle);
+            clearCache(cfg);
+            return connectWithDialect(cfg, dialect, keepBuilderOpen);
+        }
+        await dialect.ensureSchema(handle, conn, cfg);
+        let rebuildWarnings = [];
+        if (tokenizeOnlyRebuild && dialect.postSchemaRebuild) {
+            rebuildWarnings = await dialect.postSchemaRebuild(handle, conn, cfg, cfg.baseDir, wantFeatures);
+        }
+        // 3x the largest reconcile this cache has recorded, floored at 30s and capped at 10min.
+        // Installed before build() -- that call is the one that races a watcher's transaction.
+        if (dialect.setDerivedBusyTimeout) {
+            var _ref;
+            const recordedMaxMs = Number((_ref = await getMeta(conn, 'reconcile_max_ms')) !== null && _ref !== void 0 ? _ref : '0');
+            await dialect.setDerivedBusyTimeout(handle, conn, Math.min(Math.max(30000, 3 * recordedMaxMs), 600000));
+        }
+        const { parsed, warnings } = await builder.build();
+        // A one-shot open is done reconciling for good; a watcher keeps `builder` alive across its run.
+        if (!keepBuilderOpen) await builder.close();
+        return {
+            handle,
+            conn,
+            cfg,
+            dbPath,
+            parsed,
+            warnings: [
+                ...rebuildWarnings,
+                ...warnings
+            ],
+            builder
+        };
+    } catch (err) {
+        await builder.close();
+        if (!closed) await dialect.close(handle);
+        throw err;
+    }
+}
+// A store's open(): connects (see connectWithDialect above), then wraps the resulting connection
+// in the Store interface. The builder's pool closes right after the initial build.
+export async function openWithDialect(cfg, dialect) {
+    const { handle, conn, cfg: resolvedCfg, dbPath, parsed, warnings } = await connectWithDialect(cfg, dialect, false);
+    const store = dialect.createStore(handle, conn, resolvedCfg);
+    // reconcile ran before this object existed, so its chunk text is keyed by the connection.
+    rekeyChunkText(conn, store);
+    return {
+        store,
+        cfg: resolvedCfg,
+        dbPath,
+        parsed,
+        warnings
+    };
+}
+// Same connect+build as openWithDialect, but keeps the builder's pool alive and hands it back
+// alongside the store, for a caller (a watcher) that reconciles repeatedly on this connection.
+export async function openWithBuilder(cfg, dialect) {
+    const { handle, conn, cfg: resolvedCfg, dbPath, parsed, warnings, builder } = await connectWithDialect(cfg, dialect, true);
+    const store = dialect.createStore(handle, conn, resolvedCfg);
+    rekeyChunkText(conn, store);
+    return {
+        store,
+        cfg: resolvedCfg,
+        dbPath,
+        parsed,
+        warnings,
+        builder
+    };
+}
+export async function docCount(store) {
+    const stmt = await store.prepare('SELECT COUNT(*) AS n FROM frontmatter');
+    return (await stmt.get()).n;
+}

package/dist/esm/store/open.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/sensemaking/src/store/open.ts"],"sourcesContent":["import { mkdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { ResolvedConfig } from '../config/index.ts';\nimport { featureSignature, STATE_DIR } from '../config/index.ts';\nimport { rekeyChunkText } from '../embed/handoff.ts';\nimport { FEATURES } from '../features/index.ts';\nimport type { Builder } from './builder.ts';\nimport { createBuilder } from './builder.ts';\nimport { clearCache } from './cache.ts';\nimport { getMeta, setMeta } from './shared.ts';\nimport { changedSignatureKeys, embedIdentityAdopted, signatureDiff } from './signature.ts';\nimport type { Connection, OpenDialect, Store } from './types.ts';\n\n// One open algorithm shared by every store, parameterised by a per-engine OpenDialect (types.ts).\n// Ordering is universal, not a dialect concern: connect, meta table, schema-version and\n// feature-signature comparison (rebuild, adopt, or partial rebuild), any extra rebuild trigger,\n// ensureSchema, the derived busy_timeout PRAGMA, reconcile, then the store itself.\n\nexport interface OpenResult {\n  store: Store;\n  cfg: ResolvedConfig;\n  dbPath: string;\n  parsed: number;\n  warnings: string[];\n}\n\ninterface ConnectResult<Handle> {\n  handle: Handle;\n  conn: Connection;\n  cfg: ResolvedConfig;\n  dbPath: string;\n  parsed: number;\n  warnings: string[];\n  // Closed already unless `keepBuilderOpen` was set: a one-shot open reconciles once and is done\n  // with it, a watcher keeps calling build() on the same instance across its whole run.\n  builder: Builder;\n}\n\nasync function connectWithDialect<Handle>(cfg: ResolvedConfig, dialect: OpenDialect<Handle>, keepBuilderOpen: boolean): Promise<ConnectResult<Handle>> {\n  const stateDir = join(cfg.baseDir, STATE_DIR);\n  mkdirSync(stateDir, { recursive: true });\n  const dbPath = join(stateDir, dialect.filename);\n\n  const { handle, conn } = await dialect.connect(dbPath, cfg);\n  // A throw below must release this handle, or the leaked WAL makes the cache file undeletable on\n  // Windows. `closed` keeps the catch from double-closing a handle a rebuild branch already closed.\n  let closed = false;\n  // Created here, not inside reconcile(): its pool must survive across every build() call this\n  // connection sees (a watcher's repeated ticks), not just the one below.\n  const builder = createBuilder(conn, cfg, cfg.baseDir, dialect.reconcileDialect);\n  try {\n    await conn.exec('CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT)');\n\n    // Schema-version or feature-set mismatch: reconcile only reparses changed files, so an\n    // old cache can't be patched incrementally -- rebuild instead (cheap: nothing expensive lives here).\n    const version = await getMeta(conn, 'schema_version');\n    const features = await getMeta(conn, 'features');\n    const wantFeatures = featureSignature(cfg, FEATURES);\n    let tokenizeOnlyRebuild = false;\n    if ((version !== null && version !== dialect.schemaVersion) || (features !== null && features !== wantFeatures)) {\n      // Indexing derives from presets, so a config edit rebuilding the cache must say so and\n      // name what changed -- silent rebuilds make derived indexing look like a hang or a bug.\n      if (version !== null && version !== dialect.schemaVersion) {\n        console.error('sense: cache format changed (new sensemaking version); rebuilding the index');\n        // Close before clearCache deletes the files out from under the still-open handle.\n        closed = true;\n        await dialect.close(handle);\n        clearCache(cfg);\n        return connectWithDialect(cfg, dialect, keepBuilderOpen);\n      }\n      const changedKeys = changedSignatureKeys(features ?? '', wantFeatures);\n      // Only a dialect-owned carve-out (sqlite's tokenizer) skips the rebuild below with its own\n      // partial DDL swap; every other single- or multi-segment change takes it.\n      if (dialect.partialRebuild && (await dialect.partialRebuild(handle, conn, cfg, changedKeys))) {\n        tokenizeOnlyRebuild = true;\n      } else if (changedKeys.size === 1 && changedKeys.has('embed') && embedIdentityAdopted(features ?? '', wantFeatures)) {\n        // First sight of a resolved weight identity: the model itself hasn't changed, so\n        // adopt it into meta with no rebuild and no re-embed, mirroring the tokenize precedent.\n        console.error(\"sense: recorded the embedding model's resolved identity; vectors are unaffected\");\n        await setMeta(conn, 'features', wantFeatures);\n      } else {\n        const changed = signatureDiff(features ?? '', wantFeatures);\n        console.error(`sense: config change (${changed}) rebuilds the index`);\n        closed = true;\n        await dialect.close(handle);\n        clearCache(cfg);\n        return connectWithDialect(cfg, dialect, keepBuilderOpen);\n      }\n    }\n\n    // A rebuild trigger independent of the signature comparison above (sqlite: the content\n    // table's own DDL no longer matches the resolved tokenizer).\n    const extraReason = dialect.extraRebuildReason ? dialect.extraRebuildReason(handle) : null;\n    if (extraReason !== null) {\n      console.error(`sense: ${extraReason}; rebuilding the index`);\n      closed = true;\n      await dialect.close(handle);\n      clearCache(cfg);\n      return connectWithDialect(cfg, dialect, keepBuilderOpen);\n    }\n\n    await dialect.ensureSchema(handle, conn, cfg);\n\n    let rebuildWarnings: string[] = [];\n    if (tokenizeOnlyRebuild && dialect.postSchemaRebuild) {\n      rebuildWarnings = await dialect.postSchemaRebuild(handle, conn, cfg, cfg.baseDir, wantFeatures);\n    }\n\n    // 3x the largest reconcile this cache has recorded, floored at 30s and capped at 10min.\n    // Installed before build() -- that call is the one that races a watcher's transaction.\n    if (dialect.setDerivedBusyTimeout) {\n      const recordedMaxMs = Number((await getMeta(conn, 'reconcile_max_ms')) ?? '0');\n      await dialect.setDerivedBusyTimeout(handle, conn, Math.min(Math.max(30000, 3 * recordedMaxMs), 600_000));\n    }\n\n    const { parsed, warnings } = await builder.build();\n    // A one-shot open is done reconciling for good; a watcher keeps `builder` alive across its run.\n    if (!keepBuilderOpen) await builder.close();\n\n    return { handle, conn, cfg, dbPath, parsed, warnings: [...rebuildWarnings, ...warnings], builder };\n  } catch (err) {\n    await builder.close();\n    if (!closed) await dialect.close(handle);\n    throw err;\n  }\n}\n\n// A store's open(): connects (see connectWithDialect above), then wraps the resulting connection\n// in the Store interface. The builder's pool closes right after the initial build.\nexport async function openWithDialect<Handle>(cfg: ResolvedConfig, dialect: OpenDialect<Handle>): Promise<OpenResult> {\n  const { handle, conn, cfg: resolvedCfg, dbPath, parsed, warnings } = await connectWithDialect(cfg, dialect, false);\n  const store = dialect.createStore(handle, conn, resolvedCfg);\n  // reconcile ran before this object existed, so its chunk text is keyed by the connection.\n  rekeyChunkText(conn, store);\n  return { store, cfg: resolvedCfg, dbPath, parsed, warnings };\n}\n\n// Same connect+build as openWithDialect, but keeps the builder's pool alive and hands it back\n// alongside the store, for a caller (a watcher) that reconciles repeatedly on this connection.\nexport async function openWithBuilder<Handle>(cfg: ResolvedConfig, dialect: OpenDialect<Handle>): Promise<OpenResult & { builder: Builder }> {\n  const { handle, conn, cfg: resolvedCfg, dbPath, parsed, warnings, builder } = await connectWithDialect(cfg, dialect, true);\n  const store = dialect.createStore(handle, conn, resolvedCfg);\n  rekeyChunkText(conn, store);\n  return { store, cfg: resolvedCfg, dbPath, parsed, warnings, builder };\n}\n\nexport async function docCount(store: Store): Promise<number> {\n  const stmt = await store.prepare('SELECT COUNT(*) AS n FROM frontmatter');\n  return ((await stmt.get()) as { n: number }).n;\n}\n"],"names":["mkdirSync","join","featureSignature","STATE_DIR","rekeyChunkText","FEATURES","createBuilder","clearCache","getMeta","setMeta","changedSignatureKeys","embedIdentityAdopted","signatureDiff","connectWithDialect","cfg","dialect","keepBuilderOpen","stateDir","baseDir","recursive","dbPath","filename","handle","conn","connect","closed","builder","reconcileDialect","exec","version","features","wantFeatures","tokenizeOnlyRebuild","schemaVersion","console","error","close","changedKeys","partialRebuild","size","has","changed","extraReason","extraRebuildReason","ensureSchema","rebuildWarnings","postSchemaRebuild","setDerivedBusyTimeout","recordedMaxMs","Number","Math","min","max","parsed","warnings","build","err","openWithDialect","resolvedCfg","store","createStore","openWithBuilder","docCount","stmt","prepare","get","n"],"mappings":"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"}

package/dist/esm/store/reconcile.d.ts

@@ -0,0 +1,7 @@
+import type { Config } from '../config/index.js';
+import type { ParsePool } from '../scan/pool.js';
+import type { Connection, ReconcileDialect } from './types.js';
+export declare function reconcile(conn: Connection, cfg: Config, baseDir: string, dialect: ReconcileDialect, pool?: ParsePool): Promise<{
+    parsed: number;
+    warnings: string[];
+}>;

package/dist/esm/store/reconcile.js

@@ -0,0 +1,132 @@
+import { activeFeatures } from '../features/index.js';
+import { progress } from '../output/progress.js';
+import { listFiles, RESERVED_COLUMNS } from '../scan/index.js';
+import { reparseFiles } from '../scan/reparse.js';
+import { getColumns, quoteIdent } from './shared.js';
+import { withTransaction } from './transaction.js';
+// One reconcile algorithm shared by every store, parameterised by a per-engine ReconcileDialect
+// (types.ts). Ordering is universal, not a dialect concern: ALTER, then the frontmatter upsert,
+// then reconcileContent, then preset_files, then the vanished-frontmatter delete, then feature hooks
+// -- a vanished path's content delete (inside reconcileContent) must precede its frontmatter
+// delete, since sqlite's delete SQL resolves the row via its frontmatter rowid.
+// Feature-owned columns (`_rank`) must stay out of the upsert: a reparse would null the last
+// computed value on every touch, not just the reconciles that recompute it.
+const CORE_FRONTMATTER_COLUMNS = new Set([
+    'path',
+    '_mtime',
+    '_ctime',
+    '_size',
+    '_parse_error'
+]);
+export async function reconcile(conn, cfg, baseDir, dialect, pool) {
+    const files = listFiles(cfg, baseDir);
+    const currentSet = new Set(files.map((f)=>f.relPath));
+    const existingStmt = await conn.prepare('SELECT "path", "_mtime", "_size" FROM frontmatter');
+    const existingRows = await existingStmt.all();
+    const existing = new Map(existingRows.map((r)=>[
+            r.path,
+            r
+        ]));
+    const vanished = existingRows.filter((r)=>!currentSet.has(r.path)).map((r)=>r.path);
+    const toReparse = files.filter((f)=>{
+        const row = existing.get(f.relPath);
+        return !row || row._mtime !== f.mtimeMs || row._size !== f.size;
+    });
+    if (vanished.length === 0 && toReparse.length === 0) return {
+        parsed: 0,
+        warnings: []
+    };
+    const features = activeFeatures(cfg);
+    const seenColumns = await getColumns(conn);
+    // Bulk reparses (a sync, a cold build) are the long silences a query can hit; short
+    // reconciles stay silent (progress() has a threshold).
+    const report = progress('reparsing files', toReparse.length);
+    const { docs: parsedDocs, warnings, newColumns } = await reparseFiles(toReparse, features, cfg, seenColumns, report.tick, {
+        pool
+    });
+    report.finish();
+    for (const col of newColumns)seenColumns.add(col);
+    const allColumns = [
+        ...seenColumns
+    ];
+    // Fence before ALTERing: a store's own failure past this point is a raw, engine-specific
+    // error with no indication of the boundary or the levers -- dialect.checkColumnLimit names both.
+    dialect.checkColumnLimit(allColumns.length);
+    // Columns the frontmatter upsert actually writes: core + parsed frontmatter keys, never a
+    // feature-owned reserved column (see CORE_FRONTMATTER_COLUMNS above).
+    const writableColumns = allColumns.filter((c)=>CORE_FRONTMATTER_COLUMNS.has(c) || !RESERVED_COLUMNS.has(c));
+    // ON CONFLICT DO UPDATE (not OR REPLACE) keeps the row's rowid stable across reparses --
+    // sqlite's content rows are coupled to that rowid.
+    const insertSql = `INSERT INTO frontmatter (${writableColumns.map(quoteIdent).join(', ')}) VALUES (${writableColumns.map(()=>'?').join(', ')}) ON CONFLICT("path") DO UPDATE SET ${writableColumns.filter((c)=>c !== 'path').map((c)=>`${quoteIdent(c)} = excluded.${quoteIdent(c)}`).join(', ')}`;
+    const added = toReparse.filter((f)=>!existing.has(f.relPath)).map((f)=>f.relPath);
+    const delta = {
+        files,
+        reparsed: parsedDocs.map((d)=>d.relPath),
+        added,
+        vanished
+    };
+    const addedSet = new Set(added);
+    const reparsedExisting = parsedDocs.map((d)=>d.relPath).filter((p)=>!addedSet.has(p));
+    // Paths whose content (and, per feature, other rows) need clearing: gone entirely, or about to
+    // be reinserted fresh. Disjoint from `added`, which has nothing to clear.
+    const touched = [
+        ...vanished,
+        ...reparsedExisting
+    ];
+    const txStart = Date.now();
+    await withTransaction(conn, async ()=>{
+        var _feature_remove, _feature_afterReconcile;
+        // Re-read inside the write transaction: newColumns came from a read taken before it opened, so a
+        // concurrent reconcile may have added some of them since. ALTER has no IF NOT EXISTS.
+        const present = await getColumns(conn);
+        for (const col of newColumns)if (!present.has(col)) await conn.exec(`ALTER TABLE frontmatter ADD COLUMN ${quoteIdent(col)}${dialect.columnTypeSuffix()}`);
+        if (parsedDocs.length > 0) {
+            const rows = parsedDocs.map((doc)=>writableColumns.map((col)=>{
+                    var _doc_data_col;
+                    if (col === 'path') return doc.relPath;
+                    if (col === '_mtime') return doc.mtimeMs;
+                    if (col === '_ctime') return doc.ctimeMs;
+                    if (col === '_size') return doc.size;
+                    // Written per parse, unlike _rank, which a feature pass owns and the upsert skips.
+                    if (col === '_parse_error') return doc.parseError;
+                    return (_doc_data_col = doc.data[col]) !== null && _doc_data_col !== void 0 ? _doc_data_col : null;
+                }));
+            await conn.runBatch(insertSql, rows);
+        }
+        // After the upsert, so every doc already has the frontmatter row sqlite's content rowid
+        // couples to. ON CONFLICT DO UPDATE preserves that rowid, so a reparse keeps its identity.
+        await dialect.reconcileContent(conn, touched, parsedDocs, delta, cfg);
+        // A preset edit forces a full rebuild, so an unchanged doc's coverage is already correct;
+        // new docs have nothing to clear, which keeps cold builds linear.
+        if (touched.length > 0) await conn.runBatch('DELETE FROM preset_files WHERE "path" = ?', touched.map((p)=>[
+                p
+            ]));
+        const presetRows = [];
+        for (const doc of parsedDocs)for (const presetName of doc.presets)presetRows.push([
+            doc.relPath,
+            presetName
+        ]);
+        if (presetRows.length > 0) await conn.runBatch('INSERT INTO preset_files ("path", preset) VALUES (?, ?)', presetRows);
+        // Before the feature hooks, never after: rank's afterReconcile reads frontmatter as PageRank's
+        // node set, so a lingering vanished row would dilute rank mass across every surviving note.
+        if (vanished.length > 0) await conn.runBatch('DELETE FROM frontmatter WHERE "path" = ?', vanished.map((p)=>[
+                p
+            ]));
+        if (touched.length > 0) for (const feature of features)await ((_feature_remove = feature.remove) === null || _feature_remove === void 0 ? void 0 : _feature_remove.call(feature, conn, touched, delta));
+        for (const feature of features){
+            var _feature_store;
+            const docsForFeature = parsedDocs.map((doc)=>({
+                    path: doc.relPath,
+                    extracted: doc.extracted[feature.name]
+                }));
+            await ((_feature_store = feature.store) === null || _feature_store === void 0 ? void 0 : _feature_store.call(feature, conn, docsForFeature, delta));
+        }
+        for (const feature of features)await ((_feature_afterReconcile = feature.afterReconcile) === null || _feature_afterReconcile === void 0 ? void 0 : _feature_afterReconcile.call(feature, conn, delta));
+    }, dialect.beginMode());
+    const durationMs = Date.now() - txStart;
+    if (dialect.recordDuration) await dialect.recordDuration(conn, durationMs);
+    return {
+        parsed: parsedDocs.length,
+        warnings
+    };
+}

package/dist/esm/store/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/sensemaking/src/store/reconcile.ts"],"sourcesContent":["import type { Config } from '../config/index.ts';\nimport { activeFeatures } from '../features/index.ts';\nimport type { ExtractedDoc, ReconcileDelta } from '../features/types.ts';\nimport { progress } from '../output/progress.ts';\nimport { listFiles, RESERVED_COLUMNS } from '../scan/index.ts';\nimport type { ParsePool } from '../scan/pool.ts';\nimport { reparseFiles } from '../scan/reparse.ts';\nimport { getColumns, quoteIdent } from './shared.ts';\nimport { withTransaction } from './transaction.ts';\nimport type { Connection, ReconcileDialect } from './types.ts';\n\n// One reconcile algorithm shared by every store, parameterised by a per-engine ReconcileDialect\n// (types.ts). Ordering is universal, not a dialect concern: ALTER, then the frontmatter upsert,\n// then reconcileContent, then preset_files, then the vanished-frontmatter delete, then feature hooks\n// -- a vanished path's content delete (inside reconcileContent) must precede its frontmatter\n// delete, since sqlite's delete SQL resolves the row via its frontmatter rowid.\n\n// Feature-owned columns (`_rank`) must stay out of the upsert: a reparse would null the last\n// computed value on every touch, not just the reconciles that recompute it.\nconst CORE_FRONTMATTER_COLUMNS = new Set(['path', '_mtime', '_ctime', '_size', '_parse_error']);\n\nexport async function reconcile(conn: Connection, cfg: Config, baseDir: string, dialect: ReconcileDialect, pool?: ParsePool): Promise<{ parsed: number; warnings: string[] }> {\n  const files = listFiles(cfg, baseDir);\n  const currentSet = new Set(files.map((f) => f.relPath));\n\n  const existingStmt = await conn.prepare('SELECT \"path\", \"_mtime\", \"_size\" FROM frontmatter');\n  const existingRows = (await existingStmt.all()) as Array<{ path: string; _mtime: number; _size: number }>;\n  const existing = new Map(existingRows.map((r) => [r.path, r]));\n  const vanished = existingRows.filter((r) => !currentSet.has(r.path)).map((r) => r.path);\n\n  const toReparse = files.filter((f) => {\n    const row = existing.get(f.relPath);\n    return !row || row._mtime !== f.mtimeMs || row._size !== f.size;\n  });\n\n  if (vanished.length === 0 && toReparse.length === 0) return { parsed: 0, warnings: [] };\n\n  const features = activeFeatures(cfg);\n  const seenColumns = await getColumns(conn);\n\n  // Bulk reparses (a sync, a cold build) are the long silences a query can hit; short\n  // reconciles stay silent (progress() has a threshold).\n  const report = progress('reparsing files', toReparse.length);\n  const { docs: parsedDocs, warnings, newColumns } = await reparseFiles(toReparse, features, cfg, seenColumns, report.tick, { pool });\n  report.finish();\n  for (const col of newColumns) seenColumns.add(col);\n\n  const allColumns = [...seenColumns];\n  // Fence before ALTERing: a store's own failure past this point is a raw, engine-specific\n  // error with no indication of the boundary or the levers -- dialect.checkColumnLimit names both.\n  dialect.checkColumnLimit(allColumns.length);\n  // Columns the frontmatter upsert actually writes: core + parsed frontmatter keys, never a\n  // feature-owned reserved column (see CORE_FRONTMATTER_COLUMNS above).\n  const writableColumns = allColumns.filter((c) => CORE_FRONTMATTER_COLUMNS.has(c) || !RESERVED_COLUMNS.has(c));\n  // ON CONFLICT DO UPDATE (not OR REPLACE) keeps the row's rowid stable across reparses --\n  // sqlite's content rows are coupled to that rowid.\n  const insertSql = `INSERT INTO frontmatter (${writableColumns.map(quoteIdent).join(', ')}) VALUES (${writableColumns.map(() => '?').join(', ')}) ON CONFLICT(\"path\") DO UPDATE SET ${writableColumns\n    .filter((c) => c !== 'path')\n    .map((c) => `${quoteIdent(c)} = excluded.${quoteIdent(c)}`)\n    .join(', ')}`;\n\n  const added = toReparse.filter((f) => !existing.has(f.relPath)).map((f) => f.relPath);\n  const delta: ReconcileDelta = { files, reparsed: parsedDocs.map((d) => d.relPath), added, vanished };\n  const addedSet = new Set(added);\n  const reparsedExisting = parsedDocs.map((d) => d.relPath).filter((p) => !addedSet.has(p));\n  // Paths whose content (and, per feature, other rows) need clearing: gone entirely, or about to\n  // be reinserted fresh. Disjoint from `added`, which has nothing to clear.\n  const touched = [...vanished, ...reparsedExisting];\n\n  const txStart = Date.now();\n  await withTransaction(\n    conn,\n    async () => {\n      // Re-read inside the write transaction: newColumns came from a read taken before it opened, so a\n      // concurrent reconcile may have added some of them since. ALTER has no IF NOT EXISTS.\n      const present = await getColumns(conn);\n      for (const col of newColumns) if (!present.has(col)) await conn.exec(`ALTER TABLE frontmatter ADD COLUMN ${quoteIdent(col)}${dialect.columnTypeSuffix()}`);\n\n      if (parsedDocs.length > 0) {\n        const rows = parsedDocs.map((doc) =>\n          writableColumns.map((col) => {\n            if (col === 'path') return doc.relPath;\n            if (col === '_mtime') return doc.mtimeMs;\n            if (col === '_ctime') return doc.ctimeMs;\n            if (col === '_size') return doc.size;\n            // Written per parse, unlike _rank, which a feature pass owns and the upsert skips.\n            if (col === '_parse_error') return doc.parseError;\n            return doc.data[col] ?? null;\n          })\n        );\n        await conn.runBatch(insertSql, rows);\n      }\n\n      // After the upsert, so every doc already has the frontmatter row sqlite's content rowid\n      // couples to. ON CONFLICT DO UPDATE preserves that rowid, so a reparse keeps its identity.\n      await dialect.reconcileContent(conn, touched, parsedDocs, delta, cfg);\n\n      // A preset edit forces a full rebuild, so an unchanged doc's coverage is already correct;\n      // new docs have nothing to clear, which keeps cold builds linear.\n      if (touched.length > 0)\n        await conn.runBatch(\n          'DELETE FROM preset_files WHERE \"path\" = ?',\n          touched.map((p) => [p])\n        );\n      const presetRows: unknown[][] = [];\n      for (const doc of parsedDocs) for (const presetName of doc.presets) presetRows.push([doc.relPath, presetName]);\n      if (presetRows.length > 0) await conn.runBatch('INSERT INTO preset_files (\"path\", preset) VALUES (?, ?)', presetRows);\n\n      // Before the feature hooks, never after: rank's afterReconcile reads frontmatter as PageRank's\n      // node set, so a lingering vanished row would dilute rank mass across every surviving note.\n      if (vanished.length > 0)\n        await conn.runBatch(\n          'DELETE FROM frontmatter WHERE \"path\" = ?',\n          vanished.map((p) => [p])\n        );\n\n      if (touched.length > 0) for (const feature of features) await feature.remove?.(conn, touched, delta);\n      for (const feature of features) {\n        const docsForFeature: ExtractedDoc[] = parsedDocs.map((doc) => ({ path: doc.relPath, extracted: doc.extracted[feature.name] }));\n        await feature.store?.(conn, docsForFeature, delta);\n      }\n      for (const feature of features) await feature.afterReconcile?.(conn, delta);\n    },\n    dialect.beginMode()\n  );\n\n  const durationMs = Date.now() - txStart;\n  if (dialect.recordDuration) await dialect.recordDuration(conn, durationMs);\n\n  return { parsed: parsedDocs.length, warnings };\n}\n"],"names":["activeFeatures","progress","listFiles","RESERVED_COLUMNS","reparseFiles","getColumns","quoteIdent","withTransaction","CORE_FRONTMATTER_COLUMNS","Set","reconcile","conn","cfg","baseDir","dialect","pool","files","currentSet","map","f","relPath","existingStmt","prepare","existingRows","all","existing","Map","r","path","vanished","filter","has","toReparse","row","get","_mtime","mtimeMs","_size","size","length","parsed","warnings","features","seenColumns","report","docs","parsedDocs","newColumns","tick","finish","col","add","allColumns","checkColumnLimit","writableColumns","c","insertSql","join","added","delta","reparsed","d","addedSet","reparsedExisting","p","touched","txStart","Date","now","feature","present","exec","columnTypeSuffix","rows","doc","ctimeMs","parseError","data","runBatch","reconcileContent","presetRows","presetName","presets","push","remove","docsForFeature","extracted","name","store","afterReconcile","beginMode","durationMs","recordDuration"],"mappings":"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"}

package/dist/esm/store/shared.d.ts

@@ -3,3 +3,4 @@ export declare function quoteIdent(name: string): string;
 export declare function getColumns(conn: Connection): Promise<Set<string>>;
 export declare function getMeta(conn: Connection, key: string): Promise<string | null>;
 export declare function setMeta(conn: Connection, key: string, value: string | null): Promise<void>;
+export declare function recordReconcileDuration(conn: Connection, ms: number): Promise<void>;

package/dist/esm/store/shared.js

@@ -22,3 +22,12 @@ export async function setMeta(conn, key, value) {
     const stmt = await conn.prepare('INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value');
     await stmt.run(key, value);
 }
+// Reconcile's own write-transaction duration, for open()'s derived busy_timeout: keep the
+// observed max so a big watcher reconcile's lock hold is what the next open bounds its wait against.
+export async function recordReconcileDuration(conn, ms) {
+    const prevRaw = await getMeta(conn, 'reconcile_max_ms');
+    // -1, not 0, so a genuinely 0ms first reconcile (sub-millisecond, common on a tiny tree)
+    // still gets recorded instead of losing to the "nothing recorded yet" default.
+    const prevMax = prevRaw === null ? -1 : Number(prevRaw);
+    if (ms > prevMax) await setMeta(conn, 'reconcile_max_ms', String(ms));
+}

package/dist/esm/store/shared.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/sensemaking/src/store/shared.ts"],"sourcesContent":["import type { Connection } from './types.ts';\n\n// SQL and meta-table primitives both stores' open()/reconcile() need. Engine-neutral: both\n// stores' Connection satisfies the same async exec/prepare/runBatch shape (types.ts).\n\nexport function quoteIdent(name: string): string {\n  return `\"${name.split('\"').join('\"\"')}\"`;\n}\n\nexport async function getColumns(conn: Connection): Promise<Set<string>> {\n  const stmt = await conn.prepare('PRAGMA table_info(frontmatter)');\n  const rows = (await stmt.all()) as Array<{ name: string }>;\n  return new Set(rows.map((r) => r.name));\n}\n\nexport async function getMeta(conn: Connection, key: string): Promise<string | null> {\n  const stmt = await conn.prepare('SELECT value FROM meta WHERE key = ?');\n  const row = (await stmt.get(key)) as { value: string } | undefined;\n  return row ? row.value : null;\n}\n\nexport async function setMeta(conn: Connection, key: string, value: string | null): Promise<void> {\n  if (value === null) {\n    const stmt = await conn.prepare('DELETE FROM meta WHERE key = ?');\n    await stmt.run(key);\n    return;\n  }\n  const stmt = await conn.prepare('INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value');\n  await stmt.run(key, value);\n}\n"],"names":["quoteIdent","name","split","join","getColumns","conn","stmt","prepare","rows","all","Set","map","r","getMeta","key","row","get","value","setMeta","run"],"mappings":"AAEA,2FAA2F;AAC3F,sFAAsF;AAEtF,OAAO,SAASA,WAAWC,IAAY;IACrC,OAAO,CAAC,CAAC,EAAEA,KAAKC,KAAK,CAAC,KAAKC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1C;AAEA,OAAO,eAAeC,WAAWC,IAAgB;IAC/C,MAAMC,OAAO,MAAMD,KAAKE,OAAO,CAAC;IAChC,MAAMC,OAAQ,MAAMF,KAAKG,GAAG;IAC5B,OAAO,IAAIC,IAAIF,KAAKG,GAAG,CAAC,CAACC,IAAMA,EAAEX,IAAI;AACvC;AAEA,OAAO,eAAeY,QAAQR,IAAgB,EAAES,GAAW;IACzD,MAAMR,OAAO,MAAMD,KAAKE,OAAO,CAAC;IAChC,MAAMQ,MAAO,MAAMT,KAAKU,GAAG,CAACF;IAC5B,OAAOC,MAAMA,IAAIE,KAAK,GAAG;AAC3B;AAEA,OAAO,eAAeC,QAAQb,IAAgB,EAAES,GAAW,EAAEG,KAAoB;IAC/E,IAAIA,UAAU,MAAM;QAClB,MAAMX,OAAO,MAAMD,KAAKE,OAAO,CAAC;QAChC,MAAMD,KAAKa,GAAG,CAACL;QACf;IACF;IACA,MAAMR,OAAO,MAAMD,KAAKE,OAAO,CAAC;IAChC,MAAMD,KAAKa,GAAG,CAACL,KAAKG;AACtB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/sensemaking/src/store/shared.ts"],"sourcesContent":["import type { Connection } from './types.ts';\n\n// SQL and meta-table primitives both stores' open()/reconcile() need. Engine-neutral: both\n// stores' Connection satisfies the same async exec/prepare/runBatch shape (types.ts).\n\nexport function quoteIdent(name: string): string {\n  return `\"${name.split('\"').join('\"\"')}\"`;\n}\n\nexport async function getColumns(conn: Connection): Promise<Set<string>> {\n  const stmt = await conn.prepare('PRAGMA table_info(frontmatter)');\n  const rows = (await stmt.all()) as Array<{ name: string }>;\n  return new Set(rows.map((r) => r.name));\n}\n\nexport async function getMeta(conn: Connection, key: string): Promise<string | null> {\n  const stmt = await conn.prepare('SELECT value FROM meta WHERE key = ?');\n  const row = (await stmt.get(key)) as { value: string } | undefined;\n  return row ? row.value : null;\n}\n\nexport async function setMeta(conn: Connection, key: string, value: string | null): Promise<void> {\n  if (value === null) {\n    const stmt = await conn.prepare('DELETE FROM meta WHERE key = ?');\n    await stmt.run(key);\n    return;\n  }\n  const stmt = await conn.prepare('INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value');\n  await stmt.run(key, value);\n}\n\n// Reconcile's own write-transaction duration, for open()'s derived busy_timeout: keep the\n// observed max so a big watcher reconcile's lock hold is what the next open bounds its wait against.\nexport async function recordReconcileDuration(conn: Connection, ms: number): Promise<void> {\n  const prevRaw = await getMeta(conn, 'reconcile_max_ms');\n  // -1, not 0, so a genuinely 0ms first reconcile (sub-millisecond, common on a tiny tree)\n  // still gets recorded instead of losing to the \"nothing recorded yet\" default.\n  const prevMax = prevRaw === null ? -1 : Number(prevRaw);\n  if (ms > prevMax) await setMeta(conn, 'reconcile_max_ms', String(ms));\n}\n"],"names":["quoteIdent","name","split","join","getColumns","conn","stmt","prepare","rows","all","Set","map","r","getMeta","key","row","get","value","setMeta","run","recordReconcileDuration","ms","prevRaw","prevMax","Number","String"],"mappings":"AAEA,2FAA2F;AAC3F,sFAAsF;AAEtF,OAAO,SAASA,WAAWC,IAAY;IACrC,OAAO,CAAC,CAAC,EAAEA,KAAKC,KAAK,CAAC,KAAKC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1C;AAEA,OAAO,eAAeC,WAAWC,IAAgB;IAC/C,MAAMC,OAAO,MAAMD,KAAKE,OAAO,CAAC;IAChC,MAAMC,OAAQ,MAAMF,KAAKG,GAAG;IAC5B,OAAO,IAAIC,IAAIF,KAAKG,GAAG,CAAC,CAACC,IAAMA,EAAEX,IAAI;AACvC;AAEA,OAAO,eAAeY,QAAQR,IAAgB,EAAES,GAAW;IACzD,MAAMR,OAAO,MAAMD,KAAKE,OAAO,CAAC;IAChC,MAAMQ,MAAO,MAAMT,KAAKU,GAAG,CAACF;IAC5B,OAAOC,MAAMA,IAAIE,KAAK,GAAG;AAC3B;AAEA,OAAO,eAAeC,QAAQb,IAAgB,EAAES,GAAW,EAAEG,KAAoB;IAC/E,IAAIA,UAAU,MAAM;QAClB,MAAMX,OAAO,MAAMD,KAAKE,OAAO,CAAC;QAChC,MAAMD,KAAKa,GAAG,CAACL;QACf;IACF;IACA,MAAMR,OAAO,MAAMD,KAAKE,OAAO,CAAC;IAChC,MAAMD,KAAKa,GAAG,CAACL,KAAKG;AACtB;AAEA,0FAA0F;AAC1F,qGAAqG;AACrG,OAAO,eAAeG,wBAAwBf,IAAgB,EAAEgB,EAAU;IACxE,MAAMC,UAAU,MAAMT,QAAQR,MAAM;IACpC,yFAAyF;IACzF,+EAA+E;IAC/E,MAAMkB,UAAUD,YAAY,OAAO,CAAC,IAAIE,OAAOF;IAC/C,IAAID,KAAKE,SAAS,MAAML,QAAQb,MAAM,oBAAoBoB,OAAOJ;AACnE"}

package/dist/esm/store/signature.d.ts

@@ -0,0 +1,3 @@
+export declare function changedSignatureKeys(before: string, after: string): Set<string>;
+export declare function embedIdentityAdopted(before: string, after: string): boolean;
+export declare function signatureDiff(before: string, after: string): string;

package/dist/esm/store/signature.js

@@ -0,0 +1,35 @@
+// Feature-signature comparison for open()'s rebuild-vs-adopt decision (config.featureSignature's
+// format: global features, embed provider, tokenize, then one segment per preset). Pure string
+// comparison, no SQL, shared by every store's open dialect.
+// Segment keys that moved between two feature signatures.
+export function changedSignatureKeys(before, after) {
+    const keyOf = (part)=>part.startsWith('preset:') ? part.split(':').slice(0, 2).join(':') : part.split(':')[0];
+    const parse = (sig)=>new Map(sig.split('|').map((part)=>[
+                keyOf(part),
+                part
+            ]));
+    const a = parse(before);
+    const b = parse(after);
+    const changed = new Set();
+    for (const [key, val] of b)if (a.get(key) !== val) changed.add(key);
+    for (const key of a.keys())if (!b.has(key)) changed.add(key);
+    return changed;
+}
+// Whether the embed segment only gained its resolved weight identity: same provider and
+// model, no identity recorded before, one now -- adopted into meta without a rebuild.
+export function embedIdentityAdopted(before, after) {
+    const embedPart = (sig)=>sig.split('|').find((p)=>p.startsWith('embed:'));
+    const b = embedPart(before);
+    const a = embedPart(after);
+    if (b === undefined || a === undefined) return false;
+    const at = a.indexOf('@');
+    return b.indexOf('@') === -1 && at !== -1 && a.slice(0, at) === b;
+}
+// Names what moved, for the rebuild notice.
+export function signatureDiff(before, after) {
+    const changed = changedSignatureKeys(before, after);
+    const label = (key)=>key === 'embed' ? 'embed settings' : key === 'tokenize' ? 'content tokenizer' : key.startsWith('preset:') ? `preset "${key.slice(7)}"` : 'features';
+    return changed.size === 0 ? 'features' : [
+        ...changed
+    ].map(label).join(', ');
+}

package/dist/esm/store/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/sensemaking/src/store/signature.ts"],"sourcesContent":["// Feature-signature comparison for open()'s rebuild-vs-adopt decision (config.featureSignature's\n// format: global features, embed provider, tokenize, then one segment per preset). Pure string\n// comparison, no SQL, shared by every store's open dialect.\n\n// Segment keys that moved between two feature signatures.\nexport function changedSignatureKeys(before: string, after: string): Set<string> {\n  const keyOf = (part: string) => (part.startsWith('preset:') ? part.split(':').slice(0, 2).join(':') : part.split(':')[0]);\n  const parse = (sig: string) => new Map(sig.split('|').map((part) => [keyOf(part), part]));\n  const a = parse(before);\n  const b = parse(after);\n  const changed = new Set<string>();\n  for (const [key, val] of b) if (a.get(key) !== val) changed.add(key);\n  for (const key of a.keys()) if (!b.has(key)) changed.add(key);\n  return changed;\n}\n\n// Whether the embed segment only gained its resolved weight identity: same provider and\n// model, no identity recorded before, one now -- adopted into meta without a rebuild.\nexport function embedIdentityAdopted(before: string, after: string): boolean {\n  const embedPart = (sig: string) => sig.split('|').find((p) => p.startsWith('embed:'));\n  const b = embedPart(before);\n  const a = embedPart(after);\n  if (b === undefined || a === undefined) return false;\n  const at = a.indexOf('@');\n  return b.indexOf('@') === -1 && at !== -1 && a.slice(0, at) === b;\n}\n\n// Names what moved, for the rebuild notice.\nexport function signatureDiff(before: string, after: string): string {\n  const changed = changedSignatureKeys(before, after);\n  const label = (key: string) => (key === 'embed' ? 'embed settings' : key === 'tokenize' ? 'content tokenizer' : key.startsWith('preset:') ? `preset \"${key.slice(7)}\"` : 'features');\n  return changed.size === 0 ? 'features' : [...changed].map(label).join(', ');\n}\n"],"names":["changedSignatureKeys","before","after","keyOf","part","startsWith","split","slice","join","parse","sig","Map","map","a","b","changed","Set","key","val","get","add","keys","has","embedIdentityAdopted","embedPart","find","p","undefined","at","indexOf","signatureDiff","label","size"],"mappings":"AAAA,iGAAiG;AACjG,+FAA+F;AAC/F,4DAA4D;AAE5D,0DAA0D;AAC1D,OAAO,SAASA,qBAAqBC,MAAc,EAAEC,KAAa;IAChE,MAAMC,QAAQ,CAACC,OAAkBA,KAAKC,UAAU,CAAC,aAAaD,KAAKE,KAAK,CAAC,KAAKC,KAAK,CAAC,GAAG,GAAGC,IAAI,CAAC,OAAOJ,KAAKE,KAAK,CAAC,IAAI,CAAC,EAAE;IACxH,MAAMG,QAAQ,CAACC,MAAgB,IAAIC,IAAID,IAAIJ,KAAK,CAAC,KAAKM,GAAG,CAAC,CAACR,OAAS;gBAACD,MAAMC;gBAAOA;aAAK;IACvF,MAAMS,IAAIJ,MAAMR;IAChB,MAAMa,IAAIL,MAAMP;IAChB,MAAMa,UAAU,IAAIC;IACpB,KAAK,MAAM,CAACC,KAAKC,IAAI,IAAIJ,EAAG,IAAID,EAAEM,GAAG,CAACF,SAASC,KAAKH,QAAQK,GAAG,CAACH;IAChE,KAAK,MAAMA,OAAOJ,EAAEQ,IAAI,GAAI,IAAI,CAACP,EAAEQ,GAAG,CAACL,MAAMF,QAAQK,GAAG,CAACH;IACzD,OAAOF;AACT;AAEA,wFAAwF;AACxF,sFAAsF;AACtF,OAAO,SAASQ,qBAAqBtB,MAAc,EAAEC,KAAa;IAChE,MAAMsB,YAAY,CAACd,MAAgBA,IAAIJ,KAAK,CAAC,KAAKmB,IAAI,CAAC,CAACC,IAAMA,EAAErB,UAAU,CAAC;IAC3E,MAAMS,IAAIU,UAAUvB;IACpB,MAAMY,IAAIW,UAAUtB;IACpB,IAAIY,MAAMa,aAAad,MAAMc,WAAW,OAAO;IAC/C,MAAMC,KAAKf,EAAEgB,OAAO,CAAC;IACrB,OAAOf,EAAEe,OAAO,CAAC,SAAS,CAAC,KAAKD,OAAO,CAAC,KAAKf,EAAEN,KAAK,CAAC,GAAGqB,QAAQd;AAClE;AAEA,4CAA4C;AAC5C,OAAO,SAASgB,cAAc7B,MAAc,EAAEC,KAAa;IACzD,MAAMa,UAAUf,qBAAqBC,QAAQC;IAC7C,MAAM6B,QAAQ,CAACd,MAAiBA,QAAQ,UAAU,mBAAmBA,QAAQ,aAAa,sBAAsBA,IAAIZ,UAAU,CAAC,aAAa,CAAC,QAAQ,EAAEY,IAAIV,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG;IACzK,OAAOQ,QAAQiB,IAAI,KAAK,IAAI,aAAa;WAAIjB;KAAQ,CAACH,GAAG,CAACmB,OAAOvB,IAAI,CAAC;AACxE"}

package/dist/esm/store/sqlite/open.d.ts

@@ -1,13 +1,13 @@
+import { DatabaseSync } from 'node:sqlite';
 import type { ResolvedConfig } from '../../config/index.js';
-import type { Store } from '../types.js';
+import type { OpenResult } from '../open.js';
+import type { OpenDialect } from '../types.js';
 export declare const DB_FILENAME = "cache.db";
-export declare const SCHEMA_VERSION = "18";
-export interface OpenResult {
-    store: Store;
-    cfg: ResolvedConfig;
-    dbPath: string;
-    parsed: number;
-    warnings: string[];
+export declare const SCHEMA_VERSION = "19";
+export type { OpenResult };
+interface SqliteHandle {
+    db: DatabaseSync;
+    tokenize: string;
 }
+export declare const sqliteOpenDialect: OpenDialect<SqliteHandle>;
 export declare function openSqlite(cfg: ResolvedConfig): Promise<OpenResult>;
-export declare function docCount(store: Store): Promise<number>;