review

type BranchContext struct {
	RepoRoot   string
	Branch     string
	BaseBranch string
	Files      []FileChange
	Stats      DiffStats
	Diff       string
	Unstaged   string
	RecentLog  string
	AgentsMD   string
}

type BranchContextOptions struct {
	MaxDiffBytes    int
	IncludeUnstaged bool
	IncludeAgents   bool
	BaseBranch      string // Defaults to main or master
}

type DiffStats struct {
	Files      int
	Insertions int
	Deletions  int
}

type FileChange struct {
	Status  string
	Path    string
	OldPath string
}

type Finding struct {
	ID           string   // e.g., "FINDING-001"
	Severity     Severity // CRITICAL, MAJOR, MINOR
	Title        string   // Brief description
	File         string   // File path
	Line         int      // Line number (0 if not specified)
	Evidence     string   // Proof of the issue
	Impact       string   // Business/technical impact
	Fix          string   // Description of fix
	SuggestedFix string   // Code block with suggested fix
}

type FixResult struct {
	// Summary describes what was changed
	Summary string

	// FilesChanged lists files that were modified
	FilesChanged []string

	// Trace contains transparency data
	Trace *transparency.Trace

	// Error if fix failed
	Error error
}

type Grade string

type PRCheck struct {
	Name       string
	Status     string
	Conclusion string
}

type PRComment struct {
	Author string
	Body   string
	Path   string // For review comments
	Line   int
}

type PRContext struct {
	PR       *PRInfo
	Diff     string
	Comments []PRComment
	Checks   []PRCheck
	Files    []string
}

type PRInfo struct {
	Number       int
	Title        string
	Author       string
	State        string
	URL          string
	Body         string
	CIStatus     string
	Labels       []string
	BaseBranch   string
	HeadBranch   string
	Additions    int
	Deletions    int
	ChangedFiles int
}

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

type ParsedReview struct {
	Grade       Grade
	Summary     string
	BuildStatus string
	TestStatus  string
	Findings    []Finding
	Remarks     []string
	Approved    bool
	Blockers    []string // Finding IDs
	Suggestions []string // Finding IDs
	RawReview   string
}

type ProjectContext struct {
	RepoRoot    string
	Branch      string
	Tree        string
	GoMod       string
	PackageJSON string
	ReadmeMD    string
	AgentsMD    string
	RecentLog   string
}

type ProjectContextOptions struct {
	MaxTreeDepth  int
	IncludeAgents bool
}

type RunResult struct {
	// Review is the generated review (markdown)
	Review string

	// Parsed contains the structured review data (populated by Parse())
	Parsed *ParsedReview

	// Trace contains transparency data
	Trace *transparency.Trace

	// ContextAudit shows what context was sent
	ContextAudit *transparency.ContextAudit

	// PRInfo contains PR metadata (for PR reviews)
	PRInfo *PRInfo

	// Error if generation failed
	Error error
}

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

type RunnerConfig struct {
	// For RLM-based execution (preferred)
	Models   *model.Manager
	Registry *tool.Registry
	ModelID  string

	// Legacy config (used if Models not provided)
	Invoker *oneshot.DefaultInvoker
	Ledger  *transparency.CostLedger
}

type Severity string

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