Public/Invoke-AvmReleaseBranch.ps1

function Invoke-AvmReleaseBranch {
    <#
    .SYNOPSIS
        Prepare a reviewed external fork pull request for credentialed E2E testing.

    .DESCRIPTION
        For an external fork pull request that requires credentialed E2E tests,
        an authorized FTE must first review all code, workflows, and dependencies
        that could access credentials on the current pull request head. The
        command cannot verify which commit was reviewed. It snapshots the head
        when invoked and refuses to merge if it changes during the handoff.
        Restrict write access to the release branch and review any later changes.
        Using the installed GitHub CLI and its existing github.com authentication,
        this command creates a release branch from upstream main, retargets the
        fork pull request, merges the captured head, and opens a follow-up pull
        request to main. The follow-up links to the original pull request, thanks
        its author, and preserves its description. For Azure/bicep-registry-modules,
        it adds the PR: Run Required E2E Tests label to the follow-up. It does not
        approve reviews or bypass protections. Ordinary checks do not require
        this handoff.

        A failure can leave a branch or retargeted or merged pull request behind.
        Inspect their state before recovering manually; do not blindly rerun.

    .PARAMETER Repository
        Upstream github.com repository in owner/name form.

    .PARAMETER PullRequest
        Number of an open external fork pull request in the upstream repository.

    .PARAMETER SkipModuleVersionCheck
        Skip the PowerShell Gallery check for a newer Avm.Authoring release.

    .PARAMETER WhatIf
        Validate and display the planned handoff without changing GitHub state.

    .PARAMETER Confirm
        Prompt before performing the handoff.

    .OUTPUTS
        PSCustomObject with Repository, OriginalPullRequest, ReleaseBranch,
        HeadCommit, and FollowUpPullRequestUrl.

    .EXAMPLE
        Invoke-AvmReleaseBranch `
            -Repository 'Azure/example' `
            -PullRequest 123 `
            -WhatIf

    .EXAMPLE
        avm release-branch `
            --repository Azure/example `
            --pull-request 123
    #>

    [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')]
    [OutputType([pscustomobject])]
    param(
        [Parameter(Mandatory)]
        [ValidatePattern('^[A-Za-z0-9][A-Za-z0-9-]*/[A-Za-z0-9_.-]+$')]
        [string] $Repository,

        [Parameter(Mandatory)]
        [ValidateRange(1, [int]::MaxValue)]
        [int] $PullRequest,

        [switch] $SkipModuleVersionCheck
    )

    Set-StrictMode -Version 3.0
    $ErrorActionPreference = 'Stop'
    if ($env:AVM_OFFLINE -eq '1') {
        throw [AvmConfigurationException]::new('AVM_OFFLINE=1 prevents the GitHub pull request handoff.')
    }
    Test-AvmModuleVersion -SkipModuleVersionCheck:$SkipModuleVersionCheck

    $repo = Invoke-AvmGitHubApi -Endpoint "repos/$Repository"
    if ($repo['fork'] -ne $false -or $repo['default_branch'] -cne 'main' -or
        $repo['permissions']['push'] -ne $true) {
        throw [System.InvalidOperationException]::new(
            "The authenticated GitHub account must have write access to the non-fork upstream $Repository with default branch main.")
    }
    $mergeMethod = if ($repo['allow_squash_merge'] -eq $true) { 'squash' }
    elseif ($repo['allow_merge_commit'] -eq $true) { 'merge' }
    elseif ($repo['allow_rebase_merge'] -eq $true) { 'rebase' }
    else {
        throw [System.InvalidOperationException]::new("No supported merge method is enabled for $Repository.")
    }

    $endpoint = "repos/$Repository/pulls/$PullRequest"
    $pr = Invoke-AvmGitHubApi -Endpoint $endpoint
    if ($pr['state'] -cne 'open' -or $pr['draft'] -ne $false -or
        $pr['base']['repo']['full_name'] -ine $Repository -or
        $null -eq $pr['head']['repo'] -or $pr['head']['repo']['fork'] -ne $true -or
        $pr['head']['repo']['owner']['login'] -ieq $repo['owner']['login']) {
        throw [System.InvalidOperationException]::new(
            "Pull request $PullRequest must be open, ready for review, target the upstream repository, and originate from an external fork.")
    }
    $headCommit = [string]$pr['head']['sha']
    if ($headCommit -notmatch '^[a-fA-F0-9]{40}$') {
        throw [System.InvalidOperationException]::new('GitHub did not return a valid pull request head commit.')
    }
    $originalPullRequestUrl = [string]$pr['html_url']
    $expectedPullRequestUrl = "https://github.com/$Repository/pull/$PullRequest"
    if ($originalPullRequestUrl -ine $expectedPullRequestUrl) {
        throw [System.InvalidOperationException]::new('GitHub did not return the expected pull request URL.')
    }
    $originalAuthor = [string]$pr['user']['login']
    if ($originalAuthor -cnotmatch '^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?(?:\[bot\])?$') {
        throw [System.InvalidOperationException]::new('GitHub did not return a valid pull request author.')
    }

    $main = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/git/ref/heads/main"
    $mainSha = [string]$main['object']['sha']
    if ($mainSha -notmatch '^[a-fA-F0-9]{40}$') {
        throw [System.InvalidOperationException]::new('GitHub did not return a valid main commit.')
    }
    $branch = 'release/fork-pr-{0}-{1}' -f $PullRequest, $headCommit.Substring(0, 12).ToLowerInvariant()
    if (-not $PSCmdlet.ShouldProcess("$Repository pull request #$PullRequest",
            "Create $branch, retarget and merge fork head $headCommit, and open a pull request to main")) {
        return
    }

    $stage = 'creating the release branch'
    $followUpUrl = ''
    try {
        $null = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/git/refs" -Method POST -Body @{
            ref = "refs/heads/$branch"
            sha = $mainSha
        }
        $stage = 'retargeting the fork pull request'
        $null = Invoke-AvmGitHubApi -Endpoint $endpoint -Method PATCH -Body @{ base = $branch }
        $stage = 'checking the retargeted pull request'
        for ($attempt = 0; $attempt -lt 10; $attempt++) {
            $current = Invoke-AvmGitHubApi -Endpoint $endpoint
            if ($current['state'] -cne 'open' -or $current['base']['ref'] -cne $branch -or
                $current['head']['sha'] -ine $headCommit) {
                throw [System.InvalidOperationException]::new(
                    'The pull request state, target, or captured head changed during the handoff.')
            }
            if ($current['mergeable_state'] -cne 'unknown') { break }
            if ($attempt -lt 9) { Start-Sleep -Seconds 2 }
        }
        # Unstable means mergeable with pending or failed statuses; the merge endpoint still enforces required protections.
        if ($current['mergeable'] -ne $true -or
            $current['mergeable_state'] -cnotin @('clean', 'unstable')) {
            throw [System.InvalidOperationException]::new(
                "GitHub reports mergeable_state '$($current['mergeable_state'])'. Resolve required checks, reviews, or conflicts without bypassing protections.")
        }

        $releaseRef = "repos/$Repository/git/ref/heads/$branch"
        $release = Invoke-AvmGitHubApi -Endpoint $releaseRef
        if ($release['object']['sha'] -ine $mainSha) {
            throw [System.InvalidOperationException]::new('The release branch changed before the fork merge.')
        }
        $stage = 'merging the fork pull request'
        $merge = Invoke-AvmGitHubApi -Endpoint "$endpoint/merge" -Method PUT -Body @{
            sha          = $headCommit
            merge_method = $mergeMethod
        }
        if ($merge['merged'] -ne $true -or $merge['sha'] -notmatch '^[a-fA-F0-9]{40}$') {
            throw [System.InvalidOperationException]::new('GitHub did not confirm the fork pull request was merged.')
        }
        $stage = 'verifying the merged release branch'
        $release = Invoke-AvmGitHubApi -Endpoint $releaseRef
        if ($release['object']['sha'] -ine $merge['sha']) {
            throw [System.InvalidOperationException]::new('The release branch no longer points to the reported merge commit.')
        }
        $stage = 'opening the follow-up pull request'
        $followUpBody = @(
            "Credentialed E2E follow-up for [$Repository#$PullRequest]($originalPullRequestUrl)"
            "(fork commit ``$headCommit``)."
        ) -join ' '
        $followUpBody += "`n`nThank you @$originalAuthor for your contribution."
        $originalBody = [string]$pr['body']
        if (-not [string]::IsNullOrEmpty($originalBody)) {
            $followUpBody += "`n`n$originalBody"
        }
        $followUp = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/pulls" -Method POST -Body @{
            title = "E2E: $($pr['title'])"
            head  = $branch
            base  = 'main'
            body  = $followUpBody
        }
        if ([string]::IsNullOrWhiteSpace([string]$followUp['html_url'])) {
            throw [System.InvalidOperationException]::new('GitHub did not return the follow-up pull request URL.')
        }
        $followUpUrl = [string]$followUp['html_url']
        if ($Repository -ieq 'Azure/bicep-registry-modules') {
            $number = $followUp['number']
            if ($number -isnot [int] -and $number -isnot [long] -or $number -lt 1) {
                throw [System.InvalidOperationException]::new('GitHub did not return a valid follow-up pull request number.')
            }
            $stage = "adding the E2E label to $followUpUrl"
            $null = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/issues/$number/labels" -Method POST `
                -Body @{ labels = @('PR: Run Required E2E Tests') }
        }
        return [pscustomobject]@{
            Repository             = $Repository
            OriginalPullRequest    = $PullRequest
            ReleaseBranch          = $branch
            HeadCommit             = $headCommit
            FollowUpPullRequestUrl = $followUpUrl
        }
    }
    catch {
        throw [System.InvalidOperationException]::new(
            "Handoff stopped while $stage. Inspect $Repository pull request #$PullRequest and branch $branch before manual recovery; do not blindly rerun. $($_.Exception.Message)",
            $_.Exception)
    }
}

# SIG # Begin signature block
# MIInKAYJKoZIhvcNAQcCoIInGTCCJxUCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAHE99JRatCgJm6
# SvqVjGKESH+TFRUZ02SDqHF/WPLlLKCCDLowggX1MIID3aADAgECAhMzAAACHU0Z
# yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD
# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1
# OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD
# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB
# DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8
# o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg
# 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4
# Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R
# X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk
# ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B
# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O
# BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw
# HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg
# UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0
# JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh
# MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv
# Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy
# dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9
# s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H
# VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3
# w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n
# 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs
# A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo
# Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb
# SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6
# 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z
# V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v
# 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs
# /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA
# AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg
# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl
# IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow
# VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo
# MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ
# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh
# emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h
# KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd
# M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp
# yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t
# Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5
# REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs
# 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK
# Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5
# pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW
# eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ
# 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC
# NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB
# gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU
# ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny
# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx
# MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0
# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx
# MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI
# MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4
# NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh
# ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q
# hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU
# nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb
# H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z
# uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u
# vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW
# 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV
# DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10
# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnEMIIZwAIBATBuMFcxCzAJBgNVBAYTAlVT
# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv
# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w
# DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ
# KoZIhvcNAQkEMSIEIAAbXNAM0BWD/keijm2b5EZWxCxFjJEI/pbr+V8rEA5fMEIG
# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v
# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAF336sFhhwwjVYQIv
# xnMacwtJvIOh2VjhdwDgn/0VMe0dVrAGOI8K08mwUfy9gXLgOnWcSOyEppGV2+Rt
# NNy+D0vTVGT0AwHmcyPvtVo7aZqBKQcp1FweG3r4Vn1FbEy95gMjcaXF95FzwZUS
# EkobEopjjCwi7bNyHAhwNJgwAiqRWvR8Q+0PScCrtTTXK3ygo0Z9ldwhnkXb3/Hr
# jCjFrnoORtIkpjjnSwoO3FLpKFYGXeRUsFz1hKIWxTYWf8tYMLO7wp1VIn1e+WfR
# tZpfbdRD1ygHV8R8OsLxyDqVGmJ/lXhdWWE+1dltw4jhBBAa/qZ7KVBWJQXOgrJA
# mp1z0qGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20w
# ghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9
# MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCDKMqeOXRaW0oTC
# 0eBuqhvAIIOhPY1BOtI5PuHY3ziLzwIGavNM29I8GBMyMDI2MTExOTE2Mjc1Mi42
# NTJaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
# cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw
# JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzcwMy0wNUUwLUQ5NDcxJTAjBgNVBAMT
# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgIT
# MwAAAh86cGnkojAulQABAAACHzANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt
# ZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjAyMTkxOTM5NTFaFw0yNzA1MTcxOTM5NTFa
# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL
# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk
# IFRTUyBFU046MzcwMy0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l
# LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDL
# O8XFOcfGqAqgiz0+AmQmFl3dZ0aTG4UFJkqqNdMHy28DaheCBs6ONufukye5x42C
# WkzgRIy9kE2VWwEntZ8ZkgyrykC0bIqsID7+6FxguseTXf1Vwvm1D8104VmetoBJ
# lJ4uGbuyJZUvXDx55nVh50ygLTzZ24WkQsnPpvRZv2kPc39f3bhLyHVtnHsa/W/8
# 6Vrftd+AfFveA+qN/EY+XGj5c/DPMXCYECb0arYb92dDJWtwzpyBrp4gfHlgY1UE
# pc4l4AGELrf2J4wrxTzTW+SM8XhV1dOOPrYjD080IbZqL8B+IF0RCdn269YXrGK6
# QIHipznKZcCS8jN30YAHnTJVN5Zzs6t/2YsqBGDquvDad7934FFTwzvUcO3VoIyd
# 93XWwvP8/SCFVJh21W8oGQTptGHyly+Fl4henVMVZF1v6osOtirX8GFTiEhnf8nR
# dOg7yZYAJ0xy9CtDfbXaTn/cf3Lq3N/GCYKFjC+5mUCE+AJhmxMuMdvSUGmKiAFd
# iPAjUTqsWWBBZJm0eCwgeGJFmmQA+V7/98BKcE+gUL7O9eWRDQwKeAcvo6rxNv2Y
# 4jKrHA6Z/wi3a/fKUhLCNZES8qGdrpDAm7qh+6FjYxytAbkiKM6uTNy/ULPlwtlY
# ZoAJDDQP7eYCywwVbNTbHXRBSS+NccC0sSB4W7U67wIDAQABo4IBSTCCAUUwHQYD
# VR0OBBYEFNk72sGDlH0r5DwvfGR5XwJI8B7bMB8GA1UdIwQYMBaAFJ+nFV0AXmJd
# g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z
# b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El
# MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6
# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt
# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0l
# AQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUA
# A4ICAQBlbu3IoynnPz0K1iPbeNnsej2b15l5sdl2FAFBBGT9lRdc2gNV8LAIusPY
# HHhUvRDcsx4lbMNhVKPGu4TDLaqNt/CI+SFtGuqdRLpVP1XE9cCLyKrKPpcJFJCq
# PpV+efoAtYBmIUQcxxwT7WIQ7gag8+rkKvrMkCoRqKS0mKv8J1sKfi85+G2uhZ/1
# RteSVdYZOZOj+Sb4wzonTCTj7EtgMN/BX35W5dTzd7wJdGepYkVi871dSrC2Tr1Z
# FzAR7S44drCWZpJ6phJabVNOsNxFJKgSykugOGWzQ318Rr3MTPg2s3Bns+pUPVgM
# ijd4bUOH2BlEsLMMwOcolTTZqg1HYrdY1jxpUAI9ipjBQRINL/O705Z+/f2LjNmJ
# QooCVJVX24adpZ519SsfazGoqXGt91bmqKo0fI09Il4sUHh4ih6rpiQDBlyL7vmv
# CejwVxYevY4qVwTZ/o3gvl+R0lFxYS9feIM4NeG0+WsDZ7jLci5MFeuNwosQY3z2
# 6Xg1oj0U9u+ncR9uTU+xBmJ8BtlCdhQ13RNMX5P+krRYPB3XCp9Jm6XaO1995q32
# AIZm1mzBGI6yHlviXaEC5TzGiO1LXuPtXZU2X93oQJbMoe3v8+5CPKrQalGWyYuh
# 2a3V1pwbj+W0FEmEFPpu8TI+qYO1IIQWUSRvFjXth5Ob02hMMjCCB3EwggVZoAMC
# AQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV
# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w
# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m
# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIy
# NVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp
# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw
# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw
# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9
# DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2
# Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N
# 7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXc
# ag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJ
# j361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjk
# lqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37Zy
# L9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M
# 269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLX
# pyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLU
# HMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode
# 2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEA
# ATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYE
# FJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEB
# MEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv
# RG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEE
# AYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB
# /zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEug
# SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N
# aWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG
# AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jv
# b0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt
# 4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsP
# MeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++
# Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9
# QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2
# wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aR
# AfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5z
# bcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nx
# t67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3
# Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+AN
# uOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/Z
# cGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCB
# yzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMc
# TWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBU
# U1MgRVNOOjM3MDMtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1T
# dGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQBLIMg1P7sNuCXpmbH2IXT2tXeE
# EKCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw
# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3
# DQEBCwUAAgUA7qj+dTAiGA8yMDI2MTExOTA0NDk1N1oYDzIwMjYxMTIwMDQ0OTU3
# WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDuqP51AgEAMAcCAQACAgSuMAcCAQAC
# AhQ7MAoCBQDuqk/1AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKg
# CjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAK53MB5F
# r/5+LxWbBX3a6k6llFpI3eYJZx6cm3Bg5Iyz47fxT9QFFyKEBQsJg1j77qvsGAfY
# C+PO0GOnAAtkxZgzsgaI+hM561nCm0pJ6pwYC2lmY0KmCrNtci2vO/JysviDHxqG
# uf4jOB45I/gRM7yDkRspcfjfQaO53H28XgPYGGEwz4lwwSjJ71/tZcS+p9Qjklrn
# OvMACA38TjKMKFb8P4RKWeVbiMk/PcBxeMgA4uMoUtkrjWlirVEejtp4wHV0uuvp
# 5WM2XwuszQct95dgYsLvmFoKaq1guy9+cJS+3nWek8TLkENusUg9j/fmhcYe2HzP
# IFwtQqqhWg7v6cgxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UE
# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z
# b2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQ
# Q0EgMjAxMAITMwAAAh86cGnkojAulQABAAACHzANBglghkgBZQMEAgEFAKCCAUow
# GgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCC2DIZ5
# d1IkdCkYWZwe/zPeIfRaVjlEf989sRBLhyo9aDCB+gYLKoZIhvcNAQkQAi8xgeow
# gecwgeQwgb0EILAkCt9WkCsMtURkFu6TY0P3UXdRnCiYuPZhe3ykLfwUMIGYMIGA
# pH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE
# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIfOnBp5KIwLpUA
# AQAAAh8wIgQgWiJQs/nEhVA2zl8b7w2hMGkhOTIiKPtGicYo/8nGjZUwDQYJKoZI
# hvcNAQELBQAEggIAQBEfwsz31HHcLgH/v7dGO3wC5bWm1txo9XegbEvxfw9krb6y
# HHrFlZELnExncdcVJKOeEkz5JL2OqfM0bZk7Tj0Btju68hGtfkTH+HZ1tiSgXhQ8
# r6CXFeJN9dvSz7W0LAr4N7bBbB75E49SnkSOfTIv7jU8zSb+Pujg6881ZEUPMe02
# Uq6f6cm19Hc52sbTMR9I/lHOSTl2WXh6zjbLF4jzkV7LA9zfCcn/FZm5Z1JUu9NU
# hVPZNR7JFJkD2YQxgp1XGIB5ILzVW8hIKzjN+wHRQqyuLOjL5Ybdd9kqane/PPpQ
# N4W6wVEiRav+8T+bs5+xJEaH+DLL34lPtFHiLjjdhTI1soxSXoMx4cPDKcgHLML9
# uPcorOtVbMIjfIKLMH0Ws5ZBtbHUMZZWghlEdsUX7IT+7K5SvWoD3Ao0ZhJhAuwc
# g6eCFw6s3/yBTcgnsl7OETmtFHW9zC4MgZpC7XtlhQeaLTVLLw/OuQ5AGPREqaXx
# tcdeo+ER3XRufzdv+LHaRpuL/Sv3q7W4hZfdaDc3fl/KEO6qMiBCfDW4/HwEZtWV
# Yn/R2GMUijwI+CgtlHT8LKniPnogZ39N5nwqNdhQhpluDcqI0Ud6EDhlV/ZUrwLd
# jYQk9mvSNceQLe0EXCJAtUU5//E4Q5RlJSDf4tHPNnTTg4ZqK134jSwVGws=
# SIG # End signature block