[REL-4161] fix changelog formatting (#525)

Needed to massage the changelog into shape.
<!-- ld-jira-link -->
---
Related Jira issue: [REL-4161: Migrate ld-find-code-refs from Releaser
to GHA](https://launchdarkly.atlassian.net/browse/REL-4161)
<!-- end-ld-jira-link -->

Author: blaqbern

.github/workflows/release.yml

@@ -25,13 +25,19 @@ jobs:
     env:
       LD_RELEASE_VERSION: ${{ inputs.releaseVersion }}
       DRY_RUN: ${{ inputs.dryRun || 'false' }}
-      CHANGELOG_ENTRY: ${{ inputs.changeLog }}
+      CHANGELOG_ENTRY: ${{ toJSON(inputs.changeLog) }}
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       ARTIFACT_DIRECTORY: "/tmp/release-artifacts"
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
+      - name: Install jq
+        run: |
+          if ! command -v jq >/dev/null; then
+            sudo apt-get update
+            sudo apt-get install -y jq
+          fi
       - name: get secrets
         uses: launchdarkly/gh-actions/actions/[email protected]
         with:
@@ -70,5 +76,5 @@ jobs:
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           tag: v${{ inputs.releaseVersion }}
-          body: ${{ inputs.changeLog }}
+          body: ${{ fromJSON(toJSON(inputs.changeLog)) }}
           artifacts: ${{ env.ARTIFACT_DIRECTORY }}/*

scripts/release/commit-and-tag.sh

@@ -2,36 +2,34 @@
 
 set -euo pipefail
 
-RELEASE_TAG="v${LD_RELEASE_VERSION}"
+release_tag="v${LD_RELEASE_VERSION}"
 
 tag_exists() (
   git fetch --tags
-  git rev-parse "${RELEASE_TAG}" >/dev/null 2>&1
+  git rev-parse "${release_tag}" >/dev/null 2>&1
 )
 
 update_changelog() (
   local ts=$(date +"%Y-%m-%d")
-  local changelog_entry=$(printf "## [%s] - %s\n%s\n" "$LD_RELEASE_VERSION" "$ts" "$CHANGELOG_ENTRY")
+  local changelog_json=$(echo "$CHANGELOG_ENTRY" | jq =r .)
+  local changelog_entry=$(printf "## [%s] - %s\n%s\n" "$LD_RELEASE_VERSION" "$ts" "$changelog_json")
 
   # insert the new changelog entry (followed by empty line) after line 4
   # of CHANGELOG.md
   sed -i "4r /dev/stdin" CHANGELOG.md <<< "$changelog_entry"$'\n'
 )
 
 release_summary() (
-  echo
-  echo "Changes staged for release $RELEASE_TAG:"
+  echo "Changes staged for release $release_tag:"
   git diff
 
-  echo
   echo "Updated CHANGELOG:"
   cat CHANGELOG.md
-  echo
 )
 
 commit_and_tag() (
   if tag_exists; then
-    echo "Tag $RELEASE_TAG already exists. Aborting."
+    echo "Tag $release_tag already exists. Aborting."
     exit 1
   fi
 
@@ -41,10 +39,10 @@ commit_and_tag() (
   git config user.name "LaunchDarklyReleaseBot"
   git config user.email "[email protected]"
   git add .
-  git commit -m "Prepare release ${RELEASE_TAG}"
-  git tag "${RELEASE_TAG}"
+  git commit -m "Prepare release ${release_tag}"
+  git tag "${release_tag}"
   git push origin HEAD
-  git push origin "${RELEASE_TAG}"
+  git push origin "${release_tag}"
 )
 
 if [[ "$DRY_RUN" == "true" ]]; then