#pragma once #include "evo/biology/cellular_kinematics.hpp" #include "evo/biology/metabolism.hpp" #include #include #include #include #include #include #include #include // Git-managed trial values (Cellular_Region_Movement_Plan.md, tuning file). The file is // plain `key = value` lines with `#` comments and integer values; `_` may separate digits. // Every key below is required exactly once and range-checked, so a typo fails loudly // instead of running with a default. namespace evo::biology { inline constexpr std::int64_t cellular_tuning_version = 1; inline constexpr std::size_t max_cellular_tuning_bytes = std::size_t{64} * 1'024; struct CellularTuning { std::int64_t version{}; // Region shape and capacity; shape applies when a region opens. std::int64_t region_width_um{}, region_height_um{}; std::int64_t region_organism_cap{}, region_deposit_limit{}, region_perception_radius_um{}; // Founder handling. std::int64_t founder_thrust_um_per_s2{}, founder_reverse_thrust_um_per_s2{}; std::int64_t founder_drag_ppm_per_tick{}, founder_lateral_drag_ppm_per_tick{}; std::int64_t founder_turn_heading_per_s{}; // 65,536 heading units per turn. // Thrust energy as a share of the metabolic full-speed movement cost, per thousand. std::int64_t founder_thrust_cost_per_mille{}; // Currents. std::int64_t currents_min_count{}, currents_max_count{}; std::int64_t currents_min_width_um{}, currents_max_width_um{}; std::int64_t currents_min_speed_um_per_s{}, currents_max_speed_um_per_s{}; std::int64_t currents_grid_pitch_um{}; // Moving food. std::int64_t food_merged_bubble_cap_multiple{}, food_visible_moving_bubbles{}; std::int64_t food_induced_drift_radius_um{}, food_induced_drift_max_um_per_s{}; std::int64_t food_induced_drift_decay_ppm_per_tick{}; // Thermal map and biology (temperatures in millikelvin). std::int64_t thermal_ambient_min_mk{}, thermal_ambient_max_mk{}; std::int64_t founder_preferred_mk{}, founder_comfort_band_mk{}, founder_body_tau_ms{}; std::int64_t founder_lethal_cold_mk{}, founder_lethal_heat_mk{}; std::int64_t thermal_off_preference_per_mille_per_k{}, thermal_transition_per_mille_per_k{}; std::int64_t thermal_multiplier_cap_per_mille{}; // Lifecycle. std::int64_t lifecycle_logout_delay_ms{}; // Mutation offers. std::int64_t mutation_step_points{}, mutation_paired_points{}; std::int64_t mutation_recovery_floor_per_mille{}; std::int64_t mutation_offer_interval_ms{}, mutation_offer_options{}; auto operator<=>(const CellularTuning&) const = default; }; enum class CellularTuningErrorKind : std::uint8_t { too_large, syntax, unknown_key, duplicate_key, invalid_value, out_of_range, missing_key, inconsistent, unsupported_version }; struct CellularTuningError { CellularTuningErrorKind kind{}; std::size_t line{}; // 1-based; zero when not tied to a line. std::string key; auto operator<=>(const CellularTuningError&) const = default; }; [[nodiscard]] std::expected parse_cellular_tuning(std::string_view text); // The shared line reader for Git tuning files: comments and blank lines dropped, each other // line split into a valid key and its unparsed value text. Views point into `text`. struct TuningLine { std::size_t line{}; // 1-based. std::string_view key, value; }; [[nodiscard]] std::expected, CellularTuningError> read_tuning_lines(std::string_view text, std::size_t max_bytes); // Optional '-', then digits with single '_' separators between digits; at most 18 digits. [[nodiscard]] std::optional parse_tuning_integer(std::string_view text) noexcept; // Canonical text: every key once, in schema order, so equal tunings encode identically. [[nodiscard]] std::string encode_cellular_tuning(const CellularTuning& tuning); [[nodiscard]] std::string_view describe(CellularTuningErrorKind kind) noexcept; // Founder handling per 50 ms tick, rounded down; costs are supplied by the metabolic budget. [[nodiscard]] CellularHandling founder_cellular_handling(const CellularTuning& tuning, accounting::Picojoules thrust_cost, accounting::Picojoules reverse_cost); enum class CellularHandlingError : std::uint8_t { unsupported_rate, overflow }; // Development 6: an organism's handling from its movement arrangement, scaled from the // founder's tuned handling (index 100 = founder). Output scales thrust, braking scales // reverse thrust, steering scales turning; streamlining lowers forward drag only and // coasting lowers both, so a coasting body also tops out faster. Full-output costs per tick // are the budget's full-speed movement cost times output (or braking) over efficiency. // Without the movement capability or with shed output, the body cannot thrust or turn. // A genome from before schema 6 has no arrangement and handles as the founder does. [[nodiscard]] std::expected derive_cellular_handling(const Genome& genome, const MetabolicBudget& budget, const CellularTuning& tuning); // The same from the founder's per-tick handling directly; its costs are ignored. [[nodiscard]] std::expected derive_cellular_handling(const Genome& genome, const MetabolicBudget& budget, const CellularHandling& founder); } // namespace evo::biology