Steve Cliff
29 lines
1.7 KiB
Markdown
29 lines
1.7 KiB
Markdown
## ADDED Requirements
|
|
|
|
### Requirement: Permission error translation helper
|
|
The system SHALL provide a `friendlyAPIError` function in the `cmd` package that translates APIError status codes into human-readable messages with operation context.
|
|
|
|
#### Scenario: Authentication error (401)
|
|
- **WHEN** an APIError with StatusCode 401 is passed to friendlyAPIError with operation "create board"
|
|
- **THEN** the function SHALL return an error with message "create board: authentication failed — check your API key"
|
|
|
|
#### Scenario: Permission denied (403) with hint
|
|
- **WHEN** an APIError with StatusCode 403 is passed to friendlyAPIError with operation "create board" and permissionHint "requires project manager role"
|
|
- **THEN** the function SHALL return an error with message "create board: permission denied (requires project manager role)"
|
|
|
|
#### Scenario: Permission denied (403) without hint
|
|
- **WHEN** an APIError with StatusCode 403 is passed to friendlyAPIError with operation "create project" and empty permissionHint
|
|
- **THEN** the function SHALL return an error with message "create project: permission denied"
|
|
|
|
#### Scenario: Not found (404)
|
|
- **WHEN** an APIError with StatusCode 404 is passed to friendlyAPIError with operation "delete board"
|
|
- **THEN** the function SHALL return an error with message "delete board: not found — the resource may not exist or you may not have access to it"
|
|
|
|
#### Scenario: Non-API error
|
|
- **WHEN** a non-APIError (e.g., network error) is passed to friendlyAPIError
|
|
- **THEN** the function SHALL return the original error unchanged
|
|
|
|
#### Scenario: Unknown status code
|
|
- **WHEN** an APIError with StatusCode 500 is passed to friendlyAPIError
|
|
- **THEN** the function SHALL return the original APIError unchanged
|