🔧 chore: Update CodeQL configuration for improved analysis scheduling and clarity

.github/workflows/codeql.yml

@@ -6,7 +6,7 @@
 #
 # ******** NOTE ********
 # We have attempted to detect the languages in your repository. Please check
-# the language matrix defined below to confirm you have the correct set of
+# the `language` matrix defined below to confirm you have the correct set of
 # supported CodeQL languages.
 #
 name: "CodeQL Advanced"
@@ -17,7 +17,7 @@ on:
   pull_request:
     branches: [ "main" ]
   schedule:
-    - cron: '43 23 * * 5'
+    - cron: '39 17 * * 6'
 
 jobs:
   analyze:
@@ -26,6 +26,7 @@ jobs:
     #   - https://gh.io/recommended-hardware-resources-for-running-codeql
     #   - https://gh.io/supported-runners-and-hardware-resources
     #   - https://gh.io/using-larger-runners (GitHub.com only)
+    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
     runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
     permissions:
       # required for all workflows
@@ -42,23 +43,27 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          # The following entry uses "javascript-typescript" to analyze both JavaScript and TypeScript.
+          - language: actions
+            build-mode: none
           - language: javascript-typescript
             build-mode: none
-          # CodeQL supports the following values for the 'language' key:
+        # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'swift'
-          #   'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'swift'
+        # Use `c-cpp` to analyze code written in C, C++ or both
-          # For compiled languages, you can adjust the 'build-mode' (for example, to "manual") if needed.
+        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
       # Add any setup steps before running the `github/codeql-action/init` action.
-      # This includes steps like installing compilers or runtimes (e.g., actions/setup-node).
+      # This includes steps like installing compilers or runtimes (`actions/setup-node`
-      # For example, if you require a specific Node.js version for building your project:
+      # or others). This is typically only required for manual builds.
-      # - name: Setup Node.js
+      # - name: Setup runtime (example)
-      #   uses: actions/setup-node@v3
+      #   uses: actions/setup-example@v1
-      #   with:
-      #     node-version: '16'
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
@@ -66,13 +71,11 @@ jobs:
         with:
           languages: ${{ matrix.language }}
           build-mode: ${{ matrix.build-mode }}
-          # Use our custom configuration file to exclude test files.
-          config-file: .codeql-config.yml
           # If you wish to specify custom queries, you can do so here or in a config file.
           # By default, queries listed here will override any specified in a config file.
-          # To add queries to those specified in your config file, prefix the list here with "+"
+          # Prefix the list here with "+" to use these queries and those in the config file.
-          # For more details on CodeQL's query packs, refer to:
+
-          # https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+          # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
           # queries: security-extended,security-and-quality
 
       # If the analyze step fails for one of the languages you are analyzing with
@@ -85,8 +88,8 @@ jobs:
         shell: bash
         run: |
           echo 'If you are using a "manual" build mode for one or more of the' \
-               'languages you are analyzing, replace this with the commands to build' \
+            'languages you are analyzing, replace this with the commands to build' \
-               'your code. For example:'
+            'your code, for example:'
           echo '  make bootstrap'
           echo '  make release'
           exit 1
@@ -94,4 +97,4 @@ jobs:
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v3
         with:
-          category: "/language:${{ matrix.language }}"
+          category: "/language:${{matrix.language}}"