From 841b513393dd4062197f13efcea9445f9ffbaa8a Mon Sep 17 00:00:00 2001
From: Salvydas Lukosius <ss-o@users.noreply.github.com>
Date: Fri, 22 May 2026 23:24:37 +0100
Subject: [PATCH 1/2] chore(labels): restore canonical label source file

Add lib/labels.yml as the machine-readable source of truth referenced by the org runbooks. The file mirrors the current z-shell/.github label set and includes conservative legacy migration metadata for future dry-run sync tooling.
---
 lib/labels.yml | 156 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 156 insertions(+)
 create mode 100644 lib/labels.yml

diff --git a/lib/labels.yml b/lib/labels.yml
new file mode 100644
index 000000000..779335a83
--- /dev/null
+++ b/lib/labels.yml
@@ -0,0 +1,156 @@
+---
+# Canonical z-shell organization label set.
+#
+# This file is the source of truth referenced by:
+# - AGENTS.md
+# - runbooks/labels.md
+# - runbooks/triage.md
+# - runbooks/project-tracker.md
+#
+# Intended sync semantics:
+# - create/update these labels in target repositories
+# - migrate open issues/PRs from legacy labels before deleting any legacy label
+# - do not delete unknown local labels automatically
+# - keep automation-owned labels listed here if external tools rely on them
+
+labels:
+  # Work type
+  - name: type:bug
+    color: b60205
+    description: Something is broken or behaving incorrectly.
+  - name: type:feature
+    color: 0e8a16
+    description: A request for new behavior or capability.
+  - name: type:docs
+    color: '0052cc'
+    description: Documentation-only work.
+  - name: type:question
+    color: d4c5f9
+    description: Support, clarification, or usage question.
+  - name: type:maintenance
+    color: '531999'
+    description: Non-feature maintenance, cleanup, or org work.
+  - name: type:membership
+    color: 6f42c1
+    description: Membership and organization-role requests.
+  - name: type:handoff
+    color: '5319e7'
+    description: Cross-agent or cross-maintainer handoff context.
+
+  # Area
+  - name: area:zi
+    color: 1d76db
+    description: Zi core behavior, APIs, or documentation.
+  - name: area:plugin
+    color: 3e16f3
+    description: Plugin behavior or plugin-facing work.
+  - name: area:annex
+    color: 3e16f3
+    description: Annex behavior or annex-facing work.
+  - name: area:package
+    color: 3e16f3
+    description: Package or package-management work.
+  - name: area:docs
+    color: '0052cc'
+    description: Documentation systems, content, or publishing.
+  - name: area:ci
+    color: '5319e7'
+    description: Continuous integration or GitHub Actions work.
+  - name: area:dependencies
+    color: fbca04
+    description: Dependency updates or dependency-management work.
+  - name: area:release
+    color: d93f0b
+    description: Release process, versioning, or changelog work.
+  - name: area:meta
+    color: 1d76db
+    description: Organization-wide policy, templates, or meta-repo work.
+
+  # Severity and workflow modifiers
+  - name: priority:high
+    color: ee0701
+    description: Needs prompt attention.
+  - name: regression
+    color: b60205
+    description: Previously working behavior is broken.
+  - name: security
+    color: ee0701
+    description: Security-sensitive issue or hardening work.
+  - name: breaking-change
+    color: d93f0b
+    description: Breaks backward compatibility or changes a public contract.
+  - name: status:triage
+    color: fbca04
+    description: Awaiting initial review or classification.
+  - name: status:blocked
+    color: e4e669
+    description: Cannot proceed until an external dependency or decision changes.
+  - name: needs-info
+    color: f9d0c4
+    description: Waiting on more detail before work can continue.
+  - name: good first issue
+    color: '7057ff'
+    description: Well-scoped starter task for a new contributor.
+  - name: help wanted
+    color: '008672'
+    description: Maintainers would welcome outside help.
+  - name: invalid
+    color: 0b467f
+    description: Off-topic, incorrect, or not actionable.
+  - name: duplicate
+    color: cfd3d7
+    description: Covered by another issue or pull request.
+  - name: wontfix
+    color: ffffff
+    description: Acknowledged but not planned for implementation.
+  - name: meta:org-tracked
+    color: '5319e7'
+    description: Auto-add this issue to the org-wide Z-Shell Tracker.
+
+  # External automation labels retained for compatibility.
+  # These are not part of the triage taxonomy but appear in z-shell/.github
+  # and are commonly managed by Dependabot / dependency automation.
+  - name: dependencies
+    color: '0366d6'
+    description: Pull requests that update a dependency file
+  - name: github_actions
+    color: '000000'
+    description: Pull requests that update GitHub Actions code
+
+legacy_migrations:
+  bug 🐞: type:bug
+  bug: type:bug
+  feature-request 💡: type:feature
+  new-feature 🎉: type:feature
+  documentation 📝: type:docs
+  documentation: type:docs
+  Q&A ✍️: type:question
+  enhancement ✨: type:maintenance
+  enhancement: type:maintenance
+  maintenance 📈: type:maintenance
+  agent-memory 🧠: type:handoff
+  👥 member: type:membership
+  annex 🌀: area:annex
+  plugin ⚙️: area:plugin
+  package 📦: area:package
+  ci 🤖: area:ci
+  ci ⚙️: area:ci
+  github-actions :octocat:: area:ci
+  dependencies 📦: area:dependencies
+  javascript 📦: area:dependencies
+  renovate 📦: area:dependencies
+  submodules ⚙️: area:dependencies
+  high-priority 🔥: priority:high
+  triage 📑: status:triage
+  priority-low 🔖: status:blocked
+  beginner-friendly: good first issue
+  help-wanted: help wanted
+  breaking-change 💥: breaking-change
+  security 🛡️: security
+  invalid ⚠️: invalid
+
+sync_policy:
+  delete_unknown_labels: false
+  delete_legacy_labels_only_when_unused: true
+  preserve_labels_on_open_items_before_removal: true
+  pilot_before_org_wide_rollout: true

From b496c35db16c4b498d7b9e65fe27aef0df392a8f Mon Sep 17 00:00:00 2001
From: Sall <59910950+ss-o@users.noreply.github.com>
Date: Fri, 22 May 2026 23:34:32 +0100
Subject: [PATCH 2/2] Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Sall <59910950+ss-o@users.noreply.github.com>
---
 lib/labels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/labels.yml b/lib/labels.yml
index 779335a83..452efa838 100644
--- a/lib/labels.yml
+++ b/lib/labels.yml
@@ -135,7 +135,7 @@ legacy_migrations:
   package 📦: area:package
   ci 🤖: area:ci
   ci ⚙️: area:ci
-  github-actions :octocat:: area:ci
+  "github-actions :octocat:": area:ci
   dependencies 📦: area:dependencies
   javascript 📦: area:dependencies
   renovate 📦: area:dependencies