Struct MachineState 

pub struct MachineState {
    pub provider_id: Option<String>,
    pub public_ipv4: Option<String>,
    pub hostkey_fingerprint: Option<String>,
    pub last_adopted_at: Option<String>,
}

On-disk JSON shape for .yah/infra/state/machines/<name>.json.

Forward-compatible: every field is optional so a partial adopt (server found, hostkey poll timed out) still produces a useful record. The file is re-written wholesale on each adopt + each attach — no incremental patching.

Fields

provider_id: Option<String>

Provider-native server id (Hetzner: server.id as decimal string). Captured once on first adopt; refreshed only if the box is rebuilt and the name re-bound to a new server id.

public_ipv4: Option<String>

Primary public IPv4 observed at last adopt/attach. Refreshed every adopt; for audit, not for binding (mesh IP is what callers use).

hostkey_fingerprint: Option<String>

SSH hostkey fingerprint observed at attach time. Refreshed on every attach — when it changes between runs, the box was rebuilt.

last_adopted_at: Option<String>

RFC3339 timestamp of the most recent successful adopt.

Implementations

impl MachineState

pub fn path(workspace_root: &Path, name: &str) -> PathBuf

<workspace_root>/.yah/infra/state/machines/<name>.json.

pub fn load(workspace_root: &Path, name: &str) -> Result<Self>

Load state for name. Missing file returns Ok(MachineState::default()) so callers can treat the no-state-yet case identically to the partial- state case (initialize on adopt).

pub fn save(&self, workspace_root: &Path, name: &str) -> Result<()>

Write state for name, creating parent dirs as needed.

Trait Implementations

impl Clone for MachineState

fn clone(&self) -> MachineState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MachineState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MachineState

fn default() -> MachineState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MachineState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for MachineState

impl PartialEq for MachineState

fn eq(&self, other: &MachineState) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for MachineState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MachineState