Skip to content
This repository was archived by the owner on Jun 26, 2026. It is now read-only.

Commit 92ff040

Browse files
authored
ci(labels): adopt Kubernetes-style label scheme (#16)
Mirror the label workflow already running in cozystack/cozystack: a declarative .github/labels.yml synced via EndBug/label-sync, a PR auto-labeler that derives kind/* and area/* from the Conventional Commits title, and a PR size labeler that ignores generated and vendored paths. labels.yml carries the generic categories (kind/, priority/, triage/, lifecycle/, do-not-merge/, security/, size/) and is adapted to this repo by replacing the backend-oriented area/* set (database, network, storage, virtualization, platform, etc.) with area/* that match the SPA: console, forms, k8s-client, ui, types, tenants, auth, vm, container, ci, docs, tests, plus area/uncategorized as the fallback. The labeler's authoritative-label set is narrow on purpose. Beyond the additive pass it removes exactly two labels it knows it set itself: area/uncategorized once a real area/* is derived, and kind/breaking-change once neither the conventional-commit ! marker nor a BREAKING CHANGE: footer remains. Maintainer-added labels are preserved untouched. The derivation lives in .github/scripts/pr-labeler.js as a pure function so the rules can be covered by node:test cases (.github/scripts/pr-labeler.test.js) exercising the title-edit scenarios the additive-only design used to mishandle. pr-size isIgnored is rewritten for a node workspace: pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lockb, *.lock, node_modules/, dist/, build/, generated/. The Go-specific paths from cozystack (vendor/, zz_generated, .pb.go, charts/) are dropped. The validate job grows a description-vs-automation drift check: any label whose description advertises automation (auto-applied, auto-closed, auto-labeled, auto-closed) must be referenced by name in .github/workflows/ or .github/scripts/, so a description cannot promise behaviour that no code backs. The lifecycle/* descriptions and the lgtm description are reworded to reflect that they are manual markers in this repo — there is no stale-bot and no /lgtm command handler. labels.yml header notes that size/* line-count thresholds are the contract pr-size.yaml encodes. EndBug/label-sync runs with delete-other-labels: false, so the existing GitHub defaults (bug, enhancement, documentation, question, duplicate) collapse into the new kind/* and triage/* names via the aliases lists without losing references on already-tagged items. Assisted-By: Claude <[email protected]> Signed-off-by: Aleksei Sviridkin <[email protected]>
1 parent 3732f7c commit 92ff040

6 files changed

Lines changed: 1022 additions & 0 deletions

File tree

‎.github/labels.yml‎

Lines changed: 354 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,354 @@
1+
# cozystack-ui repository labels
2+
#
3+
# Label conventions follow the Kubernetes scheme:
4+
# https://github.com/kubernetes/test-infra/blob/master/label_sync/labels.md
5+
#
6+
# Synced into the repository by .github/workflows/labels.yaml
7+
# (EndBug/label-sync@v2). Edit this file via pull request — UI changes
8+
# will be overwritten on the next sync.
9+
#
10+
# Constraints (enforced by the validate job in labels.yaml):
11+
# - description ≤ 100 characters (GitHub REST API limit)
12+
# - color is a 6-character hex string (no leading #)
13+
# - label names are unique
14+
# - aliases do not collide with top-level names
15+
#
16+
# Categories:
17+
# kind/ issue or PR type
18+
# priority/ urgency
19+
# triage/ review state
20+
# lifecycle/ issue or PR lifecycle
21+
# area/ subsystem; extensible — add when 3+ open issues exist
22+
# do-not-merge/ PR merge blockers
23+
# security/ security-finding severity and status
24+
# size/ PR size (auto-applied)
25+
#
26+
# `aliases:` lets EndBug/label-sync rename existing labels without losing
27+
# references on already-tagged issues and PRs.
28+
#
29+
# size/* line-count thresholds in the descriptions below are the contract
30+
# the .github/workflows/pr-size.yaml bucket logic encodes. Editing one and
31+
# not the other will drift the label off what the workflow actually applies
32+
# — keep them in lockstep.
33+
34+
# ──────────────────────────────────────────────
35+
# kind/ — issue or PR type
36+
# ──────────────────────────────────────────────
37+
38+
- name: kind/bug
39+
color: 'd73a4a'
40+
description: Categorizes issue or PR as related to a bug
41+
aliases: ['bug']
42+
43+
- name: kind/feature
44+
color: 'a2eeef'
45+
description: Categorizes issue or PR as related to a new feature
46+
aliases: ['enhancement']
47+
48+
- name: kind/documentation
49+
color: '0075ca'
50+
description: Categorizes issue or PR as related to documentation
51+
aliases: ['documentation']
52+
53+
- name: kind/support
54+
color: 'd876e3'
55+
description: Categorizes issue as a support question
56+
aliases: ['question']
57+
58+
- name: kind/cleanup
59+
color: 'c7def8'
60+
description: Categorizes issue or PR as related to cleanup of code, process, or technical debt
61+
62+
- name: kind/regression
63+
color: 'e11d21'
64+
description: Categorizes issue or PR as related to a regression from a prior release
65+
66+
- name: kind/flake
67+
color: 'f7c6c7'
68+
description: Categorizes issue or PR as related to a flaky test
69+
70+
- name: kind/failing-test
71+
color: 'e11d21'
72+
description: Categorizes issue or PR as related to a consistently or frequently failing test
73+
74+
- name: kind/api-change
75+
color: 'c7def8'
76+
description: Categorizes issue or PR as related to adding, removing, or otherwise changing an API
77+
78+
- name: kind/breaking-change
79+
color: 'e11d21'
80+
description: Indicates the change introduces a breaking API or behaviour change
81+
82+
# ──────────────────────────────────────────────
83+
# priority/ — urgency
84+
# ──────────────────────────────────────────────
85+
86+
- name: priority/critical-urgent
87+
color: 'e11d21'
88+
description: Highest priority. Must be actively worked on as someone's top priority right now
89+
90+
- name: priority/important-soon
91+
color: 'eb6420'
92+
description: Must be staffed and worked on either currently, or very soon, ideally in time for the next release
93+
94+
- name: priority/important-longterm
95+
color: 'fbca04'
96+
description: Important over the long term, but may not be staffed and/or may need multiple releases to complete
97+
98+
- name: priority/backlog
99+
color: 'fef2c0'
100+
description: General backlog priority. Lower than priority/important-longterm
101+
102+
# ──────────────────────────────────────────────
103+
# triage/ — review state
104+
# ──────────────────────────────────────────────
105+
106+
- name: triage/needs-triage
107+
color: 'ededed'
108+
description: Indicates an issue needs triage by a maintainer
109+
110+
- name: triage/accepted
111+
color: '0e8a16'
112+
description: Indicates an issue is ready to be actively worked on
113+
114+
- name: triage/needs-information
115+
color: 'fbca04'
116+
description: Indicates an issue needs more information in order to work on it
117+
118+
- name: triage/not-reproducible
119+
color: 'fbca04'
120+
description: Indicates an issue can not be reproduced as described
121+
122+
- name: triage/duplicate
123+
color: 'cfd3d7'
124+
description: Indicates an issue is a duplicate of another issue
125+
aliases: ['duplicate']
126+
127+
- name: triage/unresolved
128+
color: 'cfd3d7'
129+
description: Indicates an issue that can not or will not be resolved
130+
131+
# ──────────────────────────────────────────────
132+
# lifecycle/ — issue or PR lifecycle
133+
# ──────────────────────────────────────────────
134+
135+
- name: lifecycle/active
136+
color: '1d76db'
137+
description: Indicates that an issue or PR is actively being worked on by a contributor
138+
139+
- name: lifecycle/frozen
140+
color: 'db5dd6'
141+
description: Marks an issue or PR as kept alive regardless of inactivity; manual marker only
142+
aliases: ['frozen']
143+
144+
- name: lifecycle/stale
145+
color: 'dadada'
146+
description: Denotes an issue or PR that has remained open with no activity; manual marker only
147+
aliases: ['stale']
148+
149+
- name: lifecycle/rotten
150+
color: '795548'
151+
description: Denotes an issue or PR that has aged beyond stale; manual marker only
152+
153+
# ──────────────────────────────────────────────
154+
# area/ — subsystem (extensible)
155+
# Add a new area/* when there are 3+ open issues on the topic.
156+
# ──────────────────────────────────────────────
157+
158+
- name: area/console
159+
color: 'bfd4f2'
160+
description: Issues or PRs related to apps/console — routes, detail pages, marketplace, command palette
161+
162+
- name: area/forms
163+
color: 'bfd4f2'
164+
description: Issues or PRs related to RJSF schema forms and widgets (backup, external-ips, storage-class, etc.)
165+
166+
- name: area/k8s-client
167+
color: 'bfd4f2'
168+
description: Issues or PRs related to packages/k8s-client — K8sClient, hooks, watch layer
169+
170+
- name: area/ui
171+
color: 'bfd4f2'
172+
description: Issues or PRs related to packages/ui — AppShell, Sidebar, Header, Button, primitives
173+
174+
- name: area/types
175+
color: 'bfd4f2'
176+
description: Issues or PRs related to packages/types — shared Kubernetes resource types
177+
178+
- name: area/tenants
179+
color: 'bfd4f2'
180+
description: Issues or PRs related to tenant context, tenant-namespace scoping, multi-tenancy
181+
182+
- name: area/auth
183+
color: 'bfd4f2'
184+
description: Issues or PRs related to authentication, oauth2-proxy integration, userinfo
185+
186+
- name: area/vm
187+
color: 'bfd4f2'
188+
description: Issues or PRs related to virtual machines — VNC console, VM tabs, kubevirt integration
189+
190+
- name: area/container
191+
color: 'bfd4f2'
192+
description: Issues or PRs related to the container image build, Containerfile, nginx configuration
193+
194+
- name: area/ci
195+
color: 'bfd4f2'
196+
description: Issues or PRs related to CI workflows, GitHub Actions, automation
197+
198+
- name: area/docs
199+
color: 'bfd4f2'
200+
description: Issues or PRs related to documentation — README, CLAUDE.md, AGENTS.md, contributor guides
201+
202+
- name: area/tests
203+
color: 'bfd4f2'
204+
description: Issues or PRs related to testing infrastructure — vitest, jsdom, testing-library
205+
206+
- name: area/uncategorized
207+
color: 'fbca04'
208+
description: PR auto-labeler could not map title scope to a known area/*; please review
209+
210+
# ──────────────────────────────────────────────
211+
# do-not-merge/ — PR merge blockers (Prow convention)
212+
# ──────────────────────────────────────────────
213+
214+
- name: do-not-merge/work-in-progress
215+
color: 'e11d21'
216+
description: Indicates that a PR should not merge because it is a work in progress
217+
218+
- name: do-not-merge/hold
219+
color: 'e11d21'
220+
description: Indicates that a PR should not merge because someone has issued /hold
221+
222+
# ──────────────────────────────────────────────
223+
# Cross-cutting / preserved
224+
# ──────────────────────────────────────────────
225+
226+
- name: epic
227+
color: 'a335ee'
228+
description: A large development increment that brings definite value to Cozystack users
229+
230+
- name: community
231+
color: '97458a'
232+
description: Community contributions are welcome in this issue
233+
234+
- name: help wanted
235+
color: '008672'
236+
description: Extra attention is needed
237+
238+
- name: good first issue
239+
color: '7057ff'
240+
description: Good for newcomers
241+
242+
- name: quality-of-life
243+
color: 'aaaaaa'
244+
description: QoL improvements
245+
246+
- name: upstream-issue
247+
color: 'aaaaaa'
248+
description: Requires resolving an issue in an upstream project
249+
250+
- name: release
251+
color: 'aaaaaa'
252+
description: Releasing a new cozystack-ui version
253+
254+
- name: automated
255+
color: 'ededed'
256+
description: Created by automation
257+
258+
- name: debug
259+
color: '704479'
260+
description: Debugging in progress
261+
262+
- name: sponsored
263+
color: '00ff00'
264+
description: Sponsored work
265+
266+
- name: lgtm
267+
color: '238636'
268+
description: Manual marker that a reviewer has signed off; informational — does not gate merge
269+
270+
- name: ok-to-test
271+
color: '00ff00'
272+
description: Indicates a non-member PR is safe to run CI on
273+
274+
# ──────────────────────────────────────────────
275+
# size/ — PR size (auto-applied by .github/workflows/pr-size.yaml)
276+
# ──────────────────────────────────────────────
277+
278+
- name: size/XS
279+
color: '00ff00'
280+
description: This PR changes 0-9 lines, ignoring generated files
281+
aliases: ['size:XS']
282+
283+
- name: size/S
284+
color: '77b800'
285+
description: This PR changes 10-29 lines, ignoring generated files
286+
aliases: ['size:S']
287+
288+
- name: size/M
289+
color: 'ebb800'
290+
description: This PR changes 30-99 lines, ignoring generated files
291+
aliases: ['size:M']
292+
293+
- name: size/L
294+
color: 'eb9500'
295+
description: This PR changes 100-499 lines, ignoring generated files
296+
aliases: ['size:L']
297+
298+
- name: size/XL
299+
color: 'ff823f'
300+
description: This PR changes 500-999 lines, ignoring generated files
301+
aliases: ['size:XL']
302+
303+
- name: size/XXL
304+
color: 'ffb8b8'
305+
description: This PR changes 1000+ lines, ignoring generated files
306+
aliases: ['size:XXL']
307+
308+
# ──────────────────────────────────────────────
309+
# security/ — security-finding severity and status
310+
# ──────────────────────────────────────────────
311+
312+
- name: security
313+
color: 'aaaaaa'
314+
description: Security-related issues and features
315+
316+
- name: security/critical
317+
color: 'd73a4a'
318+
description: Critical security vulnerability
319+
320+
- name: security/high
321+
color: 'e99695'
322+
description: High severity security finding
323+
324+
- name: security/medium
325+
color: 'f9c513'
326+
description: Medium severity security finding
327+
328+
- name: security/low
329+
color: '0e8a16'
330+
description: Low severity security finding
331+
332+
- name: security/triage-needed
333+
color: 'fbca04'
334+
description: Needs security triage
335+
336+
- name: security/confirmed
337+
color: '1d76db'
338+
description: Confirmed vulnerability
339+
340+
- name: security/false-positive
341+
color: 'c5def5'
342+
description: Triaged as false positive
343+
344+
- name: security/accepted-risk
345+
color: 'bfd4f2'
346+
description: Risk accepted with justification
347+
348+
- name: security/in-progress
349+
color: '0075ca'
350+
description: Fix in progress
351+
352+
- name: security/fixed
353+
color: '0e8a16'
354+
description: Fix released

0 commit comments

Comments
 (0)