From c468c70933b3d12b35da364e7d1bf3a69eda53d9 Mon Sep 17 00:00:00 2001 From: dingo Date: Fri, 9 Oct 2026 10:51:23 -0400 Subject: [PATCH] M11.1: record the first cellular loop decisions (ADR-0098) Maintainer decisions (2026-10-09) for the first playable loop: budding (parent keeps control, one funded wildlife bud); funded in-life mutation from seeded candidates; exact-copy heredity, no NPC mutation in M11; logout freezes at once, lingers vulnerable, then suspends; resume in place or nearest valid spot within a bounded radius; absorption plus engulfment by membrane-contested size ratio; first bud fundable within a session (tunable); friend recognition deferred. Updates OPEN_QUESTIONS 7/10/14/31/33, REPRODUCTION_MODEL, ROADMAP, STATUS; BACKLOG gains the open M10 native-client items. Refresh the dev session window. Co-Authored-By: Claude Opus 5.5 --- .../region/dev-session-route/listener.yaml | 2 +- docs/BACKLOG.md | 2 + docs/ROADMAP.md | 6 + docs/STATUS.md | 22 +++ .../0098-m11-first-cellular-loop-decisions.md | 182 ++++++++++++++++++ docs/adr/README.md | 1 + docs/architecture/OPEN_QUESTIONS.md | 10 +- docs/biology/REPRODUCTION_MODEL.md | 17 ++ 8 files changed, 236 insertions(+), 6 deletions(-) create mode 100644 docs/adr/0098-m11-first-cellular-loop-decisions.md diff --git a/deploy/kubernetes/region/dev-session-route/listener.yaml b/deploy/kubernetes/region/dev-session-route/listener.yaml index eaa5c18..32ea5ae 100644 --- a/deploy/kubernetes/region/dev-session-route/listener.yaml +++ b/deploy/kubernetes/region/dev-session-route/listener.yaml @@ -12,7 +12,7 @@ spec: env: - {name: REGION_SESSION, value: "dev"} - {name: REGION_SESSION_LISTEN, value: "0.0.0.0:7400"} - - {name: REGION_SESSION_WINDOW, value: "dev-20261009T133555-f23c:1791566755"} + - {name: REGION_SESSION_WINDOW, value: "dev-20261009T144507-0d1e:1791570907"} - {name: REGION_M10_MAX_GRANT_LIFETIME, value: "14400"} ports: # QUIC (ADR-0090): UDP only; nothing listens on TCP 7400. diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index 24e65d8..45ad4b5 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -15,6 +15,8 @@ names it. Remove an item only when it is done, and record where it was done. | **Store Job values.** Supply the published registry digests for `aevolution-postgres-tools` and `aevolution-server` (from each CI Publish step's `Digest:` line), and the NOLOGIN runtime group role for dev (`aevolution`) and for stage (`aevolution_stage`). Then include `stores/` in each environment's path. | M8.3, 2026-09-29 | Values pending | M8.3 in-cluster evidence | | **Alert destination.** Alertmanager routes every alert to a null receiver (ADR-0072). Choose where alerts go (Discord, email, a webhook), and optionally a heartbeat receiver for the always-firing Watchdog. Receiver credentials go in a Secret. | M8.5, 2026-09-30 | The maintainer will decide later | Any claim that alerts reach a person; M8.6 alert evidence; World0 | | **Kubelet log rotation check.** Confirm the RKE2 nodes' `container-log-max-size` and `container-log-max-files` (default 10Mi × 5), which bound region host logs (ADR-0072). | M8.5, 2026-09-30 | Needs node access | M8.6 | +| **M10 native-client observation.** M10's exit asks that the native client stay responsive against the authoritative server. The maintainer's observation moves to the later 2k drill (ADR-0097). | M10.9, 2026-10-09 | Drills paused by maintainer decision | Closing M10's exit evidence; the 2k drill | +| **Windows client cannot connect to the dev region.** On 2026-10-09 the client failed with "unreachable or certificate does not match". The default server name was wrong (fixed, `af156ab`), and the pod had been serving the certificate from before a CA renewal (restarted; `evo-session-probe` from the same machine was then welcomed). The client still failed afterwards; the cause is not yet known. | M10, 2026-10-09 | Maintainer: revisit later | The native-client observation above | | **Storage after the RAID/disk rework.** Re-run `deploy/kubernetes/inventory/disk-probe-local-path.yaml` (or a new class), and update INVENTORY.md. | M8.1, 2026-09-29 | Maintainer is reorganizing disks | M8.3's final storage decision | ## Accepted risks (maintainer decisions) diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 704ba9b..0b9edcf 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -587,6 +587,12 @@ M6 accounting contracts. Read GENOME_MODEL, ENERGY_MODEL and REPRODUCTION_MODEL. Synthetic fixtures are test oracles, not accepted gameplay balance. Ratify the offline lifecycle before enabling persistent player lives. +Status: +- 11.1's design decisions are accepted (ADR-0098, 2026-10-09). The time-based rate + migration (ADR-0089) is next. +- M10's exit evidence for native-client responsiveness is open (BACKLOG): the + maintainer's observation moves to the later 2k drill. + | ID / objective | Files/modules | Dependencies | Completion criteria | Tests / evidence | Risk | |---|---|---|---|---|---| | 11.1 Ratify cellular life and design decisions | docs/biology, docs/networking, docs/adr | M10, founding requirements | Decide bounded first-loop movement/feeding/reproduction rules, mutation timing/cost and heredity; resolve reproduction-cost semantics from ADR-0031/0032; document offline freeze/resume fairness and friend recognition or explicit social-feature deferral | State diagrams, adversarial logout scenarios, worked energy/matter budgets, review against locked vision | Fixture behavior or convenience invents permanent game rules | diff --git a/docs/STATUS.md b/docs/STATUS.md index 3adaada..e3eb9ee 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,5 +1,27 @@ # Project status and next steps +## Current gate - 2026-10-09 (M11.1) + +ADR-0098 records the maintainer's decisions for the first playable cellular loop: +- **Budding:** the parent keeps control and funds one wildlife bud. +- **Mutation:** earned during life, offered as seeded candidates and applied through + funded development. +- **Heredity:** exact copy; wildlife does not mutate in M11. +- **Logout:** biology freezes at once; the organism lingers, frozen but vulnerable, then + suspends. +- **Resume:** in place, or at the nearest valid spot within a bounded radius. +- **Feeding:** absorption and engulfment by a size ratio contested by membrane + thickness. +- **Birth cost:** a first bud fundable within a session (a tunable playtest target). +- **Friend recognition:** deferred. + +Next is 11.1's ratified engineering half: migrating biological rates from per-tick to +time-based units (ADR-0089). + +Open from M10 (BACKLOG): +- the maintainer's native-client observation, moved to the later 2k drill; +- the Windows client failing to connect to the dev region after a CA renewal. + ## Current gate - 2026-10-03 M10.1 ratifies M10 timing and workload budgets (ADR-0089, diff --git a/docs/adr/0098-m11-first-cellular-loop-decisions.md b/docs/adr/0098-m11-first-cellular-loop-decisions.md new file mode 100644 index 0000000..741063d --- /dev/null +++ b/docs/adr/0098-m11-first-cellular-loop-decisions.md @@ -0,0 +1,182 @@ +# ADR-0098: M11 first cellular loop decisions + +## Status +Accepted for M11 (2026-10-09). M11.1 records these decisions; nothing is implemented +yet. The maintainer chose each one from presented options on 2026-10-09. They are game +rules for the first playable loop, and changing one needs a new decision. + +Numeric values marked **tunable** are starting points for the 11.9 playtests. They are +not locked rules. Each one is a versioned rule constant, so a change goes through +simulation-version review (ADR-0089) and is recorded with its playtest evidence. + +## Context +M11 turns the M2–M6 fixtures and the M10 session layer into repeated primitive-cell +lives (ROADMAP 11.1–11.9). The locked requirements come from the founding brief +(PROJECT_VISION): absolute permadeath, independent wildlife descendants, no offline +progression, no classes and no linear progression tree, biological costs, and shared +presentation for players and NPCs. Within those requirements, REPRODUCTION_MODEL, +GENOME_MODEL and OPEN_QUESTIONS left the first-loop rules open. The engineering +constitution forbids settling them in code. ADR-0089 already ratified time-based +biological rates, to be migrated in M11.1. + +## Decision + +### 1. Reproduction: budding +One accepted strategy, budding: +- The parent survives and keeps its life and control. +- It pays an explicit investment of matter and energy to build one descendant. The + investment is the ADR-0032 reproduction investment, priced at the parent's own + construction rate. Construction overhead goes to heat and waste, as in ADR-0028. +- The descendant is autonomous wildlife from its first tick. No account owns it and + nothing labels it. + +Reproduction is an action under ADR-0092: it has a stable id, a durable outcome, and +duplicates resolve to the first outcome. The server decides prerequisites, cost, +placement and the child's genome; the client sends only the intention. An organism +that cannot fund the investment in every ledger channel is refused, and nothing is +spent. Abundant energy never pays for missing nitrogen. Placement capacity may refuse +or delay a bud, but it never grants a free or reduced one. + +Binary fission, eggs, cohorts and spores stay open. + +### 2. Mutation: earned during life, funded +A player's living organism can change its genome during its life: +- Eligibility is earned by surplus that has been fed and retained. The exact trigger + is part of 11.4's contract. +- The player is offered seeded candidates, using the M3.4 generator (ADR-0033): stable + context, no free rerolls, and stale offers rejected. +- A chosen candidate is applied through funded development (ADR-0031/0032). It + reserves and spends matter and energy for the change. It can fail for lack of + resources, and then nothing changes. +- Each applied mutation creates an immutable successor genome with ancestry (ADR-0030, + ADR-0034). The organism keeps its life id; only its genome revision advances. + +There is no tree, no class and no guaranteed sequence. Offers are contextual, and every +candidate trades one cost against another. + +### 3. Heredity: exact copy; wildlife does not mutate in M11 +- A bud inherits its parent's current genome exactly at the moment of birth, and its + ancestry records the parent organism and genome revision. +- Wildlife never mutates on its own in M11. Open question 11 (NPC mutation) stays open + for M12. Lineages diverge in M11 only through mutations players choose before + budding. + +### 4. Logout and disconnect: linger, then freeze +On a clean logout or a detected disconnect, the organism enters **SuspendPending**: +- Its biology freezes at once. It cannot move, feed, grow, mutate or reproduce. + Maintenance, gestation, construction and every other biological timer stop, because + an offline organism may never progress (locked). +- It stays in the world for a fixed linger time (**tunable**, starting at 10 s). During + that time it is perceivable and vulnerable: other organisms can engulf it, and lethal + outcomes apply. +- If it survives the linger time, it becomes **Suspended** durably and leaves the + world. Its inventory stays in global accounting and cannot interact. +- A reconnect during the linger time resumes it in place. +- A death decided before the freeze boundary is committed first (REPRODUCTION_MODEL + state diagram). + +Lingering costs the organism nothing biologically and gains it nothing; it only stops +logging out from being an escape. Detection bounds for a disconnect (heartbeat and +timeout) are the session layer's: they reuse the M10 session timeouts and are stated +in 11.7's contract. + +### 5. Resume: the same spot, else the nearest valid spot +A resume first replays any committed death, and a dead life never resumes. Then: +- The organism resumes at its frozen position if that position is still valid. +- Otherwise it resumes at the nearest valid position within a small bounded radius + (**tunable**, starting at a few cell diameters). It is never placed farther away: + there is no free travel. +- If no valid position exists within the radius, the life stays suspended and the + player is told why. + +Resume performs no elapsed-time biology. It needs a unique control grant: two sessions +never resume the same life (ADR-0091). + +### 6. Feeding and predation: absorb and engulf +- **Absorption.** A cell takes up environmental nutrients through surface contact, at + most at the genome's intake budget (ADR-0032), channel by channel. It takes only + what the environment holds (atomic transfers, ADR-0053). +- **Engulfment.** A cell can engulf a contacted cell that is sufficiently smaller. + - The size-ratio threshold is **tunable**, starting at 1.5 by mass. + - The prey's membrane thickness contests it: a thicker membrane raises the ratio + required, so defence is a built trait with a cost, not a percentage modifier. + - The engulfed cell dies. Its whole inventory moves to the predator exactly once, + bounded by the predator's capacity. Any excess becomes detritus at the contact + point, so nothing is destroyed or created. +- **Corpses.** A cell that dies another way leaves a corpse or detritus with its + inventory (ADR-0027, ADR-0056), and any cell can absorb it. + +The server resolves contact, perception, motion and intake (11.3). Clients send only +movement and engulf intentions. + +### 7. Birth cost: reachable within a session +GENOME_MODEL found that a birth can be funded within a plausible lifespan only near +the schema's minimum reproduction fraction. M11 re-derives the development-version +constants (ADR-0032) so a typical primitive cell can fund its first bud in roughly 5 +to 15 minutes of competent feeding (**tunable**). This is a new development version +with migration and regression evidence, not an edit of the existing one. The target +is a playtest hypothesis, and 11.9 adjusts it. + +### 8. Friend recognition: deferred +M11 has no friend mechanism. Players and wildlife look identical (locked shared +presentation). Open question 31 is deferred explicitly, to be revisited after the 11.9 +playtests. + +### Ratified earlier: time-based biological rates +Ratified in ADR-0089. M11.1 migrates per-tick genome and checkpoint rate fields to +time-based units, with deterministic per-tick conversion and explicit units, +precision, remainder carry, rounding and overflow bounds. Regression evidence must +show unchanged 50 ms behaviour where the version is unchanged. + +## Scope +These decisions bound M11 only. Still open: +- binary fission, eggs, cohorts and spores; +- NPC mutation (open question 11) and speciation; +- recombination and multiple parents; +- how long suspension is retained, and what happens to the matter of a life suspended + indefinitely; +- friend recognition; +- evolvable behaviour. + +Wildlife behaviour in M11 is a bounded, deterministic controller over the same +intentions players use (open question 33). It has no special biological rules. + +## Alternatives considered +- **Reproduction.** Binary fission needs a rule for which half the player controls. + Spores and cohorts add cohort materialisation to the first loop. +- **Mutation.** Mutating only at reproduction would leave a life with no evolutionary + choices of its own. Mutating both during life and at reproduction would double the + rule surface before the first playtest. +- **Heredity.** Random inherited drift would settle NPC mutation now, without M12's + ecology evidence. +- **Logout.** An instant freeze makes logging out an escape from predation. Blocking + logout while engaged punishes clean exits and still freezes on a disconnect. +- **Feeding.** Absorption alone delays the predation pillar. Damage over contact adds a + combat model with more invented constants. +- **Birth cost.** A rare birth makes descendants nearly unobservable in a playtest. + Deferring the cost leaves budding effectively unreachable. + +## Benefits +- **Little new rule surface.** Budding, the candidate generator, funded development and + the corpse transfers already exist as fixtures. +- **Conservation stays checkable.** Every change spends ledger channels, and engulfment + and corpses move inventories exactly once. +- **Offline fairness.** The locked rule holds even during the linger time, because + freezing happens before lingering. + +## Costs and risks +- **Lingering can still be gamed.** A player could log out where nothing can reach + them. 11.7's tests cover this, and the linger time is tunable. +- **Mutation could look like progression.** Funded in-life mutation risks reading as a + progression system. Offers must stay contextual tradeoffs, and 11.4's tests check + that no candidate dominates. +- **Size could dominate predation.** Engulfment by size ratio may favour size; the + membrane contest and the cost of size (ADR-0032) are the counterweights, and 11.9 + watches for monopoly. +- **Tunables could harden into rules.** Each tunable value is versioned and must be + changed with evidence, never silently. + +## Consequences +- Updated: REPRODUCTION_MODEL and OPEN_QUESTIONS rows 7, 10, 14, 31 and 33. +- 11.2–11.7 implement against this ADR, and each states its own contract. +- The first implementation increment is the ratified time-based rate migration. diff --git a/docs/adr/README.md b/docs/adr/README.md index e2d877f..f0a3c94 100644 --- a/docs/adr/README.md +++ b/docs/adr/README.md @@ -98,6 +98,7 @@ design. No unadopted candidate is a link dependency of the proof. - [ADR-0084: Engineering UI toolkit](0084-engineering-ui-toolkit.md) - Dear ImGui 1.92.9b pinned (M9.8a) and integrated as the engineering client overlay with toolkit-first input routing (M9.8c). - [ADR-0090: M10 QUIC transport](0090-m10-quic-transport.md) - msquic 2.6.2 with OpenSSL 3.5.9 LTS (TLS 1.3 only) from pinned sources on Windows and Linux; DATAGRAM frames for superseding state, streams for reliable actions; M9 TLS/TCP kept as dev fallback; owned impairment relay; exact CA pinning due in 10.2b. +- [ADR-0098: M11 first cellular loop decisions](0098-m11-first-cellular-loop-decisions.md) - maintainer decisions for the first playable loop: budding (parent keeps control, one funded wildlife bud); funded in-life mutation from seeded candidates; exact-copy heredity with no NPC mutation in M11; logout lingers frozen but vulnerable, then suspends; resume in place or nearest valid spot within a bounded radius; absorption plus engulfment by contested size ratio; birth reachable within a session (tunable); friend recognition deferred. - [ADR-0097: M10 load and abuse qualification](0097-m10-load-and-abuse-qualification.md) - only evolution-dev reference-worker runs qualify; one multi-client evo-load tool with per-client distributions; a load governor over per-tick work (p95 window of 40 ticks) and tick debt refuses grant logins, then sheds replication radius and cadence in 3 levels with hysteresis (tickets still admitted); abuse suite of fuzz, floods, slow peers, storms and lease loss. - [ADR-0096: M10 probe handoff](0096-m10-probe-handoff.md) - EXPERIMENT durable probe records with one owning region and a conserved test inventory; fenced prepared/staged/committed/aborted transfers; signed single-use transfer tickets; protocol v4 offers, redirects and ghosts; recovery sweep (schema v14) and replay guard proven by a two-process fault matrix. - [ADR-0095: M10 interpolation and session loss](0095-m10-interpolation-and-session-loss.md) - drift-corrected client tick clock, adaptive 2-6 tick interpolation of remote markers with at most 2 ticks of extrapolation (organisms never), frozen stale view on loss and a fresh baseline on reconnect. diff --git a/docs/architecture/OPEN_QUESTIONS.md b/docs/architecture/OPEN_QUESTIONS.md index 1de14eb..da9f33a 100644 --- a/docs/architecture/OPEN_QUESTIONS.md +++ b/docs/architecture/OPEN_QUESTIONS.md @@ -12,14 +12,14 @@ person. ADR indexes distinguish scoped proof choices from production proposals. | 4 | Dependency manager | Evaluate vcpkg manifest vs Conan; no runtime dependency for proof | Build; first dependency | | 5 | Units library | Minimal explicit integer wrappers now; evaluate dimensional library before biology | Simulation; M2 | | 6 | Determinism | Exact integer proof; physics separately scoped | Simulation; each system ADR | -| 7 | Mutation generation | Seeded context-conditioned candidates with validated prerequisites | Biology/design; M3/M11 | +| 7 | Mutation generation | Seeded context-conditioned candidates with validated prerequisites. M11: earned during life, offered from seeded candidates and applied through funded development (ADR-0098); candidate count and the eligibility trigger come in 11.4's contract | Biology/design; M3/M11 | | 8 | Genome representation | Immutable versioned developmental capabilities, not DNA | Biology; M3 | | 9 | Developmental body | Typed body graph proposal | Biology/engine; M13 | -| 10 | Heredity/reproductive mutation | Preserve ancestry, define mutation budget and costs | Biology/design; M3/M11 | +| 10 | Heredity/reproductive mutation | M11 (ADR-0098): budding; a bud copies its parent's current genome exactly, with ancestry; no mutation at birth. Recombination stays open | Biology/design; M3/M11 | | 11 | NPC mutation | Undecided; no silent autonomous divergence | Biology/design; M12 | | 12 | Species/speciation | Derived classifications; no class mechanics | Biology/design; M12 | | 13 | Lineage extinction | Need world-wide no-living/no-viable-reserve evidence | Ecology; M4/M12 | -| 14 | Offline state | Park without any progression; disconnect fairness unresolved | Design/security; before player persistence | +| 14 | Offline state | M11 (ADR-0098): biology freezes at once on logout or a detected disconnect; the organism lingers in the world, frozen but vulnerable (tunable, 10 s), then suspends durably; resume in place or at the nearest valid spot within a bounded radius, else it stays suspended. How long suspension is retained stays open | Design/security; before player persistence | | 15 | Multicellular transition | Physiological and ecological criteria unresolved | Design/biology; M14 | | 16 | Population abstraction | Conservative cohort ledger + distributions, ensemble validation | Ecology; M4 | | 17 | Region dimensions | Benchmark against interest, entities and migration overhead | Engine/platform; M7 | @@ -36,9 +36,9 @@ person. ADR indexes distinguish scoped proof choices from production proposals. | 28 | Recovery | Committed contiguous replay range and unique epoch | Persistence; M7/M8 | | 29 | Cross-version migration | Clone, migrate, accelerated comparison, approved world barrier | Simulation/platform; M7+ | | 30 | Steam identity | Provider subject → internal account boundary | Backend/security; before Steam | -| 31 | Friend recognition | Separate social channel, no player/NPC labels | Design; M11 | +| 31 | Friend recognition | Deferred explicitly for M11 (ADR-0098); revisit after the 11.9 playtests. No player/NPC labels | Design; after M11.9 | | 32 | Anti-cheat | Authoritative outcomes plus authenticated bounded intentions | Security; M10 | -| 33 | AI behavior | Shared intention interface; bounded deterministic controller | Simulation; M2/M11 | +| 33 | AI behavior | Shared intention interface; bounded deterministic controller. M11 wildlife uses the same intentions as players, with no special biological rules (ADR-0098) | Simulation; M2/M11 | | 34 | Evolvable behavior | Undecided; intelligence not mandatory | Biology/design; M12/R&D | | 35 | Morphology limits | Development graph validates material, attachment and capability | Biology/design; M13 | | 36 | Procedural animation | Isolated locomotion prototypes; no authored animation dependence | Engine; M13 | diff --git a/docs/biology/REPRODUCTION_MODEL.md b/docs/biology/REPRODUCTION_MODEL.md index e5d04bd..cdbb177 100644 --- a/docs/biology/REPRODUCTION_MODEL.md +++ b/docs/biology/REPRODUCTION_MODEL.md @@ -79,6 +79,23 @@ preserves every timer; same-tick death/reproduction ordering; huge spore request all suspend/resume crash points; changed habitat; unique control grants and death committed after snapshot. Extinction includes suspended viability. +## M11 decisions (ADR-0098) + +The maintainer accepted these for the first playable loop (2026-10-09): +- **Budding.** The parent keeps its life and control, and funds one wildlife bud at + its construction rate. +- **Heredity.** A bud copies its parent's current genome exactly. Wildlife does not + mutate in M11. +- **Mutation.** Mutations are earned and applied during life through funded + development. +- **Logout.** On logout or a detected disconnect, biology freezes at once. The organism + lingers frozen but vulnerable, then suspends. +- **Resume.** In place, or at the nearest valid spot within a bounded radius; otherwise + the life stays suspended. + +Fission, eggs, cohorts, spores, NPC mutation, and how long suspension is retained stay +open. The values marked tunable are playtest hypotheses, not locked rules. + ## Implemented M2.5 fixture boundary [ADR-0028](../adr/0028-funded-reproduction.md) implements funded budding inside