Avm.Authoring

0.10.1

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.

    .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

        }

        $isUpdateCommand = $rawArguments.Count -gt 0 -and [string]$rawArguments[0] -ceq 'update'

        if (-not $isUpdateCommand) {

            Test-AvmModuleVersion `

                -SkipModuleVersionCheck:$SkipModuleVersionCheck `

                -RefreshLatestVersion

            $PSDefaultParameterValues = if ($PSDefaultParameterValues) {

                $PSDefaultParameterValues.Clone()

            }

            else {

                @{}

            }

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

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

        }

        # Honour .avm/.disable sentinel anywhere up the path: spec section 8.

        # 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 ($token -in @('--passthru', '--pass-thru', '-PassThru', '-passthru')) {

                    $passThru = $true

                    continue

                }

                $arg

            }

        )

        $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

# MIInQwYJKoZIhvcNAQcCoIInNDCCJzACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAaQbgM5yxMYAqc

# yUSW5yYXDwqV3w1nQW52oHwa1lnLxKCCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# 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

# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnfMIIZ2wIBATBuMFcxCzAJBgNVBAYTAlVT

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv

# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w

# DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ

# KoZIhvcNAQkEMSIEIFTbZzJ+4DgzAQBxNaV9M9imek/ThPagQvPe+zxruzJoMEIG

# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAPoJSdGXC9ZX2K7OI

# JMRFemAbTOQUkT3Fo1zAa5ed0MxVUokT6NIeYGk7RWCoodrZB8Ym1hHoIrSuq6qo

# j3NBOfIW2e5sta+GkmQ7Dq+elSCiPuY8L0ZtLXsoIKdwD4xX6yw1tJWj6KLBiIOz

# pqK1Rv+FzTfMR+9UHbH/HiZG+61i8ggsGHmgLUvRBeNWfB3v+fd+wSfGggcmait1

# DHWvshV5ZeVkd4ZiHcixRJJA5VpO+DRaX6h0jgm9xmQyozUudf7bnpixQOanC7bI

# xg8TqRHe1zs/Peq49AY8XQ2UXp7791mAk83Xot51A4McASj3/ItzTti/9cKURhsH

# /nlMXqGCF68wgherBgorBgEEAYI3AwMBMYIXmzCCF5cGCSqGSIb3DQEHAqCCF4gw

# gheEAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsqhkiG9w0BCRABBKCCAUgEggFE

# MIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCBGILr8ML4ndzM2

# GuEajfsHl9MF/f6MGUG95etiH/BfMAIGamOHfdq7GBIyMDI2MDgyMDIzMjgwNy4y

# M1owBIACAfSggdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGlt

# aXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjRDMUEtMDVFMC1EOTQ3MSUw

# IwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloIIR/jCCBygwggUQ

# oAMCAQICEzMAAAIYJdmSBeLn5eQAAQAAAhgwDQYJKoZIhvcNAQELBQAwfDELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjUwODE0MTg0ODI1WhcNMjYxMTEz

# MTg0ODI1WjCB0zELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO

# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEt

# MCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMScw

# JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NEMxQS0wNUUwLUQ5NDcxJTAjBgNVBAMT

# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUA

# A4ICDwAwggIKAoICAQCx3Ojq65AmoB/Eue8QF8i+PqScr6npucxcQVn9CM84XLCV

# yMN/MjwODWfMOXGbv+mpu+NaHK9rMqYXI7qps/AKV9GcjnuHk4KLGCk44IYklAhl

# JOIyC6LcHwM+IW0k9x/NG3cWyfGMtfAEiMaCeMZ+ZCXvN6MDVahgv+oGZCHD8UMV

# NZ5vF+jibREII7F/arCPfVo6NzZphR4+0sxcexco8UfS2nlIogX/20nFFKDQ1gS9

# CpWKWN7xpCQ93erMC7HYxzkcxIrg0xO1VUJgBYNRnin7qIMj23kE0IEix/migU1R

# a3EKqekViItiQd8V/GFVQFnwsYbFiwDfqycPrmzYd/i3zqTR7xZ6Uf+6x+Fio4zf

# PbJojyuDTzrfUiTCpTPJCgQ+oyweAF6bXGmY4ZIhSdW9OwC/6WYQIvZGqtw5mVlr

# HwrRqKKPyHpSRYE3YgD+KRpyRNIZVEFCZZZm4sVZX9PjG43OxwLRfvGjh962Cmyp

# oQDSNj9B6+RO8u/g6U03144vws2HtWbRHrk/uhps5AOq1QUDAKCOA8nSJX+NAJow

# Bw7dJikbnBIBiImSThcuM1KU3FTYh2OzWw5GGXuzssLqE5vttUAdXA43vgbF8U2I

# QgDoF+50A2OlAnSdRz+mkRelPimAMEexi1Xw7IpKMqwjE50VHt8gkiMNzwO9SQID

# AQABo4IBSTCCAUUwHQYDVR0OBBYEFCQuocRcOhtjt0e6hAIFrixftovRMB8GA1Ud

# IwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRp

# bWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYI

# KwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMv

# TWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1Ud

# EwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeA

# MA0GCSqGSIb3DQEBCwUAA4ICAQCeSNGGPA+B2gim+3hiKhP+PQta4HEXcBEEpcMQ

# 2CCtoq8LShE/BuMCaxec8Sa26jkwPy4n1fD15ivGqqQrgMX2ydkyscx+ijEJr77W

# KsvPxiijMLi1yL5rg3ftJuR7Wm3XGz2pm2+Q+BkZafkFzBV+YDBJkseLYK5nTpjT

# 9f63p80GetsxWi81oNfhY93Ij0YTPF8iCAOxyTYimjhVcv8CtzPunYXtsRkZG7LG

# OAwL7CgKQMlof/KT/BxmkCyLF7g8503QNbplvfk7cODf5rqmsA0xzdYh298oOXvk

# /RqpxBtABHtvR/iAfg0yRRy3RabgY3kqGwTVgrtX/ACoMqYriPHfMvPdrwezFr0c

# HcbKK2WYLmwOE6XhBMY3mRGLqgKhXiEr6QgWCeRaMeFJE2ibPfpCdsJIb8EcsSbY

# ZFT27f8jjNR30TUAL3sgkQZ/Bv7Q1ZvdARyuTKl0Z1bCXQsQ5uGtBH0HVXv551zI

# 2axfSnYFfSsWl3U+RclJvF/whwSLD9uQ2BqBkT5WUO3Fd6u4t2jmTeUY6/us9i44

# RqhljEO9m2kc/0/frCZbgg2NHo0iefZQz6Ss//F4udFsMGSb1GyWegOFWtqWIoMf

# rYHGFyAv22JGA4eVwjTCq9VYt2/zJbyvGRrA6WEJGpPcQoQJbyS1QA/A1sFQuRP6

# hZy8FzCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcN

# AQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAw

# BgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEw

# MB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt

# U3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk

# 4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9c

# T8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWG

# UNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6Gnsz

# rYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2

# LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLV

# wIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTd

# EonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0

# gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFph

# AXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJ

# YfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXb

# GjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJ

# KwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnP

# EP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMw

# UQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggr

# BgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYw

# DwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoY

# xDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtp

# L2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYB

# BQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20v

# cGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0B

# AQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U5

# 18JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgAD

# sAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo

# 32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZ

# iefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZK

# PmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RI

# LLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgk

# ujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9

# af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzba

# ukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/

# OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNZMIIC

# QQIBATCCAQGhgdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGlt

# aXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjRDMUEtMDVFMC1EOTQ3MSUw

# IwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4D

# AhoDFQCda0atdaK40TxCsp+bgK0avnvP6aCBgzCBgKR+MHwxCzAJBgNVBAYTAlVT

# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA7jGbvTAiGA8yMDI2MDgy

# MDE1MjkwMVoYDzIwMjYwODIxMTUyOTAxWjB3MD0GCisGAQQBhFkKBAExLzAtMAoC

# BQDuMZu9AgEAMAoCAQACAj0rAgH/MAcCAQACAhIpMAoCBQDuMu09AgEAMDYGCisG

# AQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMB

# hqAwDQYJKoZIhvcNAQELBQADggEBAKNmlEfr0y9drZ4KE2S8kjJMfyGQ/Nc0MbCB

# 0lhrQgkd5ZdI7/7ihOvJ0iW5DLUXRSg5yJg0y1cTFjgVO6GtgQxqYnbV+iDQhRXw

# B4tU5hv8pkm+ECxQgME+xCp7pJik8R4npubKWw1eq09KAQO5f8FsHGPDaaoCrPqX

# pIQfWGIocGpkM4gAeoqNWK27uN7YCH5/6Q+mSmsQq1zTSkSsObDZBETrO21ZeXwQ

# 4er2ZkSJn/LWFYV0HzUR9sN1WdwZFldIIKZMUz6evzRu0C5UKyUjdQipcp+CtBeA

# NJWqlXS/3JYkX2zzSPrde+fGKqMhwEEU7A8pKQypo6VbMNRfwnsxggQNMIIECQIB

# ATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD

# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAhgl2ZIF4ufl

# 5AABAAACGDANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3

# DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCA4NTzk2SrBI6P5NxmH66DVvFQ8whgW13FI

# Ged150FPKzCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIJkT3Im45Mi0jBZo

# RLqXMYorVdxKjPXKdHNo5XPH14VqMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgUENBIDIwMTACEzMAAAIYJdmSBeLn5eQAAQAAAhgwIgQgk1aznSC+AQuMc5ZD

# xeGEhLA+lOkukBRoGcq/MsLZcDUwDQYJKoZIhvcNAQELBQAEggIAHfgTu3rkBT2p

# m2YmryJpKEhd85SqrQuqDDsC7uZrggytPc2t9SlG8Y2QZKKyoN5v3rlAYsorL2qC

# /NBkCAFCXQy12Mc4S/1aFOyrX4ZV5r1DvHi5Kf+pVsEjc/AIJ79k1KrtWC2bO4+B

# sts60+nZ8G75/Hc39q+H9JbV2DBHc6WSBmUtCkoD+cWZSi1ANcr6XS2cYdlem8A0

# oP32JIDWrgKecXuYacHCPbqlZbUOwGSERuBi21kUAhc+PCF8yt9IMUbC7u+GNUio

# VqxU1GZ8WhFIiRaYpX3mLnAZUCQ3LiRnvtiy1T93FcYlLbIi4XogCZLg4/xGNEvj

# GSTr/ax6ajSOKS2yAA8OQjBt0vkmSaFQZzanKF+trd7vEQkK2BuYR0laYaF2qzeQ

# HaHohDhSf9edoiux3kz2w8049LSVmE2Ezo8kWJCvj+V2RrjWJasgORSzN7rxd7wg

# rzMC4+0xcSqjIZldEsujPTiC4SfMmrq9rtzmyqDqOmbBoCcppaHiJIiaZumnVaEM

# wU2seV0on3VBdAMzEUfgpqdy/Qh1Ka1bxk2QTT41ohw7j2LUXN/OlEgjYlZiYotn

# asQyJ2+juqSOsJRem+TlTYj/aP9J47ASfnEbNj25QJUlkJ5tcCclaG6QJRtD/Fsm

# L0SZ5hE4pT/IgWkgSEfGs9Tnz52VfxE=

# SIG # End signature block