progress

type Reporter interface {
	Start(label string) Step
	// StartConcurrent opens a set of steps that run and render together.
	// On a TTY they occupy a contiguous block of lines repainted in place
	// as each one changes — so several long-running operations (e.g. the
	// LookupService and SessionManager installs, which the operator
	// reconciles at the same time) animate side by side rather than one
	// appearing to finish before the other starts. On a non-TTY every
	// state change of every step appends its own line so the log stays
	// grep-able. The returned steps are safe to drive from separate
	// goroutines; the group serialises rendering internally. The caller
	// must close every returned step (Done or Fail).
	StartConcurrent(labels ...string) []Step
	// Note prints a one-off informational line outside the step counter
	// (used for things like 'syncing cached local secrets'). It does
	// not advance the step counter.
	Note(msg string)
}

type Step interface {
	Update(phase string)
	Done(summary string)
	Fail(err error)
}