Files
aevolution/schemas/cellular-population.md
T
dingo 463b091056
Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (ecs) (push) Successful in 2m24s
Foundation / checks (network) (push) Successful in 20m40s
Foundation / checks (client) (push) Successful in 21m57s
Foundation / checks (tsan) (push) Successful in 26m32s
Foundation / checks (postgres) (push) Successful in 1h3m17s
Foundation / checks (checks) (push) Successful in 1h14m29s
Foundation / postgres-tools (push) Successful in 34s
Foundation / server-image (push) Successful in 4m6s
Foundation / image (push) Successful in 4m52s
feat(persistence): admit durable funded maturation upgrades
2026-10-19 06:23:51 -04:00

4.0 KiB

Exact cellular population envelope 1

Authority: ADR-0139/0140/0142. Little-endian integers, no padding. Size is bounded by max_cellular_population_bytes. No changes to existing cellular owner envelopes.

Offset Bytes Field
0 8 Magic AEVOPOP1
8 4 Version 1
12 4 Automatic policy flag, exactly 0 or 1
16 4 Materialization radius, micrometres, positive
20 4 Collapse radius, strictly larger, at most 1,000,000 micrometres
24 8 Conversion sequence
32 8 World
40 8 Region
48 8 Frame
56 8 Completed tick
64 8 Nested biological payload bytes
72 8 Cohort member count, at most 256
80 16 each Sorted unique member life ID and exact genome ID
after members declared length Complete canonical rules-8 CellularLives snapshot
final 8 FNV-1a64 over all preceding bytes

Require exact total length, matching trusted identity/tick, valid policy, canonical nested restoration and complete byte-identical re-encoding. Every tagged member must exist, have zero account, active presence and exactly the recorded genome. The membership table contains no additional inventory. Untagged living cells are individuals. New offspring may be individual until the next applicable group conversion. No random seed or residual is missing: the representation is exact.

The checksum detects corruption, not malicious alteration. Production object publication must also bind SHA-256, predecessor, current fence and immutable manifest. Migration 44 admits this envelope as checkpoint profile 5, nested cellular bundle 9 and history profile 5. It must never be labeled as the existing raw cellular profile-4 payload. Entry wraps identical rules-8 biology with empty membership and sequence zero; reverse entry unwraps the identical biology. Conversion sequence is local to each profile-5 generation. The immutable region commit sequence and transition evidence distinguish generations and never reset. See population batch format 1.

Portable envelope 2

ADR-0144 adds magic AEVOPOP2, version 2, with the identical header/member layout and a nested owner format 7, rules 8. Envelope 1 requires owner format 6; magic, envelope version and nested tuple must agree. Explicit no-tick upgrade retains every membership tag, conversion sequence and policy. Paired population migration moves the exact existing tags with their cells, retaining each region's policy and conversion sequence; it performs no collapse, materialization or new automatic-policy evaluation. Untagged members stay untagged.

Envelope 2 is portable only in this segment. Existing durable trace 1 refuses it; schema 45/profile 5 does not admit the new nested owner tuple. No live flag or default entry enables migration or this new representation.

M12.4g/ADR-0146 subsequently admits envelope 2 as profile 5 with bundle 10 and history 5 in schema 46. An explicit no-tick version upgrade retains membership, policy and conversion sequence through the immutable version-upgrade journal. Ordinary publication requires population batch 2; profile transitions preserve bundle 10. No worker upgrades automatically and no paired migration is published.

ADR-0157 additionally permits portable envelope 2 to contain owner 7/rules 9. The nested owner identifies the changed growth semantics; no membership, policy, sequence or wire-layout change is needed. An explicit no-tick maturation candidate preserves all tags and upgrades only the nested rules. Both representations use the same funded-growth kernel. Envelope 1 remains rules 8. Durable bundle 10 remains rules 8 and does not admit this portable maturation upgrade.

ADR-0158/schema 53 subsequently admits nested rules 9 as bundle 11. Entry requires the retained bundle-10 same-profile upgrade; ordinary intervals use batch 2 and profile transitions preserve the exact tuple. See durable maturation. Default entry is unchanged.