feat(ecology): make photosynthesis regions playable on DEV
Foundation / checks (ecs) (push) Successful in 2m19s
Foundation / checks (deploy) (push) Successful in 4m47s
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 16m48s
Foundation / checks (network) (push) Canceled after 16m46s
Foundation / checks (postgres) (push) Canceled after 16m47s
Foundation / checks (client) (push) Canceled after 16m53s
Foundation / checks (tsan) (push) Canceled after 14m33s

ADR-0176 and schema 57 admit raw cellular bundle 13 (rules 11 on owner
format 9) through parser-local normalization to bundle 12, and a fenced
no-tick 12 -> 13 upgrade that declares the region's light; recovery reads
the light from the target and re-derives the whole target from the source.
The resumable cellular-v8 opening provisions a cellular-v7 genesis, one
empty tick and the durable upgrades to bundle 13.

Session v12 adds the owner's captured light and the producers it can see
to its perception, and lets offers name photosynthesis; older sessions keep
their layouts and never receive photosynthesis candidates. The client
draws chloroplasts by efficiency, shows sunlight in the HUD and offers
photosynthesis cards. DEV now provisions and serves region 9 with the
trial light; region 8 stays stored but unserved.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
dingo
2026-10-19 23:04:34 -04:00
co-authored by Claude Opus 5.5
parent 108f29eda5
commit b73ccbae9a
38 changed files with 1106 additions and 140 deletions
@@ -0,0 +1,42 @@
# ADR-0176: Durable photosynthesis regions and session v12
## Status and scope
Accepted 2026-10-19. Makes ADR-0175's rules-11 producers playable on the existing
profile-4 path: schema 57, the `cellular-v8` opening and session protocol v12. Trial
numbers stay tunable. No World0 operation; DEV deployment is a separate manifest change.
## Decision
**Bundle 13.** Cellular bundle 13 `(11, 9, 2, 1, 1, 5, 4, 2, 1)` is rules 11 on owner
format 9 with development 5 and founder 4, raw profile 4 only, history profile 4 and raw
trace 4. Schema 57 admits it by parser-local normalization to bundle 12 (every common
field validated exactly as before), the same births wrapper, and bundle 12's mutation
results (1 died, 3 declined, 4 offspring plan applied). Population and joint profiles do
not admit it yet.
**Upgrade 12 -> 13.** An explicit fenced, no-tick version upgrade through the existing
immutable version-upgrade journal declares the region's light. Unlike earlier upgrades it
has an input that the source cannot supply; recovery reads the light from the target
payload, re-derives the complete target from the source with it and requires the exact
bytes, so only the declaration itself is new. Pending intervals or unpublished mutation
choices block it, as for bundle 12.
**Opening `cellular-v8`.** The provisioning tool writes a `cellular-v7` genesis, then
under a short lease publishes one empty tick (upgrades never follow a genesis directly)
and runs the durable 9 -> 10 -> 11 -> 12 -> 13 upgrades with `--light-pj` (irradiance per
square micrometre per tick; entitlement effectively unbounded). It is resumable from any
intermediate bundle and idempotent at 13. Founders born afterwards are founder 4.
**Session v12.** v12 is v11 plus, in the owner's perception, the light its cell captured
on the last tick and the photosynthesis level of every producer it can see (by organism,
so the client can draw green organelles), and mutation offers may name capability 7.
Older sessions keep their exact layouts: they receive no producer data, and photosynthesis
candidates are dropped from the offers sent to them (their other choices stay valid).
## Consequences
A DEV region can be provisioned with photosynthesis and played with a v12 client. Light
has no durable state beyond the owner payload, which is fully replayed. Remaining before
the integrated 12.5 gate: census/migration/population support for bundle 13, a joint
region over a rules-11 owner on the durable path, and playtest balance.
+2
View File
@@ -1,5 +1,7 @@
# Architecture decision records
- [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.
- [ADR-0174: Durable cellular environment profile](0174-durable-cellular-environment-profile.md) - schema 56 checkpoint profile 6 nesting population envelope 2; explicit one-way 5 -> 6 entry, fenced joint publication with owned intervals and SQL flow totals, exact replayed recovery.