feat: durable liquid regions (bundle 14, schema 58), cellular-v9 and session v13
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 4s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 4m25s
Foundation / postgres-tools (push) Successful in 1m12s
Foundation / server-image (push) Successful in 4m20s
Foundation / image (push) Successful in 4m54s
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 4s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 4m25s
Foundation / postgres-tools (push) Successful in 1m12s
Foundation / server-image (push) Successful in 4m20s
Foundation / image (push) Successful in 4m54s
ADR-0178. Bundle 14 (rules 12 on owner format 10) is admitted by schema 58 through parser-local normalization to bundle 13, with an exact fenced 13 -> 14 upgrade whose only input, the liquid rules, recovery reads from the target. Schema 58 also widens the canonical action input: byte 13 bit 0 is brake. evo-world-clone gains the cellular-v9 opening: cellular-v8 followed by the liquid upgrade from --tuning FILE (region size must match) and an optional --current-seed; resumable and idempotent at bundle 14. Session v13 adds the owner's velocity, heading and the region's current configuration to its perception, each deposit's world velocity, and a brake on cellular actions; older sessions keep their layouts. A rules-12 server lists every pool and the nearest 256 moving bubbles. The client speaks v13, brakes on Space (rebindable; older controls files take the default), draws currents as drifting streaks and carries bubbles along their velocities between perceptions. Tests: protocol v13 round trips and refusals, action-input brake, controls files, and a PostgreSQL cellular-v9 provisioning test whose player is born, swims and brakes through the live host. Full local PostgreSQL qualification, the Linux debug suite and the Windows client suite pass. Refreshes the DEV session window. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,48 @@
|
||||
# ADR-0178: Durable liquid regions and session v13
|
||||
|
||||
## Status and scope
|
||||
|
||||
Accepted 2026-10-21. Implements phases 1-2 of the
|
||||
[region and movement plan](../../Cellular_Region_Movement_Plan.md) under
|
||||
[ADR-0177](0177-cellular-regions-world-linkage.md): rules 12 on the raw profile-4 path,
|
||||
schema 58, the `cellular-v9` opening and session protocol v13. Trial numbers come from the
|
||||
Git tuning file. DEV-only; no World0 operation.
|
||||
|
||||
## Decision
|
||||
|
||||
**Biology.** Genome schema 6 carries the movement arrangement (001-010, 100 = founder);
|
||||
development 6 and founder 5 use it. A shared integer motion step (velocity relative to the
|
||||
liquid, heading, funded thrust and braking, drag to exactly zero, sub-micrometre carry)
|
||||
runs identically on server and client. Seeded looping currents are a condition, not stock.
|
||||
Habitat format 3 moves bubbles with the current and the drift moving cells induce, merges
|
||||
touching bubbles up to a cap, keeps pools fixed and addresses unique.
|
||||
|
||||
**Owner format 10, rules 12.** An explicit no-tick format-9/rules-11 upgrade declares the
|
||||
liquid rules (current configuration, founder handling, deposit motion) taken from the
|
||||
tuning file and a seed when the region opens; the server never reads the file. See
|
||||
[schemas/cellular-lives-v10.md](../../schemas/cellular-lives-v10.md). Brake is a step
|
||||
intent valid only under rules 12, carried in raw trace 4 as flag bit 1.
|
||||
|
||||
**Bundle 14, schema 58.** Bundle 14 `(12, 10, 2, 1, 1, 6, 5, 2, 1)` is admitted by
|
||||
parser-local normalization to bundle 13, with bundle 12/13's births and mutation results,
|
||||
and an exact fenced 13 -> 14 upgrade whose only input, the liquid rules, recovery reads
|
||||
from the target. Schema 58 also widens the canonical action input: byte 13 bit 0 is brake.
|
||||
Population, census and migration profiles do not admit bundle 14 (raw path only, per the
|
||||
maintainer).
|
||||
|
||||
**Opening `cellular-v9`.** `cellular-v8` followed by the 13 -> 14 upgrade, with
|
||||
`--tuning FILE` (region size must match) and an optional `--current-seed`; resumable and
|
||||
idempotent at bundle 14. DEV mounts the tuning file into the provision Job as a generated
|
||||
ConfigMap.
|
||||
|
||||
**Session v13.** v12 plus liquid motion in the owner's perception (velocity, heading and
|
||||
the current configuration), deposit world velocities and a brake on cellular actions. See
|
||||
[schemas/network/session-v13-cellular-liquid.md](../../schemas/network/session-v13-cellular-liquid.md).
|
||||
|
||||
## Consequences
|
||||
|
||||
DEV region 10 (60 x 60 mm) replaces region 9 as the served region; regions 1-9 stay stored.
|
||||
The v13 client draws currents and carries bubbles between perceptions. Remaining from the
|
||||
plan: client-side prediction of the owner's motion with the shared step, the thermal map
|
||||
(phase 3), movement mutations (phase 4), wildlife that plans with inertia (phase 5), logout
|
||||
and region capacity (phase 6), and live retuning without reopening a region.
|
||||
@@ -1,5 +1,7 @@
|
||||
# Architecture decision records
|
||||
|
||||
- [ADR-0178: Durable liquid regions and session v13](0178-durable-liquid-region.md) - rules 12 on owner format 10 (currents, moving food, liquid motion), raw bundle 14 and schema 58 with a 13 -> 14 upgrade from the Git tuning file, the `cellular-v9` opening and session v13 (motion, currents, brake).
|
||||
|
||||
- [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).
|
||||
|
||||
Reference in New Issue
Block a user