haive.games.go.state_manager

Go game state management module.

This module provides comprehensive state management functionality for the ancient strategy game of Go (also known as Weiqi or Baduk), including move validation, stone capture mechanics, and game progression tracking.

Go is an abstract strategy board game for two players in which the aim is to surround more territory than the opponent. The game is played on a 19×19 grid (though 13×13 and 9×9 are common variants) where players alternate placing black and white stones. Players capture opponents’ stones by completely surrounding them.

Classes:

GoGameStateManager: Main state management class for Go game operations.

Example

Basic Go game setup and play:

>>> from haive.games.go.state_manager import GoGameStateManager
>>> from haive.games.go.models import GoMove
>>>
>>> # Initialize standard 19×19 Go game
>>> state = GoGameStateManager.initialize(board_size=19)
>>> print(f"Board size: {state.board_size}×{state.board_size}")
>>> print(f"Current player: {state.turn}")  # "black"
>>>
>>> # Make a move (place stone at coordinates)
>>> move_coords = (3, 4)  # (row, col)
>>> new_state = GoGameStateManager.apply_move(state, move_coords)
>>> print(f"Stone placed at {move_coords}")
>>>
>>> # Pass turn (no stone placed)
>>> pass_state = GoGameStateManager.apply_move(new_state, None)
>>> print(f"Pass count: {pass_state.passes}")

Note

• Standard board sizes: 19×19 (professional), 13×13, 9×9 (beginners)

• Players are “black” and “white” with black moving first

• Coordinates are (row, col) tuples using 0-based indexing

• Pass moves are represented as None coordinates

• Game ends when both players pass consecutively

• Stone capture follows the rule of liberty (breathing spaces)

• Uses Sente library for Go game logic and SGF format

Classes

GoGameStateManager

Manager class for Go game state operations.

Module Contents

class haive.games.go.state_manager.GoGameStateManager

Manager class for Go game state operations.

This class provides static methods for initializing and modifying Go game states, including:

• Game initialization

• Move application and validation

• Pass move handling

• Game end detection

Example

>>> # Initialize a new game
>>> state = GoGameStateManager.initialize(board_size=19)
>>>
>>> # Apply a move
>>> new_state = GoGameStateManager.apply_move(state, (3, 4))
>>> print(new_state.turn)  # 'white'

static apply_move(state, move)

Apply a move to the current game state.

This method handles:

• Move validation and application

• Pass moves (when move is None)

• Capture counting

• Turn alternation

• Game end detection

Parameters:

• state (GoGameState) – Current game state.

• move (Optional[Tuple[int, int]]) – Move coordinates or None for pass.

Returns:

New game state after applying the move.

Return type:

GoGameState

Example

>>> state = GoGameStateManager.initialize()
>>> # Play a move at (3, 4)
>>> new_state = GoGameStateManager.apply_move(state, (3, 4))
>>> print(new_state.turn)  # 'white'
>>>
>>> # Pass move
>>> pass_state = GoGameStateManager.apply_move(new_state, None)
>>> print(pass_state.passes)  # 1

static initialize(board_size=19)

Initialize a new Go game state.

Parameters:

board_size (int) – Size of the board (default: 19).

Returns:

Initial game state.

Return type:

GoGameState

Example

>>> state = GoGameStateManager.initialize(board_size=13)
>>> print(state.board_size)  # 13
>>> print(state.turn)  # 'black'