docs: correct labels maintenance cadence

This commit is contained in:
codex-bot-andresmgsl 2026-07-29 10:37:03 +00:00
parent 3eff28e624
commit 4198597834
3 changed files with 17 additions and 10 deletions

View file

@ -12,9 +12,11 @@ on:
# check_suite/check_run/workflow_run), a blocker:conflict when ANOTHER PR # 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 # 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 # 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 # those four while cutting nominal scheduled sweeps from four an hour to one
# another engine writes some of those transitions, only the classes with no # at GitHub's 1-minute billing floor. Do not delete the cron: it is their
# other writer bound the cadence; relax it only as that list shrinks. # 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 * * * *"}] schedule: [{cron: "0 * * * *"}]
# A manual full-board sweep, including taxonomy bootstrap on a fresh repo. # A manual full-board sweep, including taxonomy bootstrap on a fresh repo.
workflow_dispatch: workflow_dispatch:

View file

@ -212,10 +212,13 @@ on a PR would say the same thing twice and drift.
## Maintenance ## Maintenance
The labels workflow (issue #10) recomputes PR state statelessly on PR events The labels workflow (issue #10) recomputes PR state statelessly on subscribed
plus a 15-minute advisory cron, and bootstraps this taxonomy idempotently on events plus a consumer-owned scheduled discovery sweep. Hourly is the
manual dispatch. The sweep warns when the core taxonomy declares a label the recommended default when no other engine drives board state; relax it only as
repository lacks. The same workflow reconciles issue-flow labels on issue the transition classes with no other writer shrink. Manual dispatch both
bootstraps this taxonomy idempotently and runs the operator's on-demand
full-board reconcile. The sweep warns when the core taxonomy declares a label
the repository lacks. The same workflow reconciles issue-flow labels on issue
events and during the scheduled sweep. Default GitHub labels (`duplicate`, events and during the scheduled sweep. Default GitHub labels (`duplicate`,
`invalid`, `question`, `wontfix`, `help wanted`, `good first issue`) are `invalid`, `question`, `wontfix`, `help wanted`, `good first issue`) are
deleted at bootstrap — a `question` is a discussion, not an issue. deleted at bootstrap — a `question` is a discussion, not an issue.

View file

@ -303,9 +303,11 @@ on:
# pull_request_review trigger), blocker:ci-red set/cleared, blocker:conflict # pull_request_review trigger), blocker:ci-red set/cleared, blocker:conflict
# when another PR merges under this one, and time-based stale / 48h # when another PR merges under this one, and time-based stale / 48h
# claim-reclaim. Events below carry the rest in seconds. Hourly trades ≤1h of # claim-reclaim. 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 floor. # latency on those four while cutting nominal scheduled sweeps from four an
# If another engine writes some of those transitions, only the classes with # hour to one at GitHub's 1-minute floor. Do not delete the cron: it is their
# no other writer bound the cadence; relax it only as that list shrinks. # 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 * * * *"}] schedule: [{cron: "0 * * * *"}]
# A manual full-board sweep, including taxonomy bootstrap on a fresh repo. # A manual full-board sweep, including taxonomy bootstrap on a fresh repo.
workflow_dispatch: workflow_dispatch: