Dune/docs/GUILD_RATE_KARAMA_RULES.md

Guild shipment rates and ordinary Karama

Bounded primary-source and engine audit, 2026-09-06. This records the missing cancellation contract; it does not activate a new rule or resolve the pending affordability choice.

Implemented payment follow-up

The shared contributor-income calculation and private Guild transport quotes are now integrated and verified. November2020 direct contribution routing now also credits a non-Guild ally’s contribution when Guild is the shipper; Guild’s own contribution still goes to the bank. This corrects the reverse-direction omission not identified in the original audit below. The source adjudication, 1,600-check checkpoint and browser evidence are in GUILD_SHIPMENT_PAYMENTS.md. It does not implement the unresolved cancellation/intent contract.

Confirmed source contract

The November 2020 FAQ distinguishes canceling Guild income for one shipment, its own half-price use, rates granted to one ally, cross-planet/return transport, and Advanced out-of-order action. General cancellation affects one use; alliance powers are cancelable. The older April FAQ contradicts the transport restriction and should not override November. Independent Karama shipment purchase can benefit another player and pays the bank. GF9 November FAQ, p. 7

The Ixian/Tleilaxu Karama reference separately lists removal of the discount, requiring full price; prohibition of cross-planet/return transport; and income redirection to the bank. Canceling one does not automatically cancel all three. Its explicit out-of-order timing is when Guild attempts that change; it gives no comparably precise announcement/payment sentence for the discount. GF9 Ixian & Tleilaxu, final Karama reference, PDF p. 12

Ordinary reserve shipment costs one spice per force into a stronghold, two elsewhere. Guild pays half; its ally can ship from reserves or across the planet at that rate. Return to reserves belongs to Guild itself and normally costs one spice per two forces. Fractions round up. GF9 base rules, pp. 9, 19, 23

An ally may pay some or all of a shipment, up to its price. That contribution normally goes directly to Guild, or to the bank if Guild is absent. Guild's own contribution to its ally goes to the bank, rather than returning to Guild. Removing the rate does not cancel ordinary allied payment permission. Fremen's ordinary reserve entry remains exempt from Karama cancellation. GF9 November FAQ, pp. 2, 7

Scope and composition

Shipment	Rate cancellation contract
Guild reserves to Dune	Remove Guild discount: one/two spice per force according to destination.
Guild cross-planet	Same destination pricing after discount removal; canceling permission to cross-ship is a separate power cancellation.
Guild return to reserves	The table says full price, but no retrieved example explicitly recalculates this special return tariff. One spice per force is the natural doubled-tariff interpretation, not a dedicated FAQ result.
Guild ally reserves to Dune	Remove Guild's alliance discount; the ally remains shipper. Ordinary shipment permission remains.
Guild ally cross-planet, including allied Fremen southern reserves	The rate is Guild's alliance benefit; discount removal and cancellation of cross-shipment permission must remain separate. The general alliance-cancellation answer supports the permission cancellation, without a dedicated allied-Fremen example.
Fremen ordinary free reserve arrival	No Guild discount to remove; do not turn this into paid shipment.
Independently purchased Karama rate	Its source is the Treachery card, not Guild's faction advantage. A Guild-rate power cancellation should not erase the independent card benefit. This is source composition, not an explicit two-Karama timing example.

Track power owner, shipper, card owner/beneficiary, and payment contributors separately. A Guild-funded ally is still the ally's shipment, using Guild's alliance benefit. Cancellation of income changes the recipient of payment; it does not double the fee. Discount cancellation changes the fee; it does not redirect the remaining legitimate Guild income.

Homeworld advantages have their own Karama immunity and are outside this ordinary-shipment audit; do not extend these rules to that gated module by analogy. GF9 Ecaz & Moritani, p. 10

Material unresolved timing

The retrieved publisher sources do not state whether a declared shipment can be reduced, redirected, replaced or declined after cancellation makes it unaffordable. They do not specify whether that attempt consumes shipment, whether another declaration can regain the discount, or how a prior independent rate card is treated if transport itself is stopped. Do not present an automatic refund, retry, forced debt, smaller shipment, or full-price reservation prerequisite as an official ruling.

Likewise, no retrieved primary passage orders ordinary rate cancellation against Guild's Advanced shipment-stop declaration, a second payment-contributor choice, or a newly played independent rate card. The base Advanced Guild power stops a shipment; it is not the ordinary discount cancellation. Existing implementation's canceled-special-shipment settlement is already marked provisional and must not silently become authority for this new case.

A pre-payment declaration window is a safe software architecture for applying the printed price effect without undoing arrival. Its exact user-visible sequencing remains implementation composition. Parent has asked the user about the unaffordable outcome; this audit does not supply that answer.

Current implementation findings

• ship computes a valid discounted quote and exact typed reserve count. Its existing pendingShipment only pauses for Advanced Guild's special shipment-stop choice. Ordinary games call commitShipment directly.
• commitShipment pays, transfers forces, marks shipment used and generates technology/arrival effects before opening guildIncome. That existing response can redirect income, but is too late for discount cancellation. Reusing it to reprice would require undoing already-settled effects and is unsafe.
• guildShip validates exact source groups, elites, advisor state and entry, then pays/transfers inline. It needs a normalized pending transport intent if ordinary permission/rate responses are added. Retain exact sectors and unit types; do not reconstruct a different group after a response.
• Existing payment math correctly sends Guild-funded ally spice to the bank: eligible Guild income subtracts Guild's contribution. The rate helper itself has no new cancellation regression; the absent rate/transport response was a preexisting compliance gap.
• g.karamaShipping already distinguishes card owner and beneficiary. Keep this independent rate source distinct from Guild's ordinary ability during repricing and resumption.
• Existing aid is escrowed and visible to the recipient. A changed price can invalidate the recorded contributor split even when the combined budget suffices. Do not silently enlarge another player's authorized contribution beyond their pledged amount, or replace an explicit split without the chosen settlement contract.

Proposed intent fields are shipper ID, source kind and exact force groups, destination/sector, typed amounts/advisor stance, turn/phase, rate source, quoted costs, and chosen ally contribution. Record which one-use windows have resolved, so JSON resume cannot reopen a canceled discount or replay payments. Revalidate custody, legal destination, alliance and contribution before committing once. This is a software proposal, not a stored arbitrary Action or printed rule.

Focused checks before integration

Cover own and allied reserve shipments at both destination prices; odd force counts; cross/return transport separately; free Fremen; independent Karama rates; explicit/default aid splits; Guild versus non-Guild contributors; separate income cancellation; nested Bene Gesserit Worthless conversion and cancellation; JSON reload/stale submissions; unchanged forces/payment/technology before settlement; and exactly one final commit. Include both sufficient and insufficient full-price budgets, but bind the latter tests only after the pending interpretation is selected.

Official indexed PDF passages were verified in the browser and compared with local publisher-authored base/Ix extracts. Direct current GF9 PDF fetching returned 403, so this is not a claim that a newly downloaded binary was checked. Targeted GF9 searches for affordability, changed declarations and refunds found no ruling. Community and tournament variants were not used to fill that gap. No game files or live rooms were modified.