Files
aevolution/docs/adr/0103-cellular-perception-trial.md
T
dingo 44732967e7
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (network) (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 0s
Foundation / checks (tsan) (push) Canceled after 0s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (client) (push) Canceled after 1m8s
Foundation / checks (checks) (push) Canceled after 1m13s
Foundation / checks (ecs) (push) Canceled after 1m4s
Add bounded cellular resource perception
2026-10-10 21:16:54 -04:00

50 lines
2.4 KiB
Markdown

# ADR-0103: Cellular resource perception trial
## Status
Accepted direction for the M11.3 exploratory slice (2026-10-10). Range and
disclosure are versioned trial rules and may be revisited after hands-on use.
## Context
ADR-0101 adds sparse, finite food patches at a 1,000 μm pitch. ADR-0102 makes
the server authoritative for position and contact. A client needs enough local
information to choose where to steer, while unseen map stock and patch-opening
provenance must stay outside its view. The founder's starting movement capacity
is 200 μm/s; perception should show several nearby patches without revealing
the whole finite region.
## Decision
- The M11.3 trial uses a fixed 5,000 μm perception radius, measured as the
shortest Euclidean gap between the organism's square footprint and each
patch's square footprint. A patch exactly 5,000 μm away is visible.
- The server view may disclose the address and current exact energy and
matter inventory of provisioned patches within range, including an empty
provisioned patch. It never discloses source/provenance identifiers or
patches outside range. Unprovisioned patches are absent from the view.
- Clients cannot choose or enlarge this range. The biological owner derives
the footprint and position from authoritative state and returns a canonical
address-ordered projection. A footprint outside the habitat is rejected.
- The range is about 25 seconds of full-speed travel for the starting founder.
This is a trial affordance for steering and feeding choices, not a general
sensory law or a claim about the eventual world.
## Alternatives considered
- **Expose the full habitat:** rejected because finite stock outside the
perception boundary would become client knowledge.
- **Hide exact quantities:** deferred; exact nearby quantities make the first
agency and feeding-choice probe interpretable. A later revision can test a
coarser signal.
- **Let clients request their range:** rejected because it turns a view
boundary into a client-controlled information leak.
## Consequences
The pure habitat API can project visible patch records without exposing their
provenance. The live server still needs to bind this projection to the
authenticated life and authoritative position before the exploratory probe.
Changing range or disclosure after the probe requires an explicit trial-rule
revision and a checkpoint/profile version decision before persisted play.