Implement M6.5c persisted environmental community and bounded writers
This commit is contained in:
@@ -0,0 +1,88 @@
|
||||
#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{};
|
||||
auto operator<=>(const EnvironmentalConfig&) const = default;
|
||||
};
|
||||
struct EnvironmentalInput {
|
||||
std::uint64_t temperature_mK{}, source_enabled{};
|
||||
std::array<std::uint64_t, 5> bite{};
|
||||
auto operator<=>(const EnvironmentalInput&) const = default;
|
||||
};
|
||||
struct EnvironmentalProgress {
|
||||
std::uint64_t tick{}, source_remainder{}, last_funded{}, efficiency_remainder{},
|
||||
growth_remainder{}, producer_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{};
|
||||
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_;
|
||||
}
|
||||
|
||||
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
|
||||
@@ -8,6 +8,9 @@
|
||||
#include <memory>
|
||||
#include <span>
|
||||
|
||||
namespace evo::processes {
|
||||
class EnvironmentalCommunity;
|
||||
}
|
||||
namespace evo::world {
|
||||
struct OrganismResourceId {
|
||||
std::uint64_t value{};
|
||||
@@ -91,6 +94,11 @@ class EnvironmentalTransfers {
|
||||
std::uint64_t current_tick);
|
||||
|
||||
private:
|
||||
friend class evo::processes::EnvironmentalCommunity;
|
||||
[[nodiscard]] bool process_checkpoint(std::uint64_t tick,
|
||||
const std::array<std::uint64_t, 10>& environment,
|
||||
const std::array<std::uint64_t, 10>& producer,
|
||||
const std::array<std::uint64_t, 10>& consumer) noexcept;
|
||||
struct History {
|
||||
EnvironmentalReceipt receipt{};
|
||||
std::array<EnvironmentalLeg, max_legs> legs{};
|
||||
|
||||
Reference in New Issue
Block a user