azeroth-shell 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,149 @@
+// QI4 — sunken_templeScripts residual, extracted for the 1500-line ratchet: the Shade of Eranikus
+// areatrigger, gated on quest 8555 being rewarded. Cite: sunken_temple/sunken_templeScripts.cpp.
+
+import type { DbScriptIntent } from './types.ts';
+import { TEMPSPAWN_DEAD_DESPAWN } from './opcodes.ts';
+
+/** Matches registry.ts QuestScriptHook — local to avoid circular import. */
+type QuestScriptHook = 'accept' | 'reward' | 'complete' | 'frame';
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+// Cite: sunken_templeScripts.cpp:40 QUEST_THE_CHARGE_OF_DRAGONFLIGHTS = 8555 — the pre-quest gate
+// for the Shade of Eranikus trigger. The bake has Anachronos 15192 on both ends, prevQuest 8519.
+export const QUEST_THE_CHARGE_OF_DRAGONFLIGHTS = 8555;
+// Cite: sunken_templeScripts.cpp:41 QUEST_ERANIKUS_TYRANT_OF_DREAMS = 8733, accepted from Malfurion
+// after the summon. Not in the Phonecraft bake — kept for whole-chain mapping only.
+const QUEST_ERANIKUS_TYRANT_OF_DREAMS = 8733;
+// Cite: sunken_temple.h:17 TYPE_MALFURION = 3 Instance encounter slot set IN_PROGRESS when Malfurion is
+// summoned.
+const TYPE_MALFURION = 3;
+// Cite: sc_instance.h:15 IN_PROGRESS = 1 EncounterState written by SetData(TYPE_MALFURION, IN_PROGRESS).
+const ENCOUNTER_IN_PROGRESS = 1;
+// Cite: sunken_temple.h:42 NPC_MALFURION = 15362 Summoned by AreaTrigger_at_shade_of_eranikus when 8555 is
+// rewarded.
+const NPC_MALFURION = 15362;
+// Cite: sunken_temple.h:99–104 aSunkenTempleLocation[2] Malfurion summon loc { -660.5277f, -16.7117f,
+// -90.8357f, 1.6055f }
+const MALFURION_SPAWN = {
+  x: -660.5277,
+  y: -16.7117,
+  z: -90.8357,
+  o: 1.6055,
+} as const;
+// Cite: sunken_templeScripts.cpp:55 — SummonCreature(NPC_MALFURION, …, TEMPSPAWN_DEAD_DESPAWN, 0),
+// which opcodes.ts spells TEMPSPAWN_DEAD_DESPAWN = 1 (Object.h:44).
+const MALFURION_SPAWN_TYPE = TEMPSPAWN_DEAD_DESPAWN;
+// Cite: sunken_temple.h:76 SPELL_SPIRIT_SPAWN_IN = 17321 npc_malfurionAI ctor DoCastSpellIfCan on spawn.
+const SPELL_SPIRIT_SPAWN_IN = 17321;
+/** Cite: sunken_templeScripts.cpp:69 EMOTE_MALFURION1 = -1109000 DoScriptText on dungeon spawn (ctor). */
+const EMOTE_MALFURION1 = -1109000;
+// Cite: sunken_templeScripts.cpp:70–73 SAY_MALFURION1–4 Speech sequence before SetFlag QUESTGIVER (UpdateAI
+// cases 1–4).
+const SAY_MALFURION1 = -1109001;
+const SAY_MALFURION2 = -1109002;
+const SAY_MALFURION3 = -1109003;
+const SAY_MALFURION4 = -1109004;
+// Cite: Unit.h:511 UNIT_NPC_FLAG_QUESTGIVER = 0x00000002 Ctor removes QUESTGIVER; speech case 5 restores it
+// so 8733 can be accepted.
+const UNIT_NPC_FLAG_QUESTGIVER = 0x00000002;
+
+// AreaTrigger_at_shade_of_eranikus — with 8555 rewarded, 8733 not, and TYPE_MALFURION idle, summon
+// Malfurion and mark it IN_PROGRESS; his speech then flags him a questgiver. Cite: :44–61, :78–143.
+function runShadeOfEranikusAt(): DbScriptIntent[] {
+  const citeAt =
+    'sunken_templeScripts.cpp:44–61 AreaTrigger_at_shade_of_eranikus ' +
+    `GetQuestRewardStatus(${QUEST_THE_CHARGE_OF_DRAGONFLIGHTS}) gate`;
+  const citeSpawn =
+    `sunken_templeScripts.cpp:55 SummonCreature(NPC_MALFURION=${NPC_MALFURION}, ` +
+    `aSunkenTempleLocation[2]=(${MALFURION_SPAWN.x},${MALFURION_SPAWN.y},${MALFURION_SPAWN.z},${MALFURION_SPAWN.o}), ` +
+    `TEMPSPAWN_DEAD_DESPAWN, 0)`;
+  const citeSet =
+    `sunken_templeScripts.cpp:56 SetData(TYPE_MALFURION=${TYPE_MALFURION}, IN_PROGRESS=${ENCOUNTER_IN_PROGRESS})`;
+  const citeCtor =
+    `sunken_templeScripts.cpp:86–92 npc_malfurionAI ctor: DoScriptText(EMOTE_MALFURION1=${EMOTE_MALFURION1}) ` +
+    `+ DoCastSpellIfCan(SPELL_SPIRIT_SPAWN_IN=${SPELL_SPIRIT_SPAWN_IN}) + RemoveFlag(QUESTGIVER)`;
+  const citeSpeech =
+    `sunken_templeScripts.cpp:98–143 UpdateAI speech 0–5 SAY_MALFURION1–4 ` +
+    `(${SAY_MALFURION1}…${SAY_MALFURION4}) then SetFlag(UNIT_NPC_FLAG_QUESTGIVER) - FO6 timer`;
+  const citeFollowUp =
+    `sunken_templeScripts.cpp:41 QUEST_ERANIKUS_TYRANT_OF_DREAMS=${QUEST_ERANIKUS_TYRANT_OF_DREAMS} ` +
+    'accept from Malfurion after speech - bake gap FO6';
+  return [
+    {
+      kind: 'skip',
+      reason:
+        `AT Shade of Eranikus requires rewarded ${QUEST_THE_CHARGE_OF_DRAGONFLIGHTS} ` +
+        `and incomplete/unrewarded ${QUEST_ERANIKUS_TYRANT_OF_DREAMS} + TYPE_MALFURION != IN_PROGRESS`,
+      cite: citeAt,
+    },
+    {
+      kind: 'temp_spawn_creature',
+      creatureEntry: NPC_MALFURION,
+      x: MALFURION_SPAWN.x,
+      y: MALFURION_SPAWN.y,
+      z: MALFURION_SPAWN.z,
+      o: MALFURION_SPAWN.o,
+      despawnDelay: 0,
+      pathId: 0,
+      setRun: false,
+      summonActive: false,
+      spawnDataEntry: 0,
+      spawnType: MALFURION_SPAWN_TYPE,
+      cite: citeSpawn,
+    },
+    {
+      kind: 'set_instance_data',
+      type: TYPE_MALFURION,
+      data: ENCOUNTER_IN_PROGRESS,
+      cite: citeSet,
+    },
+    {
+      kind: 'cast_spell',
+      spellId: SPELL_SPIRIT_SPAWN_IN,
+      castFlags: 0,
+      sourceIsGo: false,
+      targetCleared: false,
+      cite: citeCtor,
+    },
+    {
+      kind: 'talk',
+      textId: EMOTE_MALFURION1,
+      stringTemplateId: 0,
+      cite: citeCtor,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `npc_malfurionAI ctor RemoveFlag(UNIT_NPC_FLAG_QUESTGIVER=${UNIT_NPC_FLAG_QUESTGIVER}) on summon - host NPC flags`,
+      cite: citeCtor,
+    },
+    {
+      kind: 'skip',
+      reason:
+        'Malfurion speech timers (bow + SAY1–4) then SetFlag QUESTGIVER - FO6 timed AI',
+      cite: citeSpeech,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `follow-up accept QUEST_ERANIKUS_TYRANT_OF_DREAMS (${QUEST_ERANIKUS_TYRANT_OF_DREAMS}) from Malfurion - bake gap FO6`,
+      cite: citeFollowUp,
+    },
+  ];
+}
+
+// Family pack: sunken_temple/sunken_templeScripts.cpp. Only the Shade of Eranikus areatrigger,
+// gated on 8555 being rewarded — this file has no accept or reward hook.
+export function runSunkenTempleScripts(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (
+    (phase === 'frame' || phase === 'complete') &&
+    questId === QUEST_THE_CHARGE_OF_DRAGONFLIGHTS
+  ) {
+    return runShadeOfEranikusAt();
+  }
+  return [];
+}

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

@@ -0,0 +1,163 @@
+// QI4 — eastern_kingdoms/swamp_of_sorrows residual, extracted for the 1500-line ratchet. It claims
+// the accept hook for quest 1393 only. Cite: eastern_kingdoms/swamp_of_sorrows.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: swamp_of_sorrows.cpp:39 QUEST_GALENS_ESCAPE = 1393 Escort Galen Goodward out of his cage, then open
+// his strongbox camp.
+export const QUEST_GALENS_ESCAPE = 1393;
+// Cite: scriptdev2.sql ScriptName='npc_galen_goodward' WHERE entry=5391; bake starterCreatureEntries for
+// quest 1393.
+const NPC_GALEN_GOODWARD = 5391;
+// Cite: swamp_of_sorrows.cpp:41 GO_GALENS_CAGE = 37118 WaypointStart point 1 opens nearest cage via
+// UseDoorOrButton; WP1 reached resets it.
+const GO_GALENS_CAGE = 37118;
+// Cite: swamp_of_sorrows.cpp:44 SAY_QUEST_ACCEPTED = -1000583 DoScriptText on accept
+// (QuestAccept_npc_galen_goodward).
+const SAY_QUEST_ACCEPTED = -1000583;
+// Cite: swamp_of_sorrows.cpp:43 SAY_PERIODIC = -1000582 UpdateEscortAI when STATE_ESCORT_NONE — idle FO6
+// (not accept-hook).
+const SAY_PERIODIC = -1000582;
+// Cite: swamp_of_sorrows.cpp:45–46 SAY_ATTACKED_1/2 = -1000584 / -1000585 Aggro while escorting — combat
+// FO6 (urand branch not ported as RNG).
+const SAY_ATTACKED_1 = -1000584;
+const SAY_ATTACKED_2 = -1000585;
+// Cite: swamp_of_sorrows.cpp:47 SAY_QUEST_COMPLETE = -1000586 WaypointReached WP21 DoScriptText before
+// explore credit.
+const SAY_QUEST_COMPLETE = -1000586;
+// Cite: swamp_of_sorrows.cpp:48 EMOTE_WHISPER = -1000587 WaypointReached WP21 DoScriptText (strongbox
+// secret whisper).
+const EMOTE_WHISPER = -1000587;
+// Cite: swamp_of_sorrows.cpp:49 EMOTE_DISAPPEAR = -1000588 WaypointReached WP22 DoScriptText before
+// ForcedDespawn at WP23.
+const EMOTE_DISAPPEAR = -1000588;
+// Cite: ScriptDevAIMgr.h:50 FACTION_ESCORT_N_NEUTRAL_ACTIVE = 250 QuestAccept SetFactionTemporary on Galen
+// escort start.
+const FACTION_ESCORT_N_NEUTRAL_ACTIVE = 250;
+/** Cite: Creature.h:577 TEMPFACTION_RESTORE_RESPAWN = 0x01 */
+const TEMPFACTION_RESTORE_RESPAWN = 0x01;
+/** Cite: Creature.h:582 TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x20 */
+const TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x20;
+// Cite: swamp_of_sorrows.cpp:147 TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x01 |
+// 0x20 = 0x21
+const GALEN_TEMP_FACTION_FLAGS =
+  TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC;
+// Cite: swamp_of_sorrows.cpp:61 m_periodicSay = 6000 Idle periodic say interval (ms) while not escorting —
+// FO6 timer.
+const GALEN_PERIODIC_SAY_MS = 6000;
+/** Cite: swamp_of_sorrows.cpp:113 ForcedDespawn(1000) WP23 despawn delay after pause. */
+const GALEN_DESPAWN_MS = 1000;
+// Cite: bake goEnderEntries / classic-db quest 1393 ender Galen's Strongbox (GO 32569) — camp north of
+// Stonard after escort credit.
+const GO_GALENS_STRONGBOX = 32569;
+
+// QuestAccept_npc_galen_goodward — quest 1393 Galen's Escape: temporary faction, the accept line
+// and an escort that opens his cage at WP1; WP21 credits. Cite: swamp_of_sorrows.cpp:139–152.
+function runGalenGoodwardAccept(): DbScriptIntent[] {
+  const citeEscort =
+    `swamp_of_sorrows.cpp:146 npc_galen_goodward (${NPC_GALEN_GOODWARD}) ` +
+    'npc_escortAI::Start(false, player, quest) - FO6 degraded finishEscort';
+  const citeFaction =
+    'swamp_of_sorrows.cpp:147 SetFactionTemporary(FACTION_ESCORT_N_NEUTRAL_ACTIVE, ' +
+    'TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC)';
+  const citeTalk =
+    `swamp_of_sorrows.cpp:148 DoScriptText(SAY_QUEST_ACCEPTED=${SAY_QUEST_ACCEPTED})`;
+  const citeCage =
+    `swamp_of_sorrows.cpp:72–85 WaypointStart WP1 GetClosestGameObjectWithEntry(` +
+    `GO_GALENS_CAGE=${GO_GALENS_CAGE}) UseDoorOrButton; WP1 reached ResetDoorOrButton - FO6 WP`;
+  const citeRun =
+    'swamp_of_sorrows.cpp:97–98 WP20 SetRun(true) - FO6 waypoint';
+  const citeCredit =
+    `swamp_of_sorrows.cpp:100–106 WP21 DoScriptText(SAY_QUEST_COMPLETE=${SAY_QUEST_COMPLETE}) + ` +
+    `DoScriptText(EMOTE_WHISPER=${EMOTE_WHISPER}) + RewardPlayerAndGroupAtEventExplored(1393) - FO6 finishEscort`;
+  const citeDespawn =
+    `swamp_of_sorrows.cpp:108–114 WP22 EMOTE_DISAPPEAR=${EMOTE_DISAPPEAR}; ` +
+    `WP23 SetEscortPaused + ForcedDespawn(${GALEN_DESPAWN_MS}) - FO6 WP`;
+  const citeAggro =
+    `swamp_of_sorrows.cpp:64–67 Aggro while escorting DoScriptText(urand SAY_ATTACKED_1=${SAY_ATTACKED_1} / ` +
+    `SAY_ATTACKED_2=${SAY_ATTACKED_2}) - FO6 combat`;
+  const citePeriodic =
+    `swamp_of_sorrows.cpp:123–128 idle STATE_ESCORT_NONE DoScriptText(SAY_PERIODIC=${SAY_PERIODIC}) ` +
+    `every ${GALEN_PERIODIC_SAY_MS}ms - FO6 idle`;
+  const citeEnder =
+    `bake goEnderEntries GO_GALENS_STRONGBOX=${GO_GALENS_STRONGBOX} after WP21 explore credit`;
+  return [
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(false, player, quest) npc_galen_goodward (${NPC_GALEN_GOODWARD}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'set_faction',
+      factionId: FACTION_ESCORT_N_NEUTRAL_ACTIVE,
+      flags: GALEN_TEMP_FACTION_FLAGS,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'talk',
+      textId: SAY_QUEST_ACCEPTED,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP1 UseDoorOrButton / ResetDoorOrButton GO_GALENS_CAGE (${GO_GALENS_CAGE}) - FO6 waypoint`,
+      cite: citeCage,
+    },
+    {
+      kind: 'skip',
+      reason: 'WP20 SetRun(true) - FO6 waypoint',
+      cite: citeRun,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP21 SAY_QUEST_COMPLETE (${SAY_QUEST_COMPLETE}) + EMOTE_WHISPER (${EMOTE_WHISPER}) + ` +
+        'RewardPlayerAndGroupAtEventExplored(1393) - FO6 finishEscort',
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP22 EMOTE_DISAPPEAR (${EMOTE_DISAPPEAR}) + WP23 ForcedDespawn(${GALEN_DESPAWN_MS}) - FO6`,
+      cite: citeDespawn,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `Aggro SAY_ATTACKED_1/2 (${SAY_ATTACKED_1}/${SAY_ATTACKED_2}) while escorting - FO6 combat`,
+      cite: citeAggro,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `idle SAY_PERIODIC (${SAY_PERIODIC}) every ${GALEN_PERIODIC_SAY_MS}ms - FO6`,
+      cite: citePeriodic,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `turn-in Galen's Strongbox GO (${GO_GALENS_STRONGBOX}) after explore credit - host GO ender`,
+      cite: citeEnder,
+    },
+  ];
+}
+
+// Family pack: eastern_kingdoms/swamp_of_sorrows.cpp Hooks: pQuestAcceptNPC QuestAccept_npc_galen_goodward
+// (1393).
+export function runSwampOfSorrows(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase !== 'accept') return [];
+  if (questId === QUEST_GALENS_ESCAPE) return runGalenGoodwardAccept();
+  return [];
+}

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

@@ -0,0 +1,318 @@
+// QI4 — kalimdor/tanaris residuals, extracted for the 1500-line ratchet. This batch claims the
+// accept hooks for quests 648 and 1560; mob_aquementas is combat residual. Cite: kalimdor/tanaris.cpp.
+
+import type { DbScriptIntent } from './types.ts';
+import { UNIT_STAND_STATE_STAND } from './opcodes.ts';
+
+/** Matches registry.ts QuestScriptHook — local to avoid circular import. */
+type QuestScriptHook = 'accept' | 'reward' | 'complete' | 'frame';
+
+/** Minimal registry entry shape (mirrors registry.ts QuestScriptEntry). */
+export interface TanarisQuestScriptEntry {
+  family?: string;
+  questId?: number;
+  questIds?: number[];
+  hooks?: QuestScriptHook[];
+  run?: (phase: QuestScriptHook, questId: number) => DbScriptIntent[];
+  cite?: string;
+}
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+/** Cite: tanaris.cpp:148 QUEST_RESCUE_OOX_17TN = 648 Escort Homing Robot OOX-17/TN; WP35 explore credit. */
+export const QUEST_RESCUE_OOX_17TN = 648;
+/** Cite: tanaris.cpp:265 QUEST_TOOGA = 1560 FollowerAI Tooga → Torta LOS explore credit. */
+export const QUEST_TOOGA = 1560;
+
+/** Cite: bake starterCreatureEntries quest 648; scriptdev2 npc_oox17tn Homing Robot OOX-17/TN. */
+const NPC_OOX17TN = 7784;
+/** Cite: bake enderCreatureEntries quest 648 — Oglethorpe Obnoticus (7406). */
+const NPC_OGLETHORPE = 7406;
+/** Cite: bake starterCreatureEntries quest 1560; scriptdev2 npc_tooga Tooga. */
+const NPC_TOOGA = 5955;
+/** Cite: tanaris.cpp:266 NPC_TORTA = 6015 Bake enderCreatureEntries quest 1560. */
+const NPC_TORTA = 6015;
+
+/** Cite: tanaris.cpp:150–152 ambush templates. */
+const NPC_SCORPION = 7803;
+const NPC_SCOFFLAW = 7805;
+const NPC_SHADOW_MAGE = 5617;
+
+/** Cite: tanaris.cpp:141–146 OOX script texts (shared line ids with OOX-09/HL / OOX-22/FE). */
+const SAY_OOX_START = -1000287;
+const SAY_OOX_AGGRO1 = -1000288;
+const SAY_OOX_AGGRO2 = -1000289;
+const SAY_OOX_AMBUSH = -1000290;
+const SAY_OOX17_AMBUSH_REPLY = -1000291;
+const SAY_OOX_END = -1000292;
+
+/** Cite: tanaris.cpp:256–263 Tooga / Torta post-event texts. */
+const SAY_TOOG_THIRST = -1000391;
+const SAY_TOOG_WORRIED = -1000392;
+const SAY_TOOG_POST_1 = -1000393;
+const SAY_TORT_POST_2 = -1000394;
+const SAY_TOOG_POST_3 = -1000395;
+const SAY_TORT_POST_4 = -1000396;
+const SAY_TOOG_POST_5 = -1000397;
+const SAY_TORT_POST_6 = -1000398;
+
+/** Cite: ScriptDevAIMgr.h:53 FACTION_ESCORT_N_FRIEND_ACTIVE = 495 OOX SetFactionTemporary on accept. */
+const FACTION_ESCORT_N_FRIEND_ACTIVE = 495;
+/** Cite: ScriptDevAIMgr.h:52 FACTION_ESCORT_N_FRIEND_PASSIVE = 290 Tooga StartFollow faction. */
+const FACTION_ESCORT_N_FRIEND_PASSIVE = 290;
+/** Cite: Creature.h:577 TEMPFACTION_RESTORE_RESPAWN = 0x01 */
+const TEMPFACTION_RESTORE_RESPAWN = 0x01;
+/** Cite: Creature.h:582 TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x20 */
+const TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x20;
+// Cite: tanaris.cpp:242 TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x01 | 0x20 = 0x21
+const OOX_TEMP_FACTION_FLAGS =
+  TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC;
+
+/** Cite: Unit.h:97 UNIT_STAND_STATE_STAND = 0 (opcodes.ts re-export) */
+const UNIT_STAND_STATE_STAND_TANARIS = UNIT_STAND_STATE_STAND;
+/** Cite: Unit.h:104 UNIT_STAND_STATE_DEAD = 7 OOX Reset() while not escorting. */
+const UNIT_STAND_STATE_DEAD = 7;
+
+// Cite: Object.h:45 TEMPSPAWN_CORPSE_TIMED_DESPAWN = 3 WP23/29 SummonCreature
+// TEMPSPAWN_CORPSE_TIMED_DESPAWN.
+const TEMPSPAWN_CORPSE_TIMED_DESPAWN = 3;
+/** Cite: tanaris.cpp:173–175 WP23 scorpion despawn 30000ms */
+const SCORPION_DESPAWN_MS = 30000;
+/** Cite: tanaris.cpp:181 first scofflaw despawn 10000ms */
+const SCOFFLAW_SHORT_DESPAWN_MS = 10000;
+/** Cite: tanaris.cpp:182–184 shadow mage / second scofflaw 30000ms */
+const AMBUSH_DESPAWN_MS = 30000;
+
+/** Cite: tanaris.cpp:173–175 WP23 SummonCreature scorpion positions. */
+const SCORPION_SPAWN = [
+  { entry: NPC_SCORPION, x: -8340.7, y: -4448.17, z: 9.17, o: 3.1 },
+  { entry: NPC_SCORPION, x: -8343.18, y: -4444.35, z: 9.44, o: 2.35 },
+  { entry: NPC_SCORPION, x: -8348.7, y: -4457.8, z: 9.58, o: 2.02 },
+] as const;
+/** Cite: tanaris.cpp:181–184 WP29 SummonCreature positions. */
+const WP29_SPAWN = [
+  { entry: NPC_SCOFFLAW, x: -7488.02, y: -4786.56, z: 10.67, o: 3.74, despawn: SCOFFLAW_SHORT_DESPAWN_MS },
+  { entry: NPC_SHADOW_MAGE, x: -7486.41, y: -4791.55, z: 10.54, o: 3.26, despawn: AMBUSH_DESPAWN_MS },
+  { entry: NPC_SCOFFLAW, x: -7488.47, y: -4800.77, z: 9.77, o: 2.5, despawn: AMBUSH_DESPAWN_MS },
+] as const;
+
+/** Cite: tanaris.cpp:268 POINT_ID_TO_WATER = 1 Post-event MovePoint after dialogue phase 6. */
+const POINT_ID_TO_WATER = 1;
+/** Cite: tanaris.cpp:271 m_afToWaterLoc */
+const TO_WATER_LOC = {
+  x: -7032.664551,
+  y: -4906.199219,
+  z: -1.606446,
+} as const;
+/** Cite: ObjectDefines.h INTERACTION_DISTANCE = 5.0f Tooga MoveInLineOfSight Torta credit range. */
+const INTERACTION_DISTANCE = 5;
+/** Cite: tanaris.cpp:285 m_uiCheckSpeechTimer = 2500 initial; :374 = 5000 after tick */
+const TOGA_SPEECH_TIMER_MS = 2500;
+const TOGA_SPEECH_INTERVAL_MS = 5000;
+/** Cite: tanaris.cpp:286 m_uiPostEventTimer = 1000; :332 = 5000 between phases */
+const TOGA_POST_EVENT_START_MS = 1000;
+const TOGA_POST_EVENT_INTERVAL_MS = 5000;
+
+// ── accept handlers ──────────────────────────────────────────────────────────
+
+// QuestAccept_npc_oox17tn — quest 648 Rescue OOX-17/TN!: talk, stand, temporary friendly faction
+// and escort; two ambushes then the WP35 credit. Cite: tanaris.cpp:235–248, :161–194.
+function runOox17tnAccept(): DbScriptIntent[] {
+  const citeTalk =
+    `tanaris.cpp:239 npc_oox17tn (${NPC_OOX17TN}) DoScriptText(SAY_OOX_START=${SAY_OOX_START})`;
+  const citeActive = 'tanaris.cpp:240 SetActiveObjectState(true)';
+  const citeStand =
+    `tanaris.cpp:241 SetStandState(UNIT_STAND_STATE_STAND) from Reset DEAD=${UNIT_STAND_STATE_DEAD}`;
+  const citeFaction =
+    'tanaris.cpp:242 SetFactionTemporary(FACTION_ESCORT_N_FRIEND_ACTIVE, ' +
+    'TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC)';
+  const citeEscort =
+    `tanaris.cpp:244–245 npc_oox17tn (${NPC_OOX17TN}) ` +
+    'npc_escortAI::Start(false, player, quest) - FO6 degraded finishEscort';
+  const citeWp23 =
+    `tanaris.cpp:171–176 WP23 DoScriptText(SAY_OOX_AMBUSH=${SAY_OOX_AMBUSH}) + ` +
+    `3× SummonCreature(NPC_SCORPION=${NPC_SCORPION} @ ${SCORPION_SPAWN[0].x}/` +
+    `${SCORPION_SPAWN[1].x}/${SCORPION_SPAWN[2].x}) ` +
+    `TEMPSPAWN_CORPSE_TIMED_DESPAWN=${TEMPSPAWN_CORPSE_TIMED_DESPAWN} ${SCORPION_DESPAWN_MS}ms - FO6`;
+  const citeWp29 =
+    `tanaris.cpp:178–187 WP29 SAY_OOX_AMBUSH=${SAY_OOX_AMBUSH} + ` +
+    `NPC_SCOFFLAW=${NPC_SCOFFLAW} @ ${WP29_SPAWN[0].x} ${SCOFFLAW_SHORT_DESPAWN_MS}ms + ` +
+    `NPC_SHADOW_MAGE=${NPC_SHADOW_MAGE} @ ${WP29_SPAWN[1].x} + ` +
+    `NPC_SCOFFLAW @ ${WP29_SPAWN[2].x} SAY_OOX17_AMBUSH_REPLY=${SAY_OOX17_AMBUSH_REPLY} - FO6`;
+  const citeAggro =
+    `tanaris.cpp:202–210 Aggro urand SAY_OOX_AGGRO1/2=${SAY_OOX_AGGRO1}/${SAY_OOX_AGGRO2} - FO6 combat`;
+  const citeSummoned =
+    `tanaris.cpp:212–216 JustSummoned AttackStart(m_creature) for ` +
+    `scorpion/scofflaw/mage ${NPC_SCORPION}/${NPC_SCOFFLAW}/${NPC_SHADOW_MAGE} - FO6 combat`;
+  const citeCredit =
+    `tanaris.cpp:188–192 WP35 DoScriptText(SAY_OOX_END=${SAY_OOX_END}) + ` +
+    'RewardPlayerAndGroupAtEventExplored(648) - FO6 finishEscort';
+  const citeEnder =
+    `bake enderCreatureEntries NPC_OGLETHORPE=${NPC_OGLETHORPE} after WP35 explore credit`;
+  return [
+    {
+      kind: 'talk',
+      textId: SAY_OOX_START,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'set_active_object',
+      active: true,
+      cite: citeActive,
+    },
+    {
+      kind: 'stand_state',
+      standState: UNIT_STAND_STATE_STAND_TANARIS,
+      cite: citeStand,
+    },
+    {
+      kind: 'set_faction',
+      factionId: FACTION_ESCORT_N_FRIEND_ACTIVE,
+      flags: OOX_TEMP_FACTION_FLAGS,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(false, player, quest) npc_oox17tn (${NPC_OOX17TN}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP23 SAY_OOX_AMBUSH (${SAY_OOX_AMBUSH}) + 3× NPC_SCORPION (${NPC_SCORPION}) ` +
+        `TEMPSPAWN_CORPSE_TIMED_DESPAWN (${TEMPSPAWN_CORPSE_TIMED_DESPAWN}) ${SCORPION_DESPAWN_MS}ms - FO6`,
+      cite: citeWp23,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP29 SAY_OOX_AMBUSH (${SAY_OOX_AMBUSH}) + NPC_SCOFFLAW (${NPC_SCOFFLAW}) + ` +
+        `NPC_SHADOW_MAGE (${NPC_SHADOW_MAGE}) + SAY_OOX17_AMBUSH_REPLY (${SAY_OOX17_AMBUSH_REPLY}) - FO6`,
+      cite: citeWp29,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `Aggro SAY_OOX_AGGRO1/2 (${SAY_OOX_AGGRO1}/${SAY_OOX_AGGRO2}) - FO6 combat`,
+      cite: citeAggro,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `JustSummoned AttackStart ambush (${NPC_SCORPION}/${NPC_SCOFFLAW}/${NPC_SHADOW_MAGE}) - FO6 combat`,
+      cite: citeSummoned,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP35 SAY_OOX_END (${SAY_OOX_END}) + RewardPlayerAndGroupAtEventExplored(648) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason: `turn-in NPC_OGLETHORPE (${NPC_OGLETHORPE}) after explore credit`,
+      cite: citeEnder,
+    },
+  ];
+}
+
+// QuestAccept_npc_tooga — quest 1560 Tooga's Quest: start following at a friendly faction, and
+// sighting Torta gives the explore credit before the post-event talk. Cite: tanaris.cpp:398–407.
+function runToogaAccept(): DbScriptIntent[] {
+  const citeFollow =
+    `tanaris.cpp:402–403 npc_tooga (${NPC_TOOGA}) ` +
+    `StartFollow(player, FACTION_ESCORT_N_FRIEND_PASSIVE=${FACTION_ESCORT_N_FRIEND_PASSIVE}, quest) ` +
+    '- FO6 degraded FollowerAI finishEscort';
+  const citeSpeech =
+    `tanaris.cpp:370–383 speech timer ${TOGA_SPEECH_TIMER_MS}/${TOGA_SPEECH_INTERVAL_MS}ms ` +
+    `urand SAY_TOOG_THIRST=${SAY_TOOG_THIRST} / SAY_TOOG_WORRIED=${SAY_TOOG_WORRIED} - FO6`;
+  const citeCredit =
+    `tanaris.cpp:296–308 LOS NPC_TORTA=${NPC_TORTA} INTERACTION_DISTANCE=${INTERACTION_DISTANCE}: ` +
+    'RewardPlayerAndGroupAtEventExplored(1560) + SetFollowComplete(true) - FO6 finishEscort';
+  const citePost =
+    `tanaris.cpp:328–365 post-event timer ${TOGA_POST_EVENT_START_MS}/${TOGA_POST_EVENT_INTERVAL_MS}ms ` +
+    `phases SAY_TOOG_POST_1=${SAY_TOOG_POST_1}…SAY_TORT_POST_6=${SAY_TORT_POST_6}; ` +
+    `MovePoint(POINT_ID_TO_WATER=${POINT_ID_TO_WATER}, ` +
+    `${TO_WATER_LOC.x},${TO_WATER_LOC.y},${TO_WATER_LOC.z}) - FO6`;
+  const citeEnder =
+    `bake enderCreatureEntries NPC_TORTA=${NPC_TORTA} after LOS explore credit`;
+  return [
+    {
+      kind: 'skip',
+      reason:
+        `StartFollow(player, FACTION_ESCORT_N_FRIEND_PASSIVE=${FACTION_ESCORT_N_FRIEND_PASSIVE}, quest) ` +
+        `npc_tooga (${NPC_TOOGA}) - FO6 degraded FollowerAI finishEscort`,
+      cite: citeFollow,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `speech SAY_TOOG_THIRST (${SAY_TOOG_THIRST}) / SAY_TOOG_WORRIED (${SAY_TOOG_WORRIED}) - FO6`,
+      cite: citeSpeech,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `LOS NPC_TORTA (${NPC_TORTA}) RewardPlayerAndGroupAtEventExplored(1560) ` +
+        `INTERACTION_DISTANCE=${INTERACTION_DISTANCE} - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `post-event SAY_TOOG_POST_1–SAY_TORT_POST_6 (${SAY_TOOG_POST_1}–${SAY_TORT_POST_6}) + ` +
+        `MovePoint water (${TO_WATER_LOC.x}) - FO6`,
+      cite: citePost,
+    },
+    {
+      kind: 'skip',
+      reason: `turn-in NPC_TORTA (${NPC_TORTA}) after explore credit`,
+      cite: citeEnder,
+    },
+  ];
+}
+
+// Family pack: kalimdor/tanaris.cpp Hooks: pQuestAcceptNPC oox17tn (648), tooga (1560). Residuals
+// documented on accept chains: WP ambushes / Torta LOS credit.
+export function runTanaris(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase === 'accept') {
+    if (questId === QUEST_RESCUE_OOX_17TN) return runOox17tnAccept();
+    if (questId === QUEST_TOOGA) return runToogaAccept();
+    return [];
+  }
+  return [];
+}
+
+// Map entries spread into QUEST_SCRIPT_REGISTRY (keeps registry.ts under 1500). next-batch.mjs also matches
+// `family: 'kalimdor/tanaris'` in registry.ts.
+export const TANARIS_REGISTRY: Record<string | number, TanarisQuestScriptEntry> = {
+  'kalimdor/tanaris': {
+    family: 'kalimdor/tanaris',
+    questIds: [QUEST_RESCUE_OOX_17TN, QUEST_TOOGA],
+    hooks: ['accept'],
+    cite: 'kalimdor/tanaris.cpp:235–248,398–407,161–194,292–310,323–383',
+    run: runTanaris,
+  },
+  [QUEST_RESCUE_OOX_17TN]: {
+    family: 'kalimdor/tanaris',
+    questId: QUEST_RESCUE_OOX_17TN,
+    questIds: [QUEST_RESCUE_OOX_17TN],
+    hooks: ['accept'],
+    cite: 'tanaris.cpp:235–248 QuestAccept_npc_oox17tn',
+    run: runTanaris,
+  },
+  [QUEST_TOOGA]: {
+    family: 'kalimdor/tanaris',
+    questId: QUEST_TOOGA,
+    questIds: [QUEST_TOOGA],
+    hooks: ['accept'],
+    cite: 'tanaris.cpp:398–407 QuestAccept_npc_tooga',
+    run: runTanaris,
+  },
+};