git

type ApplyOptions struct {
	// PatchPath is the path to the patch file.
	PatchPath string

	// ThreeWay enables 3-way merge.
	ThreeWay bool

	// CheckOnly validates the patch without applying it.
	CheckOnly bool
}

type Client struct {
	// Dir is the working directory of the git repository.
	Dir string

	// AuthToken is the optional authentication token for push operations.
	AuthToken string

	// Options provides optional git configuration.
	Options *ClientOptions
}

type ClientOptions struct {
	// UserName is the git user name for commits.
	UserName string

	// UserEmail is the git user email for commits.
	UserEmail string

	// Quiet suppresses output from git commands.
	Quiet bool

	// DryRun logs commands without executing them.
	DryRun bool
}

type CloneOptions struct {
	// Source is the repository URL or path to clone from.
	Source string

	// Dest is the destination directory.
	Dest string

	// Ref is the reference to checkout after clone (optional).
	Ref string

	// Depth specifies shallow clone depth (0 for full history).
	Depth int

	// Local indicates to use --local for local repositories.
	Local bool

	// Submodules indicates whether to initialize submodules.
	Submodules bool

	// Quiet suppresses output.
	Quiet bool
}

type CloneResult struct {
	// HEAD is the checked out commit SHA.
	HEAD string

	// Branch is the checked out branch name.
	Branch string

	// IsShallow indicates if the clone is shallow.
	IsShallow bool
}

type CommitAuthor struct {
	Name  string
	Email string
	When  time.Time
}

type CommitOptions struct {
	// Message is the commit message.
	Message string

	// Author is the commit author (defaults to config).
	Author *CommitAuthor

	// AllowEmpty allows creating a commit with no changes.
	AllowEmpty bool
}

type PushOptions struct {
	// Remote is the remote name (default: "origin").
	Remote string

	// Branch is the branch to push.
	Branch string

	// Force enables force push.
	Force bool

	// SetUpstream sets the upstream branch.
	SetUpstream bool
}

type RepositoryInfo struct {
	// HEAD is the current commit SHA.
	HEAD string

	// IsShallow indicates if the repository is a shallow clone.
	IsShallow bool

	// Branch is the current branch name (empty if detached HEAD).
	Branch string

	// Clean indicates if the working directory has no changes.
	Clean bool
}