imccyu fcd109d29a feat(storage): version read compatibility and backup-and-skip salvage for per-record units ...

A DomainSpec may declare compatibleVersions: older domain versions whose
stored records the current record schemas still accept. The json backend's
per-record reads admit documents stamped with a declared version (writes
always stamp the current one), and the legacy whole-unit bootstrap migrates
only a file whose stored version is in the accepted set — previously it
migrated any version and stamped the records current, turning a discardable
stale cache into invalid-record failures that refused the whole domain at
open and permanently poisoned the new tree on first boot.

A DomainSpec may also declare invalidRecords: 'backup-and-skip' for domains
whose records are disposable derived data: a stored record failing its zod
schema is moved aside through the new optional KvUnit.backupRecord
(<key>.json.bak.<YYYYMMDDHHmm> under the json backend), logged with its
cause, and skipped, instead of rejecting the open. The default stays
fail-loud, and so do backends without backupRecord.

2026-09-02 15:25:07 +08:00

..

helpers

docs: reserve seam for complete capabilities

2026-08-09 17:26:57 +08:00

domain.spec.ts

feat(storage): version read compatibility and backup-and-skip salvage for per-record units

2026-09-02 15:25:07 +08:00

invariant.spec.ts

refactor: apply repository naming contract

2026-08-13 00:54:38 +08:00