config

type AppState interface {
	// GetHelpScreensSeen returns the bitmask of seen help screens
	GetHelpScreensSeen() uint32
	// SetHelpScreensSeen updates the bitmask of seen help screens
	SetHelpScreensSeen(seen uint32) error
	// GetOnboarded returns whether the onboarding ritual has been completed.
	GetOnboarded() bool
	// SetOnboarded marks onboarding as complete and persists the state.
	SetOnboarded(onboarded bool) error
}

type Automation struct {
	ID           string `json:"id"`
	Name         string `json:"name"`
	Instructions string `json:"instructions"`
	// Program is the agent command used for automation runs (e.g. claude, codex).
	Program string `json:"program,omitempty"`
	// RepoPath is the repository path where this automation should run.
	RepoPath string    `json:"repo_path,omitempty"`
	Schedule string    `json:"schedule"`
	Enabled  bool      `json:"enabled"`
	LastRun  time.Time `json:"last_run,omitempty"`
	NextRun  time.Time `json:"next_run"`
}

type Config struct {
	// DefaultProgram is the default program to run in new instances
	DefaultProgram string `json:"default_program"`
	// AutoYes is a flag to automatically accept all prompts.
	AutoYes bool `json:"auto_yes"`
	// DaemonPollInterval is the interval (ms) at which the daemon polls sessions for autoyes mode.
	DaemonPollInterval int `json:"daemon_poll_interval"`
	// BranchPrefix is the prefix used for git branches created by the application.
	BranchPrefix string `json:"branch_prefix"`
	// NotificationsEnabled controls whether macOS/Linux desktop notifications
	// are sent when an agent finishes (Running -> Ready).
	NotificationsEnabled *bool `json:"notifications_enabled,omitempty"`
	// SkipGitHooks controls whether --no-verify is passed to git commit.
	// Defaults to true (skip hooks) for reliability — pre-commit hooks can
	// block pause/resume. Set to false if your repo has mandatory hooks
	// (e.g. secret scanning).
	SkipGitHooks *bool `json:"skip_git_hooks,omitempty"`
	// Memory configures the IDE-wide memory system.
	Memory *MemoryConfig `json:"memory,omitempty"`
}

type InstanceStorage interface {
	// SaveInstances saves the raw instance data
	SaveInstances(instancesJSON json.RawMessage) error
	// GetInstances returns the raw instance data
	GetInstances() json.RawMessage
	// DeleteAllInstances removes all stored instances
	DeleteAllInstances() error
}

type MemoryConfig struct {
	// Enabled turns the memory system on/off. Default false until configured.
	Enabled bool `json:"enabled"`
	// EmbeddingProvider selects the embedding backend: "openai", "ollama", or "none".
	// When "none" or unset, memory search falls back to keyword-only (FTS).
	EmbeddingProvider string `json:"embedding_provider,omitempty"`
	// OpenAIAPIKey is the API key for OpenAI embeddings.
	OpenAIAPIKey string `json:"openai_api_key,omitempty"`
	// OpenAIModel is the embedding model name. Default "text-embedding-3-small".
	OpenAIModel string `json:"openai_model,omitempty"`
	// OllamaURL is the Ollama server URL. Default "http://localhost:11434".
	OllamaURL string `json:"ollama_url,omitempty"`
	// OllamaModel is the Ollama model name. Default "nomic-embed-text".
	OllamaModel string `json:"ollama_model,omitempty"`
	// ClaudeModel is the model used for re-ranking with the "claude" provider.
	// Defaults to "claude-haiku-4-5-20251001" — works with both API key and Max subscription.
	ClaudeModel string `json:"claude_model,omitempty"`
	// StartupInjectCount controls how many memory snippets are injected into
	// CLAUDE.md when starting an agent. Default 5.
	StartupInjectCount int `json:"startup_inject_count,omitempty"`
	// GitEnabled controls whether memory changes are git-versioned.
	// Default true. Set to false to disable auto-commits in the memory directory.
	GitEnabled *bool `json:"git_enabled,omitempty"`
	// SystemBudgetChars is the max characters of system/ file content injected
	// into CLAUDE.md at startup. Default 4000.
	SystemBudgetChars int `json:"system_budget_chars,omitempty"`
}

type Skill struct {
	Name         string   // display name
	Description  string   // short description shown in picker
	ContextFiles []string // absolute or ~-relative paths to include as context
	SetupScript  string   // shell command to run before agent starts
	Instructions string   // the markdown body — prepended to the agent prompt
	SourceFile   string   // path to the .md file (for display)
}

type State struct {
	// HelpScreensSeen is a bitmask tracking which help screens have been shown
	HelpScreensSeen uint32 `json:"help_screens_seen"`
	// Instances stores the serialized instance data as raw JSON
	InstancesData json.RawMessage `json:"instances"`
	// TopicsData stores the serialized topic data as raw JSON
	TopicsData json.RawMessage `json:"topics,omitempty"`
	// RecentRepos stores recently opened repo paths so they persist in the picker
	RecentRepos []string `json:"recent_repos,omitempty"`
	// Onboarded indicates the companion bootstrap ritual has been completed.
	Onboarded bool `json:"onboarded,omitempty"`
}

type StateManager interface {
	InstanceStorage
	TopicStorage
	AppState
}

type TopicStorage interface {
	SaveTopics(topicsJSON json.RawMessage) error
	GetTopics() json.RawMessage
}