errors

Dec 18, 2025

Changes in this version

+ var ErrApplyBucketDefaults = errors.New("failed to apply bucket defaults")

+ var ErrApplyTags = errors.New("failed to apply tags")

+ var ErrBackendNotFound = errors.New("backend configuration not found")

+ var ErrBlockPublicAccess = errors.New("failed to block public access")

+ var ErrBucketNotEmpty = errors.New("bucket contains objects and cannot be deleted")

+ var ErrBucketRequired = errors.New("backend.bucket is required")

+ var ErrCheckBucketExist = errors.New("failed to check bucket existence")

+ var ErrCreateBucket = errors.New("failed to create bucket")

+ var ErrCreateNotImplemented = errors.New("create not implemented for backend type")

+ var ErrDeleteBucket = errors.New("failed to delete bucket")

+ var ErrDeleteNotImplemented = errors.New("delete not implemented for backend type")

+ var ErrDeleteObjects = errors.New("failed to delete objects from bucket")

+ var ErrDeprecatedCmdNotCallable = errors.New("deprecated command should not be called")

+ var ErrEnableEncryption = errors.New("failed to enable encryption")

+ var ErrEnableVersioning = errors.New("failed to enable versioning")

+ var ErrFailedToLoadTerraformComponent = errors.New("failed to load terraform component")

+ var ErrFileTemplateRequired = errors.New("file-template is required")

+ var ErrForceRequired = errors.New("--force flag required for backend deletion")

+ var ErrInteractiveModeNotAvailable = errors.New("interactive mode not available")

+ var ErrInteractiveNotAvailable = errors.New("interactive confirmation not available in non-TTY environment")

+ var ErrListObjects = errors.New("failed to list bucket objects")

+ var ErrLocalsCircularDep = errors.New("circular dependency in locals")

+ var ErrLocalsDependencyExtract = errors.New("failed to extract dependencies for local")

+ var ErrLocalsInvalidType = errors.New("locals must be a map")

+ var ErrLocalsResolution = errors.New("failed to resolve local")

+ var ErrMissingTerraformBackendConfig = errors.New("'backend' config is missing for the component")

+ var ErrMissingTerraformBackendType = errors.New("'backend_type' is missing for the component")

+ var ErrMissingTerraformWorkspaceKeyPrefix = errors.New("backend config is missing 'workspace_key_prefix'")

+ var ErrNoOptionsAvailable = errors.New("no options available")

+ var ErrProvisionerFailed = errors.New("provisioner failed")

+ var ErrRegionRequired = errors.New("backend.region is required")

+ var ErrS3BucketAccessDenied = errors.New("access denied to S3 bucket")

+ var ErrStateFilesExist = errors.New("bucket contains terraform state files")

+ var ErrUnknownSubcommand = errors.New("unknown subcommand")

+ var ErrWorkingDirAccessFailed = errors.New("failed to access working directory")

+ var ErrWorkingDirNotDirectory = errors.New("working directory path is not a directory")

+ var ErrWorkingDirNotFound = errors.New("working directory does not exist")

Dec 10, 2025

Changes in this version

+ var ErrAmbiguousComponentPath = errors.New("ambiguous component path")

+ var ErrAuthProviderNotAvailable = errors.New("auth provider is not available")

+ var ErrAwsGetCallerIdentity = errors.New("failed to get AWS caller identity")

+ var ErrBackendConfigEmpty = errors.New("'backend' section is empty but 'backend_type' requires configuration")

+ var ErrBackendSectionMissing = errors.New("no 'backend' section configured")

+ var ErrBackendTypeEmptyAfterRender = errors.New("'backend_type' is empty after template processing")

+ var ErrBackendTypeMissing = errors.New("no 'backend_type' configured")

+ var ErrBackendTypeRequired = errors.New("backend_type is required")

+ var ErrCannotNavigatePath = errors.New("cannot navigate path: field is not a map")

+ var ErrComponentNotInStack = errors.New("component not found in stack configuration")

+ var ErrComponentTypeMismatch = errors.New("path component type does not match command")

+ var ErrContainerAlreadyExists = errors.New("container already exists")

+ var ErrContainerNotFound = errors.New("container not found")

+ var ErrContainerNotRunning = errors.New("container is not running")

+ var ErrContainerRunning = errors.New("container is running")

+ var ErrContainerRuntimeOperation = errors.New("container runtime operation failed")

+ var ErrDevcontainerNameEmpty = errors.New("devcontainer name cannot be empty")

+ var ErrDevcontainerNameInvalid = errors.New("devcontainer name contains invalid characters")

+ var ErrDevcontainerNameTooLong = errors.New("devcontainer name is too long")

+ var ErrDevcontainerNotFound = errors.New("devcontainer not found")

+ var ErrEmptyPath = errors.New("empty path")

+ var ErrInvalidConfig = errors.New("invalid configuration")

+ var ErrInvalidDevcontainerConfig = errors.New("invalid devcontainer configuration")

+ var ErrInvalidFromStep = errors.New("invalid from-step flag")

+ var ErrInvalidStackConfiguration = errors.New("invalid stack configuration")

+ var ErrInvalidVersionConstraint = errors.New("invalid version constraint")

+ var ErrInvalidWorkflowManifest = errors.New("invalid workflow manifest")

+ var ErrInvalidWorkflowStepType = errors.New("invalid workflow step type")

+ var ErrLoadAWSConfig = errors.New("failed to load AWS config")

+ var ErrMissingAtmosConfig = errors.New("atmos configuration not found or invalid")

+ var ErrNoStacksFound = errors.New("no stacks found")

+ var ErrNotInGitRepository = errors.New("not inside a git repository")

+ var ErrPTYNotSupported = errors.New("PTY not supported on this platform")

+ var ErrPathIsComponentBase = errors.New("must specify a component directory, not the base directory")

+ var ErrPathNotInComponentDir = errors.New("path is not within Atmos component directories")

+ var ErrPathNotWithinComponentBase = errors.New("path is not within component base path")

+ var ErrPathResolutionFailed = errors.New("failed to resolve component from path")

+ var ErrRuntimeNotAvailable = errors.New("container runtime not available")

+ var ErrTemplateEvaluation = errors.New("template evaluation failed")

+ var ErrTerraformBackendAPIError = errors.New("terraform backend API error")

+ var ErrTerraformOutputNotFound = errors.New("terraform output not found")

+ var ErrTerraformStateNotProvisioned = errors.New("terraform state not provisioned")

+ var ErrUnknownListMergeStrategy = errors.New("unknown list merge strategy")

+ var ErrVersionConstraint = errors.New("version constraint not satisfied")

+ var ErrWorkflowFileNotFound = errors.New("workflow file not found")

+ var ErrWorkflowNoSteps = errors.New("workflow has no steps defined")

+ var ErrWorkflowNoWorkflow = errors.New("no workflow found")

+ var ErrWorkflowStepFailed = errors.New("workflow step execution failed")

type ErrorBuilder

+ func (b *ErrorBuilder) WithCause(cause error) *ErrorBuilder

Nov 24, 2025

Changes in this version

+ const ErrWrapFormat

+ var ErrMissingAccountSpec = errors.New("account specification is required in principal")

+ var ErrMissingAssumeRole = errors.New("assume_role is required in principal")

+ var ErrMissingPermissionSet = errors.New("permission set name is required in principal")

+ var ErrMissingPrincipal = errors.New("principal is required")

+ var ErrSSOAccountListFailed = errors.New("failed to list aws sso accounts")

+ var ErrSSODeviceAuthFailed = errors.New("aws sso device authorization failed")

+ var ErrSSOInvalidToken = errors.New("invalid aws sso token")

+ var ErrSSOProvisioningFailed = errors.New("aws sso identity provisioning failed")

+ var ErrSSORoleListFailed = errors.New("failed to list aws sso roles")

+ var ErrSSOSessionExpired = errors.New("aws sso session expired")

+ var ErrSSOTokenCreationFailed = errors.New("aws sso token creation failed")

Nov 18, 2025

Changes in this version

+ const CloseSentryTimeout

+ const DefaultMarkdownWidth

+ const DefaultMaxLineLength

+ const EnvVerbose

+ const ExitCodeSIGINT

+ var ErrAtlantisConfigTemplateNotDef = errors.New("atlantis config template is not defined")

+ var ErrAtlantisConfigTemplateNotSpec = errors.New("atlantis config template is not specified")

+ var ErrAtlantisInvalidFlags = errors.New("incompatible atlantis flags")

+ var ErrAtlantisProjectTemplateNotDef = errors.New("atlantis project template is not defined")

+ var ErrAtmosConfigNotFound = errors.New("atmos configuration file not found")

+ var ErrAzureExpirationTimeEmpty = errors.New("expiration time is empty")

+ var ErrAzureInvalidJWTFormat = errors.New("invalid JWT format")

+ var ErrAzureNoAccountForTenant = errors.New("no account found for tenant")

+ var ErrAzureNoAccountsInCache = errors.New("no accounts found in cache")

+ var ErrAzureOIDClaimNotFound = errors.New("oid claim not found in token")

+ var ErrAzureTimeParseFailure = errors.New("unable to parse time: tried RFC3339, local time formats, and Unix timestamp")

+ var ErrAzureUsernameClaimNotFound = errors.New("no username claim found in token (tried upn, unique_name, email)")

+ var ErrCUEValidationUnsupported = errors.New("validation using CUE is not supported yet")

+ var ErrCommandFailed = errors.New("command execution failed")

+ var ErrComponentEmpty = errors.New("component is empty")

+ var ErrComponentNameRequired = errors.New("component name is required")

+ var ErrComponentNotFoundInSections = errors.New("component not found in terraform or helmfile sections")

+ var ErrComponentsSectionNotFound = errors.New("components section not found in stack")

+ var ErrDescribingStacks = errors.New("error describing stacks")

+ var ErrEmptyTargetComponentName = errors.New("target component name cannot be empty")

+ var ErrGettingAbstractFlag = errors.New("error getting abstract flag")

+ var ErrGettingCommonFlags = errors.New("error getting common flags")

+ var ErrGettingVarsFlag = errors.New("error getting vars flag")

+ var ErrInitializingCLIConfig = errors.New("error initializing CLI config")

+ var ErrInvalidArguments = errors.New("invalid arguments")

+ var ErrInvalidAuthManagerType = errors.New("invalid authManager type")

+ var ErrInvalidFilePath = errors.New("invalid file path")

+ var ErrInvalidFormat = errors.New("invalid format")

+ var ErrInvalidStackPattern = errors.New("invalid stack pattern")

+ var ErrInvalidTemplateSettings = errors.New("invalid template settings")

+ var ErrInvalidTheme = errors.New("invalid theme")

+ var ErrKeychainDeletionRequiresConfirmation = errors.New("keychain deletion requires interactive confirmation or --force flag")

+ var ErrMissingComponent = errors.New("component is required")

+ var ErrMissingComponentType = errors.New("component type is required")

+ var ErrNewPlanFileNotExist = errors.New("new plan file does not exist")

+ var ErrNoJSONOutput = errors.New("no JSON output found in terraform show output")

+ var ErrOriginalPlanFileNotExist = errors.New("original plan file does not exist")

+ var ErrOriginalPlanFileRequired = errors.New("original plan file is required")

+ var ErrOutputFormat = errors.New("output format error")

+ var ErrProfileDirNotAccessible = errors.New("profile directory not accessible")

+ var ErrProfileDirNotExist = errors.New("profile directory does not exist")

+ var ErrProfileDiscovery = errors.New("failed to discover profiles")

+ var ErrProfileInvalidMetadata = errors.New("invalid profile metadata")

+ var ErrProfileLoad = errors.New("failed to load profile")

+ var ErrProfileMerge = errors.New("failed to merge profile configuration")

+ var ErrProfileNotFound = errors.New("profile not found")

+ var ErrProfileSyntax = errors.New("profile syntax error")

+ var ErrQueryFailed = errors.New("query execution failed")

+ var ErrRelPath = errors.New("error determining relative path")

+ var ErrRemoteRepoNotGitRepo = errors.New("target remote repository is not a git repository")

+ var ErrSpaceliftAdminStackComponentNotProvisioned = errors.New("spacelift admin stack component cannot be provisioned")

+ var ErrSpaceliftAdminStackWorkspaceNotEnabled = errors.New("spacelift admin stack does not have workspace enabled")

+ var ErrStackCircularInheritance = errors.New("circular component inheritance detected")

+ var ErrStackEmpty = errors.New("stack is empty")

+ var ErrStackImportNotFound = errors.New("stack import not found")

+ var ErrStackImportSelf = errors.New("stack manifest imports itself")

+ var ErrStackManifestFileNotFound = errors.New("stack manifest file not found")

+ var ErrStackManifestSchemaValidation = errors.New("stack manifest schema validation failed")

+ var ErrStacksDirectoryDoesNotExist = errors.New("directory for Atmos stacks does not exist")

+ var ErrTableTooWide = errors.New("the table is too wide to display properly")

+ var ErrTerraformGenerateBackendArgument = errors.New("invalid arguments")

+ var ErrThemeNotFound = errors.New("theme not found")

+ var ErrValidationFailed = errors.New("validation failed")

+ var ErrVersionCacheLoadFailed = errors.New("failed to load version check cache")

+ var ErrVersionCheckFailed = errors.New("failed to check for version updates")

+ var ErrVersionDisplayFailed = errors.New("failed to display version information")

+ var ErrVersionFormatInvalid = errors.New("invalid version output format")

+ var ErrVersionGitHubAPIFailed = errors.New("failed to query GitHub API for releases")

+ var ErrWorkflowDirectoryDoesNotExist = errors.New("workflow directory does not exist")

+ func CaptureError(err error)

+ func CaptureErrorWithComponentConfig(err error, info *schema.ConfigAndStacksInfo, context map[string]string)

+ func CaptureErrorWithContext(err error, context map[string]string)

+ func ClearAllComponentMetadata()

+ func ClearComponentMetadata(component *schema.ErrorsConfig)

+ func CloseAllSentry()

+ func CloseSentry()

+ func Format(err error, config FormatterConfig) string

+ func GetComponentErrorConfig(info *schema.ConfigAndStacksInfo) (*schema.ErrorsConfig, error)

+ func GetContext(err error, key string) (string, bool)

+ func GetExitCode(err error) int

+ func GetMarkdownRenderer() *markdown.Renderer

+ func HasContext(err error, key, value string) bool

+ func InitializeSentry(config *schema.SentryConfig) error

+ func MergeErrorConfigs(global *schema.ErrorsConfig, component *schema.ErrorsConfig) *schema.ErrorsConfig

+ func SetComponentBooleanOverrides(component *schema.ErrorsConfig, enabled, debug, captureStackContext bool)

+ func SetVerboseFlag(verbose bool)

+ func WithExitCode(err error, code int) error

+ type ErrorBuilder struct

+ func Build(err error) *ErrorBuilder

+ func (b *ErrorBuilder) Err() error

+ func (b *ErrorBuilder) WithContext(key string, value interface{}) *ErrorBuilder

+ func (b *ErrorBuilder) WithExample(example string) *ErrorBuilder

+ func (b *ErrorBuilder) WithExampleFile(content string) *ErrorBuilder

+ func (b *ErrorBuilder) WithExitCode(code int) *ErrorBuilder

+ func (b *ErrorBuilder) WithExplanation(explanation string) *ErrorBuilder

+ func (b *ErrorBuilder) WithExplanationf(format string, args ...interface{}) *ErrorBuilder

+ func (b *ErrorBuilder) WithHint(hint string) *ErrorBuilder

+ func (b *ErrorBuilder) WithHintf(format string, args ...interface{}) *ErrorBuilder

+ func (b *ErrorBuilder) WithTitle(title string) *ErrorBuilder

+ type ExecError struct

+ Args []string

+ Cmd string

+ ExitCode int

+ Stderr string

+ func NewExecError(cmd string, args []string, exitCode int, cause error) *ExecError

+ func (e *ExecError) Error() string

+ func (e *ExecError) Unwrap() error

+ func (e *ExecError) WithStderr(stderr string) *ExecError

+ type FormatterConfig struct

+ MaxLineLength int

+ Title string

+ Verbose bool

+ func DefaultFormatterConfig() FormatterConfig

+ type SentryClientRegistry struct

+ func GetRegistry() *SentryClientRegistry

+ func (r *SentryClientRegistry) CloseAll()

+ func (r *SentryClientRegistry) GetOrCreateClient(config *schema.SentryConfig) (*sentry.Hub, error)

+ type WorkflowStepError struct

+ Command string

+ ExitCode int

+ Step string

+ Workflow string

+ func NewWorkflowStepError(workflow, step, command string, exitCode int, cause error) *WorkflowStepError

+ func (e *WorkflowStepError) Error() string

+ func (e *WorkflowStepError) Unwrap() error

+ func (e *WorkflowStepError) WorkflowStepMessage() string

Nov 11, 2025

Changes in this version

+ var ErrBuildIOConfig = errors.New("failed to build I/O config")

+ var ErrCompatibilityFlagMissingTarget = errors.New("compatibility flag references non-existent flag")

+ var ErrComponentRequired = errors.New("component is required")

+ var ErrDecode = errors.New("decoding error")

+ var ErrDuplicateFlagRegistration = errors.New("duplicate flag registration")

+ var ErrEncode = errors.New("encoding error")

+ var ErrIOContextNotInitialized = errors.New("global I/O context is nil after initialization")

+ var ErrInvalidFlagValue = errors.New("invalid value for flag")

+ var ErrInvalidPositionalArgs = errors.New("invalid positional arguments")

+ var ErrMaskingContent = errors.New("failed to mask content")

+ var ErrRequiredFlagEmpty = errors.New("required flag cannot be empty")

+ var ErrRequiredFlagNotProvided = errors.New("required flag not provided")

+ var ErrTTYRequired = errors.New("requires a TTY")

+ var ErrUIFormatterNotInitialized = errors.New("ui formatter not initialized")

+ var ErrUnknownStream = errors.New("unknown I/O stream")

+ var ErrWorkflowNameRequired = errors.New("workflow name is required")

+ var ErrWriteToStream = errors.New("failed to write to stream")

Nov 3, 2025

Changes in this version

+ var ErrAuthNotConfigured = errors.New("authentication not configured in atmos.yaml")

+ var ErrAuthenticationChainNotBuilt = errors.New("authentication chain not built")

+ var ErrIdentitySelectionRequiresTTY = errors.New("interactive identity selection requires a TTY")

Oct 29, 2025

Changes in this version

+ var ErrAuthConsole = errors.New("auth console operation failed")

+ var ErrAwsMissingEnvVars = errors.New("missing required AWS environment variables")

+ var ErrAzureContainerRequired = errors.New("container_name is required for azurerm backend")

+ var ErrAzurePermissionDenied = errors.New("permission denied accessing Azure blob")

+ var ErrBackendConfigRequired = errors.New("backend configuration is required")

+ var ErrComponentArtifactGeneration = errors.New("component artifact generation failed")

+ var ErrComponentConfigInvalid = errors.New("component configuration invalid")

+ var ErrComponentExecutionFailed = errors.New("component execution failed")

+ var ErrComponentListFailed = errors.New("failed to list components")

+ var ErrComponentProviderNil = errors.New("component provider cannot be nil")

+ var ErrComponentProviderNotFound = errors.New("component provider not found")

+ var ErrComponentProviderRegistration = errors.New("failed to register component provider")

+ var ErrComponentTypeEmpty = errors.New("component type cannot be empty")

+ var ErrComponentValidationFailed = errors.New("component validation failed")

+ var ErrCreateAzureClient = errors.New("failed to create Azure Blob Storage client")

+ var ErrCreateAzureCredential = errors.New("failed to create Azure credential")

+ var ErrCreateGCSClient = errors.New("failed to create GCS client")

+ var ErrGCSBucketRequired = errors.New("bucket is required for gcs backend")

+ var ErrGetBlobFromAzure = errors.New("failed to get blob from Azure Blob Storage")

+ var ErrGetObjectFromGCS = errors.New("failed to get object from GCS")

+ var ErrHTTPRequestFailed = errors.New("HTTP request failed")

+ var ErrIdentityLogout = errors.New("identity logout failed")

+ var ErrIdentityNotInConfig = errors.New("identity not found in configuration")

+ var ErrInvalidBackendConfig = errors.New("invalid backend configuration")

+ var ErrInvalidLogoutOption = errors.New("invalid logout option")

+ var ErrKeyringDeletion = errors.New("keyring deletion failed")

+ var ErrLogoutFailed = errors.New("logout failed")

+ var ErrLogoutNotImplemented = errors.New("logout not implemented for this provider")

+ var ErrLogoutNotSupported = errors.New("logout not supported for this provider")

+ var ErrMutuallyExclusiveFlags = errors.New("mutually exclusive flags provided")

+ var ErrNoSuitableShell = errors.New("no suitable shell found")

+ var ErrNotImplemented = errors.New("not implemented")

+ var ErrPartialLogout = errors.New("partial logout")

+ var ErrProviderLogout = errors.New("provider logout failed")

+ var ErrProviderNotFound = errors.New("provider not found")

+ var ErrProviderNotInConfig = errors.New("provider not found in configuration")

+ var ErrProviderNotSupported = errors.New("provider does not support this operation")

+ var ErrReadAzureBlobBody = errors.New("failed to read Azure blob body")

+ var ErrReadGCSObjectBody = errors.New("failed to read GCS object body")

+ var ErrStorageAccountRequired = errors.New("storage_account_name is required for azurerm backend")

+ var ErrUnknownServiceAlias = errors.New("unknown service alias")

+ var ErrUserAborted = errors.New("user aborted")

Oct 20, 2025

Changes in this version

+ var ErrEmptyConfigFile = errors.New("config file path cannot be empty")

+ var ErrEmptyConfigPath = errors.New("config path cannot be empty")

+ var ErrFailedToLoadTerraformModule = errors.New("failed to load terraform module")

+ var ErrFileAccessDenied = errors.New("file access denied")

+ var ErrGitHubRateLimitExceeded = errors.New("GitHub API rate limit exceeded")

+ var ErrInvalidComponentMapType = errors.New("invalid component map type")

+ var ErrInvalidLimit = errors.New("limit must be between 1 and 100")

+ var ErrInvalidOffset = errors.New("offset must be >= 0")

+ var ErrInvalidSinceDate = errors.New("invalid date format for --since")

+ var ErrSpinnerReturnedNilModel = errors.New("spinner returned nil model")

+ var ErrSpinnerUnexpectedModelType = errors.New("spinner returned unexpected model type")

+ var ErrTerminalTooNarrow = errors.New("terminal too narrow")

+ var ErrUnsupportedComponentType = errors.New(...)

+ var ErrUnsupportedOutputFormat = errors.New("unsupported output format")

+ var OsExit = os.Exit

Oct 13, 2025

Changes in this version

+ var ErrHTTPBackendWorkspaces = errors.New("workspaces are not supported for the HTTP backend")

+ var ErrInvalidTerraformComponent = errors.New("invalid Terraform component")

+ var ErrMissingHelmfileAwsProfilePattern = errors.New("helmfile AWS profile pattern is required")

+ var ErrMissingHelmfileBasePath = errors.New("helmfile base path is required")

+ var ErrMissingHelmfileClusterNamePattern = errors.New("helmfile cluster name pattern is required")

+ var ErrMissingHelmfileKubeconfigPath = errors.New("helmfile kubeconfig path is required")

+ var ErrNoTty = errors.New("no TTY attached")

Oct 8, 2025

Changes in this version

+ var ErrAtmosArgConfigNotFound = errors.New("atmos configuration not found")

+ var ErrAtmosDirConfigNotFound = errors.New("atmos config directory not found")

+ var ErrAtmosFilesDirConfigNotFound = errors.New("`atmos.yaml` or `.atmos.yaml` configuration file not found in directory")

+ var ErrAuthAwsFileManagerFailed = errors.New("failed to create AWS file manager")

+ var ErrAuthManager = errors.New("auth manager error")

+ var ErrAuthOidcDecodeFailed = errors.New("failed to decode OIDC token")

+ var ErrAuthOidcUnmarshalFailed = errors.New("failed to unmarshal oidc claims")

+ var ErrAuthenticationFailed = errors.New("authentication failed")

+ var ErrAwsAuth = errors.New("aws auth error")

+ var ErrAwsSAMLDecodeFailed = errors.New("aws saml decode failed")

+ var ErrAwsUserNotConfigured = errors.New("aws user not configured")

+ var ErrCacheDir = errors.New("cache directory creation failed")

+ var ErrCircularDependency = errors.New("circular dependency detected in identity chain")

+ var ErrCommandNil = errors.New("command cannot be nil")

+ var ErrCommandNotFound = errors.New("command not found")

+ var ErrComponentNotDefined = errors.New("component not defined in any config files")

+ var ErrComputeRelativePath = errors.New("failed to compute relative path")

+ var ErrCopyFile = errors.New("failed to copy file")

+ var ErrCreateDirectory = errors.New("failed to create directory")

+ var ErrCreateDownloadClient = errors.New("failed to create download client")

+ var ErrCreateTempDirectory = ErrCreateTempDir

+ var ErrDefaultIdentity = errors.New("default identity error")

+ var ErrDownloadFile = errors.New("failed to download file")

+ var ErrExpectedDirOrPattern = errors.New("--config-path expected directory found file")

+ var ErrExpectedFile = errors.New("--config expected file found directory")

+ var ErrExpiredCredentials = errors.New("credentials for identity are expired or invalid")

+ var ErrFailedToInitializeAtmosConfig = errors.New("failed to initialize atmos config")

+ var ErrFailedToInitializeAuthManager = errors.New("failed to initialize auth manager")

+ var ErrFileNotFound = errors.New("file not found")

+ var ErrGenerateTerraformDocs = errors.New("failed to generate terraform docs")

+ var ErrGetHooks = errors.New("error getting hooks")

+ var ErrGetImageDescriptor = errors.New("cannot get a descriptor for the OCI image")

+ var ErrGetImageLayers = errors.New("failed to get image layers")

+ var ErrIdentityNotFound = errors.New("identity not found")

+ var ErrInitializeCLIConfig = errors.New("error initializing CLI config")

+ var ErrInitializingCredentialStore = errors.New("failed to initialize credential store")

+ var ErrInitializingIdentities = errors.New("failed to initialize identities")

+ var ErrInitializingProviders = errors.New("failed to initialize providers")

+ var ErrInvalidArgumentError = errors.New("invalid argument error")

+ var ErrInvalidAuthConfig = errors.New("invalid auth config")

+ var ErrInvalidAuthSection = errors.New("invalid auth section")

+ var ErrInvalidBaseComponentConfig = errors.New("invalid base component config")

+ var ErrInvalidComponentArgument = errors.New("invalid arguments. The command requires one argument 'componentName'")

+ var ErrInvalidComponentAttribute = errors.New("invalid component attribute")

+ var ErrInvalidComponentAuth = errors.New("invalid component auth section")

+ var ErrInvalidComponentBackend = errors.New("invalid component backend section")

+ var ErrInvalidComponentBackendType = errors.New("invalid component backend_type attribute")

+ var ErrInvalidComponentCommand = errors.New("invalid component command attribute")

+ var ErrInvalidComponentEnv = errors.New("invalid component env section")

+ var ErrInvalidComponentHooks = errors.New("invalid component hooks section")

+ var ErrInvalidComponentMetadata = errors.New("invalid component metadata section")

+ var ErrInvalidComponentMetadataComponent = errors.New("invalid component metadata.component attribute")

+ var ErrInvalidComponentMetadataInherits = errors.New("invalid component metadata.inherits section")

+ var ErrInvalidComponentOverrides = errors.New("invalid component overrides section")

+ var ErrInvalidComponentOverridesAuth = errors.New("invalid component overrides auth section")

+ var ErrInvalidComponentOverridesCommand = errors.New("invalid component overrides command attribute")

+ var ErrInvalidComponentOverridesEnv = errors.New("invalid component overrides env section")

+ var ErrInvalidComponentOverridesHooks = errors.New("invalid component overrides hooks section")

+ var ErrInvalidComponentOverridesProviders = errors.New("invalid component overrides providers section")

+ var ErrInvalidComponentOverridesSettings = errors.New("invalid component overrides settings section")

+ var ErrInvalidComponentOverridesVars = errors.New("invalid component overrides vars section")

+ var ErrInvalidComponentProviders = errors.New("invalid component providers section")

+ var ErrInvalidComponentRemoteStateBackend = errors.New("invalid component remote_state_backend section")

+ var ErrInvalidComponentRemoteStateBackendType = errors.New("invalid component remote_state_backend_type attribute")

+ var ErrInvalidComponentSettings = errors.New("invalid component settings section")

+ var ErrInvalidComponentVars = errors.New("invalid component vars section")

+ var ErrInvalidComponentsHelmfile = errors.New("invalid components.helmfile section")

+ var ErrInvalidComponentsPacker = errors.New("invalid components.packer section")

+ var ErrInvalidComponentsSection = errors.New("invalid components section")

+ var ErrInvalidComponentsTerraform = errors.New("invalid components.terraform section")

+ var ErrInvalidEnvSection = errors.New("invalid env section")

+ var ErrInvalidHelmfileAuth = errors.New("invalid helmfile auth section")

+ var ErrInvalidHelmfileCommand = errors.New("invalid helmfile command")

+ var ErrInvalidHelmfileEnv = errors.New("invalid helmfile env section")

+ var ErrInvalidHelmfileOverridesSection = errors.New("invalid helmfile overrides section")

+ var ErrInvalidHelmfileSection = errors.New("invalid helmfile section")

+ var ErrInvalidHelmfileSettings = errors.New("invalid helmfile settings section")

+ var ErrInvalidHelmfileVars = errors.New("invalid helmfile vars section")

+ var ErrInvalidHooksSection = errors.New("invalid 'hooks' section in the file")

+ var ErrInvalidIdentityConfig = errors.New("invalid identity config")

+ var ErrInvalidIdentityKind = errors.New("invalid identity kind")

+ var ErrInvalidImageReference = errors.New("invalid image reference")

+ var ErrInvalidImport = errors.New("invalid import")

+ var ErrInvalidImportSection = errors.New("invalid import section")

+ var ErrInvalidOverridesSection = errors.New("invalid overrides section")

+ var ErrInvalidPackerAuth = errors.New("invalid packer auth section")

+ var ErrInvalidPackerCommand = errors.New("invalid packer command")

+ var ErrInvalidPackerEnv = errors.New("invalid packer env section")

+ var ErrInvalidPackerSection = errors.New("invalid packer section")

+ var ErrInvalidPackerSettings = errors.New("invalid packer settings section")

+ var ErrInvalidPackerVars = errors.New("invalid packer vars section")

+ var ErrInvalidProviderConfig = errors.New("invalid provider config")

+ var ErrInvalidProviderKind = errors.New("invalid provider kind")

+ var ErrInvalidRegoPolicy = errors.New("invalid Rego policy")

+ var ErrInvalidSettingsSection = errors.New("invalid settings section")

+ var ErrInvalidSpaceLiftSettings = errors.New("invalid spacelift settings section")

+ var ErrInvalidSpecificHelmfileComponent = errors.New("invalid helmfile component configuration")

+ var ErrInvalidSpecificPackerComponent = errors.New("invalid packer component configuration")

+ var ErrInvalidSpecificTerraformComponent = errors.New("invalid terraform component configuration")

+ var ErrInvalidStackConfig = errors.New("invalid stack config")

+ var ErrInvalidSubcommand = errors.New("invalid subcommand")

+ var ErrInvalidTerraformAuth = errors.New("invalid terraform auth section")

+ var ErrInvalidTerraformBackend = errors.New("invalid terraform.backend section")

+ var ErrInvalidTerraformBackendType = errors.New("invalid terraform backend_type")

+ var ErrInvalidTerraformCommand = errors.New("invalid terraform command")

+ var ErrInvalidTerraformEnv = errors.New("invalid terraform env section")

+ var ErrInvalidTerraformHooksSection = errors.New("invalid 'terraform.hooks' section in the file")

+ var ErrInvalidTerraformOverridesSection = errors.New("invalid terraform overrides section")

+ var ErrInvalidTerraformProviders = errors.New("invalid terraform providers section")

+ var ErrInvalidTerraformRemoteStateBackend = errors.New("invalid terraform.remote_state_backend section")

+ var ErrInvalidTerraformRemoteStateSection = errors.New("invalid terraform remote_state_backend section")

+ var ErrInvalidTerraformRemoteStateType = errors.New("invalid terraform remote_state_backend_type")

+ var ErrInvalidTerraformSection = errors.New("invalid terraform section")

+ var ErrInvalidTerraformSettings = errors.New("invalid terraform settings section")

+ var ErrInvalidTerraformVars = errors.New("invalid terraform vars section")

+ var ErrInvalidVarsSection = errors.New("invalid vars section")

+ var ErrLayerDecompression = errors.New("layer decompression error")

+ var ErrMergeConfiguration = errors.New("failed to merge configuration")

+ var ErrMergeEmbeddedConfig = errors.New("failed to merge embedded config")

+ var ErrMergeInputYAMLs = errors.New("failed to merge input YAMLs")

+ var ErrMergeTempConfig = errors.New("failed to merge temp config")

+ var ErrMissingInput = errors.New("missing input")

+ var ErrMultipleDefaultIdentities = errors.New("multiple default identities found")

+ var ErrNilParam = errors.New("parameter cannot be nil")

+ var ErrNilStoreValue = errors.New("cannot store nil value")

+ var ErrNilTerraformOutput = errors.New("terraform output returned nil")

+ var ErrNoCommandSpecified = errors.New("no command specified")

+ var ErrNoComponentsFound = errors.New("no components found")

+ var ErrNoCredentialsFound = errors.New("no credentials found for identity")

+ var ErrNoDefaultIdentity = errors.New("no default identity configured for authentication")

+ var ErrNoIdentitiesAvailable = errors.New("no identities available")

+ var ErrOPATimeout = errors.New("timeout evaluating OPA policy")

+ var ErrOpenFile = errors.New("failed to open file")

+ var ErrParseComponents = errors.New("could not parse components")

+ var ErrParseFile = errors.New("failed to parse file")

+ var ErrParseStacks = errors.New("could not parse stacks")

+ var ErrParseURL = errors.New("failed to parse URL")

+ var ErrPostAuthenticationHookFailed = errors.New("post authentication hook failed")

+ var ErrPreprocessYAMLFunctions = errors.New("failed to preprocess YAML functions")

+ var ErrProcessLayer = errors.New("failed to process layer")

+ var ErrProcessStack = errors.New("error processing stack")

+ var ErrPullImage = errors.New("failed to pull image")

+ var ErrReadConfig = errors.New("failed to read config")

+ var ErrReadDirectory = errors.New("failed to read directory")

+ var ErrRemoveDirectory = errors.New("failed to remove directory")

+ var ErrRenderTemplate = errors.New("failed to render template with datasources")

+ var ErrResolveOutputPath = errors.New("failed to resolve output path")

+ var ErrSetFlag = errors.New("failed to set flag")

+ var ErrSetPermissions = errors.New("failed to set permissions")

+ var ErrStackNotFound = errors.New("stack not found")

+ var ErrStatFile = errors.New("failed to stat file")

+ var ErrSubcommandFailed = errors.New("subcommand failed")

+ var ErrTarballExtraction = errors.New("tarball extraction error")

+ var ErrUnsupportedPlatform = errors.New("unsupported platform")

+ var ErrValidation = errors.New("validation failed")

+ var ErrVersionMismatch = errors.New("version mismatch")

+ var ErrWorkflowBasePathNotConfigured = errors.New("'workflows.base_path' must be configured in 'atmos.yaml'")

+ var ErrWriteOutput = errors.New("failed to write output")

+ type ExitCodeError struct

+ Code int

+ func (e ExitCodeError) Error() string

Oct 2, 2025

Changes in this version

+ var ErrBasePath = errors.New("base path required to process imports")

+ var ErrEmptyURL = errors.New("empty URL provided")

+ var ErrFailedToFindImport = errors.New("failed to find import")

+ var ErrImportPathRequired = errors.New("import path required to process imports")

+ var ErrInvalidLogLevel = errors.New("invalid log level")

+ var ErrInvalidOPAPolicy = errors.New("invalid OPA policy")

+ var ErrInvalidPagerCommand = errors.New("invalid pager command")

+ var ErrInvalidURL = errors.New("invalid URL")

+ var ErrMaxImportDepth = errors.New("maximum import depth reached")

+ var ErrNoFileMatchPattern = errors.New("no files matching patterns found")

+ var ErrNoValidAbsolutePaths = errors.New("no valid absolute paths found")

+ var ErrProfilerCreateFile = errors.New("profiler: failed to create profile file")

+ var ErrProfilerStart = errors.New("profiler start failed")

+ var ErrProfilerStartCPU = errors.New("profiler: failed to start CPU profile")

+ var ErrProfilerStartTrace = errors.New("profiler: failed to start trace profile")

+ var ErrProfilerUnsupportedType = errors.New("profiler: unsupported profile type")

+ var ErrResolveLocal = errors.New("failed to resolve local import path")

+ var ErrSourceDestination = errors.New("source and destination cannot be nil")

+ var ErrTUIRun = errors.New("failed to run TUI")

+ var ErrTempDir = errors.New("temporary directory required to process imports")

+ var ErrTerraformEnvCliVarJSON = errors.New("failed to parse JSON variable from TF_CLI_ARGS environment variable")

Sep 26, 2025

Changes in this version

+ const ErrValueWrappingFormat

+ var ErrAPIResponseError = errors.New("API response error")

+ var ErrCacheLocked = errors.New("cache file is locked")

+ var ErrCacheMarshal = errors.New("cache marshal failed")

+ var ErrCacheRead = errors.New("cache read failed")

+ var ErrCacheUnmarshal = errors.New("cache unmarshal failed")

+ var ErrCacheWrite = errors.New("cache write failed")

+ var ErrComponentAndStackRequired = errors.New("both '--component' and '--stack' flags must be provided")

+ var ErrEmptyWorkdir = errors.New("workdir cannot be empty")

+ var ErrExecuteDescribeStacks = errors.New("failed to execute describe stacks")

+ var ErrFailedToCreateAPIClient = errors.New("failed to create API client")

+ var ErrFailedToCreateAuthRequest = errors.New("failed to create authenticated request")

+ var ErrFailedToCreateLogger = errors.New("failed to create logger")

+ var ErrFailedToCreateRequest = errors.New("failed to create request")

+ var ErrFailedToDecodeOIDCResponse = errors.New("failed to decode OIDC token response")

+ var ErrFailedToDecodeTokenResponse = errors.New("failed to decode token response")

+ var ErrFailedToExchangeOIDCToken = errors.New("failed to exchange OIDC token")

+ var ErrFailedToFinalizeCSVOutput = errors.New("failed to finalize CSV output")

+ var ErrFailedToGetComponentFlag = errors.New("failed to get '--component' flag")

+ var ErrFailedToGetGitHubOIDCToken = errors.New("failed to get GitHub OIDC token")

+ var ErrFailedToGetLocalRepo = errors.New("failed to get local repository")

+ var ErrFailedToGetOIDCToken = errors.New("failed to get OIDC token")

+ var ErrFailedToGetRepoInfo = errors.New("failed to get repository info")

+ var ErrFailedToGetStackFlag = errors.New("failed to get '--stack' flag")

+ var ErrFailedToInitConfig = errors.New("failed to initialize Atmos configuration")

+ var ErrFailedToLockStack = errors.New("failed to lock stack")

+ var ErrFailedToMakeRequest = errors.New("failed to make request")

+ var ErrFailedToMarshalPayload = errors.New("failed to marshal request body")

+ var ErrFailedToProcessArgs = errors.New("failed to process command-line arguments")

+ var ErrFailedToReadResponseBody = errors.New("failed to read response body")

+ var ErrFailedToUnlockStack = errors.New("failed to unlock stack")

+ var ErrFailedToUnmarshalAPIResponse = errors.New("failed to unmarshal API response")

+ var ErrFailedToUploadInstanceStatus = errors.New("failed to upload instance status")

+ var ErrFailedToUploadInstances = errors.New("failed to upload instances")

+ var ErrFailedToUploadStacks = errors.New("failed to upload stacks")

+ var ErrHeadLookup = errors.New("HEAD not found")

+ var ErrLocalRepoFetch = errors.New("local repo unavailable")

+ var ErrNilInput = errors.New("input must not be nil")

+ var ErrNilRequestDTO = errors.New("nil request DTO")

+ var ErrNoGitRepo = errors.New("not in a git repository")

+ var ErrNonStringElement = errors.New("element is not a string")

+ var ErrNotInGitHubActions = errors.New("not running in GitHub Actions or missing OIDC token environment variables")

+ var ErrOIDCAuthFailedNoToken = errors.New("OIDC authentication failed: no token")

+ var ErrOIDCTokenExchangeFailed = errors.New("failed to exchange OIDC token for Atmos token")

+ var ErrOIDCWorkspaceIDRequired = errors.New("workspace ID environment variable is required for OIDC authentication")

+ var ErrOPAPolicyViolations = errors.New("OPA policy violations detected")

+ var ErrParseFlag = errors.New("failed to parse flag value")

+ var ErrProcessInstances = errors.New("failed to process instances")

+ var ErrRefuseDeleteSymbolicLink = errors.New("refusing to delete symbolic link")

+ var ErrWorkdirNotExist = errors.New("workdir does not exist")

Sep 23, 2025

Changes in this version

+ var ErrInvalidStackManifest = errors.New("invalid stack manifest")

Sep 16, 2025

Changes in this version

+ var ErrFailedMarshalConfigToYaml = errors.New("failed to marshal config to YAML")

Sep 3, 2025

Changes in this version

+ var ErrGitCommandExited = errors.New("git command exited with error")

+ var ErrGitCommandFailed = errors.New("error running git command")

+ var ErrGitNotAvailable = errors.New("git must be available and on the PATH")

+ var ErrGitVersionMismatch = errors.New("git version requirement not met")

+ var ErrInvalidGitPort = errors.New("invalid port number")

+ var ErrInvalidListMergeStrategy = errors.New("invalid list merge strategy")

+ var ErrMerge = errors.New("merge error")

+ var ErrReadDestDir = errors.New("failed to read the destination directory during git update")

+ var ErrRemoveGitDir = errors.New(...)

+ var ErrSSHKeyUsage = errors.New("error using ssh key")

+ var ErrUnexpectedGitOutput = errors.New("unexpected 'git version' output")

Aug 17, 2025

Changes in this version

+ var ErrAtmosConfigIsNil = errors.New("atmos config is nil")

Aug 7, 2025

Changes in this version

+ var ErrAbstractComponentCantBeProvisioned = errors.New("abstract component cannot be provisioned")

+ var ErrInvalidComponent = errors.New("invalid component")

+ var ErrLockedComponentCantBeProvisioned = errors.New("locked component cannot be provisioned")

+ var ErrMissingPackerManifest = errors.New("packer manifest is missing")

+ var ErrMissingPackerTemplate = errors.New(...)

+ var ErrMissingStack = errors.New(...)

Jul 31, 2025

Changes in this version

+ const ErrStringWrappingFormat

+ var ErrInvalidFlag = errors.New("invalid flag")

Jul 18, 2025

Changes in this version

+ var ErrDescribeComponent = errors.New("failed to describe component")

+ var ErrEvaluateTerraformBackendVariable = errors.New("failed to evaluate terraform backend variable")

+ var ErrGetObjectFromS3 = errors.New("failed to get object from S3")

+ var ErrLoadAwsConfig = errors.New("failed to load AWS config")

+ var ErrProcessTerraformStateFile = errors.New("error processing terraform state file")

+ var ErrReadFile = errors.New("error reading file")

+ var ErrReadS3ObjectBody = errors.New("failed to read S3 object body")

+ var ErrReadTerraformState = errors.New("failed to read Terraform state")

+ var ErrUnsupportedBackendType = errors.New("unsupported backend type")

+ var ErrYamlFuncInvalidArguments = errors.New("invalid number of arguments in the Atmos YAML function")

Jul 1, 2025

Changes in this version

+ const ErrWrappingFormat

+ var ErrCopyPackage = errors.New("failed to copy package")

+ var ErrCopyPackageToTarget = errors.New("failed to copy package to target")

+ var ErrCreateTempDir = errors.New("failed to create temp directory")

+ var ErrDownloadPackage = errors.New("failed to download package")

+ var ErrEmptyFilePath = errors.New("file path is empty")

+ var ErrFailedToInitializeTUIModel = errors.New("failed to initialize TUI model: verify terminal capabilities and permissions")

+ var ErrFailedToInitializeTUIModelWithDetails = errors.New("failed to initialize TUI model: verify terminal capabilities and permissions")

+ var ErrInvalidTemplateFunc = errors.New("invalid template function")

+ var ErrInvalidTerraformComponentWithMultiComponentFlags = errors.New(...)

+ var ErrInvalidTerraformFlagsWithAffectedFlag = errors.New(...)

+ var ErrInvalidTerraformSingleComponentAndMultiComponentFlags = errors.New(...)

+ var ErrLocalMixinInstallationNotImplemented = errors.New("local mixin installation not implemented")

+ var ErrLocalMixinURICannotBeEmpty = errors.New("local mixin URI cannot be empty")

+ var ErrMissingDocType = errors.New("doc-type argument missing")

+ var ErrMissingStackNameTemplateAndPattern = errors.New(...)

+ var ErrMultipleFilesFound = errors.New("multiple files found in directory")

+ var ErrNoDocsGenerateEntry = errors.New("no docs.generate entry found")

+ var ErrNoFilesFound = errors.New("no files found in directory")

+ var ErrNoValidInstallerPackage = errors.New("no valid installer package provided")

+ var ErrPathResolution = errors.New("failed to resolve absolute path")

+ var ErrPlanHasDiff = errors.New("plan files have differences")

+ var ErrProcessOCIImage = errors.New("failed to process OCI image")

+ var ErrSetTempDirPermissions = errors.New("failed to set temp directory permissions")

+ var ErrSourceDirNotExist = errors.New("source directory does not exist")

+ var ErrTUIModel = errors.New("failed to initialize TUI model")

+ var ErrUnknownPackageType = errors.New("unknown package type")

+ var ErrUnsupportedInputType = errors.New("unsupported input type")

+ var ErrValidPackage = errors.New("no valid installer package provided for")

+ func CheckErrorAndPrint(err error, title string, suggestion string)

+ func CheckErrorPrintAndExit(err error, title string, suggestion string)

+ func Exit(exitCode int)

+ func InitializeMarkdown(atmosConfig schema.AtmosConfiguration)