addon

type Manifest struct {
	Name         string   `json:"name"`
	Version      string   `json:"version"`
	Description  string   `json:"description"`
	Repo         string   `json:"repo"`
	DependsOn    []string `json:"depends_on,omitempty"`
	Capabilities []string `json:"capabilities,omitempty"`
	Resources    []string `json:"resources,omitempty"`
	Steps        []Step   `json:"steps"`
}

type Registry struct {
	Version string          `json:"version"`
	Addons  []RegistryEntry `json:"addons"`
}

type RegistryEntry struct {
	Alias       string `json:"alias"`
	Repo        string `json:"repo"`
	Description string `json:"description"`
	Official    bool   `json:"official"`
}

type Step struct {
	// Type is one of: go_get | env | property | main_import | main_code |
	// create_provider_file | note
	Type string `json:"type"`

	// go_get
	Package string `json:"package,omitempty"`

	// env | property
	Key         string `json:"key,omitempty"`
	Example     string `json:"example,omitempty"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
	Secret      bool   `json:"secret,omitempty"`
	Message     string `json:"message,omitempty"`

	// main_import
	Path string `json:"path,omitempty"`

	// main_code
	Anchor string `json:"anchor,omitempty"` // "before_listen" | "before_modules"
	Guard  string `json:"guard,omitempty"`  // skip if already present
	// Replace, when set, replaces the first line in cmd/main.go containing this
	// substring with Code before falling back to insertion.
	Replace string `json:"replace,omitempty"`
	Code    string `json:"code,omitempty"`

	// create_provider_file creates a dedicated setup file with an initializer
	// function, keeping cmd/main.go clean. Guard checks the file before creating.
	Filename string `json:"filename,omitempty"` // e.g. "cmd/setup_provider.go"
	Content  string `json:"content,omitempty"`  // full Go source for the file
}