Files
aevolution/include/evo/processes/environmental_community.hpp
T

97 lines
4.1 KiB
C++

#pragma once
#include "evo/world/transfers.hpp"
namespace evo::processes {
// Explicit fixture parameters; units and array order in environmental-community.md.
struct EnvironmentalConfig {
std::uint64_t rules{1}, world{}, frame{}, producer{}, consumer{}, source{}, tick_microseconds{},
area_um2{}, irradiance_numerator{}, irradiance_denominator{1}, efficiency{},
growth_numerator{}, growth_denominator{1}, growth_cost{};
std::array<std::uint64_t, 5> recipe{}, intake{};
std::uint64_t assimilation{}, producer_min_mK{}, producer_max_mK{}, consumer_min_mK{},
consumer_max_mK{};
std::array<std::uint64_t, 10> decay{}; // Rules 2: shared source-channel caps per tick.
auto operator<=>(const EnvironmentalConfig&) const = default;
};
struct EnvironmentalInput {
std::uint64_t temperature_mK{}, source_enabled{};
std::array<std::uint64_t, 5> bite{};
std::array<std::uint64_t, 2> terminal{}; // Rules 2: trusted host facts, actor order.
auto operator<=>(const EnvironmentalInput&) const = default;
};
struct EnvironmentalProgress {
std::uint64_t tick{}, source_remainder{}, last_funded{}, efficiency_remainder{},
growth_remainder{}, producer_terminal{};
std::uint64_t consumer_terminal{};
auto operator<=>(const EnvironmentalProgress&) const = default;
};
struct EnvironmentalReport {
std::uint64_t tick{}, captured{}, retained{}, capture_heat{}, grown{}, unmet{}, source_status{};
std::array<std::uint64_t, 5> assimilated{}, waste{};
std::uint64_t terminal_transition{};
std::uint64_t consumer_transition{};
std::array<std::uint64_t, 10> decomposed{};
auto operator<=>(const EnvironmentalReport&) const = default;
};
enum class CommunityError : std::uint8_t {
config,
input,
tick,
conflict,
stale,
capacity,
insufficient,
overflow,
budget,
format,
version,
checksum,
resources
};
class EnvironmentalCommunity {
public:
static constexpr std::size_t history_limit = 64, scratch_bytes = 65536,
max_snapshot_bytes = std::size_t{1024} * 1024;
[[nodiscard]] static std::expected<std::unique_ptr<EnvironmentalCommunity>, CommunityError>
create(EnvironmentalConfig config, std::unique_ptr<world::EnvironmentalTransfers> resources,
std::size_t budget);
[[nodiscard]] std::expected<EnvironmentalReport, CommunityError>
advance(std::uint64_t tick, const EnvironmentalInput& input);
[[nodiscard]] std::expected<world::WorldBytes, CommunityError> snapshot() const;
[[nodiscard]] static std::expected<std::unique_ptr<EnvironmentalCommunity>, CommunityError>
restore(std::span<const std::uint8_t> bytes, world::WorldIdentity identity, std::size_t budget);
[[nodiscard]] const world::EnvironmentalTransfers& resources() const noexcept {
return *resources_;
}
[[nodiscard]] EnvironmentalProgress progress() const noexcept {
return progress_;
}
[[nodiscard]] std::uint64_t tick_microseconds() const noexcept {
return config_.tick_microseconds;
}
private:
struct State {
std::array<std::uint64_t, 10> environment{}, producer{}, consumer{};
EnvironmentalProgress progress{};
auto operator<=>(const State&) const = default;
};
struct History {
EnvironmentalInput input{};
EnvironmentalReport report{};
};
EnvironmentalCommunity() = default;
[[nodiscard]] State state() const noexcept;
[[nodiscard]] bool valid(const State& s) const noexcept;
[[nodiscard]] static bool configuration(const EnvironmentalConfig& c,
const world::EnvironmentalTransfers& r) noexcept;
[[nodiscard]] std::expected<EnvironmentalReport, CommunityError>
step(State& candidate, std::uint64_t tick, const EnvironmentalInput& input) const noexcept;
EnvironmentalConfig config_{};
std::unique_ptr<world::EnvironmentalTransfers> resources_;
EnvironmentalProgress progress_{};
State anchor_{};
std::array<History, history_limit> history_{};
std::size_t count_{}, next_{}, budget_{};
};
} // namespace evo::processes