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
69 lines
4.0 KiB
Markdown
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.
|