adding pots

.github/copilot-instructions.md

@@ -1,98 +0,0 @@
-# PyCatan AI - Development Instructions
-
-## 🎯 Project Status
-
-**The Game is Ready and Tested!** 
-
-The project contains a complete and tested implementation of The Settlers of Catan game in Python, including:
-- ✅ Complete game logic and rules
-- ✅ GameManager that coordinates turns and gameplay
-- ✅ Built-in Actions system
-- ✅ Tested and working human user
-- ✅ Display systems (Console + Web)
-- ✅ Extensive integration and unit tests
-
-## 🚀 New Focus: Building an AI Agent
-
-**From now on, the project moves to the next phase:**
-
-Building an LLM-based AI agent that can play the game autonomously.
-
-### 🎮 How Will the Agent Play?
-The agent will interact with the game using the **existing Actions system** - the same actions a human user performs:
-- Building settlements and cities
-- Building roads
-- Trading with other players
-- Using development cards
-- Making strategic decisions
-
-### 📋 Agent Development Stages
-
-1. **Agent Architecture** (current stage)
-   - Planning the overall structure
-   - Defining interfaces
-   - Integration with GameManager
-
-2. **Basic Agent**
-   - Implementing basic actions
-   - Receiving game state
-   - Returning simple decisions
-
-3. **Strategy Improvement**
-   - Adding strategic thinking
-   - Planning ahead
-   - Learning from mistakes
-
-## 📚 Relevant Documents
-
-### Architecture and Structure
-- **[AI_ARCHITECTURE.md](instructions/AI_ARCHITECTURE.md)** - Agent architecture and integration (new!)
-- **[MODULAR_ORGANIZATION.md](../docs/MODULAR_ORGANIZATION.md)** - Modular project structure
-- **[REORGANIZATION.md](../docs/REORGANIZATION.md)** - Documentation of project reorganization
-
-### Code and Examples
-- **[README.md](../readme.md)** - Main documentation, usage examples
-- **[examples/](../examples/)** - Code examples and scripts
-- **[tests/](../tests/)** - Integration and unit tests
-
-### Blog and Post Series
-- **[docs/blog/](../docs/blog/)** - Series of posts about project development
-
-## 🏗️ Project Structure (Summary)
-
-```
-pycatan/
-├── core/              # Pure game logic
-│   ├── game.py
-│   ├── board.py
-│   ├── player.py
-│   └── ...
-├── management/        # Coordination and game manager
-│   ├── game_manager.py
-│   ├── actions.py
-│   └── log_events.py
-├── players/           # Player implementations
-│   ├── user.py        # Base class
-│   ├── human_user.py  # Human user ✅
-│   └── ai_agent.py    # AI agent (under construction)
-├── visualizations/    # Display interfaces
-└── config/            # Settings and mappings
-```
-
-## 💡 Working Principles
-
-1. **The game is stable** - Don't change core/ and management/ unless truly necessary
-2. **Use the Actions system** - All interactions go through Actions
-3. **Document thoroughly** - The project is well-documented, maintain the standard
-4. **Tests** - Write tests for every new feature
-5. **Modularity** - Maintain clear separation between modules
-
-## 🎯 Current Goal
-
-**Create an initial AI agent that can:**
-- Receive game state
-- Choose a legal action
-- Execute it through GameManager
-- Document the process
-
-See [AI_ARCHITECTURE.md](instructions/AI_ARCHITECTURE.md) for full details.

examples/ai_testing/my_games/current_state.json

@@ -0,0 +1,885 @@
+{
+  "timestamp": "2025-12-26T16:21:38.408731",
+  "state_number": 1,
+  "state": {
+    "hexes": [
+      {
+        "id": 1,
+        "type": "wood",
+        "number": 12,
+        "has_robber": false
+      },
+      {
+        "id": 2,
+        "type": "sheep",
+        "number": 5,
+        "has_robber": false
+      },
+      {
+        "id": 3,
+        "type": "wood",
+        "number": 4,
+        "has_robber": false
+      },
+      {
+        "id": 4,
+        "type": "sheep",
+        "number": 8,
+        "has_robber": false
+      },
+      {
+        "id": 5,
+        "type": "brick",
+        "number": 6,
+        "has_robber": false
+      },
+      {
+        "id": 6,
+        "type": "wood",
+        "number": 3,
+        "has_robber": false
+      },
+      {
+        "id": 7,
+        "type": "wheat",
+        "number": 8,
+        "has_robber": false
+      },
+      {
+        "id": 8,
+        "type": "brick",
+        "number": 10,
+        "has_robber": false
+      },
+      {
+        "id": 9,
+        "type": "wood",
+        "number": 11,
+        "has_robber": false
+      },
+      {
+        "id": 10,
+        "type": "desert",
+        "number": null,
+        "has_robber": true
+      },
+      {
+        "id": 11,
+        "type": "ore",
+        "number": 3,
+        "has_robber": false
+      },
+      {
+        "id": 12,
+        "type": "sheep",
+        "number": 4,
+        "has_robber": false
+      },
+      {
+        "id": 13,
+        "type": "brick",
+        "number": 10,
+        "has_robber": false
+      },
+      {
+        "id": 14,
+        "type": "wheat",
+        "number": 9,
+        "has_robber": false
+      },
+      {
+        "id": 15,
+        "type": "wheat",
+        "number": 6,
+        "has_robber": false
+      },
+      {
+        "id": 16,
+        "type": "sheep",
+        "number": 11,
+        "has_robber": false
+      },
+      {
+        "id": 17,
+        "type": "ore",
+        "number": 5,
+        "has_robber": false
+      },
+      {
+        "id": 18,
+        "type": "wheat",
+        "number": 9,
+        "has_robber": false
+      },
+      {
+        "id": 19,
+        "type": "ore",
+        "number": 2,
+        "has_robber": false
+      }
+    ],
+    "settlements": [],
+    "cities": [],
+    "roads": [],
+    "harbors": [
+      {
+        "id": 1,
+        "type": "any",
+        "ratio": 3,
+        "point_one": 9,
+        "point_two": 8
+      },
+      {
+        "id": 2,
+        "type": "sheep",
+        "ratio": 2,
+        "point_one": 17,
+        "point_two": 28
+      },
+      {
+        "id": 3,
+        "type": "wood",
+        "ratio": 2,
+        "point_one": 40,
+        "point_two": 48
+      },
+      {
+        "id": 4,
+        "type": "any",
+        "ratio": 3,
+        "point_one": 50,
+        "point_two": 51
+      },
+      {
+        "id": 5,
+        "type": "any",
+        "ratio": 3,
+        "point_one": 53,
+        "point_two": 54
+      },
+      {
+        "id": 6,
+        "type": "any",
+        "ratio": 3,
+        "point_one": 37,
+        "point_two": 38
+      },
+      {
+        "id": 7,
+        "type": "ore",
+        "ratio": 2,
+        "point_one": 26,
+        "point_two": 16
+      },
+      {
+        "id": 8,
+        "type": "brick",
+        "ratio": 2,
+        "point_one": 7,
+        "point_two": 6
+      },
+      {
+        "id": 9,
+        "type": "wheat",
+        "ratio": 2,
+        "point_one": 3,
+        "point_two": 2
+      }
+    ],
+    "players": [
+      {
+        "id": 0,
+        "name": "a",
+        "victory_points": 0,
+        "total_cards": 0,
+        "cards_list": [],
+        "dev_cards_list": [],
+        "settlements": 0,
+        "cities": 0,
+        "roads": 0,
+        "longest_road": 0,
+        "has_longest_road": false,
+        "knights": 0,
+        "knights_played": 0,
+        "has_largest_army": false
+      },
+      {
+        "id": 1,
+        "name": "b",
+        "victory_points": 0,
+        "total_cards": 0,
+        "cards_list": [],
+        "dev_cards_list": [],
+        "settlements": 0,
+        "cities": 0,
+        "roads": 0,
+        "longest_road": 0,
+        "has_longest_road": false,
+        "knights": 0,
+        "knights_played": 0,
+        "has_largest_army": false
+      },
+      {
+        "id": 2,
+        "name": "c",
+        "victory_points": 0,
+        "total_cards": 0,
+        "cards_list": [],
+        "dev_cards_list": [],
+        "settlements": 0,
+        "cities": 0,
+        "roads": 0,
+        "longest_road": 0,
+        "has_longest_road": false,
+        "knights": 0,
+        "knights_played": 0,
+        "has_largest_army": false
+      }
+    ],
+    "current_player": 0,
+    "current_phase": "SETUP_FIRST_ROUND",
+    "robber_position": [
+      2,
+      2
+    ],
+    "dice_result": null,
+    "points": [
+      {
+        "point_id": 1,
+        "adjacent_points": [
+          2,
+          9
+        ],
+        "adjacent_hexes": [
+          1
+        ]
+      },
+      {
+        "point_id": 2,
+        "adjacent_points": [
+          1,
+          3
+        ],
+        "adjacent_hexes": [
+          1
+        ]
+      },
+      {
+        "point_id": 3,
+        "adjacent_points": [
+          2,
+          4,
+          11
+        ],
+        "adjacent_hexes": [
+          2,
+          1
+        ]
+      },
+      {
+        "point_id": 4,
+        "adjacent_points": [
+          3,
+          5
+        ],
+        "adjacent_hexes": [
+          2
+        ]
+      },
+      {
+        "point_id": 5,
+        "adjacent_points": [
+          4,
+          6,
+          13
+        ],
+        "adjacent_hexes": [
+          3,
+          2
+        ]
+      },
+      {
+        "point_id": 6,
+        "adjacent_points": [
+          5,
+          7
+        ],
+        "adjacent_hexes": [
+          3
+        ]
+      },
+      {
+        "point_id": 7,
+        "adjacent_points": [
+          6,
+          15
+        ],
+        "adjacent_hexes": [
+          3
+        ]
+      },
+      {
+        "point_id": 8,
+        "adjacent_points": [
+          9,
+          18
+        ],
+        "adjacent_hexes": [
+          4
+        ]
+      },
+      {
+        "point_id": 9,
+        "adjacent_points": [
+          8,
+          10,
+          1
+        ],
+        "adjacent_hexes": [
+          4,
+          1
+        ]
+      },
+      {
+        "point_id": 10,
+        "adjacent_points": [
+          9,
+          11,
+          20
+        ],
+        "adjacent_hexes": [
+          5,
+          4,
+          1
+        ]
+      },
+      {
+        "point_id": 11,
+        "adjacent_points": [
+          10,
+          12,
+          3
+        ],
+        "adjacent_hexes": [
+          5,
+          2,
+          1
+        ]
+      },
+      {
+        "point_id": 12,
+        "adjacent_points": [
+          11,
+          13,
+          22
+        ],
+        "adjacent_hexes": [
+          6,
+          5,
+          2
+        ]
+      },
+      {
+        "point_id": 13,
+        "adjacent_points": [
+          12,
+          14,
+          5
+        ],
+        "adjacent_hexes": [
+          6,
+          3,
+          2
+        ]
+      },
+      {
+        "point_id": 14,
+        "adjacent_points": [
+          13,
+          15,
+          24
+        ],
+        "adjacent_hexes": [
+          7,
+          6,
+          3
+        ]
+      },
+      {
+        "point_id": 15,
+        "adjacent_points": [
+          14,
+          16,
+          7
+        ],
+        "adjacent_hexes": [
+          7,
+          3
+        ]
+      },
+      {
+        "point_id": 16,
+        "adjacent_points": [
+          15,
+          26
+        ],
+        "adjacent_hexes": [
+          7
+        ]
+      },
+      {
+        "point_id": 17,
+        "adjacent_points": [
+          18,
+          28
+        ],
+        "adjacent_hexes": [
+          8
+        ]
+      },
+      {
+        "point_id": 18,
+        "adjacent_points": [
+          17,
+          19,
+          8
+        ],
+        "adjacent_hexes": [
+          8,
+          4
+        ]
+      },
+      {
+        "point_id": 19,
+        "adjacent_points": [
+          18,
+          20,
+          30
+        ],
+        "adjacent_hexes": [
+          9,
+          8,
+          4
+        ]
+      },
+      {
+        "point_id": 20,
+        "adjacent_points": [
+          19,
+          21,
+          10
+        ],
+        "adjacent_hexes": [
+          9,
+          5,
+          4
+        ]
+      },
+      {
+        "point_id": 21,
+        "adjacent_points": [
+          20,
+          22,
+          32
+        ],
+        "adjacent_hexes": [
+          10,
+          9,
+          5
+        ]
+      },
+      {
+        "point_id": 22,
+        "adjacent_points": [
+          21,
+          23,
+          12
+        ],
+        "adjacent_hexes": [
+          10,
+          6,
+          5
+        ]
+      },
+      {
+        "point_id": 23,
+        "adjacent_points": [
+          22,
+          24,
+          34
+        ],
+        "adjacent_hexes": [
+          11,
+          10,
+          6
+        ]
+      },
+      {
+        "point_id": 24,
+        "adjacent_points": [
+          23,
+          25,
+          14
+        ],
+        "adjacent_hexes": [
+          11,
+          7,
+          6
+        ]
+      },
+      {
+        "point_id": 25,
+        "adjacent_points": [
+          24,
+          26,
+          36
+        ],
+        "adjacent_hexes": [
+          12,
+          11,
+          7
+        ]
+      },
+      {
+        "point_id": 26,
+        "adjacent_points": [
+          25,
+          27,
+          16
+        ],
+        "adjacent_hexes": [
+          12,
+          7
+        ]
+      },
+      {
+        "point_id": 27,
+        "adjacent_points": [
+          26,
+          38
+        ],
+        "adjacent_hexes": [
+          12
+        ]
+      },
+      {
+        "point_id": 28,
+        "adjacent_points": [
+          29,
+          17
+        ],
+        "adjacent_hexes": [
+          8
+        ]
+      },
+      {
+        "point_id": 29,
+        "adjacent_points": [
+          28,
+          30,
+          39
+        ],
+        "adjacent_hexes": [
+          13,
+          8
+        ]
+      },
+      {
+        "point_id": 30,
+        "adjacent_points": [
+          29,
+          31,
+          19
+        ],
+        "adjacent_hexes": [
+          13,
+          9,
+          8
+        ]
+      },
+      {
+        "point_id": 31,
+        "adjacent_points": [
+          30,
+          32,
+          41
+        ],
+        "adjacent_hexes": [
+          14,
+          13,
+          9
+        ]
+      },
+      {
+        "point_id": 32,
+        "adjacent_points": [
+          31,
+          33,
+          21
+        ],
+        "adjacent_hexes": [
+          14,
+          10,
+          9
+        ]
+      },
+      {
+        "point_id": 33,
+        "adjacent_points": [
+          32,
+          34,
+          43
+        ],
+        "adjacent_hexes": [
+          15,
+          14,
+          10
+        ]
+      },
+      {
+        "point_id": 34,
+        "adjacent_points": [
+          33,
+          35,
+          23
+        ],
+        "adjacent_hexes": [
+          15,
+          11,
+          10
+        ]
+      },
+      {
+        "point_id": 35,
+        "adjacent_points": [
+          34,
+          36,
+          45
+        ],
+        "adjacent_hexes": [
+          16,
+          15,
+          11
+        ]
+      },
+      {
+        "point_id": 36,
+        "adjacent_points": [
+          35,
+          37,
+          25
+        ],
+        "adjacent_hexes": [
+          16,
+          12,
+          11
+        ]
+      },
+      {
+        "point_id": 37,
+        "adjacent_points": [
+          36,
+          38,
+          47
+        ],
+        "adjacent_hexes": [
+          16,
+          12
+        ]
+      },
+      {
+        "point_id": 38,
+        "adjacent_points": [
+          37,
+          27
+        ],
+        "adjacent_hexes": [
+          12
+        ]
+      },
+      {
+        "point_id": 39,
+        "adjacent_points": [
+          40,
+          29
+        ],
+        "adjacent_hexes": [
+          13
+        ]
+      },
+      {
+        "point_id": 40,
+        "adjacent_points": [
+          39,
+          41,
+          48
+        ],
+        "adjacent_hexes": [
+          17,
+          13
+        ]
+      },
+      {
+        "point_id": 41,
+        "adjacent_points": [
+          40,
+          42,
+          31
+        ],
+        "adjacent_hexes": [
+          17,
+          14,
+          13
+        ]
+      },
+      {
+        "point_id": 42,
+        "adjacent_points": [
+          41,
+          43,
+          50
+        ],
+        "adjacent_hexes": [
+          18,
+          17,
+          14
+        ]
+      },
+      {
+        "point_id": 43,
+        "adjacent_points": [
+          42,
+          44,
+          33
+        ],
+        "adjacent_hexes": [
+          18,
+          15,
+          14
+        ]
+      },
+      {
+        "point_id": 44,
+        "adjacent_points": [
+          43,
+          45,
+          52
+        ],
+        "adjacent_hexes": [
+          19,
+          18,
+          15
+        ]
+      },
+      {
+        "point_id": 45,
+        "adjacent_points": [
+          44,
+          46,
+          35
+        ],
+        "adjacent_hexes": [
+          19,
+          16,
+          15
+        ]
+      },
+      {
+        "point_id": 46,
+        "adjacent_points": [
+          45,
+          47,
+          54
+        ],
+        "adjacent_hexes": [
+          19,
+          16
+        ]
+      },
+      {
+        "point_id": 47,
+        "adjacent_points": [
+          46,
+          37
+        ],
+        "adjacent_hexes": [
+          16
+        ]
+      },
+      {
+        "point_id": 48,
+        "adjacent_points": [
+          49,
+          40
+        ],
+        "adjacent_hexes": [
+          17
+        ]
+      },
+      {
+        "point_id": 49,
+        "adjacent_points": [
+          48,
+          50
+        ],
+        "adjacent_hexes": [
+          17
+        ]
+      },
+      {
+        "point_id": 50,
+        "adjacent_points": [
+          49,
+          51,
+          42
+        ],
+        "adjacent_hexes": [
+          18,
+          17
+        ]
+      },
+      {
+        "point_id": 51,
+        "adjacent_points": [
+          50,
+          52
+        ],
+        "adjacent_hexes": [
+          18
+        ]
+      },
+      {
+        "point_id": 52,
+        "adjacent_points": [
+          51,
+          53,
+          44
+        ],
+        "adjacent_hexes": [
+          19,
+          18
+        ]
+      },
+      {
+        "point_id": 53,
+        "adjacent_points": [
+          52,
+          54
+        ],
+        "adjacent_hexes": [
+          19
+        ]
+      },
+      {
+        "point_id": 54,
+        "adjacent_points": [
+          53,
+          46
+        ],
+        "adjacent_hexes": [
+          19
+        ]
+      }
+    ]
+  }
+}

examples/ai_testing/my_games/game_20251226_143530_final.json

@@ -1,816 +0,0 @@
-{
-  "hexes": [
-    {
-      "id": 1,
-      "type": "wood",
-      "number": 12,
-      "has_robber": false
-    },
-    {
-      "id": 2,
-      "type": "sheep",
-      "number": 5,
-      "has_robber": false
-    },
-    {
-      "id": 3,
-      "type": "wood",
-      "number": 4,
-      "has_robber": false
-    },
-    {
-      "id": 4,
-      "type": "sheep",
-      "number": 8,
-      "has_robber": false
-    },
-    {
-      "id": 5,
-      "type": "brick",
-      "number": 6,
-      "has_robber": false
-    },
-    {
-      "id": 6,
-      "type": "wood",
-      "number": 3,
-      "has_robber": false
-    },
-    {
-      "id": 7,
-      "type": "wheat",
-      "number": 8,
-      "has_robber": false
-    },
-    {
-      "id": 8,
-      "type": "brick",
-      "number": 10,
-      "has_robber": false
-    },
-    {
-      "id": 9,
-      "type": "wood",
-      "number": 11,
-      "has_robber": false
-    },
-    {
-      "id": 10,
-      "type": "desert",
-      "number": null,
-      "has_robber": true
-    },
-    {
-      "id": 11,
-      "type": "ore",
-      "number": 3,
-      "has_robber": false
-    },
-    {
-      "id": 12,
-      "type": "sheep",
-      "number": 4,
-      "has_robber": false
-    },
-    {
-      "id": 13,
-      "type": "brick",
-      "number": 10,
-      "has_robber": false
-    },
-    {
-      "id": 14,
-      "type": "wheat",
-      "number": 9,
-      "has_robber": false
-    },
-    {
-      "id": 15,
-      "type": "wheat",
-      "number": 6,
-      "has_robber": false
-    },
-    {
-      "id": 16,
-      "type": "sheep",
-      "number": 11,
-      "has_robber": false
-    },
-    {
-      "id": 17,
-      "type": "ore",
-      "number": 5,
-      "has_robber": false
-    },
-    {
-      "id": 18,
-      "type": "wheat",
-      "number": 9,
-      "has_robber": false
-    },
-    {
-      "id": 19,
-      "type": "ore",
-      "number": 2,
-      "has_robber": false
-    }
-  ],
-  "settlements": [],
-  "cities": [],
-  "roads": [],
-  "players": [
-    {
-      "id": 0,
-      "name": "ש",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
-      "dev_cards_list": [],
-      "settlements": 0,
-      "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
-      "has_longest_road": false,
-      "knights": 0,
-      "knights_played": 0,
-      "has_largest_army": false
-    },
-    {
-      "id": 1,
-      "name": "ה",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
-      "dev_cards_list": [],
-      "settlements": 0,
-      "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
-      "has_longest_road": false,
-      "knights": 0,
-      "knights_played": 0,
-      "has_largest_army": false
-    },
-    {
-      "id": 2,
-      "name": "ב",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
-      "dev_cards_list": [],
-      "settlements": 0,
-      "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
-      "has_longest_road": false,
-      "knights": 0,
-      "knights_played": 0,
-      "has_largest_army": false
-    }
-  ],
-  "current_player": 0,
-  "current_phase": "SETUP_FIRST_ROUND",
-  "robber_position": [
-    2,
-    2
-  ],
-  "dice_result": null,
-  "points": [
-    {
-      "point_id": 1,
-      "adjacent_points": [
-        2,
-        9
-      ],
-      "adjacent_hexes": [
-        1
-      ]
-    },
-    {
-      "point_id": 2,
-      "adjacent_points": [
-        1,
-        3
-      ],
-      "adjacent_hexes": [
-        1
-      ]
-    },
-    {
-      "point_id": 3,
-      "adjacent_points": [
-        2,
-        4,
-        11
-      ],
-      "adjacent_hexes": [
-        2,
-        1
-      ]
-    },
-    {
-      "point_id": 4,
-      "adjacent_points": [
-        3,
-        5
-      ],
-      "adjacent_hexes": [
-        2
-      ]
-    },
-    {
-      "point_id": 5,
-      "adjacent_points": [
-        4,
-        6,
-        13
-      ],
-      "adjacent_hexes": [
-        3,
-        2
-      ]
-    },
-    {
-      "point_id": 6,
-      "adjacent_points": [
-        5,
-        7
-      ],
-      "adjacent_hexes": [
-        3
-      ]
-    },
-    {
-      "point_id": 7,
-      "adjacent_points": [
-        6,
-        15
-      ],
-      "adjacent_hexes": [
-        3
-      ]
-    },
-    {
-      "point_id": 8,
-      "adjacent_points": [
-        9,
-        18
-      ],
-      "adjacent_hexes": [
-        4
-      ]
-    },
-    {
-      "point_id": 9,
-      "adjacent_points": [
-        8,
-        10,
-        1
-      ],
-      "adjacent_hexes": [
-        4,
-        1
-      ]
-    },
-    {
-      "point_id": 10,
-      "adjacent_points": [
-        9,
-        11,
-        20
-      ],
-      "adjacent_hexes": [
-        5,
-        4,
-        1
-      ]
-    },
-    {
-      "point_id": 11,
-      "adjacent_points": [
-        10,
-        12,
-        3
-      ],
-      "adjacent_hexes": [
-        5,
-        2,
-        1
-      ]
-    },
-    {
-      "point_id": 12,
-      "adjacent_points": [
-        11,
-        13,
-        22
-      ],
-      "adjacent_hexes": [
-        6,
-        5,
-        2
-      ]
-    },
-    {
-      "point_id": 13,
-      "adjacent_points": [
-        12,
-        14,
-        5
-      ],
-      "adjacent_hexes": [
-        6,
-        3,
-        2
-      ]
-    },
-    {
-      "point_id": 14,
-      "adjacent_points": [
-        13,
-        15,
-        24
-      ],
-      "adjacent_hexes": [
-        7,
-        6,
-        3
-      ]
-    },
-    {
-      "point_id": 15,
-      "adjacent_points": [
-        14,
-        16,
-        7
-      ],
-      "adjacent_hexes": [
-        7,
-        3
-      ]
-    },
-    {
-      "point_id": 16,
-      "adjacent_points": [
-        15,
-        26
-      ],
-      "adjacent_hexes": [
-        7
-      ]
-    },
-    {
-      "point_id": 17,
-      "adjacent_points": [
-        18,
-        28
-      ],
-      "adjacent_hexes": [
-        8
-      ]
-    },
-    {
-      "point_id": 18,
-      "adjacent_points": [
-        17,
-        19,
-        8
-      ],
-      "adjacent_hexes": [
-        8,
-        4
-      ]
-    },
-    {
-      "point_id": 19,
-      "adjacent_points": [
-        18,
-        20,
-        30
-      ],
-      "adjacent_hexes": [
-        9,
-        8,
-        4
-      ]
-    },
-    {
-      "point_id": 20,
-      "adjacent_points": [
-        19,
-        21,
-        10
-      ],
-      "adjacent_hexes": [
-        9,
-        5,
-        4
-      ]
-    },
-    {
-      "point_id": 21,
-      "adjacent_points": [
-        20,
-        22,
-        32
-      ],
-      "adjacent_hexes": [
-        10,
-        9,
-        5
-      ]
-    },
-    {
-      "point_id": 22,
-      "adjacent_points": [
-        21,
-        23,
-        12
-      ],
-      "adjacent_hexes": [
-        10,
-        6,
-        5
-      ]
-    },
-    {
-      "point_id": 23,
-      "adjacent_points": [
-        22,
-        24,
-        34
-      ],
-      "adjacent_hexes": [
-        11,
-        10,
-        6
-      ]
-    },
-    {
-      "point_id": 24,
-      "adjacent_points": [
-        23,
-        25,
-        14
-      ],
-      "adjacent_hexes": [
-        11,
-        7,
-        6
-      ]
-    },
-    {
-      "point_id": 25,
-      "adjacent_points": [
-        24,
-        26,
-        36
-      ],
-      "adjacent_hexes": [
-        12,
-        11,
-        7
-      ]
-    },
-    {
-      "point_id": 26,
-      "adjacent_points": [
-        25,
-        27,
-        16
-      ],
-      "adjacent_hexes": [
-        12,
-        7
-      ]
-    },
-    {
-      "point_id": 27,
-      "adjacent_points": [
-        26,
-        38
-      ],
-      "adjacent_hexes": [
-        12
-      ]
-    },
-    {
-      "point_id": 28,
-      "adjacent_points": [
-        29,
-        17
-      ],
-      "adjacent_hexes": [
-        8
-      ]
-    },
-    {
-      "point_id": 29,
-      "adjacent_points": [
-        28,
-        30,
-        39
-      ],
-      "adjacent_hexes": [
-        13,
-        8
-      ]
-    },
-    {
-      "point_id": 30,
-      "adjacent_points": [
-        29,
-        31,
-        19
-      ],
-      "adjacent_hexes": [
-        13,
-        9,
-        8
-      ]
-    },
-    {
-      "point_id": 31,
-      "adjacent_points": [
-        30,
-        32,
-        41
-      ],
-      "adjacent_hexes": [
-        14,
-        13,
-        9
-      ]
-    },
-    {
-      "point_id": 32,
-      "adjacent_points": [
-        31,
-        33,
-        21
-      ],
-      "adjacent_hexes": [
-        14,
-        10,
-        9
-      ]
-    },
-    {
-      "point_id": 33,
-      "adjacent_points": [
-        32,
-        34,
-        43
-      ],
-      "adjacent_hexes": [
-        15,
-        14,
-        10
-      ]
-    },
-    {
-      "point_id": 34,
-      "adjacent_points": [
-        33,
-        35,
-        23
-      ],
-      "adjacent_hexes": [
-        15,
-        11,
-        10
-      ]
-    },
-    {
-      "point_id": 35,
-      "adjacent_points": [
-        34,
-        36,
-        45
-      ],
-      "adjacent_hexes": [
-        16,
-        15,
-        11
-      ]
-    },
-    {
-      "point_id": 36,
-      "adjacent_points": [
-        35,
-        37,
-        25
-      ],
-      "adjacent_hexes": [
-        16,
-        12,
-        11
-      ]
-    },
-    {
-      "point_id": 37,
-      "adjacent_points": [
-        36,
-        38,
-        47
-      ],
-      "adjacent_hexes": [
-        16,
-        12
-      ]
-    },
-    {
-      "point_id": 38,
-      "adjacent_points": [
-        37,
-        27
-      ],
-      "adjacent_hexes": [
-        12
-      ]
-    },
-    {
-      "point_id": 39,
-      "adjacent_points": [
-        40,
-        29
-      ],
-      "adjacent_hexes": [
-        13
-      ]
-    },
-    {
-      "point_id": 40,
-      "adjacent_points": [
-        39,
-        41,
-        48
-      ],
-      "adjacent_hexes": [
-        17,
-        13
-      ]
-    },
-    {
-      "point_id": 41,
-      "adjacent_points": [
-        40,
-        42,
-        31
-      ],
-      "adjacent_hexes": [
-        17,
-        14,
-        13
-      ]
-    },
-    {
-      "point_id": 42,
-      "adjacent_points": [
-        41,
-        43,
-        50
-      ],
-      "adjacent_hexes": [
-        18,
-        17,
-        14
-      ]
-    },
-    {
-      "point_id": 43,
-      "adjacent_points": [
-        42,
-        44,
-        33
-      ],
-      "adjacent_hexes": [
-        18,
-        15,
-        14
-      ]
-    },
-    {
-      "point_id": 44,
-      "adjacent_points": [
-        43,
-        45,
-        52
-      ],
-      "adjacent_hexes": [
-        19,
-        18,
-        15
-      ]
-    },
-    {
-      "point_id": 45,
-      "adjacent_points": [
-        44,
-        46,
-        35
-      ],
-      "adjacent_hexes": [
-        19,
-        16,
-        15
-      ]
-    },
-    {
-      "point_id": 46,
-      "adjacent_points": [
-        45,
-        47,
-        54
-      ],
-      "adjacent_hexes": [
-        19,
-        16
-      ]
-    },
-    {
-      "point_id": 47,
-      "adjacent_points": [
-        46,
-        37
-      ],
-      "adjacent_hexes": [
-        16
-      ]
-    },
-    {
-      "point_id": 48,
-      "adjacent_points": [
-        49,
-        40
-      ],
-      "adjacent_hexes": [
-        17
-      ]
-    },
-    {
-      "point_id": 49,
-      "adjacent_points": [
-        48,
-        50
-      ],
-      "adjacent_hexes": [
-        17
-      ]
-    },
-    {
-      "point_id": 50,
-      "adjacent_points": [
-        49,
-        51,
-        42
-      ],
-      "adjacent_hexes": [
-        18,
-        17
-      ]
-    },
-    {
-      "point_id": 51,
-      "adjacent_points": [
-        50,
-        52
-      ],
-      "adjacent_hexes": [
-        18
-      ]
-    },
-    {
-      "point_id": 52,
-      "adjacent_points": [
-        51,
-        53,
-        44
-      ],
-      "adjacent_hexes": [
-        19,
-        18
-      ]
-    },
-    {
-      "point_id": 53,
-      "adjacent_points": [
-        52,
-        54
-      ],
-      "adjacent_hexes": [
-        19
-      ]
-    },
-    {
-      "point_id": 54,
-      "adjacent_points": [
-        53,
-        46
-      ],
-      "adjacent_hexes": [
-        19
-      ]
-    }
-  ]
-}

examples/ai_testing/my_games/game_20251226_143530_full.json

@@ -1,822 +0,0 @@
-{
-  "total_states": 1,
-  "timestamp": "20251226_143530",
-  "states": [
-    {
-      "hexes": [
-        {
-          "id": 1,
-          "type": "wood",
-          "number": 12,
-          "has_robber": false
-        },
-        {
-          "id": 2,
-          "type": "sheep",
-          "number": 5,
-          "has_robber": false
-        },
-        {
-          "id": 3,
-          "type": "wood",
-          "number": 4,
-          "has_robber": false
-        },
-        {
-          "id": 4,
-          "type": "sheep",
-          "number": 8,
-          "has_robber": false
-        },
-        {
-          "id": 5,
-          "type": "brick",
-          "number": 6,
-          "has_robber": false
-        },
-        {
-          "id": 6,
-          "type": "wood",
-          "number": 3,
-          "has_robber": false
-        },
-        {
-          "id": 7,
-          "type": "wheat",
-          "number": 8,
-          "has_robber": false
-        },
-        {
-          "id": 8,
-          "type": "brick",
-          "number": 10,
-          "has_robber": false
-        },
-        {
-          "id": 9,
-          "type": "wood",
-          "number": 11,
-          "has_robber": false
-        },
-        {
-          "id": 10,
-          "type": "desert",
-          "number": null,
-          "has_robber": true
-        },
-        {
-          "id": 11,
-          "type": "ore",
-          "number": 3,
-          "has_robber": false
-        },
-        {
-          "id": 12,
-          "type": "sheep",
-          "number": 4,
-          "has_robber": false
-        },
-        {
-          "id": 13,
-          "type": "brick",
-          "number": 10,
-          "has_robber": false
-        },
-        {
-          "id": 14,
-          "type": "wheat",
-          "number": 9,
-          "has_robber": false
-        },
-        {
-          "id": 15,
-          "type": "wheat",
-          "number": 6,
-          "has_robber": false
-        },
-        {
-          "id": 16,
-          "type": "sheep",
-          "number": 11,
-          "has_robber": false
-        },
-        {
-          "id": 17,
-          "type": "ore",
-          "number": 5,
-          "has_robber": false
-        },
-        {
-          "id": 18,
-          "type": "wheat",
-          "number": 9,
-          "has_robber": false
-        },
-        {
-          "id": 19,
-          "type": "ore",
-          "number": 2,
-          "has_robber": false
-        }
-      ],
-      "settlements": [],
-      "cities": [],
-      "roads": [],
-      "players": [
-        {
-          "id": 0,
-          "name": "ש",
-          "victory_points": 0,
-          "total_cards": 0,
-          "cards_list": [],
-          "dev_cards_list": [],
-          "settlements": 0,
-          "cities": 0,
-          "roads": 0,
-          "longest_road": 0,
-          "has_longest_road": false,
-          "knights": 0,
-          "knights_played": 0,
-          "has_largest_army": false
-        },
-        {
-          "id": 1,
-          "name": "ה",
-          "victory_points": 0,
-          "total_cards": 0,
-          "cards_list": [],
-          "dev_cards_list": [],
-          "settlements": 0,
-          "cities": 0,
-          "roads": 0,
-          "longest_road": 0,
-          "has_longest_road": false,
-          "knights": 0,
-          "knights_played": 0,
-          "has_largest_army": false
-        },
-        {
-          "id": 2,
-          "name": "ב",
-          "victory_points": 0,
-          "total_cards": 0,
-          "cards_list": [],
-          "dev_cards_list": [],
-          "settlements": 0,
-          "cities": 0,
-          "roads": 0,
-          "longest_road": 0,
-          "has_longest_road": false,
-          "knights": 0,
-          "knights_played": 0,
-          "has_largest_army": false
-        }
-      ],
-      "current_player": 0,
-      "current_phase": "SETUP_FIRST_ROUND",
-      "robber_position": [
-        2,
-        2
-      ],
-      "dice_result": null,
-      "points": [
-        {
-          "point_id": 1,
-          "adjacent_points": [
-            2,
-            9
-          ],
-          "adjacent_hexes": [
-            1
-          ]
-        },
-        {
-          "point_id": 2,
-          "adjacent_points": [
-            1,
-            3
-          ],
-          "adjacent_hexes": [
-            1
-          ]
-        },
-        {
-          "point_id": 3,
-          "adjacent_points": [
-            2,
-            4,
-            11
-          ],
-          "adjacent_hexes": [
-            2,
-            1
-          ]
-        },
-        {
-          "point_id": 4,
-          "adjacent_points": [
-            3,
-            5
-          ],
-          "adjacent_hexes": [
-            2
-          ]
-        },
-        {
-          "point_id": 5,
-          "adjacent_points": [
-            4,
-            6,
-            13
-          ],
-          "adjacent_hexes": [
-            3,
-            2
-          ]
-        },
-        {
-          "point_id": 6,
-          "adjacent_points": [
-            5,
-            7
-          ],
-          "adjacent_hexes": [
-            3
-          ]
-        },
-        {
-          "point_id": 7,
-          "adjacent_points": [
-            6,
-            15
-          ],
-          "adjacent_hexes": [
-            3
-          ]
-        },
-        {
-          "point_id": 8,
-          "adjacent_points": [
-            9,
-            18
-          ],
-          "adjacent_hexes": [
-            4
-          ]
-        },
-        {
-          "point_id": 9,
-          "adjacent_points": [
-            8,
-            10,
-            1
-          ],
-          "adjacent_hexes": [
-            4,
-            1
-          ]
-        },
-        {
-          "point_id": 10,
-          "adjacent_points": [
-            9,
-            11,
-            20
-          ],
-          "adjacent_hexes": [
-            5,
-            4,
-            1
-          ]
-        },
-        {
-          "point_id": 11,
-          "adjacent_points": [
-            10,
-            12,
-            3
-          ],
-          "adjacent_hexes": [
-            5,
-            2,
-            1
-          ]
-        },
-        {
-          "point_id": 12,
-          "adjacent_points": [
-            11,
-            13,
-            22
-          ],
-          "adjacent_hexes": [
-            6,
-            5,
-            2
-          ]
-        },
-        {
-          "point_id": 13,
-          "adjacent_points": [
-            12,
-            14,
-            5
-          ],
-          "adjacent_hexes": [
-            6,
-            3,
-            2
-          ]
-        },
-        {
-          "point_id": 14,
-          "adjacent_points": [
-            13,
-            15,
-            24
-          ],
-          "adjacent_hexes": [
-            7,
-            6,
-            3
-          ]
-        },
-        {
-          "point_id": 15,
-          "adjacent_points": [
-            14,
-            16,
-            7
-          ],
-          "adjacent_hexes": [
-            7,
-            3
-          ]
-        },
-        {
-          "point_id": 16,
-          "adjacent_points": [
-            15,
-            26
-          ],
-          "adjacent_hexes": [
-            7
-          ]
-        },
-        {
-          "point_id": 17,
-          "adjacent_points": [
-            18,
-            28
-          ],
-          "adjacent_hexes": [
-            8
-          ]
-        },
-        {
-          "point_id": 18,
-          "adjacent_points": [
-            17,
-            19,
-            8
-          ],
-          "adjacent_hexes": [
-            8,
-            4
-          ]
-        },
-        {
-          "point_id": 19,
-          "adjacent_points": [
-            18,
-            20,
-            30
-          ],
-          "adjacent_hexes": [
-            9,
-            8,
-            4
-          ]
-        },
-        {
-          "point_id": 20,
-          "adjacent_points": [
-            19,
-            21,
-            10
-          ],
-          "adjacent_hexes": [
-            9,
-            5,
-            4
-          ]
-        },
-        {
-          "point_id": 21,
-          "adjacent_points": [
-            20,
-            22,
-            32
-          ],
-          "adjacent_hexes": [
-            10,
-            9,
-            5
-          ]
-        },
-        {
-          "point_id": 22,
-          "adjacent_points": [
-            21,
-            23,
-            12
-          ],
-          "adjacent_hexes": [
-            10,
-            6,
-            5
-          ]
-        },
-        {
-          "point_id": 23,
-          "adjacent_points": [
-            22,
-            24,
-            34
-          ],
-          "adjacent_hexes": [
-            11,
-            10,
-            6
-          ]
-        },
-        {
-          "point_id": 24,
-          "adjacent_points": [
-            23,
-            25,
-            14
-          ],
-          "adjacent_hexes": [
-            11,
-            7,
-            6
-          ]
-        },
-        {
-          "point_id": 25,
-          "adjacent_points": [
-            24,
-            26,
-            36
-          ],
-          "adjacent_hexes": [
-            12,
-            11,
-            7
-          ]
-        },
-        {
-          "point_id": 26,
-          "adjacent_points": [
-            25,
-            27,
-            16
-          ],
-          "adjacent_hexes": [
-            12,
-            7
-          ]
-        },
-        {
-          "point_id": 27,
-          "adjacent_points": [
-            26,
-            38
-          ],
-          "adjacent_hexes": [
-            12
-          ]
-        },
-        {
-          "point_id": 28,
-          "adjacent_points": [
-            29,
-            17
-          ],
-          "adjacent_hexes": [
-            8
-          ]
-        },
-        {
-          "point_id": 29,
-          "adjacent_points": [
-            28,
-            30,
-            39
-          ],
-          "adjacent_hexes": [
-            13,
-            8
-          ]
-        },
-        {
-          "point_id": 30,
-          "adjacent_points": [
-            29,
-            31,
-            19
-          ],
-          "adjacent_hexes": [
-            13,
-            9,
-            8
-          ]
-        },
-        {
-          "point_id": 31,
-          "adjacent_points": [
-            30,
-            32,
-            41
-          ],
-          "adjacent_hexes": [
-            14,
-            13,
-            9
-          ]
-        },
-        {
-          "point_id": 32,
-          "adjacent_points": [
-            31,
-            33,
-            21
-          ],
-          "adjacent_hexes": [
-            14,
-            10,
-            9
-          ]
-        },
-        {
-          "point_id": 33,
-          "adjacent_points": [
-            32,
-            34,
-            43
-          ],
-          "adjacent_hexes": [
-            15,
-            14,
-            10
-          ]
-        },
-        {
-          "point_id": 34,
-          "adjacent_points": [
-            33,
-            35,
-            23
-          ],
-          "adjacent_hexes": [
-            15,
-            11,
-            10
-          ]
-        },
-        {
-          "point_id": 35,
-          "adjacent_points": [
-            34,
-            36,
-            45
-          ],
-          "adjacent_hexes": [
-            16,
-            15,
-            11
-          ]
-        },
-        {
-          "point_id": 36,
-          "adjacent_points": [
-            35,
-            37,
-            25
-          ],
-          "adjacent_hexes": [
-            16,
-            12,
-            11
-          ]
-        },
-        {
-          "point_id": 37,
-          "adjacent_points": [
-            36,
-            38,
-            47
-          ],
-          "adjacent_hexes": [
-            16,
-            12
-          ]
-        },
-        {
-          "point_id": 38,
-          "adjacent_points": [
-            37,
-            27
-          ],
-          "adjacent_hexes": [
-            12
-          ]
-        },
-        {
-          "point_id": 39,
-          "adjacent_points": [
-            40,
-            29
-          ],
-          "adjacent_hexes": [
-            13
-          ]
-        },
-        {
-          "point_id": 40,
-          "adjacent_points": [
-            39,
-            41,
-            48
-          ],
-          "adjacent_hexes": [
-            17,
-            13
-          ]
-        },
-        {
-          "point_id": 41,
-          "adjacent_points": [
-            40,
-            42,
-            31
-          ],
-          "adjacent_hexes": [
-            17,
-            14,
-            13
-          ]
-        },
-        {
-          "point_id": 42,
-          "adjacent_points": [
-            41,
-            43,
-            50
-          ],
-          "adjacent_hexes": [
-            18,
-            17,
-            14
-          ]
-        },
-        {
-          "point_id": 43,
-          "adjacent_points": [
-            42,
-            44,
-            33
-          ],
-          "adjacent_hexes": [
-            18,
-            15,
-            14
-          ]
-        },
-        {
-          "point_id": 44,
-          "adjacent_points": [
-            43,
-            45,
-            52
-          ],
-          "adjacent_hexes": [
-            19,
-            18,
-            15
-          ]
-        },
-        {
-          "point_id": 45,
-          "adjacent_points": [
-            44,
-            46,
-            35
-          ],
-          "adjacent_hexes": [
-            19,
-            16,
-            15
-          ]
-        },
-        {
-          "point_id": 46,
-          "adjacent_points": [
-            45,
-            47,
-            54
-          ],
-          "adjacent_hexes": [
-            19,
-            16
-          ]
-        },
-        {
-          "point_id": 47,
-          "adjacent_points": [
-            46,
-            37
-          ],
-          "adjacent_hexes": [
-            16
-          ]
-        },
-        {
-          "point_id": 48,
-          "adjacent_points": [
-            49,
-            40
-          ],
-          "adjacent_hexes": [
-            17
-          ]
-        },
-        {
-          "point_id": 49,
-          "adjacent_points": [
-            48,
-            50
-          ],
-          "adjacent_hexes": [
-            17
-          ]
-        },
-        {
-          "point_id": 50,
-          "adjacent_points": [
-            49,
-            51,
-            42
-          ],
-          "adjacent_hexes": [
-            18,
-            17
-          ]
-        },
-        {
-          "point_id": 51,
-          "adjacent_points": [
-            50,
-            52
-          ],
-          "adjacent_hexes": [
-            18
-          ]
-        },
-        {
-          "point_id": 52,
-          "adjacent_points": [
-            51,
-            53,
-            44
-          ],
-          "adjacent_hexes": [
-            19,
-            18
-          ]
-        },
-        {
-          "point_id": 53,
-          "adjacent_points": [
-            52,
-            54
-          ],
-          "adjacent_hexes": [
-            19
-          ]
-        },
-        {
-          "point_id": 54,
-          "adjacent_points": [
-            53,
-            46
-          ],
-          "adjacent_hexes": [
-            19
-          ]
-        }
-      ]
-    }
-  ]
-}

examples/ai_testing/my_games/game_20251226_143710_final.json

@@ -1,816 +0,0 @@
-{
-  "hexes": [
-    {
-      "id": 1,
-      "type": "wood",
-      "number": 12,
-      "has_robber": false
-    },
-    {
-      "id": 2,
-      "type": "sheep",
-      "number": 5,
-      "has_robber": false
-    },
-    {
-      "id": 3,
-      "type": "wood",
-      "number": 4,
-      "has_robber": false
-    },
-    {
-      "id": 4,
-      "type": "sheep",
-      "number": 8,
-      "has_robber": false
-    },
-    {
-      "id": 5,
-      "type": "brick",
-      "number": 6,
-      "has_robber": false
-    },
-    {
-      "id": 6,
-      "type": "wood",
-      "number": 3,
-      "has_robber": false
-    },
-    {
-      "id": 7,
-      "type": "wheat",
-      "number": 8,
-      "has_robber": false
-    },
-    {
-      "id": 8,
-      "type": "brick",
-      "number": 10,
-      "has_robber": false
-    },
-    {
-      "id": 9,
-      "type": "wood",
-      "number": 11,
-      "has_robber": false
-    },
-    {
-      "id": 10,
-      "type": "desert",
-      "number": null,
-      "has_robber": true
-    },
-    {
-      "id": 11,
-      "type": "ore",
-      "number": 3,
-      "has_robber": false
-    },
-    {
-      "id": 12,
-      "type": "sheep",
-      "number": 4,
-      "has_robber": false
-    },
-    {
-      "id": 13,
-      "type": "brick",
-      "number": 10,
-      "has_robber": false
-    },
-    {
-      "id": 14,
-      "type": "wheat",
-      "number": 9,
-      "has_robber": false
-    },
-    {
-      "id": 15,
-      "type": "wheat",
-      "number": 6,
-      "has_robber": false
-    },
-    {
-      "id": 16,
-      "type": "sheep",
-      "number": 11,
-      "has_robber": false
-    },
-    {
-      "id": 17,
-      "type": "ore",
-      "number": 5,
-      "has_robber": false
-    },
-    {
-      "id": 18,
-      "type": "wheat",
-      "number": 9,
-      "has_robber": false
-    },
-    {
-      "id": 19,
-      "type": "ore",
-      "number": 2,
-      "has_robber": false
-    }
-  ],
-  "settlements": [],
-  "cities": [],
-  "roads": [],
-  "players": [
-    {
-      "id": 0,
-      "name": "a",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
-      "dev_cards_list": [],
-      "settlements": 0,
-      "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
-      "has_longest_road": false,
-      "knights": 0,
-      "knights_played": 0,
-      "has_largest_army": false
-    },
-    {
-      "id": 1,
-      "name": "b",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
-      "dev_cards_list": [],
-      "settlements": 0,
-      "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
-      "has_longest_road": false,
-      "knights": 0,
-      "knights_played": 0,
-      "has_largest_army": false
-    },
-    {
-      "id": 2,
-      "name": "c",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
-      "dev_cards_list": [],
-      "settlements": 0,
-      "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
-      "has_longest_road": false,
-      "knights": 0,
-      "knights_played": 0,
-      "has_largest_army": false
-    }
-  ],
-  "current_player": 0,
-  "current_phase": "SETUP_FIRST_ROUND",
-  "robber_position": [
-    2,
-    2
-  ],
-  "dice_result": null,
-  "points": [
-    {
-      "point_id": 1,
-      "adjacent_points": [
-        2,
-        9
-      ],
-      "adjacent_hexes": [
-        1
-      ]
-    },
-    {
-      "point_id": 2,
-      "adjacent_points": [
-        1,
-        3
-      ],
-      "adjacent_hexes": [
-        1
-      ]
-    },
-    {
-      "point_id": 3,
-      "adjacent_points": [
-        2,
-        4,
-        11
-      ],
-      "adjacent_hexes": [
-        2,
-        1
-      ]
-    },
-    {
-      "point_id": 4,
-      "adjacent_points": [
-        3,
-        5
-      ],
-      "adjacent_hexes": [
-        2
-      ]
-    },
-    {
-      "point_id": 5,
-      "adjacent_points": [
-        4,
-        6,
-        13
-      ],
-      "adjacent_hexes": [
-        3,
-        2
-      ]
-    },
-    {
-      "point_id": 6,
-      "adjacent_points": [
-        5,
-        7
-      ],
-      "adjacent_hexes": [
-        3
-      ]
-    },
-    {
-      "point_id": 7,
-      "adjacent_points": [
-        6,
-        15
-      ],
-      "adjacent_hexes": [
-        3
-      ]
-    },
-    {
-      "point_id": 8,
-      "adjacent_points": [
-        9,
-        18
-      ],
-      "adjacent_hexes": [
-        4
-      ]
-    },
-    {
-      "point_id": 9,
-      "adjacent_points": [
-        8,
-        10,
-        1
-      ],
-      "adjacent_hexes": [
-        4,
-        1
-      ]
-    },
-    {
-      "point_id": 10,
-      "adjacent_points": [
-        9,
-        11,
-        20
-      ],
-      "adjacent_hexes": [
-        5,
-        4,
-        1
-      ]
-    },
-    {
-      "point_id": 11,
-      "adjacent_points": [
-        10,
-        12,
-        3
-      ],
-      "adjacent_hexes": [
-        5,
-        2,
-        1
-      ]
-    },
-    {
-      "point_id": 12,
-      "adjacent_points": [
-        11,
-        13,
-        22
-      ],
-      "adjacent_hexes": [
-        6,
-        5,
-        2
-      ]
-    },
-    {
-      "point_id": 13,
-      "adjacent_points": [
-        12,
-        14,
-        5
-      ],
-      "adjacent_hexes": [
-        6,
-        3,
-        2
-      ]
-    },
-    {
-      "point_id": 14,
-      "adjacent_points": [
-        13,
-        15,
-        24
-      ],
-      "adjacent_hexes": [
-        7,
-        6,
-        3
-      ]
-    },
-    {
-      "point_id": 15,
-      "adjacent_points": [
-        14,
-        16,
-        7
-      ],
-      "adjacent_hexes": [
-        7,
-        3
-      ]
-    },
-    {
-      "point_id": 16,
-      "adjacent_points": [
-        15,
-        26
-      ],
-      "adjacent_hexes": [
-        7
-      ]
-    },
-    {
-      "point_id": 17,
-      "adjacent_points": [
-        18,
-        28
-      ],
-      "adjacent_hexes": [
-        8
-      ]
-    },
-    {
-      "point_id": 18,
-      "adjacent_points": [
-        17,
-        19,
-        8
-      ],
-      "adjacent_hexes": [
-        8,
-        4
-      ]
-    },
-    {
-      "point_id": 19,
-      "adjacent_points": [
-        18,
-        20,
-        30
-      ],
-      "adjacent_hexes": [
-        9,
-        8,
-        4
-      ]
-    },
-    {
-      "point_id": 20,
-      "adjacent_points": [
-        19,
-        21,
-        10
-      ],
-      "adjacent_hexes": [
-        9,
-        5,
-        4
-      ]
-    },
-    {
-      "point_id": 21,
-      "adjacent_points": [
-        20,
-        22,
-        32
-      ],
-      "adjacent_hexes": [
-        10,
-        9,
-        5
-      ]
-    },
-    {
-      "point_id": 22,
-      "adjacent_points": [
-        21,
-        23,
-        12
-      ],
-      "adjacent_hexes": [
-        10,
-        6,
-        5
-      ]
-    },
-    {
-      "point_id": 23,
-      "adjacent_points": [
-        22,
-        24,
-        34
-      ],
-      "adjacent_hexes": [
-        11,
-        10,
-        6
-      ]
-    },
-    {
-      "point_id": 24,
-      "adjacent_points": [
-        23,
-        25,
-        14
-      ],
-      "adjacent_hexes": [
-        11,
-        7,
-        6
-      ]
-    },
-    {
-      "point_id": 25,
-      "adjacent_points": [
-        24,
-        26,
-        36
-      ],
-      "adjacent_hexes": [
-        12,
-        11,
-        7
-      ]
-    },
-    {
-      "point_id": 26,
-      "adjacent_points": [
-        25,
-        27,
-        16
-      ],
-      "adjacent_hexes": [
-        12,
-        7
-      ]
-    },
-    {
-      "point_id": 27,
-      "adjacent_points": [
-        26,
-        38
-      ],
-      "adjacent_hexes": [
-        12
-      ]
-    },
-    {
-      "point_id": 28,
-      "adjacent_points": [
-        29,
-        17
-      ],
-      "adjacent_hexes": [
-        8
-      ]
-    },
-    {
-      "point_id": 29,
-      "adjacent_points": [
-        28,
-        30,
-        39
-      ],
-      "adjacent_hexes": [
-        13,
-        8
-      ]
-    },
-    {
-      "point_id": 30,
-      "adjacent_points": [
-        29,
-        31,
-        19
-      ],
-      "adjacent_hexes": [
-        13,
-        9,
-        8
-      ]
-    },
-    {
-      "point_id": 31,
-      "adjacent_points": [
-        30,
-        32,
-        41
-      ],
-      "adjacent_hexes": [
-        14,
-        13,
-        9
-      ]
-    },
-    {
-      "point_id": 32,
-      "adjacent_points": [
-        31,
-        33,
-        21
-      ],
-      "adjacent_hexes": [
-        14,
-        10,
-        9
-      ]
-    },
-    {
-      "point_id": 33,
-      "adjacent_points": [
-        32,
-        34,
-        43
-      ],
-      "adjacent_hexes": [
-        15,
-        14,
-        10
-      ]
-    },
-    {
-      "point_id": 34,
-      "adjacent_points": [
-        33,
-        35,
-        23
-      ],
-      "adjacent_hexes": [
-        15,
-        11,
-        10
-      ]
-    },
-    {
-      "point_id": 35,
-      "adjacent_points": [
-        34,
-        36,
-        45
-      ],
-      "adjacent_hexes": [
-        16,
-        15,
-        11
-      ]
-    },
-    {
-      "point_id": 36,
-      "adjacent_points": [
-        35,
-        37,
-        25
-      ],
-      "adjacent_hexes": [
-        16,
-        12,
-        11
-      ]
-    },
-    {
-      "point_id": 37,
-      "adjacent_points": [
-        36,
-        38,
-        47
-      ],
-      "adjacent_hexes": [
-        16,
-        12
-      ]
-    },
-    {
-      "point_id": 38,
-      "adjacent_points": [
-        37,
-        27
-      ],
-      "adjacent_hexes": [
-        12
-      ]
-    },
-    {
-      "point_id": 39,
-      "adjacent_points": [
-        40,
-        29
-      ],
-      "adjacent_hexes": [
-        13
-      ]
-    },
-    {
-      "point_id": 40,
-      "adjacent_points": [
-        39,
-        41,
-        48
-      ],
-      "adjacent_hexes": [
-        17,
-        13
-      ]
-    },
-    {
-      "point_id": 41,
-      "adjacent_points": [
-        40,
-        42,
-        31
-      ],
-      "adjacent_hexes": [
-        17,
-        14,
-        13
-      ]
-    },
-    {
-      "point_id": 42,
-      "adjacent_points": [
-        41,
-        43,
-        50
-      ],
-      "adjacent_hexes": [
-        18,
-        17,
-        14
-      ]
-    },
-    {
-      "point_id": 43,
-      "adjacent_points": [
-        42,
-        44,
-        33
-      ],
-      "adjacent_hexes": [
-        18,
-        15,
-        14
-      ]
-    },
-    {
-      "point_id": 44,
-      "adjacent_points": [
-        43,
-        45,
-        52
-      ],
-      "adjacent_hexes": [
-        19,
-        18,
-        15
-      ]
-    },
-    {
-      "point_id": 45,
-      "adjacent_points": [
-        44,
-        46,
-        35
-      ],
-      "adjacent_hexes": [
-        19,
-        16,
-        15
-      ]
-    },
-    {
-      "point_id": 46,
-      "adjacent_points": [
-        45,
-        47,
-        54
-      ],
-      "adjacent_hexes": [
-        19,
-        16
-      ]
-    },
-    {
-      "point_id": 47,
-      "adjacent_points": [
-        46,
-        37
-      ],
-      "adjacent_hexes": [
-        16
-      ]
-    },
-    {
-      "point_id": 48,
-      "adjacent_points": [
-        49,
-        40
-      ],
-      "adjacent_hexes": [
-        17
-      ]
-    },
-    {
-      "point_id": 49,
-      "adjacent_points": [
-        48,
-        50
-      ],
-      "adjacent_hexes": [
-        17
-      ]
-    },
-    {
-      "point_id": 50,
-      "adjacent_points": [
-        49,
-        51,
-        42
-      ],
-      "adjacent_hexes": [
-        18,
-        17
-      ]
-    },
-    {
-      "point_id": 51,
-      "adjacent_points": [
-        50,
-        52
-      ],
-      "adjacent_hexes": [
-        18
-      ]
-    },
-    {
-      "point_id": 52,
-      "adjacent_points": [
-        51,
-        53,
-        44
-      ],
-      "adjacent_hexes": [
-        19,
-        18
-      ]
-    },
-    {
-      "point_id": 53,
-      "adjacent_points": [
-        52,
-        54
-      ],
-      "adjacent_hexes": [
-        19
-      ]
-    },
-    {
-      "point_id": 54,
-      "adjacent_points": [
-        53,
-        46
-      ],
-      "adjacent_hexes": [
-        19
-      ]
-    }
-  ]
-}

examples/ai_testing/my_games/game_20251226_143710_full.json

@@ -1,822 +0,0 @@
-{
-  "total_states": 1,
-  "timestamp": "20251226_143710",
-  "states": [
-    {
-      "hexes": [
-        {
-          "id": 1,
-          "type": "wood",
-          "number": 12,
-          "has_robber": false
-        },
-        {
-          "id": 2,
-          "type": "sheep",
-          "number": 5,
-          "has_robber": false
-        },
-        {
-          "id": 3,
-          "type": "wood",
-          "number": 4,
-          "has_robber": false
-        },
-        {
-          "id": 4,
-          "type": "sheep",
-          "number": 8,
-          "has_robber": false
-        },
-        {
-          "id": 5,
-          "type": "brick",
-          "number": 6,
-          "has_robber": false
-        },
-        {
-          "id": 6,
-          "type": "wood",
-          "number": 3,
-          "has_robber": false
-        },
-        {
-          "id": 7,
-          "type": "wheat",
-          "number": 8,
-          "has_robber": false
-        },
-        {
-          "id": 8,
-          "type": "brick",
-          "number": 10,
-          "has_robber": false
-        },
-        {
-          "id": 9,
-          "type": "wood",
-          "number": 11,
-          "has_robber": false
-        },
-        {
-          "id": 10,
-          "type": "desert",
-          "number": null,
-          "has_robber": true
-        },
-        {
-          "id": 11,
-          "type": "ore",
-          "number": 3,
-          "has_robber": false
-        },
-        {
-          "id": 12,
-          "type": "sheep",
-          "number": 4,
-          "has_robber": false
-        },
-        {
-          "id": 13,
-          "type": "brick",
-          "number": 10,
-          "has_robber": false
-        },
-        {
-          "id": 14,
-          "type": "wheat",
-          "number": 9,
-          "has_robber": false
-        },
-        {
-          "id": 15,
-          "type": "wheat",
-          "number": 6,
-          "has_robber": false
-        },
-        {
-          "id": 16,
-          "type": "sheep",
-          "number": 11,
-          "has_robber": false
-        },
-        {
-          "id": 17,
-          "type": "ore",
-          "number": 5,
-          "has_robber": false
-        },
-        {
-          "id": 18,
-          "type": "wheat",
-          "number": 9,
-          "has_robber": false
-        },
-        {
-          "id": 19,
-          "type": "ore",
-          "number": 2,
-          "has_robber": false
-        }
-      ],
-      "settlements": [],
-      "cities": [],
-      "roads": [],
-      "players": [
-        {
-          "id": 0,
-          "name": "a",
-          "victory_points": 0,
-          "total_cards": 0,
-          "cards_list": [],
-          "dev_cards_list": [],
-          "settlements": 0,
-          "cities": 0,
-          "roads": 0,
-          "longest_road": 0,
-          "has_longest_road": false,
-          "knights": 0,
-          "knights_played": 0,
-          "has_largest_army": false
-        },
-        {
-          "id": 1,
-          "name": "b",
-          "victory_points": 0,
-          "total_cards": 0,
-          "cards_list": [],
-          "dev_cards_list": [],
-          "settlements": 0,
-          "cities": 0,
-          "roads": 0,
-          "longest_road": 0,
-          "has_longest_road": false,
-          "knights": 0,
-          "knights_played": 0,
-          "has_largest_army": false
-        },
-        {
-          "id": 2,
-          "name": "c",
-          "victory_points": 0,
-          "total_cards": 0,
-          "cards_list": [],
-          "dev_cards_list": [],
-          "settlements": 0,
-          "cities": 0,
-          "roads": 0,
-          "longest_road": 0,
-          "has_longest_road": false,
-          "knights": 0,
-          "knights_played": 0,
-          "has_largest_army": false
-        }
-      ],
-      "current_player": 0,
-      "current_phase": "SETUP_FIRST_ROUND",
-      "robber_position": [
-        2,
-        2
-      ],
-      "dice_result": null,
-      "points": [
-        {
-          "point_id": 1,
-          "adjacent_points": [
-            2,
-            9
-          ],
-          "adjacent_hexes": [
-            1
-          ]
-        },
-        {
-          "point_id": 2,
-          "adjacent_points": [
-            1,
-            3
-          ],
-          "adjacent_hexes": [
-            1
-          ]
-        },
-        {
-          "point_id": 3,
-          "adjacent_points": [
-            2,
-            4,
-            11
-          ],
-          "adjacent_hexes": [
-            2,
-            1
-          ]
-        },
-        {
-          "point_id": 4,
-          "adjacent_points": [
-            3,
-            5
-          ],
-          "adjacent_hexes": [
-            2
-          ]
-        },
-        {
-          "point_id": 5,
-          "adjacent_points": [
-            4,
-            6,
-            13
-          ],
-          "adjacent_hexes": [
-            3,
-            2
-          ]
-        },
-        {
-          "point_id": 6,
-          "adjacent_points": [
-            5,
-            7
-          ],
-          "adjacent_hexes": [
-            3
-          ]
-        },
-        {
-          "point_id": 7,
-          "adjacent_points": [
-            6,
-            15
-          ],
-          "adjacent_hexes": [
-            3
-          ]
-        },
-        {
-          "point_id": 8,
-          "adjacent_points": [
-            9,
-            18
-          ],
-          "adjacent_hexes": [
-            4
-          ]
-        },
-        {
-          "point_id": 9,
-          "adjacent_points": [
-            8,
-            10,
-            1
-          ],
-          "adjacent_hexes": [
-            4,
-            1
-          ]
-        },
-        {
-          "point_id": 10,
-          "adjacent_points": [
-            9,
-            11,
-            20
-          ],
-          "adjacent_hexes": [
-            5,
-            4,
-            1
-          ]
-        },
-        {
-          "point_id": 11,
-          "adjacent_points": [
-            10,
-            12,
-            3
-          ],
-          "adjacent_hexes": [
-            5,
-            2,
-            1
-          ]
-        },
-        {
-          "point_id": 12,
-          "adjacent_points": [
-            11,
-            13,
-            22
-          ],
-          "adjacent_hexes": [
-            6,
-            5,
-            2
-          ]
-        },
-        {
-          "point_id": 13,
-          "adjacent_points": [
-            12,
-            14,
-            5
-          ],
-          "adjacent_hexes": [
-            6,
-            3,
-            2
-          ]
-        },
-        {
-          "point_id": 14,
-          "adjacent_points": [
-            13,
-            15,
-            24
-          ],
-          "adjacent_hexes": [
-            7,
-            6,
-            3
-          ]
-        },
-        {
-          "point_id": 15,
-          "adjacent_points": [
-            14,
-            16,
-            7
-          ],
-          "adjacent_hexes": [
-            7,
-            3
-          ]
-        },
-        {
-          "point_id": 16,
-          "adjacent_points": [
-            15,
-            26
-          ],
-          "adjacent_hexes": [
-            7
-          ]
-        },
-        {
-          "point_id": 17,
-          "adjacent_points": [
-            18,
-            28
-          ],
-          "adjacent_hexes": [
-            8
-          ]
-        },
-        {
-          "point_id": 18,
-          "adjacent_points": [
-            17,
-            19,
-            8
-          ],
-          "adjacent_hexes": [
-            8,
-            4
-          ]
-        },
-        {
-          "point_id": 19,
-          "adjacent_points": [
-            18,
-            20,
-            30
-          ],
-          "adjacent_hexes": [
-            9,
-            8,
-            4
-          ]
-        },
-        {
-          "point_id": 20,
-          "adjacent_points": [
-            19,
-            21,
-            10
-          ],
-          "adjacent_hexes": [
-            9,
-            5,
-            4
-          ]
-        },
-        {
-          "point_id": 21,
-          "adjacent_points": [
-            20,
-            22,
-            32
-          ],
-          "adjacent_hexes": [
-            10,
-            9,
-            5
-          ]
-        },
-        {
-          "point_id": 22,
-          "adjacent_points": [
-            21,
-            23,
-            12
-          ],
-          "adjacent_hexes": [
-            10,
-            6,
-            5
-          ]
-        },
-        {
-          "point_id": 23,
-          "adjacent_points": [
-            22,
-            24,
-            34
-          ],
-          "adjacent_hexes": [
-            11,
-            10,
-            6
-          ]
-        },
-        {
-          "point_id": 24,
-          "adjacent_points": [
-            23,
-            25,
-            14
-          ],
-          "adjacent_hexes": [
-            11,
-            7,
-            6
-          ]
-        },
-        {
-          "point_id": 25,
-          "adjacent_points": [
-            24,
-            26,
-            36
-          ],
-          "adjacent_hexes": [
-            12,
-            11,
-            7
-          ]
-        },
-        {
-          "point_id": 26,
-          "adjacent_points": [
-            25,
-            27,
-            16
-          ],
-          "adjacent_hexes": [
-            12,
-            7
-          ]
-        },
-        {
-          "point_id": 27,
-          "adjacent_points": [
-            26,
-            38
-          ],
-          "adjacent_hexes": [
-            12
-          ]
-        },
-        {
-          "point_id": 28,
-          "adjacent_points": [
-            29,
-            17
-          ],
-          "adjacent_hexes": [
-            8
-          ]
-        },
-        {
-          "point_id": 29,
-          "adjacent_points": [
-            28,
-            30,
-            39
-          ],
-          "adjacent_hexes": [
-            13,
-            8
-          ]
-        },
-        {
-          "point_id": 30,
-          "adjacent_points": [
-            29,
-            31,
-            19
-          ],
-          "adjacent_hexes": [
-            13,
-            9,
-            8
-          ]
-        },
-        {
-          "point_id": 31,
-          "adjacent_points": [
-            30,
-            32,
-            41
-          ],
-          "adjacent_hexes": [
-            14,
-            13,
-            9
-          ]
-        },
-        {
-          "point_id": 32,
-          "adjacent_points": [
-            31,
-            33,
-            21
-          ],
-          "adjacent_hexes": [
-            14,
-            10,
-            9
-          ]
-        },
-        {
-          "point_id": 33,
-          "adjacent_points": [
-            32,
-            34,
-            43
-          ],
-          "adjacent_hexes": [
-            15,
-            14,
-            10
-          ]
-        },
-        {
-          "point_id": 34,
-          "adjacent_points": [
-            33,
-            35,
-            23
-          ],
-          "adjacent_hexes": [
-            15,
-            11,
-            10
-          ]
-        },
-        {
-          "point_id": 35,
-          "adjacent_points": [
-            34,
-            36,
-            45
-          ],
-          "adjacent_hexes": [
-            16,
-            15,
-            11
-          ]
-        },
-        {
-          "point_id": 36,
-          "adjacent_points": [
-            35,
-            37,
-            25
-          ],
-          "adjacent_hexes": [
-            16,
-            12,
-            11
-          ]
-        },
-        {
-          "point_id": 37,
-          "adjacent_points": [
-            36,
-            38,
-            47
-          ],
-          "adjacent_hexes": [
-            16,
-            12
-          ]
-        },
-        {
-          "point_id": 38,
-          "adjacent_points": [
-            37,
-            27
-          ],
-          "adjacent_hexes": [
-            12
-          ]
-        },
-        {
-          "point_id": 39,
-          "adjacent_points": [
-            40,
-            29
-          ],
-          "adjacent_hexes": [
-            13
-          ]
-        },
-        {
-          "point_id": 40,
-          "adjacent_points": [
-            39,
-            41,
-            48
-          ],
-          "adjacent_hexes": [
-            17,
-            13
-          ]
-        },
-        {
-          "point_id": 41,
-          "adjacent_points": [
-            40,
-            42,
-            31
-          ],
-          "adjacent_hexes": [
-            17,
-            14,
-            13
-          ]
-        },
-        {
-          "point_id": 42,
-          "adjacent_points": [
-            41,
-            43,
-            50
-          ],
-          "adjacent_hexes": [
-            18,
-            17,
-            14
-          ]
-        },
-        {
-          "point_id": 43,
-          "adjacent_points": [
-            42,
-            44,
-            33
-          ],
-          "adjacent_hexes": [
-            18,
-            15,
-            14
-          ]
-        },
-        {
-          "point_id": 44,
-          "adjacent_points": [
-            43,
-            45,
-            52
-          ],
-          "adjacent_hexes": [
-            19,
-            18,
-            15
-          ]
-        },
-        {
-          "point_id": 45,
-          "adjacent_points": [
-            44,
-            46,
-            35
-          ],
-          "adjacent_hexes": [
-            19,
-            16,
-            15
-          ]
-        },
-        {
-          "point_id": 46,
-          "adjacent_points": [
-            45,
-            47,
-            54
-          ],
-          "adjacent_hexes": [
-            19,
-            16
-          ]
-        },
-        {
-          "point_id": 47,
-          "adjacent_points": [
-            46,
-            37
-          ],
-          "adjacent_hexes": [
-            16
-          ]
-        },
-        {
-          "point_id": 48,
-          "adjacent_points": [
-            49,
-            40
-          ],
-          "adjacent_hexes": [
-            17
-          ]
-        },
-        {
-          "point_id": 49,
-          "adjacent_points": [
-            48,
-            50
-          ],
-          "adjacent_hexes": [
-            17
-          ]
-        },
-        {
-          "point_id": 50,
-          "adjacent_points": [
-            49,
-            51,
-            42
-          ],
-          "adjacent_hexes": [
-            18,
-            17
-          ]
-        },
-        {
-          "point_id": 51,
-          "adjacent_points": [
-            50,
-            52
-          ],
-          "adjacent_hexes": [
-            18
-          ]
-        },
-        {
-          "point_id": 52,
-          "adjacent_points": [
-            51,
-            53,
-            44
-          ],
-          "adjacent_hexes": [
-            19,
-            18
-          ]
-        },
-        {
-          "point_id": 53,
-          "adjacent_points": [
-            52,
-            54
-          ],
-          "adjacent_hexes": [
-            19
-          ]
-        },
-        {
-          "point_id": 54,
-          "adjacent_points": [
-            53,
-            46
-          ],
-          "adjacent_hexes": [
-            19
-          ]
-        }
-      ]
-    }
-  ]
-}

examples/ai_testing/play_and_capture.py

@@ -21,6 +21,25 @@ from pycatan.management import game_manager as gm_module
 captured_states = []
 original_update_state = None
 
+# Output directory for states
+OUTPUT_DIR = Path('examples/ai_testing/my_games')
+CURRENT_STATE_FILE = OUTPUT_DIR / 'current_state.json'
+
+
+def save_current_state(state):
+    """Save the current state to a file (updated in real-time)."""
+    try:
+        OUTPUT_DIR.mkdir(exist_ok=True)
+        cleaned = clean_state_for_llm(state)
+        with open(CURRENT_STATE_FILE, 'w', encoding='utf-8') as f:
+            json.dump({
+                'timestamp': datetime.now().isoformat(),
+                'state_number': len(captured_states),
+                'state': cleaned
+            }, f, indent=2, ensure_ascii=False)
+    except Exception as e:
+        print(f"[⚠️ Failed to save current state: {e}]", flush=True)
+
 
 def capturing_wrapper(original_method):
     """Wrap the display_game_state method to capture all calls."""
@@ -36,6 +55,10 @@ def capturing_wrapper(original_method):
                     state_copy = json.loads(json.dumps(viz.current_game_state))
                     captured_states.append(state_copy)
                     print(f"[✅ Captured state #{len(captured_states)}]", flush=True)
+                    
+                    # Save current state to file (real-time update)
+                    save_current_state(state_copy)
+                    
                     break  # Only capture once per update
                 except (TypeError, AttributeError) as e:
                     # Skip if not serializable
@@ -114,6 +137,7 @@ def save_all_states():
     print(f"  📁 Full history: {history_file}")
     print(f"  📄 Final state:  {final_file}")
     print(f"  📌 Quick access: {sample_file}")
+    print(f"  🔄 Real-time:    {CURRENT_STATE_FILE} (updated during game)")
     print("\n" + "="*80)
     
     # Print summary
@@ -152,8 +176,10 @@ def main():
     print("="*80)
     print("🎮 CATAN WITH GUARANTEED STATE CAPTURE")
     print("="*80)
-    print("\nEvery game action will be automatically saved!")
-    print("Press Ctrl+C anytime to stop and save.")
+    print("\n📝 Every game action will be automatically saved!")
+    print(f"🔄 Real-time state: {CURRENT_STATE_FILE}")
+    print("💾 Full history saved at end of game")
+    print("⌨️  Press Ctrl+C anytime to stop and save.")
     print("="*80 + "\n")
     
     # Patch the VisualizationManager's display_game_state
@@ -176,6 +202,9 @@ def main():
             state_copy = json.loads(json.dumps(self.current_game_state))
             captured_states.append(state_copy)
             print(f"[✅ Captured state #{len(captured_states)}]", flush=True)
+            
+            # Save current state to file (real-time update)
+            save_current_state(state_copy)
         
         return result
     

examples/ai_testing/sample_states/captured_game.json

@@ -115,21 +115,158 @@
       "has_robber": false
     }
   ],
-  "settlements": [],
+  "settlements": [
+    {
+      "id": "b_10",
+      "vertex": 10,
+      "player": 1
+    },
+    {
+      "id": "b_14",
+      "vertex": 14,
+      "player": 2
+    },
+    {
+      "id": "b_31",
+      "vertex": 31,
+      "player": 3
+    },
+    {
+      "id": "b_36",
+      "vertex": 36,
+      "player": 2
+    },
+    {
+      "id": "b_40",
+      "vertex": 40,
+      "player": 1
+    },
+    {
+      "id": "b_44",
+      "vertex": 44,
+      "player": 3
+    }
+  ],
   "cities": [],
-  "roads": [],
+  "roads": [
+    {
+      "id": 1,
+      "from": 10,
+      "to": 11,
+      "player": 1
+    },
+    {
+      "id": 2,
+      "from": 14,
+      "to": 13,
+      "player": 2
+    },
+    {
+      "id": 3,
+      "from": 31,
+      "to": 30,
+      "player": 3
+    },
+    {
+      "id": 4,
+      "from": 44,
+      "to": 43,
+      "player": 3
+    },
+    {
+      "id": 5,
+      "from": 36,
+      "to": 35,
+      "player": 2
+    },
+    {
+      "id": 6,
+      "from": 40,
+      "to": 41,
+      "player": 1
+    }
+  ],
+  "harbors": [
+    {
+      "id": 1,
+      "type": "any",
+      "ratio": 3,
+      "point_one": 9,
+      "point_two": 8
+    },
+    {
+      "id": 2,
+      "type": "sheep",
+      "ratio": 2,
+      "point_one": 17,
+      "point_two": 28
+    },
+    {
+      "id": 3,
+      "type": "wood",
+      "ratio": 2,
+      "point_one": 40,
+      "point_two": 48
+    },
+    {
+      "id": 4,
+      "type": "any",
+      "ratio": 3,
+      "point_one": 50,
+      "point_two": 51
+    },
+    {
+      "id": 5,
+      "type": "any",
+      "ratio": 3,
+      "point_one": 53,
+      "point_two": 54
+    },
+    {
+      "id": 6,
+      "type": "any",
+      "ratio": 3,
+      "point_one": 37,
+      "point_two": 38
+    },
+    {
+      "id": 7,
+      "type": "ore",
+      "ratio": 2,
+      "point_one": 26,
+      "point_two": 16
+    },
+    {
+      "id": 8,
+      "type": "brick",
+      "ratio": 2,
+      "point_one": 7,
+      "point_two": 6
+    },
+    {
+      "id": 9,
+      "type": "wheat",
+      "ratio": 2,
+      "point_one": 3,
+      "point_two": 2
+    }
+  ],
   "players": [
     {
       "id": 0,
       "name": "a",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
+      "victory_points": 2,
+      "total_cards": 3,
+      "cards_list": [
+        "ore",
+        "brick",
+        "sheep"
+      ],
       "dev_cards_list": [],
-      "settlements": 0,
+      "settlements": 2,
       "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
+      "roads": 2,
+      "longest_road": 1,
       "has_longest_road": false,
       "knights": 0,
       "knights_played": 0,
@@ -138,14 +275,19 @@
     {
       "id": 1,
       "name": "b",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
+      "victory_points": 2,
+      "total_cards": 4,
+      "cards_list": [
+        "sheep",
+        "sheep",
+        "ore",
+        "wheat"
+      ],
       "dev_cards_list": [],
-      "settlements": 0,
+      "settlements": 2,
       "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
+      "roads": 2,
+      "longest_road": 1,
       "has_longest_road": false,
       "knights": 0,
       "knights_played": 0,
@@ -154,22 +296,26 @@
     {
       "id": 2,
       "name": "c",
-      "victory_points": 0,
-      "total_cards": 0,
-      "cards_list": [],
+      "victory_points": 2,
+      "total_cards": 3,
+      "cards_list": [
+        "ore",
+        "wheat",
+        "wheat"
+      ],
       "dev_cards_list": [],
-      "settlements": 0,
+      "settlements": 2,
       "cities": 0,
-      "roads": 0,
-      "longest_road": 0,
+      "roads": 2,
+      "longest_road": 1,
       "has_longest_road": false,
       "knights": 0,
       "knights_played": 0,
       "has_largest_army": false
     }
   ],
-  "current_player": 0,
-  "current_phase": "SETUP_FIRST_ROUND",
+  "current_player": 1,
+  "current_phase": "NORMAL_PLAY",
   "robber_position": [
     2,
     2

pycatan/core/game.py

@@ -483,10 +483,23 @@ class Game:
         ports = []
         for harbor in self.board.harbors:
             if harbor:
+                # Get point coordinates for harbor location
+                point_one_coords = harbor.point_one.position if hasattr(harbor.point_one, 'position') else [0, 0]
+                point_two_coords = harbor.point_two.position if hasattr(harbor.point_two, 'position') else [0, 0]
+                
+                # Convert points to point IDs using BoardDefinition
+                from pycatan.config.board_definition import board_definition
+                point_one_id = board_definition.game_coords_to_point_id(point_one_coords[0], point_one_coords[1])
+                point_two_id = board_definition.game_coords_to_point_id(point_two_coords[0], point_two_coords[1])
+                
+                # Determine ratio based on harbor type
+                ratio = 2 if harbor.type.name.lower() != 'any' else 3
+                
                 port_info = {
-                    'position': getattr(harbor, 'position', [0, 0]),
+                    'point_one': point_one_id,
+                    'point_two': point_two_id,
                     'resource': harbor.type.name.lower() if hasattr(harbor.type, 'name') else 'any',
-                    'ratio': getattr(harbor, 'ratio', 3)
+                    'ratio': ratio
                 }
                 ports.append(port_info)
         return ports

pycatan/static/css/style.css

@@ -220,6 +220,20 @@ h1 {
     pointer-events: none;
 }
 
+/* נמלים */
+.harbor {
+    pointer-events: none;
+}
+
+.harbor circle {
+    filter: drop-shadow(2px 2px 4px rgba(0,0,0,0.4));
+}
+
+.harbor text {
+    pointer-events: none;
+    user-select: none;
+}
+
 /* יישובים */
 .settlement {
     stroke: #2c3e50;

pycatan/static/js/board.js

@@ -527,6 +527,128 @@ class CatanBoard {
         this.svg.appendChild(line);
     }
     
+    createHarbor(harbor) {
+        // Harbor is positioned on an edge between two points
+        // We'll place it at the midpoint between the two vertices
+        
+        // Harbor types: 'wood', 'sheep', 'brick', 'wheat', 'ore', 'any'
+        // Harbor ratios: 2 (for specific resource) or 3 (for any resource)
+        
+        const harborTypeColors = {
+            'wood': '#228B22',     // Forest Green
+            'sheep': '#90EE90',    // Light Green
+            'brick': '#CD5C5C',    // Indian Red
+            'wheat': '#FFD700',    // Gold
+            'ore': '#696969',      // Dim Gray
+            'any': '#4169E1'       // Royal Blue
+        };
+        
+        const harborTypeIcons = {
+            'wood': '🌲',
+            'sheep': '🐑',
+            'brick': '🧱',
+            'wheat': '🌾',
+            'ore': '⛰️',
+            'any': '🏪'
+        };
+        
+        // Find the two vertices for this harbor
+        const pointOne = this.getVertexByPointId(harbor.point_one);
+        const pointTwo = this.getVertexByPointId(harbor.point_two);
+        
+        if (!pointOne || !pointTwo) {
+            console.warn(`Could not find vertices for harbor ${harbor.id}: points ${harbor.point_one} and ${harbor.point_two}`);
+            return;
+        }
+        
+        // Calculate midpoint between the two vertices
+        const midX = (pointOne.x + pointTwo.x) / 2;
+        const midY = (pointOne.y + pointTwo.y) / 2;
+        
+        // Calculate direction vector to push harbor outward from the board
+        const centerX = this.centerX;
+        const centerY = this.centerY;
+        const dx = midX - centerX;
+        const dy = midY - centerY;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        
+        // Push harbor 45 pixels outward from the center
+        const offsetDist = 45;
+        const x = midX + (dx / dist) * offsetDist;
+        const y = midY + (dy / dist) * offsetDist;
+        
+        // Create harbor group
+        const harborGroup = document.createElementNS('http://www.w3.org/2000/svg', 'g');
+        harborGroup.setAttribute('class', 'harbor');
+        harborGroup.setAttribute('data-harbor-id', harbor.id);
+        harborGroup.setAttribute('data-harbor-type', harbor.type);
+        harborGroup.setAttribute('data-point-one', harbor.point_one);
+        harborGroup.setAttribute('data-point-two', harbor.point_two);
+        
+        // Create harbor circle background
+        const circle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+        circle.setAttribute('cx', x);
+        circle.setAttribute('cy', y);
+        circle.setAttribute('r', 16);
+        circle.setAttribute('fill', harborTypeColors[harbor.type] || '#4169E1');
+        circle.setAttribute('stroke', 'white');
+        circle.setAttribute('stroke-width', 2.5);
+        circle.setAttribute('opacity', '0.95');
+        
+        // Create harbor icon/text
+        const text = document.createElementNS('http://www.w3.org/2000/svg', 'text');
+        text.setAttribute('x', x);
+        text.setAttribute('y', y + 5);
+        text.setAttribute('text-anchor', 'middle');
+        text.setAttribute('fill', 'white');
+        text.setAttribute('font-size', '14');
+        text.textContent = harborTypeIcons[harbor.type] || '🏪';
+        
+        // Create harbor ratio text (smaller, below the circle)
+        const ratioText = document.createElementNS('http://www.w3.org/2000/svg', 'text');
+        ratioText.setAttribute('x', x);
+        ratioText.setAttribute('y', y + 26);
+        ratioText.setAttribute('text-anchor', 'middle');
+        ratioText.setAttribute('fill', 'white');
+        ratioText.setAttribute('font-size', '8');
+        ratioText.setAttribute('font-weight', 'bold');
+        ratioText.textContent = `${harbor.ratio}:1`;
+        
+        // Create lines connecting harbor to both vertices
+        const line1 = document.createElementNS('http://www.w3.org/2000/svg', 'line');
+        line1.setAttribute('x1', pointOne.x);
+        line1.setAttribute('y1', pointOne.y);
+        line1.setAttribute('x2', x);
+        line1.setAttribute('y2', y);
+        line1.setAttribute('stroke', harborTypeColors[harbor.type] || '#4169E1');
+        line1.setAttribute('stroke-width', 2.5);
+        line1.setAttribute('opacity', '0.7');
+        
+        const line2 = document.createElementNS('http://www.w3.org/2000/svg', 'line');
+        line2.setAttribute('x1', pointTwo.x);
+        line2.setAttribute('y1', pointTwo.y);
+        line2.setAttribute('x2', x);
+        line2.setAttribute('y2', y);
+        line2.setAttribute('stroke', harborTypeColors[harbor.type] || '#4169E1');
+        line2.setAttribute('stroke-width', 2.5);
+        line2.setAttribute('opacity', '0.7');
+        
+        // Add tooltip
+        const title = document.createElementNS('http://www.w3.org/2000/svg', 'title');
+        title.textContent = `Harbor: ${harbor.type} (${harbor.ratio}:1 trade)\nPoints: ${harbor.point_one}-${harbor.point_two}`;
+        harborGroup.appendChild(title);
+        
+        // Add lines first (so they appear behind the circle)
+        harborGroup.appendChild(line1);
+        harborGroup.appendChild(line2);
+        harborGroup.appendChild(circle);
+        harborGroup.appendChild(text);
+        harborGroup.appendChild(ratioText);
+        this.svg.appendChild(harborGroup);
+        
+        console.log(`🏪 Created harbor: ${harbor.type} (${harbor.ratio}:1) at points ${harbor.point_one}-${harbor.point_two}`);
+    }
+    
     // Update board from game state (called when receiving updates from server)
     updateFromGameState(gameState) {
         console.log('Updating board from game state:', gameState);
@@ -551,6 +673,14 @@ class CatanBoard {
         // Create vertices
         this.createVertices();
         
+        // Add harbors from game state (before buildings so they appear behind)
+        if (gameState.harbors && gameState.harbors.length > 0) {
+            console.log(`Creating ${gameState.harbors.length} harbors from server data`);
+            gameState.harbors.forEach(harbor => {
+                this.createHarbor(harbor);
+            });
+        }
+        
         // Add buildings from server data
         this.updateBuildings(gameState);
         this.updateRobberFromGameState(gameState);

pycatan/visualizations/web_visualization.py

@@ -278,6 +278,7 @@ class WebVisualization(Visualization):
             'settlements': [],
             'cities': [],
             'roads': [],
+            'harbors': [],
             'players': [],
             'current_player': getattr(game_state, 'current_player', 0),
             'current_phase': getattr(game_state, 'game_phase', 'ACTION').name if hasattr(getattr(game_state, 'game_phase', None), 'name') else str(getattr(game_state, 'game_phase', 'ACTION')),
@@ -294,6 +295,10 @@ class WebVisualization(Visualization):
             if hasattr(game_state.board_state, 'tiles'):
                 web_state['hexes'] = self._convert_hexes(game_state.board_state.tiles)
             
+            # Convert harbors
+            if hasattr(game_state.board_state, 'harbors'):
+                web_state['harbors'] = self._convert_harbors(game_state.board_state.harbors)
+            
             # Find robber position
             web_state['robber_position'] = self._find_robber_position(game_state.board_state)
         
@@ -396,6 +401,51 @@ class WebVisualization(Visualization):
         
         return hexes
     
+    def _convert_harbors(self, harbors) -> List[Dict[str, Any]]:
+        """
+        Convert harbors to web format.
+        
+        Args:
+            harbors: List of harbor dictionaries from GameState
+            
+        Returns:
+            List of harbor data for web display
+        """
+        web_harbors = []
+        
+        if not harbors:
+            return web_harbors
+        
+        for i, harbor in enumerate(harbors):
+            if isinstance(harbor, dict):
+                # Harbor from Game._get_ports_info (new format)
+                harbor_data = {
+                    'id': i + 1,
+                    'type': harbor.get('resource', 'any'),  # 'wood', 'sheep', 'brick', 'wheat', 'ore', 'any'
+                    'ratio': harbor.get('ratio', 3),  # 2 or 3
+                    'point_one': harbor.get('point_one', 0),  # Point ID of first vertex
+                    'point_two': harbor.get('point_two', 0),  # Point ID of second vertex
+                }
+                web_harbors.append(harbor_data)
+            else:
+                # Harbor object (fallback for older code)
+                harbor_type = getattr(harbor, 'type', None)
+                if harbor_type:
+                    # Convert HarborType enum to string
+                    type_name = harbor_type.name.lower() if hasattr(harbor_type, 'name') else 'any'
+                    ratio = 2 if type_name != 'any' else 3
+                    
+                    harbor_data = {
+                        'id': i + 1,
+                        'type': type_name,
+                        'ratio': ratio,
+                        'point_one': 0,
+                        'point_two': 0
+                    }
+                    web_harbors.append(harbor_data)
+        
+        return web_harbors
+    
     def _get_points_info(self) -> List[Dict[str, Any]]:
         """
         Get complete information about all points on the board.

temp_viz_console.py

@@ -0,0 +1,31 @@
+
+# -*- coding: utf-8 -*-
+import sys
+import time
+import os
+
+log_file = r"c:\GIT_new\PyCatan_AI\logs\game_viz.log"
+
+print("PyCatan - Game Visualization Console")
+print("=" * 50)
+print("This window shows real-time game state updates.")
+print("Keep this window open while playing!")
+print("=" * 50)
+print(f"Reading from: {log_file}")
+
+# Wait for file to exist
+while not os.path.exists(log_file):
+    time.sleep(0.1)
+
+# Tail the file
+with open(log_file, 'r', encoding='utf-8') as f:
+    # Go to the end of file
+    # f.seek(0, 2) 
+    # Actually start from beginning since we just created it
+    
+    while True:
+        line = f.readline()
+        if line:
+            print(line, end='')
+        else:
+            time.sleep(0.1)

test_harbors_display.py

@@ -0,0 +1,70 @@
+"""
+Quick test to verify harbors are displayed in web visualization.
+"""
+
+from pycatan.core.game import Game
+from pycatan.visualizations.web_visualization import WebVisualization
+import time
+
+def test_harbors():
+    print("🧪 Testing Harbor Display in Web Visualization")
+    print("=" * 60)
+    
+    # Create a simple game
+    print("1. Creating game with 3 players...")
+    game = Game(num_of_players=3)
+    
+    # Get full game state
+    print("2. Getting game state...")
+    game_state = game.get_full_state()
+    
+    # Check if harbors are in the state
+    print(f"3. Checking harbors in board_state...")
+    if hasattr(game_state.board_state, 'harbors'):
+        harbors = game_state.board_state.harbors
+        print(f"   ✓ Found {len(harbors)} harbors!")
+        
+        # Print first few harbors
+        for i, harbor in enumerate(harbors[:3]):
+            print(f"   Harbor {i+1}: {harbor}")
+    else:
+        print("   ✗ No harbors found in board_state!")
+        return
+    
+    # Create web visualization
+    print("\n4. Creating web visualization...")
+    web_viz = WebVisualization(port=5000, auto_open=True)
+    
+    # Update with game state
+    print("5. Updating visualization with game state...")
+    web_viz.update_full_state(game_state)
+    
+    # Check converted state
+    if web_viz.current_game_state and 'harbors' in web_viz.current_game_state:
+        converted_harbors = web_viz.current_game_state['harbors']
+        print(f"   ✓ Converted {len(converted_harbors)} harbors for web display!")
+        
+        # Print first few converted harbors
+        for i, harbor in enumerate(converted_harbors[:3]):
+            print(f"   Harbor {i+1}: type={harbor['type']}, ratio={harbor['ratio']}, points={harbor.get('point_one')}-{harbor.get('point_two')}")
+    else:
+        print("   ✗ No harbors in converted state!")
+        return
+    
+    # Start the server
+    print("\n6. Starting web server...")
+    print("   → Open http://localhost:5000 to see the game board")
+    print("   → Harbors should appear at the top of the board")
+    print("   → Press Ctrl+C to stop the server")
+    
+    web_viz.start()
+    
+    # Keep running
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        print("\n\n✓ Test completed!")
+
+if __name__ == "__main__":
+    test_harbors()