engine

type FS interface {
	ReadFile(path string) ([]byte, error)
	WriteFile(path string, data []byte, perm fs.FileMode) error
}

type MergedPRGatherer interface {
	GatherMergedPRs(ctx context.Context, owner, repo, compareRange string) ([]section.MergedPR, []string, error)
}

type Options struct {
	Mode          string
	TargetVersion string
	Owner         string
	Repo          string
	ChangelogPath string
	Now           func() time.Time
	FS            FS
	Git           semver.Execer
	Gather        MergedPRGatherer
}

type Result struct {
	TargetVersionOutput    string // empty when not release (matches JS target_version output)
	PreviousTag            string
	CompareRange           string
	TargetBranch           string // resolved canonical branch prior to TARGET_BRANCH override
	SectionHeader          string
	HasPRs                 bool
	HasUserFacingChanges   bool
	Included               []section.IncludedPR
	Excluded               []section.ExcludedPR
	SkippedChangelogUpdate bool
	Warnings               []string
}