feat: Woodpecker-Plugin bump (Entwurf)

Setzt Version und Tag für den gepushten Branch wie bump-version, dazu
hotfix/* -> beta, Bump nur des auslösenden Commits, [skip ci] im
Bump-Commit. Nutzer und Autor oumta-ci, Secret oumta_ci_token
(oumta-deploy docs/zugaenge.md). plugins.yaml baut beide Plugins.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.woodpecker/plugins.yaml

@@ -26,9 +26,10 @@ steps:
       context: woodpecker/deploy
       dockerfile: woodpecker/deploy/Dockerfile
       tags: ${CI_COMMIT_TAG##deploy-}
-      username: oumta-ci
+      username:
+        from_secret: registry_username
       password:
-        from_secret: oumta_ci_token
+        from_secret: registry_password
     when:
       event: tag
       ref: refs/tags/deploy-v*
@@ -52,9 +53,10 @@ steps:
       context: woodpecker/bump
       dockerfile: woodpecker/bump/Dockerfile
       tags: ${CI_COMMIT_TAG##bump-}
-      username: oumta-ci
+      username:
+        from_secret: registry_username
       password:
-        from_secret: oumta_ci_token
+        from_secret: registry_password
     when:
       event: tag
       ref: refs/tags/bump-v*

README.md

@@ -120,9 +120,7 @@ jobs:
 
 ## Woodpecker plugins
 
-Plugins are Docker images built from `woodpecker/<name>/` by `.woodpecker/plugins.yaml`. A tag `<name>-vX.Y.Z` publishes `git.uesome.de/actions/ci-cd/<name>:vX.Y.Z`; pipelines pin that version. The push uses `oumta-ci` with the Woodpecker secret `oumta_ci_token`, so `oumta-ci` needs package write access in the org `actions`.
-
-The secret `oumta_ci_token` holds the one token `oumta-ci` writes with. Limit it in Woodpecker to the images `woodpeckerci/plugin-docker-buildx:6`, `git.uesome.de/actions/ci-cd/bump` and `git.uesome.de/actions/ci-cd/deploy` and to the events `push`, `tag` and `manual` (zugaenge.md in oumta-deploy).
+Plugins are Docker images built from `woodpecker/<name>/` by `.woodpecker/plugins.yaml`. A tag `<name>-vX.Y.Z` publishes `git.uesome.de/actions/ci-cd/<name>:vX.Y.Z`; pipelines pin that version.
 
 ### deploy
 
@@ -131,8 +129,8 @@ Writes a pushed dev or beta image with its digest to `tanztee/oumta-deploy` (D16
 Settings:
 
 - `var` (required): variable in `envs/<env>/images.env`, e.g. `AUTH_IMAGE`. `{major}` is replaced by the major of the tag (`APP_V{major}_IMAGE` -> `APP_V2_IMAGE`).
-- `deploy_token` (required): token of `oumta-ci` (`oumta_ci_token`), write access to oumta-deploy
-- `registry_username`, `registry_password`: read access to the registry for the digest (`oumta-ci` with the same token)
+- `deploy_token` (required): token of `oumta-ci`, write access to oumta-deploy only. Limit the secret to this image and the events `tag` and `manual`.
+- `registry_username`, `registry_password`: read access to the registry for the digest
 - `envs`: fixed environments instead of the tag rule, e.g. `dev beta` (oumta-keyklo)
 - `tag`: default `CI_COMMIT_TAG`
 - `registry`: default `git.uesome.de`
@@ -154,42 +152,39 @@ steps:
       registry: git.uesome.de
       repo: git.uesome.de/tanztee/oumta-auth
       tags: ${CI_COMMIT_TAG}
-      build_args:
-        VERSION: ${CI_COMMIT_TAG##v}
-      username: oumta-ci
+      username:
+        from_secret: registry_username
       password:
-        from_secret: oumta_ci_token
+        from_secret: registry_password
 
   - name: deploy
     image: git.uesome.de/actions/ci-cd/deploy:v1.0.0
     settings:
       var: AUTH_IMAGE
-      registry_username: oumta-ci
+      registry_username:
+        from_secret: registry_username
       registry_password:
-        from_secret: oumta_ci_token
+        from_secret: registry_password
       deploy_token:
         from_secret: oumta_ci_token
 ```
 
 ### bump
 
-Derives the next version for the pushed branch and pushes it as a tag on the triggering commit. There is no version commit: the build takes the version from the tag (`CI_COMMIT_TAG`, e.g. as build arg `VERSION: ${CI_COMMIT_TAG##v}`), `package.json` stays untouched. The tag event then starts the build.
+Sets the version for the pushed branch in `package.json`, commits it as `update version: vX [skip ci]`, tags it and pushes branch and tag. The tag event then starts the build; `[skip ci]` only suppresses push and pull_request events.
 
-- `release/X.Y[.Z]`, `hotfix/X.Y.Z`: next `vX.Y.Z-beta.N` of that line (D8). A hotfix needs a patch number.
-- `production/*`: no bump, the step fails. A release is a retag of a beta image (D9).
-- the branch in `release_branch` (repos without majors, e.g. oumta-keyklo `main`): next stable `vX.Y.Z`, the highest existing patch of the line plus one
-- any other branch: `vX.Y.Z-dev.<UTC timestamp>`; the line comes from `release_line`, the branch name, the nearest `release/*` or `hotfix/*` branch (newest merge base), or `major.minor` from `package.json`
+- `main`: release from the commit message (`release/x.y[.z]`, `hotfix/x.y.z`), otherwise a patch bump
+- `release/*`, `hotfix/*`: next `vX.Y.Z-beta.N`
+- any other branch: `vX.Y.Z-dev.<UTC timestamp>`; the release line comes from `release_line`, the newest ancestor `release/*` branch, or `package.json`
 
-If the stable tag of a line exists (`v2.4.0` after the release), the next patch of that line is used (`v2.4.1-beta.0`, `v2.4.1-dev.…`).
-
-Only the commit that triggered the pipeline is tagged; if the branch moved on, the step exits without a tag and the newer pipeline takes over. A commit that already carries a tag of the same kind (dev, beta or stable) is not tagged again, so a re-run does not build twice; a dev tag does not block the beta tag after a fast-forward merge.
+Only the commit that triggered the pipeline is bumped; if the branch moved on, the step exits without a bump and the newer pipeline takes over.
 
 Settings:
 
-- `git_token` (required): token of `oumta-ci` (`oumta_ci_token`), write access to the repo
+- `git_token` (required): token with write access to the repo (`oumta_ci_token`)
 - `git_user`: default `oumta-ci`
-- `release_branch`: optional, branch that gets stable tags instead of dev tags
-- `release_line`: optional, `<major>.<minor>[.<patch>]`, overrides every other rule
+- `release_line`: optional, `<major>.<minor>[.<patch>]`
+- `author_name`, `author_email`: default `oumta-ci`, `oumta-ci@noreply.git.uesome.de`
 - `remote`: default `CI_REPO_CLONE_URL`
 
 Example:
@@ -197,12 +192,12 @@ Example:
 ```yaml
 when:
   - event: push
-    branch: ['feature/**', 'release/**', 'hotfix/**']
+    branch: [develop, 'feature/**', 'release/**', 'hotfix/**']
   - event: manual
 
 steps:
   - name: bump
-    image: git.uesome.de/actions/ci-cd/bump:v2.0.0
+    image: git.uesome.de/actions/ci-cd/bump:v1.0.0
     settings:
       git_token:
         from_secret: oumta_ci_token

woodpecker/bump/Dockerfile

@@ -1,5 +1,5 @@
-# Woodpecker plugin: derives the next version and pushes it as a tag
-FROM alpine:3.20
+# Woodpecker plugin: bumps the version in package.json, tags and pushes
+FROM node:24-alpine
 RUN apk add --no-cache bash git ca-certificates
 COPY bump.sh /usr/local/bin/bump.sh
 ENTRYPOINT ["/usr/local/bin/bump.sh"]

woodpecker/bump/bump.sh

@@ -1,12 +1,11 @@
 #!/usr/bin/env bash
-# Woodpecker plugin "bump": derives the next version for the pushed branch and
-# pushes it as a tag on the triggering commit. No commit is made; the build
-# takes the version from the tag (CI_COMMIT_TAG). The tag event then starts
-# the build.
+# Woodpecker plugin "bump": sets the version for the pushed branch, commits it
+# with [skip ci], tags it and pushes both. The tag event then starts the build;
+# [skip ci] only suppresses push and pull_request events, not tag events.
 #
-#   release/X.Y[.Z], hotfix/X.Y.Z   next vX.Y.Z-beta.N (D8)
-#   production/*                    nothing: releases are retags (D9)
-#   settings.release_branch         next free vX.Y.Z (repos without majors)
+#   main                  release from the commit message (release/x.y[.z],
+#                         hotfix/x.y.z), otherwise a patch bump
+#   release/*, hotfix/*   next vX.Y.Z-beta.N
 #   any other branch      vX.Y.Z-dev.<UTC timestamp>
 set -euo pipefail
 
@@ -16,13 +15,11 @@ BRANCH=${CI_COMMIT_BRANCH:?CI_COMMIT_BRANCH is missing (push event only)}
 SHA=${CI_COMMIT_SHA:?CI_COMMIT_SHA is missing}
 REMOTE=${PLUGIN_REMOTE:-${CI_REPO_CLONE_URL:?CI_REPO_CLONE_URL is missing}}
 GIT_USER=${PLUGIN_GIT_USER:-oumta-ci}
-RELEASE_LINE=${PLUGIN_RELEASE_LINE:-}
-RELEASE_BRANCH=${PLUGIN_RELEASE_BRANCH:-}
 [[ -n ${PLUGIN_GIT_TOKEN:-} ]] || die "settings.git_token is missing"
+INPUT_RELEASE_LINE=${PLUGIN_RELEASE_LINE:-}
 
-case $BRANCH in
-  production/*) die "no bump on $BRANCH: a release is a retag of a beta image (D9)" ;;
-esac
+export GIT_AUTHOR_NAME=${PLUGIN_AUTHOR_NAME:-oumta-ci} GIT_AUTHOR_EMAIL=${PLUGIN_AUTHOR_EMAIL:-oumta-ci@noreply.git.uesome.de}
+export GIT_COMMITTER_NAME=$GIT_AUTHOR_NAME GIT_COMMITTER_EMAIL=$GIT_AUTHOR_EMAIL
 
 # Token only via credential helper, never in a URL or config, so no log shows it
 export GIT_USER PLUGIN_GIT_TOKEN
@@ -36,131 +33,180 @@ if [[ $(git rev-parse --is-shallow-repository) == true ]]; then
 fi
 git fetch --quiet --tags --force origin "+refs/heads/*:refs/remotes/origin/*"
 
-# Tag exactly the commit that triggered the pipeline. A newer push on the
+# Bump exactly the commit that triggered the pipeline. A newer push on the
 # branch starts its own pipeline, so this one steps aside.
-head=$(git rev-parse -q --verify "origin/$BRANCH") || die "$BRANCH no longer exists on origin"
-if [[ $head != "$SHA" ]]; then
+if [[ $(git rev-parse "origin/$BRANCH") != "$SHA" ]]; then
   echo "bump: $BRANCH moved past ${SHA:0:8}, the newer pipeline bumps"
   exit 0
 fi
-git checkout --quiet "$SHA"
+git checkout --quiet -B "$BRANCH" "$SHA"
 
-tag_exists() { git rev-parse -q --verify "refs/tags/v$1" >/dev/null; }
-
-# "2.4" or "v2.4.1" -> "2.4.0" / "2.4.1"; fails for anything else
-parse_line() {
-  [[ $1 =~ ^v?([0-9]+)\.([0-9]+)(\.([0-9]+))?$ ]] || return 1
-  echo "${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.${BASH_REMATCH[4]:-0}"
+set_version() {
+  npm version "$1" --no-git-tag-version --allow-same-version >/dev/null
 }
 
-# release/2.4 -> 2.4.0, hotfix/2.4.1 -> 2.4.1; a hotfix without a patch fails
-line_of_branch() {
-  local kind name
-  [[ $1 =~ ^(release|hotfix)/(.+)$ ]] || return 1
-  kind=${BASH_REMATCH[1]} name=${BASH_REMATCH[2]}
-  [[ $kind == hotfix && ! $name =~ ^v?[0-9]+\.[0-9]+\.[0-9]+$ ]] && return 1
-  parse_line "$name"
+read_package_version() {
+  node -p "require('./package.json').version"
 }
 
-# The release or hotfix branch whose merge base with HEAD is the newest, i.e.
-# the line this commit was branched from most recently. On a tie (a hotfix
-# forked from the same commit as the release) the lower line wins.
-line_of_nearest_branch() {
-  local ref line base
-  while read -r ref; do
-    line=$(line_of_branch "${ref#origin/}") || continue
-    base=$(git merge-base "$ref" HEAD 2>/dev/null) || continue
-    echo "$(git show -s --format=%ct "$base") ${line//./ } $line"
-  done < <(git for-each-ref --format='%(refname:short)' refs/remotes/origin/release/ refs/remotes/origin/hotfix/) |
-    sort -k1,1nr -k2,2n -k3,3n -k4,4n | head -n 1 | { read -r _ _ _ _ line && echo "$line"; }
-}
-
-# major.minor.0 from the version in package.json, if there is one
-line_of_package() {
-  local version
-  [[ -f package.json ]] || return 1
-  version=$(sed -nE 's/^[[:space:]]*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p' package.json | head -n 1)
-  version=$(parse_line "${version%%[-+]*}") || return 1
-  echo "${version%.*}.0"
-}
-
-# The line for this branch: setting, branch name, nearest release/hotfix
-# branch, else major.minor of package.json.
-resolve_line() {
-  if [[ -n $RELEASE_LINE ]]; then
-    parse_line "$RELEASE_LINE" || die "invalid settings.release_line '$RELEASE_LINE', expected <major>.<minor>[.<patch>]"
-    return
+normalize_release_base() {
+  local value="$1"
+  if [[ "${value}" =~ ^v?([0-9]+)\.([0-9]+)$ ]]; then
+    echo "${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.0"
+    return 0
   fi
-  line_of_branch "$BRANCH" && return
-  line_of_nearest_branch && return
-  line_of_package && return
-  die "no release line for '$BRANCH': use settings.release_line or a semantic version in package.json"
+  if [[ "${value}" =~ ^v?([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
+    echo "${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.${BASH_REMATCH[3]}"
+    return 0
+  fi
+  return 1
 }
 
-# The next stable version of a line: highest existing vX.Y.Z plus one patch.
-next_stable() {
-  local line=$1 highest
-  highest=$(git tag --list "v${line%.*}.*" | sed -nE 's/^v[0-9]+\.[0-9]+\.([0-9]+)$/\1/p' | sort -n | tail -n 1)
-  echo "${line%.*}.$(( ${highest:--1} + 1 ))"
+extract_release_base() {
+  local ref_name="$1"
+  local normalized
+  if [[ "${ref_name}" =~ ^(release|hotfix)/(.+)$ ]]; then
+    if normalized="$(normalize_release_base "${BASH_REMATCH[2]}")"; then
+      echo "${normalized}"
+      return 0
+    fi
+  fi
+  return 1
 }
 
-# A line whose stable tag exists was released; the next patch is the open one.
-next_free_patch() {
-  local line=$1 patch
-  while tag_exists "$line"; do
-    patch=${line##*.}
-    line=${line%.*}.$((patch + 1))
-  done
-  echo "$line"
+# Only release branches: a fresh hotfix branch is an ancestor of everything.
+infer_release_base_from_ancestor_release_branch() {
+  local best_release_base=""
+  local best_commit_time=0
+  local remote_ref
+  local release_base
+  local commit_time
+
+  while IFS= read -r remote_ref; do
+    if ! release_base="$(extract_release_base "${remote_ref#origin/}")"; then
+      continue
+    fi
+    if ! git merge-base --is-ancestor "$(git rev-parse "${remote_ref}")" HEAD; then
+      continue
+    fi
+    commit_time="$(git show -s --format=%ct "${remote_ref}")"
+    if [[ "${commit_time}" -gt "${best_commit_time}" ]]; then
+      best_commit_time="${commit_time}"
+      best_release_base="${release_base}"
+    fi
+  done < <(git for-each-ref --format='%(refname:short)' refs/remotes/origin/release/)
+
+  [[ -n "${best_release_base}" ]] && echo "${best_release_base}"
 }
 
-next_beta() {
-  local line=$1 highest
-  highest=$(git tag --list "v$line-beta.*" | sed -nE 's/^.*-beta\.([0-9]+)$/\1/p' | sort -n | tail -n 1)
-  echo "$line-beta.$(( ${highest:--1} + 1 ))"
+resolve_release_base() {
+  local package_version
+  local normalized
+
+  if [[ -n "${INPUT_RELEASE_LINE}" ]]; then
+    normalized="$(normalize_release_base "${INPUT_RELEASE_LINE}")" ||
+      die "invalid settings.release_line '${INPUT_RELEASE_LINE}', expected <major>.<minor>[.<patch>]"
+    echo "${normalized}"
+    return 0
+  fi
+  if extract_release_base "${BRANCH}"; then
+    return 0
+  fi
+  if infer_release_base_from_ancestor_release_branch; then
+    return 0
+  fi
+  package_version="$(read_package_version)"
+  if [[ "${package_version}" =~ ^([0-9]+)\.([0-9]+)\.[0-9]+([-.].*)?$ ]]; then
+    echo "${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.0"
+    return 0
+  fi
+  die "no release base for '${BRANCH}': use release/<major>.<minor>[.<patch>], settings.release_line or a semantic version in package.json"
 }
 
-next_dev() {
-  local line=$1 stamp
-  while :; do
-    stamp=$(date -u +%Y%m%d%H%M%S)
-    tag_exists "$line-dev.$stamp" || { echo "$line-dev.$stamp"; return; }
+next_beta_version() {
+  local release_base="$1"
+  local escaped_base
+  local highest_beta
+  escaped_base="$(printf '%s' "${release_base}" | sed 's/\./\\./g')"
+  highest_beta="$(
+    git tag --list "v${release_base}-beta.*" \
+      | sed -nE "s/^v${escaped_base}-beta\.([0-9]+)$/\\1/p" \
+      | sort -n \
+      | tail -n 1
+  )"
+  if [[ -z "${highest_beta}" ]]; then
+    echo "${release_base}-beta.0"
+  else
+    echo "${release_base}-beta.$((highest_beta + 1))"
+  fi
+}
+
+next_dev_version() {
+  local release_base="$1"
+  local timestamp
+  while true; do
+    timestamp="$(date -u +%Y%m%d%H%M%S)"
+    if ! git rev-parse -q --verify "refs/tags/v${release_base}-dev.${timestamp}" >/dev/null; then
+      echo "${release_base}-dev.${timestamp}"
+      return 0
+    fi
     sleep 1
   done
 }
 
-case $BRANCH in
-  release/* | hotfix/*)
-    line=$(line_of_branch "$BRANCH") || die "unusable branch name '$BRANCH', expected release/X.Y[.Z] or hotfix/X.Y.Z"
-    VERSION=$(next_beta "$(next_free_patch "$line")")
-    ;;
-  *)
-    if [[ -n $RELEASE_BRANCH && $BRANCH == "$RELEASE_BRANCH" ]]; then
-      VERSION=$(next_stable "$(resolve_line)")
+next_version() {
+  case "${BRANCH}" in
+    main) npm version patch --no-git-tag-version >/dev/null ;;
+    release/* | hotfix/*) set_version "$(next_beta_version "${RELEASE_BASE}")" ;;
+    *) set_version "$(next_dev_version "${RELEASE_BASE}")" ;;
+  esac
+}
+
+case "${BRANCH}" in
+  main)
+    COMMIT_MSG="$(git log -1 --pretty=%B)"
+    TARGET_VERSION=""
+    if [[ "${COMMIT_MSG}" =~ release/v?([0-9]+\.[0-9]+\.[0-9]+) ]]; then
+      TARGET_VERSION="${BASH_REMATCH[1]}"
+    elif [[ "${COMMIT_MSG}" =~ release/([0-9]+)\.([0-9]+) ]]; then
+      TARGET_VERSION="${BASH_REMATCH[1]}.${BASH_REMATCH[2]}.0"
+    elif [[ "${COMMIT_MSG}" =~ hotfix/([0-9]+\.[0-9]+\.[0-9]+) ]]; then
+      TARGET_VERSION="${BASH_REMATCH[1]}"
+    fi
+    if [[ -n "${TARGET_VERSION}" ]]; then
+      set_version "${TARGET_VERSION}"
     else
-      VERSION=$(next_dev "$(next_free_patch "$(resolve_line)")")
+      next_version
     fi
     ;;
+  *)
+    RELEASE_BASE="$(resolve_release_base)"
+    next_version
+    ;;
 esac
-TAG=v$VERSION
 
-# A re-run must not produce a second tag and a second build for the same commit.
-# Only tags of the same kind count: a dev tag on a commit that is then merged
-# fast-forward into a release branch must not block its beta tag.
-case $TAG in
-  *-dev.*) same_kind='^v[0-9]+\.[0-9]+\.[0-9]+-dev\.' ;;
-  *-beta.*) same_kind='^v[0-9]+\.[0-9]+\.[0-9]+-beta\.' ;;
-  *) same_kind='^v[0-9]+\.[0-9]+\.[0-9]+$' ;;
-esac
-existing=$(git tag --points-at HEAD 'v*' | grep -E "$same_kind" | head -n 1 || true)
-if [[ -n $existing ]]; then
-  echo "bump: ${SHA:0:8} already carries $existing, nothing to do"
+VERSION="$(read_package_version)"
+while git rev-parse -q --verify "refs/tags/v${VERSION}" >/dev/null; do
+  echo "bump: tag v${VERSION} already exists, trying the next version"
+  next_version
+  VERSION="$(read_package_version)"
+done
+
+TAG="v${VERSION}"
+if git diff --quiet; then
+  echo "bump: no version file changes, tagging the current commit"
+else
+  git add package.json
+  [[ -f package-lock.json ]] && git add package-lock.json
+  git commit --quiet -m "update version: ${TAG} [skip ci]"
+fi
+git tag "${TAG}"
+
+# Branch first, then the tag, so the tag never points at an unpushed commit.
+# If the branch moved meanwhile, the push is rejected and nothing is tagged.
+if ! git push --quiet origin "HEAD:refs/heads/${BRANCH}"; then
+  echo "bump: push to ${BRANCH} rejected, the newer pipeline bumps"
   exit 0
 fi
-
-git tag "$TAG"
-if ! git push --quiet origin "refs/tags/$TAG"; then
-  echo "bump: push of $TAG rejected, the newer pipeline bumps"
-  exit 0
-fi
-echo "bump: $TAG on $BRANCH (${SHA:0:8})"
+git push --quiet origin "refs/tags/${TAG}"
+echo "bump: ${TAG} on ${BRANCH}"