gitlabx

type Approvals struct {
	Approved          bool // every required approval rule is satisfied
	ApprovalsRequired int64
	ApprovalsLeft     int64
	ApprovedBy        []string // display names, see userDisplay
	UserHasApproved   bool
	UserCanApprove    bool
}

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

type Commit struct {
	ShortID string
	Title   string
	Message string // full message (subject + body)
}

type DiffRefs struct {
	BaseSHA  string
	HeadSHA  string
	StartSHA string
}

type Discussion struct {
	ID    string
	Notes []Note
}

type FileDiff struct {
	OldPath       string
	NewPath       string
	Diff          string
	NewFile       bool
	RenamedFile   bool
	DeletedFile   bool
	GeneratedFile bool
	TooLarge      bool
}

type GroupInfo struct {
	ID          int64
	FullPath    string
	Name        string
	Description string
}

type MRDetail struct {
	MRSummary
	DiffRefs DiffRefs
	// HasConflicts and DivergedCommits drive the rebase hygiene check:
	// DivergedCommits > 0 means the target branch moved ahead.
	HasConflicts        bool
	DivergedCommits     int64
	DetailedMergeStatus string
	Pipeline            *PipelineStatus // head pipeline; nil when none has run
}

type MRFilter struct {
	State          string // opened | merged | closed | all
	AuthorUsername string
	TargetBranch   string
	Search         string

	// Projects/Groups override the configured scope for this query (used
	// by in-TUI selection). Both empty = use the configured scope.
	Projects []string
	Groups   []string
}

type MRSummary struct {
	ProjectID    int64
	ProjectPath  string // full path with namespace; may be empty if unknown
	IID          int64
	Title        string
	Description  string
	State        string
	Draft        bool
	Author       string // username
	AuthorName   string // full name; empty when GitLab omits it
	SourceBranch string
	TargetBranch string
	HeadSHA      string
	WebURL       string
	CreatedAt    time.Time
	UpdatedAt    time.Time
}

type Note struct {
	ID         int64
	Author     string // username
	AuthorName string // full name; empty when GitLab omits it
	Body       string
	System     bool
	Resolvable bool
	Resolved   bool
	CreatedAt  time.Time
	Position   *Position // nil for general (unpositioned) notes
}

type Page struct {
	Number  int
	PerPage int
}

type PipelineStatus struct {
	Status string // GitLab status: success, failed, running, pending, canceled, skipped, manual, ...
	WebURL string
}

type Position struct {
	BaseSHA  string
	HeadSHA  string
	StartSHA string
	OldPath  string
	NewPath  string
	OldLine  *int
	NewLine  *int
}

type ProjectInfo struct {
	ID                int64
	PathWithNamespace string
	Description       string
	LastActivity      time.Time
}

type RepoFile struct {
	Name    string
	Content []byte
}

type Service interface {
	// ListOpenMergeRequests returns one page of MRs merged across the
	// scope (filter override or the configured projects and groups),
	// newest-updated first, and whether any source has more pages.
	ListOpenMergeRequests(ctx context.Context, filter MRFilter, page Page) ([]MRSummary, bool, error)

	// ListGroups returns groups the user has access to, for in-TUI scope
	// selection.
	ListGroups(ctx context.Context, search string, page Page) ([]GroupInfo, bool, error)

	// ListGroupProjects returns a group's projects (including subgroups).
	ListGroupProjects(ctx context.Context, group string, search string, page Page) ([]ProjectInfo, bool, error)

	// ListMemberProjects returns projects the user is a member of,
	// covering personal and directly-shared projects outside any group.
	ListMemberProjects(ctx context.Context, search string, page Page) ([]ProjectInfo, bool, error)

	// GetMergeRequest fetches full MR details including diff refs.
	// project is a full path (group/app) or numeric ID.
	GetMergeRequest(ctx context.Context, project any, iid int64) (*MRDetail, error)

	// ListDiffs returns every file diff of the MR (paginating internally).
	ListDiffs(ctx context.Context, project any, iid int64) ([]FileDiff, error)

	// ListCommits returns every commit on the MR's source branch
	// (paginating internally), for commit-message hygiene checks.
	ListCommits(ctx context.Context, project any, iid int64) ([]Commit, error)

	// CompareRevisions returns the file diffs between two commits (a direct
	// two-dot comparison, not merge-base). Used by incremental re-review to
	// diff the MR's new head against the last reviewed one; an unreachable
	// from-commit (force-push, GC) surfaces as an error.
	CompareRevisions(ctx context.Context, project any, from, to string) ([]FileDiff, error)

	// GetMergeRequestTemplate resolves the project's default MR description
	// template (including group-inherited ones), or "" if none is set.
	GetMergeRequestTemplate(ctx context.Context, project any) (string, error)

	// ListDirectoryFiles returns the files directly under dir in the
	// project repository at ref, with contents. A missing directory is not
	// an error: it returns nil. Used to offer repo-shipped review agents in
	// the pickers before any checkout exists.
	ListDirectoryFiles(ctx context.Context, project any, dir, ref string) ([]RepoFile, error)

	// GetRawFile returns the raw bytes of one file at ref. Used by the GUI
	// diff viewer to fetch unchanged lines around a hunk when expanding
	// context beyond what the MR diff carries.
	GetRawFile(ctx context.Context, project any, path, ref string) ([]byte, error)

	// ListDiscussions returns every discussion thread on the MR
	// (paginating internally).
	ListDiscussions(ctx context.Context, project any, iid int64) ([]Discussion, error)

	// CreateInlineDiscussion posts a positioned comment on the MR diff.
	CreateInlineDiscussion(ctx context.Context, project any, iid int64, body string, pos *Position) error

	// CreateNote posts a general (unpositioned) comment on the MR — the
	// fallback when no diff position can be resolved.
	CreateNote(ctx context.Context, project any, iid int64, body string) error

	// CreateDraftNote adds a comment to the user's pending review; pos may
	// be nil for a general draft note. Nothing is visible to others until
	// PublishAllDraftNotes.
	CreateDraftNote(ctx context.Context, project any, iid int64, body string, pos *Position) error

	// PublishAllDraftNotes publishes the pending review in one action.
	PublishAllDraftNotes(ctx context.Context, project any, iid int64) error

	// GetApprovals returns the MR's approval state as seen by the
	// current user.
	GetApprovals(ctx context.Context, project any, iid int64) (*Approvals, error)

	// Approve approves the MR. A non-empty sha must match the MR's HEAD,
	// guarding against approving code pushed after it was reviewed.
	Approve(ctx context.Context, project any, iid int64, sha string) error

	// Unapprove removes the current user's approval from the MR.
	Unapprove(ctx context.Context, project any, iid int64) error
}