integrations

type HealthStatus struct {
	// Healthy indicates if the integration is functioning correctly
	Healthy bool

	// Status is a human-readable status message
	Status string

	// Details provides additional information about the health check
	Details map[string]any

	// LastChecked is the timestamp of the last health check
	LastChecked string
}

type Integration interface {

	// GetName returns the unique identifier for this integration (e.g., "claude-code-hook")
	GetName() string

	// GetDescription returns a human-readable description of the integration
	GetDescription() string

	// GetVersion returns the integration adapter version
	GetVersion() string

	// Detect checks if the agent framework is installed on the system
	// Returns true if the framework's configuration directory/files exist
	Detect() (bool, error)

	// IsEnabled checks if this integration is currently configured and active
	// Returns true if hooks/configuration have been set up
	IsEnabled() (bool, error)

	// Setup configures the integration by installing hooks or modifying framework config
	// binaryPath is the path to the agentic-memorizer binary
	// Returns error if setup fails
	Setup(binaryPath string) error

	// Update modifies an existing integration configuration
	// Used when the binary path or integration settings change
	// Returns error if update fails
	Update(binaryPath string) error

	// Remove uninstalls the integration by removing hooks or configuration
	// Returns error if removal fails
	Remove() error

	// GetCommand returns the full command string that the framework should execute
	// binaryPath is the path to the agentic-memorizer binary
	// format is the desired output format (xml, markdown, json)
	// Returns a command string like "agentic-memorizer read --format xml --integration claude-code-hook"
	GetCommand(binaryPath string, format OutputFormat) string

	// FormatOutput formats the index for this specific integration
	// Applies integration-specific wrapping (e.g., SessionStart JSON for Claude Code)
	// index is the memory index to format
	// format is the base output format (xml, markdown, json)
	// Returns formatted string ready for the framework to consume
	FormatOutput(index *types.Index, format OutputFormat) (string, error)

	// Validate checks the health of the integration configuration
	// Returns error if configuration is invalid or inconsistent
	Validate() error

	// Reload applies configuration changes without full teardown/setup
	// newConfig contains the updated integration configuration
	// Returns error if reload fails (caller should rollback)
	Reload(newConfig IntegrationConfig) error
}

type IntegrationConfig struct {
	// Type is the integration type (e.g., "claude-code-hook", "continue", "cline")
	Type string `mapstructure:"type" yaml:"type"`

	// Enabled indicates if this integration is active
	Enabled bool `mapstructure:"enabled" yaml:"enabled"`

	// OutputFormat is the preferred output format for this integration
	OutputFormat string `mapstructure:"output_format" yaml:"output_format"`

	// Settings contains integration-specific settings
	// For Claude Code: settings_path, matchers
	// For Continue: config_path
	// For Cline: config_path
	Settings map[string]any `mapstructure:"settings" yaml:"settings"`
}

type IntegrationsConfig struct {
	// Enabled is a list of integration names that are enabled
	Enabled []string `mapstructure:"enabled" yaml:"enabled"`
}

type OutputFormat string

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