init

type AgentInstallPrompter interface {
	ConfirmAgentInstall() (bool, error)
}

type ClaudeMigratePrompter interface {
	ConfirmMigrateClaude() (bool, error)
	PromptContainerPath(detected string) (string, error)
}

type DevcontainerPrompter interface {
	ConfirmDevcontainer() (bool, error)
	ConfirmOverwriteDevcontainer() (bool, error)
	ConfirmProxy() (bool, error)
	ConfirmIntercept() (bool, error)
	SelectStacks(available []StackType) ([]StackType, error)
}

type LspInstaller interface {
	IsInstalled(binary string) bool
	Install(cmd string) error
	InstallPlugin(pluginID string) error
	EnsureMarketplace(repo string) error
}

type LspPlugin struct {
	Label       string // display name, e.g. "gopls (Go)"
	PluginID    string // e.g. "gopls@claude-code-lsps"
	Binary      string // binary name to check on PATH
	InstallCmd  string // auto-install command for the LSP binary (empty = manual only)
	InstallHint string // manual install hint for the LSP binary
}

type LspPrompter interface {
	SelectLspPlugins(available []LspPlugin) ([]LspPlugin, error)
}

type OSLspInstaller struct{}

type OSPathLooker struct{}

type PathLooker interface {
	LookPath(file string) (string, error)
}

type Prerequisite struct {
	Binary     string // binary name to look up on PATH
	Purpose    string // short description of why it's needed
	InstallURL string // URL with install instructions
}

type Prompter interface {
	ServicesPrompter
	VaultPrompter
	DevcontainerPrompter
	ClaudeMigratePrompter
	LspPrompter
	AgentInstallPrompter
}

type ServiceType struct {
	Label       string   // display name, e.g. "Jira"
	ConfigKey   string   // YAML top-level key, e.g. "jiras"
	DefaultURL  string   // empty means user must provide it
	URLRequired bool     // if true and DefaultURL is empty, prompt for URL
	ExtraFields []string // additional fields beyond name+description, e.g. "user", "org"
	EnvVars     []string // env var suffixes, e.g. ["KEY"] → JIRA_{NAME}_KEY
	EnvPrefix   string   // e.g. "JIRA"
}

type ServicesPrompter interface {
	ConfirmOverwrite() (bool, error)
	ConfirmAddTrackers() (bool, error)
	SelectServices(available []ServiceType) ([]ServiceType, error)
	PromptInstance(svc ServiceType) (map[string]string, error)
}

type StackType struct {
	Label      string // display name, e.g. "Go"
	FeatureKey string // devcontainer feature reference, e.g. "ghcr.io/devcontainers/features/go:1"
	Fixed      bool   // always included, cannot be deselected (shown as pre-checked)
}

type VaultPrompter interface {
	SelectVaultProvider(available []string) (string, error)
	PromptVaultAccount() (string, error)
}

type WizardState struct {
	SelectedStacks   []StackType
	ProxyEnabled     bool
	InterceptEnabled bool
	VaultProvider    string // e.g. "1password", empty if none
	VaultAccount     string // e.g. 1Password account name
}

type WizardStep interface {
	Name() string
	Run(w io.Writer, fw claude.FileWriter) (hints []string, err error)
}