JSON Schema for the game-state feed #49

New issue

Closed

opened 2026-10-20 19:14:27 +00:00 by mintopia · 3 comments

mintopia commented 2026-10-20 19:14:27 +00:00

Owner

Copy link

What to build

Clients can validate every game-state feed message against a published JSON Schema that follows the ADR 0019 message contract. Kept hand-written docs stay the primary explanation; the schema is linked from them.

Acceptance criteria

• Schema covers snapshot, change and every event type
• A test validates examples/live-timing/sample-race.jsonl against the schema
• Feed docs link to the schema

Decided in the docs-site grilling (2026-10-20).

## What to build Clients can validate every game-state feed message against a published JSON Schema that follows the ADR 0019 message contract. Kept hand-written docs stay the primary explanation; the schema is linked from them. ## Acceptance criteria - [ ] Schema covers snapshot, change and every event type - [ ] A test validates `examples/live-timing/sample-race.jsonl` against the schema - [ ] Feed docs link to the schema Decided in the docs-site grilling (2026-10-20).

mintopia added this to the Feed: standard messages, powerup events, race stats milestone 2026-10-20 19:14:27 +00:00

mintopia added the

ready-for-agent

label 2026-10-20 19:14:33 +00:00

mintopia self-assigned this 2026-10-20 22:30:14 +00:00

mintopia removed their assignment 2026-10-20 22:31:10 +00:00

mintopia added a new dependency 2026-10-20 22:34:35 +00:00

#31 Feed: apply the ADR 0019 message contract

mintopia added a new dependency 2026-10-20 22:34:35 +00:00

#32 Feed: dev-only debug state for scripts

mintopia added a new dependency 2026-10-20 22:34:36 +00:00

#33 Test-race scenarios and race bot in scripts/

mintopia added a new dependency 2026-10-20 22:34:36 +00:00

#34 Spike: game race ID shared across LAN instances

mintopia added a new dependency 2026-10-20 22:34:36 +00:00

#35 Feed: use and collect events, per-racer totals

mintopia added a new dependency 2026-10-20 22:34:37 +00:00

#36 Decoy drop and decoy hit events

mintopia added a new dependency 2026-10-20 22:34:37 +00:00

#37 Bribe's starting powerup missing from the feed

mintopia added a new dependency 2026-10-20 22:34:38 +00:00

#38 Game award stats and awards in the feed

mintopia commented 2026-10-20 22:34:39 +00:00

Author

Owner

Copy link

Blocked on #31–#38: the schema must match the final ADR 0019 contract, sample-race.jsonl is migrated in #31, and the use/collect/decoy/award event payloads land in #35–#38. Earlier escalation (missing blocked-by) resolved.

Blocked on #31–#38: the schema must match the final ADR 0019 contract, `sample-race.jsonl` is migrated in #31, and the use/collect/decoy/award event payloads land in #35–#38. Earlier escalation (missing blocked-by) resolved.

mintopia self-assigned this 2026-10-21 18:52:13 +00:00

mintopia commented 2026-10-21 18:53:44 +00:00

Author

Owner

Copy link

Added examples/live-timing/feed.schema.json (draft 2020-12; served at /live-timing/feed.schema.json): snapshot, change (typed known keys, roster/standings/race_result), events hit/use/collect/decoy_drop/decoy_hit; unknown keys/events allowed. tests/feed_schema_test.py (ctest feed_schema, needs python jsonschema) validates all 1368 sample-race.jsonl messages, example events, and negative cases. Linked from docs/state-websocket.md and docs/testing.md. Note: sample has no events and no totals, so those are covered by inline examples; totals optional in schema. Docs-site build not run (no node_modules).

Added `examples/live-timing/feed.schema.json` (draft 2020-12; served at /live-timing/feed.schema.json): snapshot, change (typed known keys, roster/standings/race_result), events hit/use/collect/decoy_drop/decoy_hit; unknown keys/events allowed. `tests/feed_schema_test.py` (ctest `feed_schema`, needs python jsonschema) validates all 1368 sample-race.jsonl messages, example events, and negative cases. Linked from docs/state-websocket.md and docs/testing.md. Note: sample has no events and no `totals`, so those are covered by inline examples; `totals` optional in schema. Docs-site build not run (no node_modules).

mintopia closed this issue 2026-10-21 18:54:29 +00:00

mintopia commented 2026-10-21 18:54:29 +00:00

Author

Owner

Copy link

Completed and merged by Harmonic (task 41).

Completed and merged by Harmonic (task 41).

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

develop

main

v0.1.0

Labels

Clear labels   

needs-info

Waiting on reporter for more information

  

needs-triage

Maintainer needs to evaluate this issue

  

ready-for-agent

Fully specified, ready for an AFK agent

  

ready-for-human

Requires human implementation

  

wontfix

Will not be actioned

No labels

needs-info

needs-triage

ready-for-agent

ready-for-human

wontfix

Milestone

Clear milestone

No items

No milestone

Feed: standard messages, powerup events, race stats

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

mintopia

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Depends on

#31 Feed: apply the ADR 0019 message contract

mintopia/blur

#32 Feed: dev-only debug state for scripts

mintopia/blur

#33 Test-race scenarios and race bot in scripts/

mintopia/blur

#34 Spike: game race ID shared across LAN instances

mintopia/blur

#35 Feed: use and collect events, per-racer totals

mintopia/blur

#36 Decoy drop and decoy hit events

mintopia/blur

#37 Bribe's starting powerup missing from the feed

mintopia/blur

#38 Game award stats and awards in the feed

mintopia/blur

Reference

mintopia/blur#49

No description provided.