plugin

type HelmfileOutputData struct {
	// Releases contains information about releases.
	Releases []ReleaseInfo
}

type HookBinding struct {
	// Event is the hook event pattern (e.g., "after.terraform.plan").
	Event string

	// Handler is the callback that owns all action logic for this event.
	Handler HookHandler
}

type HookBindings []HookBinding

type HookContext struct {
	// Event is the full hook event (e.g., "after.terraform.plan").
	Event string

	// Command is the extracted command (e.g., "plan", "apply").
	Command string

	// EventPrefix is "before" or "after".
	EventPrefix string

	// Config is the Atmos configuration.
	Config *schema.AtmosConfiguration

	// Info contains component and stack information.
	Info *schema.ConfigAndStacksInfo

	// Output is the raw command output.
	Output string

	// CommandError is the error from the command execution, if any.
	CommandError error

	// ExitCode is the exit code from the command execution. This is the
	// authoritative signal for success/failure and (for `terraform plan` with
	// -detailed-exitcode) for change detection:
	//   - apply/deploy: 0 = success; non-zero = error.
	//   - plan: 0 = no changes; 1 = error; 2 = changes detected.
	// Plugins should prefer this over text parsing of Output, which is
	// fragile against terraform/OpenTofu output drift and against errors
	// that occur before terraform itself runs (e.g., authentication failures).
	ExitCode int

	// Aggregate carries command-specific aggregate result data for hook events
	// that summarize more than one component.
	Aggregate any

	// Provider is the detected CI platform provider.
	Provider provider.Provider

	// CICtx is the CI platform context (repo, SHA, PR, etc.).
	CICtx *provider.Context

	// TemplateLoader loads and renders CI summary templates.
	TemplateLoader *templates.Loader

	// CreatePlanfileStore is a lazy factory for creating planfile stores.
	// Not all events need a store, so it's created on demand.
	// Returns an any that should be type-asserted to planfile.Store by the handler.
	CreatePlanfileStore func() (any, error)
}

type HookHandler func(ctx *HookContext) error

type MovedResource struct {
	// From is the original resource address.
	From string

	// To is the new resource address.
	To string
}

type OutputResult struct {
	// ExitCode is the command exit code.
	ExitCode int

	// HasChanges indicates if there are pending changes.
	HasChanges bool

	// HasErrors indicates if there were errors.
	HasErrors bool

	// Errors contains error messages if HasErrors is true.
	Errors []string

	// Data contains component-specific parsed data.
	// For terraform: *TerraformOutputData
	// For helmfile: *HelmfileOutputData
	Data any
}

type Plugin interface {
	// GetType returns the component type (e.g., "terraform", "helmfile").
	GetType() string

	// GetHookBindings returns all hook bindings for this plugin.
	// Each binding declares an event and a Handler callback that owns all action logic.
	GetHookBindings() []HookBinding
}

type ReleaseInfo struct {
	// Name is the release name.
	Name string

	// Namespace is the Kubernetes namespace.
	Namespace string

	// Status is the release status.
	Status string
}

type ResourceCounts struct {
	// Create is the number of resources to create.
	Create int

	// Change is the number of resources to change.
	Change int

	// Replace is the number of resources to replace.
	Replace int

	// Destroy is the number of resources to destroy.
	Destroy int
}

type TemplateContext struct {
	// Component is the component name.
	Component string

	// ComponentType is the component type (e.g., "terraform", "helmfile").
	ComponentType string

	// Stack is the stack name.
	Stack string

	// Command is the command that was executed (e.g., "plan", "apply").
	Command string

	// CI contains CI platform metadata.
	CI *provider.Context

	// Result contains parsed output data.
	Result *OutputResult

	// Output is the raw command output.
	Output string

	// Custom contains custom variables from configuration.
	Custom map[string]any
}

type TerraformOutput struct {
	// Value is the output value (string, number, bool, list, map).
	Value any

	// Type is the output type (string, number, bool, list, map, object).
	Type string

	// Sensitive indicates whether the output is marked as sensitive.
	Sensitive bool
}

type TerraformOutputData struct {
	// ResourceCounts contains resource change counts.
	ResourceCounts ResourceCounts

	// CreatedResources contains addresses of resources to be created.
	CreatedResources []string

	// UpdatedResources contains addresses of resources to be updated.
	UpdatedResources []string

	// ReplacedResources contains addresses of resources to be replaced.
	ReplacedResources []string

	// DeletedResources contains addresses of resources to be destroyed.
	DeletedResources []string

	// MovedResources contains resources that have been moved.
	MovedResources []MovedResource

	// ImportedResources contains addresses of resources to be imported.
	ImportedResources []string

	// Outputs contains terraform output values (after apply).
	Outputs map[string]TerraformOutput

	// HasOutputChanges indicates whether a plan includes output value changes.
	HasOutputChanges bool

	// ChangedResult contains the plan summary text.
	ChangedResult string

	// Warnings contains full warning block text extracted from terraform output.
	Warnings []string
}

type TerraformTestCleanupFailure struct {
	// File is the test file path.
	File string

	// Run is the run block associated with the cleanup failure.
	Run string

	// Resources contains Terraform resource instance addresses that need cleanup.
	Resources []string
}

type TerraformTestFile struct {
	// Path is the test file path.
	Path string

	// Status is the file outcome: "pass", "fail", "error", or "skip".
	Status string

	// Pass is the number of run blocks in this file that passed.
	Pass int

	// Fail is the number of run blocks in this file that failed.
	Fail int

	// Error is the number of run blocks in this file that errored.
	Error int

	// Skip is the number of run blocks in this file that were skipped.
	Skip int
}

type TerraformTestOutputData struct {
	// Total is the number of run blocks executed.
	Total int

	// Pass is the number of run blocks that passed.
	Pass int

	// Fail is the number of run blocks that failed.
	Fail int

	// Error is the number of run blocks that errored.
	Error int

	// Skip is the number of run blocks that were skipped.
	Skip int

	// Files contains per-test-file results in execution order.
	Files []TerraformTestFile

	// Runs contains the per-run results in execution order.
	Runs []TerraformTestRun

	// CleanupFailures contains resources Terraform could not destroy after tests.
	CleanupFailures []TerraformTestCleanupFailure

	// BackfillTruncated indicates a test_summary count for some status exceeded the parser's
	// synthetic-placeholder-row cap, so the backfilled Runs (and therefore Total/JUnit/the
	// results table) are known to be incomplete for that status.
	BackfillTruncated bool
}

type TerraformTestRun struct {
	// Name is the run block name (the identifier in `run "<name>" { ... }`).
	Name string

	// File is the .tftest.hcl file the run belongs to (the JUnit testsuite).
	File string

	// Status is the run outcome: "pass", "fail", "error", or "skip".
	Status string

	// Error contains failure detail when Status is "fail"/"error" (best-effort; may be empty).
	Error string

	// Line is the 1-based source line of the failing assertion (0 = unknown).
	// Populated from `terraform test -json` diagnostic ranges.
	Line int

	// Duration is the run's wall-clock time in seconds (0 = unknown).
	Duration float64
}