Files
aevolution/include/evo/biology/cellular_tuning.hpp
T
dingoandClaude Opus 5.5 ab5df35c3f
Foundation / checks (client) (push) Successful in 4s
Foundation / checks (checks) (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 4s
Foundation / checks (deploy) (push) Successful in 4m24s
Foundation / postgres-tools (push) Successful in 27s
Foundation / server-image (push) Successful in 4m5s
Foundation / image (push) Successful in 4m17s
feat(biology): liquid-relative cellular kinematics and the Git tuning file
Phase 1 of the region and movement plan. Adds the shared integer motion step:
Q10 velocity relative to the liquid, a 16-bit heading with a rate-limited turn,
funded forward/reverse thrust (unfunded thrust coasts), braking, separate forward
and lateral drag that decays to exactly zero, local flow, and a sub-micrometre
carry with no rounding drift. A golden trajectory digest matches across g++-14,
clang-19 and MSVC, so the server and client predictor agree exactly.

Adds deploy/kubernetes/region/dev/tuning/cellular.tuning with every v0 trial value
and a strict parser (unknown, missing, duplicate, out-of-range and inconsistent
values are refused) plus founder handling derived from it. Refreshes the DEV
session window.

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

82 lines
3.6 KiB
C++

#pragma once
#include "evo/biology/cellular_kinematics.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);
} // namespace evo::biology