From 899a672743470450b412795e14a31a99ec17abae Mon Sep 17 00:00:00 2001
From: idrissrio <idrissrio@github.com>
Date: Thu, 19 Mar 2026 10:27:53 +0100
Subject: [PATCH] Feature flag: C/C++ overlay

---
 src/feature-flags.ts | 13 +++++++++++++
 src/overlay/index.ts |  1 +
 2 files changed, 14 insertions(+)

diff --git a/src/feature-flags.ts b/src/feature-flags.ts
index d314f4f11..9fa9b9590 100644
--- a/src/feature-flags.ts
+++ b/src/feature-flags.ts
@@ -9,6 +9,7 @@ import * as defaults from "./defaults.json";
 import { Logger } from "./logging";
 import {
   CODEQL_OVERLAY_MINIMUM_VERSION,
+  CODEQL_OVERLAY_MINIMUM_VERSION_CPP,
   CODEQL_OVERLAY_MINIMUM_VERSION_CSHARP,
   CODEQL_OVERLAY_MINIMUM_VERSION_GO,
   CODEQL_OVERLAY_MINIMUM_VERSION_JAVA,
@@ -57,12 +58,14 @@ export enum Feature {
   IgnoreGeneratedFiles = "ignore_generated_files",
   JavaNetworkDebugging = "java_network_debugging",
   OverlayAnalysis = "overlay_analysis",
+  OverlayAnalysisCodeScanningCpp = "overlay_analysis_code_scanning_cpp",
   OverlayAnalysisCodeScanningCsharp = "overlay_analysis_code_scanning_csharp",
   OverlayAnalysisCodeScanningGo = "overlay_analysis_code_scanning_go",
   OverlayAnalysisCodeScanningJava = "overlay_analysis_code_scanning_java",
   OverlayAnalysisCodeScanningJavascript = "overlay_analysis_code_scanning_javascript",
   OverlayAnalysisCodeScanningPython = "overlay_analysis_code_scanning_python",
   OverlayAnalysisCodeScanningRuby = "overlay_analysis_code_scanning_ruby",
+  OverlayAnalysisCpp = "overlay_analysis_cpp",
   OverlayAnalysisCsharp = "overlay_analysis_csharp",
   /** Disable TRAP caching when overlay analysis is enabled. */
   OverlayAnalysisDisableTrapCaching = "overlay_analysis_disable_trap_caching",
@@ -199,6 +202,11 @@ export const featureConfig = {
   // Per-language overlay feature flags. Each has minimumVersion set to the
   // minimum CLI version that supports overlay analysis for that language.
   // Only languages that are GA or in staff-ship should have feature flags here.
+  [Feature.OverlayAnalysisCodeScanningCpp]: {
+    defaultValue: false,
+    envVar: "CODEQL_ACTION_OVERLAY_ANALYSIS_CODE_SCANNING_CPP",
+    minimumVersion: CODEQL_OVERLAY_MINIMUM_VERSION_CPP,
+  },
   [Feature.OverlayAnalysisCodeScanningCsharp]: {
     defaultValue: false,
     envVar: "CODEQL_ACTION_OVERLAY_ANALYSIS_CODE_SCANNING_CSHARP",
@@ -229,6 +237,11 @@ export const featureConfig = {
     envVar: "CODEQL_ACTION_OVERLAY_ANALYSIS_CODE_SCANNING_RUBY",
     minimumVersion: CODEQL_OVERLAY_MINIMUM_VERSION_RUBY,
   },
+  [Feature.OverlayAnalysisCpp]: {
+    defaultValue: false,
+    envVar: "CODEQL_ACTION_OVERLAY_ANALYSIS_CPP",
+    minimumVersion: CODEQL_OVERLAY_MINIMUM_VERSION_CPP,
+  },
   [Feature.OverlayAnalysisCsharp]: {
     defaultValue: false,
     envVar: "CODEQL_ACTION_OVERLAY_ANALYSIS_CSHARP",
diff --git a/src/overlay/index.ts b/src/overlay/index.ts
index 3b45a60d4..63a46b2b3 100644
--- a/src/overlay/index.ts
+++ b/src/overlay/index.ts
@@ -35,6 +35,7 @@ export const CODEQL_OVERLAY_MINIMUM_VERSION = "2.23.8";
 
 // Per-language minimum CLI versions for overlay analysis, based on release
 // validation data.
+export const CODEQL_OVERLAY_MINIMUM_VERSION_CPP = "2.25.0";
 export const CODEQL_OVERLAY_MINIMUM_VERSION_CSHARP = "2.24.1";
 export const CODEQL_OVERLAY_MINIMUM_VERSION_GO = "2.24.2";
 export const CODEQL_OVERLAY_MINIMUM_VERSION_JAVA = "2.23.8";