azeroth-shell 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,369 @@
+// QI4 — eastern_kingdoms/stormwind_city residual, extracted for the 1500-line ratchet. Accept hooks
+// for quests 1640, 1447 and 6403, plus the Squire Rowe gossip for 6402. Cite: stormwind_city.cpp.
+
+import type { DbScriptIntent } from './types.ts';
+import {
+  NPC_FLAG_CHANGE_REMOVE,
+  TEMPSPAWN_TIMED_OOC_OR_DEAD_DESPAWN,
+} from './opcodes.ts';
+
+/** Matches registry.ts QuestScriptHook — local to avoid circular import. */
+type QuestScriptHook = 'accept' | 'reward' | 'complete' | 'frame';
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+/** Cite: stormwind_city.cpp:46 QUEST_BEAT = 1640 Beat Bartleby — duel Bartleby for his mug. */
+export const QUEST_BEAT = 1640;
+// Cite: stormwind_city.cpp:100 QUEST_MISSING_DIPLO_PT8 = 1447 The Missing Diplomat (pt8) — defeat Dashel
+// Stonefist in Old Town.
+export const QUEST_MISSING_DIPLO_PT8 = 1447;
+// Cite: stormwind_city.cpp:521 QUEST_STORMWIND_RENDEZVOUS = 6402 Stormwind Rendezvous — meet Windsor at the
+// city gates (Squire Rowe gossip).
+export const QUEST_STORMWIND_RENDEZVOUS = 6402;
+// Cite: stormwind_city.cpp:522 QUEST_THE_GREAT_MASQUERADE = 6403 The Great Masquerade — escort Reginald
+// Windsor to keep / expose Prestor.
+export const QUEST_THE_GREAT_MASQUERADE = 6403;
+
+// Cite: bake starterCreatureEntries / classic-db creature_questrelation Bartleby (npc_bartleby script
+// name).
+const NPC_BARTLEBY = 6090;
+/** Cite: bake starterCreatureEntries — Dashel Stonefist (npc_dashel_stonefist script name). */
+const NPC_DASHEL_STONEFIST = 4961;
+/** Cite: stormwind_city.cpp:102 NPC_OLD_TOWN_THUG = 4969 Thugs summoned on Missing Diplomat accept. */
+const NPC_OLD_TOWN_THUG = 4969;
+// Cite: world_eastern_kingdoms.h:12 NPC_WINDSOR = 12580 Reginald Windsor (npc_reginald_windsor); also ender
+// of 6402 / starter of 6403.
+const NPC_WINDSOR = 12580;
+// Cite: scriptdev2.sql ScriptName='npc_squire_rowe' WHERE entry=17804 Squire Rowe — gossip starts Windsor
+// summon escort for 6402 turn-in.
+const NPC_SQUIRE_ROWE = 17804;
+// Cite: bake enderCreatureEntries quest 6403 — Highlord Bolvar Fordragon world_eastern_kingdoms.h:10
+// NPC_BOLVAR = 1748
+const NPC_BOLVAR = 1748;
+/** Cite: bake starterCreatureEntries quest 6402 — Marshal Maxwell */
+const NPC_MARSHAL_MAXWELL = 9560;
+
+/** Cite: stormwind_city.cpp:45 FACTION_ENEMY = 168 Bartleby accept SetFactionTemporary. */
+const FACTION_ENEMY = 168;
+// Cite: stormwind_city.cpp:104 FACTION_NEUTRAL = 189 Dashel accept SetFactionTemporary (hostile enough to
+// fight player).
+const FACTION_NEUTRAL = 189;
+// Cite: stormwind_city.cpp:105 FACTION_FRIENDLY_TO_ALL = 35 Dashel low-HP surrender faction (not
+// accept-hook — FO6 fight end).
+const FACTION_FRIENDLY_TO_ALL = 35;
+
+/** 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: stormwind_city.cpp:76 TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_RESTORE_COMBAT_STOP = 0x01 | 0x02 =
+// 0x03
+const BARTLEBY_TEMP_FACTION_FLAGS =
+  TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_RESTORE_COMBAT_STOP;
+
+// Cite: stormwind_city.cpp:94 SAY_PROGRESS_1_DAS = 1961 DoBroadcastText on Dashel accept ("Now you're gonna
+// get it good…").
+const SAY_PROGRESS_1_DAS = 1961;
+/** Cite: stormwind_city.cpp:95 SAY_PROGRESS_2_DAS = 1712 Low-HP surrender line (FO6 fight end). */
+const SAY_PROGRESS_2_DAS = 1712;
+// Cite: stormwind_city.cpp:96–98 SAY_PROGRESS_3_DAS / 4_THU / 5_THU End-event thug dialogue after credit
+// path (FO6).
+const SAY_PROGRESS_3_DAS = 1713;
+// Cite: stormwind_city.cpp:709 SAY_WINDSOR_QUEST_ACCEPT = -1000825 DoStartEscort StartNextDialogueText
+// first line.
+const SAY_WINDSOR_QUEST_ACCEPT = -1000825;
+// Cite: stormwind_city.cpp:710 SAY_WINDSOR_GET_READY = -1000826 Dialogue follow-up after accept (FO6
+// dialogue timer).
+const SAY_WINDSOR_GET_READY = -1000826;
+// Cite: stormwind_city.cpp:507 SAY_WELCOME = -1000824 Squire Rowe intro dialogue — Windsor greets player
+// (FO6 6402 path).
+const SAY_WELCOME = -1000824;
+/** Cite: stormwind_city.cpp:505 SAY_SIGNAL_SENT = -1000822 Rowe WP7 signal (FO6 6402 path). */
+const SAY_SIGNAL_SENT = -1000822;
+
+/** Cite: Unit.h:511 UNIT_NPC_FLAG_QUESTGIVER = 0x00000002 Dashel accept RemoveFlag(UNIT_NPC_FLAGS, …). */
+const UNIT_NPC_FLAG_QUESTGIVER = 0x00000002;
+
+/** Cite: stormwind_city.cpp:110–113 aThugSpawnPosition[0] First Old Town thug summon position on accept. */
+const THUG0_SPAWN = {
+  x: -8687.311,
+  y: 446.7531,
+  z: 100.05593,
+  o: 5.12632,
+} as const;
+/** Cite: stormwind_city.cpp:110–113 aThugSpawnPosition[1] */
+const THUG1_SPAWN = {
+  x: -8669.205,
+  y: 448.4405,
+  z: 99.74935,
+  o: 3.75387,
+} as const;
+// Cite: stormwind_city.cpp:427 TEMPSPAWN_TIMED_OOC_OR_DEAD_DESPAWN, 120000 SummonCreature despawn delay for
+// both thugs.
+const THUG_DESPAWN_MS = 120000;
+// Cite: stormwind_city.cpp:202 ResetTimer(DASHEL_START_EVENT, 2000) Delay before Dashel AttackStart after
+// accept.
+const DASHEL_START_EVENT_MS = 2000;
+// Cite: stormwind_city.cpp:374 GetHealthPercent() <= 20.f Low-HP threshold that awards fight end / explore
+// path (FO6).
+const DASHEL_LOW_HP_PCT = 20;
+// Cite: stormwind_city.cpp:60 (GetHealth - damage) * 100 / MaxHealth < 15 Bartleby DamageTaken explore
+// credit threshold (FO6 fight).
+const BARTLEBY_CREDIT_HP_PCT = 15;
+
+// QuestAccept_npc_bartleby — quest 1640 Beat Bartleby: turn him hostile and attack; taking him
+// under 15% health credits the quest and evades. Cite: stormwind_city.cpp:72–79, :58–68.
+function runBartlebyAccept(): DbScriptIntent[] {
+  const citeFaction =
+    `stormwind_city.cpp:76 npc_bartleby (${NPC_BARTLEBY}) ` +
+    `SetFactionTemporary(FACTION_ENEMY=${FACTION_ENEMY}, ` +
+    'TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_RESTORE_COMBAT_STOP)';
+  const citeAttack =
+    `stormwind_city.cpp:77 AI()->AttackStart(player)`;
+  const citeCredit =
+    `stormwind_city.cpp:60–65 DamageTaken HP<${BARTLEBY_CREDIT_HP_PCT}% ` +
+    `AreaExploredOrEventHappens(${QUEST_BEAT}) + EnterEvadeMode - FO6 finishEscort`;
+  return [
+    {
+      kind: 'set_faction',
+      factionId: FACTION_ENEMY,
+      flags: BARTLEBY_TEMP_FACTION_FLAGS,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'attack_start',
+      canAttack: true,
+      cite: citeAttack,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `DamageTaken HP<${BARTLEBY_CREDIT_HP_PCT}% AreaExploredOrEventHappens(${QUEST_BEAT}) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+  ];
+}
+
+// QuestAccept_npc_dashel_stonefist — quest 1447 The Missing Diplomat pt8: talk, go neutral, strip
+// QUESTGIVER and summon two thugs; his surrender at 20% credits. Cite: stormwind_city.cpp:413–447.
+function runDashelStonefistAccept(): DbScriptIntent[] {
+  const citeTalk =
+    `stormwind_city.cpp:421 npc_dashel_stonefist (${NPC_DASHEL_STONEFIST}) ` +
+    `DoBroadcastText(SAY_PROGRESS_1_DAS=${SAY_PROGRESS_1_DAS})`;
+  const citeFaction =
+    `stormwind_city.cpp:422 SetFactionTemporary(FACTION_NEUTRAL=${FACTION_NEUTRAL}, TEMPFACTION_RESTORE_RESPAWN)`;
+  const citeQg =
+    'stormwind_city.cpp:423 RemoveFlag(UNIT_NPC_FLAGS, UNIT_NPC_FLAG_QUESTGIVER)';
+  const citeReact =
+    'stormwind_city.cpp:424 SetReactState(REACT_AGGRESSIVE) - host AI FO6';
+  const citeThug0 =
+    `stormwind_city.cpp:427–431 SummonCreature(NPC_OLD_TOWN_THUG=${NPC_OLD_TOWN_THUG}, ` +
+    `pos0, TEMPSPAWN_TIMED_OOC_OR_DEAD_DESPAWN, ${THUG_DESPAWN_MS}) + MovePoint + RemoveFlag IMMUNE_TO_NPC`;
+  const citeThug1 =
+    `stormwind_city.cpp:435–439 SummonCreature(NPC_OLD_TOWN_THUG=${NPC_OLD_TOWN_THUG}, ` +
+    `pos1, TEMPSPAWN_TIMED_OOC_OR_DEAD_DESPAWN, ${THUG_DESPAWN_MS}) + MovePoint + RemoveFlag IMMUNE_TO_NPC`;
+  const citeStart =
+    `stormwind_city.cpp:198–203 StartEvent ResetTimer(DASHEL_START_EVENT, ${DASHEL_START_EVENT_MS}) then AttackStart - FO6`;
+  const citeSurrender =
+    `stormwind_city.cpp:374–397 HP<=${DASHEL_LOW_HP_PCT}% DoBroadcastText(SAY_PROGRESS_2_DAS=${SAY_PROGRESS_2_DAS}) + ` +
+    `SetFactionTemporary(FACTION_FRIENDLY_TO_ALL=${FACTION_FRIENDLY_TO_ALL}) - FO6 fight end`;
+  const citeCredit =
+    `stormwind_city.cpp:315–317 AreaExploredOrEventHappens(${QUEST_MISSING_DIPLO_PT8}) + ` +
+    `SAY_PROGRESS_3_DAS=${SAY_PROGRESS_3_DAS} thug stand-down - FO6 finishEscort`;
+  const prior = UNIT_NPC_FLAG_QUESTGIVER;
+  const resultFlags = prior & ~UNIT_NPC_FLAG_QUESTGIVER;
+  return [
+    {
+      kind: 'talk',
+      textId: SAY_PROGRESS_1_DAS,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'set_faction',
+      factionId: FACTION_NEUTRAL,
+      flags: TEMPFACTION_RESTORE_RESPAWN,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'modify_npc_flags',
+      flag: UNIT_NPC_FLAG_QUESTGIVER,
+      changeFlag: NPC_FLAG_CHANGE_REMOVE,
+      mode: 'remove',
+      resultFlags,
+      cite: citeQg,
+    },
+    {
+      kind: 'skip',
+      reason: 'SetReactState(REACT_AGGRESSIVE) - host AI FO6',
+      cite: citeReact,
+    },
+    {
+      kind: 'temp_spawn_creature',
+      creatureEntry: NPC_OLD_TOWN_THUG,
+      x: THUG0_SPAWN.x,
+      y: THUG0_SPAWN.y,
+      z: THUG0_SPAWN.z,
+      o: THUG0_SPAWN.o,
+      despawnDelay: THUG_DESPAWN_MS,
+      pathId: 0,
+      setRun: false,
+      summonActive: false,
+      spawnDataEntry: 0,
+      spawnType: TEMPSPAWN_TIMED_OOC_OR_DEAD_DESPAWN,
+      cite: citeThug0,
+    },
+    {
+      kind: 'temp_spawn_creature',
+      creatureEntry: NPC_OLD_TOWN_THUG,
+      x: THUG1_SPAWN.x,
+      y: THUG1_SPAWN.y,
+      z: THUG1_SPAWN.z,
+      o: THUG1_SPAWN.o,
+      despawnDelay: THUG_DESPAWN_MS,
+      pathId: 0,
+      setRun: false,
+      summonActive: false,
+      spawnDataEntry: 0,
+      spawnType: TEMPSPAWN_TIMED_OOC_OR_DEAD_DESPAWN,
+      cite: citeThug1,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `thug MovePoint + RemoveFlag IMMUNE_TO_NPC + StartEvent ${DASHEL_START_EVENT_MS}ms AttackStart - FO6 combat`,
+      cite: citeStart,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `HP<=${DASHEL_LOW_HP_PCT}% surrender SAY_PROGRESS_2_DAS (${SAY_PROGRESS_2_DAS}) + FACTION_FRIENDLY_TO_ALL (${FACTION_FRIENDLY_TO_ALL}) - FO6`,
+      cite: citeSurrender,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `AreaExploredOrEventHappens(${QUEST_MISSING_DIPLO_PT8}) + SAY_PROGRESS_3_DAS (${SAY_PROGRESS_3_DAS}) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+  ];
+}
+
+// QuestAccept_npc_reginald_windsor — quest 6403 The Great Masquerade: the accept talk starts the
+// city escort, and the keep reveal carries the explore credit. Cite: stormwind_city.cpp:1273–1281.
+function runReginaldWindsorAccept(): DbScriptIntent[] {
+  const citeAccept =
+    `stormwind_city.cpp:1275–1278 npc_reginald_windsor (${NPC_WINDSOR}) ` +
+    'DoStartEscort(player)';
+  const citeTalk =
+    `stormwind_city.cpp:1214 DoStartEscort StartNextDialogueText(SAY_WINDSOR_QUEST_ACCEPT=${SAY_WINDSOR_QUEST_ACCEPT})`;
+  const citeDlg =
+    `stormwind_city.cpp:802–804 dialogue SAY_WINDSOR_GET_READY=${SAY_WINDSOR_GET_READY} + Prestor sieze - FO6 dialogue`;
+  const citeEscort =
+    'stormwind_city.cpp:920–1177 masquerade escort + keep dialogue (Jonathan/Bolvar/Prestor) - FO6 escort';
+  const citeCredit =
+    `stormwind_city.cpp:1173–1177 RewardPlayerAndGroupAtEventExplored(${QUEST_THE_GREAT_MASQUERADE}) - FO6 finishEscort`;
+  const citeTurnIn =
+    `stormwind_city.cpp ender Highlord Bolvar Fordragon (${NPC_BOLVAR}) after explore credit`;
+  return [
+    {
+      kind: 'talk',
+      textId: SAY_WINDSOR_QUEST_ACCEPT,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `DoStartEscort on npc_reginald_windsor (${NPC_WINDSOR}) - FO6 degraded escort`,
+      cite: citeAccept,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `dialogue SAY_WINDSOR_GET_READY (${SAY_WINDSOR_GET_READY}) + Prestor line - FO6`,
+      cite: citeDlg,
+    },
+    {
+      kind: 'skip',
+      reason:
+        'masquerade city escort + keep reveal (Jonathan/Bolvar/Prestor) - FO6 escort',
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `RewardPlayerAndGroupAtEventExplored(${QUEST_THE_GREAT_MASQUERADE}) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `turn-in to Bolvar (${NPC_BOLVAR}) after explore credit - host turnIn`,
+      cite: citeTurnIn,
+    },
+  ];
+}
+
+// Quest 6402 Stormwind Rendezvous has no accept hook. The related residual is Squire Rowe's
+// gossip, which escorts in and summons Windsor as the ender. Cite: stormwind_city.cpp:663–700.
+function runStormwindRendezvousAccept(): DbScriptIntent[] {
+  const citeGossip =
+    `stormwind_city.cpp:663–687 GossipHello_npc_squire_rowe (${NPC_SQUIRE_ROWE}) ` +
+    `gates on QUEST_STORMWIND_RENDEZVOUS=${QUEST_STORMWIND_RENDEZVOUS} / MASQUERADE=${QUEST_THE_GREAT_MASQUERADE}`;
+  const citeStart =
+    `stormwind_city.cpp:690–698 GossipSelect Start(true, player) escort - FO6`;
+  const citeSummon =
+    `stormwind_city.cpp:594 SummonCreature(NPC_WINDSOR=${NPC_WINDSOR}) + WP7 SAY_SIGNAL_SENT=${SAY_SIGNAL_SENT} - FO6`;
+  const citeWelcome =
+    `stormwind_city.cpp:635 DoScriptText(SAY_WELCOME=${SAY_WELCOME}) + SetFlag QUESTGIVER - FO6 ender ready`;
+  const citeStarter =
+    `bake starter Marshal Maxwell (${NPC_MARSHAL_MAXWELL}) → ender Reginald Windsor (${NPC_WINDSOR})`;
+  return [
+    {
+      kind: 'skip',
+      reason:
+        `no pQuestAcceptNPC for ${QUEST_STORMWIND_RENDEZVOUS}; Squire Rowe (${NPC_SQUIRE_ROWE}) gossip FO6 summons Windsor`,
+      cite: citeGossip,
+    },
+    {
+      kind: 'skip',
+      reason: 'Squire Rowe GossipSelect Start(true, player) escort - FO6',
+      cite: citeStart,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `SummonCreature Windsor (${NPC_WINDSOR}) + SAY_SIGNAL_SENT (${SAY_SIGNAL_SENT}) - FO6`,
+      cite: citeSummon,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `SAY_WELCOME (${SAY_WELCOME}) + QUESTGIVER on Windsor for turn-in - FO6`,
+      cite: citeWelcome,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `Maxwell (${NPC_MARSHAL_MAXWELL}) → Windsor (${NPC_WINDSOR}) turn-in chain`,
+      cite: citeStarter,
+    },
+  ];
+}
+
+// Family pack: eastern_kingdoms/stormwind_city.cpp Hooks: pQuestAcceptNPC bartleby (1640), dashel (1447),
+// reginald (6403); related residual squire_rowe gossip for 6402.
+export function runStormwindCity(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase !== 'accept') return [];
+  if (questId === QUEST_BEAT) return runBartlebyAccept();
+  if (questId === QUEST_MISSING_DIPLO_PT8) return runDashelStonefistAccept();
+  if (questId === QUEST_THE_GREAT_MASQUERADE) return runReginaldWindsorAccept();
+  if (questId === QUEST_STORMWIND_RENDEZVOUS) return runStormwindRendezvousAccept();
+  return [];
+}

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

@@ -0,0 +1,115 @@
+// QI4 — eastern_kingdoms/stranglethorn_vale residual, extracted for the 1500-line ratchet. Only
+// the mob_yenniku SpellHit for quest 592; there is no accept hook. Cite: stranglethorn_vale.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: stranglethorn_vale.cpp:42 QUEST_ID_SAVING_YENNIKU = 592 Saving Yenniku — stun Yenniku with the Soul
+// Gem, fill it, return to Nimboya.
+export const QUEST_SAVING_YENNIKU = 592;
+// Cite: stranglethorn_vale.cpp:40 SPELL_YENNIKUS_RELEASE = 3607 Soul Gem (item 3912) spell that hits
+// Yenniku while 592 is incomplete.
+const SPELL_YENNIKUS_RELEASE = 3607;
+// Cite: stranglethorn_vale.cpp:44 FACTION_ID_HORDE_GENERIC = 83 Temporary faction after SpellHit
+// EnterEvadeMode (comment: may not be correct).
+const FACTION_ID_HORDE_GENERIC = 83;
+// Cite: Creature.h:579 TEMPFACTION_RESTORE_REACH_HOME = 0x04 SetFactionTemporary flags on Yenniku after
+// release.
+const TEMPFACTION_RESTORE_REACH_HOME = 0x04;
+// Cite: SharedDefines.h:795 EMOTE_STATE_STUN = 64 HandleEmote on EnterEvadeMode while reset timer is
+// active.
+const EMOTE_STATE_STUN = 64;
+// Cite: stranglethorn_vale.cpp:61 m_uiResetTimer = 60000 Duration (ms) of stun/faction window before
+// EMOTE_STATE_NONE + re-evade.
+const YENNIKU_RESET_TIMER_MS = 60000;
+// Cite: classic-db / ACID acid_classic.sql "Yenniku 2530 - mob_yenniku" Creature entry for ScriptName
+// mob_yenniku.
+const NPC_YENNIKU = 2530;
+// Cite: classic-db item_template 3912 Soul Gem (spell 3607); 3913 Filled Soul Gem Objective item for quest
+// 592 (ReqItemId1=3913).
+const ITEM_SOUL_GEM = 3912;
+const ITEM_FILLED_SOUL_GEM = 3913;
+
+// mob_yenniku SpellHit — quest 592 Saving Yenniku: the Soul Gem release evades him into a stunned
+// Horde-faction state for 60 s. Cite: stranglethorn_vale.cpp:55–96. The bake lacks quest 592.
+function runYennikuSpellHit(): DbScriptIntent[] {
+  const citeSpell =
+    `stranglethorn_vale.cpp:55–65 mob_yenniku (${NPC_YENNIKU}) SpellHit(` +
+    `SPELL_YENNIKUS_RELEASE=${SPELL_YENNIKUS_RELEASE}) incomplete quest 592`;
+  const citeTimer =
+    `stranglethorn_vale.cpp:61 m_uiResetTimer=${YENNIKU_RESET_TIMER_MS}; EnterEvadeMode()`;
+  const citeEvade =
+    'stranglethorn_vale.cpp:71–75 RemoveAllAurasOnEvade + CombatStop + LoadCreatureAddon + SetLootRecipient - host FO6';
+  const citeEmote =
+    `stranglethorn_vale.cpp:77 HandleEmote(EMOTE_STATE_STUN=${EMOTE_STATE_STUN})`;
+  const citeFaction =
+    `stranglethorn_vale.cpp:78 SetFactionTemporary(FACTION_ID_HORDE_GENERIC=${FACTION_ID_HORDE_GENERIC}, ` +
+    `TEMPFACTION_RESTORE_REACH_HOME=${TEMPFACTION_RESTORE_REACH_HOME})`;
+  const citeReset =
+    `stranglethorn_vale.cpp:88–92 UpdateAI after ${YENNIKU_RESET_TIMER_MS}ms ` +
+    'EMOTE_STATE_NONE + EnterEvadeMode restore - FO6 timer';
+  const citeItem =
+    `classic-db quest 592 ReqItemId1=${ITEM_FILLED_SOUL_GEM} from Soul Gem ${ITEM_SOUL_GEM} spell ${SPELL_YENNIKUS_RELEASE} - host item grant`;
+  return [
+    {
+      kind: 'skip',
+      reason:
+        `SpellHit SPELL_YENNIKUS_RELEASE (${SPELL_YENNIKUS_RELEASE}) on npc_yenniku (${NPC_YENNIKU}) with incomplete 592`,
+      cite: citeSpell,
+    },
+    {
+      kind: 'skip',
+      reason: `m_uiResetTimer=${YENNIKU_RESET_TIMER_MS} then EnterEvadeMode - FO6 timer start`,
+      cite: citeTimer,
+    },
+    {
+      kind: 'skip',
+      reason:
+        'RemoveAllAurasOnEvade + CombatStop + LoadCreatureAddon + clear loot recipient - host FO6',
+      cite: citeEvade,
+    },
+    {
+      kind: 'emote',
+      emoteId: EMOTE_STATE_STUN,
+      cite: citeEmote,
+    },
+    {
+      kind: 'set_faction',
+      factionId: FACTION_ID_HORDE_GENERIC,
+      flags: TEMPFACTION_RESTORE_REACH_HOME,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `timer ${YENNIKU_RESET_TIMER_MS}ms EMOTE_STATE_NONE + re-evade (TEMPFACTION_RESTORE_REACH_HOME) - FO6`,
+      cite: citeReset,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `Filled Soul Gem (${ITEM_FILLED_SOUL_GEM}) from spell/item host - not AI residual`,
+      cite: citeItem,
+    },
+  ];
+}
+
+// Family pack: eastern_kingdoms/stranglethorn_vale.cpp Residual: mob_yenniku SpellHit for quest 592
+// (frame/complete). No accept/reward NPC hooks in this file.
+export function runStranglethornVale(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (
+    (phase === 'frame' || phase === 'complete') &&
+    questId === QUEST_SAVING_YENNIKU
+  ) {
+    return runYennikuSpellHit();
+  }
+  return [];
+}

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

@@ -0,0 +1,146 @@
+// QI4 — stratholmeScripts residual, extracted for the 1500-line ratchet: the Aurius reward hook
+// for 5122 and the restless-soul kill credit for 5282. Cite: stratholme/stratholmeScripts.cpp.
+
+import type { DbScriptIntent } from './types.ts';
+import { NPC_FLAG_CHANGE_REMOVE } from './opcodes.ts';
+
+/** Matches registry.ts QuestScriptHook — local to avoid circular import. */
+type QuestScriptHook = 'accept' | 'reward' | 'complete' | 'frame';
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+// Cite: stratholme.h:76 QUEST_MEDALLION_FAITH = 5122 Turn-in of the Medallion of Faith at Aurius (chapel)
+// arms the Baron ally event.
+export const QUEST_MEDALLION_FAITH = 5122;
+// Cite: stratholmeScripts.cpp:139 QUEST_RESTLESS_SOUL = 5282 The Restless Souls — free 15 Restless Souls
+// with Egan's Blaster.
+export const QUEST_RESTLESS_SOUL = 5282;
+// Cite: stratholme.h:21 TYPE_AURIUS = 7 Instance encounter slot set DONE when Medallion of Faith is
+// rewarded.
+const TYPE_AURIUS = 7;
+/** Cite: sc_instance.h:17 DONE = 3 EncounterState written by SetData(TYPE_AURIUS, DONE). */
+const ENCOUNTER_DONE = 3;
+/** Cite: stratholme.h:48 NPC_AURIUS = 10917 Quest giver for 5122 / 5125; script name npc_aurius. */
+const NPC_AURIUS = 10917;
+// Cite: Unit.h:511 UNIT_NPC_FLAG_QUESTGIVER = 0x00000002 Removed on Aurius when TYPE_AURIUS becomes DONE
+// (SetData special).
+const UNIT_NPC_FLAG_QUESTGIVER = 0x00000002;
+// Cite: stratholmeScripts.cpp:145 NPC_RESTLESS_SOUL = 11122 Kill-credit entry for
+// RewardPlayerAndGroupAtEventCredit after blaster tag.
+const NPC_RESTLESS_SOUL = 11122;
+/** Cite: stratholmeScripts.cpp:146 NPC_FREED_SOUL = 11136 UpdateEntry target after the 1s die timer. */
+const NPC_FREED_SOUL = 11136;
+// Cite: stratholmeScripts.cpp:141 SPELL_EGAN_BLASTER = 17368 Item spell (Egan's Blaster 13289) that tags
+// Restless Souls while 5282 incomplete.
+const SPELL_EGAN_BLASTER = 17368;
+// Cite: stratholmeScripts.cpp:161 m_uiDieTimer = 1000 Delay (ms) from blaster tag to UpdateEntry + kill
+// credit.
+const RESTLESS_DIE_TIMER_MS = 1000;
+/** Cite: stratholmeScripts.cpp:187 ForcedDespawn(60000) Despawn delay (ms) after the soul is freed. */
+const FREED_SOUL_DESPAWN_MS = 60000;
+
+// QuestRewarded_npc_aurius — quest 5122 The Medallion of Faith: sets TYPE_AURIUS DONE, which
+// strips his QUESTGIVER flag and arms him as a Baron ally. Cite: stratholmeScripts.cpp:316–329.
+function runAuriusReward(): DbScriptIntent[] {
+  const citeSet =
+    'stratholmeScripts.cpp:326–327 SetData(TYPE_AURIUS, DONE) for QUEST_MEDALLION_FAITH';
+  const citeFlag =
+    'stratholme.cpp:478–480 TYPE_AURIUS DONE RemoveFlag(UNIT_NPC_FLAG_QUESTGIVER) on Aurius';
+  const citeBaron =
+    'stratholme.cpp:356–358,1109–1135 TYPE_AURIUS DONE → auriusSummonTimer 5s on Baron engage - instance FO6';
+  // Prior: typical questgiver QUESTGIVER only for this residual strip path.
+  const prior = UNIT_NPC_FLAG_QUESTGIVER;
+  const resultFlags = prior & ~UNIT_NPC_FLAG_QUESTGIVER;
+  return [
+    {
+      kind: 'set_instance_data',
+      type: TYPE_AURIUS,
+      data: ENCOUNTER_DONE,
+      cite: citeSet,
+    },
+    {
+      kind: 'modify_npc_flags',
+      flag: UNIT_NPC_FLAG_QUESTGIVER,
+      changeFlag: NPC_FLAG_CHANGE_REMOVE,
+      mode: 'remove',
+      resultFlags,
+      cite: citeFlag,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `npc_aurius (${NPC_AURIUS}) Baron-ally summon after TYPE_AURIUS DONE - instance FO6`,
+      cite: citeBaron,
+    },
+  ];
+}
+
+// mob_restless_soul SpellHit — quest 5282 The Restless Souls: Egan's Blaster tags the soul, and a
+// second later it frees, despawns and credits 11122. Cite: stratholmeScripts.cpp:165–198.
+function runRestlessSoulCredit(): DbScriptIntent[] {
+  const citeSpell =
+    `stratholmeScripts.cpp:165–174 SpellHit SPELL_EGAN_BLASTER=${SPELL_EGAN_BLASTER} incomplete ${QUEST_RESTLESS_SOUL}`;
+  const citeTimer =
+    `stratholmeScripts.cpp:161,183–186 m_uiDieTimer=${RESTLESS_DIE_TIMER_MS} then transform`;
+  const citeEntry =
+    `stratholmeScripts.cpp:186 UpdateEntry(NPC_FREED_SOUL=${NPC_FREED_SOUL})`;
+  const citeDespawn =
+    `stratholmeScripts.cpp:187 ForcedDespawn(${FREED_SOUL_DESPAWN_MS})`;
+  const citeTalk =
+    'stratholmeScripts.cpp:188–195 urand SAY_ZAPPED0–3 - FO6 random talk';
+  const citeCredit =
+    `stratholmeScripts.cpp:196–197 RewardPlayerAndGroupAtEventCredit(NPC_RESTLESS_SOUL=${NPC_RESTLESS_SOUL})`;
+  return [
+    {
+      kind: 'skip',
+      reason:
+        `SpellHit SPELL_EGAN_BLASTER (${SPELL_EGAN_BLASTER}) on Restless Soul with incomplete 5282`,
+      cite: citeSpell,
+    },
+    {
+      kind: 'skip',
+      reason: `m_uiDieTimer=${RESTLESS_DIE_TIMER_MS}ms then UpdateEntry/credit - FO6 timer`,
+      cite: citeTimer,
+    },
+    {
+      kind: 'update_template',
+      oldEntry: NPC_RESTLESS_SOUL,
+      newTemplate: NPC_FREED_SOUL,
+      changed: true,
+      cite: citeEntry,
+    },
+    {
+      kind: 'despawn_self',
+      despawnDelay: FREED_SOUL_DESPAWN_MS,
+      cite: citeDespawn,
+    },
+    {
+      kind: 'skip',
+      reason: 'optional DoScriptText SAY_ZAPPED0–3 via urand(0,6) - FO6 random',
+      cite: citeTalk,
+    },
+    {
+      kind: 'kill_credit',
+      creatureEntry: NPC_RESTLESS_SOUL,
+      cite: citeCredit,
+    },
+  ];
+}
+
+// Family pack: stratholme/stratholmeScripts.cpp. The Aurius reward hook for 5122, plus the
+// restless-soul kill credit for 5282 as a residual.
+export function runStratholmeScripts(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase === 'reward' && questId === QUEST_MEDALLION_FAITH) {
+    return runAuriusReward();
+  }
+  if (
+    (phase === 'frame' || phase === 'complete') &&
+    questId === QUEST_RESTLESS_SOUL
+  ) {
+    return runRestlessSoulCredit();
+  }
+  return [];
+}