flowpactworkflow contracts
Rules

FP101 · missing-required-input

A reusable workflow or local action is called without one of its required inputs.

CodeNameCategoryDefault severity
FP101missing-required-inputInputs🔴 error

Why it matters

For reusable workflows GitHub fails the run when a required input is missing — even if the input also has a default, which is then never used. For composite actions required is not enforced at all: the step silently runs with an empty string (or the default), which is how test variants get skipped unnoticed.

How to fix

Pass the input under with:, or mark it required: false with a default if it is truly optional.

Example

jobs:
  test:
    uses: ./.github/workflows/test.yml
    with:
      suite: unit
      # "config" is required by test.yml but not passed

Configure

Change the severity (or turn the rule off) in .github/flowpact/flowpact.config.yml, by code or by name:

.github/flowpact/flowpact.config.yml
rules:
  FP101: off
  # or: missing-required-input: error

Explain it in the terminal:

flowpact explain FP101

On this page