codeql.yml

# SPDX-License-Identifier: AGPL-3.0-or-later
name: codeql

# CICD-§11e: PRs into main + the weekly schedule cover everything a push:main
# trigger would — the PR run analyzes the change before merge, the schedule
# keeps default-branch results fresh against new queries. No push trigger.
on:
  pull_request:
    branches: [main]
  schedule:
    - cron: "37 4 * * 1" # weekly, Monday 04:37 UTC

permissions:
  contents: read

# CICD-§11c: a force-push to a PR branch supersedes the in-flight analysis;
# cancel it rather than paying for both.
concurrency:
  group: codeql-${{ github.ref }}
  cancel-in-progress: true

jobs:
  analyze:
    name: CodeQL (${{ matrix.language }})
    runs-on: ubuntu-latest
    permissions:
      security-events: write
      actions: read
      contents: read
    strategy:
      fail-fast: false
      matrix:
        # P1-3 (CICD-19/20): `actions` scans the workflow YAML itself — a
        # different query/engine surface than zizmor — alongside the existing
        # `python` analysis of the application code.
        include:
          - language: python
            queries: security-extended
          - language: actions
            queries: "" # security-extended is not a published suite for `actions`; use defaults
    steps:
      - name: Checkout
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false
      - name: Initialize CodeQL
        uses: github/codeql-action/init@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
        with:
          languages: ${{ matrix.language }}
          queries: ${{ matrix.queries }}
      - name: Analyze
        uses: github/codeql-action/analyze@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
        with:
          category: "/language:${{ matrix.language }}"