Files
aevolution/schemas/cellular-environment-v1.md
T
dingoandClaude Opus 5.5 4c70257883
Foundation / checks (ecs) (push) Successful in 2m28s
Foundation / checks (deploy) (push) Successful in 4m59s
Foundation / checks (network) (push) Successful in 20m56s
Foundation / checks (client) (push) Successful in 22m1s
Foundation / checks (tsan) (push) Successful in 45m41s
Foundation / checks (postgres) (push) Successful in 1h13m35s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (checks) (push) Canceled after 1h20m34s
feat(ecology): own cells and their local environment together
ADR-0172 records the maintainer's M12.5 ownership decision: one owner per
patch of space for cells and their local environment, reserves belonging
to the biological individual, and an open planet boundary whose every
crossing is a recorded import or export.

The portable CellularEnvironment owner (envelope AEVOCEN1) holds an exact
population with tagged water and dissolved compartments, refuses declared
atmosphere, imports infall from finite per-source entitlements (ADR-0136
step B) and radiates retained heat. Each tick's exchange is a validated
swap on the nested owner, undone if the biological tick refuses. Closed
and source-off regions keep their biology byte for byte; raw and cohort
representations agree under infall. No existing format, trace, golden,
default opening or live version changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 16:05:17 -04:00

2.3 KiB

Cellular environment envelope 1

Authority: ADR-0172. Little-endian integers, no padding. Size is bounded by max_cellular_environment_bytes. No existing cellular, population, trace or durable bundle format changes.

Offset Bytes Field
0 8 Magic AEVOCEN1
8 4 Format 1
12 4 Environment rules 1
16 8 World
24 8 Region
32 8 Frame
40 8 Completed tick
48 24 Voxel address x, y, z (two's-complement i64)
72 48 Habitat box x, y, z, width, height, depth in micrometres (u64 each)
120 24 Water, dissolved inorganic N, dissolved inorganic P in femtograms
144 8 Radiation cap, pJ per tick
152 8 Cumulative radiated heat, pJ
160 4 Infall source count, at most 4
164 4 Reserved, zero
168 8 Nested population envelope bytes
176 208 each Infall sources in strictly increasing id order (below)
after sources declared length Complete canonical population envelope 2 or 3
final 8 FNV-1a64 over all preceding bytes

Each source record: id (8); rectangle x, y, width, height (4 each); start and end tick (8 each, half-open); mean interval ticks (8); bubbles min and max (4 each); per-bubble inventory, entitlement and cumulative imported inventory (40 each: energy then C, N, P, other); events, credited bubbles, skipped bubbles and exhausted events (8 each).

Restore requires exact length, matching trusted identity and tick, a canonical nested population whose owner has a boundary ledger (format 7 with rules 8/9, or format 8 with rules 10), the box inside one voxel with width and height equal to the cellular area and positive depth, valid disjoint sources, cumulative import within entitlement, environmental imports within the nested ledger's incoming flow and radiated heat within its outgoing energy, and byte-identical re-encoding. Atmospheric species have no field: a configuration declaring any is refused.

Remaining entitlement and every infall event are derived, never stored: replay re-derives events from world, region, source id and tick. The checksum detects corruption only; durable publication must bind SHA-256, predecessor, fence and manifest. No checkpoint profile, SQL schema or durable bundle admits this envelope yet, and a nested population restored alone must not publish a joint result.