CultCache: a mark is explained only up to the highest slot the catalog comparison reports

Explained required only that some slot was reported, so a depth-0 slot the comparison never
reported was consented to and dropped on write (finding unreported-slot-over-consent).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Libby 2026-11-12 00:31:01 +00:00
commit 74f1db64af
2 changed files with 9 additions and 5 deletions

View file

@ -4034,8 +4034,11 @@ namespace GameCult.Caching
for (var cause = exception; cause != null; cause = cause.InnerException) causes.Add(cause.Message);
throw new InvalidDataException($"Record '{record.Key}' (schema '{record.SchemaId}') cannot be decoded: {string.Join(" <- ", causes.Distinct())}", exception);
}
// Explained only when every mark is at depth 0 and the schema comparison reported ignored slots under this id.
unread = decoded.UnreadSlots?.Explaining(decoded.UnreadSlots.AllAtDepthZero && report.IgnoredExtraSlots.Length > 0);
// Explained only when every mark is at depth 0 and the schema comparison under this id reported every slot the mark carries
// past the reader: consent reaches no slot above the highest reported (none when nothing was reported).
unread = decoded.UnreadSlots is { } marked
? marked.Explaining(marked.AllAtDepthZero && marked.SlotCount <= report.IgnoredExtraSlots.DefaultIfEmpty(-1).Max() + 1)
: null;
return new CultStoredDocument(
new CultRecordKey(record.Key),
record.StoredAt,

View file

@ -31,9 +31,10 @@ namespace GameCult.Caching
public int Occurrences { get; }
/// <summary>
/// True only when every mark is at depth 0 and the schema comparison reported ignored slots under the id the record was stored
/// under: the loss a compatible-id declaration consents to (cultlib-gaps:ruling:slot-mark-consent). Any other mark leaves the
/// record read-only whatever is declared.
/// True only when every mark is at depth 0 and the schema comparison under the id the record was stored under reported every
/// slot the mark carries past the reader (<see cref="SlotCount"/> is at most the highest reported slot plus one): the loss a
/// compatible-id declaration consents to (cultlib-gaps:ruling:slot-mark-consent). Any other mark leaves the record read-only
/// whatever is declared.
/// </summary>
public bool Explained { get; }