Skip to content

execerr-classification.md

Latest commit

 

History

History
17 lines (10 loc) · 1.23 KB

execerr-classification.md

File metadata and controls

17 lines (10 loc) · 1.23 KB

Execute error classification (shared frontends)

Repository-wide error conventions: error-handling.md.

Bundled HTTP frontends map executor failures through internal/plugins/frontends/execerr to a small set: reject (4xx-class) vs internal (5xx-class). Protocol-specific status text and bodies stay inside each frontend adapter.

For internal (5xx) outcomes, the wire Message is a fixed, non-revealing string (internal error); the original error is retained on the Outcome for structured server-side logging. Frontends must log out.Err at error severity when present and must not echo arbitrary executor/upstream strings in JSON error bodies.

Richer shared kinds (deferred)

Future work may add more shared kinds (for example: cancellation, upstream unavailable, quota exhaustion, hook mutation) without moving protocol strings into internal/core. Any expansion should:

  1. extend the shared classifier in execerr only,
  2. keep wire encoding in internal/plugins/frontends/<name>/,
  3. add regression tests per new kind before broad use.

No additional shared kinds are required for stage-three closure; this note records the decision to defer.