errors

type BuildError struct {
	Err            error
	Code           string
	Category       string
	Strategy       models.BuildStrategy
	GeneratedFlake string
	Suggestions    []string
	DetectedIssues []string
	NextSteps      []string
	CanRetryAsOCI  bool
}

type BuildErrorResponse struct {
	// Error is the main error message.
	Error string `json:"error"`

	// Code is a machine-readable error code.
	Code string `json:"code"`

	// Category groups errors by type (detection, template, build, timeout).
	Category string `json:"category"`

	// Strategy is the build strategy that was being used when the error occurred.
	Strategy string `json:"strategy,omitempty"`

	// GeneratedFlake contains the generated flake.nix content for debugging template issues.
	GeneratedFlake string `json:"generated_flake,omitempty"`

	// Suggestions provides actionable suggestions to resolve the error.
	Suggestions []string `json:"suggestions,omitempty"`

	// Documentation is a URL to relevant documentation.
	Documentation string `json:"documentation_url,omitempty"`

	// CanRetryAsOCI indicates whether the build can be retried as an OCI build.
	CanRetryAsOCI bool `json:"can_retry_as_oci"`

	// DetectedIssues lists specific problems found during the build.
	DetectedIssues []string `json:"detected_issues,omitempty"`

	// NextSteps provides guidance on what the user should do next.
	NextSteps []string `json:"next_steps,omitempty"`
}