refactor(release-changelog): extract release changelog into composite action

Move the release changelog generation and git staging logic from the
promote workflow into a new release-changelog composite action. The
action runs git-cliff and stages the output file, removing the need
for the resolve-changelog-git-add-files step in promote.

Author: jobcespedes

.github/workflows/promote.yml

@@ -278,32 +278,15 @@ jobs:
       - name: release changelog
         id: release_changelog
         if: inputs.changelog-enabled
-        uses: orhun/git-cliff-action@v4
-        env:
-          OUTPUT: ${{ inputs.changelog-prepend && '/tmp/cliff-changelog.md' || inputs.changelog-output || 'CHANGELOG.md' }}
+        uses: getdevopspro/github-actions/release-changelog@v7.2.2
         with:
+          version: ${{ steps.release_version.outputs.version }}
+          previous-version: ${{ steps.release_version.outputs.previous-version }}
+          token: ${{ inputs.changelog-token }}
+          output: ${{ inputs.changelog-output }}
           config: ${{ inputs.changelog-config }}
-          args: >-
-            ${{ steps.release_version.outputs.previous-version }}..${{ inputs.changelog-prepend && 'HEAD' || steps.release_version.outputs.version }}
-            --tag ${{ steps.release_version.outputs.version }}
-            ${{ inputs.changelog-prepend && format('--prepend {0}', inputs.changelog-output || 'CHANGELOG.md') || '' }}
-            ${{ inputs.changelog-args }}
-          github_token: ${{ inputs.changelog-token || github.token }}
-
-      - name: resolve changelog git-add-files
-        id: resolve_changelog_git_add_files
-        if: inputs.changelog-enabled
-        shell: bash
-        run: |
-          set -euo pipefail
-          CHANGELOG_FILE="${{ inputs.changelog-output }}"
-          CHANGELOG_FILE="${CHANGELOG_FILE:-CHANGELOG.md}"
-          FILES="${{ inputs.git-add-files }}"
-          case " ${FILES} " in
-            *" ${CHANGELOG_FILE} "*) ;;
-            *) FILES="${FILES:+${FILES} }${CHANGELOG_FILE}" ;;
-          esac
-          echo "files=${FILES}" >> "$GITHUB_OUTPUT"
+          args: ${{ inputs.changelog-args }}
+          prepend: ${{ inputs.changelog-prepend }}
 
       - name: push git version
         uses: getdevopspro/github-actions/release-git-push@v7.2.2
@@ -313,7 +296,7 @@ jobs:
           version: ${{ steps.release_version.outputs.version }}
           git-user-name: ${{ inputs.git-user-name }}
           git-user-email: ${{ inputs.git-user-email }}
-          git-add-files: ${{ steps.resolve_changelog_git_add_files.outputs.files || inputs.git-add-files }}
+          git-add-files: ${{ inputs.git-add-files }}
 
       - name: publish github release
         if: inputs.update-release-enabled && inputs.push-git

release-changelog/action.yml

@@ -0,0 +1,54 @@
+name: Release Changelog
+description: 'Generate a release changelog using git-cliff and stage the output file'
+inputs:
+  version:
+    description: 'The release version to tag the changelog with'
+    required: true
+  previous-version:
+    description: 'The previous version to generate the changelog from'
+    required: true
+  token:
+    description: 'GitHub token for changelog generation (defaults to current GitHub token)'
+    required: false
+    default: ''
+  output:
+    description: 'Output file path for the generated changelog'
+    required: false
+    default: 'CHANGELOG.md'
+  config:
+    description: 'Path to the cliff.toml config file passed to git-cliff'
+    required: false
+    default: 'cliff'
+  args:
+    description: 'Additional arguments to pass to git-cliff'
+    required: false
+    default: ''
+  prepend:
+    description: 'Prepend the generated changelog to the output file instead of overwriting it'
+    required: false
+    default: 'true'
+outputs:
+  content:
+    description: 'The generated changelog content'
+    value: ${{ steps.git_cliff.outputs.content }}
+runs:
+  using: "composite"
+  steps:
+    - name: release changelog
+      id: git_cliff
+      uses: orhun/git-cliff-action@v4
+      env:
+        OUTPUT: ${{ inputs.prepend == 'true' && '/tmp/cliff-changelog.md' || inputs.output }}
+      with:
+        config: ${{ inputs.config }}
+        args: >-
+          ${{ inputs.previous-version }}..${{ inputs.prepend == 'true' && 'HEAD' || inputs.version }}
+          --tag ${{ inputs.version }}
+          ${{ inputs.prepend == 'true' && format('--prepend {0}', inputs.output) || '' }}
+          ${{ inputs.args }}
+        github_token: ${{ inputs.token || github.token }}
+
+    - name: add changelog to git staging
+      shell: bash
+      run: |
+        git add "${{ inputs.output }}"