Caching: PersistedSchemaId and MarkWritten are internal for 2.0; Mesh single-file write guard in the CHANGELOG
C2a's StoredVersion owns the same identity and deletes both. No consumer outside CultLib uses them, so they do not ship public in 2.0.0 and C2a's release is not a major. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
7678148c1a
commit
8b47a2e8d9
4 changed files with 13 additions and 17 deletions
|
|
@ -76,20 +76,14 @@ All notable changes to this package are documented in this file.
|
|||
reading it. A store with no variant stays `cultcache.store.v1`, byte-identical to
|
||||
1.0.x. CultMesh single-file reads, the directory store and CultNet refuse a variant
|
||||
record by name; only the C# CultCache resolves variants.
|
||||
- `CultMesh.WriteSingleFileDocument` and `WriteSingleFileDocumentPayload` read the
|
||||
file they replace, under the store's `<path>.lock`, and refuse (without touching
|
||||
it) a file this runtime cannot read, a store stamped with a newer format version,
|
||||
or one holding any record besides the key being written. They used to replace the
|
||||
file whole. Write to a store that holds several records through a `CultCache`.
|
||||
|
||||
### Added
|
||||
|
||||
- `CultStoredDocument.PersistedSchemaId`: the schema id a record is durably
|
||||
stored under, as its backing store last read or wrote it. It differs from
|
||||
`Descriptor.SchemaId` only for a record loaded under compatible schema drift
|
||||
that its store has not rewritten since.
|
||||
- `CacheBackingStore.MarkWritten(CultStoredDocument)` (protected instance
|
||||
method): a backing store records that its completed durable write stored a
|
||||
record under its descriptor, so `PersistedSchemaId` follows the rewrite. It
|
||||
throws `ArgumentException` for an entry that is not the one the store holds
|
||||
in its own `Entries`. The single-file and directory stores mark every record
|
||||
they rewrite; a custom store calls it for each record its own write rewrote.
|
||||
|
||||
- Variants: a record that stores only its difference from a base record, resolved in
|
||||
memory when the cache admits it (`cultcache.store.v2`; see the persistence-format
|
||||
contract). A plain write at a variant's key is refused, and `Flatten` replaces a
|
||||
|
|
|
|||
Loading…
Reference in a new issue