feat(runner): add patch execution system with comprehensive test suite

runner/helpers/execute_patches.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+###############################################################################
+# Copyright (c) 2025, Advanced Micro Devices, Inc. All rights reserved.
+#
+# See LICENSE for license information.
+###############################################################################
+#
+# Execute patch scripts
+# Usage: execute_patches <patch_script1> [patch_script2] ...
+#
+# Exit codes from patch scripts:
+#   0   - Success, continue to next patch
+#   2   - Skip this patch (not an error)
+#   other - Failure, stop execution
+#
+# Example patch script with conditional skip:
+#   #!/bin/bash
+#   # Check if patch is needed
+#   if [[ -f /tmp/already_patched ]]; then
+#       echo "Patch already applied, skipping"
+#       exit 2  # Skip this patch
+#   fi
+#
+#   # Apply patch
+#   echo "Applying patch..."
+#   # ... patch logic ...
+#   exit 0  # Success
+#
+
+# Requires common.sh to be sourced
+if [[ -z "${__PRIMUS_COMMON_SOURCED:-}" ]]; then
+    # Fallback logging if common.sh not loaded
+    LOG_INFO_RANK0() {
+        if [ "${NODE_RANK:-0}" -eq 0 ]; then
+            echo "[INFO] $*" >&2
+        fi
+    }
+    LOG_ERROR_RANK0() {
+        if [ "${NODE_RANK:-0}" -eq 0 ]; then
+            echo "[ERROR] $*" >&2
+        fi
+    }
+    LOG_SUCCESS_RANK0() {
+        if [ "${NODE_RANK:-0}" -eq 0 ]; then
+            echo "[SUCCESS] $*"
+        fi
+    }
+fi
+
+# Execute multiple patch scripts
+# Args:
+#   $@: Patch script paths
+execute_patches() {
+    if [[ $# -eq 0 ]]; then
+        LOG_INFO_RANK0 "[Execute Patches] No patch scripts specified"
+        return 0
+    fi
+
+    local patch_scripts=("$@")
+
+    LOG_INFO_RANK0 "[Execute Patches] Detected patch scripts: ${patch_scripts[*]}"
+
+    for patch in "${patch_scripts[@]}"; do
+        if [[ ! -f "$patch" ]]; then
+            LOG_ERROR_RANK0 "[Execute Patches] Patch script not found: $patch"
+            return 1
+        fi
+
+        if [[ ! -r "$patch" ]]; then
+            LOG_ERROR_RANK0 "[Execute Patches] Patch script not readable: $patch"
+            return 1
+        fi
+
+        LOG_INFO_RANK0 "[Execute Patches] Running patch: bash $patch"
+
+        bash "$patch"
+        local exit_code=$?
+
+        if [[ $exit_code -eq 0 ]]; then
+            LOG_INFO_RANK0 "[Execute Patches] Patch completed successfully: $patch"
+        elif [[ $exit_code -eq 2 ]]; then
+            LOG_INFO_RANK0 "[Execute Patches] Patch skipped (exit code 2): $patch"
+        else
+            LOG_ERROR_RANK0 "[Execute Patches] Patch script failed: $patch (exit code: $exit_code)"
+            return 1
+        fi
+    done
+
+    LOG_SUCCESS_RANK0 "[Execute Patches] All patch scripts executed successfully"
+    return 0
+}
+
+# If called directly (not sourced), execute the function
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    # Always source common.sh when called directly, as functions are not inherited by subshells
+    # Unset the guard variable to force re-sourcing in this new shell instance
+    unset __PRIMUS_COMMON_SOURCED
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    # shellcheck disable=SC1091
+    source "$SCRIPT_DIR/../lib/common.sh" || {
+        echo "[ERROR] Failed to load common library" >&2
+        exit 1
+    }
+    execute_patches "$@"
+fi

runner/lib/common.sh

@@ -142,6 +142,12 @@ LOG_SUCCESS_RANK0() {
     fi
 }
 
+LOG_ERROR_RANK0() {
+    if [[ "${NODE_RANK:-0}" == "0" ]]; then
+        LOG_ERROR "$@"
+    fi
+}
+
 # ---------------------------------------------------------------------------
 # Simple Print Functions (without timestamps and prefixes)
 # ---------------------------------------------------------------------------