55 lines
3.3 KiB
YAML
55 lines
3.3 KiB
YAML
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 while cutting nominal scheduled sweeps from four an hour to one
|
|
# at GitHub's 1-minute billing floor. Do not delete the cron: it is their
|
|
# discovery path. 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
|