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 # MIInTwYJKoZIhvcNAQcCoIInQDCCJzwCAQExDzANBglghkgBZQMEAgEFADB5Bgor # 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/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghncMIIZ2AIBATBu # MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc # +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG # CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIA3lCjWEw6y1621H7HL+W7J+xT5h # iq4aOAaAKfl6xXdpMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv # AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE # ggEADplXR+gsSukpjpWmrWvEfFYYyiFqRuM0XbiWdBslCH8eSHV4upfkz7wizWdf # gXbO/TLBAdsx9Y0rlaM0267Pb7npV9FMtRJODPpQNCJ+A5tFiAdHPB8bgq9SAdYU # OvhpJjJUwVJZ98/UnRw5LFLzy6/D6EuHQbDETsbk3yWFAxt0ioGEowi6soNpx1B9 # /9GqTZVRZij2KYC7cQSMGeN1xVZuydRiVxSNvtthVVtb0QmliOiVjAqmjZmDkprU # 32CEi8n+KggbjX5ccucqqmbb3tob9sXE/NmzYRd20hcGsmv5VAKRL1s3bHAqcXaX # DK0ylvQSqlZGOhwcSQKVImNEGqGCF6wwgheoBgorBgEEAYI3AwMBMYIXmDCCF5QG # CSqGSIb3DQEHAqCCF4UwgheBAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsqhkiG # 9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC # AQUABCDtgy6ActQhtAwnQLMulxLFjDvcnS9in69f0MaaC217NwIGavNqv1B9GBIy # MDI2MTExNjIzNTEyOS43OVowBIACAfSggdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k # IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjU1 # MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNloIIR+zCCBygwggUQoAMCAQICEzMAAAIwPwcEM8T7OdYAAQAAAjAwDQYJKoZI # hvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO # BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm # MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjYxMDE1 # MTgzNzM1WhcNMjgwMTExMTgzNzM1WjCB0zELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0 # aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NTUxQS0wNUUw # LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi # MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDVwRBW2y1exyTQANEW30RXgtkb # jibnGhGNMgd90qNcF6HbZMOlVjk2/FAF1C4iBx/9p5fCdCin+Z6ZssW8KwvESArd # jPZFd7/sNE7UhHt3zmgU2qpv+4SpU+09HmRqiltt/CbyZ4DwHp1E0TNJ69zkI7mQ # nxntgFaLAy2ypUgjOlZii2yaBuxhqwWBVJYe7g0wUc6PknYpbx3a87tjAAavYlK9 # ncz0WKZ9P/isPK+X4nMMxD6539C6fqYx7idfg54/oIVA6600HlbQEHFA7GBwVpaZ # X9kPAPOTezYE+G7DvLwT0+TwS0q9QvbhIbwna5KGsnX6wNokkjBcJJq5BXJ1P8jN # 1eTV3ZTWu11L+aMlHUSIoJ8BR9y6zBJl2WqFsk7YMbaFTpv34kPcLed0ok7NC4KU # hc9cBxcwnWrcEse8dEDJPOT10jX6KyvJ+C1/4CL+18kYjGlNhEVFRm/dS7G1GRtj # 9/V1MmO2SAFiqpkBZeHvOZ4AY4P6GimdYXefZgFBoH76/BbXk+AizfU+qXJiOEjL # NmxYZH39QebQZZPW4XBw6iFDVqZJ/opOJZsozYYklY+VXz05LgvacaVOaZzqQE5B # HmXufqgHm0f+r9IDiPqG2vHqh9Vo5eXd6eAqarWHfQOSP2SvrpyG6pX445aMrdQ1 # mzKYi9EIhkosw1UIeQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFOKoYUNBGcCqpVEk # CMzFm47bcbAFMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud # HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr # BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv # bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw # MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw # DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQAB2HcW7x5FJppHuoLh # l38Nf48DKFBQBXr+CJUJQaWSnG7SonxxC+t36ANDTGVmywG4+rCIe/03xhXUMXyz # iziOfagjVK/1PDqM6eqpC7HoZV930/S9IJTVHZ2fwWdCQOMNrhWJ8Y8LD4ruzjK6 # 0RYvkIPBYjjDlMlHvphVLfzoRmg76vgBt2jgQFwI0wbF6LsJSnnDMwQrVf6WvmH/ # I0x6KAufGwJPg2LJIJdn3FEIFGeJp4eUsvRXCN1TIrVNtlg6cHYZ+XLwgsv4Bht5 # hdUm6KU1XlOhBwnOtetTdrt474+eQy1x60AeySMOUkyBrplucHiS/CXhlUPH2BiT # 6ICtiFMZL2N3jkx3wN1eE0D8Sna9Pwd7GuJ4PPZ+HokzeH9QVoE+9xUf6wJY8+ko # rNf1MaU989qZg75yPKS4d8P96vJXwxka0n/mj6V90xl/iYfNEXirlT4lHo2I1q4a # Lr6kChGAxWe5J0LVfzBkRcep6rHqHzYY2f+bsnQ7flSdeQF81dq3bagKv1FGbMu7 # 44qxxspr8l9z4R4sodeB+Piz4wNUQ/htBQU4M3bZIBVU/tgKabAOhfz67vB69oYQ # V4NuH6fk7oUhGgY7FJxP3oLRK+G10wzLMP10Ocm24NljJdZT6LSoVBHdYfCx3U3z # gRLHlBTw6y10tBq7RKmkYxjzwDCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA # AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl # IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow # fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd # TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA # A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX # 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q # UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d # q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN # pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k # rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d # Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS # Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8 # QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm # gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF # ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID # AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU # KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1 # GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0 # bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA # QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL # j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p # Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w # Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz # LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU # tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN # 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU # 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5 # KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy # qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6 # 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE # AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp # AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd # FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb # atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd # VTNYs6FwZvKhggNWMIICPgIBATCCAQGhgdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k # IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjU1 # MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNloiMKAQEwBwYFKw4DAhoDFQCnszgvh8f2WUeirqwnKpMhjr7BPqCBgzCBgKR+ # MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT # HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA # 7qXRejAiGA8yMDI2MTExNjE5MDExNFoYDzIwMjYxMTE3MTkwMTE0WjB0MDoGCisG # AQQBhFkKBAExLDAqMAoCBQDupdF6AgEAMAcCAQACAgfqMAcCAQACAhPJMAoCBQDu # pyL6AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMH # oSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBADVP6/7SuVfJ2CFxTcTi # 0k7eUGtB+DG8q2s8OvegDt84ApumChJudhOY5nfWHF10+HDjWPHXW2vlswLBqMhn # hZYzXV2UVEodLe1EYFJTqqozux1VuDVKMmgNiYw8uBC1QnmGfwTcMIyvjWxH+V8V # QFA/YS1jXnXks5l3Lz5p8ziaqJ8MDhtyacHnzqOAWEv2PrqwcIdYgttGgf8uafbG # yKmaBmNiqGxKpq1sokr71mBG01jmiy6MM52smbg7sgWagZBgrn3AoGx87nHnrbc8 # DE51Tz8R782mWHz8CchAe8CyQD35lL0ZBFRGVIASo4I8i3AK4rqus8GxI9mimZLO # /sIxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAIT # MwAAAjA/BwQzxPs51gABAAACMDANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcN # AQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCAzJNg2t1N52o3WwOZq # eBK9auZF9Mc4nYR0ZpuxsoiADTCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0E # IBSSWLrvRZbPgVa4c8ZpeOnOU3JHYBu9Ox7cqaICH9FoMIGYMIGApH4wfDELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9z # b2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIwPwcEM8T7OdYAAQAAAjAwIgQg # pDafyCHNlL3SO+Zt4m8Gi59s/jDiMQZ602Ela1iJSkAwDQYJKoZIhvcNAQELBQAE # ggIAvq0zaX4EK34hr8cYKnMiKs9us471UP7TYunDyBnAF0YsXvqPh2P0no2okFL9 # 0ytGMEmWx91QYFHtDM1ayk4n098hBsBtwhEp9oAIVy2ImayT9HSOOaWlVFf38ZAh # oAAFJ6gCqug7txnZ/c2tgwHgaP3MFmHpyc352iL2WfeG4dX8eefYSEbJEcb3MCty # LJRLFpFplf3peWEdaIFKnBaHiL3qOtwYecpnyOKfchf2b5AMkU7vxEiouFo8ntOJ # cK+gLEw58IrgZ+E00jNoR0+ozg1rFbmStL8Uk93ZA8noUggqZ+XjHCcS0KFCRyM2 # pJYbfyDG44kh3pkZV3NfKYbfv7V5Wp9tihBsSXZW0Y4D8+AORhLBZfqiwOWpvswY # Ly/xuyANoecWRjRMaHtilQex8i3rPwMESnOo6OLhAY0iQi4w+7tTnUbQw+hVlsxz # AZW0UrEnsMKNLkV7aUPw4eo7NsoO/Wi1T+FNBTDNiau8zaHiSlgUO/EvF0QuiLjN # 7qJ4NEfYpNv7GnKBxbllvCpNrn9+8e7ImRDiQEHNrybB0VG8fyjafeYmJxpTWf7r # WNkTgMkICJ1k/PbgdXBtF7AoL1y/c3+HDYN4tnsHyVh5pU67/so5Zy1g3YMqjgKV # bJmn/uYXTw/yZSJxo0HFTAYTIAQOyV10CWLJnn3RpsPcadQ= # SIG # End signature block |