config

type AIConfig struct {
	// Enabled toggles all AI features in tally. Disabled by default.
	Enabled bool `json:"enabled,omitempty" koanf:"enabled"`

	// Command is the ACP-capable agent program argv (stdio).
	// Example: ["acp-agent", "--model", "foo"].
	Command []string `json:"command,omitempty" koanf:"command"`

	// Timeout is the per-fix timeout (e.g. "90s"). Parsed with time.ParseDuration at runtime.
	Timeout string `json:"timeout,omitempty" koanf:"timeout"`

	// MaxInputBytes limits how much content tally will send to the agent (guards cost/latency).
	MaxInputBytes int `json:"max-input-bytes,omitempty" koanf:"max-input-bytes"`

	// RedactSecrets redacts obvious secrets before sending content to the agent.
	RedactSecrets bool `json:"redact-secrets,omitempty" koanf:"redact-secrets"`
}

type Config struct {
	// Rules contains configuration for individual linting rules.
	Rules RulesConfig `json:"rules" koanf:"rules"`

	// Output configures output format and destination.
	Output OutputConfig `json:"output" koanf:"output"`

	// InlineDirectives controls inline suppression directives.
	InlineDirectives InlineDirectivesConfig `json:"inline-directives" koanf:"inline-directives"`

	// AI configures opt-in AI features (e.g., AI AutoFix).
	AI AIConfig `json:"ai" koanf:"ai"`

	// FileValidation configures pre-parse file validation checks.
	FileValidation FileValidationConfig `json:"file-validation" koanf:"file-validation"`

	// SlowChecks configures async checks that require network or other slow I/O.
	SlowChecks SlowChecksConfig `json:"slow-checks" koanf:"slow-checks"`

	// ConfigFile is the path to the config file that was loaded (if any).
	// This is metadata, not loaded from config.
	ConfigFile string `json:"-" koanf:"-"`
}

type ConfigurationPreference string

type ExcludeConfig struct {
	// Paths contains glob patterns for files to exclude.
	Paths []string `json:"paths,omitempty" koanf:"paths"`
}

type FileValidationConfig struct {
	// MaxFileSize is the maximum file size in bytes (0 = unlimited).
	MaxFileSize int64 `json:"max-file-size,omitempty" koanf:"max-file-size"`
}

type FixMode string

type InlineDirectivesConfig struct {
	// Enabled controls whether inline directives are processed.
	Enabled bool `json:"enabled,omitempty" koanf:"enabled"`

	// WarnUnused reports warnings for directives that don't suppress any violations.
	WarnUnused bool `json:"warn-unused,omitempty" koanf:"warn-unused"`

	// ValidateRules reports warnings for unknown rule codes in directives.
	ValidateRules bool `json:"validate-rules,omitempty" koanf:"validate-rules"`

	// RequireReason reports warnings for directives without a reason= explanation.
	RequireReason bool `json:"require-reason,omitempty" koanf:"require-reason"`
}

type OutputConfig struct {
	// Format specifies the output format.
	Format string `json:"format,omitempty" koanf:"format"`

	// Path specifies where to write output.
	Path string `json:"path,omitempty" koanf:"path"`

	// ShowSource enables source code snippets in text output.
	ShowSource bool `json:"show-source,omitempty" koanf:"show-source"`

	// FailLevel sets the minimum severity level that causes a non-zero exit code.
	FailLevel string `json:"fail-level,omitempty" koanf:"fail-level"`
}

type RuleConfig struct {
	// Severity overrides the rule's default severity.
	// Use "off" to disable the rule.
	Severity string `json:"severity,omitempty" koanf:"severity"`

	// Fix controls when auto-fixes are applied for this rule.
	// Values: never, explicit, always (default), unsafe-only.
	Fix FixMode `json:"fix,omitempty" koanf:"fix"`

	// Exclude contains path patterns where this rule should not run.
	Exclude ExcludeConfig `json:"exclude" koanf:"exclude"`

	// Options contains rule-specific configuration options.
	Options map[string]any `json:"-" koanf:",remain"`
}

type RulesConfig struct {
	// Include explicitly enables rules.
	Include []string `json:"include,omitempty" koanf:"include"`

	// Exclude explicitly disables rules.
	Exclude []string `json:"exclude,omitempty" koanf:"exclude"`

	// Tally contains configuration for tally/* rules.
	Tally map[string]RuleConfig `json:"tally,omitempty" koanf:"tally"`

	// Buildkit contains configuration for buildkit/* rules.
	Buildkit map[string]RuleConfig `json:"buildkit,omitempty" koanf:"buildkit"`

	// Hadolint contains configuration for hadolint/* rules.
	Hadolint map[string]RuleConfig `json:"hadolint,omitempty" koanf:"hadolint"`

	// Shellcheck contains configuration for shellcheck/* rules.
	Shellcheck map[string]RuleConfig `json:"shellcheck,omitempty" koanf:"shellcheck"`
}

type SlowChecksConfig struct {
	// Mode controls when slow checks run: auto (CI detection), on, off.
	Mode string `json:"mode,omitempty" koanf:"mode"`

	// FailFast skips async checks when fast checks already produce SeverityError violations.
	FailFast bool `json:"fail-fast,omitempty" koanf:"fail-fast"`

	// Timeout is the wall-clock budget for all async checks per invocation.
	Timeout string `json:"timeout,omitempty" koanf:"timeout"`
}