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
56 lines
3.0 KiB
Markdown
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.
|