Files
aevolution/docs/adr/0178-durable-liquid-region.md
dingoandClaude Opus 5.5 d2f603b582
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
feat: durable liquid regions (bundle 14, schema 58), cellular-v9 and session v13
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>
2026-10-21 18:08:59 -04:00

2.8 KiB

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 under ADR-0177: 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. 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.

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.