flowpactworkflow contracts
Rules

FP403 · dynamic-matrix-unverified

The matrix is computed at runtime, so flowpact cannot check that every combination defines the keys it reads.

CodeNameCategoryDefault severity
FP403dynamic-matrix-unverifiedMatrix🔵 info

Why it matters

Dynamic matrices (fromJSON(...)) hide the same empty-value failure mode as static ones, but no tool can see it.

How to fix

Declare the keys in the config (matrixShapes: \{ "\<workflow\>#\<job\>": \{ keys: [os, config] \} \}) so flowpact can verify reads, prefer a static matrix, or validate the generated JSON in the job that produces it.

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:
  FP403: off
  # or: dynamic-matrix-unverified: error

Explain it in the terminal:

flowpact explain FP403

On this page