Refactor Plex Database Repair Logic

- Created a centralized database repair script (`plex-database-repair.sh`) to handle all database integrity checks and repairs for Plex Media Server.
- Updated the main Plex management script (`plex.sh`) to integrate the new repair functionality and fixed Unicode/ASCII display issues.
- Refactored the backup script (`backup-plex.sh`) to remove duplicate repair functions and ensure it utilizes the new repair script.
- Conducted thorough code validation and functional testing to ensure all scripts operate correctly with the new changes.
- Enhanced documentation for the new repair script, detailing usage, features, and integration points with other scripts.
- Fixed critical bugs related to WAL file handling and corrected typos in script options.

docs/plex-database-repair-refactoring-completion.md

@@ -0,0 +1,116 @@
+# Plex Database Repair Refactoring - Completion Summary
+
+## Task Description
+Refactor Plex Media Server management scripts to centralize database repair logic in a shared script (`plex-database-repair.sh`), remove duplicate/legacy repair logic from other scripts, and fix Unicode/ASCII display issues.
+
+## Completed Work
+
+### ✅ 1. Created Shared Database Repair Script
+- **File**: `/home/acedanger/shell/plex/plex-database-repair.sh`
+- **Features**:
+  - Centralized database integrity checking and repair logic
+  - Multiple repair strategies (dump/restore, schema recreation, backup recovery)
+  - Proper WAL file handling for repair operations
+  - File ownership correction after repairs
+  - Command-line interface with check/repair/force-repair modes
+  - Comprehensive logging and error handling
+
+### ✅ 2. Updated Main Plex Management Script
+- **File**: `/home/acedanger/shell/plex/plex.sh`
+- **Changes**:
+  - Added `repair_plex()` function that uses the shared repair script
+  - Added user-facing `repair` command
+  - Fixed Unicode/ASCII display issues in output
+  - Integrated shared repair script for all database operations
+  - Maintained backward compatibility with existing functionality
+
+### ✅ 3. Refactored Backup Script
+- **File**: `/home/acedanger/shell/plex/backup-plex.sh`
+- **Major Changes**:
+  - **Removed duplicate repair functions**:
+    - `attempt_dump_restore()`
+    - `attempt_schema_recreation()`
+    - `attempt_backup_recovery()`
+    - `recover_table_data()`
+    - `cleanup_repair_files()`
+    - `handle_wal_files_for_repair()`
+    - `check_database_integrity_with_wal()`
+  - **Updated integrity and repair functions**:
+    - `check_database_integrity()` now calls shared repair script
+    - `repair_database()` now calls shared repair script
+  - **Fixed critical issue**: Restored missing `handle_wal_files()` function for backup operations
+  - **Fixed typo**: Corrected `AUTO_REPAIR=false.service` to `AUTO_REPAIR=false`
+
+### ✅ 4. Code Validation and Testing
+- **Syntax validation**: All scripts pass `bash -n` syntax checks
+- **Functional testing**: 
+  - Help systems work correctly
+  - Database repair command integration successful
+  - Backup script operations functioning properly
+  - WAL file handling restored and working
+- **Error checking**: No remaining references to removed functions
+
+### ✅ 5. Documentation
+- **File**: `/home/acedanger/shell/docs/plex-database-repair.md`
+- **Content**: Complete documentation of the shared repair script usage and features
+
+## Key Benefits Achieved
+
+### 1. **Code Deduplication**
+- Eliminated duplicate repair logic across multiple scripts
+- Centralized repair strategies in single, well-tested script
+- Reduced maintenance burden and potential for inconsistencies
+
+### 2. **Improved Maintainability**
+- All repair logic in one place for easier updates
+- Consistent repair behavior across all scripts
+- Single source of truth for database repair procedures
+
+### 3. **Enhanced User Experience**
+- Fixed Unicode/ASCII display issues
+- Consistent repair interface across scripts
+- Clear command-line interface for repair operations
+
+### 4. **Better Error Handling**
+- Centralized error handling and logging
+- Consistent return codes across scripts
+- Proper file ownership correction after repairs
+
+### 5. **Preserved Functionality**
+- All existing backup and management functionality maintained
+- Backward compatibility preserved
+- No breaking changes to existing workflows
+
+## Files Modified
+
+1. **Created**: `/home/acedanger/shell/plex/plex-database-repair.sh`
+2. **Updated**: `/home/acedanger/shell/plex/plex.sh`
+3. **Updated**: `/home/acedanger/shell/plex/backup-plex.sh`
+4. **Created**: `/home/acedanger/shell/docs/plex-database-repair.md`
+
+## Critical Bug Fixes
+
+1. **Restored missing `handle_wal_files()` function** - Critical for backup WAL operations
+2. **Fixed typo in `--disable-auto-repair` option** - Was setting incorrect value
+3. **Fixed Unicode display issues** - Proper ASCII character usage in plex.sh
+4. **Corrected function references** - All calls now use shared repair script
+
+## Verification Status
+
+- ✅ All scripts pass syntax validation
+- ✅ Help systems functioning correctly  
+- ✅ Database repair integration working
+- ✅ Backup script operations successful
+- ✅ WAL file handling restored
+- ✅ No orphaned function references
+- ✅ All error handling preserved
+
+## Final State
+
+The refactoring is complete and fully functional. All Plex management scripts now use the centralized database repair system while maintaining their individual responsibilities:
+
+- **plex.sh**: Service management and user interface
+- **backup-plex.sh**: Backup operations with integrity checking
+- **plex-database-repair.sh**: Specialized database repair operations
+
+The system is ready for production use with improved maintainability and reduced code duplication.