From 026ba1ed41d1b82fb6da00f3cb23711b41687d24 Mon Sep 17 00:00:00 2001
From: Thomas Kroll <t.kroll@outlook.com>
Date: Fri, 13 Nov 2026 08:27:06 +0100
Subject: [PATCH] CI: check the QML on every pull request

New .github/workflows/ci.yml, triggered only by pull requests into
main (no paths filter, no push, no dispatch), contents: read. Job qml
installs qt6-declarative in an Arch Linux container pinned by digest
and runs scripts/check-qml.sh; Ubuntu 24.04's own Qt 6.4 qmllint does
not accept the script's options. Job shellcheck checks scripts/*.sh in
the same container. Job required always runs and passes only when both
gates succeeded; it is the check the main ruleset will require.

renovate.json extends helpers:pinGitHubActionDigests, so actions and
the container image stay pinned to digests.

Fixes #132

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .github/workflows/ci.yml | 53 ++++++++++++++++++++++++++++++++++++++++
 CHANGELOG.md             |  5 ++++
 renovate.json            |  2 +-
 3 files changed, 59 insertions(+), 1 deletion(-)
 create mode 100644 .github/workflows/ci.yml

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..fe0014c
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,53 @@
+name: CI
+
+# Pull requests into main only: this workflow produces the `required` check that the main
+# ruleset requires, so it must not run on push or by dispatch (that would mark a commit green
+# that was never a pull request head). No paths filter, so the check always reports.
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  # Ubuntu's own Qt 6.4 qmllint does not accept the script's options. Arch ships the Qt that the
+  # desktop shell runs. The digest pins the image; -Syu installs the current Arch Qt, so a new Qt
+  # with a new lint can turn a pull request red: fix that in its own PR, never by loosening the script.
+  qml:
+    runs-on: ubuntu-24.04
+    container: archlinux:latest@sha256:d4594bb2300cba11f41c2f27923eb56f63d9988909c402f9c95517d1e362c899
+    timeout-minutes: 15
+    steps:
+      - run: pacman -Syu --noconfirm --needed qt6-declarative
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - run: bash scripts/check-qml.sh
+
+  shellcheck:
+    runs-on: ubuntu-24.04
+    container: archlinux:latest@sha256:d4594bb2300cba11f41c2f27923eb56f63d9988909c402f9c95517d1e362c899
+    timeout-minutes: 15
+    steps:
+      - run: pacman -Syu --noconfirm --needed shellcheck
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - run: shellcheck scripts/*.sh
+
+  # The one check the main ruleset requires. It passes only when every gate succeeded.
+  required:
+    name: required
+    needs: [qml, shellcheck]
+    if: always()
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
+    env:
+      QML: ${{ needs.qml.result }}
+      SHELLCHECK: ${{ needs.shellcheck.result }}
+    steps:
+      - run: |
+          echo "qml=$QML shellcheck=$SHELLCHECK"
+          test "$QML" = success
+          test "$SHELLCHECK" = success
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2926380..04c6f5c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,11 @@ the change) are credited at the end of their line as `(#N, thanks @handle)`.
 
 ## [Unreleased]
 
+### Added
+
+- A GitHub Actions workflow runs `scripts/check-qml.sh` and shellcheck on every pull request into
+  `main` (#132).
+
 ## [0.29.1] - 2026-11-12
 
 ### Fixed
diff --git a/renovate.json b/renovate.json
index 53b71c8..a25e8f7 100644
--- a/renovate.json
+++ b/renovate.json
@@ -1,6 +1,6 @@
 {
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": ["config:recommended"],
+  "extends": ["config:recommended", "helpers:pinGitHubActionDigests"],
   "timezone": "Europe/Berlin",
   "schedule": ["* 0-5 * * 1"],
   "dependencyDashboard": true,