Struct JobExecution 

pub struct JobExecution { /* private fields */ }

One launch or restart attempt for a JobInstance.

Implementations

impl JobExecution

pub const fn new( id: JobExecutionId, job_instance_id: JobInstanceId, metadata: ExecutionMetadata, ) -> Self

Constructs a job execution record from validated metadata.

pub const fn from_snapshot( id: JobExecutionId, job_instance_id: JobInstanceId, metadata: ExecutionMetadata, version: ExecutionVersion, ) -> Self

Reconstructs a job execution snapshot with its optimistic version.

pub const fn id(&self) -> JobExecutionId

Returns the attempt identifier.

pub const fn job_instance_id(&self) -> JobInstanceId

Returns the logical instance identifier.

pub const fn metadata(&self) -> &ExecutionMetadata

Borrows the execution metadata.

pub const fn version(&self) -> ExecutionVersion

Returns the facade-owned optimistic-lock version.

pub fn transition( &mut self, expected_version: ExecutionVersion, transition: LifecycleTransition, ) -> Result<ExecutionVersion, LifecycleError>

Applies one legal lifecycle transition using compare-and-swap semantics.

The transition never changes exit status. Restart requests from STOPPED or FAILED return LifecycleError::RestartRequiresNewAttempt.

Errors

Returns a typed stale-version, illegal-transition, timestamp, failure, or version-exhaustion error without mutating this snapshot.

pub fn enrich_exit_status( &mut self, expected_version: ExecutionVersion, exit_status: ExitStatus, ) -> Result<ExecutionVersion, LifecycleError>

Enriches flow/operator exit status without changing batch status.

Errors

Returns LifecycleError::StaleVersion or LifecycleError::VersionExhausted without mutating this snapshot.

pub fn new_restart_attempt( &self, expected_version: ExecutionVersion, new_execution_id: JobExecutionId, created_at: SystemTime, ) -> Result<Self, LifecycleError>

Creates a fresh STARTING attempt for the same logical job instance.

The prior execution remains unchanged. Definition-level restart permission is a repository/launcher concern layered on top of this status policy.

Errors

Returns a typed stale-version, non-restartable, or reused-ID error.

Trait Implementations

impl Clone for JobExecution

fn clone(&self) -> JobExecution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JobExecution

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

Formats the value using the given formatter.

impl Eq for JobExecution

impl PartialEq for JobExecution

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for JobExecution