Add Scout events reporter integration (elastic#245528)

## Summary

Adds Scout events reporter integration to the kbn-cypress-config
package, enabling automatic test run tracking and reporting for Cypress
tests when Scout reporting is enabled.

### Changes 

- **Scout reporter integration**
([index.ts](src/platform/packages/shared/kbn-cypress-config/index.ts))
- Added `getReportingOptionOverrides()` to inject Scout reporter into
Cypress multi-reporter configuration
- Auto-detects test category (API, Unit, or UI) based on config file
path
- Parses existing reporter configuration and appends Scout reporter when
`SCOUT_REPORTER_ENABLED` is true
  - Extracts config file path and project root from CLI arguments

- **Custom Cypress reporter**
([reporter.ts](src/platform/packages/shared/kbn-cypress-config/src/reporting/scout_events/reporter.ts))
- Implements `ScoutCypressReporter` class that hooks into Mocha's test
lifecycle
  - Captures test run events (start, end, test begin, test end)
  - Integrates with code owners to track team ownership for test files
- Generates structured Scout events with environment metadata, test
status, and duration

---------

Co-authored-by: David Olaru <dolaru@elastic.co>
Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: Cesare de Cal <cesare.decal@elastic.co>

Author: 4 people

.buildkite/scripts/steps/functional/apm_cypress.sh

@@ -13,4 +13,9 @@ echo "--- APM Cypress Tests"
 cd "$XPACK_DIR/solutions/observability/plugins/apm/ftr_e2e"
 
 set +e
-yarn cypress:run; status=$?; yarn junit:merge || :; exit $status
+yarn cypress:run; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status

.buildkite/scripts/steps/functional/asset_inventory.sh

@@ -13,4 +13,9 @@ cd x-pack/solutions/security/test/security_solution_cypress
 
 set +e
 
-yarn cypress:asset_inventory:run:ess; status=$?; yarn junit:merge || :; exit $status
+yarn cypress:asset_inventory:run:ess; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status

.buildkite/scripts/steps/functional/asset_inventory_serverless.sh

@@ -13,4 +13,9 @@ cd x-pack/solutions/security/test/security_solution_cypress
 
 set +e
 
-yarn cypress:asset_inventory:run:serverless; status=$?; yarn junit:merge || :; exit $status
+yarn cypress:asset_inventory:run:serverless; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status

.buildkite/scripts/steps/functional/cloud_security_posture.sh

@@ -13,4 +13,9 @@ cd x-pack/solutions/security/test/security_solution_cypress
 
 set +e
 
-yarn cypress:cloud_security_posture:run:ess; status=$?; yarn junit:merge || :; exit $status
+yarn cypress:cloud_security_posture:run:ess; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status

.buildkite/scripts/steps/functional/cloud_security_posture_serverless.sh

@@ -13,4 +13,9 @@ cd x-pack/solutions/security/test/security_solution_cypress
 
 set +e
 
-yarn cypress:cloud_security_posture:run:serverless; status=$?; yarn junit:merge || :; exit $status
+yarn cypress:cloud_security_posture:run:serverless; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status

.buildkite/scripts/steps/functional/common.sh

@@ -12,3 +12,34 @@ source .buildkite/scripts/common/util.sh
 
 is_test_execution_step
 
+# Upload Scout reporter events after Cypress test execution
+upload_scout_cypress_events() {
+  local test_name="${1:-Cypress tests}"
+
+  if [[ "${SCOUT_REPORTER_ENABLED:-}" =~ ^(1|true)$ ]]; then
+    # Save current directory and navigate to Kibana root
+    local current_dir=$(pwd)
+    cd "${KIBANA_DIR:-$(git rev-parse --show-toplevel)}"
+
+    # Check if reports exist before uploading
+    if compgen -G '.scout/reports/*' > /dev/null; then
+      echo "--- Upload Scout reporter events to AppEx QA's team cluster for $test_name"
+      node scripts/scout upload-events --dontFailOnError
+
+      # Clean up only Cypress event reports to avoid double ingestion
+      # Only remove scout-cypress-* directories, preserving other test reports and failure reports
+      if compgen -G '.scout/reports/scout-cypress-*' > /dev/null; then
+       echo "🧹 Cleaning up Scout Cypress event reports"
+       rm -rf .scout/reports/scout-cypress-*
+      fi
+    else
+      echo "❌ No Scout reports found for $test_name"
+    fi
+
+    # Return to original directory
+    cd "$current_dir"
+  else
+    echo "SCOUT_REPORTER_ENABLED=$SCOUT_REPORTER_ENABLED, skipping event upload."
+  fi
+}
+

.buildkite/scripts/steps/functional/defend_workflows.sh

@@ -14,4 +14,9 @@ cd x-pack/solutions/security/plugins/security_solution
 set +e
 BK_ANALYTICS_API_KEY=$(vault_get security-solution-ci defend-workflows-bk-api-key)
 
-BK_ANALYTICS_API_KEY=$BK_ANALYTICS_API_KEY yarn cypress:dw:run; status=$?; yarn junit:merge || :; exit $status
+BK_ANALYTICS_API_KEY=$BK_ANALYTICS_API_KEY yarn cypress:dw:run; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status

.buildkite/scripts/steps/functional/defend_workflows_serverless.sh

@@ -14,4 +14,9 @@ cd x-pack/solutions/security/plugins/security_solution
 set +e
 BK_ANALYTICS_API_KEY=$(vault_get security-solution-ci defend-workflows-bk-api-key)
 
-BK_ANALYTICS_API_KEY=$BK_ANALYTICS_API_KEY yarn cypress:dw:serverless:run; status=$?; yarn junit:merge || :; exit $status
+BK_ANALYTICS_API_KEY=$BK_ANALYTICS_API_KEY yarn cypress:dw:serverless:run; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status

.buildkite/scripts/steps/functional/fleet_cypress.sh

@@ -12,4 +12,14 @@ echo "--- Fleet Cypress tests (Chrome)"
 cd x-pack/platform/plugins/shared/fleet
 
 set +e
-yarn cypress:run:reporter; status=$?; yarn cypress_space_awareness:run:reporter; space_status=$?; yarn junit:merge || :; [ "$status" -ne 0 ] && exit $status || [ "$space_status" -ne 0 ] && exit $space_status || exit 0
+yarn cypress:run:reporter; status=$?; yarn cypress_space_awareness:run:reporter; space_status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Fleet Cypress tests"
+
+# Exit with appropriate status
+if [ "$status" -ne 0 ]; then
+  exit $status
+elif [ "$space_status" -ne 0 ]; then
+  exit $space_status
+fi

.buildkite/scripts/steps/functional/osquery_cypress.sh

@@ -13,4 +13,9 @@ echo "--- Osquery Cypress tests"
 cd x-pack/platform/plugins/shared/osquery
 
 set +e
-yarn cypress:run; status=$?; yarn junit:merge || :; exit $status
+yarn cypress:run; status=$?; yarn junit:merge || :
+
+# Scout reporter
+upload_scout_cypress_events "Cypress tests"
+
+exit $status