chore(changelog): update changelog for v1.1.0

- Remove branch-specific checks from conditional statements
- Simplify logic for changelog generation and release steps
- Ensure consistent behavior regardless of branch context

.gitea/default_merge_message/MERGE_TEMPLATE.md

@@ -0,0 +1,5 @@
+chore(pr): ${PullRequestTitle} ${PullRequestReference}
+
+${PullRequestDescription}
+
+Merged from ${HeadBranch} into ${BaseBranch}

.gitea/workflows/create-major-tag.yml

@@ -0,0 +1,61 @@
+name: Create Major Version Tag
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  update-major-tag:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # nötig zum Löschen/Erstellen von Tags
+
+    steps:
+      # ▸ 1. Repository beim Release-Tag auschecken
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # alle Tags holen
+          ref: ${{ github.event.release.tag_name }}
+
+      # ▸ 2. Hauptversion aus dem Release-Tag extrahieren
+      - name: Derive major version
+        id: derive
+        shell: bash
+        run: |
+          TAG="${{ github.event.release.tag_name }}"       # z. B. v2.3.4
+          echo "Release-Tag: $TAG"
+
+          TAG_NOPREFIX="${TAG#v}"                          # entfernt führendes v/V
+          MAJOR="${TAG_NOPREFIX%%.*}"                      # nimmt Teil vor erstem Punkt
+          MAJOR_TAG="v${MAJOR}"                            # z. B. v2
+
+          echo "Major-Tag: $MAJOR_TAG"
+          echo "major_tag=$MAJOR_TAG" >>"$GITHUB_OUTPUT"
+
+      # ▸ 3. Altes Major-Tag (falls vorhanden) löschen und neu anlegen
+      - name: Re-create major tag
+        env:
+          MAJOR_TAG: ${{ steps.derive.outputs.major_tag }}
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          git config user.name "$CI_COMMIT_AUTHOR_NAME"
+          git config user.email "$CI_COMMIT_AUTHOR_EMAIL"
+
+          # Bestimmten Commit des Release-Tags ermitteln
+          COMMIT_SHA="$(git rev-list -n 1 "$RELEASE_TAG")"
+
+          echo "Commit des Release-Tags: $COMMIT_SHA"
+
+          # (a) Lokal + remote altes Major-Tag entfernen (falls es existiert)
+          git tag -d "$MAJOR_TAG" 2>/dev/null || true
+          git push --delete origin "$MAJOR_TAG" 2>/dev/null || true
+
+          # (b) Neues annotiertes Tag erstellen und pushen
+          git tag -a "$MAJOR_TAG" "$COMMIT_SHA" \
+            -m "Update $MAJOR_TAG → $RELEASE_TAG"
+          git push origin "$MAJOR_TAG"
+
+          echo "✅ $MAJOR_TAG zeigt nun auf $RELEASE_TAG ($COMMIT_SHA)"

.gitea/workflows/release.yml

@@ -14,6 +14,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Release
-        uses: https://git.0xmax42.io/actions/auto-changelog-release-action@main
+        uses: https://git.0xmax42.io/actions/auto-changelog-release-action@v0
         with:
           token: ${{ secrets.RELEASE_PUBLISH_TOKEN }}
+          allow_non_main_release: "true"

CHANGELOG.md

@@ -2,6 +2,149 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.0](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v1.0.1..v1.1.0) - 2025-09-29
+
+### 🚀 Features
+
+- *(scripts)* Add type extraction and mismatch detection logic - ([e8426bb](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/e8426bb839dd29f807f232efe5f7bf829ec4f9f1))
+
+### 📚 Documentation
+
+- Add changelog improvement ideas to TODO file - ([f54df9f](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/f54df9fbc42e3fc453042a1f2c36f7cd12e38c41))
+
+### ⚙️ Miscellaneous Tasks
+
+- *(config)* Improve child commit handling in merge template - ([65462f5](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/65462f5a1495aa45afd727a962126db953ab75a5))
+
+## [1.0.1](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v1.0.0..v1.0.1) - 2025-09-27
+
+### ⚙️ Miscellaneous Tasks
+
+- *(scripts)* Check for existing Python installation - ([94980be](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/94980be3e5e5827b75edf9abeab0987709fa3122))
+
+## [1.0.0](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.4.3..v1.0.0) - 2025-09-27
+
+### 🚀 Features
+
+- *(ci)* [**breaking**] Enhance changelog generation with context augmentation - ([8de8b47](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/8de8b470386cf9f21cec660ba71d840ea6786231))
+
+### 🐛 Bug Fixes
+
+- *(release)* Fix changelog generation pipe usage - ([fedcc1f](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/fedcc1ff41b9535f5002d046427dd640b647bde4))
+
+### ⚙️ Miscellaneous Tasks
+
+- *(release)* Update action version in workflow - ([73a1b5c](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/73a1b5cc243248b50275b2368a4cd92bbb4a1a8e))
+- *(ci)* Allow non-main branch releases - ([121ea5b](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/121ea5b57a587626a036738c23e2983380470dd7))
+
+## [0.4.3](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.4.2..v0.4.3) - 2025-06-29
+
+### 🐛 Bug Fixes
+
+- *(script)* Use dynamic branch name for git push - ([27ee174](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/27ee1746dbc7b2c6c1564a04c024337ff158a9c5))
+
+## [0.4.2](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.4.1..v0.4.2) - 2025-06-29
+
+### 🐛 Bug Fixes
+
+- *(action)* Update conditions for version detection - ([c25b2e9](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/c25b2e9cd551e923b84cd144b818940fd5e1ccff))
+
+## [0.4.1](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.4.0..v0.4.1) - 2025-06-29
+
+### 🐛 Bug Fixes
+
+- *(action)* Standardize input key naming - ([cbcd5e2](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/cbcd5e2ab7e7f2498021d5043da9999f62dcf44d))
+
+## [0.4.0](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.3.6..v0.4.0) - 2025-06-29
+
+### 🚀 Features
+
+- *(action)* Add support for non-main branch releases - ([1d9659b](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/1d9659b6df0d63ed17432e677ee77a4c17d2f2f3))
+
+## [0.3.6](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.3.5..v0.3.6) - 2025-06-29
+
+### ◀️ Revert
+
+- Integrate gha-timer for step timing - ([856565d](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/856565d87f2575d6883705ddde3d177555c1bd86))
+
+## [0.3.5](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.3.4..v0.3.5) - 2025-06-29
+
+### 🚀 Features
+
+- *(action)* Integrate gha-timer for step timing - ([e5f5084](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/e5f50849316f5dc0b045ac696c3628e610bae695))
+
+### ◀️ Revert
+
+- Improve CI readability with grouped git setup logs - ([039a14a](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/039a14a473493fd74fb61b60910652db3cfd5976))
+
+## [0.3.4](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.3.2..v0.3.4) - 2025-06-29
+
+### ⚙️ Miscellaneous Tasks
+
+- *(workflows)* Update action to specific version - ([a4ff409](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/a4ff409fd812a5ccd2291251de5cd2af9bb0e713))
+- *(scripts)* Update file permissions to executable - ([374f30a](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/374f30a50206a426b8de7a0b78cde9ad4194469f))
+
+## [0.3.2](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.3.1..v0.3.2) - 2025-06-29
+
+### 🚜 Refactor
+
+- *(action)* Simplify script invocation syntax - ([b75e412](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/b75e4121928131c1a1c0cbdea954a4fd602edd1a))
+
+## [0.3.1](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.3.0..v0.3.1) - 2025-06-29
+
+### ⚙️ Miscellaneous Tasks
+
+- *(scripts)* Improve CI readability with grouped git setup logs - ([8a3960a](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/8a3960ad8712bc29823dc601a120a61582fa2a3b))
+
+## [0.3.0](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.2.3..v0.3.0) - 2025-06-20
+
+### 🚀 Features
+
+- *(script)* Enhance git-cliff installer with jq support - ([5226899](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/522689977fe8883975e68add1b0cba2e685978ee))
+
+### ⚙️ Miscellaneous Tasks
+
+- *(workflows)* Update release action version - ([79d7c5a](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/79d7c5a7eefda51f03a9bde0e933689c29d57567))
+
+## [0.2.3](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.2.2..v0.2.3) - 2025-06-14
+
+### 🐛 Bug Fixes
+
+- *(script)* Adjust GIT_AUTHOR_DATE format for compatibility - ([5d42ea9](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/5d42ea9ddbfa4f151c83fc16c652d55618f2ee04))
+
+## [0.2.2](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.2.1..v0.2.2) - 2025-06-14
+
+### 🚀 Features
+
+- *(scripts)* Validate git configuration during setup - ([212e8c6](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/212e8c6a499365ac77c98138a09b6736dec8fe7e))
+
+### 🚜 Refactor
+
+- *(scripts)* Standardize scripts and improve readability - ([041d7e9](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/041d7e9a8a7baa5b6f41ad6dabd7d4837f7d254a))
+
+## [0.2.1](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.1.3..v0.2.1) - 2025-06-14
+
+### 🚀 Features
+
+- *(release)* Add retry logic for release creation - ([29243bd](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/29243bd67344a3020fc3023d238dacbdd96c53ad))
+
+## [0.1.3](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.1.2..v0.1.3) - 2025-06-14
+
+### 🐛 Bug Fixes
+
+- *(workflows)* Configure Git user in major tag creation - ([79921dd](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/79921dd63676138f2cfbcc3894f294b292f0a653))
+
+## [0.1.2](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.1.0..v0.1.2) - 2025-06-14
+
+### 🚀 Features
+
+- *(workflows)* Add workflow to create major version tags - ([9a05866](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/9a0586653a5e7aa6a3acb12d119f4a43c09e96c1))
+
+### ⚙️ Miscellaneous Tasks
+
+- *(workflows)* Update action to main branch - ([043a01c](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/043a01c2bacb78f3c872056f7d18aab4e845a401))
+- *(workflows)* Update action version in release workflow - ([9a0d65b](https://git.0xmax42.io/actions/auto-changelog-release-action/commit/9a0d65b8eba3d1e06c88bc02f19e2dd5a7d0a731))
+
 ## [0.1.0] - 2025-06-14
 
 ### 🚀 Features

TODO.md

@@ -0,0 +1,46 @@
+# TODO
+
+## Git-Cliff / Changelog Improvements
+
+### Idea: Use Merge Commit Body as Documentation
+
+* **Context**: Normally, only the commit subject is included in changelogs.
+* **Idea**: Treat merge commits as *project documentation*.
+
+  * The subject line = headline of the feature / branch.
+  * The body = narrative explanation of what the branch accomplished.
+  * Child commits = detailed steps, already included under the merge.
+
+### Benefits
+
+* Provides more context for each feature branch.
+* Turns the changelog into a lightweight project documentation.
+* Keeps individual commits small and clean while still showing the bigger picture.
+* Optional: if no body is present, nothing changes.
+
+### Possible Implementation
+
+* In the changelog template:
+
+  * Detect merge commits.
+  * Render `commit.body` below the subject line.
+  * Indent and format properly (e.g. bullet points preserved).
+
+### Example
+
+```
+### 🚀 Features
+
+- 🔀 **Merge branch 'feature/oauth2'** - ([abc1234](...))
+    Add OAuth2 login flow with full explanation of scope:
+    - why OAuth2 was chosen
+    - compatibility with existing login
+    - possible future extensions
+
+    - *(auth)* Add login endpoint - ([def5678](...))
+    - *(auth)* Implement token exchange - ([ghi9012](...))
+    - *(auth)* Add error handling - ([jkl3456](...))
+    - *(test)* Add unit tests for OAuth2 flow - ([mno7890](...))
+```
+
+---

VERSION

@@ -1 +1 @@
-0.1.0
+1.1.0

action.yml

@@ -14,6 +14,10 @@ inputs:
     description: "Commit-Autore-Mail"
     required: false
     default: ""
+  allow_non_main_release:
+    description: "Allow publishing releases from branches other than 'main'."
+    required: false
+    default: "false"
 
 runs:
   using: "composite"
@@ -25,34 +29,43 @@ runs:
         GITHUB_EVENT_BEFORE: ${{ github.event.before || '' }}
         GITHUB_SHA: ${{ github.sha || '' }}
         GITHUB_REF: ${{ github.ref || '' }}
+        ALLOW_NON_MAIN_RELEASE: ${{ inputs.allow_non_main_release }}
       run: |
-        bash ${{ github.action_path }}/scripts/detect-version-change.sh
+        ${{ github.action_path }}/scripts/detect-version-change.sh
 
     - name: Read CLIFF_VERSION
       shell: bash
       id: cliff_version
-      run: bash ${{ github.action_path }}/scripts/read-cliff-version.sh
+      run: |
+        ${{ github.action_path }}/scripts/read-cliff-version.sh
 
     - name: Install git-cliff
       shell: bash
       run: |
-        bash ${{ github.action_path }}/scripts/install-git-cliff.sh "${{ steps.cliff_version.outputs.version }}"
+        ${{ github.action_path }}/scripts/install-git-cliff.sh "${{ steps.cliff_version.outputs.version }}"
+
+    - name: Install Python
+      shell: bash
+      run: |
+        ${{ github.action_path }}/scripts/install-python.sh
 
     - name: Set up git
       shell: bash
       run: |
-        bash ${{ github.action_path }}/scripts/setup-git.sh \
+        ${{ github.action_path }}/scripts/setup-git.sh \
           "${{ inputs.author_name }}" \
           "${{ inputs.author_email }}"
 
     - name: Generate and commit changelog (unreleased)
-      if: steps.detect.outputs.version_changed == 'false' || github.ref != 'refs/heads/main'
+      if: steps.detect.outputs.version_changed == 'false'
       shell: bash
-      run: bash ${{ github.action_path }}/scripts/generate-unreleased-changelog.sh
+      run: |
+        ${{ github.action_path }}/scripts/generate-unreleased-changelog.sh
 
     - name: Release from VERSION
-      if: steps.detect.outputs.version_changed == 'true' && github.ref == 'refs/heads/main'
+      if: steps.detect.outputs.version_changed == 'true'
       shell: bash
       env:
         RELEASE_PUBLISH_TOKEN: ${{ inputs.token || '' }}
-      run: bash ${{ github.action_path }}/scripts/release-from-version.sh
+      run: |
+        ${{ github.action_path }}/scripts/release-from-version.sh

cliff.toml

@@ -1,4 +1,4 @@
-# CLIFF_VERSION=2.8.0
+# CLIFF_VERSION=2.10.1
 # git-cliff ~ default configuration file
 # https://git-cliff.org/docs/configuration
 #
@@ -10,18 +10,15 @@ owner = "actions"
 repo = "auto-changelog-release-action"
 
 [changelog]
-# postprocessors
 postprocessors = [
   { pattern = '<GITEA_URL>', replace = "https://git.0xmax42.io" }, # replace gitea url
 ]
 
-# template for the changelog header
 header = """
 # Changelog\n
 All notable changes to this project will be documented in this file.\n
 """
-# template for the changelog body
-# https://keats.github.io/tera/docs/#introduction
+
 body = """
 {%- macro remote_url() -%}
   <GITEA_URL>/{{ remote.gitea.owner }}/{{ remote.gitea.repo }}
@@ -38,16 +35,28 @@ body = """
     ## [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 %}\
-            {% if commit.breaking %}[**breaking**] {% endif %}\
-            {{ commit.message | upper_first }} - \
-            ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }}))\
-    {% endfor %}
+    ### {{ group | striptags | trim | upper_first }}\n
+    {% for commit in commits %}\
+        {% if commit.merge_commit %}\
+    - 🔀 **{{ commit.message | upper_first }}** - \
+    ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }}))\
+        {% if commit.extra and commit.extra.children %}\
+            {% for child in commit.extra.children %}
+                {{ "    " | safe }}- {% if child.scope %}*({{ child.scope }})* {% endif %}\
+                {% if child.breaking %}[**breaking**] {% endif %}\
+                {{ child.message | upper_first }} - \
+                ([{{ child.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ child.id }}))\
+            {% endfor %}\
+        {% endif %}\
+        {% else %}\
+    - {% if commit.scope %}*({{ commit.scope }})* {% endif %}\
+    {% if commit.breaking %}[**breaking**] {% endif %}\
+    {{ commit.message | upper_first }} - \
+    ([{{ commit.id | truncate(length=7, end="") }}]({{ self::remote_url() }}/commit/{{ commit.id }}))\
+        {% endif %}
+    {% endfor %}\
 {% endfor %}\n
 """
-# template for the changelog footer
 footer = """
 
 """

scripts/augment_context.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+import json
+import subprocess
+import sys
+import re
+
+def extract_type(raw_message: str) -> str | None:
+    m = re.match(r"^(\w+)(?:\([^)]+\))?:", raw_message.strip())
+    return m.group(1) if m else None
+
+def git_commits_between(parent, merge):
+    """Return list of commit hashes between parent and merge (exclusive of parent, inclusive of merge)."""
+    out = subprocess.check_output(
+        ["git", "rev-list", f"{parent}..{merge}", "--no-merges"],
+        text=True
+    )
+    return [line.strip() for line in out.splitlines() if line.strip()]
+
+def load_context(path=None):
+    if path:
+        with open(path) as f:
+            return json.load(f)
+    else:
+        return json.load(sys.stdin)
+
+def main(path=None):
+    context = load_context(path)
+    commits = context[0]["commits"]
+    commits_by_id = {c["id"]: c for c in commits}
+
+    new_commits = []
+    consumed = set()
+
+    for c in commits:
+        if c.get("merge_commit"):
+            parents = subprocess.check_output(
+                ["git", "rev-list", "--parents", "-n", "1", c["id"]],
+                text=True
+            ).strip().split()
+            merge_id, *parent_ids = parents
+
+            parent_type = extract_type(c["raw_message"])
+
+            if len(parent_ids) >= 2:
+                mainline = parent_ids[0]
+                children_ids = git_commits_between(mainline, merge_id)
+
+                children = []
+                for cid in children_ids:
+                    if cid in commits_by_id:
+                        child = commits_by_id[cid]
+                        child_type = extract_type(child["raw_message"])
+                        if child_type and parent_type and child_type != parent_type:
+                            if not child.get("extra") or not isinstance(child["extra"], dict):
+                                child["extra"] = {}
+                            child["extra"]["mismatch_type"] = child_type
+                        children.append(child)
+                        consumed.add(cid)
+
+                if not c.get("extra") or not isinstance(c["extra"], dict):
+                    c["extra"] = {}
+                c["extra"]["children"] = children
+
+        new_commits.append(c)
+
+    filtered = [c for c in new_commits if c["id"] not in consumed]
+    context[0]["commits"] = filtered
+
+    json.dump(context, sys.stdout, indent=4)
+
+if __name__ == "__main__":
+    main(sys.argv[1] if len(sys.argv) > 1 else None)

scripts/detect-version-change.sh

@@ -1,19 +1,22 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-# === Inputs from GitHub/Gitea Action environment ===
+# Inputs from GitHub/Gitea Action environment
 GIT_REF="${GITHUB_REF:-}"
 COMMIT_BEFORE="${GITHUB_EVENT_BEFORE:-}"
 COMMIT_AFTER="${GITHUB_SHA:-}"
 VERSION_FILE="VERSION"
+ALLOW_NON_MAIN_RELEASE="${ALLOW_NON_MAIN_RELEASE:-false}"
 
 echo "🔍 Comparing commits:"
 echo "Before: $COMMIT_BEFORE"
 echo "After:  $COMMIT_AFTER"
+echo "Ref:    $GIT_REF"
+echo "Allow release from non-main branches: $ALLOW_NON_MAIN_RELEASE"
 
-# === Check branch condition ===
-if [[ "$GIT_REF" != "refs/heads/main" ]]; then
-  echo "Not on 'main' branch – skipping version check."
+# Check branch condition
+if [[ "$ALLOW_NON_MAIN_RELEASE" != "true" && "$GIT_REF" != "refs/heads/main" ]]; then
+  echo "🚫 Not on 'main' branch and non-main releases are disabled – skipping version check."
   echo "version_changed=false" >> "$GITHUB_OUTPUT"
   exit 0
 fi

scripts/generate-unreleased-changelog.sh

@@ -8,7 +8,9 @@ GIT_BRANCH="${GITHUB_REF##refs/heads/}"
 # === Step 1: Generate Changelog (only if file exists or on main) ===
 if [[ -f "$CHANGELOG_FILE" || "$GIT_BRANCH" == "main" ]]; then
   echo "📄 Generating $CHANGELOG_FILE using git-cliff..."
-  git-cliff -c "$CLIFF_CONFIG" -o "$CHANGELOG_FILE"
+  git-cliff -c "$CLIFF_CONFIG" --context \
+|   "${GITHUB_ACTION_PATH}/scripts/augment_context.py" \
+|   git-cliff -c "$CLIFF_CONFIG" --from-context - -o "$CHANGELOG_FILE"
 else
   echo "ℹ️  $CHANGELOG_FILE does not exist and branch is not 'main'. Skipping generation."
   exit 0

scripts/install-git-cliff.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
-# install-git-cliff.sh – holt neueste oder gewünschte git-cliff-Binary (x86_64)
-# Usage: sudo ./install-git-cliff.sh        # neueste Version
-#        sudo ./install-git-cliff.sh 2.9.0  # bestimmte Version
+# install-git-cliff.sh – fetches the latest or specified git-cliff binary (x86_64)
+# Usage: sudo ./install-git-cliff.sh        # latest version
+#        sudo ./install-git-cliff.sh 2.9.0  # specific version
 set -euo pipefail
 
 REPO="orhun/git-cliff"
@@ -9,42 +9,50 @@ ARCH_OS="x86_64-unknown-linux-gnu"
 INSTALL_DIR="/usr/local/bin"
 VERSION="${1:-latest}"
 
-need() { command -v "$1" >/dev/null || { echo "$1 fehlt"; exit 1; }; }
-need curl; need tar; need grep; need sed; need awk
+need() { command -v "$1" >/dev/null || { echo "$1 is missing"; exit 1; }; }
+need curl; need tar; need grep; need sed; need awk; need jq
 
-# 1 Version ermitteln → Release-JSON abrufen
+# 1 Determine version → Fetch release JSON
 if [[ "$VERSION" == "latest" ]]; then
   API_URL="https://api.github.com/repos/${REPO}/releases/latest"
 else
   API_URL="https://api.github.com/repos/${REPO}/releases/tags/v${VERSION}"
 fi
 
-echo "🔍 Hole Release-Info ($API_URL)…"
-JSON=$(curl -sL "$API_URL")
+echo "🔍 Fetching release info ($API_URL)…"
+JSON=$(curl -fsSL "$API_URL") || {
+  echo "❌ Failed to fetch release info"
+  exit 1
+}
 
-VERSION=$(echo "$JSON" | grep -m1 '"tag_name":' | sed -E 's/.*"v?([^"]+)".*/\1/')
-ASSET_URL=$(echo "$JSON" |
-  grep -Eo '"browser_download_url": *"[^"]+' |
-  cut -d'"' -f4 |
-  grep "${ARCH_OS}\\.tar" | head -n1)
+VERSION=$(jq -r '.tag_name' <<< "$JSON") || {
+  echo "❌ Could not extract version"
+  exit 1
+}
 
-[[ -z "$ASSET_URL" ]] && { echo "❌ passender Asset nicht gefunden"; exit 1; }
+ASSET_URL=$(jq -r '.assets[]?.browser_download_url' <<< "$JSON" |
+  grep "${ARCH_OS}\.tar" | head -n1)
+
+if [[ -z "$ASSET_URL" ]]; then
+  echo "❌ Matching asset not found for architecture ${ARCH_OS}"
+  exit 1
+fi
 
 ASSET_FILE=$(basename "$ASSET_URL")
-echo "📦 Lade git-cliff v${VERSION} (${ASSET_FILE}) …"
+echo "📦 Downloading git-cliff v${VERSION} (${ASSET_FILE}) …"
 TMP=$(mktemp -d)
 curl -#L -o "${TMP}/${ASSET_FILE}" "$ASSET_URL"
 
-# 2 Entpacken je nach Endung
+# 2 Extract based on file extension
 case "$ASSET_FILE" in
   *.tar.gz|*.tgz) tar -C "$TMP" -xzf "${TMP}/${ASSET_FILE}" ;;
   *.tar.xz)       tar -C "$TMP" -xJf "${TMP}/${ASSET_FILE}" ;;
   *.zip)          need unzip; unzip -q "${TMP}/${ASSET_FILE}" -d "$TMP" ;;
-  *) echo "❌ Unbekanntes Archivformat: $ASSET_FILE"; exit 1 ;;
+  *) echo "❌ Unknown archive format: $ASSET_FILE"; exit 1 ;;
 esac
 
 BIN_PATH=$(find "$TMP" -type f -name git-cliff -perm -u+x | head -n1)
-[[ -z "$BIN_PATH" ]] && { echo "❌ Binary nicht gefunden"; exit 1; }
+[[ -z "$BIN_PATH" ]] && { echo "❌ Binary not found"; exit 1; }
 
 sudo install -m755 "$BIN_PATH" "${INSTALL_DIR}/git-cliff"
-echo "✅ git-cliff $(git-cliff --version) installiert unter ${INSTALL_DIR}"
+echo "✅ git-cliff $(git-cliff --version) installed in ${INSTALL_DIR}"

scripts/install-python.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# install-python.sh – installs the latest Python version through apt
+# Usage: sudo ./install-python.sh
+set -euo pipefail
+
+if command -v python3 >/dev/null 2>&1; then
+    echo "ℹ️ Python $(python3 --version) is already installed"
+    exit 0
+fi
+
+apt update
+apt install -y python3
+
+echo "✅ Python $(python3 --version) installed"

scripts/release-from-version.sh

@@ -1,13 +1,60 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+create_release() {
+  local -r owner="$1" repo="$2" token="$3" version="$4" body_file="$5"
+  local -i max_attempts=3 delay=5 attempt
+  local http status
+
+  # Read release body for JSON payload
+  local body_json
+  body_json=$(tail -n +2 "$body_file" | jq -Rs .)
+
+  for (( attempt=1; attempt<=max_attempts; attempt++ )); do
+    echo "🚀 Try $attempt/$max_attempts: creating release v$version …"
+
+    http=$(curl -sS \
+      -H "Authorization: token $token" \
+      -H "Content-Type: application/json" \
+      -o resp.json -w '%{http_code}' \
+      -X POST "$GITHUB_API_URL/repos/$owner/$repo/releases" \
+      -d @- <<EOF
+{
+  "tag_name": "v$version",
+  "target_commitish": "main",
+  "name": "Release v$version",
+  "body": $body_json,
+  "draft": false,
+  "prerelease": false
+}
+EOF
+    )
+
+    status=$http
+    if [[ $status == 201 ]]; then
+      echo "✅ Release created (201)."
+      rm -f resp.json
+      return 0
+    elif [[ $status == 409 ]]; then
+      echo "🔁 Release already exists (409) – skipping."
+      rm -f resp.json
+      return 0
+    fi
+
+    echo "⚠️  Release attempt failed (HTTP $status)"
+    cat resp.json
+    [[ $attempt -lt $max_attempts ]] || { echo "❌ Giving up."; return 1; }
+    sleep $((delay*attempt))   # Back-off: 5 s, 10 s, 15 s …
+  done
+}
+
 VERSION_FILE="VERSION"
 CHANGELOG_FILE="CHANGELOG.md"
 CLIFF_CONFIG="cliff.toml"
 RELEASE_BODY_TMP="$(mktemp)"
-BODY_OUTPUT_VAR="changelog_body_path"
+GIT_BRANCH="${GITHUB_REF##refs/heads/}"
 
-# === Schritt 1: Read version from VERSION ===
+# === Step 1: Read version ===
 if [[ ! -f "$VERSION_FILE" ]]; then
   echo "❌ VERSION file not found"
   exit 1
@@ -15,51 +62,51 @@ fi
 VERSION="$(<"$VERSION_FILE")"
 echo "📦 Version: $VERSION"
 
-# === Schritt 2: Generate changelog for release ===
+# === Step 2: Generate changelog for release ===
 echo "📄 Generating changelog for tag v$VERSION"
-git-cliff -c "$CLIFF_CONFIG" -t "v$VERSION" -o "$CHANGELOG_FILE"
+git-cliff -c "$CLIFF_CONFIG" -t "v$VERSION" --context \
+|   "${GITHUB_ACTION_PATH}/scripts/augment_context.py" \
+|   git-cliff -c "$CLIFF_CONFIG"  -t "v$VERSION" --from-context - -o "$CHANGELOG_FILE"
 
 ESCAPED_VERSION="$(echo "$VERSION" | sed 's/\./\\./g')"
 
 awk -v ver="$ESCAPED_VERSION" '
   $0 ~ "^## \\[" ver "\\]" {
     print_flag=1
-    line = $0
-    sub(/^## /, "", line)
-    sub(/\\s*\\(.*\\)/, "", line)  # entfernt z. B. "(...)" oder "(*)"
+    line=$0
+    sub(/^## /,"",line)
+    sub(/\\s*\\(.*\\)/,"",line)
     print line
     next
   }
-  $0 ~ "^## \\[" && $0 !~ "^## \\[" ver "\\]" {
-    print_flag=0
-  }
+  $0 ~ "^## \\[" && $0 !~ "^## \\[" ver "\\]" { print_flag=0 }
   print_flag
 ' "$CHANGELOG_FILE" > "$RELEASE_BODY_TMP"
 
-# === Schritt 3: Commit updated changelog ===
+# === Step 3: Commit changelog ===
 git add "$CHANGELOG_FILE"
 if git diff --cached --quiet; then
   echo "✅ No changes to commit"
 else
   echo "📝 Committing updated changelog"
   git commit -m "chore(changelog): update changelog for v$VERSION"
-  git push origin main
+  git push origin "$GIT_BRANCH"
 fi
 
-# === Schritt 4: Create tag if not exists ===
+# === Step 4: Create tag if necessary ===
 if git rev-parse "v$VERSION" >/dev/null 2>&1; then
   echo "🔁 Tag v$VERSION already exists, skipping."
 else
   echo "🏷️  Creating annotated tag v$VERSION"
-  export GIT_AUTHOR_DATE="$(date --iso-8601=seconds)"
+  export GIT_AUTHOR_DATE="@$(date +%s)"
   export GIT_COMMITTER_DATE="$GIT_AUTHOR_DATE"
   git tag -a "v$VERSION" -F "$RELEASE_BODY_TMP" --cleanup=verbatim
   git push origin "v$VERSION"
 fi
 
-# === Schritt 5: Create Gitea release ===
-OWNER="$(echo "$GITHUB_REPOSITORY" | cut -d/ -f1)"
-REPO="$(echo "$GITHUB_REPOSITORY" | cut -d/ -f2)"
+# === Step 5: Create release (with retry) ===
+OWNER="${GITHUB_REPOSITORY%/*}"
+REPO="${GITHUB_REPOSITORY#*/}"
 TOKEN="${RELEASE_PUBLISH_TOKEN:-$ACTIONS_RUNTIME_TOKEN}"
 
 if [[ -z "${RELEASE_PUBLISH_TOKEN:-}" ]]; then
@@ -69,29 +116,6 @@ if [[ -z "${RELEASE_PUBLISH_TOKEN:-}" ]]; then
   echo
 fi
 
-# Prüfen, ob Release bereits existiert
-if curl -sf "$GITHUB_API_URL/repos/$OWNER/$REPO/releases/tags/v$VERSION" \
-  -H "Authorization: token $TOKEN" > /dev/null; then
-  echo "🔁 Release for tag v$VERSION already exists, skipping."
-  exit 0
-fi
+create_release "$OWNER" "$REPO" "$TOKEN" "$VERSION" "$RELEASE_BODY_TMP"
 
-echo "🚀 Creating Gitea release for v$VERSION"
-
-RELEASE_BODY=$(tail -n +2 "$RELEASE_BODY_TMP" | jq -Rs .)
-
-curl -X POST "$GITHUB_API_URL/repos/$OWNER/$REPO/releases" \
-  -H "Authorization: token $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d @- <<EOF
-{
-  "tag_name": "v$VERSION",
-  "target_commitish": "main",
-  "name": "Release v$VERSION",
-  "body": $RELEASE_BODY,
-  "draft": false,
-  "prerelease": false
-}
-EOF
-
-echo "✅ Release for tag $VERSION created successfully."
+echo "🎉 Workflow finished successfully."

scripts/setup-git.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-# Optional inputs (positionals) oder Fallback auf Umgebungsvariablen
+# Optional inputs (positionals) or fallback to environment variables
 AUTHOR_NAME="${1:-${CI_COMMIT_AUTHOR_NAME:-CI Bot}}"
-AUTHOR_EMAIL="${2:-${CI_COMMIT_AUTHOR_EMAIL:-ci@example.com}}"
+AUTHOR_EMAIL="${2:-${CI_COMMIT_AUTHOR_EMAIL:-ci@bot.none}}"
 
 echo "🔧 Setting up git author:"
 echo "   Name : $AUTHOR_NAME"
@@ -11,3 +11,19 @@ echo "   Email: $AUTHOR_EMAIL"
 
 git config --global user.name "$AUTHOR_NAME"
 git config --global user.email "$AUTHOR_EMAIL"
+
+# Check if the values were set correctly
+CONFIGURED_NAME=$(git config --global user.name)
+CONFIGURED_EMAIL=$(git config --global user.email)
+
+if [[ "$CONFIGURED_NAME" != "$AUTHOR_NAME" ]]; then
+  echo "❌ Error: Git username was not set correctly!" >&2
+  exit 1
+fi
+
+if [[ "$CONFIGURED_EMAIL" != "$AUTHOR_EMAIL" ]]; then
+  echo "❌ Error: Git email was not set correctly!" >&2
+  exit 1
+fi
+
+echo "✅ Git configuration completed successfully."