# Possible Quiz Questions This document lists every question template currently generated by the API. Relevant files: - `src/party/audio-question-generator.ts` - `src/party/social-question-generator.ts` - `src/party/numeric-question-generator.ts` Notes: - Dynamic placeholders are shown with angle brackets, for example `` or ``. - Every generated question is worth `10` points. - Choice questions generate shuffled answer options. - Numeric questions generate a numeric answer range instead of options. - Not every template is available in every party. A question is only emitted when the required analytics, metadata, answer options, and party size are available. ## Audio metadata choice questions Audio metadata questions are generated by `buildAudioMetadataQuestion`. | Template | Correct answer | Required data / condition | | --- | --- | --- | | `What song is currently playing?` | Current/selected top song title | A resolvable top song and enough track title options | | `Which genre is shared by the most party members?` | The highest-ranked shared genre | Shared genre analytics and enough genre options | | `Which genre is ranked # in the party's shared genres?` | The genre at that exact rank | Shared genre analytics and enough genre options | | `Which artist is ranked highest in the shared audio data?` | The highest-ranked fair artist | Fair artist analytics and enough artist options | | `Which artist is ranked # in the shared audio data?` | The artist at that exact rank | Fair artist analytics and enough artist options | | `Which track is ranked highest across the party?` | The top fair shared track | Top fair track is shared by more than one member and enough track options exist | | `Which track is ranked # in the party analysis?` | The track at that exact rank | Fair track analytics and enough track options | | `Which artist appears on ""?` | An artist from the album | A top track with album name and artist metadata, plus enough artist options | | `Which of these tracks came out first?` | Earliest released track among detailed top tracks | At least two detailed top tracks with album release dates | | `Which of these tracks came out most recently?` | Latest released track among detailed top tracks | At least two detailed top tracks with album release dates and distinct earliest/latest tracks | | `What's the longest track by ?` | Longest detailed top track for that artist | At least two detailed top tracks by the same artist with durations | | `Who performs ""?` | The track's artist | A top track with artist metadata and enough artist options | | `What is the name of this track by ?` | The track title | A top track with artist metadata and enough track title options; song title is hidden | | `Which song is this audio clip from?` | Current/selected top song title | A top song exists, differs from the iterated top track, and enough track title options exist; song title is hidden | | `"" appears on which album?` | The track's album | A top track with album metadata and enough album options | ## Social choice questions Social questions are generated by `buildSocialQuestion`. | Template | Correct answer | Required data / condition | | --- | --- | --- | | `Who is leading the quiz right now?` | Current quiz leader | At least 2 members and a clear leader in `quizState.scores` | | `Who looks like the most diverse listener in the party?` | Member with highest genre entropy | At least 2 members and `groupSummary.mostDiverseMember` is available | | `Who listens the most to ""?` | Member with the highest score for that track | At least 2 members, a fair top track, and a top listener for that track | | `Which two players share the most musical taste?` | Pair from `groupSummary.mostAlignedPair` | At least 3 members and a resolvable most-aligned pair | ## Numeric questions Numeric questions are generated by `buildNumericQuestion`. | Template | Correct answer | Range | Required data / condition | | --- | --- | --- | --- | | `What's the release year of ?` | Album release year | Release-year range around correct year | A fair top track with an album release date | | `What year did "" come out?` | Track album release year | Release-year range around correct year | A detailed fair top track with an album release date | | `What year did 's first party track come out?` | Release year of the earliest party track by that artist | Release-year range around correct year | At least two detailed top tracks by the same artist with release dates | | `For how many players in the party is "" a top track?` | Count of party members whose top tracks include the track | `0` to party member count | A fair top track that resolves to a database track and appears for at least one member | | `How many players in the party have "" as a favourite artist?` | Count of party members whose top artists include the artist | `0` to party member count | A fair top artist that resolves to a database artist and appears for at least one member | ## Template count Current total: **24 question templates**. - Audio metadata: 15 - Social: 4 - Numeric: 5 ## Selection behavior The generator does not walk this list in a fixed order. For each round: 1. It prioritizes a question family: `audio-metadata`, `numeric`, or `social`. 2. The priority is randomized but penalizes question families used in the last 3 rounds. 3. Each family builds all valid candidates it can from the current party data. 4. Candidates with repeated question keys, subject keys, or text are filtered out. 5. A weighted random candidate is selected, with higher weight for subjects shared by more party members. 6. A song is attached when possible, preferring fresh songs that were not used in prior rounds.