feat(spec): parlay command endpoints (toilville-design#177) #18

Merged

peterswimm merged 1 commit from feat/spec-parlay-commands into main

2026-10-08 16:32:10 +00:00

peterswimm commented

2026-10-08 15:41:11 +00:00

Owner

Scope

Describes the parlay command endpoints served by ritual-engine#891, over spel#1080's contract:

GET /api/v1/parlays/{parlay_id}/commands
POST /api/v1/parlays/{parlay_id}/commands
Four schemas: ParlayCommandRequest, ParlayCommandResult, AvailableParlayCommand, ParlayCommandList.
The new steward visibility rule on GET /api/v1/events.
openapi.yaml goes to 0.64.0.

Merge after ritual-engine#891 and spel#1080, since this repo describes only endpoints the server serves.

Testing

openapi-spec-validator passes on openapi.yaml.
tools/check_schema_registry.py passes (6 files).
pytest passes: 18 passed, 1 xfailed (unchanged).
The result and list shapes match what spel#1080's shadow rehearsal returned, and what ritual-core's parlay_command tests parse.

Impact Statement

Existing features: none change.
Public APIs / contracts:
- Two new operations, listParlayCommands and applyParlayCommand, under the existing governance tag.
- GET /api/v1/events's visibility text now includes frame parlays for the steward.
Schemas: four new component schemas. No existing schema changes.
Data / artifacts: none.
Integrations: none. No Kafka command topic.
Mappings: parlay_id is the frame parlay's frame_id.
Backward compatibility: additive.

Docs

CHANGELOG Unreleased has a "parlay commands" section covering what is added and changed, and what is left out (the dormant voting kernel and a command topic).

## Scope Describes the parlay command endpoints served by ritual-engine#891, over spel#1080's contract: - `GET /api/v1/parlays/{parlay_id}/commands` - `POST /api/v1/parlays/{parlay_id}/commands` - Four schemas: `ParlayCommandRequest`, `ParlayCommandResult`, `AvailableParlayCommand`, `ParlayCommandList`. - The new steward visibility rule on `GET /api/v1/events`. - `openapi.yaml` goes to 0.64.0. **Merge after ritual-engine#891 and spel#1080**, since this repo describes only endpoints the server serves. ## Testing - `openapi-spec-validator` passes on `openapi.yaml`. - `tools/check_schema_registry.py` passes (6 files). - `pytest` passes: 18 passed, 1 xfailed (unchanged). - The result and list shapes match what spel#1080's shadow rehearsal returned, and what ritual-core's `parlay_command` tests parse. ## Impact Statement - Existing features: none change. - Public APIs / contracts: - Two new operations, `listParlayCommands` and `applyParlayCommand`, under the existing `governance` tag. - `GET /api/v1/events`'s visibility text now includes frame parlays for the steward. - Schemas: four new component schemas. No existing schema changes. - Data / artifacts: none. - Integrations: none. No Kafka command topic. - Mappings: `parlay_id` is the frame parlay's `frame_id`. - Backward compatibility: additive. ## Docs CHANGELOG Unreleased has a "parlay commands" section covering what is added and changed, and what is left out (the dormant voting kernel and a command topic).

peterswimm added 1 commit

2026-10-08 15:41:11 +00:00

feat(spec): parlay command endpoints and steward visibility on the events stream

PR policy check / policy-gate (pull_request) Successful in 0s

Details

CI / schema-registry (pull_request) Successful in 7s

Details

640fc36202

Describes ritual-engine#891 over spel#1080: GET/POST
/api/v1/parlays/{parlay_id}/commands with ParlayCommandRequest,
ParlayCommandResult, AvailableParlayCommand and ParlayCommandList, and
the events stream's new steward rule for frame-parlay facts. 0.64.0.

peterswimm merged commit c33759ba91 into main

2026-10-08 16:32:10 +00:00

peterswimm deleted branch feat/spec-parlay-commands

2026-10-08 16:32:10 +00:00

peterswimm referenced this pull request from a commit

2026-10-08 16:32:10 +00:00

Merge pull request 'feat(spec): parlay command endpoints (toilville-design#177)' (#18) from feat/spec-parlay-commands into main