Connect Richese Nexus to Karama acquisitions

docs/CURRENT_STATUS.md

@@ -16,6 +16,44 @@ open mode gates.
 
 
 ## Current checkpoint and work
+**Karama acquisitions reach Richese Nexus veto — 25 October. Prototyped / Partial.**
+The existing preview now covers immediate ordinary Karama and private Advanced
+special purchase. Uniform acknowledgements precede original costs. Under the
+visible provisional policy, successful veto discards only the intended card;
+the activation Karama stays held, special price/once-use remain unspent, and
+an intended joint Emperor Nexus stays held. Concealed ordinary misses spend
+Nexus then execute the original free purchase once. All-pass runs the original
+paid/joint special intent, including native income and suspended parent controls.
+Unpaid ordinary lots retire without inventing a winner or sale. Public source
+adds `karama` / `specialKarama`; face, cost identity and private funding stay
+concealed. [Source and selected timing](NEXUS_RICHESE_RULES.md#karama-acquisition-betrayal--25-october-2026).
+
+Three disjoint lanes, bounded read-only review and root integration pass
+**19 files, 169/169**, types/lint/build and **14 actual engine/GameTable SSR
+and component-callback journeys** on unchanged source. New cases: eight invoice,
+eight unpaid-retirement, six controls/profile and fifteen engine. Ordinary
+Basic109/Advanced117 action prefixes inherit the labelled controlled recycle;
+quiet private104 and joint147 earn native draws without it. Parent128 preserves
+a real paid-auction Emperor-income response. Pass/veto/miss, actual competing
+bid, nominal3 payment, retained joint price, exact original costs, once-use and
+native continuation are exercised. Inventories remain physical. Controls stay
+visible until action; all four minimal profiles use projected legality.
+
+Fixture feedback corrects response shape, automatic income settlement when no
+Karama remains, and the joint target's live eligibility. The parent source
+really acquired another Karama, so its child income still pauses and preserves
+the original response. An older entitlement assertion now accepts independent
+cards already supported by the prior selected E1/E2 composition. One extracted
+helper callback receives a missing type annotation. No game rule or guard is
+weakened. Private source-bound report/logs:
+`/home/quintine/.local/share/dune/checkpoints/20261025-richese-karama-final/`;
+rendered journeys/HTML: `20261025-richese-karama-runtime/` alongside it.
+These are engine/SSR/callback evidence, not hydration, DOM/browser/mobile or
+deployed acceptance. Native full-deck exhaustion, wider combinations, full
+modes and final assurance remain open. No saved-room/D1/server/reset/restart/
+deployment operation occurred. Continue the remaining rule/checklist gaps;
+complete administration/non-AI work precedes strategic AI and final acceptance.
+
 **Ordinary-deck Richese Nexus purchase veto — 25 October. Prototyped / Partial.**
 A positive native Richese ordinary win now opens the existing neutral response
 before payment choice. The card’s identity is concealed. Under the selected visible
@@ -48,8 +86,8 @@ legacy source-quote mutators only narrow the new frame union. No game rule or
 start guard is weakened. Private source-bound logs/HTML:
 `/home/quintine/.local/share/dune/checkpoints/20261025-richese-normal-betrayal/`.
 No saved-room/D1/server/reset/restart/deployment operation or recovery campaign
-occurred. Proactive immediate/private special Karama producers, wider valid
-combinations, final assurance and exact-revision deployed acceptance remain due.
+occurred. The later Karama checkpoint above adds the immediate/private producers;
+wider valid combinations, final assurance and deployed acceptance remain due.
 
 **Selected revival storm/HMS route reasons — 25 October.** Source review retains
 the current routes: Southern's named placement does not inherit Fremen storm

docs/IMPLEMENTATION_STATUS.md

@@ -1,5 +1,44 @@
 # Dune implementation status
 
+## 25 October 2026 — Richese Nexus reaches original Karama acquisitions
+
+**Prototyped / Partial.** Immediate ordinary Karama and private Advanced special
+purchase now pause before their exact original costs in the existing Richese
+Betrayal preview. Successful veto discards the selected card while retaining
+unplayed Karama, special price/once-use and intended joint Emperor Nexus. This
+pre-cost order is explicitly provisional under the 14 October authority.
+Concealed ordinary misses spend Nexus then execute the original free purchase;
+all-pass resumes the native paid/joint intent and parent controls once. The
+ordinary retirement helper advances an unbought lot without fabricating a bid,
+sale or competing-bidder award. Public controls distinguish intended purchases,
+show nominal prices and keep selected faces/funding concealed. Source enum adds
+`karama` / `specialKarama`; action/event interfaces are unchanged.
+[Selected timing, sources and limits](NEXUS_RICHESE_RULES.md#karama-acquisition-betrayal--25-october-2026).
+
+Three disjoint lanes, bounded review and root integration pass **19 files,
+169/169**, types/lint/build and fourteen actual engine/GameTable SSR and isolated
+component-callback journeys. New invoice8/retirement8/controls6/engine15 cases
+cover both ordinary rules bands, veto/pass/miss, competing bid, paid private
+purchase, nested native Emperor income and joint intent. Ordinary Basic109/
+Advanced117 inherits the labelled recycle; quiet private104 and joint147 earn
+native draws without it. Parent128 has an actual paid income response. Printed
+main/cache and Nexus inventories remain physical; full deck exhaustion is not
+claimed. Minimal profiles acknowledge legal projections; strategy is deferred.
+
+The first frozen union163/169 exposes fixture assumptions about response amount,
+automatic income, a previously retained target and an old independent-card
+exclusion. Targeted fixes use native live sources and current prior entitlement.
+Quiet income auto-settles after its only Karama spends; the real paid-parent
+source has acquired another Karama, so child income still saves its parent.
+No hands, wallets, profiles or rule guards are altered to make cases pass.
+Final type feedback adds one missing helper annotation. Source-bound report:
+`/home/quintine/.local/share/dune/checkpoints/20261025-richese-karama-final/report.json`;
+rendered journeys/HTML in adjacent `20261025-richese-karama-runtime/`.
+These are engine/SSR/callback results, not parent hydration, DOM/browser/mobile
+or deployed proof. No saved-room/D1/server/reset/restart/deployment operation or
+recovery campaign occurs. Wider valid combinations, full modes, remaining
+non-AI features, final assurance and exact-revision deployed acceptance stay due.
+
 ## 25 October 2026 — Original normal auction reaches Richese Nexus purchase veto
 
 **Ordinary-deck Richese Nexus purchase veto — 25 October. Prototyped / Partial.**

docs/NEXUS_RICHESE_RULES.md

@@ -2,6 +2,84 @@
 
 Audited 10 September 2026, with a bounded Betrayal implementation contract added 30 September. This separates the ordinary Secret Ally shipment, native Cunning's two-marker operation and Betrayal's two auction outcomes. It does not certify full-family implementation or open the Nexus release gate. See [common Nexus rules](NEXUS_CARD_RULES.md), [auction custody and source boundaries](RICHESE_AUCTION_RULES.md), [No-Field custody](RICHESE_NO_FIELD_RULES.md), and [allied No-Field distinctions](RICHESE_ALLIED_SHIPMENT_AUDIT.md).
 
+## Karama acquisition Betrayal — 25 October 2026
+
+**Prototyped / Partial.** The printed Richese Nexus purchase-veto alternative
+has no origin restriction. Supplied physical16 permits ordinary Karama's free
+acquisition outside Richese auctions; physical36 / E2p4 permits the private
+native special purchase for Karama plus three spice, once per game. The printed
+special-power Karama immunity does not establish Nexus immunity. These two
+direct sources now enter the existing supported Betrayal preview.
+
+**Selected provisional pre-cost order:** under the 14 October recommended-option
+authority, prepare the original legal intent, then offer the neutral response
+before any activation cost. A successful veto discards only the intended card.
+The activation Karama stays held; private special purchase also retains its
+three spice and unused once-per-game power. A prepared joint Emperor Nexus
+stays held too. This is a recommended online composition, **not** a publisher
+timing clarification, refund or ruling that a used special power is restored.
+
+The ordinary lot remains concealed and uses the prior committed blind-attempt
+policy. Use first spends the physical Richese Nexus. Actual Richese-family:
+discard that lot and retire its native unpaid pool position once, without
+inventing a winning bid, sale or award to a competing bidder. Other family:
+Nexus stays spent, then the exact original Karama spends and acquires the lot
+free. All-pass retains Nexus and performs that same native acquisition once.
+The independent retirement helper preserves actual next opener, hand limits,
+inspection offer, remaining cards and last-cache transition.
+
+The private selected cache card is necessarily Richese-family, so this source
+has no blind miss. The face/ID and actual joint funding are never added to the
+public prompt. All-pass runs the original typed special intent once: its native
+costs, acquisition, once-use, separate Emperor income and suspended parent
+controls remain. Veto preserves those parent controls without making income.
+The nominal three-spice prompt does not identify a private Emperor Nexus choice.
+
+Private `preCost` frames bind the original unplayed cost, selected physical
+source, normalized special intent, wallet/reservations, live window and enclosing
+controls. They store no raw action for replay. Public reaction source additionally
+accepts `karama` and `specialKarama`; existing action/event fields are unchanged.
+Persistent controls distinguish intended acquisitions from won auctions and
+explain the selected ordering. All four minimal profiles pass concealed ordinary
+attempts and consume the canonical special-veto projection.
+
+Evidence: [invoice helper](../game/nexus-richese-betrayal.ts),
+[unbought retirement](../game/normal-auction-retirement.ts),
+[invoice cases](../tests/nexus-richese-betrayal-karama.test.ts),
+[retirement cases](../tests/normal-auction-retirement.test.ts),
+[controls/profile cases](../tests/nexus-richese-betrayal-karama-controls.test.tsx),
+[actual source fixtures](../tests/fixture-richese-karama-betrayal.ts),
+[engine cases](../tests/richese-karama-betrayal-engine.test.ts).
+Ordinary Richese-family recycling remains labelled controlled placement after
+real cost/discard; private special and joint sources earn their actual draws
+without that recycle. This section supersedes the earlier proactive/private
+producer exclusions only in the existing supported profile. Wider combinations,
+comprehensive assurance, full modes and exact-revision deployed acceptance stay
+open. Local engine/SSR evidence is not browser/hydration/deployed evidence.
+
+Frozen **19 files, 169/169**, types/lint/build and fourteen actual engine/
+GameTable SSR/component-callback journeys pass. New invoice8, retirement8,
+controls6 and engine15 cases include both ordinary rules bands, competing bid,
+private paid purchase, actual pending ordinary Emperor income and joint Emperor
+Nexus intent. Basic109/Advanced117 ordinary prefixes retain their labelled
+controlled recycle; quiet private104 and joint147 use native draws without it.
+Parent128 includes that earlier controlled recycle and actual paid income.
+Main/cache and Nexus inventories stay physical; no full exhaustion/reshuffle is
+claimed. The private control stays readable until an acknowledgement is made.
+
+Fixture repairs follow actual response shape and native income auto-settlement:
+quiet purchase spends its only opposing Karama, whereas the parent source really
+acquired a second Karama and still pauses its child income. Joint selection uses
+the remaining eligible cache rather than an already retained face. An older
+Emperor entitlement assertion is reconciled with previously delivered independent
+card support; one extracted-helper callback needs a type annotation. Runtime
+mechanics and profile guards are not relaxed. Private source-bound report:
+`/home/quintine/.local/share/dune/checkpoints/20261025-richese-karama-final/report.json`;
+journey data and rendered HTML are in the adjacent
+`20261025-richese-karama-runtime/` directory. No saved rooms, D1, running server,
+reset, restart, deployment or recovery campaign is involved. Browser/mobile,
+hydration, broader combinations, full modes and final assurance remain open.
+
 ## Ordinary winning-bid Betrayal — 25 October 2026
 
 **Prototyped / Partial.** The printed purchase-veto alternative has no cache-
@@ -42,8 +120,8 @@ Fresh normal frames bind their original live pool index, round, opaque lot ID,
 physical card, winning quote and source controls. Public event IDs contain no
 card identifier. Intrinsic receipt shape and old cache/Black Market signature
 bytes remain unchanged. The legacy alternatives keep their existing native
-continuations. Proactive immediate Karama acquisition and private special-
-Karama acquisition remain separate outstanding producers. Wider profile,
+continuations. Immediate and private special Karama producers are added in the
+later [Karama acquisition section](#karama-acquisition-betrayal--25-october-2026). Wider profile,
 combination, recovery/privacy assurance and deployed acceptance are not claimed.
 
 Evidence: [invoice/outcome helper](../game/nexus-richese-betrayal.ts),
@@ -86,8 +164,7 @@ played hand. Final type feedback replaces two mutations of a readonly fixture
 array with equivalent malformed copies. No rules, profiles or start guards
 are relaxed. Private matching code fingerprints, logs and rendered HTML:
 `/home/quintine/.local/share/dune/checkpoints/20261025-richese-normal-betrayal/`.
-Exact native discard/reshuffle, proactive immediate Karama, private special
-acquisition, wider combinations, complete modes, final recovery/privacy/rules
+Exact native discard/reshuffle, wider combinations, complete modes, final recovery/privacy/rules
 assurance and browser/mobile/deployed acceptance remain unfinished. These
 journeys are engine/SSR, not parent hydration or DOM clicks. No saved-room/D1/
 server/reset/restart/deployment operation occurred.

docs/RICHESE_ACQUISITION_RULES.md

@@ -13,6 +13,18 @@ Targeted searches found discussion titles concerning full hands and alliance can
 
 ## 1. Advanced special Karama purchase
 
+### Richese Nexus pre-cost response — 25 October 2026
+
+The supported Richese Betrayal preview now offers neutral acknowledgements
+after preparing the exact private purchase, before its activation costs. Under
+the explicitly provisional selected ordering, a veto discards only the intended
+cache card: Karama, three spice and special once-use remain unspent, including
+an intended joint Emperor Nexus. All-pass executes the original paid/joint
+intent and separate income once, preserving an already pending parent response.
+The nominal-price prompt grants no selected-face or private-funding inspection.
+Ordinary Karama immunity alone does not establish Nexus immunity.
+[Source, selected policy and evidence](NEXUS_RICHESE_RULES.md#karama-acquisition-betrayal--25-october-2026).
+
 ### Emperor Nexus joint purchase composition — 14 October 2026
 
 The original source explicitly calls this a purchase; the printed Emperor

docs/RULE_DECISIONS.md

@@ -1,5 +1,21 @@
 # Rule decision index
 
+## Richese Nexus before Karama acquisition costs — 25 October 2026
+
+Apply the printed purchase veto to native immediate ordinary Karama and private
+Advanced special purchases in the existing supported preview. Ordinary Karama
+special-power immunity does not itself establish Nexus immunity. Under the
+14 October recommended-option authority, resolve Betrayal **before** costs:
+successful veto discards only the intended card, retaining the unplayed Karama,
+special price and once-use, including a prepared joint Emperor Nexus. This is
+explicitly provisional ordering, not a printed refund/restore ruling. Concealed
+ordinary lots use the existing spend-before-family-check convention; a miss
+spends Nexus and resumes the exact free acquisition. All-pass runs the original
+paid/joint typed intent and native enclosing income/controls once. No selected
+face or private funding is disclosed. This supersedes prior producer exclusions
+only in the existing bounded preview.
+[Source, selected order and limits](NEXUS_RICHESE_RULES.md#karama-acquisition-betrayal--25-october-2026).
+
 ## Richese Nexus ordinary-purchase blind attempt — 25 October 2026
 
 The printed Richese veto is not cache-only, but an ordinary recycled card's
@@ -12,8 +28,9 @@ quote does not reopen. No prior family flag or exact-face reveal is introduced.
 This spend-on-miss convention is explicitly provisional online composition;
 primary rules did not establish general voluntary Nexus discard or an identifying
 family back. Existing cache/Black Market alternatives, private eligibility,
-native later payment choice and source/profile guards remain. Proactive and
-special Karama acquisition are still outstanding producers.
+native later payment choice and source/profile guards remain. The later
+[pre-cost acquisition decision](#richese-nexus-before-karama-acquisition-costs--25-october-2026)
+adds proactive and special Karama producers in the same supported profile.
 [Printed source, knowledge policy and scope](NEXUS_RICHESE_RULES.md#ordinary-winning-bid-betrayal--25-october-2026).
 
 ## Revived placement retains storm and HMS routes — 25 October 2026