sensemaking 0.27.0 → 0.28.0

package/skills/sense/references/stores/sqlite.md

@@ -2,7 +2,7 @@
 
 Read this guide when `store` is `sqlite` or omitted.
 
-SQLite is the default store. It uses Node's built-in SQLite, keeps the cache at `.sense/cache.db`, supports concurrent sense commands through WAL, and implements the full search grammar documented here.
+SQLite is the default store. It uses Node's built-in SQLite, keeps the cache at `.sense/cache.db`, supports concurrent sense commands through WAL, and implements the full search grammar documented here. A build after a Node upgrade that changes the bundled SQLite version rebuilds the cache, and a no-build query on that cache fails with `INDEX_NOT_READY` until it does.
 
 ## `sense search` grammar
 

package/skills/sense/references/stores/turso.md

@@ -4,7 +4,7 @@ Read this guide when `store` is `turso`.
 
 Sense stores the cache at `.sense/cache.turso.db` and uses `@tursodatabase/database` with Tantivy full-text indexes. Use this experimental adapter when the tree benefits from the embedded Turso engine or its text-index behavior.
 
-The first open installs the native package if needed. Turso holds the cache file for the connection's lifetime, so another Sense command waits for the current command or watcher cycle to close it. The upstream engine supports more deployment and concurrency options than this adapter currently exposes. Sense opens a local file and does not configure sync, remote access, concurrent writers, or encryption.
+The first open installs the native package if needed, at the newest version in sensemaking's declared range. A build after the installed version changes rebuilds the cache, and a no-build query on that cache fails with `INDEX_NOT_READY` until it does. Turso holds the cache file for the connection's lifetime, so another Sense command waits for the current command or watcher cycle to close it. The upstream engine supports more deployment and concurrency options than this adapter currently exposes. Sense opens a local file and does not configure sync, remote access, concurrent writers, or encryption.
 
 ## `sense search` grammar
 

package/skills/sense-setup/references/stores/duckdb.md

@@ -17,7 +17,7 @@ Sense's [store benchmark summary](../store-benchmarks.md) measures the current a
 ## Current Sense adapter boundaries
 
 - DuckDB support is experimental.
-- The first open installs `@duckdb/node-api`, with a native download of about 110 MB.
+- The first open installs the newest `@duckdb/node-api` in the range sensemaking's `peerDependencies` declares, a native download of about 110 MB. An already-installed version is used, and one outside that range is reported. A build after the version changes rebuilds the cache.
 - Under DuckDB's [concurrency model](https://duckdb.org/docs/current/connect/concurrency), Sense opens an existing cache for no-build observation in read-only mode, so several independent reader processes can coexist. A build-enabled command or watcher opens it read-write and excludes every other process until it closes. Contenders wait within Sense's bounded lock budget, then fail with `STORE_BUSY`. This cross-process rule does not promise writer/reader coexistence or unrestricted sharing by independently configured DuckDB instances in one process.
 - `sense search` accepts bare words and quoted phrases. It rejects FTS5 boolean, prefix, `NEAR`, initial-token, grouping, and column-filter syntax.
 - SQLite's raw `MATCH`, `snippet()`, and `bm25()` queries do not port.

package/skills/sense-setup/references/stores/sqlite.md

@@ -12,7 +12,7 @@ Choose it when the tree has no engine-specific requirement, when saved searches
 - The sense SQL functions `has()`, `basename()`, and `segment()`.
 - WAL-backed concurrent sense commands.
 
-The cache is `.sense/cache.db`. It is derived data and can be rebuilt from the markdown files.
+The cache is `.sense/cache.db`. It is derived data and can be rebuilt from the markdown files. It records the bundled SQLite version that built it, so a Node upgrade that changes that version rebuilds it on the next build.
 
 ## When another store fits the workflow