feat(ecology): distinguish inherited plans in verified census
Foundation / checks (tsan) (push) Canceled after 0s
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 1m13s
Foundation / checks (client) (push) Canceled after 1m14s
Foundation / checks (postgres) (push) Canceled after 1m7s
Foundation / checks (deploy) (push) Canceled after 1m13s
Foundation / checks (ecs) (push) Canceled after 1m13s
Foundation / checks (network) (push) Canceled after 1m14s

This commit is contained in:
dingo
2026-10-19 15:06:47 -04:00
parent c60cdf8e19
commit dc7c0e1fa1
20 changed files with 492 additions and 23 deletions
+15
View File
@@ -1,5 +1,20 @@
# Project status and next steps
## Retained-plan census and verified history - 2026-10-19
[ADR-0169](adr/0169-retained-plan-census-observations.md) adds raw owner-8 census
projection 2. Expressed organisms/body/reserve retain their existing meaning;
separate living plan references preserve inherited diversity before any offspring
is born. Dead-plan records remain history. Exact/descendant/scoped queries and
committed history/registered snapshots retain the explicit projection boundary.
No extra inventory, redundant SQL journal or terminal extinction rule is added.
MSVC/GCC Release pass **90/90**. Clang-tidy, formatting, focused ASan/UBSan and
actual database history/capture checks pass; [validation](engineering/VALIDATION.md)
records scope. Old projection-1 plan measures remain unobserved. Population and
migration integration, in-life trait timing, birth-time control, NPC behavior,
client UI and remaining target-host/ecology/product gates still prevent M12 closure.
## Durable retained offspring plans - 2026-10-19
[ADR-0168](adr/0168-durable-retained-plan-admission.md)/schema 55 adds explicit
@@ -0,0 +1,55 @@
# ADR-0169: Retained-plan census observations
## Status and scope
Accepted read-only M12.6/12.7 integration for raw owner 8/rules 10, 2026-10-19.
Extends ADR-0150/0159 and ADR-0165/0168. No new biological rule, population or
migration admission, client permission, viable-store completeness or extinction
acceptance policy.
## Decision
Add census projection 2 for raw retained-plan owners. Keep projection 1 and its
old observed values for rules 8/9. Record the projection version in regional and
scoped boundaries; mixed projections/bodies/rules fail the complete set. Existing
recorded heads still require full canonical recovery and complete immutable
genome/resident identity checks before observation.
Resident organism counts, body and reserve remain grouped by expressed genome
and their existing five presence/representation kinds. Add separate per-kind
counts of living organisms retaining each offspring plan. These references own
no inventory and are not extra organisms or expressed archive carriers. Include
suspended controlled holders: logout cannot erase the retained plan. Also count
local corpse plan records separately as history, never reproductive stock.
Exact and descendant queries sum each measure independently with checked bounds.
An expressed parent can contribute resident stock to genome A and a plan
reference to genome B; do not add these counts together as population. A genome
with no expressed carrier can still have a living plan holder. A holder count is
not a guarantee of current reproductive capability, funded birth or survival.
Dead-plan and retained-nonresident history do not supply current viability.
Projection-1 plan fields are unobserved (zero defaults), distinguished by the
boundary version; do not interpret them as measured absence. Projection 2 uses
the exact new owner references/history. All other unsupported owner/profile
combinations still refuse. No terminal extinction API is added.
Verified regional history and scoped/registered snapshots propagate the explicit
projection boundary. Missing, stale, false or mixed evidence fails the entire
query; there is no skip/zero fallback. No additional SQL census journal or source
of authority is introduced. Cross-domain/other-store viability and durable
accepted reconciliation remain subsequent M12.7 work.
## Alternatives, consequences and qualification
Treating a plan as an expressed carrier invents stock. Ignoring it can falsely
erase heritable diversity. Changing projection 1 silently loses compatibility.
Separate versioned reference counts preserve both biological and accounting
meanings at bounded observation cost.
Require unexpressed selected plans with zero inventory/carriers, funded children,
later plans leaving existing children unchanged, logout/resume, terminal death
and retained dead references. Verify exact/descendant/scoped sums, restore and
detachment, old projection controls and complete inventory closure. Qualify the
new observations through actual committed replay/history and registered snapshot
capture; preserve old projection values and all historical goldens.
+2
View File
@@ -1,5 +1,7 @@
# Architecture decision records
- [ADR-0169: Retained-plan census observations](0169-retained-plan-census-observations.md) - raw owner-8 projection 2 separates expressed resident stock from living offspring-plan references and dead-plan history; verified history and registered capture retain exact boundaries.
- [ADR-0168: Durable raw retained-plan admission](0168-durable-retained-plan-admission.md) - schema 55, explicit raw bundle-11 -> 12 fenced upgrades and trace-4 mutation/birth publication with exact recovery; no automatic opening or population admission.
- [ADR-0167: Explicit retained-plan checkpoint upgrade](0167-retained-plan-checkpoint-upgrade.md) - portable raw-only bundle 12 and exact no-tick bundle-11 source transformation; SQL/durable admission and population support remain separate.
+8 -5
View File
@@ -48,13 +48,16 @@ earlier children keep their original form. Save/reload retains plan selections
and dead-parent history, and logout freezes the controlled parent's biology.
This scoped mode edits inherited plans only. The future operator catalog still
needs to distinguish traits that can also change during an existing life. Existing
durable bundles, census, population and migration refuse the new owner until
their plan semantics are qualified. [Trace 4](../../schemas/cellular-region-batch-v4.md)
needs to distinguish traits that can also change during an existing life.
Population and migration still refuse the new owner. [Trace 4](../../schemas/cellular-region-batch-v4.md)
supplies portable replay and inherited-offer action matching; old traces refuse
this owner. [Bundle 12](../../schemas/cellular-inheritance-upgrade.md) supplies
its portable raw checkpoint and exact retained-source upgrade; SQL publication
is still separate. The birth-time control choice,
its raw checkpoint and exact retained-source upgrade. ADR-0168/schema 55 now
admits explicit fenced raw upgrades, durable plan selections/births and full
recovery. [Census projection 2](../../schemas/ecology/regional-cellular-census-v2.md)
separates living plan references from expressed bodies/reserves and retains dead
plan records as history. A plan reference owns no stock and promises no funded
offspring or survival. The birth-time control choice,
persistent NPC behavior and UI remain unimplemented; default/DEV rules do not
opt into this owner.
+4 -1
View File
@@ -23,7 +23,10 @@ behavior remains. [ADR-0167](../adr/0167-retained-plan-checkpoint-upgrade.md) de
the portable raw checkpoint tuple and exact retained-source upgrade.
[ADR-0168](../adr/0168-durable-retained-plan-admission.md) adds schema 55,
explicit fenced raw admission, plan selections and repeated funded births with
complete source/target recovery. Population/migration/census admission, the
complete source/target recovery. [ADR-0169](../adr/0169-retained-plan-census-observations.md)
qualifies raw census projection 2 through committed history and registered
snapshots, with separate living plan holders and dead-plan history rather than
invented expressed carriers or stock. Population/migration admission, the
in-life expression catalog, authority
handoff and NPC/UI integration are still required.
+59
View File
@@ -1,5 +1,64 @@
# Validation report
## 2026-10-19 - Retained-plan census projection 2 and committed observations
[ADR-0169](../adr/0169-retained-plan-census-observations.md) and the
[projection contract](../../schemas/ecology/regional-cellular-census-v2.md)
separate living plan holders and dead-plan history from expressed organisms and
inventory. Regional/scoped boundaries carry the projection version. Existing
history and registered capture fully reconstruct their cuts before observation;
no new SQL schema or census journal is added.
Executed locally:
- MSVC 19.44 Release full CTest **90/90, 23.07 s**, outside the filesystem
sandbox. The first resumed sandbox run passed 88/90 and failed its two
hard-link fixtures with access denied; the unrestricted full rerun passed.
- GCC 14.2 Release full CTest **90/90, 17.84 s**, with NDEBUG.
- Clang 19.1/clang-tidy 19 focused projection test **1/1, 6.92 s** and repository
format check passed.
- Clang 19.1 ASan/UBSan retained-plan owner, new census and legacy census
**3/3, 89.62 s**, without reports.
- Clang 19.1/clang-tidy 19 private database population suite **56 s total**;
Clang ASan/UBSan equivalent **114 s total**, without reports. Both include
the new committed-history/registered-capture integration and the existing
raw/cohort, interval, atomic migration and registered coverage/fault controls.
- GCC 14.2 persistence consumers rebuilt and the same private population suite
passed **38 s total**, including both committed plan-census observations.
Tests earn a structural offspring plan through actual feeding/selection. Before
birth the plan has zero expressed carriers/stock and one living holder. Real
funded births express the plan; a subsequent lower-ID plan leaves earlier
children unchanged. Exact and descendant measures, per-kind sums, local corpse
history, actual death, logout/suspension, detached observations and restore
retain their separate meanings. The total resident count/body/reserve equals
the biological owner and total living holders equals living local organisms.
Two-region queries reject a mixed projection boundary. Legacy projection 1
retains old values and unobserved zero-default plan fields; no golden changes.
The database fixture selects a real plan, publishes result 4 and reconstructs
the exact selected head through history and registered capture. After repeated
births and replacement authority it repeats the comparison with direct
observation. Same-tick upgrade history retains projection 2 and its original
head/tick. An unavailable retained build refuses the complete registered query.
Generic historical replay, coverage and migration evidence checks remain active.
These are read-only engineering observations. No plan-holder count promises
funded reproduction, survival or global viable-store completeness. Population,
migration, other stores/clone domains, accepted extinction/freshness, client
permissions and target-host query costs remain separate work. No player UI,
actual-days ecology, live deployment or M12 completion is claimed.
Visual review used the existing 2026-10-17 `build/m12-ui-review` renders of the
compact HUD and evolution panel; these are retained review artifacts, not newly
captured screens. The current evolution panel describes changing the existing
cell. Retained-plan selection needs an explicit versioned presentation before
player exposure; this segment changes no UI or live/default biological opening.
The census push refreshes the DEV window to **2026-10-19 23:06:09 UTC**. Its
exact staged deployment policy passes with 138 objects rendered across 17
overlays and zero failures. This is no assertion of deployed reachability.
## 2026-10-19 - Durable raw retained-plan admission
[ADR-0168](../adr/0168-durable-retained-plan-admission.md)/schema 55 adds the