chuk-puzzles-gym 0.10__tar.gz → 0.10.1__tar.gz

{chuk_puzzles_gym-0.10/src/chuk_puzzles_gym.egg-info → chuk_puzzles_gym-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chuk-puzzles-gym
-Version: 0.10
+Version: 0.10.1
 Summary: Multi-game puzzle gym for LLM training and benchmarking - 30 constraint puzzles with synthetic data generation
 Author: Chris Hay
 License: MIT

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "chuk-puzzles-gym"
-version = "0.10"
+version = "0.10.1"
 description = "Multi-game puzzle gym for LLM training and benchmarking - 30 constraint puzzles with synthetic data generation"
 readme = "README.md"
 requires-python = ">=3.11"

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/binary/game.py

@@ -358,6 +358,8 @@ class BinaryPuzzleGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         empty_cells = [(r, c) for r in range(self.size) for c in range(self.size) if self.grid[r][c] == -1]
         if not empty_cells:
             return None

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/bridges/game.py

@@ -415,6 +415,8 @@ class BridgesGame(PuzzleGame):
 
     async def get_hint(self) -> tuple[Any, str] | None:
         """Get a hint for the next move."""
+        if not self.can_use_hint():
+            return None
         # Find a bridge in the solution that's not yet placed correctly
         for bridge_key, solution_count in self.solution.items():
             current_count = self.bridges.get(bridge_key, 0)

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/cryptarithmetic/game.py

@@ -362,6 +362,11 @@ class CryptarithmeticGame(PuzzleGame):
 
         return "\n".join(lines)
 
+    def get_stats(self) -> str:
+        """Get current game statistics."""
+        assigned = sum(1 for v in self.player_mapping.values() if v is not None)
+        return f"Moves: {self.moves_made} | Assigned: {assigned}/{len(self.letters)} | Seed: {self.seed}"
+
     def get_rules(self) -> str:
         return (
             "CRYPTARITHMETIC\n"

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/einstein/game.py

@@ -281,6 +281,8 @@ class EinsteinGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None
         """
+        if not self.can_use_hint():
+            return None
         # Find first unassigned attribute in solution
         for i in range(self.num_houses):
             for attr in ATTRIBUTES:

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/fillomino/game.py

@@ -435,6 +435,8 @@ class FillominoGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         # Find an empty cell
         for r in range(self.size):
             for c in range(self.size):

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/futoshiki/game.py

@@ -288,6 +288,8 @@ class FutoshikiGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         empty_cells = [(r, c) for r in range(self.size) for c in range(self.size) if self.grid[r][c] == 0]
         if not empty_cells:
             return None

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/graph_coloring/commands.py

@@ -4,10 +4,14 @@ from typing import TYPE_CHECKING
 
 from ...models import GameCommand, MoveResult
 from .._base import CommandResult, GameCommandHandler
+from .game import COLOR_NAMES
 
 if TYPE_CHECKING:
     from .game import GraphColoringGame
 
+# Build a lookup from lowercase color name to color number
+_COLOR_NAME_TO_NUM = {name.lower(): i + 1 for i, name in enumerate(COLOR_NAMES)}
+
 
 class GraphColoringCommandHandler(GameCommandHandler):
     """Handles commands for Graph Coloring game."""
@@ -36,6 +40,16 @@ class GraphColoringCommandHandler(GameCommandHandler):
         else:
             return self.error_result(f"Unknown command: {cmd}")
 
+    def _parse_color(self, value: str) -> int | None:
+        """Parse a color argument as either an integer or a color name."""
+        # Try integer first
+        try:
+            return int(value)
+        except ValueError:
+            pass
+        # Try color name lookup
+        return _COLOR_NAME_TO_NUM.get(value.lower())
+
     async def _handle_place(self, args: list[str]) -> CommandResult:
         """Handle the PLACE command: place <node> <color>."""
         if len(args) != 2:
@@ -45,10 +59,13 @@ class GraphColoringCommandHandler(GameCommandHandler):
             )
 
         node = self.parse_int(args[0], "node")
-        color = self.parse_int(args[1], "color")
+        color = self._parse_color(args[1])
 
-        if node is None or color is None:
-            return self.error_result("Node and color must be integers.")
+        if node is None:
+            return self.error_result("Node must be an integer.")
+        if color is None:
+            valid = ", ".join(f"{i + 1}={COLOR_NAMES[i]}" for i in range(self.game.num_colors))
+            return self.error_result(f"Invalid color. Use a number or name: {valid}")
 
         result = await self.game.validate_move(node, color)
 

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/graph_coloring/game.py

@@ -289,6 +289,11 @@ class GraphColoringGame(PuzzleGame):
 
         return "\n".join(lines)
 
+    def get_stats(self) -> str:
+        """Get current game statistics."""
+        colored = sum(1 for n in range(1, self.num_nodes + 1) if self.coloring.get(n, 0) > 0)
+        return f"Moves: {self.moves_made} | Colored: {colored}/{self.num_nodes} | Edges: {len(self.edges)} | Seed: {self.seed}"
+
     def get_rules(self) -> str:
         return (
             f"GRAPH COLORING ({self.num_nodes} nodes, {self.num_colors} colors)\n"
@@ -298,9 +303,11 @@ class GraphColoringGame(PuzzleGame):
         )
 
     def get_commands(self) -> str:
+        color_map = ", ".join(f"{i + 1}={COLOR_NAMES[i]}" for i in range(self.num_colors))
         return (
             "Commands:\n"
-            f"  place <node> <color>  - Color a node (1-{self.num_colors})\n"
+            f"  place <node> <color>  - Color a node (number or name)\n"
+            f"  Colors: {color_map}\n"
             "  clear <node>          - Remove color from a node\n"
             "  hint                  - Get a hint\n"
             "  check                 - Check if solved\n"

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/hidato/game.py

@@ -302,6 +302,8 @@ class HidatoGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         # Find an empty cell
         empty_cells = [(r, c) for r in range(self.size) for c in range(self.size) if self.grid[r][c] == 0]
         if not empty_cells:

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/hitori/game.py

@@ -395,6 +395,8 @@ class HitoriGame(PuzzleGame):
 
     async def get_hint(self) -> tuple[Any, str] | None:
         """Get a hint for the next move."""
+        if not self.can_use_hint():
+            return None
         # Find a cell that should be shaded but isn't, or vice versa
         for r in range(self.size):
             for c in range(self.size):

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/kakuro/game.py

@@ -311,6 +311,8 @@ class KakuroGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         empty_cells = [
             (r, c)
             for r in range(self.size)

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/kenken/game.py

@@ -366,6 +366,8 @@ class KenKenGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         empty_cells = [(r, c) for r in range(self.size) for c in range(self.size) if self.grid[r][c] == 0]
         if not empty_cells:
             return None

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/killer_sudoku/game.py

@@ -395,6 +395,8 @@ class KillerSudokuGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         empty_cells = [(r, c) for r in range(9) for c in range(9) if self.grid[r][c] == 0]
         if not empty_cells:
             return None

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/knapsack/game.py

@@ -255,6 +255,8 @@ class KnapsackGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None
         """
+        if not self.can_use_hint():
+            return None
         # Suggest selecting an item that's in the optimal solution but not selected
         for i in range(len(self.items)):
             if self.optimal_selection[i] and not self.selection[i]:

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/lights_out/game.py

@@ -173,6 +173,8 @@ class LightsOutGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         # Find a cell in the solution that should be pressed
         for row in range(self.size):
             for col in range(self.size):

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/logic_grid/game.py

@@ -235,6 +235,8 @@ class LogicGridGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         # Find a connection that hasn't been marked
         for person in self.categories.person:
             attrs = self.solution[person]

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/mastermind/game.py

@@ -211,6 +211,8 @@ class MastermindGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if no hints available
         """
+        if not self.can_use_hint():
+            return None
         if self.is_complete():
             return None
 

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/minesweeper/game.py

@@ -310,6 +310,8 @@ class MinesweeperGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None
         """
+        if not self.can_use_hint():
+            return None
         if self.game_over:
             return None
 

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/nonogram/game.py

@@ -192,6 +192,8 @@ class NonogramGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         unknown_cells = [(r, c) for r in range(self.size) for c in range(self.size) if self.grid[r][c] == -1]
         if not unknown_cells:
             return None

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/nqueens/game.py

@@ -296,6 +296,11 @@ class NQueensGame(PuzzleGame):
 
         return "\n".join(lines)
 
+    def get_stats(self) -> str:
+        """Get current game statistics."""
+        placed = sum(1 for r in range(self.size) for c in range(self.size) if self.grid[r][c] == 1)
+        return f"Moves: {self.moves_made} | Queens: {placed}/{self.size} | Board: {self.size}x{self.size} | Seed: {self.seed}"
+
     def get_rules(self) -> str:
         return (
             f"N-QUEENS ({self.size}x{self.size})\n"

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/numberlink/game.py

@@ -317,6 +317,12 @@ class NumberlinkGame(PuzzleGame):
 
         return "\n".join(lines)
 
+    def get_stats(self) -> str:
+        """Get current game statistics."""
+        filled = sum(1 for r in range(self.size) for c in range(self.size) if self.grid[r][c] != 0)
+        total = self.size * self.size
+        return f"Moves: {self.moves_made} | Filled: {filled}/{total} | Pairs: {self.num_pairs} | Seed: {self.seed}"
+
     def get_rules(self) -> str:
         return (
             f"NUMBERLINK ({self.size}x{self.size}, {self.num_pairs} pairs)\n"

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/nurikabe/game.py

@@ -479,6 +479,8 @@ class NurikabeGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None
         """
+        if not self.can_use_hint():
+            return None
         # Find a cell that differs from solution
         for row in range(self.size):
             for col in range(self.size):

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/rush_hour/game.py

@@ -454,6 +454,10 @@ class RushHourGame(PuzzleGame):
 
         return "\n".join(lines)
 
+    def get_stats(self) -> str:
+        """Get current game statistics."""
+        return f"Moves: {self.moves_made} | Vehicles: {len(self.vehicles)} | Grid: {self.size}x{self.size} | Seed: {self.seed}"
+
     def get_rules(self) -> str:
         return (
             f"RUSH HOUR ({self.size}x{self.size})\n"

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/scheduler/game.py

@@ -316,6 +316,8 @@ class SchedulerGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None
         """
+        if not self.can_use_hint():
+            return None
         # Find an unscheduled task that's in the optimal solution
         for task_id in range(self.num_tasks):
             if task_id not in self.schedule and task_id in self.optimal_schedule:

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/shikaku/game.py

@@ -327,6 +327,8 @@ class ShikakuGame(PuzzleGame):
 
     async def get_hint(self) -> tuple[Any, str] | None:
         """Get a hint for the next move."""
+        if not self.can_use_hint():
+            return None
         # Find a rectangle from the solution that hasn't been placed yet
         solution_rects: dict[int, list[tuple[int, int]]] = {}
         for r in range(self.size):

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/skyscrapers/game.py

@@ -255,6 +255,11 @@ class SkyscrapersGame(PuzzleGame):
 
         return "\n".join(lines)
 
+    def get_stats(self) -> str:
+        """Get current game statistics."""
+        empty = sum(1 for r in range(self.size) for c in range(self.size) if self.grid[r][c] == 0)
+        return f"Moves: {self.moves_made} | Empty cells: {empty} | Grid: {self.size}x{self.size} | Seed: {self.seed}"
+
     def get_rules(self) -> str:
         return (
             f"SKYSCRAPERS ({self.size}x{self.size})\n"

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/slitherlink/game.py

@@ -272,6 +272,8 @@ class SlitherlinkGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None
         """
+        if not self.can_use_hint():
+            return None
         # Find an edge that's in the solution but not set by player
         for row in range(self.size + 1):
             for col in range(self.size):

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/sokoban/game.py

@@ -499,6 +499,8 @@ class SokobanGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None
         """
+        if not self.can_use_hint():
+            return None
         if self.is_complete():
             return None
 

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/star_battle/game.py

@@ -301,6 +301,8 @@ class StarBattleGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         # Find a star location from solution that hasn't been placed
         for r in range(self.size):
             for c in range(self.size):

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/sudoku/game.py

@@ -249,6 +249,8 @@ class SudokuGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         empty_cells = [(r, c) for r in range(9) for c in range(9) if self.grid[r][c] == 0]
         if not empty_cells:
             return None

{chuk_puzzles_gym-0.10 → chuk_puzzles_gym-0.10.1}/src/chuk_puzzles_gym/games/tents/game.py

@@ -326,6 +326,8 @@ class TentsGame(PuzzleGame):
         Returns:
             Tuple of (hint_data, hint_message) or None if puzzle is complete
         """
+        if not self.can_use_hint():
+            return None
         # Find a tent location from solution that hasn't been placed
         for r in range(self.size):
             for c in range(self.size):