feat(ci): migrate issue to discusion

Author: Samuel Fialka

.github/scripts/backlog-cleanup.js

@@ -10,6 +10,7 @@
  *   exempt labels that have been inactive for 90+ days.
  * - Avoids sending duplicate Friendly Reminder comments if one was 
  *   posted within the last 7 days.
+ * - Moves issues labeled 'questions' to GitHub Discussions
  */
 
 const dedent = (strings, ...values) => {
@@ -28,68 +29,112 @@ async function fetchAllOpenIssues(github, owner, repo) {
     let page = 1;
 
     while (true) {
-        const response = await github.rest.issues.listForRepo({
+        try {
+            const response = await github.rest.issues.listForRepo({
+                owner,
+                repo,
+                state: 'open',
+                per_page: 100,
+                page,
+            });
+            const data = response.data || [];
+            if (data.length === 0) break;
+            const onlyIssues = data.filter(issue => !issue.pull_request);
+            issues.push(...onlyIssues);
+            if (data.length < 100) break;
+            page++;
+        } catch (err) {
+            console.error('Error fetching issues:', err);
+            break;
+        }
+    }
+    return issues;
+}
+
+
+async function migrateToDiscussion(github, owner, repo, issue, categories) {
+    const discussionCategory = 'Q&A';
+    try {
+        const category = categories.find(cat =>
+            cat.name.toLowerCase() === discussionCategory.toLowerCase()
+        );
+        if (!category) {
+            throw new Error(`Discussion category '${discussionCategory}' not found.`);
+        }
+        const { data: discussion } = await github.rest.discussions.create({
             owner,
             repo,
-            state: 'open',
-            per_page: 100,
-            page,
+            title: issue.title,
+            body: `Originally created by @${issue.user.login} in #${issue.number}\n\n---\n\n${issue.body || ''}`,
+            category_id: category.id,
         });
-
-        const data = response.data || [];
-        if (data.length === 0) break;
-        const onlyIssues = data.filter(issue => !issue.pull_request);
-        issues.push(...onlyIssues);
-
-        if (data.length < 100) break;
-        page++;
+        await github.rest.issues.createComment({
+            owner,
+            repo,
+            issue_number: issue.number,
+            body: `💬 This issue was moved to [Discussions](${discussion.html_url}) for better visibility.`,
+        });
+        await github.rest.issues.update({
+            owner,
+            repo,
+            issue_number: issue.number,
+            state: 'closed',
+        });
+        return discussion.html_url;
+    } catch (err) {
+        console.error(`Error migrating issue #${issue.number} to discussion:`, err);
+        return null;
     }
-    return issues;
 }
 
+
 const shouldSendReminder = (issue, exemptLabels, closeLabels) => {
-  const hasExempt = issue.labels.some(l => exemptLabels.includes(l.name));
-  const hasClose = issue.labels.some(l => closeLabels.includes(l.name));
-  return issue.assignees.length > 0 && !hasExempt && !hasClose;
+    const hasExempt = issue.labels.some(l => exemptLabels.includes(l.name));
+    const hasClose = issue.labels.some(l => closeLabels.includes(l.name));
+    return issue.assignees.length > 0 && !hasExempt && !hasClose;
 };
 
 
 module.exports = async ({ github, context }) => {
+    let categories = [];
+    try {
+        const { data } = await github.rest.discussions.listCategories({ owner, repo });
+        categories = data;
+    } catch (err) {
+        console.error('Error fetching discussion categories:', err);
+    }
     const { owner, repo } = context.repo;
-    const issues = await fetchAllOpenIssues(github, owner, repo);
+    let issues = [];
+    try {
+        issues = await fetchAllOpenIssues(github, owner, repo);
+    } catch (err) {
+        console.error('Failed to fetch issues:', err);
+        return;
+    }
     const now = new Date();
     const thresholdDays = 90;
-    const exemptLabels = ['to-be-discussed'];
-    const closeLabels = ['awaiting-response'];
+    const exemptLabels = ['Status: Community help needed', 'Status: Needs investigation'];
+    const closeLabels = ['Status: Awaiting Response'];
+    const discussionLabel = 'Type: Question';
     const sevenDays = 7 * 24 * 60 * 60 * 1000;
 
     let totalClosed = 0;
     let totalReminders = 0;
     let totalSkipped = 0;
+    let totalMigrated = 0;    
 
     for (const issue of issues) {
         const isAssigned = issue.assignees && issue.assignees.length > 0;
         const lastUpdate = new Date(issue.updated_at);
         const daysSinceUpdate = Math.floor((now - lastUpdate) / (1000 * 60 * 60 * 24));
 
-        if (daysSinceUpdate < thresholdDays) {
-            totalSkipped++;
+        if (issue.labels.some(label => label.name === discussionLabel)) {
+            const migrated = await migrateToDiscussion(github, owner, repo, issue, categories);
+            if (migrated) totalMigrated++;
             continue;
         }
 
-        const { data: comments } = await github.rest.issues.listComments({
-            owner,
-            repo,
-            issue_number: issue.number,
-            per_page: 10,
-        });
-
-        const recentFriendlyReminder = comments.find(comment =>
-            comment.user.login === 'github-actions[bot]' &&
-            comment.body.includes('⏰ Friendly Reminder') &&
-            (now - new Date(comment.created_at)) < sevenDays
-        );
-        if (recentFriendlyReminder) {
+        if (daysSinceUpdate < thresholdDays) {
             totalSkipped++;
             continue;
         }
@@ -100,19 +145,45 @@ module.exports = async ({ github, context }) => {
         }
 
         if (issue.labels.some(label => closeLabels.includes(label.name)) || !isAssigned) {
-            await github.rest.issues.createComment({
-                owner,
-                repo,
-                issue_number: issue.number,
-                body: '⚠️ This issue was closed automatically due to inactivity. Please reopen or open a new one if still relevant.',
-            });
-            await github.rest.issues.update({
+            try {
+                await github.rest.issues.createComment({
+                    owner,
+                    repo,
+                    issue_number: issue.number,
+                    body: '⚠️ This issue was closed automatically due to inactivity. Please reopen or open a new one if still relevant.',
+                });
+                await github.rest.issues.update({
+                    owner,
+                    repo,
+                    issue_number: issue.number,
+                    state: 'closed',
+                });
+                totalClosed++;
+            } catch (err) {
+                console.error(`Error closing issue #${issue.number}:`, err);
+            }
+            continue;
+        }
+
+        let comments = [];
+        try {
+            const { data } = await github.rest.issues.listComments({
                 owner,
                 repo,
                 issue_number: issue.number,
-                state: 'closed',
+                per_page: 50,
             });
-            totalClosed++;
+            comments = data;
+        } catch (err) {
+            console.error(`Error fetching comments for issue #${issue.number}:`, err);
+        }
+
+        const recentFriendlyReminder = comments.find(comment =>
+            comment.user.login === 'github-actions[bot]' &&
+            comment.body.includes('⏰ Friendly Reminder')
+        );
+        if (recentFriendlyReminder) {
+            totalSkipped++;
             continue;
         }
 
@@ -129,14 +200,17 @@ module.exports = async ({ github, context }) => {
                 - Or label it 'awaiting-response' if you're waiting on something
 
                 This is just a reminder; the issue remains open for now.`;
-
-            await github.rest.issues.createComment({
-                owner,
-                repo,
-                issue_number: issue.number,
-                body: comment,
-            });
-            totalReminders++;
+            try {
+                await github.rest.issues.createComment({
+                    owner,
+                    repo,
+                    issue_number: issue.number,
+                    body: comment,
+                });
+                totalReminders++;
+            } catch (err) {
+                console.error(`Error sending reminder for issue #${issue.number}:`, err);
+            }
         }
     }
 
@@ -145,5 +219,6 @@ module.exports = async ({ github, context }) => {
         Total issues processed: ${issues.length}
         Total issues closed: ${totalClosed}
         Total reminders sent: ${totalReminders}
+        Total migrated to discussions: ${totalMigrated}
         Total skipped: ${totalSkipped}`);
 };

.github/workflows/backlog-bot.yml

@@ -2,10 +2,11 @@ name: "Backlog Management Bot"
 
 on:
   schedule:
-    - cron: '0 2 * * *' # Run daily at 2 AM UTC
+    - cron: '0 4 * * *' # Run daily at 4 AM UTC
 
 permissions: 
   issues: write
+  discussions: write
   contents: read
 
 jobs:
@@ -14,10 +15,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
 
       - name: Run backlog cleanup script
-        uses: actions/github-script@v7
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |