config

type AgentConfig struct {
	Includes        []string          `yaml:"includes,omitempty" mapstructure:"includes"`
	EnvFile         []string          `yaml:"env_file,omitempty" mapstructure:"env_file"`
	FromEnv         []string          `yaml:"from_env,omitempty" mapstructure:"from_env"`
	Env             map[string]string `yaml:"env,omitempty" mapstructure:"env"`
	Memory          string            `yaml:"memory,omitempty" mapstructure:"memory"`
	Editor          string            `yaml:"editor,omitempty" mapstructure:"editor"`
	Visual          string            `yaml:"visual,omitempty" mapstructure:"visual"`
	Shell           string            `yaml:"shell,omitempty" mapstructure:"shell"`
	ClaudeCode      *ClaudeCodeConfig `yaml:"claude_code,omitempty" mapstructure:"claude_code"`
	EnableSharedDir *bool             `yaml:"enable_shared_dir,omitempty" mapstructure:"enable_shared_dir"`
	PostInit        string            `yaml:"post_init,omitempty" mapstructure:"post_init"`
}

type ArgDefinition struct {
	Name    string `yaml:"name" mapstructure:"name"`
	Default string `yaml:"default,omitempty" mapstructure:"default"`
}

type BuildConfig struct {
	Image        string              `yaml:"image" mapstructure:"image"`
	Dockerfile   string              `yaml:"dockerfile,omitempty" mapstructure:"dockerfile"`
	Packages     []string            `yaml:"packages,omitempty" mapstructure:"packages"`
	Context      string              `yaml:"context,omitempty" mapstructure:"context"`
	BuildArgs    map[string]string   `yaml:"build_args,omitempty" mapstructure:"build_args"`
	Instructions *DockerInstructions `yaml:"instructions,omitempty" mapstructure:"instructions"`
	Inject       *InjectConfig       `yaml:"inject,omitempty" mapstructure:"inject"`
}

type BuiltinIPRangeConfig struct {
	URL      string
	JQFilter string
}

type ClaudeCodeConfig struct {
	Config      ClaudeCodeConfigOptions `yaml:"config" mapstructure:"config"`
	UseHostAuth *bool                   `yaml:"use_host_auth,omitempty" mapstructure:"use_host_auth"`
}

type ClaudeCodeConfigOptions struct {
	Strategy string `yaml:"strategy" mapstructure:"strategy"` // "copy" or "fresh"
}

type Config struct {
	// Project is the project configuration from clawker.yaml.
	// Never nil - uses defaults if no config file exists.
	// Contains runtime context (Key, RootDir, worktree methods) after loading.
	Project *Project

	// Settings is the user settings from settings.yaml.
	// Never nil - uses defaults if no settings file exists.
	Settings *Settings

	// Resolution is the project resolution (project key, entry, workdir).
	// Never nil - empty resolution if not in a registered project.
	Resolution *Resolution

	// Registry is the registry for write operations.
	// May be nil if registry initialization failed. Check RegistryInitErr() for details.
	Registry Registry
	// contains filtered or unexported fields
}

type ConfigNotFoundError struct {
	Path string
}

type CopyInstruction struct {
	Src   string `yaml:"src" mapstructure:"src"`
	Dest  string `yaml:"dest" mapstructure:"dest"`
	Chown string `yaml:"chown,omitempty" mapstructure:"chown"`
	Chmod string `yaml:"chmod,omitempty" mapstructure:"chmod"`
}

type DockerInstructions struct {
	Copy        []CopyInstruction  `yaml:"copy,omitempty" mapstructure:"copy"`
	Env         map[string]string  `yaml:"env,omitempty" mapstructure:"env"`
	Labels      map[string]string  `yaml:"labels,omitempty" mapstructure:"labels"`
	Expose      []ExposePort       `yaml:"expose,omitempty" mapstructure:"expose"`
	Args        []ArgDefinition    `yaml:"args,omitempty" mapstructure:"args"`
	Volumes     []string           `yaml:"volumes,omitempty" mapstructure:"volumes"`
	Workdir     string             `yaml:"workdir,omitempty" mapstructure:"workdir"`
	Healthcheck *HealthcheckConfig `yaml:"healthcheck,omitempty" mapstructure:"healthcheck"`
	Shell       []string           `yaml:"shell,omitempty" mapstructure:"shell"`
	UserRun     []RunInstruction   `yaml:"user_run,omitempty" mapstructure:"user_run"`
	RootRun     []RunInstruction   `yaml:"root_run,omitempty" mapstructure:"root_run"`
}

type ExposePort struct {
	Port     int    `yaml:"port" mapstructure:"port"`
	Protocol string `yaml:"protocol,omitempty" mapstructure:"protocol"` // "tcp" or "udp", defaults to tcp
}

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

type FirewallConfig struct {
	Enable          bool            `yaml:"enable" mapstructure:"enable"`
	AddDomains      []string        `yaml:"add_domains,omitempty" mapstructure:"add_domains"`
	RemoveDomains   []string        `yaml:"remove_domains,omitempty" mapstructure:"remove_domains"`
	OverrideDomains []string        `yaml:"override_domains,omitempty" mapstructure:"override_domains"`
	IPRangeSources  []IPRangeSource `yaml:"ip_range_sources,omitempty" mapstructure:"ip_range_sources"`
}

type GitCredentialsConfig struct {
	ForwardHTTPS  *bool `yaml:"forward_https,omitempty" mapstructure:"forward_https"`     // Enable HTTPS credential forwarding (default: follows host_proxy)
	ForwardSSH    *bool `yaml:"forward_ssh,omitempty" mapstructure:"forward_ssh"`         // Enable SSH agent forwarding (default: true)
	ForwardGPG    *bool `yaml:"forward_gpg,omitempty" mapstructure:"forward_gpg"`         // Enable GPG agent forwarding (default: true)
	CopyGitConfig *bool `yaml:"copy_git_config,omitempty" mapstructure:"copy_git_config"` // Copy host .gitconfig (default: true)
}

type HealthcheckConfig struct {
	Cmd         []string `yaml:"cmd" mapstructure:"cmd"`
	Interval    string   `yaml:"interval,omitempty" mapstructure:"interval"`
	Timeout     string   `yaml:"timeout,omitempty" mapstructure:"timeout"`
	StartPeriod string   `yaml:"start_period,omitempty" mapstructure:"start_period"`
	Retries     int      `yaml:"retries,omitempty" mapstructure:"retries"`
}

type IPRangeSource struct {
	// Name is the identifier (e.g., "github", "google-cloud", "cloudflare")
	Name string `yaml:"name" mapstructure:"name" json:"name"`
	// URL is an optional custom URL (uses built-in URL if empty for known sources)
	URL string `yaml:"url,omitempty" mapstructure:"url" json:"url,omitempty"`
	// JQFilter extracts CIDR arrays from JSON response (optional, uses built-in if empty)
	JQFilter string `yaml:"jq_filter,omitempty" mapstructure:"jq_filter" json:"jq_filter,omitempty"`
	// Required determines if failure to fetch is fatal (default: false)
	Required *bool `yaml:"required,omitempty" mapstructure:"required" json:"required,omitempty"`
}

type InjectConfig struct {
	AfterFrom          []string `yaml:"after_from,omitempty" mapstructure:"after_from"`
	AfterPackages      []string `yaml:"after_packages,omitempty" mapstructure:"after_packages"`
	AfterUserSetup     []string `yaml:"after_user_setup,omitempty" mapstructure:"after_user_setup"`
	AfterUserSwitch    []string `yaml:"after_user_switch,omitempty" mapstructure:"after_user_switch"`
	AfterClaudeInstall []string `yaml:"after_claude_install,omitempty" mapstructure:"after_claude_install"`
	BeforeEntrypoint   []string `yaml:"before_entrypoint,omitempty" mapstructure:"before_entrypoint"`
}

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

type LoaderOption func(*Loader)

type LoggingConfig struct {
	// FileEnabled enables logging to file (default: true)
	// Set to false in ~/.local/clawker/settings.yaml to disable
	FileEnabled *bool `yaml:"file_enabled,omitempty"`
	// MaxSizeMB is the max size in MB before rotation (default: 50)
	MaxSizeMB int `yaml:"max_size_mb,omitempty"`
	// MaxAgeDays is max days to retain old logs (default: 7)
	MaxAgeDays int `yaml:"max_age_days,omitempty"`
	// MaxBackups is max number of old log files to keep (default: 3)
	MaxBackups int `yaml:"max_backups,omitempty"`
}

type Mode string

type MultiValidationError struct {
	Errors []error
}

type Project struct {
	Version      string          `yaml:"version" mapstructure:"version"`
	Project      string          `yaml:"-" mapstructure:"-"`
	DefaultImage string          `yaml:"default_image,omitempty" mapstructure:"default_image"`
	Build        BuildConfig     `yaml:"build" mapstructure:"build"`
	Agent        AgentConfig     `yaml:"agent" mapstructure:"agent"`
	Workspace    WorkspaceConfig `yaml:"workspace" mapstructure:"workspace"`
	Security     SecurityConfig  `yaml:"security" mapstructure:"security"`
	Ralph        *RalphConfig    `yaml:"ralph,omitempty" mapstructure:"ralph"`
	// contains filtered or unexported fields
}

type ProjectEntry struct {
	Name      string            `yaml:"name"`
	Root      string            `yaml:"root"`
	Worktrees map[string]string `yaml:"worktrees,omitempty"`
}

type ProjectHandle interface {
	// Key returns the project slug key.
	Key() string
	// Get returns the ProjectEntry, loading from disk if needed.
	Get() (*ProjectEntry, error)
	// Root returns the project root directory path.
	Root() (string, error)
	// Exists checks if the project exists in the registry.
	Exists() (bool, error)
	// Update atomically modifies the project entry.
	Update(fn func(*ProjectEntry) error) error
	// Delete removes the project from the registry.
	Delete() (bool, error)
	// Worktree returns a handle for operating on a specific worktree.
	Worktree(name string) WorktreeHandle
	// ListWorktrees returns handles for all worktrees in this project.
	ListWorktrees() ([]WorktreeHandle, error)
}

type ProjectRegistry struct {
	Projects map[string]ProjectEntry `yaml:"projects"`
}

type RalphConfig struct {
	MaxLoops                  int  `yaml:"max_loops,omitempty" mapstructure:"max_loops"`
	StagnationThreshold       int  `yaml:"stagnation_threshold,omitempty" mapstructure:"stagnation_threshold"`
	TimeoutMinutes            int  `yaml:"timeout_minutes,omitempty" mapstructure:"timeout_minutes"`
	CallsPerHour              int  `yaml:"calls_per_hour,omitempty" mapstructure:"calls_per_hour"`
	CompletionThreshold       int  `yaml:"completion_threshold,omitempty" mapstructure:"completion_threshold"`
	SessionExpirationHours    int  `yaml:"session_expiration_hours,omitempty" mapstructure:"session_expiration_hours"`
	SameErrorThreshold        int  `yaml:"same_error_threshold,omitempty" mapstructure:"same_error_threshold"`
	OutputDeclineThreshold    int  `yaml:"output_decline_threshold,omitempty" mapstructure:"output_decline_threshold"`
	MaxConsecutiveTestLoops   int  `yaml:"max_consecutive_test_loops,omitempty" mapstructure:"max_consecutive_test_loops"`
	LoopDelaySeconds          int  `yaml:"loop_delay_seconds,omitempty" mapstructure:"loop_delay_seconds"`
	SafetyCompletionThreshold int  `yaml:"safety_completion_threshold,omitempty" mapstructure:"safety_completion_threshold"`
	SkipPermissions           bool `yaml:"skip_permissions,omitempty" mapstructure:"skip_permissions"`
}

type Registry interface {
	// Project returns a handle for operating on a specific project.
	Project(key string) ProjectHandle
	// Load reads and parses the registry file.
	Load() (*ProjectRegistry, error)
	// Save writes the registry to the file.
	Save(r *ProjectRegistry) error
	// Register adds a project to the registry, returns the slug key used.
	Register(displayName, rootDir string) (string, error)
	// Unregister removes a project from the registry by key.
	Unregister(key string) (bool, error)
	// UpdateProject atomically updates a project entry in the registry.
	UpdateProject(key string, fn func(*ProjectEntry) error) error
	// Path returns the full path to the registry file.
	Path() string
	// Exists checks if the registry file exists.
	Exists() bool
}

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

type Resolution struct {
	ProjectKey   string
	ProjectEntry ProjectEntry
	WorkDir      string
}

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

type RunInstruction struct {
	Cmd    string `yaml:"cmd,omitempty" mapstructure:"cmd"`       // Generic command for both OS
	Alpine string `yaml:"alpine,omitempty" mapstructure:"alpine"` // Alpine-specific command
	Debian string `yaml:"debian,omitempty" mapstructure:"debian"` // Debian-specific command
}

type SecurityConfig struct {
	Firewall        *FirewallConfig       `yaml:"firewall,omitempty" mapstructure:"firewall"`
	DockerSocket    bool                  `yaml:"docker_socket" mapstructure:"docker_socket"`
	CapAdd          []string              `yaml:"cap_add,omitempty" mapstructure:"cap_add"`
	EnableHostProxy *bool                 `yaml:"enable_host_proxy,omitempty" mapstructure:"enable_host_proxy"` // defaults to true
	GitCredentials  *GitCredentialsConfig `yaml:"git_credentials,omitempty" mapstructure:"git_credentials"`
}

type Settings struct {
	// Logging configures file-based logging.
	// File logging is ENABLED by default - users can disable via settings.yaml.
	Logging LoggingConfig `yaml:"logging,omitempty"`

	// DefaultImage is the user's preferred default container image.
	// Set by 'clawker init' after building the base image.
	DefaultImage string `yaml:"default_image,omitempty"`
}

type SettingsLoader interface {
	Path() string
	ProjectSettingsPath() string
	Exists() bool
	Load() (*Settings, error)
	Save(s *Settings) error
	EnsureExists() (bool, error)
}

type SettingsLoaderOption func(*FileSettingsLoader)

type ValidationError struct {
	Field   string
	Message string
	Value   interface{}
}

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

type WorkspaceConfig struct {
	RemotePath  string `yaml:"remote_path" mapstructure:"remote_path"`
	DefaultMode string `yaml:"default_mode" mapstructure:"default_mode"`
}

type WorktreeDirInfo struct {
	Name string // original branch name
	Slug string // slugified directory name
	Path string // full filesystem path
}

type WorktreeHandle interface {
	// Name returns the branch name that the worktree is tracking.
	Name() string
	// Slug returns the filesystem-safe slug.
	Slug() string
	// Path returns the worktree directory path.
	Path() (string, error)
	// DirExists returns true if the clawker-managed worktree directory exists
	// at ~/.local/clawker/projects/<key>/worktrees/<slug>.
	DirExists() bool
	// GitExists returns true if git worktree metadata is valid.
	// Reads <worktree-path>/.git file and validates it points to the correct location
	// in the project's .git/worktrees/<slug> directory.
	GitExists() bool
	// Status returns the health status by calling DirExists() and GitExists().
	Status() *WorktreeStatus
	// Delete removes the worktree entry from the registry.
	Delete() error
}

type WorktreeStatus struct {
	Name      string // Branch name that the worktree is tracking
	Slug      string // Filesystem-safe slug
	Path      string // Worktree directory path
	DirExists bool   // Worktree directory exists on filesystem
	GitExists bool   // .git file exists and points to valid git metadata
	Error     error  // Non-nil if path resolution failed
}