Files
aevolution/include/evo/server/probe_ledger.hpp
T
dingoandClaude Opus 5.5 a7a3d12283
Foundation / checks (deploy) (push) Successful in 3m29s
Foundation / checks (ecs) (push) Successful in 2m0s
Foundation / checks (client) (push) Successful in 12m51s
Foundation / checks (network) (push) Successful in 13m0s
Foundation / checks (tsan) (push) Successful in 7m50s
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 32m4s
Foundation / checks (postgres) (push) Canceled after 19m13s
Wire M10.8c-1 region handoff: protocol v4, durable probes, crossing, ghosts
ADR-0096. Session protocol v4 (v3 is deployed and frozen) adds HandoffOffer,
SessionRedirect, close reasons handed_off and moved, and ghost marker records.
Sessions use the durable probe record: logins open it where it was saved
(redirected when it lives elsewhere), and session ends save it. A marker
crossing into a neighbour's area is frozen, prepared, its control released
and a signed ticket offered; uncommitted transfers are aborted after the
ticket's lifetime. The destination shows arriving probes as ghosts (schema
v13 incoming_probe_transfers) and opens the marker where it crossed.

Refreshes the dev session window.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 21:24:42 -04:00

52 lines
2.3 KiB
C++

#pragma once
#include "evo/network/handoff_ticket.hpp"
#include "evo/network/session_control.hpp"
#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;
protected:
ProbeLedger(ProbeLedger&&) = default;
ProbeLedger& operator=(ProbeLedger&&) = default;
};
} // namespace evo::server