engine

type FileProvider interface {
	ReadFile(path string) ([]byte, error)
	Stat(path string) (FileStat, error)
}

type FileProviderFactory interface {
	Match(target string) bool
	Provider(target string) (FileProvider, string, error)
}

type FileStat struct {
	Path    string
	Size    int64
	ModTime time.Time
}

type GitHubFactory struct {
	// contains filtered or unexported fields
}

type GitHubRemote struct {
	Repo       string
	DefaultRef string
	Token      string
	BaseURL    string
}

type Options struct {
	Syntax *core.DirectiveSyntax
	// ConfigOverrides records explicit CLI policies for snapshot configuration.
	ConfigOverrides map[string]bool
	// RevisionChanges and ReverseCandidates describe an immutable source snapshot.
	// RevisionChanges keys and FileChanges paths use repository forward slashes.
	RevisionChanges   map[string]*core.FileChanges
	ReverseCandidates []string
	MatchCandidates   []string
	// DependencyChanges supplies foreign changed-line evidence without adding sources.
	DependencyChanges func(string) (*core.FileChanges, error)
	// DependencyConfigChanged requests structural revalidation, not co-change evidence.
	DependencyConfigChanged func(string) bool
	Repository              *vcs.Backend
	StrictPaths             bool
	Parallelism             int
	Verbose                 bool
	Ignores                 []string // file or file#label
	IgnoreBaseDir           string   // optional configuration coordinate root
	CodeOnly                bool
	UnknownPolicy           string // error|warn|ignore
	SkipDirs                []string
	Fix                     bool
	Files                   FileProvider
	Factories               []FileProviderFactory
	CombinedDiffPolicy      string
	SuppressCoChanges       bool
	SourceFiles             []string
	StructuralFiles         []string
}

type Result struct {
	Findings   []core.Finding
	Suppressed []core.Finding
	Stats      map[string]any
}