OPDC API error code

SAGE_ERROR

HTTP status 502

Any other database-side failure: a deadlock, a permission, a dropped connection. 502, retryable.

The four codes above are split out of it precisely so that this one's retry hint is honest: what is left here can clear without the caller changing anything, and a constraint violation never can.

The API answers with a problem document (RFC 9457) whose type is https://twinn.engineering/errors/sage-error, and with X-Error-Code: SAGE_ERROR. Branch on the code, never on the detail text.

How errors work, and what to retryEvery error code