analyzer

type AnalysisInput struct {
	ProjectID   string              // Project identifier
	ParseResult *parser.ParseResult // Complete parse result with type information
}

type AnalysisReport struct {
	ProjectID                string                   // Project identifier
	Timestamp                int64                    // Analysis timestamp
	DependencyGraph          *DependencyGraph         // Project dependencies
	InterfaceImplementations []*parser.Implementation // Interface implementations from parser
	CallChains               []*CallChain             // Function call relationships
	CircularDependencies     []*CircularDependency    // Circular import cycles
	Metrics                  *CodeMetrics             // Code quality metrics
}

type Analyzer interface {
	// AnalyzeProject performs comprehensive analysis on parsed project data
	AnalyzeProject(ctx context.Context, input *AnalysisInput) (*AnalysisReport, error)

	// BuildDependencyGraph constructs a dependency graph from parsed packages
	BuildDependencyGraph(ctx context.Context, packages []*parser.PackageInfo) (*DependencyGraph, error)

	// MapCallChains traces function call relationships using proper type information
	MapCallChains(ctx context.Context, packages []*parser.PackageInfo) ([]*CallChain, error)

	// DetectCircularDependencies identifies circular import cycles
	DetectCircularDependencies(ctx context.Context, graph *DependencyGraph) ([]*CircularDependency, error)
}

type CallChain struct {
	Caller      *FunctionReference // The calling function
	Callee      *FunctionReference // The called function
	CallSites   []CallSite         // Where the calls occur
	IsRecursive bool               // Whether this is a recursive call
}

type CallSite struct {
	File       string // File path
	Line       int    // Line number
	Column     int    // Column position
	Expression string // Call expression
}

type CircularDependency struct {
	Cycle    []string      // Ordered list of paths forming the cycle
	Severity SeverityLevel // Impact severity
	Impact   []string      // Affected components
}

type CodeMetrics struct {
	TotalFiles           int            // Total number of files
	TotalLines           int            // Total lines of code
	TotalFunctions       int            // Total number of functions
	TotalInterfaces      int            // Total number of interfaces
	TotalStructs         int            // Total number of structs
	CyclomaticComplexity map[string]int // Function complexity scores
	TestCoverage         float64        // Percentage of code covered by tests
	DependencyDepth      int            // Maximum dependency chain length
	CouplingScore        float64        // Inter-package coupling metric
}

type Config struct {
	MaxDependencyDepth int  // Maximum allowed dependency depth
	IgnoreTestFiles    bool // Skip test file analysis
	IgnoreVendor       bool // Skip vendor directory
	IncludeMetrics     bool // Calculate code metrics
	ParallelWorkers    int  // Number of concurrent workers
}

type DependencyEdge struct {
	From string         // Source path
	To   string         // Target path
	Type DependencyType // Import type
	Line int            // Line number of import
}

type DependencyGraph struct {
	Nodes map[string]*DependencyNode // Map of package path to node
	Edges []*DependencyEdge          // All dependency relationships
	Root  string                     // Project root path
}

type DependencyNode struct {
	Path         string   // File or package path
	Type         NodeType // File or Package
	Dependencies []string // Paths of direct dependencies
	Dependents   []string // Paths that depend on this node
}

type DependencyType string

type FunctionReference struct {
	Name      string // Function name
	Package   string // Package name
	Receiver  string // Receiver type if method
	Signature string // Full signature
}

type NodeType string

type SeverityLevel string