diff --git a/alkstore-sqlite/README.md b/alkstore-sqlite/README.md index f9663a7..9b44f0c 100644 --- a/alkstore-sqlite/README.md +++ b/alkstore-sqlite/README.md @@ -10,11 +10,10 @@ let store = alkstore_sqlite::open("store.db", alkstore_sqlite::SqliteOpts::defau **Engine posture — single-host, file-backed.** Cross-process on one host is verified territory; a `.db` on network storage (NFS -two-writers) is not a supportable deployment posture. Durability -knobs, pool sizing, and the watcher cadence are engine-configuration -concerns on `SqliteOpts` — `synchronous = NORMAL` is hardwired at -connection bootstrap; there is no consumer surface to raise the sync -level. +two-writers) is not a supportable deployment posture. `SqliteOpts` +carries the watcher cadence and the reader-pool size; +`synchronous = NORMAL` is hardwired at connection bootstrap — there +is no consumer surface to raise the sync level. See the [family README](https://git.alk.dev/alkdev/alkstore/blob/main/README.md) for the interface and the deployment matrix, and the diff --git a/alkstore-sqlite/src/opts.rs b/alkstore-sqlite/src/opts.rs index c1e98f7..aaaa841 100644 --- a/alkstore-sqlite/src/opts.rs +++ b/alkstore-sqlite/src/opts.rs @@ -19,10 +19,11 @@ pub const DEFAULT_MAX_READERS: usize = 8; /// Construction options for the SQLite engine's /// [`open`](crate::open) constructor. /// -/// Durability knobs, pool sizing, and the watcher cadence are -/// engine-configuration concerns — they never appear on the contract -/// surface (ADR-008 §6); deployment.md carries the documented tuning -/// facts. +/// The engine's configuration surface (the watcher cadence and the +/// reader-pool size) — the durability settings (`synchronous = NORMAL`, +/// the busy timeout) are bootstrapped constants, not knobs, per +/// deployment.md's posture (ADR-008 §6); they never appear on the +/// contract surface. #[derive(Debug, Clone)] pub struct SqliteOpts { /// The watcher's `PRAGMA data_version` poll cadence. `None` = the