Support AI opponents in two-faction games

docs/CURRENT_STATUS.md

@@ -1,6 +1,6 @@
 # Current development status
 
-Updated 27 October 2026. **The full twelve-faction goal is unfinished. Basic
+Updated 28 October 2026. **The full twelve-faction goal is unfinished. Basic
 is playable. Advanced, expansion-faction and supported optional-module starts
 are labelled previews; complete rules/publication acceptance remains gated.**
 
@@ -16,6 +16,18 @@ open mode gates.
 
 
 ## Current checkpoint and work
+**AI opponent in the four-faction setup — 28 October. Prototyped / Partial.**
+The host can add two AI faction seats under one AI controller. Existing lobby
+configuration applies separately; removing either bot keeps or promotes the
+remaining seat correctly. Mixed human/AI controller groups are rejected, and
+bot IDs grant no human seat access. Seven related unit files pass 75 cases; an
+isolated HTTP case covers room setup, credential rejection and start. Bots use
+their existing independent legal policies; coordinated strategy, strength
+calibration, complete games and deployed acceptance remain open.
+An isolated browser room also exercised adding both AI seats, removing and
+promoting the original primary, and adding a replacement.
+[Scope](TWO_PLAYER_TWO_FACTIONS.md).
+
 **Truthtrance and Atreides ordinary auction knowledge — 27 October. Prototyped /
 Partial.** A structured fact compares the current successfully inspected
 ordinary auction card with a public printed name. Single/compound controls,
@@ -40,8 +52,9 @@ and actions. Exactly two controllers with two seats each are required to start;
 ordinary victory uses the four-stronghold target. Independent factions and no
 automatic alliance are provisional. Focused setup, victory, UI and isolated
 HTTP cases pass; complete games, player-count interactions, comprehensive
-custody review and deployed acceptance remain open. Human seats are required;
-handover into a browser holding another active room seat remains unsupported.
+custody review and deployed acceptance remain open. The current AI-opponent
+follow-up above adds bot seats. Handover into a browser holding another active
+room seat remains unsupported.
 [A dedicated isolated browser room](TWO_PLAYER_TWO_FACTIONS.md) also exercised
 adding, switching and independently readying the host's two factions.
 [Scope](TWO_PLAYER_TWO_FACTIONS.md).

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,17 @@
 # Dune implementation status
 
+## 28 October 2026 — AI opponent with two factions
+
+An AI controller can have two distinct bot faction seats in the optional
+two-person setup. Hosts may add, configure and remove each seat, with controller
+promotion after removing its original bot. The game rejects mixed human/AI
+ownership. Seven focused unit files pass 75 cases, including bot-driven setup;
+an isolated HTTP case confirms room setup, start and rejected bot-seat
+impersonation. An isolated browser room exercised adding both bot seats,
+primary removal, promotion and replacement. The bots retain independent legal policies; coordinated strategy,
+strength calibration, full games and deployed acceptance remain open.
+[Scope](TWO_PLAYER_TWO_FACTIONS.md).
+
 ## 27 October 2026 — Truthtrance and Atreides ordinary auction knowledge
 
 A single or compound structured question can compare a named Treachery Card

docs/TWO_PLAYER_TWO_FACTIONS.md

@@ -95,10 +95,15 @@ the UI explicit about which faction owns each pending decision. Existing
 autopilot can operate a faction seat only under its existing authorization;
 until full AI refinement, each offered decision needs a minimal legal bot path.
 
-The current prototype requires human seats, permits ordinary existing
-seat-autopilot, and does not yet support accepting a handover into a browser
-already holding a different active seat for the same room. The mode cannot be
-disabled once a secondary faction is added. Recovery replaces an existing
+The prototype supports human controllers, an AI controller with two bot seats,
+and ordinary existing human-seat autopilot. AI factions use independent legal
+policies, not coordinated strategy or calibrated two-faction strength. The host
+can add either AI faction, configure each and remove a bot seat; if the primary
+bot leaves, its remaining bot is promoted to the controller identity. Each
+controller must be entirely human or entirely AI. Accepting a handover into a
+browser already holding a different active seat for the same room remains
+unsupported. The mode cannot be disabled while a secondary faction is present.
+Recovery replaces an existing
 scoped credential for the recovered seat without overwriting another valid
 legacy seat. Comprehensive recovery, revocation and custody acceptance remain
 open.