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 Config struct {
	// AuthorName is the git user.name for commits.
	AuthorName string

	// AuthorEmail is the git user.email for commits.
	AuthorEmail string
}

type ConfigOptions struct {
	// ExplicitAuthorName is an explicitly set author name that should override all other sources.
	// This has the highest priority and is used for user-specified overrides.
	ExplicitAuthorName string

	// ExplicitAuthorEmail is an explicitly set author email that should override all other sources.
	// This has the highest priority and is used for user-specified overrides.
	ExplicitAuthorEmail string

	// ProjectAuthorName is the project-level git author name from .holon/config.yaml.
	ProjectAuthorName string

	// ProjectAuthorEmail is the project-level git author email from .holon/config.yaml.
	ProjectAuthorEmail string

	// EnvAuthorName is the author name from environment variables (GIT_AUTHOR_NAME).
	EnvAuthorName string

	// EnvAuthorEmail is the author email from environment variables (GIT_AUTHOR_EMAIL).
	EnvAuthorEmail string
}

type FileStatus struct {
	// Path is the file path.
	Path string

	// Status is the human-readable status (e.g., "modified", "added", "deleted").
	Status string

	// StatusCode is the raw status code from git status.
	StatusCode string
}

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
}