Video Converter v0.2.0.0

Fixed

• Session State Deadlock (#116): Resolved deadlock in SessionStateManager by using threading.RLock() instead of threading.Lock(). The nested lock acquisition when create_session() called save() was causing test hangs.

Changed

• Version scheme changed from 1.x.x to 0.x.x.x (project is in active development)
• Coverage Configuration: Exclude __main__.py (CLI entrypoint) and applescript.py (macOS-specific) from coverage measurement. Focus coverage on testable business logic modules.

Added

Core Features

• VMAF Quality Measurement (#26): VmafAnalyzer class for perceptual video quality measurement with VMAF score calculation, VmafScores dataclass (min, mean, max, percentiles), VmafQualityLevel enum (visually lossless >= 93), frame sampling, quick_analyze() for fast estimation, and async support. 46 comprehensive unit tests.
• Concurrent Processing (#31): ConcurrentProcessor for parallel video processing with configurable max concurrent jobs, ResourceMonitor for system resource tracking, AggregatedProgress for combined progress, semaphore-based concurrency limiting, and thread-safe job management. 32 test cases.
• Error Recovery (#32): ErrorRecoveryManager with ErrorCategory and RecoveryAction enums, automatic error classification, disk space monitoring, FailureRecord tracking, manual retry API, and partial output cleanup.
• Retry Logic (#27): RetryManager with four-stage retry (same settings → switch encoder → adjust quality → final attempt), automatic encoder fallback (HW ↔ SW), CRF adjustment, RetryConfig, RetryAttempt tracking, and RetryResult. 35 unit tests.

Photos Integration

• Photos Re-Import (#101): PhotosImporter class for importing converted videos back to Photos library via AppleScript, import_video(), verify_import(), get_video_info() methods, configurable timeout, and comprehensive exception hierarchy (PhotosImportError, PhotosNotRunningError, ImportTimeoutError, DuplicateVideoError, ImportFailedError).
• Metadata Preservation (#103): MetadataPreserver class with VideoMetadataSnapshot, capture_metadata(), embed_metadata_in_file() via ExifTool, apply_photos_metadata() via AppleScript, verify_metadata() with MetadataTolerance presets, and VerificationResult.
• Original Handling (#102): OriginalHandling enum (DELETE, ARCHIVE, KEEP), handle_original() method, CLI options (--reimport, --delete-originals, --keep-originals, --archive-album, --confirm-delete), and AppleScript integration.
• Permission Guidance (#96): --check-permissions flag, rich panel display for permission errors, display_photos_permission_error(), display_photos_permission_success(), display_photos_library_info(), and quick access to System Settings.
• Progress Display (#97): PhotosProgressDisplay with library info panel, two-phase progress tracking (Export/Convert), metadata display, styled summary panel, and _NullPhotosProgress for quiet mode.

Folder Support

• iCloud Drive Support (#88): Automatic iCloud stub file detection (.filename.icloud format) in FolderExtractor, _is_icloud_stub(), _get_original_path_from_stub(), in_cloud and stub_path properties, FolderConfig with iCloud settings, and _ensure_file_available() in Orchestrator. 15 unit tests.
• Folder Extractor: FolderExtractor class for direct video conversion from filesystem folders, recursive scanning with include/exclude patterns, video codec detection, FolderVideoInfo and FolderStats dataclasses. 62 test cases.

Automation

• Service Management (#35): Public load(), unload(), restart() methods in ServiceManager, permission checking, CLI commands (service-start, service-stop, service-load, service-unload, service-restart, service-logs), --follow and --stderr options.
• Status Query (#36): calculate_next_run(), get_last_run_info(), get_detailed_status() methods, LastRunInfo and DetailedServiceStatus dataclasses, enhanced CLI status command with next run time and statistics. 26 tests.

UI/UX

• Rich Progress Display (#38): ui/progress.py module with SingleFileProgressDisplay, BatchProgressDisplay, IndeterminateSpinner, ProgressDisplayManager, custom Rich columns (SizeProgressColumn, SpeedColumn, ETAColumn), and null object pattern for quiet mode. 35 unit tests.
• Statistics Reporter: StatisticsReporter class with StatsPeriod enum, time-based filtering (today, week, month, all), enhanced stats CLI command, stats-export for JSON/CSV, --detailed and --period options.
• macOS Notifications: NotificationManager class with automatic batch completion notifications, success/partial/failure types, summary statistics, NotificationConfig, and Orchestrator integration.

Quality & Validation

• Metadata Verification (#22): MetadataVerifier class for comprehensive metadata comparison, ToleranceSettings (date: 1s, GPS: 0.000001°, duration: 0.1s), CheckResult and VerificationResult dataclasses, category-based verification, and tolerance profiles. 43 test cases.
• Timestamp Sync (#21): TimestampSynchronizer for copying timestamps, FileTimestamps dataclass, birth time support on macOS via SetFile, TimestampVerificationResult, preserve_timestamps config option. 23 test cases.
• Conversion History (#18): ConversionHistory class for duplicate prevention, ConversionRecord dataclass, HistoryStatistics, UUID and file hash identification, JSON persistence, export functionality. 41 test cases.

Other

• iCloud Download (#16): iCloudHandler for detecting and downloading iCloud videos, CloudStatus enum, stub file analysis, brctl download triggering, DownloadProgress tracking, icloud_timeout and skip_cloud_only options.
• Real-time Progress (#11): ProgressInfo dataclass with ETA calculation, ProgressParser for FFmpeg output, ProgressMonitor with throttling, create_simple_callback helper.
• 10-bit HDR Encoding: bit_depth option for 8/10-bit, hdr option for HDR10 (BT.2020 PQ), libx265 10-bit support with yuv420p10le.

Test Infrastructure

• Integration Tests (#115): test_vmaf_integration.py (29 tests), test_concurrent_integration.py (24 tests), test_error_recovery_integration.py (34 tests), test_icloud_folder_integration.py (31 tests), test_statistics_integration.py (47 tests), test_notification_integration.py (49 tests).
• Test Coverage (#116): Verified 81.62% unit test coverage, exceeding 80% target. Added mock_osxphotos fixture, updated test_config_version, refactored test_photos_extractor.py.
• Photos CLI Tests (#98): test_photos_handler.py, test_photos_permissions.py, test_photos_progress.py, test_photos_cli.py.
• Photos Re-Import Tests (#104): test_photos_metadata_preservation.py, test_photos_original_handling.py, test_photos_reimport.py.