Add support for out-of-band topics

Author: prestist

README.md

@@ -16,6 +16,42 @@ Steps to run the meeting
 
 Working days: non-holiday weekdays. Relevant holidays are the national holidays of the USA, Western Europe, and India.
 
+# Tips
+
+## Submitting Out-of-Band Topics
+
+Out-of-band topics allow you to include discussion items from external sources (like RHCOS, other projects, or any URL) in the FCOS meeting without creating issues in the fedora-coreos-tracker repository.
+
+### How to Submit an Out-of-Band Topic:
+
+1. **Create a new issue** in this repository (`fcos-meeting-action`)
+2. **Add the label**: `out-of-band-topic`
+3. **Title your issue** with a descriptive meeting topic name
+4. **Add a URL** in the issue body pointing to the external resource you want to discuss
+
+**Example Issue:**
+```
+Title: Discuss new awesome feature
+Label: out-of-band-topic
+Body:
+https://github.com/coreos/placeholder/issues/456
+```
+
+### What Happens Next:
+
+- The action automatically includes your topic in the next meeting checklist
+- If the URL points to a GitHub issue, the action fetches the real issue title
+- If title fetching fails, your issue title is used instead
+- The trigger issue is automatically closed with a comment linking to the meeting checklist
+- Your external topic appears alongside regular tracker topics in the meeting agenda
+
+### Supported URLs:
+
+- GitHub issues (title auto-fetched)
+- Any other URL (uses your issue title)
+
+This feature is for discussing RHCOS topics, external dependencies, or one-time discussion items that might not make sense in the fedora-coreos-tracker repository
+
 # Development
 
 ## Prerequisites

dist/index.js

@@ -1,7 +1,15 @@
 import * as core from '@actions/core'
 import { Octokit } from 'octokit'
+import { OutOfBandTopic } from './meetingTopics'
 
-export async function createThisReposIssue(body: string): Promise<void> {
+export interface CreatedIssue {
+  number: number
+  url: string
+}
+
+export async function createThisReposIssue(
+  body: string
+): Promise<CreatedIssue | null> {
   try {
     const octokit = new Octokit({
       auth: process.env.GITHUB_TOKEN
@@ -15,14 +23,67 @@ export async function createThisReposIssue(body: string): Promise<void> {
     }
     const [owner, repo] = githubRepository.split(`/`)
 
-    await octokit.rest.issues.create({
+    const response = await octokit.rest.issues.create({
       owner,
       repo,
       title,
       body
     })
+
+    return {
+      number: response.data.number,
+      url: response.data.html_url
+    }
   } catch (error) {
     // Fail the workflow run if an error occurs
     if (error instanceof Error) core.setFailed(error.message)
   }
+  return null
+}
+
+export async function closeOutOfBandIssues(
+  outOfBandIssues: OutOfBandTopic[],
+  checklistIssue: CreatedIssue
+): Promise<void> {
+  if (outOfBandIssues.length === 0) {
+    return
+  }
+
+  try {
+    const octokit = new Octokit({
+      auth: process.env.GITHUB_TOKEN
+    })
+    const githubRepository = process.env.GITHUB_REPOSITORY
+    if (!githubRepository) {
+      throw new Error(`GITHUB_REPOSITORY environment variable is not set`)
+    }
+    const [owner, repo] = githubRepository.split(`/`)
+
+    for (const issue of outOfBandIssues) {
+      // Add comment to the issue
+      const comment = `This out-of-band topic has been added to the meeting checklist: ${checklistIssue.url}\n\nTopic: ${issue.title}\nExternal link: ${issue.url}`
+
+      await octokit.rest.issues.createComment({
+        owner,
+        repo,
+        issue_number: issue.issueNumber,
+        body: comment
+      })
+
+      // Close the issue
+      await octokit.rest.issues.update({
+        owner,
+        repo,
+        issue_number: issue.issueNumber,
+        state: 'closed'
+      })
+
+      console.log(`Closed out-of-band issue #${issue.issueNumber}`)
+    }
+  } catch (error) {
+    // Log error but don't fail the workflow
+    if (error instanceof Error) {
+      console.error(`Error closing out-of-band issues: ${error.message}`)
+    }
+  }
 }

src/createIssue.ts

@@ -1,7 +1,7 @@
 import * as core from '@actions/core'
 import { GetActionItems } from './actionItems'
 import { GetMeetingTopics } from './meetingTopics'
-import { createThisReposIssue } from './createIssue'
+import { createThisReposIssue, closeOutOfBandIssues } from './createIssue'
 import { GetAttendees } from './attendees'
 import fs from 'fs'
 
@@ -19,16 +19,25 @@ export async function run(): Promise<void> {
     console.log(actionItems)
 
     console.log('Get meeting topics')
-    const meetingTopics = await GetMeetingTopics()
-    console.log(meetingTopics)
+    const meetingTopicsResult = await GetMeetingTopics()
+    console.log(meetingTopicsResult.topics)
 
     const issueBody = hydrateIssueTemplate(
       attendees,
       actionItems,
-      meetingTopics
+      meetingTopicsResult.topics
     )
     console.log('Create issue')
-    createThisReposIssue(issueBody)
+    const createdIssue = await createThisReposIssue(issueBody)
+
+    // Close out-of-band issues if any were processed
+    if (createdIssue && meetingTopicsResult.outOfBandIssues.length > 0) {
+      console.log('Closing out-of-band issues')
+      await closeOutOfBandIssues(
+        meetingTopicsResult.outOfBandIssues,
+        createdIssue
+      )
+    }
   } catch (error) {
     // Fail the workflow run if an error occurs
     if (error instanceof Error) core.setFailed(error.message)