Summary
core/specs/probable.yaml documents the GET /events response as a paginated envelope object { events: Event[], pagination: {...} }. The live Probable API actually returns a bare array of events Event[] with no wrapping object. The spec is incorrect (note: the PMXT fetcher code handles this correctly by reading the raw array — the spec is wrong, not the code).
Impact
MEDIUM — the spec misrepresents the actual API response shape. Any code generated from or validated against the spec would expect an envelope that doesn't exist. The spec inaccuracy also makes the codebase harder to maintain.
Details
- Endpoint:
GET /events
- Spec declares:
{ events: Event[], pagination: { cursor: string, total: integer } }
- Live API returns:
Event[] (bare array, no pagination wrapper)
- Code status: the Probable fetcher correctly reads from the bare array (no bug in code)
- Spec file:
core/specs/probable.yaml, getEvents response schema
Required Fix
Update the getEvents response schema in core/specs/probable.yaml to reflect the actual bare array response: type: array, items: $ref Event. Remove the erroneous pagination envelope from the schema.
Summary
core/specs/probable.yamldocuments theGET /eventsresponse as a paginated envelope object{ events: Event[], pagination: {...} }. The live Probable API actually returns a bare array of eventsEvent[]with no wrapping object. The spec is incorrect (note: the PMXT fetcher code handles this correctly by reading the raw array — the spec is wrong, not the code).Impact
MEDIUM — the spec misrepresents the actual API response shape. Any code generated from or validated against the spec would expect an envelope that doesn't exist. The spec inaccuracy also makes the codebase harder to maintain.
Details
GET /events{ events: Event[], pagination: { cursor: string, total: integer } }Event[](bare array, no pagination wrapper)core/specs/probable.yaml, getEvents response schemaRequired Fix
Update the
getEventsresponse schema incore/specs/probable.yamlto reflect the actual bare array response:type: array, items: $ref Event. Remove the erroneous pagination envelope from the schema.