Struct CheckpointBuilder 

pub struct CheckpointBuilder { /* private fields */ }

Builder for creating pipeline checkpoints.

Provides a convenient interface for capturing all necessary state when creating checkpoints during pipeline execution.

Example

let checkpoint = CheckpointBuilder::new()
    .phase(PipelinePhase::Development, 3, 5)
    .reviewer_pass(1, 2)
    .capture_from_config(&ctx, &registry, "claude", "codex")
    .build();

Implementations

impl CheckpointBuilder

pub fn new() -> Self

Create a new checkpoint builder with default values.

pub fn phase( self, phase: PipelinePhase, iteration: u32, total_iterations: u32, ) -> Self

Set the phase and iteration information.

pub fn reviewer_pass(self, pass: u32, total: u32) -> Self

Set the reviewer pass information.

pub fn agents(self, developer: &str, reviewer: &str) -> Self

Set the agent names.

pub fn cli_args(self, args: CliArgsSnapshot) -> Self

Set the CLI arguments snapshot.

pub fn developer_config(self, config: AgentConfigSnapshot) -> Self

Set the developer agent configuration snapshot.

pub fn reviewer_config(self, config: AgentConfigSnapshot) -> Self

Set the reviewer agent configuration snapshot.

pub fn rebase_state(self, state: RebaseState) -> Self

Set the rebase state.

pub fn config_path(self, path: Option<PathBuf>) -> Self

Set the config path.

pub fn git_identity(self, name: Option<&str>, email: Option<&str>) -> Self

Set the git user name and email.

pub fn skip_rebase(self, value: bool) -> Self

Set the skip_rebase flag for CLI args capture.

pub fn with_executor(self, executor: Arc<dyn ProcessExecutor>) -> Self

Set the process executor for external process execution.

pub fn capture_cli_args(self, config: &Config) -> Self

Capture CLI arguments from a Config.

pub fn capture_from_context( self, config: &Config, registry: &AgentRegistry, developer_name: &str, reviewer_name: &str, logger: &Logger, run_context: &RunContext, ) -> Self

Capture all configuration from a PhaseContext and AgentRegistry.

This is a convenience method that captures CLI args and both agent configs. It takes a PhaseContext which provides access to config, registry, and agents.

pub fn with_executor_from_context( self, executor_arc: Arc<dyn ProcessExecutor>, ) -> Self

Set the executor from a PhaseContext.

This is a convenience method that extracts the executor_arc from PhaseContext and sets it for the checkpoint builder.

pub fn with_execution_history(self, history: ExecutionHistory) -> Self

Attach execution history from a PhaseContext.

This method captures the execution history from the phase context and attaches it to the checkpoint.

pub fn with_prompt_history(self, history: HashMap<String, String>) -> Self

Set the entire prompt history from a HashMap.

This is useful when transferring prompts from a PhaseContext.

Arguments

• history - HashMap of prompt keys to prompt text

pub fn build(self) -> Option<PipelineCheckpoint>

Build the checkpoint without workspace.

Returns None if required fields (phase, agent configs) are missing. Generates a new RunContext if not set.

This method uses CWD-relative file operations for file state capture. For pipeline code where a workspace is available, prefer build_with_workspace().

pub fn build_with_workspace( self, workspace: &dyn Workspace, ) -> Option<PipelineCheckpoint>

Build the checkpoint with workspace-aware file capture.

Returns None if required fields (phase, agent configs) are missing. Generates a new RunContext if not set.

This method uses the workspace abstraction for file state capture, which is the preferred approach for pipeline code. The workspace provides:

• Explicit path resolution relative to repo root
• Testability via MemoryWorkspace in tests

Trait Implementations

impl Default for CheckpointBuilder

fn default() -> Self

Returns the “default value” for a type.