model

type Action struct {
	Resource Resource
	Phase    Phase
	// Op describes the change in the words a person would use, because it is
	// printed in the confirmation prompt and read under pressure.
	Op string
	// Warning is printed in red and requires acknowledgement. Empty for the
	// ordinary case.
	Warning string
}

type BlastRadius struct {
	Total     int
	ByKind    map[Kind]int
	TouchesDB bool
	DataLoss  bool // an instance-store instance is in the plan

	// SavingsUSD is the hourly total across resources that have an estimate.
	SavingsUSD float64
	// SavingsByKind breaks that down, so a plan dominated by one kind is
	// visible rather than hidden inside a single number.
	SavingsByKind map[Kind]float64
	// UnpricedByKind counts resources with no defensible estimate. Reported
	// separately and never as zero: a zero saving is a claim that stopping the
	// thing is free, which is a different statement from not knowing.
	UnpricedByKind map[Kind]int
}

type Entry struct {
	Kind   Kind           `json:"kind"`
	ID     string         `json:"id"`
	ARN    string         `json:"arn,omitempty"`
	Name   string         `json:"name,omitempty"`
	Region string         `json:"region"`
	Phase  Phase          `json:"phase"`
	Prior  map[string]any `json:"prior"`
	// Result records what actually happened, so a partial fire can be restored
	// without re-running against resources that were never changed.
	Result string `json:"result,omitempty"`
	Error  string `json:"error,omitempty"`
}

type Kind string

type Phase int

type Plan struct {
	ID        string
	CreatedAt time.Time
	Account   string
	Regions   []string
	Actions   []Action
	Refusals  []Refusal
	// AckRequired lists warnings that must be acknowledged before firing.
	AckRequired []string
}

type Refusal struct {
	Resource Resource
	Reason   string
}

type Resource struct {
	ID     string
	ARN    string
	Kind   Kind
	Name   string
	Region string
	Tags   map[string]string

	// Prior is the state that must be restored, captured at discovery. Kept as
	// a map so a new resource kind does not need a new struct threaded through
	// the state file, and so an unrecognised field survives a version change
	// rather than being silently dropped on restore.
	Prior map[string]any

	// HasInstanceStore marks an instance whose local NVMe is erased by a stop.
	// EBS survives; instance store does not, and the API gives no warning.
	HasInstanceStore bool

	// EstimatedHourlyUSD is what stopping it saves, where it can be known
	// cheaply. Zero means unknown, not free.
	EstimatedHourlyUSD float64
}

type Snapshot struct {
	PlanID    string     `json:"plan_id"`
	CreatedAt time.Time  `json:"created_at"`
	Account   string     `json:"account"`
	Regions   []string   `json:"regions"`
	Entries   []Entry    `json:"entries"`
	Fired     *time.Time `json:"fired_at,omitempty"`
	Restored  *time.Time `json:"restored_at,omitempty"`
}