Add code insights iteration stats Slack bot (#30528)

.github/workflows/iteration-stats-slackbot.yml

@@ -0,0 +1,33 @@
+name: Code Insights iteration stats Slack bot
+
+on:
+  schedule:
+    # Every Friday 5pm PST (Saturday 1am UTC)
+    # Note: script will exit if there is no iteration ending that day (every 2 weeks, but cron doesn't support that)
+    - cron: 0 1 * * 6
+
+jobs:
+  update-status:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Post iteration stats
+        uses: Amadevus/pwsh-script@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_PROJECTS_ACTION_TOKEN }}
+          SLACK_WEBHOOK_URI: ${{ secrets.INSIGHTS_ITERATION_SLACKBOT_WEBHOOK_URI }}
+        with:
+          script: |
+            $global:InformationPreference = 'Continue'
+            $global:ProgressPreference = 'SilentlyContinue'
+            Set-StrictMode -Version 3.0
+
+            Install-Module PSGitHub -Force -ErrorAction Stop
+            Install-Module PSSlack -Force -ErrorAction Stop
+
+            if (!$env:GITHUB_TOKEN) {
+              throw "No GITHUB_TOKEN env var provided"
+            }
+
+            $PSDefaultParameterValues['*GitHub*:Token'] = ConvertTo-SecureString -String $env:GITHUB_TOKEN -AsPlainText -Force
+
+            ./.github/workflows/post-iteration-stats.ps1 -ProjectNodeId 'MDExOlByb2plY3ROZXh0MzI3Ng==' -SlackChannel '#code-insights-internal' -SlackWebhookUri $env:SLACK_WEBHOOK_URI

.github/workflows/post-iteration-stats.ps1

@@ -0,0 +1,74 @@
+# Gathers stats on issue sizes in a GitHub iteration board for an iteration ending today and posts a summary to Slack
+
+[CmdletBinding()]
+param(
+    # GitHub GraphQL Node ID of the GitHub Beta project
+    [Parameter(Mandatory)]
+    [string] $ProjectNodeId,
+
+    # Previously set up webhook URI from https://sourcegraph.slack.com/apps/A0F7XDUAZ
+    [Parameter(Mandatory)]
+    [string] $SlackWebhookUri,
+
+    # Slack channel to post to
+    [Parameter(Mandatory)]
+    [string] $SlackChannel
+)
+
+# PST is the most western timezone we have, i.e. the latest EOD teammates have.
+# Therefor the milestone due date refers to the end of PST Friday (which is already Saturday in UTC, and GitHub Actions run in UTC, but this script may also be run locally for testing in any timezone).
+$todayInPST = [TimeZoneInfo]::ConvertTimeBySystemTimeZoneId([DateTime]::Today, 'Pacific Standard Time').Date
+
+$currentMilestone = Get-GitHubMilestone -Owner sourcegraph -RepositoryName sourcegraph -State open |
+    Where-Object { $_.Title -like 'Insights iteration*' -and $_.DueOn.Date -eq $todayInPST }
+
+if (!$currentMilestone) {
+    Write-Warning "No milestone found that ends today ($($todayInPST.ToLongDateString()))"
+    return
+}
+
+$items = Get-GitHubBetaProjectItem -ProjectNodeId $ProjectNodeId | Where-Object { $_.Content -and $_.Content.Milestone }
+
+Write-Information "$($items.Count) items in project"
+
+$byIteration = $items | Group-Object -Property { $_.Content.Milestone.Title } -AsHashTable
+
+$currentIterationItems = $byIteration[$currentMilestone.Title]
+$finishedItems = $currentIterationItems | Where-Object { $_.Fields['Status'] -eq 'Done' }
+$notSized = $currentIterationItems | Where-Object { !$_.Fields['Size 🔵'] }
+
+# Maps an input item to its size field, assuming 1 for unsized issues.
+filter Get-IterationItemSize {
+    $_.Fields['Size 🔵'] ?? 1
+}
+
+# Tests whether the given project item has a given GitHub label and returns a boolean
+function Test-ItemHasLabel {
+    [OutputType([bool])]
+    param(
+        [Parameter(Mandatory)] [psobject] $Item,
+        [Parameter(Mandatory)] [string] $Label
+    )
+
+    [bool]($Item.Content.Labels | Where-Object { $_.Name -eq $Label })
+}
+
+$stats = $finishedItems | Get-IterationItemSize | Measure-Object -AllStats
+$frontendStats = $finishedItems | Where-Object { Test-ItemHasLabel -Item $_ -Label 'webapp' } | Get-IterationItemSize | Measure-Object -AllStats
+$backendStats = $finishedItems | Where-Object { Test-ItemHasLabel -Item $_ -Label 'backend' } | Get-IterationItemSize | Measure-Object -AllStats
+$notFinished = $currentIterationItems | Where-Object { $_.Fields['Status'] -ne 'Done' } | Get-IterationItemSize | Measure-Object -AllStats
+
+$message = "
+Beep bop, this is your friendly iteration bot, with some fresh stats to help with our next iteration planning! :spiral_calendar_pad:
+
+*$($currentMilestone.Title) (ending today)*
+Sum of finished issues: :large_blue_circle: *$($stats.Sum)* | :desktop_computer: Frontend: $($frontendStats.Sum) | :database: Backend: $($backendStats.Sum)
+_$($stats.Count) issues, average size $($stats.Average.ToString('#.##')), smallest $($stats.Minimum), largest $($stats.Maximum)_
+
+:issue: Not finished: :large_yellow_circle: $($notFinished.Sum) ($($notFinished.Count) issues)
+:grey_question: Not sized: $($notSized.Count) issues
+"
+
+Write-Information "Sending Slack message:`n$message"
+
+Send-SlackMessage -Uri $SlackWebhookUri -Channel $SlackChannel -Username 'Iteration Bot' -IconEmoji ':robot:' -Parse full -Text $message