integrations

type ConfigFormat string

type ConfigPatchFunc func(configData []byte, targetFile string, install bool) ([]byte, error)

type Definition struct {
	ID          ID
	Name        string
	Description string
	Type        IntegrationType
	Template    string // embedded template content

	// TargetFileFunc returns the absolute path where the rendered template is written.
	TargetFileFunc func(dirs Dirs) string

	// ConfigFileFunc returns the absolute path to the target tool's config file.
	// Implementations must check tool-specific env var overrides internally
	// (e.g., CODEX_CONFIG_DIR, CLAUDE_SETTINGS_FILE).
	ConfigFileFunc func(dirs Dirs) string
	ConfigFormat   ConfigFormat
	ConfigPatcher  ConfigPatchFunc

	Detector DetectFunc

	// MatchProviderIDs lists provider IDs from detect.Result.Accounts that
	// correspond to this integration. This is the stable join key for
	// matching auto-detected accounts to integration definitions.
	MatchProviderIDs []string

	// MatchToolNameHint is a substring to match against detect.DetectedTool.Name
	// for associating a detected tool entry with this integration. Empty means
	// no tool matching (env-key-only providers like OpenCode).
	MatchToolNameHint string

	// TemplateFileMode is the file permission for the rendered template file.
	TemplateFileMode os.FileMode

	// EscapeBin transforms the openusage binary path for template substitution.
	EscapeBin func(string) string
}

type DetectFunc func(dirs Dirs) Status

type Dirs struct {
	Home         string
	ConfigRoot   string // XDG_CONFIG_HOME or ~/.config
	HooksDir     string // ~/.config/openusage/hooks
	OpenusageBin string // resolved binary path
}

type ID string

type InstallResult struct {
	ID           ID
	Action       string // "installed", "upgraded", "already_current", "uninstalled"
	TemplateFile string
	ConfigFile   string
	PreviousVer  string
	InstalledVer string
}

type IntegrationType string

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

type Match struct {
	Definition Definition
	Tool       *detect.DetectedTool
	Account    *core.AccountConfig
	Status     Status
	Actionable bool // true if tool/account detected AND not installed
}

type Status struct {
	ID               ID
	Name             string
	Installed        bool
	Configured       bool
	InstalledVersion string
	DesiredVersion   string
	NeedsUpgrade     bool
	State            string
	Summary          string
}