ci: add git-cliff changelog generation to prod deploy pipeline

Creates a GitHub Release with a categorized changelog after each
successful production deploy, using date-based version tags.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Mlaz-code

.github/workflows/deploy-prod.yml

@@ -129,6 +129,47 @@ jobs:
           echo "## Rollback" >> $GITHUB_STEP_SUMMARY
           echo "**Promoted**: ${{ steps.target.outputs.target_url }}" >> $GITHUB_STEP_SUMMARY
 
+  changelog:
+    name: Changelog & Release
+    needs: deploy-production
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    if: inputs.dry_run != true && inputs.rollback != true
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Determine version tag
+        id: version
+        run: |
+          TAG="v$(date -u +%Y.%m.%d)"
+          # Append run number suffix if tag already exists
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            TAG="${TAG}.${{ github.run_number }}"
+          fi
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+
+      - name: Generate changelog
+        uses: orhun/git-cliff-action@v4
+        id: cliff
+        with:
+          config: cliff.toml
+          args: --latest --strip header
+        env:
+          OUTPUT: CHANGES.md
+          GITHUB_REPO: ${{ github.repository }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.tag }}
+          name: ${{ steps.version.outputs.tag }}
+          body: ${{ steps.cliff.outputs.content }}
+          generate_release_notes: false
+
   health-check:
     name: Health Check
     needs: deploy-production

cliff.toml

@@ -0,0 +1,58 @@
+# git-cliff configuration — https://git-cliff.org/docs/configuration
+
+[changelog]
+header = """
+# Changelog\n
+"""
+body = """
+{%- macro remote_url() -%}
+  https://github.com/{{ remote.github.owner }}/{{ remote.github.repo }}
+{%- endmacro -%}
+
+{% 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 %}
+    - {% if commit.scope %}**{{ commit.scope }}**: {% endif %}{{ commit.message | upper_first }}\
+      {% if commit.github.username %} by @{{ commit.github.username }}{%- endif -%}
+      {% if commit.github.pr_number %} in \
+        [#{{ commit.github.pr_number }}]({{ self::remote_url() }}/pull/{{ commit.github.pr_number }}) \
+      {%- endif -%}
+  {% endfor %}
+{% endfor %}
+"""
+trim = true
+footer = ""
+postprocessors = [
+  { pattern = '\$REPO', replace = "https://github.com/sharpapi/docs.sharpapi.io" },
+]
+
+[git]
+conventional_commits = true
+filter_unconventional = false
+split_commits = false
+commit_parsers = [
+  { message = "^feat", group = "Features" },
+  { message = "^fix", group = "Bug Fixes" },
+  { message = "^docs", group = "Documentation" },
+  { message = "^seo", group = "SEO" },
+  { message = "^perf", group = "Performance" },
+  { message = "^refactor", group = "Refactoring" },
+  { message = "^style", group = "Styling" },
+  { message = "^ci", group = "CI/CD" },
+  { message = "^chore", group = "Miscellaneous" },
+  { message = "^build", group = "Build" },
+]
+protect_breaking_commits = false
+filter_commits = false
+topo_order = false
+sort_commits = "newest"
+
+[remote.github]
+owner = "sharpapi"
+repo = "docs.sharpapi.io"