<#PSScriptInfo
.VERSION 2026.08.0017
.GUID c5044de3-67b5-4e70-b6fc-75e7847c799e
.NAME universal-intel-chipset-device-updater
.AUTHOR Marcin Grygiel
.COMPANYNAME FirstEver.tech
.COPYRIGHT (c) 2026 Marcin Grygiel / FirstEver.tech. All rights reserved.
.TAGS Universal Intel Chipset Device Software Updater INF Windows Automation MDM
.LICENSEURI https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/blob/main/LICENSE
.PROJECTURI https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater
.ICONURI
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
v2026.08.0017 - Replaced FriendlyName keyword-based device pre-filtering in Get-IntelChipsetHWIDs with direct HWID matching against the full INF database. Fixes silent detection gaps for devices whose FriendlyName did not contain a recognized keyword (e.g. Gaussian Mixture Model, Host Bridge/DRAM Registers, PCIe Controller (x16), Thermal, Northpeak, LPSS, DmaSec Extension variants). No change to UI or output format.
v2026.05.0014 - Improved display formatting: removed "Generation:" label, added parsing info hint, cleaned up extra blank lines.
#>

<#
.SYNOPSIS
    Detects and installs the latest Intel Chipset Device Software INF files.

.DESCRIPTION
    Automatically detects, downloads, and installs the latest Intel Chipset Device
    Software INF files for your specific hardware. Compares installed INF versions
    against a complete historical database of every Intel Chipset Device Software
    package ever released, then downloads and installs the correct latest version.

    Security: full SHA-256 hash verification and Intel digital signature validation
    before execution. Automatic System Restore Point created before any changes.

    Requires Administrator privileges (auto-elevates if needed) and internet access
    to GitHub and Intel servers. Downloads are verified before execution - no
    unverified code is ever run.

    Supports silent unattended deployment via -quiet flag for MDM solutions:
    Microsoft Intune, SCCM, VMware Workspace ONE, PDQ Deploy.

    Usage: .\universal-intel-chipset-device-updater.ps1 [options]

Options:
  -help, -?          Display this help and exit.
  -version, -v       Display the tool version and exit.
  -auto, -a          All prompts are answered with Yes, no user interaction required.
  -quiet, -q         Run in completely silent mode (no console window).
                       Implies -auto and hides the PowerShell window.
  -beta              Use beta database for new hardware testing.
  -debug, -d         Enable debug output.
  -skipverify, -s    Skip script self-hash verification. Use only for testing.

    Logging: All actions are logged to %ProgramData%\chipset_update.log.

.PARAMETER version
    Display the tool version and exit.

.PARAMETER auto
    Run in automatic mode - all prompts are answered with Yes.
    No user interaction is required. Suitable for scripted deployments.

.PARAMETER quiet
    Run in completely silent mode with no console window.
    Implies -auto and relaunches the script with -WindowStyle Hidden.
    Suitable for MDM solutions: Microsoft Intune, SCCM, VMware Workspace ONE, PDQ Deploy.

.PARAMETER beta
    Use the beta database (intel-chipset-infs-beta.md) instead of the stable release.
    Intended for testing support for new Intel hardware platforms before official release.

.PARAMETER debug
    Enable debug output. Prints detailed diagnostic messages to the console
    during execution. All debug messages are also written to the log file
    regardless of whether this flag is set.

.PARAMETER skipverify
    Skip the script self-hash verification.
    By default, the script verifies its own integrity against a SHA-256 file
    published on GitHub before proceeding. Use this flag for local testing only.

.EXAMPLE
    .\universal-intel-chipset-device-updater.ps1
    Runs the updater interactively. The user is prompted at each step.

.EXAMPLE
    .\universal-intel-chipset-device-updater.ps1 -auto
    Runs the updater without any user prompts. All confirmations are answered Yes automatically.

.EXAMPLE
    .\universal-intel-chipset-device-updater.ps1 -quiet
    Runs completely silently with no console window. Suitable for background deployment via MDM.

.EXAMPLE
    .\universal-intel-chipset-device-updater.ps1 -auto -debug
    Runs without user prompts and prints detailed diagnostic output to the console.

.EXAMPLE
    .\universal-intel-chipset-device-updater.ps1 -auto -skipverify
    Runs without user prompts and skips self-hash verification. Use for local testing only.

.NOTES
    Author:  Marcin Grygiel / FirstEver.tech
    License: MIT

    All actions are logged to %ProgramData%\chipset_update.log.

    This tool is not affiliated with Intel Corporation.
    INF files are sourced from official Intel servers.
    Use at your own risk.

.LINK
    https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater
#>

# =============================================
# COMMAND-LINE PARAMETERS - MANUAL PARSING
# =============================================
# To disable partial matching, we do not use param() block.
# Instead we parse $args manually.
$rawArgs = $args
$Help = $false
$Version = $false
$AutoMode = $false
$Debug = $false
$SkipVerification = $false
$QuietMode = $false
$Beta = $false
$Developer = $false

# Allowed switches (full names and aliases)
$allowedSwitches = @(
    '-help',
    '-?',
    '-version', '-v',
    '-auto', '-a',
    '-beta',
    '-developer',
    '-debug', '-d',
    '-skipverify', '-s',
    '-quiet', '-q'
)

# Parse arguments
for ($i = 0; $i -lt $rawArgs.Count; $i++) {
    $arg = $rawArgs[$i]
    if ($arg -match '^-') {
        if ($allowedSwitches -notcontains $arg) {
            Clear-Host
            Write-Host ""
            Write-Host " Unknown parameter: $arg"
            Write-Host " Use -help or -? to see available options."
            Write-Host ""
            exit 1
        }
        switch -Regex ($arg) {
            '^-help$'                { $Help = $true }
            '^-version$|^-v$'        { $Version = $true }
            '^-auto$|^-a$'           { $AutoMode = $true }
            '^-beta$'                { $Beta = $true }
            '^-developer$'           { $Developer = $true }
            '^-debug$|^-d$'          { $Debug = $true }
            '^-skipverify$|^-s$'     { $SkipVerification = $true }
            '^-quiet$|^-q$'          { $QuietMode = $true }
        }
    } else {
        # Positional arguments are not supported
        Clear-Host
        Write-Host ""
        Write-Host " Positional arguments are not allowed."
        Write-Host " Use -help or -? to see available options."
        Write-Host ""
        exit 1
    }
}

# If quiet mode is requested, relaunch with -auto and hidden window
if ($QuietMode) {
    # Rebuild argument list without -quiet/-q, add -auto if not already present
    $newArgs = @()
    $hasAuto = $false
    foreach ($arg in $rawArgs) {
        if ($arg -match '^-quiet$|^-q$') {
            # skip
        } else {
            $newArgs += $arg
            if ($arg -match '^-auto$|^-a$') {
                $hasAuto = $true
            }
        }
    }
    if (-not $hasAuto) {
        $newArgs += '-auto'
    }
    $scriptPath = $MyInvocation.MyCommand.Path
    $argString = ($newArgs -join ' ')
    Start-Process -FilePath "powershell.exe" -ArgumentList "-WindowStyle Hidden -File `"$scriptPath`" $argString"
    exit 0
}

# Set flags based on parsed arguments
[bool]$DebugMode = $Debug          # $true = enabled, $false = disabled (default)
[bool]$SkipSelfHashVerification = $SkipVerification  # $true = skip, $false = verify (default)

# =============================================
# SCRIPT VERSION
# =============================================
$ScriptVersion = "2026.08.0017"
# =============================================

# Detect if running from SFX package
$isSFX = $MyInvocation.ScriptName -like "$env:SystemRoot\Temp\universal-intel-chipset-device-updater*"

if ($ScriptVersion -match '^(\d+\.\d+)-(\d{4}\.\d{2}\.\d+)$') {
    $DisplayVersion = "$($matches[1]) ($($matches[2]))"
} else {
    $DisplayVersion = $ScriptVersion
}

# If help requested, show and exit
if ($Help) {
    Get-Help $MyInvocation.MyCommand.Path
    exit 0
}

# If version requested, show and exit
if ($Version) {
    Clear-Host
    Write-Host ""
    Write-Host " Universal Intel Chipset Device Updater version $DisplayVersion"
    Write-Host ""
    exit 0
}

# =============================================
# AUTO-ELEVATE IF NOT ADMIN (with argument passing)
# =============================================
$currentPrincipal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
$isAdmin = $currentPrincipal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

if (-not $isAdmin) {
    Clear-Host
    Write-Host ""
    Write-Host " Administrator privileges required. Restarting with elevation..." -ForegroundColor Yellow
    Write-Host ""
    $scriptPath = $MyInvocation.MyCommand.Path

    # Rebuild argument string from the original arguments
    $argList = ""
    if ($rawArgs.Count -gt 0) {
        $argList = ($rawArgs -join " ")
    }

    try {
        Start-Process -FilePath "powershell.exe" -ArgumentList "-NoExit -File `"$scriptPath`" $argList" -Verb RunAs
    } catch {
        Clear-Host
        Write-Host ""
        Write-Host " Elevation failed. Please run the script as Administrator manually." -ForegroundColor Red
        Write-Host ""
        pause
        exit 1
    }
    exit 0
}

# =============================================
# ELEVATED CONTEXT
# =============================================
Write-Host "Running with administrator privileges. Applying console settings..." -ForegroundColor Green

$Host.UI.RawUI.BackgroundColor = "Black"

try {
    [console]::WindowWidth = 75
    [console]::WindowHeight = 58
    [console]::BufferWidth = [console]::WindowWidth
} catch {
    Write-Host "Failed to set console size: $_" -ForegroundColor Red
}

# =============================================
# CONFIGURATION
# =============================================
# $DebugMode and $SkipSelfHashVerification already set above
# =============================================

# GitHub repository URLs
$githubBaseUrl = "https://raw.githubusercontent.com/FirstEverTech/Universal-Intel-Chipset-Updater/main/data/"
$githubArchiveUrl = "https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/releases/download/archive/"
$chipsetINFsUrl = $githubBaseUrl + "intel-chipset-infs-latest.md"
if ($Developer) {
    $chipsetINFsUrl = $githubBaseUrl + "intel-chipset-infs-dev.md"
    Write-Host ""
    Write-Host " [DEVELOPER MODE] Using development database: intel-chipset-infs-dev.md" -ForegroundColor Magenta
    Write-Host " This database is intended for internal testing only." -ForegroundColor Magenta
    Write-Host ""
} elseif ($Beta) {
    $chipsetINFsUrl = $githubBaseUrl + "intel-chipset-infs-beta.md"
    Write-Host ""
    Write-Host " [BETA MODE] Using beta database: intel-chipset-infs-beta.md" -ForegroundColor Yellow
    Write-Host " This database may contain support for new hardware not yet in stable release." -ForegroundColor Yellow
    Write-Host ""
}
$downloadListUrl = $githubBaseUrl + "intel-chipset-infs-download.txt"
$supportMessageUrl = $githubBaseUrl + "intel-chipset-infs-message.txt"
$creditsMessageUrl = $githubBaseUrl + "intel-chipset-infs-credits.txt"
$adsUrl            = $githubBaseUrl + "intel-chipset-infs-ads.txt"

# Temporary directory for downloads
$tempDir = Join-Path $env:SystemRoot "Temp\IntelChipset"

# =============================================
# ENHANCED ERROR HANDLING
# =============================================

$global:InstallationErrors = @()
$global:ScriptStartTime = Get-Date
$global:NewVersionLaunched = $false
$global:NewerWindowsInboxVersion = $false
$logFile = Join-Path $env:ProgramData "chipset_update.log"

# =============================================
# VERSION MANAGEMENT FUNCTIONS
# =============================================

function Get-VersionNumber {
    param([string]$Version)

    $oldVersionTable = @{
        "10.1-2025.11.0" = "2025.11.0001"
        "10.1-2025.11.5" = "2025.11.0002"
        "10.1-2025.11.6" = "2025.11.0003"
        "10.1-2025.11.7" = "2025.11.0004"
        "10.1-2025.11.8" = "2025.11.0005"
        "10.1-2026.02.1" = "2026.02.0006"
        "10.1-2026.02.2" = "2026.02.0007"
    }

    if ($oldVersionTable.ContainsKey($Version)) {
        $Version = $oldVersionTable[$Version]
    }

    if ($Version -match '^10\.1-(\d{4}\.\d{2}\.\d+)$') {
        $Version = $matches[1]
    }

    if ($Version -match '^(\d{4})\.(\d{2})\.(\d+)$') {
        return [int]$matches[3]
    }

    throw "Cannot parse version: $Version"
}

function Compare-Versions {
    param([string]$Version1, [string]$Version2)

    $ver1Num = Get-VersionNumber -Version $Version1
    $ver2Num = Get-VersionNumber -Version $Version2

    if ($ver1Num -eq $ver2Num) { return 0 }
    if ($ver1Num -lt $ver2Num) { return -1 }
    return 1
}

function Get-VersionForFileName {
    param([string]$Version)

    if ($Version -match '^10\.1-(\d{4}\.\d{2}\.\d+)$') {
        return $matches[1]
    }

    return $Version
}

function Get-VersionForGitHubTag {
    param([string]$Version)

    # TODO: Both branches return $Version unchanged — if tag format ever
    # differs from the version string (e.g. needs a "v" prefix or other
    # transformation), implement the conversion logic here.
    if ($Version -match '^10\.1-') {
        return $Version
    }

    return $Version
}

# =============================================
# LOGGING FUNCTIONS
# =============================================

function Write-Log {
    param([string]$Message, [string]$Type = "INFO")
    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $logEntry = "[$timestamp] [$Type] $Message"
    try {
        Add-Content -Path $logFile -Value $logEntry -ErrorAction SilentlyContinue
    } catch {
        # Silent fallback
    }

    if ($Type -eq "ERROR") {
        $global:InstallationErrors += $Message
        Write-Host " ERROR: $Message" -ForegroundColor Red
    }
}

function Write-DebugMessage {
    param([string]$Message, [string]$Color = "Gray")
    Write-Log -Message $Message -Type "DEBUG"
    if ($DebugMode) {
        Write-Host " DEBUG: $Message" -ForegroundColor $Color
    }
}

function Show-FinalSummary {
    $duration = (Get-Date) - $global:ScriptStartTime
    if ($global:InstallationErrors.Count -gt 0) {
        Write-Host "`n Completed with $($global:InstallationErrors.Count) error(s)." -ForegroundColor Red
        Write-Host " See $logFile for details." -ForegroundColor Red
    } else {
        Write-Host "`n Operation completed successfully." -ForegroundColor Green
    }
    Write-Log "Script execution completed in $([math]::Round($duration.TotalMinutes, 2)) minutes with $($global:InstallationErrors.Count) errors"
}

# =============================================
# COLOR LINE PARSING FUNCTION
# =============================================
function Write-ColorLine {
    param([string]$Line)

    # Get all valid console color names
    $validColors = [Enum]::GetNames([ConsoleColor])

    # Start with the console's current colors
    $currentFg = $Host.UI.RawUI.ForegroundColor
    $currentBg = $Host.UI.RawUI.BackgroundColor

    $segments = @()
    $position = 0
    $length = $Line.Length

    while ($position -lt $length) {
        # Find next opening bracket '['
        $openBracket = $Line.IndexOf('[', $position)
        if ($openBracket -eq -1) {
            # No more brackets – take the rest of the line as plain text
            $text = $Line.Substring($position)
            if ($text) {
                $segments += [PSCustomObject]@{
                    Text       = $text
                    Foreground = $currentFg
                    Background = $currentBg
                }
            }
            break
        }

        # If there is text before the bracket, add it as a segment
        if ($openBracket -gt $position) {
            $text = $Line.Substring($position, $openBracket - $position)
            $segments += [PSCustomObject]@{
                Text       = $text
                Foreground = $currentFg
                Background = $currentBg
            }
        }

        # Find the closing bracket
        $closeBracket = $Line.IndexOf(']', $openBracket)
        if ($closeBracket -eq -1) {
            # No closing bracket – treat everything from '[' as literal text
            $text = $Line.Substring($openBracket)
            $segments += [PSCustomObject]@{
                Text       = $text
                Foreground = $currentFg
                Background = $currentBg
            }
            break
        }

        # Extract the tag content (what's inside the brackets)
        $tagContent = $Line.Substring($openBracket + 1, $closeBracket - $openBracket - 1)

        # Check if the tag contains a comma – meaning a pair "Foreground,Background"
        if ($tagContent -match ',') {
            $colors = $tagContent -split ',' | ForEach-Object { $_.Trim() }
            if ($colors.Count -eq 2 -and ($validColors -contains $colors[0]) -and ($validColors -contains $colors[1])) {
                $currentFg = [ConsoleColor]$colors[0]
                $currentBg = [ConsoleColor]$colors[1]
                $position = $closeBracket + 1
                continue
            }
        }

        # If it's a single color name (foreground only)
        if ($validColors -contains $tagContent) {
            $currentFg = [ConsoleColor]$tagContent
            $position = $closeBracket + 1
            continue
        }

        # If it's not a recognized color, treat the brackets as literal text
        $text = $Line.Substring($openBracket, $closeBracket - $openBracket + 1)
        $segments += [PSCustomObject]@{
            Text       = $text
            Foreground = $currentFg
            Background = $currentBg
        }
        $position = $closeBracket + 1
    }

    # Output all segments on the same line
    foreach ($seg in $segments) {
        Write-Host $seg.Text -NoNewline -ForegroundColor $seg.Foreground -BackgroundColor $seg.Background
    }
    Write-Host ""
}

# =============================================
# PARSE KEY AND URL FROM CREDIT LINE
# =============================================
function Get-KeyAndUrlFromLine {
    param([string]$Line)

    # List of all valid color names (must match those used in Write-ColorLine)
    $validColors = [Enum]::GetNames([ConsoleColor])
    # Build a regex that matches any single color or a pair separated by comma
    $colorPattern = '\[(?:' + (($validColors | ForEach-Object { [regex]::Escape($_) }) -join '|') + ')(?:,(?:' + (($validColors | ForEach-Object { [regex]::Escape($_) }) -join '|') + '))?\]'

    # Remove only color tags from the line
    $cleanLine = $Line -replace $colorPattern, ''

    # Look for pattern "press [X]" (case-insensitive) to get the key
    if ($cleanLine -match 'press \[([A-Za-z0-9])\]') {
        $key = $matches[1]

        # Find a URL pattern in the line (domain with at least one dot, optionally with path)
        if ($cleanLine -match '(https?://)?([a-zA-Z0-9.-]+\.[a-zA-Z]{2,}(?:/[^\s]*)?)') {
            $urlCandidate = $matches[0]
            # If no protocol, add https://
            if ($urlCandidate -notmatch '^https?://') {
                $urlCandidate = "https://$urlCandidate"
            }
            return @{ Key = $key; Url = $urlCandidate }
        }
    }
    return $null
}

# =============================================
# HEADER DISPLAY FUNCTION
# =============================================
function Show-Header {
    Clear-Host
    Write-Host "/*************************************************************************" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "                UNIVERSAL INTEL CHIPSET DEVICE UPDATER                 " -NoNewline -ForegroundColor White -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "** --------------------------------------------------------------------- **" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue

    $paddedVersion = $DisplayVersion.PadRight(14)
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "                       Tool Version: $paddedVersion                    " -NoNewline -ForegroundColor Yellow -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue

    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue
    $authorText =  "           Author: Marcin Grygiel / GitHub.com/FirstEverTech           "
    $padding = [math]::Floor((69 - $authorText.Length) / 2)
    $spaces = " " * [math]::Max(0, $padding)
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "$spaces$authorText$spaces" -NoNewline -ForegroundColor Green -BackgroundColor DarkBlue
    # Adjust length – if the text does not reach the end, padding with spaces to 69 characters (internal width)
    $totalLength = $spaces.Length + $authorText.Length + $spaces.Length
    if ($totalLength -lt 69) {
        Write-Host (" " * (69 - $totalLength)) -NoNewline -ForegroundColor Green -BackgroundColor DarkBlue
    }
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue

    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "           This tool is not affiliated with Intel Corporation.         " -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "           INF files are sourced from official Intel servers.          " -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "           Use at your own risk.                                       " -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "*************************************************************************/" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host ""
}

# =============================================
# SCREEN MANAGEMENT FUNCTIONS
# =============================================

function Show-Screen1 {
    Show-Header
    Write-Host " [SCREEN 1/4] INITIALIZATION AND SECURITY CHECKS" -ForegroundColor Cyan
    Write-Host " ===============================================" -ForegroundColor Cyan

    if ($DebugMode) {
        Write-Host " DEBUG MODE: ENABLED" -ForegroundColor Magenta
    }
    if ($SkipSelfHashVerification) {
        Write-Host "`n SELF-HASH VERIFICATION: DISABLED (Testing Mode)" -ForegroundColor Yellow
    }

    Write-Host ""

    Write-Host " Checking Windows system requirements..." -ForegroundColor Yellow
    try {
        $os = Get-CimInstance -ClassName Win32_OperatingSystem -ErrorAction Stop
        $build = [int]$os.BuildNumber

        if ($build -lt 17763) {
            Write-Host " [WARNING] Windows 10 LTSB 2015/2016 detected." -ForegroundColor Red
            Write-Host " TLS 1.2 may not work properly." -ForegroundColor Gray
            Write-Host " Some features may be limited." -ForegroundColor Gray
        } else {
            Write-Host " Windows Build: $build" -ForegroundColor Gray
            Write-Host " Operating system compatibility: PASSED" -ForegroundColor Green
        }
    } catch {
        Write-Host " [INFO] Could not determine Windows build." -ForegroundColor Gray
    }
    Write-Host ""

    Write-Host " Checking .NET Framework prerequisites..." -ForegroundColor Yellow
    try {
        $netRelease = Get-ItemPropertyValue -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -Name "Release" -ErrorAction Stop
        if ($netRelease -ge 461808) {
            Write-Host " .NET Framework 4.7.2 or newer detected: PASSED" -ForegroundColor Green
        } else {
            Write-Host " [WARNING] .NET Framework older than 4.7.2" -ForegroundColor Red
        }
    } catch {
        Write-Host " [WARNING] .NET Framework 4.7.2+ not found or couldn't be checked" -ForegroundColor Red
        Write-Host " This may affect GitHub connectivity." -ForegroundColor Gray
    }
    Write-Host ""

    Write-Host " Testing GitHub connectivity..." -ForegroundColor Yellow
    try {
        [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
        $null = Invoke-WebRequest -Uri "https://raw.githubusercontent.com" -UseBasicParsing -TimeoutSec 5 -ErrorAction Stop
        Write-Host " Repository access verification: PASSED" -ForegroundColor Green
    } catch {
        Write-Host " [WARNING] Cannot reach GitHub servers" -ForegroundColor Red
        Write-Host " Self-hash verification will be skipped." -ForegroundColor Gray
        Write-Host " You can still use offline INF detection." -ForegroundColor Gray
    }
    Write-Host ""

    Write-Host " Pre-check summary..." -ForegroundColor Yellow
    $continue = $true

    if ($build -lt 17763 -or !$netRelease -or $netRelease -lt 461808) {
        Write-Host " [IMPORTANT] Some issues were detected." -ForegroundColor Yellow
        Write-Host ""
        Write-Host " If you experience problems:" -ForegroundColor Gray
        Write-Host " 1. For LTSB/LTSC users: Install .NET Framework 4.8" -ForegroundColor Gray
        Write-Host " 2. For GitHub issues: Check firewall/proxy settings" -ForegroundColor Gray
        Write-Host ""

        if ($AutoMode) {
            $choice = "Y"
            Write-Host " Auto mode: automatically continuing (Y)." -ForegroundColor Cyan
        } else {
            do {
                $choice = Read-Host " Continue despite warnings? (Y/N)"
                $choice = $choice.Trim().ToUpper()

                if ($choice -ne 'Y' -and $choice -ne 'N') {
                    Write-Host " Invalid input. Please enter Y or N." -ForegroundColor Red
                }
            } while ($choice -ne 'Y' -and $choice -ne 'N')
        }

        if ($choice -eq 'N') {
            Write-Host " Operation cancelled." -ForegroundColor Red
            if (-not $AutoMode) {
                Write-Host " Press any key to exit..."
                $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
            }
            exit 0
        }

        Write-Host " Continuing with limited functionality..." -ForegroundColor Yellow
        Write-Host ""
    } else {
        Write-Host " All system requirements verified successfully." -ForegroundColor Green
    }
}

function Show-Screen2 {
    Show-Header
    Write-Host " [SCREEN 2/4] HARDWARE DETECTION AND VERSION ANALYSIS" -ForegroundColor Cyan
    Write-Host " ====================================================" -ForegroundColor Cyan
    Write-Host ""
}

function Show-Screen3 {
    Show-Header
    Write-Host " [SCREEN 3/4] UPDATE CONFIRMATION AND SYSTEM PREPARATION" -ForegroundColor Cyan
    Write-Host " =======================================================" -ForegroundColor Cyan
    Write-Host ""

    Write-Host " IMPORTANT NOTICE:" -ForegroundColor Yellow
    Write-Host " The INF files update process may take several minutes to complete." -ForegroundColor Yellow
    Write-Host " During installation, the screen may temporarily go black and some" -ForegroundColor Yellow
    Write-Host " devices may temporarily disconnect as PCIe bus INF files are being" -ForegroundColor Yellow
    Write-Host " updated. This is normal behavior and the system will return to" -ForegroundColor Yellow
    Write-Host " normal operation once the installation is complete." -ForegroundColor Yellow
    Write-Host ""

    if ($AutoMode) {
        $response = "Y"
        Write-Host " Auto mode: automatically proceeding (Y)." -ForegroundColor Cyan
    } else {
        $response = Read-Host " Do you want to proceed with INF files update? (Y/N)"
    }

    return $response
}

function Show-Screen4 {
    Show-Header
    Write-Host " [SCREEN 4/4] DOWNLOAD AND INSTALLATION PROGRESS" -ForegroundColor Cyan
    Write-Host " ===============================================" -ForegroundColor Cyan
    Write-Host ""
}

# =============================================
# SELF-HASH VERIFICATION FUNCTION
# =============================================

function Verify-ScriptHash {
    if ($SkipSelfHashVerification) {
        Write-Host " SKIPPED: Self-hash verification disabled (Testing Mode)." -ForegroundColor Yellow
        Write-Host ""
        return $true
    }

    try {
        Write-Host " Verifying Updater source file integrity..." -ForegroundColor Yellow

        $scriptPath = $null
        if ($PSCommandPath) {
            $scriptPath = $PSCommandPath
        } elseif ($MyInvocation.MyCommand.Path) {
            $scriptPath = $MyInvocation.MyCommand.Path
        } else {
            $potentialPath = Join-Path (Get-Location) "universal-intel-chipset-device-updater.ps1"
            if (Test-Path $potentialPath) {
                $scriptPath = $potentialPath
            }
        }

        if (-not $scriptPath -or -not (Test-Path $scriptPath)) {
            Write-Host " FAIL: Cannot locate script file for hash verification." -ForegroundColor Red
            return $false
        }

        Write-DebugMessage "Script path: $scriptPath"

        $currentHash = $null
        $retryCount = 0
        $maxRetries = 3

        while ($retryCount -lt $maxRetries -and -not $currentHash) {
            try {
                $hashResult = Get-FileHash -Path $scriptPath -Algorithm SHA256
                $currentHash = $hashResult.Hash.ToUpper()
                Write-DebugMessage "Successfully calculated script hash (attempt $($retryCount + 1)): $currentHash"
            } catch {
                $retryCount++
                if ($retryCount -eq $maxRetries) {
                    Write-Host " FAIL: Could not calculate script hash after $maxRetries attempts." -ForegroundColor Red
                    Write-Host " Error: $($_.Exception.Message)" -ForegroundColor Red
                    return $false
                }
                Start-Sleep -Milliseconds 500
            }
        }

        if (-not $currentHash) {
            Write-Host " FAIL: Could not calculate script hash." -ForegroundColor Red
            return $false
        }

        $hashVersion = Get-VersionForFileName -Version $ScriptVersion
        $hashFileUrl = "https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/releases/download/v$hashVersion/universal-intel-chipset-device-updater-$hashVersion-ps1.sha256"

        Write-DebugMessage "Downloading hash from: $hashFileUrl"

        try {
            $expectedHashResponse = Invoke-WebRequest -Uri $hashFileUrl -UseBasicParsing -ErrorAction Stop

            $expectedHashLine = ""
            if ($expectedHashResponse.Content -is [byte[]]) {
                $expectedHashLine = [System.Text.Encoding]::UTF8.GetString($expectedHashResponse.Content).Trim()
            } else {
                $expectedHashLine = $expectedHashResponse.Content.ToString().Trim()
            }

            Write-DebugMessage "Raw hash file content: '$expectedHashLine'"

            $expectedHash = $null
            $expectedFileName = $null

            if ($expectedHashLine -match '^([A-Fa-f0-9]{64})\s+(\S+)$') {
                $expectedHash = $matches[1].ToUpper()
                $expectedFileName = $matches[2]
                Write-DebugMessage "Parsed format: HASH FILENAME"
            } elseif ($expectedHashLine -match '^([A-Fa-f0-9]{64})$') {
                $expectedHash = $expectedHashLine.ToUpper()
                $expectedFileName = "universal-intel-chipset-device-updater.ps1"
                Write-DebugMessage "Parsed format: HASH only"
            } elseif ($expectedHashLine -match '^([A-Fa-f0-9]{64})\s*\*?\s*(\S+)$') {
                $expectedHash = $matches[1].ToUpper()
                $expectedFileName = $matches[2]
                Write-DebugMessage "Parsed format: HASH * FILENAME"
            }

            if (-not $expectedHash) {
                Write-Host " FAIL: Could not parse hash from file. Content: $expectedHashLine" -ForegroundColor Red
                return $false
            }

            Write-DebugMessage "Expected hash: $expectedHash"
            Write-DebugMessage "Current hash: $currentHash"
            Write-DebugMessage "Expected file: $expectedFileName"

            if ($currentHash -eq $expectedHash) {
                Write-Host " Updater hash verification: PASSED" -ForegroundColor Green
                Write-Host ""
                Write-DebugMessage "Hash verification successful"
                return $true
            } else {
                Write-Host " FAIL: Updater hash verification failed. Hash doesn't match." -ForegroundColor Red
                Write-Host "`n WARNING: The updater file may have been modified or corrupted!" -ForegroundColor Red
                Write-Host " Please download the Updater from the official source:" -ForegroundColor Red
                Write-Host " https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/releases" -ForegroundColor Cyan
                Write-Host ""
                Write-Host " Hash verification failed: $($expectedFileName)" -ForegroundColor Yellow
                Write-Host " Source: $expectedHash" -ForegroundColor Green
                Write-Host " Actual: $currentHash" -ForegroundColor Red
                return $false
            }
        } catch {
            Write-Host " ERROR: Could not download or parse hash file." -ForegroundColor Red
            Write-Host " Please download the Updater from the official source and try again:" -ForegroundColor Red
            Write-Host " https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/releases" -ForegroundColor Red

            Write-Host ""
            Write-Host " Hash verification failed: universal-intel-chipset-device-updater.ps1" -ForegroundColor Yellow
            Write-Host " Source: I can't read the source HASH from the GitHub repository." -ForegroundColor Red
            Write-Host " Actual: $currentHash" -ForegroundColor Red
            Write-Host ""

            return $false
        }
    } catch {
        Write-Host " ERROR: Could not verify script hash." -ForegroundColor Red
        Write-Host " Error: $($_.Exception.Message)" -ForegroundColor Red
        Write-Host "`n Please download the Updater from the official source and try again:" -ForegroundColor Red
        Write-Host " https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/releases" -ForegroundColor Red

        return $false
    }
}

# =============================================
# UPDATE CHECK FUNCTION
# =============================================

function Get-DownloadsFolder {
    try {
        $registryPath = "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders"
        $downloadsGuid = "{374DE290-123F-4565-9164-39C4925E467B}"

        if (Test-Path $registryPath) {
            $downloadsValue = Get-ItemProperty -Path $registryPath -Name $downloadsGuid -ErrorAction SilentlyContinue
            if ($downloadsValue -and $downloadsValue.$downloadsGuid) {
                $downloadsPath = [Environment]::ExpandEnvironmentVariables($downloadsValue.$downloadsGuid)
                Write-DebugMessage "Found Downloads folder in registry: $downloadsPath"
                return $downloadsPath
            }
        }

        $defaultDownloads = [Environment]::GetFolderPath("UserProfile") + "\Downloads"
        Write-DebugMessage "Using default Downloads folder: $defaultDownloads"
        return $defaultDownloads
    } catch {
        Write-DebugMessage "Error getting Downloads folder: $($_.Exception.Message)"
        return [Environment]::GetFolderPath("UserProfile") + "\Downloads"
    }
}

function Check-ForUpdaterUpdates {
    try {
        Write-Host " Checking for newer updater version..." -ForegroundColor Yellow

        $versionFileUrl = "https://raw.githubusercontent.com/FirstEverTech/Universal-Intel-Chipset-Updater/main/src/universal-intel-chipset-device-updater.ver"
        $latestVersionContent = Invoke-WebRequest -Uri $versionFileUrl -UseBasicParsing -ErrorAction Stop
        $latestVersion = $latestVersionContent.Content.Trim()

        $comparisonResult = Compare-Versions -Version1 $ScriptVersion -Version2 $latestVersion

        Write-DebugMessage "Current version: $ScriptVersion"
        Write-DebugMessage "Latest version: $latestVersion"
        Write-DebugMessage "Comparison result: $comparisonResult"

        if ($comparisonResult -eq 0) {
            Write-Host " Status: Already on latest version." -ForegroundColor Green
            Write-Host ""
            Write-Host " Starting hardware detection..." -ForegroundColor Gray
            Write-Host ""
            Start-Sleep -Seconds 3
            return $true
        } elseif ($comparisonResult -lt 0) {
            Write-Host " A new version $latestVersion is available (current: $ScriptVersion)." -ForegroundColor Yellow

            # Check if running from PSGallery installation
            $psGalleryPath = Join-Path $env:ProgramFiles "WindowsPowerShell\Scripts"
            $isPSGallery = $MyInvocation.ScriptName -like "$psGalleryPath*"

            if ($isPSGallery) {
                Write-Host ""
                Write-Host " Detected PowerShell Gallery installation." -ForegroundColor Cyan
                Write-Host " Updating via Update-Script..." -ForegroundColor Yellow
                Write-Host ""
                try {
                    Update-Script universal-intel-chipset-device-updater -Force -ErrorAction Stop
                    Write-Host " SUCCESS: Script updated successfully." -ForegroundColor Green
                    Write-Host " Please run the script again to use the new version." -ForegroundColor Yellow
                    Write-Host ""
                    Cleanup
                    if (-not $isSFX) { Clear-Host; Write-Host "`n Thank you for using Universal Intel Chipset Device Updater!`n" -ForegroundColor Cyan }
                    exit 0
                } catch {
                    Write-Host " ERROR: Failed to update via PSGallery - $($_.Exception.Message)" -ForegroundColor Red
                    Write-Host " Please update manually: Update-Script universal-intel-chipset-device-updater" -ForegroundColor Yellow
                    Write-Host ""
                    # Fall through to normal update flow
                }
            }

            if ($AutoMode) {
                $continueChoice = "Y"
                Write-Host " Auto mode: automatically continuing with current version (Y)." -ForegroundColor Cyan
            } else {
                do {
                    Write-Host ""
                    $continueChoice = Read-Host " Do you want to continue with the current version? (Y/N)"
                    $continueChoice = $continueChoice.Trim().ToUpper()

                    if ($continueChoice -ne 'Y' -and $continueChoice -ne 'N') {
                        Write-Host " Invalid input. Please enter Y or N." -ForegroundColor Red
                    }
                } while ($continueChoice -ne 'Y' -and $continueChoice -ne 'N')
            }

            if ($continueChoice -eq 'Y') {
                return $true
            } else {
                # User chose not to continue with current version
                if ($AutoMode) {
                    $downloadChoice = "N"
                    Write-Host " Auto mode: automatically not downloading new version (N)." -ForegroundColor Cyan
                } else {
                    do {
                        $downloadChoice = Read-Host " Do you want to download the latest version? (Y/N)"
                        $downloadChoice = $downloadChoice.Trim().ToUpper()

                        if ($downloadChoice -ne 'Y' -and $downloadChoice -ne 'N') {
                            Write-Host " Invalid input. Please enter Y or N." -ForegroundColor Red
                        }
                    } while ($downloadChoice -ne 'Y' -and $downloadChoice -ne 'N')
                }

                if ($downloadChoice -eq 'Y') {
                    $tagVersion = Get-VersionForGitHubTag -Version $latestVersion
                    $fileVersion = Get-VersionForFileName -Version $latestVersion

                    $downloadUrl = "https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/releases/download/v$tagVersion/ChipsetUpdater-$fileVersion-Win10-Win11.exe"
                    $downloadsFolder = Get-DownloadsFolder
                    $outputPath = Join-Path $downloadsFolder "ChipsetUpdater-$fileVersion-Win10-Win11.exe"

                    Write-Host " Downloading new version to:" -ForegroundColor Yellow
                    Write-Host " $outputPath" -ForegroundColor Yellow
                    Write-Host ""

                    $maxRetries = 3
                    $retryCount = 0
                    $downloadSuccess = $false

                    while ($retryCount -lt $maxRetries -and -not $downloadSuccess) {
                        try {
                            Write-Host " Attempt $($retryCount + 1) of $maxRetries..." -ForegroundColor Yellow
                            Invoke-WebRequest -Uri $downloadUrl -OutFile $outputPath -UseBasicParsing -ErrorAction Stop
                            $downloadSuccess = $true
                            Write-Host " SUCCESS: New version downloaded successfully." -ForegroundColor Green
                            Write-Host "`n File saved to:" -ForegroundColor Yellow
                            Write-Host " $outputPath" -ForegroundColor Yellow
                        } catch {
                            $retryCount++
                            if ($retryCount -eq $maxRetries) {
                                Write-Host " ERROR: Failed to download new version after $maxRetries attempts - $($_.Exception.Message)" -ForegroundColor Red
                                Write-Host " Please download manually from: https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater/releases" -ForegroundColor Red
                            } else {
                                Write-Host " Download attempt $retryCount failed, retrying..." -ForegroundColor Yellow
                                Start-Sleep -Seconds 2
                            }
                        }
                    }

                    if ($downloadSuccess) {
                        if ($AutoMode) {
                            $exitChoice = "Y"
                            Write-Host " Auto mode: automatically exiting to run new version (Y)." -ForegroundColor Cyan
                        } else {
                            do {
                                $exitChoice = Read-Host "`n Do you want to exit now to run the new version? (Y/N)"
                                $exitChoice = $exitChoice.Trim().ToUpper()

                                if ($exitChoice -ne 'Y' -and $exitChoice -ne 'N') {
                                    Write-Host " Invalid input. Please enter Y or N." -ForegroundColor Red
                                }
                            } while ($exitChoice -ne 'Y' -and $exitChoice -ne 'N')
                        }

                        if ($exitChoice -eq 'Y') {
                            Write-Host " Starting the new version and closing current updater..." -ForegroundColor Green
                            Write-Host ""

                            Start-Process -FilePath $outputPath

                            exit 100
                        } else {
                            Write-Host " Update cancelled by user." -ForegroundColor Yellow
                            Cleanup
                            if (-not $AutoMode) {
                                Write-Host " Press any key..."
                                $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
                            }
                            Show-FinalCredits
                            exit 0
                        }
                    } else {
                        Write-Host " Update process cancelled due to download failure." -ForegroundColor Red
                        Cleanup
                        if (-not $AutoMode) {
                            Write-Host " Press any key..."
                            $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
                        }
                        Show-FinalCredits
                        exit 1
                    }
                } else {
                    Write-Host " Update cancelled by user." -ForegroundColor Yellow
                    Cleanup
                    if (-not $AutoMode) {
                        Write-Host " Press any key..."
                        $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
                    }
                    Show-FinalCredits
                    exit 0
                }
            }
        } else {
            Write-Host " Status: Current version appears newer than latest." -ForegroundColor Cyan
            Write-Host ""
            Write-Host " Starting hardware detection..." -ForegroundColor Gray
            Start-Sleep -Seconds 3
            return $true
        }
    } catch {
        Write-Host " WARNING: Could not check for updates." -ForegroundColor Yellow
        Write-Host " Error: $($_.Exception.Message)" -ForegroundColor Yellow
        Write-Host " Continuing with current version in 3 seconds..." -ForegroundColor Yellow
        Start-Sleep -Seconds 3
        return $true
    }
}

# =============================================
# FILE INTEGRITY VERIFICATION FUNCTIONS
# =============================================

function Verify-FileHash {
    param(
        [string]$FilePath,
        [string]$ExpectedHash,
        [string]$HashType = "Primary",
        [string]$OriginalFileName = $null
    )

    if (-not $ExpectedHash) {
        Write-DebugMessage "No expected $HashType hash provided, skipping verification."
        return $true
    }

    $actualHash = $null
    try {
        if (-not (Test-Path $FilePath)) {
            Write-Log "File not found for hash calculation: $FilePath" -Type "ERROR"
            return $false
        }
        $hashResult = Get-FileHash -Path $FilePath -Algorithm SHA256
        $actualHash = $hashResult.Hash
        Write-DebugMessage "Calculated SHA256 for $FilePath : $actualHash"
    } catch {
        Write-Log "Error calculating hash for $FilePath : $($_.Exception.Message)" -Type "ERROR"
        return $false
    }

    if (-not $actualHash) {
        Write-Log "Failed to calculate hash for $FilePath" -Type "ERROR"
        return $false
    }

    if ($actualHash -eq $ExpectedHash) {
        Write-DebugMessage "$HashType hash verification passed for $FilePath"
        Write-Host " PASS: $HashType hash verification passed." -ForegroundColor Green
        return $true
    } else {
        $displayName = if ($OriginalFileName) { $OriginalFileName } else { Split-Path $FilePath -Leaf }

        $errorMessage = "$HashType hash verification failed for $displayName. Source: $ExpectedHash, Actual: $actualHash"

        $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        $logEntry = "[$timestamp] [ERROR] $errorMessage"
        try {
            Add-Content -Path $logFile -Value $logEntry -ErrorAction SilentlyContinue
        } catch {
            # Silent fallback
        }
        $global:InstallationErrors += $errorMessage

        Write-Host ""
        Write-Host " $HashType hash verification failed: $displayName" -ForegroundColor Red
        Write-Host " Source: $ExpectedHash" -ForegroundColor Red
        Write-Host " Actual: $actualHash" -ForegroundColor Red
        Write-Host ""
        return $false
    }
}

# =============================================
# DIGITAL SIGNATURE VERIFICATION FUNCTIONS
# =============================================

function Verify-FileSignature {
    param(
        [string]$FilePath,
        [string]$INFPath = $null
    )

    try {
        Write-DebugMessage "Verifying digital signature for: $FilePath"

        $signature = Get-AuthenticodeSignature -FilePath $FilePath
        Write-DebugMessage "Signature status: $($signature.Status)"
        Write-DebugMessage "Signer: $($signature.SignerCertificate.Subject)"
        Write-DebugMessage "Signature Algorithm: $($signature.SignerCertificate.SignatureAlgorithm.FriendlyName)"

        if ($signature.Status -ne 'Valid') {
            Write-Log "Digital signature is not valid. Status: $($signature.Status)" -Type "ERROR"
            Write-Host " FAIL: Digital signature verification - Status: $($signature.Status)" -ForegroundColor Red
            return $false
        }

        # List of allowed Intel signers in priority order
        # Intel has used different certificate subjects over the years
        $allowedSigners = @(
            @{ Pattern = 'CN=Intel Corporation'; Name = 'Intel Corporation (latest)' },
            @{ Pattern = 'Intel\(R\) Software and Firmware Products'; Name = 'Intel(R) Software and Firmware Products (newer)' },
            @{ Pattern = 'Intel Corporation - Software and Firmware Products'; Name = 'Intel Corporation - Software and Firmware Products (oldest)' }
        )

        $signerName = $signature.SignerCertificate.Subject
        $isValidSigner = $false
        $matchedSigner = $null

        # Check if signature matches any Intel pattern
        foreach ($signer in $allowedSigners) {
            if ($signerName -match $signer.Pattern) {
                $isValidSigner = $true
                $matchedSigner = $signer.Name
                Write-DebugMessage "Matched Intel signature: '$($signer.Name)'"
                break
            }
        }

        # SPECIAL EXCEPTION: Version 10.1.20524.8822 signed by FirstEver.tech
        # Intel did not provide an official installer for this version
        $isFirstEverSignature = $signerName -match 'FirstEver\.tech'
        if ($isFirstEverSignature) {
            # Check if this is actually version 10.1.20524.8822
            $fileName = Split-Path $FilePath -Leaf
            if ($fileName -match '20524|8822' -or $INFPath -match '20524|8822') {
                Write-DebugMessage "Detected FirstEver.tech signature for version 10.1.20524.8822 - ACCEPTED as exception"
                Write-Host " NOTE: Using FirstEver.tech signature (official Intel installer not available for this version)" -ForegroundColor Yellow
                $isValidSigner = $true
                $matchedSigner = "FirstEver.tech (exception for version 10.1.20524.8822)"
            } else {
                # If this is not the specific version, reject it
                Write-Log "FirstEver.tech signature detected but not for version 10.1.20524.8822" -Type "ERROR"
                Write-Host " FAIL: FirstEver.tech signature is only allowed for version 10.1.20524.8822" -ForegroundColor Red
                return $false
            }
        }

        if (-not $isValidSigner) {
            Write-Log "File not signed by any recognized Intel signer or FirstEver.tech. Signer: $signerName" -Type "ERROR"
            Write-Host " FAIL: Digital signature verification - Not signed by recognized authority." -ForegroundColor Red
            Write-Host "   Signer: $signerName" -ForegroundColor Yellow
            Write-Host "   Allowed signers:" -ForegroundColor Yellow
            Write-Host "     1. Intel Corporation (latest)" -ForegroundColor Gray
            Write-Host "     2. Intel(R) Software and Firmware Products (newer)" -ForegroundColor Gray
            Write-Host "     3. Intel Corporation - Software and Firmware Products (oldest)" -ForegroundColor Gray
            Write-Host "     4. FirstEver.tech (only for version 10.1.20524.8822)" -ForegroundColor Gray
            return $false
        }

        # NOTE: Certificate expiration is intentionally NOT checked against Get-Date here.
        # Authenticode signatures remain cryptographically valid after cert expiration as
        # long as a valid RFC3161 timestamp exists ($signature.Status -eq 'Valid' already
        # accounts for this via Get-AuthenticodeSignature). A raw NotAfter < Get-Date check
        # rejects legitimate, correctly-timestamped old Intel installers.

        # Check algorithm (accept SHA256, SHA1 for older installers)
        $sigAlgo = $signature.SignerCertificate.SignatureAlgorithm.FriendlyName
        if ($sigAlgo -notmatch 'sha256|sha1') {
            Write-DebugMessage "Unusual signature algorithm: $sigAlgo" -Type "WARNING"
            Write-Host " WARNING: Unusual signature algorithm: $sigAlgo" -ForegroundColor Yellow
            # Don't block, just warn
        }

        $displayName = if ($matchedSigner) { $matchedSigner } else { $signerName }
        Write-Host " PASS: Digitally signed by $displayName" -ForegroundColor Green
        Write-DebugMessage "Digital signature verification passed for $FilePath"
        return $true
    } catch {
        Write-Log "Error verifying digital signature: $($_.Exception.Message)" -Type "ERROR"
        Write-Host " FAIL: Digital signature verification - Error: $($_.Exception.Message)" -ForegroundColor Red
        return $false
    }
}

function Verify-InstallerSignature {
    param([string]$INFPath, [string]$Prefix)

    try {
        if ($Prefix) {
            $setupPath = Join-Path $INFPath ($Prefix.TrimStart('\'))
        } else {
            $setupPath = Join-Path $INFPath "SetupChipset.exe"
        }

        Write-DebugMessage "Checking installer signature at: $setupPath"

        if (-not (Test-Path $setupPath)) {
            Write-Log "Installer not found for signature verification: $setupPath" -Type "ERROR"
            return $false
        }

        # Pass INFPath to Verify-FileSignature for version detection
        return Verify-FileSignature -FilePath $setupPath -INFPath $INFPath
    } catch {
        Write-Log "Error in installer signature verification: $($_.Exception.Message)" -Type "ERROR"
        return $false
    }
}

# =============================================
# UPDATED PARSER FOR EXTENDED FORMAT
# =============================================

function Parse-DownloadList {
    param([string]$DownloadListContent)

    Write-DebugMessage "Starting download list parsing."
    $downloadData = @{}

    try {
        $blocks = $DownloadListContent -split "`n`n" | Where-Object { $_.Trim() }

        Write-DebugMessage "Found $($blocks.Count) blocks in download list."

        foreach ($block in $blocks) {
            $name = $null
            $infVer = $null
            $link = $null
            $prefix = $null
            $variant = "Consumer"
            $sha256 = $null
            $backup = $null
            $sha256_b = $null
            $prefix_b = $null

            $lines = $block -split "`n" | ForEach-Object { $_.Trim() }
            foreach ($line in $lines) {
                if ($line -match '^Name\s*=\s*(.+)') {
                    $name = $matches[1]
                } elseif ($line -match '^INFVer\s*=\s*[^,]+,([0-9.]+)') {
                    $infVer = $matches[1]
                } elseif ($line -match '^Link\s*=\s*(.+)') {
                    $link = $matches[1]
                } elseif ($line -match '^Prefix\s*=\s*(.+)') {
                    $prefix = $matches[1]
                } elseif ($line -match '^Variant\s*=\s*(.+)') {
                    $variant = $matches[1]
                } elseif ($line -match '^SHA256\s*=\s*([A-F0-9]+)') {
                    $sha256 = $matches[1]
                } elseif ($line -match '^Backup\s*=\s*(.+)') {
                    $backup = $matches[1]
                } elseif ($line -match '^SHA256_B\s*=\s*([A-F0-9]+)') {
                    $sha256_b = $matches[1]
                } elseif ($line -match '^Prefix_B\s*=\s*(.+)') {
                    $prefix_b = $matches[1]
                }
            }

            if ($infVer -and $link) {
                $key = "$infVer-$variant"
                $downloadData[$key] = @{
                    Name      = $name
                    INFVer    = $infVer
                    Link      = $link
                    Prefix    = $prefix
                    Variant   = $variant
                    SHA256    = $sha256
                    Backup    = $backup
                    SHA256_B  = $sha256_b
                    Prefix_B  = $prefix_b
                }
                Write-DebugMessage "Added download entry: $key -> $name"
            } else {
                Write-DebugMessage "Skipping incomplete block - missing INFVer or Link."
            }
        }

        Write-DebugMessage "Download list parsing completed. Found $($downloadData.Count) entries."
        return $downloadData
    } catch {
        Write-Log "Download list parsing failed: $($_.Exception.Message)" -Type "ERROR"
        return @{}
    }
}

# =============================================
# ENHANCED DOWNLOAD FUNCTION
# =============================================

function Download-Extract-File {
    param(
        [string]$Url,
        [string]$OutputPath,
        [string]$Prefix,
        [string]$ExpectedHash,
        [string]$SourceName = "Primary"
    )

    try {
        $tempFile = "$tempDir\temp_$(Get-Random).$([System.IO.Path]::GetExtension($Url).TrimStart('.'))"

        Write-DebugMessage "Downloading from $SourceName source: $Url to $tempFile"
        Write-Host " Downloading from $SourceName source..." -ForegroundColor Yellow

        $downloadSuccess = $true
        $downloadError = $null

        try {
            Invoke-WebRequest -Uri $Url -OutFile $tempFile -UseBasicParsing -ErrorAction Stop
        } catch {
            $downloadSuccess = $false
            $downloadError = $_.Exception.Message
        }

        if (-not $downloadSuccess) {
            Write-Log "Download failed for $SourceName source $Url : $downloadError" -Type "ERROR"
            return @{ Success = $false; ErrorType = "DownloadFailed"; Message = "Download failed: $downloadError" }
        }

        if (-not (Test-Path $tempFile)) {
            return @{ Success = $false; ErrorType = "DownloadFailed"; Message = "File not found after download" }
        }

        if ($ExpectedHash) {
            Write-Host " Verifying $SourceName source file integrity..." -ForegroundColor Yellow
            $originalFileName = [System.IO.Path]::GetFileName($Url)
            if (-not (Verify-FileHash -FilePath $tempFile -ExpectedHash $ExpectedHash -HashType $SourceName -OriginalFileName $originalFileName)) {
                Remove-Item $tempFile -Force -ErrorAction SilentlyContinue
                return @{ Success = $false; ErrorType = "HashMismatch"; Message = "Hash verification failed." }
            }
        }

        $fileExtension = [System.IO.Path]::GetExtension($Url).ToLower()

        if ($fileExtension -eq '.zip') {
            try {
                Add-Type -AssemblyName System.IO.Compression.FileSystem
                [System.IO.Compression.ZipFile]::ExtractToDirectory($tempFile, $OutputPath)
                Write-Host " ZIP file extracted successfully." -ForegroundColor Green
                Write-DebugMessage "ZIP extraction successful to: $OutputPath"
            } catch {
                try {
                    Write-Host " Using COM object for ZIP extraction..." -ForegroundColor Yellow
                    $shell = New-Object -ComObject Shell.Application
                    $zipFolder = $shell.NameSpace($tempFile)
                    $destFolder = $shell.NameSpace($OutputPath)
                    $destFolder.CopyHere($zipFolder.Items(), 0x14)
                    Write-Host " ZIP file extracted successfully using COM." -ForegroundColor Green
                } catch {
                    Write-Log "Error extracting ZIP file: $_" -Type "ERROR"
                    return @{ Success = $false; ErrorType = "ExtractionFailed"; Message = "ZIP extraction failed.: $_" }
                }
            }
        } elseif ($fileExtension -eq '.exe') {
            New-Item -ItemType Directory -Path $OutputPath -Force | Out-Null

            if ($Prefix -and $Prefix -ne '\SetupChipset.exe') {
                $subDir = Split-Path $Prefix.TrimStart('\') -Parent
                if ($subDir) {
                    $fullOutputPath = Join-Path $OutputPath $subDir
                    New-Item -ItemType Directory -Path $fullOutputPath -Force | Out-Null
                    Write-DebugMessage "Created subdirectory: $fullOutputPath"
                }

                $outputFile = Join-Path $OutputPath ($Prefix.TrimStart('\'))
                Copy-Item $tempFile $outputFile -Force
                Write-Host " EXE file copied to: $outputFile" -ForegroundColor Green
            } else {
                Copy-Item $tempFile "$OutputPath\SetupChipset.exe" -Force
                Write-Host " EXE file copied to: $OutputPath\SetupChipset.exe" -ForegroundColor Green
            }
        } else {
            Write-Log "Unknown file type: $fileExtension" -Type "ERROR"
            return @{ Success = $false; ErrorType = "UnknownFileType"; Message = "Unknown file type: $fileExtension" }
        }

        Remove-Item $tempFile -Force -ErrorAction SilentlyContinue
        Write-DebugMessage "Removed temporary file: $tempFile"
        return @{ Success = $true; ErrorType = "None"; Message = "Success" }
    } catch {
        Write-Log "Error in Download-Extract-File: $_" -Type "ERROR"
        return @{ Success = $false; ErrorType = "UnknownError"; Message = "Unexpected error: $_" }
    }
}

# =============================================
# HARDWARE DETECTION FUNCTIONS
# =============================================

function Get-IntelChipsetHWIDs {
    # NOTE (v2026.08.0017): Detection no longer pre-filters candidate devices by
    # matching keywords ("Chipset", "LPC", "PCI Express Root Port", etc.) against
    # $device.FriendlyName. That approach silently dropped legitimate Intel System
    # devices whose FriendlyName didn't happen to contain one of those words (e.g.
    # "Gaussian Mixture Model", "Host Bridge/DRAM Registers", "PCIe Controller (x16)").
    #
    # Every VEN_8086 System-class device with Status -eq 'OK' is now collected
    # unconditionally by HWID. The authoritative filter is applied downstream,
    # where each detected HWID is looked up directly against the full INF/HWID
    # database ($chipsetData.ContainsKey($hwId)) - so nothing is excluded here
    # based on a guessed keyword list.
    $intelChipsets = @()

    try {
        $pciDevices = Get-PnpDevice -Class 'System' -ErrorAction SilentlyContinue |
        Where-Object { $_.HardwareID -like '*PCI\VEN_8086*' -and $_.Status -eq 'OK' }

        foreach ($device in $pciDevices) {
            foreach ($hwid in $device.HardwareID) {
                if ($hwid -match 'PCI\\VEN_8086&DEV_([A-F0-9]{4})') {
                    $deviceId = $matches[1]
                    $description = $device.FriendlyName

                    $intelChipsets += [PSCustomObject]@{
                        HWID            = $deviceId
                        Description     = $description
                        HardwareID      = $hwid
                        InstanceId      = $device.InstanceId
                        PnpDeviceObject = $device
                    }
                }
            }
        }

        Write-DebugMessage "Scanning completed: found $($intelChipsets.Count) candidate Intel System-class device HWID(s) (VEN_8086, Status=OK) prior to database matching"
        return $intelChipsets | Sort-Object HWID -Unique
    } catch {
        Write-Log "Hardware detection failed: $($_.Exception.Message)" -Type "ERROR"
        return @{}
    }
}

function Get-CurrentINFVersion {
    param(
        [Parameter(ParameterSetName = 'ByObject')]
        $Device,
        [Parameter(ParameterSetName = 'ByInstanceId')]
        [string]$DeviceInstanceId
    )

    try {
        # Preferred path (v2026.08.0017): caller already holds the PnpDevice object
        # from the initial enumeration, so we query properties directly on it
        # instead of re-running Get-PnpDevice against the whole system just to
        # find one InstanceId again. This is the main cost driver when many
        # devices are detected - avoiding it turns an O(n^2) scan into O(n).
        if ($Device) {
            $versionProperty = $Device | Get-PnpDeviceProperty -KeyName "DEVPKEY_Device_DriverVersion" -ErrorAction SilentlyContinue
            if ($versionProperty -and $versionProperty.Data) {
                Write-DebugMessage "Got version from DEVPKEY_Device_DriverVersion: $($versionProperty.Data)"
                return $versionProperty.Data
            }

            $infVersionProperty = $Device | Get-PnpDeviceProperty -KeyName "DEVPKEY_Device_INFVersion" -ErrorAction SilentlyContinue
            if ($infVersionProperty -and $infVersionProperty.Data) {
                Write-DebugMessage "Got version from DEVPKEY_Device_INFVersion: $($infVersionProperty.Data)"
                return $infVersionProperty.Data
            }

            $DeviceInstanceId = $Device.InstanceId
        } elseif ($DeviceInstanceId) {
            # Fallback path kept for backward compatibility (e.g. -DebugMode callers
            # that only have an InstanceId string). Slower - re-enumerates all PnP
            # devices on the system to find this one.
            $lookedUpDevice = Get-PnpDevice | Where-Object { $_.InstanceId -eq $DeviceInstanceId }
            if ($lookedUpDevice) {
                $versionProperty = $lookedUpDevice | Get-PnpDeviceProperty -KeyName "DEVPKEY_Device_DriverVersion" -ErrorAction SilentlyContinue
                if ($versionProperty -and $versionProperty.Data) {
                    Write-DebugMessage "Got version from DEVPKEY_Device_DriverVersion: $($versionProperty.Data)"
                    return $versionProperty.Data
                }

                $infVersionProperty = $lookedUpDevice | Get-PnpDeviceProperty -KeyName "DEVPKEY_Device_INFVersion" -ErrorAction SilentlyContinue
                if ($infVersionProperty -and $infVersionProperty.Data) {
                    Write-DebugMessage "Got version from DEVPKEY_Device_INFVersion: $($infVersionProperty.Data)"
                    return $infVersionProperty.Data
                }
            }
        }

        $driverInfo = Get-CimInstance -ClassName Win32_PnPSignedDriver | Where-Object {
            $_.DeviceID -eq $DeviceInstanceId -and $_.DriverVersion
        } | Select-Object -First 1

        if ($driverInfo) {
            Write-DebugMessage "Got version from WMI: $($driverInfo.DriverVersion)"
            return $driverInfo.DriverVersion
        }

        Write-DebugMessage "Could not determine version for device: $DeviceInstanceId"
        return $null
    } catch {
        Write-DebugMessage "Error getting INF version: $_"
        return $null
    }
}

# =============================================
# TEMP DIRECTORY CLEANUP FUNCTION
# =============================================

function Clear-TempINFFolders {
    try {
        if (Test-Path $tempDir) {
            Remove-Item -Path $tempDir -Recurse -Force -ErrorAction SilentlyContinue
            Write-DebugMessage "Cleaned up temporary directory: $tempDir"
        }
    } catch {
        Write-DebugMessage "Error during cleanup: $_"
    }
}

# =============================================
# DATA DOWNLOAD AND PARSING FUNCTIONS
# =============================================

function Get-LatestINFInfo {
    param([string]$Url)

    try {
        $cacheBuster = "t=" + (Get-Date -Format 'yyyyMMddHHmmss')
        if ($Url.Contains('?')) {
            $finalUrl = $Url + "&" + $cacheBuster
        } else {
            $finalUrl = $Url + "?" + $cacheBuster
        }

        Write-DebugMessage "Downloading from: $finalUrl (with cache-buster)"
        $content = Invoke-WebRequest -Uri $finalUrl -UseBasicParsing -ErrorAction Stop
        Write-DebugMessage "Successfully downloaded content from $finalUrl"
        return $content.Content
    } catch {
        Write-Log "Error downloading from GitHub: `n $($_.Exception.Message)" -Type "ERROR"
        return $null
    }
}

function Parse-ChipsetINFsFromMarkdown {
    param([string]$MarkdownContent)

    Write-DebugMessage "Starting Markdown parsing."
    $chipsetData = @{}

    try {
        $lines = $MarkdownContent -split "`n"
        $currentPlatform = $null
        $currentGeneration = $null
        $inMainstreamSection = $false
        $inWorkstationSection = $false
        $inXeonSection = $false
        $inAtomSection = $false
        for ($i = 0; $i -lt $lines.Count; $i++) {
            $line = $lines[$i].Trim()

            if ($line -match '^### Mainstream Desktop/Mobile') {
                $inMainstreamSection = $true
                $inWorkstationSection = $false
                $inXeonSection = $false
                $inAtomSection = $false
                Write-DebugMessage "Entered Mainstream Desktop/Mobile section."
                continue
            } elseif ($line -match '^### Workstation/Enthusiast') {
                $inMainstreamSection = $false
                $inWorkstationSection = $true
                $inXeonSection = $false
                $inAtomSection = $false
                Write-DebugMessage "Entered Workstation/Enthusiast section."
                continue
            } elseif ($line -match '^### Xeon/Server Platforms') {
                $inMainstreamSection = $false
                $inWorkstationSection = $false
                $inXeonSection = $true
                $inAtomSection = $false
                Write-DebugMessage "Entered Xeon/Server Platforms section."
                continue
            } elseif ($line -match '^### Atom/Low-Power Platforms') {
                $inMainstreamSection = $false
                $inWorkstationSection = $false
                $inXeonSection = $false
                $inAtomSection = $true
                Write-DebugMessage "Entered Atom/Low-Power Platforms section."
                continue
            }

            if ($line -match '^####\s+(.+)') {
                $rawPlatform = $matches[1].Trim()
                $isEOLHeader = $rawPlatform -match '\s+EOL$'
                $currentPlatform = $rawPlatform -replace '\s+EOL$', ''
                Write-DebugMessage "Platform header: raw='$rawPlatform', normalized='$currentPlatform', isEOL=$isEOLHeader"

                if ($inMainstreamSection) {
                    $sectionName = "Mainstream Desktop/Mobile"
                } elseif ($inWorkstationSection) {
                    $sectionName = "Workstation/Enthusiast"
                } elseif ($inXeonSection) {
                    $sectionName = "Xeon/Server Platforms"
                } elseif ($inAtomSection) {
                    $sectionName = "Atom/Low-Power Platforms"
                } else {
                    $sectionName = "Unknown"
                }

                Write-DebugMessage "Processing platform: $currentPlatform ($sectionName)"
                continue
            }

            if ($line -match '\*\*Generation:\*\*\s*(.+)') {
                $currentGeneration = $matches[1]
                Write-DebugMessage "Generation: $currentGeneration"
                continue
            }

            if ($line -match '^\|.*INF.*\|.*Package.*\|.*Version.*\|.*Date.*\|.*HWIDs.*\|$' -and $currentPlatform) {
                Write-DebugMessage "Found table for platform: $currentPlatform"
                $i++

                while ($i -lt $lines.Count -and $lines[$i].Trim() -match '^\|.*\|.*\|.*\|.*\|.*\|$') {
                    $dataLine = $lines[$i].Trim()
                    $i++

                    if ($dataLine -match '^\|\s*:?---') { continue }

                    $columns = $dataLine.Split('|', [System.StringSplitOptions]::RemoveEmptyEntries) | ForEach-Object { $_.Trim() }
                    if ($columns.Count -ge 5) {
                        $inf     = $columns[0]
                        $package = $columns[1]
                        $version = $columns[2]
                        $date    = $columns[3] -replace '\\', ''
                        $hwIds   = $columns[4] -split ',' | ForEach-Object { $_.Trim() }

                        # EOL can be in package (old database) or in header (new database)
                        $isEOL = ($package -match '\(EOL') -or $isEOLHeader
                        $cleanPackage = ($package -replace '\s*\(EOL[^)]*\)\s*', '').Trim()

                        Write-DebugMessage "Parsed row: INF=$inf, Package=$cleanPackage, Version=$version, IsEOL=$isEOL, HWIDs=$($hwIds -join ', ')"

                        foreach ($hwId in $hwIds) {
                            if ($hwId -match '^[A-F0-9]{4}$') {
                                $chipsetData[$hwId] = @{
                                    Platform          = $currentPlatform
                                    Section           = $sectionName
                                    Generation        = $currentGeneration
                                    INF               = $inf
                                    Package           = $cleanPackage
                                    Version           = $version
                                    Date              = $date
                                    HasAsterisk       = $date -match '\*$'
                                    IsWindowsInbox    = ($cleanPackage -eq "None")
                                    IsEOL             = $isEOL
                                }
                                Write-DebugMessage "Added HWID: $hwId for platform $currentPlatform (Package: $cleanPackage, IsEOL: $isEOL, IsWindowsInbox: $($cleanPackage -eq 'None'))"
                            } else {
                                Write-DebugMessage "Skipping invalid HWID: $hwId"
                            }
                        }
                    }
                }
            }
        }

        Write-DebugMessage "Markdown parsing completed. Found $($chipsetData.Count) HWID entries."
        return $chipsetData
    } catch {
        Write-Log "Markdown parsing failed: $($_.Exception.Message)" -Type "ERROR"
        return @{}
    }
}

# =============================================
# INSTALLATION FUNCTION
# =============================================

function Install-ChipsetINF {
    param([string]$INFPath, [string]$Prefix)

    try {
        if ($Prefix) {
            $setupPath = Join-Path $INFPath ($Prefix.TrimStart('\'))
        } else {
            $setupPath = Join-Path $INFPath "SetupChipset.exe"
        }

        Write-DebugMessage "Installing from path: $setupPath"

        if (Test-Path $setupPath) {
            $isMSI = $setupPath -match '\.msi$'

            if ($isMSI) {
                Write-Host " Verifying MSI installer integrity..." -ForegroundColor Yellow

                if ($INFPath -match '(\d+\.\d+\.\d+\.\d+)') {
                    $version = $matches[1]
                    Write-DebugMessage "Extracted version for MSI verification: $version"

                    try {
                        $hashUrl = $githubArchiveUrl + "intel_chipset_$version.msi.sha256"
                        Write-DebugMessage "Downloading MSI hash from: $hashUrl"

                        $hashResponse = Invoke-WebRequest -Uri $hashUrl -UseBasicParsing -ErrorAction Stop
                        $hashContent = $hashResponse.Content
                        if ($hashContent -is [byte[]]) {
                            $hashContent = [System.Text.Encoding]::UTF8.GetString($hashContent)
                        } else {
                            $hashContent = $hashContent.ToString()
                        }

                        $hashContent = $hashContent.Trim()
                        if ($hashContent.Length -gt 0 -and [int][char]$hashContent[0] -eq 0xFEFF) {
                            $hashContent = $hashContent.Substring(1).Trim()
                        }
                        $hashContent = $hashContent.TrimStart([char]0xEF, [char]0xBB, [char]0xBF).Trim()

                        Write-DebugMessage "Hash file content: $hashContent"

                        if ($hashContent -match '^([A-F0-9]{64})\s+') {
                            $expectedHash = $matches[1]
                            Write-DebugMessage "Expected MSI hash: $expectedHash"

                            $actualHash = (Get-FileHash -Path $setupPath -Algorithm SHA256).Hash
                            Write-DebugMessage "Actual MSI hash: $actualHash"

                            if ($actualHash -eq $expectedHash) {
                                Write-Host " MSI integrity verification: PASSED" -ForegroundColor Green
                                Write-DebugMessage "MSI hash verification successful"
                            } else {
                                Write-Log "MSI hash mismatch for $setupPath" -Type "ERROR"
                                Write-Host " ERROR: MSI integrity verification failed. Hash mismatch." -ForegroundColor Red
                                Write-Host " Expected: $expectedHash" -ForegroundColor Yellow
                                Write-Host " Actual:   $actualHash" -ForegroundColor Yellow
                                return $false
                            }
                        } else {
                            Write-Log "Invalid hash file format from $hashUrl" -Type "ERROR"
                            Write-Host " WARNING: Could not parse hash file. Proceeding with caution..." -ForegroundColor Yellow
                        }
                    } catch {
                        Write-DebugMessage "Could not verify MSI hash: $($_.Exception.Message)"
                        Write-Host " WARNING: Could not verify MSI hash (file may not be available yet)." -ForegroundColor Yellow
                        Write-Host " ZIP archive was already verified. Proceeding with installation..." -ForegroundColor Yellow
                    }
                } else {
                    Write-Host " WARNING: Could not extract version for MSI verification." -ForegroundColor Yellow
                }
            } else {
                Write-Host " Verifying installer digital signature..." -ForegroundColor Yellow
                # Pass INFPath to Verify-FileSignature for version detection
                if (-not (Verify-FileSignature -FilePath $setupPath -INFPath $INFPath)) {
                    Write-Log "Installer digital signature verification failed. Aborting installation." -Type "ERROR"
                    Write-Host " ERROR: Installer digital signature verification failed. Installation aborted." -ForegroundColor Red
                    return $false
                }
            }

            Write-Host ""
            Write-Host " IMPORTANT NOTICE:" -ForegroundColor Yellow
            Write-Host " The INF files updater is now running." -ForegroundColor Yellow
            Write-Host " Please DO NOT close this window or interrupt the process." -ForegroundColor Yellow
            Write-Host " The system may appear unresponsive during installation - this is normal." -ForegroundColor Yellow
            Write-Host ""

            if ($isMSI) {
                Write-Host " Running installer: SetupChipset.msi" -ForegroundColor Cyan
                Write-DebugMessage "Starting MSI installer with msiexec: /i /quiet /norestart"

                $process = Start-Process -FilePath "msiexec.exe" -ArgumentList "/i `"$setupPath`" /quiet /norestart" -Wait -PassThru -NoNewWindow

                if ($process.ExitCode -eq 0 -or $process.ExitCode -eq 3010) {
                    Write-Host " INF files installed successfully." -ForegroundColor Green
                    if ($process.ExitCode -eq 3010) {
                        Write-Host " (Reboot required to complete installation)" -ForegroundColor Yellow
                    }
                    Write-DebugMessage "MSI installer completed successfully with exit code: $($process.ExitCode)"
                    return $true
                } else {
                    Write-Log "MSI installer failed with exit code: $($process.ExitCode)" -Type "ERROR"
                    Write-Host " ERROR: MSI installation failed with exit code: $($process.ExitCode)" -ForegroundColor Red
                    return $false
                }
            } else {
                Write-Host " Running installer: SetupChipset.exe" -ForegroundColor Cyan
                Write-DebugMessage "Starting installer with arguments: -S -OVERALL -downgrade -norestart"

                $process = Start-Process -FilePath $setupPath -ArgumentList "-S -OVERALL -downgrade -norestart" -Wait -PassThru

                if ($process.ExitCode -eq 0 -or $process.ExitCode -eq 3010) {
                    Write-Host " INF files installed successfully." -ForegroundColor Green
                    Write-DebugMessage "Installer completed successfully with exit code: $($process.ExitCode)"
                    return $true
                } else {
                    Write-Log "Installer failed with exit code: $($process.ExitCode)" -Type "ERROR"
                    return $false
                }
            }
        } else {
            Write-Log "Installer not found at: $setupPath" -Type "ERROR"

            $installers = Get-ChildItem -Path $INFPath -Filter "*.exe" -Recurse | Where-Object {
                $_.Name -like "*Setup*" -or $_.Name -like "*Install*"
            }

            if (-not $installers) {
                $installers = Get-ChildItem -Path $INFPath -Filter "*.msi" -Recurse | Where-Object {
                    $_.Name -like "*Setup*" -or $_.Name -like "*Install*"
                }
            }

            if ($installers) {
                Write-Host " Found alternative installer: $($installers[0].FullName)" -ForegroundColor Yellow

                $altIsMSI = $installers[0].Name -match '\.msi$'
                if (-not $altIsMSI) {
                    Write-Host " Verifying alternative installer digital signature..." -ForegroundColor Yellow
                    if (-not (Verify-FileSignature -FilePath $installers[0].FullName -INFPath $INFPath)) {
                        Write-Log "Alternative installer digital signature verification failed." -Type "ERROR"
                        return $false
                    }
                }

                return Install-ChipsetINF -INFPath $INFPath -Prefix "\$($installers[0].Name)"
            }
            return $false
        }
    } catch {
        Write-Log "Error running installer: $_" -Type "ERROR"
        return $false
    }
}

# =============================================
# FINAL CREDITS FUNCTION (with interactive keys)
# =============================================

function Show-FinalCredits {
    Clear-Host
    Write-Host "/*************************************************************************" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "                UNIVERSAL INTEL CHIPSET DEVICE UPDATER                 " -NoNewline -ForegroundColor White -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "** --------------------------------------------------------------------- **" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue

    $paddedVersion = $DisplayVersion.PadRight(14)
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "                       Tool Version: $paddedVersion                    " -NoNewline -ForegroundColor Yellow -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue

    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue
    $authorText =  "           Author: Marcin Grygiel / GitHub.com/FirstEverTech           "
    $padding = [math]::Floor((69 - $authorText.Length) / 2)
    $spaces = " " * [math]::Max(0, $padding)
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "$spaces$authorText$spaces" -NoNewline -ForegroundColor Green -BackgroundColor DarkBlue
    # Adjust length – if the text does not reach the end, padding with spaces to 69 characters (internal width)
    $totalLength = $spaces.Length + $authorText.Length + $spaces.Length
    if ($totalLength -lt 69) {
        Write-Host (" " * (69 - $totalLength)) -NoNewline -ForegroundColor Green -BackgroundColor DarkBlue
    }
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue

    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "           This tool is not affiliated with Intel Corporation.         " -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "           INF files are sourced from official Intel servers.          " -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "           Use at your own risk.                                       " -NoNewline -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "**                                                                       **" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host "*************************************************************************/" -ForegroundColor Gray -BackgroundColor DarkBlue
    Write-Host ""

    Write-Host " THANK YOU FOR USING UNIVERSAL INTEL CHIPSET DEVICE UPDATER" -ForegroundColor Cyan
    Write-Host " ==========================================================" -ForegroundColor Cyan
    Write-Host ""
    Write-Host " I hope this tool has been helpful in updating your system." -ForegroundColor Yellow
    Write-Host ""

    # --- Dictionary to store key -> URL mappings ---
    $keyActions = @{}

    # --- Load ad links from intel-chipset-infs-ads.txt (A-E keys) ---
    # File format (one per line):  A = https://...
    # Missing or empty value means that key behaves as Exit.
    $cacheBuster = "?t=$(Get-Date -Format 'yyyyMMddHHmmss')"
    try {
        $adsContent = Invoke-WebRequest -Uri ($adsUrl + $cacheBuster) -UseBasicParsing -ErrorAction Stop
        foreach ($adLine in ($adsContent.Content -split "`r?`n")) {
            if ($adLine -match '^\s*([A-Ea-e])\s*=\s*(https?://\S+)\s*$') {
                $adKey = $matches[1].ToUpper()
                $keyActions[$adKey]              = $matches[2]
                $keyActions[$adKey.ToLower()]    = $matches[2]
            }
        }
    } catch {
        # Ads file unavailable - A-E keys will simply exit (no action registered)
    }

    # --- Load credits message (intel-chipset-infs-credits.txt).
    #     Old versions of this updater load intel-chipset-infs-message.txt instead;
    #     that file is left unchanged for backward compatibility.
    try {
        $content = Invoke-WebRequest -Uri ($creditsMessageUrl + $cacheBuster) -UseBasicParsing -ErrorAction Stop
        $lines = $content.Content -split "`r?`n"
    } catch {
        # Fallback embedded credits
        $lines = @(
            "[Magenta]",
            "[Magenta] SUPPORT THIS PROJECT",
            "[Magenta] ====================",
            "",
            " This project is maintained in my free time.",
            " Your support ensures regular updates and compatibility.",
            "",
            " Support options:",
            "",
            "[Green] - Support Patreon:[Yellow] tinyurl.com/fet-patron[Gray] - press [Black,Gray][1][Gray,Black] key",
            "[Green] - Support PayPal: [Yellow] tinyurl.com/fet-paypal[Gray] - press [Black,Gray][2][Gray,Black] key",
            "[Green] - Support Coffee: [Yellow] tinyurl.com/fet-coffee[Gray] - press [Black,Gray][3][Gray,Black] key",
            "[Green] - Support Ko-Fi:  [Yellow] tinyurl.com/fet-mykofi[Gray] - press [Black,Gray][4][Gray,Black] key",
            "[Green] - Support GitHub: [Yellow] tinyurl.com/fet-github[Gray] - press [Black,Gray][5][Gray,Black] key",
            "",
            " If this project helped you, please consider:",
            "",
            "[Green] - Giving it a STAR on GitHub",
            "[Green] - Sharing with friends and colleagues",
            "[Green] - Reporting issues or suggesting features",
            "[Green] - Supporting development financially",
            "",
            "[Magenta]",
            "[Magenta] CAREER OPPORTUNITY",
            "[Magenta] ==================",
            "",
            " I'm currently seeking new challenges where I can apply my expertise",
            " in solving complex IT infrastructure problems. If your organization",
            " struggles with system compatibility, automation, or tooling gaps,",
            " let's discuss how I can help.",
            "",
            " I specialize in Windows deployment, driver automation, hardware",
            " compatibility, infrastructure analysis, and custom IT tooling.",
            "",
            "[Green] - Connect with me:[Yellow] linkedin.com/in/marcin-grygiel[Gray] - press [Black,Gray][L][Gray,Black] key"
        )
    }

    # Display each line and collect key/URL information
    foreach ($line in $lines) {
        Write-ColorLine $line

        $keyInfo = Get-KeyAndUrlFromLine -Line $line
        if ($keyInfo) {
            if ($keyInfo.Key -match '[a-zA-Z]') {
                $keyActions[$keyInfo.Key.ToUpper()] = $keyInfo.Url
                $keyActions[$keyInfo.Key.ToLower()] = $keyInfo.Url
            } else {
                $keyActions[$keyInfo.Key] = $keyInfo.Url
            }
        }
    }

    # --- Handle key press ---
    if ($AutoMode) {
        return
    } else {
        Write-Host "`n Press " -NoNewline -ForegroundColor Gray
        Write-Host "1" -NoNewline -ForegroundColor Yellow
        Write-Host "=Patreon, " -NoNewline -ForegroundColor Gray
        Write-Host "2" -NoNewline -ForegroundColor Yellow
        Write-Host "=PayPal, " -NoNewline -ForegroundColor Gray
        Write-Host "3" -NoNewline -ForegroundColor Yellow
        Write-Host "=Coffee, " -NoNewline -ForegroundColor Gray
        Write-Host "4" -NoNewline -ForegroundColor Yellow
        Write-Host "=Ko-Fi, " -NoNewline -ForegroundColor Gray
        Write-Host "5" -NoNewline -ForegroundColor Yellow
        Write-Host "=GitHub, other key = Exit." -ForegroundColor Gray

        $key = $host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")
        $pressed = $key.Character.ToString()

        if ($keyActions.ContainsKey($pressed) -and $keyActions[$pressed]) {
            $url = $keyActions[$pressed]
            Start-Process $url
            if (-not $isSFX) { Clear-Host; Write-Host "`n Thank you for using Universal Intel Chipset Device Updater!`n" -ForegroundColor Cyan }
            exit
        } else {
            if (-not $isSFX) { Clear-Host; Write-Host "`n Thank you for using Universal Intel Chipset Device Updater!`n" -ForegroundColor Cyan }
            exit
        }
    }
}

# =============================================
# CLEANUP FUNCTION
# =============================================

function Cleanup {
    Write-Host "`n Cleaning up temporary files..." -ForegroundColor Yellow
    if (Test-Path $tempDir) {
        try {
            Get-ChildItem -Path $tempDir -Exclude "*.ps1" -Recurse | Remove-Item -Force -Recurse -ErrorAction Stop
            Write-Host " Temporary files cleaned successfully." -ForegroundColor Green
        } catch {
            Write-Host " Warning: Could not clean all temporary files." -ForegroundColor Yellow
        }
    }
}

# =============================================
# MAIN SCRIPT EXECUTION
# =============================================

try {
    Show-Screen1

    Write-Host ""
    if (-not (Verify-ScriptHash)) {
        Write-Host " Update process aborted for security reasons." -ForegroundColor Red
        Cleanup
        if (-not $AutoMode) {
            Write-Host "`n Press any key..."
            $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
        }
        Show-FinalCredits
        exit 1
    }

    $updateCheckResult = Check-ForUpdaterUpdates
    if (-not $updateCheckResult) {
        exit 100
    }

    Clear-TempINFFolders
    New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
    Write-DebugMessage "Created temporary directory: $tempDir"

    Show-Screen2

    $detectedIntelChipsets = Get-IntelChipsetHWIDs

    if ($detectedIntelChipsets.Count -eq 0) {
        Write-Host " No Intel devices found." -ForegroundColor Yellow
        Write-Host " If you have an Intel platform, make sure you have at least" -ForegroundColor Yellow
        Write-Host " SandyBridge or newer platform." -ForegroundColor Yellow
        Cleanup
        # After summary, wait for user to acknowledge (unless auto mode)
        if (-not $AutoMode) {
            Write-Host "`n Press any key to continue to the credits screen..." -NoNewline
            $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
            Write-Host ""  # move to next line
        }
        Show-FinalCredits
        exit
    }

    Write-Host " Found $($detectedIntelChipsets.Count) Intel device(s)" -ForegroundColor Green

    if ($DebugMode) {
        Write-Host "`n === DEBUG INFORMATION ===" -ForegroundColor Cyan
        Write-Host " Checking versions for detected devices:" -ForegroundColor Gray
        foreach ($device in $detectedIntelChipsets) {
            $currentVersion = Get-CurrentINFVersion -Device $device.PnpDeviceObject
            Write-Host " Device: $($device.Description)" -ForegroundColor Gray
            Write-Host "   HWID: $($device.HWID) | Version: $currentVersion" -ForegroundColor Gray
        }
        Write-Host " === END DEBUG ===`n" -ForegroundColor Cyan
    }

    Write-Host " INF database download & hardware matching in progress... " -ForegroundColor Yellow -NoNewline
    Write-Host "(up to 1 minute)" -ForegroundColor Gray
    $chipsetInfo = Get-LatestINFInfo -Url $chipsetINFsUrl
    $downloadListInfo = Get-LatestINFInfo -Url $downloadListUrl

    if (-not $chipsetInfo -or -not $downloadListInfo) {
        Write-Host " Failed to download INF information. Exiting." -ForegroundColor Red
        Cleanup
        if (-not $AutoMode) {
            Write-Host "`n Press any key..."
            $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
        }
        Show-FinalCredits
        exit
    }

    $chipsetData = Parse-ChipsetINFsFromMarkdown -MarkdownContent $chipsetInfo
    $downloadData = Parse-DownloadList -DownloadListContent $downloadListInfo

    if ($chipsetData.Count -eq 0 -or $downloadData.Count -eq 0) {
        Write-Host " Error: Could not parse INF information." -ForegroundColor Red
        Write-Host " Please check the format of markdown and download list files." -ForegroundColor Yellow
        Cleanup
        if (-not $AutoMode) {
            Write-Host "`n Press any key..."
            $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
        }
        Show-FinalCredits
        exit
    }

    $matchingChipsets = @()
    $chipsetUpdateAvailable = $false
    $windowsInboxPlatformsFound = @()

    # First pass: collect all matches without printing
    foreach ($device in $detectedIntelChipsets) {
        $hwId = $device.HWID
        if ($chipsetData.ContainsKey($hwId)) {
            $chipsetInfo = $chipsetData[$hwId]
            if ($chipsetInfo.IsWindowsInbox) {
                $windowsInboxPlatformsFound += @{
                    HWID        = $hwId
                    Description = $device.Description
                    Platform    = $chipsetInfo.Platform
                    Generation  = $chipsetInfo.Generation
                    Version     = $chipsetInfo.Version
                }
                continue
            }
            $currentVersion = Get-CurrentINFVersion -Device $device.PnpDeviceObject
            $matchingChipsets += @{
                Device         = $device
                ChipsetInfo    = $chipsetInfo
                CurrentVersion = $currentVersion
                HardwareID     = $device.HardwareID
                InstanceId     = $device.InstanceId
            }
        }
    }

    # Display grouped Windows Inbox platforms (compact)
    if ($windowsInboxPlatformsFound.Count -gt 0) {
        Write-Host "`n Windows Inbox Drivers detected (no installation required):" -ForegroundColor Cyan
        $inboxGrouped = $windowsInboxPlatformsFound | Group-Object Platform
        foreach ($group in $inboxGrouped) {
            $hwids = ($group.Group | ForEach-Object { $_.HWID }) -join ', '
            Write-Host " - $($group.Name) (HWID: $hwids)" -ForegroundColor Gray
            Write-Host "   Generation: $($group.Group[0].Generation)" -ForegroundColor DarkGray
            Write-Host "   Version: $($group.Group[0].Version)" -ForegroundColor DarkGray
        }
        # Removed extra Write-Host ""
    }

    # Display grouped compatible platforms, HWIDs wrapped at 12 per line for readability
    if ($matchingChipsets.Count -gt 0) {
        Write-Host "`n Found compatible device(s)" -ForegroundColor Green
        $groupedMatches = $matchingChipsets | Group-Object { $_.ChipsetInfo.Platform }
        foreach ($group in $groupedMatches) {
            $hwidList = $group.Group | ForEach-Object { $_.Device.HWID }
            Write-Host " - $($group.Name) devices (HWID):" -ForegroundColor Yellow

            $chunkSize = 12
            for ($i = 0; $i -lt $hwidList.Count; $i += $chunkSize) {
                $chunkEnd = [Math]::Min($i + $chunkSize - 1, $hwidList.Count - 1)
                $chunk = $hwidList[$i..$chunkEnd]
                $isLastChunk = ($i + $chunkSize) -ge $hwidList.Count
                $trailingComma = if ($isLastChunk) { "" } else { "," }
                Write-Host "   $($chunk -join ', ')$trailingComma" -ForegroundColor White
            }
            Write-Host ""
        }
    }

    # Build unique platform+package entries.
    # A platform can now have TWO packages: one EOL (older, for legacy HWIDs dropped
    # from the latest package) and one main (latest). Both are tracked separately so
    # both get installed - EOL first, then main (confirmed safe on X79 testing:
    # no restart needed between installers, main does not overwrite EOL HWID entries
    # because the latest INF simply has no entry for those legacy IDs).
    $uniquePlatforms = @{}   # key = "Platform::Package" to allow multiple packages per platform
    $platformHasEOL  = @{}   # key = Platform, value = $true if any EOL device detected

    foreach ($match in $matchingChipsets) {
        $platform  = $match.ChipsetInfo.Platform
        $package   = $match.ChipsetInfo.Package
        $isEOL     = $match.ChipsetInfo.IsEOL
        $entryKey  = "$platform::$package"

        if (-not $uniquePlatforms.ContainsKey($entryKey)) {
            $uniquePlatforms[$entryKey] = @{
                ChipsetInfo     = $match.ChipsetInfo
                Devices         = @($match.Device)
                CurrentVersions = @()
                IsEOL           = $isEOL
            }
        } else {
            $uniquePlatforms[$entryKey].Devices += $match.Device
        }

        if ($isEOL) { $platformHasEOL[$platform] = $true }

        if ($match.CurrentVersion) {
            $uniquePlatforms[$entryKey].CurrentVersions += $match.CurrentVersion
        }
    }

    # For platforms where EOL devices were detected, also ensure the main (latest)
    # package entry exists so it gets installed after the EOL one.
    # (It will already exist if any non-EOL HWID of that platform was also detected.)
    # No extra action needed - if a platform has only EOL devices detected, only the
    # EOL package will be installed; the main package is only installed when at least
    # one of its own HWIDs was actually found in the system.

    Write-DebugMessage "uniquePlatforms count: $($uniquePlatforms.Count)"
    Start-Sleep -Seconds 2
    Write-DebugMessage "Now displaying platform information..."

    Write-Host " =============== Platform Information ===============" -ForegroundColor Cyan
    Write-Host ""

    $hasAnyAsterisk = $false
    $hasNewerWindowsInbox = $false

    foreach ($entryKey in $uniquePlatforms.Keys) {
        Write-DebugMessage "Displaying platform entry: $entryKey"

        $platformData    = $uniquePlatforms[$entryKey]
        $chipsetInfo     = $platformData.ChipsetInfo
        $devices         = $platformData.Devices
        $currentVersions = $platformData.CurrentVersions | Sort-Object -Unique
        $platformName    = $chipsetInfo.Platform
        $eolLabel        = if ($platformData.IsEOL) { " [EOL]" } else { "" }

        # Platform name (white) with generation after slash (cyan)
        Write-Host " Platform: $platformName$eolLabel" -ForegroundColor White -NoNewline
        if ($chipsetInfo.Generation) {
            Write-Host " / $($chipsetInfo.Generation)" -ForegroundColor Cyan
        } else {
            Write-Host ""
        }

        # Installer version line (gray)
        $installerVersionDisplay = "$($chipsetInfo.Package) ($($chipsetInfo.Date))"
        Write-Host "  Latest Intel Chipset INF Utility: $installerVersionDisplay" -ForegroundColor Gray

        # Status line
        $needsUpdate = $false
        $newerVersionDetected = $false
        $currentVersionsText = if ($currentVersions.Count -gt 0) { $currentVersions -join ', ' } else { "Unable to determine" }

        if ($currentVersions.Count -gt 0) {
            foreach ($currentVersion in $currentVersions) {
                try {
                    $currentVer = [version]$currentVersion
                    $latestVer = [version]$chipsetInfo.Version
                    if ($currentVer -gt $latestVer) {
                        $newerVersionDetected = $true
                        break
                    } elseif ($currentVer -ne $latestVer) {
                        $needsUpdate = $true
                        break
                    }
                } catch {
                    Write-DebugMessage "Version parsing failed for comparison: Current=$currentVersion, Latest=$($chipsetInfo.Version)"
                    if ($currentVersion -ne $chipsetInfo.Version) {
                        $needsUpdate = $true
                        break
                    }
                }
            }
        } else {
            $needsUpdate = $true
        }

        if ($newerVersionDetected) {
            $statusText = "Inbox / newer detected"
            $statusColor = "Magenta"
            $hasNewerWindowsInbox = $true
        } elseif ($needsUpdate) {
            $statusText = "Update available"
            $statusColor = "Yellow"
            $chipsetUpdateAvailable = $true
        } else {
            $statusText = "Latest version"
            $statusColor = "Green"
        }

        Write-Host "  Detected INF: $currentVersionsText -> Latest INF: $($chipsetInfo.Version) -> $statusText" -ForegroundColor $statusColor
        Write-Host ""

        if ($chipsetInfo.HasAsterisk) {
            $hasAnyAsterisk = $true
        }
    }

    if ($hasAnyAsterisk) {
        Write-Host " Note: INF files marked with (*) use the symbolic date 18/07/1968" -ForegroundColor Yellow
        Write-Host "       (Intel's founding date), which appears in the system." -ForegroundColor Yellow
        Write-Host "       The shown date is derived from the .cat file signature timestamp." -ForegroundColor Yellow
        Write-Host ""
    }

    if ($hasNewerWindowsInbox) {
        Write-Host " Note: This INF file was installed via Windows Update" -ForegroundColor Yellow
        Write-Host "       and is not yet included in any Intel package." -ForegroundColor Yellow
        Write-Host "       Installing an older INF version is not recommended." -ForegroundColor Yellow
        Write-Host ""
    }

    if ($chipsetUpdateAvailable) {
        Write-Host " A newer version of the INF files is available." -ForegroundColor Green
        Write-Host ""
        if ($AutoMode) {
            $response = "Y"
            Write-Host " Auto mode: automatically installing (Y)." -ForegroundColor Cyan
        } else {
            $response = Read-Host " Do you want to install the latest INF files? (Y/N)"
        }
        if ($response -ne "Y" -and $response -ne "y") {
            Write-Host "`n Installation cancelled." -ForegroundColor Yellow
            Cleanup
            if (-not $AutoMode) {
                Write-Host "`n Press any key..."
                $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
            }
            Show-FinalCredits
            exit
        }
    } else {
        if ($uniquePlatforms.Count -gt 0) {
            if ($hasNewerWindowsInbox) {
                Write-Host " Some platforms have newer INF versions (Windows Inbox) than available" -ForegroundColor Cyan
                Write-Host " in Intel packages. Installing an older INF version is not recommended." -ForegroundColor Cyan
                Write-Host ""
            } else {
                Write-Host " All platforms are up to date." -ForegroundColor Green
                Write-Host ""
            }

            if ($AutoMode) {
                $response = "Y"
                Write-Host " Auto mode: automatically forcing reinstall (Y)." -ForegroundColor Cyan
            } else {
                $response = Read-Host " Do you want to force reinstall this INF files anyway? (Y/N)"
            }
            if ($response -eq "Y" -or $response -eq "y") {
                $chipsetUpdateAvailable = $true
            } else {
                Write-Host "`n Installation cancelled." -ForegroundColor Yellow
                Cleanup
                if (-not $AutoMode) {
                    Write-Host "`n Press any key..."
                    $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
                }
                Show-FinalCredits
                exit
            }
        }
    }

    $response = Show-Screen3

    if ($chipsetUpdateAvailable -and ($response -eq "Y" -or $response -eq "y")) {
        Write-Host "`n Starting INF files update process..." -ForegroundColor Green

        Write-Host " Creating system restore point..." -ForegroundColor Yellow

        $restorePointCreated = $false
        $restorePointDescription = "Before Intel Chipset INF Update - $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"

        try {
            try {
                $null = Enable-ComputerRestore -Drive "C:\" -ErrorAction SilentlyContinue
            } catch {
                Write-DebugMessage "System restore might already be enabled or not available: $($_.Exception.Message)"
            }

            $warningMessages = @()
            Checkpoint-Computer -Description $restorePointDescription -RestorePointType "MODIFY_SETTINGS" -WarningVariable warningMessages -WarningAction SilentlyContinue -ErrorAction Stop

            if ($warningMessages.Count -gt 0) {
                $warningText = $warningMessages -join " "
                if ($warningText -match "1440 minutes" -or $warningText -match "past.*minutes") {
                    throw "RestorePointFrequencyLimit"
                }
            }

            $restorePointCreated = $true
            Write-Host " System restore point created successfully: " -ForegroundColor Green
            Write-Host " '$restorePointDescription'" -ForegroundColor Green
            Write-DebugMessage "System restore point created: $restorePointDescription"

            Write-Host "`n Preparing for installation..." -ForegroundColor Yellow
            Start-Sleep -Seconds 5
        } catch {
            $errorMessage = $_.Exception.Message

            if ($errorMessage -match "RestorePointFrequencyLimit" -or $errorMessage -match "1440 minutes" -or $errorMessage -match "past.*minutes") {
                Write-Log "Failed to create system restore point." -Type "ERROR"
                Write-Host "`n IMPORTANT NOTICE:" -ForegroundColor Yellow
                Write-Host " Another restore point was created within the last 24 hours." -ForegroundColor Yellow
                Write-Host " Windows currently cannot create more restore points." -ForegroundColor Yellow
                Write-Host " You can delete existing restore points or retry the installation later." -ForegroundColor Yellow
                Write-Host ""

                if ($AutoMode) {
                    $continueResponse = "Y"
                    Write-Host " Auto mode: automatically continuing without restore point (Y)." -ForegroundColor Cyan
                } else {
                    $continueResponse = Read-Host " Do you want to continue without creating a restore point? (Y/N)"
                }
                if ($continueResponse -ne "Y" -and $continueResponse -ne "y") {
                    Write-Host "`n Installation cancelled." -ForegroundColor Yellow
                    Cleanup
                    if (-not $AutoMode) {
                        Write-Host "`n Press any key..."
                        $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
                    }
                    Show-FinalCredits
                    exit
                }
            } else {
                Write-Log "Failed to create system restore point." -Type "ERROR"
                Write-Host " WARNING: Could not create system restore point. Continuing anyway..." -ForegroundColor Yellow
                Write-Host " If the update causes issues, you may not be able to easily revert the changes." -ForegroundColor Yellow
            }

            Write-Host "`n Preparing for installation..." -ForegroundColor Gray
            Start-Sleep -Seconds 5
        }

        Show-Screen4

        $packageGroups = @{}
        foreach ($entryKey in $uniquePlatforms.Keys) {
            $platformData    = $uniquePlatforms[$entryKey]
            $packageVersion  = $platformData.ChipsetInfo.Package
            $platformName    = $platformData.ChipsetInfo.Platform

            if (-not $packageGroups.ContainsKey($packageVersion)) {
                $packageGroups[$packageVersion] = @{
                    Platforms = @()
                    IsEOL     = $platformData.IsEOL
                }
            }
            $packageGroups[$packageVersion].Platforms += $platformName
        }

        # Sort ASCENDING - EOL (older) packages install first, main (latest) installs last.
        # This matches confirmed X79 test behaviour: no restart needed between installers,
        # and the later (newer) installer does not touch legacy HWIDs it no longer lists.
        $sortedPackages = $packageGroups.Keys | Sort-Object { [version]($_ -replace '\s*\(S\)\s*', '') }
        Write-DebugMessage "Package groups: $($packageGroups.Count) unique packages"

        $successCount = 0
        $processedPackages = @{}

        foreach ($packageVersion in $sortedPackages) {
            $pkgData  = $packageGroups[$packageVersion]
            $platforms = $pkgData.Platforms
            $eolLabel  = if ($pkgData.IsEOL) { " [EOL - legacy devices]" } else { "" }
            Write-Host " Package $packageVersion$eolLabel for platforms:" -ForegroundColor Cyan
            Write-Host " " -NoNewline
            Write-Host "$($platforms -join ', ')"

            Write-DebugMessage "Processing package: $packageVersion for platforms: $($platforms -join ', ')"

            $variant = "Consumer"
            if ($packageVersion -match '\(S\)$') {
                $variant = "Server"
            }
            Write-DebugMessage "Determined variant: $variant"

            $cleanPackageVersion = $packageVersion -replace '\s*\(S\)\s*', ''
            $downloadKey = "$cleanPackageVersion-$variant"
            Write-DebugMessage "Looking for download key: $downloadKey"

            if ($downloadData.ContainsKey($downloadKey)) {
                $downloadInfo = $downloadData[$downloadKey]
                $driverPath = "$tempDir\$cleanPackageVersion-$variant"

                $downloadSuccess = $false
                $usedBackup = $false
                $errorPhase = $null

                Write-Host "`n Attempting download from primary source..." -ForegroundColor Yellow
                $primaryResult = Download-Extract-File -Url $downloadInfo.Link -OutputPath $driverPath -Prefix $downloadInfo.Prefix -ExpectedHash $downloadInfo.SHA256 -SourceName "Primary"

                if ($primaryResult.Success) {
                    $downloadSuccess = $true
                    Write-Host " SUCCESS: Primary source - download and hash verification successful." -ForegroundColor Green
                } else {
                    if ($primaryResult.ErrorType -eq "DownloadFailed") {
                        Write-Host " FAILED: Primary source - download failed." -ForegroundColor Red
                        $errorPhase = "1a"
                    } elseif ($primaryResult.ErrorType -eq "HashMismatch") {
                        $errorPhase = "1b"
                    } else {
                        Write-Host " FAILED: Primary source - unexpected error." -ForegroundColor Red
                        $errorPhase = "1x"
                    }

                    if ($downloadInfo.Backup) {
                        Write-Host " Attempting download from backup source..." -ForegroundColor Yellow
                        $backupPrefix = $downloadInfo.Prefix
                        $backupHash = $downloadInfo.SHA256

                        $backupResult = Download-Extract-File -Url $downloadInfo.Backup -OutputPath $driverPath -Prefix $backupPrefix -ExpectedHash $backupHash -SourceName "Backup"

                        if ($backupResult.Success) {
                            $downloadSuccess = $true
                            $usedBackup = $true
                            Write-Host " SUCCESS: Backup source - download and hash verification successful." -ForegroundColor Green
                        } else {
                            if ($backupResult.ErrorType -eq "DownloadFailed") {
                                Write-Host " FAILED: Backup source - download failed." -ForegroundColor Red
                                $errorPhase = "2a"
                            } elseif ($backupResult.ErrorType -eq "HashMismatch") {
                                $errorPhase = "2b"
                            } else {
                                Write-Host " FAILED: Backup source - unexpected error." -ForegroundColor Red
                                $errorPhase = "2x"
                            }
                        }
                    } else {
                        Write-Host " No backup source available" -ForegroundColor Red
                    }
                }

                if (-not $downloadSuccess) {
                    switch ($errorPhase) {
                        "1a" {
                            Write-Host "`n ERROR: Primary source download failed and no backup available." -ForegroundColor Red
                            Write-Host " Check your internet connection or the primary URL." -ForegroundColor Yellow
                        }
                        "1b" {
                            Write-Host "`n ERROR: Primary source file corrupted (hash mismatch) and no backup available" -ForegroundColor Red
                            Write-Host " The downloaded file may be tampered or incomplete." -ForegroundColor Yellow
                        }
                        "2a" {
                            Write-Host "`n ERROR: Both primary and backup sources download failed." -ForegroundColor Red
                            Write-Host " Check your internet connection and URL availability." -ForegroundColor Yellow
                        }
                        "2b" {
                            Write-Host "`n ERROR: Both primary and backup sources have hash mismatches" -ForegroundColor Red
                            Write-Host " Files may be corrupted on both servers." -ForegroundColor Yellow
                        }
                        default {
                            Write-Host "`n ERROR: Unknown download error" -ForegroundColor Red
                        }
                    }
                    continue
                }

                if (Install-ChipsetINF -INFPath $driverPath -Prefix $downloadInfo.Prefix) {
                    $successCount++
                    $processedPackages[$cleanPackageVersion] = $true
                    Write-Host " Successfully installed package $cleanPackageVersion for $($platforms.Count) platform(s)." -ForegroundColor Green
                    Write-DebugMessage "Installation successful for package: $cleanPackageVersion"
                } else {
                    Write-Host " Failed to install INF files." -ForegroundColor Red
                    Write-DebugMessage "Installation failed for package: $cleanPackageVersion"
                }
            } else {
                Write-Host " Error: Download information not found for package version $cleanPackageVersion (variant: $variant)" -ForegroundColor Red
                Write-Host " Please check intel_chipset_infs_download.txt for missing entries." -ForegroundColor Yellow
                Write-DebugMessage "Download key not found: $downloadKey"
            }
        }

        if ($successCount -gt 0) {
            Write-Host "`n IMPORTANT NOTICE:" -ForegroundColor Yellow
            Write-Host " Computer restart is required to complete INF installation!" -ForegroundColor Yellow

            Write-Host "`n Summary: Installed $successCount unique package(s) for all detected platforms." -ForegroundColor Green
            Write-DebugMessage "Installation summary: $successCount successful packages."
        } else {
            Write-Host "`n No INF files were successfully installed." -ForegroundColor Red
            Write-DebugMessage "No packages were successfully installed."
        }
    } else {
        Write-Host "`n Update cancelled." -ForegroundColor Yellow
        Write-DebugMessage "User cancelled the update."
    }

    Cleanup

    Show-FinalSummary

    Write-Host "`n INF files update process completed." -ForegroundColor Cyan
    Write-Host " If you have any issues with this tool, please report them at:"
    Write-Host " https://github.com/FirstEverTech/Universal-Intel-Chipset-Updater" -ForegroundColor Cyan

    if ($DebugMode) {
        Write-Host "`n [DEBUG MODE ENABLED - All debug messages were shown]" -ForegroundColor Magenta
    }

    if (-not $AutoMode) {
        Write-Host "`n Press any key to continue..." -ForegroundColor Gray
        $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
    }

    # Show credits
    Show-FinalCredits
    exit 0
} catch {
    Write-Log "Unhandled error in main execution: $($_.Exception.Message)" -Type "ERROR"
    Write-Host " An unexpected error occurred. Please check the log file at $logFile for details." -ForegroundColor Red
    Cleanup
    if (-not $AutoMode) {
        Write-Host "`n Press any key..."
        $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
    }
    Show-FinalCredits
    exit 1
}