Foundation / checks (deploy) (push) Successful in 3m20s
Foundation / checks (ecs) (push) Successful in 1m57s
Foundation / checks (client) (push) Failing after 10m4s
Foundation / checks (network) (push) Successful in 13m3s
Foundation / checks (tsan) (push) Successful in 7m53s
Foundation / checks (checks) (push) Successful in 32m18s
Foundation / checks (postgres) (push) Successful in 43m26s
Foundation / postgres-tools (push) Skipped
Foundation / server-image (push) Skipped
Foundation / image (push) Skipped
ADR-0096. Two real evo-server processes on PostgreSQL (regions 7/161 and 7/162, adjacent areas) run crossings and crossings back, SIGKILL of the source after prepare and of the destination after stage and after commit, duplicate and stale ticket retries, a client that never arrives and a destination that is down. After every scenario SQL checks one owner per probe, the conserved inventory and frozen-iff-open-transfer. The matrix found two recovery gaps, now fixed: - a source restarted after a prepare left the probe frozen for good (its abort deadline was in memory): schema v14 overdue_probe_transfers and a session-layer sweep abort open outgoing transfers past the ticket lifetime plus 10 s by the database clock; - a ticket replayed at a restarted destination after the probe moved on took control back: admission of a committed transfer now requires the record as that commit left it. M10.8 is complete. Refreshes the dev session window. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
57 lines
2.6 KiB
C++
57 lines
2.6 KiB
C++
#pragma once
|
|
#include "evo/network/handoff_ticket.hpp"
|
|
#include "evo/network/session_control.hpp"
|
|
#include <chrono>
|
|
#include <cstdint>
|
|
#include <expected>
|
|
#include <vector>
|
|
|
|
// M10.8c (ADR-0096): the region's durable probe records as the session layer uses them.
|
|
// Transport-neutral; the host implements it over PostgreSQL (PostgresProbeLedger), tests use
|
|
// fakes. EXPERIMENT: probes are non-biological engineering entities (ADR-0094).
|
|
namespace evo::server {
|
|
struct ProbeHome {
|
|
std::uint64_t owner{}, generation{};
|
|
std::int64_t x{}, y{};
|
|
bool frozen{}; // An open transfer: neither this region nor the owner may act yet.
|
|
};
|
|
struct IncomingProbe {
|
|
network::TransferId transfer{};
|
|
std::int64_t x{}, y{};
|
|
};
|
|
enum class ProbeLedgerError : std::uint8_t { fenced, unavailable };
|
|
class ProbeLedger {
|
|
public:
|
|
ProbeLedger() = default;
|
|
ProbeLedger(const ProbeLedger&) = delete;
|
|
ProbeLedger& operator=(const ProbeLedger&) = delete;
|
|
virtual ~ProbeLedger() = default;
|
|
// The account's probe, created here at the position when the world has none.
|
|
[[nodiscard]] virtual std::expected<ProbeHome, ProbeLedgerError>
|
|
open(const network::AccountId& account, std::int64_t x, std::int64_t y, std::int64_t z) = 0;
|
|
// Best effort: the owned, active probe's position (session end).
|
|
virtual void save(const network::AccountId& account, std::uint64_t generation, std::int64_t x,
|
|
std::int64_t y, std::int64_t z) = 0;
|
|
// Freezes the probe at its final position for `destination`.
|
|
[[nodiscard]] virtual std::expected<void, ProbeLedgerError>
|
|
prepare(const network::AccountId& account, std::uint64_t generation,
|
|
const network::TransferId& transfer, std::uint64_t destination, std::int64_t x,
|
|
std::int64_t y, std::int64_t z) = 0;
|
|
// Abandons a transfer whose client never arrived: true when aborted (the probe is active
|
|
// here again), false when it had been committed.
|
|
[[nodiscard]] virtual std::expected<bool, ProbeLedgerError>
|
|
abort(const network::TransferId& transfer) = 0;
|
|
// Open transfers addressed to this region (shown as ghosts).
|
|
[[nodiscard]] virtual std::expected<std::vector<IncomingProbe>, ProbeLedgerError>
|
|
incoming() = 0;
|
|
// M10.8d: this region's open outgoing transfers prepared more than `age` ago by the
|
|
// store's clock, whoever prepared them (an earlier process too): recovery aborts them.
|
|
[[nodiscard]] virtual std::expected<std::vector<network::TransferId>, ProbeLedgerError>
|
|
overdue(std::chrono::seconds age) = 0;
|
|
|
|
protected:
|
|
ProbeLedger(ProbeLedger&&) = default;
|
|
ProbeLedger& operator=(ProbeLedger&&) = default;
|
|
};
|
|
} // namespace evo::server
|