git

type Branch struct {
	Name     string `json:"name"`
	Current  bool   `json:"current"`
	Remote   bool   `json:"remote"`
	SHA      string `json:"sha,omitempty"`
	Upstream string `json:"upstream,omitempty"`
}

type Commit struct {
	SHA     string `json:"sha"`
	Message string `json:"message"`
	Author  string `json:"author"`
	Date    string `json:"date"`
	Refs    string `json:"refs,omitempty"` // branch/tag decorations
}

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

type GitAdapter interface {
	// OpenRepository re-initializes the adapter for the given repo path.
	// Must be called before any other operation.
	OpenRepository(ctx context.Context, path string) error

	// Root returns the repository root path.
	Root() string

	// Status returns the working tree status.
	GetStatus(ctx context.Context) (*Status, error)

	// Commit creates a commit with the given message (and optional author).
	// Author defaults to the Git config user.name / user.email if empty.
	CreateCommit(ctx context.Context, message, author string) (string, error)

	// GetCommitHistory returns commit history for a branch (or all if empty).
	GetCommitHistory(ctx context.Context, branch string, limit int) ([]Commit, error)

	// Branch operations.
	ListBranches(ctx context.Context) ([]Branch, error)
	CreateBranch(ctx context.Context, name string) error
	CheckoutBranch(ctx context.Context, name string) error
	DeleteBranch(ctx context.Context, name string, force bool) error
	CurrentBranch(ctx context.Context) (string, error)

	// Remote operations.
	GetRemotes(ctx context.Context) ([]Remote, error)
	AddRemote(ctx context.Context, name, url string) error
	RemoveRemote(ctx context.Context, name string) error
	Push(ctx context.Context, remote, branch string, force bool) (*PushResult, error)
	Pull(ctx context.Context, remote, branch string) (*PullResult, error)

	// Graph returns the commit graph structure for visualisation.
	GetGraph(ctx context.Context, branch string, maxCount int) ([]GraphNode, error)
}

type GraphNode struct {
	SHA     string   `json:"sha"`
	Message string   `json:"message"`
	Parents []string `json:"parents"`
	Refs    string   `json:"refs,omitempty"`
}

type PullResult struct {
	Output      string `json:"output"`
	FastForward bool   `json:"fast_forward"`
}

type PushResult struct {
	Output string `json:"output"`
}

type Remote struct {
	Name    string `json:"name"`
	URL     string `json:"url"`
	PushURL string `json:"push_url,omitempty"`
}

type Status struct {
	Branch    string        `json:"branch"`
	Clean     bool          `json:"clean"`
	Staged    []StatusEntry `json:"staged"`
	Unstaged  []StatusEntry `json:"unstaged"`
	Untracked []string      `json:"untracked"`
}

type StatusEntry struct {
	IndexStatus    string `json:"index_status"`    // staged change (M, A, D, R, C, or space)
	WorktreeStatus string `json:"worktree_status"` // unstaged change (M, A, D, or space)
	Path           string `json:"path"`
	OldPath        string `json:"old_path,omitempty"` // for renames/copies
}