diff --git a/deploy/kubernetes/region/dev-session-route/listener.yaml b/deploy/kubernetes/region/dev-session-route/listener.yaml index e8b4817..812d72f 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-20261016T020534-56602:1792127134"} + - {name: REGION_SESSION_WINDOW, value: "dev-20261016T123310-15095:1792164790"} - {name: REGION_M10_MAX_GRANT_LIFETIME, value: "14400"} ports: # QUIC (ADR-0090): UDP only; nothing listens on TCP 7400. diff --git a/docs/adr/0133-behaviour-driven-evolution-and-colonies.md b/docs/adr/0133-behaviour-driven-evolution-and-colonies.md new file mode 100644 index 0000000..bd2c7f9 --- /dev/null +++ b/docs/adr/0133-behaviour-driven-evolution-and-colonies.md @@ -0,0 +1,198 @@ +# ADR-0133: Behaviour-driven evolution and budding colonies + +## Status + +Proposed (2026-10-16) by the maintainer after the first sign-in playtests. Design for +three rules versions, each to be built and playtested on its own: rules 7 (weighted +offers), rules 8 (colonizing buds) and rules 9 (steered colonies and coalescence). +Every number marked **tunable** is a trial value. Nothing here is implemented yet. + +## Context + +Mutation offers are seeded, uniform draws from the 28-operator catalog (ADR-0120): what +a cell does has no effect on what it is offered. A decline consumes the whole offer +(ADR-0120 amendment). Every bud becomes independent wildlife (ADR-0125). The roadmap's +multicellular transition (M14.2, "funded multicellular development") has no earned +path into it. + +The maintainer's intent: a cell's **behaviour decides how it evolves**, and therefore +what kind of multicellular organism it can become. Budding is the bridge. A bud may +stay attached to its parent and grow a colony that the player steers. Given time, a +colony may coalesce into a multicellular organism. + +## Decision + +### Rules 7: behaviour-weighted offers + +**Behaviour record.** Each owned life keeps cumulative counters, updated once per +committed tick by the authoritative owner and stored in its state, so replay and +recovery reproduce them exactly: + +- distance moved (µm) and ticks spent moving; +- ticks spent still (no movement requested); +- energy acquired from food (the credit ADR-0120 already counts); +- buds attempted and produced; +- engulfs attempted and succeeded. + +Offline (frozen) ticks add nothing (ADR-0128). Wildlife keeps no record. + +**Trait families.** Every catalog operator belongs to one family; families have +related families: + +| Family | Operators (capability, effect) | Fed by | Related | +|---|---|---|---| +| Locomotion | movement up/down/acquire/shed | moving | Feeding | +| Feeding | ingestion, energy conversion | eating | Locomotion, Growth | +| Growth | target size | eating, budding | Feeding, Reproduction | +| Defense | membrane | being engulfed, staying still | Growth | +| Reproduction | reproduction | budding | Growth | +| Environment | thermal tolerance | (none yet) | (none) | + +**Weights.** When an offer is drawn, each eligible operator gets an integer weight in +per-mille: + +- **Base:** 1000. +- **Behaviour:** × (1000 + 2000 × the share of this life's activity that feeds the + family) / 1000 (**tunable**). A cell that only moves draws locomotion three times as + often as an unrelated family. +- **History:** × the operator's bias, starting at 1000. + - An accepted mutation multiplies its own operator's bias by 1.25 and its family's + other operators' by 1.10. + - A declined candidate multiplies its own bias by 0.80, its family's other + operators' by 0.92, and related families' operators' by 0.97 (all **tunable**). + Declining cold tolerance therefore makes every temperature trait rarer, and + feeding traits slightly rarer if it were a feeding trait. +- **Floor and cap:** each final weight is clamped to 100–4000 per-mille. **Nothing is + ever ruled out**: the floor keeps every strategy reachable, as the locked "no linear + mutation tree" requirement demands. + +The draw is weighted sampling without replacement from the existing seeded stream +(seed, stream, event index: ADR-0120), in checked integer arithmetic, so it is exact +and replayable. Biases are life state. Candidates are still **shown in operator order, +unranked**; only their chance of appearing changes. + +**Per-candidate decline.** A v10 mutation choice may decline **one** candidate of the +exact outstanding offer. The candidate leaves the offer and is not replaced, and its +decline bias applies. The offer stays open with the rest. Declining the last candidate +consumes the offer. "Decline all" (operator 0, schema v40) applies the decline bias to +every candidate shown. A decline never earns a replacement: the next offer still needs +feeding credit (ADR-0120). The wire form is a new choice kind; the details belong to +the implementation ADR amendment. + +### Rules 8: colonizing buds + +**New capabilities** (genome schema 4, development version 4): + +- **Colonization**, per-mille: the chance a bud stays attached. Founders start at 0, so + rules-8 founders bud like today until they evolve it. +- **Budding efficiency**, per-mille: lowers the construction energy and the bud's + provision. Matter is never discounted (ADR-0118): a cheaper bud is a smaller or + thriftier one. +- **Budding rate:** the minimum interval between buds. +- **Movement efficiency:** cheaper movement per µm. Fed by moving. +- **Mutation rate:** less feeding credit per offer. Fed by eating. + +These join the families above, and reproduction-family operators are the ones budding +behaviour pulls toward. + +**The bud roll.** A funded bud draws, from the seeded stream keyed by (region, parent +life, bud sequence), whether it is **attached** (draw below colonization) or +**detached**. The result is recorded in the trace like any outcome, so replay does not +redraw it. + +- **Attached:** the bud joins its parent's colony. It belongs to the parent's account, + has its own body and reserve, and stays in contact with a member of the colony. The + colony has a bounded size (16 members, **tunable**); a bud that would exceed it is + detached instead. +- **Detached:** unowned wildlife, as today, with a **home anchor** at its birth + position. The wildlife controller keeps it within 2 mm of its anchor (**tunable**). + When its parent's account logs out, every detached bud of that parent re-anchors at + the parent's last position, so a player's detached colony stays where they left it. + +**Logout.** Attached members are the player's organism. They freeze, linger and +suspend with the parent, exactly as the parent does (ADR-0128), and resume with it. +Detached buds are wildlife and keep living (ADR-0125). + +### Rules 9: steered colonies and coalescence + +**One body, separate reserves.** The player steers the colony as one body: movement +intentions move every attached member together, keeping their attachments. Each member +keeps its own reserve and feeds from any patch it touches. Members pay their own +upkeep, and the colony's movement cost is shared in proportion to mass. A member that +starves dies, becomes a corpse and detaches. Engulfing and budding are colony actions, +performed by the member best placed for them. + +**Permadeath.** The life is the colony's founding cell. When it dies, the life ends +(ADR-0127). Surviving attached members detach as wildlife with their own reserves. +Nothing is resurrected. + +**Coalescence.** Once a colony has held at least 4 members (**tunable**) for at least 5 +minutes of active play (**tunable**), offers may include **Coalesce**. Choosing it is a +funded transition (ADR-0118): + +- the members' bodies and reserves combine, channel by channel, into one multicellular + organism, with construction energy for the junctions; +- nothing is created or lost; +- the colony's history (its size, and which families its members evolved) becomes the + organism's starting body plan. + +This is the entry to M14.2. What that organism can then develop into, and how it +enters the 3D habitat (M14.3), is M14's decision, not this ADR's. + +## Locked requirements + +- **No linear mutation tree:** satisfied, because the weight floor keeps every operator + reachable and offers remain unranked. +- **Absolute permadeath:** a dead founder ends the life; colony members never carry it + on. +- **No account-age advantage:** behaviour records and biases are life state. A new life + starts uniform. +- **Offline fairness:** attached members freeze with their owner; detached wildlife is + independent. +- **Biological costs and conservation:** every new effect is funded; cheaper budding + lowers energy or bud size, never matter. +- **Shared presentation:** colonies and wildlife render by the same rules as everything + else. + +## Versions + +- **Rules 7:** owner format 7 (behaviour record, biases, per-candidate decline state), + a version bundle and schema migration, a new choice kind on the wire, and a new DEV + region. +- **Rules 8:** genome schema 4 and development version 4 (new capabilities), owner + format 8 (colony membership, home anchors), a trace outcome for the bud roll, a + version bundle, a migration and a region. +- **Rules 9:** colony motion, shared costs and the Coalesce transition, with the same + version steps. + +Each version keeps earlier regions and their history unchanged, as rules 6 did +(ADR-0132). + +## Alternatives + +- **Uniform offers (status quo):** rejected by the maintainer; behaviour would not + matter. +- **Deterministic paths (moving always offers speed):** rejected; it is a linear tree. +- **Rerolling declined candidates:** rejected, as in ADR-0120; it gives unearned draws. + Declining shapes later odds instead. +- **An automatic budding discount per bud:** replaced by the budding-efficiency + capability, so cheaper budding is evolved rather than granted. +- **Colonies sharing one reserve from the start:** rejected; the merged reserve is what + Coalescence earns. + +## Consequences + +Players read their evolution from their play: a mover drifts toward speed, a feeder +toward intake and size, a budder toward colonies. The client needs the behaviour record +and the per-family odds to explain offers ("offered because you move a lot"). The +playtests need telemetry on family shares, decline rates and colony sizes to tune the +numbers. A colony gives the multicellular transition a cause, and a recognisable +origin for each multicellular body plan. + +## Open questions + +- Which behaviours should feed Defense and Environment once threats and temperature + gradients exist? +- How many discards per offer, if declining should cost anything? +- How colony members attach geometrically (chain, cluster, sheet), and whether that + shape constrains the multicellular body plan. diff --git a/docs/adr/README.md b/docs/adr/README.md index bae29f1..262a947 100644 --- a/docs/adr/README.md +++ b/docs/adr/README.md @@ -37,6 +37,7 @@ - [ADR-0130: Cellular playtest telemetry boundary](0130-cellular-playtest-telemetry-boundary.md) - M11.9: playtest telemetry is an offline, read-only `evo-world-clone summary` of a region head with account-free aggregates only (population, death causes, lifespans, buds, mutations, variety); per-player questions stay in consented notes. - [ADR-0131: Keycloak login and the grant broker](0131-keycloak-login-and-grant-broker.md) - players sign in to Keycloak realm `aeternalis` (PKCE, public client `aevolution-game`); `evo-grant-broker` verifies the RS256 access token, maps it to a game account (schema v39), issues 10-minute grants with increasing serials, and revokes on logout by raising the accepted serial and expiring control. - [ADR-0132: Cellular balance, rules 6](0132-cellular-balance-rules-6.md) - genome schema 3 (a third of the mutation step) and development version 3 (a third of the construction energy) for founders of rules-6 regions; opening `cellular-v5`, bundle v7, schema v41; existing lineages and history unchanged. +- [ADR-0133: Behaviour-driven evolution and budding colonies](0133-behaviour-driven-evolution-and-colonies.md) - proposed: offers weighted by each life's behaviour and by accept/decline history (never ruled out), per-candidate decline (rules 7); buds that attach to a steered colony or detach as anchored wildlife (rules 8); colony motion and a funded Coalesce transition into M14 multicellularity (rules 9). - [ADR-0058: Region durability contract](0058-region-durability-contract.md) - accepted M7.1 full checkpoint batches and explicit state closure; storage implementation follows.