docs: cellular region and movement redesign with ADR-0177 and implementation plan

Records the maintainer's region decisions: regions linked to a world area rather
than a voxel, currents and a world-derived thermal map as conditions rather than
stock, capped regions, fresh-life region choice, scaled emergence and a protected
logout anchor. ADR-0098, 0172 and 0173 note the amendments. Adds the movement
draft decisions (fixed-point motion state, player-dropped 007 anchor) and the
phased implementation plan with a Git tuning file and bubble merging.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
dingo
2026-10-21 16:13:20 -04:00
co-authored by Claude Opus 5.5
parent 9adaf6515b
commit 34f544942f
8 changed files with 1776 additions and 0 deletions
@@ -7,6 +7,12 @@ amends the target gameplay with offspring-only structural expression, birth-time
one-way control succession and NPC-parent continuity. The decisions below retain
their historical M11 implementation meaning until a new version is qualified.
2026-10-21: [ADR-0177](0177-cellular-regions-world-linkage.md) amends decision 4
for new cellular rules: logout takes effect after a delay during which the cell
stays vulnerable; afterwards it is anchored in place, cannot be engulfed, is not
moved by currents, and its metabolism and thermal response are frozen. This
replaces the vulnerable linger. A fresh life is also offered a choice of region.
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.
@@ -9,6 +9,13 @@ owner (12.5b) implements. It extends ADR-0136 step B, ADR-0144 and ADR-0157/0165
No default/live version, durable profile, SQL schema, photosynthesis, atmosphere
or M6 fixture change. ADR-0136 step C remains proposed design input.
Amended by [ADR-0177](0177-cellular-regions-world-linkage.md) for new cellular
rules: habitats are linked to a world area instead of one voxel; currents and the
thermal map are environmental conditions, not stock; regions cap their organism
count; emergence is a recorded export with a scaled world credit; logged-out
controlled cells are anchored, protected and frozen. Single ownership, individual
reserves and recorded boundary crossings are unchanged.
## Maintainer clarification
- **One owner per patch of space, at any moment.** It is not one global owner.
@@ -6,6 +6,11 @@ Accepted portable M12.5b evidence, 2026-10-19. Extends ADR-0172 and the populati
batches of ADR-0142/0144/0171. No durable admission, SQL schema, checkpoint profile,
automatic scheduling or live/default rule change.
Amended by [ADR-0177](0177-cellular-regions-world-linkage.md) for new cellular
rules: emergence adds a recorded export flow; currents and the thermal map are
re-derived from configuration and add no flows; refused births at the region cap
and protected anchored offline cells must be reproduced by replay.
## Decision
Joint batch 1 (`AEVOEBT1`) carries one complete, unchanged population batch (format
@@ -0,0 +1,110 @@
# ADR-0177: Cellular regions, world linkage and emergence
## Status and authority
Accepted product direction, 2026-10-21, from the maintainer's region review
decisions in chat. Implementation is pending. Amends ADR-0172 (habitat geometry,
environmental conditions, boundary crossings, offline treatment) and ADR-0173
(recorded flows and unattended intervals) for new cellular rules. Companion design:
[Cellular region changes](../../Cellular_Region_Changes.md) and
[Cellular movement draft](../../Cellular_movement_draft.md). Historical rules,
envelopes, checkpoints, tests and currently running worlds retain their meanings.
## Context
ADR-0172 places each cellular habitat inside one environmental voxel and accounts
every environmental quantity as owned stock. The region review needs larger
habitats with procedural currents and a thermal map, a defined exit from the 2D
cellular stage into the 3D world, a bounded population per region and a simpler
logout rule. It also selects simplifications so these can be playtested on the
DEV system without full fluid or thermal energy accounting.
## Decision
### Cellular regions belong to a world, not to a voxel
A cellular region is its own habitat linked to a world. It is not located in one
world voxel and its size is not limited by voxel extent. Each region maps to an
area of its world. The region's thermal map is that world area's thermal map,
scaled down to the habitat. The same mapping is used to select emergence targets.
Regions do not grow. Each region has a hard cap on its organism count; the world
adds regions instead. Whether demand creates another region for the same world or
attaches a region to a new world is a later equation, not selected here.
### Currents and the thermal map are environmental conditions
Procedural currents are a fixed environmental condition, like incident light.
They are not stock, carry no mechanical energy accounting, and add no ledger
entries. Drifting never credits usable E, and no process harvests flow energy.
The thermal map is a static maintained condition derived from the world map. It
is not owned thermal energy and is not derived from accumulated waste heat. The
existing heat compartment and radiative export keep their meanings. Owned thermal
energy with heat capacity is deferred until gameplay needs changing temperatures.
### Births stop at the region cap
At the hard cap, births in that region are refused. Engulfment and death return
matter to the region and reopen slots. When a region stays at the cap with no
active players for an extended period, an operator may cull wildlife through an
admin interface. Culling is an explicit, recorded operator action, never an
automatic despawn presented as selection.
### Region choice for a fresh life
A fresh cell is offered a choice of region when it begins, so friends can share
one. Recognition of friends stays a separate design question (ADR-0098).
### Emergence into the world
An organism that evolves out of the 2D stage leaves its cellular region. Its
matter is a recorded export from the region and is lost to the cellular scale.
The organism enters the world at a value scaled to world quantities. This is an
explicit scale conversion, not a one-to-one conserved transfer. The conversion
depends on the number of regions per world and the matter per region and is not
yet selected.
Target selection uses the region's mapped world area. Several candidate locations
closest to the organism's preferred temperature with the nutrients it needs are
ranked, and one is chosen at random. Crowding is not otherwise prevented: finite
world resources penalize popular sites.
The emerging organism chooses **individual** or **bulk** emergence. Bulk places it
in a selection queue; organisms emerging together with the same or close biology
receive one shared target choice.
### Logout anchors and freezes the controlled cell
Logout takes effect after a delay. During the delay the cell remains in play and
vulnerable; logging out while about to be engulfed does not prevent it. After the
delay the cell is anchored in place: it cannot be engulfed, is not moved by
currents, and its metabolism and thermal response are frozen. This replaces the
vulnerable linger of ADR-0098 for these rules. Offline fairness is unchanged:
an offline controlled organism does not move, feed, reproduce, mutate or progress.
### Disposable DEV worlds
New cellular rules start in new DEV worlds. Existing DEV worlds need not be
migrated; this does not authorize any World0 action.
## Consequences
- ADR-0172's one-voxel habitat geometry does not apply to the new rules. Its
single-owner principle, individual reserves and recorded open-boundary crossings
still apply.
- Currents and the thermal map need seeded, versioned configuration so replay and
restore reproduce them exactly, but no new joint-batch flows.
- Emergence adds a new recorded export flow to joint batches; the world-side
credit belongs to the world owner's own import record.
- The birth cap changes population outcomes and must be recorded in replay.
- Anchored offline cells are excluded from engulfment and flow in replay.
- Open: the emergence conversion scale, the region-or-world creation equation,
cap values, logout delay duration, bulk-queue timing and similarity threshold.
## Alternatives
Growing a single region to fit demand was rejected: capped regions scale by count.
Owned mechanical and thermal energy accounting for playtests was rejected as cost
without gameplay benefit at this stage. A vulnerable offline linger was replaced by
a logout delay followed by a protected anchor.
+2
View File
@@ -1,5 +1,7 @@
# Architecture decision records
- [ADR-0177: Cellular regions, world linkage and emergence](0177-cellular-regions-world-linkage.md) - maintainer-accepted direction: regions map to a world area rather than a voxel, currents and the thermal map are conditions not stock, capped regions refuse births, scaled emergence export, protected anchored logout; implementation pending.
- [ADR-0176: Durable photosynthesis regions and session v12](0176-durable-photosynthesis-region.md) - schema 57 raw bundle 13 (rules 11, owner format 9) with a light-declaring 12 -> 13 upgrade, the resumable `cellular-v8` opening and session v12 (captured light, visible producers, photosynthesis offers).
- [ADR-0175: Photosynthesis producers](0175-photosynthesis-producers.md) - genome schema 5 photosynthesis with trial organelle costs, founder 4/rules 11, light booked by the cell owner (format 9) from recorded intentions, light-aware wildlife; earlier bytes unchanged.