Let the asso pigliatutto ace capture itself on a bare table

With the rule enabled, an ace played on an empty table goes straight to
the player's capture pile instead of staying on the table: it counts as
the last capture but never scores a scopa. An empty capture request now
matches only that self-capture option, so requesting nothing still can't
satisfy a real capture.

server/packages/tavolo-scopone/src/tavolo/scopone/engine.py

@@ -29,9 +29,11 @@ Rules implemented
   it reaches at least three cards (A-2-3 = 3, A-2-3-4 = 4, ...). A team
   capturing the whole denari suit (ace to king) wins the match instantly.
 * Optional ``asso_pigliatutto`` rule (disabled by default): an ace played
-  when no equal rank is on the table sweeps the whole table. The sweep
-  never scores a scopa, even when cards remain in hand. When another ace
-  is on the table the mandatory equal-rank capture still applies.
+  when no equal rank is on the table sweeps the whole table — or captures
+  itself, leaving the table empty, when the table is bare. The sweep never
+  scores a scopa, even when cards remain in hand, but it counts as a
+  capture for the last-taker rule. When another ace is on the table the
+  mandatory equal-rank capture still applies.
 * The match ends when a team reaches the target score with a clear lead; a
   tie at or above the target is broken by playing another hand.
 """
@@ -122,14 +124,15 @@ def legal_captures(
     If an equal-ranked card is on the table, only those single-card
     captures are returned (the rule forbids taking a combination instead).
     Otherwise, when ``asso_pigliatutto`` is enabled and ``card`` is an ace,
-    the only capture is the whole table; without the option every subset of
-    the table whose ranks sum to ``card.rank`` is returned.
+    the only capture is the whole table — or an empty capture when the
+    table is bare, the ace taking itself. Without the option every subset
+    of the table whose ranks sum to ``card.rank`` is returned.
     """
     equal = [c for c in table if c.rank == card.rank]
     if equal:
         return [[c] for c in equal]
     if asso_pigliatutto and card.rank == 1:
-        return [list(table)] if table else []
+        return [list(table)]
 
     candidates = [c for c in table if c.rank <= card.rank]
     captures: List[List[Card]] = []
@@ -255,12 +258,12 @@ def play(
     options = legal_captures(
         table_before, card, asso_pigliatutto=state.asso_pigliatutto
     )
-    # An asso pigliatutto sweep: the ace takes the whole table because no
-    # equal rank was on it. Such a sweep never scores a scopa.
+    # An asso pigliatutto capture: the ace takes the whole table because no
+    # equal rank was on it, or takes itself when the table is bare. Such a
+    # capture never scores a scopa.
     pigliatutto = (
         state.asso_pigliatutto
         and card.rank == 1
-        and bool(table_before)
         and all(c.rank != card.rank for c in table_before)
     )
 
@@ -305,10 +308,12 @@ def play(
 def _match_option(
     options: Sequence[Sequence[Card]], requested: Sequence[Card]
 ) -> Optional[List[Card]]:
-    """Return the option matching ``requested`` exactly, if any."""
+    """Return the option matching ``requested`` exactly, if any.
+
+    An empty request matches only an empty option — the asso pigliatutto
+    self-capture — so requesting nothing never satisfies a real capture.
+    """
     wanted = sorted(c.code for c in requested)
-    if not wanted:
-        return None
     for option in options:
         if sorted(c.code for c in option) == wanted:
             return list(option)
@@ -339,7 +344,7 @@ def auto_play(state: ScoponeState, rng: Optional[random.Random] = None) -> None:
         state,
         player.sub,
         card.code,
-        [c.code for c in capture] if capture else None,
+        [c.code for c in capture] if capture is not None else None,
     )
 
 

server/packages/tavolo-scopone/src/tavolo/scopone/state.py

@@ -92,7 +92,8 @@ class Move:
     card: str
     captured: List[str] = field(default_factory=list)
     scopa: bool = False
-    # The play was an asso pigliatutto sweep (it took the whole table).
+    # The play was an asso pigliatutto capture (the whole table, or the
+    # ace itself when the table was empty).
     pigliatutto: bool = False
 
     def to_json(self) -> Dict[str, Any]:
@@ -159,8 +160,9 @@ class ScoponeState:
     # suit wins the match instantly). Default on.
     napola: bool = True
     # Whether the asso pigliatutto rule is scored (an ace sweeps the whole
-    # table when no equal rank is on it; the sweep never scores a scopa).
-    # Default off, also for states serialized before the option existed.
+    # table when no equal rank is on it, or captures itself when the table
+    # is empty; the capture never scores a scopa). Default off, also for
+    # states serialized before the option existed.
     asso_pigliatutto: bool = False
     phase: str = PHASE_LOBBY
     players: List[PlayerState] = field(default_factory=list)