Add configurable transient retries for CLI execution

internal/config/config.go

@@ -33,12 +33,13 @@ var (
 
 // Config is the on-disk YAML shape for application-level settings.
 type Config struct {
-	PromptDir  string                   `yaml:"prompt_dir"`
-	ProfileDir string                   `yaml:"profile_dir"`
-	SchemaDir  string                   `yaml:"schema_dir"`
-	Server     ServerConfig             `yaml:"server"`
-	Defaults   DefaultsConfig           `yaml:"defaults"`
-	Backends   map[string]BackendConfig `yaml:"backends"`
+	PromptDir        string                   `yaml:"prompt_dir"`
+	ProfileDir       string                   `yaml:"profile_dir"`
+	SchemaDir        string                   `yaml:"schema_dir"`
+	TransientRetries *strictInteger           `yaml:"transient_retries"`
+	Server           ServerConfig             `yaml:"server"`
+	Defaults         DefaultsConfig           `yaml:"defaults"`
+	Backends         map[string]BackendConfig `yaml:"backends"`
 }
 
 type BackendConfig struct {
@@ -49,6 +50,20 @@ type BackendConfig struct {
 	QueueCapacity    *int           `yaml:"queue_capacity"`
 }
 
+type strictInteger int
+
+func (value *strictInteger) UnmarshalYAML(node *yaml.Node) error {
+	if node.Tag != "!!int" {
+		return fmt.Errorf("expected integer, got %s", node.Tag)
+	}
+	var decoded int
+	if err := node.Decode(&decoded); err != nil {
+		return err
+	}
+	*value = strictInteger(decoded)
+	return nil
+}
+
 type BackendSettings struct {
 	ID               string
 	Endpoint         string
@@ -82,6 +97,7 @@ type AppSettings struct {
 	MaxResponseBytes    int64
 	DefaultRenderFormat renderformat.PreparedRunOutputFormat
 	Backends            []BackendSettings
+	TransientRetries    *int
 }
 
 // CLIOverrides can be applied after config load to enforce precedence.
@@ -224,6 +240,13 @@ func decodeConfig(raw []byte) (Config, error) {
 
 func applyConfig(base AppSettings, cfg Config) (AppSettings, error) {
 	out := base
+	if cfg.TransientRetries != nil {
+		if *cfg.TransientRetries < 0 {
+			return AppSettings{}, fmt.Errorf("%w: transient_retries must be greater than or equal to 0", ErrInvalidConfig)
+		}
+		value := int(*cfg.TransientRetries)
+		out.TransientRetries = &value
+	}
 
 	if v := strings.TrimSpace(cfg.PromptDir); v != "" {
 		out.PromptDir = filepath.Clean(v)