Scope Advanced Kull to the attempted Karama effect

Adopt the supplied Advanced specific-effect wording, preserving Basic and legacy phase-wide semantics. Bind signed semantic purposes through ordinary/special activations, counters, feasibility and settlement; retain unrelated human controls and minimal bot actions. Phase expiry remains provisional; prior counter, BG and deferred-overbid choices stay.

Validation: frozen12-file111/111, types/lint/build and two original-action/rendered-table programmes. Explicit unopened deal/auction/spice order supports real paid Baliset and shipments; Advanced retains Karama for Baliset cancellation while Basic stays blocked. Four minimal policies remain legal. Correct stale exchange/phase-market/Fremen fixture assumptions. Recovery schema expectations maintained without running deferred SQL assurance. No full modes, browser/deployed acceptance, saved-game/reset/restart or deployment operation.

game/bots.ts

@@ -77,6 +77,7 @@ import {
 import { ownedTech } from './tech-tokens';
 import type { StrongholdProgress } from './victory-progress';
 import { canUseAsKarama } from './karama';
+import { kullPurposeBlock, kullSpecialPurpose } from './kull-purpose';
 import {
   canUseAsKaramaRole,
   shrineTruthtranceBotAction,
@@ -1410,7 +1411,7 @@ function policyActions(g: GameView): Action[] {
   }
   if (
     !g.battle &&
-    !g.karamaBlocked &&
+    !kullPurposeBlock(g, kullSpecialPurpose(me.faction)) &&
     g.choamCashIn?.karamas.length &&
     (me.spice ?? 0) < (level === 0 ? 2 : 5)
   ) {
@@ -1457,7 +1458,7 @@ function policyActions(g: GameView): Action[] {
   const sapho = saphoAction(g);
   if (sapho) return [sapho];
   const specialCard =
-    !g.karamaBlocked &&
+    !kullPurposeBlock(g, kullSpecialPurpose(me.faction)) &&
     !g.choamMarket &&
     (!g.revival.pending ||
       (me.faction === 'tleilaxu' && g.decision?.kind === 'revivalStop')) &&
@@ -2849,7 +2850,7 @@ function policyActions(g: GameView): Action[] {
     }
     if (d.kind === 'auctionPayment') {
       const karama = me.hand?.find((c) =>
-        !g.karamaBlocked && canUseAsKaramaRole(g, me, c),
+        !kullPurposeBlock(g, 'auction-free-purchase') && canUseAsKaramaRole(g, me, c),
       );
       const use =
         !!karama &&

game/choam-kull.ts

@@ -1,9 +1,12 @@
 import type { Card } from './cards';
+import { isKullPurpose, type KullPurpose } from './kull-purpose';
 
 export type KullPhaseRestriction = Readonly<{
   player: string;
   turn: number;
   phase: number;
+  /** Absent preserves the original Basic/legacy all-purpose phase ban. */
+  purpose?: KullPurpose;
 }>;
 
 export type KullContext = Readonly<{
@@ -41,7 +44,8 @@ function plainRecord(value: unknown): value is Record<string, unknown> {
 
 function validRestriction(value: unknown): value is KullPhaseRestriction {
   return plainRecord(value) &&
-    Object.keys(value).sort().join(',') === 'phase,player,turn' &&
+    (Object.keys(value).sort().join(',') === 'phase,player,turn' ||
+      Object.keys(value).sort().join(',') === 'phase,player,purpose,turn' && isKullPurpose(value.purpose)) &&
     identifier(value.player) && stamp(value.turn, value.phase);
 }
 
@@ -62,8 +66,8 @@ export function activeKullRestrictions(
   return (restrictions ?? [])
     .filter(restriction => validRestriction(restriction) &&
       restriction.turn === turn && restriction.phase === phase)
-    .map(({ player, turn: savedTurn, phase: savedPhase }) =>
-      ({ player, turn: savedTurn, phase: savedPhase }));
+    .map(({ player, turn: savedTurn, phase: savedPhase, purpose }) =>
+      ({ player, turn: savedTurn, phase: savedPhase, ...(purpose !== undefined ? { purpose } : {}) }));
 }
 
 export function kullBlocksKarama(
@@ -71,10 +75,12 @@ export function kullBlocksKarama(
   turn: number,
   phase: number,
   player: string,
+  purpose?: KullPurpose,
 ): boolean {
-  return identifier(player) && stamp(turn, phase) &&
+  return identifier(player) && stamp(turn, phase) && (purpose === undefined || isKullPurpose(purpose)) &&
     !!restrictions?.some(restriction => validRestriction(restriction) &&
-      restriction.player === player && restriction.turn === turn && restriction.phase === phase);
+      restriction.player === player && restriction.turn === turn && restriction.phase === phase &&
+      (restriction.purpose === undefined || purpose !== undefined && restriction.purpose === purpose));
 }
 
 /** Saved history may expire, but malformed, duplicate or future bans are not history. */
@@ -91,7 +97,7 @@ export function validateKullPhaseRestrictions(
       restriction.turn > context.turn ||
       (restriction.turn === context.turn && restriction.phase > context.phase))
       throw new Error('Kull Wahad has lost its phase restriction history.');
-    const key = JSON.stringify([restriction.player, restriction.turn, restriction.phase]);
+    const key = JSON.stringify([restriction.player, restriction.turn, restriction.phase, restriction.purpose ?? null]);
     if (seen.has(key)) throw new Error('Kull Wahad has duplicate phase restrictions.');
     seen.add(key);
   }

game/engine.ts

@@ -508,6 +508,7 @@ import { reserveExtortion, collectExtortion, answerExtortion, validateExtortionS
 import { STORM_START_SECTOR, PLAYER_CIRCLE_SECTORS } from './player-positions';
 import { cashInCards } from './choam-karama';
 import { kullBlocksKarama, activeKullRestrictions, validateKullPhaseRestrictions, validateKullAttemptStamp, kullNativeCostCards, kullNexusCostCards, kullCounterCards, type KullPhaseRestriction } from './choam-kull';
+import { kullCancellationPurpose, kullSpecialPurpose, kullPurposeLabel, type KullPurpose } from './kull-purpose';
 import { quoteRicheseBetrayalInvoice, requiredRicheseBetrayalResponders, richeseBetrayalEligibility, richeseBetrayalEvent, createRicheseBetrayalReceipt, validateRicheseBetrayalCursor, type RicheseBetrayalCursor, type RicheseBetrayalReceipt } from './nexus-richese-betrayal';
 import { saleOptions, quoteSale, type ChoamMarket } from './choam-market';
 import { highKaitainDiscardsAvailable, quoteKaitainDiscards, homeworldWorthlessSaleBlock } from './homeworld-card-economy';
@@ -1302,6 +1303,8 @@ export type Game = {
     turn: number;
     phase: number;
     form: 'printed' | 'substitution';
+    /** New Advanced attempts restrict this effect; absent preserves original phase scope. */
+    purpose?: KullPurpose;
     stage: 'offer' | 'counter';
     selection?: { source: 'printed' | 'nexus'; card: string; nexusEvent?: string };
     intent: { kind: 'ordinary'; use: KaramaUse } | { kind: 'special'; use: SpecialKaramaIntent };
@@ -13769,10 +13772,29 @@ function nextAuction(g: Game) {
     currentAuctionContinuationQuote(g, { kind: 'next' }),
   );
 }
-/** Physical custody only: promise feasibility remains conservatively checked at commit. */
-function karamaSpendingBlock(g: Game, p: Player, card: Card): string | null {
-  if (g.kullPreview && kullBlocksKarama(g.kullRestrictions, g.turn, g.phase, p.id))
-    return 'Kull Wahad prevents your Karama activations for this phase.';
+/** Semantic effects exclude card identity, amounts, beneficiaries and route choices. */
+function karamaUsePurpose(g: Game, use: KaramaUse): KullPurpose {
+  if (use.kind === 'shipment') return 'shipment-price';
+  if (use.kind !== 'cancel') return 'auction-free-purchase';
+  const response = use.response;
+  return kullCancellationPurpose(response.kind,
+    response.kind === 'choamWorthless' ? g.pendingChoamWorthless?.effect
+      : response.kind === 'eliteStrength' ? getPlayer(g, response.owner).faction : undefined);
+}
+function kullIntentPurpose(g: Game, intent: NonNullable<Game['pendingKull']>['intent']): KullPurpose {
+  return intent.kind === 'ordinary' ? karamaUsePurpose(g, intent.use)
+    : kullSpecialPurpose(getPlayer(g, intent.use.owner).faction);
+}
+function kullKaramaBlock(g: Game, p: Player, purpose?: KullPurpose): string | null {
+  if (!g.kullPreview || !kullBlocksKarama(g.kullRestrictions, g.turn, g.phase, p.id, purpose)) return null;
+  return kullBlocksKarama(g.kullRestrictions, g.turn, g.phase, p.id)
+    ? 'Kull Wahad prevents your Karama activations for this phase.'
+    : `Kull Wahad prevents ${kullPurposeLabel(purpose!)} for this phase. Other Karama effects remain available.`;
+}
+/** Physical custody plus the intended effect; promise feasibility is checked at commit. */
+function karamaSpendingBlock(g: Game, p: Player, card: Card, purpose?: KullPurpose): string | null {
+  const kullBlock = kullKaramaBlock(g, p, purpose);
+  if (kullBlock) return kullBlock;
   if (g.pendingKull?.stage === 'counter' &&
     (g.pendingKull.card === card.id || g.pendingChoamWorthless?.card === card.id ||
       g.pendingKull.worthless?.card === card.id))
@@ -13797,12 +13819,12 @@ function karamaSpendingBlock(g: Game, p: Player, card: Card): string | null {
     return 'A Worthless conversion is already pending.';
   return null;
 }
-function karamaCard(g: Game, p: Player, id?: unknown) {
+function karamaCard(g: Game, p: Player, id?: unknown, purpose?: KullPurpose) {
   // Explicit selections retain the specific custody error from spendKarama.
   const available = p.hand.filter(
     (c) =>
       canUseAsKaramaRole(g, p, c) &&
-      (id === undefined ? !karamaSpendingBlock(g, p, c) : c.id === id),
+      (id === undefined ? !karamaSpendingBlock(g, p, c, purpose) : c.id === id),
   );
   return available.find((c) => c.effect === 'karama') ?? available[0];
 }
@@ -13815,7 +13837,7 @@ function responseCancelCards(
   if (g.pendingKull?.stage === 'counter')
     return kullCounterCards(p.hand, physicalTreacheryCards(g), g.pendingKull.card,
       card => {
-        if (!canUseAsKaramaRole(g, p, card) || karamaSpendingBlock(g, p, card)) return false;
+        if (!canUseAsKaramaRole(g, p, card) || karamaSpendingBlock(g, p, card, karamaUsePurpose(g, {kind:'cancel', response}))) return false;
         try {
           return assertKaramaPromiseFeasibility(g, p, { kind: 'cancel', response }, card);
         } catch (error) {
@@ -13827,7 +13849,7 @@ function responseCancelCards(
   // A physically spendable card whose Truthtrance feasibility is not proven
   // remains a possible choice; the authoritative action still checks promises.
   return p.hand
-    .filter((card) => !karamaSpendingBlock(g, p, card))
+    .filter((card) => !karamaSpendingBlock(g, p, card, karamaUsePurpose(g, {kind:'cancel', response})))
     .map((card) => card.id);
 }
 /** The same conversion can be suspended by an independent private interaction. */
@@ -14445,6 +14467,8 @@ function validateKaramaUse(
   use: KaramaUse,
   spendingCard?: Card,
 ) {
+  const kullBlock = kullKaramaBlock(g, p, karamaUsePurpose(g, use));
+  requireRule(!kullBlock, kullBlock ?? 'Kull Wahad prevents this Karama effect.');
   if (use.kind === 'cancel') {
     requireRule(
       use.response && use.response.owner !== p.id,
@@ -14652,6 +14676,10 @@ function assertKaramaPromiseFeasibility(
   return true;
 }
 type KullFrame = NonNullable<Game['pendingKull']>;
+function kullSettledRestriction(g: Game, frame: KullFrame): KullPhaseRestriction {
+  return { player: frame.owner, turn: g.turn, phase: g.phase,
+    ...(frame.purpose === undefined ? {} : { purpose: frame.purpose }) };
+}
 // Independent printed descriptors, assembled once rather than trusting a saved
 // hand to define its own identity or rebuilding the physical deck per quote.
 const kullCanonicalCards: Readonly<Record<string, Card>> =
@@ -14665,7 +14693,7 @@ function kullCostRetainsAuctionPayment(g: Game, p: Player, card: Card, physical:
   return !g.auction || g.auction.bidder !== p.id || auctionSpicePaymentFunded(g, p) ||
     p.hand.some(held => held.id !== card.id && canonicalKullCard(held) &&
       physical.reduce((count, candidate) => count + Number(candidate.id === held.id), 0) === 1 &&
-      !karamaSpendingBlock(g, p, held));
+      !karamaSpendingBlock(g, p, held, 'auction-free-purchase'));
 }
 function kullCostPromisesAllow(g: Game, p: Player, card: Card, fuelSource: 'printed' | 'nexus'): boolean {
   const source = g.pendingKull ? kullSource(g, g.pendingKull) : g;
@@ -14686,7 +14714,7 @@ function kullCostPromisesAllow(g: Game, p: Player, card: Card, fuelSource: 'prin
       if (g.pendingKull)
         projected.kullRestrictions = [
           ...activeKullRestrictions(projected.kullRestrictions, projected.turn, projected.phase),
-          { player: g.pendingKull.owner, turn: projected.turn, phase: projected.phase },
+          kullSettledRestriction(projected, g.pendingKull),
         ];
     }
     projected.response = null;
@@ -14731,7 +14759,7 @@ function kullSignature(g: Game, frame: KullFrame): string {
   return JSON.stringify({
     event: frame.event, player: frame.player, owner: frame.owner, card: frame.card,
     turn: frame.turn, phase: frame.phase, form: frame.form, intent: frame.intent,
-    selection: frame.selection,
+    selection: frame.selection, purpose: frame.purpose,
     controls: nullentropyParentSignature(source, frame.resume, frame.event),
     status: source.status, advanced: source.advanced, active: source.active,
     order: source.order, ready: source.ready, hajr: source.hajr, choamMarket: source.choamMarket,
@@ -14790,6 +14818,8 @@ function kullIntegrity(g: Game): void {
     requireRule(frame.signature === kullSignature(g, frame),
       'The saved Kull attempt no longer matches its original controls and opportunity.');
     const source = kullSource(g, frame), owner = getPlayer(source, frame.owner);
+    requireRule(frame.purpose === undefined || (g.advanced && frame.purpose === kullIntentPurpose(source, frame.intent)),
+      'The Advanced Kull restriction no longer matches the original Karama effect.');
     if (frame.worthless) {
       const parentOwner = getPlayer(source, frame.worthless.owner);
       requireRule(kullNexusCostCards(parentOwner.hand, physicalTreacheryCards(g))
@@ -14800,7 +14830,7 @@ function kullIntegrity(g: Game): void {
     requireRule(card, 'The original attempted Karama must remain in its owner’s hand.');
     requireRule(frame.form === (card.kind === 'worthless' ? 'substitution' : 'printed'),
       'The Kull attempt no longer matches its original physical card form.');
-    requireRule(!karamaSpendingBlock(source, owner, card), 'The original Karama activation is no longer legal.');
+    requireRule(!karamaSpendingBlock(source, owner, card, kullIntentPurpose(source, frame.intent)), 'The original Karama activation is no longer legal.');
     if (frame.intent?.kind === 'ordinary') {
       validateKaramaUse(source, owner, frame.intent.use, card);
       requireRule(assertKaramaPromiseFeasibility(source, owner, frame.intent.use, card),
@@ -14860,6 +14890,7 @@ function beginKullAttempt(g: Game, p: Player, card: Card, intent: KullFrame['int
     player: choam.id, owner: p.id, card: card.id,
     turn: g.turn, phase: g.phase, form: card.kind === 'worthless' ? 'substitution' : 'printed',
     stage: 'offer', intent: structuredClone(intent), resume: structuredClone(resume),
+    ...(g.advanced ? { purpose: kullIntentPurpose(g, intent) } : {}),
     worthless: structuredClone(g.pendingChoamWorthless ?? null), signature: '',
   };
   // Payment dispatch removed this control before entering its native branch.
@@ -14918,7 +14949,7 @@ function decideKull(g: Game, p: Player, action: Action): void {
   log(g, `${p.name} declared Kull Wahad. Only a different Karama can prevent it.`);
 }
 function spendKarama(g: Game, p: Player, card: Card, use: KaramaUse, kullOffered = false) {
-  const blocked = karamaSpendingBlock(g, p, card);
+  const blocked = karamaSpendingBlock(g, p, card, karamaUsePurpose(g, use));
   requireRule(!blocked, blocked ?? 'This card cannot be spent as Karama.');
   validateKaramaUse(g, p, use, card);
   const promiseProven = assertKaramaPromiseFeasibility(g, p, use, card);
@@ -15402,7 +15433,7 @@ function finishAutomaticDecision(g: Game): boolean {
     // split or consume a card on behalf of a player, including a BG conversion.
     if (
       auctionSpicePaymentFunded(g, p) &&
-      !p.hand.some((card) => !karamaSpendingBlock(g, p, card)) &&
+      !p.hand.some((card) => !karamaSpendingBlock(g, p, card, 'auction-free-purchase')) &&
       !emperorNexusUniformAuctionPayment(g)
     ) {
       g.decision = null;
@@ -15414,7 +15445,7 @@ function finishAutomaticDecision(g: Game): boolean {
 }
 function recoverAuctionPayment(g: Game, p: Player) {
   const a = g.auction!;
-  if (a.bid <= p.spice + (aidFor(g, p)?.amount ?? 0) || karamaCard(g, p)) {
+  if (a.bid <= p.spice + (aidFor(g, p)?.amount ?? 0) || karamaCard(g, p, undefined, 'auction-free-purchase')) {
     g.decision = { kind: 'auctionPayment', player: p.id };
     return;
   }
@@ -26159,9 +26190,11 @@ function finishResponse(g: Game, canceled: boolean, settlement?: BureaucratSettl
       const used = discard(g, choam, pending.card);
       finishNexusChoam(g,pending,'complete');
       if (pending.effect === 'kull') {
+        const restriction = kullSettledRestriction(g, g.pendingKull!);
         g.kullRestrictions = [...activeKullRestrictions(g.kullRestrictions, g.turn, g.phase),
-          { player: g.pendingKull!.owner, turn: g.turn, phase: g.phase }];
-        log(g, `${getPlayer(g, g.pendingKull!.owner).name} cannot activate Karama for this phase. The attempted card stays held.`);
+          restriction];
+        log(g, `${getPlayer(g, g.pendingKull!.owner).name} cannot activate ${restriction.purpose
+          ? kullPurposeLabel(restriction.purpose) : 'Karama'} for this phase. The attempted card stays held.`);
         resumeKullAttempt(g, true);
         return;
       }
@@ -29286,7 +29319,7 @@ function expansionSpecialKaramaRule<T>(calculate: () => T): T {
 }
 function actualSpecialKaramaCards(g: Game, p: Player) {
   return p.hand.filter(card => card.kind === 'special' && card.effect === 'karama' &&
-    !karamaSpendingBlock(g, p, card));
+    !karamaSpendingBlock(g, p, card, kullSpecialPurpose(p.faction)));
 }
 function ecazSpecialKaramaContext(g: Game, p: Player) {
   const b = g.battle;
@@ -29399,7 +29432,7 @@ export function prepareSpecialKaramaIntent(
     (c) => c.id === action.card && canUseAsKaramaRole(g, p, c),
   );
   requireRule(card, 'Choose a Karama card in your hand.');
-  const activationBlock = karamaSpendingBlock(g, p, card);
+  const activationBlock = karamaSpendingBlock(g, p, card, kullSpecialPurpose(p.faction));
   requireRule(!activationBlock, activationBlock ?? 'This Karama is committed elsewhere.');
   const base = { owner: p.id, card: card.id, turn: g.turn, phase: g.phase };
   if (p.faction === 'ecaz') {
@@ -29421,7 +29454,7 @@ export function prepareSpecialKaramaIntent(
     return { ...base, kind: 'moritani', source: choice.source, keep: choice.keep, discard: choice.discard };
   }
   if (p.faction === 'richese') {
-    const blocked = karamaSpendingBlock(g, p, card);
+    const blocked = karamaSpendingBlock(g, p, card, kullSpecialPurpose(p.faction));
     requireRule(!blocked, blocked ?? 'This Karama is committed elsewhere.');
     requireRule(
       !(
@@ -30032,7 +30065,7 @@ function richeseSpecialKaramaView(g: Game, p: Player) {
   const karamas = p.hand.filter(
     (c) =>
       canUseAsKaramaRole(g, p, c) &&
-      !karamaSpendingBlock(g, p, c) &&
+      !karamaSpendingBlock(g, p, c, kullSpecialPurpose(p.faction)) &&
       !(
         g.richeseAuction?.source === 'blackMarket' &&
         !g.currentAuctionSale &&
@@ -31136,7 +31169,7 @@ function applyActionInner(
         id !== response.owner,
         'Karama cancels another faction’s power.',
       );
-      const card = karamaCard(g, p, action.card);
+      const card = karamaCard(g, p, action.card, karamaUsePurpose(g, {kind:'cancel', response}));
       requireRule(card, 'Choose a Karama in your hand.');
       spendKarama(g, p, card, { kind: 'cancel', response });
     }
@@ -32273,7 +32306,7 @@ function applyActionInner(
         'Choose spice payment or Karama.',
       );
       if (action.karama) {
-        const card = karamaCard(g, p, action.card);
+        const card = karamaCard(g, p, action.card, 'auction-free-purchase');
         requireRule(card, 'You do not hold a Karama card.');
         spendKarama(g, p, card, { kind: 'auctionPayment' });
       } else settleAuction(g, false);
@@ -33265,7 +33298,7 @@ function applyActionInner(
       if (!quotedBid.ok) throw new RuleError(quotedBid.reason);
       requireRule(!g.kullPreview ||
         (p.id === byFaction(g, 'choam')?.id &&
-          !kullBlocksKarama(g.kullRestrictions, g.turn, g.phase, p.id)) ||
+          !kullBlocksKarama(g.kullRestrictions, g.turn, g.phase, p.id, 'auction-free-purchase')) ||
         quotedBid.amount <= p.spice + (aidFor(g, p)?.amount ?? 0),
       'Kull preview defers an unfunded Karama-dependent overbid before acceptance.');
       a.bid = quotedBid.amount;
@@ -35325,9 +35358,16 @@ export function viewGame(state: Game, id: string) {
     kullCounterEvent: g.pendingKull?.stage === 'counter' ? g.pendingKull.event : null,
     karamaBlocked: g.kullPreview && kullBlocksKarama(g.kullRestrictions, g.turn, g.phase, id)
       ? 'Kull Wahad prevents your Karama activations for this phase.' : null,
+    karamaPurposeBlocks: (g.kullPreview ? activeKullRestrictions(g.kullRestrictions, g.turn, g.phase) : [])
+      .filter((restriction): restriction is KullPhaseRestriction & {purpose: KullPurpose} =>
+        restriction.player === id && restriction.purpose !== undefined)
+      .map(({purpose}) => ({purpose, label: kullPurposeLabel(purpose),
+        message: kullKaramaBlock(g, me, purpose)!})),
     kullReaction: g.pendingKull?.stage === 'offer'
       ? { event: g.pendingKull.event, player: g.pendingKull.player, target: g.pendingKull.owner,
           intent: g.pendingKull.intent.kind === 'ordinary' ? g.pendingKull.intent.use.kind : 'special',
+          scope: g.pendingKull.purpose === undefined ? 'phase' as const : 'effect' as const,
+          effect: kullPurposeLabel(kullIntentPurpose(kullSource(g, g.pendingKull), g.pendingKull.intent)),
           plays: id === g.pendingKull.player ? kullPlays(g, me) : [],
           canDecline: id === g.pendingKull.player, blocked: null as string | null }
       : null,
@@ -35404,7 +35444,7 @@ export function viewGame(state: Game, id: string) {
         ? {
             cards: cashInCards(g, me),
             karamas: cashInCards(g, me).filter((c) =>
-              canUseAsKaramaRole(g, me, c),
+              canUseAsKaramaRole(g, me, c) && !karamaSpendingBlock(g, me, c, kullSpecialPurpose(me.faction)),
             ),
           }
         : null,

game/kull-purpose.ts

@@ -0,0 +1,138 @@
+import { FACTIONS, type FactionId } from './catalog';
+import type { ResponseWindow } from './engine';
+import { CHOAM_NEXUS_EFFECTS } from './nexus-choam';
+
+type DetailedResponseKind = 'choamWorthless' | 'eliteStrength';
+type AliasResponseKind = 'nexusPrescience' | 'nexusAdvisorFlip';
+type OrdinaryResponseKind = Exclude<ResponseWindow['kind'], DetailedResponseKind | AliasResponseKind>;
+const worthlessLabels = CHOAM_NEXUS_EFFECTS;
+type WorthlessPurposeEffect = keyof typeof worthlessLabels;
+
+/** Purpose records contain semantic public effects, never a hidden card,
+ * amount, force count, route, recipient or native variant declaration. */
+export type KullPurpose =
+  | 'shipment-price'
+  | 'auction-free-purchase'
+  | `special:${FactionId}`
+  | `cancel:${OrdinaryResponseKind}`
+  | `cancel:choamWorthless:${WorthlessPurposeEffect}`
+  | `cancel:eliteStrength:${FactionId}`;
+
+/** Exhaustive against the engine's typed public response kinds. New response
+ * families must receive an explicit purpose rather than an arbitrary suffix. */
+const cancellationLabels = {
+  moritaniPlacement: 'Moritani Terror placement',
+  ecazPlacement: 'Ecaz Ambassador placement',
+  ecazCollection: 'Ecaz collection',
+  ecazOccupy: 'Ecaz Occupy',
+  moritaniAlliance: 'Moritani alliance',
+  moritaniDuke: 'the Moritani Duke',
+  moritaniRetention: 'Moritani card retention',
+  voice: 'the Voice',
+  prescience: 'Prescience',
+  advisor: 'a spiritual advisor shipment',
+  emperorIncome: 'Emperor income',
+  richesePurchaseIncome: 'Richese purchase income',
+  richeseGift: 'a Richese gift',
+  richeseNoField: 'Richese No-Field use',
+  harkonnenBonus: 'the Harkonnen bonus card',
+  harkonnenTraitor: 'the Harkonnen allied traitor call',
+  guildIncome: 'Guild income',
+  guildRate: 'the Guild shipping rate',
+  guildTransportPermission: 'Guild transport permission',
+  emperorGift: 'the Emperor gift',
+  emperorRevival: 'Emperor revival',
+  stormPeek: 'the storm peek',
+  stormProtection: 'storm protection',
+  wormPlacement: 'additional worm placement',
+  wormSurvival: 'worm survival',
+  wormAllyProtection: 'allied worm protection',
+  atreidesAuction: 'Atreides auction inspection',
+  atreidesSpice: 'Atreides Spice Deck inspection',
+  guildTiming: 'Guild timing',
+  kwisatz: 'Kwisatz Haderach',
+  capture: 'Harkonnen leader capture',
+  fremenSupport: 'Fremen support',
+  advisorFlip: 'advisor conversion',
+  nexusSardaukar: 'Nexus Sardaukar strength',
+  nexusFremenCunning: 'Fremen Nexus Cunning',
+  nexusEcazBetrayal: 'Ecaz Nexus Betrayal',
+  nexusGuildCunning: 'Guild Nexus Cunning',
+  bgCharity: 'Bene Gesserit charity',
+  choamCharity: 'CHOAM charity',
+  choamInflation: 'CHOAM inflation',
+  choamSale: 'a CHOAM sale',
+  choamBattleIncome: 'CHOAM battle income',
+  choamAudit: 'the CHOAM audit',
+  choamBattleAid: 'CHOAM battle aid',
+  worthlessKarama: 'Worthless-card Karama substitution',
+  faceDancerReplacement: 'Face Dancer replacement',
+  choamRevival: 'CHOAM revival',
+  revivalLimit: 'the revival limit',
+  revivalDiscount: 'the revival discount',
+  earlyRevival: 'early revival',
+  revivalIncome: 'revival income',
+  foreignGhola: 'a foreign ghola',
+  ixSubstitution: 'Ixian substitution',
+  ixMovement: 'Ixian movement',
+  fremenMovement: 'Fremen movement',
+  mobileStronghold: 'Hidden Mobile Stronghold movement',
+  richeseAuction: 'the Richese auction',
+  richeseBlackMarket: 'the Richese Black Market',
+  ixAuction: 'Ixian auction selection',
+  ixTechnology: 'Ixian auction technology',
+  ixAllyCard: 'the Ixian allied card',
+} satisfies Record<OrdinaryResponseKind, string>;
+
+const purposeLabels = new Map<KullPurpose, string>([
+  ['shipment-price', 'Karama shipment pricing'],
+  ['auction-free-purchase', 'a free Treachery purchase'],
+]);
+for (const faction of FACTIONS) {
+  purposeLabels.set(`special:${faction.id}`, `the ${faction.name} special Karama power`);
+  purposeLabels.set(`cancel:eliteStrength:${faction.id}`, `cancellation of ${faction.name} special-force strength`);
+}
+for (const [kind, label] of Object.entries(cancellationLabels) as [OrdinaryResponseKind, string][])
+  purposeLabels.set(`cancel:${kind}`, `cancellation of ${label}`);
+for (const [effect, label] of Object.entries(worthlessLabels) as [WorthlessPurposeEffect, string][])
+  purposeLabels.set(`cancel:choamWorthless:${effect}`, `cancellation of ${label}`);
+
+export function isKullPurpose(value: unknown): value is KullPurpose {
+  return typeof value === 'string' && purposeLabels.has(value as KullPurpose);
+}
+export function kullCancellationPurpose(kind: ResponseWindow['kind'], detail?: string): KullPurpose {
+  if (kind === 'choamWorthless') {
+    if (typeof detail !== 'string' || !Object.hasOwn(worthlessLabels, detail))
+      throw new Error('Kull cancellation needs the canonical CHOAM effect.');
+    return `cancel:choamWorthless:${detail as WorthlessPurposeEffect}`;
+  }
+  if (kind === 'eliteStrength') {
+    if (!FACTIONS.some(faction => faction.id === detail))
+      throw new Error('Kull cancellation needs the special-force owner faction.');
+    return `cancel:eliteStrength:${detail as FactionId}`;
+  }
+  const canonical = kind === 'nexusPrescience' ? 'prescience' : kind === 'nexusAdvisorFlip' ? 'advisorFlip' : kind;
+  if (detail !== undefined || !Object.hasOwn(cancellationLabels, canonical))
+    throw new Error('Kull cancellation needs one canonical response purpose without extra details.');
+  return `cancel:${canonical}`;
+}
+export function kullSpecialPurpose(faction: FactionId): KullPurpose {
+  if (!FACTIONS.some(candidate => candidate.id === faction))
+    throw new Error('Kull special Karama needs the actual native faction.');
+  return `special:${faction}`;
+}
+export function kullPurposeLabel(purpose: KullPurpose): string {
+  if (!isKullPurpose(purpose)) throw new Error('Kull needs a canonical purpose.');
+  return purposeLabels.get(purpose)!;
+}
+
+/** Projection messages belong to the engine. Legacy all-purpose restrictions
+ * take priority; a purpose-specific entry blocks only the requested purpose. */
+export function kullPurposeBlock(view: {
+  karamaBlocked?: string | null;
+  karamaPurposeBlocks?: readonly { purpose: KullPurpose; message: string }[];
+}, purpose: KullPurpose): string | null {
+  if (view.karamaBlocked) return view.karamaBlocked;
+  return isKullPurpose(purpose)
+    ? view.karamaPurposeBlocks?.find(entry => entry.purpose === purpose)?.message ?? null : null;
+}

game/reference.ts

@@ -2653,7 +2653,7 @@ export const RULE_TOPICS: RuleTopic[] = [
       'Advanced Bene Gesserit may spend Worthless cards as Karama. Each opens a separate native cancellation response and stays spent if the power is denied. In the Semuta preview, its physical cost offers recovery before that response; the card remains Worthless for its new faction. A later printed cancellation cost is a separate fresh event whose recovery does not undo denial. Allowed converted prices retain the original owner/beneficiary and claimed-cost refund boundary. Normal printed Karama has no BG conversion response.',
       'A pending Worthless purchase keeps space for its original auction card. Gifts and hand exchanges must leave enough room for every committed incoming card. Refreshing restores the same auction, unused shipment opportunity or original canceled power.',
       'Atreides full-plan inspection, Emperor revival, Fremen’s summoned worm, Harkonnen hand exchange the Guild shipment stop and Tleilaxu revival prevention are implemented as once-per-game uses. Other cancellations and special Karamas are still being implemented.',
-      'In the opt-in Kull development preview, another player’s legal ordinary Karama or supported special activation pauses before its costs for CHOAM’s neutral reaction. A declared Kull is pending, not yet a phase ban. Only a different eligible physical Karama can counter it; the original stays reserved. Successful Kull retains the unplayed original, including an advanced Bene Gesserit Worthless card intercepted before conversion, and prevents further Karama activations for that phase. See Kull Wahad for the explicit preview policy and deferred winning-overbid warning.',
+      'In the opt-in Kull development preview, another player’s legal ordinary Karama or supported special activation pauses before its costs for CHOAM’s neutral reaction. A declared Kull is pending, not yet a phase ban. Only a different eligible physical Karama can counter it; the original stays reserved. Successful Kull retains the unplayed original, including an advanced Bene Gesserit Worthless card intercepted before conversion, and prevents further Karama activations for that phase in Basic. New Advanced attempts instead restrict that specific effect; phase expiry is provisional. See Kull Wahad for the explicit preview policy and deferred winning-overbid warning.',
     ],
     related: ['bidding', 'battle', 'advanced-combat', 'special-karama', 'choam-kull', 'nexus-choam-kull'],
   },
@@ -3731,22 +3731,22 @@ export const RULE_TOPICS: RuleTopic[] = [
       'This opt-in development preview supports CHOAM with classic factions in Basic or Advanced, using the physical CHOAM and Ix Treachery decks without optional modules. Basic supports printed ordinary Karama; Advanced also supports Bene Gesserit substitutions and the legal special powers of this roster. Existing games are not retrofitted. Normal expansion starts remain closed, and the visible preview warning is not rules-completion approval.',
       'Another player’s legal Karama cancellation, shipment-rate use, immediate auction purchase, winning-bid payment or supported special activation pauses before its card and other costs. CHOAM sees the attempted player and purpose and may decline or choose a legal held Kull Wahad. Each Use names its printed source explicitly. The separate Nexus Kull guide covers additional Cunning costs in its new profile only. The same public opportunity appears without Kull in hand, so waiting does not disclose hidden ownership. Invalid attempts never open this window; CHOAM does not receive a self-targeted Kull offer.',
       'Decline resumes the original attempt once. Declaring Kull opens the ordinary CHOAM-effect response. Kull is still pending: its target may counter with a different eligible physical Karama before any phase ban applies. The interrupted card stays reserved and cannot serve as its own counter. Other eligible responders use their existing response controls.',
-      'If everyone allows Kull, CHOAM discards the exact Kull card. The original attempted card remains in its owner’s hand; its effect and additional costs do not occur, and an attempted special once-per-game use remains unspent. The activating player cannot activate printed or substituted Karama again during this turn’s current phase. An allied shipment recipient is not automatically the restricted player.',
-      'The successful restriction ends when the phase or turn changes, not during a temporary response, market or worm substep. It does not prohibit holding, acquiring, transferring or otherwise legally discarding a Karama without activating it.',
+      'If everyone allows Kull, CHOAM discards the exact Kull card. The original attempted card remains in its owner’s hand; its effect and additional costs do not occur, and an attempted special once-per-game use remains unspent. Basic prevents that player’s Karama activations for this phase. A new Advanced attempt instead prevents only the specific effect: shipment pricing, free Treachery purchase, that faction’s special, or cancellation of the particular advantage. Other effects remain available; printed and substituted Karama share the same restriction. An allied shipment recipient is not automatically the restricted player.',
+      'The successful restriction ends when the phase or turn changes, not during a temporary response, market or worm substep. Advanced effect scope follows the supplied rules; retaining phase expiry is a provisional interpretation. Immediate purchase and winning payment share one effect, as do force/leader or route variants of the same faction special. Old unstamped pending attempts and restrictions retain their original broad scope. Holding, acquiring, transferring and otherwise legal nonactivation discards remain available.',
       'A successful distinct counter spends or converts its own card under ordinary rules. Kull then stays held and its exact physical card cannot use its CHOAM effect again that phase. No Karama ban is established on the original player, and the reserved original attempt resumes once with its normal costs. Prevention is not a refund of a counter card.',
       'Advanced Bene Gesserit is intercepted before Worthless conversion or discard: successful Kull keeps that original unplayed Worthless card held. If CHOAM declines or Kull is countered, the original proceeds to its separate conversion response. Ordinary cancellation of that conversion still leaves its Worthless card discarded. A different BG Worthless counter has its own conversion response; it is never the reserved original.',
       'Winning overbids whose Karama payment would become unplayable remain deferred. To avoid accepting a bid that the preview cannot settle, a non-CHOAM unfunded Karama-dependent bid is refused privately before commitment, independently of CHOAM’s hidden Kull ownership. CHOAM self-activations are outside interception; normal non-preview bidding is unchanged. An already unfunded winning activation remains guarded. Holding Karama alone is not a reaction trigger. This unfinished-composition fence does not restart bidding, award the lot free, supply new funding or change numeric UI bid limits.',
       'A live Truthtrance battle or shipment promise also constrains original attempts, Kull costs and counters. A cost that cannot be proved compatible is unavailable before disposal; CHOAM may decline instead. Proven supported cancellations remain available. Pending Kull cannot release a suspended promise, and its counter choices exclude unproven costs so legal AI can progress. Unsupported continuations remain an incomplete preview composition, not a publisher ban or permission to release the promise.',
       'The different-card counter and before-conversion custody are explicitly selected development policy, not a located publisher clarification. This printed-only profile still excludes Nexus. The separate Nexus Kull profile adds one bounded Cunning interaction without changing older games; other expansion rosters, optional modules, unpayable-auction recovery and full CHOAM acceptance remain outside both previews. Nexus cards do not receive blanket immunity to Karama.',
     ],
-    example: 'Bene Gesserit attempts to use Baliset as Karama. CHOAM declares Kull. Baliset cannot also counter Kull; a different eligible Karama may. If Kull succeeds, Baliset stays held and BG cannot activate any Worthless-as-Karama again this phase. If a distinct counter prevents Kull, the original Baliset attempt proceeds to its normal conversion response.',
+    example: 'Bene Gesserit attempts to use Baliset as Karama. CHOAM declares Kull. Baliset cannot also counter Kull; a different eligible Karama may. If Kull succeeds, Baliset stays held; in a new Advanced attempt BG cannot repeat that specific Karama effect this phase but may use another legal effect. If a distinct counter prevents Kull, the original Baliset attempt proceeds to its normal conversion response.',
     related: ['choam-worthless', 'nexus-choam-kull', 'faction-choam', 'card-karama', 'advanced-beneGesserit', 'special-karama', 'bidding', 'choam-karama', 'nexus-cards', 'implementation-checklist'],
     checklist: [
-      { area: 'Implementation', status: 'Partial', detail: 'Opt-in printed Kull interception binds typed ordinary or prepared special intents, distinct physical counters and a stamped activation restriction. Deferred overbid recovery and combined-module support remain excluded.', evidence: ['game/choam-kull.ts', 'game/engine.ts'] },
+      { area: 'Implementation', status: 'Partial', detail: 'Opt-in Kull binds typed intents, distinct physical counters and Basic/legacy all-purpose or new Advanced semantic-effect restrictions. Different effects remain playable; phase expiry is provisional in Advanced. Deferred overbid recovery and combined-module support remain excluded.', evidence: ['game/choam-kull.ts', 'game/kull-purpose.ts', 'game/engine.ts'] },
       { area: 'Player controls', status: 'Partial', detail: 'Owner-only legal held costs and decline use the Kull event; counters reuse ordinary response controls. Public viewers receive purpose/actors, not private intent payloads or hidden choices.', evidence: ['components/choam-kull.tsx', 'components/game-table.tsx'] },
       { area: 'AI', status: 'Partial', detail: 'Legal preview participation uses projected reactor choices and ordinary distinct counter controls. Full strategy and difficulty calibration remain deferred.', evidence: ['game/bot-choam-kull.ts', 'game/bots.ts'] },
       { area: 'Documentation', status: 'Partial', detail: 'Pending versus active restrictions, distinct custody, decline/prevention/success, BG-before-conversion and deferred overbid limits have internal explanations. Publisher-source and full-faction acceptance remain separate.', evidence: ['docs/CHOAM_KULL_DESIGN.md', 'docs/CHOAM_KULL_SOURCE_UPDATE.md', 'docs/NEXUS_CHOAM_RULES.md'] },
-      { area: 'Verification', status: 'Partial', detail: 'Focused engine, controls, all-profile legal bots and authenticated SQLite cover saved offer/counter/decline, exact custody, promises, orphan rejection and profile safeguards. Actual phone-width Basic/Advanced seats exercised Kull use, distinct counter and refreshed decline through the table. Complete combined games, proxy-free checkpoint HTTP and deployed acceptance remain separate.', evidence: ['tests/choam-kull-engine.test.ts', 'tests/choam-kull-recovery.test.ts', 'tests/choam-kull-controls.test.tsx', 'tests/bot-choam-kull.test.ts', 'tests/choam-kull.test.ts', 'tests/prototype-room.test.ts'] },
+      { area: 'Verification', status: 'Partial', detail: '18 October Advanced scope:12-file111/111, types/lint/build and two genuine-action/rendered-table programmes pass. Selected unopened deal/auction/Spice positions yield real Baliset purchase, paid shipments, repeated-effect rejection and a different-effect cancellation; Basic retains broad scope. Four policies legally pass. Controlled intent tests cover shared auction/special variants and unstamped frames. Earlier SQLite/phone evidence concerns the old scope, not current recovery/browser certification. Original Nexus/alias programmes, wider combinations, final assurance and deployed acceptance remain open.', evidence: ['tests/kull-purpose.test.ts', 'tests/kull-purpose-intents.test.ts', 'tests/kull-purpose-engine.test.ts', 'tests/fixture-kull-purpose.ts', 'tests/choam-kull-engine.test.ts', 'tests/choam-kull-recovery.test.ts', 'tests/choam-kull-controls.test.tsx', 'tests/bot-choam-kull.test.ts', 'tests/choam-kull.test.ts', 'tests/prototype-room.test.ts'] },
     ],
   },
   {
@@ -4447,12 +4447,12 @@ export const RULE_TOPICS: RuleTopic[] = [
     summary: 'In the explicit Nexus Kull preview, choose one actual Treachery fuel card at a Karama attempt; the CHOAM Nexus is spent when the declaration is accepted, even if Kull is prevented.',
     steps: [
       'This is the fresh local nexus-kull development profile, not a public expansion start or an upgrade to existing saves. It admits two to six ready seats with native CHOAM and otherwise classic factions in Basic or Advanced, physical CHOAM and Ix Treachery decks, and Nexus alone. Other optional modules, expansion factions, Semuta and Richese Betrayal stay outside its boundary. The older kull profile remains printed-only and has no Nexus cards.',
-      'The CHOAM Nexus face says: Discard any Treachery Card to obtain a Worthless Card special effect of your choice. The CHOAM rulebook gives Kull its attempted-Karama timing and phase restriction. Cunning changes the fuel identity, not the effect, target or timing. Neither text supplies a nested counter priority: distinct counters and BG-before-conversion custody are the recorded user-selected policy, not a publisher clarification.',
+      'The CHOAM Nexus face says: Discard any Treachery Card to obtain a Worthless Card special effect of your choice. Basic uses the CHOAM phase-wide scope; new Advanced attempts use the supplied specific-effect scope with provisional phase expiry. Cunning changes the fuel identity, not the effect, target or timing. Neither text supplies a nested counter priority: distinct counters and BG-before-conversion custody are the recorded user-selected policy, not a publisher clarification.',
       'Wait for another player’s validated Karama attempt. There is no proactive Kull choice in the generic Nexus panel. The public event, attempted player and purpose are the same whether CHOAM holds CHOAM Nexus, another Nexus, no eligible fuel or no Nexus at all. Only CHOAM receives its private source-aware plays and blocking reasons; opponents do not see the cost list or reserved original card.',
       'Choose a cost through the shared selector and inspect that actual card before Use. Printed source requires a held printed Kull Wahad. Nexus source requires unallied native CHOAM holding the actual CHOAM Nexus in this profile and one uniquely held canonical Treachery Card: a weapon, defense, special, Karama or Worthless card can be fuel. Reserved or promise-incompatible fuel is unavailable. The card does not become a manufactured Kull, and Karama used as fuel does not activate its own power.',
       'Use must identify the offered event, selected source (printed or nexus) and actual fuel card. Omitting the source, guessing another event or supplying someone else’s card is not a valid Use. Decline needs only the event and spends nothing; the exact original attempt resumes once. You do not choose a new target, price, effect or Nexus identity.',
       'An accepted Nexus declaration discards the physical CHOAM Nexus once immediately. The selected fuel stays held while the ordinary CHOAM-effect response is pending. Pending Kull is not yet a phase ban. The interrupted original stays reserved; it cannot counter its own interruption. A distinct eligible printed Karama or Advanced BG substitution uses the existing response controls before any restriction begins.',
-      'If Kull succeeds, discard exactly the selected fuel once, retain the original unplayed Karama or BG Worthless card and leave the original special once-use and additional costs unspent. The activating player, not an allied shipment beneficiary, cannot activate printed or substituted Karama for the stamped current turn and phase. This does not ban holding, acquiring, trading or otherwise legally discarding Karama.',
+      'If Kull succeeds, discard exactly the selected fuel once, retain the original unplayed Karama or BG Worthless card and leave the original special once-use and additional costs unspent. The activating player, not an allied shipment beneficiary, receives the stamped restriction: Basic/legacy all-purpose, or the new Advanced attempted effect only. Another legal Advanced effect remains available, using either printed or substituted Karama. This does not ban holding, acquiring, trading or otherwise legally discarding Karama.',
       'If a distinct counter prevents Kull, the selected fuel remains held under the existing exact-cost phase prevention policy, but the accepted Nexus spend is not refunded. No Kull activation ban is established. Resume the original attempt once with its normal costs. A BG original resumes its separate ordinary conversion response; ordinary prevention of that conversion still leaves its Worthless card discarded. A BG counter likewise owns its separate conversion, never the reserved original.',
       'The selected deferred-overbid policy still privately refuses non-CHOAM unfunded Karama-dependent bids before commitment, independently of hidden Kull or Nexus ownership. No auction restart, free award, invented funding or numeric UI cap is added. Own Truthtrance promises and reservations constrain the original, fuel and counters; unsupported continuations are guarded before an offer rather than silently releasing a promise.',
       'Refresh restores the same event, selected source, physical costs, spent Nexus and original continuation, including a suspended BG response. Corrupt ownership rejects without changing the game. Verified older printed-only counter saves receive a bounded immutable binding migration, not Nexus choices or a source-omitting action shim. Frozen checks and actual Basic/Advanced CLI/runtime/phone success and prevention are verified locally; complete CHOAM/Nexus, wider combinations and deployed acceptance remain open.',