Struct LocalTracker 

pub struct LocalTracker { /* private fields */ }

A run directory under <root>/runs/<run_id>/.

create starts a new run (manifest + running status + fresh logs); open re-attaches to an existing directory for resume, continuing the event sequence where it left off.

Implementations

impl LocalTracker

pub fn create(root: impl AsRef<Path>, kind: RunKind, name: &str) -> Result<Self>

Create a new run directory under root (e.g. .soma) and write its manifest (environment fields best-effort) and running status.

pub fn open(run_dir: impl AsRef<Path>) -> Result<Self>

Re-attach to an existing run directory (resume). The event sequence continues after the last recorded line, and the status flips back to running.

Trait Implementations

impl Tracker for LocalTracker

fn run_id(&self) -> &str

Identifier of the run this tracker is bound to.

fn run_dir(&self) -> &Path

Root directory of the run (for file-based backends).

fn sink(&self) -> Arc<dyn EventSink>

The sink that persists events for this run.

fn save_manifest(&self, manifest: &RunManifest) -> Result<()>

Atomically write the manifest.

fn save_artifact(&self, rel_path: &str, bytes: &[u8]) -> Result<()>

Write an artifact at a path relative to the run directory, creating parent directories as needed.

fn save_study(&self, study: &Study) -> Result<()>

Atomically write study.json (tmp + rename — readers never see a partial study, and a crash mid-write preserves the previous complete version).

fn heartbeat(&self) -> Result<()>

Refresh heartbeat_at in the status file.

fn finalize(&self, state: RunState) -> Result<()>

Set the terminal state, stamp finished_at, and flush the sink.