ci: add automated changelog generation and GitHub releases

- Add git-cliff configuration (cliff.toml) for generating changelogs
  from commit messages following Keep a Changelog format
- Update release workflow to automatically generate changelog and
  create GitHub releases with release notes when a version tag is pushed
- Uses git-cliff 2.10.1 for parsing commit history and extracting
  issues/PRs references

Author: RAprogramm

.github/workflows/release.yml

@@ -72,3 +72,38 @@ jobs:
         env:
           CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
         run: cargo +${{ steps.msrv.outputs.msrv }} publish --locked --token "$CARGO_REGISTRY_TOKEN"
+
+  release:
+    runs-on: ubuntu-latest
+    needs: publish
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Install git-cliff
+        uses: taiki-e/install-action@v2
+        with:
+          tool: [email protected]
+
+      - name: Generate changelog
+        id: changelog
+        shell: bash
+        run: |
+          TAG="${GITHUB_REF#refs/tags/}"
+
+          # Generate changelog for current tag only
+          CHANGELOG=$(git cliff --current --strip header)
+
+          # Save to output using multiline format
+          echo "content<<EOF" >> "$GITHUB_OUTPUT"
+          echo "$CHANGELOG" >> "$GITHUB_OUTPUT"
+          echo "EOF" >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body: ${{ steps.changelog.outputs.content }}
+          generate_release_notes: false

cliff.toml

@@ -0,0 +1,90 @@
+# git-cliff configuration file
+# https://git-cliff.org/docs/configuration
+
+[changelog]
+# Changelog header
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n
+"""
+
+# Template for changelog body
+body = """
+{% if version %}\
+    ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+{% else %}\
+    ## [Unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+    ### {{ group | striptags | trim | upper_first }}
+    {% for commit in commits %}
+        - {{ commit.message | upper_first }}
+    {% endfor %}
+{% endfor %}\n
+"""
+
+# Template for changelog footer
+footer = """
+<!-- generated by git-cliff -->
+"""
+
+# Remove the leading and trailing whitespace from the template
+trim = true
+
+[git]
+# Parse commits based on https://www.conventionalcommits.org
+conventional_commits = false
+# Filter unconventional commits
+filter_unconventional = false
+# Split the commit message by pattern
+split_commits = false
+
+# Regex for preprocessing commit messages
+commit_preprocessors = [
+    # Transform "#123 type: description" to "type: description (#123)"
+    { pattern = '^#(\d+)\s+(.+)$', replace = "${2} (#${1})" },
+]
+
+# Regex for parsing commit messages
+commit_parsers = [
+    { message = "^feat", group = "Added" },
+    { message = "^add", group = "Added" },
+    { message = "^fix", group = "Fixed" },
+    { message = "^perf", group = "Changed" },
+    { message = "^refactor", group = "Changed" },
+    { message = "^docs", group = "Changed" },
+    { message = "^test", group = "Changed" },
+    { message = "^chore\\(release\\): prepare for", skip = true },
+    { message = "^chore\\(deps.*\\)", skip = true },
+    { message = "^chore\\(pr\\)", skip = true },
+    { message = "^chore\\(pull\\)", skip = true },
+    { message = "^chore: bump version", skip = true },
+    { message = "^Merge pull request", skip = true },
+    { message = "^Merge branch", skip = true },
+    { message = "^deps\\(", skip = true },
+    { message = "^ci", skip = true },
+    { body = ".*security", group = "Security" },
+    { message = "^revert", group = "Reverted" },
+]
+
+# Protect breaking changes from being skipped due to matching a skipping commit_parser
+protect_breaking_commits = false
+
+# Filter out commits that match the specified patterns
+filter_commits = false
+
+# Glob pattern for matching git tags
+tag_pattern = "v[0-9].*"
+
+# Sort tags chronologically
+date_order = false
+sort_commits = "oldest"
+
+# Link parsers for extracting external references
+link_parsers = [
+    { pattern = "\\(#(\\d+)\\)", href = "https://github.com/RAprogramm/telegram-webapp-sdk/issues/$1", text = "#$1" },
+]