add sprint filter and support no time range to jira/grooming command

Author: jiajliu

PLUGINS.md

@@ -76,7 +76,7 @@ A plugin to automate tasks with Jira
 **Commands:**
 - **`/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
 - **`/jira:solve`** - Analyze a JIRA issue and create a pull request to solve it.
 - **`/jira:status-rollup` `issue-id [--start-date YYYY-MM-DD] [--end-date YYYY-MM-DD]`** - Generate a status rollup comment for any JIRA issue based on all child issues and a given date range
 

docs/data.json

@@ -76,8 +76,8 @@
         {
           "name": "grooming",
           "description": "Analyze new bugs and cards added over a time period and generate grooming meeting agenda",
-          "synopsis": "/jira:grooming [project-filter] [time-period] [--component component-name] [--label label-name]",
-          "argument_hint": "[project-filter] [time-period] [--component component-name] [--label label-name]"
+          "synopsis": "/jira:grooming [project-filter] [time-period] [--component component-name] [--label label-name] [--sprint sprint-name]",
+          "argument_hint": "[project-filter] [time-period] [--component component-name] [--label label-name] [--sprint sprint-name]"
         },
         {
           "name": "solve",

plugins/jira/commands/grooming.md

@@ -1,14 +1,14 @@
 ---
 description: Analyze new bugs and cards added over a time period and generate grooming meeting agenda
-argument-hint: [project-filter] [time-period] [--component component-name] [--label label-name]
+argument-hint: [project-filter] [time-period] [--component component-name] [--label label-name] [--sprint sprint-name]
 ---
 
 ## Name
 jira:grooming
 
 ## Synopsis
 ```
-/jira:grooming [project-filter] [time-period] [--component component-name] [--label label-name]
+/jira:grooming [project-filter] [time-period] [--component component-name] [--label label-name] [--sprint sprint-name]
 ```
 
 ## Description
@@ -81,6 +81,16 @@ The `jira:grooming` command runs in three main phases:
    /jira:grooming OCPSTRAT last-week --component "Control Plane" --label "performance"
    ```
 
+7. **Filter by sprint**:
+   ```
+   /jira:grooming OCPSTRAT "" --sprint "OTA 277"
+   ```
+
+8. **Combine sprint with other filters**:
+   ```
+   /jira:grooming OCPSTRAT "" --component "Cluster Version Operator" --sprint "OTA 277"
+   ```
+
 ## Output Format
 
 ### Grooming Meeting Agenda
@@ -136,10 +146,11 @@ The command outputs a ready-to-use Markdown document that can be copied into Con
     - `"OpenShift Virtualization,Red Hat OpenShift Control Planes"`  
       Default: read from configuration file
 
-- **$2 – time-period**  
-  Time range for issue collection.  
-  Options: `last-week` | `last-2-weeks` | `last-month` | `YYYY-MM-DD:YYYY-MM-DD`  
+- **$2 – time-period**
+  Time range for issue collection.
+  Options: `last-week` | `last-2-weeks` | `last-month` | `YYYY-MM-DD:YYYY-MM-DD` | `""` (empty string for no time filter)
   Default: `last-week`
+  Note: To query all issues without time filtering, pass an empty string `""`
 
 - **--component** *(optional)*
   Filter by JIRA component (single or comma-separated).
@@ -153,6 +164,11 @@ The command outputs a ready-to-use Markdown document that can be copied into Con
     - `--label "technical-debt"`
     - `--label "performance,security"`
 
+- **--sprint** *(optional)*
+  Filter by JIRA sprint name.
+  Examples:
+    - `--sprint "OTA 277"`
+
 ## Return Value
 - **Markdown Report**: Ready-to-use grooming agenda with categorized issues and action items