cpu-sig-tracker - Man Page

cpu-sig-tracker config [-h|--help]

Set up GitLab and JIRA authentication tokens

-h, --help

Print help

cpu-sig-tracker dump-inventory [-r|--release] <-o|--output> [--koji-profile] [--prune] [-v|--verbose] [-h|--help]

Enumerate packages in a proposed_updates Koji tag and emit a sandogasa-inventory TOML file

-r, --release <RELEASES>

CentOS release(s) to enumerate, e.g. "c10s" or "c9s,c10s" (CSV or repeated). The Koji tag queried per release is "proposed_updates<N>s-packages-main-release" where N is the major version digit

-o, --output <OUTPUT>

Output file (sandogasa-inventory TOML). If it exists, merge in the newly-discovered packages; existing entries are preserved

--koji-profile <KOJI_PROFILE> [default: cbs]

Koji CLI profile (cbs for CentOS Build System)

--prune

Drop packages from each workload that are no longer tagged in either the `-release` or `-testing` tag for that release. Orphan `[[package]]` entries (metadata blocks for packages no longer referenced by any workload) are left in place so user-entered fields aren't lost

-v, --verbose

Print progress to stderr

-h, --help

Print help

cpu-sig-tracker file-issue [--affected] [--expected-fix] [--jira] [--release] [--type] [--note] [--dry-run] [-v|--verbose] [-h|--help] <MR_URL>

File a tracking issue in the proposed_updates GitLab group for a given Merge Request URL

--affected <AFFECTED>

Affected (currently-tagged) NVR. If omitted, left blank in the issue body; can be filled in later

--expected-fix <EXPECTED_FIX>

Expected fix NVR once the MR lands and is built

--jira <JIRA>

Override the auto-extracted JIRA key (e.g. "RHEL-12345"). Useful when the MR description doesn't mention it verbatim

--release <RELEASE>

Override the release auto-derived from the MR target branch (e.g. `c10s`)

--type <ISSUE_TYPE>

Apply one of the proposed_updates type labels: enhancement, bugfix, arch-enablement, security

Possible values:

• enhancement
• bugfix
• arch-enablement
• security

--note <NOTE>

Free-form context note prepended to the issue body as a lead paragraph before the structured metadata

--dry-run

Print the issue that would be filed and exit without making any GitLab API calls

-v, --verbose

Print progress to stderr

-h, --help

Print help

<MR_URL>

Full Merge Request URL to track, e.g. `https://gitlab.com/redhat/centos-stream/rpms/xz/-/merge_requests/42`

cpu-sig-tracker retire [-y|--yes] [--force] [-v|--verbose] [-h|--help] <ISSUE_URL>

Close a tracking issue (retire-issue suggestion) after verifying JIRA is resolved and the build is untagged

-y, --yes

Skip the interactive confirmation prompt

--force

Skip the retire-issue precondition checks (JIRA resolved, build untagged). Use when the tool can't reach JIRA/Koji or when you're sure the conditions hold

-v, --verbose

Print progress to stderr

-h, --help

Print help

<ISSUE_URL>

Full tracking issue URL (either `/-/issues/<n>` or `/-/work_items/<n>` form)

cpu-sig-tracker status [-i|--inventory] [--release] [-p|--package] [--json] [--refresh] [--include-closed] [-v|--verbose] [-h|--help]

Report JIRA status and suggested next action for each active tracking issue

-i, --inventory <INVENTORY> [default: inventory.toml]

Path to the sandogasa-inventory TOML file

--release <RELEASE>

Restrict the check to a single release (e.g. `c10s`)

-p, --package <PACKAGES>

Narrow to specific packages (repeatable or CSV). When unset, every tracked package in scope is processed. Primarily useful with --refresh to skip the extra work-item-status probes for packages you don't care about

--json

Emit JSON instead of grouped text

--refresh

Rewrite tracking issue bodies to the standardized format, refreshing the MR state and JIRA status lines to their current values. Normalizes legacy bodies and keeps already-standard bodies up to date. Mutates GitLab state; off by default

--include-closed

With --refresh, also process closed tracking issues — backfill their start_date / due_date and reconcile their work-item status against the current JIRA resolution (e.g. Done → Won't do when JIRA was retroactively flipped). Body content is left alone. No-op without --refresh

-v, --verbose

Print progress to stderr

-h, --help

Print help

cpu-sig-tracker sync-issues [-i|--inventory] [--release] [--json] [-v|--verbose] [-h|--help]

Report which inventory packages have active, proposed, or missing tracking issues per release

-i, --inventory <INVENTORY> [default: inventory.toml]

Path to the sandogasa-inventory TOML file

--release <RELEASE>

Restrict the check to a single release (e.g. `c10s`). If omitted, every workload in the inventory is checked

--json

Emit a machine-readable JSON array instead of grouped text

-v, --verbose

Print progress to stderr

-h, --help

Print help

cpu-sig-tracker untag <--release> [-y|--yes] [--force] [-v|--verbose] [-h|--help] <TARGET>

Untag a proposed_updates build from its CBS -release tag after verifying the JIRA is resolved

--release <RELEASE>

CentOS release whose proposed_updates tags to untag from (`c9s`, `c10s`, …)

-y, --yes

Skip the interactive confirmation prompt

--force

Skip the JIRA-resolved precondition. Use when the tracking issue can't be located or you're sure the check would pass

-v, --verbose

Print progress to stderr

-h, --help

Print help

<TARGET>

Either a package name (e.g. `xz` — the tool discovers the currently-tagged NVR in `-release` and `-testing`) or a specific NVR (e.g. `xz-5.6.4-1~proposed.el10`)