Module run 

Run command entrypoints and module wiring.

Responsibilities:

• Define the public commands::run API used by CLI and UI clients.
• Re-export stable types used across the crate (e.g., PhaseType).

Not handled here:

• Actual run loop implementation (see run_loop).
• Run-one orchestration (see run_one).
• Phase execution internals (see phases).
• Queue lock management (see queue_lock).
• Dry-run UX (see dry_run).

Invariants/assumptions:

• Public entrypoint signatures must remain stable for CLI and interactive flows.
• All orchestration logic lives in submodules; this file is a thin facade.

Re-exports

pub use crate::agent::AgentOverrides;

pub use parallel::state::ParallelStateFile;

pub use parallel::state::WorkerLifecycle;

pub use parallel::state::WorkerRecord;

pub use parallel::state::load_state;

pub use parallel::state::state_file_path;

Modules

parallel

Parallel run loop supervisor and worker orchestration for direct-push mode.

Structs

RunLoopOptions

Enums

RunOutcome

Outcome of a single task run.

Functions

dry_run_loop

Dry-run selection for ralph run loop --dry-run.

dry_run_one

Dry-run selection for ralph run one --dry-run.

parallel_retry

Retry a blocked or failed parallel worker.

parallel_status

Show status of parallel workers.

run_loop

run_one

Run the first available todo task.

run_one_parallel_worker

Run a specific task as a parallel worker (acquires queue lock, allows upstream creation).

run_one_with_id

Run a specific task by ID.

run_one_with_id_locked

Run a specific task when the queue lock is already held by the caller.