Skip to content

Conversation

@jiajliu
Copy link

@jiajliu jiajliu commented Oct 30, 2025

What this PR does / why we need it:

The grooming command is helpful for QE grooming tasks. This pull request adds support for sprint filter, enabling list generation based on sprint names. Additionally, the time-period argument can now be left empty, allowing for an unlimited time range.

  • Add --sprint parameter to filter issues by sprint name
  • Update argument hint and synopsis to include sprint option
  • Clarify that empty string "" can be passed for time-period to disable time filtering

Checklist:

  • Subject and description added to both, commit and PR.
  • Relevant issues have been referenced.
  • This change includes docs.

@openshift-ci openshift-ci bot requested review from bentito and bryan-cox October 30, 2025 02:44
@bryan-cox
Copy link
Contributor

/approve

@openshift-ci
Copy link

openshift-ci bot commented Oct 30, 2025

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: bryan-cox, jiajliu

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci openshift-ci bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Oct 30, 2025
@jiajliu jiajliu changed the title [jira/grooming] add spint filter and support no time range to grooming command [jira/grooming] add sprint filter and support no time range to grooming command Nov 3, 2025
- **`/jira:create` `<type> [project-key] <summary> [--component <name>] [--version <version>] [--parent <key>]`** - Create Jira issues (story, epic, feature, task, bug) with proper formatting
- **`/jira:generate-test-plan` `[JIRA issue key] [GitHub PR URLs]`** - Generate test steps for a JIRA issue
- **`/jira:grooming` `[project-filter] [time-period] [--component component-name] [--label label-name]`** - Analyze new bugs and cards added over a time period and generate grooming meeting agenda
- **`/jira:grooming` `[project-filter] [time-period] [--component component-name] [--label label-name] [--sprint sprint-name]`** - Analyze new bugs and cards added over a time period and generate grooming meeting agenda
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IMHO, the sprint name also represents a time range, so I think we can merge it with the time-period field.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

E.g

/jira:grooming OCPSTRAT "OTA 277" --component "Control Plane" --label "performance"

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good to know that a string name could be provided in time-period field, but according to my local testing, they returned different results.

  1. /jira:grooming OCPBUGS "" --component "Cluster Version Operator" --sprint "OTA 277"
    It retrieves and returns the bugs(such as OCPBUGS-61872 and OCPBUGS-54151), which is consistent with jira’s Sprint "OTA 277".
...
  - OCPBUGS-61872: https://issues.redhat.com/browse/OCPBUGS-61872
  - OCPBUGS-54151: https://issues.redhat.com/browse/OCPBUGS-54151
  - CI Logs: Available in issue OCPBUGS-61872 additional info section

● ---
  The grooming agenda has been generated successfully for sprint OTA 277 with the Cluster Version Operator
  component in the OCPBUGS project. The sprint shows excellent completion with both bugs resolved:
...
  1. /jira:grooming OCPBUGS "OTA 277" --component "Cluster Version Operator"
    It retrieves a time range (September 16 - October 6, 2025) according to provided string "OTA 277." Then, it will identify and return bugs(such as OCPBUGS-62416 and OCPBUGS-61872), that were created during this period but are not consistent with jira's Sprint "OTA 277".
...
  Summary: During the OTA 277 sprint (Sept 16 - Oct 6, 2025), only 2 new bugs were created for the Cluster
  Version Operator component, and both have already been verified and closed. This indicates excellent sprint
  execution with 100% completion rate.

  The agenda includes:
  - Detailed analysis of both issues (OCPBUGS-61872 and OCPBUGS-62416)
...

From the QE side, what we need is the result returned from the first example. It can help us plan and participate in sprint work effectively.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IIUC, this would require changes to the implementation to support it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants