Dune/docs/ADVISOR_MATCHING.md

# Matching incoming Bene Gesserit groups

## Guild and Junction transport — 24 October 2026

**Prototyped / Partial.** Compose supplied revised
Advanced physical28's marked matching clause and physical17's group counter
with fresh Guild cross-transport and Junction board arrivals. Incoming BG board
groups retain their actual source stance. A Junction native or foreign World
packet provisionally starts with the ordinary fighter default; multiple selected
world keys are one original transport packet. Match only opposite-type arrivals
joining actual BG residents. Returns to reserves/worlds need no board matching.

The selected provisional priority offers matching after the original fresh
declaration's legality/funding quote, before native Guild transport permission,
rate, Guild Betrayal settlement or any payment/transfer. These sources do not
specify their relative response order. Junction's Homeworld permission and
tariff stay immune; matching targets only BG's independent group conversion.
Absent-Guild Secret Ally retains its unspent actual Nexus and bank price until
the original physical commitment. Native Guild Cunning belongs to Guild, not
BG; it grants no extra BG transport. Purchased Karama is an independent price,
not a cross-transport permission.

The public ten-field source contains only event, producer, owner, turn/phase,
origin, destination/sector, target stance and physical group. Private native
opportunity identity, original order/funding and exact signature remain outside
that receipt. Before either counter outcome, revalidate the real original grant
and packet using a nonmutating projection of its owned matching controls;
Junction/Secret frontdoor busy checks must not reject their own response. Never
create matching events in movement-preparation simulation.

Under the existing provisional remedy, prevent only that packet/destination/
stance in the same producer opportunity, retaining the unused shipment and
original Junction offer or Secret card. A different packet/destination remains
available. Price changes, destination sectors and response UUIDs cannot retry
the same original packet. Human quotes and minimal bots share those denials.
Allowance consumes the matching parent before invoking the exact original
permission/Secret/Junction suffix once. Existing stored permission/rate/Betrayal
continuations keep their old protocol; do not reopen them or replay costs. This
fresh-declaration cutover preserves the original full-rate cleanup timing.

[Native sources](../tests/fixture-advisor-transport-matching.ts) earn original
public Advanced BG/Guild/Atreides setup, original advisor and Karama, paid
fighters, actual Nexus alliance or current high-native Junction offer. Separate
[Secret Ally source](../tests/fixture-advisor-secret-transport-matching.ts)
earns absent-Guild Nexus entitlement with BG unallied and an actual Atreides/
Emperor alliance supplying native draw eligibility. Sources use85 public actions
for allied Guild,82 for Junction board,36 for native World and74 for Secret.
No played force, hand, phase, alliance, grant, offer or response is installed.

Frozen **25 files437/437**, types/lint/build, twenty native declaration/response/
replacement/original-permission/rate/GameTable SSR journeys, two controlled
Truthtrance cases and sixteen existing-profile paths with32 accepted actions
pass. Both board directions and native World arrivals preserve state while
matching waits. Prevention keeps the actual grant, blocks the same packet and
admits empty or genuine two-counter replacements. Matching allowance still
precedes original Guild permission and, when a real discount exists, rate.
A one-force city price has no separate discount; actual desert discount does.
Original permission denial and unaffordable full-rate cancellation leave the
physical shipment unused. Secret keeps its Nexus through prevention and spends
it once on actual transfer. Junction retains original tariff/custody/income.

Bounded review identifies and repairs Truthtrance's own busy overlay in grant
validation and an inconsistent matching-only price restriction. A labelled
controlled original-card relocation reproduces the busy failure; both overlay
regressions then preserve real Truthtrance priority and resume the same matching
response. Runtime feedback corrects city-discount and actual empty-target
assumptions; type feedback normalizes nullable World tables at three adapters.
Controlled Truthtrance custody is not a native earned draw. Standard controls
render; SSR does not establish callback/hydration or browser acceptance.

Private proof and HTML:
`/home/quintine/.local/share/dune/checkpoints/20261024-advisor-transport-matching/`.
`frozen-integrated-4/report.json` binds tree
`43e21e75f3d9b4130593e5c4427c1df86232ea8e8506408c38861706e09437d7`,
2766 files on base `c999054ae02d5a03d1005448f9c467bf0c44bed3`.
Checkpoint prose/reference overlays are separately reviewed. Two-origin
gathering, mixed foreign-World/purchased-price/Betrayal/other modules, all valid
combinations and final browser/deployed/mode assurance remain open. No AI
refinement or saved-room/D1/server/reset/restart/deployment operation.

## Fremen Ambassador relocation — 24 October 2026

**Prototyped / Partial.** The supplied revised
Advanced physical28 matching clause covers incoming shipping/moving groups;
physical17 permits preventing the group's flip. Fremen Ambassador relocation
can move a genuine BG ally's opposite-type group into its residents. This is a
separate matching operation before the physical transfer, not the later alone
conversion. Basic and same-type/empty arrivals retain their original behavior.

Native grant, token, phase, mutual ally, route, fresh-advisor locks and occupancy
remain the original producer's authority. After their quote succeeds, offer
matching before CHOAM's movement reaction, Sandmaster collection or any transfer.
The public ten-field source binds event, original Ambassador parent, owner,
turn/phase, origin, destination/sector, target stance and selected physical group.
The exact original order and parent signature stay private. An inactive ordinary
player may own this independent allied grant; do not use their normal moved
index as its identity. Existing normal matching sources retain their shape.

Under the existing provisional prevention policy, restore the original owned
move chooser while retaining the already-consumed trigger and all ordinary
allowances. Deny that same packet/destination/stance for this Ambassador event;
a sector, response UUID or optional fighter flag cannot retry it. Another
packet or destination remains available. Do not invent a trigger refund, a new
decline action or a turn-wide ban. Minimal bots and human drafts use the shared
quote to omit blocked packets. Allowance consumes the matching parent before
one original CHOAM/transfer/arrival suffix; original post-transfer mandatory
conversions retain their own timing. Already-recorded old continuations are
not reopened or replayed.

[Native fixture](../tests/fixture-advisor-ambassador-matching.ts) earns the
public Advanced BG/Ecaz/Atreides base33 setup, original Arrakeen advisor, paid
two-force Tuek's fighter group, real first-Revival Fremen placement, actual
turn-two Shai-Hulud/Nexus alliance and a paid third-party entrant. Ecaz selects
its genuinely allied BG beneficiary. No played force, hand, alliance, phase or
matching response is installed. Both direction payloads and later replacement
choices remain caller-owned. [Connected cases](../tests/advisor-ambassador-matching-engine.test.ts)
cover allowance/prevention, unchanged pending physical state, scoped retry and
different-packet/empty replacement, exact parent binding and minimal profiles.
The frozen batch passes **17 files358/358**, types/lint/build, six native
declaration/response/replacement/GameTable SSR journeys and eight existing-profile
paths with sixteen accepted response/replacement actions. Each source uses81
actual public actions. Both matching directions retain forces, stances, money
and allowances while pending. Allowance moves once without replaying the trigger;
prevention preserves that grant, rejects the original packet and admits either
the actual two-force packet or empty Polar Sink replacement. The no-matching
route retains the original Karama. Four existing profiles respond and choose a
legal replacement after prevention, without strategic refinement.

The first native allowance passes. Feedback only repairs an empty-source
zero/absence test assertion; the focused repair and final union pass. The native
runtime required no application source repair. Private proof and original-source
HTML live in
`/home/quintine/.local/share/dune/checkpoints/20261024-advisor-ambassador-matching/`.
`frozen-integrated-2/report.json` binds tree
`c2f21f81711c05ce6eb466d152fc65de53bb816dbcf04215e92fa3028e513107`,
2761 files on base `767bace7747ccf3cfb62600dc31cd47b2d46117b`.
Only checkpoint prose/reference overlays follow that proof, with separate
link/evidence/source-invariance review. SSR is not callback/hydration or browser
acceptance. The Guild/Junction follow-up is now prototyped above; two-origin
gathering, wider modules and final mode/browser/deployed acceptance remain open. No saved-room/D1/server/
reset/restart/deployment operation.

## Normal movement and reserve shipment — 24 October 2026

**Prototyped / Partial.** The supplied revised
Advanced rulebook physical28/printed26, E, explicitly marks its matching-type
shipping/movement bullet with the Karama icon. Physical17/printed15 identifies
the canceled operation as flipping one group to or from advisors. The same
physical28 section requires a single BG type throughout each territory. The
selected incoming packet matches the residents; this grants no permission to
flip the resident group or leave mixed types after arrival.

An opposite-type ground group now receives a counter before physical movement.
The packet may be a selected subset across sectors of its one origin. Existing
same-type movement has no flip and no extra matching response. The source gives
no fixed ordinary reserve side. Under the 14 October recommended policy,
provisionally retain the existing normal-fighter shipment default: ordinary
reserves joining resident advisors need matching, while reserves joining
fighters are ordinary placement. Basic is unchanged.

Neither source specifies the remedy for preventing this mandatory matching.
The selected provisional composition stops the one declaration before transfer,
shipment payment or action use. Residents and the incoming packet keep their
original location/type. Permit a legal replacement; do not invent a consumed
shipment/movement or a turn-wide ban. Prevent the same packet from matching in
that destination territory in the same owned opportunity. A different sector
in that destination is not a new packet. A different packet/destination or
later earned movement/turn is independent. Do not reuse the continuously-alone
hold from [already committed conversions](ADVISOR_AUTOMATIC_FLIPS.md).

The public ten-field source selects a fresh event, kind, owner, turn, native
movement index, origin, destination, sector, resident stance and selected
physical group. The original order and its exact signature remain in a private
parent. The shared pure quote owns current held groups, resident matching and
scoped denial; existing native code retains route, fresh-advisor locks,
occupancy, funding, card preparation and actual physical commitment. Consume
the private parent before resuming the original CHOAM movement or normal
shipment suffix once. Existing declaration card uses stay in their original
state; no new refund is invented.

Humans retain the standard Karama/Allow controls, with a persistent explanation
that this arrival has not happened. The personalized bot adapter uses the same
pure quote to omit prevented packets, keeping only minimal legal participation.
No strategic refinement or difficulty calibration is added.

[Native fixture](../tests/fixture-advisor-matching-move.ts) earns public Advanced
BG/Atreides/Emperor setup with original base33 and Atreides' original Karama.
BG's original advisor shares Arrakeen with ten Atreides. Actual first phases
and declined preparation precede a real one-force shipment into empty Basin9
for2, earning a separate fighter. Both directions between those original groups
are actual movement declarations. The recorded pre-shipment prefix also owns
a normal one-force reserve shipment into the Arrakeen advisors for1. No played
force, phase, wallet, hand, stance or counter is installed.

[Connected cases](../tests/advisor-matching-engine.test.ts) cover both outcomes,
unchanged precommit state, same-sector retry restraint, legal replacements,
already-matching movement and original-parent mismatch. Frozen **19
files244/244**, types/lint/build and seven native declaration/response/GameTable
SSR journeys pass, alongside twelve existing-profile responses and twelve
accepted legal replacements after prevention. Ground sources take34 actual
actions; the original pre-shipment prefix takes33. Both ground directions and
normal reserves preserve original residents and held packets while waiting.
Allowance moves the selected counter once; normal shipment pays1 and spends
its slot once. Prevention preserves forces, payment and the unused action,
rejects the same packet/destination and permits the earned same-type sector
reposition or an empty-territory shipment. Same-type movement creates no
matching response and retains the original Karama.

The focused first native allowance and final frozen batch pass. Standard
controls render; this is not a new callback/browser/mobile/deployed certificate.
Private proof and original-source HTML:
`/home/quintine/.local/share/dune/checkpoints/20261024-advisor-matching-groups/`.
`frozen-integrated/report.json` binds tree
`f1dc33ab54b8f74e98c7c6e7950fddf9dfd2a16cf0e4648cb2c0617cda23a061`,
2752 files on base `abf0305ddfe6883f49b9f34c1d4e879c47dcf4f2`.
Checkpoint prose/reference overlays are separately reviewed and hashed after
proof. Existing-mode completeness, special relocation, Guild/Homeworld,
Planetologist gathering and Spiritual Advisor matching remain open. No saved-
room/D1, reset, restart or deployment operation was performed.

## Spiritual Advisor source follow-up

Complete physical28 review also requires Polar Sink or decline when the
original shipment destination retains BG fighters, unless Intrusion changes
them first. Existing fighter-child ordering is provisional, not a specific
user override of that destination restriction. Preserve Basic. Target
availability must be shared by ordinary declarations, settlement, Guild
Ambassador quotes, projected controls and bots; keep Homeworld resource quotes
independent of destination legality.

The source does not expressly resolve the original destination itself being
Polar Sink with resident fighters. The recommended provisional composition
keeps the named Polar fallback and lets the incoming advisor packet match those
fighters under its own precommit matching counter, after the distinct Spiritual
Advisor shipping counter. The other faction's shipment is already committed
and cannot be undone. The separate parent, target projection and committed
alone-conversion follow-up is now tracked in [Spiritual Advisors](SPIRITUAL_ADVISORS.md);
the normal movement/shipment evidence above does not certify that follow-up.