scanners

type Artifact struct {
	Name     string
	Body     []byte
	Format   string
	Metadata map[string]string
}

type Context struct {
	Name          string
	Command       string
	Args          []string
	Env           map[string]string
	BaseEnv       []string
	Format        string
	OnFailure     string
	CaptureStdout bool
	ResultHandler ResultHandler

	AtmosConfig   *schema.AtmosConfiguration
	Info          *schema.ConfigAndStacksInfo
	ToolchainPATH string

	OutputFile   string
	OutputDir    string
	ExitCode     int
	CommandError error
}

type Finding struct {
	Path     string
	Line     int
	Severity string
	RuleID   string
	Message  string
}

type Output struct {
	Artifact *Artifact
	Summary  *Summary
}

type ResultHandler func(ctx *Context) (*Summary, error)

type Summary struct {
	Kind   string
	Status SummaryStatus
	Title  string
	Counts map[string]int
	// Body is the Markdown summary shared by terminal Markdown output, CI, Pro,
	// PR comments, and code-scanning consumers.
	Body string
	// TerminalBody, when set, replaces Body only in local terminal output. It is
	// plain terminal text (not Markdown), so callers can use presentation such
	// as source excerpts without changing shared scanner reports.
	TerminalBody string
	Findings     []Finding
	SARIF        []byte
}

type SummaryStatus string