Avm.Authoring

0.40.0

Public/Invoke-Avm.ps1

                                function Invoke-Avm {

    <#

    .SYNOPSIS

        Avm CLI dispatcher. The 'avm' alias is the user-facing entry point.

    .DESCRIPTION

        Routes a verb path like 'tool install foo' to the matching cmdlet by

        consulting Get-AvmVerbRegistry. Verb matching is case-sensitive and

        prefers the longest matching prefix; remaining arguments are passed

        through to the resolved cmdlet via splatting.

        The dispatcher is intentionally not declared as a [CmdletBinding] cmdlet

        so that unbound arguments such as '-Json' or '--json' flow through

        unchanged into $args rather than failing parameter binding at this layer.

    .PARAMETER SkipModuleVersionCheck

        Skip the PowerShell Gallery check for a newer Avm.Authoring version and

        apply the same setting to the dispatched command. Writes a warning once.

    .EXAMPLE

        PS> avm

    .EXAMPLE

        PS> avm version

    .EXAMPLE

        PS> avm doctor --json

    .EXAMPLE

        PS> avm pre-commit --passthru

    #>

    [Alias('avm')]

    param(

        [switch] $SkipModuleVersionCheck

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    $rawArguments = @($args)

    $verbPath = if ($rawArguments.Count -gt 0) {

        ([string[]]$rawArguments -join ' ')

    }

    else {

        'help'

    }

    try {

        $verboseRequested = Test-AvmDebugMode

        if (-not $verboseRequested) {

            $verboseRequested = @(

                $rawArguments |

                    Where-Object {

                        ([string]$_).ToLowerInvariant() -in @('-verbose', '--verbose')

                    }

            ).Count -gt 0

        }

        if ($verboseRequested) {

            $VerbosePreference = 'Continue'

            $PSDefaultParameterValues = if ($PSDefaultParameterValues) {

                $PSDefaultParameterValues.Clone()

            }

            else {

                @{}

            }

            $PSDefaultParameterValues['*:Verbose'] = $true

        }

        $isUpgradeCommand = $rawArguments.Count -gt 0 -and [string]$rawArguments[0] -ceq 'upgrade'

        $isVersionCommand = $rawArguments.Count -gt 0 -and [string]$rawArguments[0] -ceq 'version'

        $isE2eListCommand = $false

        if ($rawArguments.Count -ge 3) {

            $isE2eListCommand = [string]$rawArguments[0] -ceq 'test' -and [string]$rawArguments[1] -ceq 'e2e'

            if ($isE2eListCommand) {

                $isE2eListCommand = @($rawArguments[2..($rawArguments.Count - 1)] |

                        Where-Object { [string]$_ -match '^--?list(?:=true)?$' }).Count -gt 0

            }

        }

        if (-not $isUpgradeCommand -and -not $isE2eListCommand) {

            Test-AvmModuleVersion `

                -SkipModuleVersionCheck:$SkipModuleVersionCheck `

                -RefreshLatestVersion `

                -WarnOnly:$isVersionCommand

            $PSDefaultParameterValues = if ($PSDefaultParameterValues) {

                $PSDefaultParameterValues.Clone()

            }

            else {

                @{}

            }

            $PSDefaultParameterValues['*:SkipModuleVersionCheck'] = $true

            $PSDefaultParameterValues['Test-AvmModuleVersion:SuppressSkipWarning'] = $true

        }

        # Honour a .avm/.disable sentinel anywhere up the path. The opt-out lets a repo turn the dispatcher off without uninstalling

        # the module. We honour it even for read-only verbs like 'avm version'

        # so the user can't accidentally rely on output that the maintainer

        # explicitly disabled.

        $sentinel = Test-AvmDisableSentinel

        if ($sentinel) {

            throw [AvmConfigurationException]::new(

                "avm is disabled in this repository (remove $sentinel to re-enable).")

        }

        $passThru = $false

        $arguments = @(

            foreach ($arg in $rawArguments) {

                $token = [string]$arg

                if ($arg -is [string] -and $token -in @('--passthru', '--pass-thru', '-PassThru', '-passthru')) {

                    $passThru = $true

                    continue

                }

                # Preserve array-valued parameters as a single argument.

                , $arg

            }

        )

        if ($arguments.Count -ge 2 -and

            [string]$arguments[0] -ceq 'test' -and

            [string]$arguments[1] -ceq 'intn') {

            $arguments[1] = 'integration'

        }

        $registry = @(Get-AvmVerbRegistry)

        # F09: bare 'avm', 'avm --help', 'avm -h' and 'avm help' all print the same

        # verb listing. A help token is only honoured when it is the sole argument

        # so it can never shadow a real verb path such as 'avm tool install'.

        $helpRequested = $arguments.Count -eq 0

        if (-not $helpRequested -and $arguments.Count -eq 1) {

            $first = [string]$arguments[0]

            if ($first -in @('--help', '-h', 'help')) { $helpRequested = $true }

        }

        if ($helpRequested) {

            Write-AvmLog 'Avm.Authoring CLI' -Level Info

            Write-AvmLog '' -Level Info

            Write-AvmLog 'Usage: avm <verb> [<args>]' -Level Info

            Write-AvmLog '' -Level Info

            Write-AvmLog 'Available verbs:' -Level Info

            foreach ($entry in $registry) {

                $verb = ($entry.Path -join ' ').PadRight(20)

                Write-AvmLog ('  {0}  {1}' -f $verb, $entry.Summary) -Level Info

            }

            return

        }

        # Find the longest verb-path prefix that matches the supplied arguments.

        $match = $null

        $matchLen = 0

        foreach ($entry in $registry) {

            $entryPath = @($entry.Path)

            $len = $entryPath.Count

            if ($arguments.Count -lt $len) { continue }

            $matched = $true

            for ($i = 0; $i -lt $len; $i++) {

                if ([string]$arguments[$i] -cne [string]$entryPath[$i]) {

                    $matched = $false

                    break

                }

            }

            if ($matched -and $len -gt $matchLen) {

                $match = $entry

                $matchLen = $len

            }

        }

        if (-not $match) {

            $supplied = ($arguments -join ' ')

            throw [System.ArgumentException]::new(

                "Unknown verb: '$supplied'. Run 'avm' with no arguments to list available verbs.")

        }

        $remaining = if ($arguments.Count -gt $matchLen) {

            $arguments[$matchLen..($arguments.Count - 1)]

        }

        else {

            @()

        }

        # An if/else expression that returns a single-element array is auto-

        # unwrapped to a scalar on assignment. Re-wrap here so that .Count and

        # indexer access stay safe under Set-StrictMode -Version 3.0.

        $remaining = @($remaining)

        $cmd = Get-Command -Name $match.Cmdlet -ErrorAction Stop

        # Translate the residual CLI-shaped args into named (hashtable) and

        # positional (array) splats. Array splatting alone does not reliably

        # promote '-foo' tokens to parameter names, so anything that looks like a

        # flag (single- or double-dash prefix, with optional '=value') is bound

        # by name. The lookup against $cmd.Parameters resolves parameter casing

        # via the dictionary's case-insensitive comparer, so callers may use

        # 'avm doctor --json' or 'avm doctor -Json' interchangeably.

        $bound = @{}

        $positional = [System.Collections.Generic.List[object]]::new()

        $i = 0

        while ($i -lt $remaining.Count) {

            $token = [string]$remaining[$i]

            $isFlag = ($token.Length -gt 1) -and ($token.StartsWith('-')) -and ($token -cne '--')

            if (-not $isFlag) {

                $positional.Add($remaining[$i])

                $i++

                continue

            }

            $name = if ($token.StartsWith('--')) { $token.Substring(2) } else { $token.Substring(1) }

            $inlineValue = $null

            $eq = $name.IndexOf('=')

            if ($eq -ge 0) {

                $inlineValue = $name.Substring($eq + 1)

                $name = $name.Substring(0, $eq)

            }

            if (-not $cmd.Parameters.ContainsKey($name)) {

                # Allow kebab-case flags ('--allow-path-fallback' -> 'AllowPathFallback').

                if ($name.Contains('-')) {

                    $pascal = -join ($name -split '-' | ForEach-Object {

                            if ($_.Length -gt 0) { $_.Substring(0, 1).ToUpperInvariant() + $_.Substring(1) } else { '' }

                        })

                    if ($cmd.Parameters.ContainsKey($pascal)) {

                        $name = $pascal

                    }

                }

            }

            if (-not $cmd.Parameters.ContainsKey($name)) {

                throw [System.ArgumentException]::new(

                    "Unknown parameter '$token' for $($match.Cmdlet).")

            }

            $param = $cmd.Parameters[$name]

            $canonical = $param.Name

            $isSwitch = $param.ParameterType -eq [System.Management.Automation.SwitchParameter]

            if ($isSwitch) {

                if ($null -ne $inlineValue) {

                    $bound[$canonical] = [System.Convert]::ToBoolean($inlineValue)

                }

                else {

                    $bound[$canonical] = $true

                }

                $i++

            }

            else {

                if ($null -ne $inlineValue) {

                    $bound[$canonical] = $inlineValue

                    $i++

                }

                elseif ($i + 1 -lt $remaining.Count) {

                    $bound[$canonical] = $remaining[$i + 1]

                    $i += 2

                }

                else {

                    throw [System.ArgumentException]::new("Missing value for parameter '$token'.")

                }

            }

        }

        $verbPath = ($match.Path -join ' ')

        Write-AvmLog ('Starting avm {0}' -f $verbPath) -Level Info

        Write-AvmLog ('dispatch: cmdlet = {0}' -f $match.Cmdlet) -Level Verbose

        Write-AvmLog ('dispatch: positional arguments = {0}' -f ($positional -join ' | ')) -Level Verbose

        Write-AvmLog ('dispatch: bound parameters = {0}' -f (($bound.GetEnumerator() | Sort-Object Key | ForEach-Object { '{0}={1}' -f $_.Key, $_.Value }) -join '; ')) -Level Verbose

        $dispatchSw = [System.Diagnostics.Stopwatch]::StartNew()

        $result = & $cmd @bound @positional

        $dispatchSw.Stop()

        Write-AvmLog ('dispatch: completed {0} in {1}' -f $match.Cmdlet, (Format-AvmDuration -Duration $dispatchSw.Elapsed)) -Level Verbose

    }

    catch [AvmException] {

        Assert-AvmCleanFailure -Verb $verbPath -Exception $_.Exception

    }

    $items = @($result | Where-Object { $null -ne $_ })

    $rendered = @($items | Where-Object { $null -ne $_.PSObject.Properties['Status'] })

    $passThrough = @($items | Where-Object { $null -eq $_.PSObject.Properties['Status'] })

    Write-AvmLog ('dispatch: result objects={0}; rendered={1}; passthrough={2}' -f $items.Count, $rendered.Count, $passThrough.Count) -Level Verbose

    # F25: render once per invocation, not once per emitted object.

    if ($rendered.Count -gt 0) {

        Write-AvmResult -Result $rendered -Verb $verbPath

    }

    # F02: a gauntlet verb that reports Status 'fail' or 'error' must make the

    # hosting process exit non-zero, so wrapping git hooks and CI steps cannot

    # pass silently. Read-only verbs (e.g. 'version') emit no 'Status' property

    # and stream straight through untouched.

    foreach ($item in $rendered) {

        $status = ([string]$item.PSObject.Properties['Status'].Value).Trim()

        if ($status.ToLowerInvariant() -in @('fail', 'error')) {

            Assert-AvmCommandSuccess -Verb $verbPath -Status $status -Result $item

        }

    }

    # F23: the rendered summary is the interactive contract. Only hand the raw

    # result objects back when the caller asks for them; objects the renderer

    # did not consume (e.g. 'avm version') always stream through.

    if ($passThru) {

        return $result

    }

    return $passThrough

}

# SIG # Begin signature block

# MIInUQYJKoZIhvcNAQcCoIInQjCCJz4CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCYMYOvVanyyGJb

# 6Vu63a9R2Xk5Yw4tpDinDjo9ZJjVyqCCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1

# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP

# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC

# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf

# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j

# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT

# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT

# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw

# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w

# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl

# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC

# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN

# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK

# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK

# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY

# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu

# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE

# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz

# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6

# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO

# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD

# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC

# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX

# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ

# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq

# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo

# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv

# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a

# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1

# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO

# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7

# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ

# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS

# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm

# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3

# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E

# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX

# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP

# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw

# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC

# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D

# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY

# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI

# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6

# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w

# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7

# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK

# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK

# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw

# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT

# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghneMIIZ2gIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIA3lCjWEw6y1621H7HL+W7J+xT5h

# iq4aOAaAKfl6xXdpMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv

# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE

# ggEADplXR+gsSukpjpWmrWvEfFYYyiFqRuM0XbiWdBslCH8eSHV4upfkz7wizWdf

# gXbO/TLBAdsx9Y0rlaM0267Pb7npV9FMtRJODPpQNCJ+A5tFiAdHPB8bgq9SAdYU

# OvhpJjJUwVJZ98/UnRw5LFLzy6/D6EuHQbDETsbk3yWFAxt0ioGEowi6soNpx1B9

# /9GqTZVRZij2KYC7cQSMGeN1xVZuydRiVxSNvtthVVtb0QmliOiVjAqmjZmDkprU

# 32CEi8n+KggbjX5ccucqqmbb3tob9sXE/NmzYRd20hcGsmv5VAKRL1s3bHAqcXaX

# DK0ylvQSqlZGOhwcSQKVImNEGqGCF64wgheqBgorBgEEAYI3AwMBMYIXmjCCF5YG

# CSqGSIb3DQEHAqCCF4cwgheDAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFYBgsqhkiG

# 9w0BCRABBKCCAUcEggFDMIIBPwIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC

# AQUABCDtgy6ActQhtAwnQLMulxLFjDvcnS9in69f0MaaC217NwIGauvcYGoiGBEy

# MDI2MTEwOTA5MzQ0NC41WjAEgAIB9KCB2aSB1jCB0zELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQg

# T3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NTIx

# QS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp

# Y2WgghH+MIIHKDCCBRCgAwIBAgITMwAAAjlH4VFFJ7+kTAABAAACOTANBgkqhkiG

# 9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYw

# JAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjEwMTUx

# ODM3NDhaFw0yODAxMTExODM3NDhaMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRp

# b25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1MjFBLTA1RTAt

# RDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIw

# DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALszC4gUr6TtV8kRUnrQDqvY6wmz

# jjlGBSi6IOMY3qGEwSr+Ss3bHHaLI/3gISoE5hCr1evxHabQMW3tJKCXJJKFmPZ3

# hk6bHhw34YtJzy8nNJTJfKS0rspqXSVFXoB0a7zFctLnevxdLejg9WtUTTcXasYv

# 5Jw7oNYBWbA3aXGmzeQr5LWtB1IJJalCgLBqed5UgdwKG2WcrbPq7721TNVo/IHh

# xbi87IbWoI3omMeMLp7YDzop12CK0+WdQDUSVXzRuf+3yS1uT+nbLCVvyAn29y4s

# fozT5/o3vcL7BsDSqAHSBs0HnjHXrguHoceHC2cyuE82w9gMCiyq+X2wQbtPlBVE

# nOjjTwwxcqG4yj1ZFhepYWf8ieO/J5Rc1Xfvi08hYnsAoPvDE2tgPKsHzTp9qYkE

# bvJLkvwTDTsbDcnmQkXjpGbdavFdvWw0jgEoz1yMHvfa7lUUmcmgi1IRVHpyHywW

# se15Mxryzpg3cvaNHpiWzc9MFiJUcORxjV8Dn+RV8jupQ541bsFydJ5o7EysI8GD

# D3r5L2sXtpRQRlGi+aV1r7RG0jYksQWHlwtFy9xD2E3KNf0OaMnpPX2PK+5EhxRt

# rBj4LQg1n6VVcNaY//QF614z+thrlIi2XOSzp8AUd9mXp1bu/WgCES3iEDU36Dnz

# OOnSPXtKVfbtyZh9AgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQULJbabgF+KganYxVx

# i0YXVx3hf5owHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0f

# BFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwv

# TWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsG

# AQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAx

# MCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO

# BgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBACi2pZP180kt2rRknv2w

# I8rg9tgAy7cyNCxAt8gTkLEkxP/VrFU1WMwngE0N/vwgsR0SKH0to5RU1z5mLY+Z

# 8JWoYkfJtJQuao16oxeLn6vZMd4en/49I5suPhKoeXAZrCy7yb4+DpuoiU3Plcbu

# dEhPgt3YMUZfSw0pvyFPUN5m460tur/XYSjak8Ml9BxAF+S+Ci24huH/ecN1H82w

# uY10BT4JddTodVs5qYrEF9SrnnucB4pDW8I0C6oo1kdeGWublqZ9GOTvZKEu/uGq

# r+gtvVKe8daFop1CwZ+24RL7IH21A25T9Fhuc+ibhk0AWhCYd1UAbYDbAH6FZ7gO

# 768RhxScN+ou+ZLGN5tz+RH+Wo6qNnJQEpWxRKl9SqFxNtNX76pcMsmVrCvj1py6

# Ktf7NhdHK3iAr0d6VUH1k1AjL+AuiUb3rL3KGvWc7+LnOJiVpNtDQ647hPSwK2Fd

# LipuvP/9mbSa7NNLKTERyd01+oZA/4LS2MxSd3nYBFejW19pDn8cZEChEtrEvkqR

# uaIVzvLVVadDhVmMwNlDsIqevqRNNdhONcd0K8owguDS+omnEtXY2G/Dd9wHFPCu

# hpQrHCYUAD86BNmURQoseReKOC9EryFai8+iYw/q12U8lzjiiiyr7RA55B/2RZpc

# AtO5bSPZKf4/U7cyl1/9urtTMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAA

# AAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUg

# QXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2

# AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpS

# g0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2r

# rPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k

# 45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSu

# eik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09

# /SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR

# 6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxC

# aC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaD

# IV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMUR

# HXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMB

# AAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQq

# p1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ

# 6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRt

# MBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBB

# MAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP

# 6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWlj

# cm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMu

# Y3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2

# Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03d

# mLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1Tk

# eFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kp

# icO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKp

# W99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrY

# UP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QB

# jloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkB

# RH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0V

# iY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq

# 0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1V

# M1izoXBm8qGCA1kwggJBAgEBMIIBAaGB2aSB1jCB0zELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQg

# T3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NTIx

# QS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp

# Y2WiIwoBATAHBgUrDgMCGgMVALNosP4D06rjeNywRc4pY6tn039goIGDMIGApH4w

# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd

# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQELBQACBQDu

# m6BtMCIYDzIwMjYxMTA5MDEyOTE3WhgPMjAyNjExMTAwMTI5MTdaMHcwPQYKKwYB

# BAGEWQoEATEvMC0wCgIFAO6boG0CAQAwCgIBAAICCCoCAf8wBwIBAAICEt0wCgIF

# AO6c8e0CAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQAC

# AwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAE8vke+ocddfvpG8/

# z4Yyyuht+gXTmxYN3AGfPKI/H9GTYQJihjWRSUUWpRIsCy+5mRAbq5DZCVUnpxNV

# yhZQa54wU3CxAK2BsVwoZsg0TPprXOE4OzQlL5jsc1/Lk4p5QgYA3EPAFla89lrM

# Jfvs7Y2k0Z7tVVe7AH3Ul8CPDf+l87dVMRkGY9oB8XRLFRRsh2vv466fRvuMaB5E

# zylEWWZNSghX5+/W6kvkD9fsqxf+2wzemXyRZy25TBzQlAqY3k19IZaOWNnR8Zlg

# RQo7s1/9NVlQV80ZGtRdIS8fCfOK3hvt/1VOGaCyiuraYzQx7mMWkNsoQUHdV5Ci

# c6wzOTGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# AhMzAAACOUfhUUUnv6RMAAEAAAI5MA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG

# 9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIKkcCDNkqOXS2HVc

# ou2sJ6pgsFWDj/yWPDzrdrdpwVR6MIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCB

# vQQgA3HyMW1kzgw6REndLZdbBpNOIaIReIfatWGx6eYpVuUwgZgwgYCkfjB8MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy

# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAjlH4VFFJ7+kTAABAAACOTAi

# BCD+E5G5xcNJLWHU5fMAxNarAo5XbvwZtXXleRCKkKPQjTANBgkqhkiG9w0BAQsF

# AASCAgAWlfiFtK4t51yYURszJzfEsC1VIOod5If6fl6CoUUVJKS1ouY+wVrsD4m4

# 4Zkd+cbcm9n/9Z2ubOkHgBhphyRYaLVquV6tpoljs9/F0ifC6M+AWYHrtEAuGMxh

# XvNaflZxV0ue5zLmpM6xc7FLuJmB8PckP7CDd0Qgk94+DqoGYREtsZ+xfSewmLM8

# 5JGsC+3cAiujwtcYpQA64uh2PeTxtkmp+lCJg0/D/ImbIzttPQtCB61u4fAaZbKP

# FR2YhUdJsJLpcp7iMha8JkiAiuHHJJveB9qr+j7rKW05g/4v25h93UuUwPTUFGPC

# oMkOOOGww9d+hD2lcqWREBP9UYen8UE7qGxjS+LVqYp6ex5Vk5D3vZKl+T3rsDcL

# xXR11YhE+/hKDLdWFacK+nYEDRcGGYYlvOs6XZxiGO1Lhotr/Rz3HA929TuOlh9O

# ctxiwtBES9fBNbyg6cSAirUP6YBrQra8l1AjOmyg/0F2q+zlH8VFQfCny0jNuLlR

# SUT8FdZwY6KNNCFumR5bHysb0ZRUKqTdCGLJPDv5y/0izo3Wr67p3S7PAP0EN+2Y

# wSyGRn76cTU2ojfN/tNgy92r3O45mkoHjgOYZEYoCU/HwRfVtToPeE/vZThZmYuc

# Cbb8Teu9vt3h8s/2C6pUwrPs+CCYuWVURToAeUZ3tN+PmP/N3g==

# SIG # End signature block