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

chore: complete namespace cleanup — remove all mokoplatform/MokoStandards/MokoEnterprise refs
Sweep 391 files across templates, workflows, MCP servers, CLI tools, lib, deploy, validate, wrappers, configs, and docs. All references to mokoplatform, moko-platform, MokoStandards, MokoStandards-API, and MokoEnterprise replaced with mokocli/MokoCli. Also renamed moko-platform.sublime-project → mokocli.sublime-project and fixed composer.json description.
2026-06-21 05:43:23 +00:00 · 2026-06-21 00:43:06 -05:00 · 2026-06-21 05:28:23 +00:00 · 2026-06-21 05:28:19 +00:00 · 2026-06-21 05:25:42 +00:00 · 2026-06-21 05:25:14 +00:00
798 changed files with 8640 additions and 45958 deletions
@@ -0,0 +1,12 @@
 [submodule "templates/repos/Template-Client"]
 	path = templates/repos/Template-Client
 	url = https://git.mokoconsulting.tech/MokoConsulting/Template-Client.git
 [submodule "templates/repos/Template-Generic"]
 	path = templates/repos/Template-Generic
 	url = https://git.mokoconsulting.tech/MokoConsulting/Template-Generic.git
 [submodule "templates/repos/Template-Joomla"]
 	path = templates/repos/Template-Joomla
 	url = https://git.mokoconsulting.tech/MokoConsulting/Template-Joomla.git
 [submodule "templates/repos/Template-MCP"]
 	path = templates/repos/Template-MCP
 	url = https://git.mokoconsulting.tech/MokoConsulting/Template-MCP.git
@@ -1,4 +1,4 @@
-# mokoplatform
+# mokocli
 Enterprise automation, validation, sync, and governance engine for all Moko Consulting repositories.
@@ -9,7 +9,7 @@ Enterprise automation, validation, sync, and governance engine for all Moko Cons
 | **Language** | PHP 8.1+ |
 | **Version** | 09.01.00 |
 | **Branch** | develop on `dev`, merge to `main` (protected) |
-| **Wiki** | [mokoplatform Wiki](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/wiki) |
+| **Wiki** | [mokocli Wiki](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki) |
 ## Commands
@@ -44,7 +44,7 @@ composer check                           # Run all checks
 ### CLI Framework
-All CLI tools extend `MokoEnterprise\CliFramework` (`lib/Enterprise/CliFramework.php`).
+All CLI tools extend `MokoCli\CliFramework` (`lib/Enterprise/CliFramework.php`).
 Built-in flags: `--help`, `--verbose`, `--quiet`, `--dry-run`.
 After adding a CLI tool, register it in `bin/moko` COMMAND_MAP.
@@ -73,4 +73,4 @@ PHPStan runs with `--memory-limit=512M`. CI enforces PHPCS errors; PHPStan is `c
 - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`)
 - **Wiki**: documentation lives in the Gitea wiki, not `docs/` files
 - **New CLI tools**: extend `CliFramework`, not `CLIApp` (legacy)
- **Standards**: [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform/wiki/Home)
+- **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home)
@@ -7,8 +7,8 @@ contact_links:
  - name: 💬 Ask a Question
    url: https://mokoconsulting.tech/
    about: Get help or ask questions through our website
-  - name: 📚 mokoplatform Documentation
+  - name: 📚 mokocli Documentation
-    url: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+    url: https://git.mokoconsulting.tech/MokoConsulting/mokocli
    about: View our coding standards and best practices
  - name: 🔒 Report a Security Vulnerability
    url: https://git.mokoconsulting.tech/mokoconsulting-tech/.github-private/security/advisories/new
@@ -42,7 +42,7 @@ Suggested text here
 <!-- Add any other context, screenshots, or references -->
 ## Standards Alignment
- [ ] Follows mokoplatform documentation guidelines
+- [ ] Follows mokocli documentation guidelines
 - [ ] Uses en_US/en_GB localization
 - [ ] Includes proper SPDX headers where applicable
@@ -37,7 +37,7 @@ If you have ideas about how this could be implemented, share them here:
 Add any other context, mockups, or screenshots about the feature request here.
 ## Relevant Standards
-Does this relate to any standards in [mokoplatform](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform)?
+Does this relate to any standards in [mokocli](https://git.mokoconsulting.tech/MokoConsulting/mokocli)?
 - [ ] Accessibility (WCAG 2.1 AA)
 - [ ] Localization (en_US/en_GB)
 - [ ] Security best practices
@@ -35,7 +35,7 @@ Use this template only for:
 <!-- Describe how this could be addressed -->
 ## Standards Reference
-Does this relate to security standards in [mokoplatform](https://git.mokoconsulting.tech/MokoConsulting/mokoplatform)?
+Does this relate to security standards in [mokocli](https://git.mokoconsulting.tech/MokoConsulting/mokocli)?
 - [ ] SPDX license identifiers
 - [ ] Secret management
 - [ ] Dependency security
@@ -2,8 +2,8 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Automation
+# INGROUP: mokocli.Automation
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.gitea/workflows/branch-protection.yml
 # BRIEF: Apply standardised branch protection rules to all governed repositories
 #
@@ -57,13 +57,13 @@ jobs:
      - name: Determine target repos
        id: repos
        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
        run: |
          API="${GITEA_URL}/api/v1"
          # Platform/standards/infra repos to exclude
-          EXCLUDE="gitea-org-config org-profile gitea-private .mokogitea-private mokoplatform MokoTesting"
+          EXCLUDE="gitea-org-config org-profile gitea-private .mokogitea-private mokocli MokoTesting"
-          EXCLUDE="$EXCLUDE MokoStandards-Template-Client MokoStandards-Template-Dolibarr MokoStandards-Template-Generic MokoStandards-Template-Joomla MokoDoliProjTemplate"
+          EXCLUDE="$EXCLUDE MokoCli-Template-Client MokoCli-Template-Dolibarr MokoCli-Template-Generic MokoCli-Template-Joomla MokoDoliProjTemplate"
          if [ -n "${{ inputs.repos }}" ]; then
            # User-specified repos
@@ -105,7 +105,7 @@ jobs:
      - name: Apply protection rules
        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
          DRY_RUN: ${{ inputs.dry_run || 'false' }}
        run: |
          API="${GITEA_URL}/api/v1"
@@ -2,8 +2,8 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Automation
+# INGROUP: mokocli.Automation
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.gitea/workflows/bulk-repo-sync.yml
 # BRIEF: Bulk repo sync — runs from API repo, syncs standards to all governed repos
@@ -84,8 +84,8 @@ jobs:
          echo "Running: php automation/bulk_sync.php ${{ steps.args.outputs.args }}"
          php automation/bulk_sync.php ${{ steps.args.outputs.args }} 2>&1 | tee /tmp/bulk_sync.log
        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
-          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          GH_TOKEN: ${{ secrets.GH_PAT }}
          GIT_PLATFORM: gitea
          GITEA_URL: https://git.mokoconsulting.tech
          GITEA_ORG: MokoConsulting
@@ -112,7 +112,7 @@ jobs:
            bash automation/enforce_tags.sh || echo "Tag enforcement had errors (non-fatal)"
          fi
        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
          GITEA_URL: https://git.mokoconsulting.tech
          GITEA_ORG: MokoConsulting
@@ -2,9 +2,9 @@
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
-# DEFGROUP: mokoplatform.CI
+# DEFGROUP: mokocli.CI
-# INGROUP: mokoplatform
+# INGROUP: mokocli
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.gitea/workflows/pr-branch-check.yml
 # BRIEF: PR branch merge policy enforcement
 #
@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Automation
+# INGROUP: mokocli.Automation
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.gitea/workflows/renovate.yml
 # BRIEF: Run Renovate Bot across all governed repos for dependency updates
 #
@@ -57,12 +57,12 @@ jobs:
      - name: Determine target repos
        id: repos
        env:
-          GA_TOKEN: ${{ secrets.GA_TOKEN }}
+          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
        run: |
          API="${GITEA_URL}/api/v1"
-          EXCLUDE="gitea-org-config org-profile gitea-private .mokogitea-private mokoplatform MokoTesting"
+          EXCLUDE="gitea-org-config org-profile gitea-private .mokogitea-private mokocli MokoTesting"
-          EXCLUDE="$EXCLUDE MokoStandards-Template-Client MokoStandards-Template-Dolibarr MokoStandards-Template-Generic MokoStandards-Template-Joomla MokoDoliProjTemplate"
+          EXCLUDE="$EXCLUDE MokoCli-Template-Client MokoCli-Template-Dolibarr MokoCli-Template-Generic MokoCli-Template-Joomla MokoDoliProjTemplate"
          if [ -n "${{ inputs.repos }}" ]; then
            REPOS=$(echo "${{ inputs.repos }}" | tr ',' ' ')
@@ -107,7 +107,7 @@ jobs:
      - name: Run Renovate
        if: steps.repos.outputs.repo_list != ''
        env:
-          RENOVATE_TOKEN: ${{ secrets.GA_TOKEN }}
+          RENOVATE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
          RENOVATE_PLATFORM: gitea
          RENOVATE_ENDPOINT: ${{ env.GITEA_URL }}/api/v1
          RENOVATE_GIT_AUTHOR: 'Renovate Bot <renovate@mokoconsulting.tech>'
@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Maintenance
+# INGROUP: mokocli.Maintenance
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.gitea/workflows/sync-wikis.yml
 # BRIEF: Daily sync of all Gitea wikis to consolidated GitHub wiki repo
@@ -31,7 +31,7 @@ jobs:
      - name: Sync all wikis
        env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+          GH_TOKEN: ${{ secrets.GH_PAT }}
          GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
        run: |
          if [ -z "$GH_TOKEN" ]; then
@@ -1,68 +1,66 @@
-# 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: mokoplatform.Release
+# INGROUP: mokocli.Release
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
-# PATH: /.mokogitea/workflows/auto-bump.yml
+# PATH: /.mokogitea/workflows/auto-bump.yml
-# VERSION: 09.23.00
+# VERSION: 09.02.00
-# BRIEF: Auto patch-bump version on every push to dev (skips merge commits)
+# BRIEF: Auto patch-bump version on every push to dev (skips merge commits)
-
+
-name: "Universal: Auto Version Bump"
+name: "Universal: Auto Version Bump"
-
+
-on:
+on:
-  push:
+  push:
-    branches:
+    branches:
-      - dev
+      - dev
-      - rc
+      - rc
-      - 'feature/**'
+      - 'feature/**'
-      - 'patch/**'
+      - 'patch/**'
-
+
-env:
+env:
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
-  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
+  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
-
+
-permissions:
+permissions:
-  contents: write
+  contents: write
-
+
-jobs:
+jobs:
-  bump:
+  bump:
-    name: Version Bump
+    name: Version Bump
-    runs-on: release
+    runs-on: release
-    if: >-
+    if: >-
-      !contains(github.event.head_commit.message, '[skip ci]') &&
+      !contains(github.event.head_commit.message, '[skip ci]') &&
-      !contains(github.event.head_commit.message, '[skip bump]') &&
+      !contains(github.event.head_commit.message, '[skip bump]') &&
-      !startsWith(github.event.head_commit.message, 'Merge pull request')
+      !startsWith(github.event.head_commit.message, 'Merge pull request')
-
+
-    steps:
+    steps:
-      - name: Checkout
+      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-        with:
+        with:
-          token: ${{ secrets.MOKOGITEA_TOKEN }}
+          token: ${{ secrets.MOKOGITEA_TOKEN }}
-          fetch-depth: 1
+          fetch-depth: 1
-
+
-      - name: Setup mokoplatform tools
+      - name: Setup mokocli tools
-        run: |
+        run: |
-          if [ -f "/opt/mokoplatform/cli/version_bump.php" ] && [ -f "/opt/mokoplatform/vendor/autoload.php" ]; then
+          if ! command -v composer &> /dev/null; then
-            echo "Using pre-installed /opt/mokoplatform"
+            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 "MOKO_CLI=/opt/mokoplatform/cli" >> "$GITHUB_ENV"
+          fi
-          else
+          if [ -d "/opt/mokocli/cli" ]; then
-            if ! command -v composer &> /dev/null; then
+            echo "MOKO_CLI=/opt/mokocli/cli" >> "$GITHUB_ENV"
-              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
+          else
-            fi
+            git clone --depth 1 --branch main --quiet \
-            rm -rf /tmp/mokoplatform-api
+              "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/MokoConsulting/mokocli.git" \
-            git clone --depth 1 --branch main --quiet \
+              /tmp/mokocli
-              "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/MokoConsulting/mokoplatform.git" \
+            cd /tmp/mokocli && composer install --no-dev --no-interaction --quiet
-              /tmp/mokoplatform-api
+            echo "MOKO_CLI=/tmp/mokocli/cli" >> "$GITHUB_ENV"
-            cd /tmp/mokoplatform-api && composer install --no-dev --no-interaction --quiet
+          fi
-            echo "MOKO_CLI=/tmp/mokoplatform-api/cli" >> "$GITHUB_ENV"
+
-          fi
+      - name: Bump version
-
+        run: |
-      - name: Bump version
+          php ${MOKO_CLI}/version_auto_bump.php \
-        run: |
+            --path . --branch "${GITHUB_REF_NAME}" \
-          php ${MOKO_CLI}/version_auto_bump.php \
+            --token "${{ secrets.MOKOGITEA_TOKEN }}" \
-            --path . --branch "${GITHUB_REF_NAME}" \
+            --repo-url "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
            --token "${{ secrets.MOKOGITEA_TOKEN }}" \
            --repo-url "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Release
+# INGROUP: mokocli.Release
-# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokoplatform
+# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokocli
 # PATH: /templates/workflows/universal/auto-release.yml.template
 # VERSION: 05.00.00
 # BRIEF: Universal build & release � detects platform from manifest.xml
@@ -66,25 +66,25 @@ jobs:
          token: ${{ secrets.MOKOGITEA_TOKEN }}
          fetch-depth: 1
-      - name: Setup mokoplatform tools
+      - name: Setup mokocli tools
        env:
          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
        run: |
-          if [ -f /opt/mokoplatform/cli/version_bump.php ] && [ -f /opt/mokoplatform/vendor/autoload.php ]; then
+          if [ -f /opt/mokocli/cli/version_bump.php ] && [ -f /opt/mokocli/vendor/autoload.php ]; then
-            echo Using pre-installed /opt/mokoplatform
+            echo Using pre-installed /opt/mokocli
-            echo MOKO_CLI=/opt/mokoplatform/cli >> $GITHUB_ENV
+            echo MOKO_CLI=/opt/mokocli/cli >> $GITHUB_ENV
          else
            echo Falling back to fresh clone
            if ! command -v composer > /dev/null 2>&1; then
              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
            fi
-            rm -rf /tmp/mokoplatform-api
+            rm -rf /tmp/mokocli
-            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokoplatform.git
+            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokocli.git
-            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/mokoplatform-api
+            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/mokocli
-            cd /tmp/mokoplatform-api
+            cd /tmp/mokocli
            composer install --no-dev --no-interaction --quiet
-            echo MOKO_CLI=/tmp/mokoplatform-api/cli >> $GITHUB_ENV
+            echo MOKO_CLI=/tmp/mokocli/cli >> $GITHUB_ENV
          fi
      - name: Rename branch to rc
@@ -109,6 +109,40 @@ jobs:
            --path . --stability rc --bump minor --branch rc \
            --token "${{ secrets.MOKOGITEA_TOKEN }}"
      - name: Update RC release notes from CHANGELOG.md
        run: |
          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
          # Extract [Unreleased] section from changelog
          NOTES=""
          if [ -f "CHANGELOG.md" ]; then
            NOTES=$(awk '/^## \[Unreleased\]/{found=1; next} /^## \[/{if(found) exit} found{print}' CHANGELOG.md)
          fi
          [ -z "$NOTES" ] && NOTES="Release candidate"
          # Find the RC release and update its body
          RELEASE_ID=$(curl -sf -H "Authorization: token ${TOKEN}" \
            "${API_BASE}/releases/tags/release-candidate" \
            | python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" 2>/dev/null || true)
          if [ -n "$RELEASE_ID" ]; then
            python3 -c "
          import json, urllib.request
          body = open('/dev/stdin').read()
          payload = json.dumps({'body': body}).encode()
          req = urllib.request.Request(
              '${API_BASE}/releases/${RELEASE_ID}',
              data=payload, method='PATCH',
              headers={
                  'Authorization': 'token ${TOKEN}',
                  'Content-Type': 'application/json'
              })
          urllib.request.urlopen(req)
          " <<< "$NOTES"
            echo "RC release notes updated from CHANGELOG.md"
          fi
      - name: Summary
        if: always()
        run: |
@@ -149,50 +183,95 @@ jobs:
          fi
          echo "No conflict markers found"
-      - name: Setup mokoplatform tools
+      - name: Setup mokocli tools
        env:
          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_MIRROR_TOKEN }}"}}'
        run: |
-          if [ -f /opt/mokoplatform/cli/version_bump.php ] && [ -f /opt/mokoplatform/vendor/autoload.php ]; then
+          if [ -f /opt/mokocli/cli/version_bump.php ] && [ -f /opt/mokocli/vendor/autoload.php ]; then
-            echo Using pre-installed /opt/mokoplatform
+            echo Using pre-installed /opt/mokocli
-            echo MOKO_CLI=/opt/mokoplatform/cli >> $GITHUB_ENV
+            echo MOKO_CLI=/opt/mokocli/cli >> $GITHUB_ENV
          else
            echo Falling back to fresh clone
            if ! command -v composer > /dev/null 2>&1; then
              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
            fi
-            rm -rf /tmp/mokoplatform-api
+            rm -rf /tmp/mokocli
-            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokoplatform.git
+            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokocli.git
-            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/mokoplatform-api
+            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/mokocli
-            cd /tmp/mokoplatform-api
+            cd /tmp/mokocli
            composer install --no-dev --no-interaction --quiet
-            echo MOKO_CLI=/tmp/mokoplatform-api/cli >> $GITHUB_ENV
+            echo MOKO_CLI=/tmp/mokocli/cli >> $GITHUB_ENV
          fi
      - name: "Detect platform"
        id: platform
        run: |
          php ${MOKO_CLI}/platform_detect.php --path . --github-output 2>/dev/null || true
          php ${MOKO_CLI}/manifest_read.php --path . --github-output 2>/dev/null || true
      - name: "Determine version bump level"
        id: bump
        run: |
          # Fix/patch branches: version was already bumped by pre-release, just strip suffix
          # Feature/dev branches: bump minor for the new stable release
          HEAD_REF="${{ github.event.pull_request.head.ref || 'dev' }}"
          case "$HEAD_REF" in
            fix/*|patch/*|hotfix/*|bugfix/*) BUMP="none" ;;
            *)                               BUMP="minor" ;;
          esac
          echo "level=${BUMP}" >> "$GITHUB_OUTPUT"
          echo "Bump level: ${BUMP} (from branch: ${HEAD_REF})"
      - name: "Publish stable release"
        run: |
          BUMP_FLAG=""
          if [ "${{ steps.bump.outputs.level }}" != "none" ]; then
            BUMP_FLAG="--bump ${{ steps.bump.outputs.level }}"
          fi
          php ${MOKO_CLI}/release_publish.php \
-            --path . --stability stable --bump minor --branch main \
+            --path . --stability stable ${BUMP_FLAG} --branch main \
            --token "${{ secrets.MOKOGITEA_TOKEN }}"
-      - name: Update release notes from CHANGELOG.md
+      - name: "Read published version"
        id: version
        run: |
          VERSION=$(php ${MOKO_CLI}/version_read.php --path . 2>/dev/null || echo "")
          VERSION=$(echo "$VERSION" | sed 's/-\(dev\|alpha\|beta\|rc\)$//')
          [ -z "$VERSION" ] && VERSION="00.00.00" && echo "skip=true" >> "$GITHUB_OUTPUT"
          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
          echo "tag=stable" >> "$GITHUB_OUTPUT"
          echo "release_tag=stable" >> "$GITHUB_OUTPUT"
          echo "branch=main" >> "$GITHUB_OUTPUT"
          echo "Published version: ${VERSION}"
      - name: Update release notes and promote changelog
        run: |
          API_BASE="${GITEA_URL}/api/v1/repos/${GITEA_ORG}/${GITEA_REPO}"
          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
          # Get the stable release info (version and ID)
          RELEASE_JSON=$(curl -sf -H "Authorization: token ${TOKEN}" \
            "${API_BASE}/releases/tags/stable" 2>/dev/null || echo '{}')
          RELEASE_ID=$(python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" <<< "$RELEASE_JSON" 2>/dev/null || true)
          # Extract version from release name (e.g. "06.17.00" or "v06.17.00")
          VERSION=$(python3 -c "
          import json, sys, re
          r = json.load(sys.stdin)
          name = r.get('name', '')
          m = re.search(r'(\d+\.\d+\.\d+)', name)
          print(m.group(1) if m else '')
          " <<< "$RELEASE_JSON" 2>/dev/null || true)
          # Extract [Unreleased] section from changelog
          NOTES=""
          if [ -f "CHANGELOG.md" ]; then
            NOTES=$(awk '/^## \[Unreleased\]/{found=1; next} /^## \[/{if(found) exit} found{print}' CHANGELOG.md)
            [ -z "$NOTES" ] && NOTES="Stable release"
          else
            NOTES="Stable release"
          fi
          [ -z "$NOTES" ] && NOTES="Stable release"
          # Update release body via API
          RELEASE_ID=$(curl -sf -H "Authorization: token ${{ secrets.MOKOGITEA_TOKEN }}" \
            "${API_BASE}/releases/tags/stable" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" 2>/dev/null || true)
          if [ -n "$RELEASE_ID" ]; then
            python3 -c "
          import json, urllib.request
@@ -202,7 +281,7 @@ jobs:
              '${API_BASE}/releases/${RELEASE_ID}',
              data=payload, method='PATCH',
              headers={
-                  'Authorization': 'token ${{ secrets.MOKOGITEA_TOKEN }}',
+                  'Authorization': 'token ${TOKEN}',
                  'Content-Type': 'application/json'
              })
          urllib.request.urlopen(req)
@@ -210,6 +289,24 @@ jobs:
            echo "Release notes updated from CHANGELOG.md"
          fi
          # Promote [Unreleased] → [version] in CHANGELOG.md and reset
          if [ -n "$VERSION" ] && [ -f "CHANGELOG.md" ]; then
            DATE=$(date +%Y-%m-%d)
            python3 -c "
          import sys
          version, date = sys.argv[1], sys.argv[2]
          content = open('CHANGELOG.md').read()
          old = '## [Unreleased]'
          new = f'## [Unreleased]\n\n## [{version}] --- {date}'
          content = content.replace(old, new, 1)
          open('CHANGELOG.md', 'w').write(content)
          " "$VERSION" "$DATE"
            git add CHANGELOG.md
            git commit -m "chore: promote changelog [Unreleased] → [${VERSION}]" || true
            git push origin main || true
            echo "Changelog promoted: [Unreleased] → [${VERSION}]"
          fi
      # -- STEP 9: Mirror to GitHub (stable only) --------------------------------
      - name: "Step 9: Mirror release to GitHub"
        if: >-
@@ -4,10 +4,10 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoPlatform.Universal
+# INGROUP: MokoCli.Universal
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.mokogitea/workflows/branch-cleanup.yml
-# VERSION: 09.23.00
+# VERSION: 01.00.00
 # BRIEF: Delete feature branches after PR merge
 name: "Branch Cleanup"
@@ -4,7 +4,7 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.CI
+# INGROUP: MokoCli.CI
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
 # PATH: /.gitea/workflows/ci-generic.yml
 # VERSION: 01.00.00
@@ -13,19 +13,6 @@
 name: "Generic: Project CI"
 on:
  push:
    branches:
      - main
      - dev
      - dev/**
      - rc/**
      - version/**
  pull_request:
    branches:
      - main
      - dev
      - dev/**
      - rc/**
  workflow_dispatch:
 permissions:
@@ -4,18 +4,18 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.CI
+# INGROUP: mokocli.CI
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.mokogitea/workflows/ci-platform.yml
 # VERSION: 09.23.00
-# BRIEF: mokoplatform CI — the standards engine validates itself
+# BRIEF: mokocli CI — the standards engine validates itself
 #
 # +========================================================================+
 # |                  MOKO-PLATFORM CI                             |
 # +========================================================================+
 # |                                                                        |
 # |  This is NOT a generic CI workflow. This is the self-validation        |
-# |  pipeline for the central mokoplatform enterprise engine.           |
+# |  pipeline for the central mokocli enterprise engine.           |
 # |                                                                        |
 # |  It dogfoods every tool the platform ships to governed repos:          |
 # |                                                                        |
@@ -29,7 +29,7 @@
 # |                                                                        |
 # +========================================================================+
-name: "Platform: mokoplatform CI"
+name: "Platform: mokocli CI"
 on:
  push:
@@ -421,7 +421,7 @@ jobs:
      - name: Check gate results
        run: |
          {
-            echo "# mokoplatform CI"
+            echo "# mokocli CI"
            echo ""
            echo "| Gate | Job | Status |"
            echo "|---|---|---|"
@@ -4,10 +4,10 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Maintenance
+# INGROUP: MokoCli.Maintenance
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCli
-# PATH: /.mokogitea/workflows/cleanup.yml
+# PATH: /.gitea/workflows/cleanup.yml
-# VERSION: 09.23.00
+# VERSION: 01.00.00
 # BRIEF: Scheduled cleanup — delete merged branches and old workflow runs
 name: "Universal: Repository Cleanup"
@@ -33,17 +33,17 @@ jobs:
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
-          token: ${{ secrets.MOKOGITEA_TOKEN }}
+          token: ${{ secrets.GA_TOKEN }}
      - name: Delete merged branches
        env:
-          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
+          GA_TOKEN: ${{ secrets.GA_TOKEN }}
        run: |
          echo "=== Merged Branch Cleanup ==="
          API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
          # List branches via API
-          BRANCHES=$(curl -sS -H "Authorization: token ${GITEA_TOKEN}" \
+          BRANCHES=$(curl -sS -H "Authorization: token ${GA_TOKEN}" \
            "${API}/branches?limit=50" | jq -r '.[].name')
          DELETED=0
@@ -56,7 +56,7 @@ jobs:
            # Check if branch is merged into main
            if git merge-base --is-ancestor "origin/${BRANCH}" origin/main 2>/dev/null; then
              echo "  Deleting merged branch: ${BRANCH}"
-              curl -sS -X DELETE -H "Authorization: token ${GITEA_TOKEN}" \
+              curl -sS -X DELETE -H "Authorization: token ${GA_TOKEN}" \
                "${API}/branches/${BRANCH}" 2>/dev/null || true
              DELETED=$((DELETED + 1))
            fi
@@ -66,20 +66,20 @@ jobs:
      - name: Clean old workflow runs
        env:
-          GA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
+          GA_TOKEN: ${{ secrets.GA_TOKEN }}
        run: |
          echo "=== Workflow Run Cleanup ==="
          API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
          CUTOFF=$(date -d "30 days ago" +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -v-30d +%Y-%m-%dT%H:%M:%SZ)
          # Get old completed runs
-          RUNS=$(curl -sS -H "Authorization: token ${GITEA_TOKEN}" \
+          RUNS=$(curl -sS -H "Authorization: token ${GA_TOKEN}" \
            "${API}/actions/runs?status=completed&limit=50" | \
            jq -r ".workflow_runs[] | select(.created_at < \"${CUTOFF}\") | .id" 2>/dev/null)
          DELETED=0
          for RUN_ID in $RUNS; do
-            curl -sS -X DELETE -H "Authorization: token ${GITEA_TOKEN}" \
+            curl -sS -X DELETE -H "Authorization: token ${GA_TOKEN}" \
              "${API}/actions/runs/${RUN_ID}" 2>/dev/null || true
            DELETED=$((DELETED + 1))
          done
@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoStandards.Deploy
+# INGROUP: MokoCli.Deploy
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards-API
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /templates/workflows/joomla/deploy-manual.yml.template
 # VERSION: 04.07.00
 # BRIEF: Manual SFTP deploy to dev server for Joomla repos
@@ -40,7 +40,7 @@ jobs:
        run: |
          php -v && composer --version
-      - name: Setup MokoStandards tools
+      - name: Setup MokoCli tools
        env:
          GA_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
          MOKO_CLONE_TOKEN: ${{ secrets.GA_TOKEN || secrets.GA_TOKEN || github.token }}
@@ -48,7 +48,7 @@ jobs:
          COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GA_TOKEN || github.token }}"}}'
        run: |
          git clone --depth 1 --branch main --quiet \
-            "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/MokoStandards-API.git" \
+            "https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokocli.git" \
            /tmp/mokostandards-api 2>/dev/null || true
          if [ -d "/tmp/mokostandards-api" ] && [ -f "/tmp/mokostandards-api/composer.json" ]; then
            cd /tmp/mokostandards-api && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
@@ -4,10 +4,10 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Security
+# INGROUP: MokoCli.Security
-# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokoplatform
+# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokocli
 # PATH: /templates/workflows/gitleaks.yml.template
-# VERSION: 09.23.00
+# VERSION: 01.00.00
 # BRIEF: Secret scanning — detect leaked credentials, API keys, and tokens
 #
 # +========================================================================+
@@ -25,10 +25,6 @@
 name: "Universal: Secret Scanning"
 on:
  pull_request:
    branches:
      - main
      - 'dev/**'
  schedule:
    - cron: '0 5 * * 1'  # Weekly Monday 05:00 UTC
  workflow_dispatch:
@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Automation
+# INGROUP: mokocli.Automation
-# VERSION: 09.26.00
+# VERSION: 09.37.01
 # BRIEF: Auto-create feature branch when an issue is opened
 name: "Universal: Issue Branch"
@@ -28,7 +28,7 @@ jobs:
    steps:
      - name: Create branch and comment
        run: |
-          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
+          TOKEN="${{ secrets.GA_TOKEN }}"
          API="${GITEA_URL}/api/v1/repos/${{ github.repository }}"
          ISSUE_NUM="${{ github.event.issue.number }}"
          ISSUE_TITLE="${{ github.event.issue.title }}"
@@ -4,10 +4,10 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Notifications
+# INGROUP: MokoCli.Notifications
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCli
-# PATH: /.mokogitea/workflows/notify.yml
+# PATH: /.gitea/workflows/notify.yml
-# VERSION: 09.23.00
+# VERSION: 01.00.00
 # BRIEF: Push notifications via ntfy on release success or workflow failure
 name: "Universal: Notifications"
@@ -4,23 +4,26 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Release
+# INGROUP: mokocli.Release
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /templates/workflows/universal/pre-release.yml.template
 # 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"
 on:
-  pull_request:
+  push:
    types: [closed]
    branches:
      - dev
-  pull_request_target:
+      - 'fix/**'
-    types: [synchronize, opened, reopened]
+      - 'patch/**'
-    branches:
+      - 'hotfix/**'
-      - main
+      - 'bugfix/**'
      - 'chore/**'
      - alpha
      - beta
      - rc
  workflow_dispatch:
    inputs:
      stability:
@@ -43,12 +46,11 @@ env:
 jobs:
  build:
-    name: "Build Pre-Release (${{ inputs.stability || 'development' }})"
+    name: "Build Pre-Release (${{ inputs.stability || github.ref_name }})"
    runs-on: release
    if: >-
      github.event_name == 'workflow_dispatch' ||
-      (github.event_name == 'pull_request' && github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'dev') ||
+      github.event_name == 'push'
      (github.event_name == 'pull_request_target' && github.event.pull_request.base.ref == 'main')
    steps:
      - name: Checkout
@@ -56,40 +58,47 @@ jobs:
        with:
          fetch-depth: 0
          token: ${{ secrets.MOKOGITEA_TOKEN }}
-          ref: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.sha || '' }}
+          ref: ${{ github.ref_name }}
-      - name: Setup mokoplatform tools
+      - name: Setup mokocli tools
        env:
          MOKO_CLONE_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
          MOKO_CLONE_HOST: git.mokoconsulting.tech/MokoConsulting
        run: |
-          # Use pre-installed /opt/mokoplatform if available (updated by cron every 6h)
+          # Use pre-installed /opt/mokocli if available (updated by cron every 6h)
-          if [ -f /opt/mokoplatform/cli/version_bump.php ] && [ -f /opt/mokoplatform/cli/manifest_element.php ] && [ -f /opt/mokoplatform/vendor/autoload.php ]; then
+          if [ -f /opt/mokocli/cli/version_bump.php ] && [ -f /opt/mokocli/cli/manifest_element.php ] && [ -f /opt/mokocli/vendor/autoload.php ]; then
-            echo Using pre-installed /opt/mokoplatform
+            echo Using pre-installed /opt/mokocli
-            echo MOKO_CLI=/opt/mokoplatform/cli >> $GITHUB_ENV
+            echo MOKO_CLI=/opt/mokocli/cli >> $GITHUB_ENV
          else
            echo Falling back to fresh clone
            if ! command -v composer > /dev/null 2>&1; then
              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
            fi
-            rm -rf /tmp/mokoplatform-api
+            rm -rf /tmp/mokocli
-            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokoplatform.git
+            CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokocli.git
-            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/mokoplatform-api
+            git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/mokocli
-            cd /tmp/mokoplatform-api && composer install --no-dev --no-interaction --quiet
+            cd /tmp/mokocli && composer install --no-dev --no-interaction --quiet
-            echo MOKO_CLI=/tmp/mokoplatform-api/cli >> $GITHUB_ENV
+            echo MOKO_CLI=/tmp/mokocli/cli >> $GITHUB_ENV
          fi
      - name: Detect platform
        id: platform
        run: |
          # Auto-detect and update platform if not set in manifest
          php ${MOKO_CLI}/platform_detect.php --path . --github-output 2>/dev/null || true
          php ${MOKO_CLI}/manifest_read.php --path . --github-output
      - name: Resolve metadata and bump version
        id: meta
        run: |
-          # Auto-detect stability: RC for PRs targeting main, else use input or default to development
+          # Auto-detect stability from branch name on push, or use input on dispatch
-          if [ "${{ github.event_name }}" = "pull_request_target" ] && [ "${{ github.event.pull_request.base.ref }}" = "main" ]; then
+          if [ "${{ github.event_name }}" = "push" ]; then
-            STABILITY="release-candidate"
+            case "${{ github.ref_name }}" in
              rc)    STABILITY="release-candidate" ;;
              alpha) STABILITY="alpha" ;;
              beta)  STABILITY="beta" ;;
              *)     STABILITY="development" ;;
            esac
          else
            STABILITY="${{ inputs.stability || 'development' }}"
          fi
@@ -164,7 +173,7 @@ jobs:
          php ${MOKO_CLI}/release_create.php \
            --path . --version "$VERSION" --tag "$TAG" \
            --token "${{ secrets.MOKOGITEA_TOKEN }}" --api-base "$API_BASE" \
-            --repo "${GITEA_REPO}" --branch dev --prerelease
+            --repo "${GITEA_REPO}" --branch "${{ github.ref_name }}" --prerelease
      - name: Update release notes from CHANGELOG.md
        run: |
@@ -4,8 +4,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: MokoPlatform.Universal
+# INGROUP: mokocli.Universal
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.mokogitea/workflows/rc-revert.yml
 # VERSION: 09.23.00
 # BRIEF: Rename rc/ branch back to dev/ when PR is closed without merge
@@ -4,10 +4,10 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: mokoplatform.Security
+# INGROUP: MokoCli.Security
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoCli
-# PATH: /.mokogitea/workflows/security-audit.yml
+# PATH: /.gitea/workflows/security-audit.yml
-# VERSION: 09.23.00
+# VERSION: 01.00.00
 # BRIEF: Dependency vulnerability scanning for composer and npm packages
 name: "Universal: Security Audit"
@@ -80,19 +80,3 @@ jobs:
            -H "Priority: high" \
            -d "Security audit found vulnerabilities. Review dependency updates." \
            "${NTFY_URL}/${NTFY_TOPIC}" || true
      - name: Joomla version audit
        if: always()
        run: |
          if [ -f "monitoring/joomla-version-audit.php" ] && [ -n "$JOOMLA_SITES" ]; then
            echo "$JOOMLA_SITES" > /tmp/sites.json
            php monitoring/joomla-version-audit.php --sites /tmp/sites.json || true
            echo "### Joomla Version Audit" >> $GITHUB_STEP_SUMMARY
            rm -f /tmp/sites.json
          else
            echo "Joomla audit skipped (no script or JOOMLA_SITES_JSON not configured)"
          fi
        env:
          JOOMLA_SITES: ${{ vars.JOOMLA_SITES_JSON }}
@@ -0,0 +1,103 @@
 # Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: mokocli.Automation
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.mokogitea/workflows/sync-feature-versions.yml
 # VERSION: 01.00.00
 # BRIEF: Merge dev into open feature branches after version bumps
 name: "Universal: Sync Feature Branch Versions"
 on:
  push:
    branches:
      - dev
  workflow_dispatch:
 permissions:
  contents: write
 env:
  GITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
 jobs:
  sync:
    name: Sync feature branches with dev
    runs-on: ubuntu-latest
    if: >-
      github.event_name == 'workflow_dispatch' ||
      contains(github.event.head_commit.message, 'chore(version)')
    steps:
      - name: Checkout dev
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
          ref: dev
          token: ${{ secrets.MOKOGITEA_TOKEN }}
      - name: Configure git
        run: |
          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"
      - name: Merge dev into feature branches
        run: |
          echo "=== Syncing feature branches with dev ==="
          # Fetch all remote branches
          git fetch origin
          # Find feature branches (feature/*, fix/*, patch/*, hotfix/*, bugfix/*, chore/*)
          BRANCHES=$(git branch -r --list 'origin/feature/*' 'origin/fix/*' 'origin/patch/*' 'origin/hotfix/*' 'origin/bugfix/*' 'origin/chore/*' | sed 's|origin/||; s/^[[:space:]]*//')
          if [ -z "$BRANCHES" ]; then
            echo "No feature branches found — nothing to sync"
            exit 0
          fi
          SYNCED=0
          SKIPPED=0
          FAILED=0
          for BRANCH in $BRANCHES; do
            echo ""
            echo "--- ${BRANCH} ---"
            # Skip branches that are already up to date with dev
            if git merge-base --is-ancestor dev "origin/${BRANCH}" 2>/dev/null; then
              echo "Already up to date"
              SKIPPED=$((SKIPPED + 1))
              continue
            fi
            # Try to merge dev into the branch
            git checkout "origin/${BRANCH}" -B "$BRANCH" 2>/dev/null
            if git merge dev --no-edit -m "chore: merge dev into ${BRANCH} (version sync) [skip ci]" 2>/dev/null; then
              git push origin "$BRANCH" 2>/dev/null
              echo "Synced successfully"
              SYNCED=$((SYNCED + 1))
            else
              git merge --abort 2>/dev/null || true
              echo "Merge conflict — skipping (manual rebase needed)"
              FAILED=$((FAILED + 1))
            fi
          done
          # Return to dev
          git checkout dev 2>/dev/null || true
          echo ""
          echo "=== Summary ==="
          echo "Synced: ${SYNCED}"
          echo "Already current: ${SKIPPED}"
          echo "Conflicts (skipped): ${FAILED}"
          if [ "$FAILED" -gt 0 ]; then
            echo "::warning::${FAILED} branch(es) had merge conflicts and need manual rebase"
          fi
@@ -0,0 +1,73 @@
 # Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: mokocli.Universal
 # REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /.mokogitea/workflows/workflow-sync-trigger.yml
 # VERSION: 01.01.00
 # BRIEF: Trigger workflow sync to live repos when a PR is merged to main
 name: "Universal: Workflow Sync Trigger"
 on:
  pull_request:
    types: [closed]
    branches:
      - main
 env:
  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
 jobs:
  sync:
    name: Sync workflows to live repos
    runs-on: ubuntu-latest
    if: >-
      github.event.pull_request.merged == true &&
      !contains(github.event.pull_request.title, '[skip sync]')
    steps:
      - name: Determine platform from repo name
        id: platform
        run: |
          REPO="${{ github.event.repository.name }}"
          case "$REPO" in
            Template-Joomla)   PLATFORM="joomla" ;;
            Template-Dolibarr) PLATFORM="dolibarr" ;;
            Template-Go)       PLATFORM="go" ;;
            Template-MCP)      PLATFORM="mcp" ;;
            Template-Generic)  PLATFORM="" ;;
            *)                 PLATFORM="" ;;
          esac
          echo "platform=$PLATFORM" >> "$GITHUB_OUTPUT"
          echo "Platform: ${PLATFORM:-all}"
      - name: Clone mokocli
        env:
          MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
        run: |
          GITEA_URL="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}"
          git clone --depth 1 "${GITEA_URL}/MokoConsulting/mokocli.git" /tmp/mokocli
      - name: Install dependencies
        run: |
          cd /tmp/mokocli
          composer install --no-dev --no-interaction --quiet 2>/dev/null || true
      - name: Run workflow sync
        env:
          MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
        run: |
          ARGS="--token ${MOKOGITEA_TOKEN}"
          ARGS="${ARGS} --org ${{ vars.GITEA_ORG || github.repository_owner }}"
          ARGS="${ARGS} --phase repos"
          PLATFORM="${{ steps.platform.outputs.platform }}"
          if [ -n "$PLATFORM" ]; then
            ARGS="${ARGS} --platform-filter ${PLATFORM}"
          fi
          php /tmp/mokocli/cli/workflow_sync.php ${ARGS}
@@ -1,7 +1,7 @@
 {
    "metadata": {
        "generated_at": "2026-03-10T19:51:42.238134Z",
-        "repository": "MokoConsulting/mokoplatform",
+        "repository": "MokoConsulting/mokocli",
        "version": "1.0.0"
    },
    "scripts": [
@@ -2,8 +2,8 @@
 Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 SPDX-License-Identifier: GPL-3.0-or-later
 FILE INFORMATION
-DEFGROUP: MokoStandards.Root
+DEFGROUP: MokoCli.Root
-INGROUP: MokoStandards
+INGROUP: MokoCli
 REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
 PATH: /CHANGELOG.md
 BRIEF: Release changelog
@@ -12,42 +12,14 @@ BRIEF: Release changelog
 # Changelog
 ## [Unreleased]
-## [09.26.00] --- 2026-06-07
+## [09.37.00] --- 2026-06-21
-### Added
+## [09.37.00] --- 2026-06-21
 - `workflow_sync.php` — cascading workflow sync from Generic → platform templates → live repos based on manifest.platform
 - `platform_detect.php` — auto-detect repo platform type (joomla/dolibarr/go/mcp/platform/generic) from file structure, optionally update manifest
 - Version prefix support in `version_read.php` and `version_bump.php` — repos with `<version_prefix>` in manifest (e.g. MokoGitea: `1.26.1+moko.`) get prefix-aware version scanning and bumping
 - Platform types: joomla, dolibarr, go, mcp, platform, generic
 - Template-Go and Template-MCP repos created
-### Changed
+## [09.36.00] --- 2026-06-21
 - `auto-release.yml` — patch branches (fix/*, patch/*, hotfix/*, bugfix/*) use `--bump none` (pre-release already bumped); feature/dev branches bump minor
 - `pre-release.yml` — triggers on push to dev, fix/**, patch/**, hotfix/**, bugfix/**, alpha, beta, rc branches
 - Version format standardized: `[prefix]XX.YY.ZZ` in source files, suffix (`-dev`, `-rc`) added by release system only
-## [09.26.00] --- 2026-06-07
+## [09.36.00] --- 2026-06-21
-### Added
+## [09.35.00] --- 2026-06-21
 - `cli/manifest_detect.php` — auto-detect manifest fields from source files (Joomla, Dolibarr, Go, MCP/Node, generic)
 - Supports `--json`, `--diff`, `--update`, `--github-output` modes
 - Warns on missing core fields (platform, name, version, package_type, language, entry_point)
-### Removed
+## [09.35.00] --- 2026-06-21
 - `mcp/servers/mokowaas_api/` — consolidated into mcp-mokowaas-api repo
 ## [09.25.00] --- 2026-06-04
 ## [09.23] --- 2026-05-31
 ## [09.22] --- 2026-05-31
 ### Changed
 - **refactor(cli):** migrate 64 legacy scripts to CliFramework (#235) — all tools in cli/, automation/, maintenance/, deploy/, release/ now extend CliFramework with free --help, --verbose, --quiet, --dry-run, --json, banners, and coloured logging
 ### Fixed
 - fix: auto-detect org/repo in updates_xml_build from manifest and git remote
 - fix: restore hyphen in version suffixes
 - fix: release names use standardized format
 - fix: remove lesser stream copies, each stream updates independently
 - fix: sort updates.xml entries dev first, stable last
@@ -1,161 +1,161 @@
-# Contributing to Moko Consulting Projects
+# Contributing to Moko Consulting Projects
-
+
-Thank you for your interest in contributing. All Moko Consulting repositories follow this universal workflow and version policy.
+Thank you for your interest in contributing. All Moko Consulting repositories follow this universal workflow and version policy.
-
+
-## Branching Workflow
+## Branching Workflow
-
+
-```
+```
-feature/* ──PR──> dev ──draft PR──> (renamed to rc) ──merge──> main
+feature/* ──PR──> dev ──draft PR──> (renamed to rc) ──merge──> main
-```
+```
-
+
-### Step by step
+### Step by step
-
+
-1. **Create a feature branch** from `dev`:
+1. **Create a feature branch** from `dev`:
-   ```bash
+   ```bash
-   git checkout dev && git pull
+   git checkout dev && git pull
-   git checkout -b feature/my-change
+   git checkout -b feature/my-change
-   ```
+   ```
-
+
-2. **Work and commit** on your feature branch. Push to origin.
+2. **Work and commit** on your feature branch. Push to origin.
-
+
-3. **Open a PR**: `feature/my-change` → `dev`. After review and checks, merge it.
+3. **Open a PR**: `feature/my-change` → `dev`. After review and checks, merge it.
-
+
-4. **When ready for release**, open a **draft PR**: `dev` → `main`.
+4. **When ready for release**, open a **draft PR**: `dev` → `main`.
-   - This automatically renames the source branch to `rc` (release candidate)
+   - This automatically renames the source branch to `rc` (release candidate)
-   - An RC pre-release is built and uploaded
+   - An RC pre-release is built and uploaded
-
+
-5. **Alpha and beta branches** are created by manually renaming the branch before the RC stage:
+5. **Alpha and beta branches** are created by manually renaming the branch before the RC stage:
-   - Rename `dev` to `alpha` for early testing → alpha pre-release is built
+   - Rename `dev` to `alpha` for early testing → alpha pre-release is built
-   - Rename `alpha` to `beta` for feature-complete testing → beta pre-release is built
+   - Rename `alpha` to `beta` for feature-complete testing → beta pre-release is built
-   - When the draft PR is created, the branch is renamed to `rc`
+   - When the draft PR is created, the branch is renamed to `rc`
-
+
-6. **Once PR checks pass** on the `rc` branch, mark the PR as ready and merge to `main`.
+6. **Once PR checks pass** on the `rc` branch, mark the PR as ready and merge to `main`.
-
+
-7. **Merging to main** triggers the stable release pipeline:
+7. **Merging to main** triggers the stable release pipeline:
-   - Minor version bump (e.g., `02.09.xx` → `02.10.00`)
+   - Minor version bump (e.g., `02.09.xx` → `02.10.00`)
-   - Stability suffix stripped (clean version)
+   - Stability suffix stripped (clean version)
-   - Gitea release created with ZIP/tar.gz packages
+   - Gitea release created with ZIP/tar.gz packages
-   - `updates.xml` updated (Joomla extensions)
+   - `updates.xml` updated (Joomla extensions)
-   - `dev` branch recreated from `main`
+   - `dev` branch recreated from `main`
-
+
-### Branch summary
+### Branch summary
-
+
-| Branch | Purpose | Created by |
+| Branch | Purpose | Created by |
-|--------|---------|-----------|
+|--------|---------|-----------|
-| `feature/*` | New features and fixes | Developer |
+| `feature/*` | New features and fixes | Developer |
-| `dev` | Integration branch | Auto-recreated after release |
+| `dev` | Integration branch | Auto-recreated after release |
-| `alpha` | Alpha pre-release testing | Manual rename from `dev` |
+| `alpha` | Alpha pre-release testing | Manual rename from `dev` |
-| `beta` | Beta pre-release testing | Manual rename from `alpha` |
+| `beta` | Beta pre-release testing | Manual rename from `alpha` |
-| `rc` | Release candidate | Auto-renamed on draft PR to main |
+| `rc` | Release candidate | Auto-renamed on draft PR to main |
-| `main` | Stable releases | Protected, merge only |
+| `main` | Stable releases | Protected, merge only |
-| `version/XX.YY.ZZ` | Archived release snapshots | Auto-created by CI |
+| `version/XX.YY.ZZ` | Archived release snapshots | Auto-created by CI |
-
+
-### Protected branches
+### Protected branches
-
+
-| Branch | Direct push | Merge via |
+| Branch | Direct push | Merge via |
-|--------|------------|-----------|
+|--------|------------|-----------|
-| `main` | Blocked (CI bot whitelisted) | PR merge only |
+| `main` | Blocked (CI bot whitelisted) | PR merge only |
-| `dev` | Blocked (CI bot whitelisted) | PR merge from feature/* |
+| `dev` | Blocked (CI bot whitelisted) | PR merge from feature/* |
-| `rc` | Blocked (CI bot whitelisted) | Auto-created on draft PR |
+| `rc` | Blocked (CI bot whitelisted) | Auto-created on draft PR |
-| `alpha` | Blocked (CI bot whitelisted) | Manual rename |
+| `alpha` | Blocked (CI bot whitelisted) | Manual rename |
-| `beta` | Blocked (CI bot whitelisted) | Manual rename |
+| `beta` | Blocked (CI bot whitelisted) | Manual rename |
-| `feature/*` | Open | N/A (source branch) |
+| `feature/*` | Open | N/A (source branch) |
-
+
-## Version Policy
+## Version Policy
-
+
-### Format
+### Format
-
+
-All versions use `XX.YY.ZZ` — three two-digit segments, zero-padded:
+All versions use `XX.YY.ZZ` — three two-digit segments, zero-padded:
-
+
- **XX** — Major version (breaking changes)
+- **XX** — Major version (breaking changes)
- **YY** — Minor version (new features, bumped on release to main)
+- **YY** — Minor version (new features, bumped on release to main)
- **ZZ** — Patch version (auto-incremented on every push to dev/feature branches)
+- **ZZ** — Patch version (auto-incremented on every push to dev/feature branches)
-
+
-Rollover: patch `99` → `00` increments minor; minor `99` → `00` increments major.
+Rollover: patch `99` → `00` increments minor; minor `99` → `00` increments major.
-
+
-### Stability suffixes
+### Stability suffixes
-
+
-Each branch appends a suffix to indicate stability:
+Each branch appends a suffix to indicate stability:
-
+
-| Branch | Suffix | Example |
+| Branch | Suffix | Example |
-|--------|--------|---------|
+|--------|--------|---------|
-| `main` | (none) | `02.09.00` |
+| `main` | (none) | `02.09.00` |
-| `dev` | `-dev` | `02.09.01-dev` |
+| `dev` | `-dev` | `02.09.01-dev` |
-| `feature/*` | `-dev` | `02.09.01-dev` |
+| `feature/*` | `-dev` | `02.09.01-dev` |
-| `alpha` | `-alpha` | `02.09.01-alpha` |
+| `alpha` | `-alpha` | `02.09.01-alpha` |
-| `beta` | `-beta` | `02.09.01-beta` |
+| `beta` | `-beta` | `02.09.01-beta` |
-| `rc` | `-rc` | `02.09.01-rc` |
+| `rc` | `-rc` | `02.09.01-rc` |
-
+
-### Auto version bump
+### Auto version bump
-
+
-On every push to `dev`, `feature/*`, or `patch/*`:
+On every push to `dev`, `feature/*`, or `patch/*`:
-
+
-1. Patch version incremented
+1. Patch version incremented
-2. Stability suffix `-dev` applied
+2. Stability suffix `-dev` applied
-3. All version-bearing files updated (manifests, CHANGELOG, PHP headers, etc.)
+3. All version-bearing files updated (manifests, CHANGELOG, PHP headers, etc.)
-4. Commit created with `[skip ci]` to avoid loops
+4. Commit created with `[skip ci]` to avoid loops
-
+
-### Release version flow
+### Release version flow
-
+
-Version bumps happen at specific release events:
+Version bumps happen at specific release events:
-
+
-| Event | Bump | Example |
+| Event | Bump | Example |
-|-------|------|---------|
+|-------|------|---------|
-| Feature merged to dev | Patch bump after dev release | `02.09.01-dev` → release → `02.09.02-dev` |
+| Feature merged to dev | Patch bump after dev release | `02.09.01-dev` → release → `02.09.02-dev` |
-| Dev promoted to RC | Minor bump | `02.09.02-dev` → `02.10.00-rc` |
+| Dev promoted to RC | Minor bump | `02.09.02-dev` → `02.10.00-rc` |
-| RC merged to main | Minor bump | `02.10.00-rc` → `02.11.00` (stable) |
+| RC merged to main | Minor bump | `02.10.00-rc` → `02.11.00` (stable) |
-| Dev recreated from main | Patch bump | `02.11.00` → `02.11.01-dev` |
+| Dev recreated from main | Patch bump | `02.11.00` → `02.11.01-dev` |
-
+
-### Release stream copies
+### Release stream copies
-
+
-When a higher-stability release is published, copies are created for all lesser streams with the same base version:
+When a higher-stability release is published, copies are created for all lesser streams with the same base version:
-
+
- **RC `02.10.00-rc`** also creates: `02.10.00-dev`, `02.10.00-alpha`, `02.10.00-beta`
+- **RC `02.10.00-rc`** also creates: `02.10.00-dev`, `02.10.00-alpha`, `02.10.00-beta`
- **Stable `02.11.00`** also creates: `02.11.00-dev`, `02.11.00-alpha`, `02.11.00-beta`, `02.11.00-rc`
+- **Stable `02.11.00`** also creates: `02.11.00-dev`, `02.11.00-alpha`, `02.11.00-beta`, `02.11.00-rc`
-
+
-This ensures Joomla sites on ANY stability channel see the update (Joomla only shows versions higher than what's installed).
+This ensures Joomla sites on ANY stability channel see the update (Joomla only shows versions higher than what's installed).
-
+
-### Version files
+### Version files
-
+
-The version tools update all files containing version stamps:
+The version tools update all files containing version stamps:
-
+
- `.mokogitea/manifest.xml` (canonical source)
+- `.mokogitea/manifest.xml` (canonical source)
- Joomla XML manifests (`<version>` tag)
+- Joomla XML manifests (`<version>` tag)
- `README.md`, `CHANGELOG.md` (`VERSION:` pattern)
+- `README.md`, `CHANGELOG.md` (`VERSION:` pattern)
- `package.json`, `pyproject.toml`
+- `package.json`, `pyproject.toml`
- Any text file with a `VERSION: XX.YY.ZZ` label
+- Any text file with a `VERSION: XX.YY.ZZ` label
-
+
-Files synced from other repos (with a `# REPO:` header) are not touched.
+Files synced from other repos (with a `# REPO:` header) are not touched.
-
+
-## Code Standards
+## Code Standards
-
+
- **PHP**: PSR-12, tabs for indentation
+- **PHP**: PSR-12, tabs for indentation
- **Copyright**: all files must include the Moko Consulting copyright header
+- **Copyright**: all files must include the Moko Consulting copyright header
- **License**: SPDX identifier `GPL-3.0-or-later` (or as specified per repo)
+- **License**: SPDX identifier `GPL-3.0-or-later` (or as specified per repo)
- **Attribution**: use `Authored-by: Moko Consulting` in commits, not individual names
+- **Attribution**: use `Authored-by: Moko Consulting` in commits, not individual names
-
+
-## Commit Messages
+## Commit Messages
-
+
-Use conventional commit format:
+Use conventional commit format:
-
+
-```
+```
-type(scope): short description
+type(scope): short description
-
+
-Optional body with context.
+Optional body with context.
-
+
-Authored-by: Moko Consulting
+Authored-by: Moko Consulting
-```
+```
-
+
-Types: `feat`, `fix`, `chore`, `docs`, `style`, `refactor`, `test`, `ci`
+Types: `feat`, `fix`, `chore`, `docs`, `style`, `refactor`, `test`, `ci`
-
+
-Special flags in commit messages:
+Special flags in commit messages:
- `[skip ci]` — skip all CI workflows
+- `[skip ci]` — skip all CI workflows
- `[skip bump]` — skip auto version bump only
+- `[skip bump]` — skip auto version bump only
-
+
-## Reporting Issues
+## Reporting Issues
-
+
-Use the repository's issue tracker with the appropriate template.
+Use the repository's issue tracker with the appropriate template.
-
+
---
+---
-
+
-*Moko Consulting <hello@mokoconsulting.tech>*
+*Moko Consulting <hello@mokoconsulting.tech>*
@@ -4,14 +4,14 @@ SPDX-License-Identifier: GPL-3.0-or-later
 FILE INFORMATION
 DEFGROUP: MokoPlatform.Root
 INGROUP: MokoPlatform
-REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 PATH: /PLUGIN_SCRIPTS.md
 BRIEF: Plugin system CLI documentation
 -->
 # Plugin System CLI Scripts
-Command-line scripts for validating, health checking, and managing projects using the mokoplatform plugin system.
+Command-line scripts for validating, health checking, and managing projects using the mokocli plugin system.
 ## Available Scripts
@@ -4,20 +4,20 @@ SPDX-License-Identifier: GPL-3.0-or-later
 FILE INFORMATION
 DEFGROUP: MokoPlatform.Root
 INGROUP: MokoPlatform
-REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 PATH: /README.md
-VERSION: 09.26.00
+VERSION: 09.37.01
 BRIEF: Project overview and documentation
 -->
-# mokoplatform Enterprise API
+# mokocli Enterprise API
 ![Version](https://img.shields.io/badge/version-09.01.00-blue) ![PHP](https://img.shields.io/badge/PHP-8.1%2B-777BB4) ![License](https://img.shields.io/badge/license-GPL--3.0--or--later-green)
-PHP implementation of mokoplatform — enterprise standards, automation framework, workflow templates, and bulk sync tooling.
+PHP implementation of mokocli — enterprise standards, automation framework, workflow templates, and bulk sync tooling.
-> **Primary platform**: [Gitea — git.mokoconsulting.tech](https://git.mokoconsulting.tech/MokoConsulting/MokoStandards-API)
+> **Primary platform**: [Gitea — git.mokoconsulting.tech](https://git.mokoconsulting.tech/MokoConsulting/MokoCli-API)
-> **Backup mirror**: [GitHub](https://github.com/MokoConsulting/MokoStandards-API) *(read-only mirror)*
+> **Backup mirror**: [GitHub](https://github.com/MokoConsulting/MokoCli-API) *(read-only mirror)*
 ## What Lives Here
@@ -4,7 +4,7 @@ SPDX-License-Identifier: GPL-3.0-or-later
 FILE INFORMATION
 DEFGROUP: MokoPlatform.Index
 INGROUP: MokoPlatform.Analysis
-REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 PATH: /analysis/index.md
 BRIEF: Analysis directory index
 -->
@@ -11,7 +11,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform.Scripts
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/bulk_joomla_template.php
 * BRIEF: Bulk scaffold and sync Joomla template repositories
 *
@@ -28,7 +28,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{
+use MokoCli\{
    AuditLogger,
    CliFramework,
    Config,
@@ -42,7 +42,7 @@ use MokoEnterprise\{
 *
 * Provides three operations for Joomla template projects:
 *   --scaffold: Create a new template repository with the full directory structure
- *   --sync:    Push mokoplatform files to existing template repositories
+ *   --sync:    Push mokocli files to existing template repositories
 *   --list:    List all repositories tagged as joomla-template
 *
 * Works with both GitHub and Gitea via the PlatformAdapterFactory.
@@ -318,7 +318,7 @@ class BulkJoomlaTemplate extends CliFramework
                            $name,
                            $path,
                            $content,
-                            "chore: update {$path} from mokoplatform",
+                            "chore: update {$path} from mokocli",
                            $existingSha,
                            $branch
                        );
@@ -11,7 +11,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform.Scripts
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/bulk_sync.php
 * BRIEF: Enterprise-grade bulk repository synchronization
 */
@@ -21,7 +21,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{
+use MokoCli\{
    ApiClient,
    AuditLogger,
    CheckpointManager,
@@ -42,7 +42,7 @@ use MokoEnterprise\{
 /**
 * Bulk Repository Synchronization Tool
 *
- * Synchronizes mokoplatform files across multiple repositories using
+ * Synchronizes mokocli files across multiple repositories using
 * the Enterprise library for robust, audited operations.
 */
 class BulkSync extends CliFramework
@@ -95,7 +95,7 @@ class BulkSync extends CliFramework
     */
    protected function run(): int
    {
-        $this->log("🚀 mokoplatform Bulk Synchronization v" . self::VERSION, 'INFO');
+        $this->log("🚀 mokocli Bulk Synchronization v" . self::VERSION, 'INFO');
        // Initialize enterprise components
        if (!$this->initializeComponents()) {
@@ -180,7 +180,7 @@ class BulkSync extends CliFramework
            $results['health'] = $this->runHealthChecksAll($org, $repositories);
        }
-        // Create/update tracking issue in mokoplatform
+        // Create/update tracking issue in mokocli
        $this->createSyncIssue($org, $results);
        // Create/update a failure issue when any repos failed
@@ -244,7 +244,7 @@ class BulkSync extends CliFramework
     * Filter repositories based on include/exclude lists
     */
    /** Repositories that are permanently excluded from bulk sync. */
-    private const ALWAYS_EXCLUDE = ['mokoplatform', '.github-private'];
+    private const ALWAYS_EXCLUDE = ['mokocli', '.github-private'];
    private function filterRepositories(array $repositories, array $include, array $exclude): array
    {
@@ -426,7 +426,7 @@ class BulkSync extends CliFramework
                $this->log("", 'ERROR');
                $this->log("Required Implementation:", 'ERROR');
                $this->log("  1. Clone/fetch target repository", 'ERROR');
-                $this->log("  2. Apply file updates based on mokoplatform configuration", 'ERROR');
+                $this->log("  2. Apply file updates based on mokocli configuration", 'ERROR');
                $this->log("  3. Create pull request with changes", 'ERROR');
                $this->log("  4. Handle merge conflicts and validation", 'ERROR');
                $this->log("", 'ERROR');
@@ -837,7 +837,7 @@ class BulkSync extends CliFramework
    }
    /**
-     * Ensure all standard mokoplatform labels exist on a target repository.
+     * Ensure all standard mokocli labels exist on a target repository.
     *
     * Fetches existing labels first (GET) and only POSTs the ones that are
     * missing. This avoids the 422 "already exists" responses that would
@@ -872,7 +872,7 @@ class BulkSync extends CliFramework
            // Workflow / Process
            ['automation',             '8B4513', 'Automated processes or scripts'],
-            ['mokoplatform',          'B60205', 'mokoplatform compliance'],
+            ['mokocli',          'B60205', 'mokocli compliance'],
            ['needs-review',           'FBCA04', 'Awaiting code review'],
            ['work-in-progress',       'D93F0B', 'Work in progress, not ready for merge'],
            ['breaking-change',        'D73A4A', 'Breaking API or functionality change'],
@@ -912,8 +912,8 @@ class BulkSync extends CliFramework
            ['health: poor',           'FF6B6B', 'Health score below 50'],
            // Sync / Automation (used by bulk_sync, scan_drift, check_repo_health)
-            ['standards-update',       'B60205', 'mokoplatform sync update'],
+            ['standards-update',       'B60205', 'mokocli sync update'],
-            ['standards-drift',        'FBCA04', 'Repository drifted from mokoplatform'],
+            ['standards-drift',        'FBCA04', 'Repository drifted from mokocli'],
            ['sync-report',            '0075CA', 'Bulk sync run report'],
            ['sync-failure',           'D73A4A', 'Bulk sync failure requiring attention'],
            ['push-failure',           'D73A4A', 'File push failure requiring attention'],
@@ -925,10 +925,10 @@ class BulkSync extends CliFramework
            ['type: version',          '0E8A16', 'Version-related change'],
        ];
-        // Quick check: if the repo already has the 'mokoplatform' label, it was
+        // Quick check: if the repo already has the 'mokocli' label, it was
        // provisioned previously — skip the expensive full label provisioning.
        try {
-            $probe = $this->api->get("/repos/{$org}/{$repo}/labels/mokoplatform");
+            $probe = $this->api->get("/repos/{$org}/{$repo}/labels/mokocli");
            if (!empty($probe['name'])) {
                return; // already provisioned
            }
@@ -1024,7 +1024,7 @@ class BulkSync extends CliFramework
     */
    private function updateOpenBranches(string $org, string $repo): void
    {
-        $syncBranchPrefix = 'chore/sync-mokoplatform-';
+        $syncBranchPrefix = 'chore/sync-mokocli-';
        try {
            $defaultBranch = 'main';
@@ -1055,7 +1055,7 @@ class BulkSync extends CliFramework
                    $this->api->post("/repos/{$org}/{$repo}/merges", [
                        'base'           => $branch,
                        'head'           => $defaultBranch,
-                        'commit_message' => "chore: merge {$defaultBranch} into {$branch} (mokoplatform sync)",
+                        'commit_message' => "chore: merge {$defaultBranch} into {$branch} (mokocli sync)",
                    ]);
                    $this->log("  🔀 Merged {$defaultBranch} → {$branch} (PR #{$prNum})", 'INFO');
                } catch (\Exception $e) {
@@ -1076,7 +1076,7 @@ class BulkSync extends CliFramework
    /**
     * Records which sync run touched the repo, the PR number, and the
-     * mokoplatform version that was applied — giving each repo a clear audit
+     * mokocli version that was applied — giving each repo a clear audit
     * trail of what was changed and why.
     */
    /**
@@ -1119,16 +1119,16 @@ class BulkSync extends CliFramework
        $minor       = self::VERSION_MINOR;
        $force       = isset($this->options['force']) ? ' *(--force)*' : '';
        $prLink      = $this->adapter->getPullRequestWebUrl($org, $repo, $prNumber);
-        $source      = $this->adapter->getRepoWebUrl($org, 'mokoplatform');
+        $source      = $this->adapter->getRepoWebUrl($org, 'mokocli');
-        $branchName  = 'chore/sync-mokoplatform-v' . $minor;
+        $branchName  = 'chore/sync-mokocli-v' . $minor;
        $branchLink  = $this->adapter->getBranchWebUrl($org, $repo, $branchName);
-        $title = "chore: mokoplatform v{$minor} sync tracking";
+        $title = "chore: mokocli v{$minor} sync tracking";
        $body = <<<MD
-        ## mokoplatform Sync Applied
+        ## mokocli Sync Applied
-        A mokoplatform bulk sync run has updated files in this repository.
+        A mokocli bulk sync run has updated files in this repository.
        | Field | Value |
        |-------|-------|
@@ -1144,13 +1144,13 @@ class BulkSync extends CliFramework
        Protected files (README, CHANGELOG, GOVERNANCE, etc.) were not overwritten.
        ---
-        *Updated automatically by [mokoplatform]({$source}) `bulk_sync.php`*
+        *Updated automatically by [mokocli]({$source}) `bulk_sync.php`*
        MD;
        // Dedent heredoc
        $body = preg_replace('/^        /m', '', $body);
-        $labelNames = ['standards-update', 'mokoplatform', 'type: chore', 'automation'];
+        $labelNames = ['standards-update', 'mokocli', 'type: chore', 'automation'];
        $labels = $this->resolveLabelIds($org, $repo, $labelNames);
        try {
@@ -1213,7 +1213,7 @@ class BulkSync extends CliFramework
    }
    /**
-     * Create a tracking issue in mokoplatform for this sync run.
+     * Create a tracking issue in mokocli for this sync run.
     */
    private function createSyncIssue(string $org, array $results): void
    {
@@ -1232,7 +1232,7 @@ class BulkSync extends CliFramework
        $issues   = $results['issues'] ?? [];
        // Stable title — no timestamp so repeated runs update a single issue
-        $title = "sync: mokoplatform v" . self::VERSION_MINOR . " bulk sync report";
+        $title = "sync: mokocli v" . self::VERSION_MINOR . " bulk sync report";
        $protection = $results['protection'] ?? [];
        $hasProtect = !empty($protection);
@@ -1281,7 +1281,7 @@ class BulkSync extends CliFramework
            : "|---|---|---|---|";
        $body = <<<MD
-        ## mokoplatform Bulk Sync Report
+        ## mokocli Bulk Sync Report
        **Organisation:** `{$org}`
        **Triggered:** {$now}{$force}
@@ -1301,7 +1301,7 @@ class BulkSync extends CliFramework
        try {
            // Search for existing issue by label — any state so we can reopen closed ones
-            $existing = $this->api->get("/repos/{$org}/mokoplatform/issues", [
+            $existing = $this->api->get("/repos/{$org}/mokocli/issues", [
                'labels'   => 'sync-report',
                'state'    => 'all',
                'per_page' => 1,
@@ -1309,8 +1309,8 @@ class BulkSync extends CliFramework
                'direction' => 'desc',
            ]);
-            $labelNames = ['sync-report', 'mokoplatform', 'type: chore', 'automation'];
+            $labelNames = ['sync-report', 'mokocli', 'type: chore', 'automation'];
-            $labels = $this->resolveLabelIds($org, 'mokoplatform', $labelNames);
+            $labels = $this->resolveLabelIds($org, 'mokocli', $labelNames);
            $existing = array_values($existing);
            if (!empty($existing) && isset($existing[0]['number'])) {
@@ -1319,22 +1319,22 @@ class BulkSync extends CliFramework
                if (($existing[0]['state'] ?? 'open') === 'closed') {
                    $patch['state'] = 'open';
                }
-                $this->api->patch("/repos/{$org}/mokoplatform/issues/{$issueNumber}", $patch);
+                $this->api->patch("/repos/{$org}/mokocli/issues/{$issueNumber}", $patch);
                try {
-                    $this->api->post("/repos/{$org}/mokoplatform/issues/{$issueNumber}/labels", ['labels' => $labels]);
+                    $this->api->post("/repos/{$org}/mokocli/issues/{$issueNumber}/labels", ['labels' => $labels]);
                } catch (\Exception $le) {
 /* non-fatal */
                }
-                $this->log("📋 Sync report issue updated: {$org}/mokoplatform#{$issueNumber}", 'INFO');
+                $this->log("📋 Sync report issue updated: {$org}/mokocli#{$issueNumber}", 'INFO');
            } else {
-                $issue = $this->api->post("/repos/{$org}/mokoplatform/issues", [
+                $issue = $this->api->post("/repos/{$org}/mokocli/issues", [
                    'title'     => $title,
                    'body'      => $body,
                    'labels'    => $labels,
                    'assignees' => ['jmiller'],
                ]);
                $issueNumber = $issue['number'] ?? '?';
-                $this->log("📋 Sync report issue created: {$org}/mokoplatform#{$issueNumber}", 'INFO');
+                $this->log("📋 Sync report issue created: {$org}/mokocli#{$issueNumber}", 'INFO');
            }
        } catch (\Exception $e) {
            $this->log("⚠️  Failed to create/update sync report issue: " . $e->getMessage(), 'WARN');
@@ -1342,7 +1342,7 @@ class BulkSync extends CliFramework
    }
    /**
-     * Create or update a failure issue in mokoplatform when repos fail to sync.
+     * Create or update a failure issue in mokocli when repos fail to sync.
     * Uses the 'sync-failure' label so it is distinct from the run-report issue.
     * Reopens a closed issue rather than creating a duplicate.
     */
@@ -1388,7 +1388,7 @@ class BulkSync extends CliFramework
        $body = preg_replace('/^        /m', '', $body);
        try {
-            $existing = $this->api->get("/repos/{$org}/mokoplatform/issues", [
+            $existing = $this->api->get("/repos/{$org}/mokocli/issues", [
                'labels'    => 'sync-failure',
                'state'     => 'all',
                'per_page'  => 1,
@@ -1403,17 +1403,17 @@ class BulkSync extends CliFramework
                if (($existing[0]['state'] ?? 'open') === 'closed') {
                    $patch['state'] = 'open';
                }
-                $this->api->patch("/repos/{$org}/mokoplatform/issues/{$num}", $patch);
+                $this->api->patch("/repos/{$org}/mokocli/issues/{$num}", $patch);
-                $this->log("🚨 Failure issue #{$num} updated: {$org}/mokoplatform#{$num}", 'WARN');
+                $this->log("🚨 Failure issue #{$num} updated: {$org}/mokocli#{$num}", 'WARN');
            } else {
-                $issue = $this->api->post("/repos/{$org}/mokoplatform/issues", [
+                $issue = $this->api->post("/repos/{$org}/mokocli/issues", [
                    'title'     => $title,
                    'body'      => $body,
-                    'labels'    => $this->resolveLabelIds($org, 'mokoplatform', ['sync-failure']),
+                    'labels'    => $this->resolveLabelIds($org, 'mokocli', ['sync-failure']),
                    'assignees' => ['jmiller'],
                ]);
                $num = $issue['number'] ?? '?';
-                $this->log("🚨 Failure issue created: {$org}/mokoplatform#{$num}", 'WARN');
+                $this->log("🚨 Failure issue created: {$org}/mokocli#{$num}", 'WARN');
            }
        } catch (\Exception $e) {
            $this->log("⚠️  Could not create/update failure issue: " . $e->getMessage(), 'WARN');
@@ -1,123 +1,123 @@
-#!/usr/bin/env bash
+#!/usr/bin/env bash
-# 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
-# BRIEF: Trigger a workflow across all client-waas repos in a Gitea org
+# BRIEF: Trigger a workflow across all client-waas repos in a Gitea org
-
+
-set -euo pipefail
+set -euo pipefail
-
+
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-# Usage
+# Usage
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-usage() {
+usage() {
-  cat <<EOF
+  cat <<EOF
-Usage: $(basename "$0") GITEA_URL TOKEN ORG WORKFLOW [REF] [INPUTS]
+Usage: $(basename "$0") GITEA_URL TOKEN ORG WORKFLOW [REF] [INPUTS]
-
+
-Arguments:
+Arguments:
-  GITEA_URL   Base URL of the Gitea instance (e.g. https://git.mokoconsulting.tech)
+  GITEA_URL   Base URL of the Gitea instance (e.g. https://git.mokoconsulting.tech)
-  TOKEN       Gitea API token with repo/action permissions
+  TOKEN       Gitea API token with repo/action permissions
-  ORG         Organisation or user that owns the repos
+  ORG         Organisation or user that owns the repos
-  WORKFLOW    Workflow filename to trigger (e.g. dependency-audit.yml)
+  WORKFLOW    Workflow filename to trigger (e.g. dependency-audit.yml)
-  REF         Branch ref to run against (default: main)
+  REF         Branch ref to run against (default: main)
-  INPUTS      Optional JSON object of workflow inputs (e.g. '{"dry_run":"true"}')
+  INPUTS      Optional JSON object of workflow inputs (e.g. '{"dry_run":"true"}')
-
+
-Example:
+Example:
-  $(basename "$0") https://git.mokoconsulting.tech abc123 MokoConsulting dependency-audit.yml main '{"notify":"true"}'
+  $(basename "$0") https://git.mokoconsulting.tech abc123 MokoConsulting dependency-audit.yml main '{"notify":"true"}'
-EOF
+EOF
-  exit 1
+  exit 1
-}
+}
-
+
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-# Argument parsing
+# Argument parsing
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-if [ $# -lt 4 ]; then
+if [ $# -lt 4 ]; then
-  usage
+  usage
-fi
+fi
-
+
-GITEA_URL="${1%/}"
+GITEA_URL="${1%/}"
-TOKEN="$2"
+TOKEN="$2"
-ORG="$3"
+ORG="$3"
-WORKFLOW="$4"
+WORKFLOW="$4"
-REF="${5:-main}"
+REF="${5:-main}"
-INPUTS="${6:-{\}}"
+INPUTS="${6:-{\}}"
-
+
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-# Fetch all repos in the org, paginated
+# Fetch all repos in the org, paginated
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-echo "Fetching repos for org '${ORG}' on ${GITEA_URL} ..."
+echo "Fetching repos for org '${ORG}' on ${GITEA_URL} ..."
-
+
-PAGE=1
+PAGE=1
-LIMIT=50
+LIMIT=50
-ALL_REPOS=""
+ALL_REPOS=""
-
+
-while true; do
+while true; do
-  RESPONSE=$(curl -s \
+  RESPONSE=$(curl -s \
-    -H "Authorization: token ${TOKEN}" \
+    -H "Authorization: token ${TOKEN}" \
-    -H "Accept: application/json" \
+    -H "Accept: application/json" \
-    "${GITEA_URL}/api/v1/orgs/${ORG}/repos?page=${PAGE}&limit=${LIMIT}")
+    "${GITEA_URL}/api/v1/orgs/${ORG}/repos?page=${PAGE}&limit=${LIMIT}")
-
+
-  # Break if empty array
+  # Break if empty array
-  COUNT=$(echo "$RESPONSE" | jq -r 'length')
+  COUNT=$(echo "$RESPONSE" | jq -r 'length')
-  if [ "$COUNT" -eq 0 ]; then
+  if [ "$COUNT" -eq 0 ]; then
-    break
+    break
-  fi
+  fi
-
+
-  NAMES=$(echo "$RESPONSE" | jq -r '.[].name')
+  NAMES=$(echo "$RESPONSE" | jq -r '.[].name')
-  ALL_REPOS="${ALL_REPOS}${NAMES}"$'\n'
+  ALL_REPOS="${ALL_REPOS}${NAMES}"$'\n'
-
+
-  if [ "$COUNT" -lt "$LIMIT" ]; then
+  if [ "$COUNT" -lt "$LIMIT" ]; then
-    break
+    break
-  fi
+  fi
-
+
-  PAGE=$((PAGE + 1))
+  PAGE=$((PAGE + 1))
-done
+done
-
+
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-# Filter for client-waas repos
+# Filter for client-waas repos
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-CLIENT_REPOS=$(echo "$ALL_REPOS" | grep 'client-waas' | sort || true)
+CLIENT_REPOS=$(echo "$ALL_REPOS" | grep 'client-waas' | sort || true)
-
+
-if [ -z "$CLIENT_REPOS" ]; then
+if [ -z "$CLIENT_REPOS" ]; then
-  echo "No client-waas repos found in org '${ORG}'."
+  echo "No client-waas repos found in org '${ORG}'."
-  exit 0
+  exit 0
-fi
+fi
-
+
-TOTAL=$(echo "$CLIENT_REPOS" | wc -l | tr -d ' ')
+TOTAL=$(echo "$CLIENT_REPOS" | wc -l | tr -d ' ')
-echo "Found ${TOTAL} client-waas repo(s). Triggering workflow '${WORKFLOW}' (ref: ${REF}) ..."
+echo "Found ${TOTAL} client-waas repo(s). Triggering workflow '${WORKFLOW}' (ref: ${REF}) ..."
-echo ""
+echo ""
-
+
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-# Trigger workflow for each repo
+# Trigger workflow for each repo
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-SUCCESS=0
+SUCCESS=0
-FAIL=0
+FAIL=0
-
+
-while IFS= read -r REPO; do
+while IFS= read -r REPO; do
-  [ -z "$REPO" ] && continue
+  [ -z "$REPO" ] && continue
-
+
-  PAYLOAD=$(jq -n --arg ref "$REF" --argjson inputs "$INPUTS" '{ref: $ref, inputs: $inputs}')
+  PAYLOAD=$(jq -n --arg ref "$REF" --argjson inputs "$INPUTS" '{ref: $ref, inputs: $inputs}')
-
+
-  HTTP_CODE=$(curl -s -o /dev/null -w '%{http_code}' \
+  HTTP_CODE=$(curl -s -o /dev/null -w '%{http_code}' \
-    -X POST \
+    -X POST \
-    -H "Authorization: token ${TOKEN}" \
+    -H "Authorization: token ${TOKEN}" \
-    -H "Content-Type: application/json" \
+    -H "Content-Type: application/json" \
-    -d "$PAYLOAD" \
+    -d "$PAYLOAD" \
-    "${GITEA_URL}/api/v1/repos/${ORG}/${REPO}/actions/workflows/${WORKFLOW}/dispatches")
+    "${GITEA_URL}/api/v1/repos/${ORG}/${REPO}/actions/workflows/${WORKFLOW}/dispatches")
-
+
-  if [ "$HTTP_CODE" -eq 204 ] || [ "$HTTP_CODE" -eq 201 ]; then
+  if [ "$HTTP_CODE" -eq 204 ] || [ "$HTTP_CODE" -eq 201 ]; then
-    echo "  [OK]   ${ORG}/${REPO} (HTTP ${HTTP_CODE})"
+    echo "  [OK]   ${ORG}/${REPO} (HTTP ${HTTP_CODE})"
-    SUCCESS=$((SUCCESS + 1))
+    SUCCESS=$((SUCCESS + 1))
-  else
+  else
-    echo "  [FAIL] ${ORG}/${REPO} (HTTP ${HTTP_CODE})"
+    echo "  [FAIL] ${ORG}/${REPO} (HTTP ${HTTP_CODE})"
-    FAIL=$((FAIL + 1))
+    FAIL=$((FAIL + 1))
-  fi
+  fi
-done <<< "$CLIENT_REPOS"
+done <<< "$CLIENT_REPOS"
-
+
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-# Summary
+# Summary
-# ---------------------------------------------------------------------------
+# ---------------------------------------------------------------------------
-echo ""
+echo ""
-echo "Done. Success: ${SUCCESS} | Failed: ${FAIL} | Total: ${TOTAL}"
+echo "Done. Success: ${SUCCESS} | Failed: ${FAIL} | Total: ${TOTAL}"
-
+
-if [ "$FAIL" -gt 0 ]; then
+if [ "$FAIL" -gt 0 ]; then
-  exit 1
+  exit 1
-fi
+fi
@@ -6,8 +6,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Automation.CI
-# INGROUP: moko-platform.Automation
+# INGROUP: mokocli.Automation
-# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH: /automation/ci-issue-reporter.sh
 # VERSION: 09.23.00
 # BRIEF: Creates or updates a Gitea issue when a CI gate fails.
@@ -8,7 +8,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/enrich_manifest_xml.php
 * BRIEF: Enrich XML manifests with repo-specific build and deploy details
 *
@@ -21,8 +21,8 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\MokoStandardsParser;
+use MokoCli\ManifestParser;
 class EnrichManifestXmlCli extends CliFramework
 {
@@ -43,10 +43,10 @@ class EnrichManifestXmlCli extends CliFramework
        $skipStr    = $this->getArgument('--skip');
        $skipRepos  = $skipStr !== '' ? array_map('trim', explode(',', $skipStr)) : [];
-        $parser = new MokoStandardsParser();
+        $parser = new ManifestParser();
        $tmpBase = sys_get_temp_dir() . '/moko-enrich-' . getmypid();
-        echo "=== mokoplatform XML Manifest Enrichment ===\n";
+        echo "=== mokocli XML Manifest Enrichment ===\n";
        echo "Mode: " . ($this->dryRun ? "DRY RUN" : "LIVE") . "\n";
        if (!empty($skipRepos)) {
            echo "Skipping: " . implode(', ', $skipRepos) . "\n";
@@ -97,7 +97,7 @@ class EnrichManifestXmlCli extends CliFramework
            }
            $manifestPath = "{$workDir}/.mokogitea/manifest.xml";
-            if (!file_exists($manifestPath) || !str_contains(file_get_contents($manifestPath), '<mokoplatform')) {
+            if (!file_exists($manifestPath) || !str_contains(file_get_contents($manifestPath), '<mokocli')) {
                echo "SKIP (no XML manifest)\n";
                $stats['skipped']++;
                $this->rmTree($workDir);
@@ -113,8 +113,8 @@ class EnrichManifestXmlCli extends CliFramework
            }
            $enrichment['build']['language'] = $enrichment['build']['language']
                ?? $repo['language']
-                ?? MokoStandardsParser::platformLanguage($platform);
+                ?? ManifestParser::platformLanguage($platform);
-            $enrichment['build']['package_type'] = $enrichment['build']['package_type'] ?? MokoStandardsParser::platformPackageType($platform);
+            $enrichment['build']['package_type'] = $enrichment['build']['package_type'] ?? ManifestParser::platformPackageType($platform);
            $enrichedXml = $this->enrichManifestXml($existingXml, $enrichment);
            $dc = count($enrichment['deploy'] ?? []);
@@ -312,7 +312,7 @@ class EnrichManifestXmlCli extends CliFramework
            return $xml;
        }
-        $ns = MokoStandardsParser::NAMESPACE_URI;
+        $ns = ManifestParser::NAMESPACE_URI;
        $root = $dom->documentElement;
        foreach (['build', 'deploy', 'scripts'] as $tag) {
@@ -8,7 +8,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/enrich_mokostandards_xml.php
 * BRIEF: Enrich XML manifests with repo-specific build and deploy details
 *
@@ -21,8 +21,8 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\MokoStandardsParser;
+use MokoCli\ManifestParser;
 class EnrichMokostandardsXmlCli extends CliFramework
 {
@@ -43,10 +43,10 @@ class EnrichMokostandardsXmlCli extends CliFramework
        $skipStr    = $this->getArgument('--skip');
        $skipRepos  = $skipStr !== '' ? array_map('trim', explode(',', $skipStr)) : [];
-        $parser = new MokoStandardsParser();
+        $parser = new ManifestParser();
        $tmpBase = sys_get_temp_dir() . '/moko-enrich-' . getmypid();
-        echo "=== mokoplatform XML Manifest Enrichment ===\n";
+        echo "=== mokocli XML Manifest Enrichment ===\n";
        echo "Mode: " . ($this->dryRun ? "DRY RUN" : "LIVE") . "\n";
        if (!empty($skipRepos)) {
            echo "Skipping: " . implode(', ', $skipRepos) . "\n";
@@ -97,7 +97,7 @@ class EnrichMokostandardsXmlCli extends CliFramework
            }
            $manifestPath = "{$workDir}/.mokogitea/manifest.xml";
-            if (!file_exists($manifestPath) || !str_contains(file_get_contents($manifestPath), '<mokoplatform')) {
+            if (!file_exists($manifestPath) || !str_contains(file_get_contents($manifestPath), '<mokocli')) {
                echo "SKIP (no XML manifest)\n";
                $stats['skipped']++;
                $this->rmTree($workDir);
@@ -113,8 +113,8 @@ class EnrichMokostandardsXmlCli extends CliFramework
            }
            $enrichment['build']['language'] = $enrichment['build']['language']
                ?? $repo['language']
-                ?? MokoStandardsParser::platformLanguage($platform);
+                ?? ManifestParser::platformLanguage($platform);
-            $enrichment['build']['package_type'] = $enrichment['build']['package_type'] ?? MokoStandardsParser::platformPackageType($platform);
+            $enrichment['build']['package_type'] = $enrichment['build']['package_type'] ?? ManifestParser::platformPackageType($platform);
            $enrichedXml = $this->enrichManifestXml($existingXml, $enrichment);
            $dc = count($enrichment['deploy'] ?? []);
@@ -315,7 +315,7 @@ class EnrichMokostandardsXmlCli extends CliFramework
            return $xml;
        }
-        $ns = MokoStandardsParser::NAMESPACE_URI;
+        $ns = ManifestParser::NAMESPACE_URI;
        $root = $dom->documentElement;
        foreach (['build', 'deploy', 'scripts'] as $tag) {
@@ -4,7 +4,7 @@ SPDX-License-Identifier: GPL-3.0-or-later
 FILE INFORMATION
 DEFGROUP: MokoPlatform.Index
 INGROUP: MokoPlatform.Automation
-REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 PATH: /automation/index.md
 BRIEF: Automation directory index
 -->
@@ -10,14 +10,14 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/migrate_to_gitea.php
 * BRIEF: Migrate repositories from GitHub to self-hosted Gitea instance
 *
 * USAGE
 *   php automation/migrate_to_gitea.php --dry-run
 *   php automation/migrate_to_gitea.php --repos MokoCRM MokoDoliMods
- *   php automation/migrate_to_gitea.php --exclude mokoplatform --skip-archived
+ *   php automation/migrate_to_gitea.php --exclude mokocli --skip-archived
 *   php automation/migrate_to_gitea.php --resume
 */
@@ -25,12 +25,12 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
-use MokoEnterprise\CheckpointManager;
+use MokoCli\CheckpointManager;
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\Config;
+use MokoCli\Config;
-use MokoEnterprise\PlatformAdapterFactory;
+use MokoCli\PlatformAdapterFactory;
-use MokoEnterprise\GitHubAdapter;
+use MokoCli\GitHubAdapter;
-use MokoEnterprise\MokoGiteaAdapter;
+use MokoCli\MokoGiteaAdapter;
 /**
 * Gitea Migration Script
@@ -278,7 +278,7 @@ class MigrateToGitea extends CliFramework
        try {
            $this->gitea->createIssue(
                $giteaOrg,
-                'mokoplatform',
+                'mokocli',
                'chore: GitHub → Gitea migration report — ' . count($results['migrated']) . ' repos migrated',
                $report,
                ['labels' => ['automation', 'type: chore']]
@@ -11,7 +11,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform.Scripts
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/push_files.php
 * BRIEF: Push one or more specific files to one or more remote repositories
 */
@@ -21,7 +21,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{
+use MokoCli\{
    ApiClient,
    AuditLogger,
    CliFramework,
@@ -35,7 +35,7 @@ use MokoEnterprise\{
 /**
 * Targeted File Push Tool
 *
- * Pushes one or more specific files from mokoplatform templates to one or
+ * Pushes one or more specific files from mokocli templates to one or
 * more remote repositories — without running a full sync.
 *
 * Files are specified by their destination path as they appear in the target
@@ -81,7 +81,7 @@ class PushFiles extends CliFramework
     */
    protected function run(): int
    {
-        $this->log('📦 mokoplatform File Push v' . self::VERSION, 'INFO');
+        $this->log('📦 mokocli File Push v' . self::VERSION, 'INFO');
        if (!$this->initializeComponents()) {
            return 1;
@@ -337,7 +337,7 @@ class PushFiles extends CliFramework
                $prNumber = null;
                if (!$direct) {
-                    $prTitle  = "chore: push " . count($entries) . " file(s) from mokoplatform";
+                    $prTitle  = "chore: push " . count($entries) . " file(s) from mokocli";
                    $prBody   = $this->buildPRBody($entries);
                    $pr       = $this->adapter->createPullRequest(
                        $org,
@@ -414,7 +414,7 @@ class PushFiles extends CliFramework
        $message = !empty($customMessage)
            ? $customMessage
-            : "chore: update {$destPath} from mokoplatform";
+            : "chore: update {$destPath} from mokocli";
        // Fetch existing file SHA (needed for updates)
        $existingSha = null;
@@ -457,9 +457,9 @@ class PushFiles extends CliFramework
    ): void {
        $now     = gmdate('Y-m-d H:i:s') . ' UTC';
        $version = self::VERSION;
-        $source  = $this->adapter->getRepoWebUrl($org, 'mokoplatform');
+        $source  = $this->adapter->getRepoWebUrl($org, 'mokocli');
-        $title = "chore: mokoplatform file push tracking";
+        $title = "chore: mokocli file push tracking";
        $deliveryLine = $prNumber !== null
            ? "| **Pull request** | [#{$prNumber}](" . $this->adapter->getPullRequestWebUrl($org, $repo, $prNumber) . ") |"
@@ -471,9 +471,9 @@ class PushFiles extends CliFramework
        ));
        $body = <<<MD
-        ## mokoplatform File Push
+        ## mokocli File Push
-        One or more files were pushed to this repository from mokoplatform.
+        One or more files were pushed to this repository from mokocli.
        | Field | Value |
        |-------|-------|
@@ -487,12 +487,12 @@ class PushFiles extends CliFramework
        {$fileRows}
        ---
-        *Generated automatically by [mokoplatform]({$source}) `push_files.php`*
+        *Generated automatically by [mokocli]({$source}) `push_files.php`*
        MD;
        $body = preg_replace('/^        /m', '', $body);
-        $labels = ['standards-update', 'mokoplatform', 'type: chore', 'automation'];
+        $labels = ['standards-update', 'mokocli', 'type: chore', 'automation'];
        try {
            $existing = $this->api->get("/repos/{$org}/{$repo}/issues", [
@@ -550,7 +550,7 @@ class PushFiles extends CliFramework
    }
    /**
-     * Create or update a failure issue in mokoplatform when repos fail to receive files.
+     * Create or update a failure issue in mokocli when repos fail to receive files.
     * Uses the 'push-failure' label. Reopens a closed issue rather than creating a duplicate.
     */
    private function createFailureIssue(string $org, array $results): void
@@ -598,7 +598,7 @@ class PushFiles extends CliFramework
        $body = preg_replace('/^        /m', '', $body);
        try {
-            $existing = $this->api->get("/repos/{$org}/mokoplatform/issues", [
+            $existing = $this->api->get("/repos/{$org}/mokocli/issues", [
                'labels'    => 'push-failure',
                'state'     => 'all',
                'per_page'  => 1,
@@ -613,17 +613,17 @@ class PushFiles extends CliFramework
                if (($existing[0]['state'] ?? 'open') === 'closed') {
                    $patch['state'] = 'open';
                }
-                $this->api->patch("/repos/{$org}/mokoplatform/issues/{$num}", $patch);
+                $this->api->patch("/repos/{$org}/mokocli/issues/{$num}", $patch);
-                $this->log("🚨 Failure issue #{$num} updated: {$org}/mokoplatform#{$num}", 'WARN');
+                $this->log("🚨 Failure issue #{$num} updated: {$org}/mokocli#{$num}", 'WARN');
            } else {
-                $issue = $this->api->post("/repos/{$org}/mokoplatform/issues", [
+                $issue = $this->api->post("/repos/{$org}/mokocli/issues", [
                    'title'     => $title,
                    'body'      => $body,
                    'labels'    => ['push-failure'],
                    'assignees' => ['jmiller'],
                ]);
                $num = $issue['number'] ?? '?';
-                $this->log("🚨 Failure issue created: {$org}/mokoplatform#{$num}", 'WARN');
+                $this->log("🚨 Failure issue created: {$org}/mokocli#{$num}", 'WARN');
            }
        } catch (\Exception $e) {
            $this->log("⚠️  Could not create/update failure issue: " . $e->getMessage(), 'WARN');
@@ -638,14 +638,14 @@ class PushFiles extends CliFramework
    private function buildPRBody(array $entries): string
    {
        $now   = gmdate('Y-m-d H:i:s') . ' UTC';
-        $lines = ["## mokoplatform File Push\n", "**Pushed:** {$now}\n", '### Files\n'];
+        $lines = ["## mokocli File Push\n", "**Pushed:** {$now}\n", '### Files\n'];
        foreach ($entries as $entry) {
            $lines[] = "- `{$entry['destination']}`";
        }
-        $sourceUrl = $this->adapter->getRepoWebUrl(self::DEFAULT_ORG, 'mokoplatform');
+        $sourceUrl = $this->adapter->getRepoWebUrl(self::DEFAULT_ORG, 'mokocli');
-        $lines[] = "\n---\n*Generated by [mokoplatform]({$sourceUrl}) `push_files.php`*";
+        $lines[] = "\n---\n*Generated by [mokocli]({$sourceUrl}) `push_files.php`*";
        return implode("\n", $lines);
    }
@@ -8,7 +8,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/push_manifest_xml.php
 * BRIEF: Push XML manifests to all governed repositories
 */
@@ -18,8 +18,8 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\MokoStandardsParser;
+use MokoCli\ManifestParser;
 class PushManifestXmlCli extends CliFramework
 {
@@ -44,10 +44,10 @@ class PushManifestXmlCli extends CliFramework
        $skipStr    = $this->getArgument('--skip');
        $skipRepos  = $skipStr !== '' ? array_map('trim', explode(',', $skipStr)) : [];
-        $parser = new MokoStandardsParser();
+        $parser = new ManifestParser();
        $tmpBase = sys_get_temp_dir() . '/moko-manifest-push-' . getmypid();
-        echo "=== mokoplatform XML Manifest Push ===\n";
+        echo "=== mokocli XML Manifest Push ===\n";
        echo "Org: {$giteaOrg}\n";
        echo "Mode: " . ($this->dryRun ? "DRY RUN" : "LIVE") . "\n";
        if ($repoFilter) {
@@ -97,8 +97,8 @@ class PushManifestXmlCli extends CliFramework
                'description'       => $repo['description'] ?? '',
                'license'           => 'GPL-3.0-or-later',
                'topics'            => $repo['topics'] ?? [],
-                'language'          => $repo['language'] ?? MokoStandardsParser::platformLanguage($platform),
+                'language'          => $repo['language'] ?? ManifestParser::platformLanguage($platform),
-                'package_type'      => MokoStandardsParser::platformPackageType($platform),
+                'package_type'      => ManifestParser::platformPackageType($platform),
                'last_synced'       => date('c'),
            ]);
@@ -125,7 +125,7 @@ class PushManifestXmlCli extends CliFramework
            // Check if already XML and up-to-date
            $manifestPath = "{$workDir}/.mokogitea/manifest.xml";
-            $existingIsXml = file_exists($manifestPath) && str_contains(file_get_contents($manifestPath), '<mokoplatform');
+            $existingIsXml = file_exists($manifestPath) && str_contains(file_get_contents($manifestPath), '<mokocli');
            if ($existingIsXml && !$force) {
                $existingPlatform = $parser->extractPlatform(file_get_contents($manifestPath));
                if ($existingPlatform === $platform) {
@@ -8,7 +8,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/push_mokostandards_xml.php
 * BRIEF: Push XML manifests to all governed repositories
 */
@@ -18,8 +18,8 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\MokoStandardsParser;
+use MokoCli\ManifestParser;
 class PushMokostandardsXmlCli extends CliFramework
 {
@@ -44,10 +44,10 @@ class PushMokostandardsXmlCli extends CliFramework
        $skipStr    = $this->getArgument('--skip');
        $skipRepos  = $skipStr !== '' ? array_map('trim', explode(',', $skipStr)) : [];
-        $parser = new MokoStandardsParser();
+        $parser = new ManifestParser();
        $tmpBase = sys_get_temp_dir() . '/moko-manifest-push-' . getmypid();
-        echo "=== mokoplatform XML Manifest Push ===\n";
+        echo "=== mokocli XML Manifest Push ===\n";
        echo "Org: {$giteaOrg}\n";
        echo "Mode: " . ($this->dryRun ? "DRY RUN" : "LIVE") . "\n";
        if ($repoFilter) {
@@ -97,8 +97,8 @@ class PushMokostandardsXmlCli extends CliFramework
                'description'       => $repo['description'] ?? '',
                'license'           => 'GPL-3.0-or-later',
                'topics'            => $repo['topics'] ?? [],
-                'language'          => $repo['language'] ?? MokoStandardsParser::platformLanguage($platform),
+                'language'          => $repo['language'] ?? ManifestParser::platformLanguage($platform),
-                'package_type'      => MokoStandardsParser::platformPackageType($platform),
+                'package_type'      => ManifestParser::platformPackageType($platform),
                'last_synced'       => date('c'),
            ]);
@@ -125,7 +125,7 @@ class PushMokostandardsXmlCli extends CliFramework
            // Check if already XML and up-to-date
            $manifestPath = "{$workDir}/.mokogitea/manifest.xml";
-            $existingIsXml = file_exists($manifestPath) && str_contains(file_get_contents($manifestPath), '<mokoplatform');
+            $existingIsXml = file_exists($manifestPath) && str_contains(file_get_contents($manifestPath), '<mokocli');
            if ($existingIsXml && !$force) {
                $existingPlatform = $parser->extractPlatform(file_get_contents($manifestPath));
                if ($existingPlatform === $platform) {
@@ -11,7 +11,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform.Scripts
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/repo_cleanup.php
 * BRIEF: Enterprise repository cleanup — branches, PRs, issues, workflows, labels, logs
 */
@@ -21,7 +21,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{ApiClient, AuditLogger, CliFramework, Config, GitPlatformAdapter, MetricsCollector, PlatformAdapterFactory};
+use MokoCli\{ApiClient, AuditLogger, CliFramework, Config, GitPlatformAdapter, MetricsCollector, PlatformAdapterFactory};
 /**
 * Enterprise Repository Cleanup
@@ -39,14 +39,14 @@ use MokoEnterprise\{ApiClient, AuditLogger, CliFramework, Config, GitPlatformAda
 class RepoCleanup extends CliFramework
 {
    private const VERSION        = '09.23.00';
-    private const SYNC_PREFIX    = 'chore/sync-mokoplatform-';
+    private const SYNC_PREFIX    = 'chore/sync-mokocli-';
-    private const CURRENT_BRANCH = 'chore/sync-mokoplatform-v04.02.00';
+    private const CURRENT_BRANCH = 'chore/sync-mokocli-v04.02.00';
    /** Workflow files that have been retired and should be deleted from governed repos. */
    private const RETIRED_WORKFLOWS = [
        'build.yml', 'code-quality.yml', 'release-cycle.yml', 'release-pipeline.yml',
        'branch-cleanup.yml', 'auto-update-changelog.yml', 'enterprise-issue-manager.yml',
-        'flush-actions-cache.yml', 'mokoplatform-script-runner.yml', 'unified-ci.yml',
+        'flush-actions-cache.yml', 'mokocli-script-runner.yml', 'unified-ci.yml',
        'unified-platform-testing.yml', 'reusable-build.yml', 'reusable-ci-validation.yml',
        'reusable-deploy.yml', 'reusable-php-quality.yml', 'reusable-platform-testing.yml',
        'reusable-project-detector.yml', 'reusable-release.yml', 'reusable-script-executor.yml',
@@ -98,7 +98,7 @@ class RepoCleanup extends CliFramework
        }
-        $this->logMsg("🧹 mokoplatform Repository Cleanup v" . self::VERSION);
+        $this->logMsg("🧹 mokocli Repository Cleanup v" . self::VERSION);
        $this->logMsg("Organization: {$org}");
        $this->logMsg("Current sync branch: " . self::CURRENT_BRANCH);
        if ($this->dryRun) {
@@ -225,7 +225,7 @@ class RepoCleanup extends CliFramework
        }
        $allRepos = $this->adapter->listOrgRepos($org, $skipArchived);
-        return array_filter($allRepos, fn($r) => !in_array($r['name'], ['mokoplatform', '.github-private'], true));
+        return array_filter($allRepos, fn($r) => !in_array($r['name'], ['mokocli', '.github-private'], true));
    }
    // ─── Cleanup operations ──────────────────────────────────────────────
@@ -463,9 +463,9 @@ class RepoCleanup extends CliFramework
    private function checkLabels(string $org, string $repo, array &$results): void
    {
        try {
-            $this->api->get("/repos/{$org}/{$repo}/labels/mokoplatform");
+            $this->api->get("/repos/{$org}/{$repo}/labels/mokocli");
        } catch (\Exception $e) {
-            $this->logMsg("  ⚠️  Missing 'mokoplatform' label");
+            $this->logMsg("  ⚠️  Missing 'mokocli' label");
            $results['labels_missing']++;
            $this->api->resetCircuitBreaker();
        }
@@ -479,7 +479,7 @@ class RepoCleanup extends CliFramework
            if (preg_match('/^\s*VERSION:\s*(\d{2}\.\d{2}\.\d{2})/m', $content, $m)) {
                $version = $m[1];
-                // Check manifest.xml for the tracked mokoplatform version
+                // Check manifest.xml for the tracked mokocli version
                try {
                    $mokoFile = $this->api->get("/repos/{$org}/{$repo}/contents/.mokogitea/manifest.xml");
                    $mokoContent = base64_decode($mokoFile['content'] ?? '');
@@ -6,7 +6,7 @@
 #
 # DEFGROUP: MokoPlatform.Automation.ServerAutoheal
 # INGROUP:  MokoPlatform.Automation
-# REPO:     https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# REPO:     https://git.mokoconsulting.tech/MokoConsulting/mokocli
 # PATH:     /automation/server-autoheal.sh
 # BRIEF:    Server auto-heal on unclean restart + split system/content backups
 #
@@ -0,0 +1,633 @@
 #!/usr/bin/env php
 <?php
 /**
 * Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 *
 * This file is part of a Moko Consulting project.
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Automation
 * INGROUP: MokoPlatform.Scripts
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /automation/update_dependencies.php
 * VERSION: 09.37.01
 * BRIEF: Cross-repo dependency update automation — scan, update, PR, auto-merge
 */
 declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 use MokoCli\{
    ApiClient,
    AuditLogger,
    CheckpointManager,
    CircuitBreakerOpen,
    CliFramework,
    Config,
    GitPlatformAdapter,
    PlatformAdapterFactory,
    RateLimitExceeded
 };
 /**
 * Cross-Repo Dependency Update Automation
 *
 * Scans org repos for outdated Composer/npm dependencies, creates PRs with
 * changelogs, and optionally auto-merges safe patch updates.
 *
 * @see https://git.mokoconsulting.tech/MokoConsulting/mokocli/issues/149
 */
 class UpdateDependencies extends CliFramework
 {
    public const VERSION = '01.00.00';
    private const BRANCH_PREFIX = 'chore/deps-update';
    private ApiClient $api;
    private GitPlatformAdapter $adapter;
    private AuditLogger $logger;
    private CheckpointManager $checkpoints;
    /** Summary counters. */
    private int $reposScanned  = 0;
    private int $reposUpdated  = 0;
    private int $prsCreated    = 0;
    private int $autoMerged    = 0;
    private int $reposFailed   = 0;
    protected function configure(): void
    {
        $this->setDescription('Cross-repo dependency update automation');
        $this->addArgument('--org',           'Organization to scan',                         'MokoConsulting');
        $this->addArgument('--repos',         'Comma-separated list of specific repos',       '');
        $this->addArgument('--exclude',       'Comma-separated list of repos to exclude',     '');
        $this->addArgument('--skip-archived', 'Skip archived repositories',                   true);
        $this->addArgument('--type',          'Dependency type: composer, npm, or all',       'all');
        $this->addArgument('--patch-only',    'Only update patch versions (safe updates)',     false);
        $this->addArgument('--auto-merge',    'Auto-merge PRs with only patch updates',       false);
        $this->addArgument('--resume',        'Resume from checkpoint',                       false);
    }
    protected function run(): int
    {
        $this->log("Dependency Update Automation v" . self::VERSION, 'INFO');
        if (!$this->initComponents()) {
            return self::EXIT_FAILURE;
        }
        $org       = $this->getArgument('--org', 'MokoConsulting');
        $depType   = strtolower($this->getArgument('--type', 'all'));
        $patchOnly = $this->getArgument('--patch-only', false);
        $autoMerge = $this->getArgument('--auto-merge', false);
        // ── Gather repos ─────────────────────────────────────────────────
        $repos = $this->gatherRepos($org);
        if ($repos === null) {
            return self::EXIT_FAILURE;
        }
        $total = count($repos);
        $this->log("Found {$total} repositories to scan", 'INFO');
        // ── Resume support ───────────────────────────────────────────────
        $completed = [];
        if ($this->getArgument('--resume', false)) {
            $checkpoint = $this->checkpoints->load('deps_update');
            if ($checkpoint) {
                $completed = $checkpoint['completed'] ?? [];
                $this->log("Resuming — skipping " . count($completed) . " already-processed repos", 'INFO');
            }
        }
        // ── Process each repo ────────────────────────────────────────────
        $this->section('Scanning repositories for outdated dependencies');
        foreach ($repos as $i => $repo) {
            $repoName = $repo['name'];
            $this->progress($i + 1, $total, $repoName);
            if (in_array($repoName, $completed, true)) {
                continue;
            }
            try {
                $this->processRepo($org, $repoName, $depType, $patchOnly, $autoMerge);
                $completed[] = $repoName;
                $this->checkpoints->save('deps_update', ['completed' => $completed]);
            } catch (RateLimitExceeded $e) {
                $this->log("Rate limit hit — checkpoint saved", 'WARNING');
                break;
            } catch (CircuitBreakerOpen $e) {
                $this->log("Circuit breaker open — checkpoint saved", 'WARNING');
                break;
            } catch (\Exception $e) {
                $this->log("Failed {$repoName}: {$e->getMessage()}", 'ERROR');
                $this->reposFailed++;
            }
        }
        $this->progress($total, $total, '', true);
        // ── Summary ──────────────────────────────────────────────────────
        $this->section('Summary');
        $this->printSummary(
            $this->reposScanned - $this->reposFailed,
            $this->reposFailed,
            $this->elapsed()
        );
        $this->log("Repos scanned: {$this->reposScanned}", 'INFO');
        $this->log("Repos updated: {$this->reposUpdated}", 'INFO');
        $this->log("PRs created:   {$this->prsCreated}", 'INFO');
        if ($autoMerge) {
            $this->log("Auto-merged:   {$this->autoMerged}", 'INFO');
        }
        if (count($completed) === $total) {
            $this->checkpoints->clear('deps_update');
        }
        return $this->reposFailed > 0 ? self::EXIT_FAILURE : self::EXIT_SUCCESS;
    }
    // ── Component init ───────────────────────────────────────────────────
    private function initComponents(): bool
    {
        try {
            $config            = new Config();
            $this->api         = new ApiClient($config);
            $this->adapter     = PlatformAdapterFactory::create($this->api, $config);
            $this->logger      = new AuditLogger();
            $this->checkpoints = new CheckpointManager();
            return true;
        } catch (\Exception $e) {
            $this->log("Failed to initialise: {$e->getMessage()}", 'ERROR');
            return false;
        }
    }
    // ── Repo gathering ───────────────────────────────────────────────────
    private function gatherRepos(string $org): ?array
    {
        $specificRepos = array_filter(explode(',', $this->getArgument('--repos', '')));
        $excludeRepos  = array_filter(explode(',', $this->getArgument('--exclude', '')));
        $skipArchived  = $this->getArgument('--skip-archived', true);
        // Default exclusions
        $excludeRepos = array_merge($excludeRepos, [
            'mokocli', '.mokogitea-private', 'org-profile',
        ]);
        try {
            $repos = $this->adapter->listOrgRepos($org, $skipArchived);
        } catch (\Exception $e) {
            $this->log("Failed to list repos: {$e->getMessage()}", 'ERROR');
            return null;
        }
        if (!empty($specificRepos)) {
            $repos = array_filter($repos, fn($r) => in_array($r['name'], $specificRepos, true));
        }
        if (!empty($excludeRepos)) {
            $repos = array_filter($repos, fn($r) => !in_array($r['name'], $excludeRepos, true));
        }
        return array_values($repos);
    }
    // ── Per-repo processing ──────────────────────────────────────────────
    private function processRepo(
        string $org,
        string $repoName,
        string $depType,
        bool $patchOnly,
        bool $autoMerge
    ): void {
        $this->reposScanned++;
        $hasComposer = ($depType === 'all' || $depType === 'composer');
        $hasNpm      = ($depType === 'all' || $depType === 'npm');
        $outdated = [];
        // ── Composer ─────────────────────────────────────────────────
        if ($hasComposer) {
            $composerOutdated = $this->scanComposer($org, $repoName, $patchOnly);
            if ($composerOutdated !== null) {
                $outdated['composer'] = $composerOutdated;
            }
        }
        // ── npm ──────────────────────────────────────────────────────
        if ($hasNpm) {
            $npmOutdated = $this->scanNpm($org, $repoName, $patchOnly);
            if ($npmOutdated !== null) {
                $outdated['npm'] = $npmOutdated;
            }
        }
        if (empty($outdated)) {
            return;
        }
        // Check if there's already an open deps PR
        if ($this->hasExistingDepsPR($org, $repoName)) {
            $this->log("  {$repoName}: existing deps PR found — skipping", 'INFO');
            return;
        }
        $this->reposUpdated++;
        // ── Create PR ────────────────────────────────────────────────
        $totalUpdates = 0;
        $allPatchOnly = true;
        foreach ($outdated as $type => $packages) {
            $totalUpdates += count($packages);
            foreach ($packages as $pkg) {
                if (!$this->isPatchUpdate($pkg['current'] ?? '', $pkg['latest'] ?? '')) {
                    $allPatchOnly = false;
                }
            }
        }
        $title = "chore(deps): update {$totalUpdates} " . ($totalUpdates === 1 ? 'dependency' : 'dependencies');
        $body  = $this->buildPrBody($repoName, $outdated);
        $branch = self::BRANCH_PREFIX . '-' . date('Y-m-d');
        if ($this->dryRun) {
            $this->log("[dry-run] Would create PR in {$repoName}: {$title}", 'INFO');
            foreach ($outdated as $type => $packages) {
                foreach ($packages as $pkg) {
                    $this->log("  [{$type}] {$pkg['name']}: {$pkg['current']} → {$pkg['latest']}", 'INFO');
                }
            }
            return;
        }
        try {
            // Clone repo, run updates, push branch
            $prNumber = $this->cloneUpdateAndPR($org, $repoName, $branch, $title, $body, $outdated);
            if ($prNumber > 0) {
                $this->prsCreated++;
                $this->log("  {$repoName}: PR #{$prNumber} created", 'INFO');
                // Auto-merge if all updates are patch-level
                if ($autoMerge && $allPatchOnly && $prNumber > 0) {
                    $this->tryAutoMerge($org, $repoName, $prNumber);
                }
            }
        } catch (\Exception $e) {
            $this->log("  {$repoName}: PR creation failed — {$e->getMessage()}", 'ERROR');
        }
    }
    // ── Composer scanning ────────────────────────────────────────────────
    private function scanComposer(string $org, string $repoName, bool $patchOnly): ?array
    {
        // Check if repo has composer.json
        try {
            $this->adapter->getFileContents($org, $repoName, 'composer.json');
        } catch (\Exception $e) {
            return null;
        }
        // Check if repo has composer.lock
        try {
            $this->adapter->getFileContents($org, $repoName, 'composer.lock');
        } catch (\Exception $e) {
            return null;
        }
        // Clone to temp dir and run composer outdated
        $tmpDir = sys_get_temp_dir() . '/moko_deps_' . $repoName . '_' . getmypid();
        @mkdir($tmpDir, 0700, true);
        try {
            $cloneUrl = $this->adapter->getCloneUrl($org, $repoName);
            $cmd = sprintf(
                'git clone --depth 1 --quiet %s %s 2>/dev/null',
                escapeshellarg($cloneUrl),
                escapeshellarg($tmpDir)
            );
            exec($cmd, $output, $exitCode);
            if ($exitCode !== 0) {
                return null;
            }
            // Run composer outdated
            $flags = $patchOnly ? '--minor-only' : '';
            $cmd = sprintf(
                'composer outdated --format=json --no-interaction %s --working-dir=%s 2>/dev/null',
                $flags,
                escapeshellarg($tmpDir)
            );
            $json = shell_exec($cmd);
            if ($json === null || $json === '') {
                return null;
            }
            $data = json_decode($json, true);
            $installed = $data['installed'] ?? [];
            if (empty($installed)) {
                return null;
            }
            $outdated = [];
            foreach ($installed as $pkg) {
                // Skip abandoned/dev packages
                if (($pkg['abandoned'] ?? false) || str_starts_with($pkg['version'] ?? '', 'dev-')) {
                    continue;
                }
                $outdated[] = [
                    'name'    => $pkg['name'] ?? '',
                    'current' => $pkg['version'] ?? '',
                    'latest'  => $pkg['latest'] ?? '',
                    'status'  => $pkg['latest-status'] ?? 'unknown',
                ];
            }
            return empty($outdated) ? null : $outdated;
        } finally {
            // Cleanup
            if (is_dir($tmpDir)) {
                exec(sprintf('rm -rf %s', escapeshellarg($tmpDir)));
            }
        }
    }
    // ── npm scanning ─────────────────────────────────────────────────────
    private function scanNpm(string $org, string $repoName, bool $patchOnly): ?array
    {
        // Check if repo has package.json
        try {
            $this->adapter->getFileContents($org, $repoName, 'package.json');
        } catch (\Exception $e) {
            return null;
        }
        // Check for lock file
        $hasLock = false;
        foreach (['package-lock.json', 'yarn.lock', 'pnpm-lock.yaml'] as $lockFile) {
            try {
                $this->adapter->getFileContents($org, $repoName, $lockFile);
                $hasLock = true;
                break;
            } catch (\Exception $e) {
                // continue
            }
        }
        if (!$hasLock) {
            return null;
        }
        $tmpDir = sys_get_temp_dir() . '/moko_deps_npm_' . $repoName . '_' . getmypid();
        @mkdir($tmpDir, 0700, true);
        try {
            $cloneUrl = $this->adapter->getCloneUrl($org, $repoName);
            exec(sprintf('git clone --depth 1 --quiet %s %s 2>/dev/null',
                escapeshellarg($cloneUrl), escapeshellarg($tmpDir)));
            if (!file_exists("{$tmpDir}/package.json")) {
                return null;
            }
            // Install deps first (needed for npm outdated)
            exec(sprintf('cd %s && npm install --silent 2>/dev/null', escapeshellarg($tmpDir)));
            $json = shell_exec(sprintf('cd %s && npm outdated --json 2>/dev/null', escapeshellarg($tmpDir)));
            if ($json === null || $json === '' || $json === '{}') {
                return null;
            }
            $data = json_decode($json, true);
            if (!is_array($data) || empty($data)) {
                return null;
            }
            $outdated = [];
            foreach ($data as $name => $info) {
                $current = $info['current'] ?? '';
                $wanted  = $info['wanted'] ?? '';
                $latest  = $info['latest'] ?? '';
                $target  = $patchOnly ? $wanted : $latest;
                if ($current === $target || $target === '') {
                    continue;
                }
                $outdated[] = [
                    'name'    => $name,
                    'current' => $current,
                    'latest'  => $target,
                    'status'  => ($current === $wanted) ? 'up-to-date' : 'outdated',
                ];
            }
            return empty($outdated) ? null : $outdated;
        } finally {
            if (is_dir($tmpDir)) {
                exec(sprintf('rm -rf %s', escapeshellarg($tmpDir)));
            }
        }
    }
    // ── PR creation ──────────────────────────────────────────────────────
    private function cloneUpdateAndPR(
        string $org,
        string $repoName,
        string $branch,
        string $title,
        string $body,
        array $outdated
    ): int {
        $tmpDir = sys_get_temp_dir() . '/moko_deps_pr_' . $repoName . '_' . getmypid();
        @mkdir($tmpDir, 0700, true);
        try {
            $cloneUrl = $this->adapter->getCloneUrl($org, $repoName);
            exec(sprintf('git clone --quiet %s %s 2>/dev/null',
                escapeshellarg($cloneUrl), escapeshellarg($tmpDir)));
            // Create branch
            exec(sprintf('git -C %s checkout -b %s 2>/dev/null',
                escapeshellarg($tmpDir), escapeshellarg($branch)));
            $updated = false;
            // Run composer update if needed
            if (isset($outdated['composer'])) {
                $packages = array_column($outdated['composer'], 'name');
                $cmd = sprintf(
                    'cd %s && composer update %s --no-interaction --quiet 2>/dev/null',
                    escapeshellarg($tmpDir),
                    implode(' ', array_map('escapeshellarg', $packages))
                );
                exec($cmd, $output, $exitCode);
                if ($exitCode === 0) {
                    $updated = true;
                }
            }
            // Run npm update if needed
            if (isset($outdated['npm'])) {
                $packages = array_column($outdated['npm'], 'name');
                $cmd = sprintf(
                    'cd %s && npm update %s --save 2>/dev/null',
                    escapeshellarg($tmpDir),
                    implode(' ', array_map('escapeshellarg', $packages))
                );
                exec($cmd, $output, $exitCode);
                if ($exitCode === 0) {
                    $updated = true;
                }
            }
            if (!$updated) {
                return 0;
            }
            // Commit and push
            exec(sprintf('git -C %s config user.email "gitea-actions[bot]@mokoconsulting.tech"', escapeshellarg($tmpDir)));
            exec(sprintf('git -C %s config user.name "gitea-actions[bot]"', escapeshellarg($tmpDir)));
            exec(sprintf('git -C %s add -A', escapeshellarg($tmpDir)));
            // Check if there are actual changes
            exec(sprintf('git -C %s diff --cached --quiet', escapeshellarg($tmpDir)), $output, $diffExit);
            if ($diffExit === 0) {
                return 0; // No changes
            }
            exec(sprintf('git -C %s commit -m %s',
                escapeshellarg($tmpDir),
                escapeshellarg($title . " [skip ci]")));
            exec(sprintf('git -C %s push origin %s 2>/dev/null',
                escapeshellarg($tmpDir), escapeshellarg($branch)), $output, $pushExit);
            if ($pushExit !== 0) {
                $this->log("  {$repoName}: push failed", 'ERROR');
                return 0;
            }
            // Create PR via API
            $defaultBranch = $this->getDefaultBranch($org, $repoName);
            $pr = $this->adapter->createPullRequest(
                $org, $repoName, $title, $branch, $defaultBranch, $body, [
                    'labels' => ['dependencies'],
                ]
            );
            return (int) ($pr['number'] ?? 0);
        } finally {
            if (is_dir($tmpDir)) {
                exec(sprintf('rm -rf %s', escapeshellarg($tmpDir)));
            }
        }
    }
    // ── Auto-merge ───────────────────────────────────────────────────────
    private function tryAutoMerge(string $org, string $repoName, int $prNumber): void
    {
        try {
            $this->api->put(
                "/repos/{$org}/{$repoName}/pulls/{$prNumber}/merge",
                ['Do' => 'squash', 'merge_message_field' => 'chore(deps): auto-merge patch updates']
            );
            $this->autoMerged++;
            $this->log("  {$repoName}: PR #{$prNumber} auto-merged", 'INFO');
        } catch (\Exception $e) {
            $this->log("  {$repoName}: auto-merge failed — {$e->getMessage()}", 'WARNING');
        }
    }
    // ── Helpers ───────────────────────────────────────────────────────────
    private function hasExistingDepsPR(string $org, string $repoName): bool
    {
        try {
            $prs = $this->adapter->listPullRequests($org, $repoName, ['state' => 'open']);
            foreach ($prs as $pr) {
                if (str_starts_with($pr['head']['ref'] ?? '', self::BRANCH_PREFIX)) {
                    return true;
                }
            }
        } catch (\Exception $e) {
            // Ignore — proceed with creating PR
        }
        return false;
    }
    private function getDefaultBranch(string $org, string $repoName): string
    {
        try {
            $repo = $this->api->get("/repos/{$org}/{$repoName}");
            return $repo['default_branch'] ?? 'main';
        } catch (\Exception $e) {
            return 'main';
        }
    }
    private function isPatchUpdate(string $current, string $latest): bool
    {
        $cur = explode('.', ltrim($current, 'v'));
        $lat = explode('.', ltrim($latest, 'v'));
        if (count($cur) < 3 || count($lat) < 3) {
            return false;
        }
        // Same major and minor, only patch differs
        return $cur[0] === $lat[0] && $cur[1] === $lat[1] && $cur[2] !== $lat[2];
    }
    private function buildPrBody(string $repoName, array $outdated): string
    {
        $lines = [
            "## Dependency Updates",
            "",
            "**Repository**: `{$repoName}`",
            "**Scanned**: " . date('Y-m-d H:i:s'),
            "",
        ];
        foreach ($outdated as $type => $packages) {
            $lines[] = "### " . ucfirst($type);
            $lines[] = "";
            $lines[] = "| Package | Current | Latest | Type |";
            $lines[] = "|---------|---------|--------|------|";
            foreach ($packages as $pkg) {
                $updateType = $this->isPatchUpdate($pkg['current'], $pkg['latest']) ? 'patch' : 'minor/major';
                $lines[] = "| `{$pkg['name']}` | {$pkg['current']} | {$pkg['latest']} | {$updateType} |";
            }
            $lines[] = "";
        }
        $lines[] = "---";
        $lines[] = "*Auto-generated by `moko deps:update`*";
        return implode("\n", $lines);
    }
 }
 $script = new UpdateDependencies('update_dependencies', 'Cross-repo dependency update automation');
 exit($script->execute());
@@ -9,11 +9,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: MokoStandards.CLI
+ * DEFGROUP: MokoCli.CLI
- * INGROUP: MokoStandards
+ * INGROUP: MokoCli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /bin/moko
- * BRIEF: Unified CLI dispatcher — run any MokoStandards script without needing GitHub Actions
+ * BRIEF: Unified CLI dispatcher — run any MokoCli script without needing GitHub Actions
 *
 * USAGE
 *   php bin/moko <command> [options]     (all platforms)
@@ -89,6 +89,7 @@ const COMMAND_MAP = [
    // Automation
    'sync'                        => 'automation/bulk_sync.php',
    'deps:update'                 => 'automation/update_dependencies.php',
    'automation:cleanup'          => 'automation/repo_cleanup.php',
    'automation:migrate-gitea'    => 'automation/migrate_to_gitea.php',
@@ -177,6 +178,7 @@ const COMMAND_MAP = [
    'repo:archive'         => 'cli/archive_repo.php',
    'repo:scaffold-client' => 'cli/scaffold_client.php',
    'repo:provision'       => 'cli/client_provision.php',
    'repo:wizard'          => 'cli/repo_wizard.php',
    'repo:rename-branch'   => 'cli/branch_rename.php',
    'repo:reset-dev'       => 'cli/dev_branch_reset.php',
@@ -198,6 +200,7 @@ const COMMAND_MAP = [
    'deploy:sftp'          => 'deploy/deploy-sftp.php',
    'deploy:backup'        => 'deploy/backup-before-deploy.php',
    'deploy:health-check'  => 'deploy/health-check.php',
    'deploy:verify'        => 'deploy/deploy-and-verify.php',
    'deploy:rollback'      => 'deploy/rollback-joomla.php',
    'deploy:sync'          => 'deploy/sync-joomla.php',
@@ -220,6 +223,9 @@ const COMMAND_MAP = [
    // Licensing
    'license'              => 'cli/license_manage.php',
    // Security
    'security:advisories'  => 'security/advisory_scan.php',
    // Shell completion
    'completion'           => 'cli/completion.php',
@@ -292,10 +298,10 @@ function printHelp(): void
 {
    echo <<<'HELP'
 ╔══════════════════════════════════════════════════════════╗
-║              MokoStandards CLI  (bin/moko)               ║
+║              MokoCli CLI  (bin/moko)               ║
 ╚══════════════════════════════════════════════════════════╝
-Run any MokoStandards script locally without GitHub Actions.
+Run any MokoCli script locally without GitHub Actions.
 USAGE
  php bin/moko <command> [options]     (all platforms)
@@ -397,7 +403,7 @@ function loadPluginCommands(): array
    $commands = [];
    foreach (glob("{$pluginDir}/*Plugin.php") as $file) {
-        $className = 'MokoEnterprise\\Plugins\\'
+        $className = 'MokoCli\\Plugins\\'
            . pathinfo($file, PATHINFO_FILENAME);
        if (!class_exists($className)) {
@@ -8,9 +8,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/archive_repo.php
 * BRIEF: Gracefully retire a governed repository — archive, close issues/PRs, remove sync def
 */
@@ -20,9 +20,9 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\Config;
+use MokoCli\Config;
-use MokoEnterprise\PlatformAdapterFactory;
+use MokoCli\PlatformAdapterFactory;
 class ArchiveRepoCli extends CliFramework
 {
@@ -135,7 +135,7 @@ class ArchiveRepoCli extends CliFramework
            try {
                $issue = $adapter->createIssue(
                    $org,
-                    'mokoplatform',
+                    'mokocli',
                    "chore: archived repository {$repoName}",
                    "## Repository Archived\n\n"
                    . "**Repository:** `{$org}/{$repoName}`\n"
@@ -150,7 +150,7 @@ class ArchiveRepoCli extends CliFramework
                    ]
                );
                if (isset($issue['number'])) {
-                    echo "  Archival record: mokoplatform#{$issue['number']}\n";
+                    echo "  Archival record: mokocli#{$issue['number']}\n";
                }
            } catch (\Exception $e) {
                echo "  Warning: could not create archival record: " . $e->getMessage() . "\n";
@@ -16,7 +16,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.Enterprise.CLI
 * INGROUP: MokoPlatform.Enterprise
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/audit_query.php
 * BRIEF: Search, filter, and export audit logs
 */
@@ -25,7 +25,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 /**
 * CLI tool to search, filter, and export audit logs.
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/badge_update.php
 * BRIEF: Update [VERSION: XX.XX.XX] badges in all markdown files
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class BadgeUpdateCli extends CliFramework
 {
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/branch_rename.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Rename a git branch via Gitea API (create new, update PR, delete old)
 */
@@ -18,7 +18,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class BranchRenameCli extends CliFramework
 {
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/bulk_workflow_push.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Push a workflow file to all governed repos via the Gitea Contents API
 */
@@ -20,7 +20,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class BulkWorkflowPushCli extends CliFramework
 {
@@ -154,7 +154,7 @@ class BulkWorkflowPushCli extends CliFramework
                'content' => $encodedContent,
                'sha' => $remoteSha,
                'message' => "chore: sync {$destPath} "
-                    . "from mokoplatform [skip ci]",
+                    . "from mokocli [skip ci]",
                'branch' => $branch,
            ]);
@@ -184,7 +184,7 @@ class BulkWorkflowPushCli extends CliFramework
            $payload = json_encode([
                'content' => $encodedContent,
                'message' => "chore: add {$destPath} "
-                    . "from mokoplatform [skip ci]",
+                    . "from mokocli [skip ci]",
                'branch' => $branch,
            ]);
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/bulk_workflow_trigger.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Trigger a workflow across multiple repos at once
 */
@@ -20,7 +20,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class BulkWorkflowTriggerCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/changelog_promote.php
 * BRIEF: Promote [Unreleased] section in CHANGELOG.md to a versioned entry
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ChangelogPromoteCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/changelog_prune.php
 * BRIEF: Prune old CHANGELOG.md entries — keeps [Unreleased] + last N releases
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ChangelogPruneCli extends CliFramework
 {
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/client_dashboard.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Generate unified client dashboard HTML
 */
@@ -20,7 +20,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ClientDashboardCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/client_health_check.php
 * BRIEF: Verify a client site's update server, installed version, and release availability
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ClientHealthCheckCli extends CliFramework
 {
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/client_inventory.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Discover and list all client-waas repos with their server configuration status
 */
@@ -20,7 +20,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ClientInventoryCli extends CliFramework
 {
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/client_provision.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Provision a new client environment end-to-end
 */
@@ -20,7 +20,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ClientProvisionCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/completion.php
 * BRIEF: Generate bash/zsh tab completion scripts for bin/moko
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class CompletionCli extends CliFramework
 {
@@ -8,9 +8,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/create_project.php
 * BRIEF: Create baseline GitHub Projects for repositories with standard fields and views
 */
@@ -19,12 +19,12 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class CreateProjectCli extends CliFramework
 {
    /** @var string[] */
-    private array $ALWAYS_EXCLUDE = ['mokoplatform', '.github-private'];
+    private array $ALWAYS_EXCLUDE = ['mokocli', '.github-private'];
    /** @var array<string, string> */
    private array $PLATFORM_TO_TYPE = [
@@ -80,10 +80,10 @@ class CreateProjectCli extends CliFramework
            return 2;
        }
-        $config   = \MokoEnterprise\Config::load();
+        $config   = \MokoCli\Config::load();
        $platformName = $config->getString('platform', 'gitea');
        try {
-            $adapter = \MokoEnterprise\PlatformAdapterFactory::create($config);
+            $adapter = \MokoCli\PlatformAdapterFactory::create($config);
            $api     = $adapter->getApiClient();
        } catch (\Exception $e) {
            $this->log('ERROR', "Platform initialization failed: " . $e->getMessage());
@@ -183,7 +183,7 @@ class CreateProjectCli extends CliFramework
            CURLOPT_HTTPHEADER     => [
                'Authorization: bearer ' . $token,
                'Content-Type: application/json',
-                'User-Agent: mokoplatform-CreateProject',
+                'User-Agent: mokocli-CreateProject',
            ],
        ]);
        $body = (string) curl_exec($ch);
@@ -205,7 +205,7 @@ class CreateProjectCli extends CliFramework
        return $data['data'] ?? [];
    }
-    private function restGet(string $path, string $token, ?\MokoEnterprise\ApiClient $apiClient = null): array
+    private function restGet(string $path, string $token, ?\MokoCli\ApiClient $apiClient = null): array
    {
        if ($apiClient !== null) {
            try {
@@ -217,7 +217,7 @@ class CreateProjectCli extends CliFramework
        return [];
    }
-    private function detectRepoPlatform(string $org, string $repo, string $token, ?\MokoEnterprise\ApiClient $apiClient = null): string
+    private function detectRepoPlatform(string $org, string $repo, string $token, ?\MokoCli\ApiClient $apiClient = null): string
    {
        foreach (['.github/.mokostandards', '.mokogitea/.mokostandards', '.mokostandards'] as $path) {
            $data = $this->restGet("repos/{$org}/{$repo}/contents/{$path}", $token, $apiClient);
@@ -422,14 +422,14 @@ class CreateProjectCli extends CliFramework
                updateProjectV2(input: {
                    projectId: $projectId,
                    shortDescription: $shortDescription,
-                    readme: "Managed by mokoplatform. Run `php cli/create_project.php` to regenerate."
+                    readme: "Managed by mokocli. Run `php cli/create_project.php` to regenerate."
                }) {
                    projectV2 { id }
                }
            }',
            [
                'projectId'        => $projectId,
-                'shortDescription' => "Standard project board for {$repo}. Auto-created by mokoplatform.",
+                'shortDescription' => "Standard project board for {$repo}. Auto-created by mokocli.",
            ],
            $token
        );
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/create_repo.php
- * BRIEF: Scaffold a new governed repository with full mokoplatform baseline
+ * BRIEF: Scaffold a new governed repository with full mokocli baseline
 */
 declare(strict_types=1);
@@ -20,15 +20,15 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\Config;
+use MokoCli\Config;
-use MokoEnterprise\PlatformAdapterFactory;
+use MokoCli\PlatformAdapterFactory;
 class CreateRepoCli extends CliFramework
 {
    protected function configure(): void
    {
-        $this->setDescription('Scaffold a new governed repository with full mokoplatform baseline');
+        $this->setDescription('Scaffold a new governed repository with full mokocli baseline');
        $this->addArgument('--name', 'Repository name', null);
        $this->addArgument('--type', 'Project type', null);
        $this->addArgument('--description', 'Repository description', '');
@@ -60,16 +60,16 @@ class CreateRepoCli extends CliFramework
            'generic' => 'generic',
        ];
        $TYPE_TO_TOPICS = [
-            'dolibarr' => ['dolibarr', 'erp', 'crm', 'php', 'mokoplatform'],
+            'dolibarr' => ['dolibarr', 'erp', 'crm', 'php', 'mokocli'],
-            'joomla' => ['joomla', 'cms', 'php', 'mokoplatform'],
+            'joomla' => ['joomla', 'cms', 'php', 'mokocli'],
-            'nodejs' => ['nodejs', 'javascript', 'typescript', 'mokoplatform'],
+            'nodejs' => ['nodejs', 'javascript', 'typescript', 'mokocli'],
-            'terraform' => ['terraform', 'infrastructure', 'iac', 'mokoplatform'],
+            'terraform' => ['terraform', 'infrastructure', 'iac', 'mokocli'],
-            'python' => ['python', 'mokoplatform'],
+            'python' => ['python', 'mokocli'],
-            'wordpress' => ['wordpress', 'php', 'cms', 'mokoplatform'],
+            'wordpress' => ['wordpress', 'php', 'cms', 'mokocli'],
-            'generic' => ['mokoplatform'],
+            'generic' => ['mokocli'],
        ];
        $platform = $TYPE_TO_PLATFORM[$type] ?? 'generic';
-        $topics = $TYPE_TO_TOPICS[$type] ?? ['mokoplatform'];
+        $topics = $TYPE_TO_TOPICS[$type] ?? ['mokocli'];
        $platformName = $adapter->getPlatformName();
        $vis = $private ? 'private' : 'public';
        echo "Scaffolding new repository: {$org}/{$name}"
@@ -84,7 +84,7 @@ class CreateRepoCli extends CliFramework
        if (!$this->dryRun) {
            try {
                $data = $adapter->createOrgRepo($org, $name, [
-                    'description' => $description ?: "Managed by mokoplatform ({$type})",
+                    'description' => $description ?: "Managed by mokocli ({$type})",
                    'private' => $private,
                    'has_issues' => true,
                    'has_projects' => true,
@@ -138,12 +138,12 @@ class CreateRepoCli extends CliFramework
        echo "Step 4: Creating README.md...\n";
        $baseUrl = $platformName === 'gitea' ? $config->getString('gitea.url', 'https://git.mokoconsulting.tech') : 'https://github.com';
        $repoUrl = "{$baseUrl}/{$org}/{$name}";
-        $standardsUrl = "{$baseUrl}/{$org}/MokoStandards";
+        $standardsUrl = "{$baseUrl}/{$org}/MokoCli";
        $readmeContent = "<!--\n"
            . "Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>\n"
            . "SPDX-License-Identifier: GPL-3.0-or-later\n"
            . "DEFGROUP: {$name}\n"
-            . "INGROUP: mokoplatform\n"
+            . "INGROUP: mokocli\n"
            . "REPO: {$repoUrl}\n"
            . "PATH: /README.md\n"
            . "BRIEF: {$description}\n"
@@ -152,7 +152,7 @@ class CreateRepoCli extends CliFramework
            . "{$description}\n\n"
            . "## Getting Started\n\n"
            . "This repository is governed by"
-            . " [mokoplatform]({$standardsUrl}).\n\n"
+            . " [mokocli]({$standardsUrl}).\n\n"
            . "## License\n\n"
            . "GPL-3.0-or-later. See [LICENSE](LICENSE)"
            . " for details.\n";
@@ -169,7 +169,7 @@ class CreateRepoCli extends CliFramework
                $name,
                'README.md',
                $readmeContent,
-                'docs: initialize README with mokoplatform header [skip ci]',
+                'docs: initialize README with mokocli header [skip ci]',
                $sha
            );
            echo "  README.md created\n";
@@ -10,7 +10,7 @@
 * FILE INFORMATION
 * DEFGROUP: MokoPlatform.CLI
 * INGROUP: MokoPlatform
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/deploy_joomla.php
 * BRIEF: Smart Joomla deploy — routes files to correct server directories by extension type
 *
@@ -31,7 +31,7 @@ require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 use phpseclib3\Net\SFTP;
 use phpseclib3\Crypt\PublicKeyLoader;
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/dev_branch_reset.php
 * BRIEF: Delete and recreate dev branch from main via Gitea API
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class DevBranchResetCli extends CliFramework
 {
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/grafana_dashboard.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Manage Grafana dashboards via API
 */
@@ -20,7 +20,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class GrafanaDashboardCli extends CliFramework
 {
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/joomla_build.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Build a Joomla extension ZIP from manifest — all types supported
 * NOTE: Called by pre-release and auto-release workflows.
 */
@@ -19,7 +19,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class JoomlaBuildCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/joomla_compat_check.php
 * BRIEF: Check if extension targetplatform regex matches the latest Joomla version
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class JoomlaCompatCheckCli extends CliFramework
 {
@@ -0,0 +1,507 @@
 #!/usr/bin/env php
 <?php
 /* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
 * DEFGROUP: mokocli.CLI
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/joomla_metadata_validate.php
 * VERSION: 09.37.01
 * BRIEF: Validate MokoGitea repo metadata against Joomla extension manifest XML
 */
 declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
 use MokoCli\CliFramework;
 class JoomlaMetadataValidateCli extends CliFramework
 {
    /** Joomla element prefix map — must match MokoGitea's cleanJoomlaElement() */
    private const JOOMLA_PREFIX = [
        'package'   => 'pkg_',
        'component' => 'com_',
        'module'    => 'mod_',
        'template'  => 'tpl_',
        'library'   => 'lib_',
        'file'      => 'file_',
    ];
    protected function configure(): void
    {
        $this->setDescription('Validate MokoGitea repo metadata against Joomla extension manifest XML');
        $this->addArgument('--path', 'Repo root path (default: current directory)', '.');
        $this->addArgument('--token', 'Gitea API token (or GITEA_TOKEN env)', '');
        $this->addArgument('--org', 'Gitea org', 'MokoConsulting');
        $this->addArgument('--repo', 'Repo name (auto-detected from git if empty)', '');
        $this->addArgument('--api-base', 'Gitea API base URL', 'https://git.mokoconsulting.tech/api/v1');
        $this->addArgument('--ci', 'CI mode: exit 1 on any error', false);
        $this->addArgument('--json', 'Output as JSON', false);
    }
    protected function run(): int
    {
        $path     = realpath($this->getArgument('--path')) ?: $this->getArgument('--path');
        $token    = $this->getArgument('--token') ?: getenv('GITEA_TOKEN') ?: '';
        $org      = $this->getArgument('--org');
        $repoName = $this->getArgument('--repo');
        $apiBase  = rtrim($this->getArgument('--api-base'), '/');
        $ciMode   = (bool) $this->getArgument('--ci');
        $jsonMode = (bool) $this->getArgument('--json');
        if (!is_dir($path)) {
            $this->log('ERROR', "Path does not exist: {$path}");
            return 1;
        }
        if ($repoName === '') {
            $repoName = $this->detectRepoName($path);
        }
        // ── Step 1: Find the Joomla extension manifest XML ──────────
        $joomlaXml = $this->findJoomlaManifest($path);
        if ($joomlaXml === null) {
            $this->log('ERROR', 'No Joomla extension manifest XML found');
            return 1;
        }
        $this->log('INFO', "Joomla manifest: {$joomlaXml['path']}");
        // ── Step 2: Load MokoGitea metadata ─────────────────────────
        $metadata = $this->loadMetadata($path, $org, $repoName, $token, $apiBase);
        if ($metadata === null) {
            $this->log('ERROR', 'Could not load MokoGitea metadata');
            return 1;
        }
        // ── Step 3: Compare ─────────────────────────────────────────
        $results = $this->compare($metadata, $joomlaXml, $path);
        // ── Step 4: Output ──────────────────────────────────────────
        if ($jsonMode) {
            echo json_encode([
                'repo'    => $repoName,
                'results' => $results,
            ], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . "\n";
        } else {
            $this->printResults($repoName, $results);
        }
        $errors = count(array_filter($results, fn($r) => $r['status'] === 'error'));
        return ($ciMode && $errors > 0) ? 1 : 0;
    }
    // =================================================================
    // Find Joomla manifest XML
    // =================================================================
    private function findJoomlaManifest(string $root): ?array
    {
        // Search common locations for a Joomla extension manifest
        $candidates = [];
        // Package manifest: source/pkg_*.xml
        foreach (glob("{$root}/source/pkg_*.xml") as $file) {
            $candidates[] = $file;
        }
        // Component manifest: source/packages/com_*/[name].xml
        foreach (glob("{$root}/source/packages/com_*/*.xml") as $file) {
            $basename = basename($file);
            // Skip access.xml, config.xml, etc.
            if (in_array($basename, ['access.xml', 'config.xml'], true)) {
                continue;
            }
            $candidates[] = $file;
        }
        // Direct source/*.xml
        foreach (glob("{$root}/source/*.xml") as $file) {
            if (basename($file) !== 'pkg_mokosuitebackup.xml') {
                // Already caught above
            }
            $candidates[] = $file;
        }
        // src/ fallback
        foreach (glob("{$root}/src/pkg_*.xml") as $file) {
            $candidates[] = $file;
        }
        // Find the first one that has <extension type="...">
        foreach (array_unique($candidates) as $file) {
            $content = file_get_contents($file);
            if ($content === false) {
                continue;
            }
            if (preg_match('/<extension\s[^>]*type=["\']([^"\']+)["\']/', $content, $typeMatch)) {
                $xml = @simplexml_load_string($content);
                if ($xml === false) {
                    $relPath = str_replace($root . '/', '', $file);
                    $relPath = str_replace($root . '\\', '', $relPath);
                    $this->log('WARN', "Skipping {$relPath}: malformed XML");
                    continue;
                }
                $type = strtolower($typeMatch[1]);
                $relPath = str_replace($root . '/', '', $file);
                $relPath = str_replace($root . '\\', '', $relPath);
                return [
                    'path' => $relPath,
                    'type' => $type,
                    'xml'  => $xml,
                ];
            }
        }
        return null;
    }
    // =================================================================
    // Load metadata (from API)
    // =================================================================
    private function loadMetadata(string $root, string $org, string $repoName, string $token, string $apiBase): ?array
    {
        if ($token === '') {
            $this->log('ERROR', 'No API token provided (use --token or set GITEA_TOKEN env var)');
            return null;
        }
        $url = "{$apiBase}/repos/{$org}/{$repoName}/metadata";
        $ctx = stream_context_create([
            'http' => [
                'header'        => "Authorization: token {$token}\r\nAccept: application/json\r\n",
                'timeout'       => 10,
                'ignore_errors' => true,
            ],
        ]);
        $body = file_get_contents($url, false, $ctx);
        // Extract HTTP status from response headers
        $httpCode = 0;
        if (isset($http_response_header[0]) && preg_match('/\d{3}/', $http_response_header[0], $m)) {
            $httpCode = (int) $m[0];
        }
        if ($body === false) {
            $this->log('ERROR', "Failed to connect to {$url} — check network or TLS configuration");
            return null;
        }
        if ($httpCode === 404) {
            $this->log('ERROR', "API endpoint not found: {$url}");
            $this->log('ERROR', 'Server may need MokoGitea-Fork >= #650 (metadata endpoint rename)');
            return null;
        }
        if ($httpCode === 401 || $httpCode === 403) {
            $this->log('ERROR', "Authentication failed (HTTP {$httpCode}) — check your API token");
            return null;
        }
        if ($httpCode >= 400) {
            $this->log('ERROR', "API returned HTTP {$httpCode}: " . substr($body, 0, 200));
            return null;
        }
        $data = json_decode($body, true);
        if (!is_array($data)) {
            $this->log('ERROR', "API returned invalid JSON from {$url}");
            return null;
        }
        $data['source'] = 'api';
        return $data;
    }
    // =================================================================
    // Compare metadata against Joomla manifest
    // =================================================================
    private function compare(array $metadata, array $joomlaXml, string $root): array
    {
        $results = [];
        $xml     = $joomlaXml['xml'];
        $type    = $joomlaXml['type'];
        // 1. Extension type
        $metaType = $this->normalizeExtensionType(
            $metadata['extension_type'] ?? $metadata['package_type'] ?? ''
        );
        $results[] = [
            'field'    => 'extension_type',
            'metadata' => $metaType,
            'joomla'   => $type,
            'status'   => ($metaType === $type) ? 'ok' : 'error',
            'message'  => ($metaType === $type)
                ? "matches <extension type=\"{$type}\">"
                : "metadata has \"{$metaType}\" but Joomla manifest has \"{$type}\"",
        ];
        // 2. Element name
        $metaName    = strtolower($metadata['name'] ?? '');
        $metaElement = $this->deriveElement($metaType, $metaName);
        $joomlaElement = $this->extractJoomlaElement($xml, $type);
        $elementMatch = ($metaElement === $joomlaElement);
        $results[] = [
            'field'    => 'element',
            'metadata' => $metaElement,
            'joomla'   => $joomlaElement,
            'status'   => $elementMatch ? 'ok' : 'error',
            'message'  => $elementMatch
                ? "derived correctly"
                : "metadata derives \"{$metaElement}\" but Joomla uses \"{$joomlaElement}\"",
        ];
        // 3. Version
        $metaVersion  = $metadata['version'] ?? '';
        $joomlaVersion = (string) ($xml->version ?? '');
        if ($metaVersion !== '' && $joomlaVersion !== '') {
            // Strip dev/rc suffixes for comparison (CI bumps these)
            $metaBase   = preg_replace('/-(dev|rc|alpha|beta)\d*$/', '', $metaVersion);
            $joomlaBase = preg_replace('/-(dev|rc|alpha|beta)\d*$/', '', $joomlaVersion);
            $versionMatch = ($metaBase === $joomlaBase);
            $results[] = [
                'field'    => 'version',
                'metadata' => $metaVersion,
                'joomla'   => $joomlaVersion,
                'status'   => $versionMatch ? 'ok' : 'warn',
                'message'  => $versionMatch
                    ? 'matches (base version)'
                    : "metadata has \"{$metaVersion}\" but Joomla has \"{$joomlaVersion}\"",
            ];
        }
        // 4. PHP minimum (from composer.json)
        $composerPhp = $this->readComposerPhpRequirement($root);
        $metaPhp     = $metadata['php_minimum'] ?? '';
        if ($composerPhp !== '' && $metaPhp !== '') {
            $phpMatch = ($metaPhp === $composerPhp);
            $results[] = [
                'field'    => 'php_minimum',
                'metadata' => $metaPhp,
                'joomla'   => $composerPhp . ' (composer.json)',
                'status'   => $phpMatch ? 'ok' : 'warn',
                'message'  => $phpMatch
                    ? 'matches composer.json'
                    : "metadata has \"{$metaPhp}\" but composer.json requires \"{$composerPhp}\"",
            ];
        }
        // 5. Description
        $metaDesc   = $metadata['description'] ?? '';
        $joomlaDesc = (string) ($xml->description ?? '');
        // Joomla descriptions are often language keys, skip those
        if ($metaDesc !== '' && $joomlaDesc !== '' && !str_starts_with($joomlaDesc, 'COM_') && !str_starts_with($joomlaDesc, 'PKG_')) {
            $descMatch = ($metaDesc === $joomlaDesc);
            $results[] = [
                'field'    => 'description',
                'metadata' => substr($metaDesc, 0, 60) . (strlen($metaDesc) > 60 ? '...' : ''),
                'joomla'   => substr($joomlaDesc, 0, 60) . (strlen($joomlaDesc) > 60 ? '...' : ''),
                'status'   => $descMatch ? 'ok' : 'info',
                'message'  => $descMatch ? 'matches' : 'descriptions differ (informational)',
            ];
        }
        return $results;
    }
    // =================================================================
    // Helpers
    // =================================================================
    /**
     * Normalize extension_type — map MokoGitea types to Joomla types.
     */
    private function normalizeExtensionType(string $type): string
    {
        return match (strtolower($type)) {
            'joomla-extension' => 'package', // legacy mapping
            default => strtolower($type),
        };
    }
    /**
     * Derive the Joomla element name from type + name.
     * Replicates MokoGitea's cleanJoomlaElement() + prefix logic.
     */
    private function deriveElement(string $type, string $name): string
    {
        // Clean: lowercase, strip non-alphanumeric except . _ -
        $clean = strtolower($name);
        $clean = preg_replace('/[^a-z0-9._-]/', '', $clean);
        $prefix = self::JOOMLA_PREFIX[$type] ?? '';
        return $prefix . $clean;
    }
    /**
     * Extract the element name from a Joomla manifest XML.
     * Follows the same logic as Joomla's InstallerAdapter::getElement().
     */
    private function extractJoomlaElement(\SimpleXMLElement $xml, string $type): string
    {
        switch ($type) {
            case 'package':
                $packagename = (string) ($xml->packagename ?? '');
                if ($packagename !== '') {
                    return 'pkg_' . strtolower(preg_replace('/[^a-zA-Z0-9._-]/', '', $packagename));
                }
                break;
            case 'component':
                $element = (string) ($xml->element ?? '');
                if ($element !== '') {
                    $element = strtolower($element);
                    return str_starts_with($element, 'com_') ? $element : 'com_' . $element;
                }
                $name = (string) ($xml->name ?? '');
                $name = strtolower(preg_replace('/[^a-zA-Z0-9._-]/', '', $name));
                return str_starts_with($name, 'com_') ? $name : 'com_' . $name;
            case 'module':
                $element = (string) ($xml->element ?? '');
                if ($element !== '') {
                    return strtolower($element);
                }
                break;
            case 'plugin':
                // Plugins derive element from the file attribute
                if (isset($xml->files)) {
                    foreach ($xml->files->children() as $file) {
                        $plugin = (string) ($file->attributes()->plugin ?? '');
                        if ($plugin !== '') {
                            return strtolower($plugin);
                        }
                    }
                }
                break;
            case 'library':
                $libname = (string) ($xml->libraryname ?? '');
                if ($libname !== '') {
                    return strtolower($libname);
                }
                break;
        }
        // Fallback: use <name> tag
        $name = (string) ($xml->name ?? '');
        return strtolower(preg_replace('/[^a-zA-Z0-9._-]/', '', $name));
    }
    /**
     * Read PHP version requirement from composer.json.
     */
    private function readComposerPhpRequirement(string $root): string
    {
        $composerFile = "{$root}/composer.json";
        if (!is_file($composerFile)) {
            return '';
        }
        $data = json_decode(file_get_contents($composerFile), true);
        if (!is_array($data)) {
            return '';
        }
        $phpReq = $data['require']['php'] ?? '';
        // Extract version number from constraint like ">=8.1"
        if (preg_match('/(\d+\.\d+)/', $phpReq, $m)) {
            return $m[1];
        }
        return '';
    }
    private function detectRepoName(string $root): string
    {
        $gitConfig = "{$root}/.git/config";
        if (!file_exists($gitConfig)) {
            return basename($root);
        }
        $content = file_get_contents($gitConfig);
        if (preg_match('/url\s*=\s*.*\/([^\/\s]+?)(?:\.git)?\s*$/m', $content, $m)) {
            return $m[1];
        }
        return basename($root);
    }
    // =================================================================
    // Output
    // =================================================================
    private function printResults(string $repoName, array $results): void
    {
        $errors = count(array_filter($results, fn($r) => $r['status'] === 'error'));
        $warns  = count(array_filter($results, fn($r) => $r['status'] === 'warn'));
        $oks    = count(array_filter($results, fn($r) => $r['status'] === 'ok'));
        $this->log('INFO', "Validating {$repoName} Joomla metadata...\n");
        foreach ($results as $r) {
            $icon = match ($r['status']) {
                'ok'    => "\xE2\x9C\x93", // ✓
                'error' => "\xE2\x9C\x97", // ✗
                'warn'  => "\xE2\x9A\xA0", // ⚠
                default => "\xE2\x84\xB9", // ℹ
            };
            $line = sprintf(
                "  %s %-16s %s",
                $icon,
                $r['field'],
                $r['message']
            );
            $this->log(
                match ($r['status']) {
                    'error' => 'ERROR',
                    'warn'  => 'WARN',
                    'ok'    => 'OK',
                    default => 'INFO',
                },
                $line
            );
        }
        echo "\n";
        if ($errors > 0) {
            $this->log('ERROR', "{$errors} error(s) — update delivery will fail");
        } elseif ($warns > 0) {
            $this->log('WARN', "All critical checks passed, {$warns} warning(s)");
        } else {
            $this->log('OK', "All {$oks} checks passed");
        }
    }
 }
 $app = new JoomlaMetadataValidateCli();
 exit($app->execute());
@@ -8,9 +8,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/joomla_release.php
 * BRIEF: Joomla release pipeline — build ZIP+tar.gz, upload to GitHub Release, update updates.xml
 *
@@ -25,7 +25,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
-use MokoEnterprise\{ApiClient, AuditLogger, CliFramework, Config, PlatformAdapterFactory, SourceResolver};
+use MokoCli\{ApiClient, AuditLogger, CliFramework, Config, PlatformAdapterFactory, SourceResolver};
 /**
 * Joomla Release Manager
@@ -57,7 +57,7 @@ class JoomlaRelease extends CliFramework
    ];
    private ApiClient $api;
-    private \MokoEnterprise\GitPlatformAdapter $adapter;
+    private \MokoCli\GitPlatformAdapter $adapter;
    protected function configure(): void
    {
@@ -407,7 +407,7 @@ class JoomlaRelease extends CliFramework
            $this->api->post("/repos/{$repo}/releases", [
                'tag_name'   => $tag,
                'name'       => $releaseName,
-                'body'       => "## {$version}\n\nCreated by mokoplatform release pipeline.",
+                'body'       => "## {$version}\n\nCreated by mokocli release pipeline.",
                'prerelease' => ($stability !== 'stable'),
            ]);
        }
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/license_manage.php
 * BRIEF: Manage license packages and keys via MokoGitea licensing API
 *
@@ -28,7 +28,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class LicenseManage extends CliFramework
 {
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_detect.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Auto-detect manifest fields from source files and optionally push to API
 */
@@ -18,7 +18,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class ManifestDetectCli extends CliFramework
 {
@@ -161,15 +161,18 @@ class ManifestDetectCli extends CliFramework
        $platform = $this->detectPlatform($root);
        $fields = [
-            'platform'     => $platform,
+            'platform'       => $platform,
-            'name'         => '',
+            'name'           => '',
-            'description'  => '',
+            'description'    => '',
-            'version'      => '',
+            'version'        => '',
-            'element_name' => '',
+            'element_name'   => '',
-            'package_type' => '',
+            'package_type'   => '',
-            'language'     => '',
+            'language'       => '',
-            'entry_point'  => '',
+            'entry_point'    => '',
-            'license_spdx' => '',
+            'license_spdx'   => '',
            'display_name'   => '',
            'target_version' => '',
            'php_minimum'    => '',
        ];
        switch ($platform) {
@@ -316,7 +319,13 @@ class ManifestDetectCli extends CliFramework
        ];
        if (isset($prefixMap[$extType])) {
            $prefix = $prefixMap[$extType];
-            if (strpos($element, $prefix) !== 0 && strpos($element, '_') === false) {
+            // Only add prefix if not already present (check all known prefixes)
            $hasPrefix = false;
            foreach ($prefixMap as $p) {
                if (strpos($element, $p) === 0) { $hasPrefix = true; break; }
            }
            if (strpos($element, 'plg_') === 0) { $hasPrefix = true; }
            if (!$hasPrefix) {
                $element = $prefix . $element;
            }
        } elseif ($extType === 'plugin') {
@@ -349,6 +358,30 @@ class ManifestDetectCli extends CliFramework
            }
        }
        // Display name for update feeds
        if (!empty($fields['name'])) {
            $name = $fields['name'];
            // If name already has "Type - " prefix, use as-is
            if (preg_match('/^(Package|Component|Module|Plugin|Template|Library)\s*-\s*/i', $name)) {
                $fields['display_name'] = $name;
            } elseif (!empty($extType)) {
                $fields['display_name'] = ucfirst($extType) . ' - ' . $name;
            }
        }
        // Target Joomla version
        if (preg_match('/<targetplatform\s[^>]*version="([^"]+)"/', $xml, $m)) {
            $fields['target_version'] = trim($m[1]);
        } else {
            // Default for Joomla 5/6
            $fields['target_version'] = '(5|6)\..*';
        }
        // PHP minimum
        if (preg_match('/<php_minimum>([^<]+)<\/php_minimum>/', $xml, $m)) {
            $fields['php_minimum'] = trim($m[1]);
        }
        // License
        if (preg_match('/<license>([^<]+)<\/license>/', $xml, $m)) {
            $fields['license_spdx'] = $this->normalizeLicense(trim($m[1]));
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_element.php
 * BRIEF: Extract element name, type, type prefix, and ZIP name from manifest
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class ManifestElementCli extends CliFramework
 {
@@ -0,0 +1,564 @@
 #!/usr/bin/env php
 <?php
 /* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
 * DEFGROUP: mokocli.CLI
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_integrity.php
 * VERSION: 09.37.01
 * BRIEF: Cross-check manifest API fields against repo contents across the org
 */
 declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
 use MokoCli\CliFramework;
 class ManifestIntegrityCli extends CliFramework
 {
    protected function configure(): void
    {
        $this->setDescription('Cross-check manifest fields against repo contents across the org');
        $this->addArgument('--path', 'Single repo path (local mode)', '');
        $this->addArgument('--org', 'Gitea org (bulk mode)', 'MokoConsulting');
        $this->addArgument('--repo', 'Single repo name (remote mode)', '');
        $this->addArgument('--token', 'Gitea API token (or GITEA_TOKEN env)', '');
        $this->addArgument('--api-base', 'Gitea API base URL', 'https://git.mokoconsulting.tech/api/v1');
        $this->addArgument('--fix', 'Push fixes for detected drift', false);
        $this->addArgument('--json', 'Output as JSON', false);
        $this->addArgument('--quiet', 'Only show repos with issues', false);
    }
    protected function run(): int
    {
        $path     = $this->getArgument('--path');
        $org      = $this->getArgument('--org');
        $repoName = $this->getArgument('--repo');
        $token    = $this->getArgument('--token') ?: getenv('GITEA_TOKEN') ?: '';
        $apiBase  = rtrim($this->getArgument('--api-base'), '/');
        $fixMode  = (bool) $this->getArgument('--fix');
        $jsonMode = (bool) $this->getArgument('--json');
        $quiet    = (bool) $this->getArgument('--quiet');
        if ($token === '') {
            $this->log('ERROR', 'API token required (use --token or GITEA_TOKEN env)');
            return 1;
        }
        // ── Mode selection ──────────────────────────────────────────
        if ($path !== '') {
            // Local mode: detect from source + compare to API
            return $this->checkLocal($path, $org, $repoName, $token, $apiBase, $fixMode, $jsonMode);
        }
        if ($repoName !== '') {
            // Single remote repo
            return $this->checkRemoteRepo($org, $repoName, $token, $apiBase, $fixMode, $jsonMode);
        }
        // Bulk mode: all repos in org
        return $this->checkOrg($org, $token, $apiBase, $fixMode, $jsonMode, $quiet);
    }
    // =====================================================================
    // Local mode — detect from source, compare to API
    // =====================================================================
    private function checkLocal(string $path, string $org, string $repoName, string $token, string $apiBase, bool $fix, bool $json): int
    {
        $root = realpath($path) ?: $path;
        if (!is_dir($root)) {
            $this->log('ERROR', "Path does not exist: {$path}");
            return 1;
        }
        if ($repoName === '') {
            $repoName = $this->detectRepoName($root);
        }
        // Run manifest_detect logic
        $detected = $this->runDetect($root, $repoName);
        $current = $this->fetchManifest($apiBase, $org, $repoName, $token);
        if ($current === null) {
            $this->log('ERROR', "Failed to fetch manifest for {$org}/{$repoName}");
            return 1;
        }
        $issues = $this->validate($current, $detected, $repoName);
        if ($json) {
            echo json_encode(['repo' => $repoName, 'issues' => $issues], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . "\n";
        } else {
            $this->printIssues($repoName, $issues);
        }
        if ($fix && !empty($issues)) {
            return $this->applyFixes($apiBase, $org, $repoName, $token, $current, $issues);
        }
        return empty($issues) ? 0 : 1;
    }
    // =====================================================================
    // Remote single repo mode — fetch source files via API
    // =====================================================================
    private function checkRemoteRepo(string $org, string $repoName, string $token, string $apiBase, bool $fix, bool $json): int
    {
        $current = $this->fetchManifest($apiBase, $org, $repoName, $token);
        if ($current === null) {
            $this->log('ERROR', "Failed to fetch manifest for {$org}/{$repoName}");
            return 1;
        }
        $issues = $this->validateManifestOnly($current, $repoName);
        if ($json) {
            echo json_encode(['repo' => $repoName, 'issues' => $issues], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . "\n";
        } else {
            $this->printIssues($repoName, $issues);
        }
        if ($fix && !empty($issues)) {
            return $this->applyFixes($apiBase, $org, $repoName, $token, $current, $issues);
        }
        return empty($issues) ? 0 : 1;
    }
    // =====================================================================
    // Bulk org mode — check all repos
    // =====================================================================
    private function checkOrg(string $org, string $token, string $apiBase, bool $fix, bool $json, bool $quiet): int
    {
        $repos = $this->fetchOrgRepos($apiBase, $org, $token);
        if ($repos === null) {
            $this->log('ERROR', "Failed to fetch repos for org {$org}");
            return 1;
        }
        $this->log('INFO', "Manifest Integrity Check — {$org} (" . count($repos) . " repos)");
        $allResults = [];
        $totalIssues = 0;
        $reposWithIssues = 0;
        foreach ($repos as $repo) {
            $name = $repo['name'];
            $manifest = $this->fetchManifest($apiBase, $org, $name, $token);
            if ($manifest === null) {
                if (!$quiet) {
                    $this->log('WARN', "{$name}: no manifest");
                }
                continue;
            }
            $issues = $this->validateManifestOnly($manifest, $name);
            if (!empty($issues)) {
                $reposWithIssues++;
                $totalIssues += count($issues);
                if ($json) {
                    $allResults[] = ['repo' => $name, 'issues' => $issues];
                } else {
                    $this->printIssues($name, $issues);
                }
                if ($fix) {
                    $this->applyFixes($apiBase, $org, $name, $token, $manifest, $issues);
                }
            } elseif (!$quiet && !$json) {
                $this->log('OK', "{$name}: clean");
            }
        }
        if ($json) {
            echo json_encode($allResults, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . "\n";
        } else {
            echo "\n";
            $level = $reposWithIssues > 0 ? 'WARN' : 'OK';
            $this->log($level, sprintf(
                'Summary: %d repos checked, %d with issues (%d total issues)',
                count($repos),
                $reposWithIssues,
                $totalIssues
            ));
        }
        return $reposWithIssues > 0 ? 1 : 0;
    }
    // =====================================================================
    // Validation rules
    // =====================================================================
    /**
     * Full validation: compare API manifest against locally-detected fields.
     */
    private function validate(array $current, array $detected, string $repoName): array
    {
        $issues = [];
        // Required fields that should never be empty
        $required = ['platform', 'name', 'version', 'package_type', 'language', 'entry_point'];
        foreach ($required as $field) {
            if (empty($current[$field])) {
                $fix = $detected[$field] ?? null;
                $issues[] = [
                    'field'    => $field,
                    'severity' => 'error',
                    'message'  => 'Missing required field',
                    'current'  => '',
                    'fix'      => $fix,
                ];
            }
        }
        // Drift detection: detected value differs from API
        foreach ($detected as $field => $detectedValue) {
            $currentValue = $current[$field] ?? '';
            if ($detectedValue !== '' && $currentValue !== '' && $detectedValue !== $currentValue) {
                // Version drift is expected on dev branches (suffix)
                if ($field === 'version' && strpos($detectedValue, $currentValue) === 0) {
                    continue; // e.g., detected "02.34.50-dev" vs API "02.34.50"
                }
                if ($field === 'version' && strpos($currentValue, $detectedValue) === 0) {
                    continue;
                }
                $issues[] = [
                    'field'    => $field,
                    'severity' => 'warn',
                    'message'  => 'Drift: source differs from manifest',
                    'current'  => $currentValue,
                    'fix'      => $detectedValue,
                ];
            }
        }
        // Platform-specific structure validation
        $platform = $current['platform'] ?? '';
        $issues = array_merge($issues, $this->validatePlatformStructure($platform, $current, $repoName));
        return $issues;
    }
    /**
     * API-only validation: check manifest fields for completeness and consistency
     * without access to source files.
     */
    private function validateManifestOnly(array $manifest, string $repoName): array
    {
        $issues = [];
        // Required fields
        $required = ['platform', 'name', 'version', 'language'];
        foreach ($required as $field) {
            if (empty($manifest[$field])) {
                $issues[] = [
                    'field'    => $field,
                    'severity' => 'error',
                    'message'  => 'Missing required field',
                    'current'  => '',
                    'fix'      => null,
                ];
            }
        }
        // Recommended fields
        $recommended = ['package_type', 'entry_point', 'license_spdx', 'description'];
        foreach ($recommended as $field) {
            if (empty($manifest[$field])) {
                $issues[] = [
                    'field'    => $field,
                    'severity' => 'info',
                    'message'  => 'Recommended field is empty',
                    'current'  => '',
                    'fix'      => null,
                ];
            }
        }
        // Platform-specific checks
        $platform = $manifest['platform'] ?? '';
        $issues = array_merge($issues, $this->validatePlatformStructure($platform, $manifest, $repoName));
        return $issues;
    }
    /**
     * Platform-specific validation rules.
     */
    private function validatePlatformStructure(string $platform, array $manifest, string $repoName): array
    {
        $issues = [];
        switch ($platform) {
            case 'joomla':
            case 'waas-component':
                // Joomla repos must have element_name
                if (empty($manifest['element_name'])) {
                    $issues[] = [
                        'field'    => 'element_name',
                        'severity' => 'error',
                        'message'  => 'Joomla repos require element_name',
                        'current'  => '',
                        'fix'      => null,
                    ];
                }
                // Language should be PHP
                if (!empty($manifest['language']) && $manifest['language'] !== 'PHP') {
                    $issues[] = [
                        'field'    => 'language',
                        'severity' => 'warn',
                        'message'  => 'Joomla repos should have language=PHP',
                        'current'  => $manifest['language'],
                        'fix'      => 'PHP',
                    ];
                }
                break;
            case 'dolibarr':
            case 'crm-module':
                if (!empty($manifest['language']) && $manifest['language'] !== 'PHP') {
                    $issues[] = [
                        'field'    => 'language',
                        'severity' => 'warn',
                        'message'  => 'Dolibarr repos should have language=PHP',
                        'current'  => $manifest['language'],
                        'fix'      => 'PHP',
                    ];
                }
                break;
            case 'go':
                if (!empty($manifest['language']) && $manifest['language'] !== 'Go') {
                    $issues[] = [
                        'field'    => 'language',
                        'severity' => 'warn',
                        'message'  => 'Go repos should have language=Go',
                        'current'  => $manifest['language'],
                        'fix'      => 'Go',
                    ];
                }
                break;
            case 'mcp':
                if (!empty($manifest['language']) && !in_array($manifest['language'], ['TypeScript', 'JavaScript'], true)) {
                    $issues[] = [
                        'field'    => 'language',
                        'severity' => 'warn',
                        'message'  => 'MCP repos should have language=TypeScript or JavaScript',
                        'current'  => $manifest['language'],
                        'fix'      => null,
                    ];
                }
                break;
        }
        // Version format check: should be XX.YY.ZZ
        $version = $manifest['version'] ?? '';
        if ($version !== '' && !preg_match('/^\d{2}\.\d{2}\.\d{2}/', $version)) {
            // Allow semver for node/go repos
            if (!in_array($platform, ['mcp', 'node', 'go'], true)) {
                $issues[] = [
                    'field'    => 'version',
                    'severity' => 'info',
                    'message'  => 'Version does not match XX.YY.ZZ format',
                    'current'  => $version,
                    'fix'      => null,
                ];
            }
        }
        return $issues;
    }
    // =====================================================================
    // Output
    // =====================================================================
    private function printIssues(string $repoName, array $issues): void
    {
        if (empty($issues)) {
            return;
        }
        $errors = count(array_filter($issues, fn($i) => $i['severity'] === 'error'));
        $warns  = count(array_filter($issues, fn($i) => $i['severity'] === 'warn'));
        $infos  = count($issues) - $errors - $warns;
        echo "\n";
        $summary = [];
        if ($errors > 0) $summary[] = "{$errors} error(s)";
        if ($warns > 0) $summary[] = "{$warns} warning(s)";
        if ($infos > 0) $summary[] = "{$infos} info";
        $this->log($errors > 0 ? 'ERROR' : 'WARN', "{$repoName} — " . implode(', ', $summary));
        foreach ($issues as $issue) {
            $icon = match ($issue['severity']) {
                'error' => 'ERROR',
                'warn'  => 'WARN',
                default => 'INFO',
            };
            $msg = sprintf('  %-18s %s', $issue['field'], $issue['message']);
            if ($issue['current'] !== '') {
                $msg .= " (current: {$issue['current']})";
            }
            if ($issue['fix'] !== null) {
                $msg .= " → fix: {$issue['fix']}";
            }
            $this->log($icon, $msg);
        }
    }
    // =====================================================================
    // Fix application
    // =====================================================================
    private function applyFixes(string $apiBase, string $org, string $repo, string $token, array $current, array $issues): int
    {
        $fixes = [];
        foreach ($issues as $issue) {
            if ($issue['fix'] !== null && $issue['fix'] !== '') {
                $fixes[$issue['field']] = $issue['fix'];
            }
        }
        if (empty($fixes)) {
            $this->log('INFO', "{$repo}: no auto-fixable issues");
            return 0;
        }
        $merged = array_merge($current, $fixes);
        $url = "{$apiBase}/repos/{$org}/{$repo}/manifest";
        $payload = json_encode($merged);
        $ctx = stream_context_create([
            'http' => [
                'method'  => 'PUT',
                'header'  => "Authorization: token {$token}\r\nContent-Type: application/json\r\nAccept: application/json\r\n",
                'content' => $payload,
                'timeout' => 10,
            ],
        ]);
        $body = @file_get_contents($url, false, $ctx);
        if ($body === false) {
            $this->log('ERROR', "{$repo}: failed to push fixes");
            return 1;
        }
        $this->log('OK', "{$repo}: fixed " . implode(', ', array_keys($fixes)));
        return 0;
    }
    // =====================================================================
    // API helpers
    // =====================================================================
    private function fetchManifest(string $apiBase, string $org, string $repo, string $token): ?array
    {
        $url = "{$apiBase}/repos/{$org}/{$repo}/manifest";
        $ctx = stream_context_create([
            'http' => [
                'header'  => "Authorization: token {$token}\r\nAccept: application/json\r\n",
                'timeout' => 10,
            ],
        ]);
        $body = @file_get_contents($url, false, $ctx);
        if ($body === false) return null;
        $data = json_decode($body, true);
        return is_array($data) ? $data : null;
    }
    private function fetchOrgRepos(string $apiBase, string $org, string $token): ?array
    {
        $allRepos = [];
        $page = 1;
        $limit = 50;
        while (true) {
            $url = "{$apiBase}/orgs/{$org}/repos?page={$page}&limit={$limit}";
            $ctx = stream_context_create([
                'http' => [
                    'header'  => "Authorization: token {$token}\r\nAccept: application/json\r\n",
                    'timeout' => 15,
                ],
            ]);
            $body = @file_get_contents($url, false, $ctx);
            if ($body === false) return null;
            $repos = json_decode($body, true);
            if (!is_array($repos) || empty($repos)) break;
            $allRepos = array_merge($allRepos, $repos);
            if (count($repos) < $limit) break;
            $page++;
        }
        // Filter out archived and empty repos
        return array_filter($allRepos, fn($r) => !($r['archived'] ?? false) && !($r['empty'] ?? false));
    }
    // =====================================================================
    // Detection (delegates to manifest_detect logic)
    // =====================================================================
    private function runDetect(string $root, string $repoName): array
    {
        $script = __DIR__ . '/manifest_detect.php';
        $redirect = PHP_OS_FAMILY === 'Windows' ? '2>NUL' : '2>/dev/null';
        $cmd = sprintf(
            'php %s --path %s --repo %s --json --quiet %s',
            escapeshellarg($script),
            escapeshellarg($root),
            escapeshellarg($repoName),
            $redirect
        );
        $output = shell_exec($cmd) ?? '';
        // Extract JSON object from output (skip banner/log lines)
        if (preg_match('/\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}/s', $output, $m)) {
            $data = json_decode($m[0], true);
            if (is_array($data)) {
                return $data;
            }
        }
        return [];
    }
    private function detectRepoName(string $root): string
    {
        $gitConfig = "{$root}/.git/config";
        if (!file_exists($gitConfig)) {
            return basename($root);
        }
        $content = file_get_contents($gitConfig);
        if (preg_match('/url\s*=\s*.*\/([^\/\s]+?)(?:\.git)?\s*$/m', $content, $m)) {
            return $m[1];
        }
        return basename($root);
    }
 }
 $app = new ManifestIntegrityCli();
 exit($app->execute());
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_licensing.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Ensure licensing tags (updateservers, dlid) in Joomla extension manifests
 */
@@ -18,7 +18,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 /**
 * Reads the <licensing> block from .mokogitea/manifest.xml and ensures that the
@@ -6,126 +6,431 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/manifest_read.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
- * BRIEF: Parse .manifest.xml and output requested field(s) for CI consumption
+ * BRIEF: Read repo metadata from Gitea manifest API, auto-detect the rest
 */
 declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ManifestReadCli extends CliFramework
 {
    /** Joomla extension XML element names searched in root and source/ dirs. */
    private const JOOMLA_XML_ROOTS = ['extension', 'install'];
    protected function configure(): void
    {
-        $this->setDescription('Parse manifest.xml and output requested field(s) for CI consumption');
+        $this->setDescription('Read repo metadata from Gitea API with auto-detection fallback');
-        $this->addArgument('--path', 'Repository root path', '.');
+        $this->addArgument('--path',          'Repository root path',                     '.');
-        $this->addArgument('--field', 'Single field name to output', '');
+        $this->addArgument('--field',         'Single field name to output',              '');
-        $this->addArgument('--all', 'Print all fields as KEY=VALUE lines', false);
+        $this->addArgument('--all',           'Print all fields as KEY=VALUE lines',      false);
-        $this->addArgument('--github-output', 'Append all fields to $GITHUB_OUTPUT', false);
+        $this->addArgument('--github-output', 'Append all fields to $GITHUB_OUTPUT',      false);
-        $this->addArgument('--json', 'Output all fields as JSON', false);
+        $this->addArgument('--json',          'Output all fields as JSON',                false);
    }
    protected function run(): int
    {
-        $path = $this->getArgument('--path');
+        $path    = $this->getArgument('--path');
-        $field = $this->getArgument('--field');
+        $field   = $this->getArgument('--field');
        $showAll = $this->getArgument('--all');
-        $ghOutput = $this->getArgument('--github-output');
+        $ghOut   = $this->getArgument('--github-output');
        $jsonMode = $this->getArgument('--json');
-        // Determine mode
+        $mode = match (true) {
-        if ($ghOutput) {
+            (bool) $ghOut   => 'github-output',
-            $mode = 'github-output';
+            (bool) $showAll => 'all',
-        } elseif ($showAll) {
+            (bool) $jsonMode => 'json',
-            $mode = 'all';
+            default         => 'field',
-        } elseif ($jsonMode) {
+        };
-            $mode = 'json';
+
-        } else {
+        $root = realpath($path) ?: $path;
-            $mode = 'field';
+
        // ── 1. Resolve org/repo ──────────────────────────────────────────
        [$org, $repo] = $this->resolveOrgRepo($root);
        // ── 2. Primary: Gitea manifest API ───────────────────────────────
        $fields = null;
        if ($org !== '' && $repo !== '') {
            $fields = $this->fetchFromApi($org, $repo);
        }
-        // -- Locate manifest --
+        // ── 3. Fallback: auto-detect from source tree ────────────────────
-        $root = realpath($path) ?: $path;
+        if ($fields === null) {
-        $manifestFile = null;
+            $this->log('INFO', 'API unavailable — falling back to source-tree detection');
            $fields = $this->autoDetect($root, $repo);
        }
-        // Priority: manifest.xml (current standard)
+        if (empty($fields)) {
-        $candidates = [
+            $this->log('ERROR', "Could not resolve metadata for {$root}");
-            "{$root}/.mokogitea/manifest.xml",
+            return 1;
-            "{$root}/.mokogitea/.manifest.xml",    // legacy (dot-prefixed)
+        }
-            "{$root}/.mokogitea/.mokoplatform",  // legacy v4
+
        // Provide backward-compatible aliases (hyphenated → underscore)
        $fields = $this->addAliases($fields);
        // Strip empty values
        $fields = array_filter($fields, fn($v) => $v !== '' && $v !== null);
        // ── 4. Output ────────────────────────────────────────────────────
        return $this->outputFields($fields, $mode, $field);
    }
    // ── Gitea manifest API ───────────────────────────────────────────────
    private function fetchFromApi(string $org, string $repo): ?array
    {
        $token   = getenv('GA_TOKEN') ?: getenv('GITEA_TOKEN') ?: '';
        $baseUrl = getenv('GITEA_URL') ?: 'https://git.mokoconsulting.tech';
        $baseUrl = rtrim($baseUrl, '/');
        if ($token === '') {
            return null;
        }
        $url = "{$baseUrl}/api/v1/repos/{$org}/{$repo}/manifest";
        $ctx = stream_context_create([
            'http' => [
                'header'  => "Authorization: token {$token}\r\nAccept: application/json\r\n",
                'timeout' => 10,
                'ignore_errors' => true,
            ],
        ]);
        $body = @file_get_contents($url, false, $ctx);
        if ($body === false) {
            return null;
        }
        // Check HTTP status from response headers
        $status = 0;
        if (isset($http_response_header[0])) {
            preg_match('/\d{3}/', $http_response_header[0], $m);
            $status = (int) ($m[0] ?? 0);
        }
        if ($status < 200 || $status >= 300) {
            return null;
        }
        $data = json_decode($body, true);
        if (!is_array($data) || empty($data)) {
            return null;
        }
        $this->log('INFO', "Loaded metadata from Gitea manifest API ({$org}/{$repo})");
        return $data;
    }
    // ── Auto-detection fallback ──────────────────────────────────────────
    private function autoDetect(string $root, string $repoName): array
    {
        $fields = [
            'name' => $repoName ?: basename($root),
            'org'  => 'MokoConsulting',
        ];
-        foreach ($candidates as $candidate) {
+        // Resolve source directory (source/ or src/)
-            if (file_exists($candidate)) {
+        $srcDir = null;
-                $manifestFile = $candidate;
+        foreach (['source', 'src'] as $candidate) {
            if (is_dir("{$root}/{$candidate}")) {
                $srcDir = $candidate;
                break;
            }
        }
-        if ($manifestFile === null) {
+        // ── Try Joomla detection ─────────────────────────────────────
-            $this->log('ERROR', "No manifest found in {$root}");
+        $joomlaResult = $this->detectJoomla($root, $srcDir);
-            return 1;
+        if ($joomlaResult !== null) {
            $fields = array_merge($fields, $joomlaResult);
            $this->log('INFO', "Auto-detected platform: joomla ({$fields['extension_type']} — {$fields['element_name']})");
            return $fields;
        }
-        // -- Parse XML --
+        // ── Try Dolibarr detection ───────────────────────────────────
-        $xml = @simplexml_load_file($manifestFile);
+        $dolibarrResult = $this->detectDolibarr($root);
        if ($dolibarrResult !== null) {
            $fields = array_merge($fields, $dolibarrResult);
            $this->log('INFO', "Auto-detected platform: dolibarr");
            return $fields;
        }
-        if ($xml === false) {
+        // ── Generic fallback ─────────────────────────────────────────
-            // Fallback: try YAML format (.mokostandards legacy)
+        $fields['platform'] = $this->detectGenericPlatform($root);
-            $content = file_get_contents($manifestFile);
+        $fields['element_name'] = strtolower($fields['name']);
-            $fields = [];
+        $fields['extension_type'] = 'application';
-            if (preg_match('/^platform:\s*(.+)/m', $content, $m)) {
+        $fields['language'] = $this->detectLanguage($root);
-                $fields['platform'] = trim($m[1], " \t\n\r\"'");
+        if ($srcDir !== null) {
            $fields['entry_point'] = "{$srcDir}/";
        }
        $this->log('INFO', "Auto-detected platform: {$fields['platform']}");
        return $fields;
    }
    /**
     * Detect Joomla platform by scanning for extension XML manifests.
     *
     * Searches root and source/ dirs for XML files containing <extension type="...">.
     * Extracts element name from the filename (pkg_*, com_*, mod_*, plg_*, tpl_*) or
     * from the <element> tag inside the manifest.
     */
    private function detectJoomla(string $root, ?string $srcDir): ?array
    {
        $searchDirs = [$root];
        if ($srcDir !== null) {
            $searchDirs[] = "{$root}/{$srcDir}";
        }
        foreach ($searchDirs as $dir) {
            $xmlFiles = glob("{$dir}/*.xml") ?: [];
            foreach ($xmlFiles as $xmlFile) {
                $content = @file_get_contents($xmlFile);
                if ($content === false) {
                    continue;
                }
                // Match <extension type="component|module|plugin|package|template|file|library">
                if (!preg_match('/<extension\s+[^>]*type="([^"]+)"/', $content, $typeMatch)) {
                    // Also try legacy <install type="...">
                    if (!preg_match('/<install\s+[^>]*type="([^"]+)"/', $content, $typeMatch)) {
                        continue;
                    }
                }
                $extType = strtolower($typeMatch[1]);
                $basename = pathinfo($xmlFile, PATHINFO_FILENAME);
                // Try to extract element name from XML <element> tag
                $xml = @simplexml_load_string($content);
                $element = '';
                if ($xml !== false) {
                    // Package manifests have <files><file ...>element</file></files>
                    // Component/module manifests have <element> or use filename
                    $element = (string) ($xml->element ?? '');
                    if ($element === '') {
                        $element = strtolower($basename);
                    }
                } else {
                    $element = strtolower($basename);
                }
                // Derive display name
                $displayName = (string) ($xml->name ?? ucfirst(str_replace('_', ' ', $basename)));
                return [
                    'platform'       => 'joomla',
                    'extension_type' => $extType,
                    'element_name'   => $element,
                    'display_name'   => $displayName,
                    'language'       => 'PHP',
                    'entry_point'    => ($srcDir ?? '.') . '/',
                ];
            }
-            if (preg_match('/^standards_version:\s*(.+)/m', $content, $m)) {
+
-                $fields['standards-version'] = trim($m[1], " \t\n\r\"'");
+            // Also check for pkg_*.xml pattern specifically
            $pkgFiles = glob("{$dir}/pkg_*.xml") ?: [];
            if (!empty($pkgFiles)) {
                $basename = pathinfo($pkgFiles[0], PATHINFO_FILENAME);
                return [
                    'platform'       => 'joomla',
                    'extension_type' => 'package',
                    'element_name'   => strtolower($basename),
                    'display_name'   => ucfirst(str_replace('_', ' ', $basename)),
                    'language'       => 'PHP',
                    'entry_point'    => ($srcDir ?? '.') . '/',
                ];
            }
-            if (preg_match('/^governed_repo:\s*(.+)/m', $content, $m)) {
+        }
-                $fields['name'] = trim($m[1], " \t\n\r\"'");
+
        // Check for com_*/manifest.xml pattern (component subdirectory)
        $comDirs = glob("{$root}/com_*", GLOB_ONLYDIR) ?: [];
        foreach ($comDirs as $comDir) {
            $comManifest = glob("{$comDir}/*.xml") ?: [];
            foreach ($comManifest as $xmlFile) {
                $content = @file_get_contents($xmlFile);
                if ($content && preg_match('/<extension\s+[^>]*type="component"/', $content)) {
                    return [
                        'platform'       => 'joomla',
                        'extension_type' => 'component',
                        'element_name'   => strtolower(basename($comDir)),
                        'display_name'   => ucfirst(str_replace('com_', '', basename($comDir))),
                        'language'       => 'PHP',
                        'entry_point'    => ($srcDir ?? '.') . '/',
                    ];
                }
            }
-        } else {
+        }
-            // Register namespace for XPath (optional, simple path works without)
+
-            $fields = [
+        return null;
-                'name'              => (string)($xml->identity->name ?? ''),
+    }
-                'display-name'      => (string)($xml->identity->{"display-name"} ?? ''),
+
-                'org'               => (string)($xml->identity->org ?? ''),
+    /**
-                'description'       => (string)($xml->identity->description ?? ''),
+     * Detect Dolibarr platform by scanning for module descriptor files.
-                'license'           => (string)($xml->identity->license ?? ''),
+     */
-                'license-spdx'      => (string)($xml->identity->license['spdx'] ?? ''),
+    private function detectDolibarr(string $root): ?array
-                'platform'          => (string)($xml->governance->platform ?? ''),
+    {
-                'standards-version' => (string)($xml->governance->{"standards-version"} ?? ''),
+        // Look for mod*.class.php containing DolibarrModules
-                'standards-source'  => (string)($xml->governance->{"standards-source"} ?? ''),
+        $searchPaths = [
-                'language'          => (string)($xml->build->language ?? ''),
+            "{$root}/core/modules/mod*.class.php",
-                'package-type'      => (string)($xml->build->{"package-type"} ?? ''),
+            "{$root}/*/core/modules/mod*.class.php",
-                'entry-point'       => (string)($xml->build->{"entry-point"} ?? ''),
+        ];
-                'version'           => (string)($xml->identity->version ?? ''),
+
-                'source-dir'        => (string)($xml->deploy->{"source-dir"} ?? ''),
+        foreach ($searchPaths as $pattern) {
-                'remote-subdir'     => (string)($xml->deploy->{"remote-subdir"} ?? ''),
+            $files = glob($pattern) ?: [];
-                'excludes'          => (string)($xml->deploy->excludes ?? ''),
+            foreach ($files as $file) {
-                'dev-host'          => (string)($xml->deploy->{"dev-host"} ?? ''),
+                $content = @file_get_contents($file);
-                'demo-host'         => (string)($xml->deploy->{"demo-host"} ?? ''),
+                if ($content && str_contains($content, 'DolibarrModules')) {
-                'manifest-file'     => $manifestFile,
+                    $modName = pathinfo($file, PATHINFO_FILENAME);
                    // modMyModule.class → mymodule
                    $element = strtolower(preg_replace('/^mod/', '', str_replace('.class', '', $modName)));
                    return [
                        'platform'       => 'dolibarr',
                        'extension_type' => 'module',
                        'element_name'   => $element,
                        'display_name'   => ucfirst($element),
                        'language'       => 'PHP',
                        'entry_point'    => './',
                    ];
                }
            }
        }
        // Secondary: check for update.txt (Dolibarr marker)
        if (file_exists("{$root}/update.txt")) {
            return [
                'platform'       => 'dolibarr',
                'extension_type' => 'module',
                'element_name'   => strtolower(basename($root)),
                'display_name'   => basename($root),
                'language'       => 'PHP',
                'entry_point'    => './',
            ];
        }
-        // Strip empty values for cleaner output
+        return null;
-        $fields = array_filter($fields, fn($v) => $v !== '');
+    }
-        // -- Output --
+    /**
     * Detect generic platform type (php, nodejs, python, etc.) from project files.
     */
    private function detectGenericPlatform(string $root): string
    {
        if (file_exists("{$root}/composer.json")) {
            return 'php';
        }
        if (file_exists("{$root}/package.json")) {
            return 'nodejs';
        }
        if (file_exists("{$root}/pyproject.toml") || file_exists("{$root}/setup.py")) {
            return 'python';
        }
        if (file_exists("{$root}/go.mod")) {
            return 'go';
        }
        if (file_exists("{$root}/Cargo.toml")) {
            return 'rust';
        }
        return 'generic';
    }
    /**
     * Detect primary language from project files.
     */
    private function detectLanguage(string $root): string
    {
        if (file_exists("{$root}/composer.json")) {
            return 'PHP';
        }
        if (file_exists("{$root}/tsconfig.json")) {
            return 'TypeScript';
        }
        if (file_exists("{$root}/package.json")) {
            return 'JavaScript';
        }
        if (file_exists("{$root}/pyproject.toml") || file_exists("{$root}/setup.py")) {
            return 'Python';
        }
        return '';
    }
    // ── Org/repo resolution ──────────────────────────────────────────────
    /**
     * Resolve org and repo name from environment or git remote.
     *
     * @return array{0: string, 1: string}  [org, repo]
     */
    private function resolveOrgRepo(string $root): array
    {
        // 1. GITHUB_REPOSITORY env (set in Gitea Actions / GitHub Actions)
        $envRepo = getenv('GITHUB_REPOSITORY') ?: '';
        if ($envRepo !== '' && str_contains($envRepo, '/')) {
            return explode('/', $envRepo, 2);
        }
        // 2. Parse git remote origin URL
        $remoteUrl = trim((string) shell_exec(
            'git -C ' . escapeshellarg($root) . ' remote get-url origin 2>/dev/null'
        ));
        if ($remoteUrl !== '') {
            // SSH: git@host:Org/Repo.git  or  HTTPS: https://host/Org/Repo.git
            if (preg_match('#[/:]([^/]+)/([^/]+?)(?:\.git)?$#', $remoteUrl, $m)) {
                return [$m[1], $m[2]];
            }
        }
        return ['', basename($root)];
    }
    // ── Backward-compatible aliases ──────────────────────────────────────
    /**
     * Add hyphenated aliases for underscore fields (backward compat with old manifest.xml consumers).
     * Also map old field names to new ones.
     */
    private function addAliases(array $fields): array
    {
        // Map API field names → old manifest.xml hyphenated names
        $aliases = [
            'display_name'       => 'display-name',
            'license_spdx'       => 'license-spdx',
            'license_name'       => 'license',
            'standards_version'  => 'standards-version',
            'standards_source'   => 'standards-source',
            'extension_type'     => 'package-type',
            'entry_point'        => 'entry-point',
            'element_name'       => 'name',
        ];
        foreach ($aliases as $newKey => $oldKey) {
            if (isset($fields[$newKey]) && !isset($fields[$oldKey])) {
                $fields[$oldKey] = $fields[$newKey];
            }
        }
        return $fields;
    }
    // ── Output ───────────────────────────────────────────────────────────
    private function outputFields(array $fields, string $mode, string $field): int
    {
        switch ($mode) {
            case 'field':
                if ($field === '') {
-                    $this->log('ERROR', "Usage: manifest_read.php --path <dir> --field <name>");
+                    $this->log('ERROR', "Usage: manifest:read --path <dir> --field <name>");
-                    $this->log('ERROR', "       manifest_read.php --path <dir> --all");
+                    $this->log('ERROR', "       manifest:read --path <dir> --all");
-                    $this->log('ERROR', "       manifest_read.php --path <dir> --json");
+                    $this->log('ERROR', "       manifest:read --path <dir> --json");
-                    $this->log('ERROR', "       manifest_read.php --path <dir> --github-output");
+                    $this->log('ERROR', "       manifest:read --path <dir> --github-output");
                    return 2;
                }
                echo ($fields[$field] ?? '') . "\n";
@@ -142,22 +447,21 @@ class ManifestReadCli extends CliFramework
                break;
            case 'github-output':
-                $outputFile = getenv('GITHUB_OUTPUT');
+                $outputFile = getenv('GITHUB_OUTPUT') ?: getenv('GITEA_OUTPUT') ?: '';
-                if ($outputFile === false || $outputFile === '') {
+                $lines = [];
-                    $this->log('ERROR', 'GITHUB_OUTPUT not set — printing to stdout instead');
+                foreach ($fields as $k => $v) {
-                    foreach ($fields as $k => $v) {
+                    $envKey = str_replace('-', '_', $k);
-                        // Convert field-name to FIELD_NAME for env var style
+                    $lines[$envKey] = "{$envKey}={$v}\n";
-                        $envKey = str_replace('-', '_', $k);
+                }
-                        echo "{$envKey}={$v}\n";
+                // Deduplicate (aliases may collide after underscore conversion)
-                    }
+                $output = implode('', $lines);
                if ($outputFile === '') {
                    $this->log('WARNING', 'GITHUB_OUTPUT not set — printing to stdout');
                    echo $output;
                } else {
-                    $fh = fopen($outputFile, 'a');
+                    file_put_contents($outputFile, $output, FILE_APPEND);
-                    foreach ($fields as $k => $v) {
+                    $this->log('INFO', "Wrote " . count($lines) . " fields to GITHUB_OUTPUT");
                        $envKey = str_replace('-', '_', $k);
                        fwrite($fh, "{$envKey}={$v}\n");
                    }
                    fclose($fh);
                    $this->log('INFO', "Wrote " . count($fields) . " fields to GITHUB_OUTPUT");
                }
                break;
        }
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/package_build.php
 * BRIEF: Build ZIP and tar.gz install packages for Joomla/Dolibarr/generic projects
 *
@@ -19,7 +19,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class PackageBuildCli extends CliFramework
 {
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/platform_detect.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Auto-detect repository platform type and optionally update manifest
 */
@@ -18,7 +18,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class PlatformDetectCli extends CliFramework
 {
@@ -82,7 +82,7 @@ class PlatformDetectCli extends CliFramework
                $giteaUrl,
                $token,
                'PATCH',
-                "/api/v1/repos/{$owner}/{$repo}/manifest",
+                "/api/v1/repos/{$owner}/{$repo}/metadata",
                json_encode(['platform' => $platform])
            );
@@ -134,9 +134,9 @@ class PlatformDetectCli extends CliFramework
            }
        }
-        // 5. Platform — is mokoplatform itself or org-config
+        // 5. Platform — is mokocli itself or org-config
        $repoName = basename($root);
-        if (in_array($repoName, ['mokoplatform', 'mokogitea-org-config'])) {
+        if (in_array($repoName, ['mokocli', 'mokogitea-org-config'])) {
            return 'platform';
        }
@@ -6,24 +6,24 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release.php
- * BRIEF: Automate the mokoplatform version branch release flow
+ * BRIEF: Automate the mokocli version branch release flow
 */
 declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleaseCli extends CliFramework
 {
    protected function configure(): void
    {
-        $this->setDescription('Automate the mokoplatform version branch release flow');
+        $this->setDescription('Automate the mokocli version branch release flow');
        $this->addArgument('--bump', 'Bump type: patch, minor, or major', '');
    }
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_body_update.php
 * BRIEF: Update Gitea release body with changelog extract and checksums
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleaseBodyUpdateCli extends CliFramework
 {
@@ -6,31 +6,336 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_cascade.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
- * BRIEF: DEPRECATED — cascade behavior removed. Each release stream is independent.
+ * BRIEF: Cascade release zip to all lower stability channels
 */
 declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleaseCascadeCli extends CliFramework
 {
    /** Channel hierarchy: highest stability first. */
    private const CHANNELS = ['stable', 'release-candidate', 'beta', 'alpha', 'development'];
    /** Map stability input names to canonical tag names. */
    private const TAG_MAP = [
        'stable'            => 'stable',
        'release-candidate' => 'release-candidate',
        'rc'                => 'release-candidate',
        'beta'              => 'beta',
        'alpha'             => 'alpha',
        'development'       => 'development',
        'dev'               => 'development',
    ];
    protected function configure(): void
    {
-        $this->setDescription('DEPRECATED — cascade behavior removed');
+        $this->setDescription('Cascade release zip to all lower stability channels');
        $this->addArgument('--stability', 'Source stability channel (required)', '');
        $this->addArgument('--token', 'Gitea API token (required)', '');
        $this->addArgument('--api-base', 'Gitea API base URL for the repo (required)', '');
    }
    protected function run(): int
    {
-        $this->log('INFO', 'No-op (cascade behavior removed — each stream is independent)');
+        $stability = strtolower($this->getArgument('--stability'));
-        return 0;
+        $token     = $this->getArgument('--token');
        $apiBase   = rtrim($this->getArgument('--api-base'), '/');
        if ($token === '') {
            $envToken = getenv('MOKOGITEA_TOKEN');
            if ($envToken === false || $envToken === '') {
                $envToken = getenv('GITEA_TOKEN');
            }
            if ($envToken !== false && $envToken !== '') {
                $token = $envToken;
            }
        }
        if ($stability === '' || $token === '' || $apiBase === '') {
            $this->log('ERROR', 'Usage: release_cascade.php --stability CHANNEL --token TOKEN --api-base URL');
            return 1;
        }
        $sourceTag = self::TAG_MAP[$stability] ?? null;
        if ($sourceTag === null) {
            $this->log('ERROR', "Unknown stability: {$stability}");
            return 1;
        }
        // Find lower channels to cascade to
        $lowerChannels = $this->getLowerChannels($sourceTag);
        if (count($lowerChannels) === 0) {
            $this->log('INFO', "No lower channels for '{$stability}' — nothing to cascade.");
            return 0;
        }
        $this->log('INFO', "Cascading from '{$sourceTag}' to: " . implode(', ', $lowerChannels));
        if ($this->dryRun) {
            $this->log('INFO', '[DRY RUN] No changes will be made.');
        }
        // 1. Get source release
        $sourceRelease = $this->giteaApi("{$apiBase}/releases/tags/{$sourceTag}", $token);
        if ($sourceRelease === null) {
            $this->log('WARN', "No release found at tag '{$sourceTag}' — nothing to cascade.");
            return 0;
        }
        $sourceVersion = $sourceRelease['name'] ?? $sourceTag;
        $sourceBody    = $sourceRelease['body'] ?? '';
        $sourceAssets  = $sourceRelease['assets'] ?? [];
        // Find zip assets (exclude .sha256 sidecars)
        $zipAssets = array_filter($sourceAssets, function (array $asset): bool {
            $name = strtolower($asset['name'] ?? '');
            return str_ends_with($name, '.zip') && !str_ends_with($name, '.sha256');
        });
        // Also grab sha256 sidecars
        $sha256Assets = array_filter($sourceAssets, function (array $asset): bool {
            return str_ends_with(strtolower($asset['name'] ?? ''), '.zip.sha256');
        });
        if (count($zipAssets) === 0) {
            $this->log('WARN', "Source release '{$sourceTag}' has no zip assets — nothing to cascade.");
            return 0;
        }
        $this->log('INFO', "Source: {$sourceVersion} — " . count($zipAssets) . " zip(s)");
        echo "\n";
        // 2. Download source assets to temp files
        $downloads = [];
        foreach (array_merge($zipAssets, $sha256Assets) as $asset) {
            $url = $asset['browser_download_url'] ?? '';
            if ($url === '') {
                continue;
            }
            $tmpFile = tempnam(sys_get_temp_dir(), 'cascade_');
            if ($this->downloadFile($url, $token, $tmpFile)) {
                $downloads[] = ['name' => $asset['name'], 'path' => $tmpFile];
                $this->log('INFO', "Downloaded: {$asset['name']}");
            } else {
                $this->log('ERROR', "Failed to download: {$asset['name']}");
            }
        }
        if (count($downloads) === 0) {
            $this->log('ERROR', 'Could not download any source assets.');
            return 1;
        }
        // 3. Cascade to each lower channel
        $errors = 0;
        foreach ($lowerChannels as $targetTag) {
            echo "\n";
            $result = $this->cascadeToChannel(
                $apiBase, $token, $targetTag,
                $sourceVersion, $sourceBody, $downloads
            );
            if (!$result) {
                $errors++;
            }
        }
        // 4. Cleanup temp files
        foreach ($downloads as $dl) {
            @unlink($dl['path']);
        }
        echo "\n";
        $this->log('INFO', "Cascade complete. " . (count($lowerChannels) - $errors)
            . "/" . count($lowerChannels) . " channels updated.");
        return $errors > 0 ? 1 : 0;
    }
    /**
     * Cascade assets to a single target channel.
     */
    private function cascadeToChannel(
        string $apiBase,
        string $token,
        string $targetTag,
        string $sourceVersion,
        string $sourceBody,
        array $downloads
    ): bool {
        $this->log('INFO', "→ {$targetTag}");
        if ($this->dryRun) {
            $this->log('INFO', "  [DRY RUN] Would cascade to {$targetTag}");
            return true;
        }
        // Find existing release at target tag
        $existing = $this->giteaApi("{$apiBase}/releases/tags/{$targetTag}", $token);
        if ($existing !== null && !empty($existing['id'])) {
            $releaseId = (int) $existing['id'];
            // Delete existing assets
            $existingAssets = $existing['assets'] ?? [];
            foreach ($existingAssets as $asset) {
                $assetId = $asset['id'] ?? 0;
                if ($assetId > 0) {
                    $this->giteaApi(
                        "{$apiBase}/releases/{$releaseId}/assets/{$assetId}",
                        $token, 'DELETE'
                    );
                }
            }
            // Update release metadata
            $updatePayload = json_encode([
                'name' => $sourceVersion,
                'body' => $sourceBody,
            ]);
            $this->giteaApi(
                "{$apiBase}/releases/{$releaseId}",
                $token, 'PATCH', $updatePayload
            );
            $this->log('INFO', "  Updated release metadata (id: {$releaseId})");
        } else {
            // Create new release at target tag
            // Use the source release's target commitish so the tag points to the same commit
            $createPayload = json_encode([
                'tag_name'          => $targetTag,
                'target_commitish'  => 'main',
                'name'              => $sourceVersion,
                'body'              => $sourceBody,
                'prerelease'        => ($targetTag !== 'stable'),
            ]);
            $newRelease = $this->giteaApi("{$apiBase}/releases", $token, 'POST', $createPayload);
            if ($newRelease === null || empty($newRelease['id'])) {
                $this->log('ERROR', "  Failed to create release at tag '{$targetTag}'");
                return false;
            }
            $releaseId = (int) $newRelease['id'];
            $this->log('INFO', "  Created release (id: {$releaseId})");
        }
        // Upload assets
        foreach ($downloads as $dl) {
            $uploadUrl = "{$apiBase}/releases/{$releaseId}/assets?name=" . rawurlencode($dl['name']);
            $success = $this->uploadAsset($uploadUrl, $token, $dl['path'], $dl['name']);
            if ($success) {
                $this->log('INFO', "  Uploaded: {$dl['name']}");
            } else {
                $this->log('ERROR', "  Failed to upload: {$dl['name']}");
            }
        }
        return true;
    }
    /**
     * Get all channels below the given source channel.
     */
    private function getLowerChannels(string $sourceTag): array
    {
        $idx = array_search($sourceTag, self::CHANNELS, true);
        if ($idx === false) {
            return [];
        }
        return array_slice(self::CHANNELS, $idx + 1);
    }
    /**
     * Download a file via HTTP.
     */
    private function downloadFile(string $url, string $token, string $destPath): bool
    {
        $ch = curl_init($url);
        if ($ch === false) {
            return false;
        }
        $fp = fopen($destPath, 'wb');
        if ($fp === false) {
            return false;
        }
        curl_setopt_array($ch, [
            CURLOPT_FOLLOWLOCATION => true,
            CURLOPT_FILE           => $fp,
            CURLOPT_HTTPHEADER     => ["Authorization: token {$token}"],
            CURLOPT_TIMEOUT        => 120,
        ]);
        curl_exec($ch);
        $code = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        fclose($fp);
        return $code >= 200 && $code < 300;
    }
    /**
     * Upload a file as a release asset via multipart form.
     */
    private function uploadAsset(string $url, string $token, string $filePath, string $fileName): bool
    {
        $ch = curl_init($url);
        if ($ch === false) {
            return false;
        }
        $cfile = new CURLFile($filePath, 'application/octet-stream', $fileName);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => ['attachment' => $cfile],
            CURLOPT_HTTPHEADER     => ["Authorization: token {$token}"],
            CURLOPT_TIMEOUT        => 120,
        ]);
        $response = curl_exec($ch);
        $code = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        return $code >= 200 && $code < 300;
    }
    /**
     * Make an HTTP request to the Gitea API.
     */
    private function giteaApi(
        string $url,
        string $token,
        string $method = 'GET',
        ?string $body = null
    ): ?array {
        $ch = curl_init($url);
        if ($ch === false) {
            return null;
        }
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER     => [
                "Authorization: token {$token}",
                'Content-Type: application/json',
            ],
            CURLOPT_TIMEOUT        => 30,
            CURLOPT_CUSTOMREQUEST  => $method,
        ]);
        if ($body !== null) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
        }
        $response = curl_exec($ch);
        $httpCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($httpCode < 200 || $httpCode >= 300 || empty($response) || !is_string($response)) {
            return null;
        }
        $decoded = json_decode($response, true);
        return is_array($decoded) ? $decoded : null;
    }
 }
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_create.php
 * BRIEF: Create or overwrite a Gitea release with proper naming
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class ReleaseCreateCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_manage.php
 * BRIEF: Create/update Gitea releases, upload assets, update release body
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleaseManageCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_mirror.php
 * BRIEF: Mirror a Gitea release (with assets) to a GitHub repository
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleaseMirrorCli extends CliFramework
 {
@@ -201,7 +201,7 @@ class ReleaseMirrorCli extends CliFramework
            CURLOPT_HTTPHEADER => [
                "Authorization: token {$token}",
                'Accept: application/vnd.github+json',
-                'User-Agent: mokoplatform',
+                'User-Agent: mokocli',
                'Content-Type: application/json',
            ],
            CURLOPT_TIMEOUT => 30,
@@ -229,7 +229,7 @@ class ReleaseMirrorCli extends CliFramework
            CURLOPT_HTTPHEADER => [
                "Authorization: token {$token}",
                'Accept: application/vnd.github+json',
-                'User-Agent: mokoplatform',
+                'User-Agent: mokocli',
                'Content-Type: application/octet-stream',
            ],
            CURLOPT_POSTFIELDS => file_get_contents($filePath),
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_notes.php
 * BRIEF: Extract release notes from CHANGELOG.md for a given version
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleaseNotesCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_package.php
 * BRIEF: Build packages (ZIP + tar.gz) with SHA-256 and upload to Gitea release
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class ReleasePackageCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_promote.php
 * BRIEF: Promote a Gitea release from one channel to another (rename release, tag, assets)
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class ReleasePromoteCli extends CliFramework
 {
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_publish.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Publish a release and create copies for all lesser stability streams.
 */
@@ -18,7 +18,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleasePublishCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_validate.php
 * BRIEF: Pre-release validation -- version consistency, required files, manifest checks
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class ReleaseValidateCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/release_verify.php
 * BRIEF: Verify a built release artifact — version, SHA256, disallowed files
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ReleaseVerifyCli extends CliFramework
 {
@@ -0,0 +1,429 @@
 #!/usr/bin/env php
 <?php
 /* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 * SPDX-License-Identifier: GPL-3.0-or-later
 * FILE INFORMATION
 * DEFGROUP: mokocli.CLI
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/repo_wizard.php
 * BRIEF: Interactive configuration wizard for new repositories
 */
 declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
 use MokoCli\{CliFramework, Config, PlatformAdapterFactory};
 /**
 * Interactive repo setup wizard.
 *
 * Walks through platform selection, generates config files, workflows,
 * and optionally creates the repo on Gitea via API.
 *
 * @see https://git.mokoconsulting.tech/MokoConsulting/mokocli/issues/145
 */
 class RepoWizard extends CliFramework
 {
    private const PLATFORMS = [
        'joomla'     => 'Joomla extension (component, module, plugin, package)',
        'dolibarr'   => 'Dolibarr ERP module',
        'nodejs'     => 'Node.js / TypeScript project',
        'python'     => 'Python project',
        'mcp-server' => 'MCP server (Model Context Protocol)',
        'generic'    => 'Generic PHP or multi-language project',
    ];
    private const LICENSES = [
        'GPL-3.0-or-later' => 'GNU General Public License v3',
        'MIT'              => 'MIT License',
        'Apache-2.0'       => 'Apache License 2.0',
        'proprietary'      => 'Proprietary / All rights reserved',
    ];
    /** Collected wizard answers. */
    private array $answers = [];
    /** When true, skip all interactive prompts and use defaults. */
    private bool $nonInteractive = false;
    protected function configure(): void
    {
        $this->setDescription('Interactive configuration wizard for new repositories');
        $this->addArgument('--path',            'Directory to generate files in',  '.');
        $this->addArgument('--create-remote',   'Create repo on Gitea via API',    false);
        $this->addArgument('--non-interactive', 'Use defaults (no prompts)',        false);
    }
    protected function run(): int
    {
        $rawPath    = $this->getArgument('--path', '.');
        $targetPath = realpath($rawPath) ?: $rawPath;
        $this->nonInteractive = (bool) $this->getArgument('--non-interactive', false);
        // Validate target path
        if (!is_dir($targetPath) && !@mkdir($targetPath, 0755, true)) {
            $this->log('ERROR', "Target path does not exist and cannot be created: {$targetPath}");
            return self::EXIT_USAGE;
        }
        $targetPath = realpath($targetPath) ?: $targetPath;
        $this->section('MokoCli Repository Wizard');
        // ── Gather info ──────────────────────────────────────────────
        $this->answers['name']        = $this->ask('Repository name', basename($targetPath));
        $this->answers['platform']    = $this->choose('Platform type', self::PLATFORMS, 'generic');
        $this->answers['org']         = $this->ask('Organization', 'MokoConsulting');
        $this->answers['description'] = $this->ask('Description', '');
        $this->answers['license']     = $this->choose('License', self::LICENSES, 'GPL-3.0-or-later');
        // ── Confirm ──────────────────────────────────────────────────
        $this->section('Configuration Summary');
        foreach ($this->answers as $key => $value) {
            $this->log('INFO', sprintf('  %-12s %s', $key . ':', $value));
        }
        if (!$this->confirm('Proceed with these settings?', true)) {
            $this->log('INFO', 'Wizard cancelled');
            return 0;
        }
        // ── Generate files ───────────────────────────────────────────
        $this->section('Generating files');
        $generated = $this->generateFiles($targetPath);
        foreach ($generated as $file) {
            $this->status(true, $file);
        }
        // ── Create remote repo ───────────────────────────────────────
        if ($this->getArgument('--create-remote', false)) {
            $this->section('Creating remote repository');
            $this->createRemoteRepo();
        }
        $this->log('INFO', '');
        $this->log('INFO', 'Generated ' . count($generated) . " files in {$targetPath}");
        $this->log('INFO', 'Next: git init && git add -A && git commit -m "chore: initial scaffold"');
        return 0;
    }
    // ── File generation ──────────────────────────────────────────────
    private function generateFiles(string $path): array
    {
        $platform = $this->answers['platform'];
        $name     = $this->answers['name'];
        $generated = [];
        // .editorconfig
        $generated[] = $this->writeFile($path, '.editorconfig', $this->editorconfig());
        // README.md
        $generated[] = $this->writeFile($path, 'README.md', $this->readme());
        // CHANGELOG.md
        $generated[] = $this->writeFile($path, 'CHANGELOG.md', $this->changelog());
        // LICENSE
        if ($this->answers['license'] !== 'proprietary') {
            $generated[] = $this->writeFile($path, 'LICENSE', "See SPDX: {$this->answers['license']}");
        }
        // Platform-specific configs
        switch ($platform) {
            case 'joomla':
            case 'dolibarr':
            case 'generic':
                $generated[] = $this->writeFile($path, 'phpcs.xml', $this->phpcsXml());
                $generated[] = $this->writeFile($path, 'phpstan.neon', $this->phpstanNeon());
                $generated[] = $this->writeFile($path, 'composer.json', $this->composerJson());
                break;
            case 'nodejs':
            case 'mcp-server':
                $generated[] = $this->writeFile($path, 'package.json', $this->packageJson());
                $generated[] = $this->writeFile($path, 'tsconfig.json', $this->tsconfigJson());
                $generated[] = $this->writeFile($path, '.eslintrc.json', $this->eslintrc());
                break;
            case 'python':
                $generated[] = $this->writeFile($path, 'pyproject.toml', $this->pyprojectToml());
                $generated[] = $this->writeFile($path, 'requirements.txt', '');
                break;
        }
        // .mokogitea/workflows
        $generated[] = $this->writeFile($path, '.mokogitea/workflows/pr-check.yml',
            "# PR check workflow — synced from mokocli templates\n# Run: moko sync to update\n");
        // .gitignore
        $generated[] = $this->writeFile($path, '.gitignore', $this->gitignore($platform));
        // Source directory
        $srcDir = in_array($platform, ['joomla', 'dolibarr', 'generic']) ? 'source' : 'src';
        if (!is_dir("{$path}/{$srcDir}")) {
            @mkdir("{$path}/{$srcDir}", 0755, true);
            $generated[] = "{$srcDir}/";
        }
        return array_filter($generated);
    }
    private function writeFile(string $basePath, string $relativePath, string $content): ?string
    {
        $fullPath = $basePath . '/' . $relativePath;
        $dir = dirname($fullPath);
        if (file_exists($fullPath)) {
            $this->log('DEBUG', "  SKIP  {$relativePath} (already exists)");
            return null;
        }
        if ($this->dryRun) {
            $this->log('INFO', "[dry-run] Would create {$relativePath}");
            return $relativePath;
        }
        if (!is_dir($dir)) {
            @mkdir($dir, 0755, true);
        }
        file_put_contents($fullPath, $content);
        return $relativePath;
    }
    // ── Remote repo creation ─────────────────────────────────────────
    private function createRemoteRepo(): void
    {
        try {
            $config  = Config::load();
            $adapter = PlatformAdapterFactory::create($config);
            $org     = $this->answers['org'];
            if ($this->dryRun) {
                $this->log('INFO', "[dry-run] Would create {$org}/{$this->answers['name']} on Gitea");
                return;
            }
            $result = $adapter->createRepository($org, $this->answers['name'], [
                'description' => $this->answers['description'],
                'private'     => false,
            ]);
            $url = $result['html_url'] ?? "{$org}/{$this->answers['name']}";
            $this->log('INFO', "Created: {$url}");
        } catch (\Exception $e) {
            $this->log('ERROR', "Failed to create remote repo: {$e->getMessage()}");
        }
    }
    // ── Interactive helpers (respect --non-interactive) ─────────────
    private function ask(string $prompt, string $default): string
    {
        if ($this->nonInteractive) {
            return $default;
        }
        return $this->input($prompt, $default);
    }
    private function choose(string $prompt, array $options, string $default): string
    {
        if ($this->nonInteractive) {
            return $default;
        }
        $keys = array_keys($options);
        $labels = [];
        foreach ($options as $key => $desc) {
            $labels[] = "{$key} — {$desc}";
        }
        $chosen = $this->select($prompt, $labels);
        // Extract the key from "key — description"
        $chosenKey = explode(' — ', $chosen, 2)[0] ?? $default;
        return in_array($chosenKey, $keys, true) ? $chosenKey : $default;
    }
    // ── Template content ─────────────────────────────────────────────
    private function editorconfig(): string
    {
        return <<<'CONF'
 root = true
 [*]
 charset = utf-8
 end_of_line = lf
 indent_size = 4
 indent_style = tab
 insert_final_newline = true
 trim_trailing_whitespace = true
 [*.{yml,yaml}]
 indent_style = space
 indent_size = 2
 [*.md]
 trim_trailing_whitespace = false
 CONF;
    }
    private function readme(): string
    {
        $name = $this->answers['name'];
        $desc = $this->answers['description'] ?: 'A Moko Consulting project.';
        $license = $this->answers['license'];
        return <<<MD
 # {$name}
 {$desc}
 ## License
 {$license}
 MD;
    }
    private function changelog(): string
    {
        return <<<MD
 # Changelog
 ## [Unreleased]
 ### Added
 - Initial project scaffold
 MD;
    }
    private function composerJson(): string
    {
        $data = [
            'name'        => 'mokoconsulting/' . strtolower($this->answers['name']),
            'description' => $this->answers['description'] ?: $this->answers['name'],
            'type'        => 'library',
            'license'     => $this->answers['license'],
            'require'     => ['php' => '>=8.1'],
            'autoload'    => ['psr-4' => new \stdClass()],
        ];
        return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . "\n";
    }
    private function phpcsXml(): string
    {
        return <<<'XML'
 <?xml version="1.0"?>
 <ruleset name="MokoCli">
    <rule ref="PSR12"/>
    <file>source/</file>
    <exclude-pattern>vendor/*</exclude-pattern>
 </ruleset>
 XML;
    }
    private function phpstanNeon(): string
    {
        return <<<'NEON'
 parameters:
    level: 6
    paths:
        - source/
 NEON;
    }
    private function packageJson(): string
    {
        $data = [
            'name'            => '@mokoconsulting/' . strtolower($this->answers['name']),
            'version'         => '0.1.0',
            'description'     => $this->answers['description'] ?: $this->answers['name'],
            'type'            => 'module',
            'scripts'         => ['build' => 'tsc', 'start' => 'node dist/index.js'],
            'devDependencies' => ['typescript' => '^5.0'],
        ];
        return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . "\n";
    }
    private function tsconfigJson(): string
    {
        return <<<'JSON'
 {
    "compilerOptions": {
        "target": "ES2022",
        "module": "NodeNext",
        "moduleResolution": "NodeNext",
        "outDir": "./dist",
        "rootDir": "./src",
        "strict": true,
        "declaration": true
    },
    "include": ["src/**/*"]
 }
 JSON;
    }
    private function eslintrc(): string
    {
        return <<<'JSON'
 {
    "root": true,
    "parser": "@typescript-eslint/parser",
    "plugins": ["@typescript-eslint"],
    "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"]
 }
 JSON;
    }
    private function pyprojectToml(): string
    {
        $name = strtolower($this->answers['name']);
        $desc = str_replace(['\\', '"'], ['\\\\', '\\"'], $this->answers['description'] ?: $this->answers['name']);
        return <<<TOML
 [project]
 name = "{$name}"
 version = "0.1.0"
 description = "{$desc}"
 requires-python = ">=3.10"
 [build-system]
 requires = ["setuptools>=68.0"]
 build-backend = "setuptools.build_meta"
 TOML;
    }
    private function gitignore(string $platform): string
    {
        $common = <<<'GI'
 # IDE
 .idea/
 .vscode/
 *.swp
 *.swo
 # OS
 .DS_Store
 Thumbs.db
 desktop.ini
 # Logs
 *.log
 GI;
        $extra = match ($platform) {
            'joomla', 'dolibarr', 'generic' => "\n# PHP\nvendor/\n.phpunit.result.cache\n",
            'nodejs', 'mcp-server' => "\n# Node\nnode_modules/\ndist/\n*.tsbuildinfo\n",
            'python' => "\n# Python\n__pycache__/\n*.pyc\n.venv/\n*.egg-info/\n",
            default => '',
        };
        return $common . $extra;
    }
 }
 $app = new RepoWizard('repo_wizard');
 exit($app->execute());
@@ -8,11 +8,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/scaffold_client.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Scaffold a new client-waas repo from Template-Client-WaaS with pre-configured settings
 */
@@ -20,7 +20,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class ScaffoldClientCli extends CliFramework
 {
@@ -8,9 +8,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/sync_rulesets.php
 * BRIEF: Apply branch protection rules to all repos via platform adapter
 */
@@ -20,9 +20,9 @@ declare(strict_types=1);
 require_once __DIR__ . '/../vendor/autoload.php';
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
-use MokoEnterprise\Config;
+use MokoCli\Config;
-use MokoEnterprise\PlatformAdapterFactory;
+use MokoCli\PlatformAdapterFactory;
 class SyncRulesetsCli extends CliFramework
 {
@@ -46,7 +46,7 @@ class SyncRulesetsCli extends CliFramework
        );
        $platformName  = $adapter->getPlatformName();
-        $ALWAYS_EXCLUDE = ['mokoplatform', '.github-private'];
+        $ALWAYS_EXCLUDE = ['mokocli', '.github-private'];
        // -- Protection rules (platform-agnostic format) --
        $PROTECTIONS = [
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/theme_lint.php
 * BRIEF: Lint theme files -- CSS syntax, image sizes, hardcoded URLs
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class ThemeLintCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/updates_xml_build.php
 * BRIEF: Generate Joomla updates.xml from extension manifest metadata
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class UpdatesXmlBuildCli extends CliFramework
 {
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/updates_xml_sync.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * 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
@@ -21,7 +21,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class UpdatesXmlSyncCli extends CliFramework
 {
@@ -6,11 +6,11 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/version_auto_bump.php
- * VERSION: 09.26.00
+ * VERSION: 09.37.01
 * BRIEF: Auto patch-bump, set stability suffix, and commit — single CLI replacing inline workflow bash
 */
@@ -18,7 +18,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\CliFramework;
+use MokoCli\CliFramework;
 class VersionAutoBumpCli extends CliFramework
 {
@@ -6,9 +6,9 @@
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
- * DEFGROUP: mokoplatform.CLI
+ * DEFGROUP: mokocli.CLI
- * INGROUP: mokoplatform
+ * INGROUP: mokocli
- * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+ * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/version_bump.php
 * BRIEF: Auto-increment version -- manifest.xml is canonical, cascades to all XML and MD files
 */
@@ -17,7 +17,7 @@ declare(strict_types=1);
 require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
-use MokoEnterprise\{CliFramework, SourceResolver};
+use MokoCli\{CliFramework, SourceResolver};
 class VersionBumpCli extends CliFramework
 {
@@ -27,6 +27,7 @@ class VersionBumpCli extends CliFramework
        $this->addArgument('--path', 'Repository root', '.');
        $this->addArgument('--minor', 'Bump minor version', false);
        $this->addArgument('--major', 'Bump major version', false);
        $this->addArgument('--min-version', 'Minimum base version (ensures bump is above this)', '');
    }
    protected function run(): int
@@ -116,6 +117,28 @@ class VersionBumpCli extends CliFramework
                $baseVersion = $v;
            }
        }
        // Check --min-version: ensures dev never falls behind stable
        $minVersion = $this->getArgument('--min-version');
        if (!empty($minVersion)) {
            $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})");
                    $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;
            }
        }
        if ($baseVersion === null) {
            $this->log('ERROR', "No version found in manifest.xml, README.md, or Joomla XML");
            return 1;
@@ -232,9 +255,25 @@ class VersionBumpCli extends CliFramework
                    $pkgContent
                );
            }
-            if ($updatedPkg !== $pkgContent) {
+            if ($updatedPkg !== $pkgContent && $updatedPkg !== null) {
                file_put_contents($packageJsonFile, $updatedPkg);
                fwrite(STDERR, "Updated package.json\n");
            } elseif (preg_match('/("version"\s*:\s*")(\d+)\.(\d+)\.(\d+)(")/m', $pkgContent, $semM)) {
                // Semver fallback: bump standard x.y.z version when XX.YY.ZZ pattern didn't match
                $sMajor = (int)$semM[2];
                $sMinor = (int)$semM[3];
                $sPatch = (int)$semM[4];
                switch ($type) {
                    case 'major': $sMajor++; $sMinor = 0; $sPatch = 0; break;
                    case 'minor': $sMinor++; $sPatch = 0; break;
                    default: $sPatch++; break;
                }
                $semNew = "{$sMajor}.{$sMinor}.{$sPatch}";
                $semUpdated = preg_replace('/("version"\s*:\s*")\d+\.\d+\.\d+(")/m', '${1}' . $semNew . '${2}', $pkgContent);
                if ($semUpdated !== $pkgContent) {
                    file_put_contents($packageJsonFile, $semUpdated);
                    fwrite(STDERR, "Updated package.json (semver: {$semM[2]}.{$semM[3]}.{$semM[4]} -> $semNew)\n");
                }
            }
        }
        $pyprojectFile = "{$root}/pyproject.toml";
@@ -327,6 +366,54 @@ class VersionBumpCli extends CliFramework
        echo "{$old} -> {$newFull}\n";
        return 0;
    }
    /**
     * Scan git release tags for the highest version across all channels.
     *
     * Checks release names like "MokoSuiteClient (VERSION: 09.37.01)" in
     * git tags (stable, release-candidate, development, etc.) to find the
     * highest version that has been released on any channel.
     */
    private function getHighestGitTagVersion(string $root): ?string
    {
        $highest = null;
        // Method 1: Parse version from git tag annotations / release commit messages
        $output = [];
        exec("cd " . escapeshellarg($root) . " && git log --all --oneline --grep='chore(version)' --grep='chore(release)' --format='%s' -20 2>/dev/null", $output);
        foreach ($output as $line) {
            if (preg_match('/(\d{2}\.\d{2}\.\d{2})/', $line, $m)) {
                $v = preg_replace('/-(?:dev|alpha|beta|rc)$/', '', $m[1]);
                if ($highest === null || version_compare($v, $highest, '>')) {
                    $highest = $v;
                }
            }
        }
        // Method 2: Check version in remote branches' manifest files
        $branches = ['origin/main', 'origin/rc', 'origin/dev'];
        $manifestPaths = ['source/pkg_*.xml', 'pkg_*.xml'];
        foreach ($branches as $branch) {
            foreach ($manifestPaths as $pattern) {
                $files = [];
                exec("cd " . escapeshellarg($root) . " && git ls-tree --name-only {$branch} -- '{$pattern}' 2>/dev/null", $files);
                foreach ($files as $file) {
                    $content = shell_exec("cd " . escapeshellarg($root) . " && git show {$branch}:{$file} 2>/dev/null");
                    if ($content && preg_match('#<version>(\d{2}\.\d{2}\.\d{2})(?:-(?:dev|alpha|beta|rc))?</version>#', $content, $m)) {
                        $v = $m[1];
                        if ($highest === null || version_compare($v, $highest, '>')) {
                            $highest = $v;
                        }
                    }
                }
            }
        }
        return $highest;
    }
 }
 $app = new VersionBumpCli();
--- a/Show More
+++ b/Show More