codeql.yml

name: codeql

# SAST for both the Python source (SEC-08) and the workflow files themselves
# (CICD-20's "actions" language). Runs on every PR plus a weekly schedule so
# drift in the CodeQL query packs themselves still gets caught even on a
# quiet repo; the push-to-main trigger is redundant with the PR run and
# dropped per CI-CD-STANDARD §11e.
on:
  pull_request:
  schedule:
    - cron: "0 7 * * 3" # Wednesday 07:00 UTC

permissions:
  contents: read

# Supersede in-flight runs on the same ref (CI-CD-STANDARD §11c).
concurrency:
  group: codeql-${{ github.ref }}
  cancel-in-progress: true

jobs:
  analyze:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      security-events: write # required to upload CodeQL results
    strategy:
      fail-fast: false
      matrix:
        language: [python, actions]
    steps:
      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
        with:
          persist-credentials: false
      - uses: github/codeql-action/init@f205ea1c3313d32999d8d6a48b4f6530d4437b38 # v4.37.4
        with:
          languages: ${{ matrix.language }}
      - uses: github/codeql-action/analyze@f205ea1c3313d32999d8d6a48b4f6530d4437b38 # v4.37.4
        with:
          category: "/language:${{ matrix.language }}"