Files
aevolution/docs/adr/0169-retained-plan-census-observations.md
T
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

56 lines
3.0 KiB
Markdown

# 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.