---
title: "CI configuration"
manual: "LLM Foundation"
version: "0.52"
permalink: "https://docs.typo3.org/permalink/netresearch/nr-llm:testing-ci-github@0.52"
source: "Testing/CiConfiguration.rst"
rendered: "2026-11-20T16:10:49+00:00"
---

<a id="testing-ci-configuration"></a>
<a id="testing-ci"></a>

# CI configuration {#testing-ci-github}

The actual workflow is [.github/workflows/ci.yml](https://github.com/netresearch/t3x-nr-llm/blob/main/.github/workflows/ci.yml),
which calls the shared Netresearch TYPO3 workflow. PHP 8.2–8.5 and TYPO3
`^13.4` / `^14.3` are the pull-request matrix. The merge queue uses the
workflow's compact matrix rather than repeating every PR cell.
The shared workflow resolves the TYPO3 constraint per cell; a plain
`composer install` under an unused matrix variable would not do that.

The functional tests of that matrix run on SQLite. Two more calls run them on
MariaDB 11.8 and on PostgreSQL 17 (PHP 8.4, TYPO3 `^14.3`).

## Local verification {#local-verification}

Use the repository's Docker runner; it selects compatible PHP and dependency
versions and avoids relying on a workstation's PHP runtime:

**Run relevant suites locally**

```bash
./Build/Scripts/runTests.sh -s unit
./Build/Scripts/runTests.sh -s functional -d sqlite
./Build/Scripts/runTests.sh -s functional -d mariadb
./Build/Scripts/runTests.sh -s functional -d postgres -i 17
make gate
```

`make gate` runs the repository's pre-push checks. A local run covers one
environment, not every CI matrix cell. See the workflow and repository
`AGENTS.md` for the current commands and required merge checks.

<a id="testing-mutation-results"></a>
<a id="testing-mutation-running"></a>
## Mutation quality {#testing-mutation}

Infection is configured with minimum MSI 70 and covered MSI 74. The mutation
job runs on the weekly schedule or manual dispatch and is report-only, not
the routine merge gate. A configured target is not a measured score. Link a
dated CI artifact when reporting actual test counts or mutation results.

**Run mutation tests explicitly**

```bash
./Build/Scripts/runTests.sh -s mutation
```

## Other CI services {#testing-ci-gitlab}

A consumer can call the same runner from another CI service with Docker
available. Pin its PHP/TYPO3 matrix and actually resolve the corresponding
constraints in each job. The GitHub workflow above is this repository's
maintained CI definition; this manual does not ship a second parallel
GitLab pipeline template.
