Struct TaskWorkspace 

pub struct TaskWorkspace { /* private fields */ }

An isolated workspace for running a benchmark task.

The workspace is created in a temporary directory with:

• Its own .git directory (isolated from main repo)
• A fresh .ralph/agent/scratchpad.md
• Copied setup files from the task definition

Implementations

impl TaskWorkspace

pub fn create( task: &TaskDefinition, base_dir: &Path, ) -> Result<Self, WorkspaceError>

Creates a new isolated workspace for the given task.

The workspace is created at: {base_dir}/ralph-bench-{task_name}-{timestamp}/

Arguments

• task - The task definition to create a workspace for
• base_dir - Base directory for workspaces (e.g., /tmp)

Errors

Returns WorkspaceError if directory creation or git init fails.

pub fn path(&self) -> &Path

Returns the path to the workspace root directory.

pub fn task_name(&self) -> &str

Returns the task name.

pub fn created_at(&self) -> u64

Returns the creation timestamp.

pub fn setup( &self, task: &TaskDefinition, tasks_dir: &Path, ) -> Result<(), WorkspaceError>

Sets up the workspace with files from the task definition.

This copies:

1. The prompt file as PROMPT.md
2. Any setup files specified in the task definition

Arguments

• task - The task definition containing setup configuration
• tasks_dir - Base directory where task files are located

Errors

Returns WorkspaceError if file copying fails.

pub fn cleanup(&mut self) -> Result<(), WorkspaceError>

Cleans up (removes) the workspace directory.

Errors

Returns WorkspaceError if removal fails.

pub fn is_cleaned_up(&self) -> bool

Returns true if the workspace has been cleaned up.

impl TaskWorkspace

pub fn run_verification( &self, verification: &Verification, ) -> Result<VerificationResult, WorkspaceError>

Runs a verification command in the workspace directory.

The command is executed via bash -c in the workspace’s root directory.

Arguments

• verification - The verification configuration with command and expected exit code

Returns

A VerificationResult indicating whether the command passed and capturing output.

Errors

Returns WorkspaceError::Verification if the command fails to execute (not the same as the command returning a non-zero exit code).

Trait Implementations

impl Debug for TaskWorkspace

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

Formats the value using the given formatter.

impl Drop for TaskWorkspace

fn drop(&mut self)

Executes the destructor for this type.