azeroth-shell 0.0.0-stage → 0.1.0

package/src/domain/quests/interpreter/dbscript/registryWesternPlaguelands.ts

@@ -0,0 +1,206 @@
+// QI4 — eastern_kingdoms/western_plaguelands residual, extracted for the 1500-line ratchet: the
+// Taelan reward hook for 5862 and accept hook for 5944. Cite: western_plaguelands.cpp.
+
+import type { DbScriptIntent } from './types.ts';
+import { NPC_FLAG_CHANGE_REMOVE, UNIT_STAND_STATE_KNEEL } from './opcodes.ts';
+
+/** Matches registry.ts QuestScriptHook — local to avoid circular import. */
+type QuestScriptHook = 'accept' | 'reward' | 'complete' | 'frame';
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+// Cite: western_plaguelands.cpp:176 QUEST_ID_SCARLET_SUBTERFUGE = 5862 Deliver Tirion's Gift to Taelan —
+// reward starts scarlet complete dialogue.
+export const QUEST_SCARLET_SUBTERFUGE = 5862;
+// Cite: western_plaguelands.cpp:177 QUEST_ID_IN_DREAMS = 5944 Escort Taelan from Hearthglen — accept starts
+// npc_escortAI + explore credit at epilogue.
+export const QUEST_IN_DREAMS = 5944;
+// Cite: western_plaguelands.cpp:167 NPC_TAELAN_FORDRING = 1842 Script host for both hooks (bake ender 5862
+// / starter 5944).
+const NPC_TAELAN_FORDRING = 1842;
+// Cite: western_plaguelands.cpp:168 NPC_SCARLET_CAVALIER = 1836 Dialogue step that starts the 5862 reward
+// RP (kneel + strip questgiver).
+const NPC_SCARLET_CAVALIER = 1836;
+// Cite: western_plaguelands.cpp:119 SAY_ESCORT_START = -1001078 DoScriptText on 5944 ReceiveAIEvent
+// AI_EVENT_START_ESCORT.
+const SAY_ESCORT_START = -1001078;
+// Cite: western_plaguelands.cpp:115 SAY_SCARLET_COMPLETE_1 = -1001076 Scarlet Subterfuge dialogue (timed
+// FO6 after reward kneel).
+const SAY_SCARLET_COMPLETE_1 = -1001076;
+// Cite: western_plaguelands.cpp:116 SAY_SCARLET_COMPLETE_2 = -1001077 Restores QUESTGIVER after scarlet
+// complete combat (FO6).
+const SAY_SCARLET_COMPLETE_2 = -1001077;
+// Cite: western_plaguelands.cpp:155 SPELL_TAELAN_SUFFERING = 18810 Cast at SAY_SCARLET_COMPLETE_1 dialogue
+// step (FO6 timed).
+const SPELL_TAELAN_SUFFERING = 18810;
+// Cite: western_plaguelands.cpp:149 SPELL_DEVOTION_AURA = 17232 JustReachedHome resumes dialogue after
+// cavalier fight (FO6).
+const SPELL_DEVOTION_AURA = 17232;
+// Cite: ScriptDevAIMgr.h:52 FACTION_ESCORT_N_FRIEND_PASSIVE = 290 ReceiveAIEvent SetFactionTemporary on
+// 5944 escort start; also 5862 attack step.
+const FACTION_ESCORT_N_FRIEND_PASSIVE = 290;
+// Cite: Creature.h:577 TEMPFACTION_RESTORE_RESPAWN = 0x01 SetFactionTemporary flags on 5944 accept path.
+const TEMPFACTION_RESTORE_RESPAWN = 0x01;
+// Cite: AIDefines.h:43 AI_EVENT_START_ESCORT = 100 QuestAccept_npc_taelan_fordring SendAIEvent event type.
+const AI_EVENT_START_ESCORT = 100;
+// Cite: AIDefines.h:50 AI_EVENT_CUSTOM_A = 1000 QuestRewarded_npc_taelan_fordring SendAIEvent event type.
+const AI_EVENT_CUSTOM_A = 1000;
+// Cite: Unit.h:511 UNIT_NPC_FLAG_QUESTGIVER = 0x00000002 JustDidDialogueStep NPC_SCARLET_CAVALIER removes
+// this on Taelan.
+const UNIT_NPC_FLAG_QUESTGIVER = 0x00000002;
+/** Cite: Unit.h:105 UNIT_STAND_STATE_KNEEL = 8 opcodes.ts re-export used by 5862 reward kneel. */
+const UNIT_STAND_STATE_KNEEL_TAELAN = UNIT_STAND_STATE_KNEEL;
+// Cite: western_plaguelands.cpp:565 ForcedDespawn(3 * MINUTE * IN_MILLISECONDS) Epilogue despawn after 5944
+// explore credit (FO6).
+const TIRION_DESPAWN_MS = 3 * 60 * 1000;
+// Cite: bake enderCreatureEntries / western_plaguelands.cpp:170 NPC_TIRION_FORDRING=12126 Turn-in after
+// 5944 explore credit (also classic-db ender 1855).
+const NPC_TIRION_FORDRING = 12126;
+
+// QuestRewarded_npc_taelan_fordring — quest 5862 Scarlet Subterfuge: the reward kneels Taelan and
+// strips QUESTGIVER, which the scarlet RP later restores so 5944 can be taken. Cite: :661–667.
+function runTaelanFordringReward(questId: number): DbScriptIntent[] {
+  const citeEvent =
+    `western_plaguelands.cpp:664 npc_taelan_fordring (${NPC_TAELAN_FORDRING}) ` +
+    'SendAIEvent(AI_EVENT_CUSTOM_A, player, creature, questId)';
+  const citeDialogue =
+    `western_plaguelands.cpp:327–328 ReceiveAIEvent StartNextDialogueText(NPC_SCARLET_CAVALIER=${NPC_SCARLET_CAVALIER})`;
+  const citeKneel =
+    'western_plaguelands.cpp:401 SetStandState(UNIT_STAND_STATE_KNEEL)';
+  const citeQg =
+    'western_plaguelands.cpp:402 RemoveFlag(UNIT_NPC_FLAGS, UNIT_NPC_FLAG_QUESTGIVER)';
+  const citeCavaliers =
+    `western_plaguelands.cpp:404–417 GetCreatureListWithEntryInGrid(NPC_SCARLET_CAVALIER=${NPC_SCARLET_CAVALIER}) ` +
+    'face + aCavalierYells - FO6 nearby NPCs';
+  const citeTimed =
+    `western_plaguelands.cpp:420–450 timed dialogue: MovePoint cavaliers; ` +
+    `SAY_SCARLET_COMPLETE_1=${SAY_SCARLET_COMPLETE_1} + SPELL_TAELAN_SUFFERING=${SPELL_TAELAN_SUFFERING}; ` +
+    `SetFactionTemporary + AttackStart; JustReachedHome SPELL_DEVOTION_AURA=${SPELL_DEVOTION_AURA}; ` +
+    `SAY_SCARLET_COMPLETE_2=${SAY_SCARLET_COMPLETE_2} SetFlag(QUESTGIVER) - FO6 RP/combat`;
+  // Reset ships QUESTGIVER; dialogue removes that bit → 0 when only that flag is set.
+  const prior = UNIT_NPC_FLAG_QUESTGIVER;
+  const resultFlags = prior & ~UNIT_NPC_FLAG_QUESTGIVER;
+  return [
+    {
+      kind: 'send_ai_event',
+      eventType: AI_EVENT_CUSTOM_A,
+      radius: 0,
+      value: questId,
+      mode: 'receive_on_source',
+      cite: citeEvent,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `StartNextDialogueText(NPC_SCARLET_CAVALIER=${NPC_SCARLET_CAVALIER}) via ReceiveAIEvent - FO6 dialogue machine`,
+      cite: citeDialogue,
+    },
+    {
+      kind: 'stand_state',
+      standState: UNIT_STAND_STATE_KNEEL_TAELAN,
+      cite: citeKneel,
+    },
+    {
+      kind: 'modify_npc_flags',
+      flag: UNIT_NPC_FLAG_QUESTGIVER,
+      changeFlag: NPC_FLAG_CHANGE_REMOVE,
+      mode: 'remove',
+      resultFlags,
+      cite: citeQg,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `cavalier face + aCavalierYells NPC_SCARLET_CAVALIER (${NPC_SCARLET_CAVALIER}) - FO6 nearby NPCs`,
+      cite: citeCavaliers,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `scarlet complete timed RP/combat (SPELL ${SPELL_TAELAN_SUFFERING}, restore QUESTGIVER) - FO6`,
+      cite: citeTimed,
+    },
+  ];
+}
+
+// QuestAccept_npc_taelan_fordring — quest 5944 In Dreams: the AI event starts the escort out of
+// Hearthglen, and the Tirion epilogue carries the credit. Cite: western_plaguelands.cpp:653–659.
+function runTaelanFordringAccept(questId: number): DbScriptIntent[] {
+  const citeEvent =
+    `western_plaguelands.cpp:656 npc_taelan_fordring (${NPC_TAELAN_FORDRING}) ` +
+    'SendAIEvent(AI_EVENT_START_ESCORT, player, creature, questId)';
+  const citeTalk =
+    `western_plaguelands.cpp:324 DoScriptText(SAY_ESCORT_START=${SAY_ESCORT_START}) via ReceiveAIEvent`;
+  const citeFaction =
+    'western_plaguelands.cpp:325 SetFactionTemporary(FACTION_ESCORT_N_FRIEND_PASSIVE, ' +
+    'TEMPFACTION_RESTORE_RESPAWN)';
+  const citeEscort =
+    'western_plaguelands.cpp:323 npc_escortAI::Start(false, player, quest) - FO6 degraded finishEscort';
+  const citeWp =
+    'western_plaguelands.cpp:340–355 WP26 SAY_EXIT_KEEP + WP56 SAY_REACH_TOWER dialogue pauses - FO6 WP';
+  const citeFight =
+    'western_plaguelands.cpp:457–515 Isillien summon/fight + Tirion spawn AI_EVENT_CUSTOM_B - FO6 combat';
+  const citeCredit =
+    `western_plaguelands.cpp:559–564 SAY_EPILOG_5 RewardPlayerAndGroupAtEventExplored(5944) + ` +
+    `ForcedDespawn(${TIRION_DESPAWN_MS}) Tirion ${NPC_TIRION_FORDRING} - FO6 finishEscort`;
+  return [
+    {
+      kind: 'send_ai_event',
+      eventType: AI_EVENT_START_ESCORT,
+      radius: 0,
+      value: questId,
+      mode: 'receive_on_source',
+      cite: citeEvent,
+    },
+    {
+      kind: 'talk',
+      textId: SAY_ESCORT_START,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'set_faction',
+      factionId: FACTION_ESCORT_N_FRIEND_PASSIVE,
+      flags: TEMPFACTION_RESTORE_RESPAWN,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(false, player, quest) npc_taelan_fordring (${NPC_TAELAN_FORDRING}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason: 'WP26/56 escort dialogue pauses (exit keep / reach tower) - FO6 waypoint',
+      cite: citeWp,
+    },
+    {
+      kind: 'skip',
+      reason: 'Isillien + Tirion fight dialogue chain - FO6 combat/RP',
+      cite: citeFight,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `SAY_EPILOG_5 RewardPlayerAndGroupAtEventExplored(5944) + ForcedDespawn(${TIRION_DESPAWN_MS}) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+  ];
+}
+
+// Family pack: eastern_kingdoms/western_plaguelands.cpp. The Taelan reward hook for 5862 and the
+// Taelan accept hook for 5944.
+export function runWesternPlaguelands(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase === 'reward' && questId === QUEST_SCARLET_SUBTERFUGE) {
+    return runTaelanFordringReward(questId);
+  }
+  if (phase === 'accept' && questId === QUEST_IN_DREAMS) {
+    return runTaelanFordringAccept(questId);
+  }
+  return [];
+}

package/src/domain/quests/interpreter/dbscript/registryWestfall.ts

@@ -0,0 +1,190 @@
+// QI4 — eastern_kingdoms/westfall residual, extracted for the 1500-line ratchet: accept hooks for
+// quests 1651 and 155. Cite: eastern_kingdoms/westfall.cpp.
+
+import type { DbScriptIntent } from './types.ts';
+
+/** Matches registry.ts QuestScriptHook — local to avoid circular import. */
+type QuestScriptHook = 'accept' | 'reward' | 'complete' | 'frame';
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+// Cite: westfall.cpp:51 QUEST_TOME_VALOR = 1651 Escort Daphne Stilwell; defend her farm from Defias raider
+// waves.
+export const QUEST_TOME_VALOR = 1651;
+// Cite: westfall.cpp:348 QUEST_DEFIAS_BROTHERHOOD = 155 Escort the Defias Traitor to the hideout overlook.
+export const QUEST_DEFIAS_BROTHERHOOD = 155;
+// Cite: bake starterCreatureEntries / scriptdev2 ScriptName='npc_daphne_stilwell' Daphne Stilwell (entry
+// 6182).
+const NPC_DAPHNE_STILWELL = 6182;
+// Cite: bake starterCreatureEntries / scriptdev2 ScriptName='npc_defias_traitor' The Defias Traitor (entry
+// 467).
+const NPC_DEFIAS_TRAITOR = 467;
+/** Cite: bake enderCreatureEntries quest 155 — Gryan Stoutmantle (234). */
+const NPC_GRYAN_STOUTMANTLE = 234;
+// Cite: westfall.cpp:52 NPC_DEFIAS_RAIDER = 6180 Wave adds summoned at escort WP4 (DoSendWave) — FO6
+// combat.
+const NPC_DEFIAS_RAIDER = 6180;
+/** Cite: westfall.cpp:53 EQUIP_ID_RIFLE = 2511 Daphne equips rifle at WP5 (SetEquipmentSlots ranged). */
+const EQUIP_ID_RIFLE = 2511;
+/** Cite: westfall.cpp:43 SAY_DS_START = -1000293 DoScriptText on Daphne accept. */
+const SAY_DS_START = -1000293;
+/** Cite: westfall.cpp:41 YELL_DEFIAS_START = -1000412 First raider wave intro yell (DoSendWave) — FO6. */
+const YELL_DEFIAS_START = -1000412;
+/** Cite: westfall.cpp:44–46 SAY_WAVE_DOWN_1/2/3 Between-wave victory lines (urand) — FO6 combat. */
+const SAY_WAVE_DOWN_1 = -1000294;
+const SAY_WAVE_DOWN_2 = -1000295;
+const SAY_WAVE_DOWN_3 = -1000414;
+/** Cite: westfall.cpp:47 SAY_DS_DOWN_3 = -1000296 WP8 cheer after third wave cleared. */
+const SAY_DS_DOWN_3 = -1000296;
+/** Cite: westfall.cpp:48 SAY_DS_PROLOGUE = -1000297 WP9 after wave defense. */
+const SAY_DS_PROLOGUE = -1000297;
+/** Cite: westfall.cpp:42 YELL_DAPHNE_START = -1000413 WP7 yell while waiting for raiders. */
+const YELL_DAPHNE_START = -1000413;
+/** Cite: westfall.cpp:339 SAY_START = 9 DoBroadcastText on Defias Traitor accept (broadcast_text id). */
+const SAY_START = 9;
+/** Cite: westfall.cpp:340 SAY_PROGRESS = 10 WP65 progress line to player. */
+const SAY_PROGRESS = 10;
+/** Cite: westfall.cpp:341 SAY_END = 11 WP94 end line before explore credit. */
+const SAY_END = 11;
+/** Cite: westfall.cpp:347 DEFIAS_TRAITOR_PATH = 467 Path id passed to npc_escortAI::Start on accept. */
+const DEFIAS_TRAITOR_PATH = 467;
+// Cite: westfall.cpp:193 TEMPSPAWN_TIMED_OOC_DESPAWN, 30000 Raider summon despawn delay (ms) — FO6 wave.
+const RAIDER_DESPAWN_MS = 30000;
+/** Cite: westfall.cpp:374 ForcedDespawn(3000, true) Traitor despawn after WP94 explore credit. */
+const TRAITOR_DESPAWN_MS = 3000;
+
+// QuestAccept_npc_daphne_stilwell — quest 1651 The Tome of Valor: say the start line and escort;
+// she equips a rifle and holds three Defias waves, then WP16 credits. Cite: westfall.cpp:315–323.
+function runDaphneStilwellAccept(): DbScriptIntent[] {
+  const citeTalk =
+    `westfall.cpp:319 npc_daphne_stilwell (${NPC_DAPHNE_STILWELL}) ` +
+    `DoScriptText(SAY_DS_START=${SAY_DS_START})`;
+  const citeEscort =
+    `westfall.cpp:321–322 npc_daphne_stilwell (${NPC_DAPHNE_STILWELL}) ` +
+    'npc_escortAI::Start(true, player, quest) - FO6 degraded finishEscort';
+  const citeWaves =
+    `westfall.cpp:107–114,179–207 WP4 DoSendWave SummonCreature(NPC_DEFIAS_RAIDER=${NPC_DEFIAS_RAIDER}) ` +
+    `×3 waves TEMPSPAWN_TIMED_OOC_DESPAWN ${RAIDER_DESPAWN_MS}ms; YELL_DEFIAS_START=${YELL_DEFIAS_START}; ` +
+    `SAY_WAVE_DOWN_1/2/3=${SAY_WAVE_DOWN_1}/${SAY_WAVE_DOWN_2}/${SAY_WAVE_DOWN_3} - FO6 combat`;
+  const citeRifle =
+    `westfall.cpp:121–128 WP5 SetEquipmentSlots(EQUIP_ID_RIFLE=${EQUIP_ID_RIFLE}) + sheath ranged - FO6 WP`;
+  const citeHold =
+    `westfall.cpp:130–136 WP7 YELL_DAPHNE_START=${YELL_DAPHNE_START} + SetEscortPaused - FO6 wave hold`;
+  const citeCheer =
+    `westfall.cpp:138–148 WP8 SAY_DS_DOWN_3=${SAY_DS_DOWN_3}; WP9 SAY_DS_PROLOGUE=${SAY_DS_PROLOGUE} - FO6 WP`;
+  const citeCredit =
+    `westfall.cpp:166–169 WP16 RewardPlayerAndGroupAtEventExplored(1651) - FO6 finishEscort`;
+  const citeEnd =
+    'westfall.cpp:171–174,289–293 WP17 DoEndEscort ForcedDespawn+Respawn - FO6';
+  return [
+    {
+      kind: 'talk',
+      textId: SAY_DS_START,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(true, player, quest) npc_daphne_stilwell (${NPC_DAPHNE_STILWELL}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP4–7 Defias raider waves NPC_DEFIAS_RAIDER (${NPC_DEFIAS_RAIDER}) ×3 - FO6 combat`,
+      cite: citeWaves,
+    },
+    {
+      kind: 'skip',
+      reason: `WP5 equip rifle ${EQUIP_ID_RIFLE} - FO6 waypoint`,
+      cite: citeRifle,
+    },
+    {
+      kind: 'skip',
+      reason: `WP7 YELL_DAPHNE_START (${YELL_DAPHNE_START}) + escort pause - FO6`,
+      cite: citeHold,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP8–9 SAY_DS_DOWN_3 (${SAY_DS_DOWN_3}) + SAY_DS_PROLOGUE (${SAY_DS_PROLOGUE}) - FO6`,
+      cite: citeCheer,
+    },
+    {
+      kind: 'skip',
+      reason:
+        'WP16 RewardPlayerAndGroupAtEventExplored(1651) - FO6 finishEscort',
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason: 'WP17 DoEndEscort ForcedDespawn+Respawn - FO6',
+      cite: citeEnd,
+    },
+  ];
+}
+
+// QuestAccept_npc_defias_traitor — quest 155 The Defias Brotherhood: say the start line and run
+// escort path 467; WP94 says the end line and credits. Cite: westfall.cpp:392–402, :359–376.
+function runDefiasTraitorAccept(): DbScriptIntent[] {
+  const citeTalk =
+    `westfall.cpp:396 npc_defias_traitor (${NPC_DEFIAS_TRAITOR}) ` +
+    `DoBroadcastText(SAY_START=${SAY_START})`;
+  const citeEscort =
+    `westfall.cpp:398–399 npc_defias_traitor (${NPC_DEFIAS_TRAITOR}) ` +
+    `npc_escortAI::Start(true, player, quest, true, false, DEFIAS_TRAITOR_PATH=${DEFIAS_TRAITOR_PATH}) ` +
+    '- FO6 degraded finishEscort (instant respawn)';
+  const citeProgress =
+    `westfall.cpp:362–367 WP65 SetRun(false) + DoBroadcastText(SAY_PROGRESS=${SAY_PROGRESS}) - FO6 WP`;
+  const citeCredit =
+    `westfall.cpp:368–374 WP94 DoBroadcastText(SAY_END=${SAY_END}) + ` +
+    `RewardPlayerAndGroupAtEventExplored(155) + ForcedDespawn(${TRAITOR_DESPAWN_MS}, true) - FO6 finishEscort`;
+  const citeEnder =
+    `bake enderCreatureEntries NPC_GRYAN_STOUTMANTLE=${NPC_GRYAN_STOUTMANTLE} after WP94 explore credit`;
+  return [
+    {
+      kind: 'talk',
+      textId: SAY_START,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(true, player, quest, true, false, path=${DEFIAS_TRAITOR_PATH}) ` +
+        `npc_defias_traitor (${NPC_DEFIAS_TRAITOR}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason: `WP65 SAY_PROGRESS (${SAY_PROGRESS}) - FO6 waypoint`,
+      cite: citeProgress,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP94 SAY_END (${SAY_END}) + RewardPlayerAndGroupAtEventExplored(155) + ` +
+        `ForcedDespawn(${TRAITOR_DESPAWN_MS}) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `turn-in Gryan Stoutmantle (${NPC_GRYAN_STOUTMANTLE}) after explore credit - host ender`,
+      cite: citeEnder,
+    },
+  ];
+}
+
+// Family pack: eastern_kingdoms/westfall.cpp. Accept hooks for 1651 and 155. Foreman Klaven
+// Mortwake is stealth-alert AI only, not a quest hook.
+export function runWestfall(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase !== 'accept') return [];
+  if (questId === QUEST_TOME_VALOR) return runDaphneStilwellAccept();
+  if (questId === QUEST_DEFIAS_BROTHERHOOD) return runDefiasTraitorAccept();
+  return [];
+}

package/src/domain/quests/interpreter/dbscript/registryWetlands.ts

@@ -0,0 +1,186 @@
+// QI4 — eastern_kingdoms/wetlands residual, extracted for the 1500-line ratchet: the accept hook
+// for quest 1249 only. Cite: eastern_kingdoms/wetlands.cpp.
+
+import type { DbScriptIntent } from './types.ts';
+
+/** Matches registry.ts QuestScriptHook — local to avoid circular import. */
+type QuestScriptHook = 'accept' | 'reward' | 'complete' | 'frame';
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+// Cite: wetlands.cpp:45 QUEST_MISSING_DIPLOMAT11 = 1249 The Missing Diplomat — subdue Tapoke "Slim" Jahn at
+// Menethil Harbor inn.
+export const QUEST_MISSING_DIPLOMAT11 = 1249;
+
+// Cite: bake starterCreatureEntries / scriptdev2 ScriptName='npc_mikhail' Mikhail (quest giver, Menethil
+// inn).
+const NPC_MIKHAIL = 4963;
+// Cite: wetlands.cpp:52 NPC_TAPOKE_SLIM_JAHN = 4962 Escort target found via GetClosestCreatureWithEntry on
+// accept.
+const NPC_TAPOKE_SLIM_JAHN = 4962;
+// Cite: wetlands.cpp:51 NPC_SLIMS_FRIEND = 4971 Guardian summoned by SPELL_CALL_FRIENDS on Slim aggro (FO6
+// combat).
+const NPC_SLIMS_FRIEND = 4971;
+
+// Cite: wetlands.cpp:48 SPELL_STEALTH = 1785 Cast on Slim at accept if not already stealthed (triggered).
+const SPELL_STEALTH = 1785;
+// Cite: wetlands.cpp:49 SPELL_CALL_FRIENDS = 16457 Slim casts on first aggro during escort — summons
+// NPC_SLIMS_FRIEND (FO6).
+const SPELL_CALL_FRIENDS = 16457;
+
+// Cite: wetlands.cpp:46 FACTION_ENEMY = 168 WP3 SetFactionTemporary when Slim drops stealth and turns
+// hostile.
+const FACTION_ENEMY = 168;
+/** Cite: Creature.h:577 TEMPFACTION_RESTORE_RESPAWN = 0x01 */
+const TEMPFACTION_RESTORE_RESPAWN = 0x01;
+/** Cite: Creature.h:578 TEMPFACTION_RESTORE_COMBAT_STOP = 0x02 */
+const TEMPFACTION_RESTORE_COMBAT_STOP = 0x02;
+// Cite: wetlands.cpp:105 TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_RESTORE_COMBAT_STOP = 0x01 | 0x02 = 0x03
+const SLIM_TEMP_FACTION_FLAGS =
+  TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_RESTORE_COMBAT_STOP;
+
+// Cite: Unit.h:476 UNIT_FLAG_IMMUNE_TO_PLAYER = 0x00000100 Reset() sets immune; WP3 removes it when fight
+// starts.
+const UNIT_FLAG_IMMUNE_TO_PLAYER = 0x00000100;
+
+// Cite: SpellDefines.h:432 TRIGGERED_OLD_TRIGGERED = 0x00000001 wetlands.cpp:216 CastSpell(pSlim,
+// SPELL_STEALTH, TRIGGERED_OLD_TRIGGERED).
+const TRIGGERED_OLD_TRIGGERED = 0x00000001;
+
+// Cite: AIDefines.h:43 AI_EVENT_START_ESCORT = 100 QuestAccept_npc_mikhail SendAIEvent event type to Slim.
+const AI_EVENT_START_ESCORT = 100;
+
+// Cite: wetlands.cpp:211 GetClosestCreatureWithEntry(..., 25.0f) Search radius from Mikhail to Slim on
+// accept.
+const SLIM_SEARCH_RADIUS = 25.0;
+
+// Cite: wetlands.cpp:40 SAY_SLIM_AGGRO = -1000977 DoScriptText on first aggro after CALL_FRIENDS (FO6
+// combat).
+const SAY_SLIM_AGGRO = -1000977;
+/** Cite: wetlands.cpp:41 SAY_SLIM_DEFEAT = -1000978 Dialogue start after low-HP evade (JustReachedHome). */
+const SAY_SLIM_DEFEAT = -1000978;
+// Cite: wetlands.cpp:42 SAY_FRIEND_DEFEAT = -1000979 Slim's friend line before ForcedDespawn(1000) on event
+// complete.
+const SAY_FRIEND_DEFEAT = -1000979;
+/** Cite: wetlands.cpp:43 SAY_SLIM_NOTES = -1000980 Second dialogue step before explore credit. */
+const SAY_SLIM_NOTES = -1000980;
+
+/** Cite: wetlands.cpp:141 GetHealthPercent() < 20.0f DamageTaken threshold that ends the fight (FO6). */
+const SLIM_CREDIT_HP_PCT = 20;
+// Cite: wetlands.cpp:146 ForcedDespawn(1000) on friend at event complete. Cite: wetlands.cpp:174
+// ForcedDespawn(1000) on Slim after explore credit.
+const SLIM_DESPAWN_MS = 1000;
+/** Cite: wetlands.cpp:175 SetRespawnDelay(2) after ForcedDespawn. */
+const SLIM_RESPAWN_DELAY_S = 2;
+
+// QuestAccept_npc_mikhail — quest 1249 The Missing Diplomat pt11: stealth Slim and start his
+// escort, which turns hostile at WP3 and credits from the defeat dialogue. Cite: wetlands.cpp:207.
+function runMikhailAccept(questId: number): DbScriptIntent[] {
+  const citeFind =
+    `wetlands.cpp:211–213 npc_mikhail (${NPC_MIKHAIL}) ` +
+    `GetClosestCreatureWithEntry(NPC_TAPOKE_SLIM_JAHN=${NPC_TAPOKE_SLIM_JAHN}, ${SLIM_SEARCH_RADIUS})`;
+  const citeStealth =
+    `wetlands.cpp:215–216 npc_tapoke_slim_jahn (${NPC_TAPOKE_SLIM_JAHN}) ` +
+    `CastSpell(SPELL_STEALTH=${SPELL_STEALTH}, TRIGGERED_OLD_TRIGGERED) if no aura`;
+  const citeEvent =
+    `wetlands.cpp:218 npc_mikhail (${NPC_MIKHAIL})→npc_tapoke_slim_jahn (${NPC_TAPOKE_SLIM_JAHN}) ` +
+    'SendAIEvent(AI_EVENT_START_ESCORT, player, pSlim, questId)';
+  const citeEscort =
+    `wetlands.cpp:162 npc_tapoke_slim_jahn (${NPC_TAPOKE_SLIM_JAHN}) ` +
+    'npc_escortAI::Start(false, player, quest, true) - FO6 degraded finishEscort';
+  const citeWp3 =
+    `wetlands.cpp:102–108 WP3 SetRun; RemoveAuras(SPELL_STEALTH=${SPELL_STEALTH}); ` +
+    `SetFactionTemporary(FACTION_ENEMY=${FACTION_ENEMY}, flags=${SLIM_TEMP_FACTION_FLAGS}); ` +
+    `RemoveFlag(UNIT_FLAG_IMMUNE_TO_PLAYER=${UNIT_FLAG_IMMUNE_TO_PLAYER}); REACT_AGGRESSIVE - FO6 WP`;
+  const citeWp7 =
+    'wetlands.cpp:109–113 WP7 fail quest if Slim escapes (JustDied) - FO6 escort fail';
+  const citeAggro =
+    `wetlands.cpp:117–127 Aggro DoCastSpellIfCan(SPELL_CALL_FRIENDS=${SPELL_CALL_FRIENDS}) ` +
+    `summon NPC_SLIMS_FRIEND (${NPC_SLIMS_FRIEND}) + DoScriptText(SAY_SLIM_AGGRO=${SAY_SLIM_AGGRO}) - FO6 combat`;
+  const citeLowHp =
+    `wetlands.cpp:136–156 DamageTaken HP<${SLIM_CREDIT_HP_PCT}%: ` +
+    `SAY_FRIEND_DEFEAT=${SAY_FRIEND_DEFEAT} + ForcedDespawn(${SLIM_DESPAWN_MS}); ` +
+    'SetEscortPaused + EnterEvadeMode - FO6 fight end';
+  const citeDialog =
+    `wetlands.cpp:86–96,55–60 JustReachedHome dialogue ` +
+    `SAY_SLIM_DEFEAT=${SAY_SLIM_DEFEAT} → SAY_SLIM_NOTES=${SAY_SLIM_NOTES} - FO6 dialogue`;
+  const citeCredit =
+    `wetlands.cpp:165–176 JustDidDialogueStep QUEST_MISSING_DIPLOMAT11 ` +
+    `RewardPlayerAndGroupAtEventExplored(1249) + ForcedDespawn(${SLIM_DESPAWN_MS}) + ` +
+    `SetRespawnDelay(${SLIM_RESPAWN_DELAY_S}) - FO6 finishEscort`;
+  return [
+    {
+      kind: 'skip',
+      reason:
+        `GetClosestCreatureWithEntry(NPC_TAPOKE_SLIM_JAHN=${NPC_TAPOKE_SLIM_JAHN}, ${SLIM_SEARCH_RADIUS}) - zone model assumes Slim present`,
+      cite: citeFind,
+    },
+    {
+      kind: 'cast_spell',
+      spellId: SPELL_STEALTH,
+      castFlags: TRIGGERED_OLD_TRIGGERED,
+      sourceIsGo: false,
+      targetCleared: false,
+      cite: citeStealth,
+    },
+    {
+      kind: 'send_ai_event',
+      eventType: AI_EVENT_START_ESCORT,
+      radius: 0,
+      value: questId,
+      mode: 'to_target',
+      cite: citeEvent,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(false, player, quest, true) npc_tapoke_slim_jahn (${NPC_TAPOKE_SLIM_JAHN}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP3 unstealth + faction ${FACTION_ENEMY} flags ${SLIM_TEMP_FACTION_FLAGS} + clear UNIT_FLAG_IMMUNE_TO_PLAYER - FO6 waypoint`,
+      cite: citeWp3,
+    },
+    {
+      kind: 'skip',
+      reason: 'WP7 fail quest if Slim escapes - FO6 escort fail',
+      cite: citeWp7,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `Aggro SPELL_CALL_FRIENDS (${SPELL_CALL_FRIENDS}) + SAY_SLIM_AGGRO (${SAY_SLIM_AGGRO}) + friend ${NPC_SLIMS_FRIEND} - FO6 combat`,
+      cite: citeAggro,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `DamageTaken HP<${SLIM_CREDIT_HP_PCT}% friend SAY_FRIEND_DEFEAT (${SAY_FRIEND_DEFEAT}) + evade - FO6 fight end`,
+      cite: citeLowHp,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `dialogue SAY_SLIM_DEFEAT (${SAY_SLIM_DEFEAT}) + SAY_SLIM_NOTES (${SAY_SLIM_NOTES}) - FO6 dialogue`,
+      cite: citeDialog,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `JustDidDialogueStep RewardPlayerAndGroupAtEventExplored(1249) + ForcedDespawn(${SLIM_DESPAWN_MS}) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+  ];
+}
+
+/** Family pack: eastern_kingdoms/wetlands.cpp Hooks: pQuestAcceptNPC QuestAccept_npc_mikhail (1249). */
+export function runWetlands(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase !== 'accept') return [];
+  if (questId === QUEST_MISSING_DIPLOMAT11) return runMikhailAccept(questId);
+  return [];
+}