name: labels
# Ceremony's own caller for the labels automation — the dogfood of issue
# #11, wearing the same local-`uses:` deviation as self-release.yml and the
# same warning: consumers must NEVER copy the local form (it rides main,
# unpinned — correct only for the repo that IS the source). Consumers write:
#   uses: heavy-duty/ceremony/.github/workflows/labels.yml@<pinned-tag>
on:
  # The consumer owns this cadence (#203). Hourly is the recommended default
  # when no other engine drives board state: the cron is then the sweep's ONLY
  # wake for four transition classes — a review verdict landing (there is no
  # pull_request_review trigger here), blocker:ci-red set or cleared (no
  # check_suite/check_run/workflow_run), a blocker:conflict when ANOTHER PR
  # merges under this one, and the time-based stale / 48h claim-reclaim. The
  # events below carry the rest in seconds. Hourly trades ≤1h of latency on
  # those four for one full-board sweep at GitHub's 1-minute billing floor. If
  # another engine writes some of those transitions, only the classes with no
  # other writer bound the cadence; relax it only as that list shrinks.
  schedule: [{cron: "0 * * * *"}]
  # A manual full-board sweep, including taxonomy bootstrap on a fresh repo.
  workflow_dispatch:
  # Narrowed (#199) to the actions that carry a queue-state change the hourly
  # cron cannot wait one cadence for — dropping only labeled/unlabeled/assigned/
  # unassigned, which feed validation and the 48h claim clock (caught within one
  # cadence) and were the dominant issues-churn source. Kept: `opened` (the
  # mint→needs-triage check, issueflow's opened-only path), `closed` (the
  # blocker-closes→ready self-heal, crew#96/#98), `edited` (a body rewrite of the
  # `Blocked by #N` declaration the sweep parses — issueflow-reconcile.sh:179),
  # `reopened` (a closed issue re-entering the queue wearing labels derived when
  # it closed). The must-fail in #199 is exactly "a queue-state transition waits
  # on the schedule when an event could have carried it", so edited/reopened stay
  # on events. The PR handoff wake is pull_request_target:labeled, NOT issues, so
  # this does not touch the handoff.
  issues:
    types: [opened, closed, edited, reopened]
  pull_request_target:
    # Every PR arrives from a fork, so these carry the head/draft/review facts
    # the sweep derives state:* from. labeled/unlabeled are the handoff wake —
    # the author's optimistic state:needs-human write, confirmed or corrected
    # here in seconds (#11); synchronize re-derives on every push;
    # review_requested/review_request_removed wake the sweep that clears (or
    # restores) blocker:unrequested — without them the one event that makes
    # the label false could not clear it, and a quiet repo wore the red flag
    # until the advisory cron (#137).
    types: [opened, reopened, ready_for_review, converted_to_draft, synchronize, labeled, unlabeled, review_requested, review_request_removed]
permissions:
  contents: read
  checks: read          # mergeability/check-rollup read for PR state
  statuses: read        # commit-status rollup read for PR state
  issues: write
  pull-requests: write
jobs:
  labels:
    uses: ./.github/workflows/labels.yml