Module tasks 

Task execution and management module

This module provides the core types for task execution, matching the CUE schema.

Task API v2

Users annotate tasks with their type to unlock specific semantics:

• Task: Single command or script
• TaskGroup: Parallel execution (all children run concurrently)
• TaskList: Sequential execution (steps run in order)

Re-exports

pub use backend::BackendFactory;

pub use backend::HostBackend;

pub use backend::TaskBackend;

pub use backend::TaskExecutionContext;

pub use backend::create_backend;

pub use backend::create_backend_with_factory;

pub use backend::should_use_dagger;

pub use index::IndexedTask;

pub use index::TaskIndex;

pub use index::TaskPath;

pub use index::WorkspaceTask;

pub use output_refs::OutputRefResolver;

pub use output_refs::TaskOutputField;

pub use output_refs::TaskOutputRef;

pub use output_refs::has_output_refs;

pub use output_refs::process_output_refs;

pub use process_registry::global_registry;

pub use executor::*;

pub use graph::*;

Modules

backend

Task backend abstraction for different execution environments

cache

Task-level caching glue between the executor, cuenv_cas, and cuenv_vcs.

captures

Capture resolution for extracting regex matches from task output.

executor

Task executor for running tasks with environment support.

graph

Task graph builder using cuenv-task-graph.

index

output_refs

Task output reference processing.

process_registry

Global process registry for tracking and terminating spawned child processes.

Structs

DaggerCacheMount

Cache volume mount configuration for Dagger

DaggerSecret

Secret configuration for Dagger containers

DaggerTaskConfig

Dagger-specific task configuration

Mapping

Mapping of external output to local workspace path

ParamDef

Parameter definition for task arguments

ProjectReference

Cross-project input declaration

ResolvedArgs

Resolved task arguments ready for interpolation

RetryConfig

Retry configuration for failed tasks

Shell

Shell configuration for task execution (legacy, for backwards compatibility)

ShellOptions

Shell options for bash-like shells

SourceLocation

Source location metadata from CUE evaluation

Task

A single executable task

TaskCachePolicy

Cache policy controls for a single task.

TaskCapture

Regex capture definition for extracting values from task output

TaskCaptureRef

Reference to a captured value, resolved at runtime

TaskDependency

A task dependency - an embedded task reference with _name field When tasks reference other tasks directly in CUE (e.g., dependsOn: [build]), the Go bridge injects the _name field to identify the dependency.

TaskGroup

A parallel task group - all children run concurrently

TaskOutput

Reference to another task’s outputs within the same project

TaskParams

Task parameter definitions for CLI arguments

Tasks

Root tasks structure from CUE

Enums

CaptureSource

Source stream for regex capture extraction

Input

A single task input definition

ParamType

Parameter type for validation

ScriptShell

Shell interpreter for script-based tasks

TaskCacheMode

Cache mode for task result caching.

TaskNode

Union of all task types - explicit typing required in CUE

Type Aliases

TaskDefinitionDeprecated

Legacy alias for TaskNode

TaskListDeprecated

Legacy alias for TaskList (now just Vec)