Count the sum of future real ordinary payments to each named recipient after the answer.
Earlier payments, gifts and ally aid do not count. The sender pays immediately; the recipient collects at the next Mentat opening.
Payments made during Mentat Pause wait until next turn's Mentat opening; collection never counts twice.
+ A legal timeline may use payments now, one remaining Charity claim and later installments.
+ The future claim is not current spendable spice; only actual payments add to the recorded total.
Bid conditions count the highest accepted future declaration in the named current ordinary lot, never the sum of smaller bids.
A qualifying bid counts even when another player wins; winning still requires the original payment.
Force Revival conditions count cumulative future ordinary returns; normal and elite physical counters each count once.
diff --git a/docs/CURRENT_STATUS.md b/docs/CURRENT_STATUS.md
index 8b87230a..90610ee7 100644
--- a/docs/CURRENT_STATUS.md
+++ b/docs/CURRENT_STATUS.md
@@ -20,6 +20,34 @@ open mode gates.
Continue remaining Basic functions before Advanced and wider interactions.
Prototype labels and final acceptance gates remain.
+**Truthtrance / Charity-funded installments — 27 October. Prototyped / Partial.**
+One remaining owned claim can fund payments after actual prepayments. Whole,
+bare, grouped and mixed questions share that timeline, cumulative caps and the
+final purse. Current card windows retain their order before future Charity.
+Actual phase-2 guides claim once; positive acceptance retains own readiness.
+A premature claim cannot evade a promised payment.
+
+Frozen **24 files, 349/349**, types/lint/build and seven native journeys
+pass, including existing early-movement regressions. Journeys include 55
+GameTable SSR renders, 7 actual answer callbacks and 26 exact guide callbacks
+(23 whole, 3 scalar). Genuine selected-Ix sources use 14 original opening
+actions, 18 after real Amal/closure, or 17 before printed Thumper; inventories and
+all source/further-action counts derive from native arrays.
+
+Actual paths prove Amal cash 5 then pay 5/Charity 2/pay 1, Thumper before its future
+claim, separate recipient 3+3 installments, one claim shared with shipment, and
+manual pay 4→cash 1: claiming early would strand owed 3 and rejects; pay 1/claim 2/pay 2
+fulfills 7. Claimed/expired income and two-Truth overbooking reject; No caps and
+history remain. A narrow fixture question annotation and unused import are
+corrected during feedback. No strategic AI or comprehensive assurance runs.
+
+Proof: `/home/quintine/.local/share/dune/checkpoints/20261027-truth-charity-proof-v3/`;
+journeys/HTML: adjacent `20261027-truth-charity-runtime/run-v3/`.
+No HTTP/storage boundary, saved-game/database, restart or deployed operation
+changes. Unresolved CHOAM own-opening income, other future income, broader deals/
+optional combinations, full modes and final acceptance remain open.
+[Contract](TRUTHTRANCE_TURN_ACTIONS.md#charity-funded-installments--27-october-2026).
+
**Truthtrance / phase-opening Amal — 27 October. Prototyped / Partial.**
Supported original openings now admit whole questions and actual printed Amal
conditions. Native halving precedes ordinary payments. Definite answers reopen
diff --git a/docs/IMPLEMENTATION_STATUS.md b/docs/IMPLEMENTATION_STATUS.md
index 53e9669a..61e37d95 100644
--- a/docs/IMPLEMENTATION_STATUS.md
+++ b/docs/IMPLEMENTATION_STATUS.md
@@ -1,5 +1,17 @@
# Dune implementation status
+## 27 October 2026 — Charity-funded payment installments
+
+Prototyped / Partial. Bare and combined payments can use one owned remaining
+Charity claim after actual prepayments, preserving current card windows and the
+same final purse for movement/Revival. Current-phase guides, readiness, cumulative
+caps and bad-order rejection are connected. Frozen 24 files, 349/349, types/
+lint/build and seven journeys (55 SSR renders, 7 answers, 26 guides) pass,
+including existing early-movement cases. No strategic tuning, deployment or saved-
+game operation occurs. Wider income/deals and complete acceptance remain.
+[Contract](TRUTHTRANCE_TURN_ACTIONS.md#charity-funded-installments--27-october-2026).
+Private proof: `/home/quintine/.local/share/dune/checkpoints/20261027-truth-charity-proof-v3/`.
+
## 27 October 2026 — Phase-opening Amal commitments
Prototyped / Partial. Original opening questions, actual printed Amal costs,
diff --git a/docs/RULE_DECISIONS.md b/docs/RULE_DECISIONS.md
index 45498a23..1ef07f51 100644
--- a/docs/RULE_DECISIONS.md
+++ b/docs/RULE_DECISIONS.md
@@ -1,5 +1,19 @@
# Rule decision index
+## Truthtrance Charity-funded installments — 27 October 2026
+
+Prototyped / Partial. Extend ordinary payment witnesses with one remaining owned
+Charity claim under its native wealth, phase, token and once-per-turn rules.
+Real prepayments may reduce wealth before the claim; the later installment
+still counts only when actually paid. Keep current card/Nexus windows before
+future Charity and share the resulting purse with every other commitment.
+Own premature claiming or passing cannot evade an answer. Recipient receipts
+remain deferred. This is bounded composition of existing Charity/bribery and
+Truthtrance authority, without inventing future auction/collection income,
+foreign gifts or a selected public route. Unresolved CHOAM own-opening income
+and wider optional combinations retain their separate boundaries.
+[Contract](TRUTHTRANCE_TURN_ACTIONS.md#charity-funded-installments--27-october-2026).
+
## Truthtrance printed Amal and phase openings — 27 October 2026
Prototyped / Partial. Extend the existing whole current-turn answer composition
diff --git a/docs/TRUTHTRANCE_BRIBE_PROMISES.md b/docs/TRUTHTRANCE_BRIBE_PROMISES.md
index 5af3322e..ef790e0b 100644
--- a/docs/TRUTHTRANCE_BRIBE_PROMISES.md
+++ b/docs/TRUTHTRANCE_BRIBE_PROMISES.md
@@ -1,5 +1,12 @@
# Truthtrance ordinary bribe-payment promises
+**27 October Charity follow-up:** an owned remaining ordinary claim can follow
+actual prepayments and fund a later installment, with current-phase guides for
+both actions. Positive answers reopen Charity readiness, and own passing or an
+underfunding early claim cannot evade the answer. This supersedes only the
+ordinary-Charity exclusion below. Other future income/preparations remain
+bounded. [Current contract](TRUTHTRANCE_TURN_ACTIONS.md#charity-funded-installments--27-october-2026).
+
**26 October timing follow-up:** [Mentat bribes](MENTAT_BRIBES.md) extend the
current-turn window through phase8. Yes must finish before Mentat Ready; No
remains live across opening collection until the actual next turn. Late receipts
diff --git a/docs/TRUTHTRANCE_TURN_ACTIONS.md b/docs/TRUTHTRANCE_TURN_ACTIONS.md
index fb609a24..845df0f9 100644
--- a/docs/TRUTHTRANCE_TURN_ACTIONS.md
+++ b/docs/TRUTHTRANCE_TURN_ACTIONS.md
@@ -1,5 +1,48 @@
# Truthtrance combined current-turn actions
+## Charity-funded installments — 27 October 2026
+
+**Prototyped / Partial.** Ordinary payment witnesses can now schedule one
+remaining owned Charity claim and the actual installments around it. After
+printed Amal reduces cash 10 to 5, a real payment of 5 can precede the normal
+two-spice claim; a later payment of 1 completes 6. Different recipients share
+the same cash and claim. Charity itself never counts as a bribe, and actual
+recipient receipts remain deferred to their original Mentat opening.
+
+The shared private planner partitions exact deficits, validates native Charity
+and stamps the hypothetical claim once. The same helper serves existing
+movement/Revival preparation. The final purse funds every later obligation:
+after Amal, payment 6 plus a two-spice desert shipment is unfunded; payment 5
+plus that shipment can use the single claim. An early claim at cash 1 cannot
+strand a previously accepted seven-spice payment: pay the remaining 1 first,
+then claim 2 and pay the remaining 2. Actual rejected actions stay immutable.
+
+Current printed windows precede future Charity. A required Thumper spends its
+physical cost before the later claim; quotes do not consume hidden normal
+Spice cards or turn future money into current cash. Native card preparations
+can precede payments where their effect/order requires it. Any original Nexus
+agreement must fit before the future phase and retain recipient restrictions.
+No chosen branch, timeline or prospective income is installed in a real game.
+
+Bare, grouped, mixed and combined payment questions use guarded current-phase
+payment/Charity packets. Positive acceptance reopens owned Charity readiness;
+own Ready cannot forfeit the necessary claim. After an actual claim or phase
+expiry it cannot be reserved again. Cumulative No caps and original history
+persist. Four profiles consume legal guides; strategy and calibration remain
+deferred. Native phase controls handle waiting before the actual Charity phase.
+
+Other future income, unresolved CHOAM own-opening income, wider card/optional
+compositions, complete modes and final assurance remain open. Existing native
+ordinary entitlement for another faction is quoted without choosing CHOAM's
+foreign opening response. This is a bounded extension, not full planning of all
+possible deals or later collection.
+Frozen evidence: 24 affected files, 349/349, types/lint/build and seven
+native/SSR/control journeys pass (55 GameTable renders, 7 answer callbacks,
+23 whole and 3 scalar guide callbacks). Private proof:
+`/home/quintine/.local/share/dune/checkpoints/20261027-truth-charity-proof-v3/`;
+journeys/HTML: adjacent `20261027-truth-charity-runtime/run-v3/`.
+This is local native/SSR evidence, not browser hydration or deployed acceptance.
+
## Printed Amal and phase openings — 27 October 2026
**Prototyped / Partial.** Whole questions can now be asked during a supported
diff --git a/game/engine.ts b/game/engine.ts
index 50ec4642..d43a387b 100644
--- a/game/engine.ts
+++ b/game/engine.ts
@@ -599,6 +599,7 @@ import { resolveBattleWeapons } from './effective-weapons';
import { choamGholaEvent, choamGholaSkillOfferEvent, choamGholaSkillSignature, choamMarketGholaError, choamSaleGholaTiming, type ChoamMarketGhola } from './choam-market-ghola';
import { quoteAdvisorPreparationWindow, quoteAdvisorPreparation, validateAdvisorPreparation, projectAdvisorPreparationWindow, AdvisorPreparationError, type AdvisorPreparationWindow, type AdvisorPreparationSource } from './advisor-preparation-window';
import { quoteFremenRevivalGrant, validateFremenRevivalGrant, projectFremenRevivalGrant, FremenRevivalGrantError, type FremenRevivalGrantSource } from './fremen-revival-grant';
+import { splitOrdinaryPayments, type OrdinaryPayment } from './ordinary-payment-plan';
import {
charityAmount,
charityQuote,
@@ -15117,7 +15118,7 @@ function alliancePromisePlan(g: Game, p: Player, promises = g.alliancePromises ?
if (accepts) getPlayer(future, p.id).ally = accepts;
if (accepts && hasBribePromises(trial, p.id, true) && !bribePromiseCompletion(future, getPlayer(future, p.id))) {
const payment = bribePromiseCompletion(trial, actor)?.find(action => action.target === accepts);
- if (!payment) continue;
+ if (!payment || typeof payment.amount !== 'number' || payment.amount > uncommittedSpice(trial, actor)) continue;
const amount = payment.amount as number;
actor.spice -= amount;
getPlayer(trial, accepts).bribes += amount;
@@ -15365,6 +15366,64 @@ function bribeQuestionWindow(g: Game): boolean {
return bribePromiseTurn(g) && !bribeTimingBlock({ ...g, truthtrance: null,
inflation: g.inflation?.side === 'double' ? null : g.inflation });
}
+/** One owned claim, using the same entitlement as real Charity and existing
+ * preparation quotes. Future phase projection consumes no hidden card. */
+function forecastOrdinaryCharity(source: Game, owner: string): Game | null {
+ const before = getPlayer(source, owner);
+ if (source.phase > 2 || before.charityTurn === source.turn ||
+ source.phase === 2 && source.ready.includes(owner)) return null;
+ const g = structuredClone(source); g.phase = 2; g.ready = [];
+ g.truthtrance = null; g.response = null; g.decision = null; g.phaseOpening = null;
+ g.pendingKarama = null; g.pendingTreacheryDiscard = null;
+ g.spiceWindow = null; g.spiceResolution = null; g.spiceSequence = null; g.nexus = false;
+ g.stormCardWindowOpen = false; g.thumperWindowOpen = false; g.amalWindowOpen = false;
+ const player = getPlayer(g, owner);
+ if (charityQuote(g, player).total <= 0) return null;
+ try {
+ if (source.phase < 2 && byFaction(g, 'choam') && g.choamCharity?.turn !== g.turn) {
+ if (player.faction === 'choam') return null;
+ // Another faction's ordinary entitlement survives either CHOAM opening
+ // outcome. Quote the beneficiary only, without choosing that response.
+ player.spice += charityQuote(g, player).total; player.charityTurn = g.turn;
+ return g;
+ }
+ const next = applyActionInner(g, owner, { type: 'charity' }, 'shipmentPreparation');
+ const response = next.response;
+ if (response?.kind === 'bgCharity' && response.owner === owner) {
+ next.response = null;
+ payCharity(next, getPlayer(next, owner), response.amount ?? 2, response.charityHomeworld ?? 0);
+ }
+ return next;
+ } catch (error) { if (error instanceof RuleError) return null; throw error; }
+}
+function quoteOrdinaryPayments(g: Game, actor: string, payments: readonly OrdinaryPayment[]) {
+ const owner = getPlayer(g, actor);
+ for (const payment of payments) {
+ const recipient = getPlayer(g, payment.recipient);
+ requireRule(recipient.id !== actor && recipient.id !== owner.ally &&
+ payment.amount <= uncommittedSpice(g, owner), 'Retain legal ordinary payment funding and recipients.');
+ checkBureaucratContributors(g, recipient.id, [{ payer: actor, amount: payment.amount }]);
+ recordBribePayment(g, actor, recipient.id, payment.amount);
+ owner.spice -= payment.amount; recipient.bribes += payment.amount;
+ }
+}
+function* ordinaryPaymentSeeds(source: Game, actor: string, payments: readonly OrdinaryPayment[],
+ beforeFuture: (game: Game) => void = () => {}): Generator<{ game: Game; actions: Action[] }> {
+ if (!Number.isSafeInteger(payments.reduce((sum, payment) => sum + payment.amount, 0))) return;
+ const split = splitOrdinaryPayments(payments, Math.max(0, uncommittedSpice(source, getPlayer(source, actor))));
+ try {
+ const current = structuredClone(source);
+ quoteOrdinaryPayments(current, actor, split.before);
+ beforeFuture(current);
+ const actions: Action[] = split.before.map(payment => ({ type: 'bribe', target: payment.recipient, amount: payment.amount }));
+ if (!split.after.length) { yield { game: current, actions }; return; }
+ const claimed = forecastOrdinaryCharity(current, actor);
+ if (!claimed) return;
+ quoteOrdinaryPayments(claimed, actor, split.after);
+ yield { game: claimed, actions: [...actions, { type: 'charity' },
+ ...split.after.map(payment => ({ type: 'bribe', target: payment.recipient, amount: payment.amount }))] };
+ } catch (error) { if (!(error instanceof RuleError)) throw error; }
+}
/** Shared funded completion; alternatives are quotations and never become a
* stored route. Record its future payments before checking the remaining purse
* so a satisfied bribe is not reserved for a second time by another family. */
@@ -15375,29 +15434,19 @@ function bribePromiseCompletion(g: Game, p: Player, promises = g.bribePromises ?
return turnActionCompletion({ ...g, bribePromises: promises, bribeExpressionPromises: expressions }, p.id)?.payments ?? null;
for (const required of bribePromiseRule(() => bribeCompletionCandidates(promises, expressions, p.id, g.turn))) {
if (!required.length) return [];
- const trial = structuredClone(g), actor = getPlayer(trial, p.id);
- trial.truthtrance = null;
- if (bribeTimingBlock(trial)) return null;
- const total = required.reduce((sum, payment) => sum + payment.amount, 0);
- if (!Number.isSafeInteger(total) || total > uncommittedSpice(trial, actor)) continue;
- trial.bribePromises = structuredClone(promises);
- trial.bribeExpressionPromises = structuredClone(expressions);
- try {
- for (const payment of required) {
- if (payment.recipient === p.id || payment.recipient === p.ally ||
- !g.players.some(player => player.id === payment.recipient)) throw new RuleError('Choose a non-allied bribe recipient.');
- recordBribePayment(trial, p.id, payment.recipient, payment.amount);
- }
- actor.spice -= total;
+ const source = structuredClone(g); source.truthtrance = null;
+ if (bribeTimingBlock(source)) return null;
+ source.bribePromises = structuredClone(promises);
+ source.bribeExpressionPromises = structuredClone(expressions);
+ for (const seed of ordinaryPaymentSeeds(source, p.id, required)) try {
+ const trial = seed.game;
const voluntary = { actor: p.id, action: { type: 'bribe' } };
- for (const payment of required)
- checkBureaucratContributors(trial, payment.recipient, [{ payer: p.id, amount: payment.amount }]);
reconcileBattlePromises(trial, voluntary);
reconcileShipmentPromises(trial, voluntary);
reconcileGroundMovementPromises(trial, p.id, voluntary.action, g.phase);
reconcileBidPromises(trial, voluntary);
reconcileRevivalPromises(trial, voluntary);
- return required.map(payment => ({ type: 'bribe', target: payment.recipient, amount: payment.amount }));
+ return seed.actions;
} catch (error) { if (!(error instanceof RuleError)) throw error; }
}
return null;
@@ -15411,21 +15460,23 @@ function bribeCompatibleLaterPromises(g: Game, p: Player,
function bribeTruthAnswers(g: Game, p: Player, claim: BribeClaim): ('yes' | 'no' | 'unknown')[] {
if (!bribeQuestionWindow(g) || claim.turn !== g.turn || claim.recipient === p.id ||
claim.recipient === p.ally || !g.players.some(player => player.id === claim.recipient)) return [];
- return (['yes', 'no'] as const).filter(answer => !!bribePromiseCompletion(g, p, [...(g.bribePromises ?? []),
+ const source = g.phase === 2 ? { ...g, ready: g.ready.filter(id => id !== p.id) } : g;
+ return (['yes', 'no'] as const).filter(answer => !!bribePromiseCompletion(source, p, [...(g.bribePromises ?? []),
{ ...claim, event: 'candidate', player: p.id, asker: g.truthtrance?.queue[0]?.player ?? g.host,
answer: answer === 'yes', progress: 0 }]));
}
function bribeExpressionTruthAnswers(g: Game, p: Player, claim: BribeExpressionClaim): ('yes' | 'no' | 'unknown')[] {
if (!bribeQuestionWindow(g) || claim.turn !== g.turn || bribeExpressionRecipients(claim.claim)
.some(recipient => recipient === p.id || recipient === p.ally || !g.players.some(player => player.id === recipient))) return [];
- return (['yes', 'no'] as const).filter(answer => !!bribePromiseCompletion(g, p, g.bribePromises ?? [],
+ const source = g.phase === 2 ? { ...g, ready: g.ready.filter(id => id !== p.id) } : g;
+ return (['yes', 'no'] as const).filter(answer => !!bribePromiseCompletion(source, p, g.bribePromises ?? [],
[...(g.bribeExpressionPromises ?? []), { ...claim, event: 'candidate', player: p.id,
asker: g.truthtrance?.queue[0]?.player ?? g.host, answer: answer === 'yes', progress: [] }]));
}
function reopenBribePayer(g: Game, p: Player, answer: boolean) {
- if (answer && (g.phase === 8 || g.phase === 7 && bribesCloseBeforeNextMentat(g)) && g.ready.includes(p.id)) {
+ if (answer && (g.phase === 2 || g.phase === 8 || g.phase === 7 && bribesCloseBeforeNextMentat(g)) && g.ready.includes(p.id)) {
g.ready = g.ready.filter(player => player !== p.id);
- log(g, `${p.name} has a new Truthtrance bribe commitment and must finish ${g.phase === 8 ? 'Mentat Pause' : 'Collection'} again after paying it.`);
+ log(g, `${p.name} has a new Truthtrance bribe commitment and must finish ${g.phase === 2 ? 'Charity' : g.phase === 8 ? 'Mentat Pause' : 'Collection'} again after its required preparation.`);
}
}
function bindBribeTruth(g: Game, p: Player, claim: BribeClaim, answer: boolean, asker: string) {
@@ -15509,10 +15560,12 @@ function reconcileBribePromises(g: Game, voluntary?: { actor: string; action: Ac
const pending = g.response || g.decision || g.phaseOpening || g.pendingTreacheryDiscard ||
g.pendingKarama || g.pendingKull || g.pendingRicheseBetrayal;
if (pending && voluntary) {
- const available = Math.max(0, uncommittedSpice(g, getPlayer(g, voluntary.actor)));
+ const future = structuredClone(g); future.truthtrance = null;
+ if (future.phaseOpening) projectTurnActionOpeningEnd(future);
+ future.response = null; future.decision = null; future.pendingKarama = null; future.pendingTreacheryDiscard = null;
let affordable = false;
for (const required of bribeCompletionCandidates(g.bribePromises ?? [], g.bribeExpressionPromises ?? [], voluntary.actor, g.turn)) {
- if (required.reduce((sum, payment) => sum + payment.amount, 0) <= available) { affordable = true; break; }
+ if (!ordinaryPaymentSeeds(future, voluntary.actor, required).next().done) { affordable = true; break; }
}
requireRule(affordable,
'Keep the current spice needed by your Truthtrance bribe answer.');
@@ -15530,14 +15583,25 @@ function reconcileBribePromises(g: Game, voluntary?: { actor: string; action: Ac
} else kept.push(promise);
}
}
+function ordinaryPaymentActionAvailable(g: Game, player: Player, action: Action): boolean {
+ if (action.type === 'charity') return g.phase === 2 && !g.ready.includes(player.id) &&
+ player.charityTurn !== g.turn && charityQuote(g, player).total > 0 &&
+ (!byFaction(g, 'choam') || g.choamCharity?.turn === g.turn) &&
+ !g.truthtrance && !g.phaseOpening && !g.response && !g.decision && !g.pendingTreacheryDiscard;
+ return action.type === 'bribe' && !bribeTimingBlock(g) && typeof action.amount === 'number' &&
+ action.amount > 0 && action.amount <= uncommittedSpice(g, player);
+}
function projectedBribePromiseGuide(g: Game, player: string): { action: Action } | null {
if (!bribeQuestionWindow(g) || g.truthtrance) return null;
- const action = bribePromiseCompletion(g, getPlayer(g, player))?.[0];
- if (!action) return null;
+ const joint = liveTurnActionPromises(g.turnActionPromises ?? [], player, g.turn).length
+ ? turnActionCompletion(g, player) : null;
+ if (joint?.paymentsAfterPreparations && joint.cardPreparations?.length) return null;
+ const action = joint ? joint.payments[0] : bribePromiseCompletion(g, getPlayer(g, player))?.[0];
+ if (!action || !ordinaryPaymentActionAvailable(g, getPlayer(g, player), action)) return null;
const candidates = [...liveBribePromises(g.bribePromises ?? [], player, g.turn),
...liveBribeExpressionPromises(g.bribeExpressionPromises ?? [], player, g.turn)]
- .filter(promise => promise.answer && ('claim' in promise ? bribeExpressionRecipients(promise.claim).includes(action.target as string)
- : promise.recipient === action.target));
+ .filter(promise => promise.answer && (action.type === 'charity' || ('claim' in promise ? bribeExpressionRecipients(promise.claim).includes(action.target as string)
+ : promise.recipient === action.target)));
const sequence = g.bribePromiseSequence ?? [];
candidates.sort((a, b) => sequence.indexOf(a.event) - sequence.indexOf(b.event));
return candidates[0] ? { action: { ...action, bribePromiseEvent: candidates[0].event } } : null;
@@ -19151,6 +19215,22 @@ function* turnActionPrintedPreparationSeeds(source: Game, actor: string, cards:
for (const window of turnActionWindowCardSeeds(card.game, actor, windows))
yield { game: window.game, actions: [...card.actions, ...window.actions] };
}
+/** Preserve current-window chronology when Charity is in a later phase.
+ * A second order also permits an owned printed effect before its payments. */
+function* turnActionFundedPreparations(source: Game, actor: string, required: readonly OrdinaryPayment[],
+ cards: readonly TurnActionCardRequirement[], windows: readonly TurnActionWindowCardRequirement[],
+ afterCurrentPayments: (game: Game) => void):
+ Generator<{ game: Game; actions: Action[]; payments: Action[]; cardsFirst: boolean }> {
+ for (const paid of ordinaryPaymentSeeds(source, actor, required, afterCurrentPayments))
+ for (const prepared of turnActionPrintedPreparationSeeds(paid.game, actor, cards, windows))
+ yield { ...prepared, payments: paid.actions, cardsFirst: false };
+ if (required.length && (cards.length || windows.some(required => required.answer)))
+ for (const prepared of turnActionPrintedPreparationSeeds(structuredClone(source), actor, cards, windows)) {
+ if (!prepared.actions.length) continue;
+ for (const paid of ordinaryPaymentSeeds(prepared.game, actor, required, afterCurrentPayments))
+ yield { game: paid.game, actions: prepared.actions, payments: paid.actions, cardsFirst: true };
+ }
+}
function recordNativeTurnActionWindowCard(g: Game, actor: string, effect: WindowCardEffect, source: string) {
if (g.turnActionPromises) g.turnActionPromises = turnActionRule(() =>
recordTurnActionWindowCardPlay(g.turnActionPromises!, actor, g.turn, effect, source));
@@ -19519,7 +19599,7 @@ function turnActionAllianceCanClose(g: Game, player: Player): boolean {
return !!turnActionCompletion(source, player.id);
} catch (error) { if (error instanceof RuleError) return false; throw error; }
}
-type TurnActionCompletion = MovementCompletion & { payments: Action[]; bid?: Action; revival?: RevivalPromisePlan; alliance?: Action[]; battlePlan?: BattleCompletion; traitor?: Action; cardPreparations?: Action[]; battlePower?: Action };
+type TurnActionCompletion = MovementCompletion & { payments: Action[]; paymentsAfterPreparations?: boolean; bid?: Action; revival?: RevivalPromisePlan; alliance?: Action[]; battlePlan?: BattleCompletion; traitor?: Action; cardPreparations?: Action[]; battlePower?: Action };
/** Forecast deterministic opening work only. Auction/deck draws and foreign
* choices stay at the real table; fixed Mentat receipts arrive after Amal. */
function projectTurnActionOpeningEnd(g: Game) {
@@ -19676,35 +19756,32 @@ function turnActionCompletion(source: Game, actor: string, unknownConsent?: { va
pendingNullentropy: ownedBox ? undefined : trial.pendingNullentropy } : trial;
if (required.length && bribeTimingBlock(paymentWindow)) continue;
const total = required.reduce((sum, payment) => sum + payment.amount, 0);
- if (!Number.isSafeInteger(total) || total > 0 && total > uncommittedSpice(trial, owner) ||
+ if (!Number.isSafeInteger(total) ||
required.some(payment => payment.recipient === actor || payment.recipient === owner.ally ||
!trial.players.some(player => player.id === payment.recipient))) continue;
for (const alliancePlan of alliancePlans) {
- const paid = structuredClone(trial), paidOwner = getPlayer(paid, actor);
try {
- for (const payment of required) recordBribePayment(paid, actor, payment.recipient, payment.amount);
- paidOwner.spice -= total;
- for (const action of alliancePlan?.steps ?? []) {
- const quote = normalNexusAllianceQuote(paid, getPlayer(paid, action.player), action.target);
- for (const player of paid.players) player.ally = quote.allies[player.id];
- paid.allianceOffers = quote.offers;
- if (quote.formed) for (const id of quote.formed) getPlayer(paid, id).allySinceTurn = paid.turn;
- paid.ready = [];
- }
- if (alliancePlan) {
- const opportunity = allianceOpportunity(paid)!;
- paid.alliancePromises = (paid.alliancePromises ?? []).map(promise => promise.player === actor &&
- promise.turn === opportunity.turn && promise.source === opportunity.source && !promise.released
- ? { ...promise, fulfilled: true } : promise);
- paid.allianceExpressionPromises = (paid.allianceExpressionPromises ?? []).map(promise => promise.player === actor &&
- promise.turn === opportunity.turn && promise.source === opportunity.source && !promise.released
- ? { ...promise, fulfilled: true } : promise);
- }
+ const prepareAlliance = (paid: Game) => {
+ for (const action of alliancePlan?.steps ?? []) {
+ const quote = normalNexusAllianceQuote(paid, getPlayer(paid, action.player), action.target);
+ for (const player of paid.players) player.ally = quote.allies[player.id];
+ paid.allianceOffers = quote.offers;
+ if (quote.formed) for (const id of quote.formed) getPlayer(paid, id).allySinceTurn = paid.turn;
+ paid.ready = [];
+ }
+ if (alliancePlan) {
+ const opportunity = allianceOpportunity(paid)!;
+ paid.alliancePromises = (paid.alliancePromises ?? []).map(promise => promise.player === actor &&
+ promise.turn === opportunity.turn && promise.source === opportunity.source && !promise.released
+ ? { ...promise, fulfilled: true } : promise);
+ paid.allianceExpressionPromises = (paid.allianceExpressionPromises ?? []).map(promise => promise.player === actor &&
+ promise.turn === opportunity.turn && promise.source === opportunity.source && !promise.released
+ ? { ...promise, fulfilled: true } : promise);
+ }
+ };
const voluntary = { actor, action: { type: 'bribe' } };
- for (const payment of required)
- checkBureaucratContributors(paid, payment.recipient, [{ payer: actor, amount: payment.amount }]);
- for (const cardSeed of turnActionPrintedPreparationSeeds(paid, actor, cardRequirements,
- source.phaseOpening ? windowRequirements.filter(required => required.effect !== 'amal') : windowRequirements)) {
+ for (const cardSeed of turnActionFundedPreparations(trial, actor, required, cardRequirements,
+ source.phaseOpening ? windowRequirements.filter(required => required.effect !== 'amal') : windowRequirements, prepareAlliance)) {
const funded = cardSeed.game, payer = getPlayer(funded, actor);
try {
reconcileBattlePromises(funded, voluntary);
@@ -19749,11 +19826,12 @@ function turnActionCompletion(source: Game, actor: string, unknownConsent?: { va
if (completion) {
if (alliancePlan?.uncertain) { unknownConsent!.value = true; continue; }
const cardPreparations = [...opening.actions, ...cardSeed.actions];
- return { ...completion, ...(cardPreparations.length ? { cardPreparations } : {}), ...(bid ? { bid } : {}), ...(revival ? { revival } : {}),
+ return { ...completion, ...(cardPreparations.length ? { cardPreparations } : {}),
+ ...(cardSeed.cardsFirst ? { paymentsAfterPreparations: true } : {}), ...(bid ? { bid } : {}), ...(revival ? { revival } : {}),
...(battlePlan ? { battlePlan } : {}), ...(traitor ? { traitor } : {}),
...(power.action ? { battlePower: power.action } : {}),
...(alliancePlan ? { alliance: alliancePlan.steps.map(step => ({ type: 'alliance', target: step.target })) } : {}),
- payments: required.map(payment => ({ type: 'bribe', target: payment.recipient, amount: payment.amount })) };
+ payments: cardSeed.payments };
}
} catch (error) { if (!(error instanceof RuleError)) throw error; }
}
@@ -19900,7 +19978,7 @@ function reconcileTurnActionPromises(g: Game, actor?: string, action?: Action, s
for (const p of g.players) {
const early = g.phase < 5 || sourcePhase < 5;
const voluntary = actor === p.id && action?.type !== 'passResponse' && (!early || !!action &&
- (['card', 'bribe', 'alliance', 'pledgeAid', 'emperorGift', 'bid', 'richeseGift', 'revealNoField', 'revive',
+ (['card', 'bribe', 'charity', 'alliance', 'pledgeAid', 'emperorGift', 'bid', 'richeseGift', 'revealNoField', 'revive',
'reviveLeader', 'reviveKwisatz', 'acceptLeaderRevival', 'emperorRevival', 'decision', 'passBid', 'karama', 'specialKarama'].includes(action.type) ||
action.type === 'richeseBid' && typeof action.amount === 'number' && action.amount > 0 ||
action.type === 'ready' && [2, 4, 7, 8].includes(sourcePhase)));
@@ -19961,7 +20039,9 @@ function projectedTurnActionGuide(g: Game, player: Player): { event: string; act
return action ? { event: row.event, action: { ...action,
turnActionPromiseEvent: row.event, turnActionPromisePhase: g.phase } } : null;
}
- let action = !bribeTimingBlock(g) ? completion.payments[0] : undefined;
+ const nextPayment = completion.payments[0];
+ let action = (!completion.paymentsAfterPreparations || !completion.cardPreparations?.length) && nextPayment &&
+ ordinaryPaymentActionAvailable(g, player, nextPayment) ? nextPayment : undefined;
if (!action) {
const preparation = completion.cardPreparations?.[0];
const shipmentTarget = preparation?.type === 'card' && preparation.mode === 'shipment'
@@ -20136,7 +20216,7 @@ function reconcileTravelPromises(g: Game, actor?: string, action?: Action, sourc
if (!liveTravelPromises(g.travelPromises, p.id, g.turn).length) continue;
const early = g.phase < 5 || sourcePhase < 5;
const voluntary = actor === p.id && action?.type !== 'passResponse' && (!early || !!action &&
- (['card', 'bribe', 'alliance', 'pledgeAid', 'emperorGift', 'bid', 'richeseGift', 'revealNoField', 'revive',
+ (['card', 'bribe', 'charity', 'alliance', 'pledgeAid', 'emperorGift', 'bid', 'richeseGift', 'revealNoField', 'revive',
'reviveLeader', 'reviveKwisatz', 'emperorRevival', 'decision'].includes(action.type) ||
action.type === 'richeseBid' && typeof action.amount === 'number' && action.amount > 0 ||
action.type === 'ready' && [2, 4].includes(sourcePhase)));
@@ -20605,7 +20685,7 @@ function reconcileGroundMovementPromises(g: Game, actor?: string, action?: Actio
source.producer === 'groundMovement' && source.mover === p.id)) continue;
const early = g.phase < 5 || sourcePhase < 5;
const voluntary = actor === p.id && action?.type !== 'passResponse' && (!early || !!action &&
- (['card', 'bribe', 'alliance', 'pledgeAid', 'emperorGift', 'bid', 'richeseGift', 'revealNoField', 'revive', 'reviveLeader', 'reviveKwisatz', 'emperorRevival', 'decision'].includes(action.type) ||
+ (['card', 'bribe', 'charity', 'alliance', 'pledgeAid', 'emperorGift', 'bid', 'richeseGift', 'revealNoField', 'revive', 'reviveLeader', 'reviveKwisatz', 'emperorRevival', 'decision'].includes(action.type) ||
action.type === 'richeseBid' && typeof action.amount === 'number' && action.amount > 0 ||
action.type === 'ready' && [2, 4].includes(sourcePhase)));
const busy = !!(g.response || g.decision || g.phaseOpening || g.pendingTreacheryDiscard ||
@@ -28720,30 +28800,11 @@ function earlyRevivalCompletionSeeds(initial: Game, source: Game, owner: string)
if (source.phase <= 2 && !(source.phase === 2 && source.ready.includes(owner))) {
const charitySeeds: ShipmentCompletionSeed[] = [];
for (const seed of seeds) {
- const g = structuredClone(seed.game); g.phase = 2;
- const p = getPlayer(g, owner);
- if (p.charityTurn === g.turn || charityQuote(g, p).total <= 0) continue;
- try {
+ const next = forecastOrdinaryCharity(seed.game, owner);
+ if (next) {
const action: Action = { type: 'charity' };
- // Before CHOAM's opening response, another faction's fixed ordinary
- // entitlement is unchanged by its outcome. Quote only that entitlement:
- // no CHOAM income, payment or invented receipt enters this forecast.
- let next: Game;
- if (source.phase < 2 && byFaction(g, 'choam') && g.choamCharity?.turn !== g.turn) {
- if (p.faction === 'choam') continue;
- p.spice += charityQuote(g, p).total; p.charityTurn = g.turn; next = g;
- } else {
- next = applyActionInner(g, owner, action, 'shipmentPreparation');
- // Wealthy Advanced BG claims before its counter pays. Witness only
- // that owned allowed outcome; the actual table keeps every response.
- const response = next.response;
- if (response?.kind === 'bgCharity' && response.owner === owner) {
- next.response = null;
- payCharity(next,getPlayer(next,owner),response.amount ?? 2,response.charityHomeworld ?? 0);
- }
- }
charitySeeds.push({ game: next, actions: [action], early: [{ phase: 2, action }] });
- } catch (error) { if (!(error instanceof RuleError)) throw error; }
+ }
}
seeds.push(...charitySeeds);
}
@@ -29180,7 +29241,7 @@ function reconcileShipmentPromises(
voluntary.action.type === 'richeseBid' && typeof voluntary.action.amount === 'number' && voluntary.action.amount > 0 ||
voluntary.action.type === 'ready' && [2, 4].includes(voluntary.phase ?? g.phase));
const ownVoluntary = voluntary?.actor === p.id &&
- (['card', 'bribe', 'alliance', 'pledgeAid', 'emperorGift', 'richeseGift'].includes(voluntary.action.type) ||
+ (['card', 'bribe', 'charity', 'alliance', 'pledgeAid', 'emperorGift', 'richeseGift'].includes(voluntary.action.type) ||
earlyVoluntary ||
future && voluntary.action.type === 'decision');
// A foreign pending parent may spend or refund its approved funding. Wait
diff --git a/game/ordinary-payment-plan.ts b/game/ordinary-payment-plan.ts
new file mode 100644
index 00000000..0109ae9b
--- /dev/null
+++ b/game/ordinary-payment-plan.ts
@@ -0,0 +1,22 @@
+export type OrdinaryPayment = { recipient: string; amount: number };
+
+/** Partition one cumulative obligation without duplicating a recipient's
+ * deficit. Native income, timing and entitlement remain engine calculations. */
+export function splitOrdinaryPayments(payments: readonly OrdinaryPayment[], available: number): {
+ before: OrdinaryPayment[]; after: OrdinaryPayment[]; total: number;
+} {
+ if (!Number.isSafeInteger(available) || available < 0) throw new Error('Use a safe available payment budget.');
+ let remaining = available, total = 0;
+ const before: OrdinaryPayment[] = [], after: OrdinaryPayment[] = [];
+ for (const payment of payments) {
+ if (!payment.recipient || payment.recipient !== payment.recipient.trim() ||
+ !Number.isSafeInteger(payment.amount) || payment.amount <= 0 || !Number.isSafeInteger(total + payment.amount))
+ throw new Error('Use exact recipients and positive safe payment amounts.');
+ total += payment.amount;
+ const paid = Math.min(remaining, payment.amount);
+ if (paid) before.push({ recipient: payment.recipient, amount: paid });
+ if (paid < payment.amount) after.push({ recipient: payment.recipient, amount: payment.amount - paid });
+ remaining -= paid;
+ }
+ return { before, after, total };
+}
diff --git a/game/reference.ts b/game/reference.ts
index ef9c84b9..c78dea13 100644
--- a/game/reference.ts
+++ b/game/reference.ts
@@ -3234,6 +3234,7 @@ export const RULE_TOPICS: RuleTopic[] = [
'A printed Karama shipment-price clause names the current beneficiary’s unused native shipment. The giver spends the physical printed card; the beneficiary still pays the native bank tariff, such as two spice becoming one. Playing that cost counts even if its price is unused. The source remains while that original recipient is entitled, including another actor’s turn; a different beneficiary or a Cunning second opportunity has its own interval. Own shipping or ending must preserve the whole answer before a foreign counter, while foreign actions retain their rights.',
'A Thumper condition counts an actual printed play after answering before this turn’s original first Spice reveal. Its cost counts even when the existing first-turn rule ignores the encounter or waiting Sandtrout suppresses it. Own acceptance must retain the whole answer. Known card effects enter the quote; the next hidden Spice Card does not. A forced later draw can release genuine impossibility, while choosing known casualties cannot evade an earlier answer.',
'A printed Amal clause names the original phase opening and counts a future printed play after this answer. The actual available-spice reduction occurs before ordinary payments become possible; known Mentat bribe receipts arrive afterward. Definite answers reopen your own opening pass. Own cost or acceptance must retain a completion, while a foreign Amal can release genuine impossibility before another player takes the last pass. Later openings keep separate intervals.',
+ 'One remaining owned Charity claim may fund cumulative ordinary installments after actual prepayments. Charity itself is not a bribe; it cannot be claimed twice or spent again on shipment or revival. Current card windows precede future Charity, and native guides wait for its actual phase. Own premature claiming or Ready cannot evade a commitment; cumulative No caps remain.',
'Shipment clauses describe the same one future original reserve shipment. Each ground-movement minimum requires one actual physical group, never the sum of smaller moves. Existing allowances, cards, pieces and preparation remain authoritative.',
'Yes requires the whole expression and fulfills on qualifying actual events. OR preserves legal alternatives; No negates the whole expression. Current facts freeze at answer. A private native quotation shares funding with earlier commitments without storing or publishing a selected branch.',
'Transport and Hajr close at your actual Movement end. Ghola or a payment alternative may remain after that close, through the full current turn including Mentat. A known Inflation Double opening closes payments earlier without closing Ghola. Complete a required payment before its actual opportunity closes; No payment caps remain binding until then.',
@@ -3245,7 +3246,7 @@ export const RULE_TOPICS: RuleTopic[] = [
{ area: 'Player controls', status: 'Partial', detail: 'Full editor, raw question, private answer, persistent own history and exact current-phase native guide.', evidence: ['components/turn-action-fields.tsx', 'components/turn-action-promises.tsx', 'components/truthtrance.tsx', 'components/game-table.tsx', 'tests/truth-turn-action-controls.test.tsx'] },
{ area: 'AI', status: 'Partial', detail: 'Four minimal profiles answer and consume native guides, including printed Hajr/Ghola and original power declarations; full strategy and calibration remain deferred.', evidence: ['game/bots.ts', 'tests/truth-turn-action-runtime.test.ts', 'tests/truth-turn-preparation-runtime.test.ts', 'tests/fixture-truth-turn-alliance.ts', 'tests/truth-turn-alliance-runtime.test.ts', 'tests/truth-turn-combat-runtime.test.ts', 'tests/truth-turn-card-play-runtime.test.ts', 'tests/truth-turn-power-runtime.test.ts', 'tests/truth-turn-window-card-runtime.test.ts', 'tests/truth-turn-karama-runtime.test.ts', 'tests/truth-turn-karama-shipment-runtime.test.ts', 'tests/truth-turn-thumper-runtime.test.ts'] },
{ area: 'Documentation', status: 'Implemented', detail: 'Current funding, physical event meaning, private alternatives, separate deadlines and provisional scope are explicit.', evidence: ['docs/TRUTHTRANCE_TURN_ACTIONS.md', 'docs/RULE_DECISIONS.md'] },
- { area: 'Verification', status: 'Partial', detail: 'Focused helper, control and original native sources, including physical printed plays, original Storm/blow sources, shared Revival resources and native power declarations; broader composition and final acceptance remain.', evidence: ['tests/window-card-play.test.ts', 'tests/battle-power-question.test.ts', 'tests/printed-card-play.test.ts', 'tests/turn-action-promises.test.ts', 'tests/truth-turn-action-controls.test.tsx', 'tests/fixture-truth-turn-action.ts', 'tests/truth-turn-action-runtime.test.ts', 'tests/truth-turn-action-funding.test.ts', 'tests/fixture-truth-turn-preparation.ts', 'tests/truth-turn-preparation-runtime.test.ts', 'tests/fixture-truth-turn-alliance.ts', 'tests/truth-turn-alliance-runtime.test.ts', 'tests/fixture-truth-turn-combat.ts', 'tests/truth-turn-combat-runtime.test.ts', 'tests/fixture-truth-turn-card-play.ts', 'tests/truth-turn-card-play-runtime.test.ts', 'tests/fixture-truth-turn-power.ts', 'tests/truth-turn-power-runtime.test.ts', 'tests/fixture-truth-turn-window-card.ts', 'tests/truth-turn-window-card-runtime.test.ts', 'tests/fixture-truth-turn-karama.ts', 'tests/truth-turn-karama-runtime.test.ts', 'tests/truth-turn-karama-forecast.test.ts', 'tests/fixture-truth-turn-karama-shipment.ts', 'tests/truth-turn-karama-shipment-runtime.test.ts', 'tests/truth-turn-karama-shipment-funding.test.ts', 'tests/fixture-truth-turn-thumper.ts', 'tests/truth-turn-thumper-runtime.test.ts', 'tests/fixture-truth-turn-amal.ts', 'tests/truth-turn-amal-runtime.test.ts'] },
+ { area: 'Verification', status: 'Partial', detail: 'Focused helper, control and original native sources, including physical printed plays, original Storm/blow sources, shared Revival resources and native power declarations; broader composition and final acceptance remain.', evidence: ['tests/window-card-play.test.ts', 'tests/battle-power-question.test.ts', 'tests/printed-card-play.test.ts', 'tests/turn-action-promises.test.ts', 'tests/truth-turn-action-controls.test.tsx', 'tests/fixture-truth-turn-action.ts', 'tests/truth-turn-action-runtime.test.ts', 'tests/truth-turn-action-funding.test.ts', 'tests/fixture-truth-turn-preparation.ts', 'tests/truth-turn-preparation-runtime.test.ts', 'tests/fixture-truth-turn-alliance.ts', 'tests/truth-turn-alliance-runtime.test.ts', 'tests/fixture-truth-turn-combat.ts', 'tests/truth-turn-combat-runtime.test.ts', 'tests/fixture-truth-turn-card-play.ts', 'tests/truth-turn-card-play-runtime.test.ts', 'tests/fixture-truth-turn-power.ts', 'tests/truth-turn-power-runtime.test.ts', 'tests/fixture-truth-turn-window-card.ts', 'tests/truth-turn-window-card-runtime.test.ts', 'tests/fixture-truth-turn-karama.ts', 'tests/truth-turn-karama-runtime.test.ts', 'tests/truth-turn-karama-forecast.test.ts', 'tests/fixture-truth-turn-karama-shipment.ts', 'tests/truth-turn-karama-shipment-runtime.test.ts', 'tests/truth-turn-karama-shipment-funding.test.ts', 'tests/fixture-truth-turn-thumper.ts', 'tests/truth-turn-thumper-runtime.test.ts', 'tests/fixture-truth-turn-amal.ts', 'tests/truth-turn-amal-runtime.test.ts', 'game/ordinary-payment-plan.ts', 'tests/ordinary-payment-plan.test.ts', 'tests/fixture-truth-charity-payments.ts', 'tests/truth-charity-payments-runtime.test.ts'] },
],
},
{
@@ -3404,9 +3405,9 @@ export const RULE_TOPICS: RuleTopic[] = [
'Choose Bind ordinary bribe payments this turn, another respondent, a named non-allied recipient and a positive whole minimum. The current turn is fixed. Registered native Basic and Advanced tables without optional modules support this funded-payment prototype.',
'Yes requires cumulative matching ordinary payer payments after the answer while possible. No keeps later matching payments below the minimum, even across smaller payments. Earlier payments, gifts and allied aid do not count. Several Yes questions for one recipient share the largest deficit; different recipients reserve separate spice.',
'The payer spends spice when the actual native bribe is accepted. The recipient keeps that payment deferred until the next Mentat opening; a late Mentat payment waits for next turn. The question creates no immediate recipient cash, discount or refund. Current auction and sealed-battle liabilities stay reserved.',
- 'Only answers supported by current spendable spice and earlier battle, bid, revival, shipment and movement commitments are offered. Future income, card preparations, pledge withdrawal and gifts are not forecast. A later supported question must preserve an earlier bribe Yes too.',
+ 'Ordinary payment witnesses use current spendable spice and may schedule one remaining owned Charity claim after prepayments. Later installments share the same final purse with battle, bid, revival, shipment and movement commitments. Actual claiming and phase expiry retire that entitlement. Other future income, pledge withdrawal, gifts and wider card preparation remain bounded. A later question must preserve earlier answers too.',
'Your persistent panel shows named cumulative progress and fulfilled/released status. Its legal ordinary-payment guide works out of turn in a clear native window. Current payment controls also apply the recipient cap and retain funding for other Yes answers. Stale or modified guides reject.',
- 'Your own voluntary spending, alliance offer to the recipient or finishing Mentat cannot evade an unpaid Yes. A new Yes reopens only an already-ready Mentat respondent; Collection readiness stays. A known automatic Inflation Double closure requires payment before Collection Ready ends that legal window. Completed opposing consequences may release impossible answers in accepted order. No finishes at the original turn boundary.',
+ 'Your own voluntary spending, alliance offer to the recipient or finishing Mentat cannot evade an unpaid Yes. A new Yes reopens an already-ready Charity or Mentat respondent; Collection readiness stays. A known automatic Inflation Double closure requires payment before Collection Ready ends that legal window. Completed opposing consequences may release impossible answers in accepted order. No finishes at the original turn boundary.',
'Quiet Mentat remains available after opening collection; Inflation Double still prohibits actual payments. No can be fixed under Double, while Yes requires a currently legal funded payment. This cumulative funded-current-turn protocol is a provisional composition of general Truthtrance authority; optional modules, future preparations, broader deals and complete-mode acceptance remain due.',
],
related: ['card-truthtrance', 'bribes', 'truthtrance-bid', 'truthtrance-revival', 'implementation-checklist'],
diff --git a/tests/fixture-truth-charity-payments.ts b/tests/fixture-truth-charity-payments.ts
new file mode 100644
index 00000000..806435f4
--- /dev/null
+++ b/tests/fixture-truth-charity-payments.ts
@@ -0,0 +1,141 @@
+import assert from 'node:assert/strict';
+import { viewGame, type Action, type Game } from '../game/engine';
+import type { TruthQuestion } from '../game/truthtrance';
+import { beforeIxSpiceDraw, orderIxSpiceCards } from './fixture-ix-spice-cards';
+import { createTruthTurnAmalFixture, closeTruthTurnAmal, settleTruthTurnAmal,
+ truthTurnAmalFact, truthTurnAmalGroup, truthTurnAmalPayment,
+ type TruthTurnAmalExpression } from './fixture-truth-turn-amal';
+import { actTruthTurnThumper, createTruthTurnThumperFixture, nextTruthTurnThumperNative,
+ truthTurnThumperClean, truthTurnThumperInventory, truthTurnThumperPlayer, truthTurnThumperSpice,
+ truthTurnThumperTraitors, type TruthTurnThumperStep } from './fixture-truth-turn-thumper';
+
+export type TruthCharityPaymentsStep = TruthTurnThumperStep;
+export type TruthCharityPaymentsKind = 'turnActions' | 'bribe' | 'bribeExpression' | 'mixedBribe';
+export const actTruthCharityPayments = actTruthTurnThumper;
+export const truthCharityPaymentsClean = truthTurnThumperClean;
+export const truthCharityPaymentsPlayer = truthTurnThumperPlayer;
+export const truthCharityPaymentsInventory = truthTurnThumperInventory;
+export const truthCharityPaymentsTraitors = truthTurnThumperTraitors;
+export const truthCharityPaymentsSpice = truthTurnThumperSpice;
+export const truthCharityPaymentsFact = truthTurnAmalFact;
+export const truthCharityPaymentsGroup = truthTurnAmalGroup;
+export const truthCharityPaymentsPayment = truthTurnAmalPayment;
+export const truthCharityPaymentsShip = (territory = 'polar_sink', minimum = 1): TruthTurnAmalExpression =>
+ ({ kind: 'action', action: { kind: 'ship', territory, minimum } });
+export const nextTruthCharityPaymentsNative = nextTruthTurnThumperNative;
+export function nextTruthCharityPayments(game: Game): TruthCharityPaymentsStep | null {
+ if (game.truthtrance) return null;
+ for (const player of game.players) {
+ const view = viewGame(game, player.id), guide = view.turnActionGuide ?? view.bribePromiseGuide;
+ if (guide) return { actor: player.id, action: guide.action };
+ }
+ return nextTruthCharityPaymentsNative(game);
+}
+export function advanceTruthCharityPayments(game: Game, until: (state: Game) => boolean,
+ actions: TruthCharityPaymentsStep[] = [], nativeOnly = false): Game {
+ for (let count = 0; count < 1900; count++) {
+ if (until(game)) return game;
+ assert.notEqual(game.status, 'finished', 'The original Charity/payment source ended before its native boundary');
+ const step = nativeOnly ? nextTruthCharityPaymentsNative(game) : nextTruthCharityPayments(game);
+ assert.ok(step, 'Supply the actual Truthtrance question or original private plan');
+ game = actTruthCharityPayments(game, step.actor, step.action, actions);
+ }
+ throw Error('The native Charity/payment chronology did not reach its finite boundary');
+}
+export function settleTruthCharityPayments(game: Game, actions: TruthCharityPaymentsStep[] = []): Game {
+ return advanceTruthCharityPayments(game, truthCharityPaymentsClean, actions, true);
+}
+export function reachTruthCharityPaymentsClaim(game: Game, actions: TruthCharityPaymentsStep[] = []): Game {
+ return advanceTruthCharityPayments(game, state => state.phase === 2 && truthCharityPaymentsClean(state), actions, true);
+}
+
+/** Genuine selected-Ix original deals only. Every smaller purse is earned by
+ * actual Amal; no poverty, receipt, claim marker or pass list is assigned. */
+export function createTruthCharityPaymentsFixture(options: {
+ source?: 'amalOpening' | 'afterAmal' | 'thumper' | 'phase2'; advanced?: boolean;
+} = {}) {
+ const sourceKind = options.source ?? 'amalOpening';
+ const amal = sourceKind === 'thumper' ? null : createTruthTurnAmalFixture({ phase: 1, advanced: options.advanced });
+ const thumper = sourceKind === 'thumper' ? createTruthTurnThumperFixture({ advanced: options.advanced }) : null;
+ const base = amal ?? thumper!;
+ let game = structuredClone(base.game); const actions = structuredClone(base.sourceActions), inherited = actions.length;
+ let reduction: { before: Game; steps: TruthCharityPaymentsStep[]; after: Game } | null = null;
+ let spiceOrder: ReturnType