codeql.yml

# This workflow is managed by gh actions-lock.
# SPDX-License-Identifier: MPL-2.0
name: CodeQL Security Analysis

on:
  push:
    branches: [main, master]
  pull_request:
    branches: [main, master]
  schedule:
    - cron: '0 6 1 * *'

# Estate guardrail: cancel superseded runs so re-pushes / rebased PR
# updates do not pile up queued runs against the shared account-wide
# Actions concurrency pool. Applied only to read-only check workflows
# (no publish/mutation), so cancelling a superseded run is always safe.
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true


permissions: read-all

jobs:
  analyze:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    permissions:
      contents: read
      security-events: write
    strategy:
      fail-fast: false
      matrix:
        include:
          # The repository contains no JavaScript/TypeScript source (the estate
          # language policy bans TS; only JSON config files exist), so the
          # javascript-typescript extractor errored with "no source code seen".
          # CodeQL's GitHub Actions analysis scans the workflow YAML that does
          # exist here, keeping this a meaningful security check.
          - language: actions
            build-mode: none

    steps:
      - name: Checkout
        uses: actions/checkout@v7.0.1

      - name: Initialize CodeQL
        # v4.38.0, deliberately: v4.38.1 is BLOCKED ESTATE-WIDE — it fails
        # GitHub workflow-startup validation (nexia-list#100; see standards'
        # dependabot.yml hold). Dependabot is held off this package via the
        # `github/codeql-action*` ignore in .github/dependabot.yml; do not
        # bump past 4.38.0 until the estate hold is lifted.
        uses: github/codeql-action/init@v4.38.0
        with:
          languages: ${{ matrix.language }}
          build-mode: ${{ matrix.build-mode }}

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