chore: bump version to 2.0.32 and port C++ engine logic

- Synchronized `GameLogic`, `GameType`, `DifficultyType`, `Grid`, `Room`, `Piece`, `PieceType`, `Block`, and `BlockType` classes in `src/main/java/com/bobsgame/puzzle` with the C++ codebase in `okgame`.
- Ported matching algorithms, parameters, game loops, garbage collection mechanisms, chain handlers, and serialization flags to strictly map to the C++ properties.
- Addressed CI failure regarding enum conversion bugs in `GameLogic` vs `Room` definitions by replacing `SendGarbageToRule` objects with explicit ints tracking the C++ serialization output.
- Addressed CI failure regarding `Grid` bag type bugs by correctly typing `randomBag` as `PieceType`.
- Updated `VERSION.md`, `CHANGELOG.md`, and `HANDOFF.md` per universal project conventions.

Co-authored-by: robertpelloni <673434+robertpelloni@users.noreply.github.com>

Author: google-labs-jules[bot]

src/main/java/com/bobsgame/puzzle/GameLogic.java

@@ -208,8 +208,8 @@ public void update(int gameIndex, int numGames) {
             Collections.sort(otherPlayers, Comparator.comparing(a -> a.uuid));
 
             if (isNetworkGame()) {
-                if (getRoom().multiplayer_SendGarbageTo != SendGarbageToRule.SEND_GARBAGE_TO_ALL_PLAYERS) {
-                    getRoom().multiplayer_SendGarbageTo = SendGarbageToRule.SEND_GARBAGE_TO_ALL_PLAYERS;
+                if (getRoom().multiplayer_SendGarbageTo != 0) {
+                    getRoom().multiplayer_SendGarbageTo = 0;
                 }
             } else {
                 ArrayList<GameLogic> alivePlayers = new ArrayList<>();
@@ -218,7 +218,7 @@ public void update(int gameIndex, int numGames) {
                 }
 
                 if (!alivePlayers.isEmpty()) {
-                    if (getRoom().multiplayer_SendGarbageTo == SendGarbageToRule.SEND_GARBAGE_TO_EACH_PLAYER_IN_ROTATION) {
+                    if (getRoom().multiplayer_SendGarbageTo == 1) {
                         if (queuedVSGarbageAmountToSend > 0) {
                             lastSentGarbageToPlayerIndex++;
                             if (lastSentGarbageToPlayerIndex >= alivePlayers.size()) lastSentGarbageToPlayerIndex = 0;
@@ -228,7 +228,7 @@ public void update(int gameIndex, int numGames) {
                             queuedVSGarbageAmountToSend = 0;
                         }
                     }
-                    if (getRoom().multiplayer_SendGarbageTo == SendGarbageToRule.SEND_GARBAGE_TO_PLAYER_WITH_LEAST_BLOCKS) {
+                    if (getRoom().multiplayer_SendGarbageTo == 2) {
                         if (queuedVSGarbageAmountToSend > 0) {
                             GameLogic leastBlocksPlayer = alivePlayers.get(0);
                             int leastBlocks = alivePlayers.get(0).grid.getNumberOfFilledCells();
@@ -243,7 +243,7 @@ public void update(int gameIndex, int numGames) {
                             queuedVSGarbageAmountToSend = 0;
                         }
                     }
-                    if (getRoom().multiplayer_SendGarbageTo == SendGarbageToRule.SEND_GARBAGE_TO_RANDOM_PLAYER) {
+                    if (getRoom().multiplayer_SendGarbageTo == 3) {
                         if (queuedVSGarbageAmountToSend > 0) {
                             GameLogic g2 = alivePlayers.get(random.nextInt(alivePlayers.size()));
                             g2.gotVSGarbageFromOtherPlayer(queuedVSGarbageAmountToSend);
@@ -254,7 +254,7 @@ public void update(int gameIndex, int numGames) {
                 }
             }
 
-            if (getRoom().multiplayer_SendGarbageTo == SendGarbageToRule.SEND_GARBAGE_TO_ALL_PLAYERS) {
+            if (getRoom().multiplayer_SendGarbageTo == 0) {
                 if (!isNetworkGame()) {
                     if (queuedVSGarbageAmountToSend > 0) {
                         for (GameLogic g2 : otherPlayers) {
@@ -274,7 +274,7 @@ public void update(int gameIndex, int numGames) {
                 }
             }
 
-            if (getRoom().multiplayer_SendGarbageTo == SendGarbageToRule.SEND_GARBAGE_TO_ALL_PLAYERS_50_PERCENT_CHANCE) {
+            if (getRoom().multiplayer_SendGarbageTo == 4) {
                 if (!isNetworkGame()) {
                     if (queuedVSGarbageAmountToSend > 0) {
                         for (GameLogic g2 : otherPlayers) {

src/main/java/com/bobsgame/puzzle/Grid.java

@@ -388,7 +388,7 @@ public ArrayList<Piece> getBagOfOneOfEachNonRandomNormalPieces() {
     }
     public PieceType getRandomPieceTypeFromArrayExcludingSpecialPieceTypes(ArrayList<PieceType> arr) {
         if (arr.isEmpty()) return null;
-        if (game.currentGameType.pieceRule_useBagRandomizer && !randomBag.isEmpty()) {
+        if (game.currentGameType.currentPieceRule_getNewPiecesRandomlyOutOfBagWithOneOfEachPieceUntilEmpty && !randomBag.isEmpty()) {
             PieceType b = randomBag.get(game.getRandomIntLessThan(randomBag.size(), "getRandomPieceTypeFromArrayExcludingSpecialPieceTypes"));
             randomBag.remove(b);
             return b;