======================================================================
SOURCE FILE:     01_c4_b2_bloc-star-2-seats.yaml
TABULATED FILE:  01_c4_b2_bloc-star-2-seats_tabulated.txt
======================================================================

election_title: "Bloc STAR Voting: 2-Seat Committee Election"
scenario_description: |-
  A basic multi-winner example with 4 candidates and 2 seats. It demonstrates how
  Bloc STAR fills each seat sequentially through a dedicated scoring round and
  automatic runoff.

num_winners: 2
voting_method: Bloc STAR
ballots: |-
  Ann,Bob,Cal,Don
  1,  0,  4,  5
  1,  2,  4,  5

expected_winners:
  - Don
  - Cal

# file: 01_c4_b2_bloc-star-2-seats.yaml

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

=== Bloc STAR Voting: 2-Seat Committee Election ===
  A basic multi-winner example with 4 candidates and 2 seats. It demonstrates how
  Bloc STAR fills each seat sequentially through a dedicated scoring round and
  automatic runoff.

--- Preference Matrix ---
Head-to-head / pairwise comparison
Legend: For - Equal Support - Against
        Informational only — not part of the 2-winner count below,
        so no Top-2 finalists are marked.
               |     Ann    |    Bob    |    Cal    |    Don    |
-----------------------------------------------------------------
         Ann > |    ---     |1 - 0 - 1  |0 - 0 - 2  |0 - 0 - 2  |
         Bob > | 1 - 0 - 1  |   ---     |0 - 0 - 2  |0 - 0 - 2  |
         Cal > | 2 - 0 - 0  |2 - 0 - 0  |   ---     |0 - 0 - 2  |
         Don > | 2 - 0 - 0  |2 - 0 - 0  |2 - 0 - 0  |   ---     |

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

[Condorcet Loser]
  No strict Condorcet loser; jointly weak Condorcet losers: Ann, Bob (winless — pairwise ties)

[Divergence from STAR]
  STAR     = Don
  Approval = Cal   (differs from STAR)

--- Bloc STAR Voting Method (2 winners) ---
[Bloc STAR]
 Tabulating 2 ballots to fill 2 seats.
Ann,Bob,Cal,Don
  1,  0,  4,  5
  1,  2,  4,  5

[Score Distribution] (how many ballots gave each star rating)
                Score
Candidate  5  4  3  2  1  0  | Total   Avg
Ann        0  0  0  0  2  0  |     2   1.0
Bob        0  0  0  1  0  1  |     2   1.0
Cal        0  2  0  0  0  0  |     8   4.0
Don        2  0  0  0  0  0  |    10   5.0

[Bloc STAR: Round 1: Scoring Round]
 The two highest-scoring candidates advance to the next round.
   Don           -- 10 -- First place
   Cal           --  8 -- Second place
   Ann           --  2
   Bob           --  2
 Don and Cal advance.

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

──────────────────────────────────────────────────
[Bloc STAR: Round 2: Scoring Round]
 The two highest-scoring candidates advance to the next round.
   Cal           -- 8 -- First place
   Ann           -- 2 -- Tied for second place
   Bob           -- 2 -- Tied for second place
 Cal advances, but there's a two-way tie for second.

[Bloc STAR: Round 2: Scoring Round: First tiebreaker]
 The candidate preferred in the most head-to-head matchups advances.
   Ann           -- 1 -- Tied for second place
   Bob           -- 1 -- Tied for second place
   Equal Support -- 0
 There's still a two-way tie for second.

[Bloc STAR: Round 2: Scoring Round: Second tiebreaker]
 The candidate with the most votes of score 5 advances.
   Ann           -- 0 -- Tied for second place
   Bob           -- 0 -- Tied for second place
 There's still a two-way tie for second.

*** No official tie-breaking lot numbers were provided.
    Ties are resolved using a fallback order: CSV column order.
    Lot-number priority order: ['Ann', 'Bob', 'Cal', 'Don']

[Tiebreaker: Lot Number Priority]
  Tie among: ['Ann', 'Bob']
  Resolved: ['Ann'] (selected by lot-number priority).

[Lot-decided tie — rare]
  ⚠ The ballots did not break this tie: the deterministic rungs
    (pairwise / score, then five-star) all came back equal, so the
    pre-published LOT order chose among the tied candidates — the
    result here was set by lot, not by the votes. Usually the
    "dead rung": no tied candidate held a score-5 vote (five-star
    counts fives, not fours). Verify the tied candidates' 5-counts.

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

[Bloc STAR: Winners — Bloc STAR Voting Method (2 winners)]
 Don
 Cal