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
+10 -3
View File
@@ -8,9 +8,16 @@ and cellular rules 11. A region declares light in owner format 9; each tick a st
active producer captures cross-section x irradiance x efficiency (a quarter while
moving), booked as boundary inflow inside the same atomic tick. A founder earns the
capability as its offspring plan; its children express it and capture light. Every
earlier genome, offer, owner and environment byte keeps its meaning. Durable bundle,
session wire, client look and a DEV opening follow next. Numbers are trial values to
balance after playtesting.
earlier genome, offer, owner and environment byte keeps its meaning. Numbers are trial
values to balance after playtesting.
[ADR-0176](adr/0176-durable-photosynthesis-region.md)/schema 57 makes producers
playable: raw bundle 13 with a durable light-declaring upgrade, the resumable
`cellular-v8` opening, and session v12, whose owner view carries captured light and
the producers it can see, and whose offers may name photosynthesis. The client draws
green chloroplasts by efficiency, shows sunlight in the HUD and offers photosynthesis
cards. DEV now provisions and serves region 9 (`cellular-v8`, light 40); region 8 stays
stored but unserved. A push alone does not establish the deployed result.
## Cellular environment ownership (M12.5a-b) - 2026-10-19
@@ -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.
+1 -1
View File
@@ -66,7 +66,7 @@ or authorize production enablement.
| 12.2 | Exact cellular model and paired matrix; local samples through 256 lives; bounded four-generation rules-9 predation/twin matrix | Deployment-host tail costs including publication; larger wildlife cohorts and fuller contention coverage; useful compression remains unimplemented. |
| 12.3 | Dedicated population profile/trace/store/owning host; exact recovery and private PostgreSQL fault tests | Population-specific executable/network fault drills and target-host publication/capacity qualification. |
| 12.4 | Owned intervals; exact transfer/accounting; durable atomic pair/recovery; independent loopback TLS path loss and owner expiry/replacement/heal; local object sync/read-failure matrix | Multi-host/kernel-network, storage-host and orchestrator drills, linked-boundary contracts and integrated ownership/stock audits at scale. |
| 12.5 | ADR-0175 photosynthesis producers (portable rules 11/format 9); ADR-0172 portable joint owner: one budget for cells and local environment, effective depth, tagged water/dissolved compartments, refused atmosphere, finite infall entitlements, radiative export; closed/source-off/open/exhaustion and raw/cohort comparisons; ADR-0173 joint batch with exact unattended replay; ADR-0174/schema 56 durable profile 6 with owned intervals and exact recovery | Durable rules-11 bundle, producer session wire/client and DEV opening; joint fault drills (deferred by the maintainer), worker/census/migration integration and escrowed cross-worker sources (12.5d), target-host qualification (12.5e). |
| 12.5 | ADR-0175 photosynthesis producers (portable rules 11/format 9); ADR-0172 portable joint owner: one budget for cells and local environment, effective depth, tagged water/dissolved compartments, refused atmosphere, finite infall entitlements, radiative export; closed/source-off/open/exhaustion and raw/cohort comparisons; ADR-0173 joint batch with exact unattended replay; ADR-0174/schema 56 durable profile 6 with owned intervals and exact recovery | Producer playtests and balance (DEV region 9); bundle 13 in population/joint/census/migration; joint fault drills (deferred by the maintainer), worker/census/migration integration and escrowed cross-worker sources (12.5d), target-host qualification (12.5e). |
| 12.6 | Retained archive, regional census/lineage queries, replayed history, scoped multi-region queries and consistent database head snapshots (12.6a-d); registered coverage/history domains follow in 12.7a-b | Cross-domain clone provenance, retained historical coverage/other viable stores, target-host query/index qualification and client permission/presentation; no account power or invented precise statistical ancestry. |
| 12.7 | Viability/unknown policy; consistent cuts, registered coverage, history domains/restore forks and verified pending handoff evidence (12.7a-c/schema 52) | Cross-domain clone provenance, other viable-store coverage and durable accepted global evidence records/freshness. Missing/stale/unsupported owners must prevent terminal extinction. |
| 12.8 | Deterministic seed/regime drivers, separate-process exact continuation and bounded unscripted generations | Reproducible integrated worlds running for actual days, real restarts/clone comparisons and retained accounting/diversity/cost audits. Accelerated tests cannot supply elapsed days. |
+36
View File
@@ -1,5 +1,41 @@
# Validation report
## 2026-10-19 - Durable photosynthesis regions and session v12 (ADR-0176)
[ADR-0176](../adr/0176-durable-photosynthesis-region.md)/schema 57 adds raw bundle 13,
the light-declaring 12 -> 13 upgrade, the `cellular-v8` opening and session v12 with
client support, and switches DEV to producer region 9.
Executed locally:
- GCC 14.2 Release **96/96**; Linux network-clang **102/102** and quic-linux
**106/106**; MSVC 19.44 Release **96/96**; Windows quic **8/8** and client-network **17/18** in
parallel, the remaining `motion-trace-smoke` passing alone (its impaired-link setup
failed while ten network tests shared the machine). Two Windows quic runs were
interrupted by a VS ninja dyndep assertion and a parallel `msquic.dll` copy race; the
tree was cleared and the build finished serially. No source change was needed.
- Private PostgreSQL qualification `--full` passes in **626 s** (twice; once before the
final provisioning fixes). One run made while the Windows quic build saturated the
machine failed an M10 probe duplicate-receipt check after a process restart; the idle
rerun passed it unchanged.
- Joint-environment PostgreSQL suite: durable 9 -> 10 -> 11 -> 12 -> 13 with declared
light on a funded raw region, exact upgrade retry, a reused identity with other light
refused, recovery with rules 11, format 9 and the declared light, an unattended
interval on bundle 13 recovered exactly, and a funded birth on bundle 13 that recovers
as founder 4 (genome schema 5).
- `cellular-v8` process test: refused without `--light-pj`; provisions to sequence 5 at
tick 1 on bundle 13 and reports already-provisioned on rerun.
- Session v12 contract: light and producers round-trip; v11 refuses both; producers must
ascend by organism with efficiency 1..1000 and zero reserved bytes; capability 7 offers
only in v12, capability 8 nowhere.
- clang-tidy 19 and clang-format 19 on every changed source and test. Tidy found an
optional copied through a dereference, an unchecked optional and a discarded lease
release in the new provisioning code; all fixed.
The client builds with the producer drawing, sunlight HUD line and photosynthesis cards;
the visual result has not been seen in a running client. No deployment result is claimed:
the DEV region 9 opening runs only after Argo applies the pushed manifests.
## 2026-10-19 - Photosynthesis producers (ADR-0175)
[ADR-0175](../adr/0175-photosynthesis-producers.md) adds genome schema 5, development 5,