settings

type AgentWorkspacesSettings struct {
	Dir string `yaml:"dir,omitempty" env:"HIVE_DESKTOP_AGENT_WORKSPACES_DIR"`
	// SessionEndDelay is the grace between a chat asking to end its own
	// session and the session being ended: the request arrives from inside the
	// agent's own tool call, and the delay lets that call return first. Zero
	// takes the shipped value.
	SessionEndDelay time.Duration `yaml:"session_end_delay,omitempty" env:"HIVE_DESKTOP_AGENT_WORKSPACES_SESSION_END_DELAY"`
}

type Appearance struct {
	Theme string `yaml:"theme,omitempty" env:"HIVE_DESKTOP_APPEARANCE_THEME"`
	// FontFamily names the family the app's chrome draws with and
	// MonoFontFamily the one its monospace text draws with, neither of which
	// touches a terminal — that has its own family below. Empty is the bundled
	// face; a CSS generic keyword (system-ui, ui-monospace) is the platform
	// stack.
	FontFamily     string `yaml:"font_family,omitempty"      env:"HIVE_DESKTOP_APPEARANCE_FONT_FAMILY"`
	MonoFontFamily string `yaml:"mono_font_family,omitempty" env:"HIVE_DESKTOP_APPEARANCE_MONO_FONT_FAMILY"`
	// Pixels; 0 is the shipped default.
	TerminalFontSize int `yaml:"terminal_font_size,omitempty" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_FONT_SIZE"`
	// TerminalFontFamily names an installed monospace family for the terminal
	// only, leaving the rest of the UI alone. Empty is the bundled face.
	TerminalFontFamily string `yaml:"terminal_font_family,omitempty" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_FONT_FAMILY"`
	// TerminalFontWeight is the CSS weight normal cells draw at, and
	// TerminalFontWeightBold the weight a bold cell draws at. Zero means
	// nothing persisted; the frontend owns the defaults and the valid set.
	TerminalFontWeight     int `yaml:"terminal_font_weight,omitempty"      env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_FONT_WEIGHT"`
	TerminalFontWeightBold int `yaml:"terminal_font_weight_bold,omitempty" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_FONT_WEIGHT_BOLD"`
	// TerminalLineHeight multiplies the cell height and TerminalLetterSpacing
	// widens the cell by whole device pixels. Zero means nothing persisted, so
	// the letter-spacing default has to stay zero — moving it would make "no
	// extra tracking" unselectable.
	TerminalLineHeight    float64 `yaml:"terminal_line_height,omitempty"    env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_LINE_HEIGHT"`
	TerminalLetterSpacing int     `yaml:"terminal_letter_spacing,omitempty" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_LETTER_SPACING"`
	// TerminalShowWindows lists every active session's tmux windows in the
	// terminal sidebar, not just the attached session's. On by default.
	TerminalShowWindows bool `yaml:"terminal_show_windows" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_SHOW_WINDOWS"`
	// TerminalShowStatusBar gives the attached session the same status bar a
	// chat has, plus git and pull-request state. On by default.
	TerminalShowStatusBar bool `yaml:"terminal_show_status_bar" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_SHOW_STATUS_BAR"`
	// TerminalPoolSize is how many sessions the terminal view keeps attached at
	// once for instant switching (ADR terminal-attach-pool). Like the other appearance values it
	// is carried verbatim and healed by the frontend: anything outside 1-6 reads
	// as the default, 3.
	TerminalPoolSize int `yaml:"terminal_pool_size" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_POOL_SIZE"`
	// TerminalShowSessionAge marks old Hive sessions in the terminal sidebar.
	// The threshold is measured in whole days from the session's creation time.
	TerminalShowSessionAge          bool `yaml:"terminal_show_session_age"           env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_SHOW_SESSION_AGE"`
	TerminalSessionAgeThresholdDays int  `yaml:"terminal_session_age_threshold_days" env:"HIVE_DESKTOP_APPEARANCE_TERMINAL_SESSION_AGE_THRESHOLD_DAYS"`
	// CanvasFontSize, CanvasLineSpacing and CanvasPageWidth are preset names
	// interpreted by the frontend. Empty takes the shipped defaults.
	CanvasFontSize    string `yaml:"canvas_font_size,omitempty"    env:"HIVE_DESKTOP_APPEARANCE_CANVAS_FONT_SIZE"`
	CanvasLineSpacing string `yaml:"canvas_line_spacing,omitempty" env:"HIVE_DESKTOP_APPEARANCE_CANVAS_LINE_SPACING"`
	CanvasPageWidth   string `yaml:"canvas_page_width,omitempty"   env:"HIVE_DESKTOP_APPEARANCE_CANVAS_PAGE_WIDTH"`
}

type Bootstrap struct {
	DataDir   string `yaml:"data_dir,omitempty"`
	ConfigDir string `yaml:"config_dir,omitempty"`
}

type DebugSettings struct {
	PauseIngest time.Duration `yaml:"pause_ingest" env:"HIVE_DESKTOP_DEVELOPMENT_DEBUG_PAUSE_INGEST"`
	PauseCommit time.Duration `yaml:"pause_commit" env:"HIVE_DESKTOP_DEVELOPMENT_DEBUG_PAUSE_COMMIT"`
}

type DevToolsSettings struct {
	Enabled bool `yaml:"enabled" env:"HIVE_DESKTOP_DEVELOPMENT_DEVTOOLS_ENABLED"`
}

type DevelopmentSettings struct {
	Mocks    MockSettings      `yaml:"mocks"`
	GitHub   GitHubDevSettings `yaml:"github,omitempty"`
	Vite     ServerSettings    `yaml:"vite"             envPrefix:"HIVE_DESKTOP_DEVELOPMENT_VITE_"`
	Wails    ServerSettings    `yaml:"wails"            envPrefix:"HIVE_DESKTOP_DEVELOPMENT_WAILS_"`
	Pprof    PprofSettings     `yaml:"pprof"`
	Perf     PerfSettings      `yaml:"perf"`
	Metrics  MetricsSettings   `yaml:"metrics"`
	DevTools DevToolsSettings  `yaml:"devtools"`
	Debug    DebugSettings     `yaml:"debug"`
}

type EditorSettings struct {
	Command string `yaml:"command,omitempty" env:"HIVE_DESKTOP_EDITOR_COMMAND"`
}

type GitHubDevSettings struct {
	APIBase string `yaml:"api_base,omitempty" env:"HIVE_DESKTOP_DEVELOPMENT_GITHUB_API_BASE"`
}

type HTTPSettings struct {
	Enabled bool   `yaml:"enabled" env:"HIVE_DESKTOP_HTTP_ENABLED"`
	Host    string `yaml:"host"    env:"HIVE_DESKTOP_HTTP_HOST"`
	Port    int    `yaml:"port"    env:"HIVE_DESKTOP_HTTP_PORT"`
}

type MenuBarFeed struct {
	// Feed is a feed id, "<flow id>/<feed node id>".
	Feed string `yaml:"feed"`
	// Zero uses DefaultMenuBarItemLimit.
	Limit int `yaml:"limit,omitempty"`
}

type MenuBarSettings struct {
	Feeds []MenuBarFeed `yaml:"feeds,omitempty"`
}

type MetricsSettings struct {
	Enabled bool `yaml:"enabled" env:"HIVE_DESKTOP_DEVELOPMENT_METRICS_ENABLED"`
}

type MockSettings struct {
	Mode string `yaml:"mode" env:"HIVE_DESKTOP_DEVELOPMENT_MOCKS_MODE"`
}

type NotificationSettings struct {
	Enabled  bool   `yaml:"enabled"  env:"HIVE_DESKTOP_NOTIFICATIONS_ENABLED"`
	Delivery string `yaml:"delivery" env:"HIVE_DESKTOP_NOTIFICATIONS_DELIVERY"`
	Sound    bool   `yaml:"sound"    env:"HIVE_DESKTOP_NOTIFICATIONS_SOUND"`
}

type OnboardingSettings struct {
	Completed bool `yaml:"completed,omitempty"`
}

type Paths struct {
	DataDir string
	// HiveDataDir holds hive.db, shared with the external hive CLI. It is
	// HIVE_DESKTOP_HIVE_DATA_DIR, then HIVE_DATA_DIR, then DataDir. Dev sets the
	// first to the installed hive data dir so sessions created in dev land in
	// the real database while desktop state stays isolated.
	HiveDataDir string
	StateDir    string
	ConfigDir   string
	FlowsDir    string
	ActionsPath string
	// AgentWorkspacesDir is the agent-workspace root: agent_workspaces.dir,
	// resolved and `~`-expanded, or <ConfigDir>/workspaces when unset.
	AgentWorkspacesDir   string
	SettingsPath         string
	CredentialsIndexPath string
	LogFile              string
	// ReportsDir holds the diagnostic bundles "Report a problem" writes. It is
	// resolved here so the reporter and the system service's path allowlist
	// cannot disagree about where they live.
	ReportsDir          string
	DataDirOverridden   bool
	ConfigDirOverridden bool
}

type PathsSettings struct {
	Tmux string `yaml:"tmux,omitempty" env:"HIVE_DESKTOP_PATHS_TMUX"`
}

type PerfSettings struct {
	Enabled bool `yaml:"enabled" env:"HIVE_DESKTOP_DEVELOPMENT_PERF_ENABLED"`
}

type PollingSettings struct {
	Interval time.Duration `yaml:"interval" env:"HIVE_DESKTOP_POLLING_INTERVAL"`
}

type PprofSettings struct {
	Enabled bool `yaml:"enabled" env:"HIVE_DESKTOP_DEVELOPMENT_PPROF_ENABLED"`
}

type ProfileSettings struct {
	Order []string `yaml:"order,omitempty"`
}

type ProfileTelemetrySettings struct {
	Enabled  bool   `yaml:"enabled"            env:"HIVE_DESKTOP_TELEMETRY_PROFILES_ENABLED"`
	Endpoint string `yaml:"endpoint,omitempty" env:"HIVE_DESKTOP_TELEMETRY_PROFILES_ENDPOINT"`
	User     string `yaml:"user,omitempty"     env:"HIVE_DESKTOP_TELEMETRY_PROFILES_USER"`
	Token    string `yaml:"token,omitempty"    env:"HIVE_DESKTOP_TELEMETRY_PROFILES_TOKEN"`
}

type ResolveOptions struct {
	// MockMode only affects the isolated onboarding flow path.
	MockMode string
	// AgentWorkspacesDir is settings' agent_workspaces.dir. Empty resolves to
	// <ConfigDir>/workspaces; a leading `~` is expanded here.
	AgentWorkspacesDir string
	// Getenv reads the hive data dir variables. main passes the login shell's
	// environment, where a user exports HIVE_DATA_DIR for the CLI. nil reads
	// only HIVE_DESKTOP_HIVE_DATA_DIR from this process, so a test that
	// isolates DataDir never reaches a HIVE_DATA_DIR in the developer's shell.
	Getenv func(string) string
}

type RetentionSettings struct {
	// ActionRuns is how many finished runs of actions.yml actions to keep,
	// each with its log.
	ActionRuns int `yaml:"action_runs,omitempty" env:"HIVE_DESKTOP_RETENTION_ACTION_RUNS"`
}

type ReviewLabel struct {
	Title string `yaml:"title"`
	Icon  string `yaml:"icon,omitempty"`
}

type ReviewSettings struct {
	// Labels are the preset comments the composer applies with keys 1 to 4,
	// in order. Empty is DefaultReviewLabels.
	Labels []ReviewLabel `yaml:"labels,omitempty"`
}

type ServerSettings struct {
	Host string `yaml:"host" env:"HOST"`
	Port int    `yaml:"port" env:"PORT"`
}

type Settings struct {
	Version       int                  `yaml:"version"`
	Polling       PollingSettings      `yaml:"polling"`
	Updates       UpdateSettings       `yaml:"updates"`
	Notifications NotificationSettings `yaml:"notifications"`
	// No omitempty: with terminal_show_windows off and nothing else set the
	// struct is all-zero, and an omitted section would read back as defaults.
	Appearance      Appearance              `yaml:"appearance"`
	Profiles        ProfileSettings         `yaml:"profiles,omitempty"`
	MenuBar         MenuBarSettings         `yaml:"menu_bar,omitempty"`
	HTTP            HTTPSettings            `yaml:"http"`
	Telemetry       TelemetrySettings       `yaml:"telemetry"`
	Keybindings     map[string][]string     `yaml:"keybindings,omitempty"`
	Paths           PathsSettings           `yaml:"paths,omitempty"`
	Editor          EditorSettings          `yaml:"editor,omitempty"`
	Retention       RetentionSettings       `yaml:"retention,omitempty"`
	AgentWorkspaces AgentWorkspacesSettings `yaml:"agent_workspaces,omitempty"`
	Review          ReviewSettings          `yaml:"review,omitempty"`
	Onboarding      OnboardingSettings      `yaml:"onboarding,omitempty"`
	Development     DevelopmentSettings     `yaml:"development"`
	// contains filtered or unexported fields
}

type Store struct {
	// contains filtered or unexported fields
}

type TelemetrySettings struct {
	Enabled    bool                     `yaml:"enabled"               env:"HIVE_DESKTOP_TELEMETRY_ENABLED"`
	Endpoint   string                   `yaml:"endpoint,omitempty"    env:"HIVE_DESKTOP_TELEMETRY_ENDPOINT"`
	InstanceID string                   `yaml:"instance_id,omitempty" env:"HIVE_DESKTOP_TELEMETRY_INSTANCE_ID"`
	HostID     string                   `yaml:"host_id,omitempty"     env:"HIVE_DESKTOP_TELEMETRY_HOST_ID"`
	Token      string                   `yaml:"token,omitempty"       env:"HIVE_DESKTOP_TELEMETRY_TOKEN"`
	Profiles   ProfileTelemetrySettings `yaml:"profiles,omitempty"`
}

type UpdateSettings struct {
	Enabled bool   `yaml:"enabled"           env:"HIVE_DESKTOP_UPDATES_ENABLED"`
	Channel string `yaml:"channel,omitempty" env:"HIVE_DESKTOP_UPDATES_CHANNEL"`
}