conformance

type Config struct {
	// Provider returns a fresh interfaces.IaCProvider for each scenario.
	// Required.
	Provider func() interfaces.IaCProvider

	// SkipScenarios maps scenario name → reason. The dispatcher emits a
	// t.Skipf-flagged subtest for each entry instead of executing the
	// body, preserving CI visibility into intentional skips.
	SkipScenarios map[string]string

	// SmokeOnly limits the run to scenarios with Smoke=true. Used by the
	// per-PR smoke gate.
	SmokeOnly bool

	// LiveCloud opts in to scenarios that provision real cloud resources
	// (RequiresCloud=true). Default false keeps test-suites hermetic.
	LiveCloud bool
}

type Scenario struct {
	// Name is the t.Run subtest name and the SkipScenarios map key.
	// Convention: "Scenario_<CamelCaseDescription>".
	Name string

	// Smoke marks scenarios that the per-PR smoke gate runs against an
	// active provider's real cloud. Non-smoke scenarios run only when a
	// caller opts in (e.g. nightly full-suite).
	Smoke bool

	// RequiresCloud marks scenarios that touch real cloud APIs. The
	// dispatcher skips these unless Config.LiveCloud is true.
	RequiresCloud bool

	// Run is the scenario body. It receives the live *testing.T (a
	// subtest) and the caller's Config so it can obtain a fresh provider
	// via cfg.Provider().
	Run func(t *testing.T, cfg Config)
}