An empty reservoir is not an unowned one

Two defects from review of 380d609.

Materialization treated an empty reservoir as available. A vacant cohort, or one
holding nothing, still owns its store, so a draw could credit it while the owning
record went on recording nothing: the same inventory in two places, reached from
the opposite direction to the destination defect in 1a59b63. Destinations are
checked against the registry's ownership now, not just their balance, and the
registry answers whether a reservoir is used rather than callers inferring it from
what the reservoir contains.

The same hole existed on the collapse side in a worse form, found by asking
whether the reported defect had a sibling. Nothing verified the destination was
unowned, so the shared-reservoir rule added in M4.3 would have refused the install
only after the transfer had run, leaving the members emptied and their biomass in
a reservoir nothing accounted for. That is exactly the stranding the M4.2 ordering
was chosen to prevent, defeated by a check that ran too late. Whichever registry
step follows a transfer is now proved to succeed before it, through may_install
and may_replace queries that install and replace delegate to, so there is one rule
and not a restatement that can drift.

The second finding was a functional gap the oscillation test hid by discarding its
registry each cycle. A full draw leaves a vacant record, which ADR-0036 retains
because absence is not extinction, and collapse then refused that habitat and
genome as occupied: a full materialization was a one-way door out of a habitat and
the lineage could never return. Collapse repopulates a vacant record in place now,
continuing its ownership and revision series rather than restarting them, and a
record still holding a population is refused, because merging two silently is not
a conversion. The test keeps one registry for all twelve cycles and asserts the
revision continues.

Four of the five new guards are load-bearing. The fifth is not and is recorded as
such: the may_replace pre-check in commit_materialize is unreachable given the
checks before it, since the installed record is already proved equal to the plan's
origin and the result differs only by a later revision. It is kept because it is
the right place for the guard and its collapse-side sibling is genuinely
reachable, not because it is exercised.

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
dingo
2026-09-24 17:47:37 -04:00
co-authored by Claude Opus 5
parent 380d609f06
commit 14e0c1af5e
13 changed files with 332 additions and 37 deletions
+16
View File
@@ -70,6 +70,22 @@ carries a cohort already validated and the destination was already proved
available. Every rejection therefore leaves the ledger and the registry exactly as
they were.
Two things were added here after review, and both are corrections rather than
refinements. A destination reservoir that another cohort owns is refused, because
emptiness is not availability: a vacant cohort still owns its store, and the
shared-reservoir rule would otherwise have refused the install only after the
transfer had run, leaving the members emptied and their biomass in a reservoir
nothing accounts for. Whichever registry step will follow the transfer is now
checked before it, through the registry rather than by restating its rules.
And a habitat and genome already holding a vacant record is repopulated rather than
refused. ADR-0036 keeps a record whose population reached zero because absence is
not extinction, so without this a lineage could never return to a habitat it had
once emptied, and a full materialization would be a one-way door. The retained
record's ownership and revision series continue: the plan has to be a strictly
later view of it, which is the rule every other replacement obeys. A record that is
not vacant is a population, and merging two silently is not a conversion.
The reservoir's emptiness is checked after the sample rather than beside the other
destination checks. Both run before anything moves, so this is a reporting choice:
when a committed plan is replayed into a fresh registry both would refuse it, and
+13 -3
View File
@@ -61,6 +61,14 @@ member's reservoir must be empty first, so a member's reserve is the whole of wh
backs it rather than a part sharing a store with inventory nobody counted. That is
the same rule the destination of a collapse has.
Emptiness is not availability, and that distinction had to be added after review. A
vacant cohort, or one simply holding nothing, still owns its reservoir, so crediting
it would put inventory there that the owning record does not account for: the same
inventory in two places, arrived at from the other direction. Every destination is
therefore checked against the registry's ownership as well as against its balance,
and the registry answers whether a reservoir is used rather than callers guessing
from what it contains.
What the resolution discards is stated, not mitigated. A round trip is exact when
each class holds one member and smooths within a class otherwise, and the tests
demonstrate both rather than only the flattering one. The available mitigation is
@@ -123,8 +131,10 @@ many cycles: the conserved total never moves, no member ever holds more than the
largest starting member held, and ages never decrease. Test scarcity, where a
class holding nothing materializes members holding nothing rather than refusing or
inventing. Test that drawing more than a class holds, an unknown or repeated class,
a reservoir that is not empty, a repeated reservoir, a stale view and a wrong owner
are each refused, and that every rejection leaves the ledger and the registry
unchanged. No genome schema, mutation catalog, archive, ledger, episode driver,
a reservoir that is not empty, a reservoir another cohort owns however empty, a
repeated reservoir, a stale view and a wrong owner are each refused, and that every
rejection leaves the ledger and the registry unchanged. Test the round trip through
one registry that is never discarded, so a full draw and the collapse that follows
it have to work against the record the draw left behind. No genome schema, mutation catalog, archive, ledger, episode driver,
ensemble, cohort record, collapse, interval accounting, renderer or deployment
changes.