add function to create issue for expired flags

Author: devopsdina

.github/workflows/test.yml

@@ -33,14 +33,19 @@ jobs:
   integration-test:
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: read
     steps:
       - uses: actions/checkout@v4
 
-      - name: Test the action
+      - name: Test the action with issue creation
         uses: ./
         with:
           launchdarkly_api_key: ${{ secrets.LAUNCHDARKLY_API_KEY }}
           project_key: ${{ vars.TEST_PROJECT_KEY || 'test-project' }}
           days_ahead: '30'
           include_past_due: 'true'
+          create_issues: 'true'
+          github_token: ${{ secrets.GITHUB_TOKEN }}
 

ISSUE_TEMPLATE.md

@@ -0,0 +1,26 @@
+# 🚨 Expired LaunchDarkly Feature Flag: {{flagName}}
+
+## Flag Details
+- **Flag Name**: `{{flagName}}`
+- **Flag Key**: `{{flagKey}}`
+- **Expired Date**: {{expiryDate}}
+- **Days Overdue**: {{daysOverdue}} days
+
+## Action Required
+This feature flag has expired and should be reviewed for cleanup.
+
+### Cleanup Steps
+- [ ] Review flag usage in codebase
+- [ ] Verify flag is no longer needed
+- [ ] Remove flag references from code
+- [ ] Archive flag in LaunchDarkly
+- [ ] Close this issue
+
+### Context
+This issue was automatically created by the [LaunchDarkly Feature Flag Expiry Audit Action](https://github.com/{{repoOwner}}/{{repoName}}/actions).
+
+**Project**: {{projectKey}}  
+**Audit Date**: {{auditDate}}
+
+---
+⚠️ **Important**: Please review this flag's usage before deletion to avoid breaking functionality.

README.md

@@ -10,6 +10,7 @@ A GitHub Action that audits LaunchDarkly feature flags with expiry dates stored
 - 📊 **Comprehensive Reporting**: Generates detailed summaries with flag names, keys, and expiry information
 - 🚨 **Past Due Identification**: Optionally includes flags that are already past their expiry date
 - 📝 **Multiple Date Formats**: Supports various date formats (MM/DD/YYYY, YYYY-MM-DD, etc.)
+- 🎫 **Automated Issue Creation**: Optionally creates GitHub issues for expired flags with task labels
 
 ## Usage
 
@@ -152,6 +153,34 @@ jobs:
             });
 ```
 
+### Using with Automatic Issue Creation
+
+```yaml
+name: Flag Cleanup with Issue Creation
+on:
+  schedule:
+    - cron: '0 9 * * 1' # Monday at 9 AM
+
+jobs:
+  audit-and-create-issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Audit flags and create issues
+        uses: your-org/ld-cp-exp-date-gh-actions-audit@v1
+        with:
+          launchdarkly_api_key: ${{ secrets.LAUNCHDARKLY_API_KEY }}
+          project_key: 'my-project'
+          days_ahead: '7'
+          include_past_due: 'true'
+          create_issues: 'true'
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+```
+
 ## Inputs
 
 | Input | Description | Required | Default |
@@ -160,7 +189,9 @@ jobs:
 | `project_key` | LaunchDarkly project key | Yes | |
 | `days_ahead` | Number of days ahead to check for expiring flags | No | `7` |
 | `include_past_due` | Include flags that are past their expiry date | No | `true` |
-| `custom_property_key` | Name of the custom property containing the expiry date | No | `flag.expiry.date` |
+| `custom_property_name` | Name of the custom property containing the expiry date | No | `flag.expiry.date` |
+| `create_issues` | Create GitHub issues for expired flags | No | `false` |
+| `github_token` | GitHub token for creating issues | No | `${{ secrets.GITHUB_TOKEN }}` |
 
 ## Outputs
 
@@ -208,6 +239,39 @@ The action supports multiple date formats:
 - `YYYY-MM-DD` (e.g., `2024-03-15`)
 - `YYYY/MM/DD` (e.g., `2024/03/15`)
 
+## GitHub Issue Creation
+
+The action can automatically create GitHub issues for expired flags using the `create_issues: 'true'` option.
+
+### Issue Template
+
+The action looks for an `ISSUE_TEMPLATE.md` file in your repository root. If not found, it uses a built-in template. You can customize the template with these placeholders:
+
+- `{{flagName}}` - The display name of the flag
+- `{{flagKey}}` - The flag key
+- `{{expiryDate}}` - The expiry date
+- `{{daysOverdue}}` - Number of days past expiry
+- `{{projectKey}}` - LaunchDarkly project key
+- `{{auditDate}}` - Date the audit was run
+- `{{repoOwner}}` - Repository owner
+- `{{repoName}}` - Repository name
+
+### Issue Features
+
+- **Duplicate Prevention**: Checks for existing open issues before creating new ones
+- **Auto-labeling**: Issues are labeled with `launchdarkly`, `expired-flag`, and `task`
+- **Task Checklist**: Includes cleanup steps as checkboxes
+- **Context Information**: Provides all necessary details for flag cleanup
+
+### Required Permissions
+
+To create issues, your workflow needs:
+```yaml
+permissions:
+  issues: write
+  contents: read
+```
+
 ## API Requirements
 
 ### LaunchDarkly API Token

action.yml

@@ -18,9 +18,16 @@ inputs:
     required: false
     default: 'true'
   custom_property_key:
-    description: 'Name of the custom property containing expiry date (default: flag.expiry.date)'
+    description: 'Key of the custom property containing expiry date (default: flag.expiry.date)'
     required: false
     default: 'flag.expiry.date'
+  create_issues:
+    description: 'Create GitHub issues for expired flags (default: false)'
+    required: false
+    default: 'false'
+  github_token:
+    description: 'GitHub token for creating issues (defaults to GITHUB_TOKEN)'
+    required: false
 
 outputs:
   expiring_flags:

dist/ISSUE_TEMPLATE.md

@@ -0,0 +1,26 @@
+# 🚨 Expired LaunchDarkly Feature Flag: {{flagName}}
+
+## Flag Details
+- **Flag Name**: `{{flagName}}`
+- **Flag Key**: `{{flagKey}}`
+- **Expired Date**: {{expiryDate}}
+- **Days Overdue**: {{daysOverdue}} days
+
+## Action Required
+This feature flag has expired and should be reviewed for cleanup.
+
+### Cleanup Steps
+- [ ] Review flag usage in codebase
+- [ ] Verify flag is no longer needed
+- [ ] Remove flag references from code
+- [ ] Archive flag in LaunchDarkly
+- [ ] Close this issue
+
+### Context
+This issue was automatically created by the [LaunchDarkly Feature Flag Expiry Audit Action](https://github.com/{{repoOwner}}/{{repoName}}/actions).
+
+**Project**: {{projectKey}}  
+**Audit Date**: {{auditDate}}
+
+---
+⚠️ **Important**: Please review this flag's usage before deletion to avoid breaking functionality.