======================================================================
SOURCE FILE:     bv2187_qrw6wb_ann-bob-cal.yaml
TABULATED FILE:  bv2187_qrw6wb_ann-bob-cal_tabulated.txt
======================================================================

election_title: Ann, Bob, Cal - the canonical leading example (single-winner STAR)

bv_test_id: BV2187
bv_election_id: qrw6wb
bv_results_url: https://bettervoting.com/qrw6wb/results

scenario_description: |-
  THE repo's leading example - the exact election shown in the root README, the
  YAML authoring template, and "Why YAML test cases". One file, three voters,
  three candidates: the smallest STAR election where both rounds do visible,
  different work. If a page needs "a STAR election" and nothing scenario-specific,
  it should show THIS one (see 07_Concepts/tips/TIPS_canonical_elections.md).

  Live results: https://bettervoting.com/qrw6wb/results (BetterVoting election
  qrw6wb, Test ID BV2187; write-ins disabled - the candidate list is locked).

  What each ballot teaches:
  - Voter 1 (5,4,0): likes BOTH Ann (5) and Bob (4) - no vote-splitting fear.
    In the runoff her ballot is one full vote for Ann (5 > 4): a near-tie in
    scores is still a whole vote in the runoff.
  - Voter 2 (3,5,2): a Bob fan who honestly scores the others too.
  - Voter 3 (0,3,5): loves Cal, rates Bob a lukewarm 3 - and that honest 3 is
    exactly what makes Bob everyone's acceptable choice.

  The count: Scoring Round totals Bob 12, Ann 8, Cal 7 -> finalists Bob & Ann.
  Automatic Runoff: Bob is preferred on 2 ballots, Ann on 1 -> Bob wins 2-1.
  Bob leads the scores AND wins the runoff - deliberately no twist, so the
  PROCEDURE is the whole lesson. (Bob is also the Condorcet winner.)

  CANONICAL = FROZEN: never edit these ballots. A lesson needing different
  ballots gets a new scenario with a new cast of names.

voting_method: STAR   # STAR Voting - Single-winner
num_winners: 1
ballots: |-
  Ann,Bob,Cal
  5,4,0
  3,5,2
  0,3,5

expected_winners:
  - Bob

# file: bv2187_qrw6wb_ann-bob-cal.yaml

======================================================================
TABULATION RESULTS
======================================================================

=== Ann, Bob, Cal - the canonical leading example (single-winner STAR) ===
  THE repo's leading example - the exact election shown in the root README, the
  YAML authoring template, and "Why YAML test cases". One file, three voters,
  three candidates: the smallest STAR election where both rounds do visible,
  different work. If a page needs "a STAR election" and nothing scenario-specific,
  it should show THIS one (see 07_Concepts/tips/TIPS_canonical_elections.md).

  Live results: https://bettervoting.com/qrw6wb/results (BetterVoting election
  qrw6wb, Test ID BV2187; write-ins disabled - the candidate list is locked).

  What each ballot teaches:
  - Voter 1 (5,4,0): likes BOTH Ann (5) and Bob (4) - no vote-splitting fear.
    In the runoff her ballot is one full vote for Ann (5 > 4): a near-tie in
    scores is still a whole vote in the runoff.
  - Voter 2 (3,5,2): a Bob fan who honestly scores the others too.
  - Voter 3 (0,3,5): loves Cal, rates Bob a lukewarm 3 - and that honest 3 is
    exactly what makes Bob everyone's acceptable choice.

  The count: Scoring Round totals Bob 12, Ann 8, Cal 7 -> finalists Bob & Ann.
  Automatic Runoff: Bob is preferred on 2 ballots, Ann on 1 -> Bob wins 2-1.
  Bob leads the scores AND wins the runoff - deliberately no twist, so the
  PROCEDURE is the whole lesson. (Bob is also the Condorcet winner.)

  CANONICAL = FROZEN: never edit these ballots. A lesson needing different
  ballots gets a new scenario with a new cast of names.

--- Runoff (Preference) Matrix ---
Head-to-head / pairwise comparison
Legend: For - Equal Support - Against
        * indicates Top 2 Finalist
               |   * Ann    |  * Bob    |    Cal    |
-----------------------------------------------------
       * Ann > |    ---     |1 - 0 - 2  |2 - 0 - 1  |
       * Bob > | 2 - 0 - 1  |   ---     |2 - 0 - 1  |
         Cal > | 1 - 0 - 2  |1 - 0 - 2  |   ---     |

[Condorcet Winner]
  Condorcet Winner: Bob — matches the STAR winner

[Condorcet Loser]
  Condorcet Loser: Cal — loses every head-to-head matchup

[Divergence from STAR]
  STAR                   = Bob
  Choose-One (Plurality) = Ann   (differs from STAR)

--- STAR Voting Method (single winner) ---
[STAR Voting]
 Tabulating 3 ballots.
Ann,Bob,Cal
  5,  4,  0
  3,  5,  2
  0,  3,  5

[Score Distribution] (how many ballots gave each star rating)
                Score
Candidate  5  4  3  2  1  0  | Total   Avg
Ann        1  0  1  0  0  1  |     8   2.7
Bob        1  1  1  0  0  0  |    12   4.0
Cal        1  0  0  1  0  1  |     7   2.3

[STAR Voting: Scoring Round]
 The two highest-scoring candidates advance to the next round.
   Bob           -- 12 -- First place
   Ann           --  8 -- Second place
   Cal           --  7
 Bob and Ann advance.

[STAR Voting: Automatic Runoff Round]
 The candidate preferred in the most head-to-head matchups wins.
   Bob           -- 2 -- First place
   Ann           -- 1
   Equal Support -- 0
 Bob wins.
   Runoff math:
     3  ballots cast
   − 0  Equal Support (no preference between the two finalists)
     ─
     3  voters with a preference  (majority = 2)
           Bob 2 (67%)  ·  Ann 1 (33%)

[STAR Voting: Winner — STAR Voting Method (single winner)]
 Bob