Foundation / checks (ecs) (push) Successful in 2m28s
Foundation / checks (deploy) (push) Successful in 4m59s
Foundation / checks (network) (push) Successful in 20m56s
Foundation / checks (client) (push) Successful in 22m1s
Foundation / checks (tsan) (push) Successful in 45m41s
Foundation / checks (postgres) (push) Successful in 1h13m35s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (checks) (push) Canceled after 1h20m34s
ADR-0172 records the maintainer's M12.5 ownership decision: one owner per patch of space for cells and their local environment, reserves belonging to the biological individual, and an open planet boundary whose every crossing is a recorded import or export. The portable CellularEnvironment owner (envelope AEVOCEN1) holds an exact population with tagged water and dissolved compartments, refuses declared atmosphere, imports infall from finite per-source entitlements (ADR-0136 step B) and radiates retained heat. Each tick's exchange is a validated swap on the nested owner, undone if the biological tick refuses. Closed and source-off regions keep their biology byte for byte; raw and cohort representations agree under infall. No existing format, trace, golden, default opening or live version changes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
99 lines
4.9 KiB
C++
99 lines
4.9 KiB
C++
#pragma once
|
|
|
|
#include "evo/server/lifecycle/cellular_lives.hpp"
|
|
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
#include <expected>
|
|
#include <memory>
|
|
#include <span>
|
|
#include <vector>
|
|
|
|
namespace evo::server {
|
|
struct CellularPopulationBatch;
|
|
// ADR-0139: exact local cohorts retain individuals, never mean reserves or samples.
|
|
// The single owned CellularLives store backs BOTH representations, exactly once.
|
|
struct CellularCohortMember {
|
|
std::uint64_t life{}, genome{};
|
|
auto operator<=>(const CellularCohortMember&) const = default;
|
|
};
|
|
enum class CellularPopulationError : std::uint8_t {
|
|
unsupported,
|
|
absent,
|
|
ineligible,
|
|
format,
|
|
checksum,
|
|
identity,
|
|
overflow
|
|
};
|
|
struct CellularTierPolicy {
|
|
bool automatic{false};
|
|
std::uint32_t materialize_radius_um{1'200}, collapse_radius_um{1'800};
|
|
auto operator<=>(const CellularTierPolicy&) const = default;
|
|
};
|
|
inline constexpr std::size_t cellular_population_header_bytes = 80;
|
|
inline constexpr std::uint32_t cellular_population_inheritance_format = 3;
|
|
inline constexpr std::size_t max_cellular_population_bytes = cellular_population_header_bytes +
|
|
16 * biology::max_cellular_tick_lives +
|
|
max_cellular_lives_bytes + 8;
|
|
|
|
class CellularPopulation {
|
|
public:
|
|
[[nodiscard]] static std::expected<std::unique_ptr<CellularPopulation>, CellularPopulationError>
|
|
create(std::unique_ptr<CellularLives> state, CellularTierPolicy policy = {});
|
|
CellularPopulation(const CellularPopulation&) = delete;
|
|
CellularPopulation& operator=(const CellularPopulation&) = delete;
|
|
|
|
// Read-only biology view: it confers no separate spending rights.
|
|
[[nodiscard]] const CellularLives& state() const noexcept;
|
|
[[nodiscard]] std::span<const CellularCohortMember> members() const noexcept;
|
|
[[nodiscard]] bool in_cohort(std::uint64_t life) const noexcept;
|
|
[[nodiscard]] CellularTierPolicy policy() const noexcept;
|
|
[[nodiscard]] std::uint64_t conversion_sequence() const noexcept;
|
|
[[nodiscard]] std::uint32_t format_version() const noexcept;
|
|
// Explicit no-tick envelope-1 -> envelope-2 upgrade, retaining all cohort tags.
|
|
[[nodiscard]] std::expected<std::unique_ptr<CellularPopulation>, CellularPopulationError>
|
|
migration_upgrade_candidate() const;
|
|
// ADR-0157: preserve exact membership while upgrading nested biology to rules 9.
|
|
[[nodiscard]] std::expected<std::unique_ptr<CellularPopulation>, CellularPopulationError>
|
|
maturation_upgrade_candidate() const;
|
|
// ADR-0171: envelope 3 retains all tags and nested expressed/heritable state.
|
|
[[nodiscard]] std::expected<std::unique_ptr<CellularPopulation>, CellularPopulationError>
|
|
inheritance_upgrade_candidate() const;
|
|
[[nodiscard]] std::vector<std::uint8_t> snapshot() const;
|
|
[[nodiscard]] static std::expected<std::unique_ptr<CellularPopulation>, CellularPopulationError>
|
|
restore(std::span<const std::uint8_t> bytes, std::uint64_t world, std::uint64_t region,
|
|
std::uint64_t frame, std::uint64_t tick);
|
|
// Detached exact sample for publication. Never acknowledge it before a fenced
|
|
// durable head commits its complete snapshot; recovery restores that sample.
|
|
[[nodiscard]] std::expected<std::unique_ptr<CellularPopulation>, CellularPopulationError>
|
|
conversion_candidate(std::uint64_t genome, bool to_cohort) const;
|
|
|
|
// Convert the WHOLE eligible wildlife genome group. No selectable healthy subset,
|
|
// resampling, rounding, new identity, healing, age reset or inventory transfer.
|
|
// Controlled lives are never members. Refusal leaves biology and ownership unchanged.
|
|
[[nodiscard]] std::expected<std::size_t, CellularPopulationError>
|
|
collapse(std::uint64_t genome);
|
|
[[nodiscard]] std::expected<std::size_t, CellularPopulationError>
|
|
materialize(std::uint64_t genome);
|
|
|
|
// Only controlled-life intentions/selections are supplied by the host, sorted by ID.
|
|
// All wildlife, including cohorts, uses the unchanged shared controller and kernel.
|
|
[[nodiscard]] std::expected<CellularTickExecution, CellularLivesError>
|
|
advance_tick(std::span<const CellularLifeIntent> controlled,
|
|
std::span<const CellularMutationSelection> selections = {});
|
|
|
|
private:
|
|
friend class CellularMigration;
|
|
friend class CellularEnvironment; // ADR-0172: exclusive joint owner of this population.
|
|
friend std::expected<std::unique_ptr<CellularPopulation>, CellularPopulationError>
|
|
execute_population_batch(const CellularPopulation&, CellularPopulationBatch&, bool);
|
|
explicit CellularPopulation(std::unique_ptr<CellularLives> state, CellularTierPolicy policy);
|
|
void apply_policy();
|
|
std::unique_ptr<CellularLives> state_;
|
|
std::vector<CellularCohortMember> members_; // Sorted life IDs, unique ownership tags.
|
|
CellularTierPolicy policy_;
|
|
std::uint64_t conversion_sequence_{};
|
|
};
|
|
} // namespace evo::server
|