Struct RunMetadata 

pub struct RunMetadata {
    pub run_id: String,
    pub started_at_utc: String,
    pub command: String,
    pub resume: bool,
    pub repo_root: String,
    pub ralph_version: String,
    pub pid: Option<u32>,
    pub config_summary: Option<ConfigSummary>,
}

Metadata recorded in run.json for each pipeline run.

This file is written at the start of each run to provide context for debugging and tooling. It anchors the run with essential info like command invocation, timestamps, and environment details.

Fields

run_id: String

Timestamp-based run identifier (matches directory name)

Format: YYYY-MM-DD_HH-mm-ss.SSSZ[-NN] (e.g., 2026-02-06_14-03-27.123Z)

This is the log run ID used for the per-run log directory and is distinct from the UUID-based run_id field in PipelineCheckpoint which uniquely identifies the execution session.

started_at_utc: String

Timestamp when run started (UTC, RFC3339)

command: String

Command as invoked by user (e.g., “ralph” or “ralph –resume”)

resume: bool

Whether this is a resumed session

repo_root: String

Absolute path to repository root

ralph_version: String

Ralph version (from Cargo.toml)

pid: Option<u32>

Process ID (if available)

config_summary: Option<ConfigSummary>

Configuration summary (non-secret metadata)

Trait Implementations

impl Clone for RunMetadata

fn clone(&self) -> RunMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RunMetadata

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

where __S: Serializer,

Serialize this value into the given Serde serializer.