linters

type Language struct {
	Name    string   `json:"name"`
	Files   []string `json:"files"`   // tracked, neither vendored nor generated
	Shebang int      `json:"shebang"` // of them, told by their #! line only
	// Running: kind -> the tools the project runs that read it.
	Running map[string][]Seen `json:"running,omitempty"`
	// Missing: kind -> the tools suggested, in order, when none runs.
	Missing map[string][]Suggestion `json:"missing,omitempty"`
	// Unsuggested: when nothing reads it and nothing is suggested, the
	// tools that would, each with the config it needs.
	Unsuggested []Suggestion `json:"unsuggested,omitempty"`
	// contains filtered or unexported fields
}

type Report struct {
	Tracked   int        `json:"tracked"`
	Skipped   int        `json:"skipped"` // vendored or generated
	Languages []Language `json:"languages"`
}

type Seen struct {
	Tool  string `json:"tool"`
	Where string `json:"where"`
}

type Suggestion struct {
	Tool    string `json:"tool"`
	Version string `json:"version,omitempty"`
	Config  string `json:"config,omitempty"` // the config the repository holds; for Unsuggested, the one it lacks
	Check   string `json:"check,omitempty"`  // a gate check, as YAML; empty when its command is not known
	// Each: the check runs once from a folder, and its config is in
	// subfolders only (platformio.ini): one check from each.
	Each string `json:"each,omitempty"`
}

type Tool struct {
	Name    string              `json:"name"`
	Reads   map[string][]string `json:"reads"`   // kind -> file types
	Suggest string              `json:"suggest"` // files: whenever its files are there; config: only with its config; never
	Configs []string            `json:"configs,omitempty"`
	Version string              `json:"version,omitempty"` // the one trunk tested
	SeenAs  []string            `json:"seen-as"`           // what a project runs it by
	Run     string              `json:"run,omitempty"`     // a gate check's command; empty: not known
	OnFiles bool                `json:"on-files,omitempty"`
}