Files
aevolution/schemas/ecology/scoped-cellular-census-set-v1.md
dingo 82568da9cd
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m22s
Foundation / checks (network) (push) Successful in 20m57s
Foundation / checks (client) (push) Successful in 22m5s
Foundation / checks (tsan) (push) Successful in 24m37s
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 45m14s
Foundation / checks (postgres) (push) Canceled after 45m8s
M12.6: add scoped multi-region cellular census queries
2026-10-18 15:11:51 -04:00

2.5 KiB

Scoped cellular census set, version 1

Semantic in-memory query contract under ADR-0152, not a persistent or wire codec. Portable implementation: server::CellularCensusSet.

Input names a world, frame, completed tick, owner format, rules and tick quantum, plus 1..64 nonzero strictly ascending required region IDs. Exactly one valid detached census must match each ID and every boundary field. Observations can arrive in any order; raw/exact-cohort classifications can differ. Construction refuses incomplete, extra, duplicate, foreign, stale or incompatible evidence. It returns no partial total on failure.

Shared genome IDs must carry the same complete immutable Genome value, including origin event, schema, development, parentage and capability parameters. All resident permanent organism IDs must be disjoint across observations. Full identity equality is checked, not just a short digest or genome parent list. This detects a source plus incoming ghost that both contain the same resident. Departed nonresident archive records are historical occurrences without stock.

Queries explicitly choose an exact genome or its descendant closure. An anchor unknown everywhere fails. A locally unknown anchor contributes zero only within the validated declared set, because every retained local genome includes all ancestors. Each region's resident categories and per-channel body/reserve are summed with overflow checks. Nonresident totals count record occurrences and can include repeated historical observations of one organism. They never imply remote viability, a unique population count or resident ownership.

Returned regional observations own detached copies sorted by region. No input biology changes, no ownership moves, and no tick advances. Source records count as owned until the paired commit; only that commit authorizes destination stock. Observing a candidate conveys no authority. Rejecting duplicate residents alone does not prove a consistent migration cut: source-after plus destination-before can omit a migrant without duplicating any identity.

The caller-declared list is not a durable complete world region catalog. There is no external branch identity, commit selection, permission decision, escrow reconciliation or terminal-extinction outcome. A zero is only a fact about these supplied observations. Persistence callers retain exact verified commit/page references separately. Same tick/world/frame alone does not reconcile branches or prove that all required owners, stores and viable reserves are covered.