stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 12 Releases Wiki Activity
Files
3f3473ee3a87e3935e0e5a60f3ce481a3b507c1a
git.stella-ops.org/docs/api/gateway/exception-events.md
master 3f3473ee3a
Some checks failed
AOC Guard CI / aoc-guard (push) Has been cancelled
Details
AOC Guard CI / aoc-verify (push) Has been cancelled
Details
Concelier Attestation Tests / attestation-tests (push) Has been cancelled
Details
Docs CI / lint-and-preview (push) Has been cancelled
Details
feat: add Reachability Center and Why Drawer components with tests 
- Implemented ReachabilityCenterComponent for displaying asset reachability status with summary and filtering options.
- Added ReachabilityWhyDrawerComponent to show detailed reachability evidence and call paths.
- Created unit tests for both components to ensure functionality and correctness.
- Updated accessibility test results for the new components.
2025-12-12 18:50:35 +02:00

1.1 KiB
Raw Blame History

Exception Events Gateway Contract (draft v0.1)

Scope: stream exception workflow events (exception.*) for Console activity feeds and Notify integrations.

Security / headers

  • Authorization: Bearer <token> (or DPoP where configured)
  • X-StellaOps-Tenant: <tenantId> (required)
  • X-Stella-Project: <projectId> (optional)
  • Scopes: exception:read

Endpoint

  • GET /exceptions/events — Server-Sent Events (SSE) stream.
    • Query params: tenant, traceId, projectId (optional)
    • Response: text/event-stream

Event types

  • exception.created
  • exception.updated
  • exception.status_changed
  • exception.deleted

Rate limits (proposal)

  • Max 1 active SSE connection per browser session.
  • Heartbeat every 30s; server closes idle connections after 60s without reads.
  • When rate limited: 429 with Retry-After.

Notify integration

Gateways SHOULD forward these events to Notify where configured:

  • exception.status_changed → notify.event with severity derived from exception severity and status.
  • All events include traceId for audit correlation.

Samples

  • docs/api/gateway/samples/exception-events.ndjson