validate

type BreakingChangeType string

type BreakingInput struct {
	// Symbol is the symbol being changed.
	Symbol string `json:"symbol"`

	// ChangeType describes the kind of change.
	ChangeType BreakingChangeType `json:"change_type"`

	// NewValue is the new name/type/signature.
	NewValue string `json:"new_value,omitempty"`
}

type BreakingOutput struct {
	// IsBreaking indicates if the change is breaking.
	IsBreaking bool `json:"is_breaking"`

	// Severity indicates the impact level.
	Severity string `json:"severity"` // low, medium, high, critical

	// AffectedCallers lists callers that would break.
	AffectedCallers []CallerInfo `json:"affected_callers,omitempty"`

	// Suggestion provides a recommendation.
	Suggestion string `json:"suggestion,omitempty"`
}

type CallerInfo struct {
	// Name is the caller function/method name.
	Name string `json:"name"`

	// FilePath is where the caller is defined.
	FilePath string `json:"file_path"`

	// Line is the line number of the call.
	Line int `json:"line"`

	// Package is the caller's package.
	Package string `json:"package,omitempty"`
}

type Config struct {
	// WorkingDir is the project root directory for resolving relative paths.
	WorkingDir string

	// MaxFileSize is the maximum file size to validate (bytes).
	// Default: 10MB.
	MaxFileSize int64

	// Timeout is the default timeout for validation operations (seconds).
	// Default: 30.
	Timeout int
}

type ImpactInput struct {
	// Symbols are the symbols being changed.
	Symbols []string `json:"symbols"`

	// ChangeType describes the kind of change.
	ChangeType string `json:"change_type"`
}

type ImpactOutput struct {
	// FilesAffected is the count of files that would change.
	FilesAffected int `json:"files_affected"`

	// LinesEstimated is the estimated lines that would change.
	LinesEstimated int `json:"lines_estimated"`

	// CallersAffected is the count of affected callers.
	CallersAffected int `json:"callers_affected"`

	// TestsToRun is the estimated number of tests to run.
	TestsToRun int `json:"tests_to_run"`

	// RiskLevel indicates the change risk.
	RiskLevel string `json:"risk_level"` // low, medium, high, critical

	// FileList is the list of affected files.
	FileList []string `json:"file_list,omitempty"`
}

type SyntaxError struct {
	// Line is the 1-indexed line number.
	Line int `json:"line"`

	// Column is the 0-indexed column number.
	Column int `json:"column"`

	// Message describes the error.
	Message string `json:"message"`

	// ErrorType categorizes the error (syntax, missing, unexpected).
	ErrorType string `json:"error_type"`

	// Context is the code snippet around the error.
	Context string `json:"context,omitempty"`

	// Suggestion provides a fix recommendation.
	Suggestion string `json:"suggestion,omitempty"`
}

type SyntaxInput struct {
	// FilePath is the path to the file to validate.
	// Can be absolute or relative to working directory.
	FilePath string `json:"file_path,omitempty"`

	// Content is the code content to validate.
	// If provided, takes precedence over file_path.
	Content string `json:"content,omitempty"`

	// Language overrides language detection.
	// Supported: go, python, javascript, typescript, rust, bash.
	Language string `json:"language,omitempty"`
}

type SyntaxOutput struct {
	// Valid indicates if the syntax is correct.
	Valid bool `json:"valid"`

	// Language is the detected or specified language.
	Language string `json:"language"`

	// Errors contains all syntax errors found.
	Errors []SyntaxError `json:"errors,omitempty"`

	// Warnings contains non-fatal syntax warnings.
	Warnings []SyntaxWarning `json:"warnings,omitempty"`

	// ParseTime is how long parsing took (milliseconds).
	ParseTime int64 `json:"parse_time_ms"`
}

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

type SyntaxWarning struct {
	// Line is the 1-indexed line number.
	Line int `json:"line"`

	// Column is the 0-indexed column number.
	Column int `json:"column"`

	// Message describes the warning.
	Message string `json:"message"`

	// WarningType categorizes the warning.
	WarningType string `json:"warning_type"`
}

type TestFailure struct {
	// TestName is the name of the failing test.
	TestName string `json:"test_name"`

	// Package is the package containing the test.
	Package string `json:"package"`

	// Message describes the failure.
	Message string `json:"message"`

	// File is the file where the failure occurred.
	File string `json:"file,omitempty"`

	// Line is the line number of the failure.
	Line int `json:"line,omitempty"`

	// Output is the test-specific output.
	Output string `json:"output,omitempty"`
}

type TestInput struct {
	// Scope determines which tests to run.
	Scope TestScope `json:"scope"`

	// Target is the path, pattern, or package to test.
	// Interpretation depends on scope.
	Target string `json:"target"`

	// Timeout is the maximum time for test execution (seconds).
	Timeout int `json:"timeout,omitempty"`

	// Verbose enables verbose test output.
	Verbose bool `json:"verbose,omitempty"`

	// Coverage enables coverage collection.
	Coverage bool `json:"coverage,omitempty"`
}

type TestOutput struct {
	// Passed is the count of passing tests.
	Passed int `json:"passed"`

	// Failed is the count of failing tests.
	Failed int `json:"failed"`

	// Skipped is the count of skipped tests.
	Skipped int `json:"skipped"`

	// Duration is total execution time (milliseconds).
	Duration int64 `json:"duration_ms"`

	// Failures contains details of failed tests.
	Failures []TestFailure `json:"failures,omitempty"`

	// Coverage is the coverage percentage (0-100).
	Coverage float64 `json:"coverage_pct,omitempty"`

	// Output is the raw test output.
	Output string `json:"output"`
}

type TestScope string