git

type AnalysisParams struct {
	// Scope determines what changes to analyze
	Scope AnalysisScope `json:"scope"`

	// BaseRef is the reference for the base index (default depends on scope)
	// For staged/wip: HEAD
	// For commit: parent commit
	// For range: specified base
	BaseRef string `json:"base_ref,omitempty"`

	// TargetRef is the reference for the working index
	// For range mode, this is the target commit
	TargetRef string `json:"target_ref,omitempty"`

	// Focus specifies which analyses to perform
	// Options: "duplicates", "naming"
	// Default: both
	Focus []string `json:"focus,omitempty"`

	// SimilarityThreshold for duplicate/naming detection (0.0-1.0)
	// Default: 0.8
	SimilarityThreshold float64 `json:"similarity_threshold,omitempty"`

	// MaxFindings limits findings per category
	// Default: 20
	MaxFindings int `json:"max_findings,omitempty"`
}

type AnalysisReport struct {
	// Summary provides high-level statistics
	Summary ReportSummary `json:"summary"`

	// Duplicates contains duplicate code findings
	Duplicates []DuplicateFinding `json:"duplicates,omitempty"`

	// NamingIssues contains naming consistency findings
	NamingIssues []NamingFinding `json:"naming_issues,omitempty"`

	// MetricsIssues contains function metrics findings
	MetricsIssues []MetricsFinding `json:"metrics_issues,omitempty"`

	// Metadata provides analysis context
	Metadata ReportMetadata `json:"metadata"`
}

type AnalysisScope string

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

type AntiPattern struct {
	// Type categorizes the anti-pattern
	Type AntiPatternType `json:"type"`

	// Description explains what was detected
	Description string `json:"description"`

	// Location identifies where in the file (line range or function name)
	Location string `json:"location"`

	// Severity indicates how problematic this is
	Severity AntiPatternSeverity `json:"severity"`

	// Suggestion provides a decoupling recommendation
	Suggestion string `json:"suggestion"`

	// Metrics provides supporting data
	Metrics map[string]int `json:"metrics,omitempty"`
}

type AntiPatternSeverity string

type AntiPatternType string

type CacheStats struct {
	Hits       uint64        `json:"hits"`
	Misses     uint64        `json:"misses"`
	HitRate    float64       `json:"hit_rate"`
	EntryCount int           `json:"entry_count"`
	TTL        time.Duration `json:"ttl_seconds"`
}

type CaseStyle string

type ChangeFrequencyMetadata struct {
	// AnalyzedAt is when the analysis was performed
	AnalyzedAt time.Time `json:"analyzed_at"`

	// TimeWindow is the analysis period
	TimeWindow string `json:"time_window"`

	// WindowStart is the start of the analysis period
	WindowStart time.Time `json:"window_start"`

	// WindowEnd is the end of the analysis period
	WindowEnd time.Time `json:"window_end"`

	// CommitRange describes the analyzed commits
	CommitRange string `json:"commit_range,omitempty"`

	// ComputeTimeMs is how long the analysis took
	ComputeTimeMs int64 `json:"compute_time_ms"`

	// FromCache indicates if results were served from cache
	FromCache bool `json:"from_cache"`
}

type ChangeFrequencyParams struct {
	// TimeWindow specifies the analysis period (default: "30d")
	TimeWindow string `json:"time_window,omitempty"`

	// Granularity specifies analysis level: "file" or "symbol" (default: "file")
	Granularity string `json:"granularity,omitempty"`

	// Focus specifies what to analyze: "hotspots", "collisions", "patterns", "ownership", "all"
	Focus []string `json:"focus,omitempty"`

	// FilePattern is a glob pattern to filter files (e.g., "internal/**/*.go")
	FilePattern string `json:"file_pattern,omitempty"`

	// FilePath is a specific file to analyze
	FilePath string `json:"file_path,omitempty"`

	// SymbolName is a specific symbol to analyze (requires FilePath)
	SymbolName string `json:"symbol_name,omitempty"`

	// MinChanges filters out entities with fewer changes (default: 2)
	MinChanges int `json:"min_changes,omitempty"`

	// MinContributors filters for collision detection (default: 2)
	MinContributors int `json:"min_contributors,omitempty"`

	// TopN limits the number of results (default: 50)
	TopN int `json:"top_n,omitempty"`

	// IncludePatterns is a list of glob patterns to include (overrides default exclusions)
	// If set, only files matching these patterns will be analyzed
	// Example: ["*.go", "*.py", "src/**/*"]
	IncludePatterns []string `json:"include_patterns,omitempty"`

	// ExcludePatterns is a list of additional glob patterns to exclude
	// These are added to the default exclusion list (docs, generated files, etc.)
	// Example: ["*_test.go", "mocks/*", "testdata/*"]
	ExcludePatterns []string `json:"exclude_patterns,omitempty"`

	// SkipDefaultExclusions disables the default file exclusions
	// (CHANGELOG, *.min.js, lock files, vendor/node_modules, etc.)
	// Set to true to analyze all files including generated/documentation
	SkipDefaultExclusions bool `json:"skip_default_exclusions,omitempty"`
}

type ChangeFrequencyReport struct {
	// Summary provides high-level statistics
	Summary ChangeFrequencySummary `json:"summary"`

	// Hotspots lists the most frequently changed files/symbols
	Hotspots []FileChangeFrequency `json:"hotspots,omitempty"`

	// Collisions lists areas with multiple active developers
	Collisions []CollisionZone `json:"collisions,omitempty"`

	// AntiPatterns lists detected conflict-prone patterns
	AntiPatterns []AntiPattern `json:"anti_patterns,omitempty"`

	// SymbolDetails provides symbol-level analysis when requested
	SymbolDetails []SymbolChangeFrequency `json:"symbol_details,omitempty"`

	// Ownership provides module-level ownership information
	Ownership []ModuleOwnership `json:"ownership,omitempty"`

	// Metadata contains analysis context
	Metadata ChangeFrequencyMetadata `json:"metadata"`
}

type ChangeFrequencySummary struct {
	// TotalFilesAnalyzed is the number of files examined
	TotalFilesAnalyzed int `json:"total_files_analyzed"`

	// TotalCommitsAnalyzed is the number of commits in the window
	TotalCommitsAnalyzed int `json:"total_commits_analyzed"`

	// HotspotsFound is the number of high-activity areas found
	HotspotsFound int `json:"hotspots_found"`

	// CollisionZones is the number of multi-developer areas found
	CollisionZones int `json:"collision_zones"`

	// AntiPatternsFound is the number of conflict-prone patterns detected
	AntiPatternsFound int `json:"anti_patterns_found"`

	// HighestChurn identifies the most volatile file
	HighestChurn string `json:"highest_churn,omitempty"`

	// MostActiveContributor identifies the top contributor
	MostActiveContributor string `json:"most_active_contributor,omitempty"`
}

type ChangedFile struct {
	// Path is the current file path
	Path string `json:"path"`

	// OldPath is the previous path (for renames)
	OldPath string `json:"old_path,omitempty"`

	// Status indicates the type of change
	Status FileChangeStatus `json:"status"`

	// LinesAdded is the number of lines added
	LinesAdded int `json:"lines_added"`

	// LinesDeleted is the number of lines deleted
	LinesDeleted int `json:"lines_deleted"`
}

type ChurnFilterConfig struct {
	IncludePatterns       []string
	ExcludePatterns       []string
	SkipDefaultExclusions bool
}

type CodeLocation struct {
	// FilePath is the file path
	FilePath string `json:"file_path"`

	// StartLine is the starting line number
	StartLine int `json:"start_line"`

	// EndLine is the ending line number
	EndLine int `json:"end_line"`

	// SymbolName is the name of the containing symbol (if applicable)
	SymbolName string `json:"symbol_name,omitempty"`

	// Snippet is a code snippet for context
	Snippet string `json:"snippet,omitempty"`
}

type CollisionSeverity = FindingSeverity

type CollisionZone struct {
	// EntityType is "file" or "symbol"
	EntityType string `json:"entity_type"`

	// Path is the file path
	Path string `json:"path"`

	// SymbolName is the symbol name (if EntityType is "symbol")
	SymbolName string `json:"symbol_name,omitempty"`

	// Contributors lists the developers working on this area
	Contributors []ContributorActivity `json:"contributors"`

	// CollisionScore is a 0-1 score indicating collision risk
	CollisionScore float64 `json:"collision_score"`

	// Severity categorizes the risk level
	Severity CollisionSeverity `json:"severity"`

	// Recommendation provides actionable guidance
	Recommendation string `json:"recommendation"`

	// RecentChanges is the number of changes in the last 7 days
	RecentChanges int `json:"recent_changes"`
}

type CommitInfo struct {
	// Hash is the commit SHA
	Hash string `json:"hash"`

	// AuthorName is the commit author name
	AuthorName string `json:"author_name"`

	// AuthorEmail is the commit author email
	AuthorEmail string `json:"author_email"`

	// Timestamp is when the commit was made
	Timestamp time.Time `json:"timestamp"`

	// Message is the commit message (first line)
	Message string `json:"message,omitempty"`

	// FileChanges lists files changed in this commit
	FileChanges []FileChange `json:"file_changes,omitempty"`
}

type ContributorActivity struct {
	// AuthorName is the git author name
	AuthorName string `json:"author_name"`

	// AuthorEmail is the git author email
	AuthorEmail string `json:"author_email"`

	// ChangeCount is the number of commits by this author
	ChangeCount int `json:"change_count"`

	// LinesAdded is total lines added by this author
	LinesAdded int `json:"lines_added"`

	// LinesDeleted is total lines deleted by this author
	LinesDeleted int `json:"lines_deleted"`

	// OwnershipShare is the fraction of changes by this author (0-1)
	OwnershipShare float64 `json:"ownership_share"`

	// LastChangeAt is when this author last modified the entity
	LastChangeAt time.Time `json:"last_change_at"`
}

type DiffSize string

type DiffStats struct {
	FilesAdded    int `json:"files_added"`
	FilesModified int `json:"files_modified"`
	FilesDeleted  int `json:"files_deleted"`
	FilesRenamed  int `json:"files_renamed"`
	TotalAdded    int `json:"total_lines_added"`
	TotalDeleted  int `json:"total_lines_deleted"`
}

type DuplicateFinding struct {
	// Severity indicates the importance
	Severity FindingSeverity `json:"severity"`

	// Description provides a human-readable summary
	Description string `json:"description"`

	// NewCode is the location in the changed code
	NewCode CodeLocation `json:"new_code"`

	// ExistingCode is the location in the existing codebase
	ExistingCode CodeLocation `json:"existing_code"`

	// Similarity is the similarity score (0.0-1.0)
	Similarity float64 `json:"similarity"`

	// Type indicates exact, structural, or semantic duplicate
	Type string `json:"type"`

	// Suggestion provides actionable advice
	Suggestion string `json:"suggestion"`
}

type FileChange struct {
	// Path is the file path
	Path string `json:"path"`

	// OldPath is the previous path (for renames)
	OldPath string `json:"old_path,omitempty"`

	// LinesAdded is the number of lines added
	LinesAdded int `json:"lines_added"`

	// LinesDeleted is the number of lines deleted
	LinesDeleted int `json:"lines_deleted"`

	// Status is the change type (A/M/D/R)
	Status string `json:"status"`
}

type FileChangeFrequency struct {
	// FilePath is the path to the file
	FilePath string `json:"file_path"`

	// Metrics contains frequency data per time window
	Metrics map[TimeWindow]*FrequencyMetrics `json:"metrics"`

	// Contributors lists authors and their activity
	Contributors []ContributorActivity `json:"contributors"`

	// AntiPatterns lists detected conflict-prone patterns
	AntiPatterns []AntiPattern `json:"anti_patterns,omitempty"`

	// LineCount is the current line count of the file
	LineCount int `json:"line_count,omitempty"`
}

type FileChangeStatus string

type FindingSeverity string

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

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

type FrequencyFocus string

type FrequencyGranularity string

type FrequencyMetrics struct {
	// ChangeCount is the number of commits touching this entity
	ChangeCount int `json:"change_count"`

	// LinesAdded is the total lines added in the time window
	LinesAdded int `json:"lines_added"`

	// LinesDeleted is the total lines deleted in the time window
	LinesDeleted int `json:"lines_deleted"`

	// UniqueAuthors is the number of distinct contributors
	UniqueAuthors int `json:"unique_authors"`

	// FirstChangeAt is the earliest change in the window
	FirstChangeAt time.Time `json:"first_change_at,omitempty"`

	// LastChangeAt is the most recent change in the window
	LastChangeAt time.Time `json:"last_change_at,omitempty"`

	// ChangeRate is the number of changes per day
	ChangeRate float64 `json:"change_rate"`

	// VolatilityScore is a 0-1 score indicating how volatile this entity is
	// Higher values indicate more frequent, larger changes by multiple authors
	VolatilityScore float64 `json:"volatility_score"`
}

type HistoryProvider struct {
	*Provider
}

type Language string

type MetricsFinding struct {
	// Severity indicates how critical this finding is
	Severity FindingSeverity `json:"severity"`

	// Description is a human-readable description of the issue
	Description string `json:"description"`

	// Symbol is the function/method with the metrics issue
	Symbol SymbolInfo `json:"symbol"`

	// IssueType categorizes the metrics problem
	IssueType MetricsIssueType `json:"issue_type"`

	// Issue is a short issue summary
	Issue string `json:"issue"`

	// Suggestion provides guidance on fixing the issue
	Suggestion string `json:"suggestion"`

	// OldMetrics contains the previous metrics (for modified symbols)
	OldMetrics *SymbolMetrics `json:"old_metrics,omitempty"`

	// NewMetrics contains the current metrics
	NewMetrics *SymbolMetrics `json:"new_metrics,omitempty"`
}

type MetricsIssueType string

type MetricsThresholds struct {
	// HighComplexity is the cyclomatic complexity threshold (default: 10)
	HighComplexity int

	// LongFunction is the lines of code threshold (default: 100)
	LongFunction int

	// DeepNesting is the nesting depth threshold (default: 4)
	DeepNesting int

	// ComplexityGrowthThreshold is the percentage increase to flag (default: 50)
	ComplexityGrowthThreshold int
}

type ModuleOwnership struct {
	// ModulePath is the directory path
	ModulePath string `json:"module_path"`

	// PrimaryOwner is the main contributor
	PrimaryOwner ContributorActivity `json:"primary_owner"`

	// SecondaryOwners are other significant contributors
	SecondaryOwners []ContributorActivity `json:"secondary_owners,omitempty"`

	// TotalChanges is the total change count in this module
	TotalChanges int `json:"total_changes"`

	// FileCount is the number of files in this module
	FileCount int `json:"file_count"`
}

type NamingConvention struct {
	// ExpectedStyles maps symbol kinds to their expected case styles
	// Multiple styles means any of them is acceptable
	ExpectedStyles map[SymbolKind][]CaseStyle
	// Description provides human-readable explanation
	Description string
}

type NamingFinding struct {
	// Severity indicates the importance
	Severity FindingSeverity `json:"severity"`

	// Description provides a human-readable summary
	Description string `json:"description"`

	// NewSymbol is the symbol with the naming issue
	NewSymbol SymbolInfo `json:"new_symbol"`

	// SimilarNames are existing symbols with similar names
	SimilarNames []SymbolInfo `json:"similar_names"`

	// IssueType categorizes the naming issue
	IssueType NamingIssueType `json:"issue_type"`

	// Issue provides details about the problem
	Issue string `json:"issue"`

	// Suggestion provides the recommended name
	Suggestion string `json:"suggestion"`
}

type NamingIssueType string

type PatternDetector struct {
	// Configurable thresholds
	RegistrationCallsThreshold int
	EnumValuesThreshold        int
	GodObjectLinesThreshold    int
	SwitchCasesThreshold       int
	ConfigFieldsThreshold      int
	BarrelExportRatioThreshold float64
}

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

type ReportMetadata struct {
	// BaseRef is the base reference used
	BaseRef string `json:"base_ref"`

	// TargetRef is the target reference used
	TargetRef string `json:"target_ref"`

	// Scope is the analysis scope
	Scope AnalysisScope `json:"scope"`

	// AnalyzedAt is when the analysis was performed
	AnalyzedAt time.Time `json:"analyzed_at"`

	// AnalysisTimeMs is how long the analysis took
	AnalysisTimeMs int64 `json:"analysis_time_ms"`

	// Truncated indicates if findings were limited
	Truncated bool `json:"truncated,omitempty"`

	// TotalDuplicates is the actual count before truncation
	TotalDuplicates int `json:"total_duplicates,omitempty"`

	// TotalNamingIssues is the actual count before truncation
	TotalNamingIssues int `json:"total_naming_issues,omitempty"`

	// TotalMetricsIssues is the actual count before truncation
	TotalMetricsIssues int `json:"total_metrics_issues,omitempty"`
}

type ReportSummary struct {
	// FilesChanged is the number of files with changes
	FilesChanged int `json:"files_changed"`

	// SymbolsAdded is the count of new symbols
	SymbolsAdded int `json:"symbols_added"`

	// SymbolsModified is the count of modified symbols
	SymbolsModified int `json:"symbols_modified"`

	// SymbolsDeleted is the count of deleted symbols
	SymbolsDeleted int `json:"symbols_deleted"`

	// DuplicatesFound is the count of duplicate findings
	DuplicatesFound int `json:"duplicates_found"`

	// NamingIssuesFound is the count of naming issues
	NamingIssuesFound int `json:"naming_issues_found"`

	// MetricsIssuesFound is the count of function metrics issues
	MetricsIssuesFound int `json:"metrics_issues_found"`

	// RiskScore indicates overall risk (0.0 = safe, 1.0 = risky)
	RiskScore float64 `json:"risk_score"`

	// TopRecommendation is the highest priority suggestion
	TopRecommendation string `json:"top_recommendation,omitempty"`
}

type SymbolChangeFrequency struct {
	// SymbolName is the name of the function/class/etc
	SymbolName string `json:"symbol_name"`

	// SymbolType is the kind of symbol (function, class, method, etc)
	SymbolType string `json:"symbol_type"`

	// FilePath is the file containing the symbol
	FilePath string `json:"file_path"`

	// StartLine is the current starting line of the symbol
	StartLine int `json:"start_line"`

	// EndLine is the current ending line of the symbol
	EndLine int `json:"end_line"`

	// Metrics contains frequency data per time window
	Metrics map[TimeWindow]*FrequencyMetrics `json:"metrics"`

	// Contributors lists authors and their activity on this symbol
	Contributors []ContributorActivity `json:"contributors"`
}

type SymbolDiff struct {
	Added    []SymbolInfo `json:"added"`
	Removed  []SymbolInfo `json:"removed"`
	Modified []SymbolInfo `json:"modified"`
}

type SymbolInfo struct {
	// Name is the symbol name
	Name string `json:"name"`

	// Type is the symbol type (function, class, etc.) as a string
	Type string `json:"type"`

	// FilePath is the file containing the symbol
	FilePath string `json:"file_path"`

	// Line is the line number
	Line int `json:"line"`

	// EndLine is the ending line number
	EndLine int `json:"end_line,omitempty"`

	// Complexity is the cyclomatic complexity (if available)
	Complexity int `json:"complexity,omitempty"`

	// LinesOfCode is the number of lines in the function/method
	LinesOfCode int `json:"lines_of_code,omitempty"`

	// NestingDepth is the maximum nesting depth
	NestingDepth int `json:"nesting_depth,omitempty"`

	// IsPure indicates if the function has no side effects
	IsPure bool `json:"is_pure,omitempty"`

	// SideEffects lists the detected side effect categories (e.g., "param-write", "io", "global-write")
	SideEffects []string `json:"side_effects,omitempty"`

	// Content is the symbol's code content (for duplicate detection)
	Content string `json:"-"`
}

type SymbolKind string

type SymbolMetrics struct {
	Complexity   int      `json:"complexity"`
	LinesOfCode  int      `json:"lines_of_code"`
	NestingDepth int      `json:"nesting_depth"`
	IsPure       bool     `json:"is_pure,omitempty"`
	SideEffects  []string `json:"side_effects,omitempty"`
}

type TimeWindow string