config

type AuditLogConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `yaml:"enabled"`

	// Path is the path to the audit log file.
	Path string `yaml:"path,omitempty"`

	// Format specifies the output format: json or yaml.
	Format string `yaml:"format,omitempty"`

	// IncludeAuthor includes git author in log entries.
	IncludeAuthor bool `yaml:"include-author,omitempty"`

	// IncludeTimestamp includes ISO 8601 timestamp in log entries.
	IncludeTimestamp bool `yaml:"include-timestamp,omitempty"`

	// IncludeCommitSHA includes current commit SHA in log entries.
	IncludeCommitSHA bool `yaml:"include-commit-sha,omitempty"`

	// IncludeBranch includes current branch name in log entries.
	IncludeBranch bool `yaml:"include-branch,omitempty"`
}

type ChangelogGeneratorConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `yaml:"enabled"`

	// Mode determines output style: "versioned", "unified", or "both".
	// "versioned" writes each version to a separate file (e.g., .changes/v1.2.3.md)
	// "unified" writes to a single CHANGELOG.md file
	// "both" writes to both locations
	Mode string `yaml:"mode,omitempty"`

	// Format determines the changelog format: "grouped" or "keepachangelog".
	// "grouped" (default): Custom group labels with commit type grouping
	// "keepachangelog": Keep a Changelog specification format with standard sections
	Format string `yaml:"format,omitempty"`

	// ChangesDir is the directory for version-specific changelog files (versioned mode).
	ChangesDir string `yaml:"changes-dir,omitempty"`

	// ChangelogPath is the path to the unified changelog file.
	ChangelogPath string `yaml:"changelog-path,omitempty"`

	// HeaderTemplate is the path to a custom header template file.
	HeaderTemplate string `yaml:"header-template,omitempty"`

	// Repository contains git repository settings for link generation.
	// Supports GitHub, GitLab, Codeberg, Gitea, Bitbucket, and custom hosts.
	Repository *RepositoryConfig `yaml:"repository,omitempty"`

	// Groups defines commit grouping rules.
	Groups []CommitGroupConfig `yaml:"groups,omitempty"`

	// ExcludePatterns lists regex patterns for commits to exclude.
	ExcludePatterns []string `yaml:"exclude-patterns,omitempty"`

	// IncludeNonConventional includes commits that don't follow conventional commit format
	// in an "Other Changes" section. When false (default), these commits are skipped
	// and a warning is printed listing the skipped commits.
	IncludeNonConventional bool `yaml:"include-non-conventional,omitempty"`

	// UseDefaultIcons enables predefined icons for all commit groups and contributors.
	// When true, default icons (emojis) are automatically applied to commit group headers
	// and the contributors section. User-defined GroupIcons or Contributors.Icon values
	// will override the defaults for specific entries. This is a convenient shorthand
	// instead of manually specifying all icons via group-icons.
	UseDefaultIcons bool `yaml:"use-default-icons,omitempty"`

	// GroupIcons maps default group labels to icons. Use this to add icons to default
	// groups without redefining patterns and labels. Ignored if Groups is specified.
	// Keys must match default labels: Enhancements, Fixes, Refactors, Documentation,
	// Performance, Styling, Tests, Chores, CI, Build, Reverts.
	GroupIcons map[string]string `yaml:"group-icons,omitempty"`

	// BreakingChangesIcon is the icon/emoji for the breaking changes section header.
	// Used by formatters with a dedicated breaking changes section (e.g., GitHub format).
	// When UseDefaultIcons is true and this is empty, the default icon is used.
	BreakingChangesIcon string `yaml:"breaking-changes-icon,omitempty"`

	// Contributors configures the contributors section.
	Contributors *ContributorsConfig `yaml:"contributors,omitempty"`

	// MergeAfter controls when versioned changelog files are merged into the unified changelog.
	// Values:
	// - "immediate" (merge right after generation)
	// - "manual" (no auto-merge, default)
	// - "prompt" (interactive confirmation, auto-skips in CI/non-interactive environments).
	MergeAfter string `yaml:"merge-after,omitempty"`
}

type ChangelogParserConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `yaml:"enabled"`

	// Path is the path to the changelog file (default: "CHANGELOG.md").
	Path string `yaml:"path,omitempty"`

	// RequireUnreleasedSection enforces presence of Unreleased section.
	RequireUnreleasedSection bool `yaml:"require-unreleased-section,omitempty"`

	// InferBumpType enables automatic bump type inference from changelog.
	InferBumpType bool `yaml:"infer-bump-type,omitempty"`

	// Priority determines which parser takes precedence: "changelog" or "commits"
	Priority string `yaml:"priority,omitempty"`

	// Format specifies the changelog format: keepachangelog, grouped, github, minimal, auto.
	// Default: keepachangelog (for backward compatibility).
	Format string `yaml:"format,omitempty"`

	// GroupedSectionMap provides custom section-to-category mapping for grouped format.
	// Keys are section names as they appear in the changelog (e.g., "Features", "Bug Fixes").
	// Values are semantic categories (Added, Changed, Fixed, Removed, Deprecated, Security).
	GroupedSectionMap map[string]string `yaml:"grouped-section-map,omitempty"`
}

type CommitGroupConfig struct {
	// Pattern is the regex pattern to match commit types.
	Pattern string `yaml:"pattern"`

	// Label is the section header label.
	Label string `yaml:"label"`

	// Icon is the icon/emoji for the section (optional).
	Icon string `yaml:"icon,omitempty"`

	// Order determines the display order (lower = higher priority).
	Order int `yaml:"order,omitempty"`
}

type Config struct {
	Path            string                            `yaml:"path"`
	Plugins         *PluginConfig                     `yaml:"plugins,omitempty"`
	Extensions      []ExtensionConfig                 `yaml:"extensions,omitempty"`
	PreReleaseHooks []map[string]PreReleaseHookConfig `yaml:"pre-release-hooks,omitempty"`
	Workspace       *WorkspaceConfig                  `yaml:"workspace,omitempty"`
}

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

type ContributorsConfig struct {
	// Enabled controls whether to include contributors section.
	Enabled bool `yaml:"enabled,omitempty"`

	// Format is a Go template for contributor formatting.
	Format string `yaml:"format,omitempty"`

	// Icon is the icon/emoji for the contributors section header (optional).
	Icon string `yaml:"icon,omitempty"`

	// ShowNewContributors enables the "New Contributors" section showing first-time contributors.
	// Default: true when contributors are enabled.
	ShowNewContributors *bool `yaml:"show-new-contributors,omitempty"`

	// NewContributorsFormat is a Go template for new contributor entries.
	// Available fields: {{.Name}}, {{.Username}}, {{.Host}}, {{.PRNumber}}, {{.CommitHash}}
	// Default: "* [@{{.Username}}](https://{{.Host}}/{{.Username}}) made their first contribution in [#{{.PRNumber}}](...)"
	NewContributorsFormat string `yaml:"new-contributors-format,omitempty"`

	// NewContributorsIcon is the icon for the "New Contributors" section header.
	NewContributorsIcon string `yaml:"new-contributors-icon,omitempty"`
}

type DependencyCheckConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `yaml:"enabled"`

	// AutoSync automatically syncs versions after bumps.
	AutoSync bool `yaml:"auto-sync,omitempty"`

	// Files lists the files to check and sync.
	Files []DependencyFileConfig `yaml:"files,omitempty"`
}

type DependencyFileConfig struct {
	// Path is the file path relative to repository root.
	Path string `yaml:"path"`

	// Field is the dot-notation path to the version field (for JSON/YAML/TOML).
	Field string `yaml:"field,omitempty"`

	// Format specifies the file format: json, yaml, toml, raw, regex
	Format string `yaml:"format"`

	// Pattern is the regex pattern for "regex" format.
	Pattern string `yaml:"pattern,omitempty"`
}

type DiscoveryConfig struct {
	// Enabled controls whether auto-discovery is active (default: true).
	Enabled *bool `yaml:"enabled,omitempty"`

	// Recursive enables searching subdirectories (default: true).
	Recursive *bool `yaml:"recursive,omitempty"`

	// ModuleMaxDepth limits directory traversal depth for module discovery (default: 10).
	ModuleMaxDepth *int `yaml:"module_max_depth,omitempty"`

	// ManifestMaxDepth limits directory traversal depth for manifest discovery (default: 3).
	// This is separate from ModuleMaxDepth to allow different depths for modules vs manifests.
	ManifestMaxDepth *int `yaml:"manifest_max_depth,omitempty"`

	// Exclude lists paths/patterns to skip during discovery.
	Exclude []string `yaml:"exclude,omitempty"`
}

type ExtensionConfig struct {
	Name    string         `yaml:"name"`
	Path    string         `yaml:"path"`
	Enabled bool           `yaml:"enabled"`
	Config  map[string]any `yaml:"config,omitempty"`
}

type FileOpener interface {
	OpenFile(name string, flag int, perm os.FileMode) (*os.File, error)
}

type FileWriter interface {
	WriteFile(file *os.File, data []byte) (int, error)
}

type ModuleConfig struct {
	// Name is the module identifier.
	Name string `yaml:"name"`

	// Path is the path to the module's .version file.
	Path string `yaml:"path"`

	// Enabled controls whether this module is active (default: true).
	Enabled *bool `yaml:"enabled,omitempty"`
}

type PluginConfig struct {
	CommitParser       bool                      `yaml:"commit-parser"`
	TagManager         *TagManagerConfig         `yaml:"tag-manager,omitempty"`
	VersionValidator   *VersionValidatorConfig   `yaml:"version-validator,omitempty"`
	DependencyCheck    *DependencyCheckConfig    `yaml:"dependency-check,omitempty"`
	ChangelogParser    *ChangelogParserConfig    `yaml:"changelog-parser,omitempty"`
	ChangelogGenerator *ChangelogGeneratorConfig `yaml:"changelog-generator,omitempty"`
	ReleaseGate        *ReleaseGateConfig        `yaml:"release-gate,omitempty"`
	AuditLog           *AuditLogConfig           `yaml:"audit-log,omitempty"`
}

type PreReleaseHookConfig struct {
	Command string `yaml:"command,omitempty"`
}

type ReleaseGateConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `yaml:"enabled"`

	// RequireCleanWorktree blocks bumps if git has uncommitted changes.
	RequireCleanWorktree bool `yaml:"require-clean-worktree,omitempty"`

	// RequireCIPass checks CI status before allowing bumps (disabled by default).
	RequireCIPass bool `yaml:"require-ci-pass,omitempty"`

	// BlockedOnWIPCommits blocks if recent commits contain WIP/fixup/squash.
	BlockedOnWIPCommits bool `yaml:"blocked-on-wip-commits,omitempty"`

	// AllowedBranches lists branches where bumps are allowed (empty = all allowed).
	AllowedBranches []string `yaml:"allowed-branches,omitempty"`

	// BlockedBranches lists branches where bumps are never allowed.
	BlockedBranches []string `yaml:"blocked-branches,omitempty"`
}

type RepositoryConfig struct {
	// Provider is the git hosting provider: github, gitlab, codeberg, gitea, bitbucket, custom.
	// Default: auto-detected from git remote URL.
	Provider string `yaml:"provider,omitempty"`

	// Host is the git server hostname (e.g., "github.com", "gitlab.com", "codeberg.org").
	// Required for custom providers or when auto-detect is disabled.
	Host string `yaml:"host,omitempty"`

	// Owner is the repository owner/organization.
	Owner string `yaml:"owner,omitempty"`

	// Repo is the repository name.
	Repo string `yaml:"repo,omitempty"`

	// AutoDetect enables automatic detection from git remote.
	AutoDetect bool `yaml:"auto-detect,omitempty"`
}

type TagManagerConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `yaml:"enabled"`

	// AutoCreate automatically creates tags after version bumps.
	AutoCreate *bool `yaml:"auto-create,omitempty"`

	// Prefix is the tag prefix (default: "v").
	Prefix string `yaml:"prefix,omitempty"`

	// Annotate creates annotated tags instead of lightweight tags.
	Annotate *bool `yaml:"annotate,omitempty"`

	// Push automatically pushes tags to remote after creation.
	Push bool `yaml:"push,omitempty"`

	// TagPrereleases controls whether tags are created for pre-release versions.
	// When false, tags are only created for stable releases (major/minor/patch).
	// Default: false.
	TagPrereleases *bool `yaml:"tag-prereleases,omitempty"`

	// Sign creates GPG-signed tags using git tag -s.
	// Requires git to be configured with a GPG signing key.
	// Default: false.
	Sign bool `yaml:"sign,omitempty"`

	// SigningKey specifies the GPG key ID to use for signing.
	// If empty, git uses the default signing key from user.signingkey config.
	// Only used when Sign is true.
	SigningKey string `yaml:"signing-key,omitempty"`

	// MessageTemplate is a template for the tag message.
	// Supports placeholders: {version}, {tag}, {prefix}, {date}, {major}, {minor}, {patch}, {prerelease}, {build}
	// Default: "Release {version}" for annotated/signed tags.
	MessageTemplate string `yaml:"message-template,omitempty"`
}

type ValidationResult struct {
	// Category is the validation category (e.g., "YAML Syntax", "Plugin Config").
	Category string

	// Passed indicates if the check passed.
	Passed bool

	// Message provides details about the validation result.
	Message string

	// Warning indicates if this is a warning rather than an error.
	Warning bool
}

type ValidationRule struct {
	// Type is the rule type (e.g., "pre-release-format", "major-version-max").
	Type string `yaml:"type"`

	// Pattern is a regex pattern for format validation rules.
	Pattern string `yaml:"pattern,omitempty"`

	// Value is a numeric limit for max-version rules.
	Value int `yaml:"value,omitempty"`

	// Enabled controls whether this specific rule is active.
	Enabled bool `yaml:"enabled,omitempty"`

	// Branch is a glob pattern for branch-constraint rules.
	Branch string `yaml:"branch,omitempty"`

	// Allowed lists allowed bump types for branch-constraint rules.
	Allowed []string `yaml:"allowed,omitempty"`
}

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

type VersionValidatorConfig struct {
	// Enabled controls whether the plugin is active.
	Enabled bool `yaml:"enabled"`

	// Rules defines the validation rules to apply.
	Rules []ValidationRule `yaml:"rules,omitempty"`
}

type WorkspaceConfig struct {
	// Discovery configures automatic module discovery.
	Discovery *DiscoveryConfig `yaml:"discovery,omitempty"`

	// Modules explicitly defines modules (overrides discovery if non-empty).
	Modules []ModuleConfig `yaml:"modules,omitempty"`
}