Merge pull request 'feat: skip pre-release auto-bump for non-Joomla repos (#304 )' (#307 ) from feature/304-semver-tags into dev

chore(version): auto-bump patch 09.38.02-dev [skip ci]
feat: skip pre-release auto-bump for non-Joomla repos (#304 )
2026-06-21 14:51:40 +00:00 · 2026-06-21 14:48:21 +00:00 · 2026-06-21 14:48:09 +00:00 · 2026-06-21 06:21:25 +00:00 · 2026-06-21 06:21:15 +00:00 · 2026-06-21 01:20:58 -05:00
39 changed files with 60 additions and 46 deletions
@@ -5,7 +5,7 @@
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: mokocli.Automation
-# VERSION: 09.37.07
+# VERSION: 09.38.02
 # BRIEF: Auto-create feature branch when an issue is opened

 name: "Universal: Issue Branch"
@@ -88,8 +88,20 @@ jobs:
          php ${MOKO_CLI}/platform_detect.php --path . --github-output 2>/dev/null || true
          php ${MOKO_CLI}/manifest_read.php --path . --github-output

+      - name: Check platform eligibility (Joomla only)
+        id: eligibility
+        run: |
+          PLATFORM="${{ steps.platform.outputs.platform }}"
+          if [[ "$PLATFORM" == joomla* ]] || [[ "$PLATFORM" == "joomla" ]]; then
+            echo "proceed=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "proceed=false" >> "$GITHUB_OUTPUT"
+            echo "::notice::Platform '$PLATFORM' — non-Joomla, skipping pre-release auto-bump"
+          fi
+
      - name: Resolve metadata and bump version
        id: meta
+        if: steps.eligibility.outputs.proceed == 'true'
        run: |
          # Auto-detect stability from branch name on push, or use input on dispatch
          if [ "${{ github.event_name }}" = "push" ]; then
@@ -166,6 +178,7 @@ jobs:

      - name: Create release
        id: release
+        if: steps.eligibility.outputs.proceed == 'true'
        run: |
          TAG="${{ steps.meta.outputs.tag }}"
          VERSION="${{ steps.meta.outputs.version }}"
@@ -176,6 +189,7 @@ jobs:
            --repo "${GITEA_REPO}" --branch "${{ github.ref_name }}" --prerelease

      - name: Update release notes from CHANGELOG.md
+        if: steps.eligibility.outputs.proceed == 'true'
        run: |
          TAG="${{ steps.meta.outputs.tag }}"
          VERSION="${{ steps.meta.outputs.version }}"
@@ -212,6 +226,7 @@ jobs:

      - name: Build package and upload
        id: package
+        if: steps.eligibility.outputs.proceed == 'true'
        run: |
          VERSION="${{ steps.meta.outputs.version }}"
          TAG="${{ steps.meta.outputs.tag }}"
@@ -225,6 +240,7 @@ jobs:
      # No need to build, commit, or sync updates.xml from workflows

      - name: "Delete lesser pre-release channels (cascade)"
+        if: steps.eligibility.outputs.proceed == 'true'
        continue-on-error: true
        run: |
          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
@@ -6,7 +6,7 @@ DEFGROUP: MokoPlatform.Root
 INGROUP: MokoPlatform
 REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 PATH: /README.md
-VERSION: 09.37.07
+VERSION: 09.38.02
 BRIEF: Project overview and documentation
 -->

@@ -13,7 +13,7 @@
 * INGROUP: MokoPlatform.Scripts
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/update_dependencies.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Cross-repo dependency update automation — scan, update, PR, auto-merge
 */

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

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

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

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

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

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

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

@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/joomla_build.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Build a Joomla extension ZIP from manifest — all types supported
 * NOTE: Called by pre-release and auto-release workflows.
 */
@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/joomla_metadata_validate.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Validate MokoGitea repo metadata against Joomla extension manifest XML
 */

@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_detect.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Auto-detect manifest fields from source files and optionally push to API
 */

@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_integrity.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Cross-check manifest API fields against repo contents across the org
 */

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

@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_read.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Read repo metadata from Gitea manifest API, auto-detect the rest
 */

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

@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_cascade.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Cascade release zip to all lower stability channels
 */

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

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

@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/updates_xml_sync.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * 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
@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/version_auto_bump.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Auto patch-bump, set stability suffix, and commit — single CLI replacing inline workflow bash
 */

@@ -124,19 +124,17 @@ class VersionBumpCli extends CliFramework
            $minVersion = preg_replace('/-(?:dev|alpha|beta|rc)$/', '', $minVersion);
            if (preg_match('/^\d{2}\.\d{2}\.\d{2}$/', $minVersion)) {
                if ($baseVersion === null || version_compare($minVersion, $baseVersion, '>')) {
-                    $this->log('INFO', "Using --min-version {$minVersion} (higher than manifest {$baseVersion})");
+                    $this->log('INFO', "Using --min-version {$minVersion} (higher than manifest " . ($baseVersion ?? '(none)') . ")");
                    $baseVersion = $minVersion;
                }
            }
        }

        // Auto-detect: scan git tags for higher versions from other channels
-        if ($baseVersion !== null) {
-            $gitTagVersion = $this->getHighestGitTagVersion($root);
-            if ($gitTagVersion !== null && version_compare($gitTagVersion, $baseVersion, '>')) {
-                $this->log('INFO', "Git tag version {$gitTagVersion} is higher than manifest {$baseVersion} — using as base");
-                $baseVersion = $gitTagVersion;
-            }
+        $gitTagVersion = $this->getHighestGitTagVersion($root);
+        if ($gitTagVersion !== null && ($baseVersion === null || version_compare($gitTagVersion, $baseVersion, '>'))) {
+            $this->log('INFO', "Git tag version {$gitTagVersion} is higher than manifest " . ($baseVersion ?? '(none)') . " — using as base");
+            $baseVersion = $gitTagVersion;
        }

        if ($baseVersion === null) {
@@ -370,7 +368,7 @@ class VersionBumpCli extends CliFramework
    /**
     * Scan git release tags for the highest version across all channels.
     *
-     * Checks release names like "MokoSuiteClient (VERSION: 09.37.07)" in
+     * Checks release names like "MokoSuiteClient (VERSION: 09.38.02)" in
     * git tags (stable, release-candidate, development, etc.) to find the
     * highest version that has been released on any channel.
     */
@@ -10,7 +10,7 @@
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/version_check.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Validate version consistency across README, manifests, and sub-packages
 */

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

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

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

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

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

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

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

@@ -14,7 +14,7 @@
 	DEFGROUP: dolibarr-api-mcp.Documentation
 	INGROUP: dolibarr-api-mcp
 	REPO: https://git.mokoconsulting.tech/MokoConsulting/dolibarr-api-mcp
-	VERSION: 09.37.07
+	VERSION: 09.38.02
 	PATH: ./CONTRIBUTING.md
 	BRIEF: Contribution guidelines for the project
 -->
@@ -10,7 +10,7 @@ DEFGROUP: dolibarr-api-mcp.Documentation
 INGROUP: dolibarr-api-mcp
 REPO: https://git.mokoconsulting.tech/MokoConsulting/dolibarr-api-mcp
 PATH: /SECURITY.md
-VERSION: 09.37.07
+VERSION: 09.38.02
 BRIEF: Security vulnerability reporting and handling policy
 -->

@@ -14,7 +14,7 @@
 	DEFGROUP: 
 	INGROUP: Project.Documentation
 	REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCli-Template-Generic
-	VERSION: 09.37.07
+	VERSION: 09.38.02
 	PATH: ./CONTRIBUTING.md
 	BRIEF: Contribution guidelines for the project
 -->
@@ -23,7 +23,7 @@ DEFGROUP: [PROJECT_NAME]
 INGROUP: [PROJECT_NAME].Documentation
 REPO: [REPOSITORY_URL]
 PATH: /SECURITY.md
-VERSION: 09.37.07
+VERSION: 09.38.02
 BRIEF: Security vulnerability reporting and handling policy
 -->

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

        $this->execute();
@@ -34,7 +34,7 @@ class VersionReadTest extends TestCase
    {
        file_put_contents(
            "{$this->tmpDir}/README.md",
-            "# Test\n<!-- VERSION: 09.37.07 -->\n"
+            "# Test\n<!-- VERSION: 09.38.02 -->\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.37.07 -->\n"
+            "<!-- VERSION: 09.38.02 -->\n"
        );
        mkdir("{$this->tmpDir}/src", 0755, true);
        file_put_contents(
@@ -12,7 +12,7 @@
 * INGROUP: MokoPlatform
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /validate/check_file_integrity.php
- * VERSION: 09.37.07
+ * VERSION: 09.38.02
 * BRIEF: Compare deployed files on a remote server against the local repository to detect drift
 */
Author	SHA1	Message	Date
jmiller	8a6f476957	Merge pull request 'feat: skip pre-release auto-bump for non-Joomla repos (#304 )' (#307 ) from feature/304-semver-tags into dev Platform: mokocli CI / Gate 2: Unit Tests (8.1) (push) Blocked by required conditions Details Platform: mokocli CI / Gate 2: Unit Tests (8.2) (push) Blocked by required conditions Details Platform: mokocli CI / Gate 2: Unit Tests (8.3) (push) Blocked by required conditions Details Platform: mokocli CI / Gate 3: Self-Health Check (push) Blocked by required conditions Details Platform: mokocli CI / Gate 4: Governance (push) Blocked by required conditions Details Platform: mokocli CI / Gate 5: Template Integrity (push) Blocked by required conditions Details Platform: mokocli CI / CI Summary (push) Blocked by required conditions Details Universal: Sync Feature Branch Versions / Sync feature branches with dev (push) Has been skipped Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 10s Details Platform: mokocli CI / Gate 1: Code Quality (push) Failing after 41s Details Universal: Auto Version Bump / Version Bump (push) Has been skipped Details	2026-06-21 14:51:40 +00:00
gitea-actions[bot]	7083ad9f9b	chore(version): auto-bump patch 09.38.02-dev [skip ci] Branch Cleanup / Delete merged branch (pull_request) Successful in 1s Details RC Revert / Rename rc/ back to dev/ (pull_request) Has been skipped Details	2026-06-21 14:48:21 +00:00
jmiller	660f6caaa2	feat: skip pre-release auto-bump for non-Joomla repos (#304 ) Universal: Auto Version Bump / Version Bump (push) Successful in 9s Details	2026-06-21 14:48:09 +00:00
gitea-actions[bot]	8fef6a3ce7	chore(version): pre-release bump to 09.38.01-dev [skip ci] Publish to Composer / Publish Package (release) Successful in 26s Details	2026-06-21 06:21:25 +00:00
gitea-actions[bot]	e678f31817	chore(version): auto-bump patch 09.37.08-dev [skip ci]	2026-06-21 06:21:15 +00:00
Jonathan Miller	3ef651e34d	fix(version-bump): always run git tag scan, fix null log interpolation Platform: mokocli CI / Gate 2: Unit Tests (8.1) (push) Blocked by required conditions Details Platform: mokocli CI / Gate 2: Unit Tests (8.2) (push) Blocked by required conditions Details Platform: mokocli CI / Gate 2: Unit Tests (8.3) (push) Blocked by required conditions Details Platform: mokocli CI / Gate 3: Self-Health Check (push) Blocked by required conditions Details Platform: mokocli CI / Gate 4: Governance (push) Blocked by required conditions Details Platform: mokocli CI / Gate 5: Template Integrity (push) Blocked by required conditions Details Platform: mokocli CI / CI Summary (push) Blocked by required conditions Details Universal: Sync Feature Branch Versions / Sync feature branches with dev (push) Has been skipped Details Universal: Auto Version Bump / Version Bump (push) Successful in 9s Details Universal: Pre-Release / Build Pre-Release (${{ inputs.stability \|\| github.ref_name }}) (push) Successful in 12s Details Platform: mokocli CI / Gate 1: Code Quality (push) Failing after 38s Details	2026-06-21 01:20:58 -05:00