codeql.yml

name: CodeQL

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  schedule:
    # Weekly scan so newly released CodeQL queries run against unchanged code.
    - cron: '41 3 * * 2'

# Deny-all at the workflow level; each job declares exactly what it needs
# (OpenSSF Scorecard: Token-Permissions).
permissions: {}

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

jobs:
  analyze:
    name: Analyze (${{ matrix.language }})
    runs-on: ubuntu-latest
    permissions:
      contents: read
      security-events: write
    strategy:
      fail-fast: false
      matrix:
        include:
          # GrantGuard is pure Python and Javascript with zero runtime dependencies.
          - language: python
            build-mode: none
          - language: javascript-typescript
            build-mode: none
          # Scan the GitHub Actions workflows themselves (untrusted fork PRs
          # can modify workflow files; CodeQL's actions pack catches
          # injection and excessive-permission patterns).
          - language: actions
            build-mode: none
    steps:
      - name: Checkout repository
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false

      - name: Initialize CodeQL
        uses: github/codeql-action/init@e4fba868fa4b1b91e1fdab776edc8cfbe6e9fb81 # v4.37.3
        with:
          languages: ${{ matrix.language }}
          build-mode: ${{ matrix.build-mode }}
          # Default query suite: high precision, low false-positive rate.
          # Swap to `security-extended` for broader (noisier) coverage:
          # queries: security-extended

      - name: Perform CodeQL analysis
        uses: github/codeql-action/analyze@e4fba868fa4b1b91e1fdab776edc8cfbe6e9fb81 # v4.37.3
        with:
          category: '/language:${{ matrix.language }}'