Files
aevolution/schemas/cellular-lives-v8.md
dingo 39509ecd40
Foundation / checks (ecs) (push) Successful in 2m51s
Foundation / checks (deploy) (push) Successful in 5m18s
Foundation / checks (network) (push) Successful in 25m49s
Foundation / checks (client) (push) Successful in 26m34s
Foundation / checks (tsan) (push) Successful in 37m12s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (checks) (push) Canceled after 47m59s
Foundation / checks (postgres) (push) Canceled after 47m53s
feat(persistence): define retained-plan checkpoint upgrade candidates
2026-10-19 14:17:41 -04:00

3.2 KiB

Cellular owner format 8: retained offspring plans

Authority: ADR-0165. Portable opt-in format 8/rules 10 only. Raw trace 4 supplies portable replay; bundle 12 supplies the portable raw checkpoint tuple and retained-source upgrade. No existing SQL admission, population envelope, migration or census adapter admits this version. Earlier canonical formats and their meanings are unchanged.

Little-endian, no native padding. Magic AEVCLV08. The first 308 bytes retain format 7, except magic/format/rules. Extensions:

Offset Bytes Field
308 4 Offspring-plan revision count, at most 4096
312 4 Reserved zero
316 8 each Sorted spawn sites
after sites 512 each Existing 504-byte living record, then u64 offspring genome
after lives 132 each Existing 124-byte corpse record, then u64 offspring genome
after corpses declared lengths Complete canonical habitat and lineage archive
after archive 8 each Sorted unique nonresident organism IDs
after nonresidents 32 each Offspring-plan revisions
final 8 FNV-1a64 of all preceding bytes

Each plan revision contains four u64s: life ID, previous genome ID, successor genome ID and selection tick. Records increase by (tick, life), strictly within each tick. Successor IDs are unique. The exact length is 316 + 8*sites + 512*lives + 132*corpses + habitat_bytes + archive_bytes + 8*nonresidents + 32*plan_revisions + 8, at most 16 MiB. Check counts, lengths, reserved fields and checksum before nested allocation/restore. The checksum detects corruption; it supplies no publication authority.

Living identity genome and archive current genome describe expressed anatomy. Every local living/corpse plan reference is nonzero and resolves in the archive. Initialize its chain from the expressed genome. Each selection must name that life's preceding plan and a direct single-parent successor whose origin event is its own ID, with matching genome schema/development versions. Selections follow birth and any legacy expressed revision, precede death and cannot be in the future. Only existing controlled founders select plans in this version. A successor cannot have an earlier recorded local birth. Final references must match complete retained chains. Outstanding offers regenerate from the current plan and their original context. All existing identity, presence, tissue, inventory, boundary-flow and archive invariants still apply, followed by exact canonical re-encoding.

The detached no-tick format-7/rules-9 upgrade preserves all old state and gives each local living/corpse record its current expressed genome as its initial offspring plan. No prior selections are invented. Newborns express the plan actually funded at birth and initialize their own plan to that genome. Corpses retain plans as history, without reproductive viability. Unexpressed plans own no stock and are not archive living carriers; a living parent can nevertheless retain one for future reproduction. Terminal extinction needs broader viability semantics before census/persistence integration.