v0.2.23

migrations/README.md

@@ -8,28 +8,31 @@ RustBox keeps one complete fresh-install schema per supported SQL backend:
 
 ## Compatibility baseline
 
-The consolidated compatibility baseline is **V050**. Historical migrations V047-V050 are already represented by the complete `schema.sql` files and are intentionally not shipped as standalone runtime migrations in this source tree.
+The consolidated compatibility baseline is **V052** (RustBox 0.2.23). Historical migrations up to and including V052 are already represented by the complete `schema.sql` files and are intentionally not shipped as standalone runtime migrations in this source tree:
 
-Databases older than V050 must first be upgraded with a RustBox release that can reach V050. RustBox 0.2.16 accepts V050 databases and migrates them forward normally.
+- V047-V050 — attachment/search-outbox changes, folder counter generation, blob deletion outbox, compact-row and signature preferences (consolidated in 0.2.16);
+- V051 — `display_preferences.adaptive_email_colors` (default `0`) and `mail_preferences.message_loading_mode` (default `pagination`);
+- V052 — the `snoozed_messages` table used by Snooze (local cache state only, no IMAP side effects, no foreign keys).
 
-## V051 — RustBox 0.2.16
+Databases older than V052 must first be upgraded with a RustBox release that can reach V052. RustBox 0.2.22 accepts V050 and V051 databases and migrates them to V052, so a tenant that has not logged in since an older release should be opened once with 0.2.22 before upgrading. Tenants below the baseline are refused with an explicit error instead of being partially migrated.
 
-V051 adds the preferences introduced in 0.2.16:
+The MySQL fresh schema now declares `mail_preferences.message_loading_mode` with an expression default (`DEFAULT ('pagination')`); MySQL rejects literal defaults on `TEXT` columns.
 
-- `display_preferences.adaptive_email_colors`, default `0` / disabled;
-- `mail_preferences.message_loading_mode`, default `pagination`.
+## V053 — RustBox 0.2.23
 
-`mail_preferences.messages_per_page` remains `300` by default. Supported message loading modes are `pagination`, `progressive` and `all`.
+V053 adds two appearance columns to `display_preferences`.
 
-Fresh installations already contain the V051 columns in `schema.sql` and are registered at the latest schema version. Existing V050 tenants execute `V051__adaptive_email_colors_and_message_loading_mode.sql` before application queries use the new columns.
+`skin_depth`, default `standard`, controls how far a predefined interface style may reshape the interface:
 
-## V052 — RustBox 0.2.22
+- `colors` — only the style's palette is applied; layout, shapes and typography come from your own appearance settings;
+- `standard` — palette plus the style's fixed layout preferences (the behavior of earlier releases);
+- `immersive` — additionally applies the style's structural design tokens: typography, control and avatar shapes, floating panes, app-bar treatment, selection markers and backdrop.
 
-V052 adds the `snoozed_messages` table used by the Snooze feature introduced in 0.2.22: a message can be hidden from its folder listing in the client until a chosen wake time, without being moved on the real IMAP server. The table is local cache state only (no IMAP side effects) and has no foreign keys, matching `message_tags`' existing exemption from forward-referencing foreign keys in the MySQL/PostgreSQL schemas.
+`skin_gradients`, default `0` / off, is a separate switch for every gradient a style uses (backdrops, app bars, buttons, Roundcube Classic bevels). When off, each style falls back to flat colors defined next to its gradient.
 
-Fresh installations already contain `snoozed_messages` in `schema.sql` and are registered at the latest schema version. Existing V051 tenants execute `V052__snooze.sql`.
+Fresh installations already contain both columns in `schema.sql` and are registered at the latest schema version. Existing V052 tenants execute `V053__skin_depth_and_gradients.sql`.
 
-The next migration number is **V053**.
+The next migration number is **V054**.
 
 ## Migration rules
 
@@ -39,3 +42,5 @@ Any future schema-changing release must:
 2. add the same logical numbered migration for SQLite, MySQL and PostgreSQL;
 3. register that migration in `src/db/pool.rs`;
 4. extend the offline migration tests in `scripts/validate-release-static.py`.
+
+On MySQL, `TEXT` columns must use expression defaults such as `DEFAULT ('value')`.