ciselect

Overview ¶

Command ciselect decides which CI work a change set requires.

It reads .github/ci-components.yml, matches each changed path against the component table, and reports the union of the gates those components need. A path that matches nothing enables every gate: the table is an allowlist of provably-skippable paths, so an unrecognised path is always treated as potentially affecting everything.

Usage:

ciselect -changed-files <file> -github-output   # KEY=true|false lines
ciselect -changed-files <file> -json            # full verdict
ciselect -changed-files <file> -explain         # human-readable, for job summaries
ciselect -changed-files <file> -contrib-modules # module dirs, or ALL

With no -changed-files, the list is read from stdin. An empty list means "unknown", which enables every gate.