Surface direct commits in release notes when no PR landed in the range

GitHub's generate-notes API only sees merged PRs. Releases cut from
direct pushes to main (which is how this repo currently ships) get a
near-empty "Full Changelog" body. Add .github/release.yml to categorize
PR-based notes when they exist, and have the workflow fall back to a
git log between the previous and current tag when generate-notes
returns no "What's Changed" section. Switch checkout to full depth so
git describe can reach the previous tag.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: bones7456

.github/release.yml

@@ -0,0 +1,17 @@
+changelog:
+  categories:
+    - title: Features
+      labels:
+        - enhancement
+        - feature
+    - title: Bug Fixes
+      labels:
+        - bug
+        - fix
+    - title: Documentation
+      labels:
+        - documentation
+        - docs
+    - title: Other Changes
+      labels:
+        - "*"

.github/workflows/release.yml

@@ -28,6 +28,8 @@ jobs:
         uses: actions/checkout@v5
         with:
           ref: ${{ github.event.inputs.tag || github.ref }}
+          fetch-depth: 0
+          fetch-tags: true
 
       - name: Select Xcode
         uses: maxim-lobanov/setup-xcode@v1
@@ -76,10 +78,40 @@ jobs:
           NOTES_MD="$RUNNER_TEMP/release_notes.md"
           NOTES_HTML="$RUNNER_TEMP/release_notes.html"
 
+          # PR-based notes (uses .github/release.yml for categorization).
           gh api -X POST "/repos/${{ github.repository }}/releases/generate-notes" \
             -f tag_name="$TAG" \
             --jq .body > "$NOTES_MD"
 
+          # If no PRs landed between the previous tag and this one, the body
+          # only carries the "Full Changelog" link. Synthesize a Changes
+          # section from git log so direct commits still appear in the notes.
+          if ! grep -qF '## What' "$NOTES_MD"; then
+            # Fetch full history so describe/log can reach the previous tag.
+            git fetch --tags --unshallow 2>/dev/null || git fetch --tags
+            PREV_TAG="$(git describe --tags --abbrev=0 "$TAG^" 2>/dev/null || true)"
+            RANGE="${PREV_TAG:+$PREV_TAG..}$TAG"
+
+            COMMITS="$(git log --no-merges \
+              --pretty=format:"- %s ([\`%h\`](https://github.com/${{ github.repository }}/commit/%H))" \
+              "$RANGE")"
+
+            if [ -n "$COMMITS" ]; then
+              {
+                echo "## Changes"
+                echo
+                echo "$COMMITS"
+                echo
+                cat "$NOTES_MD"
+              } > "$NOTES_MD.new"
+              mv "$NOTES_MD.new" "$NOTES_MD"
+            fi
+          fi
+
+          echo "--- release notes (markdown) ---"
+          cat "$NOTES_MD"
+          echo "--- end ---"
+
           gh api -X POST /markdown \
             -F text=@"$NOTES_MD" \
             -f mode=gfm \