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

72 lines
4.0 KiB
Markdown

# 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](cellular-population-batch.md).
## Portable envelope 2
ADR-0144 adds magic `AEVOPOP2`, version 2, with the identical header/member layout
and a nested [owner format 7](cellular-lives-v7.md), 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](cellular-maturation-upgrade.md). Default entry is unchanged.