From 10b35d1d1f8001c99ed35747641285f33a85f1d0 Mon Sep 17 00:00:00 2001 From: Raghu Betina Date: Tue, 18 Aug 2026 09:50:33 -0500 Subject: [PATCH] Clarify plan status rejection boundary Successful status reads return analysis diagnostics with exit zero. Reserve server_rejected for validated non-authentication problem responses so the error index matches the CLI contract. --- docs/errors.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/errors.md b/docs/errors.md index 8c707df..6883ae7 100644 --- a/docs/errors.md +++ b/docs/errors.md @@ -70,7 +70,8 @@ stopped without following the replacement. | Status, Compile, Compilation commands | `project_not_pushed` | 1 | No API origin is pinned for the local Project. | | `plan push`, `plan compile` | `request_outcome_unknown` | 1 | A mutation or its response could not be verified; `plan compile` identifies its `push` or `publication` phase. | | `plan push`, `plan compile` | `local_state_not_saved` | 1 | The Plan was accepted but the private ETag state could not be replaced; includes `recovery_state`. | -| `plan push`, `plan status`, `plan compile` | `server_rejected` | 1 | First Draft returned validated Plan diagnostics or rejected the request with a validated problem. | +| `plan push`, `plan compile` | `server_rejected` | 1 | First Draft returned validated Plan diagnostics or rejected the request with a validated problem. | +| `plan status` | `server_rejected` | 1 | First Draft rejected the analysis status request with a validated non-authentication problem. | | `plan status` | `status_unavailable`, `invalid_server_response` | 1 | The analysis read failed or violated its protocol. | | `plan compile` | `analysis_status_unavailable`, `invalid_analysis_status`, `analysis_status_rejected` | 1 | The bounded analysis read failed, was invalid, or was rejected. | | Analysis waits | `analysis_changed`, `wait_timed_out`, `analysis_wait_timed_out` | 1 | The pinned analysis changed or remained processing at the deadline. |