ci: run mutation tests with Infection

.github/workflows/mutation.yml

@@ -0,0 +1,47 @@
+---
+
+name: Mutation Tests
+
+on:  # yamllint disable-line rule:truthy
+  pull_request:
+  push:
+    branches: [4.x]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  mutation:
+    name: Infection
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          extensions: sockets
+          coverage: xdebug
+          ini-values: memory_limit=-1
+
+      - name: Install Composer dependencies
+        uses: ramsey/composer-install@v3
+        with:
+          dependency-versions: highest
+
+      # The Infection phar is unusable with Testo: its bundled adapter calls the
+      # unscoped \Infection\StreamWrapper\IncludeInterceptor. Infection requires
+      # PHP 8.3+, so it is installed here instead of in require-dev.
+      - name: Install Infection
+        run: |
+          composer config allow-plugins.infection/extension-installer true
+          composer require --dev --no-interaction --no-progress -W infection/infection testo/bridge-infection
+
+      - name: Run Infection
+        run: vendor/bin/infection --threads=max --logger-github --show-mutations=0 --min-msi=90 --min-covered-msi=90
+        env:
+          STRYKER_DASHBOARD_API_KEY: ${{ github.event_name == 'push' && secrets.STRYKER_DASHBOARD_API_KEY || '' }}

README.md

@@ -14,6 +14,7 @@
 
 [![Psalm Level](https://shepherd.dev/github/roadrunner-php/http/level.svg)](https://shepherd.dev/github/roadrunner-php/http)
 [![Type Coverage](https://shepherd.dev/github/roadrunner-php/http/coverage.svg)](https://shepherd.dev/github/roadrunner-php/http)
+[![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Froadrunner-php%2Fhttp%2F4.x)](https://dashboard.stryker-mutator.io/reports/github.com/roadrunner-php/http/4.x)
 
 </div>
 

infection.json5

@@ -0,0 +1,19 @@
+{
+    "$schema": "https://raw.githubusercontent.com/infection/infection/0.35.6/resources/schema.json",
+    "source": {
+        "directories": ["src"]
+    },
+    "testFramework": "testo",
+    // Feature tests start a server on a fixed port: parallel mutant runs collide on it, and a
+    // timed-out run leaves the server running and fails every later run.
+    "testFrameworkOptions": "--suite=Unit",
+    "tmpDir": "runtime",
+    "timeout": 10,
+    "logs": {
+        "text": "runtime/infection.log",
+        "github": true,
+        "stryker": {
+            "report": "4.x"
+        }
+    }
+}