temper

type Config struct {
	// Steps is the ordered list of verification steps.
	Steps []Step
	// GoRaceDetection is a configuration hint indicating whether Go race
	// detection should be enabled (e.g., by adding a separate "race" step
	// such as 'go test -race -short ./...'). It does not automatically
	// modify Steps; callers are responsible for constructing Steps
	// accordingly (e.g., via DefaultConfigWithRace). Default is false since
	// -race slows tests and increases memory usage.
	GoRaceDetection bool
	// ChangedFiles is the list of file paths changed in the current diff
	// (relative to the repository root). When non-nil, steps with Paths
	// globs are checked against this list and skipped when no files match.
	// A nil value means "unknown" and disables path-based filtering.
	ChangedFiles []string
}

type DetectOptions struct {
	// DisableGolangciLint skips the golangci-lint step even if the binary
	// is available. When false (default), golangci-lint is added as an
	// optional step for Go projects if the binary is found on PATH.
	DisableGolangciLint bool
}

type Result struct {
	// Steps is the ordered list of step results.
	Steps []StepResult
	// Passed is true if all required steps passed (optional steps may have
	// warned without affecting this flag).
	Passed bool
	// Duration is the total time for all steps.
	Duration time.Duration
	// FailedStep is the name of the first failed step, or empty if all passed.
	FailedStep string
	// Summary is a human-readable summary of the verification.
	Summary string
}

type Step struct {
	// Name identifies the step.
	Name string
	// Command is the shell command to run.
	Command string
	// Args are the command arguments.
	Args []string
	// Dir is the working directory (relative to worktree, or absolute).
	// If empty, runs in the worktree root.
	Dir string
	// Timeout is the maximum duration for this step. Zero means 5 minutes.
	Timeout time.Duration
	// Optional means failure here doesn't fail the overall check.
	Optional bool
	// Paths is a list of glob patterns (doublestar syntax). When non-empty,
	// the step is skipped if no changed files match any pattern.
	Paths []string
	// VerifyClean is a list of pathspecs (relative to the worktree) that must
	// remain clean — meaning unchanged versus HEAD with no untracked files —
	// after the step completes. When the step itself passes but produces
	// changes under any of these paths, the step is converted to a failure
	// with a message explaining that the committed artifacts are stale. Use
	// this for steps that rebuild committed build output (e.g. an embedded
	// frontend bundle): if running `npm run build` mutates the committed
	// dist/ directory, the bundle Smith committed does not match the source.
	VerifyClean []string
	// VerifyNoConflictMarkers is a list of pathspecs (relative to the
	// worktree) that must not contain git merge-conflict markers
	// (`<<<<<<<`, `=======`, `>>>>>>>` — 7+ consecutive marker characters at
	// the start of a line). When set, temper walks the listed paths and
	// fails the step when any marker is found, naming the offending
	// file:line. Unlike VerifyClean this scan does NOT depend on a rebuild
	// — when Command is empty the step becomes a cheap scan-only check that
	// runs unconditionally (no Paths gating). That independence is the
	// point: a rebase Smith can commit conflict markers into a built bundle
	// that the freshness check would miss when the rebuild is skipped or
	// happens to land the same bytes.
	VerifyNoConflictMarkers []string
}

type StepResult struct {
	// Name identifies the step (e.g., "build", "lint", "test").
	Name string
	// Command is the full command that was run.
	Command string
	// ExitCode is the process exit code.
	ExitCode int
	// Output is the combined stdout+stderr.
	Output string
	// Duration is how long the step took.
	Duration time.Duration
	// Passed indicates whether the step succeeded.
	Passed bool
	// Optional mirrors the Step.Optional flag — failure here does not fail
	// the overall check. Surfaced so summaries can render it distinctly.
	Optional bool
	// Skipped is true when the step was skipped because no changed files
	// matched its Paths globs.
	Skipped bool
}

type TemperYAML struct {
	GoRaceDetection *bool `yaml:"go_race_detection"`
}