Files
aevolution/include/evo/biology/cellular_tuning.hpp
T
dingoandClaude Opus 5.5 2bffbc2095
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 4s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 4s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 4m26s
Foundation / postgres-tools (push) Successful in 19s
Foundation / image (push) Successful in 3m57s
Foundation / server-image (push) Successful in 4m2s
feat(biology): genome schema 6 movement arrangement and derived handling
Schema 6 genomes carry the body's movement arrangement for mutations 001-010 as
reference-point indices (100 = founder): output, efficiency, burst, steering,
streamlining, braking, anchor, coasting and colony drive. It is encoded after the
capability records and covered by the digest; older schemas refuse it, so their
capability tables and mutation catalogs are unchanged. Development version 6 and
founder 5 serve rules 12.

derive_cellular_handling scales the tuned founder handling by the arrangement:
output scales thrust, braking reverse thrust, steering turning; streamlining lowers
forward drag and coasting both drags. Full-output costs follow the metabolic
budget's movement cost times output over efficiency. Shed output or a missing
movement capability leaves only passive drift. Refreshes the DEV session window.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 16:39:09 -04:00

94 lines
4.5 KiB
C++

#pragma once
#include "evo/biology/cellular_kinematics.hpp"
#include "evo/biology/metabolism.hpp"
#include <compare>
#include <cstddef>
#include <cstdint>
#include <expected>
#include <string>
#include <string_view>
// 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.
// 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<CellularTuning, CellularTuningError>
parse_cellular_tuning(std::string_view text);
// 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_genome, 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.
[[nodiscard]] std::expected<CellularHandling, CellularHandlingError>
derive_cellular_handling(const Genome& genome, const MetabolicBudget& budget,
const CellularTuning& tuning);
} // namespace evo::biology