storage-uses-wal-mode
IN premise
SQLite connections enable WAL mode on initialization, allowing concurrent readers without blocking writes.
Summary
WAL mode means multiple processes or threads can read the database at the same time without getting blocked by a write in progress. This is important for the wiki build system because it allows concurrent read operations during page generation while summaries or other data are still being written.
Dependents
These beliefs depend on this one:
- storage-optimizes-concurrent-access-and-search — The storage layer optimizes for both concurrent access (WAL mode enables non-blocking reads during writes) and full-text search (derived FTS5 index rebuilt from scratch on every save guarantees consistency), making the persistence layer production-ready for multi-reader workloads with search capability.
Details
| Source | entries/2026/04/24/reasons_lib-storage.md |