Files
Dune/docs/ADVISOR_PREPARATION.md
T
Quintine 660b0a0c25 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.
2026-10-24 18:36:55 +11:00

129 lines
7.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.