From 531cfa41f7f5867499da20c4b7fdaae52c4251ab Mon Sep 17 00:00:00 2001
From: xnoto <steven@makeitwork.cloud>
Date: Fri, 21 Aug 2026 16:47:32 -0600
Subject: [PATCH] feat: add dependabot-notify reusable workflow

Posts a synthetic alert to the cluster Grafana's embedded Alertmanager
API when a caller repo's pull_request actor is dependabot[bot]. Callers
are managed centrally by tfroot-github; requires the Cloudflare Access
service token and GRAFANA_ALERTS_TOKEN secrets distributed there.
---
 .github/workflows/dependabot-notify.yml | 41 +++++++++++++++++++++++++
 AGENTS.md                               | 14 +++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 .github/workflows/dependabot-notify.yml

diff --git a/.github/workflows/dependabot-notify.yml b/.github/workflows/dependabot-notify.yml
new file mode 100644
index 0000000..a67edea
--- /dev/null
+++ b/.github/workflows/dependabot-notify.yml
@@ -0,0 +1,41 @@
+---
+name: dependabot-notify
+
+on:
+  workflow_call:
+
+permissions: {}
+
+jobs:
+  alert:
+    runs-on: ubuntu-24.04
+    steps:
+      # No checkout needed: the pull_request event payload is read from
+      # $GITHUB_EVENT_PATH. curl -f makes the job fail loudly on non-2xx so
+      # a broken alert path is visible in the caller repo's Actions tab.
+      - name: Post Dependabot PR alert to Grafana
+        env:
+          CF_ACCESS_CLIENT_ID: ${{ secrets.CLOUDFLARE_AUTH_CLIENT_ID }}
+          CF_ACCESS_CLIENT_SECRET: ${{ secrets.CLOUDFLARE_AUTH_CLIENT_SECRET }}
+          GRAFANA_TOKEN: ${{ secrets.GRAFANA_ALERTS_TOKEN }}
+        run: |
+          set -euo pipefail
+          payload="$(jq -c '[{
+            labels: {
+              alertname: "DependabotPR",
+              severity: "info",
+              repository: .repository.full_name
+            },
+            annotations: {
+              summary: "Dependabot opened PR #\(.pull_request.number) in \(.repository.full_name): \(.pull_request.title)",
+              url: .pull_request.html_url
+            },
+            generatorURL: .pull_request.html_url
+          }]' "$GITHUB_EVENT_PATH")"
+          curl -fsS --retry 3 -X POST \
+            -H "CF-Access-Client-Id: ${CF_ACCESS_CLIENT_ID}" \
+            -H "CF-Access-Client-Secret: ${CF_ACCESS_CLIENT_SECRET}" \
+            -H "Authorization: Bearer ${GRAFANA_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "${payload}" \
+            https://grafana.makeitwork.cloud/api/alertmanager/grafana/api/v1/alerts
diff --git a/AGENTS.md b/AGENTS.md
index 96fc5cf..c58dbe1 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -37,6 +37,20 @@ The test job has only `contents: read` permission and does not receive AWS or SS
 
 There is no `container` input. The `arc-tf` runner pod IS the image, so adding `container:` on top would nest a container inside a container — don't do it.
 
+### dependabot-notify.yml
+
+Reusable workflow that posts a synthetic alert to the cluster Grafana's
+embedded Alertmanager API when a caller repo's `pull_request` event actor is
+`dependabot[bot]`. Callers are managed centrally by `tfroot-github`
+(`.github/workflows/dependabot-notify.yml` in each repo, `secrets: inherit`).
+
+Requires three Actions secrets in the caller repository (distributed by
+`tfroot-github`): `CLOUDFLARE_AUTH_CLIENT_ID` / `CLOUDFLARE_AUTH_CLIENT_SECRET`
+(the existing "GitHub Actions" Cloudflare Access service token, allowed by the
+path-scoped Access app on `grafana.makeitwork.cloud/api/alertmanager/grafana`)
+and `GRAFANA_ALERTS_TOKEN` (a Grafana service account token). No checkout and
+no `GITHUB_TOKEN` permissions are needed.
+
 ## Failure Modes
 
 ### "manifest unknown" or image pull failures