Files
aevolution/docs/adr
dingoandClaude Opus 5 55a728acd4 Make who breeds part of the rule, so the divergence is attributable
The two runs allocated contested breeding slots in different orders: the
individual run by member insertion order, the aggregate run by stored class order,
which is youngest first. When eligible parents outnumber free slots that decides
which parents reproduce, for a reason that has nothing to do with averaging. The
control never reached the capacity boundary and so could not see it, which left
ADR-0040's central claim unsupported rather than merely imprecise.

The allocation order is part of the stated rule now, oldest first, honoured at both
resolutions: classes partition ages, so the oldest class holds the oldest members,
and ordering inside a class stays something only the individual run can see, which
is a resolution effect rather than an implementation difference.

A second control sits at the capacity boundary, twelve eligible parents contending
for one free slot, and both controls compare the whole distribution of members
rather than censuses. That change matters by itself: whoever breeds hands the same
investment to a child either way, so every total agrees while the distribution does
not, and a census-only control cannot see a different parent having bred. The
probe diverging only by tick 44 is that effect.

Attribution was verified by mutation rather than argued. Restoring the individual
run's insertion order fails the new control; restoring the aggregate run's
youngest-first order fails it; the earlier one-unit drift in aggregate upkeep still
fails the first. Since either allocation order alone fails, the reported divergence
is attributable to averaging.

My first attempt at the control was wrong and the same sweep caught it. I gave the
contested fixture ages descending with the index, reasoning that this made
insertion order differ from age order; it does the opposite, and the
individual-side mutation passed. Ages ascend now, so oldest-first disagrees with
both the insertion order and the stored class order. Without the sweep the new
control would have looked like it established attribution while covering half of
it.

Also added the depletion check the ADR's attribution argument relies on: a shared
store that ran out would make intake order-dependent too. I had written that the
fixture asserts this before it did, which is now true.

The measurements were regenerated and are unchanged. Saying so plainly rather than
as confirmation: the finding was about what the numbers can be attributed to, not
about their values.

Release 38/38, analysis, ASan 38/38 and clang-format all ran and passed here.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-25 07:21:55 -04:00
..

Architecture decision records

Locked requirements outrank these records. Review architecture, ADRs, public contracts, tests, then implementation. Stop expanding implementation on conflict.

Adopted for proof applies only to the bounded initial headless slice. Proposed recommends without adopting a dependency. Deferred requires a named experiment. Later Accepted and Superseded preserve rationale. Proof choices do not silently settle gameplay or production infrastructure.

Records 0001–0015 cover language, build, dependencies, tests/benchmarks, ECS, ticks, randomness, serialization, units, errors, threads, logging, PostgreSQL, messaging and metrics. 0016–0019 cover durability/ownership, networking/security, infrastructure and voxels. 0020 scopes Gitea delivery and the stateless dev Job. Each record has the eight required sections. 0021 authorizes the opt-in ECS comparison only, not a production dependency. 0022 adopts the bounded sequential lifecycle-command scheduler for the proof. 0023 defines local periodic neighborhood queries and a measured linear baseline. 0024 adopts finite, typed energy/matter inventory transfers for M2.1. 0025 scopes finite capture, growth recipes and residual accounting for M2.2. 0026 adds shared community ownership and bounded synthetic feeding for M2.3. 0027 adds terminal inventory ownership and budgeted nutrient return for M2.4. 0028 adopts funded reproduction, bounded slot capacity and retained lineage IDs. 0029 scopes the deterministic ecosystem driver and bounded measured episodes. 0030 adopts the immutable genome v1 record, validation and canonical encoding. 0031 adopts deterministic development, derived phenotype and bounded plans. 0032 derives non-uniform metabolic budgets and the first genome/ledger path. 0033 adopts the bounded mutation catalog and uniform seeded candidate draws. 0034 adopts the permanent lineage archive and absence that is never extinction. 0035 derives strategies from genomes and measures them over a split-half gradient. 0036 defines the tier 2 cohort, its declared resolution and exclusive ownership. 0037 collapses individuals into a cohort as one sampled, ledger-exact transaction. 0038 accounts a proposed interval, refusing rather than clamping, without picking a model. 0039 materializes representatives on shares that round down and ages that never fall. 0040 measures what aggregation costs and refuses to call the result equivalence.

Every dependency adoption records exact version/commit and integrity hash, transitive license obligations, maintenance/security review, owner and removal boundary. Candidate performance and binary-size comparisons are hypotheses until benchmarked. Primary sources were reviewed during the initial September 2026 design. No unadopted candidate is a link dependency of the proof.