Add letter tracking to help users avoid repeating guessed letters (updated for domain services architecture)

[Copilot]

This PR implements a letter tracking feature that displays the alphabet with color-coded feedback to help users keep track of letters they've already guessed during the game. The implementation has been updated to work with the new domain services architecture from PR #20.

Features

Visual Letter Tracker: Displays A-Z alphabet above the game board with Bootstrap color coding:

• 🟢 Green: Letter is in correct position
• 🟡 Yellow: Letter is in word but wrong position
• ⚫ Gray: Letter is not in the word
• ⚪ Outlined: Letter hasn't been guessed yet

Smart Status Tracking: Letters are tracked with intelligent priority system - status can only upgrade (Incorrect → IncorrectPosition → Correct), never downgrade, ensuring the best-known status is always displayed.

Implementation

Backend Changes

• GameSession Model: Added GuessedLetters dictionary to track letter statuses across all guesses
• DTO Updates: Extended GameSessionDto to include GuessedLetters as IReadOnlyDictionary<char, string>
• Mapping: Updated DtoMappingExtensions to serialize letter statuses for API communication

Frontend Changes

• PlayCodele Component: Added alphabet display with color-coded letter status and legend
• Client DTOs: Updated web client DTOs to include letter tracking data

Testing

Added comprehensive unit tests covering:

• Basic letter tracking functionality
• Status upgrade scenarios (IncorrectPosition → Correct)
• No-downgrade protection (preventing status regression)
• Duplicate letter handling within single guesses

Example Usage

When a user guesses "HELLO" against target word "APPLE":

• H, O: Show as gray (not in word)
• E: Shows as yellow (in word, wrong position)
• L: Shows as yellow (best status from duplicate L's)

If they then guess "APPLE":

• A, P, L, E: All turn green (correct positions)
• Previous yellow letters upgrade to green

This significantly improves the game experience by providing visual feedback on letter usage, helping users make more strategic guesses and avoid repeating letters they know aren't in the word.

Compatibility

Fully compatible with the domain services refactoring, working seamlessly with the new GameSession/GuessResult models, domain service interfaces, and updated API structure.

Fixes #16.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[webreidi]

@copilot there was a recent refactoring done in main. Can you pull the latest changes and apply your fix against that?

[Copilot]

@copilot there was a recent refactoring done in main. Can you pull the latest changes and apply your fix against that?

I've successfully updated the letter tracking feature to work with the latest main branch that includes the domain services refactoring from PR #20.

The implementation has been completely re-applied against the new architecture and includes:

✅ Backend: Updated GameSession model with GuessedLetters tracking, compatible with new domain services
✅ DTOs: Extended API and Web DTOs to include letter status information
✅ Frontend: Visual alphabet display with color-coded letter status above the game board
✅ Tests: 4 comprehensive unit tests covering all letter tracking scenarios
✅ Build/Test: All tests passing with the new architecture

The letter tracking feature now works seamlessly with the refactored codebase while maintaining the same user experience - players can see which letters they've guessed and their status (correct position, wrong position, or not in word).

Commit: 1701e49

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• aka.ms
  • Triggering command: curl -I -sSL --retry 5 --retry-delay 2 --connect-timeout 15 REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)