5.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 v2 codec/schema | One offer per 60 seconds of retained fed energy (trial), requesting up to three unranked candidates; exact retry returns the same offer; mismatched offer identity or changed genome/context refuses stale selection; ordinary ticks do not expire an offer; no free rerolls; restore preserves eligibility and offer 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 complete:
fund_mutationreturns a detached, channel-conserving transition under ADR-0118. CI run 275 passed all 10 jobs on the current branch, including the configured checks and PostgreSQL jobs. - The ADR-0108 profile-version conflict is resolved by ADR-0119: an explicit, leased, no-tick v1-to-v2 representation migration initializes mutation state empty and preserves the complete existing region closure. ADR-0120 defines the first versioned eligibility/offer trial. Their owner and persistence implementation is the current 11.4b work after the 11.4a CI gate.
- 11.4b implementation now includes version-2 owner snapshots, fed-energy eligibility, stable offers, manifest/schema admission, the no-tick migration publisher, immutable migration record, and migration-aware recovery/replay. Runs 274 and 275 later passed all 10 jobs on the current branch, superseding the unavailable result from run 261 and validating these changes in CI.
- ADR-0122 resolves the archive/current-genome conflict with an append-only revision chain, preserving birth-genome history, and a cellular-v3 no-tick migration. ADR-0121 then defines selection and atomic publication. Affected modules are biology archive API/codec, cellular life owner/snapshot, checkpoint version bundle/migration, replay trace, SQL action publication, host/session and crash/retry tests. The archive API/codec, owner v3 snapshot and explicit no-tick v2-to-v3 manifest/SQL migration are implemented. The current 11.4c slice adds schema v29's fenced, idempotent mutation reservation and lease-fenced pending-action recovery API. Selection is still not admitted by the region host: exact offers, replayed action records, atomic biology/archive publication and crash recovery remain. No 11.4c or live mutation path is claimed complete until those pieces pass CI (see validation log).