You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The framework now ships rolling-deploy-friendly migration tooling (#7 `writeVersion` + #8 master-key rotation + #9 wrap-legacy + #6 schema registry). These compose into a real operational pattern but the README only documents each piece in isolation.
Scope:
New file `docs/operations/rolling-migration.md`.
Walk through the canonical 4-phase deploy:
Code-first: ship the new code with both old + new schemas registered, but `writeVersion = old`. Old + new readers coexist; everyone writes the old shape.
Reader rollout: observation period. Verify all instances are running the new code.
Writer flip: redeploy with `writeVersion = new`. New writes use the new shape; existing data is upcast on read.
Cleanup: optional one-shot `migrateInMemoryJournal` (or backend-equivalent) to actively rewrite historical data; finally drop the old version's upcaster from the registry.
The framework now ships rolling-deploy-friendly migration tooling (#7 `writeVersion` + #8 master-key rotation + #9 wrap-legacy + #6 schema registry). These compose into a real operational pattern but the README only documents each piece in isolation.
Scope:
Estimate: 1 day (documentation + a small worked-example diagram).