git

type Author struct {
	// Name is the author's name.
	Name string `json:"name"`
	// Email is the author's email.
	Email string `json:"email"`
}

type Branch struct {
	// Name is the branch name.
	Name string `json:"name"`
	// Hash is the commit hash the branch points to.
	Hash string `json:"hash"`
	// IsRemote indicates if this is a remote branch.
	IsRemote bool `json:"is_remote"`
	// Remote is the remote name (for remote branches).
	Remote string `json:"remote,omitempty"`
	// Upstream is the upstream branch name.
	Upstream string `json:"upstream,omitempty"`
}

type CategorizedChanges struct {
	// Features contains feat commits.
	Features []ConventionalCommit `json:"features,omitempty"`
	// Fixes contains fix commits.
	Fixes []ConventionalCommit `json:"fixes,omitempty"`
	// Performance contains perf commits.
	Performance []ConventionalCommit `json:"performance,omitempty"`
	// Documentation contains docs commits.
	Documentation []ConventionalCommit `json:"documentation,omitempty"`
	// Refactoring contains refactor commits.
	Refactoring []ConventionalCommit `json:"refactoring,omitempty"`
	// Breaking contains breaking change commits.
	Breaking []ConventionalCommit `json:"breaking,omitempty"`
	// Other contains all other commits.
	Other []ConventionalCommit `json:"other,omitempty"`
	// All contains all commits in order.
	All []ConventionalCommit `json:"all"`
}

type Commit struct {
	// Hash is the commit SHA.
	Hash string `json:"hash"`
	// ShortHash is the abbreviated commit SHA (7 characters).
	ShortHash string `json:"short_hash"`
	// Message is the full commit message.
	Message string `json:"message"`
	// Subject is the first line of the commit message.
	Subject string `json:"subject"`
	// Body is the commit message body (everything after the first line).
	Body string `json:"body"`
	// Author is the commit author.
	Author Author `json:"author"`
	// Committer is the person who made the commit.
	Committer Author `json:"committer"`
	// Date is the commit date.
	Date time.Time `json:"date"`
	// Parents are the parent commit hashes.
	Parents []string `json:"parents"`
}

type CommitFilter struct {
	// Types filters commits by type.
	Types []CommitType
	// Authors filters commits by author email.
	Authors []string
	// ExcludeAuthors excludes commits by author email.
	ExcludeAuthors []string
	// Scopes filters commits by scope.
	Scopes []string
	// ExcludeScopes excludes commits by scope.
	ExcludeScopes []string
	// IncludeNonConventional includes non-conventional commits.
	IncludeNonConventional bool
	// OnlyBreaking only includes breaking changes.
	OnlyBreaking bool
	// Since filters commits after this date.
	Since *time.Time
	// Until filters commits before this date.
	Until *time.Time
	// PathFilter filters commits that touch these paths.
	PathFilter []string
}

type CommitOptions struct {
	// Message is the commit message.
	Message string
	// Author is the commit author.
	Author *Author
	// AllowEmpty allows creating an empty commit.
	AllowEmpty bool
	// Sign signs the commit with GPG.
	Sign bool
	// Amend amends the previous commit.
	Amend bool
}

type CommitType = changes.CommitType

type ConventionalCommit struct {
	// Commit is the underlying git commit.
	Commit Commit `json:"commit"`
	// Type is the commit type (feat, fix, etc.).
	Type CommitType `json:"type"`
	// Scope is the optional scope of the commit.
	Scope string `json:"scope,omitempty"`
	// Description is the commit description (after type and scope).
	Description string `json:"description"`
	// Body is the commit body.
	Body string `json:"body,omitempty"`
	// Footer is the commit footer (contains breaking change info, references, etc.).
	Footer string `json:"footer,omitempty"`
	// Breaking indicates if this is a breaking change.
	Breaking bool `json:"breaking"`
	// BreakingDescription is the description of the breaking change.
	BreakingDescription string `json:"breaking_description,omitempty"`
	// References are issue/PR references found in the commit.
	References []Reference `json:"references,omitempty"`
	// IsConventional indicates if the commit follows conventional commit format.
	IsConventional bool `json:"is_conventional"`
}

type DiffStats struct {
	// FilesChanged is the number of files changed.
	FilesChanged int `json:"files_changed"`
	// Insertions is the number of lines inserted.
	Insertions int `json:"insertions"`
	// Deletions is the number of lines deleted.
	Deletions int `json:"deletions"`
	// Files is the list of changed files with their stats.
	Files []FileStats `json:"files,omitempty"`
}

type FetchOptions struct {
	// Remote is the remote name (default: "origin").
	Remote string
	// Tags fetches all tags.
	Tags bool
	// Prune removes remote-tracking references that no longer exist.
	Prune bool
	// Depth limits the fetch depth (0 = full).
	Depth int
}

type FileStats struct {
	// Path is the file path.
	Path string `json:"path"`
	// Insertions is the number of lines inserted.
	Insertions int `json:"insertions"`
	// Deletions is the number of lines deleted.
	Deletions int `json:"deletions"`
	// Status is the file status (added, modified, deleted, renamed).
	Status string `json:"status"`
	// OldPath is the old path (for renamed files).
	OldPath string `json:"old_path,omitempty"`
}

type ParseOptions struct {
	// StrictMode requires commits to follow conventional commit format exactly.
	StrictMode bool
	// ParseReferences enables parsing of issue/PR references.
	ParseReferences bool
	// ParseCoAuthors enables parsing of co-author information.
	ParseCoAuthors bool
}

type PullOptions struct {
	// Remote is the remote name (default: "origin").
	Remote string
	// Branch is the branch to pull (default: current branch).
	Branch string
	// Rebase uses rebase instead of merge.
	Rebase bool
	// Depth limits the fetch depth (0 = full).
	Depth int
}

type PushOptions struct {
	// Remote is the remote name (default: "origin").
	Remote string
	// Force enables force push.
	Force bool
	// Tags pushes tags.
	Tags bool
	// DryRun simulates the push.
	DryRun bool
	// RefSpec is the refspec to push.
	RefSpec string
}

type Reference struct {
	// Type is the reference type (e.g., "issue", "pr", "closes", "fixes").
	Type string `json:"type"`
	// ID is the reference ID (issue/PR number).
	ID string `json:"id"`
	// Raw is the raw reference string as found in the commit.
	Raw string `json:"raw"`
}

type ReleaseType = changes.ReleaseType

type RemoteInfo struct {
	// Name is the remote name.
	Name string `json:"name"`
	// URL is the remote URL.
	URL string `json:"url"`
	// PushURL is the push URL (if different from fetch URL).
	PushURL string `json:"push_url,omitempty"`
}

type RepositoryInfo struct {
	// Root is the repository root directory.
	Root string `json:"root"`
	// CurrentBranch is the current checked out branch.
	CurrentBranch string `json:"current_branch"`
	// DefaultBranch is the default branch (main/master).
	DefaultBranch string `json:"default_branch"`
	// Remotes is the list of configured remotes.
	Remotes []RemoteInfo `json:"remotes"`
	// IsDirty indicates if the working tree has uncommitted changes.
	IsDirty bool `json:"is_dirty"`
	// HeadCommit is the current HEAD commit hash.
	HeadCommit string `json:"head_commit"`
}

type Service interface {

	// GetRepositoryRoot returns the absolute path to the repository root.
	GetRepositoryRoot(ctx context.Context) (string, error)

	// GetRepositoryInfo returns information about the repository.
	GetRepositoryInfo(ctx context.Context) (*RepositoryInfo, error)

	// IsClean returns true if the working tree has no uncommitted changes.
	IsClean(ctx context.Context) (bool, error)

	// GetCommit returns a specific commit by hash.
	GetCommit(ctx context.Context, hash string) (*Commit, error)

	// GetCommitsSince returns all commits since the given reference.
	GetCommitsSince(ctx context.Context, ref string) ([]Commit, error)

	// GetCommitsBetween returns all commits between two references.
	GetCommitsBetween(ctx context.Context, from, to string) ([]Commit, error)

	// GetHeadCommit returns the current HEAD commit.
	GetHeadCommit(ctx context.Context) (*Commit, error)

	// GetBranchCommit returns the latest commit on a specific branch.
	GetBranchCommit(ctx context.Context, branch string) (*Commit, error)

	// GetLatestTag returns the most recent tag.
	GetLatestTag(ctx context.Context) (*Tag, error)

	// GetLatestVersionTag returns the most recent version tag matching the prefix.
	GetLatestVersionTag(ctx context.Context, prefix string) (*Tag, error)

	// ListTags returns all tags in the repository.
	ListTags(ctx context.Context) ([]Tag, error)

	// ListVersionTags returns all version tags matching the prefix.
	ListVersionTags(ctx context.Context, prefix string) ([]Tag, error)

	// GetTag returns a specific tag by name, or an error if not found.
	GetTag(ctx context.Context, name string) (*Tag, error)

	// CreateTag creates a new tag.
	CreateTag(ctx context.Context, name, message string, opts TagOptions) error

	// DeleteTag deletes a tag.
	DeleteTag(ctx context.Context, name string) error

	// PushTag pushes a tag to the remote.
	PushTag(ctx context.Context, name string, opts PushOptions) error

	// GetCurrentBranch returns the current branch name.
	GetCurrentBranch(ctx context.Context) (string, error)

	// GetDefaultBranch returns the default branch name (main/master).
	GetDefaultBranch(ctx context.Context) (string, error)

	// ListBranches returns all branches in the repository.
	ListBranches(ctx context.Context) ([]Branch, error)

	// GetRemoteURL returns the URL of the specified remote.
	GetRemoteURL(ctx context.Context, name string) (string, error)

	// Push pushes changes to the remote.
	Push(ctx context.Context, opts PushOptions) error

	// Pull pulls changes from the remote and merges them.
	Pull(ctx context.Context, opts PullOptions) error

	// Fetch fetches from the remote.
	Fetch(ctx context.Context, opts FetchOptions) error

	// GetDiffStats returns statistics about changes between two refs.
	GetDiffStats(ctx context.Context, from, to string) (*DiffStats, error)

	// ParseConventionalCommit parses a commit message as a conventional commit.
	ParseConventionalCommit(message string) (*ConventionalCommit, error)

	// ParseConventionalCommits parses multiple commits as conventional commits.
	ParseConventionalCommits(commits []Commit, opts ParseOptions) ([]ConventionalCommit, error)

	// DetectReleaseType determines the release type based on conventional commits.
	DetectReleaseType(commits []ConventionalCommit) ReleaseType

	// CategorizeCommits groups commits by their type.
	CategorizeCommits(commits []ConventionalCommit) *CategorizedChanges

	// FilterCommits filters commits based on criteria.
	FilterCommits(commits []ConventionalCommit, filter CommitFilter) []ConventionalCommit
}

type ServiceConfig struct {
	// RepoPath is the path to the repository.
	RepoPath string
	// DefaultRemote is the default remote name.
	DefaultRemote string
	// GPGSign enables GPG signing by default.
	GPGSign bool
	// GPGKeyID is the GPG key ID to use for signing.
	GPGKeyID string
	// UseCLIFallback enables falling back to git CLI when go-git fails.
	// This is useful for authentication with credential helpers.
	UseCLIFallback bool
	// AuthToken is an optional authentication token for HTTPS push.
	// When set, this is used instead of relying on credential helpers.
	AuthToken string
	// AuthUsername is the username for token auth (default: "git" for GitHub).
	AuthUsername string
}

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

type ServiceOption func(*ServiceConfig)

type Tag struct {
	// Name is the tag name.
	Name string `json:"name"`
	// Hash is the commit hash the tag points to.
	Hash string `json:"hash"`
	// Message is the tag message (for annotated tags).
	Message string `json:"message,omitempty"`
	// Tagger is the person who created the tag (for annotated tags).
	Tagger *Author `json:"tagger,omitempty"`
	// Date is the tag date.
	Date time.Time `json:"date"`
	// IsAnnotated indicates if this is an annotated tag.
	IsAnnotated bool `json:"is_annotated"`
}

type TagFilter struct {
	// Prefix filters tags by prefix (e.g., "v").
	Prefix string
	// Pattern filters tags by glob pattern.
	Pattern string
	// Since filters tags after this date.
	Since *time.Time
	// Until filters tags before this date.
	Until *time.Time
}

type TagOptions struct {
	// Annotated creates an annotated tag (vs lightweight).
	Annotated bool
	// Sign signs the tag with GPG.
	Sign bool
	// Force overwrites an existing tag.
	Force bool
	// Ref is the reference to tag (default: HEAD).
	Ref string
}