Files
aevolution/include/evo/persistence/life_reservation_store.hpp
T
dingo 636740bc55
Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (checks) (push) Failing after 40s
Foundation / checks (ecs) (push) Successful in 1m55s
Foundation / checks (postgres) (push) Failing after 53s
Foundation / checks (tsan) (push) Failing after 33s
Foundation / checks (network) (push) Failing after 3m1s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (client) (push) Canceled after 3m53s
Add durable primitive life owner lookup
2026-10-11 01:28:24 -04:00

78 lines
3.7 KiB
C++

#pragma once
#include "evo/persistence/postgres.hpp"
#include "evo/persistence/region_lease.hpp"
#include <chrono>
#include <cstdint>
#include <expected>
#include <vector>
namespace evo::persistence {
// Schema v15, ADR-0100. These operations allocate identity, never a biological
// body. Each call is one statement on the caller's connection, without retries.
enum class LifeReservationError : std::uint8_t {
existing_life,
fenced,
not_available, // Missing allocator/reservation, or reservation belongs elsewhere.
exhausted,
invalid,
store,
unknown // May have committed. Reconnect and retry the SAME request to reconcile.
};
struct LifeReservationFailure {
LifeReservationError kind{};
PgFailure cause{};
};
enum class LifeRefusal : std::uint8_t {
none = 0, // Reserved only; NOT successful spawn.
insufficient_funding = 1,
no_placement = 2,
cancelled = 3,
existing_life = 4
};
struct LifeReservation {
std::uint64_t identity{}, region{};
LifeRefusal refusal{};
friend bool operator==(const LifeReservation&, const LifeReservation&) = default;
};
struct PrimitiveLifeBinding {
Uuid account{};
std::uint64_t request{}, identity{}, born{};
Uuid commit{};
std::uint64_t commit_sequence{};
friend bool operator==(const PrimitiveLifeBinding&, const PrimitiveLifeBinding&) = default;
};
struct PrimitiveLifeOutcome {
LifeReservation reservation;
std::optional<PrimitiveLifeBinding> published;
friend bool operator==(const PrimitiveLifeOutcome&, const PrimitiveLifeOutcome&) = default;
};
// Exact retry returns the original identity/owning region/refusal, even after
// account control moves. The result grants no authority in the returned region.
// request_id is in the new-life namespace, separate from M10 probe action IDs.
[[nodiscard]] std::expected<LifeReservation, LifeReservationFailure>
reserve_primitive_life(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
std::uint64_t generation, std::uint64_t request_id, std::uint32_t rules,
std::chrono::milliseconds timeout);
// Requires control in the reservation's owning region. First refusal is final;
// repeats return it. Passing none or an unknown enum value is invalid.
[[nodiscard]] std::expected<LifeRefusal, LifeReservationFailure>
reject_primitive_life(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
std::uint64_t generation, std::uint64_t request_id, LifeRefusal reason,
std::chrono::milliseconds timeout);
// Bounded durable binding set for checkpoint reconciliation; session generations
// are intentionally absent and must be reacquired after recovery.
[[nodiscard]] std::expected<std::vector<PrimitiveLifeBinding>, LifeReservationFailure>
load_primitive_lives(Postgres& db, RegionKey key, std::chrono::milliseconds timeout);
// Authenticated world/account/request lookup. A missing value is unknown; a
// present pending reservation is still not a published life.
[[nodiscard]] std::expected<std::optional<PrimitiveLifeOutcome>, LifeReservationFailure>
query_primitive_life(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
std::uint64_t generation, std::uint64_t request_id,
std::chrono::milliseconds timeout);
// Read-only, lease-fenced lookup used before claiming durable account control.
// Returns no value when the account has no active (non-refused) life reservation.
[[nodiscard]] std::expected<std::optional<std::uint64_t>, LifeReservationFailure>
primitive_life_owner(Postgres& db, RegionKey key, const LeaseGrant& lease, const Uuid& account,
std::chrono::milliseconds timeout);
} // namespace evo::persistence