From f32a37c2bb1e9bf6226d3125b5d3572ad8da6979 Mon Sep 17 00:00:00 2001 From: "glm-5.3-flash" Date: Sun, 11 Oct 2026 15:41:26 +0000 Subject: [PATCH] =?UTF-8?q?sqlite:=20opts=20+=20README=20doc=20accuracy=20?= =?UTF-8?q?=E2=80=94=20the=20config=20surface=20is=20the=20watcher=20caden?= =?UTF-8?q?ce=20+=20reader=20pool,=20durability=20settings=20are=20bootstr?= =?UTF-8?q?apped=20constants=20(aligning=20with=20review-004=20item=209's?= =?UTF-8?q?=20lib-header=20correction)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- alkstore-sqlite/README.md | 9 ++++----- alkstore-sqlite/src/opts.rs | 9 +++++---- 2 files changed, 9 insertions(+), 9 deletions(-) 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