Struct RunManifest 

pub struct RunManifest {

    pub schema_version: u32,
    pub run_id: String,
    pub kind: RunKind,
    pub name: String,
    pub created_at: DateTime<Utc>,
    pub soma_version: Option<String>,
    pub python_version: Option<String>,
    pub hostname: Option<String>,
    pub git: GitInfo,
    pub entrypoint: Option<String>,
    pub argv: Vec<String>,
    pub cwd: Option<String>,
    pub seeds: HashMap<String, i64>,
    pub params: HashMap<String, Value>,
    pub hypothesis: Option<String>,
    pub tags: Vec<String>,
    pub notes: Option<String>,
    pub parent_run_id: Option<String>,
    pub graph: Option<GraphSummaryInfo>,
    pub study_path: Option<String>,
}

Run manifest — written once, atomically, at run start.

Mutable lifecycle state (running/completed/failed, heartbeat) lives in the separate RunStatus file so the manifest never needs rewriting after creation.

Fields

schema_version: u32

On-disk layout version this run was written with (see RUN_SCHEMA_VERSION).

run_id: String

Unique run identifier — also the run directory’s name.

kind: RunKind

What kind of work this run tracks.

name: String

Human-readable run name (not required to be unique).

created_at: DateTime<Utc>

When the run started.

soma_version: Option<String>

Version of soma that wrote this run.

python_version: Option<String>

Python interpreter version, for runs started from the bindings.

hostname: Option<String>

Host the run executed on.

git: GitInfo

Best-effort git context captured at run start.

entrypoint: Option<String>

Script or module that started the run.

argv: Vec<String>

Command-line arguments of the launching process.

cwd: Option<String>

Working directory the run was started from.

seeds: HashMap<String, i64>

Named seeds, e.g. {"torch": 42}.

params: HashMap<String, Value>

Hyperparameters the caller declared for this run — the knobs that live outside the graph (learning rate, batch size, …) and so cannot be recovered from a filter’s config hash. What makes a ParamChanged derivation possible at all.

hypothesis: Option<String>

What the person starting this run expected, and why. Recorded at the start rather than the end on purpose: a hypothesis written after seeing the result is a conclusion.

tags: Vec<String>

Free-form labels for filtering run listings.

notes: Option<String>

Free-form notes attached at run start.

parent_run_id: Option<String>

Run this one derives from — the edge the experiment pool’s lineage is built on. Set explicitly, never inferred.

graph: Option<GraphSummaryInfo>

Compact description of the executed graph, absent for graph-less runs (e.g. a study run).

study_path: Option<String>

Relative path to study.json for study runs.

Implementations

impl RunManifest

pub fn new( run_id: impl Into<String>, kind: RunKind, name: impl Into<String>, ) -> Self

Minimal manifest; callers fill in environment fields.

Trait Implementations

impl Clone for RunManifest

fn clone(&self) -> RunManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunManifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunManifest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RunManifest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.