codeql.yml

name: CodeQL

# Varredura de segurança do código (CodeQL) — procura padrões inseguros (injeção,
# XSS, etc.) a cada push/PR na main e semanalmente. Resultados aparecem na aba
# Security > Code scanning do repositório. Grátis em repositório público.

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  schedule:
    - cron: "27 4 * * 1"   # toda segunda, 04:27 UTC

jobs:
  analyze:
    name: Analyze (python)
    runs-on: ubuntu-latest
    permissions:
      security-events: write
      actions: read
      contents: read
    steps:
      - uses: actions/checkout@v6

      - name: Inicializar CodeQL
        uses: github/codeql-action/init@v4
        with:
          languages: python
          # security-extended: foco em SEGURANÇA. Evitamos "security-and-quality"
          # porque o lint de qualidade dele gera falsos positivos de "unused global"
          # no nosso padrão de módulos que expõem constantes p/ outros arquivos
          # (ex.: niimbot_registry, filament_catalog) — uso entre módulos não é visto.
          queries: security-extended

      - name: Analisar
        uses: github/codeql-action/analyze@v4
        with:
          category: "/language:python"