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

42 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.