INTELLISENSE_FEATURE_SUMMARY.md

@@ -1,73 +0,0 @@
-# Library IntelliSense Feature - File Summary
-
-## New Files Created
-
-1. **`/src/app/api/libraries/intellisense/route.ts`**
-   - API endpoint for listing directories and identifying already added libraries
-   - Handles security validation and path resolution
-   - Returns structured JSON response with directory information
-   - Supports navigation through directory hierarchy
-
-2. **`/docs/active/fixes-enhancements/LIBRARY_INTELLISENSE_FEATURE.md`**
-   - Detailed documentation of the IntelliSense feature
-   - Technical implementation details
-   - Usage instructions and testing information
-
-3. **`/tests/test-intellisense.mjs`**
-   - Test script to verify basic IntelliSense functionality
-   - Validates directory listing and path formatting
-
-4. **`/tests/test-library-check.mjs`**
-   - Test script to verify library conflict detection
-   - Tests the "already added as library" functionality
-
-5. **`/tests/test-navigation.mjs`**
-   - Test script to verify navigation functionality
-   - Tests directory hierarchy navigation
-
-## Modified Files
-
-1. **`/src/app/settings/page.tsx`**
-   - Added IntelliSense states for UI management
-   - Implemented "Browse" button functionality
-   - Created modal dialog for folder selection with navigation
-   - Added dedicated "Select" buttons for each folder item
-   - Implemented "Select as Library" option for current path
-   - Integrated with existing library management functions
-   - Added visual indicators for already added libraries
-
-2. **`/docs/FEATURE_STATUS.md`**
-   - Added "Library IntelliSense Feature" to the list of production ready features
-   - Included documentation link and implementation status
-
-3. **`/docs/README.md`**
-   - Updated "Recent Fixes & Enhancements" section to include library IntelliSense
-
-## Feature Summary
-
-The IntelliSense feature enhances the library management experience by providing:
-
-1. **Intelligent Folder Selection**
-   - Lists directories under `/mnt` for easy library addition
-   - Allows navigation through directory structure by clicking on folders
-   - Prevents addition of duplicate libraries
-
-2. **Enhanced Navigation**
-   - Click on any folder to navigate into it
-   - Use ".." to go to parent directory
-   - Dedicated "Select" button for each folder to choose it as library root
-   - "Select as Library" option for current directory
-
-3. **Visual Feedback**
-   - Greys out and disables selection of already added libraries
-   - Shows current path being explored
-   - Displays modification dates for folders
-   - Provides clear visual indicators of library status
-
-4. **Enhanced User Experience**
-   - Modal dialog interface for folder browsing
-   - Integration with existing library management workflow
-   - Automatic population of library path input field
-   - Flexible selection options (navigate or select directly)
-
-The feature has been thoroughly tested and is ready for production use.

docs/DOCUMENTATION_ORGANIZATION.md

@@ -17,10 +17,6 @@
 - `CLUSTER_FOLDER_API_TESTS.md` - API testing guide
 - `CLUSTER_FOLDER_PHASE1_COMPLETE.md` - Phase 1 completion
 - `CLUSTER_FOLDER_PHASE2_COMPLETE.md` - Phase 2 completion
-- `LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md` - Enhanced scan requirements
-- `LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md` - Enhanced scan architecture
-- `LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md` - Enhanced scan implementation plan
-- `LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md` - Enhanced scan summary
 
 #### **Media Management & Streaming** ✅ COMPLETE
 - `TRANSCODING_REMOVAL_DESIGN.md` - Transcoding removal architecture
@@ -153,7 +149,7 @@ docs/
 ├── README.md                          # Main navigation hub
 ├── FEATURE_STATUS.md                  # Current feature status
 ├── active/                           # Current features
-│   ├── library-clusters/             # Library cluster docs (16)
+│   ├── library-clusters/             # Library cluster docs (12)
 │   ├── media-streaming/              # Core streaming docs (8)
 │   ├── media-streaming-root/         # Additional streaming (3)
 │   ├── recommendations/              # Surprise Me docs (6)

docs/FEATURE_STATUS.md

@@ -59,31 +59,7 @@
 - **Target**: Support 50,000+ files efficiently
 - **Last Updated**: 2025-10-13
 
-### **6. Library Scan Enhancement** 📋 **PLANNING COMPLETE**
+### **6. Testing Framework** ✅ **COMPLETE**
-- **Status**: Comprehensive enhancement package documented
-- **Features**:
-  - File deletion detection and automatic cleanup
-  - Missing thumbnail verification and regeneration
-  - Real-time progress reporting with WebSocket updates
-  - Enhanced error handling with recovery mechanisms
-  - Concurrent processing for improved performance
-  - Transaction-based operations for data integrity
-- **Documentation**: `active/library-clusters/` (4 comprehensive docs)
-- **Implementation**: 18-23 hours estimated for Phase 1
-- **Priority**: 🔴 Critical - Core functionality gaps
-- **Last Updated**: 2025-10-13
-
-### **7. Library IntelliSense Feature** ✅ **COMPLETE**
-- **Status**: Fully implemented and tested
-- **Features**:
-  - Intelligent folder selection when adding libraries
-  - Directory listing under `/mnt` with navigation
-  - Visual indication of already added libraries
-  - Prevention of duplicate library additions
-- **Documentation**: `active/fixes-enhancements/LIBRARY_INTELLISENSE_FEATURE.md`
-- **Last Updated**: 2025-10-18
-
-### **8. Testing Framework** ✅ **COMPLETE**
 - **Status**: Comprehensive test suite implemented
 - **Features**:
   - Player integration testing (ArtPlayer, HLS)

docs/README.md

@@ -31,7 +31,7 @@ Intelligent content discovery system
 Latest improvements and bug fixes
 - 📁 [`active/fixes-enhancements/`](active/fixes-enhancements/) - Fix documentation
 - ✅ **Status**: Implemented and tested
-- 🎯 **Features**: Auto-close fixes, migration guides, implementation tracking, library IntelliSense
+- 🎯 **Features**: Auto-close fixes, migration guides, implementation tracking
 
 #### **Performance Optimization**
 Systematic performance improvements for large datasets
@@ -39,17 +39,6 @@ Systematic performance improvements for large datasets
 - ✅ **Status**: Implementation planning complete
 - 🎯 **Features**: API pagination, virtual scrolling, database optimization, caching strategy
 
-#### **Library Scan Enhancement**
-Enhanced scanning with file cleanup, thumbnail recovery, and progress tracking
-- 📁 [`active/library-clusters/`](active/library-clusters/) - Enhanced scan documentation (4 docs)
-- 📁 **Requirements**: [`LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md`](active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md)
-- 📁 **Architecture**: [`LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md`](active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md)
-- 📁 **Implementation**: [`LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md`](active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md)
-- 📁 **Summary**: [`LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md`](active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md)
-- 📋 **Status**: Planning complete, ready for development
-- 🎯 **Features**: File cleanup, thumbnail recovery, progress tracking, error handling
-- ⚡ **Priority**: 🔴 Critical - Core functionality gaps
-
 ### **🧪 Testing Suite**
 Comprehensive testing framework for all components
 - 📁 [`tests/`](../tests/) - Test scripts and utilities
@@ -101,7 +90,6 @@ open http://localhost:3000
 | Folder Bookmarks | ✅ Complete | 100% |
 | Performance Optimization | ✅ Planning Complete | 100% |
 | Testing Framework | ✅ Complete | 100% |
-| Library Scan Enhancement | 📋 Planning Complete | 100% |
 | Surprise Me (MVP) | ⚠️ Partial | 43% |
 | Recommendation ML | 📋 Planned | 0% |
 

docs/active/fixes-enhancements/LIBRARY_INTELLISENSE_FEATURE.md

@@ -1,85 +0,0 @@
-# IntelliSense Feature for Library Management
-
-## Overview
-This feature enhances the library management experience by providing an intelligent folder selection interface when adding new libraries. It lists directories under `/mnt` and allows users to easily navigate and select folders, while preventing the addition of duplicate libraries.
-
-## Features Implemented
-
-### 1. IntelliSense API Endpoint
-- **Location**: `/api/libraries/intellisense`
-- **Functionality**: 
-  - Lists directories under a specified base path (default: `/mnt`)
-  - Identifies which directories are already added as libraries
-  - Provides structured JSON response with directory information
-  - Supports navigation through directory hierarchy
-  - Includes file metadata (size, modification date)
-
-### 2. Enhanced Settings UI
-- **Browse Button**: Added a "Browse" button next to the library path input field
-- **Modal Interface**: Opens a modal dialog for folder selection when "Browse" is clicked
-- **Navigation**: Allows users to navigate through directory structure by clicking on folders
-- **Visual Indicators**: Greys out and disables selection of folders already added as libraries
-- **Path Display**: Shows the current path being explored
-- **Separate Selection**: Each folder item has a dedicated "Select" button to choose it as a library root
-- **Current Path Selection**: Option to select the currently displayed directory as a library
-
-### 3. Library Conflict Prevention
-- Automatically detects if a folder is already added as a library
-- Prevents re-adding existing libraries through the UI
-- Clearly indicates which folders are already libraries
-
-## Technical Implementation
-
-### API Endpoint
-The IntelliSense API endpoint (`/api/libraries/intellisense`) accepts the following query parameters:
-- `basePath`: The base directory to explore (default: `/mnt`)
-- `subPath`: A subdirectory path to explore within the base path
-
-The response includes:
-- `path`: The current directory path being explored
-- `parentPath`: The parent directory path (null if at root)
-- `items`: An array of directory items with:
-  - `name`: Directory name
-  - `path`: Full directory path
-  - `isDirectory`: Boolean indicating if the item is a directory
-  - `isAlreadyLibrary`: Boolean indicating if the directory is already added as a library
-  - `size`: Size of the directory
-  - `modified`: Last modification date
-
-### Frontend Integration
-The settings page was modified to include:
-- State management for IntelliSense items and UI visibility
-- Functions to fetch and display directory listings
-- Modal dialog for folder selection with navigation capabilities
-- Dedicated "Select" buttons for each folder item
-- Integration with existing library management functionality
-
-## Usage Instructions
-
-1. Navigate to the Settings page
-2. In the "Media Libraries" section, click the "Browse" button next to the library path input
-3. A modal dialog will appear showing directories under `/mnt`
-4. To navigate into a folder, click on the folder name
-5. To select a folder as a library root:
-   - Click the "Select" button next to the folder name, OR
-   - Click "Select as Library" next to the current path display
-6. The selected path will be populated in the library path input field
-7. Click "Add" to add the library
-
-## Navigation Features
-
-- **Folder Navigation**: Click on any folder name to navigate into that directory
-- **Parent Navigation**: Use the ".." entry or the "Back to /mnt" button to navigate up
-- **Current Directory Selection**: Use the "Select as Library" button next to the path display to select the currently viewed directory
-- **Direct Selection**: Each folder has a dedicated "Select" button to choose it as a library root without navigating into it
-
-## Testing
-
-The feature has been thoroughly tested with:
-- Directory listing functionality
-- Library conflict detection
-- UI interaction and navigation
-- Edge cases and error handling
-- Navigation through directory hierarchy
-
-All tests pass successfully, confirming that the IntelliSense feature works as expected.

docs/active/library-clusters/IMPLEMENTATION_COMPLETE.md

@@ -1,461 +0,0 @@
-# Library Scan Enhancement - Implementation Complete ✅
-
-## 🎉 **Implementation Summary**
-
-The library scan enhancement has been **successfully implemented** following the simplified design plan. All code changes have been completed, tested for compilation, and are ready for use.
-
----
-
-## ✅ **What Was Implemented**
-
-### **1. File Deletion Cleanup** ✓
-
-**Function**: `cleanupDeletedFiles()`  
-**Location**: [`src/lib/scanner.ts`](file:///root/workspace/nextav/src/lib/scanner.ts#L54-L92)
-
-**What it does**:
-- Gets all media records for a library from database
-- Compares database records with files found in current scan
-- Double-checks file existence on disk before deletion (safety measure)
-- Deletes orphaned database records for missing files
-- Logs each deletion with clear console messages
-- Returns count of removed records
-
-**Console Output Example**:
-```
-✓ Removed orphaned record: /path/to/deleted/file.mp4
-✓ Removed orphaned record: /path/to/another/file.mkv
-📊 Cleanup complete: 2 orphaned record(s) removed
-```
-
----
-
-### **2. Thumbnail Verification & Regeneration** ✓
-
-**Function**: `verifyAndRegenerateThumbnail()`  
-**Location**: [`src/lib/scanner.ts`](file:///root/workspace/nextav/src/lib/scanner.ts#L94-L145)
-
-**What it does**:
-- Checks if thumbnail file exists on disk for each media record
-- Skips verification for fallback thumbnails (already using placeholder)
-- Regenerates missing thumbnails using existing generation functions
-- Updates database with new thumbnail path
-- Falls back to type-based placeholder on regeneration failure
-- Logs regeneration actions
-
-**Console Output Example**:
-```
-🔄 Regenerating missing thumbnail for: video.mp4
-✓ Successfully regenerated thumbnail: video.mp4
-✗ Failed to regenerate thumbnail for: corrupted.avi
-```
-
----
-
-### **3. Enhanced Scan Function** ✓
-
-**Function**: `scanLibrary()`  
-**Location**: [`src/lib/scanner.ts`](file:///root/workspace/nextav/src/lib/scanner.ts#L147-L312)
-
-**Enhancements**:
-- Added statistics tracking object
-- Calls `cleanupDeletedFiles()` before processing files
-- Calls `verifyAndRegenerateThumbnail()` for existing media files
-- Enhanced console logging with emojis and clear formatting
-- Returns statistics object with all metrics
-- Error handling continues processing on individual failures
-
-**Console Output Example**:
-```
-📚 Starting scan for library: /media/videos
-📁 Found 150 media files
-
-🧹 Checking for deleted files...
-✓ Removed orphaned record: /media/videos/old.mp4
-📊 Cleanup complete: 1 orphaned record(s) removed
-
-⚙️  Processing files...
-✓ Added video: new_movie.mp4 with thumbnail
-🔄 Regenerating missing thumbnail for: existing.mkv
-✓ Successfully regenerated thumbnail: existing.mkv
-
-📊 Scan Complete:
-   Files Processed: 150
-   Files Added: 5
-   Files Removed: 1
-   Thumbnails Regenerated: 3
-```
-
----
-
-### **4. Updated Export Functions** ✓
-
-**Functions**: `scanAllLibraries()` and `scanSelectedLibrary()`  
-**Location**: [`src/lib/scanner.ts`](file:///root/workspace/nextav/src/lib/scanner.ts#L314-L354)
-
-**Enhancements**:
-- `scanAllLibraries()` now aggregates statistics from all libraries
-- Both functions return statistics objects
-- Enhanced console logging for aggregate results
-
-**Console Output Example** (All Libraries):
-```
-🎉 All Libraries Scan Complete:
-   Total Files Processed: 450
-   Total Files Added: 15
-   Total Files Removed: 3
-   Total Thumbnails Regenerated: 8
-```
-
----
-
-### **5. Enhanced API Response** ✓
-
-**Endpoint**: `POST /api/scan`  
-**Location**: [`src/app/api/scan/route.ts`](file:///root/workspace/nextav/src/app/api/scan/route.ts)
-
-**Enhancement**:
-- API now returns statistics in response
-- Includes success flag and detailed stats
-
-**API Response Example**:
-```json
-{
-  "success": true,
-  "message": "Library scan complete",
-  "stats": {
-    "filesProcessed": 150,
-    "filesAdded": 5,
-    "filesRemoved": 1,
-    "thumbnailsRegenerated": 3,
-    "errors": 0
-  }
-}
-```
-
----
-
-## 📝 **Files Modified**
-
-### **Core Implementation**
-- ✅ [`src/lib/scanner.ts`](file:///root/workspace/nextav/src/lib/scanner.ts) - Main scanner enhancement (3 helper functions + enhanced scan logic)
-
-### **API Enhancement**
-- ✅ [`src/app/api/scan/route.ts`](file:///root/workspace/nextav/src/app/api/scan/route.ts) - Return statistics in response
-
-**Total Files Modified**: 2
-
----
-
-## 🔍 **Code Changes Summary**
-
-### **New Imports**
-```typescript
-import { promises as fsPromises } from "fs";
-import type { Database as DatabaseType } from "better-sqlite3";
-```
-
-### **New Helper Functions**
-1. `getThumbnailPathFromUrl(url: string): string` - Convert thumbnail URL to file path
-2. `cleanupDeletedFiles(db, libraryId, currentFiles): Promise<{ removed: number }>` - File deletion cleanup
-3. `verifyAndRegenerateThumbnail(media): Promise<{ regenerated: boolean }>` - Thumbnail verification
-
-### **Enhanced Functions**
-1. `scanLibrary()` - Enhanced with cleanup and verification steps
-2. `scanAllLibraries()` - Now returns aggregate statistics
-3. `scanSelectedLibrary()` - Now returns statistics
-4. `POST /api/scan` - Enhanced API response with stats
-
----
-
-## ✅ **Build Verification**
-
-Build completed successfully with no errors:
-```bash
-✓ Compiled successfully
-✓ No TypeScript errors
-✓ All imports resolved
-✓ Production build created
-```
-
-**Build Directory**: `.next/` (updated Oct 14, 2025)
-
----
-
-## 🧪 **Testing Instructions**
-
-### **Manual Testing**
-
-#### **Test 1: File Deletion Cleanup**
-
-**Setup**:
-```bash
-# 1. Add some video files to a library folder
-cp test-videos/*.mp4 /path/to/library/
-
-# 2. Scan the library via UI or API
-curl -X POST http://localhost:3000/api/scan \
-  -H "Content-Type: application/json" \
-  -d '{"libraryId": 1}'
-
-# 3. Delete some files from disk
-rm /path/to/library/test1.mp4
-
-# 4. Re-scan the library
-curl -X POST http://localhost:3000/api/scan \
-  -H "Content-Type: application/json" \
-  -d '{"libraryId": 1}'
-```
-
-**Expected Results**:
-- ✓ Console shows: "Removed orphaned record: /path/to/library/test1.mp4"
-- ✓ API response includes: `"filesRemoved": 1`
-- ✓ Deleted files no longer appear in UI
-- ✓ Database no longer contains records for deleted files
-
----
-
-#### **Test 2: Thumbnail Recovery**
-
-**Setup**:
-```bash
-# 1. Add files and scan
-cp test-videos/*.mp4 /path/to/library/
-curl -X POST http://localhost:3000/api/scan \
-  -H "Content-Type: application/json" \
-  -d '{"libraryId": 1}'
-
-# 2. Verify thumbnails created
-ls -la public/thumbnails/
-
-# 3. Delete some thumbnail files
-rm public/thumbnails/ab/cd/*.png
-
-# 4. Re-scan
-curl -X POST http://localhost:3000/api/scan \
-  -H "Content-Type: application/json" \
-  -d '{"libraryId": 1}'
-```
-
-**Expected Results**:
-- ✓ Console shows: "🔄 Regenerating missing thumbnail for: video.mp4"
-- ✓ Console shows: "✓ Successfully regenerated thumbnail: video.mp4"
-- ✓ API response includes: `"thumbnailsRegenerated": 3`
-- ✓ Thumbnails re-created in filesystem
-- ✓ Videos display with thumbnails in UI
-
----
-
-#### **Test 3: Error Handling**
-
-**Setup**:
-```bash
-# 1. Create a corrupt video file
-echo "not a video" > /path/to/library/corrupt.mp4
-
-# 2. Scan
-curl -X POST http://localhost:3000/api/scan \
-  -H "Content-Type: application/json" \
-  -d '{"libraryId": 1}'
-```
-
-**Expected Results**:
-- ✓ Scan completes despite error
-- ✓ Other files processed normally
-- ✓ Error logged to console
-- ✓ Fallback thumbnail used for corrupt file
-- ✓ API response includes error count
-
----
-
-#### **Test 4: Statistics Reporting**
-
-**Setup**:
-```bash
-# Perform a complete scan
-curl -X POST http://localhost:3000/api/scan
-```
-
-**Expected API Response**:
-```json
-{
-  "success": true,
-  "message": "All libraries scan complete",
-  "stats": {
-    "filesProcessed": 450,
-    "filesAdded": 15,
-    "filesRemoved": 3,
-    "thumbnailsRegenerated": 8,
-    "errors": 0
-  }
-}
-```
-
-**Expected Console Output**:
-```
-📚 Starting scan for library: /media/library1
-📁 Found 150 media files
-🧹 Checking for deleted files...
-📊 Cleanup complete: 1 orphaned record(s) removed
-⚙️  Processing files...
-✓ Added video: movie.mp4 with thumbnail
-🔄 Regenerating missing thumbnail for: show.mkv
-✓ Successfully regenerated thumbnail: show.mkv
-📊 Scan Complete:
-   Files Processed: 150
-   Files Added: 5
-   Files Removed: 1
-   Thumbnails Regenerated: 3
-
-🎉 All Libraries Scan Complete:
-   Total Files Processed: 450
-   Total Files Added: 15
-   Total Files Removed: 3
-   Total Thumbnails Regenerated: 8
-```
-
----
-
-## 📊 **Statistics Tracked**
-
-The enhanced scanner now tracks and reports:
-
-| Metric | Description |
-|--------|-------------|
-| **filesProcessed** | Total files discovered and processed |
-| **filesAdded** | New files inserted into database |
-| **filesRemoved** | Orphaned records deleted (file cleanup) |
-| **thumbnailsRegenerated** | Missing thumbnails recreated |
-| **errors** | Number of errors encountered |
-
----
-
-## 🎯 **Success Criteria Met**
-
-### **Functional Requirements** ✅
-- ✅ Deleted files are automatically removed from database during scan
-- ✅ Missing thumbnails are automatically regenerated during scan
-- ✅ Scan completes even with individual file errors
-- ✅ Statistics are logged to console and returned via API
-- ✅ No regression in existing scan functionality
-
-### **Code Quality** ✅
-- ✅ Code follows existing patterns and style
-- ✅ Error handling implemented for all new code
-- ✅ Console logging provides clear, formatted feedback
-- ✅ No new dependencies added
-- ✅ TypeScript types properly defined
-
-### **Build & Compilation** ✅
-- ✅ No TypeScript errors
-- ✅ No compilation errors
-- ✅ Production build successful
-- ✅ All imports resolved correctly
-
----
-
-## 🚀 **How to Use**
-
-### **Via API**
-
-**Scan specific library**:
-```bash
-curl -X POST http://localhost:3000/api/scan \
-  -H "Content-Type: application/json" \
-  -d '{"libraryId": 1}'
-```
-
-**Scan all libraries**:
-```bash
-curl -X POST http://localhost:3000/api/scan \
-  -H "Content-Type: application/json" \
-  -d '{}'
-```
-
-### **Via UI**
-
-Navigate to your library management page and click the "Scan" button. The scan will now:
-1. Find all media files
-2. Remove deleted files from database
-3. Add new files
-4. Verify and regenerate missing thumbnails
-5. Display statistics
-
----
-
-## 📈 **Performance Impact**
-
-| Aspect | Impact | Notes |
-|--------|--------|-------|
-| **File existence checks** | Minimal | Fast filesystem operations |
-| **Database deletions** | Minimal | Simple indexed queries |
-| **Thumbnail regeneration** | Moderate | Only for missing thumbnails |
-| **Overall scan time** | +10-15% | Acceptable for data integrity |
-| **Memory usage** | No change | Same as before |
-
----
-
-## 🔧 **Troubleshooting**
-
-### **Issue**: Thumbnails not regenerating
-**Solution**: 
-- Check FFmpeg is installed: `ffmpeg -version`
-- Verify thumbnail directory permissions: `ls -la public/thumbnails/`
-- Check console logs for specific errors
-
-### **Issue**: Files not being removed from database
-**Solution**:
-- Verify files are truly deleted from disk
-- Check database permissions
-- Review console output for specific errors
-
-### **Issue**: Scan taking longer than expected
-**Solution**:
-- This is normal - cleanup and verification add processing time
-- For large libraries, consider running scan in background
-- Monitor console output to track progress
-
----
-
-## 📚 **Related Documentation**
-
-- [Requirements](LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md) - Core requirements specification
-- [Architecture](LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md) - Technical design
-- [Implementation Plan](LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md) - Step-by-step guide
-- [Summary](LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md) - Feature overview
-- [Redesign Overview](LIBRARY_SCAN_REDESIGN_OVERVIEW.md) - What changed from original plan
-
----
-
-## ✨ **Next Steps**
-
-1. **Test the implementation**
-   - Run manual tests outlined above
-   - Verify with your actual media library
-   - Check statistics reporting
-
-2. **Monitor in production**
-   - Watch console logs during scans
-   - Verify cleanup is working as expected
-   - Check thumbnail regeneration success rate
-
-3. **Optional enhancements** (Future)
-   - Add UI progress indicators (if needed)
-   - Implement scan scheduling (if desired)
-   - Add more detailed statistics (if required)
-
----
-
-*Implementation Status*: ✅ **Complete**  
-*Build Status*: ✅ **Successful**  
-*Ready for Testing*: ✅ **Yes**  
-*Production Ready*: ✅ **Yes**  
-*Implementation Date*: October 14, 2025
-
-**Implemented by**: Following the simplified implementation plan  
-**Total Development Time**: ~2 hours (faster than estimated 6-8 hours)  
-**Files Modified**: 2  
-**Lines Added**: ~180  
-**Lines Modified**: ~30  
-
-🎉 **The library scan enhancement is complete and ready to use!**

docs/active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md

@@ -1,486 +0,0 @@
-# Library Scan Enhancement Architecture
-
-## 🏗️ **System Architecture Overview**
-
-### **Simplified Scan Enhancement**
-
-```
-┌────────────────────────────────────────────────────────────┐
-│                   Enhanced Scanner                         │
-│                   (scanner.ts)                             │
-├────────────────────────────────────────────────────────────┤
-│  1. File Discovery           (existing)                    │
-│  2. File Deletion Cleanup    (NEW)                         │
-│  3. File Processing          (existing)                    │
-│  4. Thumbnail Verification   (NEW)                         │
-└────────────────────────────────────────────────────────────┘
-```
-
-**Design Philosophy**: Minimal changes to existing scanner, add two new verification steps
-
----
-
-## 🔧 **Component Enhancements**
-
-### **Enhanced Scanner Flow**
-
-``typescript
-// File: src/lib/scanner.ts
-
-const scanLibrary = async (library: { id: number; path: string }) => {
-  const db = getDatabase();
-  
-  // 1. FILE DISCOVERY (existing)
-  const allFiles = await glob(`${library.path}/**/*.*`, { nodir: true });
-  const mediaFiles = [...filteredVideoFiles, ...filteredPhotoFiles, ...filteredTextFiles];
-  
-  // 2. FILE DELETION CLEANUP (NEW)
-  await cleanupDeletedFiles(db, library.id, mediaFiles);
-  
-  // 3. FILE PROCESSING (existing + enhanced)
-  for (const file of mediaFiles) {
-    const existingMedia = db.prepare("SELECT * FROM media WHERE path = ?").get(file);
-    
-    if (existingMedia) {
-      // 4. THUMBNAIL VERIFICATION (NEW)
-      await verifyAndRegenerateThumbnail(existingMedia);
-      continue;
-    }
-    
-    // Existing: Insert new media with thumbnail generation
-  }
-};
-```
-
-### **1. File Deletion Cleanup** (NEW)
-
-**Purpose**: Remove database entries for files that no longer exist on disk
-
-**Implementation**:
-```typescript
-async function cleanupDeletedFiles(
-  db: Database, 
-  libraryId: number, 
-  currentFiles: string[]
-): Promise<{ removed: number }> {
-  // Get all media records for this library
-  const dbRecords = db.prepare(
-    "SELECT id, path FROM media WHERE library_id = ?"
-  ).all(libraryId) as { id: number; path: string }[];
-  
-  // Create set of current file paths for fast lookup
-  const currentFileSet = new Set(currentFiles);
-  
-  let removed = 0;
-  
-  // Check each database record
-  for (const record of dbRecords) {
-    // If file doesn't exist in current scan
-    if (!currentFileSet.has(record.path)) {
-      try {
-        // Verify file truly doesn't exist on disk
-        await fs.access(record.path);
-        // File exists but wasn't in scan - possibly outside glob pattern
-        continue;
-      } catch {
-        // File doesn't exist - remove from database
-        db.prepare("DELETE FROM media WHERE id = ?").run(record.id);
-        console.log(`Removed orphaned record: ${record.path}`);
-        removed++;
-      }
-    }
-  }
-  
-  console.log(`Cleanup complete: ${removed} orphaned records removed`);
-  return { removed };
-}
-```
-
-**Key Features**:
-- Double-checks file existence before deletion (safety)
-- Handles cases where files exist but weren't scanned
-- Logs each deletion for transparency
-- Returns statistics for reporting
-
-### **2. Thumbnail Verification** (NEW)
-
-**Purpose**: Detect and regenerate missing thumbnails for existing media
-
-**Implementation**:
-``typescript
-async function verifyAndRegenerateThumbnail(
-  media: MediaRecord
-): Promise<{ regenerated: boolean }> {
-  // Skip if using fallback thumbnail
-  if (media.thumbnail.includes('/fallback/')) {
-    return { regenerated: false };
-  }
-  
-  // Get full path from URL
-  const thumbnailPath = getThumbnailPathFromUrl(media.thumbnail);
-  
-  try {
-    // Check if thumbnail file exists
-    await fs.access(thumbnailPath);
-    return { regenerated: false }; // Thumbnail exists, no action needed
-  } catch {
-    // Thumbnail missing - regenerate
-    console.log(`Regenerating missing thumbnail for: ${media.path}`);
-    
-    try {
-      const { folderPath, fullPath, url } = ThumbnailManager.getThumbnailPath(media.path);
-      ThumbnailManager.ensureDirectory(folderPath);
-      
-      if (media.type === 'video') {
-        await generateVideoThumbnail(media.path, fullPath);
-      } else if (media.type === 'photo') {
-        await generatePhotoThumbnail(media.path, fullPath);
-      }
-      
-      // Update database with new thumbnail path
-      db.prepare("UPDATE media SET thumbnail = ? WHERE id = ?")
-        .run(url, media.id);
-      
-      console.log(`Successfully regenerated thumbnail: ${media.path}`);
-      return { regenerated: true };
-      
-    } catch (error) {
-      console.warn(`Failed to regenerate thumbnail for ${media.path}:`, error);
-      
-      // Use fallback thumbnail
-      const fallbackUrl = ThumbnailManager.getFallbackThumbnailUrl(media.type);
-      db.prepare("UPDATE media SET thumbnail = ? WHERE id = ?")
-        .run(fallbackUrl, media.id);
-      
-      return { regenerated: false };
-    }
-  }
-}
-
-function getThumbnailPathFromUrl(url: string): string {
-  // Convert URL like /thumbnails/ab/cd/file.png
-  // to full path like /path/to/public/thumbnails/ab/cd/file.png
-  return path.join(process.cwd(), 'public', url);
-}
-```
-
-**Key Features**:
-- Verifies file existence before attempting regeneration
-- Reuses existing thumbnail generation functions
-- Updates database with new thumbnail path
-- Falls back to type-based placeholder on failure
-- Logs all actions for debugging
-
----
-
-## 🔄 **Enhanced Scan Process Flow**
-
-### **Detailed Process Steps**
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│ 1. START SCAN                                               │
-│    ├── Receive library ID or scan all                       │
-│    └── Initialize statistics counters                       │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ 2. FILE DISCOVERY (existing)                                │
-│    ├── Glob library path for all media files               │
-│    ├── Filter by video/photo/text extensions               │
-│    └── Build list of current files                         │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ 3. FILE DELETION CLEANUP (NEW)                              │
-│    ├── Get all database records for library                │
-│    ├── For each database record:                           │
-│    │   ├── Check if file in current scan results           │
-│    │   ├── If not: Verify file doesn't exist on disk       │
-│    │   └── If missing: DELETE from database                │
-│    └── Log cleanup statistics                              │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ 4. FILE PROCESSING LOOP                                     │
-│    For each discovered file:                                │
-│    ├── Check if file already in database                   │
-│    ├── If NEW:                                              │
-│    │   ├── Generate thumbnail (existing)                    │
-│    │   ├── Analyze video codec (existing)                   │
-│    │   └── INSERT into database (existing)                  │
-│    └── If EXISTS:                                           │
-│        └── Verify & regenerate thumbnail (NEW) →            │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ 5. THUMBNAIL VERIFICATION (NEW)                             │
-│    ├── Check if thumbnail file exists on disk              │
-│    ├── If missing: Regenerate thumbnail                    │
-│    ├── Update database with new path                       │
-│    └── Log regeneration actions                            │
-└─────────────────────────────────────────────────────────────┘
-                          ↓
-┌─────────────────────────────────────────────────────────────┐
-│ 6. COMPLETE SCAN                                            │
-│    ├── Log final statistics                                │
-│    └── Return success                                      │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 🗄️ **Database Operations**
-
-### **No Schema Changes Required**
-
-Use existing tables and fields:
-
-```sql
--- Existing media table (no changes)
-CREATE TABLE media (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  library_id INTEGER,
-  path TEXT NOT NULL UNIQUE,
-  type TEXT NOT NULL,
-  title TEXT,
-  size INTEGER,
-  thumbnail TEXT,
-  codec_info TEXT DEFAULT '{}',
-  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-  FOREIGN KEY (library_id) REFERENCES libraries (id)
-);
-```
-
-### **Database Operations**
-
-```typescript
-// 1. Get all media for library
-const records = db.prepare(
-  "SELECT id, path, type, thumbnail FROM media WHERE library_id = ?"
-).all(libraryId);
-
-// 2. Delete orphaned record
-db.prepare("DELETE FROM media WHERE id = ?").run(recordId);
-
-// 3. Update thumbnail path
-db.prepare("UPDATE media SET thumbnail = ? WHERE id = ?")
-  .run(newThumbnailUrl, mediaId);
-```
-
-**No transactions needed** - Simple, independent operations
-
----
-
-## 📊 **Statistics Tracking**
-
-### **Scan Statistics Object**
-
-```typescript
-interface ScanStats {
-  filesProcessed: number;      // Total files scanned
-  filesAdded: number;           // New files inserted (existing)
-  filesRemoved: number;         // Orphaned records deleted (NEW)
-  thumbnailsRegenerated: number; // Missing thumbnails recreated (NEW)
-  errors: number;               // Total errors encountered
-}
-```
-
-### **Statistics Collection**
-
-``typescript
-const scanLibrary = async (library: { id: number; path: string }) => {
-  const stats: ScanStats = {
-    filesProcessed: 0,
-    filesAdded: 0,
-    filesRemoved: 0,
-    thumbnailsRegenerated: 0,
-    errors: 0
-  };
-  
-  // ... scan logic ...
-  
-  // Log final statistics
-  console.log('Scan complete:', stats);
-  return stats;
-};
-```
-
----
-
-## 🔒 **Error Handling Strategy**
-
-### **Error Tolerance Approach**
-
-``typescript
-// Principle: Individual failures should not stop entire scan
-
-// File deletion cleanup
-for (const record of dbRecords) {
-  try {
-    // Check and delete if needed
-    await cleanupRecord(record);
-  } catch (error) {
-    console.error(`Error cleaning up ${record.path}:`, error);
-    stats.errors++;
-    // Continue to next record
-  }
-}
-
-// Thumbnail verification
-for (const file of mediaFiles) {
-  try {
-    const existingMedia = getExistingMedia(file);
-    if (existingMedia) {
-      await verifyAndRegenerateThumbnail(existingMedia);
-    }
-  } catch (error) {
-    console.error(`Error processing ${file}:`, error);
-    stats.errors++;
-    // Continue to next file
-  }
-}
-```
-
-**Key Principles**:
-- Wrap each file operation in try-catch
-- Log errors but continue processing
-- Track error count in statistics
-- No transaction rollback (simple operations)
-
----
-
-## 🚀 **Implementation Strategy**
-
-### **Code Changes Required**
-
-**Single file modification**: `src/lib/scanner.ts`
-
-``typescript
-// Add helper functions at top of file
-async function cleanupDeletedFiles(...) { /* ... */ }
-async function verifyAndRegenerateThumbnail(...) { /* ... */ }
-function getThumbnailPathFromUrl(...) { /* ... */ }
-
-// Modify existing scanLibrary function
-const scanLibrary = async (library: { id: number; path: string }) => {
-  // Initialize statistics
-  const stats = { filesProcessed: 0, filesAdded: 0, filesRemoved: 0, thumbnailsRegenerated: 0, errors: 0 };
-  
-  // Existing file discovery code
-  const allFiles = await glob(`${library.path}/**/*.*`, { nodir: true });
-  // ... existing filtering logic ...
-  
-  // NEW: Cleanup deleted files
-  const cleanupResult = await cleanupDeletedFiles(db, library.id, mediaFiles);
-  stats.filesRemoved = cleanupResult.removed;
-  
-  // Existing file processing loop
-  for (const file of mediaFiles) {
-    stats.filesProcessed++;
-    
-    const existingMedia = db.prepare("SELECT * FROM media WHERE path = ?").get(file);
-    
-    if (existingMedia) {
-      // NEW: Verify thumbnail for existing files
-      const thumbResult = await verifyAndRegenerateThumbnail(existingMedia);
-      if (thumbResult.regenerated) stats.thumbnailsRegenerated++;
-      continue;
-    }
-    
-    // Existing new file processing
-    // ... existing thumbnail generation and insert logic ...
-    stats.filesAdded++;
-  }
-  
-  // Log final statistics
-  console.log('Scan complete:', stats);
-  return stats;
-};
-```
-
-**No other files require changes**
-
----
-
-## 🎯 **Performance Considerations**
-
-### **Performance Impact**
-
-| **Operation** | **Impact** | **Mitigation** |
-|--------------|-----------|---------------|
-| File existence checks | Low | Use fast `fs.access()` |
-| Database queries | Low | Single query per library |
-| Thumbnail regeneration | Medium | Only for missing thumbnails |
-| Overall scan time | +10-20% | Acceptable for data integrity |
-
-### **Optimization Notes**
-
-- File existence checks are fast I/O operations
-- Database deletions are simple, indexed operations
-- Thumbnail regeneration only happens for missing files
-- No additional memory overhead
-- Sequential processing (same as current)
-
----
-
-## 📈 **Testing Strategy**
-
-### **Unit Testing**
-
-``typescript
-describe('cleanupDeletedFiles', () => {
-  it('should remove records for deleted files', async () => {
-    // Setup: Create DB records for files that don't exist
-    // Execute: Run cleanup
-    // Verify: Records removed from database
-  });
-  
-  it('should keep records for existing files', async () => {
-    // Setup: Create DB records for existing files
-    // Execute: Run cleanup
-    // Verify: Records still in database
-  });
-});
-
-describe('verifyAndRegenerateThumbnail', () => {
-  it('should skip if thumbnail exists', async () => {
-    // Setup: Media record with existing thumbnail
-    // Execute: Verify
-    // Verify: No regeneration attempted
-  });
-  
-  it('should regenerate if thumbnail missing', async () => {
-    // Setup: Media record with missing thumbnail
-    // Execute: Verify
-    // Verify: Thumbnail regenerated and DB updated
-  });
-});
-```
-
-### **Integration Testing**
-
-``typescript
-describe('Enhanced Scanner', () => {
-  it('should complete full scan with cleanup and verification', async () => {
-    // Setup: Library with mixed scenarios (new, existing, deleted, missing thumbnails)
-    // Execute: Full library scan
-    // Verify: All scenarios handled correctly
-  });
-});
-```
-
----
-
-## 🔗 **Related Documentation**
-
-- [Requirements Document](LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md)
-- [Implementation Plan](LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md)
-- [Summary](LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md)
-
----
-
-*Document Status*: ✅ **Complete**  
-*Architecture Type*: Minimal, focused enhancement  
-*Implementation Complexity*: Low-Medium  
-*Last Updated*: October 14, 2025

docs/active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md

@@ -1,586 +0,0 @@
-# Library Scan Enhancement Implementation Plan
-
-## 🚀 **Implementation Overview**
-
-This document provides a step-by-step implementation guide for the simplified library scan enhancement, focusing on two core features:
-1. **File Deletion Cleanup** - Remove orphaned database entries
-2. **Thumbnail Recovery** - Regenerate missing thumbnails
-
-**Estimated Total Time**: 6-8 hours
-
----
-
-## 📋 **Implementation Steps**
-
-### **Step 1: Add Helper Function - File Deletion Cleanup**
-
-**Estimated Time**: 2-3 hours  
-**File**: `src/lib/scanner.ts`
-
-**Implementation**:
-
-```typescript
-import { promises as fs } from 'fs';
-
-// Add this helper function after imports
-async function cleanupDeletedFiles(
-  db: DatabaseType,
-  libraryId: number,
-  currentFiles: string[]
-): Promise<{ removed: number }> {
-  // Get all media records for this library
-  const dbRecords = db.prepare(
-    "SELECT id, path FROM media WHERE library_id = ?"
-  ).all(libraryId) as { id: number; path: string }[];
-
-  // Create set of current file paths for fast lookup
-  const currentFileSet = new Set(currentFiles);
-
-  let removed = 0;
-
-  // Check each database record
-  for (const record of dbRecords) {
-    // If file doesn't exist in current scan
-    if (!currentFileSet.has(record.path)) {
-      try {
-        // Double-check file truly doesn't exist on disk
-        await fs.access(record.path);
-        // File exists but wasn't in scan - possibly outside glob pattern
-        console.log(`File exists but not scanned: ${record.path}`);
-        continue;
-      } catch {
-        // File doesn't exist - remove from database
-        try {
-          db.prepare("DELETE FROM media WHERE id = ?").run(record.id);
-          console.log(`✓ Removed orphaned record: ${record.path}`);
-          removed++;
-        } catch (error) {
-          console.error(`✗ Failed to remove record ${record.path}:`, error);
-        }
-      }
-    }
-  }
-
-  if (removed > 0) {
-    console.log(`📊 Cleanup complete: ${removed} orphaned record(s) removed`);
-  }
-
-  return { removed };
-}
-```
-
-**Testing**:
-```typescript
-// Manual test
-// 1. Add files to library and scan
-// 2. Delete some files manually
-// 3. Re-scan
-// 4. Verify records removed from database
-```
-
----
-
-### **Step 2: Add Helper Function - Thumbnail Verification**
-
-**Estimated Time**: 2-3 hours  
-**File**: `src/lib/scanner.ts`
-
-**Implementation**:
-
-```typescript
-import path from 'path';
-
-// Add helper to convert thumbnail URL to file path
-function getThumbnailPathFromUrl(url: string): string {
-  // Convert URL like /thumbnails/ab/cd/file.png
-  // to full path like /path/to/public/thumbnails/ab/cd/file.png
-  return path.join(process.cwd(), 'public', url);
-}
-
-// Add thumbnail verification function
-async function verifyAndRegenerateThumbnail(
-  media: { id: number; path: string; type: string; thumbnail: string }
-): Promise<{ regenerated: boolean }> {
-  // Skip if using fallback thumbnail
-  if (media.thumbnail.includes('/fallback/')) {
-    return { regenerated: false };
-  }
-
-  // Get full path from URL
-  const thumbnailPath = getThumbnailPathFromUrl(media.thumbnail);
-
-  try {
-    // Check if thumbnail file exists
-    await fs.access(thumbnailPath);
-    return { regenerated: false }; // Thumbnail exists, no action needed
-  } catch {
-    // Thumbnail missing - regenerate
-    console.log(`🔄 Regenerating missing thumbnail for: ${path.basename(media.path)}`);
-
-    try {
-      const { folderPath, fullPath, url } = ThumbnailManager.getThumbnailPath(media.path);
-      ThumbnailManager.ensureDirectory(folderPath);
-
-      let regenerated = false;
-
-      if (media.type === 'video') {
-        await generateVideoThumbnail(media.path, fullPath);
-        regenerated = true;
-      } else if (media.type === 'photo') {
-        await generatePhotoThumbnail(media.path, fullPath);
-        regenerated = true;
-      }
-
-      if (regenerated) {
-        // Update database with new thumbnail path
-        const db = getDatabase();
-        db.prepare("UPDATE media SET thumbnail = ? WHERE id = ?")
-          .run(url, media.id);
-
-        console.log(`✓ Successfully regenerated thumbnail: ${path.basename(media.path)}`);
-        return { regenerated: true };
-      }
-
-      return { regenerated: false };
-
-    } catch (error) {
-      console.warn(`✗ Failed to regenerate thumbnail for ${path.basename(media.path)}:`, error);
-
-      // Use fallback thumbnail
-      const db = getDatabase();
-      const fallbackUrl = ThumbnailManager.getFallbackThumbnailUrl(media.type);
-      db.prepare("UPDATE media SET thumbnail = ? WHERE id = ?")
-        .run(fallbackUrl, media.id);
-
-      return { regenerated: false };
-    }
-  }
-}
-```
-
-**Testing**:
-```typescript
-// Manual test
-// 1. Add files to library and scan
-// 2. Delete thumbnail files manually (in public/thumbnails/)
-// 3. Re-scan
-// 4. Verify thumbnails regenerated
-```
-
----
-
-### **Step 3: Enhance Main Scan Function**
-
-**Estimated Time**: 1-2 hours  
-**File**: `src/lib/scanner.ts`
-
-**Modifications to `scanLibrary` function**:
-
-```typescript
-const scanLibrary = async (library: { id: number; path: string }) => {
-  const db = getDatabase();
-  
-  // Initialize statistics tracking
-  const stats = {
-    filesProcessed: 0,
-    filesAdded: 0,
-    filesRemoved: 0,
-    thumbnailsRegenerated: 0,
-    errors: 0
-  };
-  
-  console.log(`\n📚 Starting scan for library: ${library.path}`);
-  
-  // EXISTING: File discovery
-  const allFiles = await glob(`${library.path}/**/*.*`, { nodir: true });
-  
-  // EXISTING: Filter files by extension
-  const filteredVideoFiles = allFiles.filter(file => {
-    const ext = path.extname(file).toLowerCase().replace('.', '');
-    return VIDEO_EXTENSIONS.includes(ext);
-  });
-  
-  const filteredPhotoFiles = allFiles.filter(file => {
-    const ext = path.extname(file).toLowerCase().replace('.', '');
-    return PHOTO_EXTENSIONS.includes(ext);
-  });
-  
-  const filteredTextFiles = allFiles.filter(file => {
-    const ext = path.extname(file).toLowerCase().replace('.', '');
-    return TEXT_EXTENSIONS.includes(ext);
-  });
-
-  const mediaFiles = [...filteredVideoFiles, ...filteredPhotoFiles, ...filteredTextFiles];
-  
-  console.log(`📁 Found ${mediaFiles.length} media files`);
-  
-  // NEW: Cleanup deleted files
-  console.log(`\n🧹 Checking for deleted files...`);
-  try {
-    const cleanupResult = await cleanupDeletedFiles(db, library.id, mediaFiles);
-    stats.filesRemoved = cleanupResult.removed;
-  } catch (error) {
-    console.error('Error during cleanup:', error);
-    stats.errors++;
-  }
-  
-  // EXISTING + ENHANCED: Process each file
-  console.log(`\n⚙️  Processing files...`);
-  for (const file of mediaFiles) {
-    stats.filesProcessed++;
-    
-    try {
-      const stats = fs.statSync(file);
-      const title = path.basename(file);
-      const ext = path.extname(file).toLowerCase();
-      const cleanExt = ext.replace('.', '').toLowerCase();
-      const isVideo = VIDEO_EXTENSIONS.some(v => v.toLowerCase() === cleanExt);
-      const isPhoto = PHOTO_EXTENSIONS.some(p => p.toLowerCase() === cleanExt);
-      const isText = TEXT_EXTENSIONS.some(t => t.toLowerCase() === cleanExt);
-      
-      const mediaType = isVideo ? "video" : isPhoto ? "photo" : "text";
-      
-      const { folderPath, fullPath, url } = ThumbnailManager.getThumbnailPath(file);
-      
-      const existingMedia = db.prepare("SELECT * FROM media WHERE path = ?").get(file);
-      
-      if (existingMedia) {
-        // NEW: Verify thumbnail for existing media
-        try {
-          const thumbResult = await verifyAndRegenerateThumbnail(existingMedia);
-          if (thumbResult.regenerated) {
-            stats.thumbnailsRegenerated++;
-          }
-        } catch (error) {
-          console.error(`Error verifying thumbnail for ${file}:`, error);
-          stats.errors++;
-        }
-        continue;
-      }
-
-      // EXISTING: Process new files (thumbnail generation, insert, etc.)
-      ThumbnailManager.ensureDirectory(folderPath);
-
-      let finalThumbnailUrl = url;
-      let thumbnailGenerated = false;
-
-      try {
-        if (isVideo) {
-          await generateVideoThumbnail(file, fullPath);
-          thumbnailGenerated = true;
-        } else if (isPhoto) {
-          await generatePhotoThumbnail(file, fullPath);
-          thumbnailGenerated = true;
-        }
-      } catch (thumbnailError) {
-        console.warn(`Thumbnail generation failed for ${file}:`, thumbnailError);
-        finalThumbnailUrl = ThumbnailManager.getFallbackThumbnailUrl(mediaType);
-      }
-
-      // EXISTING: Analyze video codec
-      let codecInfo = '{}';
-      if (isVideo) {
-        try {
-          const videoInfo = await VideoAnalyzer.analyzeVideo(file);
-          codecInfo = JSON.stringify({
-            codec: videoInfo.codec,
-            container: videoInfo.container,
-            duration: videoInfo.duration,
-            width: videoInfo.width,
-            height: videoInfo.height,
-            bitrate: videoInfo.bitrate,
-            audioCodec: videoInfo.audioCodec,
-            needsTranscoding: videoInfo.needsTranscoding
-          });
-        } catch (error) {
-          console.warn(`Could not analyze video codec for ${file}:`, error);
-        }
-      }
-
-      // EXISTING: Insert into database
-      const media = {
-        library_id: library.id,
-        path: file,
-        type: mediaType,
-        title: title,
-        size: stats.size,
-        thumbnail: finalThumbnailUrl,
-        codec_info: codecInfo,
-      };
-
-      db.prepare(
-        "INSERT INTO media (library_id, path, type, title, size, thumbnail, codec_info) VALUES (?, ?, ?, ?, ?, ?, ?)"
-      ).run(media.library_id, media.path, media.type, media.title, media.size, media.thumbnail, media.codec_info);
-
-      stats.filesAdded++;
-      console.log(`✓ Added ${mediaType}: ${title}${thumbnailGenerated ? ' with thumbnail' : ' with fallback'}`);
-      
-    } catch (error: any) {
-      if (error.code !== "SQLITE_CONSTRAINT_UNIQUE") {
-        console.error(`Error processing ${file}:`, error);
-        stats.errors++;
-      }
-    }
-  }
-  
-  // NEW: Log final statistics
-  console.log(`\n📊 Scan Complete:`);
-  console.log(`   Files Processed: ${stats.filesProcessed}`);
-  console.log(`   Files Added: ${stats.filesAdded}`);
-  console.log(`   Files Removed: ${stats.filesRemoved}`);
-  console.log(`   Thumbnails Regenerated: ${stats.thumbnailsRegenerated}`);
-  if (stats.errors > 0) {
-    console.log(`   Errors: ${stats.errors}`);
-  }
-  
-  return stats;
-};
-```
-
-**Key Changes**:
-1. Added statistics tracking object
-2. Call `cleanupDeletedFiles()` before processing
-3. Call `verifyAndRegenerateThumbnail()` for existing files
-4. Enhanced console logging with emojis and clear formatting
-5. Return statistics object
-
----
-
-### **Step 4: Update API Response (Optional)**
-
-**Estimated Time**: 30 minutes  
-**File**: `src/app/api/scan/route.ts`
-
-**Enhancement** (if you want to return stats):
-
-```typescript
-// In the scan API endpoint
-export async function POST(request: Request) {
-  try {
-    const body = await request.json();
-    const { libraryId } = body;
-
-    let stats;
-    if (libraryId) {
-      stats = await scanSelectedLibrary(libraryId);
-    } else {
-      stats = await scanAllLibraries();
-    }
-
-    return NextResponse.json({
-      success: true,
-      message: 'Scan completed successfully',
-      stats: stats || { filesProcessed: 0, filesAdded: 0, filesRemoved: 0, thumbnailsRegenerated: 0 }
-    });
-  } catch (error) {
-    console.error('Scan error:', error);
-    return NextResponse.json(
-      { success: false, error: error.message },
-      { status: 500 }
-    );
-  }
-}
-```
-
-**Update return type** of scan functions:
-
-```typescript
-// Update scanAllLibraries to aggregate stats
-export const scanAllLibraries = async () => {
-  const db = getDatabase();
-  const libraries = db.prepare("SELECT * FROM libraries").all() as { id: number; path: string }[];
-  
-  const aggregateStats = {
-    filesProcessed: 0,
-    filesAdded: 0,
-    filesRemoved: 0,
-    thumbnailsRegenerated: 0,
-    errors: 0
-  };
-  
-  for (const library of libraries) {
-    const stats = await scanLibrary(library);
-    aggregateStats.filesProcessed += stats.filesProcessed;
-    aggregateStats.filesAdded += stats.filesAdded;
-    aggregateStats.filesRemoved += stats.filesRemoved;
-    aggregateStats.thumbnailsRegenerated += stats.thumbnailsRegenerated;
-    aggregateStats.errors += stats.errors;
-  }
-  
-  return aggregateStats;
-};
-
-// scanSelectedLibrary already returns stats from scanLibrary
-```
-
----
-
-## 🧪 **Testing Plan**
-
-### **Manual Testing Procedure**
-
-#### **Test 1: File Deletion Cleanup**
-
-```bash
-# 1. Setup test library
-mkdir -p /tmp/test-library
-cp some-videos.mp4 /tmp/test-library/
-
-# 2. Add library in UI and scan
-# Verify files appear in UI
-
-# 3. Delete files from disk
-rm /tmp/test-library/some-videos.mp4
-
-# 4. Re-scan library
-# Expected: Console shows "Removed orphaned record"
-# Expected: Files no longer appear in UI
-# Expected: Database query shows files removed
-```
-
-#### **Test 2: Thumbnail Recovery**
-
-```bash
-# 1. Setup test library and scan
-mkdir -p /tmp/test-library
-cp some-videos.mp4 /tmp/test-library/
-# Scan via UI
-
-# 2. Delete thumbnails
-rm -rf public/thumbnails/*
-
-# 3. Re-scan library
-# Expected: Console shows "Regenerating missing thumbnail"
-# Expected: Thumbnails regenerated
-# Expected: Files display with thumbnails in UI
-```
-
-#### **Test 3: Error Handling**
-
-```bash
-# 1. Create file that causes thumbnail failure
-# (corrupt video file)
-cp corrupt.mp4 /tmp/test-library/
-
-# 2. Scan library
-# Expected: Scan completes despite error
-# Expected: Error logged to console
-# Expected: Fallback thumbnail used
-# Expected: Other files processed normally
-```
-
-### **Unit Tests** (Optional)
-
-Create file: `src/lib/__tests__/scanner.test.ts`
-
-```typescript
-import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
-import fs from 'fs/promises';
-import path from 'path';
-
-describe('Enhanced Scanner', () => {
-  const testLibraryPath = path.join(__dirname, 'test-library');
-  
-  beforeEach(async () => {
-    // Setup test library
-    await fs.mkdir(testLibraryPath, { recursive: true });
-  });
-  
-  afterEach(async () => {
-    // Cleanup test library
-    await fs.rm(testLibraryPath, { recursive: true, force: true });
-  });
-  
-  it('should remove orphaned database entries', async () => {
-    // Test implementation
-  });
-  
-  it('should regenerate missing thumbnails', async () => {
-    // Test implementation
-  });
-  
-  it('should continue scan on individual file errors', async () => {
-    // Test implementation
-  });
-});
-```
-
----
-
-## ✅ **Acceptance Checklist**
-
-Before marking implementation complete, verify:
-
-### **Functional Requirements**
-- [ ] Deleted files are removed from database during scan
-- [ ] Missing thumbnails are regenerated during scan
-- [ ] Scan completes even with individual file errors
-- [ ] Statistics are logged to console
-- [ ] No regression in existing scan functionality
-
-### **Code Quality**
-- [ ] Code follows existing style and patterns
-- [ ] Error handling implemented for all new code
-- [ ] Console logging provides clear feedback
-- [ ] No new dependencies added
-
-### **Testing**
-- [ ] Manual test: File deletion cleanup works
-- [ ] Manual test: Thumbnail recovery works
-- [ ] Manual test: Error handling works
-- [ ] No TypeScript errors
-- [ ] No runtime errors in normal operation
-
-### **Documentation**
-- [ ] Code comments added for new functions
-- [ ] README updated if needed
-- [ ] This implementation guide completed
-
----
-
-## 📊 **Implementation Timeline**
-
-| Step | Task | Time | Status |
-|------|------|------|--------|
-| 1 | Add cleanupDeletedFiles function | 2-3h | ⏳ Pending |
-| 2 | Add verifyAndRegenerateThumbnail function | 2-3h | ⏳ Pending |
-| 3 | Enhance scanLibrary function | 1-2h | ⏳ Pending |
-| 4 | Update API response (optional) | 0.5h | ⏳ Pending |
-| 5 | Testing & validation | 1h | ⏳ Pending |
-
-**Total Estimated Time**: 6-8 hours
-
----
-
-## 🐛 **Troubleshooting**
-
-### **Common Issues**
-
-**Issue**: Thumbnails not regenerating  
-**Solution**: Check thumbnail path conversion logic, verify FFmpeg installed
-
-**Issue**: Database errors during cleanup  
-**Solution**: Verify database connection, check for locked database
-
-**Issue**: Scan takes too long  
-**Solution**: Normal for large libraries, consider running in background
-
-**Issue**: TypeScript errors with fs.promises  
-**Solution**: Import as `import { promises as fs } from 'fs';`
-
----
-
-## 🔗 **Related Documentation**
-
-- [Requirements Document](LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md)
-- [Architecture Document](LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md)
-- [Summary Document](LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md)
-
----
-
-*Document Status*: ✅ **Complete**  
-*Implementation Complexity*: Low-Medium  
-*Ready to Begin*: Yes  
-*Last Updated*: October 14, 2025
-
-**Next Steps**: Begin Step 1 - Add cleanupDeletedFiles helper function

docs/active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md

@@ -1,220 +0,0 @@
-# Library Scan Enhancement Requirements
-
-## 📋 **Current State Analysis**
-
-### **✅ Existing Capabilities**
-- **File Discovery**: Recursive scanning of library paths using glob patterns
-- **Multi-format Support**: Videos (9 formats), Photos (8 formats), Text files (18 formats)
-- **Thumbnail Generation**: FFmpeg-based with hashed folder structure
-- **Video Analysis**: Codec detection and transcoding requirement analysis
-- **Database Integration**: Complete media metadata storage with proper indexing
-- **Batch Processing**: Both individual library and bulk scanning options
-
-### **❌ Critical Gaps**
-1. **No File Deletion Handling**: Deleted files remain in database as orphaned records
-2. **No Thumbnail Verification**: Missing/corrupted thumbnails aren't regenerated on re-scan
-
----
-
-## 🎯 **Enhanced Requirements**
-
-### **Requirement 1: File Deletion Cleanup**
-
-**Description**: Automatically detect and remove database entries for files that no longer exist on disk
-
-**Priority**: 🔴 **P0 - Critical**
-
-**Acceptance Criteria**:
-- [ ] Compare database records with actual file system state
-- [ ] Identify orphaned database entries (files that exist in DB but not on disk)
-- [ ] Remove orphaned entries from database
-- [ ] Log cleanup actions to console
-- [ ] Handle errors gracefully (continue scan if cleanup fails)
-
-**Technical Requirements**:
-- File existence verification using `fs.access()` or `fs.stat()`
-- Delete operation for each orphaned record
-- Error logging for debugging
-- No transaction rollback needed (simple delete operations)
-
-**User Stories**:
-- As a user, when I delete files from my library folder, I want them automatically removed from the database during the next scan
-- As a user, I want the database to accurately reflect what's actually on disk
-
----
-
-### **Requirement 2: Thumbnail Recovery**
-
-**Description**: Detect and regenerate missing thumbnail files during library scan
-
-**Priority**: 🔴 **P0 - Critical**
-
-**Acceptance Criteria**:
-- [ ] Verify thumbnail file existence for each media record
-- [ ] Detect missing thumbnail files (path exists in DB but file missing on disk)
-- [ ] Regenerate missing thumbnails during scan
-- [ ] Continue processing if thumbnail generation fails (use fallback)
-- [ ] Log thumbnail regeneration actions
-
-**Technical Requirements**:
-- Thumbnail file validation using `fs.stat()`
-- Re-use existing thumbnail generation logic
-- Handle thumbnail generation failures gracefully
-- Use existing fallback thumbnail mechanism
-- No additional database fields needed
-
-**User Stories**:
-- As a user, when thumbnails are accidentally deleted, I want them automatically regenerated during the next scan
-- As a user, when thumbnail generation previously failed, I want the scan to retry automatically
-
----
-
-## 🏗️ **Technical Architecture Requirements**
-
-### **Database Schema**
-
-**No schema changes required** - Use existing tables:
-- `media` table already has `path` and `thumbnail` fields
-- No new fields needed
-
-### **Scan Process Flow**
-
-```
-1. File Discovery (existing)
-   ├── Scan library path for media files
-   └── Get existing database records
-
-2. File Deletion Cleanup (NEW)
-   ├── For each database record:
-   │   ├── Check if file exists on disk
-   │   └── If not: DELETE from database
-   └── Log cleanup actions
-
-3. File Processing (existing + enhanced)
-   ├── For each discovered file:
-   │   ├── Check if already in database (existing)
-   │   ├── If new: Insert and generate thumbnail (existing)
-   │   └── If exists: Verify thumbnail (NEW)
-   
-4. Thumbnail Verification (NEW)
-   ├── For each existing media record:
-   │   ├── Check if thumbnail file exists
-   │   ├── If missing: Regenerate thumbnail
-   │   ├── If generation fails: Use fallback
-   │   └── Log regeneration actions
-```
-
-### **API Enhancements**
-
-**No new API endpoints needed** - Enhance existing scan endpoint:
-
-```typescript
-// Use existing endpoint
-POST /api/scan
-
-// No request body changes
-{
-  "libraryId": number  // Optional: specific library
-}
-
-// Response includes new statistics
-{
-  "success": true,
-  "message": "Scan completed",
-  "stats": {
-    "filesProcessed": number,
-    "filesAdded": number,
-    "filesRemoved": number,        // NEW
-    "thumbnailsRegenerated": number // NEW
-  }
-}
-```
-
----
-
-## 📊 **Implementation Priority**
-
-| **Feature** | **Priority** | **Effort** | **Impact** |
-|-------------|--------------|------------|------------|
-| **File Deletion Detection** | 🔴 P0 | Medium (3-4h) | Critical |
-| **Missing Thumbnail Regeneration** | 🔴 P0 | Medium (3-4h) | Critical |
-
-**Total Estimated Time**: 6-8 hours
-
----
-
-## 🎯 **Success Metrics**
-
-### **Functional Metrics**
-- **Database Accuracy**: 100% of deleted files removed from database
-- **Thumbnail Recovery**: >90% of missing thumbnails regenerated successfully
-- **Error Tolerance**: Scan completes even if individual files fail
-
-### **Quality Metrics**
-- **No Regressions**: Existing scan functionality works as before
-- **Error Handling**: Individual file failures don't stop entire scan
-- **Logging**: All actions logged for debugging
-
----
-
-## 🔍 **Non-Requirements**
-
-The following are **explicitly excluded** from this enhancement:
-
-- ❌ Real-time progress reporting / WebSocket updates
-- ❌ Scan session tracking / history
-- ❌ Concurrent processing / worker threads
-- ❌ Incremental scanning (only changed files)
-- ❌ Content-based duplicate detection
-- ❌ Advanced error recovery / retry mechanisms
-- ❌ Soft delete / undo functionality
-- ❌ Performance optimizations beyond current implementation
-- ❌ UI changes / progress bars
-- ❌ Database transactions (use simple operations)
-
----
-
-## 📝 **Technical Constraints**
-
-1. **Backward Compatibility**: Must work with existing database schema
-2. **Simple Implementation**: No complex architectural changes
-3. **Error Tolerance**: Individual failures should not stop scan
-4. **Minimal Dependencies**: Use existing libraries and utilities
-5. **Code Reuse**: Leverage existing thumbnail generation code
-
----
-
-## 🧪 **Testing Requirements**
-
-### **Manual Testing Scenarios**
-1. **File Deletion Test**
-   - Add files to library and scan
-   - Delete some files from disk
-   - Re-scan library
-   - Verify deleted files removed from database
-
-2. **Thumbnail Recovery Test**
-   - Add files to library and scan
-   - Delete thumbnail files from disk
-   - Re-scan library
-   - Verify thumbnails regenerated
-
-3. **Error Handling Test**
-   - Create files that cause thumbnail failures
-   - Run scan
-   - Verify scan completes despite failures
-
-### **Unit Tests**
-- Test file existence checking
-- Test thumbnail file verification
-- Test database deletion operations
-- Test error handling
-
----
-
-*Document Status*: ✅ **Complete**  
-*Implementation Scope*: Focused on 2 core requirements  
-*Estimated Time*: 6-8 hours  
-*Last Updated*: October 14, 2025
-
-**Next Steps**: Review architecture design document for technical implementation details.

docs/active/library-clusters/LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md

@@ -1,192 +0,0 @@
-# Library Scan Enhancement Summary
-
-## 📋 **Project Overview**
-
-Focused enhancement of the NextAV library scanning system to address two critical data integrity issues that prevent the system from maintaining accurate database state.
-
----
-
-## 🎯 **Problem Statement**
-
-The current library scan implementation has two critical limitations:
-
-1. **❌ No File Deletion Handling** - Database accumulates orphaned records when files are removed from disk
-2. **❌ No Thumbnail Recovery** - Missing/corrupted thumbnails aren't detected or regenerated during re-scans
-
----
-
-## ✅ **Solution Overview**
-
-### **Simplified Scan Enhancement**
-Two-phase enhancement introducing:
-- **File Deletion Detection** - Automatic cleanup of deleted files from database
-- **Thumbnail Verification** - Detection and regeneration of missing thumbnails
-
----
-
-## 📊 **Implementation Phases**
-
-### **Single Phase: Core Data Integrity** (🔴 Critical - 6-8 hours)
-- **File Deletion Detection** - Automatically remove orphaned database entries
-- **Missing Thumbnail Regeneration** - Detect and regenerate missing thumbnails
-- **Basic Error Handling** - Log errors but continue processing
-
----
-
-## 🏗️ **Technical Architecture**
-
-### **Core Components**
-```
-┌────────────────────────────────────────────────────┐
-│              Enhanced Scanner                      │
-├────────────────────────────────────────────────────┤
-│  1. File Discovery (existing)                      │
-│  2. File Deletion Detection (NEW)                  │
-│  3. Thumbnail Verification (NEW)                   │
-│  4. Database Cleanup (NEW)                         │
-└────────────────────────────────────────────────────┘
-```
-
-### **Key Features**
-- **File Existence Check** - Verify database files still exist on disk
-- **Thumbnail Verification** - Check if thumbnail files exist and are valid
-- **Database Cleanup** - Remove orphaned media records
-- **Thumbnail Regeneration** - Recreate missing thumbnails
-
----
-
-## 📈 **Key Improvements**
-
-### **Before vs After Comparison**
-
-| **Aspect** | **Current System** | **Enhanced System** |
-|------------|-------------------|-------------------|
-| **File Cleanup** | ❌ Manual only | ✅ Automatic detection & removal |
-| **Thumbnail Management** | ❌ No verification | ✅ Missing detection & regeneration |
-| **Data Integrity** | ❌ Database drift | ✅ Database matches file system |
-| **Error Handling** | ❌ Stops on errors | ✅ Continues with logging |
-
----
-
-## 🎯 **Core Capabilities Delivered**
-
-### **1. File Deletion Detection**
-- **Automatic Cleanup**: Detects and removes files deleted from disk
-- **Smart Detection**: Compares file system state with database
-- **Safe Operations**: Deletes only confirmed missing files
-- **Console Reporting**: Logs cleanup actions
-
-### **2. Thumbnail Recovery**
-- **Existence Verification**: Checks for missing thumbnail files
-- **Automatic Regeneration**: Recreates missing thumbnails during scan
-- **Error Tolerance**: Continues processing even if thumbnails fail
-- **Fallback Support**: Uses type-based fallback thumbnails when needed
-
----
-
-## 📊 **Performance Metrics**
-
-### **Expected Performance**
-- **Scan Speed**: Similar to current implementation (no major changes)
-- **Memory Usage**: <500MB for large libraries (same as current)
-- **Thumbnail Generation**: <2 seconds average per file (same as current)
-- **Database Operations**: <50ms per operation
-
-### **Scalability**
-- **File Count**: Support libraries with existing file counts
-- **Library Size**: Handle existing media collections efficiently
-- **Error Tolerance**: Continue processing even with failures
-
----
-
-## 🧪 **Testing Coverage**
-
-### **Basic Test Suite**
-- **Unit Tests**: Core component validation
-- **Integration Tests**: End-to-end scan workflow
-- **Manual Testing**: Verify with real libraries
-
-### **Test Scenarios**
-- **File Deletion**: Verify orphaned records removed
-- **Missing Thumbnails**: Verify regeneration works
-- **Error Handling**: Verify scan continues on failures
-- **Database Integrity**: Verify no data corruption
-
----
-
-## 📚 **Documentation Created**
-
-### **Simplified Documentation Package**
-1. **[Requirements Document](LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md)** - Core requirements specification
-2. **[Architecture Document](LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md)** - Technical design
-3. **[Implementation Plan](LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md)** - Step-by-step guide
-4. **[Summary Document](LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md)** - This overview
-
----
-
-## 🚀 **Implementation Status**
-
-### **Single Phase Implementation** (🔴 Critical - 6-8 hours)
-- ✅ **Requirements Analysis**: Simplified focused requirements
-- ✅ **Architecture Design**: Streamlined system design
-- ✅ **Implementation Plan**: Pragmatic development roadmap
-- 📋 **Development**: Ready to begin implementation
-- ⏳ **Testing**: Planned after development completion
-
----
-
-## 🎯 **Success Criteria**
-
-### **Functional Success**
-- ✅ Automatic detection and cleanup of deleted files
-- ✅ Missing thumbnail detection and regeneration
-- ✅ Error tolerance - scan continues on failures
-- ✅ No regression in existing functionality
-
-### **Quality Success**
-- ✅ Basic unit tests passing
-- ✅ Integration test validates end-to-end workflow
-- ✅ Manual testing with real libraries
-- ✅ Simplified documentation package
-
----
-
-## 🔗 **Related Resources**
-
-### **Core Documentation**
-- [Library Scan Enhancement Requirements](LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md)
-- [Library Scan Enhancement Architecture](LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md)  
-- [Library Scan Enhancement Implementation Plan](LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md)
-
-### **Project Context**
-- [Main Documentation](../../README.md)
-- [Feature Status](../../FEATURE_STATUS.md)
-- [Library Clusters Feature](LIBRARY_CLUSTER_FEATURE.md)
-
-### **Testing Resources**
-- [Test Suite Documentation](../../../tests/README.md)
-- [Performance Testing](../../../tests/performance/)
-
----
-
-## 📈 **Business Impact**
-
-### **User Experience Improvements**
-- **Reliability**: No more orphaned database entries
-- **Maintenance**: Automatic thumbnail recovery
-- **Trust**: Database accurately reflects file system
-
-### **Technical Benefits**
-- **Data Integrity**: Consistent database state
-- **Maintainability**: Simple, focused enhancements
-- **Reliability**: Handles missing files gracefully
-
----
-
-*Document Status*: ✅ **Complete**  
-*Total Documentation Package*: 4 focused documents  
-*Implementation Readiness*: 📋 **Ready for Development**  
-*Estimated Time*: 6-8 hours  
-*Last Updated*: October 14, 2025
-
-**Next Steps**: Begin implementation following the simplified implementation plan focusing solely on file deletion cleanup and thumbnail recovery.

docs/active/library-clusters/LIBRARY_SCAN_REDESIGN_OVERVIEW.md

@@ -1,272 +0,0 @@
-# Library Scan Enhancement - Redesign Overview
-
-## 📋 **What Changed**
-
-The library scan enhancement has been **completely redesigned** from a comprehensive multi-phase feature (18-23 hours) to a **focused, pragmatic solution** (6-8 hours) that addresses only the two core requirements you specified.
-
----
-
-## 🎯 **Original vs Redesigned Scope**
-
-### **❌ Original Plan (Removed Features)**
-
-The original design included many advanced features that are **NOT needed**:
-
-- ❌ Real-time progress reporting with WebSocket updates
-- ❌ Scan session tracking and history database
-- ❌ Concurrent processing with worker threads
-- ❌ Incremental scanning (only changed files)
-- ❌ Content-based duplicate detection
-- ❌ Advanced error recovery mechanisms
-- ❌ Soft delete with rollback capability
-- ❌ Complex transaction management
-- ❌ Performance monitoring and metrics
-- ❌ Advanced reporting system
-- ❌ Progress UI components
-- ❌ New database tables and schema changes
-
-**Why removed**: These features add significant complexity without addressing the core problems.
-
-### **✅ Redesigned Plan (Core Features Only)**
-
-The new design focuses **exclusively** on your two requirements:
-
-1. **File Deletion Cleanup**
-   - Detect files that exist in database but not on disk
-   - Remove orphaned database records
-   - Log cleanup actions
-
-2. **Thumbnail Recovery**
-   - Check if thumbnail files exist for each media record
-   - Regenerate missing thumbnails
-   - Use fallback thumbnails on failure
-
-**Why better**: Simple, focused, quick to implement, solves the actual problems.
-
----
-
-## 📊 **Comparison Summary**
-
-| **Aspect** | **Original Design** | **Redesigned** |
-|------------|-------------------|----------------|
-| **Scope** | 7 major features | 2 core features |
-| **Implementation Time** | 18-23 hours | 6-8 hours |
-| **Code Changes** | Multiple files, new modules | Single file (`scanner.ts`) |
-| **Database Changes** | New tables, schema updates | None |
-| **Complexity** | High (worker threads, WebSockets) | Low (simple functions) |
-| **Testing** | Comprehensive suite | Basic manual tests |
-| **Documentation** | 4 detailed docs | 4 focused docs |
-
----
-
-## 🏗️ **Technical Approach**
-
-### **Redesigned Architecture**
-
-**Minimal changes to existing scanner**:
-
-```typescript
-// File: src/lib/scanner.ts
-
-// Add 2 helper functions
-async function cleanupDeletedFiles(...) { }
-async function verifyAndRegenerateThumbnail(...) { }
-
-// Enhance existing scanLibrary function
-const scanLibrary = async (library) => {
-  // 1. File discovery (existing)
-  const mediaFiles = await glob(...);
-  
-  // 2. Cleanup deleted files (NEW)
-  await cleanupDeletedFiles(db, library.id, mediaFiles);
-  
-  // 3. Process files (existing + enhanced)
-  for (const file of mediaFiles) {
-    const existing = db.get(file);
-    
-    if (existing) {
-      // Verify thumbnail (NEW)
-      await verifyAndRegenerateThumbnail(existing);
-    } else {
-      // Insert new file (existing)
-    }
-  }
-};
-```
-
-**That's it!** No worker threads, no WebSockets, no new tables.
-
----
-
-## 📝 **Documentation Updates**
-
-All 4 documentation files have been rewritten:
-
-### **1. Requirements Document**
-- **Removed**: 5 complex requirements with sub-requirements
-- **Kept**: 2 core requirements with clear acceptance criteria
-- **Added**: Non-requirements section (what's explicitly excluded)
-
-### **2. Architecture Document**
-- **Removed**: Complex multi-component architecture diagrams
-- **Kept**: Simple enhancement to existing scanner
-- **Simplified**: No worker pools, no WebSockets, no transactions
-
-### **3. Implementation Plan**
-- **Removed**: 4 phases over 18-23 hours
-- **Kept**: 4 simple steps over 6-8 hours
-- **Focused**: Actual code to add to `scanner.ts`
-
-### **4. Summary Document**
-- **Updated**: All metrics and timelines
-- **Simplified**: Feature comparison table
-- **Clarified**: Business impact focuses on data integrity
-
----
-
-## 🎯 **What You Get**
-
-### **Problem 1 Solution: File Deletion Cleanup**
-
-```typescript
-// When you delete files from disk and re-scan:
-// Before: Files stay in database forever (orphaned records)
-// After:  Files automatically removed from database
-
-// Console output:
-// ✓ Removed orphaned record: /path/to/deleted/file.mp4
-// 📊 Cleanup complete: 5 orphaned record(s) removed
-```
-
-### **Problem 2 Solution: Thumbnail Recovery**
-
-```typescript
-// When thumbnails are missing and you re-scan:
-// Before: Thumbnails stay missing forever
-// After:  Thumbnails automatically regenerated
-
-// Console output:
-// 🔄 Regenerating missing thumbnail for: video.mp4
-// ✓ Successfully regenerated thumbnail: video.mp4
-```
-
-### **Bonus: Enhanced Logging**
-
-```typescript
-// Scan statistics logged at end:
-// 📊 Scan Complete:
-//    Files Processed: 150
-//    Files Added: 10
-//    Files Removed: 5
-//    Thumbnails Regenerated: 3
-```
-
----
-
-## ⚡ **Implementation Steps**
-
-**Step 1**: Add `cleanupDeletedFiles()` helper function (2-3 hours)  
-**Step 2**: Add `verifyAndRegenerateThumbnail()` helper function (2-3 hours)  
-**Step 3**: Enhance `scanLibrary()` to call these functions (1-2 hours)  
-**Step 4**: Test with real library (1 hour)
-
-**Total**: 6-8 hours
-
----
-
-## 🧪 **Testing**
-
-### **Simple Manual Tests**
-
-**Test 1: File Deletion**
-```bash
-1. Add files to library and scan
-2. Delete some files from disk
-3. Re-scan
-4. Verify: Files removed from database ✓
-```
-
-**Test 2: Thumbnail Recovery**
-```bash
-1. Add files to library and scan
-2. Delete thumbnail files
-3. Re-scan
-4. Verify: Thumbnails regenerated ✓
-```
-
-**Test 3: Error Handling**
-```bash
-1. Create corrupt file
-2. Scan
-3. Verify: Scan completes despite error ✓
-```
-
----
-
-## 🔍 **What's NOT Included**
-
-To keep this simple and focused, the following are **explicitly excluded**:
-
-- ❌ Progress bars or real-time UI updates
-- ❌ Scan history or session tracking
-- ❌ Performance optimizations (concurrent processing)
-- ❌ Incremental scanning (only changed files)
-- ❌ Duplicate file detection
-- ❌ Advanced error recovery
-- ❌ Database transactions
-- ❌ Soft delete functionality
-- ❌ WebSocket progress updates
-- ❌ New API endpoints
-- ❌ New database tables
-
-**Rationale**: These features don't solve your two core problems and would add 12-15 hours of additional work.
-
----
-
-## 📁 **Documentation Files**
-
-All documentation has been rewritten and is ready to use:
-
-1. **[LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md](LIBRARY_SCAN_ENHANCEMENT_SUMMARY.md)**  
-   High-level overview of the redesigned feature
-
-2. **[LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md](LIBRARY_SCAN_ENHANCEMENT_REQUIREMENTS.md)**  
-   Focused requirements for the 2 core features
-
-3. **[LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md](LIBRARY_SCAN_ENHANCEMENT_ARCHITECTURE.md)**  
-   Simple technical design with code examples
-
-4. **[LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md](LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md)**  
-   Step-by-step implementation guide with actual code
-
----
-
-## ✅ **Next Steps**
-
-You can now proceed with implementation following the simplified plan:
-
-1. **Read** the [Implementation Plan](LIBRARY_SCAN_ENHANCEMENT_IMPLEMENTATION.md)
-2. **Implement** Step 1: Add `cleanupDeletedFiles()` function
-3. **Implement** Step 2: Add `verifyAndRegenerateThumbnail()` function
-4. **Implement** Step 3: Enhance `scanLibrary()` function
-5. **Test** with your media library
-6. **Deploy** - it's a single file change!
-
----
-
-## 🎉 **Benefits of Redesign**
-
-✅ **Simpler**: No complex architecture  
-✅ **Faster**: 6-8 hours vs 18-23 hours  
-✅ **Focused**: Solves actual problems  
-✅ **Maintainable**: Single file change  
-✅ **Testable**: Simple manual testing  
-✅ **Practical**: No over-engineering  
-
----
-
-*Document Status*: ✅ **Complete**  
-*Redesign Date*: October 14, 2025  
-*Ready to Implement*: Yes  
-
-**Questions?** Review the detailed implementation plan for step-by-step guidance.

src/app/api/libraries/intellisense/route.ts

@@ -1,77 +0,0 @@
-import { NextResponse } from "next/server";
-import fs from "fs";
-import path from "path";
-import { getDatabase } from '@/db';
-
-export async function GET(request: Request) {
-  const { searchParams } = new URL(request.url);
-  const basePath = searchParams.get("basePath") || "/mnt";
-  const subPath = searchParams.get("subPath") || "";
-
-  try {
-    // Get all existing libraries from database
-    const db = getDatabase();
-    const libraries = db.prepare('SELECT path FROM libraries').all() as Array<{ path: string }>;
-    const libraryPaths = new Set(libraries.map(lib => lib.path));
-
-    // Construct the full path to explore
-    const fullPath = path.join(basePath, subPath);
-    
-    // Validate that we're still within the base path for security
-    const resolvedPath = path.resolve(fullPath);
-    const resolvedBasePath = path.resolve(basePath);
-    
-    if (!resolvedPath.startsWith(resolvedBasePath)) {
-      return NextResponse.json({ error: "Access denied" }, { status: 403 });
-    }
-
-    // Check if path exists
-    if (!fs.existsSync(resolvedPath)) {
-      return NextResponse.json({ error: "Path does not exist" }, { status: 404 });
-    }
-
-    // Check if it's a directory
-    const stats = fs.statSync(resolvedPath);
-    if (!stats.isDirectory()) {
-      return NextResponse.json({ error: "Path is not a directory" }, { status: 400 });
-    }
-
-    // Read directory contents
-    const entries = fs.readdirSync(resolvedPath);
-    const result = entries.map(entry => {
-      const entryPath = path.join(resolvedPath, entry);
-      const entryStats = fs.statSync(entryPath);
-      const isDirectory = entryStats.isDirectory();
-      const isAlreadyLibrary = libraryPaths.has(entryPath);
-      
-      return {
-        name: entry,
-        path: entryPath,
-        isDirectory,
-        isAlreadyLibrary,
-        size: entryStats.size,
-        modified: entryStats.mtime
-      };
-    }).filter(item => item.isDirectory); // Only return directories
-
-    // Sort: directories first, then alphabetically
-    result.sort((a, b) => {
-      if (a.name.toLowerCase() < b.name.toLowerCase()) return -1;
-      if (a.name.toLowerCase() > b.name.toLowerCase()) return 1;
-      return 0;
-    });
-
-    const response = {
-      path: resolvedPath,
-      parentPath: resolvedPath !== resolvedBasePath ? path.dirname(resolvedPath) : null,
-      items: result
-    };
-    
-    console.log('IntelliSense response:', JSON.stringify(response, null, 2));
-    
-    return NextResponse.json(response);
-  } catch (error: any) {
-    console.error('IntelliSense error:', error);
-    return NextResponse.json({ error: error.message }, { status: 500 });
-  }
-}

src/app/api/scan/route.ts

@@ -7,28 +7,16 @@ export async function POST(request: Request) {
     const body = await request.json();
     const { libraryId } = body;
 
-    let stats;
     if (libraryId) {
       // Scan specific library
-      stats = await scanSelectedLibrary(libraryId);
+      await scanSelectedLibrary(libraryId);
-      return NextResponse.json({
+      return NextResponse.json({ message: `Library ${libraryId} scan complete` });
-        success: true,
-        message: `Library ${libraryId} scan complete`,
-        stats
-      });
     } else {
       // Scan all libraries
-      stats = await scanAllLibraries();
+      await scanAllLibraries();
-      return NextResponse.json({
+      return NextResponse.json({ message: "All libraries scan complete" });
-        success: true,
-        message: "All libraries scan complete",
-        stats
-      });
     }
   } catch (error: any) {
-    return NextResponse.json(
+    return NextResponse.json({ error: error.message }, { status: 500 });
-      { success: false, error: error.message },
-      { status: 500 }
-    );
   }
 }

src/app/clusters/[id]/page.tsx

@@ -49,20 +49,6 @@ export default function ClusterPage({ params }: ClusterPageProps) {
     }
   }, [clusterId]);
 
-  // Prevent body scrolling when cluster page is active
-  useEffect(() => {
-    const originalBodyOverflow = document.body.style.overflow;
-    const originalHtmlOverflow = document.documentElement.style.overflow;
-
-    document.body.style.overflow = 'hidden';
-    document.documentElement.style.overflow = 'hidden';
-
-    return () => {
-      document.body.style.overflow = originalBodyOverflow;
-      document.documentElement.style.overflow = originalHtmlOverflow;
-    };
-  }, []);
-
   const fetchClusterData = async () => {
     try {
       setLoading(true);
@@ -138,46 +124,20 @@ export default function ClusterPage({ params }: ClusterPageProps) {
 
   const handleRate = async (id: number, rating: number) => {
     try {
-      if (rating === 0) {
+      const res = await fetch('/api/stars', {
-        // For unstarring (rating = 0), we need to delete the existing rating
-        // First, get the current rating record to find the star ID
-        const getResponse = await fetch(`/api/stars/${id}`);
-        if (getResponse.ok) {
-          const data = await getResponse.json();
-          if (data.hasRating) {
-            // We need to get the actual star record ID to delete it
-            // Since the API structure doesn't return star ID, we'll use a different approach
-            // Delete by media_id instead of star id
-            await fetch(`/api/stars`, {
-              method: 'DELETE',
-              headers: { 'Content-Type': 'application/json' },
-              body: JSON.stringify({ mediaId: id })
-            });
-          }
-        }
-      } else {
-        // For setting/updating a rating
-        await fetch(`/api/stars`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ mediaId: id, rating })
       });
-      }
+      if (res.ok) {
         // Refresh data
         fetchClusterData();
+      }
     } catch (error) {
       console.error('Error rating:', error);
     }
   };
 
-  const formatFileSize = (bytes: number) => {
-    if (bytes === 0) return '0 Bytes';
-    const k = 1024;
-    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
-    const i = Math.floor(Math.log(bytes) / Math.log(k));
-    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
-  };
-
   const getIconComponent = (iconName: string) => {
     const icons: Record<string, any> = {
       folder: Folder,
@@ -231,12 +191,11 @@ export default function ClusterPage({ params }: ClusterPageProps) {
   const IconComponent = getIconComponent(cluster.icon);
 
   return (
-    <div className="h-screen bg-zinc-950 overflow-hidden flex flex-col">
+    <div className="min-h-screen bg-zinc-950">
       {/* Header */}
       <div className="bg-zinc-900 border-b border-zinc-800">
-        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-3">
+        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
-          <div className="flex items-center justify-between">
+          <div className="flex items-center gap-4 mb-4">
-            <div className="flex items-center gap-3">
             <Button
               variant="ghost"
               size="sm"
@@ -246,80 +205,84 @@ export default function ClusterPage({ params }: ClusterPageProps) {
               <ArrowLeft className="h-4 w-4 mr-2" />
               Back
             </Button>
+          </div>
+
+          <div className="flex items-start gap-4">
             <div
-                className="w-10 h-10 rounded-lg flex items-center justify-center shadow-lg flex-shrink-0"
+              className="w-16 h-16 rounded-xl flex items-center justify-center shadow-lg flex-shrink-0"
               style={{ backgroundColor: `${cluster.color}20` }}
             >
-                <IconComponent className="h-5 w-5" style={{ color: cluster.color }} />
+              <IconComponent className="h-8 w-8" style={{ color: cluster.color }} />
             </div>
-              <div>
+            <div className="flex-1">
-                <h1 className="text-xl font-bold text-white">{cluster.name}</h1>
+              <h1 className="text-3xl font-bold text-white mb-2">{cluster.name}</h1>
               {cluster.description && (
-                  <p className="text-zinc-400 text-sm">{cluster.description}</p>
+                <p className="text-zinc-400 text-lg">{cluster.description}</p>
               )}
-              </div>
+              <div className="flex gap-3 mt-3 text-sm text-zinc-500">
-            </div>
-            {stats && (
-              <div className="flex gap-4 text-sm text-zinc-500">
                 <span>{libraries.length} {libraries.length === 1 ? 'library' : 'libraries'}</span>
+                {stats && (
+                  <>
                     <span>•</span>
                     <span>{stats.total_media} items</span>
                     <span>•</span>
                     <span>{formatSize(stats.total_size)}</span>
-              </div>
+                  </>
                 )}
               </div>
             </div>
           </div>
+        </div>
+      </div>
 
       {/* Stats Cards */}
       {stats && (
-        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-3">
+        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
-          <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
+          <div className="grid grid-cols-1 md:grid-cols-4 gap-4">
-            <Card className="bg-zinc-900 border-zinc-800 p-3">
+            <Card className="bg-zinc-900 border-zinc-800 p-4">
-              <div className="flex items-center gap-2">
+              <div className="flex items-center gap-3">
-                <div className="w-8 h-8 bg-red-600/20 rounded-lg flex items-center justify-center">
+                <div className="w-10 h-10 bg-red-600/20 rounded-lg flex items-center justify-center">
-                  <Film className="h-4 w-4 text-red-400" />
+                  <Film className="h-5 w-5 text-red-400" />
                 </div>
                 <div>
-                  <p className="text-lg font-bold text-white">{stats.video_count || 0}</p>
+                  <p className="text-2xl font-bold text-white">{stats.video_count || 0}</p>
-                  <p className="text-xs text-zinc-400">Videos</p>
+                  <p className="text-sm text-zinc-400">Videos</p>
                 </div>
               </div>
             </Card>
 
-            <Card className="bg-zinc-900 border-zinc-800 p-3">
+            <Card className="bg-zinc-900 border-zinc-800 p-4">
-              <div className="flex items-center gap-2">
+              <div className="flex items-center gap-3">
-                <div className="w-8 h-8 bg-green-600/20 rounded-lg flex items-center justify-center">
+                <div className="w-10 h-10 bg-green-600/20 rounded-lg flex items-center justify-center">
-                  <ImageIcon className="h-4 w-4 text-green-400" />
+                  <ImageIcon className="h-5 w-5 text-green-400" />
                 </div>
                 <div>
-                  <p className="text-lg font-bold text-white">{stats.photo_count || 0}</p>
+                  <p className="text-2xl font-bold text-white">{stats.photo_count || 0}</p>
-                  <p className="text-xs text-zinc-400">Photos</p>
+                  <p className="text-sm text-zinc-400">Photos</p>
                 </div>
               </div>
             </Card>
 
-            <Card className="bg-zinc-900 border-zinc-800 p-3">
+            <Card className="bg-zinc-900 border-zinc-800 p-4">
-              <div className="flex items-center gap-2">
+              <div className="flex items-center gap-3">
-                <div className="w-8 h-8 bg-blue-600/20 rounded-lg flex items-center justify-center">
+                <div className="w-10 h-10 bg-blue-600/20 rounded-lg flex items-center justify-center">
-                  <FileText className="h-4 w-4 text-blue-400" />
+                  <FileText className="h-5 w-5 text-blue-400" />
                 </div>
                 <div>
-                  <p className="text-lg font-bold text-white">{stats.text_count || 0}</p>
+                  <p className="text-2xl font-bold text-white">{stats.text_count || 0}</p>
-                  <p className="text-xs text-zinc-400">Texts</p>
+                  <p className="text-sm text-zinc-400">Texts</p>
                 </div>
               </div>
             </Card>
 
-            <Card className="bg-zinc-900 border-zinc-800 p-3">
+            <Card className="bg-zinc-900 border-zinc-800 p-4">
-              <div className="flex items-center gap-2">
+              <div className="flex items-center gap-3">
-                <div className="w-8 h-8 bg-purple-600/20 rounded-lg flex items-center justify-center">
+                <div className="w-10 h-10 bg-purple-600/20 rounded-lg flex items-center justify-center">
-                  <HardDrive className="h-4 w-4 text-purple-400" />
+                  <HardDrive className="h-5 w-5 text-purple-400" />
                 </div>
                 <div>
-                  <p className="text-lg font-bold text-white">{formatSize(stats.total_size || 0)}</p>
+                  <p className="text-2xl font-bold text-white">{formatSize(stats.total_size || 0)}</p>
-                  <p className="text-xs text-zinc-400">Storage</p>
+                  <p className="text-sm text-zinc-400">Storage</p>
                 </div>
               </div>
             </Card>
@@ -328,12 +291,12 @@ export default function ClusterPage({ params }: ClusterPageProps) {
       )}
 
       {/* Tabs */}
-      <div className="bg-zinc-950 border-b border-zinc-800 flex-shrink-0">
       <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
-          <nav className="flex gap-2">
+        <div className="border-b border-zinc-800">
+          <nav className="flex gap-4">
             <button
               onClick={() => setActiveTab('folders')}
-              className={`px-3 py-2 text-sm font-medium border-b-2 transition-colors ${
+              className={`px-4 py-3 text-sm font-medium border-b-2 transition-colors ${
                 activeTab === 'folders'
                   ? 'border-primary text-primary'
                   : 'border-transparent text-zinc-400 hover:text-zinc-300'
@@ -344,7 +307,7 @@ export default function ClusterPage({ params }: ClusterPageProps) {
             </button>
             <button
               onClick={() => setActiveTab('videos')}
-              className={`px-3 py-2 text-sm font-medium border-b-2 transition-colors ${
+              className={`px-4 py-3 text-sm font-medium border-b-2 transition-colors ${
                 activeTab === 'videos'
                   ? 'border-primary text-primary'
                   : 'border-transparent text-zinc-400 hover:text-zinc-300'
@@ -355,7 +318,7 @@ export default function ClusterPage({ params }: ClusterPageProps) {
             </button>
             <button
               onClick={() => setActiveTab('photos')}
-              className={`px-3 py-2 text-sm font-medium border-b-2 transition-colors ${
+              className={`px-4 py-3 text-sm font-medium border-b-2 transition-colors ${
                 activeTab === 'photos'
                   ? 'border-primary text-primary'
                   : 'border-transparent text-zinc-400 hover:text-zinc-300'
@@ -366,7 +329,7 @@ export default function ClusterPage({ params }: ClusterPageProps) {
             </button>
             <button
               onClick={() => setActiveTab('texts')}
-              className={`px-3 py-2 text-sm font-medium border-b-2 transition-colors ${
+              className={`px-4 py-3 text-sm font-medium border-b-2 transition-colors ${
                 activeTab === 'texts'
                   ? 'border-primary text-primary'
                   : 'border-transparent text-zinc-400 hover:text-zinc-300'
@@ -377,7 +340,7 @@ export default function ClusterPage({ params }: ClusterPageProps) {
             </button>
             <button
               onClick={() => setActiveTab('stats')}
-              className={`px-3 py-2 text-sm font-medium border-b-2 transition-colors ${
+              className={`px-4 py-3 text-sm font-medium border-b-2 transition-colors ${
                 activeTab === 'stats'
                   ? 'border-primary text-primary'
                   : 'border-transparent text-zinc-400 hover:text-zinc-300'
@@ -391,7 +354,6 @@ export default function ClusterPage({ params }: ClusterPageProps) {
       </div>
 
       {/* Content */}
-      <div className="flex-1 overflow-y-auto">
       <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
         {activeTab === 'folders' && cluster && (
           <ClusterFolderView
@@ -490,7 +452,6 @@ export default function ClusterPage({ params }: ClusterPageProps) {
           </div>
         )}
       </div>
-      </div>
 
       {/* Video Player Modal */}
       {isPlayerOpen && selectedVideo && (
@@ -501,11 +462,8 @@ export default function ClusterPage({ params }: ClusterPageProps) {
             setIsPlayerOpen(false);
             setSelectedVideo(null);
           }}
-          playerType="modal"
-          useArtPlayer={true}
           showBookmarks={true}
           showRatings={true}
-          formatFileSize={formatFileSize}
           onBookmark={handleBookmark}
           onUnbookmark={handleUnbookmark}
           onRate={handleRate}

src/app/settings/page.tsx

@@ -18,7 +18,6 @@ import {
 } from "@/lib/player-preferences";
 import { ClusterManagement } from "@/components/cluster-management";
 import { LibraryClusterBadges } from "@/components/library-cluster-badges";
-import path from "path";
 
 interface Library {
   id: number;
@@ -40,18 +39,6 @@ const SettingsPage = () => {
     icon: string;
   }>>([]);
 
-  // IntelliSense states
-  const [intelliSenseItems, setIntelliSenseItems] = useState<Array<{
-    name: string;
-    path: string;
-    isAlreadyLibrary: boolean;
-    modified: string;
-  }>>([]);
-  const [showIntelliSense, setShowIntelliSense] = useState(false);
-  const [intelliSenseLoading, setIntelliSenseLoading] = useState(false);
-  const [intelliSensePath, setIntelliSensePath] = useState("/mnt");
-  const [intelliSenseParentPath, setIntelliSenseParentPath] = useState<string | null>(null);
-
   useEffect(() => {
     fetchLibraries();
     loadVideoPlayerPreferences();
@@ -108,10 +95,6 @@ const SettingsPage = () => {
         setNewLibraryPath("");
         setError(null);
         fetchLibraries();
-        // Refresh IntelliSense if it's open
-        if (showIntelliSense) {
-          fetchIntelliSenseItems(intelliSensePath);
-        }
       } else {
         const data = await res.json();
         setError(data.error || "Failed to add library");
@@ -132,10 +115,6 @@ const SettingsPage = () => {
       });
       if (res.ok) {
         fetchLibraries();
-        // Refresh IntelliSense if it's open
-        if (showIntelliSense) {
-          fetchIntelliSenseItems(intelliSensePath);
-        }
       }
     } catch (error) {
       console.error('Error deleting library:', error);
@@ -282,48 +261,6 @@ const SettingsPage = () => {
     }, 0);
   };
 
-  // IntelliSense functions
-  const fetchIntelliSenseItems = async (currentPath: string = "/mnt") => {
-    setIntelliSenseLoading(true);
-    try {
-      const res = await fetch(`/api/libraries/intellisense?basePath=/mnt&subPath=${encodeURIComponent(currentPath.substring(4))}`);
-      if (res.ok) {
-        const data = await res.json();
-        setIntelliSenseItems(data.items);
-        setIntelliSensePath(data.path);
-        setIntelliSenseParentPath(data.parentPath);
-      } else {
-        const error = await res.json();
-        console.error('IntelliSense error:', error.error);
-      }
-    } catch (error) {
-      console.error('Network error fetching IntelliSense items:', error);
-    } finally {
-      setIntelliSenseLoading(false);
-    }
-  };
-
-  const openIntelliSense = () => {
-    setShowIntelliSense(true);
-    fetchIntelliSenseItems();
-  };
-
-  const closeIntelliSense = () => {
-    setShowIntelliSense(false);
-    setIntelliSenseItems([]);
-  };
-
-  const navigateToIntelliSenseFolder = (folderPath: string) => {
-    fetchIntelliSenseItems(folderPath);
-  };
-
-  const selectIntelliSenseItemAsLibrary = (itemPath: string, isAlreadyLibrary: boolean) => {
-    if (!isAlreadyLibrary) {
-      setNewLibraryPath(itemPath);
-      closeIntelliSense();
-    }
-  };
-
   return (
     <div className="min-h-screen bg-zinc-950 overflow-y-auto">
       <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
@@ -351,7 +288,6 @@ const SettingsPage = () => {
 
               <div className="space-y-4">
                 <div className="flex gap-3">
-                  <div className="flex-1 relative">
                   <input
                     type="text"
                     placeholder="/mnt/media or /path/to/media"
@@ -361,15 +297,8 @@ const SettingsPage = () => {
                       setError(null);
                     }}
                     onKeyPress={(e) => e.key === 'Enter' && addLibrary()}
-                      className="w-full px-4 py-3 bg-zinc-800 border border-zinc-700 rounded-lg text-sm text-white focus:outline-none focus:ring-2 focus:ring-red-500 focus:border-transparent transition-all placeholder-zinc-500"
+                    className="flex-1 px-4 py-3 bg-zinc-800 border border-zinc-700 rounded-lg text-sm text-white focus:outline-none focus:ring-2 focus:ring-red-500 focus:border-transparent transition-all placeholder-zinc-500"
                   />
-                    <button
-                      onClick={openIntelliSense}
-                      className="absolute right-2 top-1/2 transform -translate-y-1/2 px-2 py-1 bg-zinc-700 text-xs text-zinc-300 rounded hover:bg-zinc-600 transition-colors"
-                    >
-                      Browse
-                    </button>
-                  </div>
                   <button
                     onClick={addLibrary}
                     disabled={!newLibraryPath.trim()}
@@ -380,114 +309,6 @@ const SettingsPage = () => {
                   </button>
                 </div>
 
-                {showIntelliSense && (
-                  <div className="fixed inset-0 bg-black/50 z-50 flex items-center justify-center p-4">
-                    <div className="bg-zinc-900 rounded-xl border border-zinc-800 w-full max-w-2xl max-h-[80vh] flex flex-col">
-                      <div className="p-4 border-b border-zinc-800 flex items-center justify-between">
-                        <h3 className="text-lg font-bold text-white">Select Library Folder</h3>
-                        <button 
-                          onClick={closeIntelliSense}
-                          className="text-zinc-400 hover:text-white"
-                        >
-                          ✕
-                        </button>
-                      </div>
-                      
-                      <div className="p-4 border-b border-zinc-800">
-                        <div className="text-sm text-zinc-400 mb-2">Current Path:</div>
-                        <div className="font-mono text-sm text-zinc-200 bg-zinc-800 p-2 rounded flex items-center justify-between">
-                          <span className="truncate">{intelliSensePath}</span>
-                          <button
-                            onClick={() => navigateToIntelliSenseFolder(intelliSensePath)}
-                            className="ml-2 px-2 py-1 bg-zinc-700 text-xs text-zinc-300 rounded hover:bg-zinc-600"
-                          >
-                            Select as Library
-                          </button>
-                        </div>
-                      </div>
-                      
-                      <div className="flex-1 overflow-y-auto p-4">
-                        {intelliSenseLoading ? (
-                          <div className="flex items-center justify-center h-32">
-                            <div className="animate-spin rounded-full h-8 w-8 border-2 border-red-500 border-t-transparent"></div>
-                          </div>
-                        ) : (
-                          <div className="space-y-1">
-                            {intelliSenseParentPath && (
-                              <button
-                                onClick={() => navigateToIntelliSenseFolder(intelliSenseParentPath)}
-                                className="flex items-center gap-2 w-full p-2 text-zinc-300 hover:bg-zinc-800 rounded"
-                              >
-                                <span className="transform rotate-180">📁</span>
-                                <span>..</span>
-                              </button>
-                            )}
-                            
-                            {intelliSenseItems.length > 0 ? (
-                              intelliSenseItems.map((item, index) => (
-                                <div 
-                                  key={index}
-                                  className={`flex items-center gap-2 w-full p-2 rounded ${
-                                    item.isAlreadyLibrary 
-                                      ? 'text-zinc-500' 
-                                      : 'text-zinc-200 hover:bg-zinc-800'
-                                  }`}
-                                >
-                                  <button
-                                    onClick={() => !item.isAlreadyLibrary && navigateToIntelliSenseFolder(item.path)}
-                                    disabled={item.isAlreadyLibrary}
-                                    className="flex items-center gap-2 flex-1 text-left"
-                                  >
-                                    <span>📁</span>
-                                    <div>
-                                      <div className="truncate">{item.name}</div>
-                                      <div className="text-xs text-zinc-500">
-                                        Modified: {new Date(item.modified).toLocaleDateString()}
-                                      </div>
-                                    </div>
-                                  </button>
-                                  <button
-                                    onClick={() => selectIntelliSenseItemAsLibrary(item.path, item.isAlreadyLibrary)}
-                                    disabled={item.isAlreadyLibrary}
-                                    className={`px-3 py-1 text-xs rounded ${
-                                      item.isAlreadyLibrary
-                                        ? 'bg-zinc-700 text-zinc-500 cursor-not-allowed'
-                                        : 'bg-red-600 text-white hover:bg-red-700'
-                                    }`}
-                                  >
-                                    Select
-                                  </button>
-                                </div>
-                              ))
-                            ) : (
-                              <div className="text-center py-8 text-zinc-500">
-                                No folders found in this directory
-                              </div>
-                            )}
-                          </div>
-                        )}
-                      </div>
-                      
-                      <div className="p-4 border-t border-zinc-800 flex justify-between">
-                        <button
-                          onClick={closeIntelliSense}
-                          className="px-4 py-2 text-zinc-400 hover:text-white transition-colors"
-                        >
-                          Cancel
-                        </button>
-                        <div className="flex gap-2">
-                          <button
-                            onClick={() => navigateToIntelliSenseFolder("/mnt")}
-                            className="px-4 py-2 bg-zinc-700 text-white rounded hover:bg-zinc-600 transition-colors"
-                          >
-                            Back to /mnt
-                          </button>
-                        </div>
-                      </div>
-                    </div>
-                  </div>
-                )}
-
                 {error && (
                   <div className="p-3 bg-red-900/20 border border-red-800 rounded-lg">
                     <p className="text-sm text-red-400">{error}</p>

src/app/surprise-me/page.tsx

@@ -14,7 +14,7 @@ const ALGORITHMS = [
 ] as const;
 
 export default function SurpriseMePage() {
-  const [algorithm, setAlgorithm] = useState<Algorithm>('weighted_random');
+  const [algorithm, setAlgorithm] = useState<Algorithm>('unwatched_first');
   const [recommendations, setRecommendations] = useState<any[]>([]);
   const [isLoading, setIsLoading] = useState(true);
   const [selectedVideo, setSelectedVideo] = useState<any>(null);

src/components/artplayer-wrapper.tsx

@@ -60,7 +60,7 @@ export default function ArtPlayerWrapper({
   const [localAvgRating, setLocalAvgRating] = useState(avgRating);
   const hlsErrorHandlerRef = useRef<HLSErrorHandler | null>(null);
 
-  // Prevent ALL scrolling when video player is open
+  // Prevent body scroll when video player is open
   useEffect(() => {
     if (isOpen) {
       // Save current body overflow and apply overflow hidden
@@ -68,52 +68,13 @@ export default function ArtPlayerWrapper({
       const originalOverflowX = document.body.style.overflowX;
       const originalOverflowY = document.body.style.overflowY;
       
-      // Completely disable outer container scrolling
       document.body.style.overflow = 'hidden';
-      document.documentElement.style.overflow = 'hidden';
-      
-      // Also prevent scrolling on specific scrollable containers
-      const scrollableContainers = [
-        // VirtualizedFolderGrid containers
-        ...document.querySelectorAll('.h-full.relative.overflow-hidden'),
-        // InfiniteVirtualGrid containers  
-        ...document.querySelectorAll('.flex-1.relative.overflow-hidden'),
-        // Any container with FixedSizeGrid
-        ...document.querySelectorAll('[class*="FixedSizeGrid"]'),
-        // Any container with custom-scrollbar class
-        ...document.querySelectorAll('.custom-scrollbar'),
-        // Main content containers
-        ...document.querySelectorAll('.min-h-screen'),
-        ...document.querySelectorAll('.max-w-7xl')
-      ];
-      
-      const originalStyles: Array<{ element: HTMLElement; overflow: string; overflowX: string; overflowY: string }> = [];
-      
-      scrollableContainers.forEach(container => {
-        const element = container as HTMLElement;
-        originalStyles.push({
-          element,
-          overflow: element.style.overflow,
-          overflowX: element.style.overflowX,
-          overflowY: element.style.overflowY
-        });
-        
-        element.style.overflow = 'hidden';
-      });
       
       return () => {
         // Restore original overflow styles
         document.body.style.overflow = originalOverflow;
         document.body.style.overflowX = originalOverflowX;
         document.body.style.overflowY = originalOverflowY;
-        document.documentElement.style.overflow = '';
-        
-        // Restore scrollable containers
-        originalStyles.forEach(({ element, overflow, overflowX, overflowY }) => {
-          element.style.overflow = overflow;
-          element.style.overflowX = overflowX;
-          element.style.overflowY = overflowY;
-        });
       };
     }
   }, [isOpen]);

src/lib/scanner.ts

@@ -2,11 +2,9 @@ import { getDatabase } from "@/db";
 import { glob } from "glob";
 import path from "path";
 import fs from "fs";
-import { promises as fsPromises } from "fs";
 import ffmpeg from "fluent-ffmpeg";
 import { ThumbnailManager } from "./thumbnails";
 import { VideoAnalyzer } from "./video-utils";
-import type { Database as DatabaseType } from "better-sqlite3";
 
 const VIDEO_EXTENSIONS = ["mp4", "mkv", "avi", "mov", "wmv", "flv", "webm", "m4v", "ts"];
 const PHOTO_EXTENSIONS = ["jpg", "jpeg", "png", "gif", "bmp", "webp", "tiff", "svg"];
@@ -38,134 +36,8 @@ const generatePhotoThumbnail = (photoPath: string, thumbnailPath: string) => {
   });
 };
 
-// Helper function to convert thumbnail URL to file path
-function getThumbnailPathFromUrl(url: string): string {
-  // Convert URL like /thumbnails/ab/cd/file.png
-  // to full path like /path/to/public/thumbnails/ab/cd/file.png
-  return path.join(process.cwd(), 'public', url);
-}
-
-// Helper function: File Deletion Cleanup
-async function cleanupDeletedFiles(
-  db: DatabaseType,
-  libraryId: number,
-  currentFiles: string[]
-): Promise<{ removed: number }> {
-  // Get all media records for this library
-  const dbRecords = db.prepare(
-    "SELECT id, path FROM media WHERE library_id = ?"
-  ).all(libraryId) as { id: number; path: string }[];
-
-  // Create set of current file paths for fast lookup
-  const currentFileSet = new Set(currentFiles);
-
-  let removed = 0;
-
-  // Check each database record
-  for (const record of dbRecords) {
-    // If file doesn't exist in current scan
-    if (!currentFileSet.has(record.path)) {
-      try {
-        // Double-check file truly doesn't exist on disk
-        await fsPromises.access(record.path);
-        // File exists but wasn't in scan - possibly outside glob pattern
-        console.log(`File exists but not scanned: ${record.path}`);
-        continue;
-      } catch {
-        // File doesn't exist - remove from database
-        try {
-          db.prepare("DELETE FROM media WHERE id = ?").run(record.id);
-          console.log(`✓ Removed orphaned record: ${record.path}`);
-          removed++;
-        } catch (error) {
-          console.error(`✗ Failed to remove record ${record.path}:`, error);
-        }
-      }
-    }
-  }
-
-  if (removed > 0) {
-    console.log(`📊 Cleanup complete: ${removed} orphaned record(s) removed`);
-  }
-
-  return { removed };
-}
-
-// Helper function: Thumbnail Verification
-async function verifyAndRegenerateThumbnail(
-  media: { id: number; path: string; type: string; thumbnail: string }
-): Promise<{ regenerated: boolean }> {
-  // Skip if using fallback thumbnail
-  if (media.thumbnail.includes('/fallback/')) {
-    return { regenerated: false };
-  }
-
-  // Get full path from URL
-  const thumbnailPath = getThumbnailPathFromUrl(media.thumbnail);
-
-  try {
-    // Check if thumbnail file exists
-    await fsPromises.access(thumbnailPath);
-    return { regenerated: false }; // Thumbnail exists, no action needed
-  } catch {
-    // Thumbnail missing - regenerate
-    console.log(`🔄 Regenerating missing thumbnail for: ${path.basename(media.path)}`);
-
-    try {
-      const { folderPath, fullPath, url } = ThumbnailManager.getThumbnailPath(media.path);
-      ThumbnailManager.ensureDirectory(folderPath);
-
-      let regenerated = false;
-
-      if (media.type === 'video') {
-        await generateVideoThumbnail(media.path, fullPath);
-        regenerated = true;
-      } else if (media.type === 'photo') {
-        await generatePhotoThumbnail(media.path, fullPath);
-        regenerated = true;
-      }
-
-      if (regenerated) {
-        // Update database with new thumbnail path
-        const db = getDatabase();
-        db.prepare("UPDATE media SET thumbnail = ? WHERE id = ?")
-          .run(url, media.id);
-
-        console.log(`✓ Successfully regenerated thumbnail: ${path.basename(media.path)}`);
-        return { regenerated: true };
-      }
-
-      return { regenerated: false };
-
-    } catch (error) {
-      console.warn(`✗ Failed to regenerate thumbnail for ${path.basename(media.path)}:`, error);
-
-      // Use fallback thumbnail
-      const db = getDatabase();
-      const mediaType = media.type as 'video' | 'photo' | 'text';
-      const fallbackUrl = ThumbnailManager.getFallbackThumbnailUrl(mediaType);
-      db.prepare("UPDATE media SET thumbnail = ? WHERE id = ?")
-        .run(fallbackUrl, media.id);
-
-      return { regenerated: false };
-    }
-  }
-}
-
 const scanLibrary = async (library: { id: number; path: string }) => {
   const db = getDatabase();
-  
-  // Initialize statistics tracking
-  const stats = {
-    filesProcessed: 0,
-    filesAdded: 0,
-    filesRemoved: 0,
-    thumbnailsRegenerated: 0,
-    errors: 0
-  };
-  
-  console.log(`\n📚 Starting scan for library: ${library.path}`);
-  
   // Scan all files - handle all case variations
   const allFiles = await glob(`${library.path}/**/*.*`, { nodir: true });
   
@@ -187,25 +59,8 @@ const scanLibrary = async (library: { id: number; path: string }) => {
 
   const mediaFiles = [...filteredVideoFiles, ...filteredPhotoFiles, ...filteredTextFiles];
 
-  console.log(`📁 Found ${mediaFiles.length} media files`);
-  
-  // NEW: Cleanup deleted files
-  console.log(`\n🧹 Checking for deleted files...`);
-  try {
-    const cleanupResult = await cleanupDeletedFiles(db, library.id, mediaFiles);
-    stats.filesRemoved = cleanupResult.removed;
-  } catch (error) {
-    console.error('Error during cleanup:', error);
-    stats.errors++;
-  }
-  
-  // Process each file
-  console.log(`\n⚙️  Processing files...`);
   for (const file of mediaFiles) {
-    stats.filesProcessed++;
+    const stats = fs.statSync(file);
-    
-    try {
-      const fileStats = fs.statSync(file);
     const title = path.basename(file);
     const ext = path.extname(file).toLowerCase();
     const cleanExt = ext.replace('.', '').toLowerCase();
@@ -218,20 +73,9 @@ const scanLibrary = async (library: { id: number; path: string }) => {
     // Generate hashed thumbnail path
     const { folderPath, fullPath, url } = ThumbnailManager.getThumbnailPath(file);
     
-      const existingMedia = db.prepare("SELECT id, path, type, thumbnail FROM media WHERE path = ?").get(file) as 
-        { id: number; path: string; type: string; thumbnail: string } | undefined;
-      
-      if (existingMedia) {
-        // NEW: Verify thumbnail for existing media
     try {
-          const thumbResult = await verifyAndRegenerateThumbnail(existingMedia);
+      const existingMedia = db.prepare("SELECT * FROM media WHERE path = ?").get(file);
-          if (thumbResult.regenerated) {
+      if (existingMedia) {
-            stats.thumbnailsRegenerated++;
-          }
-        } catch (error) {
-          console.error(`Error verifying thumbnail for ${file}:`, error);
-          stats.errors++;
-        }
         continue;
       }
 
@@ -280,7 +124,7 @@ const scanLibrary = async (library: { id: number; path: string }) => {
         path: file,
         type: mediaType,
         title: title,
-        size: fileStats.size,
+        size: stats.size,
         thumbnail: finalThumbnailUrl,
         codec_info: codecInfo,
       };
@@ -289,60 +133,21 @@ const scanLibrary = async (library: { id: number; path: string }) => {
         "INSERT INTO media (library_id, path, type, title, size, thumbnail, codec_info) VALUES (?, ?, ?, ?, ?, ?, ?)"
       ).run(media.library_id, media.path, media.type, media.title, media.size, media.thumbnail, media.codec_info);
 
-      stats.filesAdded++;
+      console.log(`Successfully inserted ${mediaType}: ${title}${thumbnailGenerated ? ' with thumbnail' : ' with fallback thumbnail'}`);
-      console.log(`✓ Added ${mediaType}: ${title}${thumbnailGenerated ? ' with thumbnail' : ' with fallback'}`);
     } catch (error: any) {
       if (error.code !== "SQLITE_CONSTRAINT_UNIQUE") {
-        console.error(`Error processing ${file}:`, error);
+        console.error(`Error inserting media: ${file}`, error);
-        stats.errors++;
       }
     }
   }
-  
-  // NEW: Log final statistics
-  console.log(`\n📊 Scan Complete:`);
-  console.log(`   Files Processed: ${stats.filesProcessed}`);
-  console.log(`   Files Added: ${stats.filesAdded}`);
-  console.log(`   Files Removed: ${stats.filesRemoved}`);
-  console.log(`   Thumbnails Regenerated: ${stats.thumbnailsRegenerated}`);
-  if (stats.errors > 0) {
-    console.log(`   Errors: ${stats.errors}`);
-  }
-  
-  return stats;
 };
 
 export const scanAllLibraries = async () => {
   const db = getDatabase();
   const libraries = db.prepare("SELECT * FROM libraries").all() as { id: number; path: string }[];
-  
-  const aggregateStats = {
-    filesProcessed: 0,
-    filesAdded: 0,
-    filesRemoved: 0,
-    thumbnailsRegenerated: 0,
-    errors: 0
-  };
-  
   for (const library of libraries) {
-    const stats = await scanLibrary(library);
+    await scanLibrary(library);
-    aggregateStats.filesProcessed += stats.filesProcessed;
-    aggregateStats.filesAdded += stats.filesAdded;
-    aggregateStats.filesRemoved += stats.filesRemoved;
-    aggregateStats.thumbnailsRegenerated += stats.thumbnailsRegenerated;
-    aggregateStats.errors += stats.errors;
   }
-  
-  console.log(`\n🎉 All Libraries Scan Complete:`);
-  console.log(`   Total Files Processed: ${aggregateStats.filesProcessed}`);
-  console.log(`   Total Files Added: ${aggregateStats.filesAdded}`);
-  console.log(`   Total Files Removed: ${aggregateStats.filesRemoved}`);
-  console.log(`   Total Thumbnails Regenerated: ${aggregateStats.thumbnailsRegenerated}`);
-  if (aggregateStats.errors > 0) {
-    console.log(`   Total Errors: ${aggregateStats.errors}`);
-  }
-  
-  return aggregateStats;
 };
 
 export const scanSelectedLibrary = async (libraryId: number) => {
@@ -351,5 +156,5 @@ export const scanSelectedLibrary = async (libraryId: number) => {
   if (!library) {
     throw new Error(`Library with ID ${libraryId} not found`);
   }
-  return await scanLibrary(library);
+  await scanLibrary(library);
 };

tests/test-scan-enhancement.sh

@@ -1,92 +0,0 @@
-#!/bin/bash
-# Quick Test Script for Library Scan Enhancement
-
-echo "========================================="
-echo "Library Scan Enhancement - Quick Test"
-echo "========================================="
-echo ""
-
-# Colors for output
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-echo -e "${YELLOW}This script will help you test the new scan features${NC}"
-echo ""
-
-# Test 1: Check if scanner.ts has the new functions
-echo "Test 1: Checking for new functions..."
-if grep -q "cleanupDeletedFiles" /root/workspace/nextav/src/lib/scanner.ts; then
-    echo -e "${GREEN}✓${NC} cleanupDeletedFiles function found"
-else
-    echo "✗ cleanupDeletedFiles function NOT found"
-fi
-
-if grep -q "verifyAndRegenerateThumbnail" /root/workspace/nextav/src/lib/scanner.ts; then
-    echo -e "${GREEN}✓${NC} verifyAndRegenerateThumbnail function found"
-else
-    echo "✗ verifyAndRegenerateThumbnail function NOT found"
-fi
-
-if grep -q "filesRemoved" /root/workspace/nextav/src/lib/scanner.ts; then
-    echo -e "${GREEN}✓${NC} Statistics tracking (filesRemoved) found"
-else
-    echo "✗ Statistics tracking NOT found"
-fi
-
-if grep -q "thumbnailsRegenerated" /root/workspace/nextav/src/lib/scanner.ts; then
-    echo -e "${GREEN}✓${NC} Statistics tracking (thumbnailsRegenerated) found"
-else
-    echo "✗ Statistics tracking NOT found"
-fi
-
-echo ""
-
-# Test 2: Check API enhancement
-echo "Test 2: Checking API enhancements..."
-if grep -q "stats" /root/workspace/nextav/src/app/api/scan/route.ts; then
-    echo -e "${GREEN}✓${NC} API returns stats"
-else
-    echo "✗ API stats NOT found"
-fi
-
-echo ""
-
-# Test 3: Check build
-echo "Test 3: Checking build status..."
-if [ -d "/root/workspace/nextav/.next" ]; then
-    echo -e "${GREEN}✓${NC} Build directory exists"
-    BUILD_TIME=$(stat -c %y /root/workspace/nextav/.next/BUILD_ID 2>/dev/null | cut -d' ' -f1,2)
-    if [ -n "$BUILD_TIME" ]; then
-        echo -e "${GREEN}✓${NC} Last build: $BUILD_TIME"
-    fi
-else
-    echo "✗ Build directory NOT found"
-fi
-
-echo ""
-echo "========================================="
-echo "Summary"
-echo "========================================="
-echo ""
-echo "Implementation Status: ✅ COMPLETE"
-echo ""
-echo "Next Steps:"
-echo "1. Start the development server:"
-echo "   npm run dev"
-echo ""
-echo "2. Test file deletion cleanup:"
-echo "   - Add files to a library and scan"
-echo "   - Delete some files from disk"
-echo "   - Re-scan and check console logs"
-echo ""
-echo "3. Test thumbnail recovery:"
-echo "   - Delete thumbnail files from public/thumbnails/"
-echo "   - Re-scan and check console logs"
-echo ""
-echo "4. Monitor the scan output for:"
-echo "   - 📚 Starting scan message"
-echo "   - 🧹 Checking for deleted files"
-echo "   - 📊 Statistics at the end"
-echo ""
-echo "========================================="