Files
aevolution/docs/adr/0157-funded-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

4.2 KiB

ADR-0157: Opt-in funded cellular maturation

Status

Accepted for the portable M12 ecology prerequisite, 2026-10-18. Extends ADR-0031/0032/0120/0125/0128/0137/0139/0144. Trial parameters remain revisable; this does not accept gameplay balance, durable admission or product readiness.

Decision

Rules 9 explicitly opt an existing rules-8, format-7 owner into maturation. The detached no-tick upgrade preserves every organism, archive, inventory, presence, boundary flow and cohort tag. Only the biology rules field changes. Format 7 already stores growth and all affected inventories. Population envelope 2 and recorded input formats need no new fields. Older readers reject rules 9; rules 8 and its goldens retain their meaning. No default/DEV or SQL bundle changes.

After old-size movement, maintenance, contact feeding, engulfment/death, selected mutation, budding and presence changes, surviving active cells can construct at most 5 realized thousandths per 50,000 microsecond tick (100 per second). This is an experimental rate, distinct from the development version's per-plan bound. A newborn takes no growth step in its birth tick; frozen, lingering and suspended cells do not grow. A resuming suspended cell starts growth on its next active tick. Wildlife and controlled cells use the same construction rule. A juvenile reaching adulthood can first request an admitted bud next tick.

Use the existing channelwise affordable construction transition, additionally capped by that rate. Pay its gross intake from retained reserve; release body rounding matter back to reserve and send construction energy to world heat. Recompute the resulting body from unchanged genome and new growth. Preserve damage exactly: construction is not repair. There is no new resource source, reserve grant, automatic mutation or sampled replacement organism. Checked arithmetic and full owner closure precede publication; failure changes no state.

Expanded squares retain their lower corner and expand toward positive axes. In ascending stable life-ID order, require the whole proposed extent inside the region and separated from every other present life, including lingering cells and newborns. Suspended lives occupy no space. Earlier admitted expansions block later ones. Refuse the proposed expansion without spending, relocation or trying a smaller spatial step when blocked. This simple directional/contention bias is explicit trial behavior, not a claim of physical growth geometry.

Mutation offers remain the original deterministic draw with their recorded context and displayed budget forecast. Selection validates that exact offer; rules 9 then prices the selected successor at current growth, using retained reserve. It neither redraws the candidate nor restores an obsolete juvenile body. The old pure funding API retains recorded-growth behavior; an explicit new API supports current-growth funding. Insufficient funds retain the offer as before.

Successful growth reports the exact before/after growth and intake/release. Final tick feedback reports the surviving cell's final reserve under rules 9. Both representations and recorded unattended intervals execute the same kernel.

Qualification and limits

Require channel and energy starvation, partial affordability, rounding and damage checks; real funded founder -> juvenile -> adult -> offspring evidence; newborn and offline exclusion; obstructed expansion with no spending; saved-choice funding at changed growth; raw/cohort equivalence, conversion and midpoint restore/replay. Tests must preserve old goldens and run under NDEBUG, ASan/UBSan and analysis.

Rules-9 durable checkpoint admission, migration, registered census, environmental coupling and client presentation require their own contract/qualification. Current durable bundle allowlists continue to reject this rule. No actual-days soak, deployment, World0 operation, extinction or M12 completion is inferred.

ADR-0158/schema 53 subsequently admits explicit durable bundle-10 -> 11 upgrades. The maturation rule above is unchanged; migration/census and ecological/product qualification remain separate gates.

ADR-0159 subsequently qualifies rules-9 census through retained history and registered snapshots. Migration and ecological/product qualification remain open.