codeql.yml

name: "CodeQL"

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  schedule:
    - cron: "0 6 * * 1"

# Default-deny at the top level (Scorecard Token-Permissions); the analyze
# job below re-grants exactly what CodeQL needs.
permissions:
  contents: read

jobs:
  analyze:
    # PINNED DELIBERATELY — do not replace with a bare `name: Analyze`.
    # GitHub derives an unnamed matrix job's title from ALL of its matrix
    # keys, so adding a second key later silently renames this job. Where a
    # branch ruleset requires "Analyze (actions)", a renamed job makes that
    # rule UNSATISFIABLE rather than failing: PRs sit BLOCKED with every
    # check green, and only the merge attempt names the missing context.
    name: Analyze (${{ matrix.language }})
    runs-on: ubuntu-latest
    permissions:
      security-events: write
      actions: read
      contents: read

    strategy:
      fail-fast: false
      matrix:
        # `actions` alone scans workflow YAML and ZERO application source.
        language: [actions, python]

    steps:
      - name: Checkout repository
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7

      - name: Initialize CodeQL
        uses: github/codeql-action/init@b96794f015dfd88f77b49b1c93e0fa7110f94c63 # v4
        with:
          languages: ${{ matrix.language }}
          build-mode: none

      - name: Perform CodeQL Analysis
        uses: github/codeql-action/analyze@b96794f015dfd88f77b49b1c93e0fa7110f94c63 # v4
        with:
          category: "/language:${{ matrix.language }}"