Files
aevolution/docs/adr/0174-durable-cellular-environment-profile.md
T
dingoandClaude Opus 5.5 51991ac7ff
Foundation / checks (ecs) (push) Successful in 2m24s
Foundation / checks (deploy) (push) Successful in 4m51s
Foundation / checks (network) (push) Successful in 20m42s
Foundation / checks (client) (push) Successful in 21m53s
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 40m19s
Foundation / checks (postgres) (push) Canceled after 40m9s
Foundation / checks (tsan) (push) Canceled after 37m53s
feat(persistence): admit durable cellular environment profile
ADR-0174 and schema 56 add checkpoint profile 6, which stores the joint
cell/environment envelope nesting population envelope 2 (bundles 10 and
11). Entry from a committed population head is explicit, one-way and
no-tick, with the source commit, manifest and payload digests bound in
immutable evidence. Joint intervals use schema 45's owned admission and
settlement; conversions cannot overtake a pending interval. The fenced
publisher validates the joint trace structurally, including the complete
nested population batch, and records per-commit imported and radiated
totals. Recovery replays the head's link and requires the payload
exactly, refusing a forged but structurally valid trace. A trigger
refuses profile-6 commits from every other publisher; profile 4/5 bytes,
parsers and rules are unchanged.

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

58 lines
3.4 KiB
Markdown

# ADR-0174: Durable cellular environment profile
## Status and scope
Accepted M12.5c durable admission, 2026-10-19. Extends ADR-0142/0143 (population
profile and owned intervals), ADR-0172 (joint owner) and ADR-0173 (joint batch).
Schema 56. No automatic selection, worker scheduling, census/migration support,
default/DEV opening, live upgrade or World0 operation.
## Decision
**Checkpoint profile 6** (`cellular_environment_v1`, history profile 6) stores the
complete joint envelope `AEVOCEN1`. It nests population envelope 2 only (owner 7 with
rules 8 or 9: cellular bundles 10 and 11). Bundle 12 retained-plan populations stay
outside until their own durable population admission exists.
**Entry is explicit, no-tick and one-way.** `migrate_population_to_environment` takes
a committed profile-5 head under the current lease, restores its population, wraps
it with the declared environment and requires the nested population bytes to equal
the source exactly. SQL binds the source commit, manifest digest and payload digest
in `environment_profile_transitions`; the bundle, frame, tick quantum and tick are
unchanged and a pending player mutation or interval blocks it. There is no reverse
transition: unwrapping would discard environment state that has no other owner.
Re-entering profile 5 needs a separately versioned decision.
**Publication** of a joint interval or whole-group conversion replays the batch from
the committed predecessor before upload and requires the candidate bytes exactly.
`publish_environment_checkpoint` validates the joint trace structurally, including
the complete nested population batch contract bound to the same identity,
predecessor and ticks, and records per-commit totals of imported energy/C/N/P/other
and radiated heat. Intervals require schema 45's owned admission: admission now
accepts profiles 5 and 6 and the same pending pointer and settlement journal apply.
A conversion cannot overtake a pending interval. Exact retries return the original
receipt; a reused identity with other bytes conflicts.
**Recovery** loads the head, its immutable evidence and its predecessor, then either
verifies the transition's byte-identical nesting or replays the joint trace and
requires the stored payload exactly. SQL flow totals are audit evidence only; a
structurally valid but forged trace that reaches the database through the low-level
publisher is refused on recovery, not trusted.
Every profile-6 commit requires its evidence: a trigger refuses the generic, raw and
population publishers. History/census/migration readers refuse profile 6 explicitly
until 12.5d integrates them; the region host does not select it.
## Consequences and qualification
Joint ownership now survives process and worker replacement with exact replay,
retries and fenced authority, without changing any profile-4/5 byte or rule. The
nested ledger's flows remain complete; recorded environmental totals separate them
from migration flows for audit. Required evidence: durable bundle 9 -> 10 -> 11,
profile 4 -> 5 -> 6, transition retry/conflict/resolution, unadmitted interval
refusal, owned interval with matching SQL totals, conversion blocked by a pending
interval, settled conversion, cohort interval, bypass-publisher refusal, forged-flow
recovery refusal, the upgrade chain and legacy history-domain reconstruction.
Executable/network fault drills, census and migration integration, producers and
target-host qualification remain open.