native

type Analyzer interface {
	Name() string
	Languages() []string
	Available(context.Context, string) Availability
	Analyze(context.Context, Request) Result
}

type Availability struct {
	Available bool
	Reason    string
}

type Config struct {
	Enabled           bool
	Languages         map[string]bool
	DisabledLanguages map[string]bool
	Timeout           time.Duration
	// TimeoutPinned marks an explicit user-set timeout (GROVE_NATIVE_TIMEOUT*)
	// — size-scaling is skipped so the pin is honored exactly.
	TimeoutPinned bool
}

type Request struct {
	Root    string
	Symbols []core.SymbolRecord
	Files   []string
	// ChangedFiles, when non-empty, allows the analyzer to scope expensive
	// per-package work to the packages containing these files (plus their
	// reverse importers). An analyzer that scopes MUST report the analyzed
	// package dirs in Result.Partial so the indexer carries the stored
	// native edges of every other package forward.
	ChangedFiles []string
}

type Result struct {
	Edges       []core.Edge
	Diagnostics []string
	// SkippedLanguages lists languages whose analyzers were skipped because
	// no files of theirs changed; the indexer carries their stored native
	// edges forward instead of dropping them.
	SkippedLanguages []string
	// Partial maps a language to the package dirs its analyzer actually
	// re-analyzed this run. The indexer carries stored native edges of that
	// language whose source file lives OUTSIDE those dirs.
	Partial map[string][]string
}