settings

type Hook struct {
	// Common fields
	Type          string `json:"type"`                    // "command" | "http" | "prompt" | "agent"
	StatusMessage string `json:"statusMessage,omitempty"` // spinner text while running
	If            string `json:"if,omitempty"`            // permission rule to gate firing
	TimeoutSecs   int    `json:"timeout,omitempty"`       // per-hook timeout override (seconds)
	Once          bool   `json:"once,omitempty"`          // remove after first execution
	Async         bool   `json:"async,omitempty"`         // fire-and-forget (non-blocking)

	// type="command"
	Command string `json:"command,omitempty"` // shell command

	// type="http"
	URL            string            `json:"url,omitempty"`            // POST target
	Headers        map[string]string `json:"headers,omitempty"`        // extra headers
	AllowedEnvVars []string          `json:"allowedEnvVars,omitempty"` // vars to interpolate in headers

	// type="prompt" | "agent"
	Prompt string `json:"prompt,omitempty"` // LLM prompt (may contain $ARGUMENTS)
	Model  string `json:"model,omitempty"`  // model override
}

type HookMatcher struct {
	Matcher string `json:"matcher"` // tool name or glob, "" = all
	Hooks   []Hook `json:"hooks"`
}

type HooksSettings struct {
	PreToolUse   []HookMatcher `json:"PreToolUse"`
	PostToolUse  []HookMatcher `json:"PostToolUse"`
	SessionStart []HookMatcher `json:"SessionStart"`
	Stop         []HookMatcher `json:"Stop"`
}

type Merged struct {
	// Allow is the combined allow list (user + project + local).
	Allow []string
	// Deny is the combined deny list.
	Deny []string
	// Ask is the combined ask list.
	Ask []string
	// DefaultMode is the effective default permission mode.
	DefaultMode string
	// Hooks is the merged hooks configuration.
	Hooks HooksSettings
	// Env is the merged environment map.
	Env map[string]string
	// AdditionalDirs is the merged set of additional allowed dirs.
	AdditionalDirs []string
	// Model is the preferred model override from settings (last layer wins).
	Model string
	// OutputStyle is the active output style name (last layer wins).
	OutputStyle string
	// Theme is the active palette name (last layer wins).
	Theme string
	// ThemeOverrides is the per-field color override map (last layer wins).
	ThemeOverrides map[string]string
	// Themes is the merged custom theme map (last layer wins per name).
	Themes map[string]map[string]string
	// OnboardingComplete is true once any layer sets it.
	OnboardingComplete bool
	// MCP project-scope approval gate. Last layer wins.
	EnabledMcpjsonServers      []string
	DisabledMcpjsonServers     []string
	EnableAllProjectMcpServers bool
}

type Permissions struct {
	Allow          []string `json:"allow"`
	Deny           []string `json:"deny"`
	Ask            []string `json:"ask"`
	DefaultMode    string   `json:"defaultMode"`
	AdditionalDirs []string `json:"additionalDirectories"`
}

type Settings struct {
	Permissions Permissions   `json:"permissions"`
	Hooks       HooksSettings `json:"hooks"`
	// Env holds extra environment variables for tool execution.
	Env map[string]string `json:"env"`
	// EnabledPlugins mirrors the real Claude Code enabledPlugins field.
	// Key is "pluginName@marketplace", value is true/false.
	EnabledPlugins map[string]bool `json:"enabledPlugins,omitempty"`
	// OnboardingComplete is set to true after the first-run welcome screen
	// is dismissed. Mirrors CC's projectOnboardingState gate so returning
	// users skip the welcome.
	OnboardingComplete bool `json:"onboardingComplete,omitempty"`
	// MCP project-scope approval gate (mirrors CC's MCPServerApprovalDialog).
	// A server loaded from .mcp.json is allowed to connect only if its name
	// is in EnabledMcpjsonServers OR EnableAllProjectMcpServers is true.
	// Names in DisabledMcpjsonServers are never connected.
	EnabledMcpjsonServers      []string `json:"enabledMcpjsonServers,omitempty"`
	DisabledMcpjsonServers     []string `json:"disabledMcpjsonServers,omitempty"`
	EnableAllProjectMcpServers bool     `json:"enableAllProjectMcpServers,omitempty"`
	// Model is the preferred model name (e.g. "claude-opus-4-7").
	Model string `json:"model,omitempty"`
	// OutputStyle is the active output style name, persisted across sessions.
	OutputStyle string `json:"outputStyle,omitempty"`
	// Theme is the active palette name (dark|light|dark-daltonized|
	// light-daltonized|dark-ansi|light-ansi). Matches Claude Code's
	// THEME_NAMES so settings.json values are interchangeable.
	Theme string `json:"theme,omitempty"`
	// ThemeOverrides applies per-field color tweaks on top of the named
	// theme. Keys are lowercase Palette field names (e.g. "accent",
	// "success"); values are #RRGGBB hex or ANSI 0-15 codes.
	// conduit-only — Claude Code ignores this field.
	ThemeOverrides map[string]string `json:"themeOverrides,omitempty"`
	// Themes is a map of custom theme name → field map (same shape as
	// themeOverrides). Lets users define entirely new themes selectable
	// via /theme. conduit-only.
	Themes map[string]map[string]string `json:"themes,omitempty"`
}