chore(version): pre-release bump to 09.25.03-dev [skip ci]

.mokogitea/workflows/issue-branch.yml

@@ -5,7 +5,7 @@
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: moko-platform.Automation
-# VERSION: 09.25.02
+# VERSION: 09.25.03
 # BRIEF: Auto-create feature branch when an issue is opened
 
 name: "Universal: Issue Branch"

.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

README.md

@@ -6,7 +6,7 @@ DEFGROUP: MokoPlatform.Root
 INGROUP: MokoPlatform
 REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
 PATH: /README.md
-VERSION: 09.25.02
+VERSION: 09.25.03
 BRIEF: Project overview and documentation
 -->
 

cli/branch_rename.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/branch_rename.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Rename a git branch via Gitea API (create new, update PR, delete old)
  */
 

cli/bulk_workflow_push.php

@@ -12,7 +12,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/bulk_workflow_push.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Push a workflow file to all governed repos via the Gitea Contents API
  */
 

cli/bulk_workflow_trigger.php

@@ -12,7 +12,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/bulk_workflow_trigger.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Trigger a workflow across multiple repos at once
  */
 

cli/client_dashboard.php

@@ -12,7 +12,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/client_dashboard.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Generate unified client dashboard HTML
  */
 

cli/client_inventory.php

@@ -12,7 +12,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/client_inventory.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Discover and list all client-waas repos with their server configuration status
  */
 

cli/client_provision.php

@@ -12,7 +12,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/client_provision.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Provision a new client environment end-to-end
  */
 

cli/grafana_dashboard.php

@@ -12,7 +12,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/grafana_dashboard.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Manage Grafana dashboards via API
  */
 

cli/joomla_build.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/joomla_build.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Build a Joomla extension ZIP from manifest — all types supported
  * NOTE: Called by pre-release and auto-release workflows.
  */

cli/manifest_licensing.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/manifest_licensing.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Ensure licensing tags (updateservers, dlid) in Joomla extension manifests
  */
 

cli/manifest_read.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/manifest_read.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Parse .manifest.xml and output requested field(s) for CI consumption
  */
 

cli/platform_detect.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/platform_detect.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Auto-detect repository platform type and optionally update manifest
  */
 

cli/release_cascade.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/release_cascade.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: DEPRECATED — cascade behavior removed. Each release stream is independent.
  */
 

cli/release_publish.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/release_publish.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Publish a release and create copies for all lesser stability streams.
  */
 

cli/scaffold_client.php

@@ -12,7 +12,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/scaffold_client.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Scaffold a new client-waas repo from Template-Client-WaaS with pre-configured settings
  */
 

cli/updates_xml_sync.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/updates_xml_sync.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Sync updates.xml to target branches via Gitea API
  * NOTE: Called by pre-release and auto-release workflows after updates.xml
  *       is modified on the current branch. Pushes the file to other branches

cli/version_auto_bump.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/version_auto_bump.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Auto patch-bump, set stability suffix, and commit — single CLI replacing inline workflow bash
  */
 

cli/version_check.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/version_check.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Validate version consistency across README, manifests, and sub-packages
  */
 

cli/wiki_sync.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/wiki_sync.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Sync select wiki pages from moko-platform to all template repos
  */
 

cli/workflow_sync.php

@@ -10,7 +10,7 @@
  * INGROUP: moko-platform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /cli/workflow_sync.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Sync workflows from Generic → platform templates → live repos based on manifest.platform
  */
 

deploy/backup-before-deploy.php

@@ -12,7 +12,7 @@
  * INGROUP: MokoPlatform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /deploy/backup-before-deploy.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Snapshot Joomla directories before deployment for rollback capability
  */
 

deploy/deploy-dolibarr.php

@@ -12,7 +12,7 @@
  * INGROUP: MokoPlatform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /deploy/deploy-dolibarr.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Deploy Dolibarr module files to a remote server via SFTP/rsync
  */
 

deploy/health-check.php

@@ -12,7 +12,7 @@
  * INGROUP: MokoPlatform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /deploy/health-check.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Post-deploy health check — verify a Joomla site is responding correctly
  */
 

deploy/rollback-joomla.php

@@ -12,7 +12,7 @@
  * INGROUP: MokoPlatform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /deploy/rollback-joomla.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Rollback a Joomla deployment by restoring from a pre-deploy snapshot
  */
 

deploy/sync-joomla.php

@@ -12,7 +12,7 @@
  * INGROUP: MokoPlatform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /deploy/sync-joomla.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Sync Joomla site directories between two servers via rsync over SSH
  */
 

tests/Unit/VersionBumpTest.php

@@ -63,7 +63,7 @@ class VersionBumpTest extends TestCase
     {
         file_put_contents(
             "{$this->tmpDir}/README.md",
-            "<!-- VERSION: 09.25.02 -->\nSome content\n"
+            "<!-- VERSION: 09.25.03 -->\nSome content\n"
         );
 
         $this->execute();

tests/Unit/VersionReadTest.php

@@ -34,7 +34,7 @@ class VersionReadTest extends TestCase
     {
         file_put_contents(
             "{$this->tmpDir}/README.md",
-            "# Test\n<!-- VERSION: 09.25.02 -->\n"
+            "# Test\n<!-- VERSION: 09.25.03 -->\n"
         );
 
         $this->assertSame('02.03.04', trim($this->runScript()));
@@ -68,7 +68,7 @@ class VersionReadTest extends TestCase
     {
         file_put_contents(
             "{$this->tmpDir}/README.md",
-            "<!-- VERSION: 09.25.02 -->\n"
+            "<!-- VERSION: 09.25.03 -->\n"
         );
         mkdir("{$this->tmpDir}/src", 0755, true);
         file_put_contents(

validate/check_file_integrity.php

@@ -12,7 +12,7 @@
  * INGROUP: MokoPlatform
  * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
  * PATH: /validate/check_file_integrity.php
- * VERSION: 09.25.02
+ * VERSION: 09.25.03
  * BRIEF: Compare deployed files on a remote server against the local repository to detect drift
  */