detect

type Engine struct {
	KB                *kb.KnowledgeBase
	Root              string
	ScanDepth         int           // optional max directory depth for recursive detection (0 = unlimited)
	ScanLimit         int           // optional max filesystem entries per scan (0 = unlimited)
	LineCountTimeout  time.Duration // optional timeout for external line counters (0 = unlimited)
	IncludeSubmodules bool          // include initialized Git submodule contents
	SkipDirs          []string      // additional directories to skip during walks
	TrackedOnly       bool          // only consider files tracked by git
	// contains filtered or unexported fields
}

type ToolRef struct {
	Name     string
	Category string
}

type ToolScan struct {
	Tools   map[string][]brief.Detection
	Checked []ToolRef
	Stats   brief.Stats
}

type ToolScanOptions struct {
	// Full evaluates every non-language definition.
	Full bool
	// ChangedFiles limits a partial scan to definitions affected by these paths.
	ChangedFiles []string
	// Languages supplies language names already detected by the caller.
	Languages []string
	// LanguagesChanged reevaluates definitions scoped to a language ecosystem.
	LanguagesChanged bool
}