Update label management for GitHub

Author: Ndpnt

src/reporter/github/index.js

@@ -63,7 +63,28 @@ export default class GitHub {
       }
 
       const updatedExistingLabels = labelsToRemove.length ? await this.getRepositoryLabels() : existingLabels; // Refresh labels after deletion, only if needed
-      const existingLabelsNames = updatedExistingLabels.map(label => label.name);
+      const managedLabelsNames = this.MANAGED_LABELS.map(label => label.name);
+
+      // Remove managed labels that are no longer in the MANAGED_LABELS list
+      const obsoleteManagedLabels = updatedExistingLabels.filter(label =>
+        label.description
+        && label.description.includes(MANAGED_BY_OTA_MARKER)
+        && !managedLabelsNames.includes(label.name));
+
+      if (obsoleteManagedLabels.length) {
+        logger.info(`Removing obsolete managed labels: ${obsoleteManagedLabels.map(label => `"${label.name}"`).join(', ')}`);
+
+        for (const label of obsoleteManagedLabels) {
+          await this.deleteLabel(label.name); /* eslint-disable-line no-await-in-loop */
+        }
+      }
+
+      // Refresh labels after obsolete removal
+      const finalExistingLabels = obsoleteManagedLabels.length ? await this.getRepositoryLabels() : updatedExistingLabels;
+      const existingLabelsNames = finalExistingLabels.map(label => label.name);
+      const existingLabelsMap = new Map(finalExistingLabels.map(label => [ label.name, label ]));
+
+      // Find labels that need to be created
       const missingLabels = this.MANAGED_LABELS.filter(label => !existingLabelsNames.includes(label.name));
 
       if (missingLabels.length) {
@@ -77,6 +98,31 @@ export default class GitHub {
           });
         }
       }
+
+      // Update existing labels if description changed
+      const labelsToUpdate = this.MANAGED_LABELS.filter(label => {
+        const existingLabel = existingLabelsMap.get(label.name);
+
+        if (!existingLabel) {
+          return false;
+        }
+
+        const expectedDescription = `${label.description} ${MANAGED_BY_OTA_MARKER}`;
+
+        return existingLabel.description !== expectedDescription || existingLabel.color !== label.color;
+      });
+
+      if (labelsToUpdate.length) {
+        logger.info(`Updating labels with changed descriptions: ${labelsToUpdate.map(label => `"${label.name}"`).join(', ')}`);
+
+        for (const label of labelsToUpdate) {
+          await this.updateLabel({ /* eslint-disable-line no-await-in-loop */
+            name: label.name,
+            color: label.color,
+            description: `${label.description} ${MANAGED_BY_OTA_MARKER}`,
+          });
+        }
+      }
     } catch (error) {
       logger.error(`Failed to handle repository labels: ${error.message}`);
     }
@@ -134,6 +180,15 @@ export default class GitHub {
     });
   }
 
+  async updateLabel({ name, color, description }) {
+    await this.octokit.request('PATCH /repos/{owner}/{repo}/labels/{name}', {
+      ...this.commonParams,
+      name,
+      color,
+      description,
+    });
+  }
+
   async getIssue(title) {
     return (await this.issues).get(title);
   }