Implement IAudioHardwareProvider interface consolidation

[danieljsinclair]

Issue Type

Implementation - Architecture Refactoring

Severity

High - Critical path for Option B implementation

Problem Statement

Current architecture has platform-specific code scattered across AudioPlayer and lacks proper hardware abstraction. Need consolidated IAudioHardwareProvider interface.

Current State

• Audio hardware lifecycle mixed in AudioPlayer (8 responsibilities)
• Platform code scattered (CoreAudioPlatform exists but not integrated)
• IAudioPlatform interface exists but unused
• Cannot swap hardware implementations
• Tight coupling to macOS CoreAudio

Target State

Single IAudioHardwareProvider interface for all hardware operations:

• initialize() - hardware initialization
• configure() - format and buffer setup
• start() / stop() - playback control
• setVolume() - volume control
• cleanup() - resource cleanup
• registerCallback() - audio callback registration

Implementation Tasks

1. Design IAudioHardwareProvider interface
2. Create IAudioHardwareProvider.h with proper documentation
3. Define platform-specific implementations (CoreAudioHardwareProvider)
4. Abstract platform-specific types

Acceptance Criteria

• IAudioHardwareProvider.h interface created with clear method documentation
• Interface abstracts all hardware operations (no platform-specific types)
• Platform implementations isolated in src/audio/platform/
• No macOS CoreAudio types in interface
• Clear injection points for DI
• Interface location: src/audio/IAudioHardwareProvider.h

Testing Requirements

• Interface can be mocked for unit tests
• Platform implementations can be swapped
• No circular dependencies with AudioPlayer
• Mock hardware provider works for testing

Related Issues

• DECISION NEEDED: Choose architecture direction - Pull model vs NEW architecture #12 - Architecture decision: Option B confirmed
• Implement IAudioStrategy interface consolidation #22 - IAudioStrategy interface consolidation
• Next ticket: Implement CoreAudioHardwareProvider

References

• ARCHITECTURE_FILE_CLASS_AUDIT.md - Platform coupling violations
• AUDIO_MODULE_ARCHITECTURE.md - Cross-platform requirements
• PLATFORM_AUDIO_RESEARCH.md - iOS/ESP32 requirements