parser

type ASTParser struct{}

type FileMetrics struct {
	FilePath     string             // Absolute or relative path to the file
	PackageName  string             // Package declaration
	TotalLines   int                // Total lines in the file
	CodeLines    int                // Lines with actual code (excluding blank and comments)
	CommentLines int                // Lines with comments
	BlankLines   int                // Blank lines
	Functions    []*FunctionMetrics // All functions/methods in the file
	Imports      []string           // Import paths
}

type FunctionMetrics struct {
	Name         string // Function name
	ReceiverType string // Empty if not a method, otherwise the receiver type
	StartLine    int    // Line number where function starts
	EndLine      int    // Line number where function ends
	Lines        int    // Total lines in function body
	Parameters   int    // Number of parameters
	ReturnValues int    // Number of return values
	Complexity   int    // Simple cyclomatic complexity (Phase 1: basic count)
}

type Parser interface {
	// ParseFile parses a single Go file and returns its metrics
	ParseFile(path string) (*FileMetrics, error)

	// ParseDirectory recursively parses all Go files in a directory
	// Returns metrics for all successfully parsed files and any errors encountered
	ParseDirectory(path string, excludePatterns []string) ([]*FileMetrics, []error)
}