4.0 KiB
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.