Struct Job 

pub struct Job {
    pub id: JobId,
    pub capability: String,
    pub args: Value,
    pub state: JobState,
    pub created_at: u64,
    pub updated_at: u64,
    pub output: Option<Value>,
    pub error: Option<String>,
    pub dry_run: bool,
}

A tracked unit of work in the Runtimo runtime.

Jobs carry a capability name, serialized arguments, current state, timestamps, and optional output or error information.

Example

use runtimo_core::{Job, JobState};
use serde_json::json;

let mut job = Job::new("FileRead".into(), json!({"path": "/tmp/test.txt"}), false);
assert_eq!(job.state, JobState::Pending);

job.transition_to(JobState::Validating).unwrap();
assert_eq!(job.state, JobState::Validating);

Fields

id: JobId

Unique job identifier.

capability: String

Name of the capability to execute.

args: Value

Serialized capability arguments.

state: JobState

Current state in the job lifecycle.

created_at: u64

Unix timestamp (seconds) when the job was created.

updated_at: u64

Unix timestamp (seconds) of the last state change.

output: Option<Value>

Output data from successful execution (JSON).

error: Option<String>

Error message if the job failed.

dry_run: bool

Whether this job is a dry run.

Implementations

impl Job

pub fn new(capability: String, args: Value, dry_run: bool) -> Self

Creates a new job in the Pending state.

Arguments

• capability — Name of the capability to execute
• args — Serialized capability arguments
• dry_run — If true, skip side effects

pub fn transition_to(&mut self, new_state: JobState) -> Result<(), String>

Attempts to transition the job to a new state.

Only valid transitions are allowed (see JobState for the state machine). On success, updates updated_at to the current time.

Design Note

The state machine is expressed as a matches! macro for performance on this hot path. A const fn valid_transitions() or a lookup table would be more extensible but adds indirection. The explicit tuple match is O(1) and optimizes to a jump table. If clippy suggests match_like_matches_macro, this is intentional — the macro is already the most compact form.

Errors

Returns an error string describing the invalid transition.

Trait Implementations

impl Clone for Job

fn clone(&self) -> Job

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Job

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Job

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Job

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

where __S: Serializer,

Serialize this value into the given Serde serializer.