review

type Category string

type Event struct {
	Kind EventKind
	Text string
}

type EventKind int

type Finding struct {
	ID         string
	File       string // new path, repo-relative
	OldFile    string // as reported by the model for renames; advisory only
	Line       LineRef
	Severity   Severity
	Category   Category
	Title      string
	Body       string // markdown, user-editable
	Suggestion string // optional replacement for the flagged line
	State      FindingState
}

type FindingState int

type LineRef struct {
	OldLine *int
	NewLine *int
}

type Request struct {
	// RepoPath is the checkout the review runs in (the subprocess cwd).
	RepoPath string
	// MR carries metadata shown to the model (title, description, branches).
	MR gitlabx.MRDetail
	// Diffs is the bounded, pre-filtered set of file diffs to review.
	Diffs []gitlabx.FileDiff
	// Truncated lists files that were excluded or cut by the diff budget.
	Truncated []string
	// Instructions is extra prompt text: global then per-project.
	Instructions string
	// Categories to report on.
	Categories []Category

	Model        string
	Timeout      time.Duration
	MaxBudgetUSD float64
}

type Result struct {
	Summary   string
	Findings  []Finding
	Warnings  []string // dropped findings, truncation notes
	SessionID string
	CostUSD   float64
	Raw       []byte // raw output for drift debugging; persisted by the caller
}

type Reviewer interface {
	Name() string
	// CheckAvailable verifies the backend can run (binary present, version
	// supported) and returns a user-actionable error otherwise.
	CheckAvailable(ctx context.Context) error
	Review(ctx context.Context, req Request, onEvent func(Event)) (*Result, error)
}

type Severity string