chore(changelog): update changelog for v0.3.1

- Add start and end log groups for git setup to enhance CI visibility
- Ensure log groups close on error for better debugging in pipelines

.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

@@ -41,6 +41,9 @@ jobs:
         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")"
 

.gitea/workflows/release.yml

@@ -14,6 +14,6 @@ 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 }}

CHANGELOG.md

@@ -2,7 +2,51 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.1.1](https://git.0xmax42.io/actions/auto-changelog-release-action/compare/v0.1.0..v0.1.1) - 2025-06-14
+## [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
 

VERSION

@@ -1 +1 @@
-0.1.2
+0.3.1

scripts/detect-version-change.sh

@@ -1,7 +1,7 @@
 #!/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:-}"
@@ -11,7 +11,7 @@ echo "🔍 Comparing commits:"
 echo "Before: $COMMIT_BEFORE"
 echo "After:  $COMMIT_AFTER"
 
-# === Check branch condition ===
+# Check branch condition
 if [[ "$GIT_REF" != "refs/heads/main" ]]; then
   echo "Not on 'main' branch – skipping version check."
   echo "version_changed=false" >> "$GITHUB_OUTPUT"

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)
+# install-git-cliff.sh – fetches the latest or specified git-cliff binary (x86_64)
-# Usage: sudo ./install-git-cliff.sh        # neueste Version
+# Usage: sudo ./install-git-cliff.sh        # latest version
-#        sudo ./install-git-cliff.sh 2.9.0  # bestimmte 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() { command -v "$1" >/dev/null || { echo "$1 is missing"; exit 1; }; }
-need curl; need tar; need grep; need sed; need awk
+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)…"
+echo "🔍 Fetching release info ($API_URL)…"
-JSON=$(curl -sL "$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/')
+VERSION=$(jq -r '.tag_name' <<< "$JSON") || {
-ASSET_URL=$(echo "$JSON" |
+  echo "❌ Could not extract version"
-  grep -Eo '"browser_download_url": *"[^"]+' |
+  exit 1
-  cut -d'"' -f4 |
+}
-  grep "${ARCH_OS}\\.tar" | head -n1)
 
-[[ -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/release-from-version.sh

@@ -1,13 +1,59 @@
 #!/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"
 
-# === Schritt 1: Read version from VERSION ===
+# === Step 1: Read version ===
 if [[ ! -f "$VERSION_FILE" ]]; then
   echo "❌ VERSION file not found"
   exit 1
@@ -15,7 +61,7 @@ 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"
 
@@ -26,17 +72,15 @@ awk -v ver="$ESCAPED_VERSION" '
     print_flag=1
     line=$0
     sub(/^## /,"",line)
-    sub(/\\s*\\(.*\\)/, "", line)  # entfernt z. B. "(...)" oder "(*)"
+    sub(/\\s*\\(.*\\)/,"",line)
     print line
     next
   }
-  $0 ~ "^## \\[" && $0 !~ "^## \\[" ver "\\]" {
+  $0 ~ "^## \\[" && $0 !~ "^## \\[" ver "\\]" { print_flag=0 }
-    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"
@@ -46,20 +90,20 @@ else
   git push origin main
 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 ===
+# === Step 5: Create release (with retry) ===
-OWNER="$(echo "$GITHUB_REPOSITORY" | cut -d/ -f1)"
+OWNER="${GITHUB_REPOSITORY%/*}"
-REPO="$(echo "$GITHUB_REPOSITORY" | cut -d/ -f2)"
+REPO="${GITHUB_REPOSITORY#*/}"
 TOKEN="${RELEASE_PUBLISH_TOKEN:-$ACTIONS_RUNTIME_TOKEN}"
 
 if [[ -z "${RELEASE_PUBLISH_TOKEN:-}" ]]; then
@@ -69,29 +113,6 @@ if [[ -z "${RELEASE_PUBLISH_TOKEN:-}" ]]; then
   echo
 fi
 
-# Prüfen, ob Release bereits existiert
+create_release "$OWNER" "$REPO" "$TOKEN" "$VERSION" "$RELEASE_BODY_TMP"
-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
 
-echo "🚀 Creating Gitea release for v$VERSION"
+echo "🎉 Workflow finished successfully."
-
-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."

scripts/setup-git.sh

@@ -1,9 +1,12 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-# Optional inputs (positionals) oder Fallback auf Umgebungsvariablen
+# Open a log group for better readability in CI pipelines
+echo "::group::🔧 Git Author Setup"
+
+# 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 +14,24 @@ 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
+  echo "::endgroup::"
+  exit 1
+fi
+
+if [[ "$CONFIGURED_EMAIL" != "$AUTHOR_EMAIL" ]]; then
+  echo "❌ Error: Git email was not set correctly!" >&2
+  echo "::endgroup::"
+  exit 1
+fi
+
+echo "✅ Git configuration completed successfully."
+
+# Close the log group
+echo "::endgroup::"