review

type AIAnalysisResult struct {
	Insights []AIInsight `json:"insights"`
}

type AIAnalyzer struct {
	LLM LLMClient
}

type AIFixResult struct {
	OldCode string `json:"old_code"`
	NewCode string `json:"new_code"`
}

type AIFixer struct {
	*Fixer
	AIAnalyzer *AIAnalyzer
}

type AIInsight struct {
	Severity    string  `json:"severity"`    // critical, warning, info
	Category    string  `json:"category"`    // security, performance, bug, readability
	Line        int     `json:"line"`        // 1-indexed line number
	Description string  `json:"description"` // Problem description
	Suggestion  string  `json:"suggestion"`  // Fix suggestion
	Confidence  float64 `json:"confidence"`  // 0.0-1.0
}

type Analyzer struct {
	Now func() time.Time
}

type AnalyzerOptions struct {
	Focus           ReviewFocus
	MaxIssues       int
	MaxSnippetLines int
}

type FileChange struct {
	FilePath   string
	Patches    []Patch
	BackupPath string // Set after backup is created
}

type FixChoice string

type FixOptions struct {
	// MaxFixes caps proposals.
	// 0 means default (50).
	MaxFixes int
}

type FixProposal struct {
	IssueID   string
	Title     string
	Rationale string

	// Example is a code snippet (not necessarily a patch).
	Example string

	// Patch is a best-effort unified diff proposal. It may be empty.
	Patch string

	// Safety notes and constraints.
	Notes []string

	// Actionable indicates whether this fix can be automatically applied.
	// If false, this is a suggestion-only proposal.
	Actionable bool

	// FilePath is the target file for actionable fixes.
	FilePath string

	// OldCode is the code to be replaced (for str_replace style fixes).
	OldCode string

	// NewCode is the replacement code.
	NewCode string
}

type FixResult struct {
	Applied int
	Skipped int
	Failed  int
	Quit    bool
}

type Fixer struct {
	Now func() time.Time
}

type InteractiveFixer struct {
	Reader   *bufio.Reader
	AutoAll  bool // Skip prompts and apply all
	Parallel bool // Enable parallel execution
	Workers  int  // Number of parallel workers (default 4)
}

type Issue struct {
	ID          string
	Title       string
	Description string
	Severity    Severity
	Path        string
	LineStart   int
	LineEnd     int
	Snippet     string
	Suggestions []string
	Tags        []string
}

type LLMClient interface {
	Chat(prompt string) (string, error)
}

type MultiFileApplier struct {
	BackupDir string
}

type MultiFileChange struct {
	ID          string
	Description string
	Changes     []FileChange
}

type MultiFixChoice string

type MultiFixResult struct {
	Applied    int
	Skipped    int
	Failed     int
	RolledBack bool
	Quit       bool
}

type Options struct {
	All   bool
	Paths []string

	Focus ReviewFocus

	Mode     string // "changes" or "diff" (best-effort label)
	Provider string
	Model    string

	OutputDir string

	MaxIssues       int
	MaxSnippetLines int
}

type Orchestrator struct {
	Scanner    *Scanner
	Analyzer   *Analyzer
	Fixer      *Fixer
	AIAnalyzer *AIAnalyzer
	Reporter   *Reporter

	Now func() time.Time
}

type Patch struct {
	// StartLine is 1-indexed inclusive start line (0 means use OldCode matching).
	StartLine int
	// EndLine is 1-indexed inclusive end line (0 means use OldCode matching).
	EndLine int
	// OldCode is the code to be replaced (used when StartLine/EndLine are 0).
	OldCode string
	// NewCode is the replacement code.
	NewCode string
}

type Report struct {
	GeneratedAt time.Time
	Mode        string
	Provider    string
	Model       string

	Targets []Target
	Issues  []Issue

	Summary string
}

type Reporter struct {
	Now func() time.Time
}

type ReporterOptions struct {
	OutputDir string
	// FileName can be specified for tests; when empty, auto-generated.
	FileName string

	// Permissions
	DirPerm  os.FileMode
	FilePerm os.FileMode

	// IncludeDiff controls whether diff content is embedded into report.
	// Default true, but some callers may want to omit for safety.
	IncludeDiff bool
}

type ReviewFocus struct {
	Security bool
	Test     bool
}

type ScanOptions struct {
	All bool
	// Paths filters targets when All==true (git diff). If empty, all changed files.
	Paths []string

	// GitArgs allows customizing the git diff command (mainly for tests or future extension).
	// Example: []string{"diff", "--cached"}
	GitArgs []string

	// MaxSnippetLines limits diff snippet lines for changeStack-based scanning.
	// 0 means default (200).
	MaxSnippetLines int
}

type Scanner struct {
	// If provided, used for timestamps in outputs and testability.
	Now func() time.Time
}

type Severity string

type Target struct {
	Path       string
	OldPath    string
	ChangeType string // "A","M","D","R" etc. Best-effort.
	Diff       string // unified diff (best-effort)
}