feat: "multiple words per turn" rule for Russian games

Add a per-game rule chosen on New Game for Russian variants (default off = the
single-word rule; on = standard Scrabble). Off, only the main word along the play
direction is validated and scored; perpendicular cross-words are ignored,
including in robot move generation. The rule rides every create and enqueue
request and joins the matchmaking key, so games and auto-match stay one uniform
path; "Russian-only" is a UI affordance (English always sends standard and shows
no toggle).

- Engine: consume scrabble-solver v1.1.0's PlayOptions{IgnoreCrossWords}, threaded
  through engine.Options.MultipleWordsPerTurn -> playOpts() into validate, score
  and generate.
- Backend: thread the flag through game CreateParams/Game + store (games column),
  lobby InvitationSettings + invitation row, and the matchmaker queue key (variant
  + rule); persisted, so a rebuilt-from-journal game keeps it. Baseline migration
  gains multiple_words_per_turn (DB not versioned); jet regenerated.
- Edge: multiple_words_per_turn added to the EnqueueRequest / CreateInvitationRequest
  FlatBuffers tables (Go + TS regenerated) and threaded through the gateway.
- UI: a "Multiple words per turn" toggle on New Game, shown for Russian variants
  only (auto-match and friend invite), default off; English silently sends standard.
- Tests: backend engine/matchmaker; UI unit (gating) + Playwright e2e (solver
  corner-case + GCG fixtures ship in v1.1.0). Docs + PRERELEASE tracker updated.

backend/internal/lobby/matchmaker.go

@@ -14,6 +14,14 @@ import (
 	"scrabble/backend/internal/notify"
 )
 
+// matchKey buckets the auto-match pool: two players are paired only when they chose
+// the same variant and the same per-turn word rule (multipleWords), so a game always
+// starts under a rule both players asked for.
+type matchKey struct {
+	variant       engine.Variant
+	multipleWords bool
+}
+
 // Matchmaker is the in-memory auto-match pool: a FIFO queue per variant that pairs
 // the next two humans into a two-player game, or — when no human arrives within
 // the wait window — substitutes a robot. It holds no database state and is lost on
@@ -35,8 +43,8 @@ type Matchmaker struct {
 	log       *zap.Logger
 
 	mu           sync.Mutex
-	queues       map[engine.Variant][]uuid.UUID
-	queued       map[uuid.UUID]engine.Variant
+	queues       map[matchKey][]uuid.UUID
+	queued       map[uuid.UUID]matchKey
 	waitingSince map[uuid.UUID]time.Time
 	results      map[uuid.UUID]game.Game
 	rng          *rand.Rand
@@ -55,8 +63,8 @@ func NewMatchmaker(games GameCreator, robots RobotProvider, waitDelay time.Durat
 		clock:        func() time.Time { return time.Now().UTC() },
 		pub:          notify.Nop{},
 		log:          log,
-		queues:       make(map[engine.Variant][]uuid.UUID),
-		queued:       make(map[uuid.UUID]engine.Variant),
+		queues:       make(map[matchKey][]uuid.UUID),
+		queued:       make(map[uuid.UUID]matchKey),
 		waitingSince: make(map[uuid.UUID]time.Time),
 		results:      make(map[uuid.UUID]game.Game),
 		rng:          rand.New(rand.NewSource(time.Now().UnixNano())),
@@ -101,34 +109,36 @@ type EnqueueResult struct {
 	Game    game.Game
 }
 
-// Enqueue joins accountID to the variant pool. If an opponent already waits, the
-// two are paired (seat order randomised for first-move fairness) and a game starts
-// immediately; otherwise the account waits, and a later pairing or robot
-// substitution is delivered through Poll. An account already waiting in any pool
-// gets ErrAlreadyQueued.
-func (m *Matchmaker) Enqueue(ctx context.Context, accountID uuid.UUID, variant engine.Variant) (EnqueueResult, error) {
+// Enqueue joins accountID to the auto-match pool for variant under the chosen
+// per-turn word rule (multipleWords). If an opponent already waits for the same
+// variant and rule, the two are paired (seat order randomised for first-move
+// fairness) and a game starts immediately; otherwise the account waits, and a later
+// pairing or robot substitution is delivered through Poll. An account already waiting
+// in any pool gets ErrAlreadyQueued.
+func (m *Matchmaker) Enqueue(ctx context.Context, accountID uuid.UUID, variant engine.Variant, multipleWords bool) (EnqueueResult, error) {
+	key := matchKey{variant: variant, multipleWords: multipleWords}
 	m.mu.Lock()
 	if _, ok := m.queued[accountID]; ok {
 		m.mu.Unlock()
 		return EnqueueResult{}, ErrAlreadyQueued
 	}
-	q := m.queues[variant]
+	q := m.queues[key]
 	if len(q) == 0 {
-		m.queues[variant] = append(q, accountID)
-		m.queued[accountID] = variant
+		m.queues[key] = append(q, accountID)
+		m.queued[accountID] = key
 		m.waitingSince[accountID] = m.clock()
 		m.mu.Unlock()
 		return EnqueueResult{}, nil
 	}
 	opponent := q[0]
-	m.removeLocked(opponent, variant)
+	m.removeLocked(opponent, key)
 	seats := []uuid.UUID{opponent, accountID}
 	if m.rng.Intn(2) == 0 {
 		seats[0], seats[1] = seats[1], seats[0]
 	}
 	m.mu.Unlock()
 
-	g, err := m.games.Create(ctx, autoMatchParams(variant, seats))
+	g, err := m.games.Create(ctx, autoMatchParams(key, seats))
 	if err != nil {
 		return EnqueueResult{}, err
 	}
@@ -161,19 +171,21 @@ func (m *Matchmaker) Cancel(_ context.Context, accountID uuid.UUID) bool {
 	m.mu.Lock()
 	defer m.mu.Unlock()
 	delete(m.results, accountID)
-	variant, ok := m.queued[accountID]
+	key, ok := m.queued[accountID]
 	if !ok {
 		return false
 	}
-	m.removeLocked(accountID, variant)
+	m.removeLocked(accountID, key)
 	return true
 }
 
-// QueueLen returns the number of accounts waiting in the variant pool.
+// QueueLen returns the number of accounts waiting in the variant pool, summed across
+// both per-turn word rules.
 func (m *Matchmaker) QueueLen(variant engine.Variant) int {
 	m.mu.Lock()
 	defer m.mu.Unlock()
-	return len(m.queues[variant])
+	return len(m.queues[matchKey{variant: variant, multipleWords: false}]) +
+		len(m.queues[matchKey{variant: variant, multipleWords: true}])
 }
 
 // RunReaper substitutes a robot for any player that has waited past waitDelay,
@@ -198,9 +210,9 @@ func (m *Matchmaker) RunReaper(ctx context.Context, interval time.Duration) {
 // momentarily empty pool just defers substitution to a later tick.
 func (m *Matchmaker) Reap(ctx context.Context, now time.Time) {
 	type sub struct {
-		human   uuid.UUID
-		variant engine.Variant
-		seats   []uuid.UUID
+		human uuid.UUID
+		key   matchKey
+		seats []uuid.UUID
 	}
 	m.mu.Lock()
 	var due []uuid.UUID
@@ -211,23 +223,23 @@ func (m *Matchmaker) Reap(ctx context.Context, now time.Time) {
 	}
 	var subs []sub
 	for _, acc := range due {
-		variant := m.queued[acc]
-		robotID, err := m.robots.Pick(variant)
+		key := m.queued[acc]
+		robotID, err := m.robots.Pick(key.variant)
 		if err != nil {
 			m.log.Warn("robot substitution deferred", zap.Error(err))
 			continue
 		}
-		m.removeLocked(acc, variant)
+		m.removeLocked(acc, key)
 		seats := []uuid.UUID{acc, robotID}
 		if m.rng.Intn(2) == 0 {
 			seats[0], seats[1] = seats[1], seats[0]
 		}
-		subs = append(subs, sub{human: acc, variant: variant, seats: seats})
+		subs = append(subs, sub{human: acc, key: key, seats: seats})
 	}
 	m.mu.Unlock()
 
 	for _, s := range subs {
-		g, err := m.games.Create(ctx, autoMatchParams(s.variant, s.seats))
+		g, err := m.games.Create(ctx, autoMatchParams(s.key, s.seats))
 		if err != nil {
 			m.log.Warn("robot substitution failed", zap.String("human", s.human.String()), zap.Error(err))
 			continue
@@ -241,13 +253,13 @@ func (m *Matchmaker) Reap(ctx context.Context, now time.Time) {
 
 // removeLocked drops accountID from the queue, the queued index and the waiting
 // clock. The caller holds m.mu.
-func (m *Matchmaker) removeLocked(accountID uuid.UUID, variant engine.Variant) {
+func (m *Matchmaker) removeLocked(accountID uuid.UUID, key matchKey) {
 	delete(m.queued, accountID)
 	delete(m.waitingSince, accountID)
-	q := m.queues[variant]
+	q := m.queues[key]
 	for i, id := range q {
 		if id == accountID {
-			m.queues[variant] = append(q[:i], q[i+1:]...)
+			m.queues[key] = append(q[:i], q[i+1:]...)
 			break
 		}
 	}
@@ -255,12 +267,13 @@ func (m *Matchmaker) removeLocked(accountID uuid.UUID, variant engine.Variant) {
 
 // autoMatchParams builds the create parameters for a two-player auto-match with
 // the casual defaults.
-func autoMatchParams(variant engine.Variant, seats []uuid.UUID) game.CreateParams {
+func autoMatchParams(key matchKey, seats []uuid.UUID) game.CreateParams {
 	return game.CreateParams{
-		Variant:        variant,
-		Seats:          seats,
-		TurnTimeout:    game.DefaultTurnTimeout,
-		HintsAllowed:   autoMatchHintsAllowed,
-		HintsPerPlayer: autoMatchHintsPerPlayer,
+		Variant:              key.variant,
+		Seats:                seats,
+		TurnTimeout:          game.DefaultTurnTimeout,
+		HintsAllowed:         autoMatchHintsAllowed,
+		HintsPerPlayer:       autoMatchHintsPerPlayer,
+		MultipleWordsPerTurn: key.multipleWords,
 	}
 }