Files
aevolution/schemas/cellular-lives-v3.md
dingo d9bf60138e
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (checks) (push) Failing after 2m9s
Foundation / checks (ecs) (push) Successful in 2m2s
Foundation / checks (tsan) (push) Canceled after 0s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (client) (push) Canceled after 3m11s
Foundation / checks (postgres) (push) Canceled after 1m3s
Foundation / checks (network) (push) Canceled after 1m9s
Add cellular mutation replay trace v3
2026-10-11 06:29:17 -04:00

1.7 KiB

Cellular lives checkpoint v3

Authority: ADR-0122. Cellular profile 4 v3 adds append-only genome revisions while retaining the v2 life records and mutation-offer state. Cellular-v1 and v2 checkpoints remain readable with their original version bundles.

The envelope magic is ASCII AEVCLV03, format is 3, and cellular rules remain 2. Its manifest bundle is (2,3,1,1,1,2,1,2,1): rules, envelope, habitat, coordinate, genome, development, founder, archive and mutation state. The tick quantum remains 50,000 μs and the payload cap remains 16 MiB. The header, spawn sites, life records and corpse records keep the v2 layout. The nested lineage archive uses format 2 as specified in lineage-archive-v2.

For a living life, identity.genome is the current genome reached by replaying that organism's revision chain; the archived birth record remains immutable. For a corpse, closure derives the genome at its death tick from the same chain. Restore replays and validates the archive before checking the life, corpse, habitat and inventory closure.

The only v2-to-v3 conversion is a leased, no-tick profile migration. It upgrades each format-1 archive to format 2 with an empty revision list and preserves the tick, lives, outstanding offers, corpses, habitat and conserved inventory. SQL records the source and target as one immutable migration link. Ordinary v3 successors retain the exact v3 bundle; a mutation is published with an advancing v3 tick.

The advancing v3 batch trace is specified in cellular-region-batch-v3. Its mutation selection records are decoded and replayed by the lifecycle layer; durable action reservation and checkpoint publication are not yet enabled.