Files
aevolution/docs/adr/0180-dev-starting-wildlife.md
T
dingo ff121c3ed1
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 4s
Foundation / checks (network) (push) Successful in 5s
Foundation / checks (tsan) (push) Successful in 4s
Foundation / checks (deploy) (push) Successful in 4m27s
Foundation / postgres-tools (push) Successful in 30s
Foundation / server-image (push) Successful in 4m16s
Foundation / image (push) Successful in 4m54s
feat(cellular): seed dev wildlife and tune budding playtests
2026-10-26 12:01:57 -04:00

2.7 KiB
Raw Blame History

ADR-0180: Opt-in starting wildlife for disposable playtests

Accepted scoped experiment, 2026-10-26, requested by the maintainer in chat.

The vision requires player-origin lineages. Random founding wildlife conflicts with that rule. Resolve this only for explicitly opted-in disposable DEV openings; this does not change the product rule or authorize a World0 operation.

The optional revamp tuning key playtest.starting_wildlife_cells defaults to zero and accepts 0–255, below the region's organism cap. Provisioning a nonzero count also requires --playtest-wildlife-first-id, an operator-audited unused identity range below --life-allocator-start. As with ADR-0123, the operator owns the world-wide identity audit. Never use this range in another region or restored branch of the same world. The DEV example reserves 900000003584–900000003615 for region 14.

Seeding is an explicit input to the bundle 14 -> 15 opening upgrade. It requires an empty region at tick 1, spends nursery resources including construction heat, and fails atomically on inadequate funding or placement. Roots are unowned test organisms, with no fabricated player ancestry. Each begins fully grown, undamaged, with zero spare matter and 30 seconds of full demand as energy, using the same founder provisioning formula as players. Genome variation uses seeded, bounded reference indices around the founder, with no acquired modules or free mutations.

The existing format-11 archive and organism records store the entire result. Recovery first tries the historical upgrade, then, only for an empty tick-1 source, reconstructs the fixture from the target's count and first identity and requires byte equality. No per-tick rule, checkpoint encoding, wire version or golden changes. Older readers can decode these checkpoints but cannot qualify this new opening operation; retain the writing build. Existing non-fixture upgrades retain their exact meaning. Restart and repeated provision never replenish wildlife.

Alternatives: silently seed product worlds (violates the vision); inject on every worker start (duplicates stock and breaks history); add a general administrator spawn protocol (unnecessary scope). Costs: an explicit exception to the no-biology upgrade convention, extra replay qualification, and finite nursery consumption. This is fixture coverage, not ecological balance or production qualification.

The Bud HUD consumes the server's current offspring-plan cost plus the configured fee. Internal-cell litter displays a conservative maximum because its random draw occurs at action time. No new simulation or wire version is needed for correcting this derived presentation. Growth and fee changes remain new-region trial inputs.