chore: update Process-PSModule to v6.1.13

MariusStorhaug · Copilot · MariusStorhaug · commit f9f09746b6c5 · 2026-07-23T18:52:33.000+02:00
Align workflow pin and packaging assertions to Process-PSModule v6.1.13, and disable Build-Site until this repo migrates from mkdocs to zensical.toml required by the latest release.

Co-authored-by: Copilot App &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/.github/PSModule.yml b/.github/PSModule.yml
@@ -17,10 +17,10 @@ Test:
 #     MacOS:
 #       Skip: true
 Build:
-  Docs:
-    # PlatyPS loads a conflicting YamlDotNet assembly before importing this module.
+  Site:
+    # Process-PSModule v6.1.13 switched Build-Site to zensical.toml only.
+    # Keep site build off until this repository migrates from .github/mkdocs.yml.
     Skip: true
-
 Linter:
   env:
     VALIDATE_BIOME_FORMAT: false
diff --git a/.github/workflows/Process-PSModule.yml b/.github/workflows/Process-PSModule.yml
@@ -27,7 +27,7 @@ permissions:
 
 jobs:
   Process-PSModule:
-    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@da180bac16b13bfbcdf08b2e4e221b5b49e5ff28 # v6.1.4
+    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@fb1bdb8fefd243292f779d2a856a38db6fe6daf4 # v6.1.13
     with:
       ImportantFilePatterns: |
         ^src/
diff --git a/tests/Packaging.Tests.ps1 b/tests/Packaging.Tests.ps1
@@ -11,60 +11,216 @@
 [CmdletBinding()]
 param()
 
-Describe 'Packaged dependency' {
-    BeforeAll {
-        $repositoryRoot = Split-Path -Parent $PSScriptRoot
-    }
+$importedYamlCommand = Get-Command -Name ConvertFrom-Yaml -ErrorAction SilentlyContinue
+$skipArtifactTests = [string]::IsNullOrWhiteSpace($env:PSMODULE_YAML_TEST_ARTIFACT) -and (
+    $null -eq $importedYamlCommand -or $importedYamlCommand.ModuleName -ne 'Yaml'
+)
 
-    It 'bundles the exact YamlDotNet 18.1.0 netstandard2.0 assembly' {
-        $hash = Get-FileHash -Path (
-            Join-Path $repositoryRoot 'src\assemblies\YamlDotNet.dll'
-        ) -Algorithm SHA256
+BeforeAll {
+    . (Join-Path $PSScriptRoot 'TestBootstrap.ps1')
+    $repositoryRoot = Split-Path -Parent $PSScriptRoot
+    $loadedYamlModule = if (-not [string]::IsNullOrWhiteSpace(
+            $env:PSMODULE_YAML_TEST_ARTIFACT
+        )) {
+        Import-Module -Name $env:PSMODULE_YAML_TEST_ARTIFACT -Force -Global -PassThru |
+            Where-Object Name -EQ 'Yaml' |
+            Select-Object -First 1
+    } else {
+        $command = Get-Command -Name ConvertFrom-Yaml -ErrorAction SilentlyContinue
+        if ($null -ne $command -and $command.ModuleName -eq 'Yaml') {
+            $command.Module
+        }
+    }
+    $artifactManifestPath = if ($null -ne $loadedYamlModule) {
+        Join-Path $loadedYamlModule.ModuleBase 'Yaml.psd1'
+    } else {
+        $null
+    }
+}
 
-        $hash.Hash | Should -Be '91CD6D1FD0AE5B64BF6B252EB3B1AF2382CBC599C29045427C45FE8403D4295D'
+Describe 'Dependency-free package source' {
+    It 'contains no external parser assembly, license, or notice payload' {
+        @(
+            Get-ChildItem -Path (Join-Path $repositoryRoot 'src\assemblies') `
+                -File -ErrorAction SilentlyContinue
+        ).Count | Should -Be 0
+        Test-Path (Join-Path $repositoryRoot 'src\licenses\YamlDotNet.LICENSE.txt') | Should -BeFalse
+        Test-Path (Join-Path $repositoryRoot 'src\THIRD-PARTY-NOTICES.txt') | Should -BeFalse
     }
 
     It 'keeps RequiredAssemblies out of the source manifest' {
         $manifest = Import-PowerShellDataFile -Path (
             Join-Path $repositoryRoot 'src\manifest.psd1'
         )
 
-        $manifest.DotNetFrameworkVersion | Should -Be '4.7.2'
+        $manifest.ContainsKey('DotNetFrameworkVersion') | Should -BeFalse
         $manifest.ContainsKey('RequiredAssemblies') | Should -BeFalse
     }
 
-    It 'packages the upstream license and dependency provenance' {
-        $license = Get-Content -Path (
-            Join-Path $repositoryRoot 'src\licenses\YamlDotNet.LICENSE.txt'
-        ) -Raw
-        $notice = Get-Content -Path (
-            Join-Path $repositoryRoot 'src\THIRD-PARTY-NOTICES.txt'
-        ) -Raw
+    It 'contains no external parser references or custom assembly loader' {
+        $sourceFiles = Get-ChildItem -Path (Join-Path $repositoryRoot 'src') -Recurse -File
+        $source = $sourceFiles |
+            Where-Object Extension -In @('.ps1', '.psd1', '.psm1') |
+            Get-Content -Raw
+
+        $source | Should -Not -Match 'YamlDotNet'
+        $source | Should -Not -Match '\bAdd-Type\b'
+        $source | Should -Not -Match 'Assembly\]::Load'
+    }
 
-        $license | Should -Match 'Copyright \(c\) 2008, 2009, 2010'
-        $license | Should -Match 'Permission is hereby granted, free of charge'
-        $notice | Should -Match 'YamlDotNet 18\.1\.0'
-        $notice | Should -Match 'lib/netstandard2\.0/YamlDotNet\.dll'
-        $notice | Should -Match '59FFE65ADE67AD9D886267F877B634A450363CB81B94E19DB9CA4C36461416F6'
-        $notice | Should -Match '91CD6D1FD0AE5B64BF6B252EB3B1AF2382CBC599C29045427C45FE8403D4295D'
+    It 'keeps the owned processor layers explicit and source-level' {
+        $privatePath = Join-Path $repositoryRoot 'src\functions\private'
+        @(
+            'New-YamlReaderContext.ps1',
+            'Read-YamlDirectiveBlock.ps1',
+            'New-YamlSyntaxNode.ps1',
+            'ConvertFrom-YamlSyntaxTree.ps1',
+            'Resolve-YamlScalar.ps1',
+            'ConvertFrom-YamlNode.ps1',
+            'Get-YamlSerializationShape.ps1',
+            'ConvertTo-YamlNode.ps1',
+            'Write-YamlNodeText.ps1'
+        ) | ForEach-Object {
+            Test-Path -LiteralPath (Join-Path $privatePath $_) |
+                Should -BeTrue -Because "$_ defines a required processor layer"
+        }
     }
 
-    It 'uses Process-PSModule 6.1.4 and treats tests as important changes' {
+    It 'uses Process-PSModule 6.1.13 and treats tests as important changes' {
         $workflow = Get-Content -Path (
             Join-Path $repositoryRoot '.github\workflows\Process-PSModule.yml'
         ) -Raw
 
-        $workflow | Should -Match 'workflow\.yml@da180bac16b13bfbcdf08b2e4e221b5b49e5ff28 # v6\.1\.4'
+        $workflow | Should -Match 'workflow\.yml@fb1bdb8fefd243292f779d2a856a38db6fe6daf4 # v6\.1\.13'
         $workflow | Should -Match '\^src/'
         $workflow | Should -Match '\^tests/'
     }
 
-    It 'does not add a custom assembly loader to module source' {
-        $source = Get-ChildItem -Path (Join-Path $repositoryRoot 'src') -Recurse -File |
-            Where-Object Extension -EQ '.ps1' |
-            Get-Content -Raw
+    It 'does not skip generated documentation' {
+        $configuration = Get-Content -Path (
+            Join-Path $repositoryRoot '.github\PSModule.yml'
+        ) -Raw
 
-        $source | Should -Not -Match '\bAdd-Type\b'
-        $source | Should -Not -Match 'Assembly\]::Load'
+        $configuration | Should -Not -Match '(?ms)Build:\s+Docs:\s+.*Skip:\s*true'
+    }
+
+    It 'skips site build until zensical.toml is adopted' {
+        $configuration = Get-Content -Path (
+            Join-Path $repositoryRoot '.github\PSModule.yml'
+        ) -Raw
+
+        $configuration | Should -Match '(?ms)Build:\s+Site:\s+.*Skip:\s*true'
+        Test-Path -Path (Join-Path $repositoryRoot 'zensical.toml') | Should -BeFalse
+    }
+}
+
+Describe 'Generated artifact package' {
+    It 'has no RequiredAssemblies or packaged DLL and has a complete FileList' `
+        -Skip:$skipArtifactTests {
+        $manifest = Import-PowerShellDataFile -Path $artifactManifestPath
+        $moduleBase = Split-Path -Parent $artifactManifestPath
+
+        $manifest.ContainsKey('RequiredAssemblies') | Should -BeFalse
+        $manifest.ContainsKey('DotNetFrameworkVersion') | Should -BeFalse
+        @($manifest.FunctionsToExport | Sort-Object) |
+            Should -Be @('ConvertFrom-Yaml', 'ConvertTo-Yaml', 'Test-Yaml')
+        @($manifest.FileList) | Should -Contain 'Yaml.psm1'
+        @($manifest.FileList | Where-Object { $_ -match '\.(?:dll|exe)$' }).Count | Should -Be 0
+        @($manifest.FileList | Where-Object { $_ -match 'THIRD-PARTY|YamlDotNet' }).Count | Should -Be 0
+        @(Get-ChildItem -Path $moduleBase -Recurse -File -Filter '*.dll').Count | Should -Be 0
+        { Test-ModuleManifest -Path $artifactManifestPath } | Should -Not -Throw
+    }
+
+    It 'imports in a fresh PowerShell process beside an existing YamlDotNet identity' `
+        -Skip:($skipArtifactTests -or $null -eq (Get-Command pwsh -ErrorAction SilentlyContinue)) {
+        $script = @'
+$ErrorActionPreference = 'Stop'
+$name = [System.Reflection.AssemblyName]::new('YamlDotNet')
+try {
+    $null = [System.Reflection.Emit.AssemblyBuilder]::DefineDynamicAssembly(
+        $name,
+        [System.Reflection.Emit.AssemblyBuilderAccess]::Run
+    )
+} catch {
+    $null = [AppDomain]::CurrentDomain.DefineDynamicAssembly(
+        $name,
+        [System.Reflection.Emit.AssemblyBuilderAccess]::Run
+    )
+}
+Import-Module -Name '__MANIFEST__' -Force
+$value = 'v: []' | ConvertFrom-Yaml -AsHashtable
+if ($value['v'] -isnot [object[]] -or $value['v'].Count -ne 0) {
+    throw 'The empty sequence did not survive import.'
+}
+if (-not ('name: Ada' | Test-Yaml)) {
+    throw 'The imported parser did not validate YAML.'
+}
+$shared = [ordered]@{ value = 1 }
+$roundTrip = [ordered]@{ first = $shared; second = $shared } |
+    ConvertTo-Yaml |
+    ConvertFrom-Yaml -AsHashtable
+if (-not [object]::ReferenceEquals($roundTrip['first'], $roundTrip['second'])) {
+    throw 'The fresh-process graph round trip lost alias identity.'
+}
+'coexistence-ok'
+'@.Replace('__MANIFEST__', $artifactManifestPath.Replace("'", "''"))
+
+        (& pwsh -NoLogo -NoProfile -Command $script) | Should -Contain 'coexistence-ok'
+        $LASTEXITCODE | Should -Be 0
+    }
+
+    It 'preserves internal arrays and aliases in a fresh Windows PowerShell 5.1 process' `
+        -Skip:($skipArtifactTests -or $null -eq (Get-Command powershell.exe -ErrorAction SilentlyContinue)) {
+        $script = @'
+$ErrorActionPreference = 'Stop'
+$name = [System.Reflection.AssemblyName]::new('YamlDotNet')
+$null = [AppDomain]::CurrentDomain.DefineDynamicAssembly(
+    $name,
+    [System.Reflection.Emit.AssemblyBuilderAccess]::Run
+)
+Import-Module -Name '__MANIFEST__' -Force
+$empty = 'v: []' | ConvertFrom-Yaml -AsHashtable
+if ($empty['v'] -isnot [object[]] -or $empty['v'].Count -ne 0) {
+    throw 'The empty sequence was corrupted.'
+}
+$binary = "a: &x !!binary SGVsbG8=`nb: *x" | ConvertFrom-Yaml -AsHashtable
+if ($binary['a'] -isnot [byte[]] -or -not [object]::ReferenceEquals($binary['a'], $binary['b'])) {
+    throw 'The binary value or alias identity was corrupted.'
+}
+$sequence = "a: &x []`nb: *x" | ConvertFrom-Yaml -AsHashtable
+if ($sequence['a'] -isnot [object[]] -or
+    -not [object]::ReferenceEquals($sequence['a'], $sequence['b'])) {
+    throw 'The sequence alias identity was corrupted.'
+}
+$recursive = 'a: &x [*x]' | ConvertFrom-Yaml -AsHashtable
+if (-not [object]::ReferenceEquals($recursive['a'], $recursive['a'][0])) {
+    throw 'The recursive alias was corrupted.'
+}
+$negativeZero = [BitConverter]::Int64BitsToDouble([long]::MinValue)
+if ((ConvertTo-Yaml -InputObject $negativeZero).Trim() -ne '-0.0') {
+    throw 'The negative-zero sign was lost.'
+}
+$flow = ('[' * 127) + 'null' + (']' * 127)
+if (-not (Test-Yaml -Yaml $flow -Depth 128 -MaxNodes 200)) {
+    throw 'The public maximum parse depth failed.'
+}
+$atLimit = [ordered]@{}
+$current = $atLimit
+for ($level = 1; $level -lt 127; $level++) {
+    $next = [ordered]@{}
+    $current['nested'] = $next
+    $current = $next
+}
+$current['value'] = 1
+$deepYaml = ConvertTo-Yaml -InputObject $atLimit -Depth 128 -MaxNodes 300
+if (-not (Test-Yaml -Yaml $deepYaml -Depth 128 -MaxNodes 300)) {
+    throw 'The public maximum serialization depth failed.'
+}
+'windows-powershell-ok'
+'@.Replace('__MANIFEST__', $artifactManifestPath.Replace("'", "''"))
+
+        (& powershell.exe -NoLogo -NoProfile -Command $script) |
+            Should -Contain 'windows-powershell-ok'
+        $LASTEXITCODE | Should -Be 0
     }
 }
