codeql.yml

# Static Application Security Testing (SAST) for the harness.
#
# CodeQL analyzes the TypeScript harness/desktop AND the Python scanner sidecar for
# security bugs (injection, path traversal, unsafe deserialization, etc.) using the
# security-extended query suite, and reports them in the repo's Security → Code scanning tab.
#
# Free on public repos; on private repos it needs GitHub Advanced Security enabled.
# TS + Python are interpreted, so no build step is required.

name: CodeQL (SAST)

on:
  push:
    branches: [master]
  pull_request:
    branches: [master]
  schedule:
    - cron: "27 4 * * 1" # weekly, Monday 04:27 UTC — catches newly-published query updates

permissions:
  contents: read
  security-events: write # upload findings to Code scanning
  actions: read

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

jobs:
  analyze:
    name: Analyze ${{ matrix.language }}
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        language: [javascript-typescript, python]
    steps:
      - uses: actions/checkout@v7

      - name: Initialize CodeQL
        uses: github/codeql-action/init@v4
        with:
          languages: ${{ matrix.language }}
          queries: security-extended
          # `mockups/` holds non-shipped, static design prototypes (unwired HTML/JS). They aren't product
          # code and their prototype patterns (e.g. a local `$ = id => getElementById(id)` helper) trip
          # DOM-XSS heuristics as false positives, so exclude them from analysis.
          config: |
            paths-ignore:
              - mockups

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