testing

type IntegrationTestSuite struct {
	// ScenariosDir is the root directory of test scenarios.
	ScenariosDir string
	// OutputDir is the temporary workspace for a test run.
	OutputDir string
}

type PlanConfig struct {
	// FreshInstall selects an empty previous manifest instead of resolving
	// one from before.yaml or previous.yaml, for the fresh-install case
	// where neither file is expected to exist.
	FreshInstall bool `yaml:"freshInstall"`
	// Changes lists every expected change, in the exact order
	// [plan.ComputeDiff] returns them (sorted by Kind, then Name).
	Changes []PlanConfigChange `yaml:"changes"`
	// Summary is the expected change tally.
	Summary PlanConfigSummary `yaml:"summary"`
	// HooksChanged asserts [plan.Plan.HooksChanged]. Always false in this
	// scenario suite today: the embedded chart defines no hooks, so this
	// only documents the plumbing for when one is added.
	HooksChanged bool `yaml:"hooksChanged"`
	// Masked lists field paths (as they appear in a Changes[].Fields[]
	// entry's Path) that [plan.ApplyMasking] must flag as masked. Every
	// masked path [RunPlanScenarioTest] finds in the computed plan must
	// appear here, and vice versa.
	Masked []string `yaml:"masked"`
	// Warning is documentary only: this offline harness has no live/faked
	// release store to compute a real warning from ([plan.LastSuccessfulRelease]
	// is covered separately in history_test.go), so the test runner just
	// sets Header.Warning to this value before checking it.
	Warning string `yaml:"warning"`
}

type PlanConfigChange struct {
	Action string            `yaml:"action"`
	Kind   string            `yaml:"kind"`
	Name   string            `yaml:"name"`
	Fields []PlanConfigField `yaml:"fields"`
}

type PlanConfigField struct {
	Path string `yaml:"path"`
	Old  string `yaml:"old"`
	New  string `yaml:"new"`
}

type PlanConfigSummary struct {
	Add     int `yaml:"add"`
	Change  int `yaml:"change"`
	Destroy int `yaml:"destroy"`
}

type PlanTestScenario struct {
	// Name is the scenario directory name (e.g. "plan-image-bump").
	Name string
	// Dir is the scenario's absolute directory path.
	Dir string
}

type TestScenario struct {
	// Name is the scenario directory name.
	Name string
	// ScenarioDir is the relative path under TestScenariosDir.
	ScenarioDir string
	// ManifestFile is the manifest filename within ScenarioDir.
	ManifestFile string
	// Environment selects the manifest environment for chart generation.
	Environment string
	// EnvFiles lists dotenv files to copy into the test workspace.
	EnvFiles []string
	// PlatformFile is the platform filename within ScenarioDir when present.
	PlatformFile string
	// ExpectedDir is the golden output directory, relative to TestScenariosDir.
	ExpectedDir string
	// ExpectError requires manifest loading or resolution to fail.
	ExpectError bool
	// ExpectedErrors requires specific substrings in the load/resolve error message.
	ExpectedErrors []string
}