Files
aevolution/docs/biology/CELLULAR_POPULATION.md
T
dingo 0a8962b57e
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m28s
Foundation / checks (tsan) (push) Failing after 18m22s
Foundation / checks (network) (push) Successful in 20m38s
Foundation / checks (client) (push) Failing after 21m6s
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 46m54s
Foundation / checks (checks) (push) Canceled after 47m3s
M12.4: retain and settle owned population intervals
2026-10-17 17:31:05 -04:00

52 lines
3.3 KiB
Markdown

# Exact cellular local population
[ADR-0139](../adr/0139-exact-cellular-local-cohorts.md) defines the first rules-8
population owner. It owns one biological store and an exclusive representation
tag per cohort member; cohort inventory must never be added to `current_total`
again. Untagged living cells are individuals. Views are read-only.
`create` accepts a non-null rules-8 owner. `collapse(genome)` tags every eligible
zero-account member of that genome, excluding controlled cells. An absent
wildlife group or an ineligible wildlife presence rejects the conversion.
Repeating collapse returns zero without duplicating anything. `materialize`
removes all tags for that genome; an absent cohort is refused. Neither operation
changes the biological snapshot, identities, locations, ages or balances.
`advance_tick` takes exactly the sorted controlled set and optional controlled
mutation selections. It obtains every wildlife intention from the existing
controller, merges in life-ID order and uses the same atomic cellular kernel.
Failed input validation changes neither biology nor membership. Successful death
removes stale ownership tags; funded births begin as individuals. Suspension
continues to freeze controlled biology regardless of representation elsewhere.
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.
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
any nonsuspended controlled observer, collapses beyond 1800 um of all observers,
and retains membership in the intervening band. Biology always advances through
the same 50 ms kernel. Policy configuration, sequence, membership and complete
biology restore together; loading a checkpoint does not reselect members.
`conversion_candidate` leaves the predecessor intact and returns the complete
exact successor for fenced publication. Successful candidate creation and local
checkpoint file writes are not durable production acknowledgements. A dedicated
PostgreSQL adapter now uses dedicated profile 5 (ADR-0142), leaving raw profile 4
unchanged. ADR-0143 adds owned bounded unattended intervals. New entry and interval
publication require fully suspended controlled cells; active/lingering cells stay
on the existing raw path so permanent endings remain correct. Older recorded
traces remain verifiable. The selector is opt-in and off by default; see
[durable populations](../engineering/M12_DURABLE_POPULATIONS.md) and
[owned intervals](../engineering/M12_OWNED_POPULATION_INTERVALS.md) for evidence
and the remaining production qualification.
Run `evo-cellular-cohorts --verify` for the CTest matrix or omit the option for
8192 ticks per case. The executable compares complete canonical state every tick,
not just conserved totals. It reports observed conversion/member-tick coverage,
events, costs and 16/64/128/256-life active fallback observations. Shared fixture
setup is identical to the unchanged rules-8 reference; no alternate test biology
or altered golden is used.