codeql.yml

name: codeql

# CodeQL SAST across the Python app and the GitHub Actions workflows themselves
# (SECURITY-AND-SUPPLY-CHAIN-STANDARD SEC-08, CI-CD-STANDARD CICD-19/20). Runs
# on every pull request into main plus a weekly schedule so newly disclosed
# query patterns are caught even without a code change (CI-CD-STANDARD §11e:
# the PR run already covers what a push-to-main run would re-analyze). Code
# scanning is available because this is an open-source repository.

on:
  pull_request:
    branches: [main]
  schedule:
    - cron: "19 4 * * 1"
  workflow_dispatch: {}

permissions:
  contents: read

concurrency:
  group: codeql-${{ github.ref }}
  cancel-in-progress: true

jobs:
  analyze:
    name: Analyze (${{ matrix.language }})
    runs-on: ubuntu-latest
    permissions:
      actions: read # required to analyze the `actions` language
      contents: read
      security-events: write # required to upload SARIF results
    strategy:
      fail-fast: false
      matrix:
        # `python` covers ingest/recommender/app + tests; `actions` audits the
        # workflow YAML itself (injection, permission scoping, dangerous
        # triggers) — complements the zizmor job in zizmor.yml.
        language: [python, actions]
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false

      - name: Initialize CodeQL
        uses: github/codeql-action/init@f205ea1c3313d32999d8d6a48b4f6530d4437b38 # v4.37.4
        with:
          languages: ${{ matrix.language }}

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