Module runtime 

Phase-based scheduling and centralized runtime display.

Applications declare the complete config -> tasks -> phases -> runtime structure before execution. WorkflowRuntime schedules only those tasks, displays their lifecycle, and provides cooperative cancellation. Each task workload owns all scientific I/O, artifacts, recordings, and subprocesses.

use scientific_workflow::prelude::basics::*;
use scientific_workflow::prelude::runtime::*;

let project = ScientificProject::load("my-project")
    .map_err(|error| RuntimeError::TaskWorkload {
        task: "load-project".to_owned(),
        source: Box::new(error),
    })?;
let phase = Phase::builder(2, "simulation")
    .activity_tasks_from_project(&project, "prepare", |context| {
        context.set_detail("ready");
        Ok(())
    })
    .max_active_tasks(1)
    .prepared_task_queue_capacity(1)
    .build()?;
let summary = WorkflowRuntime::builder("execution-record.json")
    .phase(phase)
    .hidden()
    .build()?
    .run_phases([2])?;
assert!(summary.is_success());

Structs

ActivityTask

Non-clone task-local handle for lifecycle-only work.

CancellationToken

Shared, cheap cancellation observation for embedded schedulers and tasks.

ExecutionPlan

Complete serializable phase/task graph registered with one runtime.

ExecutionRecord

Durable lifecycle summary for one runtime invocation.

Phase

Immutable nonempty execution phase and reporter section.

PhaseBuilder

Builder for one nonempty first-class phase.

PhaseExecutionRecord

Lifecycle facts for one selected phase.

PhaseId

Stable numeric identity of one execution phase.

PhaseSummary

Terminal summary for one selected phase.

ProgressSummary

Immutable aggregate captured when centralized reporting ends.

RuntimeSummary

Immutable aggregate for a completed selected runtime plan.

Task

First-class immutable task declaration owned by exactly one Phase.

TaskContext

Read-only task identity/configuration plus reporting and cancellation.

TaskExecutionRecord

Lifecycle facts for one selected task.

TaskId

Stable task identity scoped to one phase.

TaskIdentity

Exact parameter-derived identity of one task.

TaskKey

Exact runtime task lookup key.

TaskProgress

Non-clone task-local progress handle.

TaskSelector

Exact partial selector over phase, task kind, and structured parameters.

WorkflowRuntime

Non-clone scheduler and display owner for one declared workflow plan.

WorkflowRuntimeBuilder

Builder for one immutable runtime plan.

Enums

PhaseFailurePolicy

Scheduling behavior after the first workload failure in a phase.

RuntimeError

Failure while planning, executing, or displaying a workflow runtime.

TaskDisplayKind

Reporting shape of one task.

TaskStatus

Lifecycle status of one independently executing scientific task.

Type Aliases

TaskResult

Error-erased result returned by one task-owned workload.