codeql.yml

# CodeQL: security and quality analysis for Python (OWASP, injection, etc.).
# Results appear under Security > Code scanning; configure rulesets for merge protection.
# https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning
#
# Actions pinned to full commit SHAs (tag in comment); bump via Dependabot or after upstream review.
#
# Explicit permissions satisfy GitHub's "Workflow does not contain permissions" requirement:
# - contents: read — checkout and read repo
# - security-events: write — upload CodeQL results to Security tab
# - actions: read — CodeQL action may need to read other actions
name: CodeQL

on:
  push:
    branches: [main, master]
  pull_request:
    branches: [main, master]
  schedule:
    # Weekly run (default branch) to catch new CodeQL findings
    - cron: "0 6 * * 1"

permissions:
  contents: read
  security-events: write
  actions: read

jobs:
  analyze:
    name: Analyze (Python)
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        language: [python]

    steps:
      - name: Checkout repository
        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
        with:
          persist-credentials: false

      - name: Initialize CodeQL
        uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2
        with:
          languages: ${{ matrix.language }}
          # Keep broad default coverage for "just in case" findings.
          # Do not remove existing project hardening rules; this augments them.
          queries: security-and-quality

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