Allow Ecaz Ambassador Duke acquisition for an existing ally

docs/CURRENT_STATUS.md

@@ -16,6 +16,39 @@ open mode gates.
 
 
 ## Current checkpoint and work
+**Shared Ecaz Ambassador Duke — 26 October. Prototyped / Partial.**
+The triggered token can now grant its living Duke to Ecaz's current reciprocal
+ally. Per-recipient controls and all four minimal profiles use the server's
+offered choices. Ordinary source `ecaz` records the granting power and keeps
+unused tenure across turns until battle use; the new-alliance `ally` loan stays
+turn-long. This composition is visibly provisional. Current entry/alliance,
+same-recipient no-op, exceptional custody, occupied-Ecaz priority and Ecaz-only
+revival guards remain. Later Nexus receipts recognize ordinary shared tenure.
+
+Three disjoint quote/native/control lanes and root integration pass **19 files,
+189/189**, types/lint/build and **four native engine/GameTable SSR/actual leaf-
+callback journeys** on unchanged source. Genuine public Basic92/Advanced104-
+action sources play self acquisition, turn-end retention, a real Nexus alliance
+and fresh token entry. After the ally click, real battle use releases the same
+disc; the alternate native-leader battle retains unused Duke into turn3. All33
+original Treachery and12 Nexus cards remain. Pure/controlled supplements cover
+recipient legality, stale/foreign choices, exceptional custody and Nexus receipts.
+
+Frozen v5 report/logs:
+`/home/quintine/.local/share/dune/checkpoints/20261026-ecaz-duke-ally-proof-v5/`;
+journeys/HTML: adjacent `20261026-ecaz-duke-ally-runtime/`.
+No saved-room/D1/server, reset/restart, deployment or recovery operation occurs.
+Actual hook-free callbacks and SSR are not DOM/hydration or browser/mobile/
+deployed acceptance. Complete rules/combinations, mode gates and final assurance
+remain open. [Source and selected tenure](ECAZ_DUKE_ACQUISITION.md#existing-ally-direct-acquisition--26-october-2026).
+
+Next concrete Basic function gap: Distrans rejects even an untouched ordinary
+auction lot before the first bid/pass. Scope that pre-bid transfer under the
+14 October recommended-policy authority, retaining the actual card, lot/order,
+hand-limit eligibility and active-bid restrictions. See
+[the timing audit](RICHESE_DISTRANS_ENGINE_AUDIT.md), `distransBlock` and
+`tests/distrans-engine.test.ts`; broader special-auction timing remains separate.
+
 **Caladan reinforcement before Face Dance — 26 October. Prototyped / Partial.**
 The original winning army may now take its optional reinforcement before native
 replacement. The later reveal uses the live10/11 Arrakis or3/4 Homeworld force
@@ -42,13 +75,6 @@ No clicked-control/DOM/hydration or browser/mobile/deployed acceptance is claime
 Complete rules/combinations, mode gates and final assurance remain open.
 [Source, policy and child scope](HOMEWORLD_VICTORY_REINFORCEMENT_RULES.md#reinforcement-before-face-dance--26-october-2026).
 
-Next concrete Basic function gap: an existing Ecaz ally still cannot receive the
-triggered Ecaz Ambassador's living Duke acquisition. Printed sharing supports
-that branch; scope direct-acquisition tenure separately from the new-alliance
-turn loan, preserving occupied-Ecaz priority and the user's Ecaz-only revival.
-See [the Ambassador audit](ECAZ_AMBASSADOR_EFFECTS_AUDIT.md),
-`ambassadorEffectBlock`, `game/ecaz-duke-acquisition.ts` and `components/ecaz-entry.tsx`.
-
 **Residual Poison after Cunning — 26 October. Prototyped / Partial.**
 The printed pre-leader window now stays available after two completed nonleader
 Cunning inspections. Resolve one actual random leader death/discard, retain an

docs/ECAZ_AMBASSADOR_EFFECTS_AUDIT.md

@@ -125,7 +125,7 @@ These are the remaining consequential combinations, not reasons to ask the user
 - **No-Field, Face Dancer, worm and moving mobile stronghold:** the p.14 explicit No-Field/Face Dancer FAQ is about Terror. It is not an Ambassador FAQ. Ordinary committed force movement is supported by the broad entry trigger; a zero-force No-Field placement and a moving stronghold carrying forces need cause-specific classification. Record the actual arrival type rather than globally equating all `place()` calls with entry.
 - **Tleilaxu Ambassador revival accounting:** the effect supplies its own free amount/leader alternative, but does not expressly say whether prior normal revivals reduce it, whether it consumes subsequent ordinary quota/free allowance, whether dead-twice cycle prerequisites are waived, or whether the leader must satisfy normal revival eligibility. A Ghola card handler hardcodes a different force quantity and income classification and cannot settle those questions. Recruits doubles the current normal free rate; do not automatically double the Ambassador's printed four. Duke's Ecaz-only restriction is explicit; an ally benefit is not an exception.
 - **Independent free revival versus blocked faction advantages:** E1's Tleilaxu payment sentence and technology token rules need their own event classification. `collectRevivalIncome(..., free=true)` currently awards at most once per faction/turn; `ghola=true` awards per use. An Ambassador is not a Ghola card, so choosing that boolean solely to obtain a payout invents a rule. `techIncome` is phase-scoped and once-per-turn; an Ambassador revival during Shipment and Movement must not manufacture Axlotl income outside its printed phase. La La La/free-revival prevention and the Tleilaxu special prevention must be checked by their own wording, not inherited from normal quote plumbing. No specific E3 combination answer was found. [E1 pp.6–7](https://www.gf9games.com/dunegame/wp-content/uploads/2020/09/IxianAndTleilaxuRulebook.pdf#page=6)
-- **Ecaz effect assigned to an existing ally:** the general benefit-sharing sentence and the specific new-alliance Duke loan can be read differently for direct acquisition by an already allied faction. The existing same-turn-loan state must not be reused silently for every shared effect. New-alliance rejection/no-eligible-Duke, and an impossible effect invoked only to recycle a token, also require an explicit no-op consumption policy.
+- **Ecaz effect assigned to an existing ally:** the [26 October selected direct-acquisition composition](ECAZ_DUKE_ACQUISITION.md#existing-ally-direct-acquisition--26-october-2026) now connects printed sharing. Ordinary source `ecaz` lasts until battle use; the distinct new-alliance `ally` loan remains turn-long. This is an explicit provisional tenure choice under the recommended-policy authority. Same-recipient no-op remains rejected before token consumption; wider no-op/alliance edge policies stay separate.
 - **Post-trigger cancellation:** the p.16 entry is placement-specific. Do not add a compulsory generic `ecazAmbassadorEffect` Karama response for all eleven effects. A separately invoked native advantage, such as Harkonnen's additional card or BG's advisor, can still have its own existing cancellation window. Such child windows must return to the Ambassador continuation.
 
 ## Acceptance cases for a complete slice

docs/ECAZ_DUKE_ACQUISITION.md

@@ -1,8 +1,50 @@
 # Ecaz Ambassador: direct Duke acquisition
 
-Integrated 7 September 2026. Ecaz can now choose **Acquire Duke Vidal for Ecaz** when an eligible entrant reaches its reusable Ambassador in supported development games. The server transfers the existing shared disc, returns the token to supply and resumes the entrant’s remaining actions. There is no additional confirmation or new generic Ambassador cancellation response.
+Integrated 7 September 2026; existing-ally extension 26 October 2026. Ecaz can choose **Acquire Duke Vidal** for itself or its current reciprocal ally when an eligible entrant reaches its reusable Ambassador in supported development games. The server transfers the existing shared disc, returns the token to supply and resumes the entrant’s remaining actions. There is no additional confirmation or new generic Ambassador cancellation response.
 
-The direct acquisition and tenure follow the publisher’s [Ecaz & Moritani rules, pp.7–9](https://www.gf9games.com/dune/wp-content/uploads/EcazMoritani-Rulebook-LOWRES.pdf). Fresh indexed publisher retrieval rechecked eligibility outside Tanks, captured or ghola custody. The prior [Duke source audit](DUKE_VIDAL_RULES.md) and [remaining effects readiness review](ECAZ_REMAINING_EFFECTS_READINESS.md) record the separate unresolved combinations. This implements the direct self-acquisition choice; it does not certify the token’s alliance and loan alternatives, full Ecaz or a complete expansion game.
+The direct acquisition and tenure follow the publisher’s [Ecaz & Moritani rules, pp.7–9](https://www.gf9games.com/dune/wp-content/uploads/EcazMoritani-Rulebook-LOWRES.pdf). Fresh indexed publisher retrieval rechecked eligibility outside Tanks, captured or ghola custody. The prior [Duke source audit](DUKE_VIDAL_RULES.md) and [remaining effects readiness review](ECAZ_REMAINING_EFFECTS_READINESS.md) record the separate unresolved combinations. The current direct choice supports self or the existing reciprocal ally as recorded below; this does not certify full Ecaz or a complete expansion game.
+
+## Existing-ally direct acquisition — 26 October 2026
+
+The triggered reusable Ecaz Ambassador may now grant its direct acquisition to
+the current reciprocal ally instead of Ecaz. Publisher E3 p8's general benefit
+sharing and the authorized Advanced physical30,F support the recipient. Under
+14 October choose-recommended authority, select ordinary direct-acquisition
+tenure until battle use, including unused control across turns; this is
+provisional composition, not a publisher worked example. It is distinct from
+the newly formed alliance's optional Basic/automatic Advanced turn-long loan.
+
+Reuse source `ecaz` for the same direct power and physical disc; changing the
+recipient needs no new saved source kind. Qualification is rechecked at this
+actual token entry. A living Ecaz-held or set-aside disc can go to the ally;
+choosing its existing controller still rejects a no-op. Death history and
+`usedAt` remain, and no roster or Traitor gains a duplicate. Captive, concealed,
+Ghola, dead, duplicated-disc and existing table/profile exclusions remain.
+Occupied-Ecaz priority is checked before acquisition; only Ecaz may revive Duke.
+There is no standing gift/transfer action outside a fresh eligible entry.
+A living current-turn Nexus grant may likewise become this ordinary acquisition;
+the original card stays spent. Later Ecaz Cunning receipts recognize ordinary
+source `ecaz` as its granting power even when a former ally holds that tenure,
+including its captured underlay. Native Nexus tenure still requires the native
+Ecaz controller; no custody or mode gate is relaxed.
+
+The private owner sees separate offered beneficiaries and per-recipient reasons.
+All four minimal profiles use the first legal direct recipient after any
+eligible alliance alternative. Generic exceptional-custody reasons retain the
+existing projection boundary. Broader combinations and final assurance remain.
+
+Frozen verification passes **19 files,189/189**, types/lint/build and four native
+engine/GameTable SSR/actual hook-free choice-callback journeys. Genuine public
+Basic92/Advanced104-action sources play self acquisition, unused turn-end
+retention, Nexus alliance and fresh entry. The actual ally grant is followed
+either by Duke battle use/release or a native-leader battle and retained unused
+Duke into turn3. All33 original Treachery and12 Nexus cards remain. The quote,
+engine, controls and original acquisition/bot/Nexus tests cover the related
+guards; controlled receipt supplements are not complete custody campaigns.
+Private report/logs: `/home/quintine/.local/share/dune/checkpoints/20261026-ecaz-duke-ally-proof-v5/`;
+journeys/HTML: adjacent `20261026-ecaz-duke-ally-runtime/`.
+No saved-room/D1/server or recovery operation occurs. Browser/mobile/deployed
+acceptance and full combinations remain due; SSR/callbacks do not prove hydration.
 
 ## No-Skills native Nexus scope extension — 15 October 2026
 
@@ -69,19 +111,19 @@ grant wording. Types pass; no broad suite or deployed acceptance was run.
 
 `game/ecaz-duke-acquisition.ts` quotes a detached next `DukeState` using the existing custody helper. It requires a current seated Ecaz owner and the existing canonical shared disc. It preserves identity, death history and `usedAt`; it never appends a leader to a native roster, adds a Traitor card, manufactures a replacement disc, samples randomness or grants new battle-use permissions. Starting-force initialization remains the normal disc-creation boundary.
 
-The actual entry event, turn/phase, decision owner, physical placed Ecaz token, entrant eligibility and explicit `choice:'duke'`/self-beneficiary are checked before the token commits. Current native-roster duplication rejects through the same availability descriptor. An existing ally does not prevent Ecaz from acquiring for itself. An eligible Duke controlled by Moritani transfers as the same physical disc. The controller/source/turn update and token return occur in one authoritative action, followed by the existing Ambassador suffix.
+The actual entry event, turn/phase, decision owner, physical placed Ecaz token, entrant eligibility and explicit `choice:'duke'`/current self-or-reciprocal-ally beneficiary are checked before the token commits. Current native-roster duplication rejects through the same availability descriptor. An existing ally does not prevent Ecaz from acquiring for itself. An eligible Duke controlled by Moritani transfers as the same physical disc. The controller/source/turn update and token return occur in one authoritative action, followed by the existing Ambassador suffix.
 
 The reusable token does not belong to the five-token random cohort. Its trigger leaves that cohort unchanged and never replenishes it. The chronicle distinguishes reusable return from ordinary set-aside tokens and records previous Duke control, the new tenure and resumption of the entrant’s actions. Successful acquisition emits an automatic notice using Ecaz’s faction color and the existing configurable 1.5-second notice queue.
 
-The existing leader lifecycle supplies Duke to Ecaz’s battle-plan options and consumes temporary custody after battle use. Death retains the same disc in Tanks. Unused source-Ecaz control persists across turns, while a later qualifying Moritani acquisition still takes the same disc. Existing Advanced-Harkonnen and exceptional custody limits remain in force; this feature does not order the unresolved capture/return combination.
+The existing leader lifecycle supplies Duke to the chosen recipient’s battle-plan options and consumes temporary custody after battle use. Death retains the same disc in Tanks. Unused source-Ecaz control persists across turns, while a later qualifying Moritani acquisition still takes the same disc. Existing Advanced-Harkonnen and exceptional custody limits remain in force; this feature does not order the unresolved capture/return combination.
 
-Already controlling Duke, acquisition for an ally, alliance formation and loans remain explicitly unfinished. The same-owner restriction is a development boundary, not an asserted printed prohibition on a no-op trigger. Unsupported or unavailable commands preserve the placed token; declining the opportunity also preserves Duke and resumes the entrant.
+Same-recipient acquisition remains a rejected no-op before token consumption; the self case retains its historical development boundary rather than asserting a printed prohibition. Existing-ally acquisition is now connected as above, and Basic/Advanced new-alliance choices retain their distinct earlier prototypes. Unsupported or unavailable commands preserve the placed token; declining the opportunity also preserves Duke and resumes the entrant.
 
 ## Controls, privacy and AI
 
-Only the actual owner’s Ecaz-token offer contains the `dukeAcquisition` descriptor. The entry panel renders its explicit acquisition button, current availability reason, portrait inspector and leave-in-place alternative. Other seats cannot submit the choice. Exceptional or concealed custody yields a generic unavailable reason rather than exposing a captor/ghola identity; concealed-state private variants cannot vary the availability descriptor. Advanced-Harkonnen configurations are uniformly unavailable before inspecting that custody.
+Only the actual owner’s Ecaz-token offer contains the `dukeAcquisition` descriptor and per-recipient benefit choices. The entry panel renders the offered acquisition buttons and availability reasons, one portrait inspector and the leave-in-place alternative. The self descriptor remains a compatibility fallback when the benefit list is absent. Other seats cannot submit the choice. Exceptional or concealed custody yields a generic unavailable reason rather than exposing a captor/ghola identity. Existing profile restrictions are checked before that custody; the dated no-Skills Harkonnen extensions above supersede the original blanket table restriction.
 
-All four AI profiles use the owner’s projected descriptor to acquire or decline. They do not inspect raw Duke custody, foreign hands, spice or Traitor cards. Enabling the Ecaz handler does not add Ecaz to BG’s random-token copy choices.
+All four AI profiles use the owner’s projected choices to acquire for a legal recipient or decline, after any eligible alliance alternative. They do not inspect raw Duke custody, foreign hands, spice or Traitor cards. Enabling the Ecaz handler does not add Ecaz to BG’s random-token copy choices.
 
 The complete Ambassador gameplay explanation remains readable in the token inspector, including printed alternatives that are not implemented yet. Separate coverage copy identifies those limits. Duke’s shared inspector and internal reference now distinguish unused Ecaz tenure from Moritani end-turn expiry. The public Ambassador inventory is collapsed by default behind a native keyboard-accessible summary showing supply/placed counts; expanding it retains every zone and inspector. Actual entry and placement choices remain open.
 
@@ -89,13 +131,16 @@ The complete Ambassador gameplay explanation remains readable in the token inspe
 
 | Facet | Evidence | Remaining |
 | --- | --- | --- |
-| Implementation | Shared acquisition quote, atomic real entry, token return, original movement/worm suffix, same-disc battle/turn lifecycle | Alliance/loan alternatives, same-owner no-op, Duke revival/capture and full Occupy |
-| Player controls | Explicit action, availability text, complete token guide, Duke portrait, private-owner descriptor, compact inventory | Mobile viewport acceptance of this new panel and broader faction journeys |
-| AI | Eleven tests cover all four policies in Basic/Advanced, with/without ally, unavailable choices and privacy | Strength calibration and full expansion games |
+| Implementation | Shared self/ally quote, atomic real entry, token return, original movement/worm suffix, same-disc battle/turn lifecycle | Same-recipient no-op policy and wider revival/capture/occupation combinations |
+| Player controls | Per-recipient actions/reasons, persistent tenure guidance, complete token guide, Duke portrait, private-owner descriptor, compact inventory | Browser/mobile acceptance of the ally choices and broader faction journeys |
+| AI | All four minimal policies use projected legal recipients in Basic/Advanced; related bot regressions pass | Strength calibration and full expansion games |
 | Documentation | Internal Ecaz/Duke topics, five-facet checklist, Ambassador guide and shared-disc support metadata updated | Complete expansion reference and component inventory |
-| Verification | Thirteen pure/engine, eleven AI and four production-room SQLite tests; actual browser acquisition and subsequent battle | Every legal expansion/module combination and all nested arrival interactions |
+| Verification | Current 19-file189/189 union and four native SSR/callback journeys; historical self-acquisition results below are separately dated | Every legal expansion/module combination and all nested arrival interactions |
 
-## Validation results
+## Historical validation results — 7 September 2026
+
+The following counts and artifacts describe the original self-acquisition
+checkpoint, not verification of the 26 October ally extension.
 
 **2,474 rules/client/component +224 multiplayer tests pass: 2,698 total.** The new slice adds 24 rules/AI and four persistence tests. Full logs: `/tmp/dune-ecaz-duke-rules-final.log` (74.44 seconds), `/tmp/dune-ecaz-duke-multiplayer-final.log` (24.74 seconds). Final typecheck, lint and production build pass in `/tmp/dune-ecaz-duke-{type,lint,build}-final.log`. A final build followed the dedicated Duke inspector’s support-text correction.
 
@@ -105,7 +150,10 @@ Production SQL tests reauthenticate through freshly loaded room code, race two i
 
 The unchanged `/tmp/dune-sapho-base-fullgames.ts` public-start Basic runner completed **20/20 games**, counts 2–6 and all four homogeneous difficulty levels, seed 20261017: **10,450 accepted actions, zero rejected candidates/stalls and 476 JSON round trips**, 65.48 seconds. `/tmp/dune-ecaz-duke-fullgames-final.json` records unchanged game-source hashes during and after execution; combined fingerprint `1c5199b54891e91ac7fbcdbd71a18c545c2bc45a10b67cfa9a777278266ae93c`. This is a shared-engine/AI regression sample, not coverage of the gated Ecaz feature in full games.
 
-## Browser playtest and preservation
+## Historical browser playtest and preservation — 7 September 2026
+
+This is the original self-acquisition playtest. Its room/database counts and
+server session are historical; no hourly maintenance or restart is now scheduled.
 
 Existing isolated QA room `8S3MRDEK` was backed up at v86, preserving both authenticated seat IDs. A conserved Advanced Ecaz/Moritani position stages an already Moritani-controlled Duke, a placed reusable Ecaz Ambassador and Ecaz forces in Arrakeen. The actual Moritani shipment of two forces creates the Ecaz offer at v87. Browser acquisition reaches v88 with the same disc now controlled by Ecaz, the token in supply, five random companions unchanged and the entrant’s paid shipment/counters intact. Refresh preserves the result.
 

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,35 @@
 # Dune implementation status
 
+## 26 October 2026 — Existing-ally Ecaz Ambassador Duke acquisition
+
+**Prototyped / Partial.** Connect the printed benefit-sharing branch to the
+current reciprocal ally at a fresh Ecaz-token entry. Reuse ordinary source
+`ecaz` as the granting power with until-battle tenure, including unused control
+across turns. Keep the distinct new-alliance `ally` loan turn-long; this shared
+composition is explicitly provisional under 14 October authority. Per-recipient
+private controls, authoritative blockers and all four minimal profiles are
+connected. Preserve same-disc identity/history, occupied-Ecaz priority, Ecaz-only
+revival, exceptional custody and table/profile restrictions. Later Ecaz Cunning
+receipts admit ordinary shared tenure without changing native Nexus tenure.
+
+Frozen **19-file189/189**, types/lint/build and **four native engine/GameTable
+SSR/actual hook-free callback journeys** pass. Genuine public Basic92/Advanced104-
+action sources earn self acquisition, unused turn-end retention, Nexus alliance
+and fresh entry with Ecaz holding Duke. The actual ally choice resumes the
+entrant; a real Duke battle releases the same disc, while the alternate native-
+leader battle retains unused Duke into turn3. All33 physical Treachery and12
+Nexus cards remain. Pure/control supplements cover recipient/custody guards,
+projection/busy/foreign behavior and current living/captured Nexus receipts.
+Feedback repaired obsolete self-only bot expectations, test array intersections,
+one now-valid ordinary-source receipt mutation and an unused fixture import.
+
+Proof: `/home/quintine/.local/share/dune/checkpoints/20261026-ecaz-duke-ally-proof-v5/`;
+journeys/HTML: adjacent `20261026-ecaz-duke-ally-runtime/`.
+No saved-room/D1/server, reset/restart, deployment or recovery operation. SSR and
+leaf callbacks do not claim DOM/hydration or browser/mobile/deployed acceptance.
+Complete rules/combinations, mode gates and final assurance remain open.
+[Source and selected tenure](ECAZ_DUKE_ACQUISITION.md#existing-ally-direct-acquisition--26-october-2026).
+
 ## 26 October 2026 — Caladan reinforcement before Face Dance
 
 **Prototyped / Partial.** Select optional original-winner reinforcement before

docs/RULE_DECISIONS.md

@@ -1,5 +1,18 @@
 # Rule decision index
 
+## Existing-ally Ecaz Ambassador Duke acquisition — 26 October 2026
+
+Connect printed Ambassador benefit sharing (publisher E3 p8, authorized
+Advanced physical30,F) to the current reciprocal ally. Under 14 October
+choose-recommended authority, use ordinary direct-acquisition tenure until battle
+use, including unused persistence, rather than the new-alliance turn loan.
+Existing source `ecaz` identifies that direct power for either recipient; no new
+source kind or standing transfer action is added. Fresh entry/token/current
+alliance, same-recipient no-op, physical custody, occupied-Ecaz priority and
+Ecaz-only revival remain checked. This tenure composition is visibly provisional,
+not a publisher worked example or complete mode admission.
+[Source and execution](ECAZ_DUKE_ACQUISITION.md#existing-ally-direct-acquisition--26-october-2026).
+
 ## Caladan reinforcement before Face Dance — 26 October 2026
 
 Under the 14 October choose-recommended authority, grant the original winning