config

type AgentConfigLoader interface {
	// Load reads and returns the workspace configuration for the specified agent.
	// Returns an empty configuration (not an error) if the agents.json file doesn't exist.
	// Returns an error if the file exists but is invalid JSON or malformed.
	Load(agentName string) (*workspace.WorkspaceConfiguration, error)
}

type AgentConfigUpdater interface {
	// AddEnvVar adds or updates an environment variable in the agent's config.
	// If an entry with the same name already exists its value is replaced.
	AddEnvVar(agentName, name, value string) error

	// AddMount adds a mount entry to the agent's config.
	// The call is idempotent: if a mount with the same host and target already exists
	// it is not duplicated.
	AddMount(agentName, host, target string, ro bool) error
}

type Config interface {
	// Load reads and parses the workspace configuration from workspace.json.
	// Returns ErrConfigNotFound if the workspace.json file doesn't exist.
	// Returns an error if the JSON is malformed or cannot be read.
	Load() (*workspace.WorkspaceConfiguration, error)
}

type Merger interface {
	// Merge combines two WorkspaceConfiguration objects.
	// The override config takes precedence over the base config.
	// Returns a new merged configuration without modifying the inputs.
	Merge(base, override *workspace.WorkspaceConfiguration) *workspace.WorkspaceConfiguration
}

type ProjectConfigLoader interface {
	// Load reads and returns the workspace configuration for the specified project.
	// It first loads the global configuration (empty string "" key), then loads
	// the project-specific configuration, and merges them with project-specific
	// taking precedence.
	// Returns an empty configuration (not an error) if the projects.json file doesn't exist.
	// Returns an error if the file exists but is invalid JSON or malformed.
	Load(projectID string) (*workspace.WorkspaceConfiguration, error)
}

type ProjectConfigUpdater interface {
	// AddSecret appends secretName to the Secrets list of the given project.
	// projectID is "" for the global configuration.
	// The call is idempotent: if the secret is already present it is not duplicated.
	AddSecret(projectID string, secretName string) error

	// AddMount adds a mount entry to the given project's config.
	// projectID is "" for the global configuration.
	// The call is idempotent: if a mount with the same host and target already exists
	// it is not duplicated.
	AddMount(projectID, host, target string, ro bool) error
}

type WorkspaceConfigUpdater interface {
	// AddSecret appends secretName to the Secrets list of the workspace config,
	// creating the file and directory if they do not yet exist.
	// The call is idempotent: if the secret is already present it is not duplicated.
	AddSecret(secretName string) error

	// AddEnvVar adds or updates an environment variable in the workspace config.
	// If an entry with the same name already exists its value is replaced.
	AddEnvVar(name, value string) error

	// AddMount adds a mount entry to the workspace config.
	// The call is idempotent: if a mount with the same host and target already exists
	// it is not duplicated.
	AddMount(host, target string, ro bool) error

	// AddPort appends port to the Ports list of the workspace config.
	// The call is idempotent: if the port is already present it is not duplicated.
	AddPort(port int) error

	// AddFeature adds a feature entry to the Features map of the workspace config.
	// The call is idempotent: if the feature ID is already present it is not modified.
	AddFeature(featureID string, options map[string]interface{}) error
}