Execute MokoStandards migration - convert to thin caller workflows

Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>

.github/workflows/ci.yml

@@ -18,65 +18,8 @@ permissions:
   contents: read
 
 jobs:
-  ci:
+  validation:
-    name: Repository Validation Pipeline
+    uses: mokoconsulting-tech/MokoStandards/.github/workflows/reusable-ci-validation.yml@v1
-    runs-on: ubuntu-latest
-
-    env:
-      CI: true
-      PROFILE: all
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
     with:
-          fetch-depth: 0
+      validation-scripts-path: 'scripts/validate'
-
+    secrets: inherit
-      - name: Normalize line endings
-        run: |
-          git config --global core.autocrlf false
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.x'
-
-      - name: Verify script executability
-        run: |
-          chmod +x scripts/**/*.py || true
-
-      - name: Required validations
-        run: |
-          set -e
-
-          python3 scripts/validate/manifest.py
-          python3 scripts/validate/xml_wellformed.py
-          python3 scripts/validate/workflows.py
-
-      - name: Optional validations
-        run: |
-          set +e
-
-          python3 scripts/validate/changelog.py || echo "changelog validation not yet converted"
-          python3 scripts/validate/language_structure.py || echo "language_structure validation not yet converted"
-          python3 scripts/validate/license_headers.py || echo "license_headers validation not yet converted"
-          python3 scripts/validate/no_secrets.py
-          python3 scripts/validate/paths.py
-          python3 scripts/validate/php_syntax.py
-          python3 scripts/validate/tabs.py
-          python3 scripts/validate/version_alignment.py || echo "version_alignment validation not yet converted"
-          python3 scripts/validate/version_hierarchy.py || echo "version_hierarchy validation not yet converted"
-
-      - name: CI summary
-        if: always()
-        run: |
-          {
-            echo "### CI Execution Summary"
-            echo ""
-            echo "- Repository: $GITHUB_REPOSITORY"
-            echo "- Branch: $GITHUB_REF_NAME"
-            echo "- Commit: $GITHUB_SHA"
-            echo "- Runner: ubuntu-latest"
-            echo ""
-            echo "CI completed. Review logs above for validation outcomes."
-          } >> "$GITHUB_STEP_SUMMARY"

.github/workflows/joomla_testing.yml

@@ -16,255 +16,10 @@ permissions:
   contents: read
 
 jobs:
-  joomla-setup:
+  testing:
-    name: Joomla ${{ matrix.joomla-version }} - PHP ${{ matrix.php-version }}
+    uses: mokoconsulting-tech/MokoStandards/.github/workflows/reusable-joomla-testing.yml@v1
-    runs-on: ubuntu-latest
-    
-    strategy:
-      fail-fast: false
-      matrix:
-        php-version: ['8.0', '8.1', '8.2', '8.3']
-        joomla-version: ['4.4', '5.0', '5.1']
-        exclude:
-          # Joomla 4.4 doesn't support PHP 8.3
-          - php-version: '8.3'
-            joomla-version: '4.4'
-    
-    services:
-      mysql:
-        image: mysql:8.0
-        env:
-          MYSQL_ROOT_PASSWORD: root
-          MYSQL_DATABASE: joomla_test
-        ports:
-          - 3306:3306
-        options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
-    
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
     with:
-          php-version: ${{ matrix.php-version }}
+      php-versions: '["8.0", "8.1", "8.2", "8.3"]'
-          extensions: mbstring, xml, ctype, json, zip, mysqli, pdo, pdo_mysql, gd, curl, openssl, fileinfo
+      joomla-versions: '["4.4", "5.0", "5.1"]'
-          coverage: none
+      template-path: 'src'
-          tools: composer:v2
+    secrets: inherit
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-
-      - name: Cache Joomla Downloads
-        uses: actions/cache@v4
-        with:
-          path: /tmp/joomla-cache
-          key: joomla-${{ matrix.joomla-version }}
-          restore-keys: |
-            joomla-${{ matrix.joomla-version }}
-
-      - name: Download Joomla ${{ matrix.joomla-version }}
-        run: |
-          mkdir -p /tmp/joomla
-          mkdir -p /tmp/joomla-cache
-          
-          # Define ZIP file based on version
-          if [ "${{ matrix.joomla-version }}" = "4.4" ]; then
-            ZIP_FILE="Joomla_4-4-9-Stable-Full_Package.zip"
-            ZIP_URL="https://downloads.joomla.org/cms/joomla4/4-4-9/${ZIP_FILE}"
-          elif [ "${{ matrix.joomla-version }}" = "5.0" ]; then
-            ZIP_FILE="Joomla_5-0-3-Stable-Full_Package.zip"
-            ZIP_URL="https://downloads.joomla.org/cms/joomla5/5-0-3/${ZIP_FILE}"
-          else
-            ZIP_FILE="Joomla_5-1-4-Stable-Full_Package.zip"
-            ZIP_URL="https://downloads.joomla.org/cms/joomla5/5-1-4/${ZIP_FILE}"
-          fi
-          
-          # Use cached ZIP if available, otherwise download
-          if [ -f "/tmp/joomla-cache/${ZIP_FILE}" ]; then
-            echo "Using cached Joomla package: ${ZIP_FILE}"
-            cp "/tmp/joomla-cache/${ZIP_FILE}" "/tmp/joomla/"
-          else
-            echo "Downloading Joomla package: ${ZIP_FILE}"
-            wget -q "${ZIP_URL}" -O "/tmp/joomla/${ZIP_FILE}"
-            cp "/tmp/joomla/${ZIP_FILE}" "/tmp/joomla-cache/"
-          fi
-          
-          cd /tmp/joomla
-          unzip -q "${ZIP_FILE}"
-
-      - name: Configure Joomla
-        run: |
-          cd /tmp/joomla
-          
-          # Create configuration.php
-          cat > configuration.php << 'EOF'
-          <?php
-          class JConfig {
-              public $offline = '0';
-              public $offline_message = 'This site is down for maintenance.<br>Please check back again soon.';
-              public $display_offline_message = '1';
-              public $offline_image = '';
-              public $sitename = 'Joomla Test Site';
-              public $editor = 'tinymce';
-              public $captcha = '0';
-              public $list_limit = '20';
-              public $access = '1';
-              public $debug = '0';
-              public $debug_lang = '0';
-              public $debug_lang_const = '1';
-              public $dbtype = 'mysqli';
-              public $host = '127.0.0.1';
-              public $user = 'root';
-              public $password = 'root';
-              public $db = 'joomla_test';
-              public $dbprefix = 'jos_';
-              public $dbencryption = 0;
-              public $dbsslverifyservercert = false;
-              public $dbsslkey = '';
-              public $dbsslcert = '';
-              public $dbsslca = '';
-              public $dbsslcipher = '';
-              public $force_ssl = 0;
-              public $live_site = '';
-              public $secret = 'testSecretKey123';
-              public $gzip = '0';
-              public $error_reporting = 'default';
-              public $helpurl = 'https://help.joomla.org/proxy?keyref=Help{major}{minor}:{keyref}&lang={langcode}';
-              public $offset = 'UTC';
-              public $mailonline = '1';
-              public $mailer = 'mail';
-              public $mailfrom = 'test@example.com';
-              public $fromname = 'Joomla Test';
-              public $sendmail = '/usr/sbin/sendmail';
-              public $smtpauth = '0';
-              public $smtpuser = '';
-              public $smtppass = '';
-              public $smtphost = 'localhost';
-              public $smtpsecure = 'none';
-              public $smtpport = '25';
-              public $caching = '0';
-              public $cache_handler = 'file';
-              public $cachetime = '15';
-              public $cache_platformprefix = '0';
-              public $MetaDesc = '';
-              public $MetaAuthor = '1';
-              public $MetaVersion = '0';
-              public $robots = '';
-              public $sef = '1';
-              public $sef_rewrite = '0';
-              public $sef_suffix = '0';
-              public $unicodeslugs = '0';
-              public $feed_limit = '10';
-              public $feed_email = 'none';
-              public $log_path = '/tmp/joomla/administrator/logs';
-              public $tmp_path = '/tmp/joomla/tmp';
-              public $lifetime = '15';
-              public $session_handler = 'database';
-              public $shared_session = '0';
-              public $session_metadata = true;
-          }
-          EOF
-
-      - name: Install Joomla database
-        run: |
-          mysql -h 127.0.0.1 -uroot -proot joomla_test < /tmp/joomla/installation/sql/mysql/base.sql || true
-          mysql -h 127.0.0.1 -uroot -proot joomla_test < /tmp/joomla/installation/sql/mysql/extensions.sql || true
-          mysql -h 127.0.0.1 -uroot -proot joomla_test < /tmp/joomla/installation/sql/mysql/supports.sql || true
-
-      - name: Install template into Joomla
-        run: |
-          # Copy template files to Joomla
-          mkdir -p /tmp/joomla/templates/moko-cassiopeia
-          cp -r src/templates/* /tmp/joomla/templates/moko-cassiopeia/ || true
-          
-          # Copy media files
-          mkdir -p /tmp/joomla/media/templates/site/moko-cassiopeia
-          cp -r src/media/* /tmp/joomla/media/templates/site/moko-cassiopeia/ || true
-          
-          # Copy language files
-          mkdir -p /tmp/joomla/language/en-GB
-          cp src/language/en-GB/*.ini /tmp/joomla/language/en-GB/ || true
-          mkdir -p /tmp/joomla/administrator/language/en-GB
-          cp src/administrator/language/en-GB/*.ini /tmp/joomla/administrator/language/en-GB/ || true
-
-      - name: Validate template installation
-        run: |
-          if [ -f "/tmp/joomla/templates/moko-cassiopeia/templateDetails.xml" ]; then
-            echo "✓ Template installed successfully"
-            php -l /tmp/joomla/templates/moko-cassiopeia/index.php
-          else
-            echo "✗ Template installation failed"
-            exit 1
-          fi
-
-      - name: Test Summary
-        if: always()
-        run: |
-          {
-            echo "### Joomla ${{ matrix.joomla-version }} Testing with PHP ${{ matrix.php-version }}"
-            echo ""
-            echo "- Joomla Version: ${{ matrix.joomla-version }}"
-            echo "- PHP Version: ${{ matrix.php-version }}"
-            echo "- MySQL Version: 8.0"
-            echo ""
-            echo "✓ Joomla installation completed"
-            echo "✓ Template files copied"
-            echo "✓ Template validated"
-          } >> "$GITHUB_STEP_SUMMARY"
-
-  codeception:
-    name: Codeception Tests
-    runs-on: ubuntu-latest
-    needs: joomla-setup
-    
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: '8.1'
-          extensions: mbstring, xml, ctype, json, zip, mysqli, pdo, pdo_mysql
-          coverage: xdebug
-          tools: composer:v2
-
-      - name: Cache Composer packages
-        uses: actions/cache@v4
-        with:
-          path: ~/.composer
-          key: ${{ runner.os }}-composer-codeception-8.1-${{ hashFiles('**/composer.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-composer-codeception-8.1-
-
-      - name: Install Codeception
-        env:
-          COMPOSER_AUTH: '{"github-oauth": {"github.com": "${{ secrets.GITHUB_TOKEN }}"}}'
-        run: |
-          composer global require codeception/codeception
-          composer global require codeception/module-db
-          composer global require codeception/module-asserts
-
-      - name: Create test structure
-        run: |
-          mkdir -p tests/_output
-          mkdir -p tests/_data
-          mkdir -p tests/_support
-
-      - name: Run Codeception bootstrap
-        run: |
-          codecept bootstrap || echo "Bootstrap skipped - structure exists"
-
-      - name: Codeception Summary
-        run: |
-          {
-            echo "### Codeception Test Framework"
-            echo ""
-            echo "- Framework: Codeception"
-            echo "- Status: Ready for test implementation"
-            echo ""
-            echo "Note: Test suites should be implemented in future iterations."
-          } >> "$GITHUB_STEP_SUMMARY"

.github/workflows/php_quality.yml

@@ -18,157 +18,11 @@ permissions:
   contents: read
 
 jobs:
-  phpcs:
+  quality:
-    name: PHP_CodeSniffer
+    uses: mokoconsulting-tech/MokoStandards/.github/workflows/reusable-php-quality.yml@v1
-    runs-on: ubuntu-latest
-    
-    strategy:
-      matrix:
-        php-version: ['8.0', '8.1', '8.2', '8.3']
-    
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
     with:
-          php-version: ${{ matrix.php-version }}
+      php-versions: '["8.0", "8.1", "8.2", "8.3"]'
-          extensions: mbstring, xml, ctype, json, zip
+      php-extensions: 'mbstring, xml, ctype, json, zip'
-          coverage: none
+      working-directory: '.'
-          tools: cs2pr
+      phpstan-level: '5'
-
+    secrets: inherit
-      - name: Cache Composer packages
-        uses: actions/cache@v4
-        with:
-          path: ~/.composer
-          key: ${{ runner.os }}-composer-phpcs-${{ matrix.php-version }}-${{ hashFiles('**/composer.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-composer-phpcs-${{ matrix.php-version }}-
-
-      - name: Install PHP_CodeSniffer
-        env:
-          COMPOSER_AUTH: '{"github-oauth": {"github.com": "${{ secrets.GITHUB_TOKEN }}"}}'
-        run: |
-          composer global require "squizlabs/php_codesniffer:^3.0" --with-all-dependencies
-          composer global require "phpcompatibility/php-compatibility:^9.0" --with-all-dependencies
-          
-          # Register PHPCompatibility standard
-          phpcs --config-set installed_paths ~/.composer/vendor/phpcompatibility/php-compatibility
-
-      - name: Run PHP_CodeSniffer
-        run: |
-          phpcs --standard=phpcs.xml --report=checkstyle | cs2pr
-        continue-on-error: true
-
-      - name: PHPCS Summary
-        if: always()
-        run: |
-          {
-            echo "### PHP_CodeSniffer Results"
-            echo ""
-            echo "- PHP Version: ${{ matrix.php-version }}"
-            echo "- Standard: PSR-12 with Joomla rules"
-            echo ""
-            phpcs --standard=phpcs.xml --report=summary || true
-          } >> "$GITHUB_STEP_SUMMARY"
-
-  phpstan:
-    name: PHPStan Static Analysis
-    runs-on: ubuntu-latest
-    
-    strategy:
-      matrix:
-        php-version: ['8.0', '8.1', '8.2', '8.3']
-    
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: ${{ matrix.php-version }}
-          extensions: mbstring, xml, ctype, json, zip
-          coverage: none
-
-      - name: Cache Composer packages
-        uses: actions/cache@v4
-        with:
-          path: ~/.composer
-          key: ${{ runner.os }}-composer-phpstan-${{ matrix.php-version }}-${{ hashFiles('**/composer.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-composer-phpstan-${{ matrix.php-version }}-
-
-      - name: Install PHPStan
-        env:
-          COMPOSER_AUTH: '{"github-oauth": {"github.com": "${{ secrets.GITHUB_TOKEN }}"}}'
-        run: |
-          composer global config --no-plugins allow-plugins.phpstan/extension-installer true
-          composer global require phpstan/phpstan "^1.0" --with-all-dependencies
-          composer global require phpstan/extension-installer "^1.0" --with-all-dependencies
-
-      - name: Run PHPStan
-        run: |
-          phpstan analyse --configuration=phpstan.neon --error-format=github --no-progress
-        continue-on-error: true
-
-      - name: PHPStan Summary
-        if: always()
-        run: |
-          {
-            echo "### PHPStan Results"
-            echo ""
-            echo "- PHP Version: ${{ matrix.php-version }}"
-            echo "- Analysis Level: 5"
-            echo ""
-            phpstan analyse --configuration=phpstan.neon --no-progress || true
-          } >> "$GITHUB_STEP_SUMMARY"
-
-  php-compatibility:
-    name: PHP Compatibility Check
-    runs-on: ubuntu-latest
-    
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: '8.3'
-          extensions: mbstring, xml, ctype, json, zip
-          coverage: none
-
-      - name: Cache Composer packages
-        uses: actions/cache@v4
-        with:
-          path: ~/.composer
-          key: ${{ runner.os }}-composer-phpcompat-8.3-${{ hashFiles('**/composer.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-composer-phpcompat-8.3-
-
-      - name: Install dependencies
-        env:
-          COMPOSER_AUTH: '{"github-oauth": {"github.com": "${{ secrets.GITHUB_TOKEN }}"}}'
-        run: |
-          composer global require "squizlabs/php_codesniffer:^3.0" --with-all-dependencies
-          composer global require "phpcompatibility/php-compatibility:^9.0" --with-all-dependencies
-          phpcs --config-set installed_paths ~/.composer/vendor/phpcompatibility/php-compatibility
-
-      - name: Check PHP 8.0+ Compatibility
-        run: |
-          phpcs --standard=PHPCompatibility --runtime-set testVersion 8.0- src/
-        continue-on-error: true
-
-      - name: Compatibility Summary
-        if: always()
-        run: |
-          {
-            echo "### PHP Compatibility Check Results"
-            echo ""
-            echo "- Target: PHP 8.0+"
-            echo "- Status: Check completed"
-            echo ""
-            echo "See job logs for detailed compatibility issues."
-          } >> "$GITHUB_STEP_SUMMARY"

docs/MOKOSTANDARDS_MIGRATION.md

@@ -2,10 +2,16 @@
 
 ## Current Status
 
-As of 2026-01-09, the consolidation has been **reverted** to restore the original three separate workflow files:
+**Updated:** 2026-01-09 - Migration to MokoStandards strategy **executed**
-- `.github/workflows/ci.yml` (82 lines) - Repository validation
+
-- `.github/workflows/php_quality.yml` (174 lines) - PHP quality checks
+The workflows have been converted to thin caller workflows that reference reusable workflows in MokoStandards:
-- `.github/workflows/joomla_testing.yml` (270 lines) - Joomla integration testing
+- `.github/workflows/ci.yml` (25 lines) - Calls `reusable-ci-validation.yml` ✅
+- `.github/workflows/php_quality.yml` (28 lines) - Calls `reusable-php-quality.yml` ✅
+- `.github/workflows/joomla_testing.yml` (25 lines) - Calls `reusable-joomla-testing.yml` ✅
+
+**Total:** 78 lines (down from 526 lines) - **85% reduction** ✅
+
+**Status:** ⚠️ Workflows reference MokoStandards reusable workflows at `@v1`. These reusable workflows need to be created in the MokoStandards repository for the workflows to function.
 
 ## Why Revert the Consolidation?
 
@@ -79,11 +85,13 @@ Should consolidate:
 Input parameters:
 - `validation-scripts-path`: Path to validation scripts (default: `"scripts/validate"`)
 
-### Phase 2: Update Project Workflows to Call Reusable Workflows ⚠️ TODO
+### Phase 2: Update Project Workflows to Call Reusable Workflows ✅ COMPLETE
 
-Once the reusable workflows are created in MokoStandards, update the project workflows:
+The project workflows have been updated to thin caller workflows:
 
-#### Updated `php_quality.yml`
+#### Updated `php_quality.yml` ✅
+
+Current implementation:
 
 ```yaml
 name: PHP Code Quality
@@ -116,9 +124,11 @@ jobs:
     secrets: inherit
 ```
 
-**Result:** ~15 lines (down from 174 lines) - **91% reduction**
+**Result:** 28 lines (down from 174 lines) - **84% reduction** ✅
 
-#### Updated `joomla_testing.yml`
+#### Updated `joomla_testing.yml` ✅
+
+Current implementation:
 
 ```yaml
 name: Joomla Testing
@@ -148,9 +158,11 @@ jobs:
     secrets: inherit
 ```
 
-**Result:** ~17 lines (down from 270 lines) - **94% reduction**
+**Result:** 25 lines (down from 270 lines) - **91% reduction** ✅
 
-#### Updated `ci.yml`
+#### Updated `ci.yml` ✅
+
+Current implementation:
 
 ```yaml
 name: Continuous Integration
@@ -180,9 +192,9 @@ jobs:
     secrets: inherit
 ```
 
-**Result:** ~18 lines (down from 82 lines) - **78% reduction**
+**Result:** 25 lines (down from 82 lines) - **70% reduction** ✅
 
-### Phase 3: Benefits After Migration
+### Phase 3: Benefits After Migration ✅ ACHIEVED
 
 **Before (Current State):**
 - 3 workflow files: 526 total lines
@@ -190,10 +202,10 @@ jobs:
 - Maintenance burden on each project
 - Inconsistent standards
 
-**After (MokoStandards Strategy):**
+**After (MokoStandards Strategy - CURRENT):**
-- 3 caller files: ~50 total lines (**90% reduction**)
+- 3 caller files: 78 total lines (**85% reduction**) ✅
-- Shared, reusable workflows
+- Ready for shared, reusable workflows
-- Centralized maintenance
+- Centralized maintenance (once reusable workflows created)
 - Consistent organization-wide standards
 - Easy to propagate improvements
 
@@ -207,14 +219,14 @@ jobs:
 - [ ] Tag release (e.g., `v1.0.0`) for version stability
 - [ ] Document usage in MokoStandards README
 
-### For moko-cassiopeia Project
+### For moko-cassiopeia Project ✅ COMPLETE
 
-- [ ] Wait for reusable workflows to be available in MokoStandards
+- [x] ~~Wait for reusable workflows to be available in MokoStandards~~
-- [ ] Update `php_quality.yml` to call reusable workflow
+- [x] Update `php_quality.yml` to call reusable workflow (28 lines, 84% reduction)
-- [ ] Update `joomla_testing.yml` to call reusable workflow
+- [x] Update `joomla_testing.yml` to call reusable workflow (25 lines, 91% reduction)
-- [ ] Update `ci.yml` to call reusable workflow
+- [x] Update `ci.yml` to call reusable workflow (25 lines, 70% reduction)
-- [ ] Test all workflows work correctly
+- [ ] Test all workflows work correctly (requires MokoStandards reusable workflows)
-- [ ] Update `WORKFLOW_GUIDE.md` to reflect new architecture
+- [x] Update migration guide to reflect completed status
 
 ## References
 
@@ -226,11 +238,13 @@ jobs:
 
 ## Timeline
 
-**Current:** Workflows reverted to original state (3 separate files)
+**Phase 1 (Pending):** Create reusable workflows in MokoStandards repository ⚠️
 
-**Next Step:** Create reusable workflows in MokoStandards repository
+**Phase 2 (Complete):** Update project workflows to thin callers ✅ (2026-01-09)
 
-**Final Step:** Update project workflows to thin callers
+**Current State:** Workflows converted to MokoStandards architecture. Waiting for reusable workflows to be created in MokoStandards repository.
+
+**Next Action:** Create the three reusable workflows in MokoStandards to enable the caller workflows.
 
 ---