jhalitaksoy/mancala
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
d1918fed10
mancala/docs/specs/game-bot/tasks.md

22 lines
1.7 KiB
Markdown
Raw Normal View History

docs(game-bot): add the spec Requirements, design and tasks for playing against a bot with four levels and a strength drawn per game.
2026-10-16 12:46:20 +03:00
# Game bot: tasks
Work through the tasks in order; each ends with its tests passing and a commit. Tick a task when it is committed.
- [x] 1. **Spec**: requirements, design and tasks.
feat(backend): add a compact board for searching moves Position keeps the board as 14 stone counts and plays the Mangala rules on it without allocating. Tested against MancalaGame with the recorded games and random games.
2026-10-16 12:47:32 +03:00
- [x] 2. **Compact board**: `Position` in the engine package; tests against `MancalaGame` with the recorded parity
docs(game-bot): add the spec Requirements, design and tasks for playing against a bot with four levels and a strength drawn per game.
2026-10-16 12:46:20 +03:00
games and random games.
feat(backend): choose bot moves by strength Negamax with alpha-beta on Position scores every move; the strength sets the depth, the softmax temperature and the chance of a random move. The levels are ranges of strengths drawn per game. A calibration tournament checks that each level beats the one below.
2026-10-16 14:11:46 +03:00
- [x] 3. **Search and strength**: `BotLevel`, `BotSettings`, `BotStrength`, `BotSearch`, `BotPolicy` with unit
docs(game-bot): add the spec Requirements, design and tasks for playing against a bot with four levels and a strength drawn per game.
2026-10-16 12:46:20 +03:00
tests; `BotTournamentTest` (tag `calibration`) and its quick version; tune the evaluation weights and the
strength table until R2.4 holds, and write the final values into `design.md`.
feat(backend): play games against the bot new_bot_game starts a game against the bot at the chosen level and ends the search for an opponent. BotPlayer works out the bot's moves on its own thread pool and plays them on the game loop after the previous move's animation and a thinking time. Bot games keep their settings across restarts.
2026-10-16 14:18:45 +03:00
- [x] 4. **Bot games in the backend**: `new_bot_game`, `BackendGame.bot`, `playMove` split out of `onGameMove`,
docs(game-bot): add the spec Requirements, design and tasks for playing against a bot with four levels and a strength drawn per game.
2026-10-16 12:46:20 +03:00
`onTurnStarted`, bot ids in `GameStore`, `PublicIds` and the connection info; `BotPlayer` and its executor in
`Backend`, `BOT_SEARCH_THREADS`; `bot` in snapshots and their restore; unit tests.
feat(backend): save how the bot played Saved games against the bot keep the bot's level, strength and seed in a new bot column, so the levels can later be tuned from real games.
2026-10-16 14:19:56 +03:00
- [x] 5. **Saving**: `bot` in `GameRecord`, migration `003_bot`, the repository; integration tests.
feat(core): add bot levels, the bot game channel and bot names getPlayerDisplayName shows the bot as e.g. "Bot · Medium" from its id.
2026-10-16 14:20:31 +03:00
- [x] 6. **Core**: `channel_new_bot_game`, `BotLevel`, `BOT_LEVELS`, `BOT_OFFER_DELAY_MS`, `isBotId`,
docs(game-bot): add the spec Requirements, design and tasks for playing against a bot with four levels and a strength drawn per game.
2026-10-16 12:46:20 +03:00
`getBotLevel`, `getPlayerDisplayName` for bots, texts in English and Turkish; unit tests.
feat(frontend): offer games against the bot The lobby offers the bot levels after 10 seconds without an opponent, the home page has a Play with bot menu, and a game against the bot ends with Play again at the same level.
2026-10-16 14:22:04 +03:00
- [x] 7. **Web app**: `BotLevelPicker`, the home page button, the lobby offer and `?bot=`, "Play again" after a bot
docs(game-bot): add the spec Requirements, design and tasks for playing against a bot with four levels and a strength drawn per game.
2026-10-16 12:46:20 +03:00
game, bot names everywhere players are shown.
feat(mobile): offer games against the bot The lobby offers the bot levels after 10 seconds without an opponent, the home screen has Play with bot, the bot is shown with its level, and a new game after a bot game is one at the same level.
2026-10-16 14:23:22 +03:00
- [x] 8. **Mobile app**: lobby offer and `botLevel`, home screen button, bot names; type check and bundle.
docs(game-bot): add the spec Requirements, design and tasks for playing against a bot with four levels and a strength drawn per game.
2026-10-16 12:46:20 +03:00
- [ ] 9. **End to end and docs**: the Chrome tests from `design.md`; `README.md`, `apps/backend/README.md`,
`AGENTS.md` (the specs list, bot ids, the calibration test) and `TODO.md` (the out of scope items).
Reference in New Issue Copy Permalink