performance: add optional boot KPI goal gating

Runner/suites/Performance/Boot_Systemd_Validate/Boot_Systemd_Validate.yaml

@@ -1,7 +1,7 @@
 metadata:
   name: boot-systemd-validate
   format: "Lava-Test Test Definition 1.0"
-  description: "Systemd boot KPI capture + required unit gating + artifacts (critical-chain, blame, plot, unit states)."
+  description: "Systemd boot KPI capture, required unit gating, boot goal validation, and artifacts."
   os:
     - linux
   scope:
@@ -11,27 +11,35 @@ metadata:
 params:
   OUT_DIR: "./logs_Boot_Systemd_Validate"
 
-  # Either provide REQUIRED_UNITS_FILE (existing file path) OR REQUIRED_UNITS (list).
-  # REQUIRED_UNITS supports commas/spaces and will be written to OUT_DIR/required_units.txt automatically.
+  # Either provide REQUIRED_UNITS_FILE or REQUIRED_UNITS.
+  # REQUIRED_UNITS supports comma/space-separated service names and is written to OUT_DIR/required_units.txt.
   REQUIRED_UNITS_FILE: ""
   REQUIRED_UNITS: ""
 
   TIMEOUT_PER_UNIT: "30"
   SVG: "yes" # yes|no
-  BOOT_TYPE: "unknown" # cold|warm|unknown etc
+  BOOT_TYPE: "unknown" # cold|warm|unknown
   DISABLE_GETTY: "0" # 1|0
   DISABLE_SSHD: "0" # 1|0
   EXCLUDE_NETWORKD_WAIT_ONLINE: "0" # 1|0
   EXCLUDE_SERVICES: "" # space-separated service names
   BOOT_KPI_ITERATIONS: "1"
-  VERBOSE: "0"
 
-  # Optional improvement: configurable boot-complete wait (seconds)
+  # Optional boot KPI goal gating.
+  # Gating remains disabled by default.
+  # Enable it by setting BOOT_GOAL or BOOT_GOAL_FILE from the LAVA job.
+  BOOT_GOAL: "" # inline goal in seconds, for example "35"
+  BOOT_GOAL_FILE: "" # platform-aware goal file, for example "boot_kpi_goals"
+  BOOT_GOAL_METRIC: "boot_total_sec" # lower-is-better KPI metric to gate
+  BOOT_GOAL_TOLERANCE_PERCENT: "2" # allowed percentage above goal before FAIL
+  BOOT_GOAL_PLATFORM: "" # optional platform alias override, for example qcs6490-rb3gen2-core-kit
+
+  VERBOSE: "0"
   WAIT_FOR_BOOT_COMPLETE_TIMEOUT: "300"
 
 run:
   steps:
     - REPO_PATH=$PWD
-    - cd Runner/suites/Performance/Boot_Systemd_Validate/
-    - ./run.sh || true
-    - $REPO_PATH/Runner/utils/send-to-lava.sh Boot_Systemd_Validate.res || true
+    - cd Runner/suites/Performance/Boot_Systemd_Validate
+    - ./run.sh --out-dir "${OUT_DIR}" --required-units-file "${REQUIRED_UNITS_FILE}" --required-units "${REQUIRED_UNITS}" --timeout-per-unit "${TIMEOUT_PER_UNIT}" --svg "${SVG}" --boot-type "${BOOT_TYPE}" --disable-getty "${DISABLE_GETTY}" --disable-sshd "${DISABLE_SSHD}" --exclude-networkd-wait-online "${EXCLUDE_NETWORKD_WAIT_ONLINE}" --exclude-services "${EXCLUDE_SERVICES}" --boot-kpi-iterations "${BOOT_KPI_ITERATIONS}" --boot-goal "${BOOT_GOAL}" --boot-goal-file "${BOOT_GOAL_FILE}" --boot-goal-metric "${BOOT_GOAL_METRIC}" --boot-goal-tolerance-percent "${BOOT_GOAL_TOLERANCE_PERCENT}" --boot-goal-platform "${BOOT_GOAL_PLATFORM}" --verbose "${VERBOSE}" --wait-for-boot-complete-timeout "${WAIT_FOR_BOOT_COMPLETE_TIMEOUT}" || true
+    - $REPO_PATH/Runner/utils/send-to-lava.sh Boot_Systemd_Validate.res