powershell-modules/
├── Modules/
│   ├── Shared/
│   │   └── Public/
│   │       ├── Get-Path.ps1          # Shared path validation function
│   │       ├── Write-Message.ps1     # Shared logging function
│   │       └── Shared.ps1            # Shared module loader
│   │       └── Shared.psm1           # Shared module manifest
│   ├── Media/
│   │   ├── Classes/
│   │   │   └── MediaFile.ps1         # MediaFile class
│   │   ├── Private/
│   │   │   ├── Convert-VideoFile.ps1 # Private conversion functions
│   │   │   ├── Convert-AudioFile.ps1
│   │   │   ├── Convert-ImageFile.ps1
│   │   │   ├── Optimize-VideoFile.ps1
│   │   │   ├── Optimize-AudioFile.ps1
│   │   │   ├── Optimize-ImageFile.ps1
│   │   │   ├── Get-AllMetadata.ps1
│   │   │   ├── Get-BasicMetadata.ps1
│   │   │   ├── Get-TechnicalMetadata.ps1
│   │   │   └── Get-TagMetadata.ps1
│   │   ├── Public/
│   │   │   ├── Get-MediaInfo.ps1     # Public exported functions
│   │   │   ├── Convert-Media.ps1
│   │   │   ├── Optimize-Media.ps1
│   │   │   └── Get-MediaMetadata.ps1
│   │   ├── Media.psd1                # Module manifest
│   │   └── Media.psm1                # Module root script
│   ├── Plex/                         # Plex module (to be implemented)
│   ├── Rip/                          # Rip module (to be implemented)
│   └── Git/                          # Git module (to be implemented)
├── Tests/
│   ├── Unit/
│   │   └── Media/
│   │       └── Get-MediaInfo.Tests.ps1
│   ├── Integration/
│   └── Performance/
├── .vscode/
│   └── settings.json                 # VS Code configuration
├── PowerShellProfile.ps1             # Development profile
├── PSScriptAnalyzerSettings.psd1     # Code analysis configuration
├── PesterConfiguration.psd1          # Test configuration
├── build.ps1                         # Build script
└── README.md

# Install from PowerShell Gallery (when published)
Install-Module -Name Media -Force
Install-Module -Name Plex -Force
Install-Module -Name Rip -Force
Install-Module -Name Git -Force

# Get information about media files
Get-MediaInfo -Path "C:\Videos" -Recurse

# Convert media files
Convert-Media -InputPath "video.avi" -Format "mp4" -Quality High

# Optimize media files
Optimize-Media -Path "C:\Images" -Strategy Size -Backup

# Extract metadata
Get-MediaMetadata -Path "C:\Music" -Recurse -MetadataType Technical

# Validate and normalize paths
$ValidPath = Get-Path -Path "C:\temp\file.txt" -PathType File -MustExist

# Write formatted messages
Write-Message -Message "Operation completed" -Level Success
Write-Message -Message "Warning message" -Level Warning -LogToFile

# Build all modules
.\build.ps1 -Task Build

# Run code analysis
.\build.ps1 -Task Analyze

# Run tests
.\build.ps1 -Task Test

# Clean build output
.\build.ps1 -Task Clean

# Build, analyze, test, and package
.\build.ps1 -Task All

# Run PSScriptAnalyzer manually
Invoke-ScriptAnalyzer -Path .\Modules -Settings .\PSScriptAnalyzerSettings.psd1

# Run as part of build process
.\build.ps1 -Task Analyze

# Run all tests
Invoke-Pester -Path Tests

# Run specific test file
Invoke-Pester -Path Tests\Unit\Media\Get-MediaInfo.Tests.ps1

# Run tests with coverage
Invoke-Pester -Path Tests -CodeCoverage Modules\Media\*.ps1

# Run tests with Pester configuration
Invoke-Pester -Configuration .\PesterConfiguration.psd1