fix(changelog): allow empty unreleased on release commits

Author: pchalamet

.github/scripts/check-unreleased-changelog.sh

@@ -100,6 +100,11 @@ UNRELEASED_BLOCK=$(awk '
 ' CHANGELOG.md)
 
 if [[ -z "${UNRELEASED_BLOCK//$'\n'/}" ]]; then
+  HEAD_SUBJECT="$(git log -1 --pretty=%s)"
+  if [[ "$HEAD_SUBJECT" =~ ^chore\(release\):\ [0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+    echo "Changelog gate passed (release commit allows empty ## [Unreleased])."
+    exit 0
+  fi
   echo "ERROR: ## [Unreleased] section is empty."
   exit 1
 fi

.github/scripts/release.sh

@@ -104,7 +104,6 @@ trap 'rm -rf "$tmp_dir"' EXIT
 stripped_changelog="${tmp_dir}/changelog-stripped.md"
 new_section_file="${tmp_dir}/new-section.md"
 updated_changelog="${tmp_dir}/CHANGELOG.md"
-post_release_unreleased_bullet="- Initialize post-${version} unreleased section."
 
 awk '
   BEGIN { skip = 0 }
@@ -126,13 +125,11 @@ awk '
   echo "$compare_link"
 } > "$new_section_file"
 
-awk -v section_file="$new_section_file" -v post_bullet="$post_release_unreleased_bullet" '
+awk -v section_file="$new_section_file" '
   BEGIN { inserted = 0; skip_next_blank = 0 }
   $0 == "## [Unreleased]" && inserted == 0 {
     print
     print ""
-    print post_bullet
-    print ""
     while ((getline line < section_file) > 0) {
       print line
     }

AGENTS.md

@@ -48,6 +48,7 @@ Targeted test suites (when working on specific areas):
 - Required format for regular commits:
   - add at least one short, single-line bullet under `## [Unreleased]`.
 - Scope is strict (no exceptions for docs/process/policy/chore/dependency-only commits).
+- Exception: release commits (`chore(release): X.Y.Z`) may leave `## [Unreleased]` empty.
 - Local preflight command:
   - `make verify-changelog`
 - CI enforces this on both PRs and direct pushes to `main`.

CHANGELOG.md

@@ -4,7 +4,7 @@ All notable changes to FScript are documented in this file.
 
 ## [Unreleased]
 
-- Initialize post-0.38.2 unreleased section.
+- Updated changelog gating and release preparation so release commits can leave `## [Unreleased]` empty without placeholder bullets.
 
 ## [0.38.2]