docs: correct rc-era time-travel staleness + record the embedding-model ordering constraint
- data-storage-architecture.md described transact() as 'the unit of history' (rc.2 era). Single-op retention has been the model since 8.0 — every write gets its own generation; transact() only groups several into one. Corrected. - RELEASE-GUIDE.md now records the hard ordering constraint: no embedding-model change ships before vector model-version stamping + hard-error-on-mismatch lands.
This commit is contained in:
parent
61c247c923
commit
68da66024c
2 changed files with 14 additions and 2 deletions
|
|
@ -119,4 +119,13 @@ gh release create vY.Y.Y --generate-notes
|
|||
- **Most releases should be MINOR or PATCH**
|
||||
- **Major versions should be RARE**
|
||||
- **When in doubt, it's probably MINOR**
|
||||
- **NEVER use "BREAKING CHANGE" for internal changes**
|
||||
- **NEVER use "BREAKING CHANGE" for internal changes**
|
||||
## Hard Ordering Constraints (check before EVERY release)
|
||||
|
||||
- **Embedding model changes are SEQUENCED, not free.** No release may change the
|
||||
embedding model (or its quantization/dimensions) before **vector model-version
|
||||
stamping + hard-error-on-mismatch** ships. Stored vectors carry no model version
|
||||
today; mixing vectors from two models silently corrupts every similarity
|
||||
comparison. If a model bump is ever proposed, the stamping work moves ahead of
|
||||
it in the schedule — coordinate with the native provider so both engines stamp
|
||||
and enforce identically. (Registered with the native-provider team 2026-07-07.)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue