agent

type InlineComment struct {
	Path     string `json:"path"`
	Line     int    `json:"line"`
	Body     string `json:"body"`
	Severity string `json:"severity"` // "blocking" or "nit"
	// OutsideDiff is set by Ghost (not the agent) when Line isn't part of
	// the PR's diff, so GitHub won't accept the comment inline.
	OutsideDiff bool `json:"outside_diff,omitempty"`
}

type ReviewRequest struct {
	Dir        string  // PR worktree; the agent's working directory
	ContextDir string  // Ghost-written review materials (diff, commits), outside Dir
	Prompt     string  // BuildPrompt output
	MaxCostUSD float64 // 0 = no per-review cap
}

type ReviewResult struct {
	Summary  string          `json:"summary"`
	Verdict  Verdict         `json:"verdict"`
	Comments []InlineComment `json:"comments"`
	CostUSD  float64         `json:"-"`
	Raw      string          `json:"-"` // full agent output, for the audit trail
}

type Reviewer interface {
	Name() string
	// Review runs one review. CostUSD is set whenever the agent reported a
	// cost, including when an error is returned.
	Review(ctx context.Context, req ReviewRequest) (ReviewResult, error)
}

type Verdict string