Files
dingoandClaude Opus 5.5 f454e038a1
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 5s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 4m32s
Foundation / postgres-tools (push) Successful in 21s
Foundation / server-image (push) Successful in 4m12s
Foundation / image (push) Successful in 4m52s
feat(lifecycle): rules 13 multicellular organisms and Emerge
Adhesion turns a cell into a two-member organism: one life with a member
count, one genome and one reserve, developed as its genome with the target
size times its members. The single cell ends as an empty merged corpse.
An organism expresses accepted mutations as a whole, paid from its reserve;
its buds add internal members (wildlife stops one short of the threshold);
the extra members' mass loads its thrust. At the emergence threshold the
Emerge intent exports the body and reserve through the boundary ledger and
ends the life as emerged.

Records the maintainer's 2026-10-23 decisions in ADR-0179 and the project
vision (whole-organism mutations; the playtest form of Emerge).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 06:50:19 -04:00

97 lines
4.7 KiB
C++

#pragma once
#include "evo/biology/cellular_burn.hpp"
#include "evo/biology/cellular_habitat.hpp"
#include "evo/biology/cellular_kinematics.hpp"
#include <cstdint>
#include <optional>
namespace evo::biology {
struct CellularStepIntent {
CellularIntent movement{};
std::optional<CellularPatchAddress> intake_target;
// ADR-0124: take one smaller contacted cell after every life's step (rules 3 only).
// Exclusive with an intake target; the server chooses the prey.
bool engulf{};
// ADR-0125: fund and place one wildlife bud after the tick's mutations (rules 4 only).
// Exclusive with an intake target and with engulfment; the owner decides everything.
bool bud{};
// ADR-0128: the owner is offline; the cell does nothing this tick (no maintenance,
// movement, intake or heat) but can still be engulfed. Exclusive with every other field.
bool frozen{};
// Rules 12: oppose relative velocity instead of following `movement`.
bool brake{};
// Rules 13 (ADR-0179): matter channels the player keeps from being burned for anything but
// upkeep, bit 0 carbon to bit 3 other matter. Wildlife keeps nothing.
std::uint8_t exclude{};
// Rules 13: with `bud`, the player continues as the (first) bud; the parent becomes wildlife.
bool become{};
// Rules 13: an organism at the emergence threshold leaves the region for the world.
bool emerge{};
auto operator<=>(const CellularStepIntent&) const = default;
};
enum class CellularStepError : std::uint8_t {
invalid_tick,
unsupported_rate_period,
insufficient_maintenance,
overflow,
motion
};
enum class CellularIntakeStatus : std::uint8_t { not_requested, acquired, missing, out_of_contact };
enum class CellularMovementStatus : std::uint8_t {
not_requested,
moved,
blocked,
insufficient_reserve
};
// Complete detached candidate for one 50 ms life tick. Maintenance is charged
// first; unaffordable motion leaves the cell stationary, then one targeted patch
// may be absorbed at the resulting position. Publication owns the final swap.
struct CellularStepCandidate {
std::uint64_t begin_tick{}, end_tick{};
CellularPosition position;
accounting::Inventory reserve_after;
accounting::Inventory heat_after;
accounting::Picojoules maintenance_cost{}, movement_cost{};
CellularMovementStatus movement_status{CellularMovementStatus::not_requested};
CellularIntakeStatus intake_status{CellularIntakeStatus::not_requested};
std::optional<CellularPatchUptakeProposal> intake;
// Rules 12 (liquid motion): the motion state after the tick and the path travelled.
CellularMotionState motion{};
std::uint64_t path_um{};
// Rules 13 (ADR-0179): reserve matter burned in place of energy, for the region's spent
// pool. Costs paid this way add no heat.
accounting::Inventory spent{};
// Rules 13: a collection limit held matter (or energy) back while food was left.
bool matter_limited{}, energy_limited{};
auto operator<=>(const CellularStepCandidate&) const = default;
};
// Rules 12: liquid-relative motion inputs for one life (Cellular_Region_Movement_Plan.md).
struct CellularLiquidInput {
CellularMotionState motion;
CellularHandling handling;
CellularFlowSample flow; // Sampled at the footprint centre by the caller.
bool brake{};
auto operator<=>(const CellularLiquidInput&) const = default;
};
[[nodiscard]] std::expected<CellularStepCandidate, CellularStepError>
propose_cellular_step(std::uint64_t begin_tick, CellularArea area, CellularPosition position,
std::uint32_t extent_um, CellularStepIntent intent,
accounting::Inventory reserve, accounting::Inventory heat,
const MetabolicBudget& budget, const CellularHabitat& habitat) noexcept;
// Rules 12: maintenance first, then one kinematic tick funded from what is left; thrust it
// cannot fund is not applied and the cell coasts with the flow. No targeted intake: liquid
// regions feed by contact in the region step. Rules 13 pass `burn`: reserve matter stands in
// for missing energy, any channel for maintenance and only unexcluded ones for thrust.
[[nodiscard]] std::expected<CellularStepCandidate, CellularStepError>
propose_liquid_cellular_step(std::uint64_t begin_tick, CellularArea area, CellularPosition position,
std::uint32_t extent_um, CellularIntent movement,
const CellularLiquidInput& liquid, accounting::Inventory reserve,
accounting::Inventory heat, const MetabolicBudget& budget,
const CellularBurn* burn = nullptr) noexcept;
} // namespace evo::biology