Files
aevolution/schemas/cellular-maturation-upgrade.md
T
dingo d3a867a662
Foundation / checks (ecs) (push) Successful in 2m20s
Foundation / checks (deploy) (push) Successful in 4m7s
Foundation / checks (network) (push) Successful in 21m2s
Foundation / checks (client) (push) Successful in 22m21s
Foundation / checks (tsan) (push) Successful in 28m57s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 38m8s
Foundation / checks (checks) (push) Canceled after 38m19s
feat(persistence): admit durable maturing wildlife migrations
2026-10-19 11:57:00 -04:00

3.1 KiB

Durable cellular maturation upgrade

Authority: ADR-0158/schema 53. Bundle 11 is exactly {rules=9,envelope=7,habitat=2,coordinate=1,genome=1,development=4,founder=3,archive=2,mutation_state=1}. Raw profile 4 retains history 4/trace 3. Population profile 5 retains history 5, envelope 2/batch 2. No wire field or payload limit changes.

Only bundle 10 -> 11 may enter these rules. Require an existing non-genesis, same-profile predecessor, current lease/frame/head/digest, nonzero retained tick, new commit/next sequence, unchanged tick and empty batch evidence. The sole biological change at that boundary is the explicit rules selector. Derive the entire raw or nested population candidate from its verified retained object; preserve all identities, stocks, flows, history, presence and cohort state. Store and verify the candidate before invoking fenced publication.

The existing immutable cellular_profile_migrations journal binds both complete manifest/payload digests, sequences, commits and exact version tuples. Evidence, result and head move share one transaction. An admitted interval or biological handoff blocks new work. Ordinary publication and profile transitions cannot change the tuple; profile transitions only wrap/unwrap identical biology. Skipped prerequisites, repeats under new identities, downgrades and new genesis are refused. Exact retries under their current writer's lease retain the original request and receipt. A stale writer remains fenced; replacement recovery uses its new authority to verify the original committed evidence.

Recovery distinguishes version upgrades from representation changes and paired biological handoffs by their retained evidence. For a maturation journal entry, reconstruct the recorded bundle-10 -> 11 operation, verify both manifests and objects, and compare the full derived target bytes. Equivalent total stock alone is insufficient. Missing/corrupt/false evidence fails without older-head fallback.

SQL checks may normalize parser-local version tuples to reuse unchanged trace shape validation. Population trace 2 must first retain its actual length/SHA-256 binding. Stored manifests, traces, digests and retry bytes remain exact bundle 11. Old helper functions are private, and the effective runtime privilege audit still allows only the existing fenced entry points. Earlier migration bytes are intact.

No live/default auto-upgrade or new provisioning mode. An explicitly upgraded owner can recover and continue raw/cohort biology, including interval admission, settlement and materialization before returning-player operations. Biological ADR-0160 qualifies portable equal-rules-9 candidates/trace 2. ADR-0161/schema 54 admits bundle-11/trace-2 durable migration through the existing fenced workflow, without mixed-bundle migration or any automatic upgrade. ADR-0159 admits rules-9 retained body/reserve to census projection 1 and the verified history/registered snapshot readers. Mixed rule cuts or unavailable evidence prevent a complete result and cannot prove zero life or terminal extinction. Ecology/environment/actual-days/product qualification remains separate.