sasa/battleship
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: implement sessions, lobby, roles, and rematch lifecycle

Browse Source
This commit is contained in:
sasa
2026-08-28 22:57:17 +03:00
parent ec1ff20ddd
commit a691783f58
10 changed files with 488 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
PLANS.md
+13 -2
View File
@@ -521,7 +521,7 @@ If all criteria pass, set this milestone to `DONE`, append its execution record,
## Milestone 009 — Implement sessions, lobby, roles, and rematch lifecycle
**Status:** `READY`
**Status:** `DONE`
**Depends on:** Milestone 008
### Objective
@@ -549,11 +549,22 @@ Implement the complete in-memory application state machine and bounded client/se
If all criteria pass, set this milestone to `DONE`, append its execution record, and change Milestone 010 from `BLOCKED` to `READY`.
### Execution record
- Date: 2026-08-28
- Board model and revision: ESP32-C6FH4 QFN32, revision v0.2.
- Toolchain and library versions: PlatformIO Core 6.1.19; `espressif32` 7.0.1; ESP-IDF 6.0.1; `esp_littlefs` 1.20.4.
- Result: PASS.
- Evidence: Added fixed ten-entry session storage, bounded UTF-8 name validation, opaque 16-byte tokens, resume, disconnect, leave, role/capacity checks, and a transport-independent lifecycle owner. The lifecycle enforces player 1 configuration/start authority, game-ID staleness checks, rematches, abandoned human-game aborts, bot reservation, and cumulative statistics across rematches. Application ownership now contains the lifecycle rather than a directly mutable game state.
- Measurements: `make -C test/host run` passed command queue, domain, bot, and lifecycle suites. Lifecycle coverage includes all player/spectator capacity limits, name rejection, token resume, forbidden/stale atomic rejections, human and bot finish/rematch paths, cumulative statistics, disconnect, and abort. Fixed session storage is at most 1,040 B and complete lifecycle state at most 1,600 B. `pio run -e esp32-c6-devkitm-1` passed with 38,212 / 327,680 B RAM (11.7%) and 1,000,730 / 2,097,152 B flash (47.7%), within the Milestone 005 limits.
- Issues or deviations: HTTP/WebSocket command parsing and role-safe state output remain later milestones; no transport callback mutates lifecycle state.
- Next action: Milestone 010 is ready. Do not start it unless explicitly requested.
---
## Milestone 010 — Implement safe state presentation and bounded serialization
**Status:** `BLOCKED`
**Status:** `READY`
**Depends on:** Milestone 009
### Objective