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

This commit is contained in:
dingo
2026-10-18 13:57:52 -04:00
parent df680810af
commit da39fc8095
17 changed files with 757 additions and 4 deletions
+16
View File
@@ -1,5 +1,21 @@
# Project status and next steps
## M12.6a bounded regional census and history queries - 2026-10-18
The portable census now distinguishes resident individuals/cohorts and
active/lingering/suspended controlled lives, retaining exact body/reserve stock
and zero-carrier ancestry. Exact-genome and descendant queries use current carried
genomes. Retained departed history never counts as resident stock; migrations and
return trips retain that distinction without changing biology.
Native Release passes **79/79**; GCC census/lineage/migration contracts, relevant
ASan/UBSan checks, Clang analysis and formatting pass.
[Evidence and limits](engineering/VALIDATION.md) retain durable atomic history
publication, commit/branch binding, complete world reconciliation and client
presentation as subsequent M12.6/12.7 work. This local projection grants no
terminal-extinction or ghost ownership authority. Linked ecology, maturation and
later integration/soak gates remain open; no deployment or World0 change.
## M12.4l local migration storage failures - 2026-10-18
The private matrix now refuses preparation, staging or paired publication after
@@ -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.
+2
View File
@@ -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.
@@ -5,6 +5,12 @@ M12.1 defines evidence and explicit deferrals. The evidence contract is
[identity-and-time-v1](../../schemas/ecology/identity-and-time-v1.md); it is not
an implemented codec or world extinction service.
M12.6a implements [ADR-0150's bounded regional census](../adr/0150-regional-cellular-census-projection.md).
It reports local resident stock by current genome and exact/descendant scope,
including suspended players; retained nonresident records carry no owned stock.
This detached observation has no commit/branch binding or world coverage and
does not implement the global evidence envelope or terminal extinction below.
## Identity and classification
An organism has a permanent identity and terminal death. An immutable genome has
+3 -3
View File
@@ -4,16 +4,16 @@ Requested scope: ecological identity, population qualification, durable automati
tier transitions, unattended scheduling/migration and environmental coupling.
Commit and push each validated scoped segment separately.
## Gate status (2026-10-17)
## Gate status (2026-10-18)
| Subset | State | Evidence or condition for completion |
|---|---|---|
| 12.1 | Engineering evidence policy and explicit deferrals documented | ADR-0133, identity/time contract and worked histories; no new game rules or runtime versions. |
| 12.2 | Exact local model selected and paired qualification implemented (12.2d); production cost gate open | ADR-0139, exact canonical equality across 196,608 paired ticks per platform. Regional approximation disabled; no compression claim. Deployment-host capacity and fuller interaction coverage remain open. |
| 12.3 | Exact population profile/trace/store and opt-in host integration implemented (12.3b) | ADR-0142, schema 44; exact publication/recovery, mutation race guards, ambiguous replies and process kills. Executable/network population fault drills and target-host qualification remain open. |
| 12.4 | Unattended demand/pacing plus owned population interval admission/recovery implemented (12.4b) | ADR-0143/schema 45; bounded durable pending work, exact settlement, replacement-owner and uncertainty tests. Biological migration escrow and boundary/stock-in-transit evidence remain open. |
| 12.4 | Owned intervals and durable paired migration/fault qualification implemented in scoped segments through 12.4l | ADR-0143–0149/schema 49; bounded admitted work, source freeze, staged ghost, atomic pair and exact recovery, local TLS and storage faults. Multi-host/orchestrator, linked ecology and integrated stock audits remain open. |
| 12.5 | Blocked on 12.2-12.4 | Finite M6 process fixtures do not qualify coupled persistent cellular/cohort atmosphere/water budgets. |
| 12.6 | Existing local archive retained; integrated population history open | World-level durable event/query/client path remains required. |
| 12.6 | Local archive plus regional resident/presence/cohort census and exact/descendant queries implemented (12.6a) | ADR-0150; local detached observations exclude departed history from stock. Commit/branch binding, atomic durable events and world-level query/client path remain required. |
| 12.7 | Evidence policy defined; reconciler open | Complete durable world watermark and every viable/in-flight store remain required. |
| 12.8 | Not qualified | Actual multi-day integrated ecology/restart/clone evidence remains required. |
| 12.9 | Not accepted | Returning-player product evidence and expansion review remain required; World0 stays separately blocked. |
+9 -1
View File
@@ -27,7 +27,7 @@ or authorize production enablement.
| 12.3 | Dedicated population profile/trace/store/owning host; exact recovery and private PostgreSQL fault tests | Population-specific executable/network fault drills and target-host publication/capacity qualification. |
| 12.4 | Owned intervals; exact transfer/accounting; durable atomic pair/recovery; independent loopback TLS path loss and owner expiry/replacement/heal; local object sync/read-failure matrix | Multi-host/kernel-network, storage-host and orchestrator drills, linked-boundary contracts and integrated ownership/stock audits at scale. |
| 12.5 | Finite cellular contact feeding/decay and separate M6 producer/consumer resource owner | One jointly owned cellular/environment budget, explicit effective depth and source entitlements, versioned water/atmosphere species mapping and producer coefficients, plus closed/open and nutrient-exhaustion comparisons. |
| 12.6 | Retained genome/organism archive with ancestry and common-ancestor queries | Append-only population census/history events in the same durable commit, bounded world history queries/indexing and client presentation; no account power or invented precise statistical ancestry. |
| 12.6 | Retained archive plus bounded regional resident/presence/cohort census and exact/descendant queries (12.6a) | Append-only population census/history events in the same durable commit, bounded world history queries/indexing and client presentation; no account power or invented precise statistical ancestry. |
| 12.7 | ADR-0133's viability/unknown semantics | Durable region-set/watermark reconciliation covering every owned representation, suspended/viable stock and migration escrow. Missing/stale regions must prevent terminal extinction. |
| 12.8 | Deterministic seed/regime drivers and separate-process exact continuation | Reproducible integrated worlds running for actual days, real restarts/clone comparisons and retained accounting/diversity/cost audits. Accelerated tests cannot supply elapsed days. |
| 12.9 | M11 feedback and current UI review retained | Returning-player samples on the integrated ecology and explicit product/3D readiness decision after soak evidence. No M12 product acceptance or World0 promotion is inferred. |
@@ -94,6 +94,14 @@ Finite extra food alone does not close repeated wildlife generations. A versione
growth contract and real multi-generation evidence remain necessary; transfer
tests must not fabricate adult wildlife or silently change the rules to pass.
M12.6a's [regional census projection](../../schemas/ecology/regional-cellular-census-v1.md)
independently implements local current-genome and descendant-closure queries.
It keeps suspended stock and retained zero-carrier ancestry, separates exact cohort
tags from additional ownership, and excludes nonresident history from living stock.
It has no commit/branch/epoch binding or complete world coverage, so it cannot
publish authoritative world history or accept terminal extinction. Durable atomic
history publication and M12.7 reconciliation remain the next history boundaries.
Current expansion readiness: **no-go for M13 integration or World0 promotion**
while these M12 integration/evidence gates remain open. This records the present
engineering evidence, not a substitute for the later maintainer product review.
+12
View File
@@ -1,5 +1,17 @@
# Validation strategy
M12.6a's regional census tests compare per-category counts and body/reserve
inventories with direct individual observations. Cover active/lingering/suspended
controlled lives, real funded wildlife, exact cohort conversion/restoration,
permanent death and empty owners, all 256 resident slots, mutation-current versus
immutable birth genomes, zero-carrier ancestry and sparse IDs whose numeric order
differs from ancestry. Unknown anchor/scope and older biological rules must fail.
Existing migration tests additionally verify nonresident historical counts,
per-member migrant inventory, repeated return trips and imported cohort tags.
Full native regression and relevant ASan/UBSan/Clang checks qualify this portable
projection; durable commit-bound history, complete world coverage and client
queries remain separate M12.6/12.7 gates. No terminal-extinction outcome exists.
M12.4f's checkpoint contract exercises explicit portable bundle-9 to 10 upgrades
for raw owners and a real nonempty cohort with retained policy/sequence. It
requires complete candidate equality, canonical restore, continued batch-2
+50
View File
@@ -1,5 +1,55 @@
# Validation report
## 2026-10-18 - M12.6a bounded regional census and lineage queries
ADR-0150 adds a detached rules-8 regional projection, with explicit presence and
representation categories, per-channel living body/reserve stock, exact/current
genome and descendant-closure queries, zero-carrier retained ancestry and separate
nonresident historical counts. A const archive genome span permits bounded sparse
enumeration without a scan to the largest ID. No archive removal/mutable access,
biological rule, persistent codec or database publication is added. See the
[projection contract](../../schemas/ecology/regional-cellular-census-v1.md).
Executed locally:
- Native MSVC Release full CTest **79/79 passed**, **13.97 s**, with NDEBUG.
- GCC 14 Release census, lineage and migration contracts **3/3 passed**, **2.45 s**,
including the final funded two-step mutation ancestry case and NDEBUG checks.
- Linux Clang 19 ASan/UBSan lineage, population, census and migration contracts
**4/4 passed**, **76.78 s**, without reports. After the final ancestry/sentinel
test addition, the census sanitizer test passed again, **21.66 s**.
- Explicit clang-tidy 19 on the implementation and census/lineage/migration tests
passed with no owned warnings; repository clang-format 19 and `git diff --check`
passed. No new warning suppression was added.
Direct individual observations independently check category counts and every
body/reserve channel. Actual funded mutations distinguish immutable birth and
current genomes; the grandchild's sparse ID is numerically below its parent's.
Exact-genome zero retains its ancestor while a descendant query finds the living
successor. Active, lingering and suspended controlled stock stays distinct.
Real wildlife collapses/materializes without a second inventory; cohort restore
reproduces the same rows. Death leaves history but no living count. Empty worlds,
all 256 resident slots, unknown anchors/scopes and unsupported legacy rules are
covered. Migration tests audit departed historical records, exact individual
migrant inventories, 100 return transfers and imported envelope-2 cohort tags.
Initial test setup incorrectly supplied zero capacity to the shared empty-opening
fixture; it now provisions positive capacity with no births. The first direct
analysis invocation lacked CMake-generated module scan maps. A separate scan-free
Clang compilation database resolves that tooling issue. An explicit named invalid
scope sentinel replaces the analyzer's rejected out-of-range literal test cast;
the API still rejects every scope other than exact or descendants.
Limits: this is a portable in-memory observation, not a durable historical event,
committed evidence envelope, client query service or globally complete census.
No commit/epoch/branch/watermark binding or terminal-extinction outcome exists.
Archive capacities bound the algorithm; maximum-depth history performance on the
deployment host is not measured here. No new PostgreSQL, TSan, Docker or remote-CI
result is claimed; no thread or I/O path is introduced. Goldens and retained
biological formats are unchanged. Linked ecology/maturation, durable history,
world reconciliation and actual elapsed-day soak remain open. No deployment or
World0 action; unrelated `Build_Errors.txt` and `tash drop` remain untracked.
## 2026-10-18 - M12.4l migration object sync/read failures
Test-only qualification extends ADR-0147–0149 using the existing filesystem