From 590f4547eb410e4b059a55f03c2d3004911259b5 Mon Sep 17 00:00:00 2001
From: Eliav Louski <louski.a@gmail.com>
Date: Sat, 8 Aug 2026 21:08:34 +0300
Subject: [PATCH] ci: group generated release notes into categories

publish.yml already creates releases with --generate-notes, but with no
config every release is one flat list. 25 of the last 40 pull requests are
dependabot, so real changes get buried.

Only labels that exist on this repository are referenced. A category pointing
at a label nobody applies is dead config that fails silently.

Validated against the schemastore draft-07 schema for this file.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 .github/release.yml | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 .github/release.yml

diff --git a/.github/release.yml b/.github/release.yml
new file mode 100644
index 0000000..cdbe787
--- /dev/null
+++ b/.github/release.yml
@@ -0,0 +1,45 @@
+# yaml-language-server: $schema=https://www.schemastore.org/github-release-config.json
+#
+# Groups the notes that `gh release create --generate-notes` produces in
+# .github/workflows/publish.yml. Without this, every release is one flat list,
+# and dependabot buries the changes anyone actually cares about.
+#
+# Only labels that exist on this repository are referenced. A category pointing
+# at a label nobody applies is dead config that fails silently.
+changelog:
+  exclude:
+    labels:
+      - duplicate
+      - invalid
+      - wontfix
+      - question
+
+  categories:
+    # First match wins, so the narrow categories have to precede the catch-all.
+    - title: ⚠️ Breaking Changes
+      labels:
+        - breaking-change
+
+    - title: ✨ Features
+      labels:
+        - enhancement
+
+    - title: 🐛 Bug Fixes
+      labels:
+        - bug
+        - possible bug
+
+    - title: 📚 Documentation
+      labels:
+        - documentation
+
+    # Dependabot applies `dependencies` alongside an ecosystem label such as
+    # `javascript` or `github_actions`. Matching on `dependencies` alone keeps a
+    # human pull request that happens to carry an ecosystem label out of here.
+    - title: ⬆️ Dependencies
+      labels:
+        - dependencies
+
+    - title: 🧹 Other Changes
+      labels:
+        - '*'