M12.6: add bounded regional cellular census and lineage queries
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m33s
Foundation / checks (network) (push) Successful in 21m15s
Foundation / checks (client) (push) Successful in 22m8s
Foundation / checks (tsan) (push) Successful in 25m2s
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 38m24s
Foundation / checks (postgres) (push) Canceled after 38m24s
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m33s
Foundation / checks (network) (push) Successful in 21m15s
Foundation / checks (client) (push) Successful in 22m8s
Foundation / checks (tsan) (push) Successful in 25m2s
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 38m24s
Foundation / checks (postgres) (push) Canceled after 38m24s
This commit is contained in:
@@ -0,0 +1,63 @@
|
||||
# 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.
|
||||
@@ -1,5 +1,7 @@
|
||||
# Architecture decision records
|
||||
|
||||
- [ADR-0150: Regional cellular census projection](0150-regional-cellular-census-projection.md) - bounded local resident/representation/presence census and exact/descendant queries; retained nonresident history never counts as owned stock or world extinction.
|
||||
|
||||
- [ADR-0149: Atomic paired biological migration publication](0149-atomic-cellular-migration-publication.md) - schema 49 binds both current fences, heads and exact candidates in one immutable receipt/transaction; recovery replays the pair and hosts verify the changed head before readiness.
|
||||
|
||||
- [ADR-0148: Durable destination staging without activation](0148-durable-cellular-migration-staging.md) - schema 48 freezes the destination at its exact cut, retains a verified read-only ghost and replays it on recovery; source abort releases both pauses.
|
||||
|
||||
Reference in New Issue
Block a user