Page on-call for the tickets that actually can't wait

# PagerDuty alert for critical tickets
#
# Triggers a PagerDuty incident via the Events API v2 when Scitor's AI triage
# escalates a ticket to `priority:urgent`.
#
# What this does:
#   - Fires when the `priority:urgent` label is applied to a ticket.
#   - Sends a `trigger` event to PagerDuty's Events API, creating an incident
#     with the ticket title, URL, and issue number as custom details.
#   - Uses the GitHub issue number as PagerDuty's `dedup_key`, so re-applying
#     the label (e.g. after removing and re-adding it) doesn't open a second
#     incident for the same ticket.
#
# What this does NOT do:
#   - It does not resolve or acknowledge the incident automatically when the
#     ticket is closed. Add a second job on `issues: types: [closed]` sending
#     `event_action: "resolve"` with the same `dedup_key` if you want that.
#   - It does not page for every ticket — only for `priority:urgent`, which
#     Scitor's AI triage reserves for things like a reported outage, security
#     issue, or data-loss report (see priority.auto_assign in scitor.yaml).
#
# Required secret:
#   PAGERDUTY_ROUTING_KEY — the integration/routing key from a PagerDuty
#   "Events API v2" integration on the service you want to alert
#   (PagerDuty -> Service -> Integrations -> Add Integration -> Events API v2).
#
# Source: Scitor's own documented example at
# https://support.scitor.io/guides/github-actions#pagerduty-alert-for-critical-tickets
# Endpoint and payload shape (routing_key, event_action, payload.summary,
# payload.source, payload.severity) cross-checked against PagerDuty's Events
# API v2 documentation, fetched 2026-09-17.

name: PagerDuty — priority urgent
on:
  issues:
    types: [labeled]

jobs:
  pagerduty:
    if: >
      github.event.label.name == 'priority:urgent' &&
      github.event.issue.user.login == 'scitor-customerops[bot]'
    runs-on: ubuntu-latest
    steps:
      - name: Send PagerDuty event
        uses: actions/github-script@v7
        with:
          script: |
            const res = await fetch('https://events.pagerduty.com/v2/enqueue', {
              method: 'POST',
              headers: { 'Content-Type': 'application/json' },
              body: JSON.stringify({
                routing_key:  process.env.PAGERDUTY_ROUTING_KEY,
                event_action: 'trigger',
                dedup_key:    `scitor-${context.issue.number}`,
                payload: {
                  summary:  `Critical customer issue: ${context.payload.issue.title}`,
                  severity: 'critical',
                  source:   'scitor-support',
                  custom_details: {
                    url:          context.payload.issue.html_url,
                    issue_number: context.issue.number,
                  },
                },
                links: [{ href: context.payload.issue.html_url, text: 'View support ticket' }],
              }),
            });

            if (!res.ok) core.setFailed(`PagerDuty Events API returned ${res.status}`);
        env:
          PAGERDUTY_ROUTING_KEY: ${{ secrets.PAGERDUTY_ROUTING_KEY }}