payload-revert

Name

ci:payload-revert

Synopsis

/ci:payload-revert <payload-tag>

Description

The ci:payload-revert command reads the payload results YAML produced by /ci:payload-analysis and stages reverts for all high-confidence candidates (confidence score >= 85) that have not already been reverted.

For each qualifying candidate, it creates a TRT JIRA bug, opens a revert PR, and triggers payload validation jobs using the stage-payload-reverts skill.

This command is one of three composable stages in the payload triage pipeline:

1. /ci:payload-analysis — produces the payload results YAML
2. /ci:payload-revert — stages reverts for HIGH confidence candidates (this command)
3. /ci:payload-experiment — opens draft revert PRs for MEDIUM confidence candidates

Job Triggering Limits

• Non-aggregated jobs: Up to 5 total across all candidates
• Aggregated jobs: Up to 1 total

When the number of failing jobs across all candidates exceeds these limits, prioritize jobs from higher-confidence candidates first.

Implementation

1. Parse the payload tag from the argument. Extract version, stream, and architecture from the tag (see payload-analysis Step 1 for parsing rules).

2. Read the payload results YAML using the payload-results-yaml skill: Look for payload-results-{tag}.yaml in the current working directory. If not found, print an error and exit:

   Error: Payload results YAML not found for {payload_tag}.
   Run `/ci:payload-analysis {payload_tag}` first to generate it.
   

3. Filter candidates: Select type: "pr" candidates with confidence_score >= 85. Exclude any that already have an action with status of "open" or "merged" (pre-existing revert). type: "rhcos_rpm" candidates are never reverted — they cannot be pulled out of a payload like a PR; the payload-results-yaml skill's Read Candidates operation excludes them for this reason.

4. Dispatch to stage-payload-reverts skill: Pass all qualifying candidates with their context (results YAML path, payload tag, version, stream, architecture, release controller URL, and failing jobs). The skill updates the results YAML and HTML report in place. The trigger-payload-job skill validates that aggregated jobs have underlying_job_name set and skips them with an error if not.