analysis

type AST struct {
	File     *ast.File
	Modified bool // Modified tracks whether File has been modified.
}

type Analyzer struct {
	Name        string
	Description string
	CanFix      bool
	Requires    []*Analyzer

	Flags flag.FlagSet

	Run func(*Pass) (interface{}, error)
}

type Diagnostic struct {
	Pos      Pos
	Category string
	Message  string
	Related  []RelatedInformation `json:"Related,omitempty"`
}

type Pass struct {
	Analyzer *Analyzer

	Fix bool // Should the analyzer apply fixes to AST?

	// Field information.
	Fields []*fleetpkg.Field // Fields from every file.
	Flat   []*fleetpkg.Field // Flat view of all fields sorted by file and line number.

	// Map of file paths to the AST of that file. This is available when Fix is true.
	// Analyzers may add, modify, and delete map attributes, but they should not
	// add or remove entire field list entries (any operation that changes indices
	// in YAML paths would break other analyzers).
	AST map[string]*AST

	// ResultOf provides the inputs to this analysis pass, which are
	// the corresponding results of its prerequisite analyzers.
	// The map keys are the elements of Analysis.Required,
	// and the type of each corresponding value is the required
	// analysis's ResultType.
	ResultOf map[*Analyzer]interface{}

	Report func(Diagnostic)
}

type Pos struct {
	File string
	Line int
	Col  int
}

type Printer func(diags []Diagnostic, w io.Writer)

type RelatedInformation struct {
	Pos     Pos
	Message string
}