Use changelog section for draft release notes

Author: pchalamet

.github/scripts/extract-release-notes.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -ne 1 ]]; then
+  echo "Usage: $0 <version>"
+  exit 2
+fi
+
+version="$1"
+section_header="## [${version}]"
+
+if [[ ! -f CHANGELOG.md ]]; then
+  echo "ERROR: CHANGELOG.md not found."
+  exit 1
+fi
+
+section_body="$(
+  awk -v header="$section_header" '
+    BEGIN { in_section = 0 }
+    $0 == header { in_section = 1; next }
+    /^## \[/ && in_section { exit }
+    in_section { print }
+  ' CHANGELOG.md
+)"
+
+if [[ -z "${section_body//[[:space:]]/}" ]]; then
+  echo "ERROR: Missing or empty changelog section '${section_header}'."
+  echo "Add a '${section_header}' section to CHANGELOG.md before tagging."
+  exit 1
+fi
+
+if ! grep -q '^[[:space:]]*-\s\+' <<<"$section_body"; then
+  echo "ERROR: Section '${section_header}' must include at least one bullet line."
+  exit 1
+fi
+
+if ! grep -q '\*\*Full Changelog\*\*:' <<<"$section_body"; then
+  echo "ERROR: Section '${section_header}' must include a '**Full Changelog**' compare link."
+  exit 1
+fi
+
+printf '%s\n' "$section_body"

.github/workflows/on-push-tag.yml

@@ -75,13 +75,18 @@ jobs:
           BUILD_VERSION_SUFFIX=${BASH_REMATCH[2]}
           echo "BUILD_VERSION_SUFFIX=$BUILD_VERSION_SUFFIX" >> $GITHUB_ENV
 
+      - name: Extract release notes from changelog
+        shell: bash
+        run: |
+          ./.github/scripts/extract-release-notes.sh "${GITHUB_REF_NAME}" > "${RUNNER_TEMP}/release-notes.md"
+
       - name: Create draft GitHub release
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ github.ref_name }}
           draft: true
           prerelease: ${{ env.BUILD_VERSION_SUFFIX != '' }}
-          generate_release_notes: true
+          body_path: ${{ runner.temp }}/release-notes.md
           files: |
             .out/*.zip
             .out/*.nupkg

AGENTS.md

@@ -61,12 +61,13 @@ Follow this exact sequence for every release:
 3. Commit the changelog update to `main`.
 4. Create and push tag `X.Y.Z`.
 5. Wait for CI to create the GitHub Release **as draft** from the tag workflow.
-6. Only after the draft exists, update draft notes from `CHANGELOG.md` if needed.
+6. Confirm the draft notes are sourced from `CHANGELOG.md` `## [X.Y.Z]` (including compare link).
 7. Publish that existing draft release (do not create/publish a release manually before CI draft creation).
 
 Rules:
 - Tag-triggered CI is the source of truth for release artifacts and draft release creation.
 - Do not bypass the draft step.
+- Tag workflow must fail if `CHANGELOG.md` has no non-empty `## [X.Y.Z]` section with bullets and compare link.
 - Release notes must match the `CHANGELOG.md` version section and keep the compare link.
 
 ## Specification Maintenance (Mandatory)

CHANGELOG.md

@@ -4,6 +4,7 @@ All notable changes to FScript are documented in this file.
 
 ## [Unreleased]
 
+- Release tag workflow now populates draft release notes from the matching `CHANGELOG.md` version section and fails fast when it is missing or invalid.
 - Initialize post-0.37.0 unreleased section.
 
 ## [0.37.0]