analysis

type Analyzer interface {
	// Language returns the language identifier (e.g., "go", "ts", "py").
	Language() string

	// Discover finds all symbols in a source file.
	Discover(path string, src []byte) ([]Symbol, error)

	// Analyze returns structural metrics for a specific symbol.
	Analyze(path string, src []byte, symbol string) (Metrics, error)

	// AnalyzeFile returns file-level metrics.
	AnalyzeFile(path string, src []byte) (FileMetrics, error)
}

type FileMetrics struct {
	HasInitFunc        bool
	GlobalMutableCount int
}

type GoAnalyzer struct{}

type Metrics struct {
	// Shape
	ParamCount      int // Number of function parameters
	ReturnCount     int // Number of return values
	FuncLines       int // Lines in function body
	MaxNestingDepth int // Deepest nesting level (if/for/switch/etc.)

	// Documentation
	HasDocComment bool   // Has a doc comment
	IsExported    bool   // Exported / public symbol
	ReceiverName  string // Receiver type name (empty for standalone)
	IsConstructor bool   // Matches constructor pattern (New*, __init__, constructor)

	// Complexity
	CyclomaticComplexity int    // McCabe cyclomatic complexity
	CognitiveComplexity  int    // Sonar-style cognitive complexity
	LoopNestingDepth     int    // Max nested loop depth (for/while only)
	RecursiveCalls       int    // Direct recursive calls
	AlgoComplexity       string // Estimated Big-O: O(1), O(n), O(n²), etc.

	// Error handling
	ErrorsIgnored    int // Discarded error returns
	ErrorsNotWrapped int // Errors returned without wrapping/context
	NakedReturns     int // Bare return in named-return function
	PanicCalls       int // panic(), throw, unwrap() — unrecoverable exits
	EmptyCatchBlocks int // catch/except/recover with empty body

	// Security
	UnsafeImports    []string // Dangerous imports (os/exec, unsafe, eval, etc.)
	HardcodedSecrets int      // String literals matching secret patterns

	// Design
	MethodCount     int  // Methods on a type (type-level only)
	DeferInLoop     int  // Defer/finally inside loops
	ContextNotFirst bool // context.Context not first param (Go-specific)

	// Performance
	NestedLoopPairs   int // Inner loops nested in outer loops
	QuadraticPatterns int // Known O(n²) anti-patterns

	// File-level
	HasInitFunc        bool // File contains init() or equivalent
	GlobalMutableCount int  // Package-level mutable variables
	OsExitCalls        int  // os.Exit() or sys.exit() calls

	// Language-specific extras
	Extra map[string]float64
}

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

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

type Symbol struct {
	Name      string     // Symbol name
	Kind      SymbolKind // Function, method, class, etc.
	StartLine int        // 1-indexed start line
	EndLine   int        // 1-indexed end line (inclusive)
	Parent    string     // Enclosing type/class name (empty for top-level)
	Exported  bool       // Whether the symbol is exported/public
}

type SymbolKind int

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