feat(ci): add a backlog clean up bot

Author: dmitriyastapov

.github/scripts/backlog-cleanup.js

@@ -0,0 +1,244 @@
+/**
+ * GitHub Action script for managing issue backlog.
+ * 
+ * Behavior:
+ * - Pull Requests are skipped (only opened issues are processed)
+ * - Skips issues with 'to-be-discussed' label.
+ * - Closes issues with label 'awaiting-response' or without assignees, 
+ * with a standard closure comment.
+ * - Sends a Friendly Reminder comment to assigned issues without 
+ * exempt labels that have been inactive for 90+ days.
+ * - Avoids sending duplicate Friendly Reminder comments if one was 
+ * posted within the last 7 days.
+ * - Marks issues labeled 'questions' by adding the 'Move to Discussion' label.
+ * (Actual migration to Discussions must be handled manually.)
+ */
+
+constdedent=(strings, ...values)=>{
+constraw=typeofstrings==='string' ? [strings] : strings.raw;
+letresult='';
+raw.forEach((str,i)=>{
+result+=str+(values[i]||'');
+});
+constlines=result.split('\n');
+constminIndent=Math.min(...lines.filter(l=>l.trim()).map(l=>l.match(/^\s*/)[0].length));
+returnlines.map(l=>l.slice(minIndent)).join('\n').trim();
+};
+
+
+asyncfunctionaddMoveToDiscussionLabel(github,owner,repo,issue,isDryRun){
+consttargetLabel="Move to Discussion";
+
+consthasLabel=issue.labels.some(
+l=>l.name.toLowerCase()===targetLabel.toLowerCase()
+);
+
+if(hasLabel)returnfalse;
+
+if(isDryRun){
+console.log(`[DRY-RUN] Would add '${targetLabel}' to issue #${issue.number}`);
+returntrue;
+}
+
+try{
+awaitgithub.rest.issues.addLabels({
+ owner,
+ repo,
+issue_number: issue.number,
+labels: [targetLabel],
+});
+returntrue;
+
+}catch(err){
+console.error(`Failed to add label to #${issue.number}`,err);
+returnfalse;
+}
+}
+
+
+asyncfunctionfetchAllOpenIssues(github,owner,repo){
+constissues=[];
+letpage=1;
+
+while(true){
+try{
+constresponse=awaitgithub.rest.issues.listForRepo({
+ owner,
+ repo,
+state: 'open',
+per_page: 100,
+ page,
+});
+constdata=response.data||[];
+if(data.length===0)break;
+constonlyIssues=data.filter(issue=>!issue.pull_request);
+issues.push(...onlyIssues);
+if(data.length<100)break;
+page++;
+}catch(err){
+console.error('Error fetching issues:',err);
+break;
+}
+}
+returnissues;
+}
+
+
+asyncfunctionhasRecentFriendlyReminder(github,owner,repo,issueNumber,maxAgeMs){
+letcomments=[];
+letpage=1;
+
+while(true){
+const{ data }=awaitgithub.rest.issues.listComments({
+ owner,
+ repo,
+issue_number: issueNumber,
+per_page: 100,
+ page,
+});
+
+if(!data||data.length===0)break;
+comments.push(...data);
+if(data.length<100)break;
+page++;
+}
+
+constreminders=comments
+.filter(c=>
+c.user.login==='github-actions[bot]'&&
+c.body.includes('⏰ Friendly Reminder')
+)
+.sort((a,b)=>newDate(b.created_at)-newDate(a.created_at));
+
+if(reminders.length===0)returnfalse;
+
+constmostRecent=newDate(reminders[0].created_at);
+return(Date.now()-mostRecent.getTime())<maxAgeMs;
+}
+
+
+module.exports=async({ github, context, dryRun })=>{
+constnow=newDate();
+constthresholdDays=90;
+constexemptLabels=['Status: Community help needed','Status: Needs investigation'];
+constcloseLabels=['Status: Awaiting Response'];
+constquestionLabel='Type: Question';
+const{ owner, repo }=context.repo;
+constsevenDaysMs=7*24*60*60*1000;
+
+constisDryRun=dryRun==="1";
+if(isDryRun){
+console.log("DRY-RUN mode enabled — no changes will be made.");
+}
+
+lettotalClosed=0;
+lettotalReminders=0;
+lettotalSkipped=0;
+lettotalMarkedToMigrate=0;
+
+letissues=[];
+
+try{
+issues=awaitfetchAllOpenIssues(github,owner,repo);
+}catch(err){
+console.error('Failed to fetch issues:',err);
+return;
+}
+
+for(constissueofissues){
+constisAssigned=issue.assignees&&issue.assignees.length>0;
+constlastUpdate=newDate(issue.updated_at);
+constdaysSinceUpdate=Math.floor((now-lastUpdate)/(1000*60*60*24));
+
+if(issue.labels.some(label=>exemptLabels.includes(label.name))){
+totalSkipped++;
+continue;
+}
+
+if(issue.labels.some(label=>label.name===questionLabel)){
+constmarked=awaitaddMoveToDiscussionLabel(github,owner,repo,issue,isDryRun);
+if(marked)totalMarkedToMigrate++;
+continue;// Do not apply reminder logic
+}
+
+if(daysSinceUpdate<thresholdDays){
+totalSkipped++;
+continue;
+}
+
+if(issue.labels.some(label=>closeLabels.includes(label.name))||!isAssigned){
+
+if(isDryRun){
+console.log(`[DRY-RUN] Would close issue #${issue.number}`);
+totalClosed++;
+continue;
+}
+
+try{
+awaitgithub.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.',
+});
+awaitgithub.rest.issues.update({
+ owner,
+ repo,
+issue_number: issue.number,
+state: 'closed',
+});
+totalClosed++;
+}catch(err){
+console.error(`Error closing issue #${issue.number}:`,err);
+}
+continue;
+}
+
+if(isAssigned){
+
+if(awaithasRecentFriendlyReminder(github,owner,repo,issue.number,sevenDaysMs)){
+totalSkipped++;
+continue;
+}
+
+constassignees=issue.assignees.map(u=>`@${u.login}`).join(', ');
+constcomment=dedent`
+ ⏰ Friendly Reminder
+
+ Hi ${assignees}!
+
+ This issue has had no activity for ${daysSinceUpdate} days. If it's still relevant:
+ - Please provide a status update
+ - Add any blocking details
+ - Or label it 'Status: Awaiting Response' if you're waiting on something
+
+ This is just a reminder; the issue remains open for now.`;
+
+if(isDryRun){
+console.log(`[DRY-RUN] Would post reminder on #${issue.number}`);
+totalReminders++;
+continue;
+}
+
+try{
+awaitgithub.rest.issues.createComment({
+ owner,
+ repo,
+issue_number: issue.number,
+body: comment,
+});
+totalReminders++;
+}catch(err){
+console.error(`Error sending reminder for issue #${issue.number}:`,err);
+}
+}
+}
+
+console.log(dedent`
+ === Backlog cleanup summary ===
+ Total issues processed: ${issues.length}
+ Total issues closed: ${totalClosed}
+ Total reminders sent: ${totalReminders}
+ Total marked to migrate to discussions: ${totalMarkedToMigrate}
+ Total skipped: ${totalSkipped}`);
+};

.github/workflows/backlog-bot.yml

@@ -0,0 +1,33 @@
+name: "Backlog Management Bot"
+
+on:
+schedule:
+ - cron: '0 4 * * *'# Run daily at 4 AM UTC
+workflow_dispatch:
+inputs:
+dry-run:
+description: "Run without modifying issues"
+required: false
+default: "0"
+
+permissions: 
+issues: write
+discussions: write
+contents: read
+
+jobs:
+backlog-bot:
+name: "Check issues"
+runs-on: ubuntu-latest
+steps:
+ - name: Checkout repository
+uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+ - name: Run backlog cleanup script
+uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+with:
+github-token: ${{secrets.GITHUB_TOKEN }}
+script: |
+ const script = require('./.github/scripts/backlog-cleanup.js');
+ const dryRun = "${{github.event.inputs.dry-run }}"
+ await script({github, context, dryRun });