Support consensual lobby faction swaps

docs/CURRENT_STATUS.md

@@ -16,6 +16,17 @@ open mode gates.
 
 
 ## Current checkpoint and work
+**Consensual faction swaps — 28 October. Prototyped / Partial.** Human seats can
+offer, accept, decline or cancel a faction exchange. Offers bind current seats
+and factions; conflicting lobby changes wait while seat switching and exit
+remain available. Acceptance clears human readiness and preserves seat identity,
+credentials, circles and host. Ten related unit files pass 48 cases; two
+isolated HTTP cases cover authenticated four-seat swaps and faction allocation.
+An isolated browser room exercised offer, seat switching and acceptance, and
+confirmed the exit control remains available during an offer.
+AI swaps, wider combinations and deployed acceptance remain open.
+[Scope](FACTION_ALLOCATION.md).
+
 **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
@@ -24,7 +35,7 @@ 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.
+AI swaps, wider combinations and deployed acceptance remain open.
 [Scope](FACTION_ALLOCATION.md).
 
 **Advanced Voice names for ordinary cards — 28 October. Prototyped / Partial.**

docs/FACTION_ALLOCATION.md

@@ -32,7 +32,19 @@ 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.
+Human seats may offer an exchange of their currently assigned factions. The
+recipient accepts or declines and the proposer may cancel; each action is bound
+to the current offer. A pending offer freezes other lobby changes and new seats
+until resolved, but players can switch between their own seats or exit. Only
+acceptance changes the assignments and clears human readiness. Seat IDs,
+credentials, circles and host remain attached to their participants; faction
+leaders and Ixian elites follow the new faction. AI seats cannot offer or
+receive swaps yet. Broader player-count interpretations, AI swap policy,
+complete setup combinations, saved-game assurance and deployed acceptance
+remain open.
+
+For the swap checkpoint, ten related unit files pass 48 cases and two isolated
+HTTP cases exercise allocation and authenticated swaps across independently
+controlled seats. This evidence does not certify every setup combination.
+An isolated browser room also exercised an offer between two controlled seats,
+including switching to accept, cleared readiness and an available exit control.

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,18 @@
 # Dune implementation status
 
+## 28 October 2026 — Consensual lobby faction swaps
+
+Human seats can offer an exchange, with recipient acceptance or decline and
+proposer cancellation. The offer freezes conflicting lobby changes; on
+acceptance factions and their initial assets change while seat identities,
+credentials, circles and host stay put and human readiness clears. Ten related
+unit files pass 48 cases, and two isolated HTTP cases exercise the existing
+allocation and authenticated swaps including separately controlled seats.
+An isolated browser room exercised offer, seat switching and acceptance, with
+exit available during the offer and readiness reset on acceptance.
+AI swap policy, broader setup combinations and deployed acceptance remain open.
+[Scope](FACTION_ALLOCATION.md).
+
 ## 28 October 2026 — Random faction deal and prediction-number draft
 
 The host can deal enabled factions randomly or start a public descending-number

docs/RULE_DECISIONS.md

@@ -4,10 +4,11 @@
 
 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
+swaps. The prototype implements these 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.
+AI pick are software interpretations. Human seats can exchange factions by
+offer and acceptance; AI participation in swaps remains unfinished.
 [Scope](FACTION_ALLOCATION.md).
 
 ## Advanced Voice and ordinary card names — 28 October 2026