Struct JobMetadata 

#[non_exhaustive]
pub struct JobMetadata {
    pub schema_version: String,
    pub plan_hash: String,
    pub completed_tiles: Vec<TileCoord>,
    pub levels_completed: Vec<u32>,
    pub started_at: String,
    pub last_checkpoint_at: String,
}

On-disk checkpoint describing the state of a pyramid generation job.

Produced and consumed by JobCheckpoint::save / JobCheckpoint::load. The struct is intentionally simple and flat so that it serialises cleanly as JSON — a debugger or shell user can inspect it with cat / jq.

schema_version is stored as a String so we can read back old checkpoints, compare them against SCHEMA_VERSION, and return a structured error if they disagree.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

schema_version: String

On-disk schema version. Equal to SCHEMA_VERSION (“1”) for checkpoints produced by this crate version. Stored as a plain String so the value read from disk is preserved verbatim and can be compared against the binary’s expected version.

plan_hash: String

Lowercase hex Blake3 digest of the plan’s canonical byte representation (see compute_plan_hash).

completed_tiles: Vec<TileCoord>

Coordinates of every tile that has been successfully written and flushed since the job started.

Uses the [tile_coord_vec_serde] adapter because TileCoord in crate::planner does not itself implement Serialize / Deserialize.

levels_completed: Vec<u32>

Level indices that have been fully completed (every tile in the level is present in completed_tiles). Populated eagerly so resumption can skip whole levels without re-checking each tile.

started_at: String

RFC 3339 timestamp captured when the job first started (Overwrite mode) or when an existing checkpoint was first resumed.

last_checkpoint_at: String

RFC 3339 timestamp of the most recent checkpoint write.

Implementations

impl JobMetadata

pub fn new(plan_hash: String, started_at: String) -> Self

Construct a fresh JobMetadata tagged with the current SCHEMA_VERSION. All other fields default to empty / zero values; callers fill them in as the job progresses.

Trait Implementations

impl Clone for JobMetadata

fn clone(&self) -> JobMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JobMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JobMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for JobMetadata

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for JobMetadata

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 JobMetadata