hotfix

type EnvPlan struct {
	Env     string `json:"env"`
	Branch  string `json:"branch"`
	BaseSHA string `json:"base_sha"`

	// Commits are the fix SHAs still to cherry-pick into this environment, in
	// the caller's requested ref order, after skipping commits already present.
	Commits []string `json:"commits"`

	// NoOp is true when the whole requested set is already present in this env.
	NoOp bool `json:"no_op"`

	// BranchReset is true when the remote env/<env> branch existed at a stale tip
	// but was force-reset back to BaseSHA by the orphan self-heal. It is set only
	// when the env is not diverged and the single-flight gate ran with a real
	// checker that found no open resolution PR.
	BranchReset bool `json:"branch_reset"`

	// ConflictExpected hints whether a cherry-pick is likely to conflict. The
	// plan verb does not run the cherry-pick, so this is best-effort and false
	// by default; the workflow is authoritative.
	ConflictExpected bool `json:"conflict_expected"`
}

type FinalizeOption func(*Finalizer)

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

type FinalizerOptions struct {
	ConfigPath  string
	ManifestKey string
	Actor       string
}

type OpenPR struct {
	Number int    `json:"number"`
	URL    string `json:"url"`
}

type Option func(*Planner)

type PRChecker interface {
	// OpenHotfixPRs returns open PRs labeled cascade-hotfix whose base is baseBranch.
	OpenHotfixPRs(baseBranch string) ([]OpenPR, error)
}

type PlanChainResult struct {
	// Envs are the per-environment plans in bottom-up chain order (the first
	// environment is excluded; the target environment is the last entry).
	Envs []EnvPlan `json:"envs"`
}

type PlanResult struct {
	TargetEnv string `json:"target_env"`
	FixSHA    string `json:"fix_sha"`
	Branch    string `json:"branch"`
	BaseSHA   string `json:"base_sha"`

	// NoOp is true when the fix is already contained in the target state SHA.
	NoOp bool `json:"no_op"`

	// BranchCreated is true when env/<target> was (or, in dry-run, would be)
	// created at BaseSHA. False when it already existed at the expected tip.
	BranchCreated bool `json:"branch_created"`

	// BranchReset is true when env/<target> existed at a stale tip but was (or, in
	// dry-run, would be) force-reset back to BaseSHA by the orphan self-heal. It is
	// set only when the env is not diverged and the single-flight gate ran with a
	// real checker that found no open resolution PR.
	BranchReset bool `json:"branch_reset"`

	// HotfixVersionCandidate is the next free hotfix version over the target
	// env's current version base (e.g. v1.0.0-rc.1 -> v1.0.0-rc.1.hotfix.1).
	HotfixVersionCandidate string `json:"hotfix_version_candidate"`

	// ConflictExpected hints whether the cherry-pick is likely to conflict.
	// The plan verb does not run the cherry-pick, so this is best-effort and
	// false by default; the workflow is authoritative.
	ConflictExpected bool `json:"conflict_expected"`

	// ProtectionSuggestions are ready-to-run gh/gh api commands an operator can
	// paste to establish env/* branch protection. cascade never applies these.
	ProtectionSuggestions []string `json:"protection_suggestions"`

	DryRun bool `json:"dry_run"`
}

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

type PlannerOptions struct {
	ConfigPath  string
	ManifestKey string
	Actor       string
}