ci(pre-release): sync universal v05 workflow with chore/** branch trigger

.mokogitea/workflows/pre-release.yml

@@ -1,243 +1,252 @@
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-#
+#
-# SPDX-License-Identifier: GPL-3.0-or-later
+# SPDX-License-Identifier: GPL-3.0-or-later
-#
+#
-# FILE INFORMATION
+# FILE INFORMATION
-# DEFGROUP: Gitea.Workflow
+# DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Release
+# INGROUP: moko-platform.Release
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
-# PATH: /templates/workflows/universal/pre-release.yml.template
+# PATH: /templates/workflows/universal/pre-release.yml.template
-# VERSION: 05.01.00
+# VERSION: 05.01.00
-# BRIEF: Manual pre-release -- builds dev/alpha/beta/rc packages from any branch
+# BRIEF: Auto pre-release on push to dev/alpha/beta/rc branches
-
+
-name: "Universal: Pre-Release"
+name: "Universal: Pre-Release"
-
+
-on:
+on:
-  pull_request:
+  push:
-    types: [closed]
+    branches:
-    branches:
+      - dev
-      - dev
+      - 'fix/**'
-  pull_request_target:
+      - 'patch/**'
-    types: [synchronize, opened, reopened]
+      - 'hotfix/**'
-    branches:
+      - 'bugfix/**'
-      - main
+      - 'chore/**'
-  workflow_dispatch:
+      - alpha
-    inputs:
+      - beta
-      stability:
+      - rc
-        description: 'Pre-release channel'
+  workflow_dispatch:
-        required: true
+    inputs:
-        type: choice
+      stability:
-        options:
+        description: 'Pre-release channel'
-          - development
+        required: true
-          - alpha
+        type: choice
-          - beta
+        options:
-          - release-candidate
+          - development
-
+          - alpha
-permissions:
+          - beta
-  contents: write
+          - release-candidate
-
+
-env:
+permissions:
-  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
+  contents: write
-  GITEA_ORG: ${{ vars.GITEA_ORG || github.repository_owner }}
+
-  GITEA_REPO: ${{ vars.GITEA_REPO || github.event.repository.name }}
+env:
-
+  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
-jobs:
+  GITEA_ORG: ${{ vars.GITEA_ORG || github.repository_owner }}
-  build:
+  GITEA_REPO: ${{ vars.GITEA_REPO || github.event.repository.name }}
-    name: "Build Pre-Release (${{ inputs.stability || 'development' }})"
+
-    runs-on: release
+jobs:
-    if: >-
+  build:
-      github.event_name == 'workflow_dispatch' ||
+    name: "Build Pre-Release (${{ inputs.stability || github.ref_name }})"
-      (github.event_name == 'pull_request' && github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'dev') ||
+    runs-on: release
-      (github.event_name == 'pull_request_target' && github.event.pull_request.base.ref == 'main')
+    if: >-
-
+      github.event_name == 'workflow_dispatch' ||
-    steps:
+      github.event_name == 'push'
-      - name: Checkout
+
-        uses: actions/checkout@v4
+    steps:
-        with:
+      - name: Checkout
-          fetch-depth: 0
+        uses: actions/checkout@v4
-          token: ${{ secrets.MOKOGITEA_TOKEN }}
+        with:
-          ref: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.sha || '' }}
+          fetch-depth: 0
-
+          token: ${{ secrets.MOKOGITEA_TOKEN }}
-      - name: Setup moko-platform tools
+          ref: ${{ github.ref_name }}
-        env:
+
-          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
+      - name: Setup moko-platform tools
-          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
+        env:
-        run: |
+          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
-          # Use pre-installed /opt/moko-platform if available (updated by cron every 6h)
+          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
-          if [ -f /opt/moko-platform/cli/version_bump.php ] && [ -f /opt/moko-platform/cli/manifest_element.php ] && [ -f /opt/moko-platform/vendor/autoload.php ]; then
+        run: |
-            echo Using pre-installed /opt/moko-platform
+          # Use pre-installed /opt/moko-platform if available (updated by cron every 6h)
-            echo MOKO_CLI=/opt/moko-platform/cli >> $GITHUB_ENV
+          if [ -f /opt/moko-platform/cli/version_bump.php ] && [ -f /opt/moko-platform/cli/manifest_element.php ] && [ -f /opt/moko-platform/vendor/autoload.php ]; then
-          else
+            echo Using pre-installed /opt/moko-platform
-            echo Falling back to fresh clone
+            echo MOKO_CLI=/opt/moko-platform/cli >> $GITHUB_ENV
-            if ! command -v composer > /dev/null 2>&1; then
+          else
-              sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer > /dev/null 2>&1
+            echo Falling back to fresh clone
-            fi
+            if ! command -v composer > /dev/null 2>&1; then
-            rm -rf /tmp/moko-platform-api
+              sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer > /dev/null 2>&1
-            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git
+            fi
-            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/moko-platform-api
+            rm -rf /tmp/moko-platform-api
-            cd /tmp/moko-platform-api && composer install --no-dev --no-interaction --quiet
+            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/moko-platform.git
-            echo MOKO_CLI=/tmp/moko-platform-api/cli >> $GITHUB_ENV
+            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/moko-platform-api
-          fi
+            cd /tmp/moko-platform-api && composer install --no-dev --no-interaction --quiet
-
+            echo MOKO_CLI=/tmp/moko-platform-api/cli >> $GITHUB_ENV
-      - name: Detect platform
+          fi
-        id: platform
+
-        run: |
+      - name: Detect platform
-          php ${MOKO_CLI}/manifest_read.php --path . --github-output
+        id: platform
-
+        run: |
-      - name: Resolve metadata and bump version
+          # Auto-detect and update platform if not set in manifest
-        id: meta
+          php ${MOKO_CLI}/platform_detect.php --path . --github-output 2>/dev/null || true
-        run: |
+          php ${MOKO_CLI}/manifest_read.php --path . --github-output
-          # Auto-detect stability: RC for PRs targeting main, else use input or default to development
+
-          if [ "${{ github.event_name }}" = "pull_request_target" ] && [ "${{ github.event.pull_request.base.ref }}" = "main" ]; then
+      - name: Resolve metadata and bump version
-            STABILITY="release-candidate"
+        id: meta
-          else
+        run: |
-            STABILITY="${{ inputs.stability || 'development' }}"
+          # Auto-detect stability from branch name on push, or use input on dispatch
-          fi
+          if [ "${{ github.event_name }}" = "push" ]; then
-
+            case "${{ github.ref_name }}" in
-          case "$STABILITY" in
+              rc)    STABILITY="release-candidate" ;;
-            development)        SUFFIX="-dev";   TAG="development" ;;
+              alpha) STABILITY="alpha" ;;
-            alpha)              SUFFIX="-alpha"; TAG="alpha" ;;
+              beta)  STABILITY="beta" ;;
-            beta)               SUFFIX="-beta";  TAG="beta" ;;
+              *)     STABILITY="development" ;;
-            release-candidate)  SUFFIX="-rc";    TAG="release-candidate" ;;
+            esac
-          esac
+          else
-
+            STABILITY="${{ inputs.stability || 'development' }}"
-          # Bump version via CLI: patch for dev/alpha/beta, minor for RC
+          fi
-          case "$STABILITY" in
+
-            release-candidate) BUMP="minor" ;;
+          case "$STABILITY" in
-            *)                 BUMP="patch" ;;
+            development)        SUFFIX="-dev";   TAG="development" ;;
-          esac
+            alpha)              SUFFIX="-alpha"; TAG="alpha" ;;
-
+            beta)               SUFFIX="-beta";  TAG="beta" ;;
-          php ${MOKO_CLI}/version_bump.php --path . $([ "$BUMP" = "minor" ] && echo "--minor") 2>/dev/null || true
+            release-candidate)  SUFFIX="-rc";    TAG="release-candidate" ;;
-
+          esac
-          # Set stability suffix and verify consistency
+
-          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null || echo "00.00.01")
+          # Bump version via CLI: patch for dev/alpha/beta, minor for RC
-          VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
+          case "$STABILITY" in
-
+            release-candidate) BUMP="minor" ;;
-          php ${MOKO_CLI}/version_set_platform.php \
+            *)                 BUMP="patch" ;;
-            --path . --version "$VERSION" --branch "${{ github.ref_name }}" --stability "$STABILITY" 2>/dev/null || true
+          esac
-          php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
+
-
+          php ${MOKO_CLI}/version_bump.php --path . $([ "$BUMP" = "minor" ] && echo "--minor") 2>/dev/null || true
-          # Ensure licensing tags (updateservers, dlid) if enabled in manifest.xml
+
-          php ${MOKO_CLI}/manifest_licensing.php --path . --fix 2>/dev/null || true
+          # Set stability suffix and verify consistency
-
+          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null || echo "00.00.01")
-          # Append suffix for output
+          VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
-          if [ -n "$SUFFIX" ]; then
+
-            VERSION="${VERSION}${SUFFIX}"
+          php ${MOKO_CLI}/version_set_platform.php \
-          fi
+            --path . --version "$VERSION" --branch "${{ github.ref_name }}" --stability "$STABILITY" 2>/dev/null || true
-
+          php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
-          # Commit version bump
+
-          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
+          # Ensure licensing tags (updateservers, dlid) if enabled in manifest.xml
-          git config --local user.name "gitea-actions[bot]"
+          php ${MOKO_CLI}/manifest_licensing.php --path . --fix 2>/dev/null || true
-          git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
+
-          git add -A
+          # Append suffix for output
-          git diff --cached --quiet || {
+          if [ -n "$SUFFIX" ]; then
-            git commit -m "chore(version): pre-release bump to ${VERSION} [skip ci]"
+            VERSION="${VERSION}${SUFFIX}"
-            git push origin HEAD 2>&1
+          fi
-          }
+
-
+          # Commit version bump
-          # Auto-detect element via manifest_element.php
+          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
-          php ${MOKO_CLI}/manifest_element.php \
+          git config --local user.name "gitea-actions[bot]"
-            --path . --version "$VERSION" --stability "$STABILITY" \
+          git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
-            --repo "${GITEA_REPO}" --github-output
+          git add -A
-
+          git diff --cached --quiet || {
-          # Read back element outputs
+            git commit -m "chore(version): pre-release bump to ${VERSION} [skip ci]"
-          EXT_ELEMENT=$(grep '^ext_element=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
+            git push origin HEAD 2>&1
-          ZIP_NAME=$(grep '^zip_name=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
+          }
-          [ -z "$EXT_ELEMENT" ] && EXT_ELEMENT=$(echo "${GITEA_REPO}" | tr '[:upper:]' '[:lower:]' | tr -d ' -')
+
-          [ -z "$ZIP_NAME" ] && ZIP_NAME="${EXT_ELEMENT}-${VERSION}.zip"
+          # Auto-detect element via manifest_element.php
-
+          php ${MOKO_CLI}/manifest_element.php \
-          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+            --path . --version "$VERSION" --stability "$STABILITY" \
-          echo "stability=${STABILITY}" >> "$GITHUB_OUTPUT"
+            --repo "${GITEA_REPO}" --github-output
-          echo "suffix=${SUFFIX}" >> "$GITHUB_OUTPUT"
+
-          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
+          # Read back element outputs
-          echo "zip_name=${ZIP_NAME}" >> "$GITHUB_OUTPUT"
+          EXT_ELEMENT=$(grep '^ext_element=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
-          echo "ext_element=${EXT_ELEMENT}" >> "$GITHUB_OUTPUT"
+          ZIP_NAME=$(grep '^zip_name=' "$GITHUB_OUTPUT" | tail -1 | cut -d= -f2)
-
+          [ -z "$EXT_ELEMENT" ] && EXT_ELEMENT=$(echo "${GITEA_REPO}" | tr '[:upper:]' '[:lower:]' | tr -d ' -')
-          echo "=== Pre-Release: ${EXT_ELEMENT} ${VERSION}${SUFFIX} ==="
+          [ -z "$ZIP_NAME" ] && ZIP_NAME="${EXT_ELEMENT}-${VERSION}.zip"
-
+
-      - name: Create release
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
-        id: release
+          echo "stability=${STABILITY}" >> "$GITHUB_OUTPUT"
-        run: |
+          echo "suffix=${SUFFIX}" >> "$GITHUB_OUTPUT"
-          TAG="${{ steps.meta.outputs.tag }}"
+          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
-          VERSION="${{ steps.meta.outputs.version }}"
+          echo "zip_name=${ZIP_NAME}" >> "$GITHUB_OUTPUT"
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+          echo "ext_element=${EXT_ELEMENT}" >> "$GITHUB_OUTPUT"
-          php ${MOKO_CLI}/release_create.php \
+
-            --path . --version "$VERSION" --tag "$TAG" \
+          echo "=== Pre-Release: ${EXT_ELEMENT} ${VERSION}${SUFFIX} ==="
-            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
+
-            --repo "${GITEA_REPO}" --branch dev --prerelease
+      - name: Create release
-
+        id: release
-      - name: Update release notes from CHANGELOG.md
+        run: |
-        run: |
+          TAG="${{ steps.meta.outputs.tag }}"
-          TAG="${{ steps.meta.outputs.tag }}"
+          VERSION="${{ steps.meta.outputs.version }}"
-          VERSION="${{ steps.meta.outputs.version }}"
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+          php ${MOKO_CLI}/release_create.php \
-
+            --path . --version "$VERSION" --tag "$TAG" \
-          # Extract [Unreleased] section from changelog (everything between [Unreleased] and next ## heading)
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
-          if [ -f "CHANGELOG.md" ]; then
+            --repo "${GITEA_REPO}" --branch "${{ github.ref_name }}" --prerelease
-            NOTES=$(awk '/^## \[Unreleased\]/{found=1; next} /^## \[/{if(found) exit} found{print}' CHANGELOG.md)
+
-            [ -z "$NOTES" ] && NOTES="Release ${VERSION}"
+      - name: Update release notes from CHANGELOG.md
-          else
+        run: |
-            NOTES="Release ${VERSION}"
+          TAG="${{ steps.meta.outputs.tag }}"
-          fi
+          VERSION="${{ steps.meta.outputs.version }}"
-
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-          # Update release body via API
+
-          RELEASE_ID=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
+          # Extract [Unreleased] section from changelog (everything between [Unreleased] and next ## heading)
-            "${API_BASE}/releases/tags/${TAG}" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" 2>/dev/null || true)
+          if [ -f "CHANGELOG.md" ]; then
-
+            NOTES=$(awk '/^## \[Unreleased\]/{found=1; next} /^## \[/{if(found) exit} found{print}' CHANGELOG.md)
-          if [ -n "$RELEASE_ID" ]; then
+            [ -z "$NOTES" ] && NOTES="Release ${VERSION}"
-            python3 -c "
+          else
-          import json, urllib.request
+            NOTES="Release ${VERSION}"
-          body = open('/dev/stdin').read()
+          fi
-          payload = json.dumps({'body': body}).encode()
+
-          req = urllib.request.Request(
+          # Update release body via API
-              '${API_BASE}/releases/${RELEASE_ID}',
+          RELEASE_ID=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
-              data=payload, method='PATCH',
+            "${API_BASE}/releases/tags/${TAG}" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" 2>/dev/null || true)
-              headers={
+
-                  'Authorization': 'token ${{ secrets.MOKOGITEA_TOKEN }}',
+          if [ -n "$RELEASE_ID" ]; then
-                  'Content-Type': 'application/json'
+            python3 -c "
-              })
+          import json, urllib.request
-          urllib.request.urlopen(req)
+          body = open('/dev/stdin').read()
-          " <<< "$NOTES"
+          payload = json.dumps({'body': body}).encode()
-            echo "Release notes updated from CHANGELOG.md"
+          req = urllib.request.Request(
-          fi
+              '${API_BASE}/releases/${RELEASE_ID}',
-
+              data=payload, method='PATCH',
-      - name: Build package and upload
+              headers={
-        id: package
+                  'Authorization': 'token ${{ secrets.MOKOGITEA_TOKEN }}',
-        run: |
+                  'Content-Type': 'application/json'
-          VERSION="${{ steps.meta.outputs.version }}"
+              })
-          TAG="${{ steps.meta.outputs.tag }}"
+          urllib.request.urlopen(req)
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+          " <<< "$NOTES"
-          php ${MOKO_CLI}/release_package.php \
+            echo "Release notes updated from CHANGELOG.md"
-            --path . --version "$VERSION" --tag "$TAG" \
+          fi
-            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
+
-            --repo "${GITEA_REPO}" --output /tmp || true
+      - name: Build package and upload
-
+        id: package
-      # updates.xml is generated dynamically by MokoGitea license server
+        run: |
-      # No need to build, commit, or sync updates.xml from workflows
+          VERSION="${{ steps.meta.outputs.version }}"
-
+          TAG="${{ steps.meta.outputs.tag }}"
-      - name: "Delete lesser pre-release channels (cascade)"
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-        continue-on-error: true
+          php ${MOKO_CLI}/release_package.php \
-        run: |
+            --path . --version "$VERSION" --tag "$TAG" \
-          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
-          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
+            --repo "${GITEA_REPO}" --output /tmp || true
-
+
-          php ${MOKO_CLI}/release_cascade.php \
+      # updates.xml is generated dynamically by MokoGitea license server
-            --stability "${{ steps.meta.outputs.stability }}" \
+      # No need to build, commit, or sync updates.xml from workflows
-            --token "${TOKEN}" \
+
-            --api-base "${API_BASE}"
+      - name: "Delete lesser pre-release channels (cascade)"
-
+        continue-on-error: true
-      - name: Summary
+        run: |
-        if: always()
+          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
-        run: |
+          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
-          VERSION="${{ steps.meta.outputs.version }}"
+
-          STABILITY="${{ steps.meta.outputs.stability }}"
+          php ${MOKO_CLI}/release_cascade.php \
-          ZIP_NAME="${{ steps.meta.outputs.zip_name }}"
+            --stability "${{ steps.meta.outputs.stability }}" \
-          SHA256="${{ steps.package.outputs.sha256_zip }}"
+            --token "${TOKEN}" \
-          echo "## Pre-Release Complete" >> $GITHUB_STEP_SUMMARY
+            --api-base "${API_BASE}"
-          echo "" >> $GITHUB_STEP_SUMMARY
+
-          echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
+      - name: Summary
-          echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
+        if: always()
-          echo "| Version | \`${VERSION}\` |" >> $GITHUB_STEP_SUMMARY
+        run: |
-          echo "| Channel | ${STABILITY} |" >> $GITHUB_STEP_SUMMARY
+          VERSION="${{ steps.meta.outputs.version }}"
-          echo "| Package | \`${ZIP_NAME}\` |" >> $GITHUB_STEP_SUMMARY
+          STABILITY="${{ steps.meta.outputs.stability }}"
-          echo "| SHA-256 | \`${SHA256:-n/a}\` |" >> $GITHUB_STEP_SUMMARY
+          ZIP_NAME="${{ steps.meta.outputs.zip_name }}"
+          SHA256="${{ steps.package.outputs.sha256_zip }}"
+          echo "## Pre-Release Complete" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "| Field | Value |" >> $GITHUB_STEP_SUMMARY
+          echo "|-------|-------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Version | \`${VERSION}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| Channel | ${STABILITY} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Package | \`${ZIP_NAME}\` |" >> $GITHUB_STEP_SUMMARY
+          echo "| SHA-256 | \`${SHA256:-n/a}\` |" >> $GITHUB_STEP_SUMMARY