feat: NCS-37 Add initial API structure and DTOs for NowChess application

.codesight/CODESIGHT.md

@@ -47,14 +47,21 @@
   - class Square
   - function fromAlgebraic
   - function offset
+- `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala`
+  - class Bot
+  - function name
+  - function nextMove
+- `modules/api/src/main/scala/de/nowchess/api/dto/ErrorEventDto.scala` — class ErrorEventDto, function apply
+- `modules/api/src/main/scala/de/nowchess/api/dto/GameFullEventDto.scala` — class GameFullEventDto, function apply
+- `modules/api/src/main/scala/de/nowchess/api/dto/GameStateEventDto.scala` — class GameStateEventDto, function apply
 - `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`
+  - function kingSquare
   - function withBoard
   - function withTurn
   - function withCastlingRights
   - function withEnPassantSquare
   - function withHalfMoveClock
-  - function withMove
-  - _...2 more_
+  - _...4 more_
 - `modules/api/src/main/scala/de/nowchess/api/player/PlayerInfo.scala` — class PlayerId, function apply
 - `modules/api/src/main/scala/de/nowchess/api/response/ApiResponse.scala`
   - class ApiResponse
@@ -79,6 +86,7 @@
 - `modules/bot/python/src/export.py` — function export_to_nbai: (weights_file, output_file, trained_by, train_loss)
 - `modules/bot/python/src/generate.py` — function play_random_game_and_collect_positions: (output_file, total_positions, samples_per_game, min_move, max_move, num_workers)
 - `modules/bot/python/src/label.py` — function normalize_evaluation: (cp_value, method, scale), function label_positions_with_stockfish: (positions_file, output_file, stockfish_path, batch_size, depth, verbose, normalize, num_workers)
+- `modules/bot/python/src/lichess_importer.py` — function import_lichess_evals: (input_path, output_file, max_positions, min_depth, verbose) -> int
 - `modules/bot/python/src/tactical_positions_extractor.py`
   - function download_and_extract_puzzle_db: (url, output_dir)
   - function extract_puzzle_positions: (puzzle_csv, max_puzzles) -> Set[str]
@@ -90,14 +98,10 @@
   - function fen_to_features: (fen)
   - function find_next_version: (base_name)
   - function save_metadata: (weights_file, metadata)
-  - function train_nnue: (data_file, output_file, epochs, batch_size, lr, checkpoint, stockfish_depth, use_versioning, early_stopping_patience, weight_decay, subsample_ratio)
-  - function burst_train: (data_file, output_file, duration_minutes, epochs_per_season, early_stopping_patience, batch_size, lr, initial_checkpoint, stockfish_depth, use_versioning, weight_decay, subsample_ratio)
+  - function train_nnue: (data_file, output_file, epochs, batch_size, lr, checkpoint, stockfish_depth, use_versioning, early_stopping_patience, weight_decay, subsample_ratio, hidden_sizes)
+  - function burst_train: (data_file, output_file, duration_minutes, epochs_per_season, early_stopping_patience, batch_size, lr, initial_checkpoint, stockfish_depth, use_versioning, weight_decay, subsample_ratio, hidden_sizes)
   - class NNUEDataset
   - _...1 more_
-- `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala`
-  - class Bot
-  - function name
-  - function nextMove
 - `modules/bot/src/main/scala/de/nowchess/bot/BotController.scala`
   - class BotController
   - function getBot
@@ -148,7 +152,6 @@
   - function bestMoveWithTime
   - function loop
   - function loop
-  - _...2 more_
 - `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`
   - class MoveOrdering
   - class OrderingContext
@@ -158,6 +161,7 @@
   - function getHistory
   - _...3 more_
 - `modules/bot/src/main/scala/de/nowchess/bot/logic/TranspositionTable.scala`
+  - function advance
   - function probe
   - function store
   - function clear
@@ -181,14 +185,15 @@
   - function history
   - function getCurrentIndex
   - _...3 more_
+- `modules/core/src/main/scala/de/nowchess/chess/config/JacksonConfig.scala` — class JacksonConfig, function customize
 - `modules/core/src/main/scala/de/nowchess/chess/controller/Parser.scala` — class Parser, function parseMove
 - `modules/core/src/main/scala/de/nowchess/chess/engine/GameEngine.scala`
   - class GameEngine
-  - function isPendingPromotion
   - function board
   - function turn
   - function context
   - function canUndo
+  - function canRedo
   - _...11 more_
 - `modules/core/src/main/scala/de/nowchess/chess/observer/Observer.scala`
   - function context
@@ -198,6 +203,26 @@
   - function subscribe
   - function unsubscribe
   - _...1 more_
+- `modules/core/src/main/scala/de/nowchess/chess/registry/GameRegistry.scala`
+  - class GameRegistry
+  - function store
+  - function get
+  - function update
+  - function generateId
+- `modules/core/src/main/scala/de/nowchess/chess/registry/GameRegistryImpl.scala`
+  - class GameRegistryImpl
+  - function store
+  - function get
+  - function update
+  - function generateId
+- `modules/core/src/main/scala/de/nowchess/chess/resource/GameResource.scala`
+  - function onGameEvent
+  - function createGame
+  - function getGame
+  - function streamGame
+  - function onGameEvent
+  - function resignGame
+  - _...9 more_
 - `modules/io/src/main/scala/de/nowchess/io/GameContextExport.scala` — class GameContextExport, function exportGameContext
 - `modules/io/src/main/scala/de/nowchess/io/GameContextImport.scala` — class GameContextImport, function importGameContext
 - `modules/io/src/main/scala/de/nowchess/io/GameFileService.scala`
@@ -247,32 +272,13 @@
   - function allLegalMoves
   - function isCheck
   - function isCheckmate
-  - _...4 more_
+  - _...5 more_
 - `modules/rule/src/main/scala/de/nowchess/rules/sets/DefaultRules.scala`
   - class DefaultRules
+  - function positionOf
   - function loop
   - function toMoves
   - function loop
-- `modules/ui/src/main/scala/de/nowchess/ui/Main.scala` — class Main, function main
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/ChessBoardView.scala`
-  - class ChessBoardView
-  - function updateBoard
-  - function updateUndoRedoButtons
-  - function showMessage
-  - function showPromotionDialog
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/ChessGUI.scala`
-  - class ChessGUIApp
-  - class ChessGUILauncher
-  - function getEngine
-  - function launch
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/GUIObserver.scala` — class GUIObserver
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/PieceSprites.scala`
-  - class PieceSprites
-  - function loadPieceImage
-  - class SquareColors
-- `modules/ui/src/main/scala/de/nowchess/ui/terminal/TerminalUI.scala` — class TerminalUI, function start
-- `modules/ui/src/main/scala/de/nowchess/ui/utils/PieceUnicode.scala` — function unicode
-- `modules/ui/src/main/scala/de/nowchess/ui/utils/Renderer.scala` — class Renderer, function render
 
 ---
 
@@ -295,39 +301,39 @@
 
 ## Most Imported Files (change these carefully)
 
-- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` — imported by **60** files
-- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` — imported by **40** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` — imported by **39** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` — imported by **36** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` — imported by **22** files
-- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` — imported by **21** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` — imported by **21** files
+- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` — imported by **64** files
+- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` — imported by **44** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` — imported by **40** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` — imported by **35** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` — imported by **19** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` — imported by **18** files
+- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` — imported by **17** files
 - `modules/rule/src/main/scala/de/nowchess/rules/sets/DefaultRules.scala` — imported by **17** files
-- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` — imported by **10** files
+- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` — imported by **11** files
 - `modules/io/src/main/scala/de/nowchess/io/fen/FenParser.scala` — imported by **10** files
-- `modules/api/src/main/scala/de/nowchess/api/board/CastlingRights.scala` — imported by **8** files
-- `modules/io/src/main/scala/de/nowchess/io/GameContextImport.scala` — imported by **8** files
+- `modules/api/src/main/scala/de/nowchess/api/board/CastlingRights.scala` — imported by **9** files
+- `modules/api/src/main/scala/de/nowchess/api/game/DrawReason.scala` — imported by **7** files
+- `modules/io/src/main/scala/de/nowchess/io/GameContextImport.scala` — imported by **7** files
+- `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala` — imported by **6** files
+- `modules/bot/src/main/scala/de/nowchess/bot/ai/Evaluation.scala` — imported by **6** files
+- `modules/api/src/main/scala/de/nowchess/api/player/PlayerInfo.scala` — imported by **5** files
 - `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotBook.scala` — imported by **5** files
-- `modules/bot/src/main/scala/de/nowchess/bot/BotDifficulty.scala` — imported by **5** files
-- `modules/io/src/main/scala/de/nowchess/io/GameContextExport.scala` — imported by **5** files
+- `modules/api/src/main/scala/de/nowchess/api/game/GameResult.scala` — imported by **4** files
 - `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala` — imported by **4** files
 - `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala` — imported by **4** files
-- `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala` — imported by **4** files
-- `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala` — imported by **4** files
-- `modules/core/src/main/scala/de/nowchess/chess/observer/Observer.scala` — imported by **4** files
 
 ## Import Map (who imports what)
 
-- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala`, `modules/bot/src/main/scala/de/nowchess/bot/ai/Evaluation.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala` +55 more
-- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/board/BoardTest.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala` +35 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/main/scala/de/nowchess/api/move/Move.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/api/src/test/scala/de/nowchess/api/move/MoveTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala` +34 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala` +31 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +17 more
-- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotHash.scala` +16 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotHash.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/ZobristHash.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +16 more
+- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` ← `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala`, `modules/bot/src/main/scala/de/nowchess/bot/ai/Evaluation.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala` +59 more
+- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` ← `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala`, `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/board/BoardTest.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala` +39 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/main/scala/de/nowchess/api/move/Move.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/api/src/test/scala/de/nowchess/api/move/MoveTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala` +35 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/main/scala/de/nowchess/api/game/GameResult.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala` +30 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +14 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotHash.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/ZobristHash.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +13 more
+- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala` +12 more
 - `modules/rule/src/main/scala/de/nowchess/rules/sets/DefaultRules.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/NNUEBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +12 more
-- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/NNUEBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +5 more
-- `modules/io/src/main/scala/de/nowchess/io/fen/FenParser.scala` ← `modules/bot/src/test/scala/de/nowchess/bot/PolyglotHashTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/EngineTestHelpers.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineLoadGameTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineNotationTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEnginePromotionTest.scala` +5 more
+- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/NNUEBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +6 more
+- `modules/io/src/main/scala/de/nowchess/io/fen/FenParser.scala` ← `modules/bot/src/test/scala/de/nowchess/bot/PolyglotHashTest.scala`, `modules/core/src/main/scala/de/nowchess/chess/resource/GameResource.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/EngineTestHelpers.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineLoadGameTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineNotationTest.scala` +5 more
 
 ---
 

.codesight/graph.md

@@ -2,36 +2,36 @@
 
 ## Most Imported Files (change these carefully)
 
-- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` — imported by **60** files
-- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` — imported by **40** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` — imported by **39** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` — imported by **36** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` — imported by **22** files
-- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` — imported by **21** files
-- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` — imported by **21** files
+- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` — imported by **64** files
+- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` — imported by **44** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` — imported by **40** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` — imported by **35** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` — imported by **19** files
+- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` — imported by **18** files
+- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` — imported by **17** files
 - `modules/rule/src/main/scala/de/nowchess/rules/sets/DefaultRules.scala` — imported by **17** files
-- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` — imported by **10** files
+- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` — imported by **11** files
 - `modules/io/src/main/scala/de/nowchess/io/fen/FenParser.scala` — imported by **10** files
-- `modules/api/src/main/scala/de/nowchess/api/board/CastlingRights.scala` — imported by **8** files
-- `modules/io/src/main/scala/de/nowchess/io/GameContextImport.scala` — imported by **8** files
+- `modules/api/src/main/scala/de/nowchess/api/board/CastlingRights.scala` — imported by **9** files
+- `modules/api/src/main/scala/de/nowchess/api/game/DrawReason.scala` — imported by **7** files
+- `modules/io/src/main/scala/de/nowchess/io/GameContextImport.scala` — imported by **7** files
+- `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala` — imported by **6** files
+- `modules/bot/src/main/scala/de/nowchess/bot/ai/Evaluation.scala` — imported by **6** files
+- `modules/api/src/main/scala/de/nowchess/api/player/PlayerInfo.scala` — imported by **5** files
 - `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotBook.scala` — imported by **5** files
-- `modules/bot/src/main/scala/de/nowchess/bot/BotDifficulty.scala` — imported by **5** files
-- `modules/io/src/main/scala/de/nowchess/io/GameContextExport.scala` — imported by **5** files
+- `modules/api/src/main/scala/de/nowchess/api/game/GameResult.scala` — imported by **4** files
 - `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala` — imported by **4** files
 - `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala` — imported by **4** files
-- `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala` — imported by **4** files
-- `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala` — imported by **4** files
-- `modules/core/src/main/scala/de/nowchess/chess/observer/Observer.scala` — imported by **4** files
 
 ## Import Map (who imports what)
 
-- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala`, `modules/bot/src/main/scala/de/nowchess/bot/ai/Evaluation.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala` +55 more
-- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/board/BoardTest.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala` +35 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/main/scala/de/nowchess/api/move/Move.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/api/src/test/scala/de/nowchess/api/move/MoveTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala` +34 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala` +31 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +17 more
-- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotHash.scala` +16 more
-- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotHash.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/ZobristHash.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +16 more
+- `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala` ← `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala`, `modules/bot/src/main/scala/de/nowchess/bot/ai/Evaluation.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala` +59 more
+- `modules/api/src/main/scala/de/nowchess/api/move/Move.scala` ← `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala`, `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/board/BoardTest.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/BotMoveRepetition.scala` +39 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Square.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/main/scala/de/nowchess/api/move/Move.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/api/src/test/scala/de/nowchess/api/move/MoveTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala` +35 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Color.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/main/scala/de/nowchess/api/game/GameResult.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala` +30 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Board.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/api/src/test/scala/de/nowchess/api/game/GameContextTest.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +14 more
+- `modules/api/src/main/scala/de/nowchess/api/board/Piece.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/PolyglotHash.scala`, `modules/bot/src/main/scala/de/nowchess/bot/util/ZobristHash.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +13 more
+- `modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala` ← `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/classic/EvaluationClassic.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/nnue/NNUE.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala` +12 more
 - `modules/rule/src/main/scala/de/nowchess/rules/sets/DefaultRules.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/NNUEBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +12 more
-- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/NNUEBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +5 more
-- `modules/io/src/main/scala/de/nowchess/io/fen/FenParser.scala` ← `modules/bot/src/test/scala/de/nowchess/bot/PolyglotHashTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/EngineTestHelpers.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineLoadGameTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineNotationTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEnginePromotionTest.scala` +5 more
+- `modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala` ← `modules/bot/src/main/scala/de/nowchess/bot/bots/ClassicalBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/HybridBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/bots/NNUEBot.scala`, `modules/bot/src/main/scala/de/nowchess/bot/logic/AlphaBetaSearch.scala`, `modules/bot/src/test/scala/de/nowchess/bot/AlphaBetaSearchTest.scala` +6 more
+- `modules/io/src/main/scala/de/nowchess/io/fen/FenParser.scala` ← `modules/bot/src/test/scala/de/nowchess/bot/PolyglotHashTest.scala`, `modules/core/src/main/scala/de/nowchess/chess/resource/GameResource.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/EngineTestHelpers.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineLoadGameTest.scala`, `modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineNotationTest.scala` +5 more

.codesight/libs.md

@@ -38,14 +38,21 @@
   - class Square
   - function fromAlgebraic
   - function offset
+- `modules/api/src/main/scala/de/nowchess/api/bot/Bot.scala`
+  - class Bot
+  - function name
+  - function nextMove
+- `modules/api/src/main/scala/de/nowchess/api/dto/ErrorEventDto.scala` — class ErrorEventDto, function apply
+- `modules/api/src/main/scala/de/nowchess/api/dto/GameFullEventDto.scala` — class GameFullEventDto, function apply
+- `modules/api/src/main/scala/de/nowchess/api/dto/GameStateEventDto.scala` — class GameStateEventDto, function apply
 - `modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala`
+  - function kingSquare
   - function withBoard
   - function withTurn
   - function withCastlingRights
   - function withEnPassantSquare
   - function withHalfMoveClock
-  - function withMove
-  - _...2 more_
+  - _...4 more_
 - `modules/api/src/main/scala/de/nowchess/api/player/PlayerInfo.scala` — class PlayerId, function apply
 - `modules/api/src/main/scala/de/nowchess/api/response/ApiResponse.scala`
   - class ApiResponse
@@ -70,6 +77,7 @@
 - `modules/bot/python/src/export.py` — function export_to_nbai: (weights_file, output_file, trained_by, train_loss)
 - `modules/bot/python/src/generate.py` — function play_random_game_and_collect_positions: (output_file, total_positions, samples_per_game, min_move, max_move, num_workers)
 - `modules/bot/python/src/label.py` — function normalize_evaluation: (cp_value, method, scale), function label_positions_with_stockfish: (positions_file, output_file, stockfish_path, batch_size, depth, verbose, normalize, num_workers)
+- `modules/bot/python/src/lichess_importer.py` — function import_lichess_evals: (input_path, output_file, max_positions, min_depth, verbose) -> int
 - `modules/bot/python/src/tactical_positions_extractor.py`
   - function download_and_extract_puzzle_db: (url, output_dir)
   - function extract_puzzle_positions: (puzzle_csv, max_puzzles) -> Set[str]
@@ -81,14 +89,10 @@
   - function fen_to_features: (fen)
   - function find_next_version: (base_name)
   - function save_metadata: (weights_file, metadata)
-  - function train_nnue: (data_file, output_file, epochs, batch_size, lr, checkpoint, stockfish_depth, use_versioning, early_stopping_patience, weight_decay, subsample_ratio)
-  - function burst_train: (data_file, output_file, duration_minutes, epochs_per_season, early_stopping_patience, batch_size, lr, initial_checkpoint, stockfish_depth, use_versioning, weight_decay, subsample_ratio)
+  - function train_nnue: (data_file, output_file, epochs, batch_size, lr, checkpoint, stockfish_depth, use_versioning, early_stopping_patience, weight_decay, subsample_ratio, hidden_sizes)
+  - function burst_train: (data_file, output_file, duration_minutes, epochs_per_season, early_stopping_patience, batch_size, lr, initial_checkpoint, stockfish_depth, use_versioning, weight_decay, subsample_ratio, hidden_sizes)
   - class NNUEDataset
   - _...1 more_
-- `modules/bot/src/main/scala/de/nowchess/bot/Bot.scala`
-  - class Bot
-  - function name
-  - function nextMove
 - `modules/bot/src/main/scala/de/nowchess/bot/BotController.scala`
   - class BotController
   - function getBot
@@ -139,7 +143,6 @@
   - function bestMoveWithTime
   - function loop
   - function loop
-  - _...2 more_
 - `modules/bot/src/main/scala/de/nowchess/bot/logic/MoveOrdering.scala`
   - class MoveOrdering
   - class OrderingContext
@@ -149,6 +152,7 @@
   - function getHistory
   - _...3 more_
 - `modules/bot/src/main/scala/de/nowchess/bot/logic/TranspositionTable.scala`
+  - function advance
   - function probe
   - function store
   - function clear
@@ -172,14 +176,15 @@
   - function history
   - function getCurrentIndex
   - _...3 more_
+- `modules/core/src/main/scala/de/nowchess/chess/config/JacksonConfig.scala` — class JacksonConfig, function customize
 - `modules/core/src/main/scala/de/nowchess/chess/controller/Parser.scala` — class Parser, function parseMove
 - `modules/core/src/main/scala/de/nowchess/chess/engine/GameEngine.scala`
   - class GameEngine
-  - function isPendingPromotion
   - function board
   - function turn
   - function context
   - function canUndo
+  - function canRedo
   - _...11 more_
 - `modules/core/src/main/scala/de/nowchess/chess/observer/Observer.scala`
   - function context
@@ -189,6 +194,26 @@
   - function subscribe
   - function unsubscribe
   - _...1 more_
+- `modules/core/src/main/scala/de/nowchess/chess/registry/GameRegistry.scala`
+  - class GameRegistry
+  - function store
+  - function get
+  - function update
+  - function generateId
+- `modules/core/src/main/scala/de/nowchess/chess/registry/GameRegistryImpl.scala`
+  - class GameRegistryImpl
+  - function store
+  - function get
+  - function update
+  - function generateId
+- `modules/core/src/main/scala/de/nowchess/chess/resource/GameResource.scala`
+  - function onGameEvent
+  - function createGame
+  - function getGame
+  - function streamGame
+  - function onGameEvent
+  - function resignGame
+  - _...9 more_
 - `modules/io/src/main/scala/de/nowchess/io/GameContextExport.scala` — class GameContextExport, function exportGameContext
 - `modules/io/src/main/scala/de/nowchess/io/GameContextImport.scala` — class GameContextImport, function importGameContext
 - `modules/io/src/main/scala/de/nowchess/io/GameFileService.scala`
@@ -238,29 +263,10 @@
   - function allLegalMoves
   - function isCheck
   - function isCheckmate
-  - _...4 more_
+  - _...5 more_
 - `modules/rule/src/main/scala/de/nowchess/rules/sets/DefaultRules.scala`
   - class DefaultRules
+  - function positionOf
   - function loop
   - function toMoves
   - function loop
-- `modules/ui/src/main/scala/de/nowchess/ui/Main.scala` — class Main, function main
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/ChessBoardView.scala`
-  - class ChessBoardView
-  - function updateBoard
-  - function updateUndoRedoButtons
-  - function showMessage
-  - function showPromotionDialog
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/ChessGUI.scala`
-  - class ChessGUIApp
-  - class ChessGUILauncher
-  - function getEngine
-  - function launch
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/GUIObserver.scala` — class GUIObserver
-- `modules/ui/src/main/scala/de/nowchess/ui/gui/PieceSprites.scala`
-  - class PieceSprites
-  - function loadPieceImage
-  - class SquareColors
-- `modules/ui/src/main/scala/de/nowchess/ui/terminal/TerminalUI.scala` — class TerminalUI, function start
-- `modules/ui/src/main/scala/de/nowchess/ui/utils/PieceUnicode.scala` — function unicode
-- `modules/ui/src/main/scala/de/nowchess/ui/utils/Renderer.scala` — class Renderer, function render

.codesight/report.html

@@ -0,0 +1,198 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>NowChessSystems — codesight report</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+:root{--bg:#0a0a0f;--card:#12121a;--border:#1e1e2e;--text:#e0e0e8;--muted:#6b6b80;--accent:#6366f1;--accent2:#22d3ee;--green:#22c55e;--orange:#f59e0b;--red:#ef4444;--pink:#ec4899}
+body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;padding:2rem;max-width:1400px;margin:0 auto;line-height:1.6}
+h1{font-size:2.5rem;font-weight:800;background:linear-gradient(135deg,var(--accent),var(--accent2));-webkit-background-clip:text;-webkit-text-fill-color:transparent;margin-bottom:.25rem}
+.subtitle{color:var(--muted);font-size:1rem;margin-bottom:2rem}
+.stack-badge{display:inline-block;background:var(--card);border:1px solid var(--border);border-radius:6px;padding:2px 10px;font-size:.85rem;color:var(--accent2);margin:0 4px 4px 0}
+.stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:1rem;margin:2rem 0}
+.stat{background:var(--card);border:1px solid var(--border);border-radius:12px;padding:1.25rem;text-align:center}
+.stat-value{font-size:2rem;font-weight:800;background:linear-gradient(135deg,var(--accent),var(--accent2));-webkit-background-clip:text;-webkit-text-fill-color:transparent}
+.stat-label{color:var(--muted);font-size:.85rem;margin-top:.25rem}
+.token-hero{background:linear-gradient(135deg,#1a1a2e,#16213e);border:1px solid var(--accent);border-radius:16px;padding:2rem;margin:2rem 0;text-align:center}
+.token-saved{font-size:3rem;font-weight:900;color:var(--green)}
+.token-detail{color:var(--muted);font-size:.9rem;margin-top:.5rem}
+.section{margin:2.5rem 0}
+.section h2{font-size:1.4rem;font-weight:700;margin-bottom:1rem;padding-bottom:.5rem;border-bottom:1px solid var(--border)}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(320px,1fr));gap:1rem}
+.card{background:var(--card);border:1px solid var(--border);border-radius:10px;padding:1rem;transition:border-color .2s}
+.card:hover{border-color:var(--accent)}
+.card-title{font-weight:700;font-size:1rem;margin-bottom:.5rem}
+.card-meta{color:var(--muted);font-size:.8rem}
+.tag{display:inline-block;background:rgba(99,102,241,.15);color:var(--accent);border-radius:4px;padding:1px 6px;font-size:.75rem;margin:1px}
+.tag-auth{background:rgba(239,68,68,.15);color:var(--red)}
+.tag-db{background:rgba(34,211,238,.15);color:var(--accent2)}
+.tag-ai{background:rgba(236,72,153,.15);color:var(--pink)}
+.tag-payment{background:rgba(245,158,11,.15);color:var(--orange)}
+.tag-email{background:rgba(34,197,94,.15);color:var(--green)}
+.tag-queue{background:rgba(168,85,247,.15);color:#a855f7}
+.tag-cache{background:rgba(245,158,11,.15);color:var(--orange)}
+.method{font-weight:700;font-size:.8rem;padding:2px 6px;border-radius:4px;margin-right:6px}
+.method-GET{background:rgba(34,197,94,.2);color:var(--green)}
+.method-POST{background:rgba(99,102,241,.2);color:var(--accent)}
+.method-PUT{background:rgba(245,158,11,.2);color:var(--orange)}
+.method-PATCH{background:rgba(245,158,11,.2);color:var(--orange)}
+.method-DELETE{background:rgba(239,68,68,.2);color:var(--red)}
+.method-ALL{background:rgba(107,107,128,.2);color:var(--muted)}
+.route-path{font-family:'Fira Code',monospace;font-size:.9rem}
+.route-contract{color:var(--muted);font-size:.8rem;font-style:italic;margin-left:.5rem}
+.field{display:flex;gap:.5rem;padding:3px 0;font-size:.9rem}
+.field-name{font-family:monospace;color:var(--accent2)}
+.field-type{color:var(--muted);font-family:monospace}
+.field-flags{display:flex;gap:3px}
+.flag{font-size:.7rem;padding:0 4px;border-radius:3px;background:rgba(99,102,241,.1);color:var(--accent)}
+.flag-pk{background:rgba(245,158,11,.2);color:var(--orange)}
+.flag-fk{background:rgba(34,211,238,.2);color:var(--accent2)}
+.flag-unique{background:rgba(236,72,153,.2);color:var(--pink)}
+.hot-bar{height:8px;background:linear-gradient(90deg,var(--accent),var(--accent2));border-radius:4px;margin-top:4px}
+.component-props{color:var(--muted);font-size:.85rem}
+.badge-client{background:rgba(34,197,94,.15);color:var(--green);font-size:.75rem;padding:1px 6px;border-radius:4px}
+.badge-server{background:rgba(99,102,241,.15);color:var(--accent);font-size:.75rem;padding:1px 6px;border-radius:4px}
+.env-required{color:var(--red);font-weight:600;font-size:.8rem}
+.env-default{color:var(--green);font-size:.8rem}
+.footer{text-align:center;color:var(--muted);margin-top:4rem;padding-top:2rem;border-top:1px solid var(--border);font-size:.85rem}
+.footer a{color:var(--accent);text-decoration:none}
+table{width:100%;border-collapse:collapse}
+table td,table th{padding:8px 12px;text-align:left;border-bottom:1px solid var(--border);font-size:.9rem}
+table th{color:var(--muted);font-size:.8rem;font-weight:600;text-transform:uppercase}
+</style>
+</head>
+<body>
+
+<h1>NowChessSystems</h1>
+<div class="subtitle">AI Context Map — generated by codesight</div>
+
+<div>
+<span class="stack-badge">raw-http</span>
+
+<span class="stack-badge">unknown</span>
+<span class="stack-badge">scala</span>
+
+</div>
+
+<div class="token-hero">
+  <div class="token-saved">~20,573 tokens saved</div>
+  <div class="token-detail">
+    Output: 5,297 tokens — Exploration cost without codesight: ~25,870 tokens — 149 files scanned
+  </div>
+</div>
+
+<div class="stats">
+  <div class="stat"><div class="stat-value">0</div><div class="stat-label">Routes</div></div>
+  <div class="stat"><div class="stat-value">0</div><div class="stat-label">Models</div></div>
+  <div class="stat"><div class="stat-value">0</div><div class="stat-label">Components</div></div>
+  <div class="stat"><div class="stat-value">63</div><div class="stat-label">Libraries</div></div>
+  <div class="stat"><div class="stat-value">1</div><div class="stat-label">Env Vars</div></div>
+  <div class="stat"><div class="stat-value">1</div><div class="stat-label">Middleware</div></div>
+  <div class="stat"><div class="stat-value">383</div><div class="stat-label">Import Links</div></div>
+</div>
+
+
+
+
+
+
+
+
+<div class="section">
+<h2>Dependency Hot Files</h2>
+<div class="grid">
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/game/GameContext.scala</div>
+  <div class="card-meta">imported by 64 files</div>
+  <div class="hot-bar" style="width:100%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/move/Move.scala</div>
+  <div class="card-meta">imported by 44 files</div>
+  <div class="hot-bar" style="width:69%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/board/Square.scala</div>
+  <div class="card-meta">imported by 40 files</div>
+  <div class="hot-bar" style="width:63%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/board/Color.scala</div>
+  <div class="card-meta">imported by 35 files</div>
+  <div class="hot-bar" style="width:55%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/board/Board.scala</div>
+  <div class="card-meta">imported by 19 files</div>
+  <div class="hot-bar" style="width:30%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/board/Piece.scala</div>
+  <div class="card-meta">imported by 18 files</div>
+  <div class="hot-bar" style="width:28%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/board/PieceType.scala</div>
+  <div class="card-meta">imported by 17 files</div>
+  <div class="hot-bar" style="width:27%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/rule/src/main/scala/de/nowchess/rules/sets/DefaultRules.scala</div>
+  <div class="card-meta">imported by 17 files</div>
+  <div class="hot-bar" style="width:27%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/rule/src/main/scala/de/nowchess/rules/RuleSet.scala</div>
+  <div class="card-meta">imported by 11 files</div>
+  <div class="hot-bar" style="width:17%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/io/src/main/scala/de/nowchess/io/fen/FenParser.scala</div>
+  <div class="card-meta">imported by 10 files</div>
+  <div class="hot-bar" style="width:16%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/board/CastlingRights.scala</div>
+  <div class="card-meta">imported by 9 files</div>
+  <div class="hot-bar" style="width:14%"></div>
+</div>
+<div class="card">
+  <div class="card-title" style="font-size:.9rem">modules/api/src/main/scala/de/nowchess/api/game/DrawReason.scala</div>
+  <div class="card-meta">imported by 7 files</div>
+  <div class="hot-bar" style="width:11%"></div>
+</div>
+</div>
+</div>
+
+
+<div class="section">
+<h2>Environment Variables</h2>
+<table>
+<tr><th>Variable</th><th>Status</th><th>Source</th></tr>
+<tr>
+  <td><code>STOCKFISH_PATH</code></td>
+  <td><span class="env-required">required</span></td>
+  <td class="card-meta">modules/bot/python/nnue.py</td>
+</tr>
+</table>
+</div>
+
+
+<div class="section">
+<h2>Middleware</h2>
+<div class="grid">
+<div class="card">
+  <div class="card-title">generate <span class="tag tag-custom">custom</span></div>
+  <div class="card-meta">modules/bot/python/src/generate.py</div>
+</div>
+</div>
+</div>
+
+<div class="footer">
+  Generated by <a href="https://github.com/Houseofmvps/codesight">codesight</a> — see your codebase clearly
+</div>
+
+</body>
+</html>

.idea/gradle.xml

@@ -15,7 +15,6 @@
             <option value="$PROJECT_DIR$/modules/core" />
             <option value="$PROJECT_DIR$/modules/io" />
             <option value="$PROJECT_DIR$/modules/rule" />
-            <option value="$PROJECT_DIR$/modules/ui" />
           </set>
         </option>
       </GradleProjectSettings>

.idea/runConfigurations/NowChessSystems_modules_core_main.xml

@@ -0,0 +1,33 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="NowChessSystems.modules.core.main" type="QuarkusRunConfigurationType" factoryName="Quarkus" nameIsGenerated="true">
+    <module name="NowChessSystems.modules.core.main" />
+    <QsGradleRunConfiguration>
+      <ExternalSystemSettings>
+        <option name="executionName" />
+        <option name="externalProjectPath" value="$PROJECT_DIR$/modules/core" />
+        <option name="externalSystemIdString" value="GRADLE" />
+        <option name="scriptParameters" />
+        <option name="taskDescriptions">
+          <list />
+        </option>
+        <option name="taskNames">
+          <list>
+            <option value="quarkusDev" />
+          </list>
+        </option>
+        <option name="vmOptions" />
+      </ExternalSystemSettings>
+      <ExternalSystemDebugServerProcess>true</ExternalSystemDebugServerProcess>
+      <ExternalSystemReattachDebugProcess>true</ExternalSystemReattachDebugProcess>
+      <ExternalSystemDebugDisabled>false</ExternalSystemDebugDisabled>
+      <DebugAllEnabled>false</DebugAllEnabled>
+      <RunAsTest>false</RunAsTest>
+      <GradleProfilingDisabled>false</GradleProfilingDisabled>
+      <GradleCoverageDisabled>false</GradleCoverageDisabled>
+      <profile>dev</profile>
+    </QsGradleRunConfiguration>
+    <method v="2">
+      <option name="Make" enabled="true" />
+    </method>
+  </configuration>
+</component>

.idea/scala_compiler.xml

@@ -5,7 +5,7 @@
       <option name="deprecationWarnings" value="true" />
       <option name="uncheckedWarnings" value="true" />
     </profile>
-    <profile name="Gradle 2" modules="NowChessSystems.modules.bot.main,NowChessSystems.modules.bot.scoverage,NowChessSystems.modules.bot.test,NowChessSystems.modules.core.main,NowChessSystems.modules.core.scoverage,NowChessSystems.modules.core.test,NowChessSystems.modules.io.main,NowChessSystems.modules.io.scoverage,NowChessSystems.modules.io.test,NowChessSystems.modules.rule.main,NowChessSystems.modules.rule.scoverage,NowChessSystems.modules.rule.test,NowChessSystems.modules.ui.main,NowChessSystems.modules.ui.scoverage,NowChessSystems.modules.ui.test">
+    <profile name="Gradle 2" modules="NowChessSystems.modules.bot.main,NowChessSystems.modules.bot.scoverage,NowChessSystems.modules.bot.test,NowChessSystems.modules.core.integrationTest,NowChessSystems.modules.core.main,NowChessSystems.modules.core.native-test,NowChessSystems.modules.core.quarkus-generated-sources,NowChessSystems.modules.core.quarkus-test-generated-sources,NowChessSystems.modules.core.scoverage,NowChessSystems.modules.core.test,NowChessSystems.modules.io.main,NowChessSystems.modules.io.scoverage,NowChessSystems.modules.io.test,NowChessSystems.modules.rule.main,NowChessSystems.modules.rule.scoverage,NowChessSystems.modules.rule.test,NowChessSystems.modules.ui.main,NowChessSystems.modules.ui.scoverage,NowChessSystems.modules.ui.test">
       <option name="deprecationWarnings" value="true" />
       <option name="uncheckedWarnings" value="true" />
       <parameters>

bruno/bruno.json

@@ -0,0 +1,6 @@
+{
+  "version": "1",
+  "name": "NowChess API",
+  "type": "collection",
+  "ignore": []
+}

bruno/draw/01 Offer Draw.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Offer Draw
+  type: http
+  seq: 1
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/{{gameId}}/draw/offer
+  body: none
+  auth: none
+}

bruno/draw/02 Accept Draw.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Accept Draw
+  type: http
+  seq: 2
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/{{gameId}}/draw/accept
+  body: none
+  auth: none
+}

bruno/draw/03 Decline Draw.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Decline Draw
+  type: http
+  seq: 3
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/{{gameId}}/draw/decline
+  body: none
+  auth: none
+}

bruno/draw/04 Claim Draw.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Claim Draw
+  type: http
+  seq: 4
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/{{gameId}}/draw/claim
+  body: none
+  auth: none
+}

bruno/draw/folder.bru

@@ -0,0 +1,4 @@
+meta {
+  name: draw
+  seq: 2
+}

bruno/environments/local.bru

@@ -0,0 +1,3 @@
+vars {
+  baseUrl: http://localhost:8080
+}

bruno/export/01 Export FEN.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Export FEN
+  type: http
+  seq: 1
+}
+
+http {
+  method: GET
+  url: {{baseUrl}}/api/board/game/{{gameId}}/export/fen
+  body: none
+  auth: none
+}

bruno/export/02 Export PGN.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Export PGN
+  type: http
+  seq: 2
+}
+
+http {
+  method: GET
+  url: {{baseUrl}}/api/board/game/{{gameId}}/export/pgn
+  body: none
+  auth: none
+}

bruno/export/folder.bru

@@ -0,0 +1,4 @@
+meta {
+  name: export
+  seq: 6
+}

bruno/game/01 Create Game.bru

@@ -0,0 +1,23 @@
+meta {
+  name: Create Game
+  type: http
+  seq: 1
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game
+  body: json
+  auth: none
+}
+
+headers {
+  Content-Type: application/json
+}
+
+body:json {
+  {
+    "white": {"id": "p1", "displayName": "Alice"},
+    "black": {"id": "p2", "displayName": "Bob"}
+  }
+}

bruno/game/02 Get Game.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Get Game
+  type: http
+  seq: 2
+}
+
+http {
+  method: GET
+  url: {{baseUrl}}/api/board/game/{{gameId}}
+  body: none
+  auth: none
+}

bruno/game/03 Stream Game.bru

@@ -0,0 +1,19 @@
+meta {
+  name: Stream Game
+  type: http
+  seq: 3
+}
+
+get {
+  url: {{baseUrl}}/api/board/game/{{gameId}}/stream
+  body: none
+  auth: none
+}
+
+headers {
+  Accept: application/x-ndjson
+}
+
+vars:pre-request {
+  gameId: tjOgyEcS
+}

bruno/game/04 Resign.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Resign
+  type: http
+  seq: 4
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/{{gameId}}/resign
+  body: none
+  auth: none
+}

bruno/game/folder.bru

@@ -0,0 +1,4 @@
+meta {
+  name: game
+  seq: 3
+}

bruno/import/01 Import FEN.bru

@@ -0,0 +1,24 @@
+meta {
+  name: Import FEN
+  type: http
+  seq: 1
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/import/fen
+  body: json
+  auth: none
+}
+
+headers {
+  Content-Type: application/json
+}
+
+body:json {
+  {
+    "fen": "rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1",
+    "white": {"id": "p1", "displayName": "Alice"},
+    "black": {"id": "p2", "displayName": "Bob"}
+  }
+}

bruno/import/02 Import PGN.bru

@@ -0,0 +1,22 @@
+meta {
+  name: Import PGN
+  type: http
+  seq: 2
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/import/pgn
+  body: json
+  auth: none
+}
+
+headers {
+  Content-Type: application/json
+}
+
+body:json {
+  {
+    "pgn": "1. e4 e5 2. Nf3 Nc6 *"
+  }
+}

bruno/import/folder.bru

@@ -0,0 +1,4 @@
+meta {
+  name: import
+  seq: 5
+}

bruno/move/01 Make Move.bru

@@ -0,0 +1,15 @@
+meta {
+  name: Make Move
+  type: http
+  seq: 1
+}
+
+post {
+  url: {{baseUrl}}/api/board/game/{{gameId}}/move/b1c3
+  body: none
+  auth: none
+}
+
+vars:pre-request {
+  gameId: tjOgyEcS
+}

bruno/move/02 Get Legal Moves.bru

@@ -0,0 +1,19 @@
+meta {
+  name: Get Legal Moves
+  type: http
+  seq: 2
+}
+
+get {
+  url: {{baseUrl}}/api/board/game/{{gameId}}/moves
+  body: none
+  auth: none
+}
+
+params:query {
+  square: e2
+}
+
+vars:pre-request {
+  gameId: tjOgyEcS
+}

bruno/move/03 Undo Move.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Undo Move
+  type: http
+  seq: 3
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/{{gameId}}/undo
+  body: none
+  auth: none
+}

bruno/move/04 Redo Move.bru

@@ -0,0 +1,12 @@
+meta {
+  name: Redo Move
+  type: http
+  seq: 4
+}
+
+http {
+  method: POST
+  url: {{baseUrl}}/api/board/game/{{gameId}}/redo
+  body: none
+  auth: none
+}

bruno/move/folder.bru

@@ -0,0 +1,3 @@
+meta {
+  name: move
+}

docs/board-api-spec.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.3
 info:
-  title: NowChess API
+  title: NowChess Board API
   description: |
     REST API for the NowChess application. Designed to feel familiar to users
     of the [lichess API](https://lichess.org/api).
@@ -186,11 +186,8 @@ paths:
         currently to move.
 
         For promotion moves include the target piece as the fifth character:
-        `e7e8q`, `a2a1r`, etc.
-
-        If the move results in a pawn reaching the back rank and no promotion
-        character is supplied, the game enters `promotionPending` status and
-        the move is not yet applied — resubmit with the promotion character.
+        `e7e8q`, `a2a1r`, etc. Promotion moves without the fifth character
+        are rejected with `400 INVALID_MOVE`.
       security:
         - bearerAuth: []
       parameters:
@@ -630,7 +627,6 @@ components:
         | `draw` | Draw agreed or claimed — game over |
         | `drawOffered` | Waiting for the opponent to accept or decline a draw offer |
         | `fiftyMoveAvailable` | Fifty-move rule threshold reached; active player may claim draw |
-        | `promotionPending` | A pawn reached the back rank; awaiting promotion piece selection |
         | `insufficientMaterial` | Neither side has enough pieces to deliver checkmate — game over (draw) |
       enum:
         - started
@@ -641,7 +637,6 @@ components:
         - draw
         - drawOffered
         - fiftyMoveAvailable
-        - promotionPending
         - insufficientMaterial
 
     # -------------------------------------------------------------------------

modules/api/src/main/scala/de/nowchess/api/dto/ApiErrorDto.scala

@@ -0,0 +1,3 @@
+package de.nowchess.api.dto
+
+final case class ApiErrorDto(code: String, message: String, field: Option[String])

modules/api/src/main/scala/de/nowchess/api/dto/CreateGameRequestDto.scala

@@ -0,0 +1,6 @@
+package de.nowchess.api.dto
+
+final case class CreateGameRequestDto(
+    white: Option[PlayerInfoDto],
+    black: Option[PlayerInfoDto],
+)

modules/api/src/main/scala/de/nowchess/api/dto/ErrorEventDto.scala

@@ -0,0 +1,6 @@
+package de.nowchess.api.dto
+
+final case class ErrorEventDto(`type`: String, error: ApiErrorDto)
+
+object ErrorEventDto:
+  def apply(error: ApiErrorDto): ErrorEventDto = ErrorEventDto("error", error)

modules/api/src/main/scala/de/nowchess/api/dto/GameFullDto.scala

@@ -0,0 +1,8 @@
+package de.nowchess.api.dto
+
+final case class GameFullDto(
+    gameId: String,
+    white: PlayerInfoDto,
+    black: PlayerInfoDto,
+    state: GameStateDto,
+)

modules/api/src/main/scala/de/nowchess/api/dto/GameFullEventDto.scala

@@ -0,0 +1,6 @@
+package de.nowchess.api.dto
+
+final case class GameFullEventDto(`type`: String, game: GameFullDto)
+
+object GameFullEventDto:
+  def apply(game: GameFullDto): GameFullEventDto = GameFullEventDto("gameFull", game)

modules/api/src/main/scala/de/nowchess/api/dto/GameStateDto.scala

@@ -0,0 +1,12 @@
+package de.nowchess.api.dto
+
+final case class GameStateDto(
+    fen: String,
+    pgn: String,
+    turn: String,
+    status: String,
+    winner: Option[String],
+    moves: List[String],
+    undoAvailable: Boolean,
+    redoAvailable: Boolean,
+)

modules/api/src/main/scala/de/nowchess/api/dto/GameStateEventDto.scala

@@ -0,0 +1,6 @@
+package de.nowchess.api.dto
+
+final case class GameStateEventDto(`type`: String, state: GameStateDto)
+
+object GameStateEventDto:
+  def apply(state: GameStateDto): GameStateEventDto = GameStateEventDto("gameState", state)

modules/api/src/main/scala/de/nowchess/api/dto/ImportFenRequestDto.scala

@@ -0,0 +1,7 @@
+package de.nowchess.api.dto
+
+final case class ImportFenRequestDto(
+    fen: String,
+    white: Option[PlayerInfoDto],
+    black: Option[PlayerInfoDto],
+)

modules/api/src/main/scala/de/nowchess/api/dto/ImportPgnRequestDto.scala

@@ -0,0 +1,3 @@
+package de.nowchess.api.dto
+
+final case class ImportPgnRequestDto(pgn: String)

modules/api/src/main/scala/de/nowchess/api/dto/LegalMoveDto.scala

@@ -0,0 +1,9 @@
+package de.nowchess.api.dto
+
+final case class LegalMoveDto(
+    from: String,
+    to: String,
+    uci: String,
+    moveType: String,
+    promotion: Option[String],
+)

modules/api/src/main/scala/de/nowchess/api/dto/LegalMovesResponseDto.scala

@@ -0,0 +1,3 @@
+package de.nowchess.api.dto
+
+final case class LegalMovesResponseDto(moves: List[LegalMoveDto])

modules/api/src/main/scala/de/nowchess/api/dto/OkResponseDto.scala

@@ -0,0 +1,3 @@
+package de.nowchess.api.dto
+
+final case class OkResponseDto(ok: Boolean = true)

modules/api/src/main/scala/de/nowchess/api/dto/PlayerInfoDto.scala

@@ -0,0 +1,3 @@
+package de.nowchess.api.dto
+
+final case class PlayerInfoDto(id: String, displayName: String)

modules/core/build.gradle.kts

@@ -63,6 +63,8 @@ dependencies {
     implementation("io.quarkus:quarkus-micrometer")
     implementation("io.quarkus:quarkus-arc")
 
+    implementation("com.fasterxml.jackson.module:jackson-module-scala_3:${versions["JACKSON_SCALA"]!!}")
+
 
     testImplementation(platform("org.junit:junit-bom:5.13.4"))
     testImplementation("org.junit.jupiter:junit-jupiter")

modules/core/src/main/scala/de/nowchess/chess/config/JacksonConfig.scala

@@ -0,0 +1,11 @@
+package de.nowchess.chess.config
+
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.module.scala.DefaultScalaModule
+import io.quarkus.jackson.ObjectMapperCustomizer
+import jakarta.inject.Singleton
+
+@Singleton
+class JacksonConfig extends ObjectMapperCustomizer:
+  def customize(mapper: ObjectMapper): Unit =
+    mapper.registerModule(DefaultScalaModule)

modules/core/src/main/scala/de/nowchess/chess/engine/GameEngine.scala

@@ -258,6 +258,22 @@ class GameEngine(
     notifyObservers(BoardResetEvent(currentContext))
   }
 
+  /** Resign the game on behalf of the side to move. */
+  def resign(): Unit = synchronized {
+    if currentContext.result.isEmpty then
+      val winner = currentContext.turn.opposite
+      currentContext = currentContext.withResult(Some(GameResult.Win(winner)))
+      invoker.clear()
+  }
+
+  /** Apply a draw result directly (for agreement, fifty-move claim, etc.). */
+  def applyDraw(reason: DrawReason): Unit = synchronized {
+    if currentContext.result.isEmpty then
+      currentContext = currentContext.withResult(Some(GameResult.Draw(reason)))
+      invoker.clear()
+      notifyObservers(DrawEvent(currentContext, reason))
+  }
+
   /** Kick off play when the side to move is a bot (e.g. bot-vs-bot from initial position). */
   def startGame(): Unit = synchronized(requestBotMoveIfNeeded())
 

modules/core/src/main/scala/de/nowchess/chess/exception/ApiException.scala

@@ -0,0 +1,13 @@
+package de.nowchess.chess.exception
+
+class ApiException(
+    val status: Int,
+    val code: String,
+    message: String,
+    val field: Option[String] = None,
+) extends RuntimeException(message)
+
+class GameNotFoundException(gameId: String) extends ApiException(404, "GAME_NOT_FOUND", s"Game $gameId not found")
+
+class BadRequestException(code: String, message: String, field: Option[String] = None)
+    extends ApiException(400, code, message, field)

modules/core/src/main/scala/de/nowchess/chess/exception/ApiExceptionMapper.scala

@@ -0,0 +1,14 @@
+package de.nowchess.chess.exception
+
+import de.nowchess.api.dto.ApiErrorDto
+import jakarta.ws.rs.core.{MediaType, Response}
+import jakarta.ws.rs.ext.{ExceptionMapper, Provider}
+
+@Provider
+class ApiExceptionMapper extends ExceptionMapper[ApiException]:
+  def toResponse(ex: ApiException): Response =
+    Response
+      .status(ex.status)
+      .entity(ApiErrorDto(ex.code, ex.getMessage, ex.field))
+      .`type`(MediaType.APPLICATION_JSON)
+      .build()

modules/core/src/main/scala/de/nowchess/chess/registry/GameEntry.scala

@@ -0,0 +1,14 @@
+package de.nowchess.chess.registry
+
+import de.nowchess.api.board.Color
+import de.nowchess.api.player.PlayerInfo
+import de.nowchess.chess.engine.GameEngine
+
+final case class GameEntry(
+    gameId: String,
+    engine: GameEngine,
+    white: PlayerInfo,
+    black: PlayerInfo,
+    drawOfferedBy: Option[Color] = None,
+    resigned: Boolean = false,
+)

modules/core/src/main/scala/de/nowchess/chess/registry/GameRegistry.scala

@@ -0,0 +1,7 @@
+package de.nowchess.chess.registry
+
+trait GameRegistry:
+  def store(entry: GameEntry): Unit
+  def get(gameId: String): Option[GameEntry]
+  def update(entry: GameEntry): Unit
+  def generateId(): String

modules/core/src/main/scala/de/nowchess/chess/registry/GameRegistryImpl.scala

@@ -0,0 +1,22 @@
+package de.nowchess.chess.registry
+
+import jakarta.enterprise.context.ApplicationScoped
+import java.util.concurrent.ConcurrentHashMap
+import scala.util.Random
+
+@ApplicationScoped
+class GameRegistryImpl extends GameRegistry:
+  private val games = ConcurrentHashMap[String, GameEntry]()
+
+  def store(entry: GameEntry): Unit =
+    games.put(entry.gameId, entry)
+
+  def get(gameId: String): Option[GameEntry] =
+    Option(games.get(gameId))
+
+  def update(entry: GameEntry): Unit =
+    games.put(entry.gameId, entry)
+
+  def generateId(): String =
+    val chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
+    Iterator.continually(Random.nextInt(chars.length)).map(chars).take(8).mkString

modules/core/src/main/scala/de/nowchess/chess/resource/GameResource.scala

@@ -0,0 +1,306 @@
+package de.nowchess.chess.resource
+
+import com.fasterxml.jackson.databind.ObjectMapper
+import de.nowchess.api.board.Square
+import de.nowchess.api.dto.*
+import de.nowchess.api.game.{DrawReason, GameContext, GameResult}
+import de.nowchess.api.move.{Move, MoveType, PromotionPiece}
+import de.nowchess.api.player.{PlayerId, PlayerInfo}
+import de.nowchess.chess.controller.Parser
+import de.nowchess.chess.engine.GameEngine
+import de.nowchess.chess.exception.{BadRequestException, GameNotFoundException}
+import de.nowchess.chess.observer.*
+import de.nowchess.chess.registry.{GameEntry, GameRegistry}
+import de.nowchess.io.fen.{FenExporter, FenParser}
+import de.nowchess.io.pgn.{PgnExporter, PgnParser}
+import io.smallrye.mutiny.Multi
+import jakarta.enterprise.context.ApplicationScoped
+import jakarta.inject.Inject
+import jakarta.ws.rs.*
+import jakarta.ws.rs.core.{MediaType, Response}
+
+import java.util.concurrent.atomic.AtomicReference
+
+@Path("/api/board/game")
+@ApplicationScoped
+class GameResource(@Inject val registry: GameRegistry, @Inject val objectMapper: ObjectMapper):
+
+  private val DefaultWhite = PlayerInfo(PlayerId("p1"), "Player 1")
+  private val DefaultBlack = PlayerInfo(PlayerId("p2"), "Player 2")
+
+  // ── mapping ──────────────────────────────────────────────────────────────
+
+  private def statusOf(entry: GameEntry): String =
+    if entry.drawOfferedBy.isDefined then "drawOffered"
+    else
+      val ctx = entry.engine.context
+      ctx.result match
+        case Some(GameResult.Win(_)) =>
+          if entry.resigned then "resign" else "checkmate"
+        case Some(GameResult.Draw(DrawReason.Stalemate))            => "stalemate"
+        case Some(GameResult.Draw(DrawReason.InsufficientMaterial)) => "insufficientMaterial"
+        case Some(GameResult.Draw(_))                               => "draw"
+        case None =>
+          if ctx.halfMoveClock >= 100 then "fiftyMoveAvailable"
+          else if entry.engine.ruleSet.isCheck(ctx) then "check"
+          else "started"
+
+  private def moveToUci(move: Move): String =
+    val base = s"${move.from}${move.to}"
+    move.moveType match
+      case MoveType.Promotion(PromotionPiece.Queen)  => s"${base}q"
+      case MoveType.Promotion(PromotionPiece.Rook)   => s"${base}r"
+      case MoveType.Promotion(PromotionPiece.Bishop) => s"${base}b"
+      case MoveType.Promotion(PromotionPiece.Knight) => s"${base}n"
+      case _                                         => base
+
+  private def toLegalMoveDto(move: Move): LegalMoveDto =
+    val (moveTypeStr, promotionStr) = move.moveType match
+      case MoveType.Normal(false)                    => ("normal", None)
+      case MoveType.Normal(true)                     => ("capture", None)
+      case MoveType.CastleKingside                   => ("castleKingside", None)
+      case MoveType.CastleQueenside                  => ("castleQueenside", None)
+      case MoveType.EnPassant                        => ("enPassant", None)
+      case MoveType.Promotion(PromotionPiece.Queen)  => ("promotion", Some("queen"))
+      case MoveType.Promotion(PromotionPiece.Rook)   => ("promotion", Some("rook"))
+      case MoveType.Promotion(PromotionPiece.Bishop) => ("promotion", Some("bishop"))
+      case MoveType.Promotion(PromotionPiece.Knight) => ("promotion", Some("knight"))
+    LegalMoveDto(move.from.toString, move.to.toString, moveToUci(move), moveTypeStr, promotionStr)
+
+  private def toPlayerDto(info: PlayerInfo): PlayerInfoDto =
+    PlayerInfoDto(info.id.value, info.displayName)
+
+  private def toGameStateDto(entry: GameEntry): GameStateDto =
+    val ctx = entry.engine.context
+    GameStateDto(
+      fen = FenExporter.exportGameContext(ctx),
+      pgn = PgnExporter.exportGame(
+        Map(
+          "Event"  -> "NowChess game",
+          "White"  -> entry.white.displayName,
+          "Black"  -> entry.black.displayName,
+          "Result" -> "*",
+        ),
+        ctx.moves,
+      ),
+      turn = ctx.turn.label.toLowerCase,
+      status = statusOf(entry),
+      winner = ctx.result.collect { case GameResult.Win(c) => c.label.toLowerCase },
+      moves = ctx.moves.map(moveToUci),
+      undoAvailable = entry.engine.canUndo,
+      redoAvailable = entry.engine.canRedo,
+    )
+
+  private def toGameFullDto(entry: GameEntry): GameFullDto =
+    GameFullDto(entry.gameId, toPlayerDto(entry.white), toPlayerDto(entry.black), toGameStateDto(entry))
+
+  private def playerInfoFrom(dto: Option[PlayerInfoDto], default: PlayerInfo): PlayerInfo =
+    dto.fold(default)(d => PlayerInfo(PlayerId(d.id), d.displayName))
+
+  private def newEntry(ctx: GameContext, white: PlayerInfo, black: PlayerInfo): GameEntry =
+    GameEntry(registry.generateId(), GameEngine(initialContext = ctx), white, black)
+
+  private def applyMoveInput(engine: GameEngine, uci: String): Option[String] =
+    val error = new AtomicReference[Option[String]](None)
+    val obs = new Observer:
+      def onGameEvent(e: GameEvent): Unit = e match
+        case InvalidMoveEvent(_, reason) => error.set(Some(reason))
+        case _                           => ()
+    engine.subscribe(obs)
+    engine.processUserInput(uci)
+    engine.unsubscribe(obs)
+    error.get()
+
+  // ── response helpers ─────────────────────────────────────────────────────
+
+  private def ok(body: AnyRef): Response      = Response.ok(body).build()
+  private def created(body: AnyRef): Response = Response.status(Response.Status.CREATED).entity(body).build()
+
+  // ── endpoints ────────────────────────────────────────────────────────────
+  // scalafix:off DisableSyntax.throw
+
+  @POST
+  @Consumes(Array(MediaType.APPLICATION_JSON))
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def createGame(body: CreateGameRequestDto): Response =
+    val req   = Option(body).getOrElse(CreateGameRequestDto(None, None))
+    val white = playerInfoFrom(req.white, DefaultWhite)
+    val black = playerInfoFrom(req.black, DefaultBlack)
+    val entry = newEntry(GameContext.initial, white, black)
+    registry.store(entry)
+    created(toGameFullDto(entry))
+
+  @GET
+  @Path("/{gameId}")
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def getGame(@PathParam("gameId") gameId: String): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    ok(toGameFullDto(entry))
+
+  @GET
+  @Path("/{gameId}/stream")
+  @Produces(Array("application/x-ndjson"))
+  def streamGame(@PathParam("gameId") gameId: String): Multi[String] =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    Multi
+      .createFrom()
+      .emitter[String] { emitter =>
+        emitter.emit(objectMapper.writeValueAsString(GameFullEventDto(toGameFullDto(entry))) + "\n")
+        val obs = new Observer:
+          def onGameEvent(event: GameEvent): Unit =
+            registry.get(gameId).foreach { updated =>
+              emitter.emit(
+                objectMapper.writeValueAsString(GameStateEventDto(toGameStateDto(updated))) + "\n",
+              )
+            }
+        entry.engine.subscribe(obs)
+        emitter.onTermination(() => entry.engine.unsubscribe(obs))
+      }
+
+  @POST
+  @Path("/{gameId}/resign")
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def resignGame(@PathParam("gameId") gameId: String): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    if entry.engine.context.result.isDefined then throw BadRequestException("GAME_OVER", "Game is already over")
+    entry.engine.resign()
+    registry.update(entry.copy(resigned = true))
+    ok(OkResponseDto())
+
+  @POST
+  @Path("/{gameId}/move/{uci}")
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def makeMove(@PathParam("gameId") gameId: String, @PathParam("uci") uci: String): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    if entry.engine.context.result.isDefined then throw BadRequestException("GAME_OVER", "Game is already over")
+    val (from, to, promoOpt) = Parser
+      .parseMove(uci)
+      .getOrElse(throw BadRequestException("INVALID_UCI", s"Invalid UCI notation: $uci", Some("uci")))
+    val candidates  = entry.engine.ruleSet.legalMoves(entry.engine.context)(from).filter(_.to == to)
+    val isPromotion = candidates.exists { case Move(_, _, MoveType.Promotion(_)) => true; case _ => false }
+    if candidates.isEmpty || (isPromotion && promoOpt.isEmpty) then
+      throw BadRequestException("INVALID_MOVE", s"$uci is not a legal move", Some("uci"))
+    applyMoveInput(entry.engine, uci).foreach(err => throw BadRequestException("INVALID_MOVE", err, Some("uci")))
+    ok(toGameStateDto(entry))
+
+  @GET
+  @Path("/{gameId}/moves")
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def getLegalMoves(
+      @PathParam("gameId") gameId: String,
+      @QueryParam("square") square: String,
+  ): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    val ctx   = entry.engine.context
+    val moves =
+      if Option(square).isEmpty || square.isEmpty then entry.engine.ruleSet.allLegalMoves(ctx)
+      else
+        val sq = Square
+          .fromAlgebraic(square)
+          .getOrElse(throw BadRequestException("INVALID_SQUARE", s"Invalid square: $square", Some("square")))
+        entry.engine.ruleSet.legalMoves(ctx)(sq)
+    ok(LegalMovesResponseDto(moves.map(toLegalMoveDto)))
+
+  @POST
+  @Path("/{gameId}/undo")
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def undoMove(@PathParam("gameId") gameId: String): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    if !entry.engine.canUndo then throw BadRequestException("NO_UNDO", "No moves to undo")
+    entry.engine.undo()
+    ok(toGameStateDto(entry))
+
+  @POST
+  @Path("/{gameId}/redo")
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def redoMove(@PathParam("gameId") gameId: String): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    if !entry.engine.canRedo then throw BadRequestException("NO_REDO", "No moves to redo")
+    entry.engine.redo()
+    ok(toGameStateDto(entry))
+
+  @POST
+  @Path("/{gameId}/draw/{action}")
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def drawAction(
+      @PathParam("gameId") gameId: String,
+      @PathParam("action") action: String,
+  ): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    if entry.engine.context.result.isDefined then throw BadRequestException("GAME_OVER", "Game is already over")
+    action match
+      case "offer" =>
+        registry.update(entry.copy(drawOfferedBy = Some(entry.engine.context.turn)))
+        ok(OkResponseDto())
+      case "accept" =>
+        entry.drawOfferedBy match
+          case None =>
+            throw BadRequestException("NO_DRAW_OFFER", "No draw offer to accept")
+          case Some(offerer) if offerer == entry.engine.context.turn =>
+            throw BadRequestException("CANNOT_ACCEPT_OWN_OFFER", "Cannot accept your own draw offer")
+          case _ =>
+            entry.engine.applyDraw(DrawReason.Agreement)
+            registry.update(entry.copy(drawOfferedBy = None))
+            ok(OkResponseDto())
+      case "decline" =>
+        if entry.drawOfferedBy.isEmpty then throw BadRequestException("NO_DRAW_OFFER", "No draw offer to decline")
+        registry.update(entry.copy(drawOfferedBy = None))
+        ok(OkResponseDto())
+      case "claim" =>
+        if entry.engine.context.halfMoveClock < 100 then
+          throw BadRequestException("CLAIM_NOT_AVAILABLE", "Fifty-move rule draw is not available")
+        entry.engine.applyDraw(DrawReason.FiftyMoveRule)
+        ok(OkResponseDto())
+      case _ =>
+        throw BadRequestException("INVALID_ACTION", s"Unknown draw action: $action", Some("action"))
+
+  @POST
+  @Path("/import/fen")
+  @Consumes(Array(MediaType.APPLICATION_JSON))
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def importFen(body: ImportFenRequestDto): Response =
+    val ctx = FenParser.parseFen(body.fen) match
+      case Left(err)  => throw BadRequestException("INVALID_FEN", err, Some("fen"))
+      case Right(ctx) => ctx
+    val white = playerInfoFrom(body.white, DefaultWhite)
+    val black = playerInfoFrom(body.black, DefaultBlack)
+    val entry = newEntry(ctx, white, black)
+    registry.store(entry)
+    created(toGameFullDto(entry))
+
+  @POST
+  @Path("/import/pgn")
+  @Consumes(Array(MediaType.APPLICATION_JSON))
+  @Produces(Array(MediaType.APPLICATION_JSON))
+  def importPgn(body: ImportPgnRequestDto): Response =
+    val engine = GameEngine()
+    engine.loadGame(PgnParser, body.pgn) match
+      case Left(err) => throw BadRequestException("INVALID_PGN", err, Some("pgn"))
+      case Right(_)  => ()
+    val entry = GameEntry(registry.generateId(), engine, DefaultWhite, DefaultBlack)
+    registry.store(entry)
+    created(toGameFullDto(entry))
+
+  @GET
+  @Path("/{gameId}/export/fen")
+  @Produces(Array(MediaType.TEXT_PLAIN))
+  def exportFen(@PathParam("gameId") gameId: String): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    ok(FenExporter.exportGameContext(entry.engine.context))
+
+  @GET
+  @Path("/{gameId}/export/pgn")
+  @Produces(Array("application/x-chess-pgn"))
+  def exportPgn(@PathParam("gameId") gameId: String): Response =
+    val entry = registry.get(gameId).getOrElse(throw GameNotFoundException(gameId))
+    val pgn = PgnExporter.exportGame(
+      Map(
+        "Event"  -> "NowChess game",
+        "White"  -> entry.white.displayName,
+        "Black"  -> entry.black.displayName,
+        "Result" -> "*",
+      ),
+      entry.engine.context.moves,
+    )
+    ok(pgn)
+  // scalafix:on DisableSyntax.throw

modules/ui/CHANGELOG.md

@@ -1,106 +0,0 @@
-##  (2026-04-01)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-##  (2026-04-01)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-##  (2026-04-01)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-##  (2026-04-02)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-##  (2026-04-03)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-##  (2026-04-07)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-##  (2026-04-07)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-##  (2026-04-12)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-29 JSON - Cherry Picked ([#28](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/28)) ([dbcafd2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dbcafd286993e0604a6fa286c5543581a149439e))
-##  (2026-04-12)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-29 JSON - Cherry Picked ([#28](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/28)) ([dbcafd2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dbcafd286993e0604a6fa286c5543581a149439e))
-##  (2026-04-14)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-29 JSON - Cherry Picked ([#28](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/28)) ([dbcafd2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dbcafd286993e0604a6fa286c5543581a149439e))
-##  (2026-04-16)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-29 JSON - Cherry Picked ([#28](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/28)) ([dbcafd2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dbcafd286993e0604a6fa286c5543581a149439e))
-##  (2026-04-19)
-
-### Features
-
-* NCS-10 Implement Pawn Promotion ([#12](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/12)) ([13bfc16](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/13bfc16cfe25db78ec607db523ca6d993c13430c))
-* NCS-13 Implement Threefold Repetition ([#31](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/31)) ([767d305](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/767d3051a76c266050b6335774d66e2db2273c16))
-* NCS-14 implemented insufficient moves rule ([#30](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/30)) ([b0399a4](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/b0399a4e489950083066c9538df9a84dcc7a4613))
-* NCS-16 Core Separation via Patterns ([#10](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/10)) ([1361dfc](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/1361dfc89553b146864fb8ff3526cf12cf3f293a))
-* NCS-17 Implement basic ScalaFX UI ([#14](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/14)) ([3ff8031](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/3ff80318b4f16c59733a46498581a5c27f048287))
-* NCS-21 Write Scripts to automate certain tasks ([#15](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/15)) ([8051871](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/80518719d536a087d339fe02530825dc07f8b388))
-* NCS-25 Add linters to keep quality up ([#27](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/27)) ([fd4e67d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/fd4e67d4f782a7e955822d90cb909d0a81676fb2))
-* NCS-29 JSON - Cherry Picked ([#28](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/28)) ([dbcafd2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dbcafd286993e0604a6fa286c5543581a149439e))
-* NCS-41 Bot Platform ([#33](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/33)) ([dceab08](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/dceab0875e6d15f7d3958633cf5dd5b29a851b1d))

modules/ui/build.gradle.kts

@@ -1,101 +0,0 @@
-import org.gradle.api.file.DuplicatesStrategy
-import org.gradle.jvm.tasks.Jar
-
-plugins {
-    id("scala")
-    id("org.scoverage")
-    application
-}
-
-group = "de.nowchess"
-version = "1.0-SNAPSHOT"
-
-@Suppress("UNCHECKED_CAST")
-val versions = rootProject.extra["VERSIONS"] as Map<String, String>
-
-repositories {
-    mavenCentral()
-}
-
-scala {
-    scalaVersion = versions["SCALA3"]!!
-}
-
-scoverage {
-    scoverageVersion.set(versions["SCOVERAGE"]!!)
-    excludedPackages.set(listOf("de\\.nowchess\\.ui\\..*"))
-}
-
-application {
-    mainClass.set("de.nowchess.ui.Main")
-}
-
-tasks.withType<ScalaCompile> {
-    scalaCompileOptions.additionalParameters = listOf("-encoding", "UTF-8")
-}
-
-tasks.named<JavaExec>("run") {
-    jvmArgs("-Dfile.encoding=UTF-8", "-Dstdout.encoding=UTF-8", "-Dstderr.encoding=UTF-8")
-    standardInput = System.`in`
-}
-
-tasks.named<Jar>("jar") {
-    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-}
-
-dependencies {
-
-    implementation("org.scala-lang:scala3-compiler_3") {
-        version {
-            strictly(versions["SCALA3"]!!)
-        }
-    }
-    implementation("org.scala-lang:scala3-library_3") {
-        version {
-            strictly(versions["SCALA3"]!!)
-        }
-    }
-
-    implementation(project(":modules:core"))
-    implementation(project(":modules:rule"))
-    implementation(project(":modules:api"))
-    implementation(project(":modules:io"))
-    implementation(project(":modules:bot"))
-
-    // ScalaFX dependencies
-    implementation("org.scalafx:scalafx_3:${versions["SCALAFX"]!!}")
-    
-    // JavaFX dependencies for the current platform
-    val javaFXVersion = versions["JAVAFX"]!!
-    val osName = System.getProperty("os.name").lowercase()
-    val platform = when {
-        osName.contains("win") -> "win"
-        osName.contains("mac") -> "mac"
-        osName.contains("linux") -> "linux"
-        else -> "linux"
-    }
-    
-    listOf("base", "controls", "graphics", "media").forEach { module ->
-        implementation("org.openjfx:javafx-$module:$javaFXVersion:$platform")
-    }
-
-    testImplementation(platform("org.junit:junit-bom:${versions["JUNIT_BOM"]!!}"))
-    testImplementation("org.junit.jupiter:junit-jupiter")
-    testImplementation("org.scalatest:scalatest_3:${versions["SCALATEST"]!!}")
-    testImplementation("co.helmethair:scalatest-junit-runner:${versions["SCALATEST_JUNIT"]!!}")
-
-    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
-}
-
-tasks.test {
-    useJUnitPlatform {
-        includeEngines("scalatest")
-        testLogging {
-            events("skipped", "failed")
-        }
-    }
-    finalizedBy(tasks.reportScoverage)
-}
-tasks.reportScoverage {
-    dependsOn(tasks.test)
-}

modules/ui/src/main/resources/styles.css

@@ -1,30 +0,0 @@
-/* Arabian Chess GUI Styles */
-
-.root {
-    -fx-font-family: "Comic Sans MS", "Comic Sans", cursive;
-    -fx-background-color: #F3C8A0;
-}
-
-.button {
-    -fx-background-radius: 8;
-    -fx-padding: 8 16 8 16;
-    -fx-font-family: "Comic Sans MS", cursive;
-    -fx-font-size: 12px;
-    -fx-cursor: hand;
-}
-
-.button:hover {
-    -fx-opacity: 0.8;
-}
-
-.label {
-    -fx-font-family: "Comic Sans MS", cursive;
-}
-
-.dialog-pane {
-    -fx-background-color: #F3C8A0;
-}
-
-.dialog-pane .content {
-    -fx-font-family: "Comic Sans MS", cursive;
-}

modules/ui/src/main/scala/de/nowchess/ui/Main.scala

@@ -1,34 +0,0 @@
-package de.nowchess.ui
-
-import de.nowchess.api.game.{BotParticipant, Human}
-import de.nowchess.api.player.{PlayerId, PlayerInfo}
-import de.nowchess.bot.util.PolyglotBook
-import de.nowchess.bot.BotDifficulty
-import de.nowchess.ui.terminal.TerminalUI
-import de.nowchess.ui.gui.ChessGUILauncher
-
-/** Application entry point - starts both GUI and Terminal UI for the chess game. Both views subscribe to the same
-  * GameEngine via Observer pattern.
-  */
-object Main:
-  def main(args: Array[String]): Unit =
-    val book = PolyglotBook("../../modules/bot/codekiddy.bin")
-
-    // Create the core game engine (single source of truth)
-    val engine = new de.nowchess.chess.engine.GameEngine(
-      participants = Map(
-        de.nowchess.api.board.Color.White -> BotParticipant(
-          de.nowchess.bot.bots.HybridBot(BotDifficulty.Easy, book = Some(book)),
-        ),
-        de.nowchess.api.board.Color.Black -> Human(PlayerInfo(PlayerId("p1"), "Player 1")),
-      ),
-    )
-
-    engine.startGame()
-
-    // Launch ScalaFX GUI in separate thread
-    ChessGUILauncher.launch(engine)
-
-    // Create and start the terminal UI (blocks on main thread)
-    val tui = new TerminalUI(engine)
-    tui.start()

modules/ui/src/main/scala/de/nowchess/ui/gui/ChessBoardView.scala

@@ -1,392 +0,0 @@
-package de.nowchess.ui.gui
-
-import java.util.concurrent.atomic.AtomicReference
-import scalafx.Includes.*
-import scalafx.application.Platform
-import scalafx.geometry.{Insets, Pos}
-import scalafx.scene.control.{Button, ButtonType, ChoiceDialog, Label}
-import scalafx.scene.layout.{BorderPane, GridPane, HBox, StackPane, VBox}
-import scalafx.scene.paint.Color as FXColor
-import scalafx.scene.shape.Rectangle
-import scalafx.scene.text.{Font, Text}
-import scalafx.stage.Stage
-import de.nowchess.api.board.{Board, Color, File, Piece, PieceType, Rank, Square}
-import de.nowchess.api.move.MoveType
-import de.nowchess.chess.command.{MoveCommand, MoveResult}
-import de.nowchess.chess.engine.GameEngine
-import de.nowchess.io.fen.{FenExporter, FenParser}
-import de.nowchess.io.pgn.{PgnExporter, PgnParser}
-import de.nowchess.io.json.{JsonExporter, JsonParser}
-import de.nowchess.io.{FileSystemGameService, GameContextExport, GameContextImport, GameFileService}
-import java.nio.file.Paths
-import scalafx.stage.FileChooser
-import scalafx.stage.FileChooser.ExtensionFilter
-
-/** ScalaFX chess board view that displays the game state. Uses chess sprites and color palette. Handles user
-  * interactions (clicks) and sends moves to GameEngine.
-  */
-class ChessBoardView(val stage: Stage, private val engine: GameEngine) extends BorderPane:
-
-  private val squareSize          = 70.0
-  private val comicSansFontFamily = "Comic Sans MS"
-  private val boardGrid           = new GridPane()
-  private val messageLabel = new Label {
-    text = "Welcome!"
-    font = Font.font(comicSansFontFamily, 16)
-    padding = Insets(10)
-  }
-
-  private val currentBoard   = new AtomicReference[Board](engine.board)
-  private val currentTurn    = new AtomicReference[Color](engine.turn)
-  private val selectedSquare = new AtomicReference[Option[Square]](None)
-  private val squareViews    = scala.collection.mutable.Map[(Int, Int), StackPane]()
-
-  private val undoButton: Button = new Button("Undo") {
-    font = Font.font(comicSansFontFamily, 12)
-    onAction = _ => if engine.canUndo then engine.undo()
-    style = "-fx-background-radius: 8; -fx-background-color: #B9DAD1;"
-    disable = !engine.canUndo
-  }
-  private val redoButton: Button = new Button("Redo") {
-    font = Font.font(comicSansFontFamily, 12)
-    onAction = _ => if engine.canRedo then engine.redo()
-    style = "-fx-background-radius: 8; -fx-background-color: #B9C2DA;"
-    disable = !engine.canRedo
-  }
-
-  // Initialize UI
-  initializeBoard()
-
-  top = new VBox {
-    padding = Insets(10)
-    spacing = 5
-    alignment = Pos.Center
-    children = Seq(
-      new Label {
-        text = "Chess"
-        font = Font.font(comicSansFontFamily, 24)
-        style = "-fx-font-weight: bold;"
-      },
-      messageLabel,
-    )
-  }
-
-  center = new VBox {
-    padding = Insets(20)
-    alignment = Pos.Center
-    style = s"-fx-background-color: ${PieceSprites.SquareColors.Border};"
-    children = boardGrid
-  }
-
-  bottom = new VBox {
-    padding = Insets(10)
-    spacing = 8
-    alignment = Pos.Center
-    children = Seq(
-      new HBox {
-        spacing = 10
-        alignment = Pos.Center
-        children = Seq(
-          undoButton,
-          redoButton,
-          new Button("Reset") {
-            font = Font.font(comicSansFontFamily, 12)
-            onAction = _ => engine.reset()
-            style = "-fx-background-radius: 8; -fx-background-color: #E1EAA9;"
-          },
-        )
-      },
-      new HBox {
-        spacing = 10
-        alignment = Pos.Center
-        children = Seq(
-          new Button("FEN Export") {
-            font = Font.font(comicSansFontFamily, 12)
-            onAction = _ => doFenExport()
-            style = "-fx-background-radius: 8; -fx-background-color: #DAC4B9;"
-          },
-          new Button("FEN Import") {
-            font = Font.font(comicSansFontFamily, 12)
-            onAction = _ => doFenImport()
-            style = "-fx-background-radius: 8; -fx-background-color: #DAD4B9;"
-          },
-          new Button("PGN Export") {
-            font = Font.font(comicSansFontFamily, 12)
-            onAction = _ => doPgnExport()
-            style = "-fx-background-radius: 8; -fx-background-color: #C4DAB9;"
-          },
-          new Button("PGN Import") {
-            font = Font.font(comicSansFontFamily, 12)
-            onAction = _ => doPgnImport()
-            style = "-fx-background-radius: 8; -fx-background-color: #B9DAC4;"
-          },
-        )
-      },
-      new HBox {
-        spacing = 10
-        alignment = Pos.Center
-        children = Seq(
-          new Button("JSON Export") {
-            font = Font.font(comicSansFontFamily, 12)
-            onAction = _ => doJsonExport()
-            style = "-fx-background-radius: 8; -fx-background-color: #B9C4DA;"
-          },
-          new Button("JSON Import") {
-            font = Font.font(comicSansFontFamily, 12)
-            onAction = _ => doJsonImport()
-            style = "-fx-background-radius: 8; -fx-background-color: #C4B9DA;"
-          },
-        )
-      },
-    )
-  }
-
-  private def initializeBoard(): Unit =
-    boardGrid.padding = Insets(5)
-    boardGrid.hgap = 0
-    boardGrid.vgap = 0
-
-    // Create 8x8 board with rank/file labels
-    for
-      rank <- 0 until 8
-      file <- 0 until 8
-    do
-      val square = createSquare(rank, file)
-      squareViews((rank, file)) = square
-      boardGrid.add(square, file, 7 - rank) // Flip rank for proper display
-
-    updateBoard(currentBoard.get(), currentTurn.get())
-
-  private def createSquare(rank: Int, file: Int): StackPane =
-    val isWhite   = (rank + file) % 2 == 0
-    val baseColor = if isWhite then PieceSprites.SquareColors.White else PieceSprites.SquareColors.Black
-
-    val bgRect = new Rectangle {
-      width = squareSize
-      height = squareSize
-      fill = FXColor.web(baseColor)
-      arcWidth = 8
-      arcHeight = 8
-    }
-
-    val square = new StackPane {
-      children = Seq(bgRect)
-      onMouseClicked = _ => handleSquareClick(rank, file)
-      style = "-fx-cursor: hand;"
-    }
-
-    square
-
-  private def handleSquareClick(rank: Int, file: Int): Unit =
-    val clickedSquare = Square(File.values(file), Rank.values(rank))
-
-    selectedSquare.get() match
-      case None =>
-        // First click - select piece if it belongs to current player
-        currentBoard.get().pieceAt(clickedSquare).foreach { piece =>
-          if piece.color == currentTurn.get() then
-            selectedSquare.set(Some(clickedSquare))
-            highlightSquare(rank, file, PieceSprites.SquareColors.Selected)
-
-            val legalDests = engine.ruleSet
-              .legalMoves(engine.context)(clickedSquare)
-              .collect { case move if move.from == clickedSquare => move.to }
-            legalDests.foreach { sq =>
-              highlightSquare(sq.rank.ordinal, sq.file.ordinal, PieceSprites.SquareColors.ValidMove)
-            }
-        }
-
-      case Some(fromSquare) =>
-        // Second click - attempt move
-        if clickedSquare == fromSquare then
-          // Deselect
-          selectedSquare.set(None)
-          updateBoard(currentBoard.get(), currentTurn.get())
-        else
-          val isPromo = engine.ruleSet
-            .legalMoves(engine.context)(fromSquare)
-            .exists(m =>
-              m.to == clickedSquare && (m.moveType match
-                case MoveType.Promotion(_) => true
-                case _                     => false
-              ),
-            )
-          if isPromo then showPromotionDialog(fromSquare, clickedSquare)
-          else engine.processUserInput(s"${fromSquare}$clickedSquare")
-          selectedSquare.set(None)
-
-  def updateBoard(board: Board, turn: Color): Unit =
-    currentBoard.set(board)
-    currentTurn.set(turn)
-    selectedSquare.set(None)
-
-    // Update all squares
-    for
-      rank <- 0 until 8
-      file <- 0 until 8
-    do
-      squareViews.get((rank, file)).foreach { stackPane =>
-        val isWhite   = (rank + file) % 2 == 0
-        val baseColor = if isWhite then PieceSprites.SquareColors.White else PieceSprites.SquareColors.Black
-
-        val bgRect = new Rectangle {
-          width = squareSize
-          height = squareSize
-          fill = FXColor.web(baseColor)
-          arcWidth = 8
-          arcHeight = 8
-        }
-
-        val square      = Square(File.values(file), Rank.values(rank))
-        val pieceOption = board.pieceAt(square)
-
-        val children: Seq[scalafx.scene.Node] = pieceOption match
-          case Some(piece) =>
-            Seq(bgRect) ++ PieceSprites.loadPieceImage(piece, squareSize * 0.8).toSeq
-          case None =>
-            Seq(bgRect)
-
-        stackPane.children = children
-      }
-
-    updateUndoRedoButtons()
-
-  def updateUndoRedoButtons(): Unit =
-    undoButton.disable = !engine.canUndo
-    redoButton.disable = !engine.canRedo
-
-  private def highlightSquare(rank: Int, file: Int, color: String): Unit =
-    squareViews.get((rank, file)).foreach { stackPane =>
-      val bgRect = new Rectangle {
-        width = squareSize
-        height = squareSize
-        fill = FXColor.web(color)
-        arcWidth = 8
-        arcHeight = 8
-      }
-
-      val square      = Square(File.values(file), Rank.values(rank))
-      val pieceOption = currentBoard.get().pieceAt(square)
-
-      stackPane.children = (pieceOption match
-        case Some(piece) =>
-          Seq(bgRect) ++ PieceSprites.loadPieceImage(piece, squareSize * 0.8).toSeq
-        case None =>
-          Seq(bgRect)
-      ): Seq[scalafx.scene.Node]
-    }
-
-  def showMessage(msg: String): Unit =
-    messageLabel.text = msg
-
-  def showPromotionDialog(from: Square, to: Square): Unit =
-    val choices = Seq("Queen", "Rook", "Bishop", "Knight")
-    val dialog = new ChoiceDialog(defaultChoice = "Queen", choices = choices) {
-      initOwner(stage)
-      title = "Pawn Promotion"
-      headerText = "Choose promotion piece"
-      contentText = "Promote to:"
-    }
-    val uciSuffix = dialog.showAndWait() match
-      case Some("Rook")   => "r"
-      case Some("Bishop") => "b"
-      case Some("Knight") => "n"
-      case _              => "q"
-    engine.processUserInput(s"${from}${to}$uciSuffix")
-
-  private def doFenExport(): Unit =
-    doExport(FenExporter, "FEN")
-
-  private def doFenImport(): Unit =
-    doImport(FenParser, "FEN")
-
-  private def doPgnExport(): Unit =
-    doExport(PgnExporter, "PGN")
-
-  private def doPgnImport(): Unit =
-    doImport(PgnParser, "PGN")
-
-  private def doJsonExport(): Unit =
-    val fileChooser = new FileChooser {
-      title = "Export Game as JSON"
-      initialFileName = "chess_game.json"
-      extensionFilters.add(new ExtensionFilter("JSON files (*.json)", "*.json"))
-      extensionFilters.add(new ExtensionFilter("All files", "*.*"))
-    }
-
-    Option(fileChooser.showSaveDialog(stage)).foreach { selectedFile =>
-      val result = FileSystemGameService.saveGameToFile(
-        engine.context,
-        selectedFile.toPath,
-        JsonExporter,
-      )
-      result match
-        case Right(_)  => showMessage(s"✓ Game saved to: ${selectedFile.getName}")
-        case Left(err) => showMessage(s"⚠️ Error saving file: $err")
-    }
-
-  private def doJsonImport(): Unit =
-    val fileChooser = new FileChooser {
-      title = "Import Game from JSON"
-      extensionFilters.add(new ExtensionFilter("JSON files (*.json)", "*.json"))
-      extensionFilters.add(new ExtensionFilter("All files", "*.*"))
-    }
-
-    Option(fileChooser.showOpenDialog(stage)).foreach { selectedFile =>
-      val result = FileSystemGameService.loadGameFromFile(
-        selectedFile.toPath,
-        JsonParser,
-      )
-      result match
-        case Right(gameContext) =>
-          engine.loadPosition(gameContext)
-          showMessage(s"✓ Game loaded from: ${selectedFile.getName}")
-        case Left(err) =>
-          showMessage(s"⚠️ Error: $err")
-    }
-
-  private def doExport(exporter: GameContextExport, formatName: String): Unit = {
-    val exported = exporter.exportGameContext(engine.context)
-    showCopyDialog(s"$formatName Export", exported)
-  }
-
-  private def doImport(importer: GameContextImport, formatName: String): Unit =
-    showInputDialog(s"$formatName Import", rows = 5).foreach { input =>
-      importer.importGameContext(input) match
-        case Right(gameContext) =>
-          engine.loadPosition(gameContext)
-          showMessage(s"✓ $formatName loaded successfully!")
-        case Left(err) =>
-          showMessage(s"⚠️  $formatName Error: $err")
-    }
-
-  private def showCopyDialog(title: String, content: String): Unit =
-    val area = new javafx.scene.control.TextArea(content)
-    area.setEditable(false)
-    area.setWrapText(true)
-    area.setPrefRowCount(4)
-    val alert = new javafx.scene.control.Alert(javafx.scene.control.Alert.AlertType.INFORMATION)
-    alert.setTitle(title)
-    alert.setHeaderText("")
-    alert.getDialogPane.setContent(area)
-    alert.getDialogPane.setPrefWidth(500)
-    alert.initOwner(stage.delegate)
-    alert.showAndWait()
-
-  private def showInputDialog(title: String, rows: Int = 2): Option[String] =
-    val area = new javafx.scene.control.TextArea()
-    area.setWrapText(true)
-    area.setPrefRowCount(rows)
-    val dialog = new javafx.scene.control.Dialog[String]()
-    dialog.setTitle(title)
-    dialog.getDialogPane.setContent(area)
-    dialog.getDialogPane.getButtonTypes.addAll(
-      javafx.scene.control.ButtonType.OK,
-      javafx.scene.control.ButtonType.CANCEL,
-    )
-    dialog.setResultConverter { bt =>
-      if bt == javafx.scene.control.ButtonType.OK then area.getText else ""
-    }
-    dialog.initOwner(stage.delegate)
-    val result = dialog.showAndWait()
-    if result.isPresent && result.get.nonEmpty then Some(result.get) else None

modules/ui/src/main/scala/de/nowchess/ui/gui/ChessGUI.scala

@@ -1,57 +0,0 @@
-package de.nowchess.ui.gui
-
-import javafx.application.{Application as JFXApplication, Platform as JFXPlatform}
-import javafx.stage.Stage as JFXStage
-import scalafx.application.Platform
-import scalafx.scene.Scene
-import scalafx.stage.Stage
-import de.nowchess.chess.engine.GameEngine
-
-/** ScalaFX GUI Application for Chess. This is launched from Main alongside the TUI. Both subscribe to the same
-  * GameEngine via Observer pattern.
-  */
-class ChessGUIApp extends JFXApplication:
-
-  override def start(primaryStage: JFXStage): Unit =
-    val engine = ChessGUILauncher.getEngine
-    val stage  = new Stage(primaryStage)
-
-    stage.title = "Chess"
-    stage.width = 700
-    stage.height = 1000
-    stage.resizable = false
-
-    val boardView   = new ChessBoardView(stage, engine)
-    val guiObserver = new GUIObserver(boardView)
-
-    // Subscribe GUI observer to engine
-    engine.subscribe(guiObserver)
-
-    stage.scene = new Scene {
-      root = boardView
-      // Load CSS if available
-      try
-        Option(getClass.getResource("/styles.css")).foreach(url => stylesheets.add(url.toExternalForm))
-      catch {
-        case _: Exception => // CSS is optional
-      }
-    }
-
-    stage.onCloseRequest = _ =>
-      // Unsubscribe when window closes
-      engine.unsubscribe(guiObserver)
-
-    stage.show()
-
-/** Launcher object that holds the engine reference and launches GUI in separate thread. */
-object ChessGUILauncher:
-  private val engineRef = new java.util.concurrent.atomic.AtomicReference[GameEngine]()
-
-  def getEngine: GameEngine = engineRef.get()
-
-  def launch(eng: GameEngine): Unit =
-    engineRef.set(eng)
-    val guiThread = new Thread(() => JFXApplication.launch(classOf[ChessGUIApp]))
-    guiThread.setDaemon(false)
-    guiThread.setName("ScalaFX-GUI-Thread")
-    guiThread.start()

modules/ui/src/main/scala/de/nowchess/ui/gui/GUIObserver.scala

@@ -1,80 +0,0 @@
-package de.nowchess.ui.gui
-
-import scalafx.application.Platform
-import scalafx.scene.control.Alert
-import scalafx.scene.control.Alert.AlertType
-import de.nowchess.chess.observer.{GameEvent, Observer, *}
-import de.nowchess.api.board.Board
-import de.nowchess.api.game.DrawReason
-
-/** GUI Observer that implements the Observer pattern. Receives game events from GameEngine and updates the ScalaFX UI.
-  * All UI updates must be done on the JavaFX Application Thread.
-  */
-class GUIObserver(private val boardView: ChessBoardView) extends Observer:
-
-  override def onGameEvent(event: GameEvent): Unit =
-    // Ensure UI updates happen on JavaFX thread
-    Platform.runLater {
-      event match
-        case e: MoveExecutedEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          e.capturedPiece.foreach { piece =>
-            boardView.showMessage(s"Captured: $piece on ${e.toSquare}")
-          }
-
-        case e: CheckDetectedEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          boardView.showMessage(s"${e.context.turn.label} is in check!")
-
-        case e: CheckmateEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          showAlert(AlertType.Information, "Game Over", s"Checkmate! ${e.winner.label} wins.")
-
-        case e: DrawEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          val msg = e.reason match
-            case DrawReason.Stalemate            => "Stalemate! The game is a draw."
-            case DrawReason.InsufficientMaterial => "Draw by insufficient material."
-            case DrawReason.FiftyMoveRule        => "Draw claimed under the 50-move rule."
-            case DrawReason.ThreefoldRepetition  => "Draw by threefold repetition."
-            case DrawReason.Agreement            => "Draw by agreement."
-          showAlert(AlertType.Information, "Game Over", msg)
-
-        case e: InvalidMoveEvent =>
-          boardView.showMessage(s"⚠️  ${e.reason}")
-
-        case e: BoardResetEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          boardView.showMessage("Board has been reset to initial position.")
-
-        case e: FiftyMoveRuleAvailableEvent =>
-          boardView.showMessage("50-move rule is now available — type 'draw' to claim.")
-
-        case e: ThreefoldRepetitionAvailableEvent =>
-          boardView.showMessage("Threefold repetition is now available — type 'draw' to claim.")
-
-        case e: MoveUndoneEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          boardView.showMessage(s"↶ Undo: ${e.pgnNotation}")
-          boardView.updateUndoRedoButtons()
-
-        case e: MoveRedoneEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          if e.capturedPiece.isDefined then
-            boardView.showMessage(s"↷ Redo: ${e.pgnNotation} — Captured: ${e.capturedPiece.get}")
-          else boardView.showMessage(s"↷ Redo: ${e.pgnNotation}")
-          boardView.updateUndoRedoButtons()
-
-        case e: PgnLoadedEvent =>
-          boardView.updateBoard(e.context.board, e.context.turn)
-          boardView.showMessage("✓ PGN loaded successfully!")
-          boardView.updateUndoRedoButtons()
-    }
-
-  private def showAlert(alertType: AlertType, titleText: String, content: String): Unit =
-    new Alert(alertType) {
-      initOwner(boardView.stage)
-      title = titleText
-      headerText = None
-      contentText = content
-    }.showAndWait()

modules/ui/src/main/scala/de/nowchess/ui/gui/PieceSprites.scala

@@ -1,34 +0,0 @@
-package de.nowchess.ui.gui
-
-import scalafx.scene.image.{Image, ImageView}
-import de.nowchess.api.board.{Color, Piece, PieceType}
-
-/** Utility object for loading chess piece sprites. */
-object PieceSprites:
-
-  private val spriteCache = scala.collection.mutable.Map[String, Option[Image]]()
-
-  /** Load a piece sprite image from resources. Sprites are cached for performance.
-    */
-  def loadPieceImage(piece: Piece, size: Double = 60.0): Option[ImageView] =
-    val key = s"${piece.color.label.toLowerCase}_${piece.pieceType.label.toLowerCase}"
-    spriteCache.getOrElseUpdate(key, loadImage(key)).map { image =>
-      new ImageView(image) {
-        fitWidth = size
-        fitHeight = size
-        preserveRatio = true
-        smooth = true
-      }
-    }
-
-  private def loadImage(key: String): Option[Image] =
-    val path = s"/sprites/pieces/$key.png"
-    Option(getClass.getResourceAsStream(path)).map(new Image(_))
-
-  /** Get square colors for the board using theme. */
-  object SquareColors:
-    val White     = "#F3C8A0" // Warm light beige
-    val Black     = "#BA6D4B" // Warm terracotta
-    val Selected  = "#C19EF5" // Purple highlight
-    val ValidMove = "#E1EAA9" // Light yellow-green
-    val Border    = "#5A2C28" // Dark brown border

modules/ui/src/main/scala/de/nowchess/ui/terminal/TerminalUI.scala

@@ -1,107 +0,0 @@
-package de.nowchess.ui.terminal
-
-import java.util.concurrent.atomic.AtomicBoolean
-import scala.io.StdIn
-import de.nowchess.api.game.DrawReason
-import de.nowchess.chess.engine.GameEngine
-import de.nowchess.chess.observer.*
-import de.nowchess.ui.utils.Renderer
-
-/** Terminal UI that implements Observer pattern. Subscribes to GameEngine and receives state change events. Handles all
-  * I/O and user interaction in the terminal.
-  */
-class TerminalUI(engine: GameEngine) extends Observer:
-  private val running = new AtomicBoolean(true)
-
-  /** Called by GameEngine whenever a game event occurs. */
-  override def onGameEvent(event: GameEvent): Unit =
-    event match
-      case e: MoveExecutedEvent =>
-        println()
-        print(Renderer.render(e.context.board))
-        e.capturedPiece.foreach: cap =>
-          println(s"Captured: $cap on ${e.toSquare}")
-        printPrompt(e.context.turn)
-
-      case e: MoveUndoneEvent =>
-        println(s"Undo: ${e.pgnNotation}")
-        println()
-        print(Renderer.render(e.context.board))
-        printPrompt(e.context.turn)
-
-      case e: MoveRedoneEvent =>
-        println(s"Redo: ${e.pgnNotation}")
-        println()
-        print(Renderer.render(e.context.board))
-        printPrompt(e.context.turn)
-
-      case e: CheckDetectedEvent =>
-        println(s"${e.context.turn.label} is in check!")
-
-      case e: CheckmateEvent =>
-        println(s"Checkmate! ${e.winner.label} wins.")
-        println()
-        print(Renderer.render(e.context.board))
-
-      case e: DrawEvent =>
-        val msg = e.reason match
-          case DrawReason.Stalemate            => "Stalemate! The game is a draw."
-          case DrawReason.InsufficientMaterial => "Draw by insufficient material."
-          case DrawReason.FiftyMoveRule        => "Draw claimed under the 50-move rule."
-          case DrawReason.ThreefoldRepetition  => "Draw by threefold repetition."
-          case DrawReason.Agreement            => "Draw by agreement."
-        println(msg)
-        println()
-        print(Renderer.render(e.context.board))
-
-      case e: InvalidMoveEvent =>
-        println(s"⚠️  ${e.reason}")
-
-      case e: BoardResetEvent =>
-        println("Board has been reset to initial position.")
-        println()
-        print(Renderer.render(e.context.board))
-        printPrompt(e.context.turn)
-
-      case _: FiftyMoveRuleAvailableEvent =>
-        println("50-move rule is now available — type 'draw' to claim.")
-
-      case _: ThreefoldRepetitionAvailableEvent =>
-        println("Threefold repetition is now available — type 'draw' to claim.")
-
-      case e: PgnLoadedEvent =>
-        println("PGN loaded successfully.")
-        println()
-        print(Renderer.render(e.context.board))
-        printPrompt(e.context.turn)
-
-  /** Start the terminal UI game loop. */
-  def start(): Unit =
-    // Register as observer
-    engine.subscribe(this)
-
-    // Show initial board
-    println()
-    print(Renderer.render(engine.board))
-    printPrompt(engine.turn)
-
-    while running.get() do
-      val input = Option(StdIn.readLine()).getOrElse("quit").trim
-      synchronized {
-        input.toLowerCase match
-          case "quit" | "q" =>
-            running.set(false)
-            println("Game over. Goodbye!")
-          case "" =>
-            printPrompt(engine.turn)
-          case _ =>
-            engine.processUserInput(input)
-      }
-
-    // Unsubscribe when done
-    engine.unsubscribe(this)
-
-  private def printPrompt(turn: de.nowchess.api.board.Color): Unit =
-    val undoHint = if engine.canUndo then " [undo]" else ""
-    val redoHint = if engine.canRedo then " [redo]" else ""
-    print(s"${turn.label}'s turn. Enter move (or 'quit'/'q' to exit)$undoHint$redoHint: ")

modules/ui/src/main/scala/de/nowchess/ui/utils/PieceUnicode.scala

@@ -1,18 +0,0 @@
-package de.nowchess.ui.utils
-
-import de.nowchess.api.board.{Color, Piece, PieceType}
-
-extension (p: Piece)
-  def unicode: String = (p.color, p.pieceType) match
-    case (Color.White, PieceType.King)   => "\u2654"
-    case (Color.White, PieceType.Queen)  => "\u2655"
-    case (Color.White, PieceType.Rook)   => "\u2656"
-    case (Color.White, PieceType.Bishop) => "\u2657"
-    case (Color.White, PieceType.Knight) => "\u2658"
-    case (Color.White, PieceType.Pawn)   => "\u2659"
-    case (Color.Black, PieceType.King)   => "\u265A"
-    case (Color.Black, PieceType.Queen)  => "\u265B"
-    case (Color.Black, PieceType.Rook)   => "\u265C"
-    case (Color.Black, PieceType.Bishop) => "\u265D"
-    case (Color.Black, PieceType.Knight) => "\u265E"
-    case (Color.Black, PieceType.Pawn)   => "\u265F"

modules/ui/src/main/scala/de/nowchess/ui/utils/Renderer.scala

@@ -1,30 +0,0 @@
-package de.nowchess.ui.utils
-
-import de.nowchess.api.board.*
-
-object Renderer:
-
-  private val AnsiReset       = "\u001b[0m"
-  private val AnsiLightSquare = "\u001b[48;5;223m" // warm beige
-  private val AnsiDarkSquare  = "\u001b[48;5;130m" // brown
-  private val AnsiWhitePiece  = "\u001b[97m"       // bright white text
-  private val AnsiBlackPiece  = "\u001b[30m"       // black text
-
-  def render(board: Board): String =
-    val rows = (0 until 8).reverse
-      .map { rank =>
-        val cells = (0 until 8).map { file =>
-          val sq        = Square(File.values(file), Rank.values(rank))
-          val isLightSq = (file + rank) % 2 != 0
-          val bgColor   = if isLightSq then AnsiLightSquare else AnsiDarkSquare
-          board.pieceAt(sq) match
-            case Some(piece) =>
-              val fgColor = if piece.color == Color.White then AnsiWhitePiece else AnsiBlackPiece
-              s"$bgColor$fgColor ${piece.unicode} $AnsiReset"
-            case None =>
-              s"$bgColor   $AnsiReset"
-        }.mkString
-        s"${rank + 1} $cells ${rank + 1}"
-      }
-      .mkString("\n")
-    s"  a  b  c  d  e  f  g  h\n$rows\n  a  b  c  d  e  f  g  h\n"

modules/ui/src/test/scala/de/nowchess/ui/utils/RendererAndUnicodeTest.scala

@@ -1,44 +0,0 @@
-package de.nowchess.ui.utils
-
-import de.nowchess.api.board.{Board, Color, File, Piece, PieceType, Rank, Square}
-import org.scalatest.funsuite.AnyFunSuite
-import org.scalatest.matchers.should.Matchers
-
-class RendererAndUnicodeTest extends AnyFunSuite with Matchers:
-
-  test("unicode returns correct unicode character for all piece types"):
-    val pieces = Seq(
-      (Piece(Color.White, PieceType.King), "\u2654"),
-      (Piece(Color.White, PieceType.Queen), "\u2655"),
-      (Piece(Color.White, PieceType.Rook), "\u2656"),
-      (Piece(Color.White, PieceType.Bishop), "\u2657"),
-      (Piece(Color.White, PieceType.Knight), "\u2658"),
-      (Piece(Color.White, PieceType.Pawn), "\u2659"),
-      (Piece(Color.Black, PieceType.King), "\u265A"),
-      (Piece(Color.Black, PieceType.Queen), "\u265B"),
-      (Piece(Color.Black, PieceType.Rook), "\u265C"),
-      (Piece(Color.Black, PieceType.Bishop), "\u265D"),
-      (Piece(Color.Black, PieceType.Knight), "\u265E"),
-      (Piece(Color.Black, PieceType.Pawn), "\u265F"),
-    )
-    pieces.foreach { (piece, expected) =>
-      piece.unicode shouldBe expected
-    }
-
-  test("render outputs coordinates ranks ansi escapes and piece glyphs"):
-    val board    = Board(Map(Square(File.E, Rank.R4) -> Piece(Color.White, PieceType.Queen)))
-    val rendered = Renderer.render(Board(Map.empty))
-    val lines    = rendered.trim.split("\\n").toList.map(_.trim)
-
-    lines.head shouldBe "a  b  c  d  e  f  g  h"
-    lines.last shouldBe "a  b  c  d  e  f  g  h"
-    rendered should include("8")
-    rendered should include("1")
-    Renderer.render(board) should include("\u2655")
-    Renderer.render(board) should include("\u001b[")
-
-  test("render applies black piece color for black pieces"):
-    val board    = Board(Map(Square(File.A, Rank.R1) -> Piece(Color.Black, PieceType.King)))
-    val rendered = Renderer.render(board)
-    rendered should include("\u265A")     // Black king unicode
-    rendered should include("\u001b[30m") // ANSI black text color

modules/ui/versions.env

@@ -1,3 +0,0 @@
-MAJOR=0
-MINOR=12
-PATCH=0

settings.gradle.kts

@@ -18,6 +18,5 @@ include(
     "modules:api",
     "modules:io",
     "modules:rule",
-    "modules:ui",
     "modules:bot",
 )