Struct MuxBusBlob 

struct MuxBusBlob {
    tokens: MuxBusTokens,
    generation: String,
}

On-disk JSON shape for the single-blob format (macOS/Linux’s preferred layout, write_single_blob/blob_key). Wraps MuxBusTokens with a generation stamp — the SAME new_generation() nanosecond-timestamp scheme the chunked layout already uses for its own cross-field torn-write check — so a blob and split entries found coexisting (muxbus_load_tokens’s reconciliation) can be compared for actual freshness instead of assuming a fixed direction is always right.

reagent P1 on PR #2665: an earlier version of the reconciliation logic hardcoded “split is always fresher,” which was true for the ONE historical case that motivated it (an old pre-fix blob→split migration whose blob delete failed) but breaks once THIS fix’s own self-heal can also leave stale split leftovers behind a newer blob (if delete_split_tokens partially fails, then a later muxbus_save — which on macOS/Linux only ever writes the blob — updates the blob but not the stale split entries). An actual freshness comparison handles both directions correctly instead of guessing.

#[serde(default)] on generation means a genuinely old, pre-fix legacy blob (written before this stamp existed) deserializes with an empty generation, which reads as timestamp 0 — always losing a freshness comparison against any split entry’s real generation stamp, which is exactly the right outcome for that original historical case.

Fields

tokens: MuxBusTokens

generation: String

Trait Implementations

impl Default for MuxBusBlob

fn default() -> MuxBusBlob

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MuxBusBlob

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MuxBusBlob

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

where __S: Serializer,

Serialize this value into the given Serde serializer.