Files
aevolution/docs/adr/0150-regional-cellular-census-projection.md
T
dingo a180c41ae7
Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (ecs) (push) Successful in 2m25s
Foundation / checks (network) (push) Successful in 20m50s
Foundation / checks (client) (push) Successful in 22m7s
Foundation / checks (tsan) (push) Successful in 24m42s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 35m33s
Foundation / checks (checks) (push) Canceled after 35m43s
M12.6: derive replayed census history from immutable commits
2026-10-18 14:36:14 -04:00

69 lines
4.0 KiB
Markdown

# ADR-0150: Regional cellular census projection
## Status
Accepted for scoped M12.6a engineering implementation, 2026-10-18. This implements
a read-only local projection under ADR-0133, not durable population-history
publication, a complete world evidence envelope or terminal extinction.
## Context and decision
ADR-0144 retains departed organisms as known-alive archive records. Summing
`LineageArchive::living_carriers` across regions therefore duplicates migrants.
The exact population owner also contains both active and cohort members in one
store; counting that store and membership tags as separate organisms duplicates
stock. Suspended players remain living even when no organism is progressing.
Add a bounded, detached `CellularCensus` projection of a valid rules-8 raw owner
(format 6/7) or exact population (envelope 1/2). Record world, region, frame,
completed tick and owner/rules/population versions. This observation has no lease,
commit digest or recovery-branch proof: observing an uncommitted candidate does
not grant it durable authority. A later adapter must bind a verified committed
payload and its exact history context before publishing evidence.
Retain every locally archived genome in ascending ID order, including zero-carrier
ancestors, with its immutable parents and schema/development versions. Add a const
archive genome span for bounded enumeration; successful genome admission invalidates
that view. No removal or mutable archive access is added.
Each row partitions resident living stock into five disjoint categories: individual
wildlife, exact cohort wildlife, active controlled, lingering controlled and
suspended controlled. Each category reports count, body and reserve in existing
pJ/C/N/P/other-fg units. Membership tags only classify the existing owned lives.
Corpses, food, nursery, heat and cumulative boundary flows are not living stock.
Retained nonresident archive records are a separate historical count without owned
inventory or current-viability meaning. Frozen source stock counts until paired
commit; an uncommitted destination ghost supplies no authoritative observation.
Queries explicitly choose exact-genome carriers or the anchor's descendant
closure. Use the retained parent graph, bounded iterative traversal and checked
channel/count addition. Unknown anchor or unsupported versions fail; they do not
become zero. A zero result is a fact about this particular regional observation,
never world absence, species classification or terminal extinction.
## Alternatives, costs and qualification
Archive-only counting is invalid after migration; cohort-count addition violates
exclusive ownership. Scanning integer IDs up to an allocator high-water mark is
unbounded for sparse identities. Enumerate at most 4,096 retained genomes and
256 resident lives, retaining at most 65,536 historical nonresident records.
Build child adjacency once and visit each descendant at most once per query;
do not recurse on ancestry depth or inspect wall time.
Require active/lingering/suspended separation, real funded wildlife, conversion
invariance, full restore reproducibility, mutation-current versus birth genomes,
zero-carrier ancestry retention, death exclusion, sparse identities and migration
ownership before/after/return. Compare resident counts and per-channel body/reserve
against direct individual observations. No biological rule, codec/golden, database,
network, renderer, foundation dependency, automatic selector or deployment changes.
Durable append-only census/history with atomic commit binding, bounded backend
queries, branch/epoch/watermark reconciliation and client presentation remain
subsequent M12.6/12.7 work. Linked ecological resources and the rules-8 maturation
gap remain open independently of this observational primitive.
Follow-on ADR-0151 implements regional commit-bound history reads using the
existing immutable biological journal as canonical events, without a second
census-write window. Full world/branch reconciliation and client presentation
remain separate from both primitives.