Add Azure DevOps logging commands for improved pipeline log readability

- Use ##vso[section] for main sections
- Use ##vso[task.logissue type=warning] for important decisions
- Use ##vso[task.logissue type=debug] for informational messages
- Use ##vso[group] for collapsible file lists
- Improved visual hierarchy and color coding in Azure Pipelines logs

Co-authored-by: johlju <[email protected]>

Author: Copilot

.build/Test-ShouldRunDscResourceIntegrationTests.ps1

@@ -78,7 +78,7 @@ function Get-PublicCommandsUsedByDscResources
 
     if (-not $publicCommandNames)
     {
-        Write-Warning -Message "No public commands found in $SourcePath/Public"
+        Write-Host "##vso[task.logissue type=warning]No public commands found in $SourcePath/Public"
         return @()
     }
 
@@ -194,12 +194,12 @@ function Get-ChangedFiles
             }
         }
 
-        Write-Warning -Message "Failed to get git diff between $From and $To. Exit code: $LASTEXITCODE. Output: $gitDiffOutput"
+        Write-Host "##vso[task.logissue type=warning]Failed to get git diff between $From and $To. Exit code: $LASTEXITCODE. Output: $gitDiffOutput"
         return @()
     }
     catch
     {
-        Write-Warning -Message "Error getting changed files: $_"
+        Write-Host "##vso[task.logissue type=warning]Error getting changed files: $_"
         return @()
     }
 }
@@ -379,35 +379,36 @@ function Test-ShouldRunDscResourceIntegrationTests
         $SourcePath = 'source'
     )
 
+    Write-Host "##vso[section]Analyzing DSC Resource Integration Test Requirements"
     Write-Host "Analyzing changes between $BaseBranch and $CurrentBranch..."
     Write-Host ""
 
     # Get list of public commands used by DSC resources dynamically
     $PublicCommandsUsedByDscResources = Get-PublicCommandsUsedByDscResources -SourcePath $SourcePath
-    Write-Host "Discovered $($PublicCommandsUsedByDscResources.Count) public commands used by DSC resources and classes."
+    Write-Host "##vso[task.logissue type=debug]Discovered $($PublicCommandsUsedByDscResources.Count) public commands used by DSC resources and classes."
     Write-Host ""
 
     $changedFiles = Get-ChangedFiles -From $BaseBranch -To $CurrentBranch
 
     if (-not $changedFiles)
     {
-        Write-Host "No changed files detected. DSC resource integration tests will run by default."
+        Write-Host "##vso[task.logissue type=warning]No changed files detected. DSC resource integration tests will run by default."
         Write-Host ""
         return $true
     }
 
-    Write-Host "Changed files:"
+    Write-Host "##vso[group]Changed Files"
     $changedFiles | ForEach-Object -Process { Write-Host "  $_" }
-    Write-Host ""
+    Write-Host "##vso[task.logdetail id=1;progress=100;state=Completed]"
 
     # Check if any DSC resources are directly changed
     $changedDscResources = $changedFiles | Where-Object -FilterScript { $_ -match '^source/DSCResources/' -or $_ -match '^source/Classes/' }
     if ($changedDscResources)
     {
-        Write-Host "DSC resources or classes have been modified. DSC resource integration tests will run."
-        Write-Host "Changed DSC resources/classes:"
+        Write-Host "##vso[task.logissue type=warning]DSC resources or classes have been modified. DSC resource integration tests will run."
+        Write-Host "##vso[group]Changed DSC Resources/Classes"
         $changedDscResources | ForEach-Object -Process { Write-Host "  $_" }
-        Write-Host ""
+        Write-Host "##vso[task.logdetail id=2;progress=100;state=Completed]"
         return $true
     }
 
@@ -418,10 +419,10 @@ function Test-ShouldRunDscResourceIntegrationTests
     $affectedCommands = $changedPublicCommands | Where-Object -FilterScript { $_ -in $PublicCommandsUsedByDscResources }
     if ($affectedCommands)
     {
-        Write-Host "Public commands used by DSC resources have been modified. DSC resource integration tests will run."
-        Write-Host "Affected commands:"
+        Write-Host "##vso[task.logissue type=warning]Public commands used by DSC resources have been modified. DSC resource integration tests will run."
+        Write-Host "##vso[group]Affected Commands"
         $affectedCommands | ForEach-Object -Process { Write-Host "  $_" }
-        Write-Host ""
+        Write-Host "##vso[task.logdetail id=3;progress=100;state=Completed]"
         return $true
     }
 
@@ -447,36 +448,36 @@ function Test-ShouldRunDscResourceIntegrationTests
 
     if ($affectedPrivateFunctions)
     {
-        Write-Host "Private functions used by DSC resource-related public commands or class-based DSC resources have been modified. DSC resource integration tests will run."
-        Write-Host "Affected private functions:"
+        Write-Host "##vso[task.logissue type=warning]Private functions used by DSC resource-related public commands or class-based DSC resources have been modified. DSC resource integration tests will run."
+        Write-Host "##vso[group]Affected Private Functions"
         $affectedPrivateFunctions | ForEach-Object -Process { Write-Host "  $_" }
-        Write-Host ""
+        Write-Host "##vso[task.logdetail id=4;progress=100;state=Completed]"
         return $true
     }
 
     # Check if integration test files themselves are changed
     $changedIntegrationTests = $changedFiles | Where-Object -FilterScript { $_ -match '^tests/Integration/Resources/' }
     if ($changedIntegrationTests)
     {
-        Write-Host "DSC resource integration test files have been modified. DSC resource integration tests will run."
-        Write-Host "Changed integration test files:"
+        Write-Host "##vso[task.logissue type=warning]DSC resource integration test files have been modified. DSC resource integration tests will run."
+        Write-Host "##vso[group]Changed Integration Test Files"
         $changedIntegrationTests | ForEach-Object -Process { Write-Host "  $_" }
-        Write-Host ""
+        Write-Host "##vso[task.logdetail id=5;progress=100;state=Completed]"
         return $true
     }
 
     # Check if pipeline configuration is changed
     $changedPipelineFiles = $changedFiles | Where-Object -FilterScript { $_ -match 'azure-pipelines\.yml$|\.build/' }
     if ($changedPipelineFiles)
     {
-        Write-Host "Pipeline configuration has been modified. DSC resource integration tests will run."
-        Write-Host "Changed pipeline files:"
+        Write-Host "##vso[task.logissue type=warning]Pipeline configuration has been modified. DSC resource integration tests will run."
+        Write-Host "##vso[group]Changed Pipeline Files"
         $changedPipelineFiles | ForEach-Object -Process { Write-Host "  $_" }
-        Write-Host ""
+        Write-Host "##vso[task.logdetail id=6;progress=100;state=Completed]"
         return $true
     }
 
-    Write-Host "No changes detected that would affect DSC resources. DSC resource integration tests can be skipped."
+    Write-Host "##vso[task.logissue type=debug]No changes detected that would affect DSC resources. DSC resource integration tests can be skipped."
     Write-Host ""
     return $false
 }
@@ -489,6 +490,17 @@ if ($MyInvocation.InvocationName -ne '.')
     # Output result for Azure DevOps variables
     Write-Output -InputObject "##vso[task.setvariable variable=ShouldRunDscResourceIntegrationTests]$shouldRun"
 
+    # Provide clear final result with appropriate color coding
+    Write-Host "##vso[section]Test Requirements Decision"
+    if ($shouldRun)
+    {
+        Write-Host "##vso[task.logissue type=warning]RESULT: DSC resource integration tests WILL RUN"
+    }
+    else
+    {
+        Write-Host "##vso[task.logissue type=debug]RESULT: DSC resource integration tests will be SKIPPED"
+    }
+    
     # Also output as regular output for local testing
     Write-Output -InputObject ""
     Write-Output -InputObject "ShouldRunDscResourceIntegrationTests: $shouldRun"