test: more branch coverage for CommandInvoker

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

.metals/metals.lock.db

@@ -0,0 +1,6 @@
+#FileLock
+#Sun Mar 29 15:06:23 CEST 2026
+hostName=localhost
+id=19d39612ed6c322b6ba3c2fc0853ca12997433c4dd8
+method=file
+server=localhost\:46585

CODE_NOTICE.md

@@ -0,0 +1,41 @@
+# 🔒 CODE FREEZE NOTICE
+
+## Date: March 29, 2026
+## Duration: Core Separation Refactor
+
+### Reason
+Implementing Command Pattern and Observer Pattern to decouple UI and logic interfaces.
+
+### Scope
+This refactor will:
+1. Extract TUI code from `core` module into standalone UI module
+2. Implement Command Pattern for all user interactions
+3. Implement Observer Pattern for state change notifications
+4. Make `core` completely UI-agnostic
+5. Enable multiple simultaneous UIs (TUI + future ScalaFX GUI)
+
+### Module Structure (Target)
+```
+modules/
+  core/        # Pure game logic, Command, Observer traits, CommandInvoker
+  api/         # Data models (unchanged)
+  ui/          # TUI and GUI implementations (both depend only on core)
+```
+
+### Expected Impact
+- All regression tests must pass
+- Build must succeed with new module structure
+- Core contains zero UI references
+- TUI and potential GUI can run independently or simultaneously
+
+### Blocked Changes
+Do not:
+- Add new features to `core`
+- Modify `core` API before Message & Observer traits are implemented
+- Create direct dependencies between UI modules
+- Add UI code to `core`
+
+Keep developing in separate branches until refactor is complete.
+
+---
+Status: **IN PROGRESS** ✏️

modules/core/CHANGELOG.md

@@ -28,3 +28,19 @@
 * add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
 * correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
 * update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))
+##  (2026-03-29)
+
+### Features
+
+* add GameRules stub with PositionStatus enum ([76d4168](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/76d4168038de23e5d6083d4e8f0504fbf31d15a3))
+* add MovedInCheck/Checkmate/Stalemate MoveResult variants (stub dispatch) ([8b7ec57](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/8b7ec57e5ea6ee1615a1883848a426dc07d26364))
+* implement GameRules with isInCheck, legalMoves, gameStatus ([94a02ff](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/94a02ff6849436d9496c70a0f16c21666dae8e4e))
+* implement legal castling ([#1](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/1)) ([00d326c](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/00d326c1ba67711fbe180f04e1100c3f01dd0254))
+* NCS-6 Implementing FEN & PGN ([#7](https://git.janis-eccarius.de/NowChess/NowChessSystems/issues/7)) ([f28e69d](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f28e69dc181416aa2f221fdc4b45c2cda5efbf07))
+* wire check/checkmate/stalemate into processMove and gameLoop ([5264a22](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/5264a225418b885c5e6ea6411b96f85e38837f6c))
+
+### Bug Fixes
+
+* add missing kings to gameLoop capture test board ([aedd787](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/aedd787b77203c2af934751dba7b784eaf165032))
+* correct test board positions and captureOutput/withInput interaction ([f0481e2](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/f0481e2561b779df00925b46ee281dc36a795150))
+* update main class path in build configuration and adjust VCS directory mapping ([7b1f8b1](https://git.janis-eccarius.de/NowChess/NowChessSystems/commit/7b1f8b117623d327232a1a92a8a44d18582e0189))

modules/core/src/main/scala/de/nowchess/chess/Main.scala

@@ -1,12 +0,0 @@
-package de.nowchess.chess
-
-import de.nowchess.api.board.Board
-import de.nowchess.api.board.Color
-import de.nowchess.chess.controller.GameController
-import de.nowchess.chess.logic.GameHistory
-
-object Main {
-  def main(args: Array[String]): Unit =
-    println("NowChess TUI — type moves in coordinate notation (e.g. e2e4). Type 'quit' to exit.")
-    GameController.gameLoop(Board.initial, GameHistory.empty, Color.White)
-}

modules/core/src/main/scala/de/nowchess/chess/command/Command.scala

@@ -0,0 +1,64 @@
+package de.nowchess.chess.command
+
+import de.nowchess.api.board.{Square, Board, Color, Piece}
+import de.nowchess.chess.logic.GameHistory
+
+/** Marker trait for all commands that can be executed and undone.
+ *  Commands encapsulate user actions and game state transitions.
+ */
+trait Command:
+  /** Execute the command and return true if successful, false otherwise. */
+  def execute(): Boolean
+
+  /** Undo the command and return true if successful, false otherwise. */
+  def undo(): Boolean
+
+  /** A human-readable description of this command. */
+  def description: String
+
+/** Command to move a piece from one square to another.
+ *  Stores the move result so undo can restore previous state.
+ */
+case class MoveCommand(
+  from: Square,
+  to: Square,
+  var moveResult: Option[MoveResult] = None,
+  var previousBoard: Option[Board] = None,
+  var previousHistory: Option[GameHistory] = None,
+  var previousTurn: Option[Color] = None
+) extends Command:
+
+  override def execute(): Boolean =
+    moveResult.isDefined
+
+  override def undo(): Boolean =
+    previousBoard.isDefined && previousHistory.isDefined && previousTurn.isDefined
+
+  override def description: String = s"Move from $from to $to"
+
+// Sealed hierarchy of move outcomes (for tracking state changes)
+sealed trait MoveResult
+object MoveResult:
+  case class Successful(newBoard: Board, newHistory: GameHistory, newTurn: Color, captured: Option[Piece]) extends MoveResult
+  case object InvalidFormat extends MoveResult
+  case object InvalidMove extends MoveResult
+
+/** Command to quit the game. */
+case class QuitCommand() extends Command:
+  override def execute(): Boolean = true
+  override def undo(): Boolean = false
+  override def description: String = "Quit game"
+
+/** Command to reset the board to initial position. */
+case class ResetCommand(
+  var previousBoard: Option[Board] = None,
+  var previousHistory: Option[GameHistory] = None,
+  var previousTurn: Option[Color] = None
+) extends Command:
+
+  override def execute(): Boolean = true
+
+  override def undo(): Boolean =
+    previousBoard.isDefined && previousHistory.isDefined && previousTurn.isDefined
+
+  override def description: String = "Reset board"

modules/core/src/main/scala/de/nowchess/chess/command/CommandInvoker.scala

@@ -0,0 +1,61 @@
+package de.nowchess.chess.command
+
+/** Manages command execution and history for undo/redo support. */
+class CommandInvoker:
+  private val executedCommands = scala.collection.mutable.ListBuffer[Command]()
+  private var currentIndex = -1
+
+  /** Execute a command and add it to history.
+   *  Discards any redo history if not at the end of the stack.
+   */
+  def execute(command: Command): Boolean =
+    if command.execute() then
+      // Remove any commands after current index (redo stack is discarded)
+      while currentIndex < executedCommands.size - 1 do
+        executedCommands.remove(executedCommands.size - 1)
+      executedCommands += command
+      currentIndex += 1
+      true
+    else
+      false
+
+  /** Undo the last executed command if possible. */
+  def undo(): Boolean =
+    if currentIndex >= 0 && currentIndex < executedCommands.size then
+      val command = executedCommands(currentIndex)
+      if command.undo() then
+        currentIndex -= 1
+        true
+      else
+        false
+    else
+      false
+
+  /** Redo the next command in history if available. */
+  def redo(): Boolean =
+    if currentIndex + 1 < executedCommands.size then
+      val command = executedCommands(currentIndex + 1)
+      if command.execute() then
+        currentIndex += 1
+        true
+      else
+        false
+    else
+      false
+
+  /** Get the history of all executed commands. */
+  def history: List[Command] = executedCommands.toList
+
+  /** Get the current position in command history. */
+  def getCurrentIndex: Int = currentIndex
+
+  /** Clear all command history. */
+  def clear(): Unit =
+    executedCommands.clear()
+    currentIndex = -1
+
+  /** Check if undo is available. */
+  def canUndo: Boolean = currentIndex >= 0
+
+  /** Check if redo is available. */
+  def canRedo: Boolean = currentIndex + 1 < executedCommands.size

modules/core/src/main/scala/de/nowchess/chess/controller/GameController.scala

@@ -1,9 +1,7 @@
 package de.nowchess.chess.controller
 
-import scala.io.StdIn
 import de.nowchess.api.board.{Board, Color, File, Piece, Rank, Square}
 import de.nowchess.chess.logic.*
-import de.nowchess.chess.view.Renderer
 
 // ---------------------------------------------------------------------------
 // Result ADT returned by the pure processMove function
@@ -51,55 +49,18 @@ object GameController:
                   val castleOpt = if MoveValidator.isCastle(board, from, to)
                                   then Some(MoveValidator.castleSide(from, to))
                                   else None
+                  val isEP = EnPassantCalculator.isEnPassant(board, history, from, to)
                   val (newBoard, captured) = castleOpt match
                     case Some(side) => (board.withCastle(turn, side), None)
-                    case None       => board.withMove(from, to)
+                    case None =>
+                      val (b, cap) = board.withMove(from, to)
+                      if isEP then
+                        val capturedSq = EnPassantCalculator.capturedPawnSquare(to, turn)
+                        (b.removed(capturedSq), board.pieceAt(capturedSq))
+                      else (b, cap)
                   val newHistory = history.addMove(from, to, castleOpt)
                   GameRules.gameStatus(newBoard, newHistory, turn.opposite) match
                     case PositionStatus.Normal  => MoveResult.Moved(newBoard, newHistory, captured, turn.opposite)
                     case PositionStatus.InCheck => MoveResult.MovedInCheck(newBoard, newHistory, captured, turn.opposite)
                     case PositionStatus.Mated   => MoveResult.Checkmate(turn)
                     case PositionStatus.Drawn   => MoveResult.Stalemate
-
-  /** Thin I/O shell: renders the board, reads a line, delegates to processMove,
-   *  prints the outcome, and recurses until the game ends.
-   */
-  def gameLoop(board: Board, history: GameHistory, turn: Color): Unit =
-    println()
-    print(Renderer.render(board))
-    println(s"${turn.label}'s turn. Enter move: ")
-    val input = Option(StdIn.readLine()).getOrElse("quit").trim
-    processMove(board, history, turn, input) match
-      case MoveResult.Quit =>
-        println("Game over. Goodbye!")
-      case MoveResult.InvalidFormat(raw) =>
-        println(s"Invalid move format '$raw'. Use coordinate notation, e.g. e2e4.")
-        gameLoop(board, history, turn)
-      case MoveResult.NoPiece =>
-        println(s"No piece on ${Parser.parseMove(input).map(_._1).fold("?")(_.toString)}.")
-        gameLoop(board, history, turn)
-      case MoveResult.WrongColor =>
-        println(s"That is not your piece.")
-        gameLoop(board, history, turn)
-      case MoveResult.IllegalMove =>
-        println(s"Illegal move.")
-        gameLoop(board, history, turn)
-      case MoveResult.Moved(newBoard, newHistory, captured, newTurn) =>
-        val prevTurn = newTurn.opposite
-        captured.foreach: cap =>
-          val toSq = Parser.parseMove(input).map(_._2).fold("?")(_.toString)
-          println(s"${prevTurn.label} captures ${cap.color.label} ${cap.pieceType.label} on $toSq")
-        gameLoop(newBoard, newHistory, newTurn)
-      case MoveResult.MovedInCheck(newBoard, newHistory, captured, newTurn) =>
-        val prevTurn = newTurn.opposite
-        captured.foreach: cap =>
-          val toSq = Parser.parseMove(input).map(_._2).fold("?")(_.toString)
-          println(s"${prevTurn.label} captures ${cap.color.label} ${cap.pieceType.label} on $toSq")
-        println(s"${newTurn.label} is in check!")
-        gameLoop(newBoard, newHistory, newTurn)
-      case MoveResult.Checkmate(winner) =>
-        println(s"Checkmate! ${winner.label} wins.")
-        gameLoop(Board.initial, GameHistory.empty, Color.White)
-      case MoveResult.Stalemate =>
-        println("Stalemate! The game is a draw.")
-        gameLoop(Board.initial, GameHistory.empty, Color.White)

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

@@ -0,0 +1,245 @@
+package de.nowchess.chess.engine
+
+import de.nowchess.api.board.{Board, Color, Piece, Square}
+import de.nowchess.chess.logic.{GameHistory, GameRules, PositionStatus}
+import de.nowchess.chess.controller.{GameController, Parser, MoveResult}
+import de.nowchess.chess.observer.*
+import de.nowchess.chess.command.{CommandInvoker, MoveCommand}
+
+/** Pure game engine that manages game state and notifies observers of state changes.
+ *  This class is the single source of truth for the game state.
+ *  All user interactions must go through this engine via Commands, and all state changes
+ *  are communicated to observers via GameEvent notifications.
+ */
+class GameEngine extends Observable:
+  private var currentBoard: Board = Board.initial
+  private var currentHistory: GameHistory = GameHistory.empty
+  private var currentTurn: Color = Color.White
+  private val invoker = new CommandInvoker()
+
+  // Synchronized accessors for current state
+  def board: Board = synchronized { currentBoard }
+  def history: GameHistory = synchronized { currentHistory }
+  def turn: Color = synchronized { currentTurn }
+
+  /** Check if undo is available. */
+  def canUndo: Boolean = synchronized { invoker.canUndo }
+
+  /** Check if redo is available. */
+  def canRedo: Boolean = synchronized { invoker.canRedo }
+
+  /** Get the command history for inspection (testing/debugging). */
+  def commandHistory: List[de.nowchess.chess.command.Command] = synchronized { invoker.history }
+
+  /** Process a raw move input string and update game state if valid.
+   *  Notifies all observers of the outcome via GameEvent.
+   */
+  def processUserInput(rawInput: String): Unit = synchronized {
+    val trimmed = rawInput.trim.toLowerCase
+    trimmed match
+      case "quit" | "q" =>
+        // Client should handle quit logic; we just return
+        ()
+
+      case "undo" =>
+        performUndo()
+
+      case "redo" =>
+        performRedo()
+
+      case "" =>
+        val event = InvalidMoveEvent(
+          currentBoard,
+          currentHistory,
+          currentTurn,
+          "Please enter a valid move or command."
+        )
+        notifyObservers(event)
+
+      case moveInput =>
+        // Try to parse as a move
+        Parser.parseMove(moveInput) match
+          case None =>
+            val event = InvalidMoveEvent(
+              currentBoard,
+              currentHistory,
+              currentTurn,
+              s"Invalid move format '$moveInput'. Use coordinate notation, e.g. e2e4."
+            )
+            notifyObservers(event)
+
+          case Some((from, to)) =>
+            // Create a move command with current state snapshot
+            val cmd = MoveCommand(
+              from = from,
+              to = to,
+              previousBoard = Some(currentBoard),
+              previousHistory = Some(currentHistory),
+              previousTurn = Some(currentTurn)
+            )
+
+            // Execute the move through GameController
+            GameController.processMove(currentBoard, currentHistory, currentTurn, moveInput) match
+              case MoveResult.Quit =>
+                // Should not happen via processUserInput, but handle it
+                ()
+
+              case MoveResult.InvalidFormat(_) | MoveResult.NoPiece | MoveResult.WrongColor | MoveResult.IllegalMove =>
+                // Move failed, don't add to history
+                handleFailedMove(moveInput)
+
+              case MoveResult.Moved(newBoard, newHistory, captured, newTurn) =>
+                // Move succeeded - store result and execute through invoker
+                cmd.moveResult = Some(de.nowchess.chess.command.MoveResult.Successful(newBoard, newHistory, newTurn, captured))
+                invoker.execute(cmd)
+                updateGameState(newBoard, newHistory, newTurn)
+                emitMoveEvent(from.toString, to.toString, captured, newTurn)
+
+              case MoveResult.MovedInCheck(newBoard, newHistory, captured, newTurn) =>
+                // Move succeeded with check
+                cmd.moveResult = Some(de.nowchess.chess.command.MoveResult.Successful(newBoard, newHistory, newTurn, captured))
+                invoker.execute(cmd)
+                updateGameState(newBoard, newHistory, newTurn)
+                emitMoveEvent(from.toString, to.toString, captured, newTurn)
+                notifyObservers(CheckDetectedEvent(currentBoard, currentHistory, currentTurn))
+
+              case MoveResult.Checkmate(winner) =>
+                // Move resulted in checkmate
+                cmd.moveResult = Some(de.nowchess.chess.command.MoveResult.Successful(Board.initial, GameHistory.empty, Color.White, None))
+                invoker.execute(cmd)
+                currentBoard = Board.initial
+                currentHistory = GameHistory.empty
+                currentTurn = Color.White
+                notifyObservers(CheckmateEvent(currentBoard, currentHistory, currentTurn, winner))
+
+              case MoveResult.Stalemate =>
+                // Move resulted in stalemate
+                cmd.moveResult = Some(de.nowchess.chess.command.MoveResult.Successful(Board.initial, GameHistory.empty, Color.White, None))
+                invoker.execute(cmd)
+                currentBoard = Board.initial
+                currentHistory = GameHistory.empty
+                currentTurn = Color.White
+                notifyObservers(StalemateEvent(currentBoard, currentHistory, currentTurn))
+  }
+
+  /** Undo the last move. */
+  def undo(): Unit = synchronized {
+    performUndo()
+  }
+
+  /** Redo the last undone move. */
+  def redo(): Unit = synchronized {
+    performRedo()
+  }
+
+  /** Reset the board to initial position. */
+  def reset(): Unit = synchronized {
+    currentBoard = Board.initial
+    currentHistory = GameHistory.empty
+    currentTurn = Color.White
+    invoker.clear()
+    notifyObservers(BoardResetEvent(
+      currentBoard,
+      currentHistory,
+      currentTurn
+    ))
+  }
+
+  // ──── Private Helpers ────
+
+  private def performUndo(): Unit =
+    if invoker.canUndo then
+      val history = invoker.history
+      val currentIdx = invoker.getCurrentIndex
+      if currentIdx >= 0 && currentIdx < history.size then
+        val cmd = history(currentIdx)
+        cmd match
+          case moveCmd: MoveCommand =>
+            if moveCmd.undo() then
+              moveCmd.previousBoard.foreach(currentBoard = _)
+              moveCmd.previousHistory.foreach(currentHistory = _)
+              moveCmd.previousTurn.foreach(currentTurn = _)
+              invoker.undo()
+              notifyObservers(BoardResetEvent(currentBoard, currentHistory, currentTurn))
+            else
+              notifyObservers(InvalidMoveEvent(currentBoard, currentHistory, currentTurn, "Cannot undo this move."))
+          case _ =>
+            // Other command types - just revert the invoker
+            invoker.undo()
+            notifyObservers(BoardResetEvent(currentBoard, currentHistory, currentTurn))
+    else
+      notifyObservers(InvalidMoveEvent(currentBoard, currentHistory, currentTurn, "Nothing to undo."))
+
+  private def performRedo(): Unit =
+    if invoker.canRedo then
+      val history = invoker.history
+      val nextIdx = invoker.getCurrentIndex + 1
+      if nextIdx >= 0 && nextIdx < history.size then
+        val cmd = history(nextIdx)
+        cmd match
+          case moveCmd: MoveCommand =>
+            if moveCmd.execute() then
+              moveCmd.moveResult.foreach {
+                case de.nowchess.chess.command.MoveResult.Successful(newBoard, newHistory, newTurn, captured) =>
+                  updateGameState(newBoard, newHistory, newTurn)
+                  invoker.redo()
+                  emitMoveEvent(moveCmd.from.toString, moveCmd.to.toString, captured, newTurn)
+                case _ => ()
+              }
+            else
+              notifyObservers(InvalidMoveEvent(currentBoard, currentHistory, currentTurn, "Cannot redo this move."))
+          case _ =>
+            invoker.redo()
+            notifyObservers(BoardResetEvent(currentBoard, currentHistory, currentTurn))
+    else
+      notifyObservers(InvalidMoveEvent(currentBoard, currentHistory, currentTurn, "Nothing to redo."))
+
+  private def updateGameState(newBoard: Board, newHistory: GameHistory, newTurn: Color): Unit =
+    currentBoard = newBoard
+    currentHistory = newHistory
+    currentTurn = newTurn
+
+  private def emitMoveEvent(fromSq: String, toSq: String, captured: Option[Piece], newTurn: Color): Unit =
+    val capturedDesc = captured.map(c => s"${c.color.label} ${c.pieceType.label}")
+    notifyObservers(MoveExecutedEvent(
+      currentBoard,
+      currentHistory,
+      newTurn,
+      fromSq,
+      toSq,
+      capturedDesc
+    ))
+
+  private def handleFailedMove(moveInput: String): Unit =
+    GameController.processMove(currentBoard, currentHistory, currentTurn, moveInput) match
+      case MoveResult.InvalidFormat(raw) =>
+        notifyObservers(InvalidMoveEvent(
+          currentBoard,
+          currentHistory,
+          currentTurn,
+          s"Invalid move format '$raw'. Use coordinate notation, e.g. e2e4."
+        ))
+      case MoveResult.NoPiece =>
+        notifyObservers(InvalidMoveEvent(
+          currentBoard,
+          currentHistory,
+          currentTurn,
+          "No piece on that square."
+        ))
+      case MoveResult.WrongColor =>
+        notifyObservers(InvalidMoveEvent(
+          currentBoard,
+          currentHistory,
+          currentTurn,
+          "That is not your piece."
+        ))
+      case MoveResult.IllegalMove =>
+        notifyObservers(InvalidMoveEvent(
+          currentBoard,
+          currentHistory,
+          currentTurn,
+          "Illegal move."
+        ))
+      case _ => ()
+
+end GameEngine

modules/core/src/main/scala/de/nowchess/chess/logic/EnPassantCalculator.scala

@@ -0,0 +1,32 @@
+package de.nowchess.chess.logic
+
+import de.nowchess.api.board.*
+
+object EnPassantCalculator:
+
+  /** Returns the en passant target square if the last move was a double pawn push.
+   *  The target is the square the pawn passed through (e.g. e2→e4 yields e3).
+   */
+  def enPassantTarget(board: Board, history: GameHistory): Option[Square] =
+    history.moves.lastOption.flatMap: move =>
+      val rankDiff = move.to.rank.ordinal - move.from.rank.ordinal
+      val isDoublePush = math.abs(rankDiff) == 2
+      val isPawn = board.pieceAt(move.to).exists(_.pieceType == PieceType.Pawn)
+      if isDoublePush && isPawn then
+        val midRankIdx = move.from.rank.ordinal + rankDiff / 2
+        Some(Square(move.to.file, Rank.values(midRankIdx)))
+      else None
+
+  /** True if moving from→to is an en passant capture. */
+  def isEnPassant(board: Board, history: GameHistory, from: Square, to: Square): Boolean =
+    board.pieceAt(from).exists(_.pieceType == PieceType.Pawn) &&
+    enPassantTarget(board, history).contains(to) &&
+    math.abs(to.file.ordinal - from.file.ordinal) == 1
+
+  /** Returns the square of the pawn to remove when an en passant capture lands on `to`.
+   *  White captures upward → captured pawn is one rank below `to`.
+   *  Black captures downward → captured pawn is one rank above `to`.
+   */
+  def capturedPawnSquare(to: Square, color: Color): Square =
+    val capturedRankIdx = to.rank.ordinal + (if color == Color.White then -1 else 1)
+    Square(to.file, Rank.values(capturedRankIdx))

modules/core/src/main/scala/de/nowchess/chess/logic/MoveValidator.scala

@@ -155,8 +155,21 @@ object MoveValidator:
     board.pieceAt(from) match
       case Some(piece) if piece.pieceType == PieceType.King =>
         legalTargets(board, from) ++ castlingTargets(board, history, piece.color)
+      case Some(piece) if piece.pieceType == PieceType.Pawn =>
+        pawnTargets(board, history, from, piece.color)
       case _ =>
         legalTargets(board, from)
 
+  private def pawnTargets(board: Board, history: GameHistory, from: Square, color: Color): Set[Square] =
+    val existing = pawnTargets(board, from, color)
+    val fi  = from.file.ordinal
+    val ri  = from.rank.ordinal
+    val dir = if color == Color.White then 1 else -1
+    val epCapture: Set[Square] =
+      EnPassantCalculator.enPassantTarget(board, history).filter: target =>
+        squareAt(fi - 1, ri + dir).contains(target) || squareAt(fi + 1, ri + dir).contains(target)
+      .toSet
+    existing ++ epCapture
+
   def isLegal(board: Board, history: GameHistory, from: Square, to: Square): Boolean =
     legalTargets(board, history, from).contains(to)

modules/core/src/main/scala/de/nowchess/chess/observer/Observer.scala

@@ -0,0 +1,82 @@
+package de.nowchess.chess.observer
+
+import de.nowchess.api.board.{Board, Color}
+import de.nowchess.chess.logic.GameHistory
+
+/** Base trait for all game state events.
+ *  Events are immutable snapshots of game state changes.
+ */
+sealed trait GameEvent:
+  def board: Board
+  def history: GameHistory
+  def turn: Color
+
+/** Fired when a move is successfully executed. */
+case class MoveExecutedEvent(
+  board: Board,
+  history: GameHistory,
+  turn: Color,
+  fromSquare: String,
+  toSquare: String,
+  capturedPiece: Option[String]
+) extends GameEvent
+
+/** Fired when the current player is in check. */
+case class CheckDetectedEvent(
+  board: Board,
+  history: GameHistory,
+  turn: Color
+) extends GameEvent
+
+/** Fired when the game reaches checkmate. */
+case class CheckmateEvent(
+  board: Board,
+  history: GameHistory,
+  turn: Color,
+  winner: Color
+) extends GameEvent
+
+/** Fired when the game reaches stalemate. */
+case class StalemateEvent(
+  board: Board,
+  history: GameHistory,
+  turn: Color
+) extends GameEvent
+
+/** Fired when a move is invalid. */
+case class InvalidMoveEvent(
+  board: Board,
+  history: GameHistory,
+  turn: Color,
+  reason: String
+) extends GameEvent
+
+/** Fired when the board is reset. */
+case class BoardResetEvent(
+  board: Board,
+  history: GameHistory,
+  turn: Color
+) extends GameEvent
+
+/** Observer trait: implement to receive game state updates. */
+trait Observer:
+  def onGameEvent(event: GameEvent): Unit
+
+/** Observable trait: manages observers and notifies them of events. */
+trait Observable:
+  private val observers = scala.collection.mutable.Set[Observer]()
+
+  /** Register an observer to receive game events. */
+  def subscribe(observer: Observer): Unit =
+    observers += observer
+
+  /** Unregister an observer. */
+  def unsubscribe(observer: Observer): Unit =
+    observers -= observer
+
+  /** Notify all observers of a game event. */
+  protected def notifyObservers(event: GameEvent): Unit =
+    observers.foreach(_.onGameEvent(event))
+
+  /** Return current list of observers (for testing). */
+  def observerCount: Int = observers.size

modules/core/src/test/scala/de/nowchess/chess/command/CommandInvokerBranchTest.scala

@@ -0,0 +1,217 @@
+package de.nowchess.chess.command
+
+import de.nowchess.api.board.{Square, File, Rank, Board, Color}
+import de.nowchess.chess.logic.GameHistory
+import org.scalatest.funsuite.AnyFunSuite
+import org.scalatest.matchers.should.Matchers
+
+class CommandInvokerBranchTest extends AnyFunSuite with Matchers:
+  
+  private def sq(f: File, r: Rank): Square = Square(f, r)
+
+  // ──── Helper: Command that always fails ────
+  private case class FailingCommand() extends Command:
+    override def execute(): Boolean = false
+    override def undo(): Boolean = false
+    override def description: String = "Failing command"
+
+  // ──── Helper: Command that conditionally fails on undo or execute ────
+  private case class ConditionalFailCommand(var shouldFailOnUndo: Boolean = false, var shouldFailOnExecute: Boolean = false) extends Command:
+    override def execute(): Boolean = !shouldFailOnExecute
+    override def undo(): Boolean = !shouldFailOnUndo
+    override def description: String = "Conditional fail"
+
+  private def createMoveCommand(from: Square, to: Square, executeSucceeds: Boolean = true): MoveCommand =
+    val cmd = MoveCommand(
+      from = from,
+      to = to,
+      moveResult = if executeSucceeds then Some(MoveResult.Successful(Board.initial, GameHistory.empty, Color.White, None)) else None,
+      previousBoard = Some(Board.initial),
+      previousHistory = Some(GameHistory.empty),
+      previousTurn = Some(Color.White)
+    )
+    cmd
+
+  // ──── BRANCH: execute() returns false ────
+  test("CommandInvoker.execute() with failing command returns false"):
+    val invoker = new CommandInvoker()
+    val cmd = FailingCommand()
+    invoker.execute(cmd) shouldBe false
+    invoker.history.size shouldBe 0
+    invoker.getCurrentIndex shouldBe -1
+
+  test("CommandInvoker.execute() does not add failed command to history"):
+    val invoker = new CommandInvoker()
+    val failingCmd = FailingCommand()
+    val successCmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    
+    invoker.execute(failingCmd) shouldBe false
+    invoker.history.size shouldBe 0
+    
+    invoker.execute(successCmd) shouldBe true
+    invoker.history.size shouldBe 1
+    invoker.history(0) shouldBe successCmd
+
+  // ──── BRANCH: undo() with invalid index (currentIndex < 0) ────
+  test("CommandInvoker.undo() returns false when currentIndex < 0"):
+    val invoker = new CommandInvoker()
+    // currentIndex starts at -1
+    invoker.undo() shouldBe false
+
+  test("CommandInvoker.undo() returns false when empty history"):
+    val invoker = new CommandInvoker()
+    invoker.canUndo shouldBe false
+    invoker.undo() shouldBe false
+
+  // ──── BRANCH: undo() with invalid index (currentIndex >= size) ────
+  test("CommandInvoker.undo() returns false when currentIndex >= history size"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    
+    invoker.execute(cmd1)
+    invoker.execute(cmd2)
+    // currentIndex now = 1, history.size = 2
+    
+    invoker.undo()  // currentIndex becomes 0
+    invoker.undo()  // currentIndex becomes -1
+    invoker.undo()  // currentIndex still -1, should fail
+
+  // ──── BRANCH: undo() command returns false ────
+  test("CommandInvoker.undo() returns false when command.undo() fails"):
+    val invoker = new CommandInvoker()
+    val failingCmd = ConditionalFailCommand(shouldFailOnUndo = true)
+    
+    invoker.execute(failingCmd) shouldBe true
+    invoker.canUndo shouldBe true
+    
+    invoker.undo() shouldBe false
+    // Index should not change when undo fails
+    invoker.getCurrentIndex shouldBe 0
+
+  test("CommandInvoker.undo() returns true when command.undo() succeeds"):
+    val invoker = new CommandInvoker()
+    val successCmd = ConditionalFailCommand(shouldFailOnUndo = false)
+    
+    invoker.execute(successCmd) shouldBe true
+    invoker.undo() shouldBe true
+    invoker.getCurrentIndex shouldBe -1
+
+  // ──── BRANCH: redo() with invalid index (currentIndex + 1 >= size) ────
+  test("CommandInvoker.redo() returns false when nothing to redo"):
+    val invoker = new CommandInvoker()
+    invoker.redo() shouldBe false
+
+  test("CommandInvoker.redo() returns false when at end of history"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    
+    invoker.execute(cmd)
+    // currentIndex = 0, history.size = 1
+    invoker.canRedo shouldBe false
+    invoker.redo() shouldBe false
+
+  test("CommandInvoker.redo() returns false when currentIndex + 1 >= size"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    
+    invoker.execute(cmd1)
+    invoker.execute(cmd2)
+    // currentIndex = 1, size = 2, currentIndex + 1 = 2, so 2 < 2 is false
+    invoker.canRedo shouldBe false
+    invoker.redo() shouldBe false
+
+  // ──── BRANCH: redo() command returns false ────
+  test("CommandInvoker.redo() returns false when command.execute() fails"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val redoFailCmd = ConditionalFailCommand(shouldFailOnExecute = false)  // Succeeds on first execute
+    
+    invoker.execute(cmd1)
+    invoker.execute(redoFailCmd)  // Succeeds and added to history
+    
+    invoker.undo()
+    // currentIndex = 0, redoFailCmd is at index 1
+    invoker.canRedo shouldBe true
+    
+    // Now modify to fail on next execute (redo)
+    redoFailCmd.shouldFailOnExecute = true
+    invoker.redo() shouldBe false
+    // currentIndex should not change
+    invoker.getCurrentIndex shouldBe 0
+
+  test("CommandInvoker.redo() returns true when command.execute() succeeds"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    
+    invoker.execute(cmd) shouldBe true
+    invoker.undo() shouldBe true
+    invoker.redo() shouldBe true
+    invoker.getCurrentIndex shouldBe 0
+
+  // ──── BRANCH: execute() with redo history discarding (while loop) ────
+  test("CommandInvoker.execute() discards redo history via while loop"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    val cmd3 = createMoveCommand(sq(File.D, Rank.R2), sq(File.D, Rank.R4))
+    
+    invoker.execute(cmd1)
+    invoker.execute(cmd2)
+    // currentIndex = 1, size = 2
+    
+    invoker.undo()
+    // currentIndex = 0, size = 2
+    // Redo history exists: cmd2 is at index 1
+    invoker.canRedo shouldBe true
+    
+    invoker.execute(cmd3)
+    // while loop should discard cmd2
+    invoker.canRedo shouldBe false
+    invoker.history.size shouldBe 2
+    invoker.history(1) shouldBe cmd3
+
+  test("CommandInvoker.execute() discards multiple redo commands"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    val cmd3 = createMoveCommand(sq(File.G, Rank.R1), sq(File.F, Rank.R3))
+    val cmd4 = createMoveCommand(sq(File.D, Rank.R2), sq(File.D, Rank.R4))
+    
+    invoker.execute(cmd1)
+    invoker.execute(cmd2)
+    invoker.execute(cmd3)
+    invoker.execute(cmd4)
+    // currentIndex = 3, size = 4
+    
+    invoker.undo()
+    invoker.undo()
+    // currentIndex = 1, size = 4
+    // Redo history: cmd3 (idx 2), cmd4 (idx 3)
+    invoker.canRedo shouldBe true
+    
+    val newCmd = createMoveCommand(sq(File.B, Rank.R2), sq(File.B, Rank.R4))
+    invoker.execute(newCmd)
+    // While loop should discard indices 2 and 3 (cmd3 and cmd4)
+    invoker.history.size shouldBe 3
+    invoker.canRedo shouldBe false
+
+  // ──── BRANCH: execute() with no redo history to discard ────
+  test("CommandInvoker.execute() with no redo history (while condition false)"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    
+    invoker.execute(cmd1)
+    invoker.execute(cmd2)
+    // currentIndex = 1, size = 2
+    // currentIndex < size - 1 is 1 < 1 which is false, so while loop doesn't run
+    
+    invoker.canRedo shouldBe false
+    
+    val cmd3 = createMoveCommand(sq(File.D, Rank.R2), sq(File.D, Rank.R4))
+    invoker.execute(cmd3)  // While loop condition should be false, no iterations
+    invoker.history.size shouldBe 3
+
+end CommandInvokerBranchTest

modules/core/src/test/scala/de/nowchess/chess/command/CommandInvokerTest.scala

@@ -0,0 +1,124 @@
+package de.nowchess.chess.command
+
+import de.nowchess.api.board.{Square, File, Rank, Board, Color}
+import de.nowchess.chess.logic.GameHistory
+import org.scalatest.funsuite.AnyFunSuite
+import org.scalatest.matchers.should.Matchers
+
+class CommandInvokerTest extends AnyFunSuite with Matchers:
+
+  private def sq(f: File, r: Rank): Square = Square(f, r)
+  
+  private def createMoveCommand(from: Square, to: Square): MoveCommand =
+    MoveCommand(
+      from = from,
+      to = to,
+      moveResult = Some(MoveResult.Successful(Board.initial, GameHistory.empty, Color.White, None)),
+      previousBoard = Some(Board.initial),
+      previousHistory = Some(GameHistory.empty),
+      previousTurn = Some(Color.White)
+    )
+
+  test("CommandInvoker executes a command and adds it to history"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    invoker.execute(cmd) shouldBe true
+    invoker.history.size shouldBe 1
+    invoker.getCurrentIndex shouldBe 0
+
+  test("CommandInvoker executes multiple commands in sequence"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    invoker.execute(cmd1) shouldBe true
+    invoker.execute(cmd2) shouldBe true
+    invoker.history.size shouldBe 2
+    invoker.getCurrentIndex shouldBe 1
+
+  test("CommandInvoker.canUndo returns false when empty"):
+    val invoker = new CommandInvoker()
+    invoker.canUndo shouldBe false
+
+  test("CommandInvoker.canUndo returns true after execution"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    invoker.execute(cmd)
+    invoker.canUndo shouldBe true
+
+  test("CommandInvoker.undo decrements current index"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    invoker.execute(cmd)
+    invoker.getCurrentIndex shouldBe 0
+    invoker.undo() shouldBe true
+    invoker.getCurrentIndex shouldBe -1
+
+  test("CommandInvoker.canRedo returns true after undo"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    invoker.execute(cmd)
+    invoker.undo()
+    invoker.canRedo shouldBe true
+
+  test("CommandInvoker.redo re-executes a command"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    invoker.execute(cmd)
+    invoker.undo() shouldBe true
+    invoker.redo() shouldBe true
+    invoker.getCurrentIndex shouldBe 0
+
+  test("CommandInvoker.canUndo returns false when at beginning"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    invoker.execute(cmd)
+    invoker.undo()
+    invoker.canUndo shouldBe false
+
+  test("CommandInvoker clear removes all history"):
+    val invoker = new CommandInvoker()
+    val cmd = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    invoker.execute(cmd)
+    invoker.clear()
+    invoker.history.size shouldBe 0
+    invoker.getCurrentIndex shouldBe -1
+
+  test("CommandInvoker discards all history when executing after undoing all"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    val cmd3 = createMoveCommand(sq(File.D, Rank.R2), sq(File.D, Rank.R4))
+    invoker.execute(cmd1)
+    invoker.execute(cmd2)
+    invoker.undo()
+    invoker.undo()
+    // After undoing twice, we're at the beginning (before any commands)
+    invoker.getCurrentIndex shouldBe -1
+    invoker.canRedo shouldBe true
+    // Executing a new command from the beginning discards all redo history
+    invoker.execute(cmd3)
+    invoker.canRedo shouldBe false
+    invoker.history.size shouldBe 1
+    invoker.history(0) shouldBe cmd3
+    invoker.getCurrentIndex shouldBe 0
+
+  test("CommandInvoker discards redo history when executing mid-history"):
+    val invoker = new CommandInvoker()
+    val cmd1 = createMoveCommand(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    val cmd2 = createMoveCommand(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    val cmd3 = createMoveCommand(sq(File.D, Rank.R2), sq(File.D, Rank.R4))
+    invoker.execute(cmd1)
+    invoker.execute(cmd2)
+    invoker.undo()
+    // After one undo, we're at the end of cmd1
+    invoker.getCurrentIndex shouldBe 0
+    invoker.canRedo shouldBe true
+    // Executing a new command discards cmd2 (the redo history)
+    invoker.execute(cmd3)
+    invoker.canRedo shouldBe false
+    invoker.history.size shouldBe 2
+    invoker.history(0) shouldBe cmd1
+    invoker.history(1) shouldBe cmd3
+    invoker.getCurrentIndex shouldBe 1
+
+end CommandInvokerTest

modules/core/src/test/scala/de/nowchess/chess/command/CommandTest.scala

@@ -0,0 +1,53 @@
+package de.nowchess.chess.command
+
+import de.nowchess.api.board.{Board, Color}
+import de.nowchess.chess.logic.GameHistory
+import org.scalatest.funsuite.AnyFunSuite
+import org.scalatest.matchers.should.Matchers
+
+class CommandTest extends AnyFunSuite with Matchers:
+
+  test("QuitCommand can be created"):
+    val cmd = QuitCommand()
+    cmd shouldNot be(null)
+
+  test("QuitCommand execute returns true"):
+    val cmd = QuitCommand()
+    cmd.execute() shouldBe true
+
+  test("QuitCommand undo returns false (cannot undo quit)"):
+    val cmd = QuitCommand()
+    cmd.undo() shouldBe false
+
+  test("QuitCommand description"):
+    val cmd = QuitCommand()
+    cmd.description shouldBe "Quit game"
+
+  test("ResetCommand with no prior state"):
+    val cmd = ResetCommand()
+    cmd.execute() shouldBe true
+    cmd.undo() shouldBe false
+
+  test("ResetCommand with prior state can undo"):
+    val cmd = ResetCommand(
+      previousBoard = Some(Board.initial),
+      previousHistory = Some(GameHistory.empty),
+      previousTurn = Some(Color.White)
+    )
+    cmd.execute() shouldBe true
+    cmd.undo() shouldBe true
+
+  test("ResetCommand with partial state cannot undo"):
+    val cmd = ResetCommand(
+      previousBoard = Some(Board.initial),
+      previousHistory = None,  // missing
+      previousTurn = Some(Color.White)
+    )
+    cmd.execute() shouldBe true
+    cmd.undo() shouldBe false
+
+  test("ResetCommand description"):
+    val cmd = ResetCommand()
+    cmd.description shouldBe "Reset board"
+
+end CommandTest

modules/core/src/test/scala/de/nowchess/chess/controller/GameControllerTest.scala

@@ -6,17 +6,12 @@ import de.nowchess.chess.logic.{CastleSide, GameHistory}
 import org.scalatest.funsuite.AnyFunSuite
 import org.scalatest.matchers.should.Matchers
 
-import java.io.ByteArrayInputStream
-
 class GameControllerTest extends AnyFunSuite with Matchers:
 
   private def sq(f: File, r: Rank): Square = Square(f, r)
   private def processMove(board: Board, history: GameHistory, turn: Color, raw: String): MoveResult =
     GameController.processMove(board, history, turn, raw)
 
-  private def gameLoop(board: Board, history: GameHistory, turn: Color): Unit =
-    GameController.gameLoop(board, history, turn)
-
   private def castlingRights(history: GameHistory, color: Color): CastlingRights =
     de.nowchess.chess.logic.CastlingRightsCalculator.deriveCastlingRights(history, color)
 
@@ -69,59 +64,6 @@ class GameControllerTest extends AnyFunSuite with Matchers:
         newTurn shouldBe Color.Black
       case other => fail(s"Expected Moved, got $other")
 
-  // ──── gameLoop ───────────────────────────────────────────────────────
-
-  private def withInput(input: String)(block: => Unit): Unit =
-    val stream = ByteArrayInputStream(input.getBytes("UTF-8"))
-    scala.Console.withIn(stream)(block)
-
-  test("gameLoop: 'quit' exits cleanly without exception"):
-    withInput("quit\n"):
-      gameLoop(Board.initial, GameHistory.empty, Color.White)
-
-  test("gameLoop: EOF (null readLine) exits via quit fallback"):
-    withInput(""):
-      gameLoop(Board.initial, GameHistory.empty, Color.White)
-
-  test("gameLoop: invalid format prints message and recurses until quit"):
-    withInput("badmove\nquit\n"):
-      gameLoop(Board.initial, GameHistory.empty, Color.White)
-
-  test("gameLoop: NoPiece prints message and recurses until quit"):
-    // E3 is empty in the initial position
-    withInput("e3e4\nquit\n"):
-      gameLoop(Board.initial, GameHistory.empty, Color.White)
-
-  test("gameLoop: WrongColor prints message and recurses until quit"):
-    // E7 has a Black pawn; it is White's turn
-    withInput("e7e6\nquit\n"):
-      gameLoop(Board.initial, GameHistory.empty, Color.White)
-
-  test("gameLoop: IllegalMove prints message and recurses until quit"):
-    withInput("e2e5\nquit\n"):
-      gameLoop(Board.initial, GameHistory.empty, Color.White)
-
-  test("gameLoop: legal non-capture move recurses with new board then quits"):
-    withInput("e2e4\nquit\n"):
-      gameLoop(Board.initial, GameHistory.empty, Color.White)
-
-  test("gameLoop: capture move prints capture message then recurses and quits"):
-    val captureBoard = Board(Map(
-      sq(File.E, Rank.R5) -> Piece.WhitePawn,
-      sq(File.D, Rank.R6) -> Piece.BlackPawn,
-      sq(File.H, Rank.R1) -> Piece.BlackKing,
-      sq(File.H, Rank.R8) -> Piece.WhiteKing
-    ))
-    withInput("e5d6\nquit\n"):
-      gameLoop(captureBoard, GameHistory.empty, Color.White)
-
-  // ──── helpers ────────────────────────────────────────────────────────
-
-  private def captureOutput(block: => Unit): String =
-    val out = java.io.ByteArrayOutputStream()
-    scala.Console.withOut(out)(block)
-    out.toString("UTF-8")
-
   // ──── processMove: check / checkmate / stalemate ─────────────────────
 
   test("processMove: legal move that delivers check returns MovedInCheck"):
@@ -161,56 +103,6 @@ class GameControllerTest extends AnyFunSuite with Matchers:
       case MoveResult.Stalemate => succeed
       case other => fail(s"Expected Stalemate, got $other")
 
-  // ──── gameLoop: check / checkmate / stalemate ─────────────────────────
-
-  test("gameLoop: checkmate prints winner message and resets to new game"):
-    // After Qa1-Qh8, position is checkmate; second "quit" exits the new game
-    val b = Board(Map(
-      sq(File.A, Rank.R1) -> Piece.WhiteQueen,
-      sq(File.A, Rank.R6) -> Piece.WhiteKing,
-      sq(File.A, Rank.R8) -> Piece.BlackKing
-    ))
-    val output = captureOutput:
-      withInput("a1h8\nquit\n"):
-        gameLoop(b, GameHistory.empty, Color.White)
-    output should include("Checkmate! White wins.")
-
-  test("gameLoop: stalemate prints draw message and resets to new game"):
-    val b = Board(Map(
-      sq(File.B, Rank.R1) -> Piece.WhiteQueen,
-      sq(File.C, Rank.R6) -> Piece.WhiteKing,
-      sq(File.A, Rank.R8) -> Piece.BlackKing
-    ))
-    val output = captureOutput:
-      withInput("b1b6\nquit\n"):
-        gameLoop(b, GameHistory.empty, Color.White)
-    output should include("Stalemate! The game is a draw.")
-
-  test("gameLoop: MovedInCheck without capture prints check message"):
-    val b = Board(Map(
-      sq(File.A, Rank.R1) -> Piece.WhiteRook,
-      sq(File.C, Rank.R3) -> Piece.WhiteKing,
-      sq(File.H, Rank.R8) -> Piece.BlackKing
-    ))
-    val output = captureOutput:
-      withInput("a1a8\nquit\n"):
-        gameLoop(b, GameHistory.empty, Color.White)
-    output should include("Black is in check!")
-
-  test("gameLoop: MovedInCheck with capture prints both capture and check message"):
-    // White Rook A1 captures Black Pawn on A8, Ra8 then attacks rank 8 putting Kh8 in check
-    val b = Board(Map(
-      sq(File.A, Rank.R1) -> Piece.WhiteRook,
-      sq(File.C, Rank.R3) -> Piece.WhiteKing,
-      sq(File.A, Rank.R8) -> Piece.BlackPawn,
-      sq(File.H, Rank.R8) -> Piece.BlackKing
-    ))
-    val output = captureOutput:
-      withInput("a1a8\nquit\n"):
-        gameLoop(b, GameHistory.empty, Color.White)
-    output should include("captures")
-    output should include("Black is in check!")
-
   // ──── castling execution ─────────────────────────────────────────────
 
   test("processMove: e1g1 returns Moved with king on g1 and rook on f1"):
@@ -365,3 +257,39 @@ class GameControllerTest extends AnyFunSuite with Matchers:
       case MoveResult.MovedInCheck(_, newHistory, _, _) =>
         castlingRights(newHistory, Color.White).queenSide shouldBe false
       case other => fail(s"Expected Moved or MovedInCheck, got $other")
+
+  // ──── en passant ────────────────────────────────────────────────────────
+
+  test("en passant capture removes the captured pawn from the board"):
+    // Setup: white pawn e5, black pawn just double-pushed to d5 (ep target = d6)
+    val b = Board(Map(
+      Square(File.E, Rank.R5) -> Piece.WhitePawn,
+      Square(File.D, Rank.R5) -> Piece.BlackPawn,
+      Square(File.E, Rank.R1) -> Piece.WhiteKing,
+      Square(File.E, Rank.R8) -> Piece.BlackKing
+    ))
+    val h = GameHistory.empty.addMove(Square(File.D, Rank.R7), Square(File.D, Rank.R5))
+    val result = GameController.processMove(b, h, Color.White, "e5d6")
+    result match
+      case MoveResult.Moved(newBoard, _, captured, _) =>
+        newBoard.pieceAt(Square(File.D, Rank.R5)) shouldBe None  // captured pawn removed
+        newBoard.pieceAt(Square(File.D, Rank.R6)) shouldBe Some(Piece.WhitePawn)  // capturing pawn placed
+        captured shouldBe Some(Piece.BlackPawn)
+      case other => fail(s"Expected Moved but got $other")
+
+  test("en passant capture by black removes the captured white pawn"):
+    // Setup: black pawn d4, white pawn just double-pushed to e4 (ep target = e3)
+    val b = Board(Map(
+      Square(File.D, Rank.R4) -> Piece.BlackPawn,
+      Square(File.E, Rank.R4) -> Piece.WhitePawn,
+      Square(File.E, Rank.R8) -> Piece.BlackKing,
+      Square(File.E, Rank.R1) -> Piece.WhiteKing
+    ))
+    val h = GameHistory.empty.addMove(Square(File.E, Rank.R2), Square(File.E, Rank.R4))
+    val result = GameController.processMove(b, h, Color.Black, "d4e3")
+    result match
+      case MoveResult.Moved(newBoard, _, captured, _) =>
+        newBoard.pieceAt(Square(File.E, Rank.R4)) shouldBe None  // captured pawn removed
+        newBoard.pieceAt(Square(File.E, Rank.R3)) shouldBe Some(Piece.BlackPawn)  // capturing pawn placed
+        captured shouldBe Some(Piece.WhitePawn)
+      case other => fail(s"Expected Moved but got $other")

modules/core/src/test/scala/de/nowchess/chess/engine/GameEngineTest.scala

@@ -0,0 +1,278 @@
+package de.nowchess.chess.engine
+
+import scala.collection.mutable
+import de.nowchess.api.board.{Board, Color}
+import de.nowchess.chess.logic.GameHistory
+import de.nowchess.chess.observer.{Observer, GameEvent, MoveExecutedEvent, CheckDetectedEvent, BoardResetEvent, InvalidMoveEvent}
+import org.scalatest.funsuite.AnyFunSuite
+import org.scalatest.matchers.should.Matchers
+
+class GameEngineTest extends AnyFunSuite with Matchers:
+
+  test("GameEngine starts with initial board state"):
+    val engine = new GameEngine()
+    engine.board shouldBe Board.initial
+    engine.history shouldBe GameHistory.empty
+    engine.turn shouldBe Color.White
+
+  test("GameEngine accepts Observer subscription"):
+    val engine = new GameEngine()
+    val mockObserver = new MockObserver()
+    engine.subscribe(mockObserver)
+    engine.observerCount shouldBe 1
+
+  test("GameEngine notifies observers on valid move"):
+    val engine = new GameEngine()
+    val mockObserver = new MockObserver()
+    engine.subscribe(mockObserver)
+    engine.processUserInput("e2e4")
+    mockObserver.events.size shouldBe 1
+    mockObserver.events.head shouldBe a[MoveExecutedEvent]
+
+  test("GameEngine updates state after valid move"):
+    val engine = new GameEngine()
+    val initialTurn = engine.turn
+    engine.processUserInput("e2e4")
+    engine.turn shouldNot be(initialTurn)
+    engine.turn shouldBe Color.Black
+
+  test("GameEngine notifies observers on invalid move"):
+    val engine = new GameEngine()
+    val mockObserver = new MockObserver()
+    engine.subscribe(mockObserver)
+    engine.processUserInput("invalid_move")
+    mockObserver.events.size shouldBe 1
+
+  test("GameEngine notifies multiple observers"):
+    val engine = new GameEngine()
+    val observer1 = new MockObserver()
+    val observer2 = new MockObserver()
+    engine.subscribe(observer1)
+    engine.subscribe(observer2)
+    engine.processUserInput("e2e4")
+    observer1.events.size shouldBe 1
+    observer2.events.size shouldBe 1
+
+  test("GameEngine allows observer unsubscription"):
+    val engine = new GameEngine()
+    val mockObserver = new MockObserver()
+    engine.subscribe(mockObserver)
+    engine.unsubscribe(mockObserver)
+    engine.observerCount shouldBe 0
+
+  test("GameEngine unsubscribed observer receives no events"):
+    val engine = new GameEngine()
+    val mockObserver = new MockObserver()
+    engine.subscribe(mockObserver)
+    engine.unsubscribe(mockObserver)
+    engine.processUserInput("e2e4")
+    mockObserver.events.size shouldBe 0
+
+  test("GameEngine reset notifies observers and resets state"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    engine.reset()
+    engine.board shouldBe Board.initial
+    engine.turn shouldBe Color.White
+    observer.events.size shouldBe 1
+
+  test("GameEngine processes sequence of moves"):
+    val engine = new GameEngine()
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    engine.processUserInput("e2e4")
+    engine.processUserInput("e7e5")
+    observer.events.size shouldBe 2
+    engine.turn shouldBe Color.White
+
+  test("GameEngine is thread-safe for synchronized operations"):
+    val engine = new GameEngine()
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    val t = new Thread(() => engine.processUserInput("e2e4"))
+    t.start()
+    t.join()
+    observer.events.size shouldBe 1
+
+  test("GameEngine canUndo returns false initially"):
+    val engine = new GameEngine()
+    engine.canUndo shouldBe false
+
+  test("GameEngine canUndo returns true after move"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    engine.canUndo shouldBe true
+
+  test("GameEngine canRedo returns false initially"):
+    val engine = new GameEngine()
+    engine.canRedo shouldBe false
+
+  test("GameEngine undo restores previous state"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    val boardAfterMove = engine.board
+    engine.undo()
+    engine.board shouldBe Board.initial
+    engine.turn shouldBe Color.White
+
+  test("GameEngine undo notifies observers"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    observer.events.clear()
+    engine.undo()
+    observer.events.size shouldBe 1
+    observer.events.head shouldBe a[BoardResetEvent]
+
+  test("GameEngine redo replays undone move"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    val boardAfterMove = engine.board
+    engine.undo()
+    engine.redo()
+    engine.board shouldBe boardAfterMove
+    engine.turn shouldBe Color.Black
+
+  test("GameEngine canUndo false when nothing to undo"):
+    val engine = new GameEngine()
+    engine.canUndo shouldBe false
+    engine.processUserInput("e2e4")
+    engine.undo()
+    engine.canUndo shouldBe false
+
+  test("GameEngine canRedo true after undo"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    engine.undo()
+    engine.canRedo shouldBe true
+
+  test("GameEngine canRedo false after redo"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    engine.undo()
+    engine.redo()
+    engine.canRedo shouldBe false
+
+  test("GameEngine undo on empty history sends invalid event"):
+    val engine = new GameEngine()
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    engine.undo()
+    observer.events.size shouldBe 1
+    observer.events.head shouldBe a[InvalidMoveEvent]
+
+  test("GameEngine redo on empty redo sends invalid event"):
+    val engine = new GameEngine()
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    engine.redo()
+    observer.events.size shouldBe 1
+    observer.events.head shouldBe a[InvalidMoveEvent]
+
+  test("GameEngine undo via processUserInput"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    val boardAfterMove = engine.board
+    engine.processUserInput("undo")
+    engine.board shouldBe Board.initial
+
+  test("GameEngine redo via processUserInput"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    val boardAfterMove = engine.board
+    engine.processUserInput("undo")
+    engine.processUserInput("redo")
+    engine.board shouldBe boardAfterMove
+
+  test("GameEngine handles empty input"):
+    val engine = new GameEngine()
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    engine.processUserInput("")
+    observer.events.size shouldBe 1
+    observer.events.head shouldBe a[InvalidMoveEvent]
+
+  test("GameEngine multiple undo/redo sequence"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    engine.processUserInput("e7e5")
+    engine.processUserInput("g1f3")
+    
+    engine.turn shouldBe Color.Black
+    
+    engine.undo()
+    engine.turn shouldBe Color.White
+    
+    engine.undo()
+    engine.turn shouldBe Color.Black
+    
+    engine.undo()
+    engine.turn shouldBe Color.White
+    engine.board shouldBe Board.initial
+
+  test("GameEngine redo after multiple undos"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    engine.processUserInput("e7e5")
+    engine.processUserInput("g1f3")
+    
+    engine.undo()
+    engine.undo()
+    engine.undo()
+    
+    engine.redo()
+    engine.turn shouldBe Color.Black
+    
+    engine.redo()
+    engine.turn shouldBe Color.White
+    
+    engine.redo()
+    engine.turn shouldBe Color.Black
+
+  test("GameEngine new move after undo clears redo history"):
+    val engine = new GameEngine()
+    engine.processUserInput("e2e4")
+    engine.processUserInput("e7e5")
+    engine.undo()
+    engine.canRedo shouldBe true
+    
+    engine.processUserInput("e7e6")  // Different move
+    engine.canRedo shouldBe false
+
+  test("GameEngine command history tracking"):
+    val engine = new GameEngine()
+    engine.commandHistory.size shouldBe 0
+    
+    engine.processUserInput("e2e4")
+    engine.commandHistory.size shouldBe 1
+    
+    engine.processUserInput("e7e5")
+    engine.commandHistory.size shouldBe 2
+
+  test("GameEngine quit input"):
+    val engine = new GameEngine()
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    val initialEvents = observer.events.size
+    engine.processUserInput("quit")
+    // quit should not produce an event
+    observer.events.size shouldBe initialEvents
+
+  test("GameEngine quit via q"):
+    val engine = new GameEngine()
+    val observer = new MockObserver()
+    engine.subscribe(observer)
+    val initialEvents = observer.events.size
+    engine.processUserInput("q")
+    observer.events.size shouldBe initialEvents
+
+  // Mock Observer for testing
+  private class MockObserver extends Observer:
+    val events = mutable.ListBuffer[GameEvent]()
+    override def onGameEvent(event: GameEvent): Unit =
+      events += event
+
+end GameEngineTest

modules/core/src/test/scala/de/nowchess/chess/logic/EnPassantCalculatorTest.scala

@@ -0,0 +1,101 @@
+package de.nowchess.chess.logic
+
+import de.nowchess.api.board.*
+import org.scalatest.funsuite.AnyFunSuite
+import org.scalatest.matchers.should.Matchers
+
+class EnPassantCalculatorTest extends AnyFunSuite with Matchers:
+
+  private def sq(f: File, r: Rank): Square = Square(f, r)
+  private def board(entries: (Square, Piece)*): Board = Board(entries.toMap)
+
+  // ──── enPassantTarget ────────────────────────────────────────────────
+
+  test("enPassantTarget returns None for empty history"):
+    val b = board(sq(File.E, Rank.R4) -> Piece.WhitePawn)
+    EnPassantCalculator.enPassantTarget(b, GameHistory.empty) shouldBe None
+
+  test("enPassantTarget returns None when last move was a single pawn push"):
+    val b = board(sq(File.E, Rank.R3) -> Piece.WhitePawn)
+    val h = GameHistory.empty.addMove(sq(File.E, Rank.R2), sq(File.E, Rank.R3))
+    EnPassantCalculator.enPassantTarget(b, h) shouldBe None
+
+  test("enPassantTarget returns None when last move was not a pawn"):
+    val b = board(sq(File.E, Rank.R4) -> Piece.WhiteRook)
+    val h = GameHistory.empty.addMove(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    EnPassantCalculator.enPassantTarget(b, h) shouldBe None
+
+  test("enPassantTarget returns e3 after white pawn double push e2-e4"):
+    val b = board(sq(File.E, Rank.R4) -> Piece.WhitePawn)
+    val h = GameHistory.empty.addMove(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    EnPassantCalculator.enPassantTarget(b, h) shouldBe Some(sq(File.E, Rank.R3))
+
+  test("enPassantTarget returns e6 after black pawn double push e7-e5"):
+    val b = board(sq(File.E, Rank.R5) -> Piece.BlackPawn)
+    val h = GameHistory.empty.addMove(sq(File.E, Rank.R7), sq(File.E, Rank.R5))
+    EnPassantCalculator.enPassantTarget(b, h) shouldBe Some(sq(File.E, Rank.R6))
+
+  test("enPassantTarget returns d3 after white pawn double push d2-d4"):
+    val b = board(sq(File.D, Rank.R4) -> Piece.WhitePawn)
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R2), sq(File.D, Rank.R4))
+    EnPassantCalculator.enPassantTarget(b, h) shouldBe Some(sq(File.D, Rank.R3))
+
+  // ──── capturedPawnSquare ─────────────────────────────────────────────
+
+  test("capturedPawnSquare for white capturing on e6 returns e5"):
+    EnPassantCalculator.capturedPawnSquare(sq(File.E, Rank.R6), Color.White) shouldBe sq(File.E, Rank.R5)
+
+  test("capturedPawnSquare for black capturing on e3 returns e4"):
+    EnPassantCalculator.capturedPawnSquare(sq(File.E, Rank.R3), Color.Black) shouldBe sq(File.E, Rank.R4)
+
+  test("capturedPawnSquare for white capturing on d6 returns d5"):
+    EnPassantCalculator.capturedPawnSquare(sq(File.D, Rank.R6), Color.White) shouldBe sq(File.D, Rank.R5)
+
+  // ──── isEnPassant ────────────────────────────────────────────────────
+
+  test("isEnPassant returns true for valid white en passant capture"):
+    // White pawn on e5, black pawn just double-pushed to d5 (ep target = d6)
+    val b = board(
+      sq(File.E, Rank.R5) -> Piece.WhitePawn,
+      sq(File.D, Rank.R5) -> Piece.BlackPawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R7), sq(File.D, Rank.R5))
+    EnPassantCalculator.isEnPassant(b, h, sq(File.E, Rank.R5), sq(File.D, Rank.R6)) shouldBe true
+
+  test("isEnPassant returns true for valid black en passant capture"):
+    // Black pawn on d4, white pawn just double-pushed to e4 (ep target = e3)
+    val b = board(
+      sq(File.D, Rank.R4) -> Piece.BlackPawn,
+      sq(File.E, Rank.R4) -> Piece.WhitePawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    EnPassantCalculator.isEnPassant(b, h, sq(File.D, Rank.R4), sq(File.E, Rank.R3)) shouldBe true
+
+  test("isEnPassant returns false when no en passant target in history"):
+    val b = board(
+      sq(File.E, Rank.R5) -> Piece.WhitePawn,
+      sq(File.D, Rank.R5) -> Piece.BlackPawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R6), sq(File.D, Rank.R5))  // single push
+    EnPassantCalculator.isEnPassant(b, h, sq(File.E, Rank.R5), sq(File.D, Rank.R6)) shouldBe false
+
+  test("isEnPassant returns false when piece at from is not a pawn"):
+    val b = board(
+      sq(File.E, Rank.R5) -> Piece.WhiteRook,
+      sq(File.D, Rank.R5) -> Piece.BlackPawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R7), sq(File.D, Rank.R5))
+    EnPassantCalculator.isEnPassant(b, h, sq(File.E, Rank.R5), sq(File.D, Rank.R6)) shouldBe false
+
+  test("isEnPassant returns false when to does not match ep target"):
+    val b = board(
+      sq(File.E, Rank.R5) -> Piece.WhitePawn,
+      sq(File.D, Rank.R5) -> Piece.BlackPawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R7), sq(File.D, Rank.R5))
+    EnPassantCalculator.isEnPassant(b, h, sq(File.E, Rank.R5), sq(File.E, Rank.R6)) shouldBe false
+
+  test("isEnPassant returns false when from square is empty"):
+    val b = board(sq(File.D, Rank.R5) -> Piece.BlackPawn)
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R7), sq(File.D, Rank.R5))
+    EnPassantCalculator.isEnPassant(b, h, sq(File.E, Rank.R5), sq(File.D, Rank.R6)) shouldBe false

modules/core/src/test/scala/de/nowchess/chess/logic/MoveValidatorTest.scala

@@ -211,3 +211,47 @@ class MoveValidatorTest extends AnyFunSuite with Matchers:
       sq(File.E, Rank.R4) -> Piece.BlackRook
     )
     MoveValidator.legalTargets(b, sq(File.D, Rank.R4)) should contain(sq(File.E, Rank.R4))
+
+  // ──── Pawn – en passant targets ──────────────────────────────────────
+
+  test("white pawn includes ep target in legal moves after black double push"):
+    // Black pawn just double-pushed to d5 (ep target = d6); white pawn on e5
+    val b = board(
+      sq(File.E, Rank.R5) -> Piece.WhitePawn,
+      sq(File.D, Rank.R5) -> Piece.BlackPawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R7), sq(File.D, Rank.R5))
+    MoveValidator.legalTargets(b, h, sq(File.E, Rank.R5)) should contain(sq(File.D, Rank.R6))
+
+  test("white pawn does not include ep target without a preceding double push"):
+    val b = board(
+      sq(File.E, Rank.R5) -> Piece.WhitePawn,
+      sq(File.D, Rank.R5) -> Piece.BlackPawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R6), sq(File.D, Rank.R5))  // single push
+    MoveValidator.legalTargets(b, h, sq(File.E, Rank.R5)) should not contain sq(File.D, Rank.R6)
+
+  test("black pawn includes ep target in legal moves after white double push"):
+    // White pawn just double-pushed to e4 (ep target = e3); black pawn on d4
+    val b = board(
+      sq(File.D, Rank.R4) -> Piece.BlackPawn,
+      sq(File.E, Rank.R4) -> Piece.WhitePawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    MoveValidator.legalTargets(b, h, sq(File.D, Rank.R4)) should contain(sq(File.E, Rank.R3))
+
+  test("pawn on wrong file does not get ep target from adjacent double push"):
+    // White pawn on a5, black pawn double-pushed to d5 — a5 is not adjacent to d5
+    val b = board(
+      sq(File.A, Rank.R5) -> Piece.WhitePawn,
+      sq(File.D, Rank.R5) -> Piece.BlackPawn
+    )
+    val h = GameHistory.empty.addMove(sq(File.D, Rank.R7), sq(File.D, Rank.R5))
+    MoveValidator.legalTargets(b, h, sq(File.A, Rank.R5)) should not contain sq(File.D, Rank.R6)
+
+  // ──── History-aware legalTargets fallback for non-pawn non-king pieces ─────
+
+  test("legalTargets with history delegates to geometry-only for non-pawn non-king pieces"):
+    val b = board(sq(File.D, Rank.R4) -> Piece.WhiteRook)
+    val h = GameHistory.empty.addMove(sq(File.E, Rank.R2), sq(File.E, Rank.R4))
+    MoveValidator.legalTargets(b, h, sq(File.D, Rank.R4)) shouldBe MoveValidator.legalTargets(b, sq(File.D, Rank.R4))

modules/core/src/test/scala/de/nowchess/chess/main/MainTest.scala

@@ -1,12 +0,0 @@
-package de.nowchess.chess.main
-
-import de.nowchess.chess.Main
-import java.io.ByteArrayInputStream
-import org.scalatest.funsuite.AnyFunSuite
-import org.scalatest.matchers.should.Matchers
-
-class MainTest extends AnyFunSuite with Matchers:
-
-  test("main exits cleanly when 'quit' is entered"):
-    scala.Console.withIn(ByteArrayInputStream("quit\n".getBytes("UTF-8"))):
-      Main.main(Array.empty)

modules/core/versions.env

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

modules/ui/build.gradle.kts

@@ -0,0 +1,73 @@
+plugins {
+    id("scala")
+    id("org.scoverage") version "8.1"
+    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"]!!)
+}
+
+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`
+}
+
+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:api"))
+
+    testImplementation(platform("org.junit:junit-bom:5.13.4"))
+    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("passed", "skipped", "failed")
+        }
+    }
+    finalizedBy(tasks.reportScoverage)
+}
+tasks.reportScoverage {
+    dependsOn(tasks.test)
+}

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

@@ -0,0 +1,16 @@
+package de.nowchess.ui
+
+import de.nowchess.chess.engine.GameEngine
+import de.nowchess.ui.terminal.TerminalUI
+
+/** Application entry point - starts the Terminal UI for the chess game. */
+object Main:
+  def main(args: Array[String]): Unit =
+    // Create the core game engine (single source of truth)
+    val engine = new GameEngine()
+
+    // Create and start the terminal UI
+    val tui = new TerminalUI(engine)
+    tui.start()
+
+end Main

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

@@ -0,0 +1,77 @@
+package de.nowchess.ui.terminal
+
+import scala.io.StdIn
+import de.nowchess.chess.engine.GameEngine
+import de.nowchess.chess.observer.{Observer, GameEvent, *}
+import de.nowchess.chess.view.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 var running = 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.board))
+        e.capturedPiece.foreach: cap =>
+          println(s"Captured: $cap on ${e.toSquare}")
+        printPrompt(e.turn)
+
+      case e: CheckDetectedEvent =>
+        println(s"${e.turn.label} is in check!")
+
+      case e: CheckmateEvent =>
+        println(s"Checkmate! ${e.winner.label} wins.")
+        println()
+        print(Renderer.render(e.board))
+
+      case e: StalemateEvent =>
+        println("Stalemate! The game is a draw.")
+        println()
+        print(Renderer.render(e.board))
+
+      case e: InvalidMoveEvent =>
+        println(s"⚠️  ${e.reason}")
+
+      case e: BoardResetEvent =>
+        println("Board has been reset to initial position.")
+        println()
+        print(Renderer.render(e.board))
+        printPrompt(e.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)
+
+    // Game loop
+    while running do
+      val input = Option(StdIn.readLine()).getOrElse("quit").trim
+      input.toLowerCase match
+        case "quit" | "q" =>
+          running = 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: ")
+
+end TerminalUI

settings.gradle.kts

@@ -1,2 +1,2 @@
 rootProject.name = "NowChessSystems"
-include("modules:core", "modules:api")
+include("modules:core", "modules:api", "modules:ui")