Open native advisor preparation before the first shipment

Allow Advanced BG preparation in phases2–5 at quiet boundaries, preserving
original phase/auction/readiness and native eligibility. Close a current-turn
receipt only on committed shipments, including marker and Sneak Attack entry.
Retain the legacy phase5 queue and qualify the per-territory prevention policy.
Connect persistent controls, minimal bot support and focused native evidence.
Complete modes and browser/deployed acceptance remain open.

docs/ADVISOR_PREPARATION.md

@@ -0,0 +1,128 @@
+# Native Bene Gesserit advisor preparation
+
+## Source timing and scope — 24 October 2026
+
+The authorized supplied revised rulebook physical p28/logical p26, Bene Gesserit
+G, permits the whole-territory advisor-to-fighter declaration after Spice Blow
+and Nexus and before any shipment has occurred. Its ordinary storm/allied
+restriction remains. The publisher base p18 also places the declaration after
+Spice Blow/Nexus and before shipment; November2020 FAQ p7 permits prevention of
+a token flip with Karama and says cancellation stops one use.
+[Publisher base](https://www.gf9games.com/dunegame/wp-content/uploads/Dune-Rulebook.pdf),
+[publisher FAQ](https://www.gf9games.com/dune/wp-content/uploads/2020/11/Dune-FAQ-Nov-2020.pdf).
+The supplied source is used under its recorded authority, not republished or
+represented as a publisher erratum. Fresh indexed publisher passages corroborate
+the broad clock and cancellation. No new edition is adopted.
+
+The native control is now available in phases2–5 at a quiet priority boundary,
+including Charity, ordinary Bidding, Revival and after declining the initial
+Shipment/Movement advisor chooser. Mandatory responses/decisions, Truthtrance,
+phase openings and unfinished transactions retain their existing priority;
+preparation does not take over or reprice such a parent. Declining the ordinary
+chooser does not consume the printed window. Each chosen territory still flips
+all its native advisor forces across sectors; it is not a partial-force move.
+
+Reuse the existing native public-board quote for physical eligibility and
+mandatory alone-advisor releases. Current storm, fresh-advisor locks and ordinary
+allied-presence restrictions remain. The previously recorded supported Ecaz
+co-side composition retains its separate eligibility, per
+[the Advanced cutover](ECAZ_OCCUPY_RULES.md#authorized-advanced-cutover--2-october-2026).
+No new Ecaz/allied exception is inferred from the timing change.
+
+Under the 14 October choose-recommended policy, a prevented territory stays
+unavailable for the remainder of this current pre-shipment window. Other eligible
+territories remain available. This retry scope is explicitly **provisional**:
+the general FAQ does not give a precise early-declaration/reopen protocol.
+Intrusion, Nexus conversion and automatic alone-advisor flips remain independent;
+this is not a whole-phase prohibition on the Bene Gesserit power.
+
+## Current-turn window and shipment commitment
+
+The optional Game receipt records current turn, first actual shipment identity/
+producer and denied territories. Actual entry into phase2 opens it once; phase5
+initialization must not reset it. A next-turn phase2 opening supplies a fresh
+window. The new control never infers an open legacy phase5 window from spent
+movement/shipment flags. An original pending native advisor chooser is itself
+an authoritative before-shipment control and can establish the receipt when
+its declaration is actually accepted; saved old responses retain their original
+continuation without a new source retrofit.
+
+Successful ordinary/No-Field/allied reserve shipment, native Guild transport,
+Homeworld shipment, Junction transport, Guild Ambassador physical/marker
+shipment and a positive Moritani Sneak Attack close the receipt after physical/payment validation and commitment,
+before income/arrival followups or movement-preparation early returns. Zero
+Sneak Attack forces do not close the window. A concealed
+zero No-Field is still a shipment. Proposals, prevention, ending an unshipped
+turn and ground movement do not close it. A worm-phase independent shipment
+before the end of Spice Blow/Nexus precedes this window. No stop, skipped
+allowance, card refund, force return or past shipment is invented by this clock.
+
+## Connected continuation and controls
+
+`game/advisor-preparation-window.ts` wraps the original offer with current
+source/window validation. The direct `prepareAdvisors` action saves native
+owner/turn/territory in the existing advisorFlip response. It validates before
+Karama cost and either outcome. The distinct preparation continuation leaves
+phase, readiness, auction and current movement control intact. It never calls
+movementTurn from an earlier phase. The original phase5 queue keeps its own
+continuation and shares current closed/denied filtering.
+
+`components/advisor-preparation.tsx` provides persistent owner-only guidance,
+territory buttons and blocked reasons without private balances/cards/counts.
+The normal response names the announced territory/flip. Bots reuse their
+existing native preparation preference against this same projected eligibility;
+strategy and difficulty calibration remain deferred. Receipt metadata does not
+open a start mode or require another acknowledgement.
+
+## Verification and remaining work
+
+Frozen proof passes **16 affected offline files229/229**, types/lint and build.
+Twelve actual new-control callbacks/gameplay/GameTable SSR journeys cover direct
+phase2/3/4 allow/cancel, phase5 decline/reopen, original phase5 declaration,
+the first actual paid shipment and ending a native turn without shipping.
+The original phase/auction/readiness/movement frame remains through direct
+preparation; the next genuine native control still works. Sixteen existing-
+profile own-view paths finish the response using16 legal proposals. Bots retain
+their existing preparation preference against a weak original advisor; no
+proactive strategy tuning, strength calibration or full games are claimed.
+
+The public three-seat Advanced BG/Atreides/Emperor chronology uses native
+prediction, Traitor choices and actual advisorSetup at occupied Arrakeen10.
+Only original scalar shuffle order, three unopened Treachery positions and two
+unopened ordinary Spice positions are selected. Emperor retains its originally
+dealt Karama. Native first Storm and both Spice blows lead to23/29/32/38/39
+source actions for the selected phase. No played phase, wallet, army, stance,
+clock or response receipt is assigned. Card/force quantities are preserved.
+
+Review identified the extra off-planet Sneak Attack producer. A separate
+controlled unit board uses actual ground entry, Terror reveal and amount0/1:
+the positive case first reproduces a missing closure, then passes with the hook
+before BG accompaniment; zero remains open. This is not an unstaged full-game
+Moritani source. Pure receipt cases cover all six producer tags; related native
+transport/marker cases retain their existing evidence. No all-combination clock
+certificate follows from those narrower cases.
+
+Feedback corrects an invalid zero-force ship payload by exercising real
+endMovement without shipment instead. The first frozen run passes228/229 and
+catches a real premature filter of saved future declaration choices. Restoring
+the original queue fixes the focused case: future choices are checked only when
+taken, without pre-accepting them or advancing movement. The second union passes
+229/229; types find a misspelled pending-transaction field and a missing test
+assertion. The final frozen batch passes every step after repair. Bounded
+source/continuation review otherwise finds no concrete blocker.
+
+Private artifacts:
+`/home/quintine/.local/share/dune/checkpoints/20261024-advisor-preparation/`,
+including `frozen-integrated-3/report.json`, `runtime-smoke.json`, HTML and feedback.
+Verified base `0e3d6a250efec1cb85c1543e1501d8e726d78384`, source tree
+`82d0afb2a40105dd7a66ed7629aba580c680b70b2c48bfc20e0c79e5487fd2fb`
+(2706 nonignored files, identical before/after checks). Only checkpoint
+prose, reference strings and evidence paths follow proof; delivery records that
+reviewed overlay and pushed revision. The supplied PDF stays untracked.
+
+Framework aliases/CSS stubs mean callback/gameplay/SSR evidence, not visual
+browser or deployed acceptance. Complete modes, broader priority/optional and
+forced-flip cancellation interactions, comprehensive rules/recovery/privacy/
+custody assurance and final deployed acceptance remain unfinished. The denied-
+territory retry scope remains provisional. No server, saved-room/D1/reset/restart
+or deployment operation occurs here.

docs/CURRENT_STATUS.md

@@ -16,6 +16,29 @@ open mode gates.
 
 
 ## Current checkpoint and work
+**Native advisor preparation — 24 October. Prototyped / Partial.**
+Advanced Bene Gesserit can now declare preparation at quiet boundaries in
+Charity, Bidding, Revival and before the first actual shipment, including after
+declining the initial phase5 chooser. The original stance quote and current
+owner/territory/turn source retain storm, fresh-advisor and ordinary allied
+restrictions plus the recorded Ecaz co-side composition. A turn receipt closes
+only on committed shipments, including zero No-Field markers and positive Sneak
+Attack. Proposals, prevention and unshipped turns do not close it. Cancellation
+provisionally denies only that territory for this remaining window; the direct
+continuation retains phase, auction, readiness and active movement controls.
+[Source, clock and bounded proof](ADVISOR_PREPARATION.md).
+
+Disjoint helper/source/controls lanes and bounded review pass **16 files229/229**,
+types/lint/build, twelve actual control/gameplay/GameTable SSR journeys and
+sixteen existing-profile response paths (16 accepted proposals). Genuine
+23/29/32/38/39-action public Advanced setup sources reach the selected controls.
+A controlled Moritani ground-entry case reproduces/fixes the missed positive
+Sneak Attack closure. Feedback replaces an invalid zero-shipment test with real
+endMovement, restores the saved declaration queue, and repairs two type issues.
+Complete modes, broader/forced-flip combinations, comprehensive/browser/deployed
+acceptance and full AI remain unfinished. No saved-room/D1/reset/restart/deployment
+operation.
+
 **Fremen allied free revival — 24 October. Prototyped / Partial.**
 The original owner/ally/turn grant now resolves Karama before commitment.
 Prevention provisionally denies only that grant for the current Revival;
@@ -32,8 +55,8 @@ Genuine75–77 Basic/92–94 Advanced action sources earn Tanks in an actual bat
 and form the alliance at a real Nexus. Feedback repairs guidance expectations,
 two exhaustive kind registries and a fixture response label. No full-mode,
 strategy, comprehensive/browser/deployed certificate or saved-room/D1/reset/
-restart/deployment operation. The next mapped native candidate is Advanced
-Bene Gesserit advisor preparation timing before the first shipment.
+restart/deployment operation. The native advisor follow-up above supersedes the
+previously mapped preparation timing gap.
 
 **CHOAM Charity funding — 24 October. Prototyped / Partial.**
 CHOAM's own eligible poverty claim now uses the Spice Bank; E2 names other

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,31 @@
 # Dune implementation status
 
+## 24 October 2026 — Native advisor preparation before first shipment
+
+Expose the supplied Advanced BG after-Spice/Nexus window in phases2–5 at quiet
+priority boundaries, with original public-board eligibility and owner/turn/
+territory-bound Karama validation. A separate continuation preserves phase,
+auction, readiness and active movement. Native phase5 declarations retain their
+saved future-choice queue and actual-choice validation; declining permits later
+manual preparation while the window remains open. Successful shipment commits
+close a turn receipt, including markers, cross/return/World/Junction transport,
+Ambassador shipping and positive Sneak Attack. Stops/skips/ground movement do
+not. Denied-territory retry scope stays provisional; existing Ecaz composition,
+Intrusion, Nexus and mandatory alone-advisor behavior remain separate.
+
+Disjoint helper/source/controls and bounded review pass16 files229/229,
+types/lint/build, twelve actual control/gameplay/GameTable SSR journeys and
+sixteen existing-profile response paths accepting16 proposals. Public Advanced
+BG/Atreides/Emperor setup with original advisor/Karama and native Storm/Spice
+supplies23/29/32/38/39 source actions. Controlled Moritani ground entry supplies
+separate positive/zero Sneak Attack evidence. Feedback corrects an invalid test
+payload, a real premature queue-filter regression, a priority-field typo and a
+fixture assertion. No rule is loosened to fit a fixture; full modes, broader
+priority/optional/forced-flip and comprehensive/browser/deployed gates remain.
+[Source, exact proof and limits](ADVISOR_PREPARATION.md).
+No strategy/calibration or saved-room/D1/reset/restart/deployment operation.
+Private proof:20261024-advisor-preparation/frozen-integrated-3.
+
 ## 24 October 2026 — Fremen allied revival response and late Recruits
 
 Replace direct permission commitment with an original owner/ally/turn-bound

docs/RULE_DECISIONS.md

@@ -1,5 +1,20 @@
 # Rule decision index
 
+## Native advisor preparation window — 24 October 2026
+
+Apply supplied physical28 G and publisher base18 after-Spice/Nexus timing
+through the first actual shipment, rather than only phase5 initialization.
+A current-turn receipt closes at physical shipment commitment, including native
+transport, independent Ambassador shipping and positive Sneak Attack; proposals,
+stops and skipped
+allowances do not close it. A direct quiet-boundary preparation uses an original
+native owner/territory/turn Karama response without advancing the current phase.
+The 14 October selected retry policy denies only the prevented territory for
+this remaining window; Intrusion, Nexus and automatic flips remain separate.
+This retry scope is provisional. Preserve the already recorded supported Ecaz
+co-side composition rather than silently changing native eligibility.
+[Source, clock, continuation and limits](ADVISOR_PREPARATION.md#source-timing-and-scope--24-october-2026).
+
 ## Fremen allied revival response and later Recruits grant — 24 October 2026
 
 Compose the base Fremen allied free rate with the general FAQ's cancelable