1.x

.gitattributes

@@ -0,0 +1,15 @@
+# Files and directories to omit from `git archive` output (release zips).
+# Anything tracked but not needed at runtime in a distributed plugin.
+
+/.claude              export-ignore
+/.github              export-ignore
+/.gitattributes       export-ignore
+/.gitignore           export-ignore
+/.release-please-manifest.json  export-ignore
+/assets               export-ignore
+/docs                 export-ignore
+/package.json         export-ignore
+/pnpm-lock.yaml       export-ignore
+/release-please-config.json     export-ignore
+/tests                export-ignore
+/*.dist               export-ignore

.github/workflows/qa.yml

@@ -0,0 +1,104 @@
+name: QA
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+    group: ${{ github.workflow }}-${{ github.ref }}
+    cancel-in-progress: true
+
+jobs:
+  php-versions:
+    runs-on: ubuntu-latest
+    outputs:
+      versions: ${{ steps.versions.outputs.version }}
+    steps:
+      - uses: actions/checkout@v6
+      - id: versions
+        uses: WyriHaximus/github-action-composer-php-versions-in-range@7c91c459140becf43d93d3975070f308ab791949  # v1.16.2
+        with:
+          upcomingReleases: true
+
+  unit-tests:
+    needs: php-versions
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php: ${{ fromJson(needs.php-versions.outputs.versions) }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f  # 2.37.0
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: none
+      - uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda  # 4.0.0
+      - run: composer test:unit
+
+  integration-tests:
+    needs: php-versions
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ matrix.wp == 'trunk' }}
+    strategy:
+      fail-fast: false
+      matrix:
+        php: ${{ fromJson(needs.php-versions.outputs.versions) }}
+        wp: ['latest']
+        suite:
+          - test:core
+          - test:wordpress-seo
+          - test:polylang
+          - test:autodescription
+        include:
+          - php: '8.2'
+            wp: 'trunk'
+            suite: test:core
+    name: PHP ${{ matrix.php }} | WP ${{ matrix.wp }} | ${{ matrix.suite }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f  # 2.37.0
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: none
+      - uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda  # 4.0.0
+      - run: composer ${{ matrix.suite }}
+        env:
+          WP_VERSION: ${{ matrix.wp }}
+
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f  # 2.37.0
+        with:
+          php-version: '8.2'
+          coverage: pcov
+      - uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda  # 4.0.0
+      - name: Coverage (core)
+        run: php -d pcov.enabled=1 vendor/bin/phpunit --testsuite=unit,integration --coverage-php=build/coverage-core.cov
+      - name: Coverage (polylang)
+        run: PLUGINS=polylang php -d pcov.enabled=1 vendor/bin/phpunit --testsuite=plugin-integration --coverage-php=build/coverage-polylang.cov
+      - name: Coverage (WPML)
+        run: PLUGINS=wpml php -d pcov.enabled=1 vendor/bin/phpunit --testsuite=plugin-integration --coverage-php=build/coverage-wpml.cov
+      - name: Coverage (wordpress-seo)
+        run: PLUGINS=wordpress-seo php -d pcov.enabled=1 vendor/bin/phpunit --testsuite=plugin-integration --coverage-php=build/coverage-wordpress-seo.cov
+      - name: Coverage (autodescription)
+        run: PLUGINS=autodescription php -d pcov.enabled=1 vendor/bin/phpunit --testsuite=plugin-integration --coverage-php=build/coverage-autodescription.cov
+      - name: Merge coverage
+        run: |
+          composer require --dev phpunit/phpcov --quiet
+          vendor/bin/phpcov merge build --clover build/coverage.xml
+      - uses: codecov/codecov-action@75cd11691c0faa626561e295848008c8a7dddffe  # v5.5.4
+        with:
+          files: build/coverage.xml
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+  static-analysis:
+    uses: inpsyde/reusable-workflows/.github/workflows/static-analysis-php.yml@6bbc8c9422de0f685b71cfb8f9cddd2b591e2c50  # main as of 2026-05-08
+
+  coding-standards:
+    uses: inpsyde/reusable-workflows/.github/workflows/coding-standards-php.yml@6bbc8c9422de0f685b71cfb8f9cddd2b591e2c50  # main as of 2026-05-08

.github/workflows/release.yml

@@ -0,0 +1,69 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions: {}
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.rp.outputs.release_created }}
+      tag_name: ${{ steps.rp.outputs.tag_name }}
+      version: ${{ steps.rp.outputs.version }}
+    steps:
+      - id: rp
+        uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7  # v5.0.0
+
+  build:
+    needs: release-please
+    if: needs.release-please.outputs.release_created == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f  # 2.37.0
+        with:
+          php-version: '8.2'
+          coverage: none
+
+      - uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda  # 4.0.0
+        with:
+          composer-options: '--no-dev --optimize-autoloader --classmap-authoritative'
+
+      - name: Build release zip
+        env:
+          VERSION: ${{ needs.release-please.outputs.version }}
+        run: |
+          mkdir -p dist
+          # Tracked files only, with .gitattributes export-ignore filtering applied.
+          git archive --prefix=page-for-custom-post-type/ HEAD | tar -x -C dist
+          # vendor/ is gitignored, so git archive doesn't include it. Copy it in.
+          cp -r vendor dist/page-for-custom-post-type/vendor
+          # Inject the bundled-only autoload require.
+          sed -i "s|// @bundle-autoload|require_once __DIR__ . '/vendor/autoload.php';|" dist/page-for-custom-post-type/plugin.php
+          grep -q "require_once __DIR__ . '/vendor/autoload.php';" dist/page-for-custom-post-type/plugin.php \
+            || { echo "::error::bundle autoload marker replacement failed"; exit 1; }
+          php -l dist/page-for-custom-post-type/plugin.php
+          (cd dist && zip -rq "../page-for-custom-post-type-${VERSION}.zip" page-for-custom-post-type)
+
+      - name: Upload zip to release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ needs.release-please.outputs.tag_name }}
+          VERSION: ${{ needs.release-please.outputs.version }}
+        run: gh release upload "$TAG" "page-for-custom-post-type-${VERSION}.zip" --clobber

.gitignore

@@ -1,5 +1,14 @@
-vendor
-wordpress
-wp-content
-.phpunit.result.cache
-composer.lock
+# Composer
+/vendor
+/composer.lock
+
+# Tests
+/wp-content
+/.phpunit.result.cache
+/tmp
+
+# Agent-generated docs (specs, plans, brainstorming notes)
+/docs/superpowers
+
+# Node
+/node_modules

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+	".": "0.5.0"
+}