Connect Tleilaxu Nexus free leader and paid force revival

docs/CURRENT_STATUS.md

@@ -29,6 +29,28 @@ optional skill bands, combinations and public expansion starts remain open.
 Rules implementation continues; comprehensive assurance and administration
 remain deferred until all rules are implemented.
 
+**Tleilaxu Secret Ally combined revival — 14 October.**
+The recommended prototype now provides owner-only leader/paid-force controls
+in quiet Revival, with the actual Tleilaxu Nexus held and faction absent.
+One mandatory own dead leader returns free and consumes the ordinary slot;
+zero-to-five exact counters cost one bank spice each and share an ordinary
+ceiling expanded to at least five. Earlier ordinary returns count; larger
+native/Recruits allowances remain. Only the unopened roster trigger is waived:
+ordinary cycles, repeated deaths, typed caps and special custody remain.
+This policy is visible and provisional, not publisher clarification.
+
+Genuine Basic/Advanced setup, shipment, opposing weapon, eight-counter loss,
+worm pact and real closing draw lead to this action. No target hand/force/
+wallet/death/phase is fabricated. Original skill return, reserves and typed
+Homeworld deployment source are reused. Final nine-file union141/141,
+types/lint/build pass. Four legal profiles execute the real leader+five return.
+Actual390px table: Dr. Yueh alive with deaths1/cycle0; spice11→6,
+Tanks8→3, reserves10→15, returns5 and leader slot consumed, one Nexus
+discard and Ready restored. No overflow or browser errors. Existing Ecaz
+six-disc/Advanced-Harkonnen Duke candidate guards and full module/deployed
+acceptance remain open.
+[Contract](NEXUS_TLEILAXU_RULES.md#recommended-combined-revival-prototype--14-october-2026).
+
 **Moritani Atomics after alliance change — 14 October.**
 The recommended interpretation keeps the permanent hand-limit penalty on
 Moritani and its original ally at detonation. Later Nexus and Enemy of My Enemy

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,40 @@
 # Dune implementation status
 
+## 14 October 2026 — Tleilaxu Secret Ally free-leader/paid-force revival
+
+Recommended-option priority closes the earlier whole-effect gate under an
+explicit provisional policy: mandatory free own leader/ordinary leader slot,
+zero-to-five physical counters at one bank spice each, shared ordinary ceiling
+expanded to at least five. Prior returns count; card-first and ordinary-first
+agree. Larger native/Recruits allowance is not reduced; fixed group never
+doubles. Only unopened roster eligibility is waived; original cycles,
+repeated-death/face-down, actual typed caps and special custody are retained.
+
+Two disjoint implementation/native-proof slices were integrated by one owner.
+The pure quote reuses canonical leader/counter eligibility; the engine binds
+actual held card/event, pays the bank once, returns the real leader through
+original skill/custody handling, deposits exact counters and records per-phase
+source permission. Homeworld signed return accepts the new Nexus source.
+Owner-only controls and four minimal legal profiles use the same offered
+selection. Wording/forwarding/fixture-trace assertions were removed rather
+than re-pinned.
+
+Native fixtures retain genuine setup, starting cards, Emperor shipment,
+real weapon death/eight-counter exchange, worm alliance and actual original
+Nexus draw. Only original unplayed deck order and producer entropy are staged.
+Ignored immutable Ready results and Advanced Guild interception were repaired
+in the fixture, never by fabricating phases, hands, deaths, wallets or forces.
+
+Final nine-file union141/141; types/lint and app build pass. Actual390×844
+table returns Dr. Yueh with deaths1 and cycle0 unchanged, spice11→6,
+Tanks8→3/reserves10→15, ordinary returns5 and leader slot consumed.
+One physical Nexus goes to discard, the offer disappears and Ready stays
+enabled. No overflow or browser errors. All four legal policies execute that
+actual five-counter return; not strategic calibration. Owned hosts/tabs/
+scaffolding removed; proof outside Git. Existing build warnings remain.
+Ecaz six-disc/Advanced-Harkonnen Duke candidate restrictions, combined
+modules, full rules, assurance and deployed acceptance remain open.
+
 ## 14 October 2026 — Persistent original Atomics hand-limit targets
 
 Recommended-option priority: the permanent one-card reduction stays on

docs/NEXUS_CARD_RULES.md

@@ -1351,7 +1351,7 @@ The [bounded Ixian Secret Ally replacement integration](NEXUS_IXIAN_REPLACEMENT_
 - The common trigger is the end of the full Spice Blow and Nexus phase. The later shorthand about the next Nexus is read with that opening condition; it does not establish an extra draw after each Advanced blow. Keep that implementation decision explicit in runtime documentation.
 - No retrieved card or E3 FAQ gives a general rule that every Nexus effect is Karama-immune, or that playing one suspends all ordinary responses. Homeworld immunity on the preceding page is limited to Homeworld advantages/penalties. Audit cancellation of an underlying native advantage separately from cancellation of the Nexus card before enabling each family.
 - Duration is explicit for several panels but not all. Ixian Betrayal's scope over multiple auction lots, the optional continuation after canceling native Prescience, and exact multi-party cancellation priority require the corresponding existing faction timing contract. Do not make an entire-phase cancellation merely from the word “advantage.”
-- Emperor forced ally payment needs a precise invoice allocation when the ally has some funds and Emperor is short. Its own purchase-refund alternative also needs original payer contributions. Tleilaxu's combined leader/force revival requires an audit of partial selection and interaction with ordinary free rates; the card does not say that all five force revivals are free.
+- Emperor forced ally payment and purchase refunds retain their precise source-invoice requirements. Tleilaxu's combined revival now uses the [explicit recommended policy](NEXUS_TLEILAXU_RULES.md#recommended-combined-revival-prototype--14-october-2026): a mandatory free own leader/ordinary slot and fixed paid physical group sharing an expanded ordinary ceiling, with preserved cycles and typed caps. This is a provisional implementation, not a new publisher answer; the five counters are not free.
 - Richese's two-No-Field effect has a bounded native Cunning shipment follow-up, but wider marker/module compositions remain separate. Its [bounded Betrayal auction contract](NEXUS_RICHESE_RULES.md#bounded-betrayal-auction-contract--30-september-2026) connects public self-cache veto and other-buyer sale diversion, not normal-deck hidden-family self-purchases or private special-Karama acquisition. Ecaz's Duke override needs explicit restoration/end-turn handling across capture, death and Ghola records. These are material implementation tasks, not reasons to invent substitute effects.
 - A complete twelve-card reference/inventory and common lifecycle are substantial first work, but do not alone make all thirty-six panels playable. Keep the public module release gated until every face's supported timing, secrecy, custody, bots, UI, rejection, multiplayer CAS and saved continuation paths are verified. If development supports only Atreides' family first, other faces must remain accurately represented and explicitly unavailable in the audit mode; they must not silently act as blanks in a released module.
 

docs/NEXUS_TLEILAXU_RULES.md

@@ -44,7 +44,7 @@ Important compositions and exclusions:
 
 ## Secret Ally questions that still affect implementation
 
-The inspected E3 FAQ does not answer these. Keep Secret Ally gated rather than implementing a smaller interpretation disguised as the complete effect.
+The inspected E3 FAQ does not answer these. The earlier blanket gate is superseded by the explicit recommended prototype policy below; that choice is not publisher clarification or a separately answered numerical user ruling.
 
 | Issue | Concrete interpretations requiring a ruling |
 | --- | --- |
@@ -54,10 +54,59 @@ The inspected E3 FAQ does not answer these. Keep Secret Ally gated rather than i
 
 Normal leader revival has an unavailable-roster trigger and a separate repeated-death cycle. E1 expressly permits face-down leaders for its negotiated service, and the FAQ separately discusses native foreign-ghola revival. Neither automatically grants those permissions to an absent-faction Nexus effect. Similarly, the FAQ's Emperor extras are explicitly additional, while this panel does not settle its ordinary counter debit. [Base p.9](https://www.gf9games.com/dunegame/wp-content/uploads/Dune-Rulebook.pdf#page=9), [E1 p.7](https://www.gf9games.com/dunegame/wp-content/uploads/2020/09/IxianAndTleilaxuRulebook.pdf#page=7), [November FAQ p.6](https://www.gf9games.com/dune/wp-content/uploads/2020/11/Dune-FAQ-Nov-2020.pdf#page=6)
 
-Coordinator question recommendation: ask explicitly about independent versus ordinary force/leader allowance, waived leader prerequisites, and whether the leader portion is optional. The related [Ambassador accounting questions](TLEILAXU_AMBASSADOR_RULES.md) are already pending; do not duplicate those or assume an answer covers differently worded Nexus text. No user question was sent by this audit.
+The 14 October choose-recommended-option instruction supersedes the coordinator's earlier recommendation to ask again. The related Ambassador wording remains a separate contract; this implementation does not invent publisher answers or apply its policy to another component.
 
-Future revival quote inputs should retain source `nexusTleilaxuSecretAlly`, chosen leader/Kwisatz identity, exact normal/starred force counts, payment and existing usage histories. Require a resolved accounting policy before mutating ordinary counters. A receipt must preserve original revival, subsequent Homeworld deployment and phase continuation once; no card/force/spice effect should be inferred afresh from a restored hand or current Tanks.
+The committed action binds the actual held card, current turn/phase/owner event, selected own leader/Kwisatz/Duke and exact physical paid group. It uses the original return/skill/reserve helpers and an explicit `nexusTleilaxu` Homeworld source. The per-phase source permission records the shared five-counter ceiling; no native Tleilaxu income or cancellation owner is manufactured.
 
 ### Source-search follow-up
 
-The requested web search found no publisher/designer answer to the three questions above. The [publisher-authored expansion rulebook, pp. 11, 14–16](https://gamers-hq.de/media/pdf/0f/7a/86/Dune_EcazMoritani_Rulebook_EN.pdf) explains Nexus cards and answers other faction interactions, but does not specify whether this grant is additional to ordinary revival, consumes the ordinary leader slot, or permits using only one part. The printed card wording quoted above establishes quantities and prices, not these accounting or partial-use rules. Search-result summaries that conflate Secret Ally with native Tleilaxu revival or Ghola are not rulings. All three questions remain pending; do not implement an inferred answer.
+The prior requested search found no publisher/designer answer to these questions. The [publisher-authored expansion rulebook, pp. 11, 14–16](https://gamers-hq.de/media/pdf/0f/7a/86/Dune_EcazMoritani_Rulebook_EN.pdf) establishes other Nexus interactions, not this allowance/slot/partial-use accounting. Search summaries conflating Secret Ally with native revival or Ghola are not rulings. Publisher provenance remains unanswered; the explicit recommended prototype policy below is a separate implementation decision.
+
+## Recommended combined revival prototype — 14 October 2026
+
+The selected provisional interpretation is complete and visible:
+
+- **Shared allowance:** expand the ordinary ceiling to at least five, with
+  earlier ordinary returns counting against it, not an extra five. Card-first
+  and ordinary-first both retain that ceiling afterward. A larger native or
+  Recruits allowance is not reduced, but the fixed card group never exceeds
+  five. Every card counter costs one bank spice; none is an actual free force.
+- **Leader:** one own dead leader is mandatory, costs zero and consumes the
+  ordinary one-leader slot. Zero forces is legal; force-only use is not.
+  The card waives the unopened unavailable-roster prerequisite, not repeated
+  death/face-down cycles or special custody. Do not write the synthetic open
+  cycle into ordinary history. Kwisatz/Auditor and own eligible Duke reuse
+  canonical identity rules; captured/living/foreign-Ghola/Cheap Hero choices
+  are excluded.
+- **Existing limits:** Advanced Fedaykin/Sardaukar share their one-per-turn
+  cap across producers; Basic keeps physical stars; Cyborgs keep their actual
+  identity and the printed one-spice price. The explicit card grant does not
+  pass through the native Fremen paid-revival prohibition.
+
+Own Ecaz repeated six-disc cycle and Advanced-Harkonnen Duke custody guards
+remain explicit pre-existing candidate limitations, not a whole-card blank.
+No native Tleilaxu early-revival or income response can exist while that
+faction is absent. Southern Hemisphere receives the actual new typed deposit
+through its original signed deployment/arrival continuation. Broader optional
+module acceptance remains open.
+
+Implementation: `game/nexus-tleilaxu-revival.ts`,
+`game/nexus-tleilaxu-options.ts`, `game/revival.ts`, original engine and
+Homeworld return helpers, `components/nexus-tleilaxu-revival.tsx`.
+Genuine Basic/Advanced fixtures preserve original setup and cards: a real
+Emperor shipment/weapon kills Dr. Yueh during the actual winning eight-counter
+exchange, a real worm opens Nexus, the other two seats ally, and the original
+Tleilaxu singleton is drawn before quiet Revival. Staging is only unplayed
+deck order and original-producer entropy; no hands, forces, deaths, Tanks,
+wallets, alliances or phases are fabricated.
+
+Final nine-file union141/141, types/lint and app build pass. Native cases cover
+paid/zero force use, both ordinary/card orders, typed and repeated-death
+boundaries, wrong actor/quantity/stale event rejection and the next real turn.
+All four legal policies return the actual leader and five counters for5 spice.
+Actual390×844 table: Dr. Yueh returns with deaths1/cycle0 unchanged;
+Atreides spice11→6, Tanks8→3, reserves10→15, ordinary returns5 and leader
+slot consumed. Exactly one physical Nexus is discarded, the offer disappears
+and Ready remains enabled. No overflow or browser errors. Owned hosts/tabs/
+scaffolding were removed; local proof stays outside Git. Full Nexus, faction,
+combined-module and deployed acceptance remain open.

docs/RULE_DECISIONS.md

@@ -546,7 +546,8 @@ These are unresolved in the cited records. Do not infer an answer from elapsed t
 | Base special Karama | Unfunded auction recovery, stopped-shipment settlement and Atreides full-plan commitment order remain provisional. Native full-plan/Voice/Prescience/Truthtrance/Ghola interactions now have genuine-setup focused evidence, but the source audit does not settle the special offer/deadline or target-first interpretation. | [Explicit base interpretations](BASE_ADVANCED_READINESS_20260907.md#explicit-unresolved-base-interpretations), [full-plan interaction audit](ATREIDES_FULL_PLAN_TIMING.md) |
 | Homeworld high-threshold revival deployment | The publisher does not state whether a return that itself first reaches the high threshold may deploy on that same return. The content-first prototype evaluates the resulting population, so the crossing return qualifies; this is a visibly provisional composition, not a located timing ruling. The Tleilaxu low-income start-condition snapshot is unchanged, and partial groups, split destinations, storm placement, allied-Homeworld limits and shipment-classified entry effects remain guarded. | [Benefits contract](HOMEWORLD_BENEFITS_RULES.md#provisional-high-threshold-revival-deployment--9-october-2026), [resumption record](IMPLEMENTATION_STATUS.md#9-october-2026--gated-captures-resumed-under-the-basic-occupation-and-odd-force-occupy-prototypes) |
 | Occupied Homeworlds | The publisher question about retention after departure, replacement or contest, unique-power composition and shared income remains open; the first-occupier/current-occupier question was already sent. The content-first Basic benefit selector now uses the visibly provisional current-sole policy above (Tupile excepted), which is an implementation choice, not an answer to that question. | [Occupation questions](HOMEWORLD_OCCUPATION_RULES.md#questions-the-retrieved-sources-do-not-settle), [lifecycle audit](HOMEWORLD_OCCUPATION_LIFECYCLE_AUDIT.md), [Basic policy](HOMEWORLD_OCCUPATION_RULES.md#basic-current-sole-benefit-policy--9-october-2026) |
-| Nexus responses and composition | Betrayal private-response timing, partial revival/payment choices, Emperor fewer-than-five, fresh advisor/storm cases, Duke restoration and remaining faction-specific combinations. Tleilaxu Secret Ally force accounting, leader slot/eligibility and force-only use remain unresolved after requested publisher/designer source searches; do not infer answers from native Tleilaxu revival or Ghola. | [Common boundaries](NEXUS_CARD_RULES.md#remaining-source-questions-and-release-boundaries), [Tleilaxu source search](NEXUS_TLEILAXU_RULES.md#source-search-follow-up) and individual faction source/runtime documents |
+| Nexus responses and composition | Betrayal private-response timing, Emperor fewer-than-five, fresh advisor/storm cases, Duke restoration and remaining faction-specific combinations remain source-bound. Tleilaxu Secret Ally now has the explicitly provisional recommended combined policy in its own row below; it is not borrowed authority from native revival or Ghola. | [Common boundaries](NEXUS_CARD_RULES.md#remaining-source-questions-and-release-boundaries) and individual faction source/runtime documents |
+| Tleilaxu Secret Ally revival | Under choose-recommended-option priority, a quiet unallied actual holder with Tleilaxu absent returns one mandatory own dead leader free, using the ordinary leader slot, and zero-to-five exact counters at one bank spice each. The card shares an ordinary ceiling expanded to at least five; prior normal returns count, larger native/Recruits allowances remain, and the fixed card group is never doubled. Only the unavailable-roster trigger is waived; repeated-death/face-down and special custody rules remain, with original ordinary cycles preserved. No force-only use, native Tleilaxu income or nonexistent cancellation owner is invented. This is provisional implementation policy, not publisher clarification or a separately answered numerical user ruling. | [Recommended combined policy](NEXUS_TLEILAXU_RULES.md#recommended-combined-revival-prototype--14-october-2026) |
 | Moritani Atomics after alliance change | The publisher’s permanent −1 text does not identify later-ally treatment, and prior requested searches found no clarification. Under choose-recommended-option priority, retain the original affected pair permanently: Moritani and its ally at detonation. Later Nexus and Enemy of My Enemy alliances are allowed without moving the penalty to a new ally; an unallied detonation gains no later ally target. Existing stored activation targets migrate immutably, without replaying effects. This is a conservative provisional implementation interpretation, not publisher clarification or a separately answered numerical user ruling. | [Recommended persistent targets](MORITANI_TERROR_RULES.md#recommended-persistent-activation-targets--14-october-2026) |
 | Moritani Sneak Attack entry classification | The printed verb is “Send”; no retrieved ruling classifies the off-planet reserve transfer as a shipment for other arrival powers. The engine now **explicitly adopts** the supported shipment composition: a positive Sneak Attack in Shipment and Movement accrues the Heighliners token once for its owner, then offers the Bene Gesserit Intrusion (Advanced, with fighters present) and the free spiritual-advisor shipment, with the committed Terror entry resolving first; a zero-force resolution accrues nothing and opens no reaction. This order is an implementation interpretation, not a publisher ruling. | [Source boundary and adopted classification](MORITANI_ASSASSINATION_SNEAK.md#adopted-shipment-classification-7-october-2026) |
 | Orgiz collection | Basic retains the publisher-p13 per-blow ambiguity and provisional one-transfer-per-positive-deposit mapping. Authorized supplied Advanced rulebook physical24 says each time Collection occurs in a territory containing spice: one transfer per actual positive territory Collection per fighter occupant, never extra transfers for multiple source keys. Canonical ordinary deposit receipts identify actual payers, including co-present collectors; force presence and old wallets alone do not qualify. Under choose-recommended-option priority, owners and eligible foreign ordinary payers resolve in original storm order. Shared Ecaz lots in both modes wait for actual bilateral allocation, then consider positive foreign recipients Ecaz first, ally second; Advanced charges once per territory, Basic counts actually reduced positive source deposits in that territory. Self, zero shares and empty purses are skipped; balances track every transfer without debt. Ordering and the Basic mapping are provisional implementations, not separate numerical user answers or publisher rulings. | [Advanced source cutover and Basic boundary](DISCOVERY_PROTOTYPE.md#authorized-advanced-collection-wording) |