Avm.Authoring

0.4.0

Private/Context/Read-AvmContextOverride.ps1

                                function Read-AvmContextOverride {

    <#

    .SYNOPSIS

        Find and parse a committed .avm/context.psd1 override.

    .DESCRIPTION

        Walks upward from $Path looking for a .avm/context.psd1 file. When

        found, parses it as a PowerShell data file and validates the

        contents against the ModuleContext schema. Returns a pscustomobject

        in the same shape as Get-AvmModuleContextInternal would produce, or

        $null when no override file exists.

        The override file lets a repository declare its classification

        explicitly when the heuristics would either miss-classify the

        layout (custom monorepo shapes) or be ambiguous (a repo that

        contains both Bicep and Terraform sources at different roots).

        Schema (all fields optional except Ecosystem and Kind):

            @{

                Ecosystem = 'bicep'                # bicep | terraform

                Kind      = 'bicep-monorepo'       # bicep-monorepo | bicep-module |

                                                   # terraform-module-repo | terraform-module-path

                Scope     = 'res'                  # res | ptn | utl (bicep only)

                Owner     = '@Azure/avm-core'      # optional

            }

        The override file's containing directory (the parent of .avm/) is

        used as the Root.

    #>

    [CmdletBinding()]

    [OutputType([pscustomobject])]

    param(

        [Parameter(Mandatory)] [string] $Path

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    $validEcosystems = @('bicep', 'terraform')

    $validKinds = @('bicep-monorepo', 'bicep-module', 'terraform-module-repo', 'terraform-module-path')

    $validScopes = @('res', 'ptn', 'utl')

    $dir = (Resolve-Path -LiteralPath $Path).ProviderPath

    if ((Get-Item -LiteralPath $dir).PSIsContainer -eq $false) {

        $dir = Split-Path -Parent $dir

    }

    while ($dir) {

        $overridePath = Join-Path (Join-Path $dir '.avm') 'context.psd1'

        if (Test-Path -LiteralPath $overridePath -PathType Leaf) {

            $data = Import-PowerShellDataFile -LiteralPath $overridePath

            if (-not $data.ContainsKey('Ecosystem')) {

                throw [AvmConfigurationException]::new(

                    "${overridePath}: missing required key 'Ecosystem'.")

            }

            if (-not $data.ContainsKey('Kind')) {

                throw [AvmConfigurationException]::new(

                    "${overridePath}: missing required key 'Kind'.")

            }

            if ($data.Ecosystem -notin $validEcosystems) {

                throw [AvmConfigurationException]::new(

                    "${overridePath}: Ecosystem '$($data.Ecosystem)' is not one of: $($validEcosystems -join ', ').")

            }

            if ($data.Kind -notin $validKinds) {

                throw [AvmConfigurationException]::new(

                    "${overridePath}: Kind '$($data.Kind)' is not one of: $($validKinds -join ', ').")

            }

            if ($data.ContainsKey('Scope') -and $null -ne $data.Scope -and $data.Scope -notin $validScopes) {

                throw [AvmConfigurationException]::new(

                    "${overridePath}: Scope '$($data.Scope)' is not one of: $($validScopes -join ', ').")

            }

            return [pscustomobject][ordered]@{

                Kind      = [string]$data.Kind

                Root      = $dir

                Ecosystem = [string]$data.Ecosystem

                Scope     = if ($data.ContainsKey('Scope')) { $data.Scope } else { $null }

                Owner     = if ($data.ContainsKey('Owner')) { $data.Owner } else { $null }

            }

        }

        $parent = Split-Path -Parent $dir

        if (-not $parent -or $parent -eq $dir) { break }

        $dir = $parent

    }

    return $null

}

# SIG # Begin signature block

# MIInOQYJKoZIhvcNAQcCoIInKjCCJyYCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDpMduR61wxkiTS

# FmcChK9a2rR+5O8NQPwddkmhrFaU6qCCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# 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/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghnGMIIZwgIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIP0Cesu3IQy07CBjnNFuX3x+GhLj

# 92iI+7uFQEF8NSmIMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv

# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE

# ggEASoI8D924YY5xUEu3tTZo6ps5Y2vzWri16FIa5U0lJM6SV90p1NU/6JoBo/A5

# 6May3DTODbDZGUIFiY9+SKttBBZlRnPb2AYPce3dqMWPrB7Yg/o3GrzGRbka0Gnd

# pFXeCQKpJjq12IUi7aAweRMzyIusk6Q03QZjlp7XQgx6Ld83+PfxJ5TSGV2W82hM

# 9kacZWheptisyzyp0Gc8eDYsVP0GKz3qXCQDgPidySaSByTqLhJSTXdaHBzi7nBO

# Fpj3BtGmTvFYyh2J+ja0WbKKNEHnjGmJF5zEaFP+tmNLlmVdytfiYuewoN6gHtpZ

# KodALkjHg1nwjw8E+ow6SblAIqGCF5YwgheSBgorBgEEAYI3AwMBMYIXgjCCF34G

# CSqGSIb3DQEHAqCCF28wghdrAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFRBgsqhkiG

# 9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC

# AQUABCDsIszXyh2Oqjcu6A9urkTaj2JyPhpKKagC5keysE9lcQIGal/egZK4GBIy

# MDI2MDgwNzExMTg1OS4xOFowBIACAfSggdGkgc4wgcsxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNh

# IE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjpEQzAwLTA1RTAt

# RDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEe0w

# ggcgMIIFCKADAgECAhMzAAACJDuEIbAsrGQiAAEAAAIkMA0GCSqGSIb3DQEBCwUA

# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT

# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI2MDIxOTE5Mzk1OVoX

# DTI3MDUxNzE5Mzk1OVowgcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAl

# BgNVBAsTHm5TaGllbGQgVFNTIEVTTjpEQzAwLTA1RTAtRDk0NzElMCMGA1UEAxMc

# TWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAKPpbdRpDZmviE29LLuPtQw8VXKztoTEYH4kXDKTPNeDeNrJ

# ib2A4tcnu02FTZ6aGstAI5lyAu/PoWSqaCHNDHOaSAq0tiIpoTOGiA79x7SVOF0s

# 11W0zBA5iCj5e1cBlxWIFfgtweTfxG6xmIXvDFJrm38vGJzTj5n+GXLWAlCkh4UO

# qnhr0+4u3yux8fTm9b2lT26uIZ0PF8lef+Vzj0LFteoDcRfXsvbhtzq36YW48MAk

# oqlqLddeoXacmWlM992sDb2xZNI0qKD0K0ELm3NCPR+Vuxr/jCo7275GS7Cllvdv

# uqdbkV0WsNHW9CZd+OXJQ/1k7fzzf03BK6Ie2+wUI2RM0hfw4vldWrWewrK7/8Z4

# hn1i7Gx8sF52obTbg8MRHKsCzSm99RY4tqlVBqMc+gKe41Iq9sSHuzkhDRiC6kaO

# L4fusgPHb+YgQj7pDxbAG2TdjHKGOPQZfD3T2LQSRORXLL7XIAOPBILxvDaozj4x

# ziHLK2VnNJzQg9QGrVgadjAKMjBrn+UxbSkWf8ekl0Hpd4y5O1hM6lo+ijrgWNCv

# ItdaN3ii+nDmU7Dtf6/cT2TA31UEL7AkRIEQILWBkwJLlNpXB8TXDimdddvWpP1u

# OBGw+Dh2SWu5RN2if/dI23RrRDk1zZSX6syVDFeg/2KxfAw2co7kkmSpENFVAgMB

# AAGjggFJMIIBRTAdBgNVHQ4EFgQUcx+RfW7/MksIx7SCpiK3HW0Ad6gwHwYDVR0j

# BBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0fBFgwVjBUoFKgUIZOaHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0JTIwVGlt

# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsGAQUFBwEBBGAwXjBcBggr

# BgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9N

# aWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcnQwDAYDVR0T

# AQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAOBgNVHQ8BAf8EBAMCB4Aw

# DQYJKoZIhvcNAQELBQADggIBAD7AdJuaEikzwJFVni2TrbiFD4t1lcTiqh5C6Lvs

# J41reOrUU7OLsxEqSSjp2IQMdc81a8BqDFqy0J7A/OblMI2HWzioIeHhHYb+vjzB

# T8ylzrz9YOYnLkIhCf8XCmzWxs1QS7sHODTTipQshUn3reOj9qbjHAqDCH69JUvv

# 92Gx9Pt2+GlF11tgtBMdmDC40HpCFwQSyCiAtXA1GPftURZkOLCgx3HILthitC7o

# wJW2LMec62RJfsWoiiLqOVx+p+jrX24Mf2vyTaoA4cJ4QCopcrKYhcMxwYaUR0MV

# tiINmA8IEzQgeAB6KVRKifTvCMe7R7SywGa0Fp89vgZ37kW5GdYbdcZ73U0Kksqq

# YVr/gaRXP04zNlSDyhzPEL/glPcd/jkkS2zNOhfA2yRXck0Jy7Ygi2vpIkeaLcQN

# UAMNFI2F3MVGliamUYSU+XkZGg+0mIMS9Ehu/kwUojDbH2Cd6F/ki8GMLhmQGD7g

# ZOmoYTeaafMXech6Q6Rfi6DT/SY3YJJquG5KL02Ycg6lQ3Z5AdS2BNv/4aaruCS0

# IzAir8k4JgiJNiqm/WhuMAYp1Yw8KuVLI0CzSNljOSFrnfnXnw0zH7AEa+x8WhWw

# Iwbk5ynq9boJfK5ZFtRWoxTU6tBsd93LMmluEkLU9sBkjIkJs35UGANMDNMpjzDg

# hJLBMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAAAAAAFTANBgkqhkiG9w0B

# AQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAG

# A1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAw

# HhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8MQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T

# dGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAOTh

# pkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2AX9sSuDivbk+F2Az/1xP

# x2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpSg0S3po5GawcU88V29YZQ

# 3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2rrPY2vjUmZNqYO7oaezOt

# gFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k45GPsjksUZzpcGkNyjYt

# cI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSueik3rMvrg0XnRm7KMtXA

# hjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09/SDPc31BmkZ1zcRfNN0S

# idb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR6L8FA6PRc6ZNN3SUHDSC

# D/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxCaC4Q6oRRRuLRvWoYWmEB

# c8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaDIV1fMHSRlJTYuVD5C4lh

# 8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMURHXLvjflSxIUXk8A8Fdsa

# N8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMBAAGjggHdMIIB2TASBgkr

# BgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQqp1L+ZMSavoKRPEY1Kc8Q

# /y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXAYDVR0gBFUwUzBR

# BgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0cDovL3d3dy5taWNyb3Nv

# ZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRtMBMGA1UdJQQMMAoGCCsG

# AQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAP

# BgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjE

# MFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kv

# Y3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEF

# BQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9w

# a2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MA0GCSqGSIb3DQEB

# CwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2Pk5HZHixBpOXPTEztTnX

# wnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03dmLq2HnjYNi6cqYJWAAOw

# Bb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1TkeFN1JFe53Z/zjj3G82jf

# ZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kpicO8F7BUhUKz/AyeixmJ

# 5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKpW99Jo3QMvOyRgNI95ko+

# ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrYUP4KWN1APMdUbZ1jdEgs

# sU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QBjloZkWsNn6Qo3GcZKCS6

# OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkBRH58oWFsc/4Ku+xBZj1p

# /cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0ViY1w/ue10CgaiQuPNtq6

# TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq0Z4+7X6gMTN9vMvpe784

# cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1VM1izoXBm8qGCA1AwggI4

# AgEBMIH5oYHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYD

# VQQLEx5uU2hpZWxkIFRTUyBFU046REMwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1p

# Y3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVAKYI8dua

# x4BJ97/9sa1f15Ab7T7joIGDMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB

# IDIwMTAwDQYJKoZIhvcNAQELBQACBQDuIBt0MCIYDzIwMjYwODA3MDg1MzA4WhgP

# MjAyNjA4MDgwODUzMDhaMHcwPQYKKwYBBAGEWQoEATEvMC0wCgIFAO4gG3QCAQAw

# CgIBAAICNO8CAf8wBwIBAAICEwowCgIFAO4hbPQCAQAwNgYKKwYBBAGEWQoEAjEo

# MCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG

# 9w0BAQsFAAOCAQEAcjNbrNMgJwjGCPWckrTmXl5jX2Qn5pj0oCNjm67+6+x5KRdq

# pCqnUnRgXNvWCMVGMnmTMHfspWu5sl2x4c3ecQwL94sKmCqeB1uOfuYIR+/gKU1c

# qHZlmvAqdA8dhFgZBxYLf49pezAIO5JFZGt1Z85Bjb9uGeGS/eB5Y3AzHGS55kNR

# 8UmpzYElKisab6d5eyvo9utilG4RMzjX3HM0cViJAqdL9jpLO32kP94Nru80UOwG

# oJn8ue9K7ZSWmFI0hJtQbsYfd37yo3X0+MzXCgVjBVV2p9za37YBkHgbum/kM2Zd

# oBl4H9W5Mz8cP8uFwypcTUM7AzWAWE+vP+Im3TGCBA0wggQJAgEBMIGTMHwxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv

# c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACJDuEIbAsrGQiAAEAAAIkMA0G

# CWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJ

# KoZIhvcNAQkEMSIEIFnf6sEcf11znFRgtYWeh+ePxbCVEfScY+wSvYtazcn2MIH6

# BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQgSCE9N2qb91HJnQFzNdx2WhUSogJ1

# yalU1sf0IRXNZI4wgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MAITMwAAAiQ7hCGwLKxkIgABAAACJDAiBCDGE6D6JUhR8D5UfZcQSmlUMfBA+vyB

# 4CavH4sapCnd4zANBgkqhkiG9w0BAQsFAASCAgAKjCRKX/GwOp5tz01KRVEpFBEa

# GxF3qTVT4GVdIwqG2OSxtmmcv708oXgMKpRf8F9zTHYYfbvNs15pswdehlL75CxV

# 3SWCtacJr7OrIiqTkwBZ+9fmgrg08mekaZ/4c8PxLG52mnbxvruvKqmbKw62UzFi

# mP/KVrllOC4Mew1YmJTF6slKKWUOfw+AqlPeYFUxAHdUO8vSC9T5YT+gyn7hq4vM

# 6xjYUCKJRq1APyZpK81IBdNR6DXUzEQ4cNHtq/DmRERdWsYzbB2wFqwJVLXuyyXv

# Pesk+k0ixyjdaOUxd5igR8LcEhfvCYMJGnVG2in9AHn3BD2bMqCq0OgWGjXs/Pvd

# /4qo3dxMClOItNhIuSyhtVFdh72ewlJHkrjp+ESRT1uXQkc2qeI3ZL/2XTPUnNIy

# /nqcY+vMV7R/OWgk46djQ+pFiyosxdkwmOhMOSX3pM1656dJxBhQUQqLxYkXIUEW

# vvXCtXis+zouhO+SLucX4mYZgyF45bqCtxhcnsSkVA1oT6M8+u3yDe5pRCtEbEOd

# dNv3jk8kwHyVNU/3wALwI8HVB8zHs2AFnou79uO4z9b76kladPImj1HokAhmNLMi

# lH6D2vSsZWClgE7e3czUyFZevYgyctSxU87gThw+2lfTyxovM6aAvxftJZUhXp9R

# XN7jwRHx7Qzzs2Zl7w==

# SIG # End signature block