vcs

type CICheck struct {
	Name   string // check name
	Status string // platform-normalized: "pass", "fail", "pending"
	Link   string // platform-specific URL to the check run details
}

type CheckRun struct {
	Name       string
	Status     string // CheckRun: QUEUED, IN_PROGRESS, COMPLETED, WAITING, PENDING, REQUESTED
	Conclusion string // CheckRun: SUCCESS, FAILURE, NEUTRAL, SKIPPED, CANCELLED, TIMED_OUT, etc.
	// State and Context are populated for GitHub StatusContext items.
	State   string // StatusContext: PENDING, SUCCESS, FAILURE, ERROR, EXPECTED
	Context string // StatusContext: the check name (e.g., "ci/build")
}

type CreateParams struct {
	// WorktreePath is the git worktree directory to run CLI commands from.
	WorktreePath string
	// BeadID to reference in the PR.
	BeadID string
	// Title for the PR (auto-generated if empty).
	Title string
	// Body for the PR (auto-generated if empty).
	Body string
	// Branch is the feature branch name.
	Branch string
	// Base is the target branch (default: main).
	Base string
	// AnvilName for state tracking.
	AnvilName string
	// Draft creates a draft PR if true.
	Draft bool

	// BeadTitle is the bead's human-readable title (used in the PR body).
	BeadTitle string
	// BeadDescription is the bead's problem/task description (used in the PR body).
	BeadDescription string
	// BeadType is the bead's issue type (bug, feature, task, etc.).
	BeadType string
	// ChangeSummary is a summary of what changed (from warden review or diff stat).
	ChangeSummary string
}

type GitLabProvider struct{}

type GiteaProvider struct{}

type MergeabilityInputs struct {
	HasConflicts         bool
	HasUnresolvedThreads bool
	HasPendingReviews    bool
}

type OpenPR struct {
	Number int
	Title  string
	Branch string
	Body   string
}

type PR struct {
	Number  int
	URL     string
	Title   string
	Branch  string
	Base    string
	BeadID  string
	Anvil   string
	Created time.Time
}

type PRStatus struct {
	// State is the PR lifecycle state. Platforms map their native values
	// to these canonical strings: "OPEN", "MERGED", "CLOSED".
	State             string
	StatusCheckRollup []CheckRun
	Reviews           []Review
	ReviewRequests    []ReviewRequest
	// Mergeable indicates conflict state. Canonical values:
	// "MERGEABLE", "CONFLICTING", "UNKNOWN".
	Mergeable         string
	UnresolvedThreads int
	HeadRefName       string
	URL               string
}

type Platform string

type Provider interface {
	// CreatePR creates a pull/merge request and returns its metadata.
	CreatePR(ctx context.Context, params CreateParams) (*PR, error)

	// MergePR merges the PR identified by prNumber using the given strategy
	// ("squash", "merge", or "rebase").
	MergePR(ctx context.Context, worktreePath string, prNumber int, strategy string) error

	// CheckStatus returns the full status of a PR including CI checks,
	// reviews, unresolved threads, and mergeability.
	CheckStatus(ctx context.Context, worktreePath string, prNumber int) (*PRStatus, error)

	// CheckStatusLight returns a lightweight status (no unresolved thread
	// count pagination). Use when only reviewRequests/mergeable are needed.
	CheckStatusLight(ctx context.Context, worktreePath string, prNumber int) (*PRStatus, error)

	// ListOpenPRs returns all open PRs in the repository.
	ListOpenPRs(ctx context.Context, worktreePath string) ([]OpenPR, error)

	// GetRepoOwnerAndName extracts the owner and repository name from the
	// git remote. The semantics of "owner" vary by platform (org, group,
	// project namespace, etc.).
	GetRepoOwnerAndName(ctx context.Context, worktreePath string) (owner, repo string, err error)

	// FetchUnresolvedThreadCount returns the number of unresolved review
	// threads on a PR. Platforms without thread resolution tracking should
	// return 0, nil.
	FetchUnresolvedThreadCount(ctx context.Context, worktreePath string, prNumber int) (int, error)

	// FetchPendingReviewRequests returns pending review requests, including
	// bot reviewers. Platforms that don't distinguish reviewer types may
	// return the standard review request list.
	FetchPendingReviewRequests(ctx context.Context, worktreePath string, prNumber int) ([]ReviewRequest, error)

	// FetchPRChecks returns the CI check results for a PR. The raw string
	// is a human-readable summary suitable for inclusion in prompts; the
	// CICheck slice contains only the failing checks parsed from the output.
	FetchPRChecks(ctx context.Context, worktreePath string, prNumber int) (raw string, failing []CICheck, err error)

	// FetchCILogs retrieves CI log output for the given failing checks.
	// Returns a map of check name → log text. Checks without available
	// logs are omitted from the result.
	FetchCILogs(ctx context.Context, worktreePath string, checks []CICheck) (map[string]string, error)

	// FetchReviewComments returns review comments and unresolved threads
	// on a PR, including PR-level review comments and inline thread comments.
	FetchReviewComments(ctx context.Context, worktreePath string, prNumber int) ([]ReviewComment, error)

	// ResolveThread marks a review thread as resolved. Platforms without
	// thread resolution support should return nil.
	ResolveThread(ctx context.Context, worktreePath string, threadID string) error

	// Platform returns which platform this provider implements.
	Platform() Platform
}

type Review struct {
	Author ReviewAuthor
	State  string
	Body   string
}

type ReviewAuthor struct {
	Login string
}

type ReviewComment struct {
	Author   string // reviewer login
	Body     string // comment text
	Path     string // file path (empty for PR-level comments)
	Line     int    // line number (0 for PR-level comments)
	State    string // "CHANGES_REQUESTED", etc. (empty for thread comments)
	ThreadID string // platform-specific thread identifier
}

type ReviewRequest struct {
	Login string
	Slug  string
	Name  string
}