feat: add preflight validation step for workflow inputs in end-to-end testing

Author: ChristophShyper

.github/workflows/e2e-action-commit-push.yml

@@ -33,8 +33,8 @@ permissions:
   contents: write
 
 jobs:
-  basic-commit:
-    name: Basic commit and push to new branch
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -47,6 +47,11 @@ jobs:
               ;;
           esac
 
+  basic-commit:
+    name: Basic commit and push to new branch
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
         with:
@@ -88,6 +93,7 @@ jobs:
 
   commit-with-prefix-message:
     name: Commit with custom prefix and message
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -132,6 +138,7 @@ jobs:
 
   allow-empty-commit:
     name: Allow empty commit with no file changes
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -171,6 +178,7 @@ jobs:
 
   commit-with-timestamp-branch:
     name: Commit to timestamped branch name
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -218,6 +226,7 @@ jobs:
 
   commit-with-repository-path:
     name: Commit from custom repository_path
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository into custom path
@@ -264,6 +273,7 @@ jobs:
 
   reset-target-branch-to-base:
     name: Reset target branch to base branch
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -331,6 +341,7 @@ jobs:
 
   rebase-conflict-fails-when-strict:
     name: Rebase conflict fails when fail_on_rebase_conflict=true
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -398,6 +409,7 @@ jobs:
 
   amend-commit:
     name: Amend previous commit with force-with-lease
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository

.github/workflows/e2e-action-container-structure-test.yml

@@ -33,8 +33,8 @@ permissions:
   contents: read
 
 jobs:
-  text-output:
-    name: Basic test with text output format
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -47,6 +47,11 @@ jobs:
               ;;
           esac
 
+  text-output:
+    name: Basic test with text output format
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
 
@@ -84,6 +89,7 @@ jobs:
 
   json-output:
     name: Test with JSON output format
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -121,6 +127,7 @@ jobs:
 
   junit-output:
     name: Test with JUnit output format and suite name
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -159,6 +166,7 @@ jobs:
 
   test-report-file:
     name: Test with report written to file
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -201,6 +209,7 @@ jobs:
 
   multiple-config-files:
     name: Test with multiple config files
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -242,6 +251,7 @@ jobs:
 
   metadata-platform-runtime:
     name: Test with metadata, platform, and runtime inputs
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository

.github/workflows/e2e-action-format-hcl.yml

@@ -33,8 +33,8 @@ permissions:
   contents: read
 
 jobs:
-  format-check-clean-files:
-    name: Check mode on already-formatted files passes
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -47,6 +47,11 @@ jobs:
               ;;
           esac
 
+  format-check-clean-files:
+    name: Check mode on already-formatted files passes
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
 
@@ -100,6 +105,7 @@ jobs:
 
   format-write-mode:
     name: Write mode formats and rewrites files
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -160,6 +166,7 @@ jobs:
 
   format-check-malformed-files:
     name: Check mode on malformed files reports failure
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -206,6 +213,7 @@ jobs:
 
   format-list-with-diff:
     name: List and diff mode on formatted files
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository

.github/workflows/e2e-action-pull-request.yml

@@ -35,8 +35,8 @@ permissions:
   issues: write
 
 jobs:
-  basic-pull-request:
-    name: Basic pull request creation
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -49,6 +49,11 @@ jobs:
               ;;
           esac
 
+  basic-pull-request:
+    name: Basic pull request creation
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
         with:
@@ -106,6 +111,7 @@ jobs:
 
   pull-request-with-title-body:
     name: Pull request with custom title and body
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -169,6 +175,7 @@ jobs:
 
   pull-request-with-repository-path:
     name: Pull request using custom checkout path and explicit repository
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository into custom path
@@ -233,6 +240,7 @@ jobs:
 
   pull-request-draft-with-diff:
     name: Draft pull request with get_diff enabled
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository

.github/workflows/e2e-action-template-action.yml

@@ -33,8 +33,8 @@ permissions:
   contents: read
 
 jobs:
-  template-action-input-output:
-    name: Validate template-action input/output contract
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -47,6 +47,11 @@ jobs:
               ;;
           esac
 
+  template-action-input-output:
+    name: Validate template-action input/output contract
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Run template action in ref mode
         if: ${{ inputs.mode == 'ref' }}
         id: action
@@ -73,6 +78,7 @@ jobs:
 
   template-action-debug:
     name: Validate template-action debug mode
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Run template action with debug enabled

.github/workflows/e2e-action-terraform-copy-vars.yml

@@ -33,8 +33,8 @@ permissions:
   contents: read
 
 jobs:
-  basic-copy-vars:
-    name: Copy variables from central file to modules
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -47,6 +47,11 @@ jobs:
               ;;
           esac
 
+  basic-copy-vars:
+    name: Copy variables from central file to modules
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
 
@@ -127,6 +132,7 @@ jobs:
 
   copy-vars-custom-paths:
     name: Copy variables with custom directory and file paths
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -202,6 +208,7 @@ jobs:
 
   copy-vars-fail-on-missing:
     name: Fail when module uses variable missing from central file
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository

.github/workflows/e2e-action-terraform-validate.yml

@@ -33,8 +33,8 @@ permissions:
   contents: read
 
 jobs:
-  validate-basic:
-    name: Validate valid Terraform configuration
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -47,6 +47,11 @@ jobs:
               ;;
           esac
 
+  validate-basic:
+    name: Validate valid Terraform configuration
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
 
@@ -98,6 +103,7 @@ jobs:
 
   validate-with-dir-filter:
     name: Validate with explicit directory filter
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository

.github/workflows/e2e-action-tflint.yml

@@ -33,8 +33,8 @@ permissions:
   contents: read
 
 jobs:
-  basic-tflint:
-    name: Basic TFLint on valid Terraform files
+  preflight:
+    name: Validate workflow inputs
     runs-on: ubuntu-latest
     steps:
       - name: Validate mode input
@@ -47,6 +47,11 @@ jobs:
               ;;
           esac
 
+  basic-tflint:
+    name: Basic TFLint on valid Terraform files
+    needs: [preflight]
+    runs-on: ubuntu-latest
+    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
 
@@ -96,6 +101,7 @@ jobs:
 
   tflint-with-dir-filter:
     name: TFLint with specific directory filter
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -156,6 +162,7 @@ jobs:
 
   tflint-no-fail-on-changes:
     name: TFLint with fail_on_changes disabled
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -205,6 +212,7 @@ jobs:
 
   tflint-with-custom-config:
     name: TFLint with explicit tflint_config
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -264,6 +272,7 @@ jobs:
 
   tflint-with-custom-params:
     name: TFLint with custom tflint_params
+    needs: [preflight]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository