From e798bec43371bd99557110b50fe37c09805f40be Mon Sep 17 00:00:00 2001
From: David Flanagan <david@rawkode.dev>
Date: Tue, 19 May 2026 16:52:16 +0100
Subject: [PATCH] ci: add CodeQL analysis for Rust + JavaScript/TypeScript
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The `main` branch ruleset has a `code_scanning` requirement (CodeQL,
`alerts_threshold: errors`) but no CodeQL workflow existed, so every
PR to main was blocked indefinitely — the rule can't pass without a
scan to evaluate. This adds the missing workflow.

Coverage
- `rust`: extracts the workspace via `cargo build --workspace`. Uses
  the same stable Rust + Go toolchain as `ci.yml`'s rust job so
  cuengine's Go FFI build keeps working under CodeQL's extractor.
- `javascript-typescript`: source-only extraction, no build. Covers
  .ts, .tsx, .js, and `<script>` blocks inside .vue files (the JS/TS
  extractor reads Vue SFCs natively).

Query pack: `security-and-quality`. The ruleset only blocks on
`errors`, so quality-pack warnings/notices surface in the Security
tab without gating PR merges.

Triggers: pull_request + push to main/v3 (so the ruleset auto-merge
clears immediately after a green run) and a weekly cron (so newly-
published queries flag regressions on existing code without a push).

Permissions: least-privilege — `security-events: write` for findings
upload, `actions: read`/`contents: read` for the extractor. No `run:`
step consumes untrusted external input.
---
 .github/workflows/codeql.yml | 60 ++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 .github/workflows/codeql.yml

diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
new file mode 100644
index 00000000..6627ee14
--- /dev/null
+++ b/.github/workflows/codeql.yml
@@ -0,0 +1,60 @@
+name: codeql
+
+# Required by the `main` branch ruleset (`code_scanning` with
+# `alerts_threshold: errors`). Runs on PRs and pushes so the ruleset's
+# auto-merge condition can clear, and on a weekly cron so newly-published
+# CodeQL queries surface regressions on existing code without a push.
+on:
+  pull_request:
+  push:
+    branches: [main, v3]
+  schedule:
+    # Mondays 06:13 UTC — odd minute to avoid the hourly-cron stampede.
+    - cron: "13 6 * * 1"
+
+concurrency:
+  group: codeql-${{ github.ref }}
+  cancel-in-progress: true
+
+# Least-privilege: only `security-events: write` for findings upload.
+# No run: step consumes untrusted external input (issue/PR/commit text);
+# the only template expansion is `matrix.language`, a static list.
+permissions:
+  security-events: write
+  actions: read
+  contents: read
+
+jobs:
+  analyze:
+    name: analyze (${{ matrix.language }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        language:
+          # CodeQL's Rust extractor only supports `build-mode: none`
+          # (source-only) — see CodeQL 2.25+ release notes. No cargo
+          # build step needed; the extractor parses .rs files directly.
+          - rust
+          # JS/TS extracts source files directly. Covers .ts, .tsx,
+          # .js, and `<script>` blocks inside .vue files (the JS/TS
+          # extractor reads Vue SFCs natively).
+          - javascript-typescript
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
+          build-mode: none
+          # `security-and-quality` is the broader pack; the ruleset
+          # only blocks on `errors`, so quality-pack warnings/notices
+          # surface in the Security tab without gating merges.
+          queries: security-and-quality
+
+      - name: perform CodeQL analysis
+        uses: github/codeql-action/analyze@v3
+        with:
+          category: /language:${{ matrix.language }}