Files
aevolution/docs/adr/0169-retained-plan-census-observations.md
dingo dc7c0e1fa1
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
feat(ecology): distinguish inherited plans in verified census
2026-10-19 15:06:47 -04:00

3.0 KiB

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.