config

type BumpType uint8

type Config struct {
	// Required GitHub Actions context.
	Token     string
	OwnerRepo string // "<owner>/<repo>"
	Actor     string
	Branch    string

	// Optional manual override.
	ManualVersion string
	Reason        string

	// Discovery / classification settings.
	ExcludeDirs []string
	CustomTypes map[string]BumpType // canonical lowercase heading -> bump

	// Operational flags.
	DryRun   bool // do not commit, push, tag, or publish
	Debug    bool // verbose tag/discovery diagnostics
	RepoRoot string

	// SummaryFile, if non-empty, receives a JSON summary of the run.
	SummaryFile string

	// SelfReleaseModule and SelfReleaseRepo together identify the
	// "releasegen releasing itself" case: when the module with this name is
	// released inside SelfReleaseRepo, the resulting version is printed to
	// stdout for downstream workflow steps to consume. SelfReleaseModule is
	// the module's directory path relative to the repo root; an empty value
	// means the root module (releasegen lives at the repository root). The
	// feature is active whenever SelfReleaseRepo is non-empty and matches
	// the repository being released; set SelfReleaseRepo to "" to disable.
	SelfReleaseModule string
	SelfReleaseRepo   string

	// RequireChangelogEntry, when true, makes `releasegen validate` enforce
	// that any module whose non-CHANGELOG files changed (vs BaseRef) also
	// gained new content under its `## [Unreleased]` section. This folds
	// the historical "ensure_changelog" pre-merge guard into releasegen so
	// developers can't merge code without a changelog entry. Default false
	// so the syntactic validation can be adopted independently.
	RequireChangelogEntry bool

	// BaseRef is the git revision the changelog-entry check diffs against.
	// Any revspec go-git can resolve is accepted (branch, tag, remote
	// tracking ref like "origin/main", raw hash). Empty falls back to
	// "origin/$GITHUB_BASE_REF" when running under GitHub Actions PR
	// events, else "origin/main".
	BaseRef string
}

type FileConfig struct {
	// CustomChangeTypes maps additional changelog headings to a bump level
	// ("major", "minor", or "patch"). Headings are case-insensitive.
	CustomChangeTypes map[string]string `yaml:"custom_change_types"`

	// ExcludeDirs lists directory prefixes to skip during changelog
	// discovery. Trailing slashes are optional.
	ExcludeDirs []string `yaml:"exclude_dirs"`

	// SelfReleaseModule is the module path (relative to the repo root)
	// that should be treated as "releasegen releasing itself" so that the
	// resolved version is printed to stdout. Empty means the root module.
	SelfReleaseModule *string `yaml:"self_release_module"`

	// SelfReleaseRepo is the "owner/repo" string the self-release feature
	// matches against. Empty disables the feature.
	SelfReleaseRepo *string `yaml:"self_release_repo"`

	// Validate carries options specific to the `releasegen validate`
	// subcommand. Kept as a nested block so the command can grow more
	// knobs without polluting the top-level namespace.
	Validate *ValidateFileConfig `yaml:"validate"`
}

type ValidateFileConfig struct {
	// RequireChangelogEntry, when true, makes `validate` enforce that any
	// module whose non-CHANGELOG files changed (vs BaseRef) also gained
	// new content under its `## [Unreleased]` section.
	RequireChangelogEntry *bool `yaml:"require_changelog_entry"`

	// BaseRef overrides the git revision the changelog-entry check diffs
	// against. Falls back to the env-aware default in DefaultBaseRef when
	// neither this nor the flag/env is set.
	BaseRef *string `yaml:"base_ref"`
}