feat(lifecycle): preserve inherited plans in exact populations
Foundation / checks (ecs) (push) Successful in 2m26s
Foundation / checks (deploy) (push) Successful in 4m57s
Foundation / checks (network) (push) Successful in 20m53s
Foundation / checks (client) (push) Successful in 22m12s
Foundation / checks (tsan) (push) Successful in 39m45s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 45m41s
Foundation / checks (checks) (push) Canceled after 45m43s

This commit is contained in:
dingo
2026-10-19 15:19:43 -04:00
parent fad79973e2
commit a898a35e1b
22 changed files with 582 additions and 36 deletions
+15
View File
@@ -1,5 +1,20 @@
# Project status and next steps
## Portable retained-plan exact populations - 2026-10-19
[ADR-0171](adr/0171-retained-plan-exact-populations.md) adds envelope/batch 3 for
owner 8/rules 10. An explicit no-tick inheritance candidate preserves the exact
membership, policy and sequence. Raw/cohort execution agrees through earned
structural plans, paid children, later selections, suspension, conversion and
recorded unattended intervals. Projection 2 keeps cohort plan references separate
from expressed stock. Old envelopes/traces and all goldens retain their meaning.
Both full Release suites pass **92/92**. Final focused tests, analysis, formatting
and ASan/UBSan pass; fresh-process MSVC/GCC output bytes agree.
[Validation](engineering/VALIDATION.md) records exact evidence. Durable population
admission, migration, linked resource ownership, control/NPC/UI and operational/
actual-days/product gates remain open. No default/live version changes.
## Explicit DEV worker placement - 2026-10-19
[ADR-0170](adr/0170-dev-worker-placement.md) implements the maintainer's worker
@@ -0,0 +1,57 @@
# ADR-0171: Retained-plan exact populations
## Status and scope
Accepted portable M12 population integration, 2026-10-19. Extends
ADR-0139/0140/0165/0169. No approximate aggregation, durable admission, automatic
upgrade, cross-region migration, new controller or live/default rule change.
## Decision
Population envelope 3 (`AEVOPOP3`) contains exactly owner 8/rules 10. Retain the
existing header/member layout, complete nested biological snapshot, policy and
conversion sequence. Membership still tags whole eligible wildlife groups by
their **expressed** genome. It never groups away or replaces individual offspring
plans, revisions, body/reserve, age, growth or identity. References own no stock.
An explicit detached no-tick envelope-2/rules-9 inheritance upgrade preserves all
tags, policy and sequence while invoking the exact nested owner upgrade. Old
envelopes retain their precise meaning and reject the new nested owner. Repeated
and skipped upgrades refuse. A raw inherited owner can be wrapped portably; that
does not authorize a database profile transition or create durable ownership.
Population batch 3 (`AEVOPBT3`) pairs only with envelope 3 and nested raw trace 4.
Keep the existing bounded recorded intentions and exact membership boundaries.
Unattended intervals still require fully suspended controlled cells, frozen-only
controlled intentions and no birth requests or mutation selections. Wildlife
uses its unchanged shared controller during recording and retained intentions
during replay. Real funded wildlife births inherit their stored plans through
the same kernel; tags own no additional organisms or inventory. No controller
rerun, resampling, or restoration-time policy evaluation is introduced.
Projection 2 additionally supports envelope 3. Tag classification determines the
existing resident and plan-holder kind independently of the expressed/plan genome
row. Raw and cohort observations may share an exact owner/rules/projection cut.
Living plans remain references, dead plans history, and unsupported evidence
never supplies terminal extinction. Projection 1 retains its old domain.
## Alternatives, consequences and qualification
Reusing envelope 2 would reinterpret its nested-format contract. Grouping by an
average plan discards inherited diversity; treating plan references as members
invents organisms. Exact retained members avoid both errors, without a speedup
or compression claim. The existing capacity ceiling and disabled policy default
remain; target-host cost is still unqualified.
Require real earned structural plans and funded children, unchanged expressed
parents, subsequent plan changes, active and suspended raw/cohort equality,
whole-group conversion, exact per-kind census, snapshot/trace restoration,
mid-interval refusal and fresh-process continuation. Mutated outer versions,
wrong raw trace pairings, altered membership boundaries and controlled activity
must refuse without changing the source. Preserve all old goldens. Qualify
Release/NDEBUG, clang-tidy, formatting and relevant ASan/UBSan before committing.
SQL and checkpoint population mappings remain unchanged. New envelope/trace
readers alone cannot publish or migrate this owner. A later durable segment must
bind its exact tuple, upgrade, trace and recovered result through existing
fences/journals, with faults and retries, before population publication is admitted.
+2
View File
@@ -1,5 +1,7 @@
# Architecture decision records
- [ADR-0171: Retained-plan exact populations](0171-retained-plan-exact-populations.md) - portable envelope/batch 3 preserve every member's expressed/heritable state, exact conversion/policy replay and projection-2 plan counts; durable admission remains separate.
- [ADR-0170: Explicit DEV worker placement](0170-dev-worker-placement.md) - required control-plane/master exclusion for DEV workloads in full and standalone overlays, with rendered-policy regression checks; no live-placement claim.
- [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.
+9
View File
@@ -23,6 +23,15 @@ The model retains exact members and makes no aggregation speedup claim. There is
no regional population approximation or biological cross-region migration.
The existing 256-life ceiling remains; target-host service capacity is separate.
[ADR-0171](../adr/0171-retained-plan-exact-populations.md) extends the portable
owner to retained-plan rules 10/owner 8 using envelope 3 and population batch 3
(nested raw trace 4). An explicit envelope-2/rules-9 inheritance candidate retains
tags, policy and sequence. Each member keeps its complete expressed body and
offspring plan; grouping by expressed genome never erases plan differences.
Projection 2 observes cohort plan holders separately from owned stock. Durable
population mappings/admission and biological migration remain separate work;
there is no automatic live upgrade, approximation or compression claim.
M12.3 adds [population envelope 1](../../schemas/cellular-population.md), detached
conversion candidates and an opt-in automatic policy (ADR-0140). The default
remains disabled. The policy materializes whole genome groups within 1200 um of
+4 -1
View File
@@ -26,7 +26,10 @@ explicit fenced raw admission, plan selections and repeated funded births with
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
invented expressed carriers or stock.
[ADR-0171](../adr/0171-retained-plan-exact-populations.md) adds portable exact
population envelope/batch 3, retained membership/plan state, raw/cohort equality
and projection-2 cohort counts. Durable population/migration admission, the
in-life expression catalog, authority
handoff and NPC/UI integration are still required.
+52
View File
@@ -1,5 +1,57 @@
# Validation report
## 2026-10-19 - Portable retained-plan exact populations
[ADR-0171](../adr/0171-retained-plan-exact-populations.md) adds explicit envelope
3 and population batch 3/nested raw trace 4. Every member retains its complete
expressed/heritable state; the no-tick inheritance candidate preserves policy,
sequence and tags. Projection 2 separately counts cohort plan references and
expressed stock. Existing checkpoint/SQL population allowlists are unchanged.
Executed locally:
- MSVC 19.44 Release full CTest **92/92, 29.63 s** and GCC 14.2 Release full
CTest **92/92, 19.99 s**, with NDEBUG. The final additional conversion and
automatic-policy proofs passed **2/2, 2.82 s** on MSVC and **2/2, 1.80 s**
on GCC. Only these tests changed after the full runs; production sources did not.
- Clang 19.1/clang-tidy 19 new population/restart and census **3/3, 21.17 s**.
Final expanded population/restart tests **2/2, 15.22 s**; format check passed.
- Clang 19.1 ASan/UBSan population/restart, inherited owner and census
**4/4, 108.71 s**, without reports. Final expanded population/restart proofs
**2/2, 48.62 s**, without reports.
- GCC 14.2 persistence consumers rebuilt and the private population/fault suite
passed **37 s total**. Existing raw/cohort, interval, migration and registered
history behavior passes; schema 55 still refuses retained-plan population
publication/profile conversion. No new SQL admission was inferred from readers.
The fixture creates a real funded legacy child and whole-group cohort before
upgrading. It compares the complete nested state and outcomes with an independent
raw continuation every tick through two earned structural plans, funded children,
offline suspension and 64-tick intervals. Manual conversions encode/replay exact
membership without changing biology; automatic policy with a fully suspended
observer collapses every actual wildlife member and replays the same boundaries.
Census equality after normalizing only the representation category preserves all
per-genome stock and independent plan/dead-history measures. A suspended selected
plan still has one holder and zero expressed stock before birth.
Tests refuse old/unknown outer versions resealed with a valid checksum, truncated
envelopes, old raw trace pairings, changed membership boundaries, repeated upgrade
and active-controlled unattended admission. Source bytes remain unchanged on
detached preparation/refusal. Fresh-process full-population continuation is exact;
MSVC/GCC expected output shares SHA-256
`818824b44bb4475177c04492ff07df4b657d3370c90d96cf7ab6ac84f9b1d297`.
An initial test incorrectly used an already populated opening and failed its
empty-input genesis tick. The fixture now explicitly requests an empty opening;
no biological rule or golden was changed to make it pass.
This retains exact individuals and makes no compression, throughput or target-host
cost claim. Database admission, cross-region migration, producer/resource coupling,
control succession/NPC behavior/UI and actual-days/product qualification remain
separate. No new service, default/DEV opening, live upgrade or World0 operation.
The refreshed population-segment DEV window expires **2026-10-19 23:19:02 UTC**.
Rendered deployment policy passes with 138 objects across 17 overlays and zero
failures. A successful push does not establish deployed reachability.
## 2026-10-19 - Explicit worker-only DEV scheduling
[ADR-0170](../adr/0170-dev-worker-placement.md) applies required negative