Allow Box recovery of purchased shipment costs

game/engine.ts

@@ -4697,16 +4697,6 @@ function validateNullentropyBegin(g: Game, owner: Player, cardId: string) {
     owner.hand.length <= limit,
     'The final exchanged hand must not exceed its hand limit.',
   );
-  const guild = byFaction(g, 'guild');
-  requireRule(
-    !(
-      g.karamaShipping?.card &&
-      guild &&
-      !guild.specialKaramaUsed &&
-      g.discard.some((c) => c.id === g.karamaShipping?.card)
-    ),
-    'Searching while a shipping Karama has a provisional Guild refund claim awaits resolution.',
-  );
   // A completed purchase has already paid its bid; it is no longer a reservation.
   const funding = structuredClone(g);
   if (funding.currentAuctionSale) {
@@ -4737,6 +4727,16 @@ function validateNullentropyBegin(g: Game, owner: Player, cardId: string) {
   );
   return { card, candidates };
 }
+/** Physical recovery ends only this cost's provisional stop refund, not its price. */
+function claimNullentropyShipmentCost(
+  g: Pick<Game, 'karamaShipping' | 'pendingKarama'>,
+  card: string,
+) {
+  if (g.karamaShipping?.card === card) g.karamaShipping.costClaimed = true;
+  const pending = g.pendingKarama;
+  if (pending?.use.kind === 'shipment' && pending.use.card === card)
+    pending.costClaimed = true;
+}
 function finishNullentropy(
   g: Game,
   player: string,
@@ -4772,6 +4772,7 @@ function finishNullentropy(
         : 'Invalid private search selection.',
     );
   }
+  claimNullentropyShipmentCost(context, cardId);
   validateTransferCompletion(
     context,
     getPlayer(context, player),
@@ -4802,6 +4803,10 @@ function finishNullentropy(
   );
   owner.hand = result.ownerHand;
   g.discard = result.discard;
+  claimNullentropyShipmentCost({
+    karamaShipping: g.karamaShipping,
+    pendingKarama: pending.resume.pendingKarama,
+  }, cardId);
   setMovementDiscardKnowledge(g, recordMovementBoxKnowledge(g.movementDiscardKnowledge,
     g.players.map(p => p.id), player, result.discard));
   g.pendingNullentropy = null;
@@ -17798,6 +17803,7 @@ function projectMovementBoxRecovery(source: Game, actor: string, box: string, se
     try { result = resolveNullentropyBox(player.hand, box, context.discard, selected,
       context.discard.filter(card => card.id !== selected).map(card => card.id), handLimit(player), true); }
     catch (error) { throw new RuleError(error instanceof Error ? error.message : 'Invalid owned Box recovery.'); }
+    claimNullentropyShipmentCost(context, selected);
     validateTransferCompletion(context, player, player, result.ownerHand, result.ownerHand, { type: 'card', card: box });
     player.hand = result.ownerHand; context.discard = result.discard;
     setMovementDiscardKnowledge(context, recordMovementBoxKnowledge(context.movementDiscardKnowledge,

game/reference.ts

@@ -1014,9 +1014,9 @@ export const RULE_TOPICS: RuleTopic[] = [
       'Payment is recorded once before inspection. Refresh or reconnect restores an unfinished paid search for its owner without charging again. While it is open, other gameplay actions wait so they cannot change the reserved Box or discard pile. The completed search saves the recovered card and shuffled pile before restoring an interrupted response, decision or phase opening. Recovery does not charge, select or shuffle again, and does not replay the earlier action.',
       'The selected card enters your hand privately. Other players do not receive the selected identity or the shuffled discard faces. Temporary search access ends on completion; the normal discard pile remains private, even though the played Box is placed face up on top. Past inspection records do not become a permanent live discard browser.',
       'An active Truthtrance question and exact card or transaction commitments must resolve as required. Basic and Advanced full-hand holders have a visibly provisional atomic exchange: retrieve one non-Box and discard the played Box, leaving the final hand at its current limit. The printed intermediate-capacity question remains unresolved; over-limit hands are rejected.',
-      'A pending Guild refund claim on a discarded shipping Karama also blocks starting the search while that provisional refund policy is unresolved. The guard protects the competing claim to that card; it is not a general ban on Box during Shipment. Empty or only-Box searches are rejected before payment under the current unsupported-empty-search policy; there is no fallback deck draw.',
+      'A pending purchased-shipment cost does not block the search. Under the provisional refund composition, recovering that exact cost preserves its purchased price, creator and beneficiary but ends its later Guild special-stop refund, even if discarded again. Selecting another card leaves the cost’s existing claim status unchanged. Empty or only-Box searches are rejected before payment under the current unsupported-empty-search policy; there is no fallback deck draw.',
       'All four AI profiles start only when their own projected availability and spice reserve allow it. They do not inspect unpaid discard contents. Once paid, they choose from their entitled cards, prefer existing functional effects over unfinished Richese faces and complete a legal selection even if only unfinished effects remain. A paid search takes priority over optional actions.',
-      'The paid search and continuations are integrated in development fixtures, with a connected full-hand prototype in both modes. The provisional Guild refund interaction remains guarded. The explicit Semuta preview can recover the used Box after a clean completed search without replaying payment or shuffle; other discard compositions remain separate. Full Richese starts and complete browser/mobile/full-game acceptance remain gated.',
+      'The paid search and continuations are integrated in development fixtures, with a connected full-hand prototype in both modes. Purchased-shipment cost recovery now uses the provisional nonduplication policy without blocking the search. The explicit Semuta preview can recover the used Box after a clean completed search without replaying payment or shuffle; other discard compositions remain separate. Full Richese starts and complete browser/mobile/full-game acceptance remain gated.',
     ],
     related: [
       'card-richese-nullentropy-box',
@@ -1030,7 +1030,7 @@ export const RULE_TOPICS: RuleTopic[] = [
         area: 'Implementation',
         status: 'Partial',
         detail:
-          'Paid inspection, exact private custody, shuffled remainder, Box on top, sole-choice completion and restored parent continuations are integrated. Basic and Advanced full-hand exchange use a connected provisional final-capacity policy. Guild-refund guards remain; wider discard/commitment refinement is separate.',
+          'Paid inspection, exact private custody, shuffled remainder, Box on top, sole-choice completion and restored parent continuations are integrated. Basic and Advanced full-hand exchange use a connected provisional final-capacity policy. Recovering an exact shipment cost ends only its provisional refund eligibility, retaining the original price and continuation; wider discard/commitment refinement is separate.',
       },
       {
         area: 'Player controls',
@@ -1048,7 +1048,7 @@ export const RULE_TOPICS: RuleTopic[] = [
         area: 'Documentation',
         status: 'Partial',
         detail:
-          'Payment, temporary private access, disposal order, continuation recovery and separate capacity/refund interpretations are documented. This does not grant generic discard browsing or certify the remaining expansion effects.',
+          'Payment, temporary private access, disposal order, continuation recovery and provisional capacity/claimed-cost refund interpretations are documented. This does not grant generic discard browsing or certify the remaining expansion effects.',
       },
       {
         area: 'Verification',
@@ -1058,6 +1058,9 @@ export const RULE_TOPICS: RuleTopic[] = [
         evidence: [
           'tests/nullentropy-box.test.ts',
           'tests/nullentropy-box-engine.test.ts',
+          'tests/box-shipment-price.test.ts',
+          'tests/box-shipment-price-controls.test.ts',
+          'tests/fixture-box-shipment-price.ts',
           'tests/nullentropy-box-engine-review.test.ts',
           'tests/nullentropy-box-bots.test.ts',
           'tests/nullentropy-box-recovery.test.ts',