diff options
Diffstat (limited to 'src/storage/README.md')
| -rw-r--r-- | src/storage/README.md | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/src/storage/README.md b/src/storage/README.md index ceb8965..3c03dba 100644 --- a/src/storage/README.md +++ b/src/storage/README.md @@ -1,6 +1,9 @@ # Storage layer -This directory is reserved for persistence adapters. The storage engine and its -schema are intentionally undecided; SQLite or another dependency will be added -to `vcpkg.json` only after the storage contract is designed. +The storage adapter owns `active.log`, `snapshot.bin`, the data-directory lock, +in-memory live/deleted state, synchronous PUT/DEL writes, startup replay, and +compaction. It uses Win32 64-bit file APIs and `FlushFileBuffers`. +The binary format is private but versioned. Invalid complete records are never +skipped; only an incomplete EOF record is truncated. Snapshot generation must +match the active log before snapshot state is trusted. |