@bct-app/game-engine 0.1.4 → 0.1.6-beta.1

package/dist/index.d.mts

@@ -21,7 +21,7 @@ declare const getSourceValue: (source: TEffect["source"], payloads: unknown[]) =
 /**
  * Resolve a value from effect source, handling PAYLOAD (with player-seat indirection), CONSTANT, and EFFECTOR.
  */
-declare const resolveSourceValue: <TResolved>(source: TEffect["source"], writableInputs: TAbility["inputs"], payloads: unknown[], effector: TPlayer | undefined, snapshotSeatMap: Map<number, TPlayer>, resolveFromPlayer: (player: TPlayer) => TResolved, isResolvedValue?: (value: unknown) => value is TResolved) => TResolved | undefined;
+declare const resolveSourceValue: <TResolved>(source: TEffect["source"], writableInputs: TAbility["inputs"], payloads: unknown[], effector: TPlayer | undefined, snapshotSeatMap: Map<number, TPlayer>, resolveFromPlayer: (player: TPlayer) => TResolved, isResolvedValue?: (value: unknown) => value is TResolved, resolveFromCharacter?: (characterId: string) => TResolved) => TResolved | undefined;
 
 /**
  * Type guard to check if a value is a number or an array of numbers.

package/dist/index.d.ts

@@ -21,7 +21,7 @@ declare const getSourceValue: (source: TEffect["source"], payloads: unknown[]) =
 /**
  * Resolve a value from effect source, handling PAYLOAD (with player-seat indirection), CONSTANT, and EFFECTOR.
  */
-declare const resolveSourceValue: <TResolved>(source: TEffect["source"], writableInputs: TAbility["inputs"], payloads: unknown[], effector: TPlayer | undefined, snapshotSeatMap: Map<number, TPlayer>, resolveFromPlayer: (player: TPlayer) => TResolved, isResolvedValue?: (value: unknown) => value is TResolved) => TResolved | undefined;
+declare const resolveSourceValue: <TResolved>(source: TEffect["source"], writableInputs: TAbility["inputs"], payloads: unknown[], effector: TPlayer | undefined, snapshotSeatMap: Map<number, TPlayer>, resolveFromPlayer: (player: TPlayer) => TResolved, isResolvedValue?: (value: unknown) => value is TResolved, resolveFromCharacter?: (characterId: string) => TResolved) => TResolved | undefined;
 
 /**
  * Type guard to check if a value is a number or an array of numbers.

package/dist/index.js

@@ -35,25 +35,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/effects/handler-types.ts
-var createEffectHandler = (type, handler) => {
-  return (context) => {
-    if (context.effect.type !== type) {
-      console.warn("Invalid effect type for handler:", context.effect.type, "expected:", type);
-      return;
-    }
-    handler({
-      ...context,
-      effect: context.effect
-    });
-  };
-};
-
-// src/effects/handlers/ability-change.ts
-var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", () => {
-  console.warn("ABILITY_CHANGE effect handling not implemented yet.");
-});
-
 // src/guards.ts
 var isNumberOrNumberArray = (value) => {
   if (typeof value === "number") {
@@ -151,7 +132,7 @@ var getSourceValue = (source, payloads) => {
   }
   return null;
 };
-var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSeatMap, resolveFromPlayer, isResolvedValue) => {
+var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSeatMap, resolveFromPlayer, isResolvedValue, resolveFromCharacter) => {
   const castOrValidate = (value) => {
     if (!isResolvedValue) {
       return value;
@@ -167,6 +148,10 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
       const player = typeof seat === "number" ? snapshotSeatMap.get(seat) : void 0;
       return player ? resolveFromPlayer(player) : void 0;
     }
+    if (input?.type === "CHARACTER") {
+      const characterId = typeof payloadValue === "string" ? payloadValue : void 0;
+      return characterId && resolveFromCharacter ? resolveFromCharacter(characterId) : void 0;
+    }
     return castOrValidate(payloadValue);
   }
   if (source?.from === "CONSTANT") {
@@ -182,6 +167,90 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
   return void 0;
 };
 
+// src/effects/handler-types.ts
+var createEffectHandler = (type, handler) => {
+  return (context) => {
+    if (context.effect.type !== type) {
+      console.warn("Invalid effect type for handler:", context.effect.type, "expected:", type);
+      return;
+    }
+    handler({
+      ...context,
+      effect: context.effect
+    });
+  };
+};
+
+// src/effects/handlers/ability-change.ts
+var toAbilityIdList = (value) => {
+  if (typeof value === "string") {
+    return value.length > 0 ? [value] : void 0;
+  }
+  if (Array.isArray(value)) {
+    const ids = value.filter((item) => typeof item === "string" && item.length > 0);
+    return ids.length > 0 ? ids : void 0;
+  }
+  return void 0;
+};
+var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", ({
+  effect,
+  operation,
+  payloads,
+  effector,
+  writableInputs,
+  getSnapshotSeatMap,
+  abilityMap,
+  makePlayersEffect,
+  characterMap
+}) => {
+  const resolvedRaw = resolveSourceValue(
+    effect.source,
+    writableInputs,
+    payloads,
+    effector,
+    getSnapshotSeatMap(),
+    (player) => player.abilities,
+    (value) => typeof value === "string" && value.length > 0 || Array.isArray(value) && value.every((item) => typeof item === "string"),
+    (characterId) => {
+      const character = characterMap.get(characterId);
+      if (!character) {
+        console.warn("Character not found for ABILITY_CHANGE effect source:", characterId);
+        return [];
+      }
+      return character.abilities.map((a) => a.id);
+    }
+  );
+  const resolvedAbilityIds = toAbilityIdList(resolvedRaw);
+  if (!resolvedAbilityIds) {
+    console.warn("Ability ID not found for ABILITY_CHANGE effect:", effect.source);
+    return;
+  }
+  makePlayersEffect.forEach((player) => {
+    const overrideRaw = operation.abilityChangeOverrides?.[String(player.seat)];
+    const overrideIds = toAbilityIdList(overrideRaw);
+    const finalAbilityIds = overrideIds ?? resolvedAbilityIds;
+    finalAbilityIds.forEach((finalAbilityId) => {
+      const newAbility = abilityMap.get(finalAbilityId);
+      if (!newAbility) {
+        console.warn("Ability not found for ABILITY_CHANGE effect:", finalAbilityId);
+        return;
+      }
+      const replaceAtSameStage = (abilities) => {
+        const idx = abilities.findIndex((aid) => abilityMap.get(aid)?.stage === newAbility.stage);
+        if (idx >= 0) {
+          abilities[idx] = finalAbilityId;
+        } else {
+          abilities.push(finalAbilityId);
+        }
+      };
+      replaceAtSameStage(player.abilities);
+      if (player.perceivedCharacter?.asCharacter) {
+        replaceAtSameStage(player.perceivedCharacter.abilities);
+      }
+    });
+  });
+});
+
 // src/effects/handlers/alignment-change.ts
 var applyAlignmentChange = createEffectHandler("ALIGNMENT_CHANGE", ({
   effect,
@@ -594,11 +663,111 @@ var resolveEffectTargets = ({
   return [];
 };
 
+// src/effects/evaluate-lifetime.ts
+var getLifetime = (effect) => {
+  if ("lifetime" in effect) {
+    return effect.lifetime;
+  }
+  return void 0;
+};
+var matchesLifetimeCondition = (player, condition, characterMap) => {
+  const { field, operator } = condition;
+  const value = condition.value;
+  if (field === "IS_DEAD") {
+    return Boolean(player.isDead) === Boolean(value);
+  }
+  if (field === "CHARACTER_ID") {
+    if (operator === "IN" && Array.isArray(value)) {
+      return value.includes(player.characterId);
+    }
+    return typeof value === "string" && player.characterId === value;
+  }
+  if (field === "CHARACTER_KIND") {
+    const kind = characterMap.get(player.characterId)?.kind;
+    if (!kind) return false;
+    if (operator === "IN" && Array.isArray(value)) {
+      return value.includes(kind);
+    }
+    return typeof value === "string" && kind === value;
+  }
+  if (field === "HAS_ABILITY") {
+    if (operator === "IN" && Array.isArray(value)) {
+      return value.some((id) => player.abilities.includes(id));
+    }
+    return typeof value === "string" && player.abilities.includes(value);
+  }
+  return false;
+};
+var evaluateConditions = (player, conditions, mode, characterMap) => {
+  if (!player) return false;
+  if (conditions.length === 0) return true;
+  const results = conditions.map((c) => matchesLifetimeCondition(player, c, characterMap));
+  return mode === "ALL" ? results.every(Boolean) : results.some(Boolean);
+};
+var evaluateLifetime = ({
+  effect,
+  operationTimelineIdx,
+  nowTimelineIndex,
+  timelines,
+  effector,
+  targets,
+  snapshotSeatMap,
+  characterMap
+}) => {
+  const lifetime = getLifetime(effect);
+  if (!lifetime || lifetime.kind === "PERMANENT") {
+    return targets;
+  }
+  if (lifetime.kind === "TURNS") {
+    const opTurn = operationTimelineIdx >= 0 ? timelines[operationTimelineIdx]?.turn : void 0;
+    const nowTurn = nowTimelineIndex >= 0 ? timelines[nowTimelineIndex]?.turn : void 0;
+    if (typeof opTurn !== "number" || typeof nowTurn !== "number") {
+      return targets;
+    }
+    return nowTurn - opTurn < lifetime.count ? targets : [];
+  }
+  if (lifetime.kind === "UNTIL_EVENT") {
+    if (operationTimelineIdx < 0) return targets;
+    for (let idx = operationTimelineIdx + 1; idx <= nowTimelineIndex; idx += 1) {
+      const tl = timelines[idx];
+      if (!tl) continue;
+      if (lifetime.event === "NEXT_DAY" && tl.time === "day") return [];
+      if (lifetime.event === "NEXT_NIGHT" && tl.time === "night") return [];
+      if (lifetime.event === "NEXT_EXECUTION" && (tl.nominations?.length ?? 0) > 0) return [];
+    }
+    return targets;
+  }
+  if (lifetime.kind === "WHILE") {
+    if (!snapshotSeatMap) {
+      return targets;
+    }
+    const subject = lifetime.subject ?? "EFFECTOR";
+    const mode = lifetime.mode ?? "ALL";
+    const conditions = lifetime.conditions ?? [];
+    if (subject === "EFFECTOR") {
+      const current = effector ? snapshotSeatMap.get(effector.seat) : void 0;
+      return evaluateConditions(current, conditions, mode, characterMap) ? targets : [];
+    }
+    return targets.filter((target) => {
+      const current = snapshotSeatMap.get(target.seat);
+      return evaluateConditions(current, conditions, mode, characterMap);
+    });
+  }
+  return targets;
+};
+
 // src/apply-operation.ts
 var isDeferredOperation = (operation, abilityMap) => {
   const ability = abilityMap.get(operation.abilityId);
   return ability?.executionTiming === "DEFER_TO_END";
 };
+var hasGatedLifetime = (allAbilities) => {
+  return allAbilities.some((ability) => ability.effects.some((effect) => {
+    if (!("lifetime" in effect)) return false;
+    const lifetime = effect.lifetime;
+    return Boolean(lifetime) && lifetime?.kind !== "PERMANENT";
+  }));
+};
 var applyOperationToPlayers = ({
   players,
   operations,
@@ -614,7 +783,6 @@ var applyOperationToPlayers = ({
   const characterMap = new Map(characters.map((character) => [character.id, character]));
   const operationTimelineMap = /* @__PURE__ */ new Map();
   timelines.forEach((timeline, idx) => timeline.operations?.forEach((op) => operationTimelineMap.set(op, idx)));
-  const playersWithStatus = copyPlayers(players);
   const nowTimelineIndex = typeof timelineIndexAtNow === "number" ? timelineIndexAtNow : timelines.length - 1;
   const operationsByTimeline = /* @__PURE__ */ new Map();
   operations.forEach((operation) => {
@@ -624,103 +792,124 @@ var applyOperationToPlayers = ({
     }
     operationsByTimeline.get(timelineIndex)?.push(operation);
   });
-  const applyOpsSequence = (ops) => {
-    ops.forEach((operation) => {
-      const operationInTimelineIdx = operationTimelineMap.get(operation) ?? -1;
-      const ability = abilityMap.get(operation.abilityId);
-      if (!ability) {
-        console.warn("Ability not found for operation:", operation);
-        return;
-      }
-      const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
-      const effector = playerSeatMap.get(operation.effector);
-      const payloads = operation.payloads || [];
-      const writableInputs = ability.inputs.filter((part) => !part.readonly);
-      let snapshotSeatMap = null;
-      const getSnapshotSeatMap = () => {
-        if (!snapshotSeatMap) {
-          snapshotSeatMap = buildPlayerSeatMap(copyPlayers(playersWithStatus));
-        }
-        return snapshotSeatMap;
-      };
-      ability.effects.forEach((effect) => {
-        const makePlayersEffect = resolveEffectTargets({
-          effect,
-          operation,
-          payloads,
-          effector,
-          playerSeatMap,
-          characterMap
-        });
-        if (!makePlayersEffect) {
+  const runReplay = (lifetimeSnapshotSeatMap) => {
+    const playersWithStatus = copyPlayers(players);
+    const applyOpsSequence = (ops) => {
+      ops.forEach((operation) => {
+        const operationInTimelineIdx = operationTimelineMap.get(operation) ?? -1;
+        const ability = abilityMap.get(operation.abilityId);
+        if (!ability) {
+          console.warn("Ability not found for operation:", operation);
           return;
         }
-        const handler = effectHandlers[effect.type];
-        if (!handler) {
-          console.warn("Unknown effect type:", effect.type);
-          return;
-        }
-        const context = {
-          effect,
-          operation,
-          payloads,
-          effector,
-          writableInputs,
-          playerSeatMap,
-          getSnapshotSeatMap,
-          characterMap,
-          nowTimelineIndex,
-          operationInTimelineIdx,
-          makePlayersEffect
+        const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
+        const effector = playerSeatMap.get(operation.effector);
+        const payloads = operation.payloads || [];
+        const writableInputs = ability.inputs.filter((part) => !part.readonly);
+        let snapshotSeatMap = null;
+        const getSnapshotSeatMap = () => {
+          if (!snapshotSeatMap) {
+            snapshotSeatMap = buildPlayerSeatMap(copyPlayers(playersWithStatus));
+          }
+          return snapshotSeatMap;
         };
-        handler(context);
+        ability.effects.forEach((effect) => {
+          const resolvedTargets = resolveEffectTargets({
+            effect,
+            operation,
+            payloads,
+            effector,
+            playerSeatMap,
+            characterMap
+          });
+          if (!resolvedTargets) {
+            return;
+          }
+          const makePlayersEffect = evaluateLifetime({
+            effect,
+            operationTimelineIdx: operationInTimelineIdx,
+            nowTimelineIndex,
+            timelines,
+            effector,
+            targets: resolvedTargets,
+            snapshotSeatMap: lifetimeSnapshotSeatMap,
+            characterMap
+          });
+          const handler = effectHandlers[effect.type];
+          if (!handler) {
+            console.warn("Unknown effect type:", effect.type);
+            return;
+          }
+          const context = {
+            effect,
+            operation,
+            payloads,
+            effector,
+            writableInputs,
+            playerSeatMap,
+            getSnapshotSeatMap,
+            characterMap,
+            abilityMap,
+            nowTimelineIndex,
+            operationInTimelineIdx,
+            makePlayersEffect
+          };
+          handler(context);
+        });
       });
-    });
-  };
-  const applyOps = (ops) => {
-    const normalOps = [];
-    const deferredOps = [];
-    ops.forEach((operation) => {
-      if (isDeferredOperation(operation, abilityMap)) {
-        deferredOps.push(operation);
-        return;
-      }
-      normalOps.push(operation);
-    });
-    applyOpsSequence(normalOps);
-    applyOpsSequence(deferredOps);
-  };
-  const settingsOps = operationsByTimeline.get(-1);
-  if (settingsOps) {
-    applyOps(settingsOps);
-  }
-  for (let i = 0; i <= nowTimelineIndex; i += 1) {
-    const timeline = timelines[i];
-    if (!timeline) {
-      continue;
-    }
-    const nominations = timeline.nominations;
-    if (nominations && nominations.length > 0) {
-      const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
-      nominations.forEach((nomination) => {
-        const voterSeats = nomination.voterSeats;
-        if (!voterSeats || voterSeats.length === 0) {
+    };
+    const applyOps = (ops) => {
+      const normalOps = [];
+      const deferredOps = [];
+      ops.forEach((operation) => {
+        if (isDeferredOperation(operation, abilityMap)) {
+          deferredOps.push(operation);
           return;
         }
-        voterSeats.forEach((seat) => {
-          const player = playerSeatMap.get(seat);
-          if (player && player.isDead && !player.hasUsedDeadVote) {
-            player.hasUsedDeadVote = true;
-          }
-        });
+        normalOps.push(operation);
       });
+      applyOpsSequence(normalOps);
+      applyOpsSequence(deferredOps);
+    };
+    const settingsOps = operationsByTimeline.get(-1);
+    if (settingsOps) {
+      applyOps(settingsOps);
     }
-    const timelineOps = operationsByTimeline.get(i);
-    if (timelineOps) {
-      applyOps(timelineOps);
+    for (let i = 0; i <= nowTimelineIndex; i += 1) {
+      const timeline = timelines[i];
+      if (!timeline) {
+        continue;
+      }
+      const nominations = timeline.nominations;
+      if (nominations && nominations.length > 0) {
+        const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
+        nominations.forEach((nomination) => {
+          const voterSeats = nomination.voterSeats;
+          if (!voterSeats || voterSeats.length === 0) {
+            return;
+          }
+          voterSeats.forEach((seat) => {
+            const player = playerSeatMap.get(seat);
+            if (player && player.isDead && !player.hasUsedDeadVote) {
+              player.hasUsedDeadVote = true;
+            }
+          });
+        });
+      }
+      const timelineOps = operationsByTimeline.get(i);
+      if (timelineOps) {
+        applyOps(timelineOps);
+      }
     }
+    return playersWithStatus;
+  };
+  if (!hasGatedLifetime(allAbilities)) {
+    return transformEmptyArray(runReplay(null));
   }
-  return transformEmptyArray(playersWithStatus);
+  const groundTruth = runReplay(null);
+  const groundTruthSeatMap = buildPlayerSeatMap(groundTruth);
+  const final = runReplay(groundTruthSeatMap);
+  return transformEmptyArray(final);
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -1,22 +1,3 @@
-// src/effects/handler-types.ts
-var createEffectHandler = (type, handler) => {
-  return (context) => {
-    if (context.effect.type !== type) {
-      console.warn("Invalid effect type for handler:", context.effect.type, "expected:", type);
-      return;
-    }
-    handler({
-      ...context,
-      effect: context.effect
-    });
-  };
-};
-
-// src/effects/handlers/ability-change.ts
-var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", () => {
-  console.warn("ABILITY_CHANGE effect handling not implemented yet.");
-});
-
 // src/guards.ts
 var isNumberOrNumberArray = (value) => {
   if (typeof value === "number") {
@@ -114,7 +95,7 @@ var getSourceValue = (source, payloads) => {
   }
   return null;
 };
-var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSeatMap, resolveFromPlayer, isResolvedValue) => {
+var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSeatMap, resolveFromPlayer, isResolvedValue, resolveFromCharacter) => {
   const castOrValidate = (value) => {
     if (!isResolvedValue) {
       return value;
@@ -130,6 +111,10 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
       const player = typeof seat === "number" ? snapshotSeatMap.get(seat) : void 0;
       return player ? resolveFromPlayer(player) : void 0;
     }
+    if (input?.type === "CHARACTER") {
+      const characterId = typeof payloadValue === "string" ? payloadValue : void 0;
+      return characterId && resolveFromCharacter ? resolveFromCharacter(characterId) : void 0;
+    }
     return castOrValidate(payloadValue);
   }
   if (source?.from === "CONSTANT") {
@@ -145,6 +130,90 @@ var resolveSourceValue = (source, writableInputs, payloads, effector, snapshotSe
   return void 0;
 };
 
+// src/effects/handler-types.ts
+var createEffectHandler = (type, handler) => {
+  return (context) => {
+    if (context.effect.type !== type) {
+      console.warn("Invalid effect type for handler:", context.effect.type, "expected:", type);
+      return;
+    }
+    handler({
+      ...context,
+      effect: context.effect
+    });
+  };
+};
+
+// src/effects/handlers/ability-change.ts
+var toAbilityIdList = (value) => {
+  if (typeof value === "string") {
+    return value.length > 0 ? [value] : void 0;
+  }
+  if (Array.isArray(value)) {
+    const ids = value.filter((item) => typeof item === "string" && item.length > 0);
+    return ids.length > 0 ? ids : void 0;
+  }
+  return void 0;
+};
+var applyAbilityChange = createEffectHandler("ABILITY_CHANGE", ({
+  effect,
+  operation,
+  payloads,
+  effector,
+  writableInputs,
+  getSnapshotSeatMap,
+  abilityMap,
+  makePlayersEffect,
+  characterMap
+}) => {
+  const resolvedRaw = resolveSourceValue(
+    effect.source,
+    writableInputs,
+    payloads,
+    effector,
+    getSnapshotSeatMap(),
+    (player) => player.abilities,
+    (value) => typeof value === "string" && value.length > 0 || Array.isArray(value) && value.every((item) => typeof item === "string"),
+    (characterId) => {
+      const character = characterMap.get(characterId);
+      if (!character) {
+        console.warn("Character not found for ABILITY_CHANGE effect source:", characterId);
+        return [];
+      }
+      return character.abilities.map((a) => a.id);
+    }
+  );
+  const resolvedAbilityIds = toAbilityIdList(resolvedRaw);
+  if (!resolvedAbilityIds) {
+    console.warn("Ability ID not found for ABILITY_CHANGE effect:", effect.source);
+    return;
+  }
+  makePlayersEffect.forEach((player) => {
+    const overrideRaw = operation.abilityChangeOverrides?.[String(player.seat)];
+    const overrideIds = toAbilityIdList(overrideRaw);
+    const finalAbilityIds = overrideIds ?? resolvedAbilityIds;
+    finalAbilityIds.forEach((finalAbilityId) => {
+      const newAbility = abilityMap.get(finalAbilityId);
+      if (!newAbility) {
+        console.warn("Ability not found for ABILITY_CHANGE effect:", finalAbilityId);
+        return;
+      }
+      const replaceAtSameStage = (abilities) => {
+        const idx = abilities.findIndex((aid) => abilityMap.get(aid)?.stage === newAbility.stage);
+        if (idx >= 0) {
+          abilities[idx] = finalAbilityId;
+        } else {
+          abilities.push(finalAbilityId);
+        }
+      };
+      replaceAtSameStage(player.abilities);
+      if (player.perceivedCharacter?.asCharacter) {
+        replaceAtSameStage(player.perceivedCharacter.abilities);
+      }
+    });
+  });
+});
+
 // src/effects/handlers/alignment-change.ts
 var applyAlignmentChange = createEffectHandler("ALIGNMENT_CHANGE", ({
   effect,
@@ -557,11 +626,111 @@ var resolveEffectTargets = ({
   return [];
 };
 
+// src/effects/evaluate-lifetime.ts
+var getLifetime = (effect) => {
+  if ("lifetime" in effect) {
+    return effect.lifetime;
+  }
+  return void 0;
+};
+var matchesLifetimeCondition = (player, condition, characterMap) => {
+  const { field, operator } = condition;
+  const value = condition.value;
+  if (field === "IS_DEAD") {
+    return Boolean(player.isDead) === Boolean(value);
+  }
+  if (field === "CHARACTER_ID") {
+    if (operator === "IN" && Array.isArray(value)) {
+      return value.includes(player.characterId);
+    }
+    return typeof value === "string" && player.characterId === value;
+  }
+  if (field === "CHARACTER_KIND") {
+    const kind = characterMap.get(player.characterId)?.kind;
+    if (!kind) return false;
+    if (operator === "IN" && Array.isArray(value)) {
+      return value.includes(kind);
+    }
+    return typeof value === "string" && kind === value;
+  }
+  if (field === "HAS_ABILITY") {
+    if (operator === "IN" && Array.isArray(value)) {
+      return value.some((id) => player.abilities.includes(id));
+    }
+    return typeof value === "string" && player.abilities.includes(value);
+  }
+  return false;
+};
+var evaluateConditions = (player, conditions, mode, characterMap) => {
+  if (!player) return false;
+  if (conditions.length === 0) return true;
+  const results = conditions.map((c) => matchesLifetimeCondition(player, c, characterMap));
+  return mode === "ALL" ? results.every(Boolean) : results.some(Boolean);
+};
+var evaluateLifetime = ({
+  effect,
+  operationTimelineIdx,
+  nowTimelineIndex,
+  timelines,
+  effector,
+  targets,
+  snapshotSeatMap,
+  characterMap
+}) => {
+  const lifetime = getLifetime(effect);
+  if (!lifetime || lifetime.kind === "PERMANENT") {
+    return targets;
+  }
+  if (lifetime.kind === "TURNS") {
+    const opTurn = operationTimelineIdx >= 0 ? timelines[operationTimelineIdx]?.turn : void 0;
+    const nowTurn = nowTimelineIndex >= 0 ? timelines[nowTimelineIndex]?.turn : void 0;
+    if (typeof opTurn !== "number" || typeof nowTurn !== "number") {
+      return targets;
+    }
+    return nowTurn - opTurn < lifetime.count ? targets : [];
+  }
+  if (lifetime.kind === "UNTIL_EVENT") {
+    if (operationTimelineIdx < 0) return targets;
+    for (let idx = operationTimelineIdx + 1; idx <= nowTimelineIndex; idx += 1) {
+      const tl = timelines[idx];
+      if (!tl) continue;
+      if (lifetime.event === "NEXT_DAY" && tl.time === "day") return [];
+      if (lifetime.event === "NEXT_NIGHT" && tl.time === "night") return [];
+      if (lifetime.event === "NEXT_EXECUTION" && (tl.nominations?.length ?? 0) > 0) return [];
+    }
+    return targets;
+  }
+  if (lifetime.kind === "WHILE") {
+    if (!snapshotSeatMap) {
+      return targets;
+    }
+    const subject = lifetime.subject ?? "EFFECTOR";
+    const mode = lifetime.mode ?? "ALL";
+    const conditions = lifetime.conditions ?? [];
+    if (subject === "EFFECTOR") {
+      const current = effector ? snapshotSeatMap.get(effector.seat) : void 0;
+      return evaluateConditions(current, conditions, mode, characterMap) ? targets : [];
+    }
+    return targets.filter((target) => {
+      const current = snapshotSeatMap.get(target.seat);
+      return evaluateConditions(current, conditions, mode, characterMap);
+    });
+  }
+  return targets;
+};
+
 // src/apply-operation.ts
 var isDeferredOperation = (operation, abilityMap) => {
   const ability = abilityMap.get(operation.abilityId);
   return ability?.executionTiming === "DEFER_TO_END";
 };
+var hasGatedLifetime = (allAbilities) => {
+  return allAbilities.some((ability) => ability.effects.some((effect) => {
+    if (!("lifetime" in effect)) return false;
+    const lifetime = effect.lifetime;
+    return Boolean(lifetime) && lifetime?.kind !== "PERMANENT";
+  }));
+};
 var applyOperationToPlayers = ({
   players,
   operations,
@@ -577,7 +746,6 @@ var applyOperationToPlayers = ({
   const characterMap = new Map(characters.map((character) => [character.id, character]));
   const operationTimelineMap = /* @__PURE__ */ new Map();
   timelines.forEach((timeline, idx) => timeline.operations?.forEach((op) => operationTimelineMap.set(op, idx)));
-  const playersWithStatus = copyPlayers(players);
   const nowTimelineIndex = typeof timelineIndexAtNow === "number" ? timelineIndexAtNow : timelines.length - 1;
   const operationsByTimeline = /* @__PURE__ */ new Map();
   operations.forEach((operation) => {
@@ -587,103 +755,124 @@ var applyOperationToPlayers = ({
     }
     operationsByTimeline.get(timelineIndex)?.push(operation);
   });
-  const applyOpsSequence = (ops) => {
-    ops.forEach((operation) => {
-      const operationInTimelineIdx = operationTimelineMap.get(operation) ?? -1;
-      const ability = abilityMap.get(operation.abilityId);
-      if (!ability) {
-        console.warn("Ability not found for operation:", operation);
-        return;
-      }
-      const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
-      const effector = playerSeatMap.get(operation.effector);
-      const payloads = operation.payloads || [];
-      const writableInputs = ability.inputs.filter((part) => !part.readonly);
-      let snapshotSeatMap = null;
-      const getSnapshotSeatMap = () => {
-        if (!snapshotSeatMap) {
-          snapshotSeatMap = buildPlayerSeatMap(copyPlayers(playersWithStatus));
-        }
-        return snapshotSeatMap;
-      };
-      ability.effects.forEach((effect) => {
-        const makePlayersEffect = resolveEffectTargets({
-          effect,
-          operation,
-          payloads,
-          effector,
-          playerSeatMap,
-          characterMap
-        });
-        if (!makePlayersEffect) {
+  const runReplay = (lifetimeSnapshotSeatMap) => {
+    const playersWithStatus = copyPlayers(players);
+    const applyOpsSequence = (ops) => {
+      ops.forEach((operation) => {
+        const operationInTimelineIdx = operationTimelineMap.get(operation) ?? -1;
+        const ability = abilityMap.get(operation.abilityId);
+        if (!ability) {
+          console.warn("Ability not found for operation:", operation);
           return;
         }
-        const handler = effectHandlers[effect.type];
-        if (!handler) {
-          console.warn("Unknown effect type:", effect.type);
-          return;
-        }
-        const context = {
-          effect,
-          operation,
-          payloads,
-          effector,
-          writableInputs,
-          playerSeatMap,
-          getSnapshotSeatMap,
-          characterMap,
-          nowTimelineIndex,
-          operationInTimelineIdx,
-          makePlayersEffect
+        const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
+        const effector = playerSeatMap.get(operation.effector);
+        const payloads = operation.payloads || [];
+        const writableInputs = ability.inputs.filter((part) => !part.readonly);
+        let snapshotSeatMap = null;
+        const getSnapshotSeatMap = () => {
+          if (!snapshotSeatMap) {
+            snapshotSeatMap = buildPlayerSeatMap(copyPlayers(playersWithStatus));
+          }
+          return snapshotSeatMap;
         };
-        handler(context);
+        ability.effects.forEach((effect) => {
+          const resolvedTargets = resolveEffectTargets({
+            effect,
+            operation,
+            payloads,
+            effector,
+            playerSeatMap,
+            characterMap
+          });
+          if (!resolvedTargets) {
+            return;
+          }
+          const makePlayersEffect = evaluateLifetime({
+            effect,
+            operationTimelineIdx: operationInTimelineIdx,
+            nowTimelineIndex,
+            timelines,
+            effector,
+            targets: resolvedTargets,
+            snapshotSeatMap: lifetimeSnapshotSeatMap,
+            characterMap
+          });
+          const handler = effectHandlers[effect.type];
+          if (!handler) {
+            console.warn("Unknown effect type:", effect.type);
+            return;
+          }
+          const context = {
+            effect,
+            operation,
+            payloads,
+            effector,
+            writableInputs,
+            playerSeatMap,
+            getSnapshotSeatMap,
+            characterMap,
+            abilityMap,
+            nowTimelineIndex,
+            operationInTimelineIdx,
+            makePlayersEffect
+          };
+          handler(context);
+        });
       });
-    });
-  };
-  const applyOps = (ops) => {
-    const normalOps = [];
-    const deferredOps = [];
-    ops.forEach((operation) => {
-      if (isDeferredOperation(operation, abilityMap)) {
-        deferredOps.push(operation);
-        return;
-      }
-      normalOps.push(operation);
-    });
-    applyOpsSequence(normalOps);
-    applyOpsSequence(deferredOps);
-  };
-  const settingsOps = operationsByTimeline.get(-1);
-  if (settingsOps) {
-    applyOps(settingsOps);
-  }
-  for (let i = 0; i <= nowTimelineIndex; i += 1) {
-    const timeline = timelines[i];
-    if (!timeline) {
-      continue;
-    }
-    const nominations = timeline.nominations;
-    if (nominations && nominations.length > 0) {
-      const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
-      nominations.forEach((nomination) => {
-        const voterSeats = nomination.voterSeats;
-        if (!voterSeats || voterSeats.length === 0) {
+    };
+    const applyOps = (ops) => {
+      const normalOps = [];
+      const deferredOps = [];
+      ops.forEach((operation) => {
+        if (isDeferredOperation(operation, abilityMap)) {
+          deferredOps.push(operation);
           return;
         }
-        voterSeats.forEach((seat) => {
-          const player = playerSeatMap.get(seat);
-          if (player && player.isDead && !player.hasUsedDeadVote) {
-            player.hasUsedDeadVote = true;
-          }
-        });
+        normalOps.push(operation);
       });
+      applyOpsSequence(normalOps);
+      applyOpsSequence(deferredOps);
+    };
+    const settingsOps = operationsByTimeline.get(-1);
+    if (settingsOps) {
+      applyOps(settingsOps);
     }
-    const timelineOps = operationsByTimeline.get(i);
-    if (timelineOps) {
-      applyOps(timelineOps);
+    for (let i = 0; i <= nowTimelineIndex; i += 1) {
+      const timeline = timelines[i];
+      if (!timeline) {
+        continue;
+      }
+      const nominations = timeline.nominations;
+      if (nominations && nominations.length > 0) {
+        const playerSeatMap = buildPlayerSeatMap(playersWithStatus);
+        nominations.forEach((nomination) => {
+          const voterSeats = nomination.voterSeats;
+          if (!voterSeats || voterSeats.length === 0) {
+            return;
+          }
+          voterSeats.forEach((seat) => {
+            const player = playerSeatMap.get(seat);
+            if (player && player.isDead && !player.hasUsedDeadVote) {
+              player.hasUsedDeadVote = true;
+            }
+          });
+        });
+      }
+      const timelineOps = operationsByTimeline.get(i);
+      if (timelineOps) {
+        applyOps(timelineOps);
+      }
     }
+    return playersWithStatus;
+  };
+  if (!hasGatedLifetime(allAbilities)) {
+    return transformEmptyArray(runReplay(null));
   }
-  return transformEmptyArray(playersWithStatus);
+  const groundTruth = runReplay(null);
+  const groundTruthSeatMap = buildPlayerSeatMap(groundTruth);
+  const final = runReplay(groundTruthSeatMap);
+  return transformEmptyArray(final);
 };
 export {
   adjustValueAsNumber,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bct-app/game-engine",
-  "version": "0.1.4",
+  "version": "0.1.6-beta.1",
   "description": "Game engine utilities for BCT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,6 +15,13 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsup src/index.ts --dts --format cjs,esm",
+    "dev": "tsup src/index.ts --dts --format cjs,esm --watch",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
   "keywords": [
     "game-engine",
     "bct"
@@ -30,19 +37,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@bct-app/game-model": "0.1.1"
+    "@bct-app/game-model": "0.1.3-beta.0"
   },
   "devDependencies": {
     "@vitest/ui": "^4.1.3",
     "tsup": "^8.0.2",
     "typescript": "^5.9.3",
     "vitest": "^4.1.3"
-  },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build": "tsup src/index.ts --dts --format cjs,esm",
-    "dev": "tsup src/index.ts --dts --format cjs,esm --watch",
-    "test": "vitest",
-    "test:run": "vitest run"
   }
-}
+}