config

type Clipboard struct {
	FallbackCommand string `yaml:"fallback_command"`
}

type Config struct {
	// Language is the UI language, "fr" or "en" — see pkg/i18n. Covers the
	// interactive TUI (bindings, popups, status bar, footers, session
	// messages); pkg/app's CLI output (`lazyshell config ...`) is unaffected
	// and stays French, since it can run before a config file — and so a
	// Language — has even been loaded.
	Language string `yaml:"language"`
	// Shell is the command started behind each new session's pty. Empty means
	// "use $SHELL, falling back to /bin/bash" (resolved at use, not at load,
	// so Default() does not need to touch the environment).
	Shell string `yaml:"shell"`
	// Term is the TERM value every session is started with. Lowering it below
	// the bundled emulator's actual capabilities is the point of exposing it:
	// some programs behave better when told less.
	Term string `yaml:"term"`
	// ScrollbackSize is the maximum number of lines a session's terminal
	// emulator keeps once they scroll off-screen.
	ScrollbackSize int `yaml:"scrollback_size"`
	// SessionsPanelWidth is the sessions list's width in landscape mode, in
	// columns — see pkg/gui/layout.go.
	SessionsPanelWidth int `yaml:"sessions_panel_width"`
	// SessionsPanelHeight is the sessions list's height in portrait mode, in
	// rows.
	SessionsPanelHeight int `yaml:"sessions_panel_height"`
	// AgentsPanelHeight is the agents dashboard's height, in rows, under the
	// sessions panel in landscape mode — see pkg/gui/layout.go. The panel
	// itself is hidden automatically when no AI agent session is detected, or
	// in portrait mode, so there is no separate enabled flag.
	AgentsPanelHeight int `yaml:"agents_panel_height"`
	// PortraitMaxWidth and PortraitMinHeight are the terminal geometry at which
	// the layout switches to stacking the panels: portrait applies when the
	// terminal is at most PortraitMaxWidth columns wide *and* more than
	// PortraitMinHeight rows tall.
	PortraitMaxWidth  int `yaml:"portrait_max_width"`
	PortraitMinHeight int `yaml:"portrait_min_height"`
	// RefreshIntervalMs is how often, in milliseconds, the sessions list and
	// the output panel are re-rendered. Lower is smoother and costs more CPU;
	// an unchanged panel is never pushed, so idle cost stays near zero either
	// way.
	RefreshIntervalMs int `yaml:"refresh_interval_ms"`
	// KillTimeoutMs is how long, in milliseconds, killing a session waits after
	// SIGTERM before escalating to SIGKILL, and again after that before giving
	// up.
	KillTimeoutMs int `yaml:"kill_timeout_ms"`
	// PrefixKey is the pass-through escape key, in gocui.Parse syntax
	// ("Ctrl+A", "Ctrl+Space", ...). Overridable at runtime via
	// $LAZYSHELL_PREFIX, which wins over this value.
	PrefixKey string `yaml:"prefix_key"`
	// Keybindings remaps actions (stable ids such as "new_session") to a
	// gocui.Parse key spec. An action missing from this map keeps its
	// built-in default.
	Keybindings map[string]string `yaml:"keybindings"`
	// Markers overrides the sessions list's gutter markers.
	Markers Markers `yaml:"markers"`
	// Scroll overrides the output panel's scrolling steps.
	Scroll Scroll `yaml:"scroll"`
	// Theme overrides the UI's colors. An empty field keeps its built-in
	// default (see pkg/gui's Theme/defaultTheme).
	Theme Theme `yaml:"theme"`
	// Clipboard configures copy-mode's yank.
	Clipboard Clipboard `yaml:"clipboard"`
	// Notify configures the desktop notification sent when a detected AI
	// agent session goes blocked or done (pkg/agent).
	Notify Notify `yaml:"notify"`
	// WindowTitle configures whether the host terminal's window/tab title
	// tracks the focused session's name and live OSC title.
	WindowTitle WindowTitle `yaml:"window_title"`
	// Mouse configures clicking, wheel scrolling and drag selection.
	Mouse Mouse `yaml:"mouse"`
	// EnvTab configures the output panel's env tab.
	EnvTab EnvTab `yaml:"env_tab"`
	// Perf configures the output panel's perf tab.
	Perf Perf `yaml:"perf"`
	// Control configures the agent control API (pkg/control). Off by default,
	// deliberately — see docs/adr/0006-api-de-controle-par-les-agents.md.
	Control Control `yaml:"control"`
	// AgentStatsCommand, when set, is run for the selected session — with
	// $LAZYSHELL_SESSION_ID in its environment — and its first line of
	// stdout is shown alongside the turn duration. Best-effort: lazyshell
	// does not parse token/cost data itself, the same "external command
	// whose output line is displayed" shape as Claude Code's own
	// statusLine. Empty means no stats line.
	AgentStatsCommand string `yaml:"agent_stats_command"`
	// RestoreLayout controls the prompt offered at launch when no
	// lazyshell.yml is present and a previous run's layout was saved for this
	// directory (docs/adr/0013-persistance-de-la-disposition.md): "ask" (the
	// default) shows a confirmation popup, "always" restores it with no
	// prompt, "never" never offers it. A project file's declared sessions
	// always take priority over a saved layout regardless of this setting —
	// the two are never merged.
	RestoreLayout string `yaml:"restore_layout"`

	// Warnings lists the keys the file contained but this struct has no field
	// for, so that a typo says why it does nothing instead of being silently
	// dropped. Filled by Load; never read from the file itself.
	Warnings []string `yaml:"-"`
}

type Control struct {
	// Enabled turns the whole API on: the socket is only created, and
	// $LAZYSHELL_CONTROL_SOCK only injected into sessions, when it is true.
	Enabled bool `yaml:"enabled"`
}

type EnvTab struct {
	// MaskSecrets replaces the value of any variable whose *name* looks like a
	// credential (TOKEN, SECRET, PASSWORD, AUTH, ..._KEY) with a fixed-width
	// mask. On by default: the panel is as shareable as a screenshot of it,
	// and an API key must not be what makes a screenshot dangerous. Set to
	// false to see the real values.
	MaskSecrets bool `yaml:"mask_secrets"`
}

type GroupSpec struct {
	Name string `yaml:"name"`
}

type Markers struct {
	// Bell flags a session that emitted a BEL since it was last looked at.
	Bell string `yaml:"bell"`
	// AltScreen flags a session with a full-screen application in control.
	AltScreen string `yaml:"alt_screen"`
	// Activity flags a session that produced output since it was last looked
	// at, other than the one currently selected.
	Activity string `yaml:"activity"`
	// Broadcast flags a session marked to receive broadcast keystrokes.
	Broadcast string `yaml:"broadcast"`
	// AgentIdle/AgentWorking/AgentBlocked/AgentDone flag a detected AI agent
	// session's state (pkg/agent) — idle, working, waiting on you, or done
	// with its turn. Empty for a session that is not running a known agent.
	AgentIdle    string `yaml:"agent_idle"`
	AgentWorking string `yaml:"agent_working"`
	AgentBlocked string `yaml:"agent_blocked"`
	AgentDone    string `yaml:"agent_done"`
	// AgentIdleColor/AgentWorkingColor/AgentBlockedColor/AgentDoneColor color
	// the four markers above, in Theme's syntax (W3C name, ANSI alias, or
	// "#rrggbb"). AgentWorkingColor also drives the working marker's pulse:
	// it alternates between this color at full and dimmed brightness.
	AgentIdleColor    string `yaml:"agent_idle_color"`
	AgentWorkingColor string `yaml:"agent_working_color"`
	AgentBlockedColor string `yaml:"agent_blocked_color"`
	AgentDoneColor    string `yaml:"agent_done_color"`
	// CommandFailed flags a non-agent session whose last command (per OSC 133
	// shell integration) exited non-zero. Not part of the fixed gutter above:
	// it is prepended to the detail column instead, alongside its exit code,
	// which the gutter's fixed width has no room for.
	CommandFailed string `yaml:"command_failed"`
	// Restart flags a session (declared with a restart: policy) that has
	// needed at least one automatic restart. Same treatment as CommandFailed:
	// prepended to the detail column, next to its attempt count, not part of
	// the fixed gutter.
	Restart string `yaml:"restart"`
}

type Mouse struct {
	// Enabled turns the whole feature on or off, including gocui's own mouse
	// reporting, which hands wheel and selection back to the host terminal.
	Enabled bool `yaml:"enabled"`
	// WheelLines is how many lines one wheel notch scrolls the output panel
	// by. Zero falls back to the built-in default.
	WheelLines int `yaml:"wheel_lines"`
	// ForwardToApp lets a full-screen program running inside a session (vim
	// with `set mouse=a`, htop) receive the mouse events itself, but only once
	// it has explicitly asked for them with a DECSET 9/1000/1002/1003. A
	// program that never asks — a shell, an AI agent CLI — never sees them,
	// and the wheel keeps scrolling lazyshell's own scrollback.
	ForwardToApp bool `yaml:"forward_to_app"`
}

type Notify struct {
	FallbackCommand string `yaml:"fallback_command"`
}

type NumericBound struct {
	// Key is the field's dotted config key, e.g. "scroll.half_page_divisor".
	Key string
	// Min and Max bound the field. Max == 0 means "no upper bound" — the same
	// convention clamp itself uses.
	Min, Max int
}

type Perf struct {
	// RefreshIntervalMs is how often the tab actually samples the process,
	// independently of RefreshIntervalMs's redraw tick. Sampling is the one
	// genuinely expensive thing this panel does — on macOS it spawns a `ps`,
	// for want of a cgo-free alternative — so it is deliberately an order of
	// magnitude slower than the redraw, and a CPU percentage is meaningless
	// over a 30 ms window anyway.
	RefreshIntervalMs int `yaml:"refresh_interval_ms"`
}

type ProjectConfig struct {
	// Shell overrides the user configuration's Shell for this project only.
	Shell string `yaml:"shell"`
	// Sessions are started at launch, in this order.
	Sessions []SessionSpec `yaml:"sessions"`
	// Groups declares the session groups this project uses, and — this is the
	// part that matters — the order their headers appear in the sessions
	// panel. Declaring a group is optional: a session may name a group that is
	// not listed here, and it simply sorts after the declared ones.
	//
	// A group carries a name and a label, and deliberately nothing else. Per
	// this struct's doc comment above, a project file says what exists; how
	// the user's interface renders it is not a repository's business.
	Groups []GroupSpec `yaml:"groups"`
	// EnvFiles are .env-style files loaded, in order, for every session this
	// project declares — before each session's own EnvFiles, and before its
	// inline Env. Relative paths resolve against the project file's
	// directory, like Cwd.
	EnvFiles []string `yaml:"env_files"`
	// NoDefaultEnv disables the automatic "<session cwd>/.env" lookup for
	// every declared session, unless a session's own NoDefaultEnv overrides
	// it back on.
	NoDefaultEnv *bool `yaml:"no_default_env"`

	// Path is the absolute path of the file this was read from. Relative cwds
	// resolve against its directory, not against the process's.
	Path string `yaml:"-"`
	// Raw is the file's content as read, hashed by the trust store so that
	// editing the file asks for approval again.
	Raw []byte `yaml:"-"`
	// Warnings lists the keys that were present but ignored, so that a `theme:`
	// in a project file says why it does nothing instead of being silently
	// dropped.
	Warnings []string `yaml:"-"`
}

type ResolvedSession struct {
	Name string
	// Group is the session's group, trimmed; "" for an ungrouped session.
	Group   string
	Cwd     string
	Command string
	Env     map[string]string
	// EnvFiles is the project's EnvFiles followed by the session's own,
	// already resolved to absolute paths.
	EnvFiles []string
	// NoDefaultEnv is the session's NoDefaultEnv if set, else the project's.
	// Nil means neither said anything — defer to the Manager's own setting.
	NoDefaultEnv *bool
	// Watch is the session's pattern watchers, already checked for a valid
	// regexp — see Validate, which drops (and reports) any entry that fails
	// to compile rather than letting a typo cost the whole session.
	Watch []WatchSpec
	// Restart is the session's automatic restart policy, already checked —
	// see resolveRestartPolicy. An unrecognized value falls back to
	// RestartNever with a warning, rather than dropping the session: unlike
	// a bad watch pattern, a bad restart policy is a single scalar with a
	// safe default, not a list of independent entries.
	Restart RestartPolicy
	// StopOnFailure is whether this session should be killed outright when
	// its Command exits non-zero, instead of leaving the shell open
	// underneath. Carried through unresolved — Validate never forces it
	// false even when Command is empty, in which case it is simply inert
	// (see warnIfStopOnFailureIsInert for why that case is still reported).
	StopOnFailure bool
	// Locked is whether the session starts locked, already resolved: the
	// declared value if there was one, else "it has a Command". Never nil —
	// SessionSpec.Locked's "not declared" state does not survive validation,
	// so nothing downstream has to re-derive the heuristic.
	Locked bool
}

type RestartPolicy string

type Scroll struct {
	// PageLines is how many lines PgUp/PgDn move by. Zero means "one full
	// panel height", which is what a page key normally does.
	PageLines int `yaml:"page_lines"`
	// HalfPageDivisor is what the panel height is divided by for Ctrl-U and
	// Ctrl-D. The default of 2 is the half page the keys are named after; 4
	// gives a quarter page.
	HalfPageDivisor int `yaml:"half_page_divisor"`
}

type SessionSpec struct {
	Name string `yaml:"name"`
	// Group is the group this session starts in, "" for none. It need not be
	// declared in Groups; that block only fixes the display order.
	Group   string            `yaml:"group"`
	Cwd     string            `yaml:"cwd"`
	Command string            `yaml:"command"`
	Env     map[string]string `yaml:"env"`
	// EnvFiles are .env-style files loaded for this session only, after the
	// project's own EnvFiles — a later file, and this list, override a key
	// set by anything earlier. Relative paths resolve against the project
	// file's directory, like Cwd.
	EnvFiles []string `yaml:"env_files"`
	// NoDefaultEnv overrides the project's NoDefaultEnv for this session
	// only. Nil means "use the project's setting".
	NoDefaultEnv *bool `yaml:"no_default_env"`
	// Watch declares this session's pattern watchers: a regex evaluated
	// against each output line, and whether a match notifies. Same
	// GroupSpec precedent as the rest of this file — what exists, not what
	// the interface looks like.
	Watch []WatchSpec `yaml:"watch"`
	// Restart is this session's automatic restart policy, as written:
	// "never" (or empty), "on-failure", or "always". See resolveRestartPolicy
	// for what happens to anything else.
	Restart string `yaml:"restart"`
	// StopOnFailure, when true, kills the session outright as soon as its
	// declared Command exits non-zero (detected via the shell's own OSC 133
	// integration, pkg/screen), instead of leaving the shell open underneath
	// as the default does. False (the zero value) leaves today's behaviour
	// untouched. Declaring it without a Command is accepted but inert — see
	// warnIfStopOnFailureIsInert.
	StopOnFailure bool `yaml:"stop_on_failure"`
	// Locked is whether this session starts in locked mode — the output panel
	// showing it but not forwarding keystrokes to it. Nil means "not
	// declared", and Validate then locks the session if, and only if, it
	// declares a Command: a declared command is something you watch, and a
	// stray keystroke landing in it can kill it.
	//
	// This is the one interface-shaped key the whitelist admits (see
	// ProjectConfig's doc comment), because what it protects is the declared
	// process itself, and the worst a hostile value can do is make the user
	// press "i". It says nothing about colours, keys or layout.
	Locked *bool `yaml:"locked"`
}

type StateFile struct {
	// Path is the cwd this layout was saved for, in clear — the filename is
	// its hash, so this is what makes a directory listing legible.
	Path    string    `yaml:"path"`
	SavedAt time.Time `yaml:"saved_at"`
	// Sessions are in the order they appeared in the sessions panel.
	Sessions []StateSession `yaml:"sessions"`
}

type StateSession struct {
	Name    string `yaml:"name"`
	Group   string `yaml:"group,omitempty"`
	Cwd     string `yaml:"cwd"`
	Command string `yaml:"command,omitempty"`
}

type Theme struct {
	ActiveBorderColor   string `yaml:"active_border_color"`
	InactiveBorderColor string `yaml:"inactive_border_color"`
	SelectedBgColor     string `yaml:"selected_bg_color"`
	LockedBorderColor   string `yaml:"locked_border_color"`
	TabActiveColor      string `yaml:"tab_active_color"`
}

type TrustStore map[string]string

type WatchSpec struct {
	Pattern string `yaml:"pattern"`
	Notify  bool   `yaml:"notify"`
}

type WindowTitle struct {
	Enabled bool `yaml:"enabled"`
}