Discussion management (#426)

Co-authored-by: Copilot <[email protected]>
Co-authored-by: Vito Tumas <[email protected]>

Author: 3 people

.github/scripts/filter-discussions-to-close.jq

@@ -0,0 +1,46 @@
+# Filter discussions that should be closed
+# A discussion should be closed if:
+# 1. It has a warning comment containing the unique marker
+# 2. That warning comment was posted by the bot
+# 3. That warning comment is older than WARNING_DAYS
+# 4. The discussion hasn't been updated since the warning (or updates are also old)
+#
+# Input: GraphQL response with discussions data
+# Arguments:
+#   $warningCutoff - ISO 8601 timestamp for warning age threshold
+#   $marker - Unique marker string to identify warning comments
+#   $botLogin - GitHub login of the bot user
+# Output: JSON objects (one per line) for discussions that should be closed
+
+.data.repository.discussions.nodes[]
+
+# Only process open discussions
+| select(.closed == false)
+
+# Store the discussion for later reference
+| . as $discussion
+
+# Find the most recent warning comment from the bot
+# Note: We only look at the last 100 comments (fetched by the shell script).
+# This is intentional - if there are 100+ comments after a warning, the discussion
+# is clearly active and should not be closed.
+| (
+    (.comments.nodes // [])
+    | map(
+        select(.body | contains($marker))
+        | select(.author.login == $botLogin)
+      )
+    | last
+  ) as $warningComment
+
+# Only proceed if a warning comment exists
+| select($warningComment != null)
+
+# Only proceed if the warning comment is old enough
+| select($warningComment.createdAt <= $warningCutoff)
+
+# Only proceed if the discussion hasn't been updated since the warning
+| select($discussion.updatedAt < $warningComment.createdAt)
+
+# Output as JSON
+| @json

.github/scripts/filter-discussions-to-warn.jq

@@ -0,0 +1,48 @@
+# Filter discussions that should receive a warning
+# A discussion should be warned if:
+# 1. It hasn't been updated in STALE_DAYS
+# 2. Either:
+#    a. It doesn't have a warning comment (with unique marker) from the bot yet, OR
+#    b. It has a warning from the bot but was updated after that warning (user responded, so we warn again)
+#
+# Input: GraphQL response with discussions data
+# Arguments:
+#   $staleCutoff - ISO 8601 timestamp for staleness threshold
+#   $marker - Unique marker string to identify warning comments
+#   $botLogin - GitHub login of the bot user
+# Output: JSON objects (one per line) for discussions that should be warned
+
+.data.repository.discussions.nodes[]
+
+# Only process open discussions
+| select(.closed == false)
+
+# Only process discussions that are stale (not updated recently)
+| select(.updatedAt < $staleCutoff)
+
+# Store the discussion for later reference
+| . as $discussion
+
+# Find the most recent warning comment from the bot
+# Note: We only look at the last 100 comments (fetched by the shell script).
+# This is intentional - if there are 100+ comments after a warning, the discussion
+# is clearly active and should not be warned again.
+| (
+    (.comments.nodes // [])
+    | map(
+        select(.body | contains($marker))
+        | select(.author.login == $botLogin)
+      )
+    | last
+  ) as $warningComment
+
+# Only proceed if:
+# - No warning comment exists yet, OR
+# - Discussion was updated after the last warning (user responded)
+| select(
+    $warningComment == null
+    or $discussion.updatedAt > $warningComment.createdAt
+  )
+
+# Output as JSON
+| @json