Update Qodana workflow: add compile step and include generated sources for resolution

- Introduced a compile step (skipping tests) to prepare classes for import resolution.
- Adjusted `qodana.yaml` to include generated sources instead of excluding them, preventing unresolved imports.

.github/workflows/qodana_code_quality.yml

@@ -1,9 +1,16 @@
 name: Qodana
 on:
   workflow_dispatch:
+    inputs:
+      target_ref:
+        description: 'Branch, tag, or commit SHA to analyze (default: develop)'
+        required: false
+        default: 'develop'
+        type: string
   pull_request:
   push:
     branches: # Specify your branches here
+      - master
       - main # The 'main' branch
       - develop
       - 'releases/*' # The release branches
@@ -16,14 +23,78 @@ jobs:
       pull-requests: write
       checks: write
     steps:
-      - uses: actions/checkout@v3
+      # Checkout for pull_request events: use the PR head SHA for accurate analysis
+      - name: Checkout (pull_request)
+        if: ${{ github.event_name == 'pull_request' }}
+        uses: actions/checkout@v4
         with:
-          ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
+          ref: ${{ github.event.pull_request.head.sha }}
           fetch-depth: 0  # a full history is required for pull request analysis
+
+      # Checkout for manual runs: use the selected branch/ref (default: develop)
+      - name: Checkout (workflow_dispatch)
+        if: ${{ github.event_name == 'workflow_dispatch' }}
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.target_ref }}
+          fetch-depth: 0
+
+      # Checkout for push events (e.g., merges to develop): use the current commit
+      - name: Checkout (push)
+        if: ${{ github.event_name == 'push' }}
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      # Set up JDK for potential code generation (e.g., protobuf) prior to Qodana analysis
+      - name: Set up Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+          cache: 'maven'
+
+      # Generate sources so that Qodana resolves imports from generated code
+      - name: Generate sources (protobuf)
+        shell: bash
+        run: |
+          if [ -f ./mvnw ]; then chmod +x ./mvnw || true; fi
+          if [ -x ./mvnw ]; then
+            ./mvnw -B -DskipTests -DskipITs=true generate-sources || true
+          elif command -v mvn >/dev/null 2>&1; then
+            mvn -B -DskipTests -DskipITs=true generate-sources || true
+          else
+            echo "[Qodana prep] Maven not available; skipping generate-sources"
+          fi
+
+      # Optionally compile (skip tests) to ensure classes are available for resolution
+      - name: Compile (skip tests)
+        shell: bash
+        run: |
+          if [ -x ./mvnw ]; then
+            ./mvnw -B -DskipTests -DskipITs=true compile || true
+          elif command -v mvn >/dev/null 2>&1; then
+            mvn -B -DskipTests -DskipITs=true compile || true
+          else
+            echo "[Qodana prep] Maven not available; skipping compile"
+          fi
+
+      # Helpful debug: list generated sources if present
+      - name: Show generated sources
+        shell: bash
+        run: |
+          echo "=== target/generated-sources (tree) ===" || true
+          if [ -d target/generated-sources ]; then
+            find target/generated-sources -maxdepth 3 -type d -print || true
+          else
+            echo "(none)" || true
+          fi
       - name: 'Qodana Scan'
         uses: JetBrains/qodana-action@v2025.2
         with:
-          pr-mode: false
+          # Enable PR-specific reporting only for pull_request events
+          pr-mode: ${{ github.event_name == 'pull_request' }}
+          # No extra args needed; linter is defined in qodana.yaml (qodana-jvm)
         env:
           QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_268690425 }}
           QODANA_ENDPOINT: 'https://qodana.cloud'

CODE_OF_CONDUCT.md

@@ -0,0 +1,5 @@
+# Contributor Code of Conduct
+
+This project adheres to No Code of Conduct.  We are all adults.  We accept anyone's contributions.  Nothing else matters.
+
+For more information please visit the [No Code of Conduct](https://nocodeofconduct.com) homepage.

qodana.yaml

@@ -3,8 +3,19 @@
 ####################################################################################################################
 
 version: "1.0"
-linter: jetbrains/qodana-jvm:2025.2
+# Use canonical linter name to avoid image warnings and CLI flag issues
+linter: qodana-jvm
 profile:
   name: qodana.recommended
+bootstrap: |
+  # Disabled bootstrap to avoid shell parsing issues in CI. If you need code generation,
+  # we can re-enable a robust script later. For now, do nothing and let Qodana run.
+  :
 include:
   - name: CheckDependencyLicenses
+exclude:
+  # Exclude generated sources from inspections to reduce noise
+  - name: All
+    paths:
+      - target/protoc-dependencies/**
+      # Keep generated sources included for indexing/resolution; excluding them can cause unresolved imports