Settle CHOAM charity claims after depleted funding

Keep CHOAM's own poverty claim bank-funded. Prototype full other-faction
claims using available CHOAM cash and an explicitly provisional bank residual;
retain original eligibility, cancellation, Homeworld portions and claim limits.
Connect persistent controls and genuine public setup/bribe evidence. Complete
rules and deployed acceptance remain open.

docs/CHOAM_CHARITY_FUNDING.md

@@ -0,0 +1,101 @@
+# CHOAM Charity funding
+
+## Source and selected prototype policy — 24 October 2026
+
+Publisher E2 physical p7 says CHOAM collects two spice per faction before
+Charity claims, then pays **other** factions' claims from its spice.
+The base physical p8 poverty rule still applies to any faction with zero/one
+spice. Composing those permissions, CHOAM's own eligible ordinary claim uses
+the Spice Bank; debiting its own wallet would either make the claim ineffective
+or reject it at zero. Eligibility and the once-per-turn stamp are unchanged.
+[Official E2](https://www.gf9games.com/dune/wp-content/uploads/2021/11/CHOAM-Rulebook-low-res.pdf),
+[official base rules](https://www.gf9games.com/dunegame/wp-content/uploads/Dune-Rulebook.pdf).
+
+E2 p12 explicitly makes other claims bank-funded when CHOAM's opening advantage
+is canceled. Targeted publisher/designer research found no corresponding
+insolvency remedy after CHOAM legally spends or transfers its opening cash.
+Indexed primary passages remained accessible; direct E2 and designer downloads
+returned403. No community implementation or tournament rules settle this choice.
+The self-claim composition above is separate from the following unresolved policy.
+
+Under the user's 14 October choose-recommended instruction, the preview now
+pays each full eligible claim, debits another faction's CHOAM wallet up to its
+available cash, and supplies the ordinary shortfall from the Spice Bank.
+This is an explicit **provisional deviation**, not a publisher-confirmed
+insolvency rule. It avoids lost entitlements, negative wallets and a blocked
+claim without retroactively prohibiting legal transfers or inventing a future
+debt/repayment mechanism. It also lets voluntary transfers shift Charity costs
+to the bank; that economic consequence remains a limitation pending a stronger
+ruling. This prototype cannot certify full CHOAM or complete rules compliance.
+
+Homeworld additions remain entirely bank-funded. Inflation changes the
+entitlement first; it never changes the wealth threshold. A wealthy Advanced
+Bene Gesserit claim retains its original Karama response before any payment;
+cancellation spends the claim but pays nothing. Current canceled CHOAM income
+and absent/older income receipts retain their existing bank behavior. No loan,
+new persistent field, incoming-bribe acceleration, claim repetition or phase
+advance is introduced. Production income remains tied to the original completed
+qualifying claim, not to the CHOAM/bank split or opening income.
+
+## Implementation and controls
+
+`game/charity.ts` supplies the original entitlement, beneficiary-aware payer
+and private funding quote. `payCharity` in `game/engine.ts` validates before
+settlement, debits only the available ordinary contribution and awards the
+original full amount exactly once. The bank remainder is implicit in the
+existing unlimited-bank accounting; no foreign wallet becomes negative.
+The public projection supplies only the existing nominal payer and entitlement,
+never a wallet-dependent split. Homeworld logs use constant funding-policy
+wording rather than exposing a private shortfall.
+
+`components/charity-claim.tsx` is the actual table control. CHOAM sees normal
+bank guidance for its own claim. Other beneficiaries see the same persistent
+provisional funding explanation regardless of CHOAM's private balance. Busy,
+pending income, completed claims, absent entitlement, Truthtrance and Nexus
+Traitor interruption retain their button blocks. The existing minimal legal
+bot Charity action uses this same server settlement; no strategy is refined.
+
+## Verification and remaining work
+
+Owner-frozen proof passes **9 affected offline files88/88**, types/lint/build, eight actual claim-control/gameplay/GameTable SSR journeys and eight existing-profile continuations (16 accepted proposals).
+The public three-seat CHOAM/Atreides/Guild source uses real lobby readiness,
+Basic or explicit Advanced-preview start, native Traitor setup and the first
+native Storm/Spice/Charity chronology. Only original scalar shuffle order, three
+unopened Treachery positions and two unopened ordinary Spice positions are
+selected. Atreides keeps its original starting Karama, so passing the first
+CHOAM income response is a genuine response rather than an installed receipt.
+
+CHOAM starts with two and earns six from that opening. Actual Guild and CHOAM
+bribes then leave zero/one spendable cash while their recipient's native deferred
+receipt remains unspendable. The fixture stops before either claim: 24/27
+source actions. No played phase, wallet, army, alliance, claim stamp or payment
+receipt is assigned. The actual new controls submit self or other claims with
+zero/partial funding, refuse while busy/already claimed and preserve original
+pieces/cards/bribes. Each source continues through actual readiness and market
+controls into Bidding. Eight existing-profile paths accept two legal Charity
+proposals each without strategy/calibration.
+
+The nine-file union also covers existing BG cancellation, Inflation, Homeworld
+portions, Production and Semuta return around Charity. First feedback passes
+87/88: an old Homeworld test still expects zero-funding rejection. Its updated
+case preserves ordinary eligibility rejection and checks full entitlement,
+CHOAM debit at cash0/1/4, unchanged source and no duplicate claim. Focused
+feedback passes; the next union passes88/88 and type checking, with one const
+lint repair. The final frozen batch passes every step. Bounded source and
+integration review found no concrete blocker; this is not comprehensive review.
+
+Private artifacts are in
+`/home/quintine/.local/share/dune/checkpoints/20261024-choam-charity-funding/`,
+including `frozen-integrated-3/report.json`, `runtime-smoke.json`, HTML and
+`feedback.json`. Verified base `52832dc0fd8b07e5e25c88245d427a500c4523ba`, tree
+`73141dec573c215ec5e05aff208107783d65f16e99bedb480c1f10d28ef5bef7`
+(2692 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 user PDF stays untracked.
+
+Framework aliases/CSS stubs mean actual callback/gameplay/SSR evidence, not
+browser visual or deployed acceptance. Full modes, all rule combinations,
+comprehensive rules/recovery/privacy/custody assurance and final deployed
+acceptance remain unfinished. No server, saved-room/D1/reset/restart or deployment
+operation occurs here. The provisional residual is still an unresolved tabletop
+interpretation, even though its selected preview behavior is usable.

docs/CURRENT_STATUS.md

@@ -16,6 +16,25 @@ open mode gates.
 
 
 ## Current checkpoint and work
+**CHOAM Charity funding — 24 October. Prototyped / Partial.**
+CHOAM's own eligible poverty claim now uses the Spice Bank; E2 names other
+factions as its payees. After legal intervening spending, the selected preview
+policy pays other eligible claims in full from available CHOAM cash and a bank
+residual. This is an explicit provisional deviation: no publisher insolvency
+remedy was found, and voluntary transfers can shift costs to the bank.
+Persistent controls explain the policy without exposing private payment shares.
+Original eligibility, once-turn claims, BG cancellation, Inflation, bank-only
+Homeworld additions, Production and deferred bribes remain.
+[Source, policy and bounded evidence](CHOAM_CHARITY_FUNDING.md).
+
+Disjoint source/fixture/controls lanes and bounded integration review pass
+**9 affected offline files88/88**, types/lint/build, eight actual claim-control/gameplay/GameTable SSR journeys and eight existing-profile continuations (16 accepted proposals).
+Actual public three-seat setup, first opening income and legal bribes supply
+24/27 source actions. Feedback updates an obsolete Homeworld rejection and
+one now-constant test binding. Full modes, wider combinations, comprehensive/
+browser/deployed acceptance and AI refinement remain unfinished. No saved-room/
+D1/reset/restart/deployment operation.
+
 **Ecaz Ambassador on the placed HMS — 24 October. Prototyped / Partial.**
 The shared placement quote now includes the genuinely placed Hidden Mobile
 Stronghold in Basic and Advanced, including its intrinsic storm shelter.

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,30 @@
 # Dune implementation status
 
+## 24 October 2026 — CHOAM Charity self-claims and shortfall funding
+
+Make the ordinary poverty claim effective for CHOAM itself using the bank,
+consistent with E2's other-faction payer language. For other eligible claims,
+prototype full entitlement from available CHOAM cash plus a bank residual after
+intervening legal spending. This second policy is provisional and permits
+transfer-driven cost shifting; no official insolvency remedy is claimed.
+Keep original claim limits, cancellation, Inflation, bank-only Homeworld bonus,
+Production and deferred incoming bribes. Actual persistent controls explain the
+policy independently of private wallet values; no new serialized field or debt.
+
+Disjoint source/fixture/control lanes and bounded review pass **9 affected offline files88/88**, types/lint/build, eight actual claim-control/gameplay/GameTable SSR journeys and eight existing-profile continuations (16 accepted proposals).
+Original public CHOAM/Atreides/Guild setup, held starting Karama, actual first
+opening response and legal bribes supply24/27 source actions without an
+installed played phase, wallet, army or payment receipt. Actual callbacks check
+busy/once-only behavior and reach native Bidding; existing legal bots claim for
+both low factions. The first union finds an older Homeworld shortfall rejection;
+its replacement keeps ordinary eligibility, full amount, exact capped debit,
+immutable rejected/starting state and no second claim. A const lint fix follows.
+
+[Source, selected policy, proof and limits](CHOAM_CHARITY_FUNDING.md)
+retain full-rule/combination and comprehensive/browser/deployed gates.
+Private final proof:20261024-choam-charity-funding/frozen-integrated-3.
+No strategy/calibration or saved-room/D1/reset/restart/deployment operation.
+
 ## 24 October 2026 — Ecaz Ambassador on the placed HMS
 
 Share dynamic placement legality between the engine, projected choices,

docs/RULE_DECISIONS.md

@@ -1,5 +1,17 @@
 # Rule decision index
 
+## CHOAM self-claim and provisional shortfall funding — 24 October 2026
+
+E2 p7 names other factions as CHOAM's payees; the ordinary poverty rule leaves
+CHOAM's own eligible claim bank-funded. After legal intervening spending,
+other eligible claims now receive their full amount from available CHOAM cash
+and a bank residual. This second rule is an explicit provisional deviation:
+no publisher insolvency remedy was found; transfers can shift costs to the
+bank. The 14 October choose-recommended authority applies. No debt, negative
+wallet, outgoing escrow or new start gate is introduced. Original claim limits,
+BG cancellation, Inflation and bank-only Homeworld additions remain.
+[Source, policy and limits](CHOAM_CHARITY_FUNDING.md#source-and-selected-prototype-policy--24-october-2026).
+
 ## Ecaz Ambassador on the placed HMS — 24 October 2026
 
 Compose E3 any-stronghold placement (p7; authorized revised p30,A) with E1