Files
aevolution/docs/engineering/M12_ENVIRONMENT_OWNERSHIP_RESOLUTION.md
dingoandClaude Opus 5.5 4c70257883
Foundation / checks (ecs) (push) Successful in 2m28s
Foundation / checks (deploy) (push) Successful in 4m59s
Foundation / checks (network) (push) Successful in 20m56s
Foundation / checks (client) (push) Successful in 22m1s
Foundation / checks (tsan) (push) Successful in 45m41s
Foundation / checks (postgres) (push) Successful in 1h13m35s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (checks) (push) Canceled after 1h20m34s
feat(ecology): own cells and their local environment together
ADR-0172 records the maintainer's M12.5 ownership decision: one owner per
patch of space for cells and their local environment, reserves belonging
to the biological individual, and an open planet boundary whose every
crossing is a recorded import or export.

The portable CellularEnvironment owner (envelope AEVOCEN1) holds an exact
population with tagged water and dissolved compartments, refuses declared
atmosphere, imports infall from finite per-source entitlements (ADR-0136
step B) and radiates retained heat. Each tick's exchange is a validated
swap on the nested owner, undone if the biological tick refuses. Closed
and source-off regions keep their biology byte for byte; raw and cohort
representations agree under infall. No existing format, trace, golden,
default opening or live version changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 16:05:17 -04:00

8.5 KiB
Raw Permalink Blame History

Cellular/environment ownership resolution

2026-10-19 engineering design review for M12.5. This document proposes the next implementation boundary; it does not declare a new biological rule, accepted producer chemistry, working adapter or completed gate.

Decision (2026-10-19): the maintainer accepted the single-owner direction with three clarifications recorded in ADR-0172: one owner per patch of space at any moment (many regions, paired transfers between them, unchanged for the later multicellular 3D world); reserves belong to the biological individual, with colony/multicellular sharing a later versioned rule; and the planet is an open system whose every crossing is a recorded import or export. ADR-0172 is the 12.5a contract and implements the portable 12.5b owner with finite infall entitlements and radiative heat export. Producers remain open.

Concrete conflict

CellularLives exclusively owns its finite habitat, nursery, living bodies and reserves, corpses, heat, archive and boundary ledger. Its complete restore checks five-channel closure against the opening and retained boundary flows. A habitat configuration copied from environmental fields would create a second spendable stock. EnvironmentalCommunity already owns its source, environment and exactly two configured resource actors, with its own atomic history and checkpoint. Advancing those two owners separately cannot publish one conserved biological tick.

The M6 ten-channel basis distinguishes water, dissolved N/P, organic energy and C/N/P/other, incident energy and heat. Cellular other has no water or gas tag. An elemental sum can therefore close while an invalid adapter turns water into food or heat into usable energy. No current API authorizes that conversion.

These are implementation conflicts with ADR-0050/0055/0101/0144 and the engineering constitution, not a request to reopen M11.9. Stop expanding the affected integration until the following boundary has its own scoped contract.

Proposed resolution

  1. Introduce a distinct composite ecological owner and checkpoint profile. It consumes exclusive ownership of cellular biology and tagged environmental stocks, exposes read-only views, and prepares a complete detached tick. Keep the existing M6 two-actor synthetic process unchanged as a reference fixture; it is not the cellular producer implementation.
  2. Initially support one explicitly declared axis-aligned habitat within one environmental voxel, using the existing checked micrometre geometry. Persist world/frame/region, source identity, origin, area and positive effective depth. Reject overlapping authorizations, cross-voxel mappings and missing fields. Camera dimensions and organism count never determine depth or supply.
  3. Adopt a versioned compartment map. Only owned organic energy/C/N/P/other can enter the existing edible deposit/reserve basis. Water remains separately tagged even inside organisms; incident energy, heat and dissolved nutrients cannot be credited as edible material through a generic retag operation. An actual conversion requires an explicitly versioned process with all debit, credit, work, waste and residual terms. Atmospheric species need their own tagged elemental composition and storage contract; absent support is an error, not zero, unlimited oxygen or an implicit photosynthesis recipe.
  4. Give each source one persisted entitlement over a declared area and interval. Capture and nutrient inflow need explicit finite source debit or an audited external import, never both. Disjoint shares or one arbiter resolve contention. Retain rate denominators, fractional residuals, interval watermarks and skipped outcomes. Restart, retries and habitat refinement cannot reset entitlements.
  5. Keep old cellular format 7/rules 8 and 9, population envelopes and durable bundles 10/11 exact. Add separately identified composite format/rules/profile only when the entire codec and replay contract exist. Do not attach new fields to an old bundle or allow a bare nested cellular snapshot to publish a joint result. Historical census and migration must either understand the whole joint owner or refuse it explicitly.
  6. Publish source debit, deposits, growth/maintenance, death/recycling, heat, residuals and the complete nested biological result atomically at one fixed quantum. No independently acknowledged environmental or cellular prefix. Cross-worker sources require owned escrow and paired durable settlement before activation; a timeout grants no release or second spending right.

Delivery segments and acceptance evidence

Worked conservation examples below are integer accounting fixtures, not proposed metabolic rates or a physical photosynthesis model:

Step Incident energy Environmental organic energy Cell reserve energy Heat Total pJ
Opening 100 30 10 0 140
Funded capture of 20, retaining 15 80 45 10 5 140
Cell maintenance spends 4 80 45 6 9 140
Contact transfers 10 organic energy 80 35 16 9 140
Explicit external import of 7 87 35 16 9 147

The final row additionally retains exactly 7 pJ of cumulative external imports; the closed rows retain zero. Neither heat nor source entitlement is an extra spendable balance. Replaying the import must retain 147, not credit another 7. Source-off executes no capture, but may spend already retained reserves.

For the other basis, water 100 fg + environmental organic other 20 fg + cell organic other 6 fg totals 126 fg. Moving 2 fg of organic other into the cell gives 100 + 18 + 8 = 126. Moving water into the existing untagged food reserve must be refused even though 98 + 20 + 8 also sums to 126. This is why elemental closure alone cannot validate the adapter. Dissolved N/P incorporation and atmospheric conversion likewise need actual typed reaction contracts, not a matching sum.

For geometry, 1,000 × 2,000 × 10 micrometres gives 20,000,000 cubic micrometres. Doubling depth changes the declared sampling volume; it does not double any owned water, nutrient or source stock. Source-area entitlement cannot double merely because another cell overlaps the same illuminated area.

Segment Concrete deliverable Required proof before commit
12.5a Accepted compartment/geometry/source and producer-process contracts, complete format declaration Worked closed and open balances; water/heat/atmosphere refusals; no ambiguous ownership or unversioned coefficient
12.5b Portable composite owner and full codec from its first advancing operation Real player-origin raw/cohort trajectories, atomic failed ticks, malformed/old formats, exact retry/restore/process continuation, closed-box and resource exhaustion comparisons
12.5c Dedicated durable profile, trace, explicit upgrade and complete recovery Source/head/fence and representation races, uncertain replies, process kills, object failures, old bundle refusal and exact history
12.5d Worker/census/migration/client integration and source regimes Registered complete-stock audits, no offline capture/growth, preserved lineage and escrow, useful source-off/open/nutrient-limited comparisons
12.5e Target-host and integrated-world qualification Publication and contention tail costs, recovery faults, actual-days varied worlds and returning-player review

The first segment must specify producer costs and atmosphere/water semantics before implementation. The proposed infall/photosynthesis sections of ADR-0136 are design input, not authority to silently supply missing chemistry or free matter. Trial coefficients must be clearly revisable and distinguish capture of external energy from nutrient acquisition and body construction.

Alternatives and consequences

A copied environmental view duplicates supply. Reusing M6's configured producer as a cellular ancestor invents player-origin biology and treats synthetic growth units as developed body mass. Independently committing two existing checkpoints creates torn cuts. Adding a generic inventory setter bypasses source authority. All four alternatives are rejected as implementation shortcuts.

A dedicated owner costs another complete format, replay path, durable admission and integration matrix. It avoids changing historical biological bytes and makes unsupported physical states explicit. Existing maturation, migration, census and bounded generation qualification can proceed independently. No environmental runtime, live upgrade, World0 operation or M12.5 completion is claimed here.