3.4 KiB
M11.4: Apply earned mutation choices through development
M11.4 connects the accepted M3 seeded candidate generator and immutable lineage archive to a living player organism. The game rule authority is ADR-0098; the first funded transition is ADR-0118. Candidate counts, event cadence, eligibility thresholds and resource targets remain trial values until informed by the 11.3 probe and later repeated-life tests. No class tree, candidate ranking or automatic wildlife mutation is introduced.
Boundaries
Read PROJECT_VISION, ENGINEERING_CONSTITUTION, GENOME_MODEL, ADR-0030 through ADR-0034, ADR-0098, ADR-0108 through ADR-0110 and the cellular checkpoint schema before changing the owner. Preserve the M3 pure generator's seed/context rules and genome v1/v2 compatibility. The headless biology library must not acquire transport, UI, database or Kubernetes dependencies. Every accepted choice must be one durable action whose outcome, successor genome, body transfer and life revision recover together.
The 11.3 hands-on probe is now executable in the engineering client. Its human notes remain the design input for tuning mutation timing and eligibility. The maintainer has explicitly authorized continuing M11 work while those notes are pending; no gameplay balance is treated as final by this plan.
Segments
| Segment | Affected modules | Acceptance evidence |
|---|---|---|
| 11.4a: funded transition proposal | Biology mutation/development public API and implementation; mutation tests; ADR-0118 | Deterministic selection revalidation; exact per-channel body/reserve closure; construction energy charge; insufficient-channel refusal with no partial result; NDEBUG tests |
| 11.4b: earned eligibility and offer identity | Cellular life state, tick intake accounting, offer context, profile-4 codec/schema | Offers require retained fed surplus; exact retry returns the same offer; changed genome/context/tick refuses stale selection; no free rerolls; checkpoint restore preserves eligibility and action identity |
| 11.4c: durable mutation publication | Cellular host/session, SQL migration/action parser, replay, crash tests | One action atomically publishes debit, genome successor, organism revision, archive and result; duplicate retry is exact; uncertain commit and process restart have one outcome |
| 11.4d: player choice and review | Engineering client trial UI, replication, playtest notes | Owner sees unranked candidates and actual tradeoffs; choice/refusal/recovery is readable; playtest verifies the choice follows useful feeding rather than appearing at spawn |
Required checks
- All current M3 mutation and archive tests remain unchanged and pass.
- Test equal inputs and retry after process restore, wrong/stale offers, unaffordable candidates in each individual channel, overflow, and exact body + reserve conservation.
- Exercise two candidates that trade construction, maintenance, movement, ingestion and membrane defense without rendering a ranked score.
- Profile-4 PostgreSQL publication, crash/restart and Linux CI evidence are required before claiming a live mutation path.
- Record the exploratory 11.3 probe feedback and revisit tuning before widening candidate options or setting an event cadence.
Progress
- 11.4a implementation is in progress:
fund_mutationreturns a detached, channel-conserving transition under ADR-0118. Session offers, eligibility, durable publication and UI remain open.