usecase

type AgentsExplainFilters struct {
	EffectiveOnly bool   `json:"effective_only,omitempty"`
	SourceFilter  string `json:"source_filter,omitempty"`
	RuleFilter    string `json:"rule_filter,omitempty"`
}

type AgentsExplainInput struct {
	CWD           string
	EffectiveOnly bool
	SourceFilter  string
	RuleFilter    string
}

type AgentsExplainResult struct {
	CWD     string                `json:"cwd"`
	Sources []AgentsExplainSource `json:"sources"`
	Rules   []AgentsExplainRule   `json:"rules"`
	Filters AgentsExplainFilters  `json:"filters,omitempty"`
	Summary AgentsExplainSummary  `json:"summary"`
}

type AgentsExplainRule struct {
	ID         string `json:"id"`
	Key        string `json:"key"`
	Text       string `json:"text"`
	SourcePath string `json:"source_path"`
	Line       int    `json:"line"`
	Priority   int    `json:"priority"`
	Status     string `json:"status"`
	ShadowedBy string `json:"shadowed_by,omitempty"`
}

type AgentsExplainSource struct {
	Path     string `json:"path"`
	Priority int    `json:"priority"`
}

type AgentsExplainSummary struct {
	Sources   int `json:"sources"`
	Rules     int `json:"rules"`
	Effective int `json:"effective"`
	Shadowed  int `json:"shadowed"`
}

type AgentsLintInput struct {
	CWD string
}

type AgentsLintIssue struct {
	Level      string `json:"level"`
	Code       string `json:"code"`
	Message    string `json:"message"`
	Key        string `json:"key,omitempty"`
	SourcePath string `json:"source_path,omitempty"`
	Line       int    `json:"line,omitempty"`
}

type AgentsLintResult struct {
	CWD     string            `json:"cwd"`
	Issues  []AgentsLintIssue `json:"issues"`
	Summary AgentsLintSummary `json:"summary"`
}

type AgentsLintSummary struct {
	Sources  int `json:"sources"`
	Rules    int `json:"rules"`
	Warnings int `json:"warnings"`
	Errors   int `json:"errors"`
}

type DeleteActionInput struct {
	Sessions        []session.Session
	Selector        session.Selector
	DryRun          bool
	Confirm         bool
	Yes             bool
	Hard            bool
	SessionsRoot    string
	TrashRoot       string
	MaxBatch        int
	MaxBatchChanged bool
	RealDefault     int
	DryRunDefault   int
	Executor        DeleteExecutor
	LogFile         string
	NewBatchID      NewBatchID
	WriteActionLog  WriteActionLog
	Now             time.Time
}

type DeleteActionResult struct {
	Summary         session.DeleteSummary
	AppliedMaxBatch int
	BatchID         string
	LogError        error
}

type DeleteExecutor func(candidates []session.Session, sel session.Selector, opts session.DeleteOptions) (session.DeleteSummary, error)

type DeleteSelectInput struct {
	SessionsRoot string
	Selector     session.Selector
	Now          time.Time
	Repository   core.SessionRepository
}

type DeleteSelectResult struct {
	Sessions      []session.Session
	AffectedBytes int64
}

type DoctorCheck struct {
	Name   string
	Level  DoctorLevel
	Detail string
}

type DoctorHostPathInput struct {
	SessionsRoot string
	SessionsErr  error
	Repository   core.SessionRepository
	CompactPath  func(string, int) string
}

type DoctorLevel string

type DoctorRiskInput struct {
	SessionsRoot   string
	SampleLimit    int
	IntegrityCheck bool
	Repository     core.SessionRepository
	Evaluator      core.RiskEvaluator
}

type DoctorRiskReport struct {
	SessionsTotal  int                `json:"sessions_total"`
	RiskTotal      int                `json:"risk_total"`
	RiskRate       float64            `json:"risk_rate"`
	High           int                `json:"high"`
	Medium         int                `json:"medium"`
	IntegrityCheck bool               `json:"integrity_check"`
	SampleLimit    int                `json:"sample_limit"`
	Samples        []DoctorRiskSample `json:"samples"`
}

type DoctorRiskSample struct {
	Level     session.RiskLevel  `json:"level"`
	Reason    session.RiskReason `json:"reason"`
	Health    session.Health     `json:"health"`
	SessionID string             `json:"session_id"`
	Path      string             `json:"path"`
	Detail    string             `json:"detail,omitempty"`
}

type GroupInput struct {
	SessionsRoot string
	Selector     session.Selector
	Now          time.Time
	By           string
	SortBy       string
	Order        string
	Offset       int
	Limit        int
	Repository   core.SessionRepository
}

type GroupStat struct {
	Group     string `json:"group"`
	Count     int    `json:"count"`
	SizeBytes int64  `json:"size_bytes"`
	Latest    string `json:"latest"`
}

type ListInput struct {
	SessionsRoot string
	Selector     session.Selector
	Now          time.Time
	SortBy       string
	Order        string
	Offset       int
	Limit        int
	Repository   core.SessionRepository
}

type ListResult struct {
	Total int
	Items []session.Session
}

type LoadTUISessionsInput struct {
	SessionsRoot string
	ScanLimit    int
	ViewLimit    int
	Now          time.Time
	Repository   core.SessionRepository
	Evaluator    core.RiskEvaluator
}

type LoadTUISessionsResult struct {
	Total int
	Items []session.Session
}

type NewBatchID func() (string, error)

type PreviewMessage struct {
	Role string
	Text string
}

type RestoreActionInput struct {
	Sessions           []session.Session
	Selector           session.Selector
	DryRun             bool
	Confirm            bool
	Yes                bool
	SessionsRoot       string
	TrashSessionsRoot  string
	MaxBatch           int
	MaxBatchChanged    bool
	RealDefault        int
	DryRunDefault      int
	AllowEmptySelector bool
	Executor           RestoreExecutor
	LogFile            string
	NewBatchID         NewBatchID
	WriteActionLog     WriteActionLog
	Now                time.Time
}

type RestoreActionResult struct {
	Summary         session.RestoreSummary
	AppliedMaxBatch int
	BatchID         string
	LogError        error
}

type RestoreExecutor func(candidates []session.Session, sel session.Selector, opts session.RestoreOptions) (session.RestoreSummary, error)

type RestoreSelectInput struct {
	TrashSessionsRoot string
	Selector          session.Selector
	BatchID           string
	LogFile           string
	Now               time.Time
	Repository        core.SessionRepository
	IDsForBatch       func(logFile, batchID string) ([]string, error)
}

type RestoreSelectResult struct {
	Sessions      []session.Session
	AffectedBytes int64
}

type WriteActionLog func(logFile string, rec audit.ActionRecord) error