tibiaway-ai 1.1.0 → 1.2.0

package/commands/boss.md

@@ -1,20 +1,42 @@
 ---
-description: Detailed boss mechanics, phases, strategy by vocation, and loot information
+description: Detailed boss mechanics, phases, strategy by vocation, and loot — backed by real TibiaWiki data
 ---
 
-Provide complete information about a Tibia boss. Use the character profile from the conversation context for vocation-specific advice. If no profile is available yet, ask for it first.
+Provide complete information about a Tibia boss. Use the character profile from conversation context for vocation-specific advice. If no profile is available, ask for it first.
 
 If no boss name was provided, ask: "¿Qué boss quieres enfrentar?"
 
-Then cover:
-1. **General description** — what it is, where it is, when/how it spawns
-2. **Key stats** — approximate HP, elemental weaknesses/resistances/immunities
-3. **Main mechanics** — attacks and damage, special mechanics, summons, unique behaviors
-4. **Phases** (if applicable) — behavior changes per phase
-5. **Preparation for the player's vocation** — optimal set, imbuements, supplies with quantities
-6. **Strategy by vocation** — positioning, skills, rotation for their specific vocation
-7. **Notable loot** — most valuable or interesting drops
-8. **Common mistakes and tips** — what NOT to do, non-obvious tricks
+## Step 1 — Fetch real data from TibiaWiki
+
+Before answering, fetch the creature data using this URL:
+`https://tibiawiki.dev/api/creatures/{boss name URL-encoded}`
+
+Example: for "The Pale Count" → `https://tibiawiki.dev/api/creatures/The%20Pale%20Count`
+
+Extract from the response:
+- `hp` — real hit points
+- `exp` — experience given
+- `maxdmg` — maximum damage output
+- `fireDmgMod`, `iceDmgMod`, `energyDmgMod`, `deathDmgMod`, `holyDmgMod`, `earthDmgMod`, `physicalDmgMod` — resistance modifiers (values >100% = weakness, <100% = resistance, 0% = immune)
+- `paraimmune` — immune to paralyze?
+- `loot` — array of dropped items with rarity
+- `location` — where it's found
+
+If the fetch fails or returns no results, warn the player that the name may not match TibiaWiki exactly, then proceed with general knowledge.
+
+## Step 2 — Answer using real data as ground truth
+
+Cover these sections:
+
+1. **Descripción general** — qué es, dónde está, cuándo/cómo aparece
+2. **Estadísticas clave** — HP, exp, max daño (usa los valores reales obtenidos)
+3. **Resistencias y debilidades** — interpreta los mods: >100% = debilidad, <100% = resistencia, 0% = inmune
+4. **Mecánicas principales** — ataques, summons, habilidades únicas
+5. **Fases** (si aplica) — cambios de comportamiento por fase
+6. **Preparación para la vocación del jugador** — set, imbuements, supplies con cantidades
+7. **Estrategia por vocación** — posicionamiento, skills, rotación
+8. **Loot destacado** — usa el loot real de TibiaWiki, menciona rarezas
+9. **Errores comunes y tips** — qué NO hacer, trucos no obvios
 
 If the boss has instant-kill mechanics, call them out explicitly.
 Respond in Spanish.

package/commands/hunt.md

@@ -1,8 +1,8 @@
 ---
-description: Suggest optimal hunting spots based on character profile, objective, and party setup
+description: Suggest optimal hunting spots backed by real TibiaWiki creature data
 ---
 
-Suggest the best hunting spots for the player. Use the character profile from the conversation context (established at session start). If no profile is available yet, ask for it first.
+Suggest the best hunting spots for the player. Use the character profile from conversation context. If no profile is available, ask for it first.
 
 Ask the player:
 1. Objective: exp / loot / profit / task
@@ -10,13 +10,36 @@ Ask the player:
 3. Premium account?
 4. Any restrictions or preferences?
 
-Then provide 3-5 prioritized hunting spots with:
-- Location name and main creatures
-- Estimated exp/hour for their level and vocation
+## Step 1 — Get creature names
+
+Based on the player's profile and answers, mentally list 6-8 creature names that match good hunting spots for their level and vocation.
+
+## Step 2 — Fetch real creature data from TibiaWiki
+
+For each creature, fetch:
+`https://tibiawiki.dev/api/creatures/{creature name URL-encoded}`
+
+Extract from each response:
+- `hp`, `exp` — real values
+- `maxdmg` — max damage
+- `location` — where they spawn
+- `bestiarylevel` — difficulty tier
+- `loot` — notable drops
+- Resistance modifiers (`fireDmgMod`, `iceDmgMod`, etc.)
+
+Only use creatures that return valid data from TibiaWiki. Discard any that don't exist.
+
+## Step 3 — Build recommendations using verified data
+
+Provide 3-5 prioritized hunting spots using only verified creatures.
+
+For each spot include:
+- Location name and main creatures (verified)
+- Estimated exp/hour for their level and vocation (base it on the real `exp` value per creature)
 - Estimated profit (positive or negative)
 - Access requirements (quests, level, etc.)
 - Vocation-specific tips
 - Solo viability
 
-Be specific with numbers. Use ranges when exact data isn't available.
+Be specific. Use the real HP and exp values from TibiaWiki to estimate rates.
 Respond in Spanish.

package/commands/quest.md

@@ -1,23 +1,46 @@
 ---
-description: Recommend quests based on level, vocation, and player objectives
+description: Recommend quests based on level, vocation, and objectives — backed by real TibiaWiki data
 ---
 
-Recommend Tibia quests for the player. Use the character profile from the conversation context. If no profile is available yet, ask for it first.
+Recommend Tibia quests for the player. Use the character profile from conversation context. If no profile is available, ask for it first.
 
 Ask the player:
-1. What are they looking for? (zone access / outfit / achievement / equipment reward / story)
+1. What are they looking for? (zone access / outfit / achievement / equipment reward / story / boss access)
 2. Do they have a party available?
 3. Anything specific they want or quests already completed?
 
-Then provide 3-5 recommended quests with:
-- Quest name
-- Why it's relevant for their profile and objective
-- Minimum recommended level
-- Prerequisites (other quests, items, etc.)
+## Step 1 — Get quest names
+
+Based on the player's profile and answers, identify 4-6 quest names that are relevant for their level and objective. Quest names in TibiaWiki typically end in "Quest" (e.g. "The Queen of the Banshees Quest").
+
+## Step 2 — Fetch real quest data from TibiaWiki
+
+For each quest, fetch:
+`https://tibiawiki.dev/api/quests/{quest name URL-encoded}`
+
+Extract from each response:
+- `lvl` — minimum level required
+- `lvlrec` — recommended level
+- `premium` — requires premium account?
+- `reward` — actual rewards
+- `dangers` — enemies encountered
+- `location` — where it takes place
+- `legend` — brief description
+
+Only use quests that return valid data. Discard any that don't exist.
+
+## Step 3 — Build recommendations using verified data
+
+Provide 3-5 recommended quests using only verified quests.
+
+For each quest include:
+- Quest name and why it's relevant for their profile and objective
+- Minimum level (use the real `lvl` value from TibiaWiki)
+- Prerequisites (other quests, items needed)
 - Estimated difficulty (easy/medium/hard)
-- Main reward
+- Main reward (use the real `reward` value from TibiaWiki)
 - Solo or party required?
-- Important tip or warning
+- Main dangers and one key tip
 
 Prioritize quests with the best effort-to-reward ratio for their current situation.
 Respond in Spanish.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tibiaway-ai",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Tu guía de Tibia powered by AI. Your path through Tibia, powered by AI.",
   "bin": {
     "tibiaway": "bin/tibiaway.js",

package/src/commands/boss.js

@@ -3,7 +3,8 @@ import ora from 'ora';
 import chalk from 'chalk';
 import { getCharacter } from '../utils/config.js';
 import { askClaude } from '../utils/api.js';
-import { error, highlight, separator } from '../utils/banner.js';
+import { fetchCreature, formatCreatureForPrompt } from '../tibia-items.js';
+import { error, highlight, separator, warn } from '../utils/banner.js';
 
 export async function handleBoss(bossName) {
   const character = getCharacter();
@@ -15,7 +16,6 @@ export async function handleBoss(bossName) {
   console.log(chalk.hex('#FF6B1A').bold('💀  BOSS ADVISOR\n'));
 
   let targetBoss = bossName;
-
   if (!targetBoss) {
     const answer = await inquirer.prompt([
       {
@@ -28,58 +28,53 @@ export async function handleBoss(bossName) {
     targetBoss = answer.boss.trim();
   }
 
-  const prompt = `Explícame todo sobre el boss: ${targetBoss}
-
-Dame información completa y detallada:
-
-1. DESCRIPCIÓN GENERAL
-   - Qué es, dónde está, historia/lore relevante
-   - Cuándo aparece / cómo se invoca / periodicidad
-
-2. ESTADÍSTICAS CLAVE
-   - HP aproximado
-   - Debilidades elementales y resistencias
-   - Inmunidades importantes
-
-3. MECÁNICAS PRINCIPALES
-   - Ataques que usa y daño aproximado
-   - Mecánicas especiales (summons, fases, habilidades únicas)
-   - Comportamientos que hay que conocer sí o sí
-
-4. FASES (si aplica)
-   - Descripción de cada fase y cambios de comportamiento
-
-5. PREPARACIÓN RECOMENDADA PARA MI PERSONAJE
-   - Set óptimo e imbuements
-   - Supplies necesarios (con cantidades estimadas)
-   - Level mínimo recomendado para mi vocación
+  console.log(chalk.hex('#888888')(`Analizando: ${targetBoss}\n`));
 
-6. ESTRATEGIA POR VOCACIÓN
-   - Cómo lo enfrento siendo ${character.vocation}
-   - Posicionamiento, skills a usar, rotación
+  // ── Buscar datos reales en TibiaWiki ──────────────────────────────────────
+  const spinner1 = ora({ text: 'Verificando en TibiaWiki...', color: 'cyan' }).start();
+  const creatureData = await fetchCreature(targetBoss);
+  spinner1.stop();
+
+  let contextBlock = '';
+  if (creatureData) {
+    console.log(chalk.hex('#4ade80')(`  ✓ Datos reales obtenidos de TibiaWiki`));
+    contextBlock = `
+DATOS REALES DE TIBIAWIKI (usa estos como base — no inventes stats):
+${formatCreatureForPrompt(creatureData)}
+`;
+  } else {
+    warn(`No se encontró "${targetBoss}" en TibiaWiki. Verifica el nombre exacto.`);
+    warn('Usando conocimiento general de IA (puede ser menos preciso).');
+  }
 
-7. LOOT DESTACADO
-   - Items más valiosos o interesantes del drop
+  // ── Prompt con datos reales ───────────────────────────────────────────────
+  const spinner2 = ora({ text: 'Consultando el libro de los bosses...', color: 'yellow' }).start();
 
-8. ERRORES COMUNES Y TIPS
-   - Qué NO hacer
-   - Trucos que no son obvios
+  const prompt = `Personaje: ${character.name} | ${character.vocation} | Level ${character.level}
+${contextBlock}
+Explícame todo sobre el boss: ${targetBoss}
 
-Sé específico. Si el boss tiene mecánicas que matan instant, mencionarlo claramente.`;
+1. DESCRIPCIÓN GENERAL — qué es, dónde está, cuándo/cómo aparece
+2. ESTADÍSTICAS CLAVE — HP, resistencias y debilidades${creatureData ? ' (usa los datos reales de arriba)' : ''}
+3. MECÁNICAS PRINCIPALES — ataques, daño, summons, habilidades únicas
+4. FASES (si aplica) — cambios de comportamiento por fase
+5. PREPARACIÓN PARA MI PERSONAJE — set, imbuements, supplies con cantidades
+6. ESTRATEGIA PARA ${character.vocation} — posicionamiento, skills, rotación
+7. LOOT DESTACADO — ítems más valiosos${creatureData && creatureData.loot.length ? ' (usa el loot real de arriba)' : ''}
+8. ERRORES COMUNES Y TIPS — qué NO hacer, trucos no obvios
 
-  console.log(chalk.hex('#888888')(`Analizando: ${targetBoss}\n`));
-  const spinner = ora({ text: 'Consultando el libro de los bosses...', color: 'yellow' }).start();
+Si el boss tiene mecánicas de instant kill, menciónalas claramente.`;
 
   try {
     const response = await askClaude(prompt);
-    spinner.stop();
+    spinner2.stop();
     separator();
     console.log('');
     console.log(chalk.hex('#f0f0f0')(response));
     console.log('');
     separator();
   } catch (err) {
-    spinner.stop();
+    spinner2.stop();
     error(`Error al consultar la IA: ${err.message}`);
   }
 }

package/src/commands/hunt.js

@@ -3,8 +3,23 @@ import ora from 'ora';
 import chalk from 'chalk';
 import { getCharacter } from '../utils/config.js';
 import { askClaude } from '../utils/api.js';
+import { validateCreatures, formatCreaturesForPrompt } from '../tibia-items.js';
 import { error, highlight, separator } from '../utils/banner.js';
 
+function extractCreatureNames(text) {
+  try {
+    const jsonMatch = text.match(/\[[\s\S]*\]/);
+    if (jsonMatch) {
+      const arr = JSON.parse(jsonMatch[0]);
+      if (Array.isArray(arr)) return arr.filter(v => typeof v === 'string' && v.trim().length > 0);
+    }
+  } catch {}
+  // Fallback: extraer líneas que parecen nombres de criaturas
+  return text.split('\n')
+    .map(l => l.replace(/^[-*\d.]+\s*/, '').trim())
+    .filter(l => l.length > 2 && l.length < 60 && !l.includes(':'));
+}
+
 export async function handleHunt() {
   const character = getCharacter();
   if (!character) {
@@ -45,42 +60,85 @@ export async function handleHunt() {
     {
       type: 'input',
       name: 'restricciones',
-      message: highlight('¿Alguna restricción o preferencia? (zonas, criaturas, etc.) — Enter para saltar:'),
+      message: highlight('¿Alguna restricción o preferencia? (Enter para saltar):'),
     },
   ]);
 
-  const prompt = `Dame las mejores recomendaciones de hunting spots para mi personaje.
+  // ── PASO 1: IA sugiere criaturas ──────────────────────────────────────────
+  console.log('');
+  const spinner1 = ora({ text: 'Consultando sugerencias de criaturas...', color: 'yellow' }).start();
+
+  const stepOnePrompt = `Personaje: ${character.name} | ${character.vocation} | Level ${character.level} | Mundo: ${character.world}
+Objetivo: ${answers.objetivo} | Modalidad: ${answers.party} | Premium: ${answers.premium ? 'Sí' : 'No'}
+${answers.restricciones ? `Preferencias: ${answers.restricciones}` : ''}
+
+Lista las 6 a 8 criaturas principales de los mejores hunting spots para este personaje.
+Responde SOLO con un array JSON, sin texto adicional:
+["Criatura 1", "Criatura 2", "Criatura 3", ...]
+Solo criaturas que existen en Tibia. Nombres exactos como aparecen en el juego.`;
 
-Objetivo: ${answers.objetivo}
-Modalidad: ${answers.party}
-Cuenta Premium: ${answers.premium ? 'Sí' : 'No'}
-${answers.restricciones ? `Preferencias/restricciones: ${answers.restricciones}` : ''}
+  let creatureNames = [];
+  try {
+    const suggestion = await askClaude(stepOnePrompt);
+    spinner1.stop();
+    creatureNames = extractCreatureNames(suggestion);
+  } catch (err) {
+    spinner1.fail('Error al consultar la IA.');
+    error(err.message);
+    return;
+  }
 
-Por favor dame entre 3 y 5 hunting spots recomendados, ordenados por prioridad para mi objetivo.
+  if (creatureNames.length === 0) {
+    error('No se pudieron extraer nombres de criaturas.');
+    return;
+  }
+
+  // ── PASO 2: Validar contra TibiaWiki ─────────────────────────────────────
+  const spinner2 = ora({ text: `Verificando ${creatureNames.length} criaturas en TibiaWiki...`, color: 'cyan' }).start();
+  const { verified, notFound } = await validateCreatures(creatureNames);
+  spinner2.stop();
+
+  const verifiedCount = Object.keys(verified).length;
+  console.log(chalk.hex('#4ade80')(`  ✓ ${verifiedCount} criaturas verificadas en TibiaWiki`));
+  if (notFound.length > 0) {
+    console.log(chalk.hex('#888')(`  ✗ No encontradas: ${notFound.join(', ')}`));
+  }
+
+  // ── PASO 3: IA arma la recomendación con datos reales ────────────────────
+  console.log('');
+  const spinner3 = ora({ text: 'Armando tu guía de hunting...', color: 'yellow' }).start();
+
+  const creaturesData = formatCreaturesForPrompt(verified);
+
+  const stepThreePrompt = `Personaje: ${character.name} | ${character.vocation} | Level ${character.level} | Mundo: ${character.world}
+Objetivo: ${answers.objetivo} | Modalidad: ${answers.party} | Premium: ${answers.premium ? 'Sí' : 'No'}
+${answers.restricciones ? `Preferencias: ${answers.restricciones}` : ''}
+
+CRIATURAS VERIFICADAS EN TIBIAWIKI con stats reales:
+${creaturesData}
+
+Con estas criaturas verificadas, dame 3 a 5 hunting spots recomendados ordenados por prioridad.
 
 Para cada spot incluye:
-1. Nombre del lugar y criaturas principales
+1. Nombre del lugar y criaturas principales (de la lista verificada)
 2. Exp/hora estimada para mi level y vocación
-3. Profit estimado (positivo o negativo)
+3. Profit estimado
 4. Requisitos de acceso (quests, level, etc.)
-5. Tips específicos para mi vocación
-6. ¿Necesita party o funciona bien solo?
+5. Tips específicos para ${character.vocation}
+6. ¿Funciona solo o necesita party?
 
-Sé específico con los números. Si no tienes datos exactos, da rangos razonables.`;
-
-  console.log('');
-  const spinner = ora({ text: 'Consultando al oráculo tibian...', color: 'yellow' }).start();
+Basa los datos de HP, exp y loot en los valores reales de TibiaWiki.`;
 
   try {
-    const response = await askClaude(prompt);
-    spinner.stop();
+    const response = await askClaude(stepThreePrompt);
+    spinner3.stop();
     separator();
     console.log('');
     console.log(chalk.hex('#f0f0f0')(response));
     console.log('');
     separator();
   } catch (err) {
-    spinner.stop();
+    spinner3.stop();
     error(`Error al consultar la IA: ${err.message}`);
   }
 }

package/src/commands/quest.js

@@ -3,8 +3,22 @@ import ora from 'ora';
 import chalk from 'chalk';
 import { getCharacter } from '../utils/config.js';
 import { askClaude } from '../utils/api.js';
+import { validateQuests, formatQuestsForPrompt } from '../tibia-items.js';
 import { error, highlight, separator } from '../utils/banner.js';
 
+function extractQuestNames(text) {
+  try {
+    const jsonMatch = text.match(/\[[\s\S]*\]/);
+    if (jsonMatch) {
+      const arr = JSON.parse(jsonMatch[0]);
+      if (Array.isArray(arr)) return arr.filter(v => typeof v === 'string' && v.trim().length > 0);
+    }
+  } catch {}
+  return text.split('\n')
+    .map(l => l.replace(/^[-*\d.]+\s*/, '').trim())
+    .filter(l => l.length > 3 && l.length < 80 && !l.includes(':'));
+}
+
 export async function handleQuest() {
   const character = getCharacter();
   if (!character) {
@@ -38,43 +52,87 @@ export async function handleQuest() {
     {
       type: 'input',
       name: 'contexto',
-      message: highlight('¿Algo específico que quieras o que ya hayas completado? (Enter para saltar):'),
+      message: highlight('¿Algo específico o quests ya completadas? (Enter para saltar):'),
     },
   ]);
 
-  const prompt = `Dame recomendaciones de quests para mi personaje.
+  // ── PASO 1: IA sugiere nombres de quests ──────────────────────────────────
+  console.log('');
+  const spinner1 = ora({ text: 'Buscando quests recomendadas...', color: 'yellow' }).start();
 
-Objetivo: ${answers.objetivo}
-Party disponible: ${answers.party ? 'Sí' : 'No (solo)'}
-${answers.contexto ? `Contexto adicional: ${answers.contexto}` : ''}
+  const stepOnePrompt = `Personaje: ${character.name} | ${character.vocation} | Level ${character.level} | Mundo: ${character.world}
+Objetivo: ${answers.objetivo} | Party disponible: ${answers.party ? 'Sí' : 'No'}
+${answers.contexto ? `Contexto: ${answers.contexto}` : ''}
 
-Dame entre 3 y 5 quests recomendadas para mi level y vocación.
+Lista los nombres exactos de 4 a 6 quests de Tibia recomendadas para este personaje.
+Responde SOLO con un array JSON, sin texto adicional:
+["Nombre Quest 1", "Nombre Quest 2", ...]
+Solo quests que existen en Tibia. Nombres exactos como aparecen en TibiaWiki (generalmente terminan en "Quest").`;
 
-Para cada quest incluye:
-1. Nombre de la quest
-2. Por qué es relevante para mi perfil y objetivo
-3. Level mínimo recomendado
-4. Prerequisitos (otras quests, items, etc.)
-5. Dificultad estimada (fácil/media/difícil)
-6. Reward principal
-7. ¿Necesita party o se puede hacer solo?
-8. Tip o advertencia importante
+  let questNames = [];
+  try {
+    const suggestion = await askClaude(stepOnePrompt);
+    spinner1.stop();
+    questNames = extractQuestNames(suggestion);
+  } catch (err) {
+    spinner1.fail('Error al consultar la IA.');
+    error(err.message);
+    return;
+  }
 
-Prioriza quests con mejor relación esfuerzo/recompensa para mi situación actual.`;
+  if (questNames.length === 0) {
+    error('No se pudieron extraer nombres de quests.');
+    return;
+  }
 
+  // ── PASO 2: Validar contra TibiaWiki ─────────────────────────────────────
+  const spinner2 = ora({ text: `Verificando ${questNames.length} quests en TibiaWiki...`, color: 'cyan' }).start();
+  const { verified, notFound } = await validateQuests(questNames);
+  spinner2.stop();
+
+  const verifiedCount = Object.keys(verified).length;
+  console.log(chalk.hex('#4ade80')(`  ✓ ${verifiedCount} quests verificadas en TibiaWiki`));
+  if (notFound.length > 0) {
+    console.log(chalk.hex('#888')(`  ✗ No encontradas: ${notFound.join(', ')}`));
+  }
+
+  // ── PASO 3: IA arma la recomendación con datos reales ────────────────────
   console.log('');
-  const spinner = ora({ text: 'Consultando el grimorio de quests...', color: 'yellow' }).start();
+  const spinner3 = ora({ text: 'Armando tu guía de quests...', color: 'yellow' }).start();
+
+  const questsData = formatQuestsForPrompt(verified);
+  const hasVerified = verifiedCount > 0;
+
+  const stepThreePrompt = `Personaje: ${character.name} | ${character.vocation} | Level ${character.level}
+Objetivo: ${answers.objetivo} | Party disponible: ${answers.party ? 'Sí' : 'No'}
+${answers.contexto ? `Contexto: ${answers.contexto}` : ''}
+
+${hasVerified ? `QUESTS VERIFICADAS EN TIBIAWIKI con datos reales:
+${questsData}
+
+Con estas quests verificadas, dame` : 'Dame'} 3 a 5 quests recomendadas para este personaje.
+
+Para cada quest incluye:
+1. Nombre y por qué es relevante para el objetivo
+2. Level mínimo recomendado ${hasVerified ? '(usa el dato real de TibiaWiki)' : ''}
+3. Prerequisitos (otras quests, items necesarios)
+4. Dificultad estimada (fácil/media/difícil)
+5. Reward principal ${hasVerified ? '(usa el reward real de TibiaWiki)' : ''}
+6. ¿Solo o necesita party?
+7. Peligros principales y tip clave
+
+Prioriza por mejor relación esfuerzo/recompensa para este personaje.`;
 
   try {
-    const response = await askClaude(prompt);
-    spinner.stop();
+    const response = await askClaude(stepThreePrompt);
+    spinner3.stop();
     separator();
     console.log('');
     console.log(chalk.hex('#f0f0f0')(response));
     console.log('');
     separator();
   } catch (err) {
-    spinner.stop();
+    spinner3.stop();
     error(`Error al consultar la IA: ${err.message}`);
   }
 }

package/src/commands/set.js

@@ -3,8 +3,33 @@ import ora from 'ora';
 import chalk from 'chalk';
 import { getCharacter } from '../utils/config.js';
 import { askClaude } from '../utils/api.js';
+import { validateItems, formatItemsForPrompt } from '../tibia-items.js';
 import { error, highlight, separator } from '../utils/banner.js';
 
+const SLOTS = ['Helmet', 'Armor', 'Legs', 'Boots', 'Weapon', 'Offhand', 'Amulet', 'Ring'];
+
+function extractItemNames(text) {
+  // Intenta parsear JSON del response de la IA
+  try {
+    const jsonMatch = text.match(/\{[\s\S]*\}/);
+    if (jsonMatch) {
+      const obj = JSON.parse(jsonMatch[0]);
+      return Object.values(obj).filter(v => typeof v === 'string' && v.trim().length > 0);
+    }
+  } catch {}
+
+  // Fallback: extraer líneas con formato "Slot: Item Name"
+  const names = [];
+  for (const line of text.split('\n')) {
+    const match = line.match(/:\s*(.+)$/);
+    if (match) {
+      const val = match[1].trim().replace(/["""]/g, '');
+      if (val && val.length > 2 && !val.startsWith('-')) names.push(val);
+    }
+  }
+  return names;
+}
+
 export async function handleSet() {
   const character = getCharacter();
   if (!character) {
@@ -50,45 +75,94 @@ export async function handleSet() {
     },
   ]);
 
-  const prompt = `Arma el set óptimo para mi personaje en esta situación.
+  // ── PASO 1: La IA sugiere nombres de ítems ───────────────────────────────
+  console.log('');
+  const spinner1 = ora({ text: 'Consultando sugerencias de ítems...', color: 'yellow' }).start();
 
-Situación: ${answers.situacion}
-Presupuesto: ${answers.budget}
-${answers.zona ? `Zona/criaturas: ${answers.zona}` : ''}
+  const stepOnePrompt = `Personaje: ${character.name} | ${character.vocation} | Level ${character.level} | Mundo: ${character.world}
+Situación: ${answers.situacion} | Presupuesto: ${answers.budget}
+${answers.zona ? `Zona: ${answers.zona}` : ''}
 ${answers.items_actuales ? `Equipo actual: ${answers.items_actuales}` : ''}
 
-Dame:
-1. SET RECOMENDADO - slot por slot:
-   - Helmet / Armor / Legs / Boots / Shield (si aplica) / Weapon / Offhand / Amulet / Ring / Backpack
+Lista los mejores ítems de Tibia para este personaje, uno por slot.
+Responde SOLO con un JSON con este formato exacto, sin texto adicional:
+{
+  "Helmet": "nombre exacto del ítem",
+  "Armor": "nombre exacto del ítem",
+  "Legs": "nombre exacto del ítem",
+  "Boots": "nombre exacto del ítem",
+  "Weapon": "nombre exacto del ítem",
+  "Offhand": "nombre exacto del ítem o null si no aplica",
+  "Amulet": "nombre exacto del ítem",
+  "Ring": "nombre exacto del ítem"
+}
+Solo ítems que existen en Tibia. Nombres exactos como aparecen en el juego.`;
 
-2. IMBUEMENTS - por cada pieza que aplique:
-   - Qué imbu poner y por qué
-   - Versión económica vs versión ideal
+  let itemNames = [];
+  try {
+    const suggestion = await askClaude(stepOnePrompt);
+    spinner1.stop();
+    itemNames = extractItemNames(suggestion);
+  } catch (err) {
+    spinner1.fail('Error al consultar la IA.');
+    error(err.message);
+    return;
+  }
 
-3. SUPPLIES recomendados por hora de hunt:
-   - Potiones (tipo y cantidad)
-   - Runes (si aplica)
-   - Food
-   - Otros consumibles importantes
+  if (itemNames.length === 0) {
+    error('No se pudieron extraer nombres de ítems de la respuesta.');
+    return;
+  }
+
+  // ── PASO 2: Validar contra TibiaWiki ─────────────────────────────────────
+  const spinner2 = ora({ text: `Verificando ${itemNames.length} ítems en TibiaWiki...`, color: 'cyan' }).start();
+  const { verified, notFound } = await validateItems(itemNames);
+  spinner2.stop();
+
+  const verifiedCount = Object.keys(verified).length;
 
-4. ALTERNATIVAS BUDGET-FRIENDLY:
-   - Opciones más baratas para cada slot crítico
+  if (verifiedCount === 0) {
+    error('No se pudo verificar ningún ítem en TibiaWiki. Intenta de nuevo.');
+    return;
+  }
 
-Sé específico con nombres de ítems. Explica brevemente el por qué de cada elección importante.`;
+  console.log(chalk.hex('#4ade80')(`  ✓ ${verifiedCount} ítems verificados en TibiaWiki`));
+  if (notFound.length > 0) {
+    console.log(chalk.hex('#888')(`  ✗ No encontrados: ${notFound.join(', ')}`));
+  }
 
+  // ── PASO 3: La IA arma el set final con stats reales ─────────────────────
   console.log('');
-  const spinner = ora({ text: 'Armando tu set óptimo...', color: 'yellow' }).start();
+  const spinner3 = ora({ text: 'Armando tu set con datos reales...', color: 'yellow' }).start();
+
+  const verifiedItemsList = formatItemsForPrompt(verified);
+
+  const stepThreePrompt = `Personaje: ${character.name} | ${character.vocation} | Level ${character.level}
+Situación: ${answers.situacion} | Presupuesto: ${answers.budget}
+${answers.zona ? `Zona: ${answers.zona}` : ''}
+${answers.items_actuales ? `Equipo actual: ${answers.items_actuales}` : ''}
+
+Ítems verificados en TibiaWiki con sus stats reales:
+${verifiedItemsList}
+
+Con estos ítems verificados, dame:
+1. SET RECOMENDADO — slot por slot con justificación breve
+2. IMBUEMENTS — qué imbu poner en cada pieza con imbu slots, versión económica vs ideal
+3. SUPPLIES recomendados por hora de hunt
+4. ALTERNATIVAS más baratas para los slots más caros
+
+Usa solo los ítems verificados de la lista. Si un slot quedó sin verificar, menciónalo.`;
 
   try {
-    const response = await askClaude(prompt);
-    spinner.stop();
+    const response = await askClaude(stepThreePrompt);
+    spinner3.stop();
     separator();
     console.log('');
     console.log(chalk.hex('#f0f0f0')(response));
     console.log('');
     separator();
   } catch (err) {
-    spinner.stop();
+    spinner3.stop();
     error(`Error al consultar la IA: ${err.message}`);
   }
 }

package/src/tibia-items.js

@@ -0,0 +1,218 @@
+import fetch from 'node-fetch';
+
+const TIBIAWIKI_BASE = 'https://tibiawiki.dev/api/items';
+const CREATURES_BASE = 'https://tibiawiki.dev/api/creatures';
+const QUESTS_BASE = 'https://tibiawiki.dev/api/quests';
+
+export async function fetchItemDetails(itemName) {
+  try {
+    const res = await fetch(`${TIBIAWIKI_BASE}/${encodeURIComponent(itemName)}`, {
+      headers: { 'Accept': 'application/json' },
+      timeout: 6000,
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    if (!data || !data.name) return null;
+    return {
+      name: data.name,
+      slot: data.slot || null,
+      armor: data.armor || null,
+      attack: data.attack || null,
+      defense: data.def || null,
+      levelRequired: data.levelrequired || null,
+      vocRequired: data.vocrequired || null,
+      imbuSlots: data.imbueslots || null,
+      attrib: data.attrib || null,
+      resist: data.resist || null,
+      primaryType: data.primarytype || null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+export async function validateItems(itemNames) {
+  const results = await Promise.all(
+    itemNames.map(async (name) => {
+      const data = await fetchItemDetails(name);
+      return { name, data };
+    })
+  );
+
+  const verified = {};
+  const notFound = [];
+
+  for (const { name, data } of results) {
+    if (data) {
+      verified[name] = data;
+    } else {
+      notFound.push(name);
+    }
+  }
+
+  return { verified, notFound };
+}
+
+export function formatItemsForPrompt(verified) {
+  return Object.values(verified).map(item => {
+    const parts = [`${item.name}`];
+    if (item.slot) parts.push(`slot: ${item.slot}`);
+    if (item.armor) parts.push(`armor: ${item.armor}`);
+    if (item.attack) parts.push(`attack: ${item.attack}`);
+    if (item.defense) parts.push(`def: ${item.defense}`);
+    if (item.levelRequired) parts.push(`level req: ${item.levelRequired}`);
+    if (item.vocRequired) parts.push(`voc: ${item.vocRequired}`);
+    if (item.imbuSlots) parts.push(`imbu slots: ${item.imbuSlots}`);
+    if (item.attrib) parts.push(`attrib: ${item.attrib}`);
+    if (item.resist) parts.push(`resist: ${item.resist}`);
+    return parts.join(' | ');
+  }).join('\n');
+}
+
+// ── Wiki markup cleanup ────────────────────────────────────────────────────
+
+function stripWiki(text) {
+  if (!text) return null;
+  return text
+    .replace(/\[\[([^\]|]+\|)?([^\]]+)\]\]/g, '$2') // [[link|text]] → text
+    .replace(/\{\{Max Damage\|([^}]+)\}\}/g, (_, inner) => {
+      // {{Max Damage|physical=500|fire=250}} → "físico 500, fuego 250"
+      return inner.split('|').map(part => {
+        const [k, v] = part.split('=');
+        return v ? `${k} ${v}` : k;
+      }).join(', ');
+    })
+    .replace(/\{\{[^}]+\}\}/g, '') // remove remaining templates
+    .replace(/'''|''|<[^>]+>/g, '') // bold, italic, html tags
+    .trim();
+}
+
+// ── Creatures ─────────────────────────────────────────────────────────────
+
+export async function fetchCreature(name) {
+  try {
+    const res = await fetch(`${CREATURES_BASE}/${encodeURIComponent(name)}`, {
+      headers: { 'Accept': 'application/json' },
+      timeout: 6000,
+    });
+    if (!res.ok) return null;
+    const d = await res.json();
+    if (!d || !d.name) return null;
+    return {
+      name: d.name,
+      hp: d.hp || null,
+      exp: d.exp || null,
+      maxdmg: stripWiki(d.maxdmg),
+      armor: d.armor || null,
+      location: stripWiki(d.location),
+      isboss: d.isboss || null,
+      bestiarylevel: d.bestiarylevel || null,
+      paraimmune: d.paraimmune || null,
+      physicalDmgMod: d.physicalDmgMod || null,
+      fireDmgMod: d.fireDmgMod || null,
+      iceDmgMod: d.iceDmgMod || null,
+      energyDmgMod: d.energyDmgMod || null,
+      deathDmgMod: d.deathDmgMod || null,
+      holyDmgMod: d.holyDmgMod || null,
+      earthDmgMod: d.earthDmgMod || null,
+      loot: d.loot || [],
+    };
+  } catch {
+    return null;
+  }
+}
+
+export async function validateCreatures(names) {
+  const results = await Promise.all(names.map(async (name) => {
+    const data = await fetchCreature(name);
+    return { name, data };
+  }));
+  const verified = {};
+  const notFound = [];
+  for (const { name, data } of results) {
+    if (data) verified[name] = data;
+    else notFound.push(name);
+  }
+  return { verified, notFound };
+}
+
+export function formatCreatureForPrompt(c) {
+  const parts = [c.name];
+  if (c.hp) parts.push(`HP: ${c.hp}`);
+  if (c.exp) parts.push(`Exp: ${c.exp}`);
+  if (c.maxdmg) parts.push(`Max dmg: ${c.maxdmg}`);
+  if (c.location) parts.push(`Ubicación: ${c.location}`);
+  if (c.bestiarylevel) parts.push(`Bestiary: ${c.bestiarylevel}`);
+  const mods = [];
+  if (c.physicalDmgMod && c.physicalDmgMod !== '100%') mods.push(`físico ${c.physicalDmgMod}`);
+  if (c.fireDmgMod && c.fireDmgMod !== '100%') mods.push(`fuego ${c.fireDmgMod}`);
+  if (c.iceDmgMod && c.iceDmgMod !== '100%') mods.push(`hielo ${c.iceDmgMod}`);
+  if (c.energyDmgMod && c.energyDmgMod !== '100%') mods.push(`energía ${c.energyDmgMod}`);
+  if (c.deathDmgMod && c.deathDmgMod !== '100%') mods.push(`muerte ${c.deathDmgMod}`);
+  if (c.holyDmgMod && c.holyDmgMod !== '100%') mods.push(`sagrado ${c.holyDmgMod}`);
+  if (c.earthDmgMod && c.earthDmgMod !== '100%') mods.push(`tierra ${c.earthDmgMod}`);
+  if (mods.length) parts.push(`Resistencias: ${mods.join(', ')}`);
+  if (c.paraimmune === 'yes') parts.push('Inmune a parálisis');
+  if (c.loot.length > 0) {
+    const topLoot = c.loot.slice(0, 6).map(l => l.itemName).join(', ');
+    parts.push(`Loot: ${topLoot}`);
+  }
+  return parts.join(' | ');
+}
+
+export function formatCreaturesForPrompt(verified) {
+  return Object.values(verified).map(formatCreatureForPrompt).join('\n');
+}
+
+// ── Quests ────────────────────────────────────────────────────────────────
+
+export async function fetchQuest(name) {
+  try {
+    const res = await fetch(`${QUESTS_BASE}/${encodeURIComponent(name)}`, {
+      headers: { 'Accept': 'application/json' },
+      timeout: 6000,
+    });
+    if (!res.ok) return null;
+    const d = await res.json();
+    if (!d || !d.name) return null;
+    return {
+      name: d.name,
+      lvl: d.lvl || null,
+      lvlrec: d.lvlrec || null,
+      premium: d.premium || null,
+      reward: stripWiki(d.reward),
+      dangers: stripWiki(d.dangers),
+      location: stripWiki(d.location),
+      legend: stripWiki(d.legend),
+    };
+  } catch {
+    return null;
+  }
+}
+
+export async function validateQuests(names) {
+  const results = await Promise.all(names.map(async (name) => {
+    const data = await fetchQuest(name);
+    return { name, data };
+  }));
+  const verified = {};
+  const notFound = [];
+  for (const { name, data } of results) {
+    if (data) verified[name] = data;
+    else notFound.push(name);
+  }
+  return { verified, notFound };
+}
+
+export function formatQuestsForPrompt(verified) {
+  return Object.values(verified).map(q => {
+    const parts = [q.name];
+    if (q.lvl) parts.push(`Level mín: ${q.lvl}`);
+    if (q.lvlrec) parts.push(`Level rec: ${q.lvlrec}`);
+    if (q.premium) parts.push(`Premium: ${q.premium}`);
+    if (q.reward) parts.push(`Reward: ${q.reward}`);
+    if (q.dangers) parts.push(`Peligros: ${q.dangers}`);
+    if (q.location) parts.push(`Ubicación: ${q.location}`);
+    return parts.join(' | ');
+  }).join('\n');
+}