config

type ActionTemplateData struct {
	Scheme string
	Value  string
	URI    string
}

type AgentProfile struct {
	Command string   `json:"command" yaml:"command"` // CLI binary (defaults to profile key if omitted)
	Flags   []string `json:"flags"   yaml:"flags"`   // extra CLI args appended to command on spawn
}

type AgentsConfig struct {
	Default       string                  // reserved key selecting the active profile
	AgentSelector bool                    // when true, the TUI new-session form prompts for agent selection
	Profiles      map[string]AgentProfile // profile name → agent configuration
}

type BatchSpawnTemplateData struct {
	Path       string // Absolute path to the session directory
	Name       string // Session name (directory basename)
	Prompt     string // User-provided prompt (batch only)
	Slug       string // Session slug (URL-safe version of name)
	ContextDir string // Path to context directory
	Owner      string // Repository owner
	Repo       string // Repository name
	ID         string // Short random ID shared with the session directory
}

type BranchTemplateData struct {
	Name  string // Session name (display name)
	Slug  string // Session slug (URL-safe version of name)
	Owner string // Repository owner
	Repo  string // Repository name
	ID    string // Short random ID shared with the session directory
}

type Check func(path string) error

type Config struct {
	Git                 GitConfig          `json:"git"                   yaml:"git"`
	GitPath             string             `json:"git_path"              yaml:"git_path"`
	Rules               []Rule             `json:"rules"                 yaml:"rules"`
	Agents              AgentsConfig       `json:"agents"                yaml:"agents"`
	AutoDeleteCorrupted bool               `json:"auto_delete_corrupted" yaml:"auto_delete_corrupted"`
	Context             ContextConfig      `json:"context"               yaml:"context"`
	Messaging           MessagingConfig    `json:"messaging"             yaml:"messaging"`
	Tmux                TmuxConfig         `json:"tmux"                  yaml:"tmux"`
	Terminal            TerminalConfig     `json:"terminal"              yaml:"terminal"`
	Database            DatabaseConfig     `json:"database"              yaml:"database"`
	Todos               TodosConfig        `json:"todos"                 yaml:"todos"`
	Experimental        ExperimentalConfig `json:"experimental"          yaml:"experimental"`
	Servers             []ServerConfig     `json:"servers"               yaml:"servers"`
	Workspaces          []string           `json:"workspaces"            yaml:"workspaces"` // parent directories containing git repository folders for new session dialog
	RepoDirsCompat      []string           `json:"-"                     yaml:"repo_dirs"`  // deprecated: use workspaces instead (kept for backwards compatibility)
	DataDir             string             `json:"-"                     yaml:"-"`          // set by caller, not from config file
}

type ConfirmPolicyConfig struct {
	Polls         int           `json:"polls"          yaml:"polls"`
	MinDuration   time.Duration `json:"min_duration"   yaml:"min_duration"`
	StableContent *bool         `json:"stable_content" yaml:"stable_content"` // nil = default
}

type ContextConfig struct {
	BaseDir     string `json:"base_dir"     yaml:"base_dir"`     // override context base path (default: $HIVE_DATA_DIR/context/)
	SymlinkName string `json:"symlink_name" yaml:"symlink_name"` // default: ".hive"
}

type DatabaseConfig struct {
	MaxOpenConns int `json:"max_open_conns" yaml:"max_open_conns"` // max open connections (default: 2)
	MaxIdleConns int `json:"max_idle_conns" yaml:"max_idle_conns"` // max idle connections (default: 2)
	BusyTimeout  int `json:"busy_timeout"   yaml:"busy_timeout"`   // busy timeout in milliseconds (default: 5000)
}

type Edit struct {
	DefaultAgent string
	Profiles     []EditProfile
	Workspaces   []string
}

type EditProfile struct {
	Name    string
	Command string
	Flags   []string
}

type ExperimentalConfig struct {
	// Daemon routes session writes and session status through `hive daemon`,
	// which a client starts on first use.
	Daemon bool `json:"daemon" yaml:"daemon"`
}

type GitConfig struct {
	StatusWorkers int `json:"status_workers" yaml:"status_workers"`
	// CloneProtocol is the transport for clone URLs hive generates from an
	// item's repository. Empty means no preference.
	CloneProtocol session.CloneProtocol `json:"clone_protocol" yaml:"clone_protocol"`
}

type InvalidEditError struct{ Reason string }

type MessagingConfig struct {
	TopicPrefix string `json:"topic_prefix" yaml:"topic_prefix"` // default: "agent"
	MaxMessages int    `json:"max_messages" yaml:"max_messages"` // max messages per topic (default: 100, 0 = unlimited)
}

type MissingPolicyConfig struct {
	Polls int `json:"polls" yaml:"polls"`
}

type PaneConfig struct {
	Command string `json:"command,omitempty" yaml:"command,omitempty"` // Command to run (template string, empty = shell)
	Dir     string `json:"dir,omitempty"     yaml:"dir,omitempty"`     // Working directory override (template string)
	Size    string `json:"size,omitempty"    yaml:"size,omitempty"`    // Pane size passed to tmux -l (for example "30%")
	Split   string `json:"split,omitempty"   yaml:"split,omitempty"`   // Split direction: horizontal or vertical (default vertical)
}

type RecycleTemplateData struct {
	DefaultBranch string // Default branch name (e.g., "main" or "master")
}

type Rule struct {
	// Pattern matches against remote URL (regex). Empty = matches all.
	Pattern string `json:"pattern" yaml:"pattern"`
	// Agent selects the agent profile used for matching repositories.
	Agent string `json:"agent,omitempty" yaml:"agent,omitempty"`
	// Commands to run in the session directory after clone/recycle.
	Commands []string `json:"commands,omitempty" yaml:"commands,omitempty"`
	// Copy are glob patterns to copy from source directory.
	Copy []string `json:"copy,omitempty" yaml:"copy,omitempty"`
	// MaxRecycled sets the max recycled sessions for matching repos.
	// nil = inherit from previous rule or default (5), 0 = unlimited, >0 = limit
	MaxRecycled *int `json:"max_recycled,omitempty" yaml:"max_recycled,omitempty"`
	// Windows defines tmux windows to create when spawning a session.
	// Mutually exclusive with Spawn/BatchSpawn.
	Windows []WindowConfig `json:"windows,omitempty" yaml:"windows,omitempty"`
	// Spawn commands to run when creating a new session (hive new).
	Spawn []string `json:"spawn,omitempty" yaml:"spawn,omitempty"`
	// BatchSpawn commands to run when creating a batch session (hive batch).
	BatchSpawn []string `json:"batch_spawn,omitempty" yaml:"batch_spawn,omitempty"`
	// Recycle commands to run when recycling a session.
	Recycle []string `json:"recycle,omitempty" yaml:"recycle,omitempty"`
	// CloneStrategy overrides the clone strategy for matching repos ("full" or "worktree").
	CloneStrategy string `json:"clone_strategy,omitempty" yaml:"clone_strategy,omitempty"`
	// BranchTemplate is a Go template for the git branch name when using the worktree
	// clone strategy. Available variables: .Name, .Slug, .Owner, .Repo, .ID.
	// Defaults to "hive/{{ .Slug }}-{{ .ID }}" when empty.
	BranchTemplate string `json:"branch_template,omitempty" yaml:"branch_template,omitempty"`
	// CloneProtocol overrides git.clone_protocol for repositories this rule matches.
	CloneProtocol session.CloneProtocol `json:"clone_protocol,omitempty" yaml:"clone_protocol,omitempty"`
}

type ServerConfig struct {
	Name      string `json:"name"       yaml:"name"`
	SSH       string `json:"ssh"        yaml:"ssh"`
	SSHConfig string `json:"ssh_config" yaml:"ssh_config"`
	Binary    string `json:"binary"     yaml:"binary"`
}

type SpawnStrategy struct {
	Windows  []WindowConfig
	Commands []string
	Agent    string
}

type SpawnTemplateData struct {
	Path       string // Absolute path to the session directory
	Name       string // Session name (directory basename)
	Slug       string // Session slug (URL-safe version of name)
	ContextDir string // Path to context directory
	Owner      string // Repository owner
	Repo       string // Repository name
	ID         string // Short random ID shared with the session directory
}

type TerminalConfig struct {
	Status TerminalStatusConfig `json:"status" yaml:"status"`
}

type TerminalConfirmConfig struct {
	Idle     ConfirmPolicyConfig `json:"idle"     yaml:"idle"`
	Missing  MissingPolicyConfig `json:"missing"  yaml:"missing"`
	Approval ConfirmPolicyConfig `json:"approval" yaml:"approval"`
}

type TerminalStatusConfig struct {
	Confirm TerminalConfirmConfig `json:"confirm" yaml:"confirm"`
}

type TmuxConfig struct {
	PollInterval         time.Duration `json:"poll_interval"          yaml:"poll_interval"`          // status check frequency, default 1.5s
	PreviewWindowMatcher []string      `json:"preview_window_matcher" yaml:"preview_window_matcher"` // regex patterns for preferred window names (e.g., ["claude", "aider"])
}

type TodosConfig struct {
	Actions       map[string]string  `json:"actions"       yaml:"actions"` // scheme -> command template
	Limiter       TodosLimiterConfig `json:"limiter"       yaml:"limiter"`
	Notifications TodosNotifyConfig  `json:"notifications" yaml:"notifications"`
}

type TodosLimiterConfig struct {
	MaxPending          int           `json:"max_pending"            yaml:"max_pending"`
	RateLimitPerSession time.Duration `json:"rate_limit_per_session" yaml:"rate_limit_per_session"`
}

type TodosNotifyConfig struct {
	Toast bool `json:"toast" yaml:"toast"`
}

type ValidationWarning struct {
	Category string `json:"category"`
	Item     string `json:"item,omitempty"`
	Message  string `json:"message"`
}

type WindowConfig struct {
	Name    string       `json:"name"              yaml:"name"`              // Window name (template string, required)
	Command string       `json:"command,omitempty" yaml:"command,omitempty"` // Command to run (template string, empty = shell); mutually exclusive with Panes
	Dir     string       `json:"dir,omitempty"     yaml:"dir,omitempty"`     // Working directory override (template string)
	Focus   bool         `json:"focus,omitempty"   yaml:"focus,omitempty"`   // Select this window after creation
	Panes   []PaneConfig `json:"panes,omitempty"   yaml:"panes,omitempty"`   // Panes to create in this window; mutually exclusive with Command
}