simulate

type Action interface {
	// Name is a short identifier for the action (for example "promote").
	Name() string

	// Describe returns a one-line human-readable summary of the action.
	Describe() string

	// Apply replays the action against the clone manifest and returns the
	// effects plus the after-state path.
	Apply(ctx ActionContext) (*ActionOutcome, error)
}

type ActionContext struct {
	// ClonePath is the path to the temp clone of the manifest the action may
	// mutate. The real promoter writes its transitions here.
	ClonePath string

	// Actor is the identity that performs the hypothetical action.
	Actor string
}

type ActionOutcome struct {
	// Effects is the ordered list of steps the orchestration would take.
	Effects []Effect

	// AfterStatePath is the manifest path holding the after-state.
	AfterStatePath string
}

type DeployDiff struct {
	Name    string      `json:"name"`
	SHA     FieldChange `json:"sha"`
	Version FieldChange `json:"version"`
}

type Disposition string

type Effect struct {
	Disposition Disposition `json:"disposition"`
	Action      string      `json:"action"`
	Target      string      `json:"target"`
	Detail      string      `json:"detail"`
}

type Engine struct {
	// contains filtered or unexported fields
}

type EnvDiff struct {
	Environment  string       `json:"environment"`
	Version      FieldChange  `json:"version"`
	SHA          FieldChange  `json:"sha"`
	Divergence   FieldChange  `json:"divergence"`
	PreviousRing FieldChange  `json:"previous_ring"`
	Deploys      []DeployDiff `json:"deploys,omitempty"`
}

type FieldChange struct {
	Field   string `json:"field"`
	From    string `json:"from"`
	To      string `json:"to"`
	Changed bool   `json:"changed"`
}

type Option func(*Engine)

type PromoteAction struct {
	// contains filtered or unexported fields
}

type Result struct {
	// ActionName is the short identifier of the simulated action.
	ActionName string `json:"action"`

	// ActionDescribe is the one-line human-readable summary of the action.
	ActionDescribe string `json:"describe"`

	// Diff is the before and after state difference.
	Diff StateDiff `json:"diff"`

	// Effects is the ordered list of orchestration steps.
	Effects []Effect `json:"effects"`
}

type StateDiff struct {
	// Envs holds the per-environment diffs in sorted-key order.
	Envs []EnvDiff `json:"envs"`
}