Files
Dune/docs/LOBBY_AI_CONFIGURATION.md
T
Quintine b9718acda8 Configure existing AI seats in the lobby
Let the host change an existing permanent AI seat's difficulty, faction and player circle without removing and readding it. Shared strict validation limits configuration to the authenticated host in the lobby, existing profiles, enabled available factions and unoccupied circles. Preserve seat identity and initialize changed faction rosters consistently. Changes reset human readiness, keep bots ready and explain the changed fields in public history.

Use existing AI strategies without calibration or strength changes. Full AI development waits for all non-AI game features; the goal retains the three adjacent 75% targets, mandatory Git checkpoints and selective subagents without a usage cutoff. No mode or publication gate opens.

Independent implementation and review cover the quote, engine, controls and persistence tests. Types, lint, 4916 offline tests, production build and 46 HTTP checks pass on stable final source. Ten new offline cases cover all factions/profiles, strict guards, roster/identity, immutable rejection, restart/privacy and both configuration-versus-start race outcomes. HTTP verifies authentication, host authority, CSRF, stale/future requests, private views and saved settings. Identical direct actions preserve players/readiness/history but retain the generic action store's version increment; controls suppress them.

Browser QA changed difficulty, faction and circle, verified readiness reset and history, restored settings after refresh and used keyboard selection. Expanded mobile cards were widened after discovering cramped controls; measured selects/buttons are 272 by 44 pixels at a 390-pixel viewport without document overflow. Desktop controls measure 169 by 44 pixels. Screenshot capture timed out, so screenshot-based visual acceptance remains unverified. Configuration controls disappear after starting and saved AI settings persist in setup. The final source rerun follows a preliminary run invalidated by the mobile/readability edits.

All 1262 original rooms, 2644 seats and every prior recovery/entry/handover/delegation/migration row remain unchanged. SQLite integrity and foreign keys pass. No database reset, migration, server restart, usage check or automation was performed. Broader rules, components, durable unattended continuation and final AI acceptance remain unfinished.

Verified source tree: 8c1baf4602d000ee37f081b2a03f8a87e89a63ef14a7121f24268c575a1ac281
2026-09-20 16:57:38 +10:00

36 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Lobby AI configuration
The host can add, remove and configure permanent AI seats before starting. Each
seat's Configure panel offers its existing difficulty, an available enabled
faction and an unoccupied player circle. Changes save immediately; human players
must confirm readiness again, while AI seats stay ready. Changing faction also
updates the public AI name. The same seat ID survives every change and refresh.
The shared `quoteLobbyBotConfiguration` validates the complete action for both
the controls and server: exact fields, authenticated host, lobby status,
permanent AI target, one of four existing profiles, enabled unoccupied faction,
and integer circle 1–6. Human seats, including those using autopilot, cannot be
configured through this action. Faction changes initialize leaders and Ixian
elite reserves consistently with existing lobby selection. Difficulty and circle
changes preserve those rosters. Public history names the changed fields and
explains the readiness reset.
Controls do not send unchanged settings. An identical direct server action
preserves players, readiness and history, but advances the room version through
the existing action store. Concurrent and stale requests retain that store's
version/session fences. Configuration cannot overwrite a simultaneous successful
start, and starting cannot overwrite a successful configuration. If configuration
wins, cleared human readiness blocks starting until reconfirmed.
This is an integrated lobby capability, not AI strategy refinement or complete
multiplayer acceptance. It preserves the existing profiles, mode/expansion start
gates and the [post-feature AI development plan](AI_DEVELOPMENT_PLAN.md).
Evidence includes the focused engine/quote tests in
`tests/lobby-bot-configuration.test.ts`, real SQLite/restart/concurrency checks in
`tests/lobby-bot-configuration-recovery.test.ts`, and authenticated HTTP checks in
`tests/lobby-bot-configuration-http.test.ts`. Browser, independent review and
final source-bound checks/preservation belong to the private checkpoint report
and Git message. Full rules completion, final accessibility review and AI
calibration remain separate gates.