Struct AlgorithmRunLedger 

pub struct AlgorithmRunLedger { /* private fields */ }

Validated immutable run identities and append-only lifecycle events.

The validated row collections cannot be mutated after construction:

use graphforge_knowledge::AlgorithmRunLedger;
let mut ledger = AlgorithmRunLedger::default();
ledger.runs.clear();

Implementations

impl AlgorithmRunLedger

pub fn new( runs: Vec<AlgorithmRun>, events: Vec<AlgorithmRunEvent>, ) -> Result<Self, KnowledgeError>

Validate and normalize complete run tables.

pub fn merge(&self, staged: &Self) -> Result<Self, KnowledgeError>

Merge immutable identities and events, rejecting conflicting reuse.

pub fn append_events( &self, appended: Vec<AlgorithmRunEvent>, ) -> Result<Self, KnowledgeError>

Append validated terminal events to this trusted ledger.

Public event fields are checked once on input. Existing run and event rows are immutable after construction, so the combined identity, ownership, time, start/terminal-count, ordering, and row-limit invariants are checked without repeating their row validators.

pub fn runs(&self) -> &[AlgorithmRun]

Run identities in canonical order.

pub fn events(&self) -> &[AlgorithmRunEvent]

Lifecycle events in canonical order.

pub fn into_runs(self) -> Vec<AlgorithmRun>

Consume the ledger and return its run identities.

pub fn into_events(self) -> Vec<AlgorithmRunEvent>

Consume the ledger and return its lifecycle events.

pub fn into_parts(self) -> (Vec<AlgorithmRun>, Vec<AlgorithmRunEvent>)

Consume the ledger and return both canonical row collections.

pub fn run(&self, run_uuid: Uuid) -> Option<&AlgorithmRun>

Locate one run.

pub fn events_for(&self, run_uuid: Uuid) -> Vec<AlgorithmRunEvent>

Return lifecycle events for one run in canonical order.

pub fn terminal_event(&self, run_uuid: Uuid) -> Option<&AlgorithmRunEvent>

Return the terminal event, when one exists.

pub fn run_batch(&self) -> Result<RecordBatch, KnowledgeError>

Encode the authoritative run table.

pub fn event_batch(&self) -> Result<RecordBatch, KnowledgeError>

Encode the authoritative event table.

pub fn from_batches( run_batches: &[RecordBatch], event_batches: &[RecordBatch], ) -> Result<Self, KnowledgeError>

Decode, validate, and normalize persisted tables.

Trait Implementations

impl Clone for AlgorithmRunLedger

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AlgorithmRunLedger

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

Formats the value using the given formatter.

impl Default for AlgorithmRunLedger

fn default() -> Self

Returns the “default value” for a type.

impl Eq for AlgorithmRunLedger

impl PartialEq for AlgorithmRunLedger

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AlgorithmRunLedger