cli

func Execute ¶

func Execute() int

Execute runs the root command using stdout/stderr and returns the POSIX exit code. It is the only function main() calls.

If the verb returns a typed *errs.Error, Execute reports its Code via the exit-code taxonomy (§4.2 of the spec). Untyped errors fall back to CodeUser (1).

func Heartbeat ¶

func Heartbeat(out io.Writer, ch <-chan jobs.Event) error

Heartbeat consumes a job Event channel and prints CLI-friendly lines to out. It returns the job's terminal error (nil on success) so callers can propagate failures to the process exit code.

func NewRoot ¶

func NewRoot(out, err io.Writer) *cobra.Command

NewRoot builds a fresh root command. Out and Err allow tests to capture output.