Labels

All org catalog labels are defined in a single source of truth.
Never create ad-hoc catalog labels directly in a repository — use the rollout workflow instead.

Countdown labels used by Auto-approve owner PRs are different (see below).

Source of Truth

winccoa-tools-pack/.github → labels/labels.yml

Full documentation: docs/LABELS.md

Available Labels

Category	Examples
Priority	priority/critical, priority/high, priority/medium, priority/low
Type	enhancement, bug, documentation, breaking-change, dependencies
Component	core, api, testing, quality, configuration, integration
Status	needs-triage, status/in-progress, status/review, status/blocked, status/ready
Special	good-first-issue, help-wanted, security, performance, area/build

Roll Out Labels to Repositories

All repos at once

1. Go to winccoa-tools-pack/.github → Actions
2. Run workflow "Fan-out labels to repositories"
3. Start with dry-run: true to preview — then re-run with dry-run: false
4. Use strict: true to also delete labels not in labels.yml

Single repo

1. Run workflow "Run single-target label sync"
2. Set target-repo to winccoa-tools-pack/<repo-name>

Add a new repo to the rollout

Edit repos.txt in the .github repo — one org/repo per line.

Auto-approve countdown labels (not from fan-out alone)

Owner PR auto-approve uses countdown labels. They are created by the first run of the repo workflow Auto-approve owner PRs (auto-approve-owner-prs.yml), not by assuming fan-out already applied them.

Label	Meaning
merge-in-3-days-without-review	Day 0 of countdown
merge-in-2-days-without-review	Day 1
merge-in-1-day-without-review	Day 2
(approve + merge path)	Day 3 — action approves; auto-merge takes over per workflow

Rule: Right after creating a repository from a template (or anytime these labels are missing), run the workflow once:

gh workflow run auto-approve-owner-prs.yml --repo winccoa-tools-pack/<repo>
# or: Actions → "Auto-approve owner PRs" → Run workflow

Verify:

gh label list --repo winccoa-tools-pack/<repo> --limit 100 | findstr /i "merge-in"

Do this before the first owner PRs that should use countdown auto-approve.

Do not hand-create these as one-off replacements for the workflow unless debugging. Prefer the workflow so names/colors stay consistent with mPokornyETM/auto-approve-stale-prs.

Add or Change a Label

1. Edit labels/labels.yml in winccoa-tools-pack/.github
2. Commit and push to main
3. Run the fan-out workflow to apply across all repos

Quick Fix via CLI (one-off)

# Create a missing label in one repo
gh label create "priority/high" --color "eb6420" --description "Important for milestone success" --repo winccoa-tools-pack/<repo>

# Edit an existing label
gh label edit "needs-triage" --color "FBCA04" --repo winccoa-tools-pack/<repo>

Quick fixes do not update labels.yml. Always follow up with a proper edit to keep the source of truth in sync.

Required Secret

The rollout workflows require the org secret ORG_LABELS_PAT (scope: repo).