From 68d782ca8281396e498f3456daffe20841aa33d4 Mon Sep 17 00:00:00 2001
From: Quintine <15965533+Quintine@users.noreply.github.com>
Date: Mon, 28 Sep 2026 14:29:47 +1000
Subject: [PATCH] Correct CHOAM Nexus reference for victory inspection

---
 game/reference.ts | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/game/reference.ts b/game/reference.ts
index ed9aeeb4..ee65bb39 100644
--- a/game/reference.ts
+++ b/game/reference.ts
@@ -3935,24 +3935,24 @@ export const RULE_TOPICS: RuleTopic[] = [
   },
   {
     id: 'nexus-choam-trade',
-    title: 'CHOAM Nexus: Collection trade',
+    title: 'CHOAM Nexus: Collection trade or victorious inspection',
     category: 'Advanced & expansions',
     coverage: 'Partial',
     developmentStage: 'Prototyped',
-    summary: 'When CHOAM is absent, an unallied holder may spend the CHOAM Nexus card and one Worthless card for two bank spice during Spice Collection.',
+    summary: 'When CHOAM is absent, an unallied holder may spend the CHOAM Nexus card with a Worthless card for two bank spice during Spice Collection, or inspect one random unused opposing hand card after winning a battle.',
     steps: [
-      'Use the Secret Ally panel only when no player controls CHOAM. This works in Basic and Advanced play.',
+      'The Collection trade and post-victory inspection are available only while CHOAM is absent and you are unallied. This works in Basic and Advanced play.',
       'During Spice Collection, choose one Worthless card from your own hand. The chosen card and your CHOAM Nexus card are discarded, and you receive two spice from the bank.',
       'Finish any current choice, Truthtrance or automatic continuation first. Continuing the phase without trading keeps your cards.',
-      'The card also permits a private random unused opposing hand-card inspection after a victory. That alternative is still in development.',
+      'After winning a battle, the private inspection choice may instead spend the Nexus card to reveal one random opposing hand card that was not used in that battle. Only you see the sampled face; if none is eligible, continue without spending the card.',
     ],
-    related: ['nexus-cards', 'collection'],
+    related: ['nexus-cards', 'collection', 'battle'],
     checklist: [
-      { area: 'Implementation', status: 'Partial', detail: 'Collection trade is playable with physical custody and a saved payment/discard receipt. Battle inspection remains missing.', evidence: ['game/nexus-choam-trade.ts', 'game/engine.ts'] },
-      { area: 'Player controls', status: 'Partial', detail: 'Private Worthless-card picker and inspector with explicit two-card cost and availability reasons.', evidence: ['components/nexus-choam-trade.tsx'] },
-      { area: 'AI', status: 'Partial', detail: 'All four profiles use the same private legal trade action. Strategy between the two panel uses awaits battle inspection.', evidence: ['game/nexus-choam-trade-options.ts', 'game/bots.ts'] },
-      { area: 'Documentation', status: 'Partial', detail: 'Source contract and connected Collection behavior are documented; remaining inspection and combination work is explicit.', evidence: ['docs/NEXUS_CHOAM_SECRET_ALLY.md'] },
-      { area: 'Verification', status: 'Partial', detail: 'Focused rules, private controls, AI, saved continuation and competing SQLite actions. Complete family acceptance remains open.', evidence: ['tests/nexus-choam-trade.test.ts', 'tests/nexus-choam-trade-recovery.test.ts'] },
+      { area: 'Implementation', status: 'Partial', detail: 'Collection trade has physical payment/discard custody; victorious inspection samples one unused opposing card privately after battle cleanup. Both retain saved receipts. Combined-module acceptance remains open.', evidence: ['game/nexus-choam-trade.ts', 'game/nexus-choam-inspection.ts', 'game/engine.ts'] },
+      { area: 'Player controls', status: 'Partial', detail: 'Private Worthless-card picker and inspector, plus a separate post-victory inspect-or-continue choice and owner-only sampled face.', evidence: ['components/nexus-choam-trade.tsx'] },
+      { area: 'AI', status: 'Partial', detail: 'All four profiles take legal private trade and inspection choices; strategic choice between uses remains unfinished.', evidence: ['game/nexus-choam-trade-options.ts', 'game/bots.ts'] },
+      { area: 'Documentation', status: 'Partial', detail: 'Both alternatives and their timing, privacy and remaining combination boundaries are documented.', evidence: ['docs/NEXUS_CHOAM_SECRET_ALLY.md'] },
+      { area: 'Verification', status: 'Partial', detail: 'Focused rules, private controls, AI, saved continuation and competing SQLite actions for trade and inspection. Complete family acceptance remains open.', evidence: ['tests/nexus-choam-trade.test.ts', 'tests/nexus-choam-trade-recovery.test.ts', 'tests/nexus-choam-inspection.test.ts'] },
     ],
   },
   {