Add random faction deal and prediction draft

docs/CURRENT_STATUS.md

@@ -16,6 +16,17 @@ open mode gates.
 
 
 ## Current checkpoint and work
+**Faction allocation at setup — 28 October. Prototyped / Partial.** Hosts can
+deal random enabled factions or start a draft in descending prediction-number
+order. Human seats choose in order, bots choose automatically, and choices
+apply together after the draft. Seat identities remain; human readiness clears.
+Direct selection still works. Nine related unit files pass 43 cases; four
+isolated HTTP cases include a four-seat/two-controller draft and game start.
+An isolated browser room exercised a random deal, a human draft choice and an
+automatic AI pick through completion.
+Consensual swaps, wider combinations and deployed acceptance remain open.
+[Scope](FACTION_ALLOCATION.md).
+
 **Advanced Voice names for ordinary cards — 28 October. Prototyped / Partial.**
 Native and borrowed Voice can require or forbid an exact ordinary battle-card
 face in Advanced. Generic Voice and Basic choices remain; matching covers

docs/FACTION_ALLOCATION.md

@@ -0,0 +1,38 @@
+# Faction allocation in the lobby
+
+## Sources and scope — 28 October 2026
+
+**Prototyped / Partial.** The user-authorized revised Dune rulebook, physical
+page 4 (printed page 2), gives two initial methods: randomly deal faction
+prediction cards, or draw distinct turn-prediction numbers and select factions
+from highest to lowest. It also permits players to swap factions. The original
+publisher rulebook describes the same selection methods; this prototype exposes
+both in Basic and Advanced and retains the existing direct-choice option.
+
+A host may deal once from all factions belonging to currently enabled families,
+without replacement. Alternatively, the host deals distinct numbers 1–10 to
+seated faction seats. The public draft follows descending numbers, rejects a
+picked or disabled faction and applies all choices together after the last pick.
+These cards represent the setup draw and are not removed from later Bene Gesserit
+prediction. Existing temporary faction selections do not reserve faces during a
+draft. The host may cancel the draft; the previous factions remain. The engine
+uses the existing cryptographic shuffle, event-bound actions and room version
+fencing, and clears human readiness when allocation begins and ends.
+
+For the provisional two-person/four-faction setup, each faction seat receives
+its own draw and pick. That is a software interpretation of the two-faction
+case, not a separate publisher clarification. Seats, credentials, host and
+player-circle positions remain attached to the same participants. AI seats pick
+a legal available faction automatically, preferring their existing faction
+when available. They retain their difficulty and a faction-appropriate name.
+Selection does not bypass any existing expansion/profile start gate.
+
+Nine related unit files pass 43 cases; four isolated HTTP cases include a
+four-seat/two-controller draft, seat selection and game start. These do not
+establish complete setup or deployed acceptance. An isolated browser room also
+exercised a random deal and a human/AI draft to completion.
+
+Consensual faction swaps are not implemented yet. A host's random deal is an
+explicit action and direct selection remains available; neither is a substitute
+for a participant-approved swap. Broader player-count interpretations, complete
+setup combinations, saved-game assurance and deployed acceptance remain open.

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,16 @@
 # Dune implementation status
 
+## 28 October 2026 — Random faction deal and prediction-number draft
+
+The host can deal enabled factions randomly or start a public descending-number
+draft, with automatic legal bot picks and all human choices applied together.
+Seat identity and existing start gates remain. Nine related unit files pass 43
+cases; four isolated HTTP cases include two controllers selecting for four
+separately authenticated faction seats and starting the game. Consensual swaps,
+wider combinations and deployed acceptance remain open. An isolated browser
+room also exercised random dealing and a human/AI draft to completion.
+[Scope](FACTION_ALLOCATION.md).
+
 ## 28 October 2026 — Advanced Voice names for ordinary cards
 
 Advanced Voice can provisionally require or forbid a specific ordinary

docs/RULE_DECISIONS.md

@@ -1,5 +1,15 @@
 # Rule decision index
 
+## Faction allocation before setup — 28 October 2026
+
+The supplied revised rulebook, physical p. 4 (printed p. 2), describes random
+faction dealing or descending turn-prediction-number draft order and permits
+swaps. The prototype implements the first two methods in the lobby, retaining
+direct selection and existing start gates. Each faction seat receives its own
+draw in the two-person/four-faction mode; that composition and the automatic
+AI pick are software interpretations. Consensual swaps remain unfinished.
+[Scope](FACTION_ALLOCATION.md).
+
 ## Advanced Voice and ordinary card names — 28 October 2026
 
 The supplied revised Advanced rules, physical p. 28 (printed p. 26), permit a