agent

type AIBackend interface {
	Validate() error
	RunIteration(ctx *Context, prompt string, display func() string) (*BackendResult, error)
	RunCommit(ctx *Context, prompt string) error
	Name() string
}

type BackendResult struct {
	Type         string  `json:"type"`
	Result       string  `json:"result"`
	IsError      bool    `json:"is_error"`
	TotalCostUSD float64 `json:"total_cost_usd"`
}

type ClaudeCodeBackend struct{}

type CodexBackend struct{}

type Context struct {
	Prompt              string
	Model               string
	MaxRuns             int
	MaxCost             float64
	MaxDuration         time.Duration
	EnableCommits       bool
	EnableBranches      bool
	BranchPrefix        string
	MergeStrategy       string
	NotesFile           string
	DryRun              bool
	Debug               bool
	CompletionSignal    string
	CompletionThreshold int
	ReviewPrompt        string
	CIRetryEnabled      bool
	CIRetryMax          int
	WorktreeName        string
	WorktreeBaseDir     string
	CleanupWorktree     bool
	Backend             AIBackend
	RunContext          context.Context
	RunCancel           context.CancelFunc

	// 仓库提供商抽象
	RepoProvider RepositoryProvider
	RepoInfo     *RepositoryInfo

	SuccessfulIterations int
	ErrorCount           int
	ExtraIterations      int
	TotalCost            float64
	CompletionCount      int
	StartTime            time.Time

	OnComplete string
	OnError    string
	OnFinish   string
}

type CoolProvider struct {
	Endpoint string
	// contains filtered or unexported fields
}

type GitHubProvider struct{}

type MergeStrategy string

type OpencodeBackend struct{}

type PRCheckResult struct {
	State  string `json:"state"`
	Bucket string `json:"bucket"`
}

type PRCreateOptions struct {
	Title        string
	Body         string
	SourceBranch string
	TargetBranch string
}

type PRInfo struct {
	ReviewDecision string `json:"reviewDecision"`
	ReviewRequests []struct {
		Login string `json:"login"`
	} `json:"reviewRequests"`
	State      string `json:"state"`
	HeadRefOid string `json:"headRefOid"`
}

type PRReviewStatus struct {
	ReviewDecision string   // APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED, ""
	ReviewRequests []string // 待审查者列表
}

type PRStatus struct {
	State     string // open, merged, closed
	CIStatus  string // pending, success, failure
	CIRunID   string
	ChecksURL string
}

type ProviderOptions struct {
	Endpoint string // API 端点 (可选，有默认值)
	APIKey   string // API Key (可选)
}

type PullRequestInfo struct {
	ID     string
	Number int
	URL    string
}

type RepositoryInfo struct {
	Provider string // github, cool, etc.
	Owner    string // 所有者/组织
	Repo     string // 仓库名（完整路径，如 "owner/repo"）
}

type RepositoryProvider interface {
	// Name 返回提供商名称 (github, cool, etc.)
	Name() string

	// Validate 验证配置和环境
	Validate(ctx *Context) error

	// DetectFromGit 从 git remote 自动检测仓库信息
	DetectFromGit() (*RepositoryInfo, error)

	// CreatePullRequest 创建 PR/MR
	CreatePullRequest(ctx *Context, opts *PRCreateOptions) (*PullRequestInfo, error)

	// MergePullRequest 合并 PR
	MergePullRequest(ctx *Context, prID string, strategy MergeStrategy) error

	// GetPRStatus 获取 PR 的 CI 状态
	GetPRStatus(ctx *Context, prID string) (*PRStatus, error)

	// GetPRChecks 获取 PR 检查项详细信息
	GetPRChecks(ctx *Context, prID string) ([]PRCheckResult, error)

	// GetPRReviewStatus 获取 PR 审查状态
	GetPRReviewStatus(ctx *Context, prID string) (*PRReviewStatus, error)

	// UpdatePRBranch 更新 PR 分支与目标分支同步
	UpdatePRBranch(ctx *Context, prID string) error

	// ClosePullRequest 关闭 PR
	ClosePullRequest(ctx *Context, prID string, deleteBranch bool) error

	// GetFailedWorkflowRun 获取 PR 的失败 workflow run ID
	GetFailedWorkflowRun(ctx *Context, prID string) (string, error)

	// SupportsBranches 是否支持分支工作流
	SupportsBranches() bool

	// SupportsCI 是否支持 CI 集成
	SupportsCI() bool
}

type WorkflowRun struct {
	DatabaseId int `json:"databaseId"`
}