ci.yml

# ---------------------------------------------------------------------------
# GitHub Actions CI — THIN WRAPPER
# ---------------------------------------------------------------------------
# This workflow deliberately contains no build logic. It only:
#   1. checks out the code,
#   2. installs the pinned prerequisites (Python + pre-commit),
#   3. runs `make ci`.
#
# All actual checks live in the Makefile (`make ci`) and run identically on a
# developer laptop. To change WHAT runs in CI, edit the Makefile and
# .pre-commit-config.yaml — not this file. The only things that belong here are
# platform-specific concerns that cannot live in a portable script: triggers,
# the runner image, and prerequisite installation.
#
# Determinism: tool versions are pinned (Python below; hook versions via `rev`
# in .pre-commit-config.yaml). Bump them deliberately.
name: ci

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [develop]

jobs:
  ci:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      # Python 3.10 is required by the commitizen / sync-pre-commit-deps hooks
      # (see .pre-commit-config.yaml). Keep this in sync with the README.
      - uses: actions/setup-python@v5
        with:
          python-version: "3.10"

      # Cache pre-commit hook environments keyed on the config so unchanged
      # hooks are not rebuilt on every run.
      - uses: actions/cache@v4
        with:
          path: ~/.cache/pre-commit
          key: pre-commit-${{ runner.os }}-${{ hashFiles('.pre-commit-config.yaml') }}

      - run: pipx install pre-commit

      # The single entrypoint. Everything CI does is defined in the Makefile.
      - run: make ci