Added create and delete operations for projects and boards with validation and error handling

2026-02-17 07:47:49 +00:00
parent c03d05734a
commit c15a48cda3
15 changed files with 571 additions and 4 deletions
@@ -0,0 +1,28 @@
+## 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