microsoft/hve-core

#!/usr/bin/env pwsh
# Copyright (c) Microsoft Corporation.
# SPDX-License-Identifier: MIT
#
# Invoke-LinkLanguageCheck.ps1
#
# Purpose: Wrapper for Link-Lang-Check.ps1 with GitHub Actions integration
# Author: HVE Core Team

#Requires -Version 7.0

[CmdletBinding()]
param(
    [string[]]$ExcludePaths = @()
)

$ErrorActionPreference = 'Stop'

# Import shared helpers
Import-Module (Join-Path $PSScriptRoot "Modules/LintingHelpers.psm1") -Force
Import-Module (Join-Path $PSScriptRoot "../lib/Modules/CIHelpers.psm1") -Force

function Invoke-LinkLanguageCheckCore {
    [CmdletBinding()]
    param(
        [string[]]$ExcludePaths = @()
    )

    $repoRoot = git rev-parse --show-toplevel 2>$null
    if ($LASTEXITCODE -ne 0) {
        Write-Error "Not in a git repository"
        return 1
    }

    $logsDir = Join-Path $repoRoot "logs"
    if (-not (Test-Path $logsDir)) {
        New-Item -ItemType Directory -Path $logsDir -Force | Out-Null
    }

    Write-Host "🔍 Checking for URLs with language paths..." -ForegroundColor Cyan

    try {
        $scriptArgs = @{}
        if ($ExcludePaths.Count -gt 0) {
            $scriptArgs['ExcludePaths'] = $ExcludePaths
        }
        $jsonOutput = & (Join-Path $PSScriptRoot "Link-Lang-Check.ps1") @scriptArgs 2>&1

        $results = $jsonOutput | ConvertFrom-Json

        if ($results -and $results.Count -gt 0) {
            Write-Host "Found $($results.Count) URLs with 'en-us' language paths`n" -ForegroundColor Yellow

            $fileGroups = $results | Group-Object -Property file
            $uniqueFiles = $fileGroups | ForEach-Object { $_.Name }

            foreach ($fileGroup in $fileGroups) {
                Write-Host "📄 $($fileGroup.Name)" -ForegroundColor Cyan
                foreach ($item in $fileGroup.Group) {
                    Write-Host "  ⚠️ Line $($item.line_number): $($item.original_url)" -ForegroundColor Yellow
                }
            }

            foreach ($item in $results) {
                Write-CIAnnotation `
                    -Message "URL contains language path: $($item.original_url)" `
                    -Level Warning `
                    -File $item.file `
                    -Line $item.line_number
            }

            $outputData = @{
                timestamp = (Get-Date).ToUniversalTime().ToString("o")
                script = "link-lang-check"
                summary = @{
                    total_issues = $results.Count
                    files_affected = $uniqueFiles.Count
                }
                issues = $results
            }
            $outputData | ConvertTo-Json -Depth 3 | Out-File (Join-Path $logsDir "link-lang-check-results.json") -Encoding utf8

            Set-CIOutput -Name "issues" -Value $results.Count
            Set-CIEnv -Name "LINK_LANG_FAILED" -Value "true"

            Write-CIStepSummary -Content @"
## Link Language Path Check Results

⚠️ **Status**: Issues Found

Found $($results.Count) URL(s) containing language path 'en-us'.

**Why this matters:**
Language-specific URLs don't adapt to user preferences and may break for non-English users.

**To fix locally:**
``````powershell
scripts/linting/Link-Lang-Check.ps1 -Fix
``````

**Files affected:**
$(($uniqueFiles | ForEach-Object { 
    $count = ($results | Where-Object file -eq $_).Count
    $safePath = if ((Get-CIPlatform) -eq 'azdo') {
        ConvertTo-AzureDevOpsEscaped -Value $_
    } else { $_ }
    "- $safePath ($count occurrence(s))"
}) -join "`n")
"@

            Write-Host "❌ Link language check failed with $($results.Count) issue(s) in $($uniqueFiles.Count) file(s)." -ForegroundColor Red

            return 1
        }

        Write-Host "✅ No URLs with language paths found" -ForegroundColor Green

        $emptyResults = @{
            timestamp = (Get-Date).ToUniversalTime().ToString("o")
            script = "link-lang-check"
            summary = @{
                total_issues = 0
                files_affected = 0
            }
            issues = @()
        }
        $emptyResults | ConvertTo-Json -Depth 3 | Out-File (Join-Path $logsDir "link-lang-check-results.json") -Encoding utf8

        Set-CIOutput -Name "issues" -Value "0"

        Write-CIStepSummary -Content @"
## Link Language Path Check Results

✅ **Status**: Passed

No URLs with language-specific paths detected.
"@

        return 0
    }
    catch {
        Write-Error -ErrorAction Continue "Link-language check failed: $($_.Exception.Message)"
        Write-CIAnnotation -Message "Link-language check failed: $($_.Exception.Message)" -Level Error
        return 1
    }
}

#region Main Execution
if ($MyInvocation.InvocationName -ne '.') {
    try {
        $exitCode = Invoke-LinkLanguageCheckCore -ExcludePaths $ExcludePaths
        exit $exitCode
    }
    catch {
        Write-Error -ErrorAction Continue "Invoke-LinkLanguageCheck failed: $($_.Exception.Message)"
        Write-CIAnnotation -Message $_.Exception.Message -Level Error
        exit 1
    }
}
#endregion Main Execution