pub fn set_total(total: u32)
Set (or update) the total without resetting the current step. Used by pipeline code that discovers the real total mid-flight (e.g. after counting delta candidates).