errtax

const (
	CodeFlagUnknown Code = "flag_unknown"
	// CodeFlagForeign is a recognized flag from a different Jira CLI — not
	// a typo, so it gets an orientation hint instead of a spelling one;
	// this CLI's equivalents ride the envelope's suggestions field.
	CodeFlagForeign         Code = "flag_foreign"
	CodeFlagValueMissing    Code = "flag_value_missing"
	CodeFlagValueInvalid    Code = "flag_value_invalid"
	CodeFlagSyntaxInvalid   Code = "flag_syntax_invalid"
	CodeRequiredFlagMissing Code = "required_flag_missing"
	CodeArgCountInvalid     Code = "arg_count_invalid"
	CodeArgValueInvalid     Code = "arg_value_invalid"
	// CodeIssueTypeUnknown is a --type value that names no issue type on the
	// project's create screen. The CLI resolves the type against the fetched
	// list in-code, so a miss is a bad input value (validation, exit 3), not a
	// Jira 404 — the valid names ride the envelope's suggestions field.
	CodeIssueTypeUnknown Code = "issue_type_unknown"
	// CodeAgentTopicUnknown is an agent-surface lookup that matched
	// nothing: a guide slug, guide section, schema --path, or export
	// format the discovery surface does not carry. The surface lists its
	// own valid names, so the hint routes there rather than to --help.
	CodeAgentTopicUnknown Code = "agent_topic_unknown"

	// CodeSavedQueryUnknown is a `search saved NAME` value that matches no
	// saved query. The names live in the user's queries directory, not in
	// --help, so this gets its own hint rather than reusing arg_value_invalid.
	CodeSavedQueryUnknown Code = "saved_query_unknown"
	// CodeJQExpressionInvalid is a --jq expression gojq could not parse or
	// compile — a bad program, not bad data, so the hint points at the
	// expression.
	CodeJQExpressionInvalid Code = "jq_expression_invalid"
	// CodeJQOutputConflict is --jq combined with an explicit --output=human:
	// the filter runs over JSON output, so the two requests contradict.
	CodeJQOutputConflict Code = "jq_output_conflict"
	// CodeJQEvalFailed is a --jq expression that compiled but failed while
	// running against the emitted document (a type error, a halt_error).
	CodeJQEvalFailed Code = "jq_eval_failed"
	// CodeRankRejected is the agile rank endpoint's 400: Jira refused the
	// rank itself — typically a project with no Jira Software board (no
	// LexoRank field) or an unusable anchor.
	CodeRankRejected Code = "rank_rejected"
	// CodeRankPartial is the rank endpoint's 207: some issues ranked, the
	// entries named in the envelope did not.
	CodeRankPartial             Code = "rank_partial"
	CodeCommandUnknown          Code = "command_unknown"
	CodePromptAborted           Code = "prompt_aborted"
	CodePromptCanceled          Code = "prompt_canceled"
	CodePromptUnavailable       Code = "prompt_unavailable"
	CodeMarkdownLossyConversion Code = "markdown_lossy_conversion"
	CodeReadOnly                Code = "read_only"
	CodeADFInvalid              Code = "adf_invalid"
	CodeIssueKeyExpansionLimit  Code = "issue_key_expansion_limit"
	CodeUserAmbiguous           Code = "user_ambiguous"
	CodeBoardAmbiguous          Code = "board_ambiguous"
	CodeDryRunBlocked           Code = "dry_run_blocked"
	// CodeCredentialEmpty, CodeCredentialNamespaceCollision, and
	// CodeOnePasswordItemAmbiguous classify as validation, matching their
	// construction sites: an empty token, an unusable profile name, and an
	// ambiguous 1Password item are input problems — the fix is "correct
	// your input", not "re-authenticate". The ambiguity code is the
	// credential-side parallel of user_ambiguous and board_ambiguous.
	CodeCredentialEmpty              Code = "credential_empty"
	CodeCredentialNamespaceCollision Code = "credential_namespace_collision"
	CodeOnePasswordItemAmbiguous     Code = "onepassword_item_ambiguous"
	// CodeEnvBackendReadOnly: a write or delete was attempted against the env
	// secret backend, which only ever reads its JIRA_TOKEN_* variable.
	CodeEnvBackendReadOnly Code = "env_backend_read_only"
	// CodeValidationFailed is the validation catch-all; every specific
	// validation code above must pre-empt it.
	CodeValidationFailed Code = "validation_failed"
	// CodeJiraBadRequest (400) and CodeJiraConflict (409) classify as
	// validation deliberately: both are client-actionable — correct the
	// input, or re-fetch and retry — where a server type would read as an
	// upstream fault.
	CodeJiraBadRequest Code = "jira_bad_request"
	CodeJiraConflict   Code = "jira_conflict"
)

const (
	CodeJiraUnauthorized             Code = "jira_unauthorized"
	CodeJiraForbidden                Code = "jira_forbidden"
	CodeCredentialMissing            Code = "credential_missing"
	CodeCredentialSourceConflict     Code = "credential_source_conflict"
	CodeCredentialBackendUnavailable Code = "credential_backend_unavailable"
	CodeCredentialMigrationFailed    Code = "credential_migration_failed"
	CodeCredentialCleanupFailed      Code = "credential_cleanup_failed"
	CodeOnePasswordUnavailable       Code = "onepassword_unavailable"
	// CodeCredentialRejected is a login-verification rejection: Jira said
	// the email/token pair is wrong.
	CodeCredentialRejected Code = "credential_rejected"
	// CodeCredentialVerifyUnavailable: Jira could not be reached to verify
	// a credential at login — distinct from the credential store being
	// unreachable (credential_backend_unavailable).
	CodeCredentialVerifyUnavailable Code = "credential_verify_unavailable"
	// CodeOnePasswordUnsupportedBuild: the binary was built without CGO,
	// so 1Password support is compiled out entirely.
	CodeOnePasswordUnsupportedBuild Code = "onepassword_unsupported_build"
	// CodeKeyringUnavailable: the OS keyring cannot service requests at all —
	// no Secret Service on the D-Bus (WSL, headless Linux), an unsupported
	// platform — distinct from credential_backend_unavailable, whose hint
	// assumes the backend exists and merely hiccuped.
	CodeKeyringUnavailable Code = "keyring_unavailable"
	// CodeEnvCredentialUnset: a profile using the env secret backend has no
	// JIRA_TOKEN_* variable set — the credential's single source is absent.
	CodeEnvCredentialUnset Code = "env_credential_unset"
	// CodeAuthFailed is the auth catch-all for untyped credential failures.
	CodeAuthFailed Code = "auth_failed"
)

const (
	// CodeProfileNotDefined and CodeProfileIncomplete split the profile
	// failure by remediation — create the profile vs finish setting it
	// up. Both classify as not_found so a bad --profile fails closed.
	CodeProfileNotDefined Code = "profile_not_defined"
	CodeProfileIncomplete Code = "profile_incomplete"
	CodeJiraNotFound      Code = "jira_not_found"
	// CodeJiraSiteNotFound: the base URL names no Atlassian tenant at all —
	// a 404 carrying the edge's Atl-Missing-Tcs signal. Distinct from
	// jira_not_found (a missing resource inside a real site) because the
	// remediation is fixing the profile's site name, not the identifier.
	CodeJiraSiteNotFound Code = "jira_site_not_found"
	// CodeJiraGone (410) is a permanently deleted resource: not-found tells
	// an agent to fix the reference, where validation would suggest
	// correcting the request.
	CodeJiraGone Code = "jira_gone"
	// CodeNotFound is the not-found catch-all for untyped failures.
	CodeNotFound Code = "not_found"
)

const (
	CodeJiraRateLimited Code = "jira_rate_limited"
	// CodeRateLimited is the rate-limit catch-all for untyped failures.
	CodeRateLimited Code = "rate_limited"
)

const (
	CodeJiraServerError Code = "jira_server_error"
	// CodeServerError is the server catch-all for untyped failures.
	CodeServerError Code = "server_error"
	CodeCanceled    Code = "canceled"
	CodeTimeout     Code = "timeout"
)

const CodeUnknown Code = ""

const (
	// TypeUnknown is the zero value — never emitted; it marks an
	// unclassified error before the registry resolves it.
	TypeUnknown    Type = ""
	TypeAuth       Type = "auth"
	TypeNotFound   Type = "not_found"
	TypeValidation Type = "validation"
	TypeRateLimit  Type = "rate_limit"
	TypeServer     Type = "server"
)