maintainer-ping-workflow

Reusable GitHub Actions workflow: pings a maintainer-ping Cloudflare Worker when an issue/PR gets the needs-moul label or mentions @moul.

Use this if you don't want to install the GitHub App (e.g. in repos under another org you can't add Apps to, or to keep everything declarative in the repo).

Use it from any repo

Create .github/workflows/maintainer-ping.yml:

name: maintainer-ping

on:
  issues:
    types: [opened, labeled]
  pull_request_target:
    types: [opened, labeled]
  issue_comment:
    types: [created]
  pull_request_review:
    types: [submitted]
  pull_request_review_comment:
    types: [created]

jobs:
  ping:
    uses: moul/maintainer-ping-workflow/.github/workflows/ping.yml@v1
    with:
      service_url: https://maintainer-ping.moul.workers.dev
    secrets:
      DISPATCH_TOKEN: ${{ secrets.MAINTAINER_PING_TOKEN }}

What you need in the caller repo

• One secret: MAINTAINER_PING_TOKEN — the DISPATCH_TOKEN you configured on the Worker. (Could be an org-level secret to share across all repos.)

That's all. No Telegram tokens, no bot setup. The Worker holds everything.

Versioning

Tag releases on this repo (v1, v1.1, …) and pin callers to a tag. Don't pin to a branch — anyone with push access to this repo could otherwise change every caller's behavior silently.

Label setup

In every repo that uses this, create the label once:

gh label create needs-moul --color FBCA04 --description "Owner attention requested"