NAME

repomatic ci-status - Report which CI jobs are red, and which of them gate a merge

SYNOPSIS

repomatic ci-status [OPTIONS]

DESCRIPTION

Report the latest CI run of each workflow, and what is actually broken.

Reads jobs rather than runs, so a crashed allowed-failure probe cannot hide inside a green run conclusion and a run still reading "queued" cannot hide the dozen jobs of it that already finished.

A job whose name carries the unstable glyph anywhere is allowed to fail and never affects the exit code. Every other job is required, including the non-matrix ones that carry no glyph at all.

A run that was cancelled, or that ran no job, is reported as such and never as green: it has no result for its commit. A workflow that ran no job on the tip is read on the last commit whose run of it was not skipped.

OPTIONS

--branch TEXT

Branch whose latest run of each workflow to read.

--workflow WORKFLOW

Workflow file to read, repeatable. Defaults to every workflow a push can start, derived from .github/workflows/.
[values: autofix.yaml, autolock.yaml, cancel-runs.yaml, changelog.yaml, debug.yaml, docs.yaml, labels.yaml, lint.yaml, metrics.yaml, release.yaml, self-maintenance.yaml, tests.yaml, unsubscribe.yaml]

--fatal / --no-fatal

Exit non-zero when a required job failed.

--sort-by [workflow|commit|run-status|verdict]

Sort table by this column. Repeat to set priority.

--help / -h

Show this message and exit.

ENVIRONMENT

CI_STATUS_BRANCH

Branch whose latest run of each workflow to read.

CI_STATUS_WORKFLOWS

Workflow file to read, repeatable. Defaults to every workflow a push can start, derived from .github/workflows/.

CI_STATUS_FATAL

Exit non-zero when a required job failed.

CI_STATUS_SORT_BY

Sort table by this column. Repeat to set priority.

CI_STATUS__CLICK_DEFAULT_HELP

Show this message and exit.

EXIT STATUS

0

Success.

1

A runtime error, an aborted prompt (Ctrl-D), or a declined confirmation.

2

A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

130

Interrupted with Ctrl-C: the process ends by SIGINT, reported as 130.

EXAMPLES

What is red on main right now

repomatic ci\-status

One workflow, without failing the shell

repomatic ci\-status \-\-workflow tests.yaml \-\-no\-fatal

AUTHORS

Kevin Deldycke