Files
aevolution/docs/adr/0158-durable-cellular-maturation.md
T
dingo 274f62cb89
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m29s
Foundation / checks (network) (push) Successful in 20m54s
Foundation / checks (client) (push) Successful in 22m0s
Foundation / checks (tsan) (push) Successful in 27m5s
Foundation / checks (postgres) (push) Successful in 1h4m20s
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 1h12m23s
feat(lifecycle): qualify census of funded maturing owners
2026-10-19 07:56:58 -04:00

3.2 KiB

ADR-0158: Durable admission of funded cellular maturation

Status

Accepted for the scoped M12 maturation durability gate, 2026-10-19. Extends ADR-0146/0157. No deployment, automatic upgrade, balance acceptance or World0 change.

Decision

Admit cellular bundle 11 {9,7,2,1,1,4,3,2,1} through schema 53. Reuse the immutable cellular_profile_migrations journal and current lease/head fence. Only explicit bundle 10 -> 11, same-profile (4 or 5), same-tick upgrades are allowed. Preserve all stocks, organisms, genomes, growth, presence, boundary flows, archive, policy, cohort membership and conversion sequence. No new genesis, skipped prerequisite, downgrade or independently published upgrade record.

The adapter verifies both predecessor bindings, derives and reads back the full candidate object, then atomically records evidence/result/head. Pending intervals and biological handoffs prevent a new upgrade. Exact retries retain original bytes/receipt under current authority; changed bytes conflict. An uncertain transaction retains the exact prepared request. Recovery verifies both complete manifests/objects and the journal and rederives the recorded operation, selected from the exact source/target tuple. No fallback to older biology or fresh genesis.

Both raw trace 3 and population envelope/batch 2 keep their existing layouts. The bound predecessor's rules select funded maturation. Representation changes preserve the tuple. Parser-local SQL normalization can reuse the existing shape checks, after checking real trace binding; stored bytes, strong digests and retry identity always retain bundle 11. Legacy parser/publisher helpers remain private.

Keep all original version meanings and migration checksums. Existing freeze, interval, player-choice, permanent-death and dedicated-publication guards remain. No worker upgrades automatically, and DEV/default provisioning stays rules 8. An explicitly upgraded host can recover and continue either representation. Biological migration still accepts bundle 10 only. Rules-9 census queries return unsupported until separately qualified; a missing projection is never zero life or evidence of extinction.

Alternatives and qualification

A fresh opening loses funded ancestry and stock history. Reusing profile-change evidence obscures a biological-rules change. A separate journal duplicates the existing atomic authority. Extend its exact pair and replay dispatch instead.

Require both profiles, real juvenile growth after upgrade, exact continuation and profile conversion, stale/current leases, retries/conflicts, pending-work refusal, ambiguous outcomes/process loss, missing/corrupt/false source or result objects, rollback, retained history and runtime privilege audits on private PostgreSQL. Run portable Release, sanitizers, analysis and the full persistence/backup/DR matrix. This qualifies the retained biological rule and its storage path, not autonomous multi-generation ecology, linked environmental budgets, actual days, deployment-host costs, product readiness or M12 completion.

ADR-0159 subsequently qualifies rules-9 census projection 1 through verified history and registered snapshots, preserving the maturation rule and storage contracts above. Mixed rules 8/9 still refuse a complete regional set.