4.9 KiB
ADR-0165: Retained cellular offspring plans
Status and scope
Accepted for the portable stored-plan segment of ADR-0163/0164, 2026-10-19. No default/DEV upgrade, SQL admission, player succession or NPC behavior policy. This is an explicit offspring-plan editing mode, not a final classification of which future mutation operators may also be expressed during an existing life.
Decision
Add cellular owner format 8/rules 10 through a detached no-tick upgrade from format 7/rules 9. Preserve all biology, inventories, identities, offers, boundary flows and archive history. Initialize each living/corpse offspring plan to its currently expressed genome. Older formats retain zero in the new in-memory fields and omit them from their unchanged canonical bytes.
identity.genome and archive current_genome keep their expressed-body meaning.
The separate offspring_genome names the inherited developmental plan. Every
newborn starts with both references naming the actual inherited plan. Existing
body derivation, maintenance, movement, feeding, growth, damage, predation and
spatial exclusion always use the expressed genome. Corpses retain the last
offspring plan as history, with no reproductive viability granted to dead tissue.
In this opt-in editing mode, the existing earned mutation choice edits the
offspring plan. Draw from the current plan using the existing recorded context
and eligibility credit. Revalidate selections exactly; admit the successor genome
without adding an expressed-genome revision or constructing parent tissue.
Consume the offer once. Record (life,previous_plan,successor_plan,tick) in an
append-only log, bounded by the existing genome archive capacity. Operator zero
still declines. NPCs still earn no mutation offers. No extra mutation fee is
invented: physical construction is funded when an actual offspring is made.
The live-expression path for nonstructural traits requires a later operator
catalog/transaction contract; this mode supplies only offspring-plan selections.
Use ADR-0164 mixed-genome funding for buds and their exact twin eligibility. Retain existing phase order: surviving-parent plan selection precedes budding; newborns do not grow or bud in their birth tick. Thus a selected plan can affect that tick's offspring while the parent's expressed body remains unchanged. The child's birth archive record names its actual inherited genome. Later selections affect later offspring only. Wildlife reproduction uses the actual plan cost.
State and restore invariants
Format 8 extends the format-7 header by a u32 plan-history count and zero u32
reserved field (316 bytes total). Each living/corpse row appends one u64 plan
reference (512/132 bytes). After habitat, archive and nonresident IDs, append
32-byte history rows in increasing (tick,life) order, then the existing FNV
trailer. Preserve the 16 MiB owner bound and existing archive limits. The magic is
AEVCLV08; only rules 10 uses this format. No native-layout serialization.
Validate counts/size before allocation, all plan references, compatible schema/ development versions, and each complete per-life chain from its expressed genome. History successors have one genome parent matching the recorded previous plan and their recorded origin matches the selected successor identity. Require unique successors, live-at-selection timing, retained actor identity, and final references matching the log. Selections must follow any legacy expressed-body revision used as their initial plan. Regenerate outstanding offers from the retained current plan. Missing, conflicting, forged, over-bound or noncanonical state refuses atomically.
Alternatives, benefits, costs and risks
Overwriting the parent's expressed genome would rebuild it and misprice its body. Treating an unexpressed plan as an archive living carrier invents an organism. Keeping only a final reference loses which parent selected earlier sibling plans. The distinct reference/log preserves body and ancestry meanings at bounded cost.
A plan without expressed carriers may still be reproductively available in a living parent. Existing census, migration, population and persistence allowlists must refuse this new owner until they have complete plan/viability semantics and versioned replay; absence of expressed carriers cannot prove its extinction. No old snapshot or golden is rewritten. This portable checkpoint is not durable publication authority, and no existing SQL bundle admits it.
Qualification
Require real earned plan selections, unchanged parent anatomy/biological charges, different funded sibling plans, later choices leaving earlier children unchanged, exact save/restore and separate-process continuation, death/history retention, offline exclusion, all-channel closure, unsupported old paths and forged codecs. Run Release/NDEBUG, analysis, formatting and relevant ASan/UBSan checks. Retained plans do not implement the birth-time control choice, persistent NPC behavior, new limb/plant traits, UI, environmental producers or M12 completion.