v0.2.8

migrations/README.md

@@ -1,6 +1,6 @@
 # Database schemas and migrations
 
-RustBox 0.2.6 keeps SQL, blob storage and search as independent concerns:
+RustBox 0.2.8 keeps SQL, blob storage and search as independent concerns:
 
 ```text
 database_backend = sqlite | mysql | pgsql
@@ -17,16 +17,19 @@ When `session_backend = "database"`, sessions live in the selected SQL database.
 migrations/
 ├── sqlite/
 │   ├── schema.sql
-│   └── V047__blob_keys_and_search_outbox.sql
+│   ├── V047__blob_keys_and_search_outbox.sql
+│   └── V048__folder_counter_generation.sql
 ├── mysql/
 │   ├── schema.sql
-│   └── V047__blob_keys_and_search_outbox.sql
+│   ├── V047__blob_keys_and_search_outbox.sql
+│   └── V048__folder_counter_generation.sql
 └── pgsql/
     ├── schema.sql
-    └── V047__blob_keys_and_search_outbox.sql
+    ├── V047__blob_keys_and_search_outbox.sql
+    └── V048__folder_counter_generation.sql
 ```
 
-Each `schema.sql` is the current complete schema for fresh installations. The historical compatibility baseline remains **V046**. RustBox 0.2.1 adds **V047**, which adds attachment SHA-256 metadata and the durable search outbox used by external indexing.
+Each `schema.sql` is the current complete schema for fresh installations. The historical compatibility baseline remains **V046**. RustBox 0.2.1 adds **V047**, which adds attachment SHA-256 metadata and the durable search outbox used by external indexing. RustBox 0.2.8 adds **V048**, which adds the monotonic `folders.counter_generation` used to reject stale IMAP counter writes even when the numeric counts temporarily return to an earlier value.
 
 Account data is isolated inside the selected physical database with a deterministic, collision-checked table prefix derived from the account hash. The `{{p}}` marker in tenant SQL is replaced by RustBox at provisioning/migration time. Sessions are global and therefore are not prefixed.
 
@@ -34,7 +37,7 @@ Account data is isolated inside the selected physical database with a determinis
 
 Every schema-changing release must add the same logical migration for all supported SQL engines and register it in `src/db/pool.rs`. Do not update only `schema.sql`: fresh installs use the baseline while existing installations use the numbered migration path.
 
-The next migration number after RustBox 0.2.6 is **V048**.
+The next migration number after RustBox 0.2.8 is **V049**.
 
 Redis and Redis Sentinel do not use SQL migrations.