chore: enforce planning label rules for issues (#421)

related: #327

This new GitHub Actions workflow listens for the 'opened' and 'labeled' events on GitHub issues and ensures any issue opened (or labelled) with a `kind/plan-xxx` label meets the following criteria:
- only users listed in the `AUTHORIZED_USER` JSON array can label an issue with the `kind/plan-xxx` label
- at most one of the `kind/plan-xxx` labels can exist on a given issue

The set of supported/expected `kind/plan-xxx` labels are:
- `kind/plan-epic`
- `kind/plan-feature`
- `kind/plan-task`

If an issue (with a `kind/plan-xxx` label) is **opened** by a non-authorized user - the issue will be automatically closed when the GitHub action fires.

If an issue is labelled with the `kind/plan-xxx` label by an unauthorized user - the `kind/plan-xxx` label is removed.

In both cases, a GitHub comment is added to the issue explaining why the issue was updated by the bot.

Please note, when opening a GH issue - **BOTH** the `opened` and `labeled` events will fire (if the issue has a label on it).  As such, the GitHub action in this PR was deliberately structured to account for multiple instances running in parallel on the same underlying GitHub issue.

Also, this work complements #361 - which defines GH issue templates that use the labels in a manner appropriate to satisfy the checks of this action.

Signed-off-by: Andy Stoneberg <astonebe@redhat.com>
This commit is contained in:
Andy Stoneberg 2025-07-24 16:41:01 -04:00 committed by GitHub
parent 616d1a8c38
commit 73cac8126f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 126 additions and 0 deletions

View File

@ -0,0 +1,126 @@
name: Validate Planning Issue
on:
issues:
types: [opened, labeled]
env:
AUTHORIZED_USERS: '["thesuperzapper", "ederign", "andyatmiami", "paulovmr", "jenny_s51", "harshad16", "thaorell", "kimwnasptd"]'
permissions:
issues: write
jobs:
validate-issue:
if: |
(github.event.action == 'labeled' && (github.event.label.name == 'kind/plan-epic' || github.event.label.name == 'kind/plan-feature' || github.event.label.name == 'kind/plan-task')) ||
(github.event.action == 'opened' && (contains(github.event.issue.labels.*.name, 'kind/plan-epic') || contains(github.event.issue.labels.*.name, 'kind/plan-feature') || contains(github.event.issue.labels.*.name, 'kind/plan-task')))
runs-on: ubuntu-latest
steps:
- name: Log trigger
uses: actions/github-script@v7
with:
script: |
console.log(`Action triggered by: ${context.eventName} event with action: ${context.payload.action}`);
if (context.payload.action === 'labeled') {
console.log(`Label added: ${context.payload.label.name}`);
} else if (context.payload.action === 'opened') {
console.log(`Issue opened with labels: ${context.payload.issue.labels.map(l => l.name).join(', ')}`);
}
- name: Handle labeled action
if: github.event.action == 'labeled'
uses: actions/github-script@v7
with:
script: |
const AUTHORIZED_USERS = JSON.parse(process.env.AUTHORIZED_USERS);
const actor = context.actor;
const issueNumber = context.issue.number;
const addedLabel = context.payload.label.name;
// First check user authorization
if (!AUTHORIZED_USERS.includes(actor)) {
// Remove the planning label
await github.rest.issues.removeLabel({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
name: addedLabel
});
// Add a comment explaining why the label was removed
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
body: `@${actor} You are not authorized to add planning labels. Only authorized users can add planning labels to issues.`
});
core.setFailed(`User ${actor} is not authorized to add planning labels`);
}
console.log(`User ${actor} is authorized to add planning labels`);
// Then check planning label requirements
const { data: issue } = await github.rest.issues.get({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber
});
const currentLabels = issue.labels.map(label => label.name);
const planningLabels = ['kind/plan-epic', 'kind/plan-feature', 'kind/plan-task'];
const presentPlanningLabels = currentLabels.filter(label => planningLabels.includes(label));
if (presentPlanningLabels.length !== 1) {
// Remove the planning label
await github.rest.issues.removeLabel({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
name: addedLabel
});
// Add a comment explaining why the label was removed
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
body: `@${actor} Planning labels require exactly one planning label to be present: ${planningLabels.join(', ')}. Please ensure only one planning label is applied.`
});
core.setFailed(`Planning labels require exactly one of: ${planningLabels.join(', ')}`);
}
console.log(`Issue has valid planning label: ${presentPlanningLabels[0]}`);
- name: Handle opened action
if: github.event.action == 'opened'
uses: actions/github-script@v7
with:
script: |
const AUTHORIZED_USERS = JSON.parse(process.env.AUTHORIZED_USERS);
const actor = context.actor;
const issueNumber = context.issue.number;
if (!AUTHORIZED_USERS.includes(actor)) {
// Add a comment explaining why the issue will be closed
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
body: `@${actor} You are not authorized to create planning issues. Only authorized users can create planning issues.`
});
// Close the issue
await github.rest.issues.update({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: issueNumber,
state: 'closed'
});
core.setFailed(`User ${actor} is not authorized to create planning issues`);
}
console.log(`User ${actor} is authorized to create planning issues`);