chore: update stable channel 02.10.00 [skip ci]

chore(release): build 02.10.00 [skip ci]
Merge pull request 'feat: multi-branch versioning workflows and wiki' (#93 ) from dev into main
2026-05-29 09:52:48 +00:00 · 2026-05-29 09:52:46 +00:00 · 2026-05-29 09:52:34 +00:00 · 2026-05-29 04:51:00 -05:00
15 changed files with 101 additions and 67 deletions
@@ -8,7 +8,7 @@
    <name>Template - MokoOnyx</name>
    <org>MokoConsulting</org>
    <description>MokoOnyx - Joomla site template (successor to MokoCassiopeia)</description>
-    <version>02.09.00</version>
+    <version>02.10.00</version>
    <license spdx="GPL-3.0-or-later">GNU General Public License v3</license>
  </identity>
  <governance>
@@ -16,6 +16,10 @@ on:
  push:
    branches:
      - dev
+      - alpha
+      - beta
+      - rc
+      - 'feature/**'

 env:
  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
@@ -57,29 +61,7 @@ jobs:

      - name: Bump version
        run: |
-          BUMP=$(php ${MOKO_CLI}/version_bump.php --path . 2>&1) || true
-          echo "$BUMP"
-
-          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null) || true
-          [ -z "$VERSION" ] && { echo "No version found — skipping"; exit 0; }
-
-          # Propagate to platform manifests with -dev suffix
-          php ${MOKO_CLI}/version_set_platform.php \
-            --path . --version "$VERSION" --branch dev --stability dev 2>/dev/null || true
-          php ${MOKO_CLI}/version_check.php --path . --fix 2>/dev/null || true
-          VERSION="${VERSION}-dev"
-
-          # Commit if anything changed
-          if git diff --quiet && git diff --cached --quiet; then
-            echo "No version changes to commit"
-            exit 0
-          fi
-
-          git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
-          git config --local user.name "gitea-actions[bot]"
-          git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
-          git add -A
-          git commit -m "chore(version): auto-bump patch ${VERSION} [skip ci]" \
-            --author="gitea-actions[bot] <gitea-actions[bot]@mokoconsulting.tech>"
-          git push origin dev
-          echo "Bumped to ${VERSION}" >> $GITHUB_STEP_SUMMARY
+          php ${MOKO_CLI}/version_auto_bump.php \
+            --path . --branch "${GITHUB_REF_NAME}" \
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" \
+            --repo-url "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
@@ -5,7 +5,7 @@
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: moko-platform.Automation
-# VERSION: 01.00.00
+# VERSION: 02.10.00
 # BRIEF: Auto-create feature branch when an issue is opened

 name: "Universal: Issue Branch"
@@ -8,13 +8,15 @@
 DEFGROUP: Joomla.Template.Site
 INGROUP: MokoOnyx.Documentation
 PATH: ./CHANGELOG.md
- VERSION: 03.09.03
+ VERSION: 02.10.00
 BRIEF: Changelog file documenting version history of MokoOnyx
 -->

-# Changelog — MokoOnyx (VERSION: 03.09.03)
+# Changelog — MokoOnyx (VERSION: 02.10.00)
 ## [Unreleased]

+## [02.10.00] --- 2026-05-29
+
 ## [02.09.00] --- 2026-05-29

 ## [02.08.00] --- 2026-05-29
@@ -22,11 +24,3 @@
 ## [02.08.00] --- 2026-05-29

 ## [02.08.00] --- 2026-05-29
-
-## [02.08.00] --- 2026-05-28
-
-
-All notable changes to the MokoOnyx Joomla template are documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
@@ -10,7 +10,7 @@
 INGROUP: MokoOnyx.Governance
 REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 FILE: SECURITY.md
- VERSION: 03.09.03
+ VERSION: 02.10.00
 BRIEF: Security policy and vulnerability reporting process for MokoOnyx.
 PATH: /SECURITY.md
 NOTE: This policy is process oriented and does not replace secure engineering practices.
@@ -11,7 +11,7 @@
 * INGROUP: MokoOnyx
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 * PATH: /html/com_joomgallery/category/default.php
- * VERSION: 01.00.00
+ * VERSION: 02.10.00
 * BRIEF: Category view override — password gate then loads default_cat sub-layout
 */

@@ -11,7 +11,7 @@
 * INGROUP: MokoOnyx
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 * PATH: /html/com_joomgallery/category/default_cat.php
- * VERSION: 01.00.00
+ * VERSION: 02.10.00
 * BRIEF: Category sub-layout — subcategories grid + images grid with pagination
 */

@@ -11,7 +11,7 @@
 * INGROUP: MokoOnyx
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 * PATH: /html/com_joomgallery/gallery/default.php
- * VERSION: 01.00.00
+ * VERSION: 02.10.00
 * BRIEF: Gallery view override — main image grid with masonry/justified layout
 */

@@ -11,7 +11,7 @@
 * INGROUP: MokoOnyx
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 * PATH: /html/com_joomgallery/image/default.php
- * VERSION: 01.00.00
+ * VERSION: 02.10.00
 * BRIEF: Image detail view override — single image with metadata, tags, custom fields
 */

@@ -10,7 +10,7 @@
 * INGROUP: MokoOnyx
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 * PATH: /html/layouts/joomla/module/card.php
- * VERSION: 01.00.07
+ * VERSION: 02.10.00
 * BRIEF: Custom card module chrome — renders module titles for all modules
 */

@@ -11,7 +11,7 @@
 * INGROUP: MokoOnyx.Layouts
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 * PATH: /src/html/layouts/mokoonyx/article-metadata.php
- * VERSION: 03.09.04
+ * VERSION: 02.10.00
 * BRIEF: Article metadata footer layout -- renders jcfields grouped by field group
 */

@@ -10,7 +10,7 @@
 * INGROUP: MokoOnyx.Accessibility
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx
 * PATH: ./media/css/a11y-high-contrast.css
- * VERSION: 03.09.14
+ * VERSION: 02.10.00
 * BRIEF: High-contrast stylesheet for accessibility toolbar
 */

@@ -36,7 +36,7 @@
 		</server>
 	</updateservers>
 	<name>Template - MokoOnyx</name>
-	<version>02.09.00</version>
+	<version>02.10.00</version>
 	<scriptfile>script.php</scriptfile>
 	<creationDate>2026-05-16</creationDate>
 	<author>Jonathan Miller || Moko Consulting</author>
@@ -1,7 +1,7 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 SPDX-License-Identifier: GPL-3.0-or-later
- VERSION: 02.09.00
+ VERSION: 02.10.00
 -->

 <updates>
@@ -11,13 +11,13 @@
    <element>mokoonyx</element>
    <type>template</type>
    <client>site</client>
-    <version>02.09.00</version>
+    <version>02.10.00</version>
    <creationDate>2026-05-29</creationDate>
    <infourl title='Template - MokoOnyx'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/stable</infourl>
    <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.09.00.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.10.00.zip</downloadurl>
    </downloads>
-    <sha256>fda0d42421b02f13846fde2e8c3453e5d038275e016d3448018cea24c89e6188</sha256>
+    <sha256>c561f8c67ccfab8f229cf906e907e211b5063c7803198a3581e2c587a993f444</sha256>
    <tags><tag>dev</tag></tags>
    <maintainer>Moko Consulting</maintainer>
    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -29,13 +29,13 @@
    <element>mokoonyx</element>
    <type>template</type>
    <client>site</client>
-    <version>02.09.00</version>
+    <version>02.10.00</version>
    <creationDate>2026-05-29</creationDate>
    <infourl title='Template - MokoOnyx'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/stable</infourl>
    <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.09.00.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.10.00.zip</downloadurl>
    </downloads>
-    <sha256>fda0d42421b02f13846fde2e8c3453e5d038275e016d3448018cea24c89e6188</sha256>
+    <sha256>c561f8c67ccfab8f229cf906e907e211b5063c7803198a3581e2c587a993f444</sha256>
    <tags><tag>alpha</tag></tags>
    <maintainer>Moko Consulting</maintainer>
    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -47,13 +47,13 @@
    <element>mokoonyx</element>
    <type>template</type>
    <client>site</client>
-    <version>02.09.00</version>
+    <version>02.10.00</version>
    <creationDate>2026-05-29</creationDate>
    <infourl title='Template - MokoOnyx'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/stable</infourl>
    <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.09.00.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.10.00.zip</downloadurl>
    </downloads>
-    <sha256>fda0d42421b02f13846fde2e8c3453e5d038275e016d3448018cea24c89e6188</sha256>
+    <sha256>c561f8c67ccfab8f229cf906e907e211b5063c7803198a3581e2c587a993f444</sha256>
    <tags><tag>beta</tag></tags>
    <maintainer>Moko Consulting</maintainer>
    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -65,13 +65,13 @@
    <element>mokoonyx</element>
    <type>template</type>
    <client>site</client>
-    <version>02.09.00</version>
+    <version>02.10.00</version>
    <creationDate>2026-05-29</creationDate>
    <infourl title='Template - MokoOnyx'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/stable</infourl>
    <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.09.00.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.10.00.zip</downloadurl>
    </downloads>
-    <sha256>fda0d42421b02f13846fde2e8c3453e5d038275e016d3448018cea24c89e6188</sha256>
+    <sha256>c561f8c67ccfab8f229cf906e907e211b5063c7803198a3581e2c587a993f444</sha256>
    <tags><tag>rc</tag></tags>
    <maintainer>Moko Consulting</maintainer>
    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -83,13 +83,13 @@
    <element>mokoonyx</element>
    <type>template</type>
    <client>site</client>
-    <version>02.09.00</version>
+    <version>02.10.00</version>
    <creationDate>2026-05-29</creationDate>
    <infourl title='Template - MokoOnyx'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/tag/stable</infourl>
    <downloads>
-      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.09.00.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://git.mokoconsulting.tech/MokoConsulting/MokoOnyx/releases/download/stable/tpl_mokoonyx-02.10.00.zip</downloadurl>
    </downloads>
-    <sha256>fda0d42421b02f13846fde2e8c3453e5d038275e016d3448018cea24c89e6188</sha256>
+    <sha256>c561f8c67ccfab8f229cf906e907e211b5063c7803198a3581e2c587a993f444</sha256>
    <tags><tag>stable</tag></tags>
    <maintainer>Moko Consulting</maintainer>
    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
@@ -201,10 +201,68 @@ Creates SHA-256 checksums for all ZIP files in `dist/`.

 ### Branching Model

-| Branch | Purpose |
-|--------|---------|
-| `main` | Stable releases |
-| `dev` | Active development |
+| Branch | Purpose | Stability Suffix |
+|--------|---------|-----------------|
+| `main` | Stable releases | (none) |
+| `dev` | Active development | `-dev` |
+| `alpha` | Alpha pre-releases | `-alpha` |
+| `beta` | Beta pre-releases | `-beta` |
+| `rc` | Release candidates | `-rc` |
+| `feature/*` | Feature development | `-dev` |
+| `version/XX.YY.ZZ` | Archived release snapshots | (none) |
+
+### Version Numbering
+
+Versions use the format `XX.YY.ZZ` (two-digit segments, zero-padded):
+
+- **XX** -- Major version (breaking changes)
+- **YY** -- Minor version (new features, bumped on release to main)
+- **ZZ** -- Patch version (auto-incremented on every push to dev/feature branches)
+
+Stability suffixes are appended during development:
+
+- `02.09.00-dev` -- Development build
+- `02.09.00-alpha` -- Alpha pre-release
+- `02.09.00-beta` -- Beta pre-release
+- `02.09.00-rc` -- Release candidate
+
+On merge to `main`, suffixes are stripped and the minor version is bumped.
+
+### Auto Version Bump
+
+On every push to `dev`, `alpha`, `beta`, `rc`, or `feature/*`:
+
+1. The patch version is incremented (e.g., `02.08.05` -> `02.08.06`)
+2. The stability suffix is applied based on the branch name
+3. All version-bearing files are updated (manifests, CHANGELOG, PHP headers, etc.)
+4. A commit is created with `[skip ci]` to avoid infinite loops
+
+Commits with `[skip ci]` or `[skip bump]` in the message are ignored.
+
+### Auto Release
+
+When a PR is merged from `dev` to `main`:
+
+1. The minor version is bumped (e.g., `02.08.xx` -> `02.09.00`)
+2. Stability suffixes are stripped (stable release)
+3. A Gitea release is created with the build package (ZIP + tar.gz + SHA-256)
+4. `updates.xml` is updated for the Joomla update server
+5. The `dev` branch is recreated from `main`
+6. A `version/XX.YY.ZZ` archive branch is created
+
+### Release Channels
+
+The `updates.xml` file provides update streams for Joomla sites:
+
+| Channel | Tag | Description |
+|---------|-----|-------------|
+| Development | `dev` | Latest dev build (or stable if higher) |
+| Alpha | `alpha` | Alpha pre-release |
+| Beta | `beta` | Beta pre-release |
+| Release Candidate | `rc` | RC pre-release |
+| Stable | `stable` | Production-ready release |
+
+Joomla sites check the channel matching their configured stability level.

 ---
Author	SHA1	Message	Date
gitea-actions[bot]	1f1de164fd	chore: update stable channel 02.10.00 [skip ci]	2026-05-29 09:52:48 +00:00
gitea-actions[bot]	8b750f0e2e	chore(release): build 02.10.00 [skip ci]	2026-05-29 09:52:46 +00:00
jmiller	a786cfcecd	Merge pull request 'feat: multi-branch versioning workflows and wiki' (#93 ) from dev into main Generic: Repo Health / Site Health (push) Has been skipped Details Generic: Repo Health / Access control (push) Successful in 2s Details Universal: Cascade Main → Dev / Cascade main → branches (push) Failing after 2s Details Generic: Repo Health / Release configuration (push) Has been cancelled Details Generic: Repo Health / Scripts governance (push) Has been cancelled Details Generic: Repo Health / Repository health (push) Has been cancelled Details	2026-05-29 09:52:34 +00:00
Jonathan Miller	636efe5d8d	feat: update workflows and wiki for multi-branch versioning [skip bump] Universal: Auto Version Bump / Version Bump (push) Has been skipped Details Generic: Repo Health / Site Health (push) Has been skipped Details Generic: Repo Health / Access control (push) Successful in 2s Details Universal: PR Check / Branch Policy (pull_request) Successful in 1s Details Generic: Repo Health / Site Health (pull_request) Has been skipped Details Joomla: Extension CI / Release Readiness Check (pull_request) Failing after 3s Details Generic: Repo Health / Access control (pull_request) Successful in 1s Details Universal: Secret Scanning / Gitleaks Secret Scan (pull_request) Successful in 4s Details Universal: PR Check / Validate PR (pull_request) Successful in 6s Details Branch Cleanup / Delete merged branch (pull_request) Has been skipped Details Universal: Build & Release / Promote Pre-Release to RC (pull_request) Has been skipped Details Joomla: Extension CI / Lint & Validate (pull_request) Failing after 26s Details Universal: Build & Release / Build & Release Pipeline (pull_request) Successful in 13s Details Generic: Repo Health / Release configuration (push) Has been cancelled Details Generic: Repo Health / Scripts governance (push) Has been cancelled Details Generic: Repo Health / Repository health (push) Has been cancelled Details Joomla: Extension CI / Tests (PHP 8.2) (pull_request) Has been cancelled Details Joomla: Extension CI / Tests (PHP 8.3) (pull_request) Has been cancelled Details Joomla: Extension CI / PHPStan Analysis (pull_request) Has been cancelled Details Joomla: Extension CI / Build RC Pre-Release (pull_request) Has been cancelled Details Universal: PR Check / Build RC Package (pull_request) Has been cancelled Details Generic: Repo Health / Release configuration (pull_request) Has been cancelled Details Generic: Repo Health / Scripts governance (pull_request) Has been cancelled Details Generic: Repo Health / Repository health (pull_request) Has been cancelled Details - auto-bump: support dev/alpha/beta/rc/feature/* branches via CLI tool - auto-release: remove redundant sed strips, replace python3 with PHP - wiki: document branching model, version numbering, release channels Authored-by: Moko Consulting Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-05-29 04:51:00 -05:00