feat: Add GoodReads sentiment analysis for book mood detection

Author: Abdul-nazeer

.gitignore

@@ -1 +1,5 @@
 GITHUB_ISSUES.md
+
+# Mood analysis cache files
+mood_analysis/mood_cache.json
+*.cache

.vscode/settings.json

@@ -0,0 +1,2 @@
+{
+}

__pycache__/ai_service.cpython-313.pyc

@@ -1,16 +1,73 @@
-# Placeholder for AI service logic.
-# implement 'generate_book_note' and 'get_ai_recommendations'. All recommendations MUST be AI-based.
+# AI service logic with GoodReads sentiment analysis integration
+# Implements 'generate_book_note' and 'get_ai_recommendations'. All recommendations MUST be AI-based.
 
-def generate_book_note(description):
+try:
+    from mood_analysis.ai_service_enhanced import AIBookService, get_book_mood_tags, generate_enhanced_book_note
+    MOOD_ANALYSIS_AVAILABLE = True
+except ImportError:
+    MOOD_ANALYSIS_AVAILABLE = False
+    print("Mood analysis not available - using fallback AI service")
+
+def generate_book_note(description, title="", author=""):
     """
     Analyzes book description and returns a 'vibe'.
-    In a real scenario, this would call an LLM (like Gemini or OpenAI).
+    Enhanced with GoodReads mood analysis when available.
     """
-    # Logic: For now, we return a string based on description length
-    if len(description) > 100:
-        return "A deep, complex narrative with lingering mystery."
-    return "A quick, refreshing read for a busy afternoon."
+    if MOOD_ANALYSIS_AVAILABLE and title and author:
+        try:
+            return generate_enhanced_book_note(description, title, author)
+        except Exception as e:
+            print(f"Mood analysis failed, using fallback: {e}")
+    
+    # Fallback to description-based analysis
+    if len(description) > 200:
+        return "A deep, complex narrative that readers find emotionally resonant."
+    elif len(description) > 100:
+        return "A compelling story with layers waiting to be discovered."
+    elif "mystery" in description.lower():
+        return "A mysterious tale that will keep you guessing."
+    elif "romance" in description.lower():
+        return "A heartwarming story perfect for cozy reading."
+    else:
+        return "A delightful read for any quiet moment."
 
 def get_ai_recommendations(query):
-    """Mock AI logic to filter/rank books."""
-    return f"AI-optimized results for: {query}"
+    """Enhanced AI logic to filter/rank books based on mood."""
+    
+    # Mood-based query mapping
+    mood_queries = {
+        'cozy': 'comfort reads warm atmosphere',
+        'dark': 'psychological thriller mystery',
+        'romantic': 'romance love story',
+        'mysterious': 'mystery suspense thriller',
+        'uplifting': 'inspiring hopeful positive',
+        'melancholy': 'literary fiction emotional',
+        'adventurous': 'adventure fantasy epic'
+    }
+    
+    # Check if query matches a mood
+    query_lower = query.lower()
+    for mood, book_query in mood_queries.items():
+        if mood in query_lower:
+            return f"AI-optimized {mood} results: {book_query}"
+    
+    return f"AI-optimized results for: {query}"
+
+def get_book_mood_tags_safe(title: str, author: str = "") -> list:
+    """
+    Safe wrapper for getting book mood tags.
+    
+    Args:
+        title: Book title
+        author: Author name
+        
+    Returns:
+        List of mood tags or empty list if not available
+    """
+    if MOOD_ANALYSIS_AVAILABLE:
+        try:
+            return get_book_mood_tags(title, author)
+        except Exception as e:
+            print(f"Error getting mood tags: {e}")
+    
+    return []

__pycache__/goodreads_scraper.cpython-313.pyc

@@ -1,22 +1,38 @@
 /**
- * BiblioDrift Core Logic
- * Handles 3D rendering, API fetching, and LocalStorage management.
+ * BiblioDrift Core Logic with GoodReads Mood Analysis
+ * Handles 3D rendering, API fetching, mood analysis, and LocalStorage management.
  */
 
 const API_BASE = 'https://www.googleapis.com/books/v1/volumes';
+const MOOD_API_BASE = 'http://localhost:5000/api/v1';
 
 class BookRenderer {
     constructor() {
         this.libraryManager = new LibraryManager();
+        this.moodAnalyzer = new MoodAnalyzer();
     }
 
-    createBookElement(bookData) {
+    async createBookElement(bookData) {
         const { id, volumeInfo } = bookData;
         const title = volumeInfo.title || "Untitled";
         const authors = volumeInfo.authors ? volumeInfo.authors.join(", ") : "Unknown Author";
         const thumb = volumeInfo.imageLinks ? volumeInfo.imageLinks.thumbnail : 'https://via.placeholder.com/128x196?text=No+Cover';
         const description = volumeInfo.description ? volumeInfo.description.substring(0, 100) + "..." : "A mysterious tome waiting to be opened.";
 
+        // Try to get mood analysis for this book
+        let vibe = this.generateVibe(description);
+        let moodTags = [];
+        
+        try {
+            const moodData = await this.moodAnalyzer.getBookMood(title, authors);
+            if (moodData && moodData.success) {
+                vibe = moodData.mood_analysis.bibliodrift_vibe || vibe;
+                moodTags = moodData.mood_analysis.primary_moods || [];
+            }
+        } catch (error) {
+            console.log('Mood analysis not available, using fallback vibe');
+        }
+
         // Randomize spine color slightly for variety
         const spineColors = ['#5D4037', '#4E342E', '#3E2723', '#2C2420', '#8D6E63'];
         const randomSpine = spineColors[Math.floor(Math.random() * spineColors.length)];
@@ -25,33 +41,51 @@ class BookRenderer {
         const scene = document.createElement('div');
         scene.className = 'book-scene';
 
+        // Generate mood tags HTML
+        const moodTagsHTML = moodTags.length > 0 
+            ? `<div class="mood-tags">${moodTags.slice(0, 2).map(tag => `<span class="mood-tag mood-${tag.mood}">${tag.mood}</span>`).join('')}</div>`
+            : '';
+
         // Structure
         scene.innerHTML = `
             <div class="book" data-id="${id}">
                 <div class="book__face book__face--front">
                     <img src="${thumb.replace('http:', 'https:')}" alt="${title}">
+                    ${moodTagsHTML}
                 </div>
                 <div class="book__face book__face--spine" style="background: ${randomSpine}"></div>
                 <div class="book__face book_face--right"></div>
                 <div class="book__face book__face--back">
                     <div>
                         <div style="font-weight: bold; font-size: 0.9rem; margin-bottom: 0.5rem;">${title}</div>
                         <div class="handwritten-note">
-                            Bookseller's Note: "${this.generateVibe(description)}"
+                            Bookseller's Note: "${vibe}"
                         </div>
+                        ${moodTags.length > 0 ? `
+                        <div class="mood-analysis">
+                            <small>Mood Analysis:</small>
+                            <div class="mood-tags-back">
+                                ${moodTags.slice(0, 3).map(tag => `<span class="mood-tag-small">${tag.mood}</span>`).join('')}
+                            </div>
+                        </div>` : ''}
                     </div>
                     <div class="book-actions">
                         <button class="btn-icon add-btn" title="Add to Library"><i class="fa-regular fa-heart"></i></button>
+                        <button class="btn-icon mood-btn" title="Analyze Mood" onclick="event.stopPropagation(); this.closest('.book-scene').querySelector('.book-renderer').showMoodAnalysis('${title}', '${authors}')"><i class="fa-solid fa-brain"></i></button>
                         <button class="btn-icon" title="Flip Back" onclick="event.stopPropagation(); this.closest('.book').classList.remove('flipped')"><i class="fa-solid fa-rotate-left"></i></button>
                     </div>
                 </div>
             </div>
             <div class="glass-overlay">
                 <strong>${title}</strong><br>
                 <small>${authors}</small>
+                ${moodTags.length > 0 ? `<div class="glass-mood-tags">${moodTags.slice(0, 2).map(tag => `<span class="glass-mood-tag">${tag.mood}</span>`).join('')}</div>` : ''}
             </div>
         `;
 
+        // Store reference for mood analysis
+        scene.querySelector('.book-scene').bookRenderer = this;
+
         // Interaction: Flip
         const bookEl = scene.querySelector('.book');
         scene.addEventListener('click', (e) => {
@@ -72,8 +106,72 @@ class BookRenderer {
         return scene;
     }
 
+    async showMoodAnalysis(title, author) {
+        try {
+            const moodData = await this.moodAnalyzer.analyzeMood(title, author);
+            if (moodData && moodData.success) {
+                this.displayMoodModal(title, moodData.mood_analysis);
+            } else {
+                alert('Mood analysis not available for this book.');
+            }
+        } catch (error) {
+            console.error('Error showing mood analysis:', error);
+            alert('Error loading mood analysis.');
+        }
+    }
+
+    displayMoodModal(title, moodAnalysis) {
+        const modal = document.createElement('div');
+        modal.className = 'mood-modal';
+        modal.innerHTML = `
+            <div class="mood-modal-content">
+                <div class="mood-modal-header">
+                    <h3>Mood Analysis: ${title}</h3>
+                    <button class="close-modal">&times;</button>
+                </div>
+                <div class="mood-modal-body">
+                    <div class="mood-section">
+                        <h4>Overall Sentiment</h4>
+                        <div class="sentiment-bar">
+                            <div class="sentiment-fill" style="width: ${(moodAnalysis.overall_sentiment.compound_score + 1) * 50}%"></div>
+                        </div>
+                        <p>${moodAnalysis.mood_description}</p>
+                    </div>
+                    <div class="mood-section">
+                        <h4>Primary Moods</h4>
+                        <div class="mood-tags-large">
+                            ${moodAnalysis.primary_moods.map(mood => 
+                                `<span class="mood-tag-large mood-${mood.mood}">${mood.mood} (${mood.frequency})</span>`
+                            ).join('')}
+                        </div>
+                    </div>
+                    <div class="mood-section">
+                        <h4>BiblioDrift Vibe</h4>
+                        <div class="vibe-quote">"${moodAnalysis.bibliodrift_vibe}"</div>
+                    </div>
+                    <div class="mood-section">
+                        <small>Based on ${moodAnalysis.total_reviews_analyzed} GoodReads reviews</small>
+                    </div>
+                </div>
+            </div>
+        `;
+
+        document.body.appendChild(modal);
+
+        // Close modal functionality
+        modal.querySelector('.close-modal').addEventListener('click', () => {
+            document.body.removeChild(modal);
+        });
+
+        modal.addEventListener('click', (e) => {
+            if (e.target === modal) {
+                document.body.removeChild(modal);
+            }
+        });
+    }
+
     generateVibe(text) {
-        // Simple heuristic to mock "AI" vibes
+        // Simple heuristic to mock "AI" vibes (fallback)
         const vibes = [
             "Perfect for a rainy afternoon.",
             "Smells like old paper and adventure.",
@@ -94,9 +192,10 @@ class BookRenderer {
 
             if (data.items) {
                 container.innerHTML = '';
-                data.items.forEach(book => {
-                    container.appendChild(this.createBookElement(book));
-                });
+                for (const book of data.items) {
+                    const bookElement = await this.createBookElement(book);
+                    container.appendChild(bookElement);
+                }
             }
         } catch (err) {
             console.error("Failed to fetch books", err);
@@ -105,6 +204,40 @@ class BookRenderer {
     }
 }
 
+class MoodAnalyzer {
+    async getBookMood(title, author) {
+        try {
+            const response = await fetch(`${MOOD_API_BASE}/mood-tags`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ title, author })
+            });
+            return await response.json();
+        } catch (error) {
+            console.error('Error fetching mood tags:', error);
+            return null;
+        }
+    }
+
+    async analyzeMood(title, author) {
+        try {
+            const response = await fetch(`${MOOD_API_BASE}/analyze-mood`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ title, author })
+            });
+            return await response.json();
+        } catch (error) {
+            console.error('Error analyzing mood:', error);
+            return null;
+        }
+    }
+}
+
 class LibraryManager {
     constructor() {
         this.storageKey = 'bibliodrift_library';