provider

type BuildInfo struct {
	// ID is the build identifier.
	ID string
	// Name is the build definition/pipeline name.
	Name string
	// Status is the current build status (e.g., "completed", "inProgress", "notStarted").
	Status string
	// Result is the build result when completed (e.g., "succeeded", "failed", "canceled").
	Result string
	// URL is the web URL to view the build.
	URL string
}

type Comment struct {
	// ID is the comment identifier.
	ID string
	// ThreadID is the parent thread identifier.
	ThreadID string
	// Author is the display name of the comment author.
	Author string
	// Body is the comment text content.
	Body string
	// CommentType indicates the type of comment ("text" for user comments, "system" for auto-generated).
	CommentType string
	// IsResolved indicates whether the comment thread has been resolved.
	IsResolved bool
	// FilePath is the file path for inline comments (empty for general comments).
	FilePath string
	// Line is the line number for inline comments (0 for general comments).
	Line int
	// CreatedAt is the timestamp when the comment was created.
	CreatedAt time.Time
}

type CommentResolution int

type CreatePRParams struct {
	// Title is the pull request title.
	Title string
	// Description is the pull request description/body text.
	Description string
	// SourceBranch is the branch being merged from (e.g., "users/alanmeadows/my-feature").
	SourceBranch string
	// TargetBranch is the branch being merged into (e.g., "main").
	TargetBranch string
}

type InlineComment struct {
	// FilePath is the path of the file to comment on.
	FilePath string
	// Line is the line number to comment on.
	Line int
	// Body is the comment text.
	Body string
	// Side indicates which side of the diff to comment on ("left" or "right").
	Side string
}

type PRBackend interface {
	// Name returns the short identifier for this backend (e.g., "ado", "github").
	Name() string

	// MatchesURL returns true if the given URL belongs to this backend's hosting service.
	MatchesURL(url string) bool

	// GetPR retrieves pull request information by ID or URL.
	GetPR(ctx context.Context, id string) (*PRInfo, error)

	// GetPipelineStatus returns the current CI/CD pipeline status for a pull request.
	GetPipelineStatus(ctx context.Context, pr *PRInfo) (*PipelineStatus, error)

	// GetBuildLogs retrieves and distills build logs for a specific build, focusing on errors.
	GetBuildLogs(ctx context.Context, pr *PRInfo, buildID string) (string, error)

	// GetComments retrieves all comments/threads on a pull request.
	GetComments(ctx context.Context, pr *PRInfo) ([]Comment, error)

	// PostComment posts a general (non-inline) comment on a pull request.
	PostComment(ctx context.Context, pr *PRInfo, body string) error

	// PostInlineComment posts a comment on a specific file and line in the PR diff.
	PostInlineComment(ctx context.Context, pr *PRInfo, comment InlineComment) error

	// ReplyToComment adds a reply to an existing comment thread.
	ReplyToComment(ctx context.Context, pr *PRInfo, threadID string, body string) error

	// ResolveComment resolves or closes a comment thread with the given resolution.
	ResolveComment(ctx context.Context, pr *PRInfo, threadID string, resolution CommentResolution) error

	// RunWorkflow executes a workflow action on the pull request (e.g., auto-complete, create work item).
	RunWorkflow(ctx context.Context, pr *PRInfo, action WorkflowAction) error

	// CreatePR creates a new pull request and returns its metadata.
	CreatePR(ctx context.Context, params CreatePRParams) (*PRInfo, error)

	// FindExistingPR searches for an existing PR from the given source branch.
	// Returns nil, nil if no matching PR is found.
	FindExistingPR(ctx context.Context, sourceBranch string) (*PRInfo, error)

	// RetryBuild retries a failed build by its ID.
	RetryBuild(ctx context.Context, pr *PRInfo, buildID string) error
}

type PRInfo struct {
	// ID is the provider-specific pull request identifier (e.g., numeric ID for ADO).
	ID string
	// Title is the pull request title.
	Title string
	// Description is the pull request description/body text.
	Description string
	// Status is the current PR status (e.g., "active", "completed", "abandoned").
	Status string
	// MergeStatus indicates mergeability (e.g., "succeeded", "conflicts", "queued").
	MergeStatus string
	// SourceBranch is the branch being merged from.
	SourceBranch string
	// TargetBranch is the branch being merged into.
	TargetBranch string
	// Author is the display name of the PR author.
	Author string
	// URL is the web URL to view the pull request.
	URL string
	// RepoID is the repository identifier used for API routing.
	RepoID string
	// Project is the project name (used by ADO for API routing).
	Project string
	// Organization is the organization name (used by ADO for API routing).
	Organization string
}

type PipelineStatus struct {
	// State is the overall pipeline state: "succeeded", "failed", "pending", or "inProgress".
	State string
	// Builds contains information about individual builds associated with the PR.
	Builds []BuildInfo
}

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

type WorkflowAction int