chore(ci): advise manual IT runs for excluded modules

When changed modules have associated integration tests that are
excluded from CI (e.g. camel-jbang-core → camel-jbang-it), post
a PR comment advising the contributor to run them manually.

The mapping is maintained in manual-it-mapping.txt, co-located
with the incremental build script.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: gnodet

.github/CI-ARCHITECTURE.md

@@ -86,6 +86,8 @@ The core test runner. Determines which modules to test using:
 Results are merged, deduplicated, and tested. The script also:
 - Detects tests disabled in CI (`@DisabledIfSystemProperty(named = "ci.env.name")`)
 - Applies an exclusion list for generated/meta modules
+- Checks for excluded modules with associated integration tests (via
+  `manual-it-mapping.txt`) and advises contributors to run them manually
 - Generates a unified PR comment with all test information
 
 ### `install-mvnd`
@@ -141,6 +143,29 @@ properties change. A future improvement could use
 [Scalpel](https://github.com/maveniverse/scalpel) to resolve the full
 dependency graph and detect all affected modules.
 
+## Manual Integration Test Advisories
+
+Some modules are excluded from CI's `-amd` expansion (the `EXCLUSION_LIST`)
+because they are generated code, meta-modules, or expensive integration test
+suites. When a contributor changes one of these modules, CI cannot automatically
+test all downstream effects.
+
+The file `manual-it-mapping.txt` (co-located with the incremental build script)
+maps source modules to their associated integration test suites. When a changed
+module has a mapping entry, CI posts an advisory in the PR comment:
+
+> You modified `dsl/camel-jbang/camel-jbang-core`. The related integration
+> tests in `dsl/camel-jbang/camel-jbang-it` are excluded from CI. Consider
+> running them manually:
+> ```
+> mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test
+> ```
+
+To add new mappings, edit `manual-it-mapping.txt` using the format:
+```
+source-artifact-id:it-module-path:command
+```
+
 ## Multi-JDK Artifact Behavior
 
 All non-experimental JDK matrix entries (17, 21) upload the CI comment

.github/actions/incremental-build/incremental-build.sh

@@ -215,6 +215,49 @@ detectDisabledTests() {
   fi
 }
 
+# Check if changed modules have associated integration tests excluded from CI.
+# Reads manual-it-mapping.txt and appends advisories to the PR comment.
+checkManualItTests() {
+  local final_pl="$1"
+  local comment_file="$2"
+  local script_dir
+  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  local mapping_file="${script_dir}/manual-it-mapping.txt"
+
+  [[ ! -f "$mapping_file" ]] && return
+
+  declare -A it_commands
+  declare -A it_sources
+
+  while IFS=: read -r source_id it_module command; do
+    # Skip comments and empty lines
+    [[ -z "$source_id" || "$source_id" == \#* ]] && continue
+    source_id="${source_id// /}"
+    it_module="${it_module// /}"
+    command="${command#"${command%%[![:space:]]*}"}"
+
+    # Check if any module in final_pl matches this source_id
+    for module_path in $(echo "$final_pl" | tr ',' '\n'); do
+      if [[ "$(basename "$module_path")" == "$source_id" ]]; then
+        it_commands["$it_module"]="$command"
+        it_sources["$it_module"]="${it_sources[$it_module]:-}${it_sources[$it_module]:+, }\`${module_path}\`"
+      fi
+    done
+  done < "$mapping_file"
+
+  if [[ ${#it_sources[@]} -gt 0 ]]; then
+    echo "" >> "$comment_file"
+    echo ":bulb: **Manual integration tests recommended:**" >> "$comment_file"
+    for it_module in "${!it_sources[@]}"; do
+      echo "" >> "$comment_file"
+      echo "> You modified ${it_sources[$it_module]}. The related integration tests in \`${it_module}\` are excluded from CI. Consider running them manually:" >> "$comment_file"
+      echo '> ```' >> "$comment_file"
+      echo "> ${it_commands[$it_module]}" >> "$comment_file"
+      echo '> ```' >> "$comment_file"
+    done
+  fi
+}
+
 # ── Comment generation ─────────────────────────────────────────────────
 
 writeComment() {
@@ -512,6 +555,9 @@ main() {
     echo "$disabled_tests" >> "$comment_file"
   fi
 
+  # Check for excluded IT suites that should be run manually
+  checkManualItTests "$final_pl" "$comment_file"
+
   # Append reactor module list from build log
   if [[ -f "$log" ]]; then
     local reactor_modules

.github/actions/incremental-build/manual-it-mapping.txt

@@ -0,0 +1,15 @@
+# Manual integration test mapping
+#
+# Maps source modules (excluded from CI -amd expansion) to their
+# associated integration test suites that must be run manually.
+#
+# Format: source-artifact-id : it-module-path : command
+#
+# JBang integration tests
+camel-jbang-core:dsl/camel-jbang/camel-jbang-it:mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test
+camel-jbang-main:dsl/camel-jbang/camel-jbang-it:mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test
+camel-jbang-plugin-generate:dsl/camel-jbang/camel-jbang-it:mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test
+camel-jbang-plugin-edit:dsl/camel-jbang/camel-jbang-it:mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test
+camel-jbang-plugin-kubernetes:dsl/camel-jbang/camel-jbang-it:mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test
+camel-jbang-plugin-test:dsl/camel-jbang/camel-jbang-it:mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test
+camel-launcher:dsl/camel-jbang/camel-jbang-it:mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test