daftari 1.7.1 → 1.9.0

package/CHANGELOG.md

@@ -7,6 +7,128 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.9.0] - 2026-05-21
+
+### Added
+
+- **fs.watch reactive indexing** (#38, PR 3 of 5). The server now keeps the
+  search index in sync with the markdown files at write time, not just at
+  startup. A chokidar watcher runs over the vault root after the MCP
+  transport is up and the cold-start reindex (if any) has finished;
+  `add` / `change` events trigger an `indexDocument()` pass for the
+  affected file, and `unlink` evicts the document and patches the
+  freshness manifest so the next startup does not see a missing file as
+  drift. Events are debounced per-path with a 500ms window — an
+  editor's atomic-rename save burst coalesces into one indexer call —
+  and `unlink` events re-stat before deleting, so FSEvents / iCloud /
+  Dropbox phantom unlink+add pairs during atomic-rename saves are
+  treated as a change instead of a delete. Daftari's own writes are
+  suppressed from the watcher path: the write-path tools register the
+  absolute path after their in-process `indexDocument()` returns, and
+  the watcher silently drops the chokidar event that follows. The new
+  `watch` config flag (default `true`) lets read-only or scripted
+  environments disable the watcher entirely. The startup freshness
+  check (manifest mtimes vs disk, see #36) remains as the reconciliation
+  backstop for events the watcher drops.
+
+- **Pluggable embedding backend** (#38, PR 4 of 5). The embedding model is
+  no longer hard-coded; a new `EmbeddingProvider` interface lets the vault
+  owner choose between two backends in `.daftari/config.yaml`:
+
+  ```yaml
+  embeddings:
+    provider: local-minilm   # default. Other values: openai-3-small.
+  ```
+
+  - **`local-minilm`** (default, 384-dim) is the existing
+    `all-MiniLM-L6-v2` path run via `@huggingface/transformers` — free,
+    fully local, slow on cold-start.
+  - **`openai-3-small`** (1536-dim) calls OpenAI's `text-embedding-3-small`
+    endpoint. ~10x faster on large vaults but paid. Requires
+    `OPENAI_API_KEY` in the server's environment; a missing key is a hard
+    config error at startup, not a silent fallback. Batches at 96 inputs
+    per request with exponential backoff on 429 / 5xx (up to 3 retries).
+
+  The `embeddings` table gains a `dim` column (schema bump 3 → 4) as
+  defense-in-depth against a corrupt or cross-provider mix. The schema
+  bump rebuilds the index cleanly — derived from the markdown files, no
+  manual migration needed. Switching providers between server runs is
+  safe: the `(content_hash, model)` composite PK lets both providers'
+  rows coexist, and the new provider's first reindex naturally populates
+  its own row set without re-embedding under the old id.
+
+### Changed
+
+- **SQL-native search via FTS5 and sqlite-vec** (#38, PR 5 of 5 — closes
+  the #38 unbundle). The hand-rolled BM25 ranker (a JavaScript scan over
+  a JSON tokens column) and the brute-force JavaScript cosine loop are
+  both gone; lexical search now runs through an FTS5 virtual table
+  (`documents_fts`) and vector search through a sqlite-vec `vec0`
+  virtual table (`embeddings_vec`). Both halves are one prepared
+  statement; SQLite's built-in BM25 ranks FTS5 matches, sqlite-vec's
+  cosine KNN ranks vector matches. AFTER INSERT / UPDATE / DELETE
+  triggers on the `documents` table keep the FTS5 mirror in sync — the
+  indexer never writes to the virtual table directly. Schema bumped
+  4 → 5; the index is a derived cache so the bump triggers a clean
+  rebuild from the markdown files. The vec table is sized at the active
+  embedding provider's dim and rebuilt on provider switch (the durable
+  `embeddings` cache is per-`(content_hash, model)` and survives the
+  vec-table rebuild, so a switch back to the previous provider is all
+  cache hits). New dependency: `sqlite-vec`. New prerequisite:
+  `better-sqlite3` with extension loading enabled — the npm prebuilt
+  has it on by default, so `npm install` is the only setup step in the
+  common case; a custom build with it disabled is a hard startup error
+  with actionable text (`npm rebuild better-sqlite3 --build-from-source`).
+  This is the final follow-up in the #38 unbundle; v1.9.0 ships as a
+  grouped release covering all five.
+
+- **Lazy embedding model load with background warm-up** (#38, PR 2 of 5).
+  The MiniLM embedding model no longer loads at server startup. With the
+  v1.8.0 content-addressed cache, a startup whose freshness manifest matches
+  disk skips the reindex pass, and a reindex whose chunk hashes are all
+  cached skips `embed()` entirely — so the model load (~100MB, ~500ms cold)
+  is now deferred until something actually needs to embed. A read-only role
+  that only calls `vault_read` / `vault_search` against a fully-cached
+  index never loads the model at all. After the MCP transport opens and the
+  freshness check / background reindex begins, the server kicks off a
+  `warmModel()` in a `void` background promise so the first user search
+  does not pay the cold-start cost. A warm-up failure (no network on the
+  first run, model download blocked) is logged to stderr but never crashes
+  the server — the next `embed()` call retries. The warm-up is gated by a
+  new optional `warm_embeddings` flag in `.daftari/config.yaml` (default
+  `true`); set it to `false` for read-only deployments or memory-constrained
+  environments. The transport-open-before-indexing ordering from v1.7.1
+  is preserved — no startup hang regression. A new `modelStatus` field on
+  the in-process `IndexState` (`cold` / `warming` / `ready` / `error`) lets
+  tools surface "embeddings warming" context when a client retries against
+  a warming model rather than misreporting an indexing pass.
+
+## [1.8.0] - 2026-05-20
+
+### Changed
+
+- **Content-addressed embedding cache** (#38, PR #39). Embeddings are no
+  longer keyed by `(path, chunk_index)` — they now live in a separate
+  `embeddings` table keyed by `(content_hash, model)`, where
+  `content_hash` is the SHA-256 of the chunk's text. `chunks` rows carry
+  a `content_hash` column and join to `embeddings` for the current model.
+  A reindex now hashes every chunk, asks the cache which hashes already
+  have a row, and only embeds the misses — so the cost of a reindex
+  scales with the number of *changed chunks*, not the size of the vault.
+  An edit to one paragraph re-embeds one chunk; a rename re-embeds zero;
+  a paragraph moved verbatim to another file re-embeds zero. The
+  composite primary key on `(content_hash, model)` is intentional: a
+  future model migration can keep both the old and new model's
+  embeddings present under the same hash. After writing chunks, the
+  reindex runs an internal `vault_gc` step that drops embeddings rows
+  whose `content_hash` is no longer referenced by any chunk, so the
+  cache does not accumulate orphans. `index.db` rebuilds cleanly on the
+  schema bump (the index is a derived cache); the first reindex after
+  upgrade is a one-time full embed that populates the cache, and every
+  reindex after that is incremental. This is PR 1 of the #38 unbundle;
+  fs.watch reactive indexing, lazy model load, FTS5, sqlite-vec, and
+  pluggable embedding backends are tracked as separate follow-ups.
+
 ## [1.7.1] - 2026-05-19
 
 ### Fixed

package/README.md

@@ -36,7 +36,7 @@ part.
 
 | Layer | Concern | What Daftari provides |
 |------:|---------|-----------------------|
-| 1 | **Storage** | Markdown + YAML frontmatter on disk, a git history, a rebuildable SQLite index for hybrid BM25 + vector search. |
+| 1 | **Storage** | Markdown + YAML frontmatter on disk, a git history, a rebuildable SQLite index — FTS5 for lexical ranking, sqlite-vec for vector search. |
 | 2 | **Multi-tenant ACL** | Config-driven RBAC. Roles and per-collection read/write/promote permissions declared in `.daftari/config.yaml`. |
 | 3 | **Write safety** ⭐ | File-level write locks (SQLite-backed, 60s TTL) give single-writer-per-document safety — a competing writer fails cleanly instead of corrupting the file. This is a safety mechanism, not a coordination protocol. The ⭐ is for what is genuinely differentiated: every write auto-committed to git with a provenance log of who changed what and when. |
 | 4 | **Curation decay** ⭐ | The draft → canonical → deprecated lifecycle, TTL-based staleness, tension logging for contradictions, and an advisory linter. Knowledge that stops being true is surfaced, not silently trusted. |
@@ -152,34 +152,83 @@ by name with JSON arguments; the server replies with a JSON text block. Here is
 ## Search internals
 
 `vault_search` is **hybrid**: a BM25 lexical score and a vector (semantic)
-score, blended with tunable weights. The vector half is worth being explicit
-about, because a local-first tool should never leave you guessing whether a
-query leaves your machine.
+score, blended with tunable weights. Both halves are SQL-native — they
+run inside SQLite, not in JavaScript.
+
+- **Lexical half.** An FTS5 virtual table (`documents_fts`) over title,
+  tags, and body. SQLite's built-in BM25 ranks every MATCH'd row.
+  Triggers on the regular `documents` table keep the FTS index in sync
+  on every write, so the indexer never touches the virtual table
+  directly. Free-text queries are tokenised, stopword-filtered, and
+  prefix-OR'd (`cirrus pricing` becomes `cirrus* OR pricing*`) so a
+  partial-keystroke or stem variation still matches.
+
+- **Vector half.** A sqlite-vec `vec0` virtual table
+  (`embeddings_vec`), sized at the active provider's dim and indexed for
+  KNN cosine queries. The durable `embeddings` cache (one row per
+  `(content_hash, model)`) is the source of truth; `embeddings_vec`
+  mirrors it for query-time access. Switching embedding providers
+  triggers a drop-and-rebuild of the vec table at the new dim — the
+  durable cache survives, so switching back is all cache hits.
+
+**Prerequisite.** sqlite-vec is a loadable SQLite extension. The
+`sqlite-vec` npm package ships pre-built binaries for darwin / linux /
+windows on x64 and arm64; `better-sqlite3`'s npm prebuilt enables
+extension loading by default. In the common case `npm install` is the
+only setup step. If a custom `better-sqlite3` build with extension
+loading disabled is in use, Daftari refuses to start with an actionable
+error: `npm rebuild better-sqlite3 --build-from-source`.
+
+The vector half is worth being explicit about, because a local-first
+tool should never leave you guessing whether a query leaves your
+machine.
+
+### Embedding providers
+
+Daftari ships with two embedding backends. Pick one in
+`.daftari/config.yaml`:
 
-- **Embedding model.** `all-MiniLM-L6-v2` (the `Xenova/all-MiniLM-L6-v2`
-  build), a 384-dimension sentence-transformer.
-- **Where it runs.** Entirely **local**. Embeddings are computed in-process by
+```yaml
+embeddings:
+  provider: local-minilm   # default. Other values: openai-3-small.
+```
+
+- **`local-minilm`** (default). `all-MiniLM-L6-v2` (the
+  `Xenova/all-MiniLM-L6-v2` build), a 384-dimension sentence-transformer.
+  Runs entirely **local**: embeddings are computed in-process by
   [`@huggingface/transformers`](https://www.npmjs.com/package/@huggingface/transformers)
-  (Transformers.js). There is **no external embedding API** — nothing is sent
-  to Hugging Face, OpenAI, or anyone else at index or query time.
-- **Dependencies.** Just `npm install`. No Python, no separate ONNX runtime, no
-  GPU, no API key — the ONNX runtime ships as a dependency of
-  `@huggingface/transformers`. The **first** reindex downloads the model
-  weights (~25 MB) from the Hugging Face hub and caches them on disk; every run
-  after that is fully offline.
-- **Graceful degradation.** If the model cannot load — e.g. no network on the
-  very first run, before the weights are cached — `vault_reindex` still builds
-  the BM25 index. The vector column is left empty, `vectorUsed` reports
-  `false`, and search transparently falls back to lexical-only ranking.
+  (Transformers.js). No external embedding API — nothing is sent to
+  Hugging Face, OpenAI, or anyone else at index or query time. Just
+  `npm install` — no Python, no API key. The **first** reindex downloads
+  the model weights (~25 MB) from the Hugging Face hub and caches them on
+  disk; every run after that is fully offline. Slow on cold start
+  (~25 min CPU on a 44k-chunk vault), but free.
+
+- **`openai-3-small`**. OpenAI's `text-embedding-3-small`, a 1536-dimension
+  hosted embedding. **Sends chunk text to OpenAI** at reindex time —
+  enable this only if you're comfortable with that. Requires
+  `OPENAI_API_KEY` in the server's environment (it is never read from
+  config files). ~10x faster than `local-minilm` on large vaults; on the
+  44k-chunk benchmark above, ~2 minutes and ~$0.10. Because Daftari's
+  embedding cache is content-addressed by `(content_hash, model)`, the
+  paid cost is a **one-time event per chunk text** — re-running
+  `vault_reindex` on an unchanged vault embeds zero new chunks. Switching
+  providers between server runs is safe: the cache keeps both providers'
+  rows, so switching back to the other later re-uses what was previously
+  embedded.
+
+- **Graceful degradation.** Whichever provider is active, if it cannot
+  reach the model (no network on the very first `local-minilm` run, before
+  the weights are cached; or OpenAI unreachable), `vault_reindex` still
+  builds the FTS5 lexical index. The vector column is left empty,
+  `vectorUsed` reports `false`, and search transparently falls back to
+  lexical-only ranking.
+
 - **Quality tradeoff.** MiniLM is small and fast, which keeps Daftari
-  dependency-light and snappy, but its recall/precision is below larger hosted
-  embedding models. Pairing it with BM25 covers the common case where a small
+  dependency-light and snappy, but its recall/precision is below larger
+  hosted embedding models. `openai-3-small` is the obvious next step.
+  Pairing either with FTS5 BM25 covers the common case where a small
   model misses an exact-term match.
-- **Swappability.** v1 pins the model as a constant (`EMBEDDING_MODEL` in
-  [`src/search/vector.ts`](src/search/vector.ts)). Any model the Transformers.js
-  feature-extraction pipeline supports can be substituted by editing that
-  constant (and `EMBEDDING_DIM` to match) and running `vault_reindex`. A
-  config-driven bring-your-own-embedding hook is not in v1.
 
 ---
 

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFhF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkCA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASrE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GhF"}

package/dist/index.js

@@ -19,6 +19,8 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { GUEST_ROLE, resolveAccess } from "./access/rbac.js";
 import { markIndexError, markIndexing, markIndexReady, setIndexProgress, } from "./search/index-state.js";
 import { isIndexFresh, reindexVault } from "./search/reindex.js";
+import { setProvider, warmModel } from "./search/vector.js";
+import { startWatcher } from "./search/watcher.js";
 import { createServer } from "./server.js";
 import { directoryExists } from "./storage/local.js";
 import { loadConfig } from "./utils/config.js";
@@ -58,6 +60,20 @@ export async function main(argv = process.argv.slice(2)) {
         process.exitCode = 1;
         return;
     }
+    // Install the configured embedding provider. loadConfig has already
+    // validated the id and (for openai-3-small) the OPENAI_API_KEY env var,
+    // so setProvider should never throw here — but if it does (race-y env
+    // var stripping by a wrapper, say), fail loud rather than serving with
+    // a broken provider.
+    try {
+        setProvider(config.value.embeddingProvider);
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        process.stderr.write(`daftari: ${reason}\n`);
+        process.exitCode = 1;
+        return;
+    }
     // Resolve the access identity. With no --role the server runs as the
     // deny-all guest; an unknown role name resolves the same way.
     const user = parseFlag(argv, "user") ?? "guest";
@@ -103,6 +119,14 @@ export async function main(argv = process.argv.slice(2)) {
     if (fresh) {
         process.stderr.write(`daftari: index is up to date — skipping reindex\n`);
         markIndexReady();
+        // Fresh index means a fully-cached state: no embedding work was done, so
+        // the model is still cold. Warm it in the background (if config allows)
+        // so the first user search does not pay the ~500ms cold start. Then
+        // start the watcher to catch out-of-band edits going forward.
+        if (config.value.warmEmbeddings) {
+            void runBackgroundWarm();
+        }
+        maybeStartWatcher(vaultRoot, config.value.watch);
         return;
     }
     // Background reindex. The promise is intentionally not awaited — main()
@@ -110,9 +134,53 @@ export async function main(argv = process.argv.slice(2)) {
     // completion alongside the live server.
     markIndexing();
     process.stderr.write(`daftari: starting background reindex…\n`);
-    void runBackgroundReindex(vaultRoot);
+    void runBackgroundReindex(vaultRoot, config.value.warmEmbeddings, () => {
+        maybeStartWatcher(vaultRoot, config.value.watch);
+    });
+}
+// Reference held so a SIGTERM / SIGINT can close the watcher cleanly. One
+// per process — the server runs against one vault for its lifetime.
+let activeWatcher = null;
+// Spawns the chokidar watcher when config.watch !== false. Wired here, not
+// at module load, so the test entry points (which import main) can run with
+// a config that disables it. Idempotent: a second call is a no-op while the
+// first watcher is still alive.
+function maybeStartWatcher(vaultRoot, watchEnabled) {
+    if (!watchEnabled) {
+        process.stderr.write(`daftari: vault watcher disabled (watch: false in config)\n`);
+        return;
+    }
+    if (activeWatcher)
+        return;
+    activeWatcher = startWatcher(vaultRoot);
+    process.stderr.write(`daftari: watching vault for out-of-band edits\n`);
+    // Clean shutdown on the signals stdio MCP servers receive when their
+    // parent process closes the pipe. Without this the chokidar handles can
+    // keep the event loop alive past the transport close.
+    const onShutdown = () => {
+        if (!activeWatcher)
+            return;
+        const w = activeWatcher;
+        activeWatcher = null;
+        void w.close();
+    };
+    process.once("SIGTERM", onShutdown);
+    process.once("SIGINT", onShutdown);
 }
-async function runBackgroundReindex(vaultRoot) {
+// Loads the embedding model in the background so the first user search does
+// not pay the cold-start latency. Failures (no network on first run, model
+// download blocked) are logged but never crash the server — the next embed()
+// call will retry. Intended to be invoked as a `void` from main().
+async function runBackgroundWarm() {
+    const result = await warmModel();
+    if (result.ok) {
+        process.stderr.write(`daftari: embedding model warm — ready for search\n`);
+    }
+    else {
+        process.stderr.write(`daftari: warning: embedding warm-up failed: ${result.error.message}\n`);
+    }
+}
+async function runBackgroundReindex(vaultRoot, warmEmbeddings, onDone) {
     try {
         const reindexed = await reindexVault(vaultRoot, makeProgressReporter());
         if (reindexed.ok) {
@@ -120,6 +188,13 @@ async function runBackgroundReindex(vaultRoot) {
             markIndexReady();
             process.stderr.write(`daftari: indexed ${r.documentCount} docs, ${r.chunkCount} chunks ` +
                 `(vectors ${r.vectorEnabled ? "on" : "off"})\n`);
+            // If the reindex was fully cache-hit (no chunks needed embedding) the
+            // model was never loaded — warm it now so the first user search isn't
+            // a cold start. A reindex that did embed already loaded the model; no
+            // extra warm is necessary in that path.
+            if (warmEmbeddings && r.embeddedCount === 0) {
+                void runBackgroundWarm();
+            }
         }
         else {
             markIndexError(reindexed.error.message);
@@ -131,6 +206,14 @@ async function runBackgroundReindex(vaultRoot) {
         markIndexError(reason);
         process.stderr.write(`daftari: warning: background indexer crashed: ${reason}\n`);
     }
+    finally {
+        // Start the watcher only after the full reindex pass finishes — the
+        // dispatch() guard inside watcher.ts would queue events while the
+        // global status is "indexing", but starting after avoids the
+        // bookkeeping and keeps the startup ordering obvious: transport,
+        // freshness/reindex, watcher.
+        onDone?.();
+    }
 }
 // Builds a ReindexOptions whose onProgress streams to both stderr (for
 // operator visibility) and the in-process IndexState (so tools can return

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/search/bm25.d.ts

@@ -1,19 +1,3 @@
 export declare function tokenize(text: string): string[];
-export interface Bm25Document {
-    path: string;
-    tokens: string[];
-}
-export interface Bm25Model {
-    termFreqs: Map<string, Map<string, number>>;
-    docFreqs: Map<string, number>;
-    docLengths: Map<string, number>;
-    docCount: number;
-    avgDocLength: number;
-}
-export declare function buildBm25(docs: Bm25Document[]): Bm25Model;
-export interface Bm25Hit {
-    path: string;
-    score: number;
-}
-export declare function searchBm25(model: Bm25Model, queryTokens: string[]): Bm25Hit[];
+export declare function buildMatchQuery(query: string): string | null;
 //# sourceMappingURL=bm25.d.ts.map

package/dist/search/bm25.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AA4DA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IAExB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,SAAS,CA0BzD;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAsB7E"}
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AA4DA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAqBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D"}

package/dist/search/bm25.js

@@ -1,18 +1,19 @@
-// BM25 lexical ranking, hand-rolled and dependency-free.
+// Lexical ranking — now a thin shim over SQLite FTS5.
 //
-// BM25 scores a document for a query by summing, over each query term, an IDF
-// weight times a saturating term-frequency factor. It is the lexical half of
-// hybrid search: it rewards exact word overlap, which embeddings tend to blur.
+// Until v1.9 this file held a hand-rolled BM25 implementation that scanned
+// every document's JSON-tokens column in JavaScript. SQLite's built-in FTS5
+// virtual table is faster, scales further, and ships with its own (Okapi)
+// BM25 ranker — so this file is now reduced to (a) a query-side tokenizer
+// used by snippet building and `relatedSearch`, and (b) a helper that turns
+// a free-text query into the prefix-OR'd MATCH string FTS5 expects.
 //
-// The vault is a curated knowledge base (tens to low-hundreds of documents),
-// so the whole corpus is ranked in memory on every query. No inverted index.
-// Okapi BM25 free parameters. k1 controls term-frequency saturation; b controls
-// how strongly document length normalises the score. These are the standard
-// defaults and need no tuning at this corpus size.
-const K1 = 1.5;
-const B = 0.75;
-// Common English words carry no discriminating signal; dropping them keeps IDF
-// meaningful and snippets pointed at content words.
+// The FTS5 virtual table (`documents_fts`) is declared in
+// `src/storage/index-db.ts`; AFTER INSERT/UPDATE/DELETE triggers on the
+// `documents` table keep it in sync.
+// Common English words carry no discriminating signal; dropping them keeps
+// the query side aligned with FTS5's porter/unicode61 tokenizer (which also
+// drops stopwords from BM25 scoring via low IDF) and gives snippet building
+// a cleaner highlight list.
 const STOPWORDS = new Set([
     "a",
     "an",
@@ -53,63 +54,40 @@ const STOPWORDS = new Set([
     "your",
 ]);
 // Lowercases, splits on any non-alphanumeric run, and drops stopwords and
-// 1-character fragments. Used identically for documents and queries so the
-// term spaces line up.
+// 1-character fragments. Used for snippet highlighting and as the BM25
+// query-side tokens fed into FTS5's MATCH parser.
 export function tokenize(text) {
     return text
         .toLowerCase()
         .split(/[^a-z0-9]+/)
         .filter((t) => t.length > 1 && !STOPWORDS.has(t));
 }
-export function buildBm25(docs) {
-    const termFreqs = new Map();
-    const docFreqs = new Map();
-    const docLengths = new Map();
-    let totalLength = 0;
-    for (const doc of docs) {
-        const tf = new Map();
-        for (const term of doc.tokens) {
-            tf.set(term, (tf.get(term) ?? 0) + 1);
-        }
-        termFreqs.set(doc.path, tf);
-        docLengths.set(doc.path, doc.tokens.length);
-        totalLength += doc.tokens.length;
-        for (const term of tf.keys()) {
-            docFreqs.set(term, (docFreqs.get(term) ?? 0) + 1);
-        }
-    }
-    return {
-        termFreqs,
-        docFreqs,
-        docLengths,
-        docCount: docs.length,
-        avgDocLength: docs.length > 0 ? totalLength / docs.length : 0,
-    };
-}
-// Scores every document against the query terms and returns the matches
-// (score > 0) sorted high to low. A document with zero query-term overlap is
-// omitted entirely rather than returned with a zero score.
-export function searchBm25(model, queryTokens) {
-    const hits = [];
-    const uniqueQueryTerms = [...new Set(queryTokens)];
-    for (const [path, tf] of model.termFreqs) {
-        const docLength = model.docLengths.get(path) ?? 0;
-        let score = 0;
-        for (const term of uniqueQueryTerms) {
-            const freq = tf.get(term) ?? 0;
-            if (freq === 0)
-                continue;
-            const df = model.docFreqs.get(term) ?? 0;
-            // IDF with the +1 inside the log keeps it non-negative even for terms
-            // that appear in more than half the corpus.
-            const idf = Math.log(1 + (model.docCount - df + 0.5) / (df + 0.5));
-            const denom = freq + K1 * (1 - B + (B * docLength) / (model.avgDocLength || 1));
-            score += idf * ((freq * (K1 + 1)) / denom);
-        }
-        if (score > 0)
-            hits.push({ path, score });
-    }
-    hits.sort((a, b) => b.score - a.score);
-    return hits;
+// Builds an FTS5 MATCH query from a free-text user query.
+//
+// We tokenize the same way as `tokenize()`, then OR every term together as
+// a prefix match (`cirrus*`). Prefix matching is friendly to partial
+// keystrokes ("pric" → "pricing", "prices") and to morphologically related
+// words; FTS5's porter tokenizer already collapses many of these on the
+// document side, so the prefix is mostly a query-side recall booster.
+//
+// FTS5 query syntax is fragile in the face of user input: quotes, hyphens,
+// the bare words AND / OR / NOT, and the trailing `*` operator all have
+// meaning to the parser. We strip every character outside [a-zA-Z0-9_]
+// during tokenization (already done), so the only remaining hazard is the
+// reserved words. We bypass that by lower-casing every token — FTS5's
+// reserved words are matched case-sensitively in upper case, so `or` is
+// just a search term.
+//
+// Returns null when the query yields no usable tokens (all-whitespace or
+// all-stopwords). Callers must treat null as "no lexical match possible"
+// rather than passing an empty string to MATCH, which is a syntax error.
+export function buildMatchQuery(query) {
+    const tokens = tokenize(query);
+    if (tokens.length === 0)
+        return null;
+    // Deduplicate to keep the MATCH string short. Prefix every token with `*`
+    // for partial matches.
+    const unique = [...new Set(tokens)];
+    return unique.map((t) => `${t}*`).join(" OR ");
 }
 //# sourceMappingURL=bm25.js.map

package/dist/search/bm25.js.map

@@ -1 +1 @@
-{"version":3,"file":"bm25.js","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bm25.js","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,4EAA4E;AAC5E,oEAAoE;AACpE,EAAE;AACF,0DAA0D;AAC1D,wEAAwE;AACxE,qCAAqC;AAErC,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,4BAA4B;AAC5B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,GAAG;IACH,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;CACP,CAAC,CAAC;AAEH,0EAA0E;AAC1E,uEAAuE;AACvE,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,0DAA0D;AAC1D,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AACrE,2EAA2E;AAC3E,wEAAwE;AACxE,sEAAsE;AACtE,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,uEAAuE;AACvE,0EAA0E;AAC1E,sEAAsE;AACtE,wEAAwE;AACxE,sBAAsB;AACtB,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,0EAA0E;IAC1E,uBAAuB;IACvB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/search/embedding-provider.d.ts

@@ -0,0 +1,8 @@
+import type { Result } from "../frontmatter/types.js";
+export interface EmbeddingProvider {
+    readonly id: string;
+    readonly dim: number;
+    warm(): Promise<Result<void, Error>>;
+    embed(texts: string[], onProgress?: (done: number, total: number) => void): Promise<Result<Float32Array[], Error>>;
+}
+//# sourceMappingURL=embedding-provider.d.ts.map

package/dist/search/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../src/search/embedding-provider.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACrC,KAAK,CACH,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACjD,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;CAC3C"}

package/dist/search/embedding-provider.js

@@ -0,0 +1,26 @@
+// EmbeddingProvider — pluggable backend for chunk-to-vector conversion.
+//
+// The vault search index always stored its embeddings under a `model` column,
+// but until this PR there was exactly one model: a locally-loaded MiniLM. The
+// provider interface lets the vault owner pick between free-and-slow (local
+// MiniLM, ~25 min cold reindex on a 44k-chunk vault) and fast-and-paid (an
+// API-backed provider, ~2 min and ~$0.10 for the same vault). Because the
+// embeddings cache is keyed by (content_hash, model), the paid cost is a
+// one-time event per chunk text — a switch back to local doesn't re-embed
+// anything; the old model's rows stay put and the new model populates its
+// own row set.
+//
+// Contract:
+//   - `id` is what gets written to embeddings.model. Two providers with the
+//     same id would corrupt the cache; treat it as a stable namespace.
+//   - `dim` is the vector dimension. The cache stores it per row as defense-
+//     in-depth, but the model id alone scopes the join, so mixed-dim vectors
+//     for the same model id are a bug — not an expected runtime state.
+//   - `warm()` is the eager-load entry point. For providers with no warm-up
+//     cost (e.g. a stateless HTTP client), it can be a no-op that returns ok.
+//   - `embed()` returns one Float32Array per input text, in input order, all
+//     of length `dim`. `onProgress` (if given) fires after each sub-batch.
+//     Errors are returned as Result.err — the caller (reindex / search) is
+//     responsible for degrading gracefully to lexical-only ranking.
+export {};
+//# sourceMappingURL=embedding-provider.js.map