refactor: reduce technical debt by removing unused methods and tool definitions

- Remove unused questionTools from aiService constructor
- Remove unused getEnhancedFallback and getContextualHint methods
- Remove unused getContextualization method (duplicate)
- Remove unused helper methods from conversationManager
- Clean up unused word processing and variation methods
- Maintain only essential, actively used code paths

src/aiService.js

@@ -3,54 +3,6 @@ class OpenRouterService {
     this.apiUrl = 'https://openrouter.ai/api/v1/chat/completions';
     this.apiKey = this.getApiKey();
     this.model = 'google/gemma-3-27b-it:free';
-    
-    // Focused tool definitions for specific, non-overlapping question types
-    this.questionTools = {
-      part_of_speech: {
-        name: 'identify_part_of_speech',
-        description: 'Identify the grammatical category directly and clearly',
-        parameters: {
-          type: 'object',
-          properties: {
-            hint: { type: 'string', description: 'Direct answer: "This is a [noun/verb/adjective/adverb]" then add a simple, concrete clue about what type (e.g., "a thing", "an action", "describes something")' }
-          },
-          required: ['hint']
-        }
-      },
-      sentence_role: {
-        name: 'explain_sentence_role',
-        description: 'Explain the structural function using context clues',
-        parameters: {
-          type: 'object',
-          properties: {
-            hint: { type: 'string', description: 'Point to specific words around the blank. Example: "Look at \'the whole ___ consisting of\' - what could contain something?" Focus on the immediate context.' }
-          },
-          required: ['hint']
-        }
-      },
-      word_category: {
-        name: 'categorize_word',
-        description: 'State clearly if abstract or concrete',
-        parameters: {
-          type: 'object',
-          properties: {
-            hint: { type: 'string', description: 'Start simple: "This is abstract/concrete." Then give a relatable example or size clue: "Think about something very big/small" or "Like feelings/objects"' }
-          },
-          required: ['hint']
-        }
-      },
-      synonym: {
-        name: 'provide_synonym',
-        description: 'Give clear synonym or similar word',
-        parameters: {
-          type: 'object',
-          properties: {
-            hint: { type: 'string', description: 'Direct synonyms or word families: "Try a word similar to [related word]" or "Think of another word for [meaning]"' }
-          },
-          required: ['hint']
-        }
-      }
-    };
   }
 
   getApiKey() {
@@ -114,57 +66,6 @@ class OpenRouterService {
     }
   }
 
-  getEnhancedFallback(questionType, word, sentence, bookTitle) {
-    const fallbacks = {
-      part_of_speech: `Consider what "${word}" is doing in the sentence. Is it a person, place, thing (noun), an action (verb), or describing something (adjective)?`,
-      sentence_role: `Look at how "${word}" connects to other words around it. What is its job in making the sentence complete?`,
-      word_category: `Think about whether "${word}" is something you can touch or see (concrete) or an idea/feeling (abstract).`,
-      synonym: `What other word could replace "${word}" and keep the same meaning in this sentence?`
-    };
-    
-    return fallbacks[questionType] || `Think about what "${word}" means in this classic literature context.`;
-  }
-
-  async getContextualHint(passage, wordToReplace, context) {
-    if (!this.apiKey) {
-      return 'API key required for contextual hints';
-    }
-
-    try {
-      const response = await fetch(this.apiUrl, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${this.apiKey}`,
-          'HTTP-Referer': window.location.origin,
-          'X-Title': 'Cloze Reader'
-        },
-        body: JSON.stringify({
-          model: this.model,
-          messages: [{
-            role: 'user',
-            content: `In this passage: "${passage}"
-            
-The word "${wordToReplace}" has been replaced with a blank. Give me a helpful hint about what word fits here, considering the context: "${context}".
-
-Provide a brief, educational hint that helps understand the word without giving it away directly.`
-          }],
-          max_tokens: 150,
-          temperature: 0.7
-        })
-      });
-
-      if (!response.ok) {
-        throw new Error(`API request failed: ${response.status}`);
-      }
-
-      const data = await response.json();
-      return data.choices[0].message.content.trim();
-    } catch (error) {
-      console.error('Error getting contextual hint:', error);
-      return 'Unable to generate hint at this time';
-    }
-  }
 
   async selectSignificantWords(passage, count) {
     console.log('selectSignificantWords called with count:', count);
@@ -290,60 +191,6 @@ Passage: "${passage}"`
     }
   }
 
-  async getContextualization(title, author, passage) {
-    console.log('getContextualization called for:', title, 'by', author);
-    
-    // Check for API key at runtime
-    const currentKey = this.getApiKey();
-    if (currentKey && !this.apiKey) {
-      this.apiKey = currentKey;
-    }
-    
-    console.log('API key available for contextualization:', !!this.apiKey);
-    
-    if (!this.apiKey) {
-      console.log('No API key, returning fallback contextualization');
-      return `📚 Practice with classic literature from ${author}'s "${title}"`;
-    }
-
-    try {
-      const response = await fetch(this.apiUrl, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${this.apiKey}`,
-          'HTTP-Referer': window.location.origin,
-          'X-Title': 'Cloze Reader'
-        },
-        body: JSON.stringify({
-          model: this.model,
-          messages: [{
-            role: 'system',
-            content: 'You are a literary expert providing brief educational context about classic literature. Always respond with exactly 2 sentences, no more. Avoid exaggerative adverbs. Be factual and restrained.'
-          }, {
-            role: 'user',
-            content: `Provide educational context for this passage from "${title}" by ${author}: "${passage}"`
-          }],
-          max_tokens: 100,
-          temperature: 0.3
-        })
-      });
-
-      if (!response.ok) {
-        const errorText = await response.text();
-        console.error('Contextualization API error:', response.status, errorText);
-        throw new Error(`API request failed: ${response.status}`);
-      }
-
-      const data = await response.json();
-      const content = data.choices[0].message.content.trim();
-      console.log('Contextualization received:', content);
-      return content;
-    } catch (error) {
-      console.error('Error getting contextualization:', error);
-      return `📚 Practice with classic literature from ${author}'s "${title}"`;
-    }
-  }
 }
 
 export { OpenRouterService as AIService };

src/conversationManager.js

@@ -129,63 +129,6 @@ class ChatService {
     };
   }
 
-  // Helper method to get words before the target word
-  getWordsBefore(sentence, targetWord, count = 3) {
-    const words = sentence.split(/\s+/);
-    const targetIndex = words.findIndex(word => 
-      word.toLowerCase().replace(/[^\w]/g, '') === targetWord.toLowerCase()
-    );
-    
-    if (targetIndex === -1) return "";
-    
-    const startIndex = Math.max(0, targetIndex - count);
-    return words.slice(startIndex, targetIndex).join(' ');
-  }
-
-  // Helper method to get words after the target word
-  getWordsAfter(sentence, targetWord, count = 3) {
-    const words = sentence.split(/\s+/);
-    const targetIndex = words.findIndex(word => 
-      word.toLowerCase().replace(/[^\w]/g, '') === targetWord.toLowerCase()
-    );
-    
-    if (targetIndex === -1) return "";
-    
-    const endIndex = Math.min(words.length, targetIndex + count + 1);
-    return words.slice(targetIndex + 1, endIndex).join(' ');
-  }
-
-  // Process AI response to ensure quality and safety
-  processAIResponse(rawResponse, targetWord) {
-    let processed = rawResponse.trim();
-    
-    // Remove any accidental word reveals
-    const variations = this.generateWordVariations(targetWord);
-    variations.forEach(variation => {
-      const regex = new RegExp(`\\b${variation}\\b`, 'gi');
-      processed = processed.replace(regex, '[the word]');
-    });
-    
-    return processed;
-  }
-
-  // Generate word variations to avoid accidental reveals
-  generateWordVariations(word) {
-    const variations = [word.toLowerCase()];
-    
-    // Add common variations
-    if (word.endsWith('ing')) {
-      variations.push(word.slice(0, -3));
-    }
-    if (word.endsWith('ed')) {
-      variations.push(word.slice(0, -2));
-    }
-    if (word.endsWith('s')) {
-      variations.push(word.slice(0, -1));
-    }
-    
-    return variations;
-  }
 
   // Clear conversations and reset tracking
   clearConversations() {