feat(release-plugin): Auto-Modus bei push auf main

- Trigger-Erkennung im "Variablen ableiten"-Step (refs/tags/* vs refs/heads/*) - Auto-Modus: Header-Version aus Plugin-PHP lesen, Tag v{version} prüfen → wenn Tag existiert: stiller Skip; sonst Pre-Flight + Build + Release - Release-API-Call mit target_commitish, damit Tag im Auto-Modus aus dem aktuellen HEAD-Commit erzeugt wird - Klassischer Tag-Push-Modus bleibt unverändert - Nachfolgende Steps mit if: steps.vars.outputs.skip != 'true' geguarded
docs(readme): Caller-Workflow auf branches:[main] + tags Trigger umstellen
2026-05-12 05:34:06 +00:00 · 2026-05-12 05:32:40 +00:00 · 2026-05-12 05:32:04 +00:00
3 changed files with 93 additions and 8 deletions
@@ -21,7 +21,12 @@ name: Release Plugin
 # "== Changelog ==" in readme.txt wird beim Build aus CHANGELOG.md
 # generiert und ist nur im fertigen ZIP vollständig.
 #
-# Trigger im aufrufenden Repo: push eines Tags der Form v<MAJOR>.<MINOR>.<PATCH>.
+# Trigger im aufrufenden Repo:
+#   - push auf main → Auto-Modus: Header-Version wird ausgelesen, Tag v<X.Y.Z>
+#     wird erzeugt (sofern noch nicht vorhanden), Release wird gebaut.
+#     Existiert der Tag bereits, beendet der Workflow still (kein Release).
+#   - push eines Tags v<MAJOR>.<MINOR>.<PATCH> → klassischer Modus: Tag wird
+#     direkt für den Release verwendet.
 # Ausführung auf dem IDF-Runner (self-hosted, Host-Modus).

 on:
@@ -50,14 +55,12 @@ jobs:
      - name: Checkout Tag
        uses: actions/checkout@v4

-      - name: Variablen ableiten
+      - name: Variablen ableiten (Auto-Modus oder Tag-Modus)
        id: vars
        shell: bash
        run: |
          set -euo pipefail
          SLUG="${{ inputs.slug }}"
-          TAG="${GITHUB_REF_NAME}"
-          VERSION="${TAG#v}"
          MAIN_FILE="${{ inputs.main_file }}"
          [[ -z "$MAIN_FILE" ]] && MAIN_FILE="${SLUG}.php"
          CONST="${{ inputs.version_constant }}"
@@ -66,6 +69,37 @@ jobs:
            base_upper="$(echo "$base" | tr '[:lower:]-' '[:upper:]_')"
            CONST="IDF_${base_upper}_VERSION"
          fi
+
+          if [[ "$GITHUB_REF" == refs/tags/* ]]; then
+            # Klassischer Modus — Tag-Push
+            MODE="tag"
+            TAG="${GITHUB_REF_NAME}"
+            VERSION="${TAG#v}"
+          else
+            # Auto-Modus — Push auf Branch (z.B. main)
+            MODE="auto"
+            if [[ ! -f "$MAIN_FILE" ]]; then
+              echo "::error::Plugin-Haupt-PHP nicht gefunden: $MAIN_FILE"
+              exit 1
+            fi
+            HEADER_VERSION="$(grep -iE '^[[:space:]]*\*?[[:space:]]*Version:[[:space:]]*' "$MAIN_FILE" | head -n1 | sed -E 's/^[^0-9]*([0-9]+\.[0-9]+\.[0-9]+).*$/\1/')"
+            if [[ -z "$HEADER_VERSION" ]]; then
+              echo "::error::Header-Version in $MAIN_FILE nicht lesbar"
+              exit 1
+            fi
+            VERSION="$HEADER_VERSION"
+            TAG="v$VERSION"
+          fi
+
+          # Skip-Check (nur Auto-Modus): existiert der Tag schon, kein neues Release
+          SKIP=false
+          if [[ "$MODE" == "auto" ]]; then
+            if git ls-remote --tags origin "refs/tags/${TAG}" 2>/dev/null | grep -q "refs/tags/${TAG}"; then
+              echo "Tag $TAG existiert bereits — Skip (kein neues Release)."
+              SKIP=true
+            fi
+          fi
+
          ZIPNAME="${SLUG}_v${VERSION}.zip"
          {
            echo "slug=$SLUG"
@@ -74,10 +108,13 @@ jobs:
            echo "main_file=$MAIN_FILE"
            echo "const=$CONST"
            echo "zipname=$ZIPNAME"
+            echo "mode=$MODE"
+            echo "skip=$SKIP"
          } >> "$GITHUB_OUTPUT"
-          echo "Ermittelt: slug=$SLUG tag=$TAG version=$VERSION main_file=$MAIN_FILE const=$CONST"
+          echo "Ermittelt: mode=$MODE tag=$TAG version=$VERSION main_file=$MAIN_FILE const=$CONST skip=$SKIP"

      - name: Pre-Flight — Tag-Format
+        if: steps.vars.outputs.skip != 'true'
        shell: bash
        run: |
          set -euo pipefail
@@ -89,6 +126,7 @@ jobs:
          echo "Tag-Format OK: $TAG"

      - name: Pre-Flight — Pflichtdateien
+        if: steps.vars.outputs.skip != 'true'
        shell: bash
        run: |
          set -euo pipefail
@@ -102,6 +140,7 @@ jobs:
          echo "Pflichtdateien OK"

      - name: Pre-Flight — Plugin-Header-Version
+        if: steps.vars.outputs.skip != 'true'
        shell: bash
        run: |
          set -euo pipefail
@@ -123,6 +162,7 @@ jobs:
          echo "Header-Version OK: $HEADER_VERSION"

      - name: Pre-Flight — Versions-Konstante
+        if: steps.vars.outputs.skip != 'true'
        shell: bash
        run: |
          set -euo pipefail
@@ -141,6 +181,7 @@ jobs:
          echo "Konstante OK: $CONST=$CONST_VERSION"

      - name: Pre-Flight — readme.txt Stable tag
+        if: steps.vars.outputs.skip != 'true'
        shell: bash
        run: |
          set -euo pipefail
@@ -157,6 +198,7 @@ jobs:
          echo "Stable tag OK: $STABLE_TAG"

      - name: Changelog-Block aus CHANGELOG.md extrahieren
+        if: steps.vars.outputs.skip != 'true'
        id: changelog
        shell: bash
        env:
@@ -190,6 +232,7 @@ jobs:
          echo "Changelog-Block extrahiert (${#BLOCK} Zeichen)."

      - name: ZIP bauen (readme.txt Changelog-Section aus CHANGELOG.md generieren)
+        if: steps.vars.outputs.skip != 'true'
        id: zip
        shell: bash
        env:
@@ -303,6 +346,7 @@ jobs:
          echo "zippath=/tmp/$ZIPNAME" >> "$GITHUB_OUTPUT"

      - name: Gitea-Release anlegen und Asset anhängen
+        if: steps.vars.outputs.skip != 'true'
        shell: bash
        env:
          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN || github.token }}
@@ -314,11 +358,16 @@ jobs:
          set -euo pipefail
          SERVER="${GITHUB_SERVER_URL:-https://git.ihre-ideenfabrik.de}"
          REPO="${GITHUB_REPOSITORY}"
+          # target_commitish setzt den Commit, aus dem der Tag erzeugt wird,
+          # falls er noch nicht existiert (Auto-Modus). Bei Tag-Push ist es egal,
+          # weil der Tag schon den Commit kennt — Gitea ignoriert das Feld dann.
+          TARGET_SHA="${GITHUB_SHA}"
          PAYLOAD="$(jq -n \
            --arg tag "$TAG" \
            --arg name "$TAG" \
            --arg body "$BODY" \
-            '{tag_name:$tag, name:$name, body:$body, draft:false, prerelease:false}')"
+            --arg target "$TARGET_SHA" \
+            '{tag_name:$tag, name:$name, body:$body, target_commitish:$target, draft:false, prerelease:false}')"
          RESP="$(curl -sSf \
            -H "Authorization: token $GITEA_TOKEN" \
            -H "Content-Type: application/json" \
@@ -0,0 +1,31 @@
+# Changelog
+
+## v1.2.0
+
+### Hinzugefügt
+- Auto-Modus für `release-plugin.yml`: Push auf main triggert ein Release, sobald die Header-Version eines Plugins erhöht wurde. Tag wird automatisch erzeugt, kein manueller `git tag` mehr nötig.
+- Wenn der Tag zur aktuellen Header-Version bereits existiert, beendet der Workflow still (kein neues Release, keine Mail).
+- Caller-Repos können den Workflow weiterhin im klassischen Modus (Tag-Push) nutzen — beide Trigger werden unterstützt.
+
+### Geändert
+- Release-API-Call nutzt jetzt `target_commitish`, damit Tags im Auto-Modus aus dem aktuellen Commit erzeugt werden können.
+
+## v1.1.0
+
+### Geändert
+- Frühere Iteration des Workflows (vor Auto-Modus). Details siehe Git-Historie.
+
+## v1.0.2
+
+### Behoben
+- Diverse Pre-Flight-Korrekturen.
+
+## v1.0.1
+
+### Behoben
+- Initial-Hotfix nach v1.0.0.
+
+## v1.0.0
+
+### Hinzugefügt
+- Erste produktive Version von `release-plugin.yml` (Tag-Push-Modus).
@@ -25,7 +25,8 @@ In jedem Plugin-Repo (`ideenfabrik/idf-<slug>`) liegt ein schlanker Caller-Workf
 name: Release
 on:
  push:
-    tags: ['v*.*.*']
+    branches: [main]      # Auto-Modus: Release sobald Header-Version hochgezogen wurde
+    tags: ['v*.*.*']      # Klassischer Modus: manuelle Tags sind weiterhin möglich

 jobs:
  release:
@@ -35,7 +36,11 @@ jobs:
    secrets: inherit
 ```

-Für die Anwendung reicht `git tag v1.2.3 && git push --tags`. Alles andere macht der Reusable Workflow. Details und Fehlerdiagnose im [Caller-Template](docs/plugin-caller-template.md).
+**Auto-Modus (Standard, seit v1.2.0):** Plugin-Header-Version, PHP-Konstante, `Stable tag:` und CHANGELOG-Block hochziehen, committen, nach `main` pushen. Der Workflow erzeugt Tag `v<X.Y.Z>` selbst und legt das Release an. Wenn die Version nicht erhöht wurde, beendet der Workflow still (kein Release, keine Mail).
+
+**Klassischer Modus:** Falls du lieber explizit taggst — `git tag v1.2.3 && git push --tags` triggert denselben Workflow im Tag-Modus. Beide Pfade können koexistieren.
+
+Details und Fehlerdiagnose im [Caller-Template](docs/plugin-caller-template.md).

 ## Pflichtdateien im Plugin-Repo