[MNT] add auto-pr-label + -draft-changelog workflows

Author: SimonBlanke

.github/auto-label-config.yml

@@ -0,0 +1,41 @@
+# =============================================================================
+# Auto-Label Configuration
+# =============================================================================
+#
+# Used by: auto-label-prs.yml
+#
+# OUTPUT:
+#   PRs get labels based on:
+#   - Title prefix: [Fix] → "Fix" label
+#   - Changed files: docs/** → "documentation" label
+#   - Branch name: dependabot/* → "dependencies" label
+#
+# =============================================================================
+
+autolabeler:
+  - label: 'documentation'
+    files:
+      - 'docs/**/*'
+      - '*.md'
+    branch:
+      - '/docs?\/.+/'
+  - label: 'Fix'
+    title:
+      - '/^\[Fix\]/i'
+  - label: 'Feature'
+    title:
+      - '/^\[Feature\]/i'
+  - label: 'Refactor'
+    title:
+      - '/^\[Refactor\]/i'
+  - label: 'Release'
+    title:
+      - '/^\[Release\]/i'
+  - label: 'Hotfix'
+    title:
+      - '/^\[Hotfix\]/i'
+  - label: 'dependencies'
+    files:
+      - 'pyproject.toml'
+    branch:
+      - '/dependabot\/.+/'

.github/draft-changelog-config.yml

@@ -0,0 +1,67 @@
+# =============================================================================
+# Draft Changelog Configuration
+# =============================================================================
+#
+# Used by: draft-changelog.yml
+#
+# OUTPUT:
+#   A draft release in GitHub Releases containing:
+#   - Title: v5.1.0 (based on version-resolver)
+#   - Body: Grouped list of PRs (based on categories)
+#
+# =============================================================================
+
+name-template: 'v$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+
+template: |
+  ## What's Changed
+
+  $CHANGES
+
+  **Full Changelog**: https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION
+
+categories:
+  - title: 'New Features'
+    labels:
+      - 'Feature'
+      - 'enhancement'
+  - title: 'Bug Fixes'
+    labels:
+      - 'Fix'
+      - 'bug'
+      - 'Hotfix'
+  - title: 'Refactoring'
+    labels:
+      - 'Refactor'
+      - 'refactoring'
+  - title: 'Documentation'
+    labels:
+      - 'documentation'
+      - 'docs'
+  - title: 'Maintenance'
+    labels:
+      - 'maintenance'
+      - 'dependencies'
+      - 'Release'
+
+version-resolver:
+  major:
+    labels:
+      - 'major'
+      - 'breaking'
+  minor:
+    labels:
+      - 'minor'
+      - 'Feature'
+  patch:
+    labels:
+      - 'patch'
+      - 'Fix'
+      - 'Hotfix'
+  default: patch
+
+exclude-labels:
+  - 'skip-changelog'
+  - 'duplicate'
+  - 'invalid'

.github/workflows/auto-label-prs.yml

@@ -0,0 +1,35 @@
+# =============================================================================
+# Auto-Label PRs
+# =============================================================================
+#
+# TRIGGER:
+#   When a PR is opened or updated
+#
+# OUTPUT:
+#   PR gets a label based on its title prefix:
+#   - [Fix] → "Fix" label
+#   - [Feature] → "Feature" label
+#   - [Refactor] → "Refactor" label
+#   - etc.
+#
+# =============================================================================
+
+name: Auto-Label PRs
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  add_labels:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6
+        with:
+          config-name: auto-label-config.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/draft-changelog.yml

@@ -0,0 +1,39 @@
+# =============================================================================
+# Draft Changelog
+# =============================================================================
+#
+# TRIGGER:
+#   When code is merged/pushed to main
+#
+# OUTPUT:
+#   A draft release in GitHub Releases section containing:
+#   - Grouped list of merged PRs (Features, Bug Fixes, etc.)
+#   - Suggested next version number
+#
+# DOES NOT:
+#   - Publish the release (you must click "Publish" manually)
+#   - Create git tags
+#   - Upload to PyPI
+#
+# =============================================================================
+
+name: Draft Changelog
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  update_draft:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: release-drafter/release-drafter@v6
+        with:
+          config-name: draft-changelog-config.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}