#pragma once #include "evo/biology/cellular_burn.hpp" #include "evo/biology/cellular_habitat.hpp" #include "evo/biology/cellular_kinematics.hpp" #include #include namespace evo::biology { struct CellularStepIntent { CellularIntent movement{}; std::optional 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 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 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 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