agent

type Agent struct {
	Repo       *repo.Repo
	Heuristics *heuristics.Registry
	Provider   llm.Provider
	Config     Config

	// Actions is the registered action vocabulary the LLM is told
	// it can emit. The system prompt's "Action is one of: ..." list
	// is generated from this registry, so the model's vocabulary
	// matches the dispatcher's vocabulary by construction. Nil
	// falls back to action.NewDefaultRegistry() — production wires
	// the same registry the CLI's dispatcher uses.
	Actions *action.Registry
}

type Config struct {
	// MaxFindingsToLLM caps how many findings are fed into the initial
	// user message. Larger N → more model context cost; defaults to 50
	// per the design doc when zero.
	MaxFindingsToLLM int

	// MaxToolCalls is the per-Scan tool-call budget. Once the loop has
	// dispatched this many tool calls, the next round must produce a
	// final response or Scan fails with ErrBudgetExhausted. Defaults
	// to 10 when zero.
	MaxToolCalls int

	// Model is the LLM model identifier passed through to the provider.
	// The provider is free to ignore this if the value is empty.
	Model string

	// Walker controls the filesystem walk used to populate
	// heuristics.Input.Walked. The zero value uses walker defaults.
	Walker walker.Options

	// InputConfig carries heuristic thresholds and policies sourced
	// from the CLI config. Zero values preserve each heuristic's
	// documented defaults.
	InputConfig heuristics.InputConfig

	// LocalOnly skips the LLM loop and converts heuristic findings
	// directly into conservative recommendations.
	LocalOnly bool

	// Categories limits findings to matching Finding.Category or
	// Finding.Heuristic values before local or LLM triage.
	Categories []string
}

type Recommendation struct {
	ID        string `json:"id"`
	Action    string `json:"action"`
	Target    string `json:"target"`
	Severity  string `json:"severity"`
	Rationale string `json:"rationale"`
}