azeroth-shell 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,125 @@
+// QI4 — eastern_kingdoms/searing_gorge residual, extracted for the 1500-line ratchet. It claims
+// the accept hook for quest 3367 only. Cite: eastern_kingdoms/searing_gorge.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';
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+// Cite: searing_gorge.cpp:53 QUEST_ID_SUNTARA_STONES = 3367 Escort Dorius Stonetender toward Ironforge
+// ("Suntara Stones").
+export const QUEST_SUNTARA_STONES = 3367;
+// Cite: bake starterCreatureEntries / searing_gorge.cpp PATH_ID + classic-db Dorius Stonetender
+// (npc_dorius_stonetender script name); PATH_ID also 8284.
+const NPC_DORIUS_STONETENDER = 8284;
+// Cite: searing_gorge.cpp:52 PATH_ID = 8284 Path id passed to npc_escortAI::Start on accept ReceiveAIEvent.
+const DORIUS_PATH_ID = 8284;
+// Cite: searing_gorge.cpp:48 SPELL_MARKSMAN_HIT = 12198 Escort ends when Dorius is hit by this spell (Dark
+// Iron marksman shot); SpellHit awards explore credit (not a waypoint).
+const SPELL_MARKSMAN_HIT = 12198;
+// Cite: searing_gorge.cpp:50 RELAY_SCRIPT_FINISHED = 8284 ScriptsStart(SCRIPT_TYPE_RELAY, …) after explore
+// credit — RP FO6.
+const RELAY_SCRIPT_FINISHED = 8284;
+// Cite: searing_gorge.cpp:46 NPC_DARK_IRON_STEELSHIFTER = 8337 Ambush summons attack Dorius at movement
+// point 2 (not accept-hook — FO6).
+const NPC_DARK_IRON_STEELSHIFTER = 8337;
+// Cite: ScriptDevAIMgr.h:48 FACTION_ESCORT_A_NEUTRAL_ACTIVE = 231 ReceiveAIEvent SetFactionTemporary on
+// Dorius escort start.
+const FACTION_ESCORT_A_NEUTRAL_ACTIVE = 231;
+/** 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: searing_gorge.cpp:84 TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x01 | 0x20 =
+// 0x21
+const DORIUS_TEMP_FACTION_FLAGS =
+  TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC;
+// Cite: AIDefines.h:43 AI_EVENT_START_ESCORT = 100 QuestAccept_npc_dorius_stonetender SendAIEvent event
+// type.
+const AI_EVENT_START_ESCORT = 100;
+// Cite: Unit.h:97 UNIT_STAND_STATE_STAND = 0 Reset() ships Dorius DEAD; accept stands him. opcodes.ts
+// re-export.
+const UNIT_STAND_STATE_STAND_DORIUS = UNIT_STAND_STATE_STAND;
+// Cite: searing_gorge.cpp:43 SAY_DORIUS_TO_PLAYER = 4354 WP37 DoBroadcastText (not accept-hook — FO6
+// waypoint). Aggro SAY 4351–4353 and finish SAY 4359 are escort-combat FO6 only.
+const SAY_DORIUS_TO_PLAYER = 4354;
+
+// QuestAccept_npc_dorius_stonetender — quest 3367 Suntara Stones: stand, temporary faction and
+// escort path 8284; the Marksman Hit at the end credits it. Cite: searing_gorge.cpp:140–149.
+function runDoriusStonetenderAccept(questId: number): DbScriptIntent[] {
+  const citeEvent =
+    `searing_gorge.cpp:144 npc_dorius_stonetender (${NPC_DORIUS_STONETENDER}) ` +
+    'SendAIEvent(AI_EVENT_START_ESCORT, player, creature, questId)';
+  const citeStand =
+    'searing_gorge.cpp:83 SetStandState(UNIT_STAND_STATE_STAND) via ReceiveAIEvent';
+  const citeFaction =
+    'searing_gorge.cpp:84 SetFactionTemporary(FACTION_ESCORT_A_NEUTRAL_ACTIVE, ' +
+    'TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC)';
+  const citeEscort =
+    `searing_gorge.cpp:85 npc_escortAI::Start(false, player, quest, true, false, PATH_ID=${DORIUS_PATH_ID}) - FO6 degraded finishEscort`;
+  const citeWp =
+    `searing_gorge.cpp:111–117 WP37 DoBroadcastText(SAY_DORIUS_TO_PLAYER=${SAY_DORIUS_TO_PLAYER}) + point emote; ` +
+    `WP53 face player - FO6 WP`;
+  const citeCredit =
+    `searing_gorge.cpp:91–98 SpellHit(SPELL_MARKSMAN_HIT=${SPELL_MARKSMAN_HIT}) ` +
+    `RewardPlayerAndGroupAtEventExplored(3367) + ScriptsStart(RELAY ${RELAY_SCRIPT_FINISHED}) + End() - FO6 finishEscort`;
+  const citeAmbush =
+    `searing_gorge.cpp:101–105 SummonedMovementInform NPC_DARK_IRON_STEELSHIFTER=${NPC_DARK_IRON_STEELSHIFTER} AttackStart - FO6 zone ambush`;
+  return [
+    {
+      kind: 'send_ai_event',
+      eventType: AI_EVENT_START_ESCORT,
+      radius: 0,
+      value: questId,
+      mode: 'receive_on_source',
+      cite: citeEvent,
+    },
+    {
+      kind: 'stand_state',
+      standState: UNIT_STAND_STATE_STAND_DORIUS,
+      cite: citeStand,
+    },
+    {
+      kind: 'set_faction',
+      factionId: FACTION_ESCORT_A_NEUTRAL_ACTIVE,
+      flags: DORIUS_TEMP_FACTION_FLAGS,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(false, player, quest, true, false, path=${DORIUS_PATH_ID}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP37 SAY_DORIUS_TO_PLAYER (${SAY_DORIUS_TO_PLAYER}) + WP53 face - FO6 waypoint`,
+      cite: citeWp,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `SpellHit SPELL_MARKSMAN_HIT (${SPELL_MARKSMAN_HIT}) RewardPlayerAndGroupAtEventExplored(3367) + RELAY ${RELAY_SCRIPT_FINISHED} - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `ambush NPC_DARK_IRON_STEELSHIFTER (${NPC_DARK_IRON_STEELSHIFTER}) AttackStart - FO6 zone ambush`,
+      cite: citeAmbush,
+    },
+  ];
+}
+
+// Family pack: eastern_kingdoms/searing_gorge.cpp Hooks: pQuestAcceptNPC QuestAccept_npc_dorius_stonetender
+// (3367).
+export function runSearingGorge(phase: QuestScriptHook, questId: number): DbScriptIntent[] {
+  if (phase !== 'accept') return [];
+  if (questId === QUEST_SUNTARA_STONES) return runDoriusStonetenderAccept(questId);
+  return [];
+}

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

@@ -0,0 +1,51 @@
+// Aggregator for the per-zone scriptdev2 quest-script registries, so registry.ts stays under the
+// 1500-line cap. Add a family here and mark it in registry.ts — never a new import line there.
+import type { QuestScriptEntry } from './registry.ts';
+import { AREATRIGGER_SCRIPTS_REGISTRY } from './registryAreatriggerScripts.ts';
+import { ASHENVALE_REGISTRY } from './registryAshenvale.ts';
+import { AZSHARA_REGISTRY } from './registryAzshara.ts';
+import { DARKSHORE_REGISTRY } from './registryDarkshore.ts';
+import { DESOLACE_REGISTRY } from './registryDesolace.ts';
+import { DUSTWALLOW_MARSH_REGISTRY } from './registryDustwallowMarsh.ts';
+import { FELWOOD_REGISTRY } from './registryFelwood.ts';
+import { FERALAS_REGISTRY } from './registryFeralas.ts';
+import { GO_SCRIPTS_REGISTRY } from './registryGoScripts.ts';
+import { MOONGLADE_REGISTRY } from './registryMoonglade.ts';
+import { NPC_PROFESSIONS_REGISTRY } from './registryNpcProfessions.ts';
+import { NPCS_SPECIAL_REGISTRY } from './registryNpcsSpecial.ts';
+import { RAZORFEN_DOWNS_REGISTRY } from './registryRazorfenDowns.ts';
+import { RAZORFEN_KRAUL_REGISTRY } from './registryRazorfenKraul.ts';
+import { STONETALON_MOUNTAINS_REGISTRY } from './registryStonetalonMountains.ts';
+import { TANARIS_REGISTRY } from './registryTanaris.ts';
+import { TELDRASSIL_REGISTRY } from './registryTeldrassil.ts';
+import { THE_BARRENS_REGISTRY } from './registryTheBarrens.ts';
+import { THOUSAND_NEEDLES_REGISTRY } from './registryThousandNeedles.ts';
+import { UNGORO_CRATER_REGISTRY } from './registryUngoroCrater.ts';
+import { WAR_EFFORT_REGISTRY } from './registryWarEffort.ts';
+import { WINTERSPRING_REGISTRY } from './registryWinterspring.ts';
+
+/** Merged per-zone registries, spread into QUEST_SCRIPT_REGISTRY as one unit. */
+export const SIBLING_REGISTRIES: Record<string | number, QuestScriptEntry> = {
+  ...AREATRIGGER_SCRIPTS_REGISTRY,
+  ...ASHENVALE_REGISTRY,
+  ...AZSHARA_REGISTRY,
+  ...DARKSHORE_REGISTRY,
+  ...DESOLACE_REGISTRY,
+  ...DUSTWALLOW_MARSH_REGISTRY,
+  ...FELWOOD_REGISTRY,
+  ...FERALAS_REGISTRY,
+  ...GO_SCRIPTS_REGISTRY,
+  ...MOONGLADE_REGISTRY,
+  ...NPC_PROFESSIONS_REGISTRY,
+  ...NPCS_SPECIAL_REGISTRY,
+  ...RAZORFEN_DOWNS_REGISTRY,
+  ...RAZORFEN_KRAUL_REGISTRY,
+  ...STONETALON_MOUNTAINS_REGISTRY,
+  ...TANARIS_REGISTRY,
+  ...TELDRASSIL_REGISTRY,
+  ...THE_BARRENS_REGISTRY,
+  ...THOUSAND_NEEDLES_REGISTRY,
+  ...UNGORO_CRATER_REGISTRY,
+  ...WAR_EFFORT_REGISTRY,
+  ...WINTERSPRING_REGISTRY,
+};

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

@@ -0,0 +1,172 @@
+// QI4 — eastern_kingdoms/silverpine_forest residual, extracted for the 1500-line ratchet. Accept
+// hooks for quests 435 and 452. Cite: eastern_kingdoms/silverpine_forest.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: silverpine_forest.cpp:54 QUEST_ERLAND = 435 Escort Deathstalker Erland through Malden's Orchard
+// ("Escorting Erland").
+export const QUEST_ERLAND = 435;
+// Cite: silverpine_forest.cpp:138 QUEST_PYREWOOD_AMBUSH = 452 Defend Deathstalker Faerleia through Pyrewood
+// council waves.
+export const QUEST_PYREWOOD_AMBUSH = 452;
+// Cite: bake starterCreatureEntries / classic-db creature_questrelation Deathstalker Erland
+// (npc_deathstalker_erland script name).
+const NPC_DEATHSTALKER_ERLAND = 1978;
+/** Cite: silverpine_forest.cpp:55 NPC_RANE = 1950 Rane Yorick — WP15 dialogue + bake ender for 435. */
+const NPC_RANE = 1950;
+/** Cite: silverpine_forest.cpp:56 NPC_QUINN = 1951 Quinn Yorick — WP26 dialogue after escort credit. */
+const NPC_QUINN = 1951;
+// Cite: bake starterCreatureEntries — Deathstalker Faerleia (npc_deathstalker_faerleia script name); also
+// ender for 452.
+const NPC_DEATHSTALKER_FAERLEIA = 2058;
+/** Cite: silverpine_forest.cpp:40 SAY_START_1 = -1000306 DoScriptText on Erland accept. */
+const SAY_START_1 = -1000306;
+// Cite: silverpine_forest.cpp:41 SAY_START_2 = -1000307 DoScriptText at escort WP1 (not accept-hook — FO6
+// WP).
+const SAY_START_2 = -1000307;
+/** Cite: silverpine_forest.cpp:46 SAY_END = -1000312 DoScriptText at WP14 with explore credit. */
+const SAY_END = -1000312;
+/** Cite: silverpine_forest.cpp:143 SAY_START = -1000553 DoScriptText on Faerleia accept. */
+const SAY_START_FAERLEIA = -1000553;
+/** Cite: silverpine_forest.cpp:144 SAY_COMPLETED = -1000554 DoScriptText when final wave is cleared. */
+const SAY_COMPLETED = -1000554;
+// Cite: silverpine_forest.cpp:141 SPELL_DRINK_POTION = 3359 Cast after each cleared wave (not accept-hook —
+// FO6 event).
+const SPELL_DRINK_POTION = 3359;
+/** Cite: silverpine_forest.cpp:147 NPC_COUNCILMAN_SMITHERS = 2060 Wave 0 summon entry (FO6). */
+const NPC_COUNCILMAN_SMITHERS = 2060;
+// Cite: silverpine_forest.cpp:157–158 final wave lords NPC_COUNCILMAN_COOPER=2065,
+// NPC_COUNCILMAN_BRUNSWICK=2067, NPC_LORD_MAYOR_MORRISON=2068
+const NPC_LORD_MAYOR_MORRISON = 2068;
+/** Cite: silverpine_forest.cpp:196 m_uiWaveTimer = 10000 Initial wave timer after StartEvent. */
+const FAERLEIA_WAVE_TIMER_MS = 10000;
+// Cite: Unit.h:511 UNIT_NPC_FLAG_QUESTGIVER = 0x00000002 StartEvent removes this so Faerleia is not
+// re-accepted mid-event.
+const UNIT_NPC_FLAG_QUESTGIVER = 0x00000002;
+
+// QuestAccept_npc_deathstalker_erland — quest 435 Escorting Erland: say the start line and escort;
+// WP14 gives the explore credit, and the Rane dialogue follows. Cite: silverpine_forest.cpp:115.
+function runDeathstalkerErlandAccept(): DbScriptIntent[] {
+  const citeTalk =
+    `silverpine_forest.cpp:119 npc_deathstalker_erland (${NPC_DEATHSTALKER_ERLAND}) ` +
+    `DoScriptText(SAY_START_1=${SAY_START_1})`;
+  const citeEscort =
+    'silverpine_forest.cpp:121–122 npc_escortAI::Start(false, player, quest) - FO6 degraded finishEscort';
+  const citeWp1 =
+    `silverpine_forest.cpp:72–74 WP1 DoScriptText(SAY_START_2=${SAY_START_2}) - FO6 WP`;
+  const citeCredit =
+    `silverpine_forest.cpp:76–78 WP14 DoScriptText(SAY_END=${SAY_END}) + ` +
+    'RewardPlayerAndGroupAtEventExplored(435) - FO6 finishEscort';
+  const citePost =
+    `silverpine_forest.cpp:79–98 WP15–27 Rane (${NPC_RANE}) / Quinn (${NPC_QUINN}) dialogue - FO6 post-credit`;
+  return [
+    {
+      kind: 'talk',
+      textId: SAY_START_1,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'skip',
+      reason:
+        'escort Start(false, player, quest) - FO6 degraded finishEscort (Malden orchard path)',
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason: `WP1 SAY_START_2 (${SAY_START_2}) - FO6 waypoint`,
+      cite: citeWp1,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP14 RewardPlayerAndGroupAtEventExplored(435) + SAY_END (${SAY_END}) - FO6 finishEscort`,
+      cite: citeCredit,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP15–27 Rane (${NPC_RANE}) / Quinn (${NPC_QUINN}) post-credit dialogue - FO6`,
+      cite: citePost,
+    },
+  ];
+}
+
+// QuestAccept_npc_deathstalker_faerleia — quest 452 Pyrewood Ambush: strip QUESTGIVER and run the
+// council waves; the fourth wave's death credits it. Cite: silverpine_forest.cpp:290–300, :226–281.
+function runDeathstalkerFaerleiaAccept(): DbScriptIntent[] {
+  const citeTalk =
+    `silverpine_forest.cpp:294 npc_deathstalker_faerleia (${NPC_DEATHSTALKER_FAERLEIA}) ` +
+    `DoScriptText(SAY_START=${SAY_START_FAERLEIA})`;
+  const citeQg =
+    'silverpine_forest.cpp:192 StartEvent RemoveFlag(UNIT_NPC_FLAG_QUESTGIVER)';
+  const citeStart =
+    `silverpine_forest.cpp:194–198 m_uiWaveTimer=${FAERLEIA_WAVE_TIMER_MS} + waveCount=0; ` +
+    `UpdateAI council waves (Smithers ${NPC_COUNCILMAN_SMITHERS} → Mayor ${NPC_LORD_MAYOR_MORRISON}) FO6`;
+  const citePotion =
+    `silverpine_forest.cpp:232 DoCastSpellIfCan(SPELL_DRINK_POTION=${SPELL_DRINK_POTION}) after each wave clear - FO6`;
+  const citeWin =
+    `silverpine_forest.cpp:235–242 waveCount==4 DoScriptText(SAY_COMPLETED=${SAY_COMPLETED}) + ` +
+    'RewardPlayerAndGroupAtEventExplored(452) + FinishEvent - FO6 finishEscort';
+  const citeFail =
+    'silverpine_forest.cpp:208–214 JustDied SendQuestFailed(452) - host fail FO6';
+  // StartEvent removes QUESTGIVER; prior 2 → result 0 when only that flag set.
+  const prior = UNIT_NPC_FLAG_QUESTGIVER;
+  const resultFlags = prior & ~UNIT_NPC_FLAG_QUESTGIVER;
+  return [
+    {
+      kind: 'talk',
+      textId: SAY_START_FAERLEIA,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'modify_npc_flags',
+      flag: UNIT_NPC_FLAG_QUESTGIVER,
+      changeFlag: NPC_FLAG_CHANGE_REMOVE,
+      mode: 'remove',
+      resultFlags,
+      cite: citeQg,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `StartEvent wave timer ${FAERLEIA_WAVE_TIMER_MS}ms + council wave AI (Smithers→Morrison) - FO6 zone event`,
+      cite: citeStart,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `SPELL_DRINK_POTION (${SPELL_DRINK_POTION}) after each wave clear - FO6 event`,
+      cite: citePotion,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `final wave RewardPlayerAndGroupAtEventExplored(452) + SAY_COMPLETED (${SAY_COMPLETED}) - FO6 finishEscort`,
+      cite: citeWin,
+    },
+    {
+      kind: 'skip',
+      reason: 'JustDied SendQuestFailed(452) - host fail FO6',
+      cite: citeFail,
+    },
+  ];
+}
+
+// Family pack: eastern_kingdoms/silverpine_forest.cpp Hooks: pQuestAcceptNPC erland (435), faerleia (452).
+export function runSilverpineForest(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase !== 'accept') return [];
+  if (questId === QUEST_ERLAND) return runDeathstalkerErlandAccept();
+  if (questId === QUEST_PYREWOOD_AMBUSH) return runDeathstalkerFaerleiaAccept();
+  return [];
+}

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

@@ -0,0 +1,180 @@
+// QI4 — kalimdor/stonetalon_mountains residual, extracted for the 1500-line ratchet. It claims the
+// accept hook for quest 6523; 1079 and 1080 are GameObject residuals. Cite: stonetalon_mountains.cpp.
+
+import type { DbScriptIntent } from './types.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 StonetalonMountainsQuestScriptEntry {
+  family?: string;
+  questId?: number;
+  questIds?: number[];
+  hooks?: QuestScriptHook[];
+  run?: (phase: QuestScriptHook, questId: number) => DbScriptIntent[];
+  cite?: string;
+}
+
+// ── sourced constants ────────────────────────────────────────────────────────
+
+// Cite: stonetalon_mountains.cpp:45 QUEST_PROTECT_KAYA = 6523 Escort Kaya Flathoof to Camp Aparaje; explore
+// credit at WP19.
+export const QUEST_PROTECT_KAYA = 6523;
+
+// Cite: bake starterCreatureEntries quest 6523; scriptdev-corpus boundCreatures Kaya Flathoof (11856) — not
+// an enum in the cpp file.
+const NPC_KAYA_FLATHOOF = 11856;
+/** Cite: bake enderCreatureEntries quest 6523 Makaba Flathoof. */
+const NPC_MAKABA_FLATHOOF = 11857;
+
+/** Cite: stonetalon_mountains.cpp:37 NPC_GRIMTOTEM_RUFFIAN = 11910 WP17 ambush summon. */
+const NPC_GRIMTOTEM_RUFFIAN = 11910;
+/** Cite: stonetalon_mountains.cpp:38 NPC_GRIMTOTEM_BRUTE = 11912 */
+const NPC_GRIMTOTEM_BRUTE = 11912;
+/** Cite: stonetalon_mountains.cpp:39 NPC_GRIMTOTEM_SORCERER = 11913 */
+const NPC_GRIMTOTEM_SORCERER = 11913;
+
+/** Cite: stonetalon_mountains.cpp:41–43 script texts. */
+const SAY_START = -1000357;
+const SAY_AMBUSH = -1000358;
+const SAY_END = -1000359;
+
+/** Cite: ScriptDevAIMgr.h:56 FACTION_ESCORT_H_PASSIVE = 775 SetFactionTemporary on accept. */
+const FACTION_ESCORT_H_PASSIVE = 775;
+/** 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: stonetalon_mountains.cpp:95 TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC = 0x01 |
+// 0x20 = 0x21
+const KAYA_TEMP_FACTION_FLAGS =
+  TEMPFACTION_RESTORE_RESPAWN | TEMPFACTION_TOGGLE_IMMUNE_TO_NPC;
+
+// Cite: Object.h:45 TEMPSPAWN_CORPSE_TIMED_DESPAWN = 3 WP17 SummonCreature TEMPSPAWN_CORPSE_TIMED_DESPAWN,
+// 30000.
+const TEMPSPAWN_CORPSE_TIMED_DESPAWN = 3;
+/** Cite: stonetalon_mountains.cpp:69–71 ambush despawn delay 30000 */
+const AMBUSH_DESPAWN_MS = 30000;
+
+/** Cite: stonetalon_mountains.cpp:69–71 WP17 SummonCreature positions. Ruffian / Brute / Sorcerer. */
+const AMBUSH_SPAWN = [
+  { entry: NPC_GRIMTOTEM_RUFFIAN, x: -50.75, y: -500.77, z: -46.13, o: 0.4 },
+  { entry: NPC_GRIMTOTEM_BRUTE, x: -40.05, y: -510.89, z: -46.05, o: 1.7 },
+  { entry: NPC_GRIMTOTEM_SORCERER, x: -32.21, y: -499.2, z: -45.35, o: 2.8 },
+] as const;
+
+// ── accept handlers ──────────────────────────────────────────────────────────
+
+// QuestAccept_npc_kaya — quest 6523 Protect Kaya: temporary passive faction, the start line and an
+// escort; WP17 is the Grimtotem ambush and WP19 the credit. Cite: stonetalon_mountains.cpp:89–102.
+function runKayaAccept(): DbScriptIntent[] {
+  const citeFaction =
+    `stonetalon_mountains.cpp:95 SetFactionTemporary(FACTION_ESCORT_H_PASSIVE=` +
+    `${FACTION_ESCORT_H_PASSIVE}, TEMPFACTION_RESTORE_RESPAWN|TOGGLE_IMMUNE_TO_NPC=` +
+    `${KAYA_TEMP_FACTION_FLAGS})`;
+  const citeTalk =
+    `stonetalon_mountains.cpp:96 npc_kaya (${NPC_KAYA_FLATHOOF}) ` +
+    `DoScriptText(SAY_START=${SAY_START})`;
+  const citeEscort =
+    `stonetalon_mountains.cpp:98–99 npc_kaya (${NPC_KAYA_FLATHOOF}) ` +
+    'npc_escortAI::Start(false, player, quest) - FO6 degraded finishEscort';
+  const citeWp17 =
+    `stonetalon_mountains.cpp:64–72 WP17 DoScriptText(SAY_AMBUSH=${SAY_AMBUSH}) + ` +
+    `SummonCreature(NPC_GRIMTOTEM_RUFFIAN=${NPC_GRIMTOTEM_RUFFIAN} @ ${AMBUSH_SPAWN[0].x}) + ` +
+    `SummonCreature(NPC_GRIMTOTEM_BRUTE=${NPC_GRIMTOTEM_BRUTE} @ ${AMBUSH_SPAWN[1].x}) + ` +
+    `SummonCreature(NPC_GRIMTOTEM_SORCERER=${NPC_GRIMTOTEM_SORCERER} @ ${AMBUSH_SPAWN[2].x}) ` +
+    `TEMPSPAWN_CORPSE_TIMED_DESPAWN=${TEMPSPAWN_CORPSE_TIMED_DESPAWN} ${AMBUSH_DESPAWN_MS}ms - FO6`;
+  const citeWp19 =
+    `stonetalon_mountains.cpp:74–78 WP19 DoScriptText(SAY_END=${SAY_END}) + ` +
+    'RewardPlayerAndGroupAtEventExplored(6523) - FO6 finishEscort';
+  const citeSummoned =
+    `stonetalon_mountains.cpp:54–57 JustSummoned AttackStart(m_creature) for ` +
+    `grimtotems ${NPC_GRIMTOTEM_RUFFIAN}/${NPC_GRIMTOTEM_BRUTE}/${NPC_GRIMTOTEM_SORCERER} - FO6 combat`;
+  const citeEnder =
+    `bake enderCreatureEntries NPC_MAKABA_FLATHOOF=${NPC_MAKABA_FLATHOOF} after explore credit`;
+  return [
+    {
+      kind: 'set_faction',
+      factionId: FACTION_ESCORT_H_PASSIVE,
+      flags: KAYA_TEMP_FACTION_FLAGS,
+      cleared: false,
+      cite: citeFaction,
+    },
+    {
+      kind: 'talk',
+      textId: SAY_START,
+      stringTemplateId: 0,
+      cite: citeTalk,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `escort Start(false, player, quest) npc_kaya (${NPC_KAYA_FLATHOOF}) - FO6 degraded finishEscort`,
+      cite: citeEscort,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP17 SAY_AMBUSH (${SAY_AMBUSH}) + NPC_GRIMTOTEM_RUFFIAN (${NPC_GRIMTOTEM_RUFFIAN}) + ` +
+        `NPC_GRIMTOTEM_BRUTE (${NPC_GRIMTOTEM_BRUTE}) + NPC_GRIMTOTEM_SORCERER (${NPC_GRIMTOTEM_SORCERER}) ` +
+        `TEMPSPAWN_CORPSE_TIMED_DESPAWN (${TEMPSPAWN_CORPSE_TIMED_DESPAWN}) ${AMBUSH_DESPAWN_MS}ms - FO6`,
+      cite: citeWp17,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `WP19 SAY_END (${SAY_END}) + RewardPlayerAndGroupAtEventExplored(6523) - FO6 finishEscort`,
+      cite: citeWp19,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `JustSummoned AttackStart grimtotems (${NPC_GRIMTOTEM_RUFFIAN}/${NPC_GRIMTOTEM_BRUTE}/` +
+        `${NPC_GRIMTOTEM_SORCERER}) - FO6 combat`,
+      cite: citeSummoned,
+    },
+    {
+      kind: 'skip',
+      reason:
+        `turn-in NPC_MAKABA_FLATHOOF (${NPC_MAKABA_FLATHOOF}) after explore credit`,
+      cite: citeEnder,
+    },
+  ];
+}
+
+// Family pack: kalimdor/stonetalon_mountains.cpp Hooks: pQuestAcceptNPC kaya (6523). Residuals documented
+// on accept chain: WP17 grimtotem ambush, WP19 explore.
+export function runStonetalonMountains(
+  phase: QuestScriptHook,
+  questId: number,
+): DbScriptIntent[] {
+  if (phase === 'accept') {
+    if (questId === QUEST_PROTECT_KAYA) return runKayaAccept();
+    return [];
+  }
+  return [];
+}
+
+// Map entries spread into QUEST_SCRIPT_REGISTRY (keeps registry.ts under 1500). next-batch.mjs also matches
+// `family: 'kalimdor/stonetalon_mountains'` in registry.ts.
+export const STONETALON_MOUNTAINS_REGISTRY: Record<
+  string | number,
+  StonetalonMountainsQuestScriptEntry
+> = {
+  'kalimdor/stonetalon_mountains': {
+    family: 'kalimdor/stonetalon_mountains',
+    questIds: [QUEST_PROTECT_KAYA],
+    hooks: ['accept'],
+    cite: 'kalimdor/stonetalon_mountains.cpp:89–102,59–80,54–57',
+    run: runStonetalonMountains,
+  },
+  [QUEST_PROTECT_KAYA]: {
+    family: 'kalimdor/stonetalon_mountains',
+    questId: QUEST_PROTECT_KAYA,
+    questIds: [QUEST_PROTECT_KAYA],
+    hooks: ['accept'],
+    cite: 'stonetalon_mountains.cpp:89–102 QuestAccept_npc_kaya',
+    run: runStonetalonMountains,
+  },
+};