rules

type Action struct {
	Type   string `json:"type"`
	Folder string `json:"folder,omitempty"`
}

type Cond struct {
	All   []Cond `json:"all,omitempty"`
	Any   []Cond `json:"any,omitempty"`
	Field string `json:"field,omitempty"`
	Op    string `json:"op,omitempty"`
	Value any    `json:"value,omitempty"`
	// contains filtered or unexported fields
}

type Defaults struct {
	DecisionModel string   `yaml:"decision_model,omitempty"`
	FallbackModel string   `yaml:"fallback_model,omitempty"`
	MinConfidence *float64 `yaml:"min_confidence,omitempty"`
}

type Evaluation struct {
	Final      *Result
	Candidates []Rule // passing intent rules above the cut-off, in priority order
	CutOff     *Rule  // the default when the decider picks none; may be nil
	// contains filtered or unexported fields
}

type Field struct {
	Name string
	Type string   // string | boolean | number | pass, fail or none | account id
	Ops  []string // the operators it accepts
}

type File struct {
	Defaults Defaults
	Rules    []Rule
}

type Options struct {
	MinConfidence float64   // threshold for rules that set none
	Now           time.Time // for age_days
}

type Result struct {
	Stage       Stage
	RuleID      int64 // 0 = no rule; with Review, the rule the decider suggested
	RuleVersion int
	Confidence  float64
	Actions     []Action // the primary rule's actions, then each stacking rule's
	Stacked     []int64  // stacking rules whose actions were appended
	Review      bool     // below threshold: take no action, show in Needs review
	// SenderRuleID is the sender rule that settled the email (Stage is StageSender); 0 otherwise.
	SenderRuleID int64
}

type Rule struct {
	ID            int64
	UserID        int64
	AccountID     int64 // 0 = all accounts
	Name          string
	Said          string // the user's original wording; "" when they gave none
	Template      string // the name of the gallery template it was added from; "" = none
	Intent        string // plain-English intent for the decider; "" = condition-only
	Conditions    Cond
	Exceptions    Cond // "unless"
	Actions       []Action
	Priority      int // lower runs first
	Stack         bool
	Model         string   // per-rule decider override
	MinConfidence *float64 // nil = the configured default
	Enabled       bool
	Version       int
	CreatedAt     int64
	UpdatedAt     int64
}

type RuleError struct {
	N   int    // the rule's place in the file, from 1
	ID  string // its id (name) as written
	Err *ValidationError
}

type SenderRule struct {
	ID        int64
	UserID    int64
	MatchType string // address | domain
	Value     string // lower-case
	RuleID    int64  // for route: the rule whose actions apply; 0 otherwise
	Verdict   string // route | keep | block
	Source    string // user | learned
	Hits      int
	CreatedAt int64
}

type Stage string

type ValidationError struct {
	Path    string
	Message string
}