2.5 KiB
ADR-0109: Cellular region-wide conservation closure
Status
Accepted M11.3 engineering correction to ADR-0108 (2026-10-10). Patch source provenance remains unchanged. No gameplay rule or resource quantity changes.
Context
ADR-0101 stores a source identity on each provisioned food patch. After uptake,
however, its energy and matter join a life's reserve and may later move between
reserve, body, heat and corpse. The existing Inventory ledger has no per-source
dimension, so it cannot truthfully report which source a mixed reserve came
from. ADR-0108's initial wording required per-source downstream reconciliation,
which would require tagging every inventory channel with provenance and would
change the accounting model.
Decision
- Keep each patch's immutable source identity as opening provenance. Do not propagate source tags through living inventories, heat or corpses.
- Profile 4 stores one explicit initial region total for each conserved channel. The total includes all provisioned patch stocks, nursery funding and other opening inventories. Every checkpoint validates that current habitat stock, nursery balances, living body/reserve/heat, region heat, corpses and any other explicit owner sum exactly to that initial total, channel by channel.
- Any external transfer after genesis must be represented as an explicit versioned opening/closing transfer in the same durable publication. M11.3 has no replenishment or cross-scale transfer, so its region total is constant.
Alternatives considered
- Per-source tagged balances: rejected because the existing ledger and biology contracts have no such dimension; copying source tags into every transformed holding would be a new accounting model with additional storage and rules.
- Discard patch provenance on intake: rejected because ADR-0101 requires provenance to remain available for audit of the opening.
- Check only that individual transfers conserve: rejected because recovery also needs a closed-world invariant that detects missing or duplicated owners.
Benefits and costs
The existing four independent inventory channels remain the accounting unit, and provenance stays auditable at the environmental opening. The checkpoint cannot answer how much downstream biomass originated from one particular patch source after mixing.
Consequences
ADR-0108 and schemas/cellular-lives-v1.md use region-wide totals, not
per-source totals. The cellular owner must carry those totals through restore
and validate all represented accounts before publication and readiness.