[8.19] [DOCS] Fix OpenAPI linting error in detection_engine (#248570) (#250278)

# Backport

This will backport the following commits from `main` to `8.19`:
- [[DOCS] Fix OpenAPI linting error in detection_engine
(#248570)](#248570)

<!--- Backport version: 10.2.0 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Lisa
Cawley","email":"lcawley@elastic.co"},"sourceCommit":{"committedDate":"2026-01-23T10:04:15Z","message":"[DOCS]
Fix OpenAPI linting error in detection_engine
(#248570)\n\nCo-authored-by: Maxim Palenov
<maxim.palenov@elastic.co>","sha":"da6bf3ecab9d48b569d444f81c2e037cd4404cec","branchLabelMapping":{"^v9.4.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","docs","Team:Detection
Engine","backport:version","v9.3.0","v9.4.0","v8.19.10"],"title":"[DOCS]
Fix OpenAPI linting error in
detection_engine","number":248570,"url":"https://github.com/elastic/kibana/pull/248570","mergeCommit":{"message":"[DOCS]
Fix OpenAPI linting error in detection_engine
(#248570)\n\nCo-authored-by: Maxim Palenov
<maxim.palenov@elastic.co>","sha":"da6bf3ecab9d48b569d444f81c2e037cd4404cec"}},"sourceBranch":"main","suggestedTargetBranches":["9.3","8.19"],"targetPullRequestStates":[{"branch":"9.3","label":"v9.3.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v9.4.0","branchLabelMappingKey":"^v9.4.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/248570","number":248570,"mergeCommit":{"message":"[DOCS]
Fix OpenAPI linting error in detection_engine
(#248570)\n\nCo-authored-by: Maxim Palenov
<maxim.palenov@elastic.co>","sha":"da6bf3ecab9d48b569d444f81c2e037cd4404cec"}},{"branch":"8.19","label":"v8.19.10","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

---------

Co-authored-by: Maxim Palenov <maxim.palenov@elastic.co>

Author: lcawl

src/platform/packages/shared/kbn-openapi-generator/redocly_linter/config.yaml

@@ -4,7 +4,6 @@ plugins:
   - extra_linter_rules_plugin.js
 
 rules:
-  spec: error
   spec-strict-refs: error
   no-path-trailing-slash: error
   no-identical-paths: error
@@ -20,6 +19,11 @@ rules:
   operation-operationId-url-safe: error
   operation-parameters-unique: error
   extra-linter-rules-plugin/valid-x-modify: error
+  no-duplicated-tag-names: error
+  no-example-value-and-externalValue: error
+  no-undefined-server-variable: error
+  nullable-type-sibling: error
+  spec-components-invalid-map-name: error
   # Disable rules generating the majority of warnings.
   # They will be handled separately.
   # operation-description: warn

src/platform/packages/shared/kbn-openapi-generator/src/parser/lib/helpers/find_refs.ts

@@ -19,11 +19,18 @@ import { traverseObject } from './traverse_object';
 export function findRefs(obj: unknown): string[] {
   const refs: string[] = [];
 
-  traverseObject(obj, (element) => {
-    if (hasRef(element)) {
-      refs.push(element.$ref);
+  traverseObject(
+    obj,
+    (element) => {
+      if (hasRef(element)) {
+        refs.push(element.$ref);
+      }
+    },
+    {
+      // We don't require example references in code generation
+      skipKeys: ['examples'],
     }
-  });
+  );
 
   return refs;
 }

src/platform/packages/shared/kbn-openapi-generator/src/parser/lib/helpers/traverse_object.ts

@@ -7,18 +7,30 @@
  * License v3.0 only", or the "Server Side Public License, v 1".
  */
 
+interface TraverseObjectOptions {
+  skipKeys?: string[];
+}
+
 /**
  * A generic function to traverse an object or array of objects recursively
  *
  * @param obj The object to traverse
  * @param onVisit A function that will be called for each traversed node in the object
  */
-export function traverseObject(obj: unknown, onVisit: (element: object) => void) {
+export function traverseObject(
+  obj: unknown,
+  onVisit: (element: object) => void,
+  options: TraverseObjectOptions = {}
+) {
   function search(element: unknown) {
     if (typeof element === 'object' && element !== null) {
       onVisit(element);
 
-      Object.values(element).forEach((value) => {
+      Object.entries(element).forEach(([key, value]) => {
+        if (options.skipKeys?.includes(key)) {
+          return;
+        }
+
         if (Array.isArray(value)) {
           value.forEach(search);
         } else {