handler

type ConsoleHandler struct {
	Verbose bool
}

type DataFlow struct {
	TaintSource      []Location `json:"taint_source"`
	IntermediateVars []Location `json:"intermediate_vars"`
	TaintSink        []Location `json:"taint_sink"`
}

type Finding struct {
	RuleID      string    `json:"rule_id"`
	Title       string    `json:"title"`
	Description string    `json:"description"`
	Severity    string    `json:"severity"`
	Path        string    `json:"path"`
	StartLine   int       `json:"start_line"`
	EndLine     int       `json:"end_line"`
	Snippet     string    `json:"snippet"`
	DataFlow    *DataFlow `json:"data_flow,omitempty"`
}

type HandleFindingsParams struct {
	Report       *ctis.Report
	Strategy     strategy.ScanStrategy
	ChangedFiles []strategy.ChangedFile
	GitEnv       gitenv.GitEnv

	// NewFingerprints, when non-nil, restricts PR/MR inline comments to findings
	// the PR introduces relative to its base branch (keyed by fingerprint). It is
	// computed by the sensor via Client.BaselineDiff in a PR context. When nil
	// (no PR context, baseline unavailable, or non-PR scan) all findings on
	// changed files are eligible — the prior behavior, preserved for back-compat.
	NewFingerprints map[string]bool
}

type Location struct {
	Path    string `json:"path"`
	Line    int    `json:"line"`
	Column  int    `json:"column"`
	Content string `json:"content"`
}

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

type RemoteHandlerConfig struct {
	Pusher         core.Pusher
	Verbose        bool
	CreateComments bool
	MaxComments    int // Max comments per PR/MR (default 10)
}

type ScanHandler interface {
	// OnStart is called at the beginning of a scan.
	// It should register the scan with the server and return scan info.
	OnStart(gitEnv gitenv.GitEnv, scannerName, scannerType string) (*ScanInfo, error)

	// HandleFindings processes scan findings.
	// It sends findings to the server and optionally creates PR/MR comments.
	HandleFindings(params HandleFindingsParams) error

	// OnCompleted is called when the scan completes successfully.
	OnCompleted() error

	// OnError is called when an error occurs during the scan.
	OnError(err error) error
}

type ScanInfo struct {
	ScanID        string `json:"scan_id"`
	LastCommitSha string `json:"last_commit_sha"`
	ScanURL       string `json:"scan_url"`
}