ci: add seo-checkup (local build on PRs, production on master) and extract shared setup action

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: ikidnapmyself

.github/actions/setup/action.yml

@@ -0,0 +1,44 @@
+name: Setup
+description: Install PHP and Composer dependencies, optionally Node dependencies and the built frontend
+
+inputs:
+  extensions:
+    description: PHP extensions to enable
+    default: mbstring, pdo, pdo_mysql, xml, curl
+  coverage:
+    description: PHP coverage driver (none, pcov, xdebug)
+    default: none
+  frontend:
+    description: Install Node dependencies and build the frontend
+    default: 'false'
+
+runs:
+  using: composite
+  steps:
+    - name: Setup PHP 8.3
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: '8.3'
+        extensions: ${{ inputs.extensions }}
+        coverage: ${{ inputs.coverage }}
+
+    - name: Install Dependencies
+      shell: bash
+      run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+
+    - name: Setup Node
+      if: inputs.frontend == 'true'
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+        cache: npm
+
+    - name: Install Node Dependencies
+      if: inputs.frontend == 'true'
+      shell: bash
+      run: npm ci
+
+    - name: Build Frontend
+      if: inputs.frontend == 'true'
+      shell: bash
+      run: npm run build

.github/workflows/ci.yml

@@ -11,15 +11,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Setup PHP 8.3
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: '8.3'
-          extensions: mbstring, pdo, pdo_mysql, xml, curl
-          coverage: none
-
-      - name: Install Dependencies
-        run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+      - uses: ./.github/actions/setup
 
       - name: Check formatting (Pint)
         run: vendor/bin/pint --test
@@ -55,31 +47,14 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Setup PHP 8.3
-        uses: shivammathur/setup-php@v2
+      - uses: ./.github/actions/setup
         with:
-          php-version: '8.3'
-          extensions: mbstring, pdo, pdo_mysql, xml, curl
           coverage: pcov
+          frontend: 'true'
 
       - name: Copy .env
         run: php -r "file_exists('.env') || copy('.env.example', '.env');"
 
-      - name: Install Dependencies
-        run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: npm
-
-      - name: Install Node Dependencies
-        run: npm ci
-
-      - name: Build Frontend
-        run: npm run build
-
       - name: Generate App Key
         run: php artisan key:generate
 
@@ -102,8 +77,26 @@ jobs:
       - name: Run Tests
         run: vendor/bin/phpunit --coverage-clover coverage.xml
 
+      - name: SEO check (local build)
+        if: github.event_name == 'pull_request'
+        uses: ikidnapmyself/seo-checkup@v1
+        with:
+          serve: php artisan serve
+          serve-url: http://localhost:8000
+          fail-on: recommended
+
       - name: Upload Coverage to Coveralls
         uses: coverallsapp/github-action@v2
         with:
           file: coverage.xml
           format: clover
+
+  seo-production:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: ikidnapmyself/seo-checkup@v1
+        with:
+          url: ${{ vars.PRODUCTION_URL }}
+          fail-on: recommended

docs/plans/2026-08-23-seo-checkup-design.md

@@ -0,0 +1,8 @@
+# SEO Checkup — design
+
+Add `ikidnapmyself/seo-checkup@v1` to the existing `ci.yml`; no new workflow.
+
+- `tests` job, after PHPUnit, on `pull_request` only: serve the already-built, already-migrated app with `php artisan serve` and audit `/`.
+- `seo-production` job on push to `master` (deploy): audit `vars.PRODUCTION_URL` (repo variable, must be set).
+- `fail-on: recommended` for both.
+- Shared PHP/Composer/Node/build steps extracted into `.github/actions/setup`.