types

type AnalysisResult struct {
	Name     string                     // Name of the analysis (e.g., "complexity")
	Category string                     // Category identifier (e.g., "C1", "C3", "C6")
	Metrics  map[string]CategoryMetrics // Analysis metrics
}

type AnalysisTarget struct {
	Language Language
	RootDir  string       // Project root directory
	Files    []SourceFile // Source files for this language
}

type C1Metrics struct {
	CyclomaticComplexity MetricSummary
	FunctionLength       MetricSummary
	FileSize             MetricSummary
	LargeFilePct         float64        // percentage of files > 500 LOC
	AfferentCoupling     map[string]int // pkg path -> incoming dep count
	EfferentCoupling     map[string]int // pkg path -> outgoing dep count
	DuplicationRate      float64        // percentage 0-100
	DuplicatedBlocks     []DuplicateBlock
	Functions            []FunctionMetric // per-function detail
}

type C2LanguageMetrics struct {
	TypeAnnotationCoverage float64 // % of functions/params with type annotations (0-100)
	NamingConsistency      float64 // % of identifiers following convention (0-100)
	MagicNumberRatio       float64 // magic numbers per 1000 LOC
	TypeStrictness         float64 // 0 or 1: strict mode on/off (Python mypy, TS strict)
	NullSafety             float64 // % of pointer/nullable usages with safety checks (0-100)
	TotalFunctions         int     // total functions analyzed
	TotalIdentifiers       int     // total identifiers checked for naming
	MagicNumberCount       int     // raw count of magic numbers
	LOC                    int     // lines of code for this language
	// Unavailable tracks metrics not applicable for this language.
	// Keyed by metric name (e.g., "null_safety"). Unavailable metrics are
	// excluded from the weighted average during scoring.
	Unavailable map[string]bool
}

type C2Metrics struct {
	PerLanguage map[Language]*C2LanguageMetrics
	Aggregate   *C2LanguageMetrics // LOC-weighted aggregate
}

type C3Metrics struct {
	MaxDirectoryDepth int
	AvgDirectoryDepth float64
	ModuleFanout      MetricSummary // avg refs per module
	CircularDeps      [][]string    // each cycle as list of package paths
	ImportComplexity  MetricSummary // avg relative path segments
	DeadExports       []DeadExport  // unreferenced exported symbols
}

type C4Metrics struct {
	Available           bool
	ReadmePresent       bool
	ReadmeWordCount     int
	CommentDensity      float64 // % lines with comments (0-100)
	APIDocCoverage      float64 // % public APIs with docstrings (0-100)
	ChangelogPresent    bool
	ChangelogDaysOld    int // -1 if not present
	DiagramsPresent     bool
	ExamplesPresent     bool
	ContributingPresent bool
	// Counts for verbose output
	TotalSourceLines int
	CommentLines     int
	PublicAPIs       int
	DocumentedAPIs   int

	// LLM-based metrics (only populated if --enable-c4-llm is used)
	LLMEnabled        bool    // true if LLM analysis was performed
	ReadmeClarity     int     // 1-10 scale
	ExampleQuality    int     // 1-10 scale
	Completeness      int     // 1-10 scale
	CrossRefCoherence int     // 1-10 scale
	LLMCostUSD        float64 // Actual cost incurred
	LLMTokensUsed     int     // Total tokens used
	LLMFilesSampled   int     // Number of files sampled for LLM analysis
}

type C5Metrics struct {
	Available            bool
	ChurnRate            float64       // avg lines changed per commit (90-day window)
	TemporalCouplingPct  float64       // % of file pairs with >70% co-change rate
	AuthorFragmentation  float64       // avg distinct authors per file (90-day window)
	CommitStability      float64       // median days between changes per file
	HotspotConcentration float64       // % of total changes in top 10% of files
	TopHotspots          []FileChurn   // top churning files (up to 10)
	CoupledPairs         []CoupledPair // detected temporal couplings
	TotalCommits         int
	TimeWindowDays       int
	RepoStalenessMonths  float64 // months since HEAD commit (wall-clock staleness)
}

type C6Metrics struct {
	TestFileCount    int
	SourceFileCount  int
	TestToCodeRatio  float64       // test LOC / source LOC
	CoveragePercent  float64       // -1 if not available
	CoverageSource   string        // "go-cover", "lcov", "cobertura", "none"
	TestIsolation    float64       // percentage of tests without external deps
	AssertionDensity MetricSummary // assertions per test function
	TestFunctions    []TestFunctionMetric
}

type C7DebugSample struct {
	FilePath    string       `json:"file_path"`
	Description string       `json:"description"`
	Prompt      string       `json:"prompt"`
	Response    string       `json:"response"`
	Score       int          `json:"score"`
	Duration    float64      `json:"duration_seconds"`
	ScoreTrace  C7ScoreTrace `json:"score_trace"`
	Error       string       `json:"error,omitempty"`
}

type C7IndicatorMatch struct {
	Name    string `json:"name"`    // e.g., "positive:returns", "negative:unclear"
	Matched bool   `json:"matched"` // Whether the indicator was found
	Delta   int    `json:"delta"`   // Point contribution (+1, -1, +2, etc.)
}

type C7MetricResult struct {
	MetricID     string          // e.g., "task_execution_consistency"
	MetricName   string          // e.g., "Task Execution Consistency"
	Score        int             // 1-10
	Status       string          // completed, timeout, error
	Duration     float64         // seconds
	Reasoning    string          // scoring rationale
	Samples      []string        // sample descriptions used
	DebugSamples []C7DebugSample `json:"debug_samples,omitempty"` // only present when debug active
}

type C7Metrics struct {
	Available bool // false if claude CLI not found or user declined

	// Legacy 4-task scores (0-100 scale) - preserved for backward compatibility
	IntentClarity          int // 0-100 score
	ModificationConfidence int // 0-100 score
	CrossFileCoherence     int // 0-100 score
	SemanticCompleteness   int // 0-100 score

	// NEW: 5 MECE metrics (1-10 scale)
	TaskExecutionConsistency       int // M1: Reproducibility across runs (1-10)
	CodeBehaviorComprehension      int // M2: Understanding what code does (1-10)
	CrossFileNavigation            int // M3: Tracing dependencies across files (1-10)
	IdentifierInterpretability     int // M4: Inferring meaning from names (1-10)
	DocumentationAccuracyDetection int // M5: Detecting comment/code mismatches (1-10)

	// Aggregate scores
	OverallScore float64 // Legacy: average of 4 task scores (0-100)
	MECEScore    float64 // NEW: weighted average of 5 MECE metrics (1-10)

	// Detailed results
	TaskResults   []C7TaskResult   // Legacy task results
	MetricResults []C7MetricResult // NEW: MECE metric results

	// Execution metadata
	TotalDuration float64 // seconds
	TokensUsed    int     // estimated total tokens
	CostUSD       float64 // estimated cost
}

type C7ScoreTrace struct {
	BaseScore  int                `json:"base_score"`  // Starting score before adjustments
	Indicators []C7IndicatorMatch `json:"indicators"`  // Each indicator checked
	FinalScore int                `json:"final_score"` // Score after clamping to 1-10
}

type C7TaskResult struct {
	TaskID    string  // e.g., "intent_clarity"
	TaskName  string  // e.g., "Intent Clarity"
	Score     int     // 0-100
	Status    string  // completed, timeout, error
	Duration  float64 // seconds
	Reasoning string  // scoring rationale from LLM judge
}

type CategoryMetrics interface {
	IsCategoryMetrics()
}

type CategoryScore struct {
	Name      string     // Category identifier (e.g., "C1")
	Score     float64    // Weighted average of sub-scores (1-10)
	Weight    float64    // Weight in composite score
	SubScores []SubScore // Per-metric sub-scores
}

type CoupledPair struct {
	FileA         string
	FileB         string
	Coupling      float64 // 0-100 percentage
	SharedCommits int
}

type DeadExport struct {
	Package string
	Name    string
	File    string
	Line    int
	Kind    string // "func", "type", "var", "const"
}

type DiscoveredFile struct {
	Path          string    // Absolute path to the file
	RelPath       string    // Path relative to project root
	Class         FileClass // Classification of the file
	ExcludeReason string    // Why file was excluded (empty if not excluded)
	Language      Language  // Programming language of the file
}

type DuplicateBlock struct {
	FileA     string
	StartA    int
	EndA      int
	FileB     string
	StartB    int
	EndB      int
	LineCount int
}

type EvidenceItem struct {
	FilePath    string  `json:"file_path"`
	Line        int     `json:"line"`
	Value       float64 `json:"value"`
	Description string  `json:"description"`
}

type ExitError struct {
	Code    int
	Message string
}

type FileChurn struct {
	Path         string
	TotalChanges int
	CommitCount  int
	AuthorCount  int
}

type FileClass int

type FunctionMetric struct {
	Package    string
	Name       string
	File       string
	Line       int
	Complexity int
	LineCount  int
}

type Language string

type MetricSummary struct {
	Avg       float64
	Max       int
	MaxEntity string // which function/file has the max
}

type RepoMetadata struct {
	Available         bool                 // false if not a git repo
	LinesOfCode       int                  // total source LOC (excluding tests, generated, vendor)
	FirstCommitDate   time.Time            // date of the first commit
	LastCommitDate    time.Time            // date of the most recent commit
	ContributorCount  int                  // number of unique contributors
	TotalCommits      int                  // total number of commits
	LanguageBreakdown map[Language]float64 // language -> percentage of source LOC
}

type ScanResult struct {
	RootDir        string           // Absolute path to project root
	TotalFiles     int              // Total files discovered
	SourceCount    int              // Number of source files
	TestCount      int              // Number of test files
	GeneratedCount int              // Number of generated files
	VendorCount    int              // Number of vendor-excluded files
	GitignoreCount int              // Number of gitignore-excluded files
	SkippedCount   int              // Files/dirs skipped due to errors (permission denied, broken paths, etc.)
	SymlinkCount   int              // Symlinks detected and skipped
	Files          []DiscoveredFile // All discovered files
	PerLanguage    map[Language]int // Source file count per language
}

type ScoredResult struct {
	ProjectName string          // Name of the scanned project (basename of root dir)
	Categories  []CategoryScore // Per-category scores (C1, C3, C6)
	Composite   float64         // Weighted composite score (1-10)
	Tier        string          // Tier classification (e.g., "Agent-Ready")
}

type SourceFile struct {
	Path     string
	RelPath  string
	Language Language
	Lines    int
	Content  []byte    // Raw source content (needed for Tree-sitter)
	Class    FileClass // source, test, generated, excluded
}

type SubScore struct {
	MetricName string         `json:"metric_name"`
	RawValue   float64        `json:"raw_value"`
	Score      float64        `json:"score"`
	Weight     float64        `json:"weight"`
	Available  bool           `json:"available"`
	Evidence   []EvidenceItem `json:"evidence"`
}

type TestFunctionMetric struct {
	Package        string
	Name           string
	File           string
	Line           int
	AssertionCount int
	HasExternalDep bool
}