osrs-tools 2.13.0 → 3.0.0

package/dist/runescape/model/quest/QuestTool.js

@@ -1,15 +1,21 @@
-import { RequirementType } from '../Requirement';
+import { evaluateRequirements } from '../eligibility/RequirementEvaluator';
+import { RequirementType, } from '../Requirement';
+import { getMaxSkillBoost } from '../skills/SkillBoosts';
 // Import all quests for registry
 import AKingdomDivided from './all/AKingdomDivided';
+import AlfredGrimhandsBarcrawl from './all/AlfredGrimhandsBarcrawl';
 import ANightAtTheTheatre from './all/ANightAtTheTheatre';
 import AnimalMagnetism from './all/AnimalMagnetism';
 import AnotherSliceOfHAM from './all/AnotherSliceOfHAM';
 import APorcineOfInterest from './all/APorcineOfInterest';
+import ARuffSituation from './all/ARuffSituation';
 import ASoulsBane from './all/ASoulsBane';
 import ATailOfTwoCats from './all/ATailOfTwoCats';
 import ATasteOfHope from './all/ATasteOfHope';
 import AtFirstLight from './all/AtFirstLight';
 import ATheatreOfBlood from './all/ATheatreOfBlood';
+import BarbarianTraining from './all/BarbarianTraining';
+import BearYourSoul from './all/BearYourSoul';
 import BelowIceMountain from './all/BelowIceMountain';
 import BeneathCursedSands from './all/BeneathCursedSands';
 import BetweenARock from './all/BetweenARock';
@@ -24,8 +30,11 @@ import ClockTower from './all/ClockTower';
 import ColdWar from './all/ColdWar';
 import Contact from './all/Contact';
 import CooksAssistant from './all/CooksAssistant';
+import CrabQuest from './all/CrabQuest';
 import CreatureOfFenkenstrain from './all/CreatureOfFenkenstrain';
 import CurrentAffairs from './all/CurrentAffairs';
+import CurseOfTheEmptyLord from './all/CurseOfTheEmptyLord';
+import DaddysHome from './all/DaddysHome';
 import DarknessOfHallowvale from './all/DarknessOfHallowvale';
 import DeathOnTheIsle from './all/DeathOnTheIsle';
 import DeathPlateau from './all/DeathPlateau';
@@ -33,11 +42,9 @@ import DeathToTheDorgeshuun from './all/DeathToTheDorgeshuun';
 import DefenderOfVarrock from './all/DefenderOfVarrock';
 import DemonSlayer from './all/DemonSlayer';
 import DesertTreasure from './all/DesertTreasure';
-import DesertTreasureI from './all/DesertTreasureI';
 import DesertTreasureIITheFallenEmpire from './all/DesertTreasureIITheFallenEmpire';
 import DeviousMinds from './all/DeviousMinds';
 import DoricQuest from './all/DoricQuest';
-import DoricsQuest from './all/DoricsQuest';
 import DragonSlayerI from './all/DragonSlayerI';
 import DragonSlayerII from './all/DragonSlayerII';
 import DreamMentor from './all/DreamMentor';
@@ -49,11 +56,14 @@ import ElementalWorkshopI from './all/ElementalWorkshopI';
 import ElementalWorkshopII from './all/ElementalWorkshopII';
 import EnakhrasLament from './all/EnakhrasLament';
 import EnlightenedJourney from './all/EnlightenedJourney';
+import EnterTheAbyss from './all/EnterTheAbyss';
 import ErnestTheChicken from './all/ErnestTheChicken';
 import EthicallyAcquiredAntiquities from './all/EthicallyAcquiredAntiquities';
 import FairytaleIGrowingPains from './all/FairytaleIGrowingPains';
 import FairytaleIICureAQueen from './all/FairytaleIICureAQueen';
+import FallenFromGrace from './all/FallenFromGrace';
 import FamilyCrest from './all/FamilyCrest';
+import FamilyPest from './all/FamilyPest';
 import FightArena from './all/FightArena';
 import FishingContest from './all/FishingContest';
 import ForgettableTale from './all/ForgettableTale';
@@ -66,26 +76,32 @@ import GrimTales from './all/GrimTales';
 import HauntedMine from './all/HauntedMine';
 import HazeelCult from './all/HazeelCult';
 import HeroesQuest from './all/HeroesQuest';
+import HisFaithfulServants from './all/HisFaithfulServants';
 import HolyGrail from './all/HolyGrail';
+import HopespearsWill from './all/HopespearsWill';
 import HorrorFromTheDeep from './all/HorrorFromTheDeep';
 import IcthlarinsLittleHelper from './all/IcthlarinsLittleHelper';
 import ImpCatcher from './all/ImpCatcher';
 import InAidOfTheMyreque from './all/InAidOfTheMyreque';
+import InSearchOfKnowledge from './all/InSearchOfKnowledge';
 import InSearchOfTheMyreque from './all/InSearchOfTheMyreque';
+import IntoTheTombs from './all/IntoTheTombs';
 import JunglePotion from './all/JunglePotion';
 import KingsRansom from './all/KingsRansom';
+import LairOfTarnRazorlor from './all/LairOfTarnRazorlor';
 import LandOfTheGoblins from './all/LandOfTheGoblins';
 import LearningTheRopes from './all/LearningTheRopes';
 import LegendsQuest from './all/LegendsQuest';
 import LostCity from './all/LostCity';
 import LunarDiplomacy from './all/LunarDiplomacy';
+import MageArenaI from './all/MageArenaI';
+import MageArenaII from './all/MageArenaII';
 import MakingFriendsWithMyArm from './all/MakingFriendsWithMyArm';
 import MakingHistory from './all/MakingHistory';
 import MeatAndGreet from './all/MeatAndGreet';
 import MerlinsCrystal from './all/MerlinsCrystal';
 import MisthalinMystery from './all/MisthalinMystery';
 import MonkeyMadness from './all/MonkeyMadness';
-import MonkeyMadnessI from './all/MonkeyMadnessI';
 import MonkeyMadnessII from './all/MonkeyMadnessII';
 import MonksFriend from './all/MonksFriend';
 import MountainDaughter from './all/MountainDaughter';
@@ -105,7 +121,6 @@ import PriestInPeril from './all/PriestInPeril';
 import PrinceAliRescue from './all/PrinceAliRescue';
 import PryingTimes from './all/PryingTimes';
 import RagAndBoneMan from './all/RagAndBoneMan';
-import RagAndBoneManI from './all/RagAndBoneManI';
 import RagAndBoneManII from './all/RagAndBoneManII';
 import Ratcatchers from './all/Ratcatchers';
 import RecipeForDisaster from './all/RecipeForDisaster';
@@ -128,21 +143,21 @@ import SheepShearer from './all/SheepShearer';
 import ShieldOfArrav from './all/ShieldOfArrav';
 import ShiloVillage from './all/ShiloVillage';
 import SinsOfTheFather from './all/SinsOfTheFather';
+import SkippyAndTheMogres from './all/SkippyAndTheMogres';
 import SleepingGiants from './all/SleepingGiants';
-import SlugMenace from './all/SlugMenace';
 import SongOfTheElves from './all/SongOfTheElves';
 import SpiritsOfTheElid from './all/SpiritsOfTheElid';
 import SwanSong from './all/SwanSong';
 import TaiBwoWannaiTrio from './all/TaiBwoWannaiTrio';
-import TaleOfTheRighteous from './all/TaleOfTheRighteous';
 import TearsOfGuthix from './all/TearsOfGuthix';
-import TempleOfIkov from './all/TempleOfIkov';
 import TempleOfTheEye from './all/TempleOfTheEye';
 import TheAscentOfArceuus from './all/TheAscentOfArceuus';
+import TheBloodMoonRises from './all/TheBloodMoonRises';
 import TheCorsairCurse from './all/TheCorsairCurse';
 import TheCurseOfArrav from './all/TheCurseOfArrav';
 import TheDepthsOfDespair from './all/TheDepthsOfDespair';
 import TheDigSite from './all/TheDigSite';
+import TheEnchantedKey from './all/TheEnchantedKey';
 import TheEyesOfGlouphrie from './all/TheEyesOfGlouphrie';
 import TheFeud from './all/TheFeud';
 import TheFinalDawn from './all/TheFinalDawn';
@@ -150,7 +165,9 @@ import TheForsakenTower from './all/TheForsakenTower';
 import TheFremennikExiles from './all/TheFremennikExiles';
 import TheFremennikIsles from './all/TheFremennikIsles';
 import TheFremennikTrials from './all/TheFremennikTrials';
+import TheFrozenDoor from './all/TheFrozenDoor';
 import TheGardenOfDeath from './all/TheGardenOfDeath';
+import TheGeneralsShadow from './all/TheGeneralsShadow';
 import TheGiantDwarf from './all/TheGiantDwarf';
 import TheGolem from './all/TheGolem';
 import TheGrandTree from './all/TheGrandTree';
@@ -162,6 +179,7 @@ import TheKnightsSword from './all/TheKnightsSword';
 import TheLostTribe from './all/TheLostTribe';
 import ThePathOfGlouphrie from './all/ThePathOfGlouphrie';
 import TheQueenOfThieves from './all/TheQueenOfThieves';
+import TheRedReef from './all/TheRedReef';
 import TheRestlessGhost from './all/TheRestlessGhost';
 import TheRibbitingTaleOfALilyPadLabourDispute from './all/TheRibbitingTaleOfALilyPadLabourDispute';
 import TheSlugMenace from './all/TheSlugMenace';
@@ -177,6 +195,7 @@ import TrollStronghold from './all/TrollStronghold';
 import TroubledTortugans from './all/TroubledTortugans';
 import TwilightsPromise from './all/TwilightsPromise';
 import UndergroundPass from './all/UndergroundPass';
+import ValeTotems from './all/ValeTotems';
 import VampyreSlayer from './all/VampyreSlayer';
 import Wanted from './all/Wanted';
 import Watchtower from './all/Watchtower';
@@ -185,9 +204,9 @@ import WhatLiesBelow from './all/WhatLiesBelow';
 import WhileGuthixSleeps from './all/WhileGuthixSleeps';
 import WitchesPotion from './all/WitchesPotion';
 import WitchsHouse from './all/WitchsHouse';
-import WitchsPotion from './all/WitchsPotion';
 import XMarksTheSpot from './all/XMarksTheSpot';
 import ZogreFleshEaters from './all/ZogreFleshEaters';
+import { MiniQuestList } from './MiniQuestList';
 import { QuestList } from './QuestList';
 /**
  * OSRS Quest utility tool
@@ -259,241 +278,265 @@ class QuestTool {
                     return false;
                 }
             }
+            else if (req.type === RequirementType.CombatLevel) {
+                // Check combat level requirement (never boostable for quest access)
+                const combatReq = req;
+                if (this.osrsAccount.combatLevel < combatReq.level) {
+                    return false;
+                }
+            }
+            else if (req.type === RequirementType.QuestPoint) {
+                // Check quest point total requirement
+                const qpReq = req;
+                if (this.osrsAccount.questPoints < qpReq.amount) {
+                    return false;
+                }
+            }
+            else if (req.type === RequirementType.SlayerLevel) {
+                // Check Slayer level requirement
+                const slayerReq = req;
+                const slayerSkill = this.osrsAccount.getSkill('Slayer');
+                if (!slayerSkill || slayerSkill.level < slayerReq.level) {
+                    return false;
+                }
+            }
+            // Item, Location, and SlayerUnlock requirements cannot be verified from
+            // hiscores data alone; we conservatively skip them (assume met).
         }
         return true;
     }
     static getAllQuests() {
-        return QuestList.map(name => QuestTool.getQuestByName(name)).filter(q => q !== undefined);
+        return QuestList.map(name => QuestTool.getQuestByName(name)).filter((q) => q !== undefined);
     }
     static getAllMiniQuests() {
-        return QuestList.map(name => QuestTool.getQuestByName(name)).filter(q => q !== undefined && q.miniquest);
+        return MiniQuestList.map(name => QuestTool.getQuestByName(name)).filter((q) => q !== undefined);
     }
     /**
-     * Build the quest registry mapping canonical names to quest objects.
-     * Uses QuestList as the source of truth for quest names.
+     * All quest objects available in this library.
+     * Adding a new quest file only requires: importing it above and appending it here.
+     */
+    static QUEST_OBJECTS = [
+        AKingdomDivided,
+        ANightAtTheTheatre,
+        APorcineOfInterest,
+        ARuffSituation,
+        ASoulsBane,
+        ATailOfTwoCats,
+        ATasteOfHope,
+        ATheatreOfBlood,
+        AnimalMagnetism,
+        AnotherSliceOfHAM,
+        AtFirstLight,
+        BelowIceMountain,
+        BeneathCursedSands,
+        BetweenARock,
+        BigChompyBirdHunting,
+        Biohazard,
+        BlackKnightsFortress,
+        BoneVoyage,
+        CabinFever,
+        ChildrenOfTheSun,
+        ClientOfKourend,
+        ClockTower,
+        ColdWar,
+        Contact,
+        CooksAssistant,
+        CrabQuest,
+        CreatureOfFenkenstrain,
+        CurrentAffairs,
+        DarknessOfHallowvale,
+        DeathOnTheIsle,
+        DeathPlateau,
+        DeathToTheDorgeshuun,
+        DefenderOfVarrock,
+        DemonSlayer,
+        DesertTreasure,
+        DesertTreasureIITheFallenEmpire,
+        DeviousMinds,
+        DoricQuest,
+        DragonSlayerI,
+        DragonSlayerII,
+        DreamMentor,
+        DruidicRitual,
+        DwarfCannon,
+        EadgarsRuse,
+        EaglesPeak,
+        ElementalWorkshopI,
+        ElementalWorkshopII,
+        EnakhrasLament,
+        EnlightenedJourney,
+        ErnestTheChicken,
+        EthicallyAcquiredAntiquities,
+        FairytaleIGrowingPains,
+        FairytaleIICureAQueen,
+        FallenFromGrace,
+        FamilyCrest,
+        FightArena,
+        FishingContest,
+        ForgettableTale,
+        GardenOfTranquillity,
+        GertrudesCat,
+        GettingAhead,
+        GhostsAhoy,
+        GoblinDiplomacy,
+        GrimTales,
+        HauntedMine,
+        HazeelCult,
+        HeroesQuest,
+        HolyGrail,
+        HorrorFromTheDeep,
+        IcthlarinsLittleHelper,
+        ImpCatcher,
+        InAidOfTheMyreque,
+        InSearchOfTheMyreque,
+        JunglePotion,
+        KingsRansom,
+        LandOfTheGoblins,
+        LearningTheRopes,
+        LegendsQuest,
+        LostCity,
+        LunarDiplomacy,
+        MakingFriendsWithMyArm,
+        MakingHistory,
+        MeatAndGreet,
+        MerlinsCrystal,
+        MisthalinMystery,
+        MonkeyMadness,
+        MonkeyMadnessII,
+        MonksFriend,
+        MountainDaughter,
+        MourningsEndPartI,
+        MourningsEndPartII,
+        MurderMystery,
+        MyArmsBigAdventure,
+        NatureSpirit,
+        ObservatoryQuest,
+        OlafsQuest,
+        OneSmallFavour,
+        Pandemonium,
+        PerilousMoons,
+        PiratesTreasure,
+        PlagueCity,
+        PriestInPeril,
+        PrinceAliRescue,
+        PryingTimes,
+        RagAndBoneMan,
+        RagAndBoneManII,
+        Ratcatchers,
+        RecipeForDisaster,
+        RecruitmentDrive,
+        Regicide,
+        RomeoAndJuliet,
+        RovingElves,
+        RoyalTrouble,
+        RumDeal,
+        RuneMysteries,
+        ScorpionCatcher,
+        Scrambled,
+        SeaSlug,
+        SecretsOfTheNorth,
+        ShadesOfMortton,
+        ShadowOfTheStorm,
+        ShadowsOfCustodia,
+        SheepHerder,
+        SheepShearer,
+        ShieldOfArrav,
+        ShiloVillage,
+        SinsOfTheFather,
+        SleepingGiants,
+        SongOfTheElves,
+        SpiritsOfTheElid,
+        SwanSong,
+        TaiBwoWannaiTrio,
+        TearsOfGuthix,
+        TempleOfTheEye,
+        TheAscentOfArceuus,
+        TheBloodMoonRises,
+        TheCorsairCurse,
+        TheCurseOfArrav,
+        TheDepthsOfDespair,
+        TheDigSite,
+        TheEyesOfGlouphrie,
+        TheFeud,
+        TheFinalDawn,
+        TheForsakenTower,
+        TheFremennikExiles,
+        TheFremennikIsles,
+        TheFremennikTrials,
+        TheGardenOfDeath,
+        TheGiantDwarf,
+        TheGolem,
+        TheGrandTree,
+        TheGreatBrainRobbery,
+        TheHandInTheSand,
+        TheHeartOfDarkness,
+        TheIdesOfMilk,
+        TheKnightsSword,
+        TheLostTribe,
+        ThePathOfGlouphrie,
+        TheQueenOfThieves,
+        TheRedReef,
+        TheRestlessGhost,
+        TheRibbitingTaleOfALilyPadLabourDispute,
+        TheSlugMenace,
+        TheTaleOfTheRighteous,
+        TheTempleOfIkov,
+        TheTouristTrap,
+        ThroneOfMiscellania,
+        TowerOfLife,
+        TreeGnomeVillage,
+        TribalTotem,
+        TrollRomance,
+        TrollStronghold,
+        TroubledTortugans,
+        TwilightsPromise,
+        UndergroundPass,
+        VampyreSlayer,
+        Wanted,
+        Watchtower,
+        WaterfallQuest,
+        WhatLiesBelow,
+        WhileGuthixSleeps,
+        WitchesPotion,
+        WitchsHouse,
+        XMarksTheSpot,
+        ZogreFleshEaters,
+        // Miniquests
+        AlfredGrimhandsBarcrawl,
+        BarbarianTraining,
+        BearYourSoul,
+        CurseOfTheEmptyLord,
+        DaddysHome,
+        EnterTheAbyss,
+        FamilyPest,
+        HisFaithfulServants,
+        HopespearsWill,
+        InSearchOfKnowledge,
+        IntoTheTombs,
+        LairOfTarnRazorlor,
+        MageArenaI,
+        MageArenaII,
+        SkippyAndTheMogres,
+        TheEnchantedKey,
+        TheFrozenDoor,
+        TheGeneralsShadow,
+        ValeTotems,
+    ];
+    /**
+     * Build the quest registry mapping normalized names to quest objects.
+     * Each quest is registered by its own `name` property, so it is findable
+     * both by exact name and fuzzy match via getQuestByName.
      * @returns Map of normalized quest names to Quest objects
      */
     static buildQuestRegistry() {
         const registry = new Map();
-        // All available quests imported above
-        const allQuests = {
-            AKingdomDivided,
-            ANightAtTheTheatre,
-            APorcineOfInterest,
-            ASoulsBane,
-            ATailOfTwoCats,
-            ATasteOfHope,
-            ATheatreOfBlood,
-            AnimalMagnetism,
-            AnotherSliceOfHAM,
-            AtFirstLight,
-            BelowIceMountain,
-            BeneathCursedSands,
-            BetweenARock,
-            BigChompyBirdHunting,
-            Biohazard,
-            BlackKnightsFortress,
-            BoneVoyage,
-            CabinFever,
-            ChildrenOfTheSun,
-            ClientOfKourend,
-            ClockTower,
-            ColdWar,
-            Contact,
-            CooksAssistant,
-            CreatureOfFenkenstrain,
-            CurrentAffairs,
-            DarknessOfHallowvale,
-            DeathOnTheIsle,
-            DeathPlateau,
-            DeathToTheDorgeshuun,
-            DefenderOfVarrock,
-            DemonSlayer,
-            DesertTreasure,
-            DesertTreasureI,
-            DesertTreasureIITheFallenEmpire,
-            DeviousMinds,
-            DoricQuest,
-            DoricsQuest,
-            DragonSlayerI,
-            DragonSlayerII,
-            DreamMentor,
-            DruidicRitual,
-            DwarfCannon,
-            EadgarsRuse,
-            EaglesPeak,
-            ElementalWorkshopI,
-            ElementalWorkshopII,
-            EnakhrasLament,
-            EnlightenedJourney,
-            ErnestTheChicken,
-            EthicallyAcquiredAntiquities,
-            FairytaleIGrowingPains,
-            FairytaleIICureAQueen,
-            FamilyCrest,
-            FightArena,
-            FishingContest,
-            ForgettableTale,
-            GardenOfTranquillity,
-            GertrudesCat,
-            GettingAhead,
-            GhostsAhoy,
-            GoblinDiplomacy,
-            GrimTales,
-            HauntedMine,
-            HazeelCult,
-            HeroesQuest,
-            HolyGrail,
-            HorrorFromTheDeep,
-            IcthlarinsLittleHelper,
-            ImpCatcher,
-            InAidOfTheMyreque,
-            InSearchOfTheMyreque,
-            JunglePotion,
-            KingsRansom,
-            LandOfTheGoblins,
-            LearningTheRopes,
-            LegendsQuest,
-            LostCity,
-            LunarDiplomacy,
-            MakingFriendsWithMyArm,
-            MakingHistory,
-            MeatAndGreet,
-            MerlinsCrystal,
-            MisthalinMystery,
-            MonkeyMadness,
-            MonkeyMadnessI,
-            MonkeyMadnessII,
-            MonksFriend,
-            MountainDaughter,
-            MourningsEndPartI,
-            MourningsEndPartII,
-            MurderMystery,
-            MyArmsBigAdventure,
-            NatureSpirit,
-            ObservatoryQuest,
-            OlafsQuest,
-            OneSmallFavour,
-            Pandemonium,
-            PerilousMoons,
-            PiratesTreasure,
-            PlagueCity,
-            PriestInPeril,
-            PrinceAliRescue,
-            PryingTimes,
-            RagAndBoneMan,
-            RagAndBoneManI,
-            RagAndBoneManII,
-            Ratcatchers,
-            RecipeForDisaster,
-            RecruitmentDrive,
-            Regicide,
-            RomeoAndJuliet,
-            RovingElves,
-            RoyalTrouble,
-            RumDeal,
-            RuneMysteries,
-            ScorpionCatcher,
-            Scrambled,
-            SeaSlug,
-            SecretsOfTheNorth,
-            ShadesOfMortton,
-            ShadowOfTheStorm,
-            ShadowsOfCustodia,
-            SheepHerder,
-            SheepShearer,
-            ShieldOfArrav,
-            ShiloVillage,
-            SinsOfTheFather,
-            SleepingGiants,
-            SlugMenace,
-            SongOfTheElves,
-            SpiritsOfTheElid,
-            SwanSong,
-            TaiBwoWannaiTrio,
-            TaleOfTheRighteous,
-            TearsOfGuthix,
-            TempleOfIkov,
-            TempleOfTheEye,
-            TheAscentOfArceuus,
-            TheCorsairCurse,
-            TheCurseOfArrav,
-            TheDepthsOfDespair,
-            TheDigSite,
-            TheEyesOfGlouphrie,
-            TheFeud,
-            TheFinalDawn,
-            TheForsakenTower,
-            TheFremennikExiles,
-            TheFremennikIsles,
-            TheFremennikTrials,
-            TheGardenOfDeath,
-            TheGiantDwarf,
-            TheGolem,
-            TheGrandTree,
-            TheGreatBrainRobbery,
-            TheHandInTheSand,
-            TheHeartOfDarkness,
-            TheIdesOfMilk,
-            TheKnightsSword,
-            TheLostTribe,
-            ThePathOfGlouphrie,
-            TheQueenOfThieves,
-            TheRestlessGhost,
-            TheRibbitingTaleOfALilyPadLabourDispute,
-            TheSlugMenace,
-            TheTaleOfTheRighteous,
-            TheTempleOfIkov,
-            TheTouristTrap,
-            ThroneOfMiscellania,
-            TowerOfLife,
-            TreeGnomeVillage,
-            TribalTotem,
-            TrollRomance,
-            TrollStronghold,
-            TroubledTortugans,
-            TwilightsPromise,
-            UndergroundPass,
-            VampyreSlayer,
-            Wanted,
-            Watchtower,
-            WaterfallQuest,
-            WhatLiesBelow,
-            WhileGuthixSleeps,
-            WitchesPotion,
-            WitchsHouse,
-            WitchsPotion,
-            XMarksTheSpot,
-            ZogreFleshEaters,
-        };
-        // Map canonical quest names from QuestList to quest objects
-        for (const questName of QuestList) {
-            const quest = QuestTool.findQuestByCanonicalName(questName, allQuests);
-            if (quest) {
-                registry.set(QuestTool.normalizeQuestName(questName), quest);
+        for (const quest of QuestTool.QUEST_OBJECTS) {
+            if (quest?.name) {
+                registry.set(QuestTool.normalizeQuestName(quest.name), quest);
             }
         }
         return registry;
     }
-    /**
-     * Find the quest object matching a canonical quest name from QuestList.
-     * Uses the quest's name property to match against the canonical name.
-     * @param canonicalName The canonical name from QuestList
-     * @param questMap Map of available quest objects
-     * @returns The matching Quest object or undefined
-     */
-    static findQuestByCanonicalName(canonicalName, questMap) {
-        // Direct match by quest.name property
-        for (const quest of Object.values(questMap)) {
-            if (quest &&
-                typeof quest === 'object' &&
-                'name' in quest &&
-                quest['name'] === canonicalName) {
-                return quest;
-            }
-        }
-        return undefined;
-    }
     /**
      * Normalize a quest name for comparison purposes.
      * Removes punctuation, extra spaces, and converts to lowercase.
@@ -574,57 +617,43 @@ class QuestTool {
      * @returns The maximum boost amount for the skill (positive integer, or 0 if unboostable)
      */
     static getMaxSkillBoost(skillName) {
-        // Data from https://oldschool.runescape.wiki/w/Temporary_skill_boost
-        const boosts = {
-            // No boost
-            Agility: 5,
-            Attack: 5,
-            // Spicy stew (orange)
-            Construction: 5,
-            // Admiral pie
-            Cooking: 5,
-            // Volcanic ash, Summer pie
-            Crafting: 3,
-            // Super combat potion, Overload(+)
-            Defence: 5,
-            // Spicy stew (yellow)
-            Farming: 5,
-            // Chef's delight(m)
-            Firemaking: 4,
-            // Spicy stew (orange)
-            Fishing: 5,
-            // Mushroom pie
-            Fletching: 3,
-            // Summer pie
-            Herblore: 5,
-            // Preserve, Prayer-boosting items
-            Hitpoints: 0,
-            // Wild pie
-            Hunter: 5,
-            // Super combat potion, Overload(+)
-            Magic: 4,
-            // Hunter potion
-            Mining: 3,
-            // Ranging potion, Overload(+)
-            Prayer: 2,
-            // Overload(+), Imbued heart
-            Ranged: 4,
-            // Garden pie
-            Runecraft: 5,
-            // Fletching potion
-            Slayer: 2,
-            // Dwarven stout(m)
-            Smithing: 4,
-            // Super combat potion, Overload(+)
-            Strength: 5,
-            // Botanical pie
-            Thieving: 5,
-            // Spicy stew (red)
-            Woodcutting: 3, // Spicy stew (orange)
-            // Add more as needed
-        };
-        const normalized = skillName.charAt(0).toUpperCase() + skillName.slice(1).toLowerCase();
-        return boosts[normalized] ?? 0;
+        return getMaxSkillBoost(skillName);
+    }
+    /**
+     * Evaluate whether an account meets a quest's requirements, including *why* it doesn't -
+     * per-requirement detail, plus which checks hiscores can't actually verify (item/location/
+     * Slayer-unlock/quest-point requirements). Recursively evaluates quest-prerequisite
+     * requirements the same way.
+     * @param quest The quest to evaluate
+     * @param account The account to evaluate it against
+     * @param visited (internal) Set of quest names already visited, to prevent infinite recursion
+     */
+    static evaluateEligibility(quest, account, visited = new Set()) {
+        if (visited.has(quest.name)) {
+            return { advisories: [], checks: [], eligible: true, unmet: [] };
+        }
+        visited.add(quest.name);
+        const result = evaluateRequirements((quest.requirements ?? []), account);
+        for (const check of result.checks) {
+            if (check.requirement.type !== RequirementType.Quest)
+                continue;
+            const prereqName = check.requirement.questName;
+            const prereq = QuestTool.getQuestByName(prereqName);
+            check.verifiable = true;
+            if (!prereq) {
+                check.met = false;
+                check.detail = `Could not find quest data for "${prereqName}"`;
+                continue;
+            }
+            const nested = QuestTool.evaluateEligibility(prereq, account, visited);
+            check.met = nested.eligible;
+            check.detail = nested.eligible
+                ? `${prereqName}'s requirements are currently met`
+                : `${prereqName}'s requirements aren't met yet (${nested.unmet.length} unmet)`;
+        }
+        const unmet = result.checks.filter(c => c.verifiable && !c.met);
+        const advisories = result.checks.filter(c => !c.verifiable);
+        return { advisories, checks: result.checks, eligible: unmet.length === 0, unmet };
     }
 }
 export { QuestTool };