settings

type AutoApproveSettings struct {
	// Enabled controls whether the AI auto-approver is active for
	// run_unsafe_shell commands. Defaults to false (nil = not set =
	// disabled). Users must explicitly opt in with enabled = true.
	Enabled *bool `toml:"enabled"`

	// Model is the Anthropic model identifier used to evaluate
	// auto-approval decisions. Empty falls back to the auto-approver's
	// built-in default model (Haiku 4.5).
	Model string `toml:"model"`
}

type CommandDefaults struct {
	// Model is the model identifier to use for the command's session.
	// Empty means the section inherits the top-level Settings.Model (and
	// its thinking/reasoning).
	Model string `toml:"model"`

	// ThinkingLevel is the extended-thinking effort level (e.g. "low",
	// "medium", "high", "xhigh", "max"). Only meaningful alongside a Model
	// in this section; empty (with a Model set) means thinking is disabled.
	// Anthropic models only.
	ThinkingLevel string `toml:"thinking_level"`

	// ReasoningMode is the OpenAI reasoning mode (e.g. "standard", "pro").
	// Only meaningful alongside a Model in this section. A mode resolved
	// without a level defaults the level to "medium". Meaningless for
	// Anthropic models.
	ReasoningMode string `toml:"reasoning_mode"`

	// ReasoningLevel is the OpenAI reasoning effort level (e.g. "low",
	// "medium", "high", "max"). Only meaningful alongside a Model in this
	// section; empty (with a Model set) means reasoning is disabled unless
	// a reasoning mode is set (which defaults the level to "medium").
	// Meaningless for Anthropic models.
	ReasoningLevel string `toml:"reasoning_level"`
}

type HookEntry struct {
	// Enabled controls whether this hook fires. Defaults to false (nil =
	// not set = disabled). Users must explicitly opt in with enabled = true.
	Enabled *bool `toml:"enabled"`

	// Events is the list of lifecycle events this hook should listen to.
	// Used by the notify hook to restrict which events trigger a
	// notification. An empty slice means all events the hook supports are
	// active.
	Events []string `toml:"events"`

	// Draft, when non-nil and true, causes the github-pr hook to create
	// draft pull requests instead of ready-for-review ones.
	Draft *bool `toml:"draft"`
}

type HooksSettings map[string]HookEntry

type JungiControlSettings struct {
	// Enabled controls whether jungi connects to the jungi control service.
	// Defaults to false (nil = not set = disabled). Users must explicitly
	// opt in with enabled = true.
	Enabled *bool `toml:"enabled"`

	// URL is the base URL of the jungi control service, e.g.
	// "https://control.example.com".
	URL string `toml:"url"`
}

type LSPServerSettings struct {
	Command     string   `toml:"command"`
	Args        []string `toml:"args"`
	FileTypes   []string `toml:"file_types"`
	RootMarkers []string `toml:"root_markers"`
	// Warmup, when true, asks the manager to spawn the server at session
	// open rather than on first request. Defaults to false.
	Warmup *bool `toml:"warmup"`
	// Enabled controls whether this server is active. A nil pointer means
	// "not specified" — the registry default applies. Users can explicitly
	// enable a disabled-by-default server with `enabled = true` or disable
	// a default server with `enabled = false`.
	Enabled *bool `toml:"enabled"`
}

type LSPSettings struct {
	// Enabled controls whether LSP support is active. A nil pointer means
	// "not set" which defaults to enabled; users explicitly opt out with
	// `enabled = false`.
	Enabled *bool `toml:"enabled"`

	// Servers maps a logical server name (e.g. "gopls") to its
	// configuration. Entries here are merged on top of the built-in
	// default registry: any field the user sets wins, anything they
	// omit falls back to the default.
	Servers map[string]LSPServerSettings `toml:"servers"`
}

type ModelOverride struct {
	// Model is the Anthropic model identifier to use for the subagent.
	// Empty falls back to the subagent's built-in default model.
	Model string `toml:"model"`
}

type PlanDefaults struct {
	CommandDefaults

	// ResearchSubagent overrides the model used for the research subagent.
	// Falls back to the subagent's built-in default (Haiku 4.5) when unset.
	ResearchSubagent ModelOverride `toml:"research_subagent"`
}

type ReviewDefaults struct {
	CommandDefaults

	// ReviewerSubagent overrides the model used for the reviewer subagent.
	// Falls back to the subagent's built-in default (Haiku 4.5) when unset.
	ReviewerSubagent ModelOverride `toml:"reviewer_subagent"`
}

type Settings struct {
	// Model is the Anthropic model identifier used for the main chat session.
	// Defaults to anthropic__claude-sonnet-5 if absent or empty.
	Model string `toml:"model"`

	// ThinkingLevel is the extended-thinking effort level applied to the
	// main chat session at startup (e.g. "low", "medium", "high", "xhigh",
	// "max"). An absent or empty value means thinking is disabled. It is
	// also inherited by [plan], [execute], and [review] when those sections
	// omit their own model (a section that sets its own model is
	// authoritative and does not inherit). Anthropic models only; OpenAI
	// models use ReasoningMode/ReasoningLevel instead.
	ThinkingLevel string `toml:"thinking_level"`

	// ReasoningMode is the OpenAI reasoning mode applied to the main chat
	// session at startup (e.g. "standard", "pro"). Meaningless for
	// Anthropic models. It is also inherited by [plan], [execute], and
	// [review] when those sections omit their own model. When a reasoning
	// level is resolved without a mode the mode defaults to "standard";
	// conversely a mode resolved without a level defaults the level to
	// "medium" (a mode alone still enables reasoning).
	ReasoningMode string `toml:"reasoning_mode"`

	// ReasoningLevel is the OpenAI reasoning effort level applied to the
	// main chat session at startup (e.g. "low", "medium", "high", "max").
	// An absent or empty value means reasoning is disabled unless a
	// reasoning mode is set (which defaults the level to "medium").
	// Meaningless for Anthropic models. It is also inherited by [plan],
	// [execute], and [review] when those sections omit their own model.
	ReasoningLevel string `toml:"reasoning_level"`

	// LSP holds language server configuration. Omitting the [lsp] table
	// leaves Enabled=true and applies built-in defaults; setting
	// `enabled = false` disables LSP entirely.
	LSP LSPSettings `toml:"lsp"`

	// AutoApprove holds the AI auto-approver configuration for
	// run_unsafe_shell commands. The auto-approver delegates the
	// approve/deny decision to a model instead of showing the manual
	// confirmation overlay. Defaults to disabled.
	//
	// Breaking change: this was formerly a bare boolean (`auto_approve =
	// true`); it is now a table. Existing configs must migrate to:
	//
	//	[auto_approve]
	//	enabled = true
	AutoApprove AutoApproveSettings `toml:"auto_approve"`

	// SkipWorktree, when non-nil and true, causes jungi to operate directly
	// on the source directory without creating a git worktree branch. The
	// repo root is still detected for the plan store, but no worktree is
	// created. Useful for new projects with no commits or when working
	// directly on an existing branch. Defaults to false (nil pointer).
	SkipWorktree *bool `toml:"skip_worktree"`

	// Hooks holds the built-in hook opt-in table. Each key is a built-in
	// hook name (e.g. "notify", "github-pr"); its value carries enable/disable
	// and per-hook options. Built-in hooks are disabled by default and only
	// become active when their entry carries enabled = true.
	Hooks HooksSettings `toml:"hooks"`

	// Plan holds the per-command model defaults applied when the /plan
	// slash command is invoked. If it omits its model, the model and
	// thinking/reasoning are inherited from the top-level; if it sets its
	// own model, only its own fields apply (an omitted level/mode disables
	// thinking/reasoning).
	Plan PlanDefaults `toml:"plan"`

	// Execute holds the per-command model defaults applied when the
	// /execute slash command is invoked. If it omits its model, the model
	// and thinking/reasoning are inherited from the top-level; if it sets
	// its own model, only its own fields apply (an omitted level/mode
	// disables thinking/reasoning).
	Execute CommandDefaults `toml:"execute"`

	// Review holds the per-command model defaults applied when the
	// /review slash command is invoked. If it omits its model, the model
	// and thinking/reasoning are inherited from the top-level; if it sets
	// its own model, only its own fields apply (an omitted level/mode
	// disables thinking/reasoning).
	Review ReviewDefaults `toml:"review"`

	// JungiControl holds the jungi control remote messenger service
	// configuration. Disabled by default; opt in with enabled = true and a
	// url.
	JungiControl JungiControlSettings `toml:"jungi_control"`
}