onboarding

type Answer struct {
	QuestionID string
	Value      bool // true = yes, false = no
	Cascaded   bool // true if derived from a parent answer
	Parent     string
}

type FindingSample struct {
	File    string
	Line    int
	Message string
}

type Override struct {
	Ruleset string
	Rule    string
	Active  bool
}

type ProgressEvent struct {
	// StageIndex is the 1-based index of the stage just completed
	// (1..len(StrictStages)).
	StageIndex int
	// StageLabel is the human-readable label from StrictStages.
	StageLabel string
	// TotalStages is len(StrictStages), duplicated here so callers
	// don't need to import the slice.
	TotalStages int
}

type Question struct {
	ID              string          `json:"id"`
	Question        string          `json:"question"`
	Rationale       string          `json:"rationale"`
	Rules           []string        `json:"rules"`
	CascadeFrom     *string         `json:"cascade_from"`
	CascadesTo      []string        `json:"cascades_to"`
	Defaults        map[string]bool `json:"defaults"`
	PositiveFixture *string         `json:"positive_fixture"`
	NegativeFixture *string         `json:"negative_fixture"`
	Kind            string          `json:"kind"`
}

type Registry struct {
	SchemaVersion int        `json:"schemaVersion"`
	Description   string     `json:"description"`
	Questions     []Question `json:"questions"`
}

type RuleCount struct {
	Name  string
	Count int
}

type ScanOptions struct {
	// KritBin is the path to the krit binary. Required.
	KritBin string
	// RepoRoot is the krit repository root (so ProfilePath can resolve
	// config/profiles/<name>.yml).
	RepoRoot string
	// Target is the directory to scan.
	Target string
}

type ScanResult struct {
	Profile  string                     `json:"profile"`
	Total    int                        `json:"total"`
	Fixable  int                        `json:"fixable"`
	ByRule   map[string]int             `json:"byRule"`
	Findings map[string][]FindingSample `json:"-"` // keyed by rule name; capped at 3 per rule
}

type ThresholdOverride struct {
	Ruleset string
	Rule    string
	Field   string
	Value   int
}

type WriteConfigOptions struct {
	ProfileYAML        []byte              // contents of config/profiles/<name>.yml
	ProfileName        string              // profile display name for the header
	Overrides          []Override          // rule on/off overrides from the questionnaire
	ThresholdOverrides []ThresholdOverride // numeric threshold overrides from the slider phase
}