git

type BranchCheckoutOpts struct {
	PriorityBranches []string // Default: ["develop", "master", "main"]
	DefaultRemote    string   // Default: "origin"
}

type BranchDetectOpts struct {
	Override         string   // --branch CLI flag (highest priority)
	PriorityBranches []string // Default: ["develop", "master", "main"]
	DefaultRemote    string   // Default: "origin"
}

type BranchPointsAtResult struct {
	Local  []string       // Local branch names (e.g. "develop", "feature/foo")
	Remote []RemoteBranch // Remote branches (e.g. origin/develop)
}

type BranchResult struct {
	Name     string // Branch name, or empty if detached
	Detached bool   // True when HEAD is detached
	Stderr   string
}

type CheckoutResult struct {
	Branch string
	Stderr string
}

type CommitResult struct {
	SHA    string // Short SHA of the new commit
	Stderr string
}

type ExecGit struct {
	GitBin   string        // Path to git binary; defaults to "git" if empty.
	Timeouts TimeoutConfig // Per-operation timeout configuration.
}

type FetchOpts struct {
	Remote string // Empty means all remotes
	Prune  bool
}

type FetchResult struct {
	Stderr string
}

type GitError struct {
	Op     string // Operation name: "fetch", "push", "merge", etc.
	Stderr string // Raw stderr output from git
	Err    error  // Underlying error (exec.ExitError, context.DeadlineExceeded, etc.)
}

type GitService interface {
	// Repository discovery
	SubmodulePaths(ctx context.Context, rootDir string) ([]string, error)
	IsSubmoduleInitialized(rootDir, subPath string) bool
	SubmoduleInit(ctx context.Context, rootDir string, paths []string) error

	// Branch and revision queries
	CurrentBranch(ctx context.Context, dir string) (BranchResult, error)
	CurrentSHA(ctx context.Context, dir string) (string, error)
	IsDetachedHead(ctx context.Context, dir string) (bool, error)
	RemoteBranches(ctx context.Context, dir string) ([]RemoteBranch, error)
	CommitsBehind(ctx context.Context, dir, localRef, remoteRef string) (int, error)
	CommitsAhead(ctx context.Context, dir, remoteRef string) (int, error)
	HasRemoteBranch(ctx context.Context, dir, remote, branch string) (bool, error)
	SymbolicRef(ctx context.Context, dir, ref string) (string, error)
	TrackingBranch(ctx context.Context, dir string) (TrackingInfo, error)
	RefExists(ctx context.Context, dir, ref string) (bool, error)
	IsAncestor(ctx context.Context, dir, ancestor, descendant string) (bool, error)

	// Status queries
	HasLocalChanges(ctx context.Context, dir string) (bool, error)
	IncomingChangelog(ctx context.Context, dir, remoteRef string, limit int) ([]string, error)

	// Mutating operations
	Fetch(ctx context.Context, dir string, opts FetchOpts) (FetchResult, error)
	Checkout(ctx context.Context, dir, branch string) (CheckoutResult, error)
	CheckoutNewBranch(ctx context.Context, dir, branch, startPoint string) (CheckoutResult, error)
	Merge(ctx context.Context, dir, ref string) (MergeResult, error)
	Push(ctx context.Context, dir string, opts PushOpts) (PushResult, error)
	Stash(ctx context.Context, dir string) (StashResult, error)
	StashPop(ctx context.Context, dir string) (StashResult, error)
	MergeAbort(ctx context.Context, dir string) error
	ResetHard(ctx context.Context, dir, ref string) error

	// Branch queries
	BranchesPointingAt(ctx context.Context, dir, ref string) (BranchPointsAtResult, error)

	// Submodule removal
	SubmoduleDeinit(ctx context.Context, rootDir, subPath string) error
	RemovePath(ctx context.Context, rootDir, path string) error

	// Root repository operations
	DiffIndex(ctx context.Context, dir string) ([]string, error)
	StageFiles(ctx context.Context, dir string, paths []string) error
	Commit(ctx context.Context, dir, message string) (CommitResult, error)
	ListTags(ctx context.Context, dir string, limit int) ([]string, error)
	CreateTag(ctx context.Context, dir string, opts TagOpts) error
}

type MergeResult struct {
	Success  bool
	Conflict bool // True if merge failed due to conflict
	Stderr   string
}

type MockGitService struct {
	SubmodulePathsFn         func(ctx context.Context, rootDir string) ([]string, error)
	IsSubmoduleInitializedFn func(rootDir, subPath string) bool
	SubmoduleInitFn          func(ctx context.Context, rootDir string, paths []string) error
	CurrentBranchFn          func(ctx context.Context, dir string) (BranchResult, error)
	CurrentSHAFn             func(ctx context.Context, dir string) (string, error)
	IsDetachedHeadFn         func(ctx context.Context, dir string) (bool, error)
	RemoteBranchesFn         func(ctx context.Context, dir string) ([]RemoteBranch, error)
	CommitsBehindFn          func(ctx context.Context, dir, localRef, remoteRef string) (int, error)
	CommitsAheadFn           func(ctx context.Context, dir, remoteRef string) (int, error)
	HasRemoteBranchFn        func(ctx context.Context, dir, remote, branch string) (bool, error)
	SymbolicRefFn            func(ctx context.Context, dir, ref string) (string, error)
	TrackingBranchFn         func(ctx context.Context, dir string) (TrackingInfo, error)
	RefExistsFn              func(ctx context.Context, dir, ref string) (bool, error)
	IsAncestorFn             func(ctx context.Context, dir, ancestor, descendant string) (bool, error)
	HasLocalChangesFn        func(ctx context.Context, dir string) (bool, error)
	IncomingChangelogFn      func(ctx context.Context, dir, remoteRef string, limit int) ([]string, error)
	FetchFn                  func(ctx context.Context, dir string, opts FetchOpts) (FetchResult, error)
	CheckoutFn               func(ctx context.Context, dir, branch string) (CheckoutResult, error)
	CheckoutNewBranchFn      func(ctx context.Context, dir, branch, startPoint string) (CheckoutResult, error)
	MergeFn                  func(ctx context.Context, dir, ref string) (MergeResult, error)
	PushFn                   func(ctx context.Context, dir string, opts PushOpts) (PushResult, error)
	StashFn                  func(ctx context.Context, dir string) (StashResult, error)
	StashPopFn               func(ctx context.Context, dir string) (StashResult, error)
	MergeAbortFn             func(ctx context.Context, dir string) error
	ResetHardFn              func(ctx context.Context, dir, ref string) error
	DiffIndexFn              func(ctx context.Context, dir string) ([]string, error)
	StageFilesFn             func(ctx context.Context, dir string, paths []string) error
	CommitFn                 func(ctx context.Context, dir, message string) (CommitResult, error)
	ListTagsFn               func(ctx context.Context, dir string, limit int) ([]string, error)
	CreateTagFn              func(ctx context.Context, dir string, opts TagOpts) error
	BranchesPointingAtFn     func(ctx context.Context, dir, ref string) (BranchPointsAtResult, error)
	SubmoduleDeinitFn        func(ctx context.Context, rootDir, subPath string) error
	RemovePathFn             func(ctx context.Context, rootDir, path string) error
}

type PushOpts struct {
	Remote      string
	Branch      string
	SetUpstream bool
}

type PushResult struct {
	Remote      string // Which remote was pushed to
	Branch      string // Which branch was pushed
	NewTracking bool   // True if -u was used to set up tracking
	Stderr      string
}

type RemoteBranch struct {
	Remote string // e.g. "origin"
	Branch string // e.g. "develop"
}

type SemVer struct {
	Major      int
	Minor      int
	Patch      int
	Prerelease string // e.g. "beta.1" (empty if none)
}

type StashResult struct {
	Created bool // For Stash: true if a stash was created; for StashPop: true if pop was applied
	Stderr  string
}

type SubmoduleStatus string

type TagOpts struct {
	Name    string // Tag name (e.g. "v1.2.3")
	Message string // Annotation message
}

type TimeoutConfig struct {
	Fetch   time.Duration // Default 120s -- network bound.
	Push    time.Duration // Default 60s -- network bound.
	Merge   time.Duration // Default 30s -- local operation.
	Default time.Duration // Default 30s -- for queries like rev-parse, branch -r.
}

type TrackingInfo struct {
	Remote string // e.g. "origin"
	Branch string // e.g. "develop"
	Set    bool   // False if no tracking branch is configured
	Stderr string
}