ci: include checksums and commit messages in releases

- Generate promoted release .sha256 assets after jar renaming
- Upload promoted jar checksums to GitHub releases
- Mention promoted checksums in release notes
- Include full commit messages in build release notes

Author: TheSilentPro

.github/release.yml

@@ -0,0 +1,38 @@
+changelog:
+  exclude:
+    labels:
+      - ignore-for-release
+      - internal
+    authors:
+      - github-actions[bot]
+
+  categories:
+    - title: Added
+      labels:
+        - feature
+        - enhancement
+
+    - title: Fixed
+      labels:
+        - bug
+        - fix
+
+    - title: Changed
+      labels:
+        - change
+        - refactor
+        - improvement
+
+    - title: Updater and Release
+      labels:
+        - updater
+        - release
+        - ci
+
+    - title: Documentation
+      labels:
+        - documentation
+
+    - title: Other Changes
+      labels:
+        - "*"

.github/workflows/promote-release.yml

@@ -1,5 +1,3 @@
-# .github/workflows/promote-release.yml
-
 name: Promote Release
 
 on:
@@ -156,25 +154,104 @@ jobs:
           promoted_jar="dist/promoted/HeadDB-${{ steps.meta.outputs.target_version }}.jar"
           cp "${jars[0]}" "$promoted_jar"
 
+          promoted_sha="${promoted_jar}.sha256"
+
+          (
+            cd "$(dirname "$promoted_jar")"
+            sha256sum "$(basename "$promoted_jar")" > "$(basename "$promoted_sha")"
+          )
+
           echo "jar=${promoted_jar}" >> "$GITHUB_OUTPUT"
+          echo "sha=${promoted_sha}" >> "$GITHUB_OUTPUT"
+
+      - name: Resolve previous public release tag
+        id: previous
+        shell: bash
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+
+          current_tag="${{ steps.meta.outputs.target_tag }}"
+
+          previous_tag="$(
+            gh release list \
+              --repo "${GITHUB_REPOSITORY}" \
+              --limit 100 \
+              --json tagName,isDraft,publishedAt \
+              --jq '
+                [
+                  .[]
+                  | select(.isDraft == false)
+                  | select(.tagName != "'"${current_tag}"'")
+                  | select(.tagName | contains("+build.") | not)
+                ]
+                | sort_by(.publishedAt)
+                | reverse
+                | .[0].tagName // ""
+              '
+          )"
 
-      - name: Create release notes
+          echo "tag=${previous_tag}" >> "$GITHUB_OUTPUT"
+
+          if [[ -n "$previous_tag" ]]; then
+            echo "Previous public release: ${previous_tag}"
+          else
+            echo "No previous public release found."
+          fi
+
+      - name: Generate release notes
+        id: notes
         shell: bash
+        env:
+          GH_TOKEN: ${{ github.token }}
         run: |
           set -euo pipefail
 
-          cat > release-notes.md <<'EOF'
-          HeadDB ${{ steps.meta.outputs.target_version }}
+          args=(
+            repos/${GITHUB_REPOSITORY}/releases/generate-notes
+            --method POST
+            --field tag_name="${{ steps.meta.outputs.target_tag }}"
+            --field target_commitish="${{ steps.meta.outputs.source_commit }}"
+          )
+
+          if [[ -n "${{ steps.previous.outputs.tag }}" ]]; then
+            args+=(--field previous_tag_name="${{ steps.previous.outputs.tag }}")
+          fi
+
+          if gh api "repos/${GITHUB_REPOSITORY}/contents/.github/release.yml?ref=${{ steps.meta.outputs.source_commit }}" >/dev/null 2>&1; then
+            args+=(--field configuration_file_path=".github/release.yml")
+          elif gh api "repos/${GITHUB_REPOSITORY}/contents/.github/release.yaml?ref=${{ steps.meta.outputs.source_commit }}" >/dev/null 2>&1; then
+            args+=(--field configuration_file_path=".github/release.yaml")
+          fi
+
+          gh api "${args[@]}" > generated-release-notes.json
+
+          jq -r '.body // ""' generated-release-notes.json > generated-body.md
+
+          cat > release-notes.md <<EOF
+          ## HeadDB ${{ steps.meta.outputs.target_version }}
 
           This release promotes an already-built GitHub release artifact.
 
           Source build: ${{ steps.meta.outputs.source_tag }}
           Source release: ${{ steps.meta.outputs.source_url }}
           Source commit: ${{ steps.meta.outputs.source_commit }}
 
-          The attached jar is the promoted jar from the source build release.
+          The attached jar and .sha256 checksum are promoted from the source build release.
+
           EOF
 
+          cat generated-body.md >> release-notes.md
+
+          delimiter="RELEASE_NOTES_$(date +%s)_${RANDOM}"
+
+          {
+            echo "body<<${delimiter}"
+            cat release-notes.md
+            echo "${delimiter}"
+          } >> "$GITHUB_OUTPUT"
+
       - name: Create promoted GitHub release
         shell: bash
         env:
@@ -185,6 +262,7 @@ jobs:
           args=(
             "${{ steps.meta.outputs.target_tag }}"
             "${{ steps.asset.outputs.jar }}"
+            "${{ steps.asset.outputs.sha }}"
             --repo "${GITHUB_REPOSITORY}"
             --target "${{ steps.meta.outputs.source_commit }}"
             --title "HeadDB ${{ steps.meta.outputs.target_version }}"
@@ -206,12 +284,7 @@ jobs:
           version: ${{ steps.meta.outputs.target_version }}
           name: HeadDB ${{ steps.meta.outputs.target_version }}
           channel: ${{ steps.meta.outputs.modrinth_channel }}
-          changelog: |
-            HeadDB ${{ steps.meta.outputs.target_version }}
-
-            Promoted from ${{ steps.meta.outputs.source_tag }}.
-
-            Source release: ${{ steps.meta.outputs.source_url }}
+          changelog: ${{ steps.notes.outputs.body }}
           loaders: |-
             paper
             folia
@@ -229,12 +302,7 @@ jobs:
           slug: ${{ vars.HANGAR_PROJECT_SLUG }}
           version: ${{ steps.meta.outputs.target_version }}
           channel: ${{ steps.meta.outputs.hangar_channel }}
-          description: |
-            HeadDB ${{ steps.meta.outputs.target_version }}
-
-            Promoted from ${{ steps.meta.outputs.source_tag }}.
-
-            Source release: ${{ steps.meta.outputs.source_url }}
+          description: ${{ steps.notes.outputs.body }}
           files: |-
             [
               {

.github/workflows/release.yml

@@ -114,6 +114,22 @@ jobs:
           echo "jar=${jar_name}" >> "$GITHUB_OUTPUT"
           echo "sha=${jar_name}.sha256" >> "$GITHUB_OUTPUT"
 
+      - name: Create build release notes
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          {
+            echo "## HeadDB ${{ steps.version.outputs.build_version }}"
+            echo
+            echo "Build from commit: ${GITHUB_SHA}"
+            echo
+            echo "### Commit message"
+            echo
+            git log -1 --pretty=format:%s%n%n%b
+            echo
+          } > release-notes.md
+
       - name: Create GitHub Release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -132,5 +148,5 @@ jobs:
             "${{ steps.assets.outputs.sha }}" \
             --target "${GITHUB_SHA}" \
             --title "HeadDB ${{ steps.version.outputs.build_version }}" \
-            --notes "Build ${{ steps.version.outputs.build_version }} from commit ${GITHUB_SHA}." \
+            --notes-file release-notes.md \
             ${prerelease_flag}