Avm.Authoring

0.45.0

Public/Invoke-AvmDocs.ps1

                                function Invoke-AvmDocs {

    <#

    .SYNOPSIS

        Generate or refresh module documentation under $Path.

    .DESCRIPTION

        Routes to the engine matching the module's ecosystem:

          - bicep      -> Invoke-AvmBicepDocs      (Bicep docs + Scriban template)

          - terraform  -> Invoke-AvmTerraformDocs  ('terraform-docs markdown table' inject mode)

        The ecosystem is determined by Get-AvmModuleContext, which honours

        the .avm/context.psd1 override file and the -Ecosystem filter.

        Bicep uses the packaged canonical README template by default. Bicep

        0.48 selects templates through bicepconfig.json, so default rendering

        uses a temporary source copy without changing caller configuration.

        A configured documentation.template.file must reference a relative

        canonical template copy; valid explicit configurations render directly.

        Temporary sources are removed on success or failure.

        Routed by the dispatcher: 'avm docs'.

    .PARAMETER Path

        Module root to document. Defaults to the current location. An explicit

        path is authoritative; discovery does not search above it.

    .PARAMETER Ecosystem

        Force the ecosystem selector. Defaults to 'auto'.

    .PARAMETER AllowPathFallback

        When set, accept a PATH-resolved tool binary that self-reports the

        lock-pinned version.

    .PARAMETER OutputFile

        README path relative to a Terraform module. Bicep documentation

        always targets README.md in each source-bearing module.

    .PARAMETER CheckDrift

        Report-only mode used by pr-check. Any README that regeneration

        would change after line-ending normalization makes the result Status

        'fail' and is emitted as an Issue, instead of being silently rewritten.

        Without it a CI run regenerates docs in the throwaway working copy and

        reports a pass, so stale READMEs merge unnoticed.

    .PARAMETER IncludeRenderedContent

        With Bicep and -CheckDrift, return generated README text and relative

        paths for independent comparisons, without writing files. Content uses

        LF line endings.

    .PARAMETER SkipModuleVersionCheck

        Skip the PowerShell Gallery check that otherwise stops the command when a

        newer Avm.Authoring version is available. Writes a warning once.

    .OUTPUTS

        pscustomobject from the engine: Engine, Tool, ToolPath, ToolSource,

        Status, FilesProcessed, Changed, Issues. Bicep results also include

        FilesSelected and NotRendered.

    .EXAMPLE

        avm docs

    .EXAMPLE

        avm docs --check-drift

        # Fail instead of regenerating: what pr-check runs.

    .EXAMPLE

        Invoke-AvmDocs -Path C:\repos\my-tf-module -Ecosystem terraform

    .EXAMPLE

        Invoke-AvmDocs -Path C:\repos\my-bicep-module -Ecosystem bicep -CheckDrift

        Compare README content without rewriting module files or configuration.

    #>

    [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSShouldProcess', '',

        Justification = 'The facade forwards WhatIf to the Bicep engine and explicitly refuses it for Terraform.')]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseSingularNouns', '',

        Justification = 'Noun mirrors the avm CLI verb (avm docs).')]

    [OutputType([pscustomobject])]

    param(

        [Parameter(Position = 0)]

        [string] $Path = $PWD.Path,

        [ValidateSet('auto', 'bicep', 'terraform')]

        [string] $Ecosystem = 'auto',

        [switch] $AllowPathFallback,

        [string] $OutputFile = 'README.md',

        [switch] $CheckDrift,

        [switch] $IncludeRenderedContent,

        [switch] $SkipModuleVersionCheck

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    Test-AvmModuleVersion -SkipModuleVersionCheck:$SkipModuleVersionCheck

    $context = Get-AvmModuleContextInternal -Path $Path -Ecosystem $Ecosystem

    switch ($context.Ecosystem) {

        'bicep' {

            Invoke-AvmBicepDocs -Context $context -AllowPathFallback:$AllowPathFallback `

                -OutputFile $OutputFile -CheckDrift:$CheckDrift `

                -IncludeRenderedContent:$IncludeRenderedContent -WhatIf:$WhatIfPreference

        }

        'terraform' {

            if ($IncludeRenderedContent) {

                throw [AvmConfigurationException]::new(

                    '-IncludeRenderedContent is available only for Bicep -CheckDrift.')

            }

            if ($WhatIfPreference) {

                throw [AvmConfigurationException]::new(

                    "Terraform documentation does not support -WhatIf; use -CheckDrift to compare without changing module files.")

            }

            Invoke-AvmTerraformDocs -Context $context -AllowPathFallback:$AllowPathFallback -OutputFile $OutputFile -CheckDrift:$CheckDrift

        }

        default {

            throw [AvmContextException]::new(

                "Cannot docs: unknown ecosystem '$($context.Ecosystem)'.")

        }

    }

}

# SIG # Begin signature block

# MIInUwYJKoZIhvcNAQcCoIInRDCCJ0ACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCz3bW0zmvtsOeG

# job3GzhyL4XcOJuI5rgHsxseslPFeaCCDMkwggYEMIID7KADAgECAhMzAAACHPrN

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

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIFtbhUkvJgE+lnTCZxnj7i8g33wh

# C5XiFrYtDS1RJqdTMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv

# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE

# ggEAAevqW7YG7F1qjJKZXbuFl1WwUt0JQugyHV+o39Jo0m7lhgLl0P3i4lgtquaW

# Xioofy5hn54RDBRrNDTyDREoLClbbAIO2XbtYZoRefcxHQWVIxPSLs9U8kyLeVyK

# arJoVLfw05DrHHImYu2j2pPx0gN9dCWSP6ZFEO+ZMRAKcHbYajUxp9jGJY6k/2RR

# O1On6cLnzUYPy04zUi/UfwHS0JuNANlikV7fhg3rLlVZVWzA7l8RVN67QO8N0MWq

# vpkybxB4pfsW9vymK7HybM03iM3RfokhKM4+HgIFPyWscJF//4cskOtKGaL9QODz

# Z9V7ZEIYRTl7YtN8IisOWCC3QqGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gG

# CSqGSIb3DQEHAqCCF4kwgheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG

# 9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC

# AQUABCDRi+L2zYxP/A+RrahCHeCUaaspjoXmjWSg1iZ2tNK8DQIGavNpRv2sGBMy

# MDI2MTExMzE1NDMzOS43NjhaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu

# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjoy

# RDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy

# dmljZaCCEf4wggcoMIIFEKADAgECAhMzAAACN6Qdd0mCnHcGAAEAAAI3MA0GCSqG

# SIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI2MTAx

# NTE4Mzc0NloXDTI4MDExMTE4Mzc0NlowgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjJEMUEtMDVF

# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIC

# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAszNbmuzfKciH9SLDWQDQ9yVs

# eAl1rHad7QC/zdHEBQR+aZ9cWJ384M4c+8oOBczU3ccEAuWGlK1bLsf9uMAUGdqt

# ehE98QSnGlkOZ4aY1Zg8xarJbA5aS7uYm6Ezj4sJGFIZfvY7Yubvi9cYAbTuO9vM

# v2COEDzbQdEWA9plbugqewJ87bHzWRQdecBQgbT0EMR2tIE8SfIC+UQWLqNNh8IC

# nDsPVVtT72pBJBhmih6z+AH5W6aq26FQ/nRDifA0xn/MAf+yYi09AvsqOFm6co0q

# pkREfyxVoADVfW/6m8lzh3MtOsv3v7skCcJaYYl5P/Tr5LL9hmAAhvJzXFKJ1xJf

# a5xNXB/5eCFpOBXos1sWIbEXSVCG0YimOflUfD7FXSdwr6TFHiKMi1n1swNGxPSJ

# /g1FkAmOPuP4vB+pyHr18rB0D8Z7xkhOfG3W0CF8kncdM5h+xCNJv/u4gOUj4dda

# zy7Aufi73hIjBYTLex+LwC0shNMFBPY0I68IWn5M58xLd8vKH3tW+4kkyYrYl9Op

# dqdaQFcpzH8FmMRf0H3zdJvWsot9iLg8r1coMkp6VjeNI04kzWg0kjRq1yz1dO5Q

# W/cFOyeKNIeGw3PaEpy7fK8Dnnl5h+xpllOU1eXNck0148WO0r757orPD0psSQVN

# eL8VDi5LwOvp/k2AVgcCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBRZmI/sEPTenZlq

# CN70CVGEgtnDxDAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNV

# HR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2Ny

# bC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYI

# KwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAy

# MDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMI

# MA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAc6waDB7TBHE+3qef

# xRhVfwck3ga4MyGisXiOFe+BzJUuQAsQQ7LIOyMgoo73/2vWUEc/iktuaML0buf7

# UABr5IJugtjcJ8a25ppREt7BkfEluJ0pKzpSNyoFeO01Jw4ODUEJ5smmuaENf2YN

# J1aXiKnCVwZi2kkzxr1VCxk9Az8O2eFLMXMJyxwoFJJz5J2LklbAB/f/CtIVMIMH

# CDdEmCnRg/kTvDasd9Ux+UqwSYyt6jzfq+JI9iads3kCYk+BB/izrdGQdGFvXgat

# E0bRfguxZs7DuoMOEjekW2ClqGfMF5gMxDYO9QTlF7WAZY1vcg3adICghgwvn/yB

# Mr9idOAxr/O6rV3WZ2fK2VibCyBfvVjsdwqBpd7V3E659nHGtq2hrhH6JHhoHWvn

# EDZr70bQEcmU68hkqZu/frHGR3TwKo9+X7qSmxMyF4fQp8Sxrd/0MKTQnR8jEzhw

# 6/i/XVBSMAWKK6M+huPiel0rQLzCDT+JkvisF9N6FCIwGAlvHTZqDPE5MDG4DKdg

# Z2UQvdruPeLIajpf6N09qBIfAntZHzsVT6Ramzwn8fmF/eiCsuXaA5fToSjxZRgS

# GBQgobJ4AIyatsFTMSt19kVlgbV9Deycfd43rrc7f7GXwdsy3QU3U7PmDKrXyblK

# VIZOHaGeNuXQzFqMw3DoxNYyo6QwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZ

# AAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0

# ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVa

# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT

# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEF

# AAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1

# V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9

# alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmv

# Haus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928

# jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3t

# pK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEe

# HT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26o

# ElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4C

# vEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ug

# poMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXps

# xREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0C

# AwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYE

# FCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtT

# NRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNo

# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5o

# dG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBD

# AEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZW

# y4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5t

# aWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAt

# MDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0y

# My5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pc

# FLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpT

# Td2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0j

# VOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3

# +SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmR

# sqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSw

# ethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5b

# RAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmx

# aQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsX

# HRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0

# W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0

# HVUzWLOhcGbyoYIDWTCCAkECAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu

# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjoy

# RDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy

# dmljZaIjCgEBMAcGBSsOAwIaAxUA74B+BZVincdKNDfX/wQ7r43ctXiggYMwgYCk

# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIF

# AO6hMxQwIhgPMjAyNjExMTMwNjU2MjBaGA8yMDI2MTExNDA2NTYyMFowdzA9Bgor

# BgEEAYRZCgQBMS8wLTAKAgUA7qEzFAIBADAKAgEAAgIVnQIB/zAHAgEAAgITNzAK

# AgUA7qKElAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB

# AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQCGNC1W+8u6bhGi

# Vlhr+/IB0ldpCiBDt6Qf5tug55fr2xHrNGLrVPFYGgXQvxprB1oGAjRka7K2KMu6

# xis+KG0KvUR9jBdMwWf0jKrEECcWYVGNHVGFBocqrxFTQxTjzEvm4IvYRSEYeo3w

# fBoo/iojAXoRwUXar/tPnbMXyXyZHu45QH0hsPdVxZJ1cQArKPFbPxVs0Yz5Sz9C

# 7SuuFtv5Zv3IuswvBcrnRXyPO7B8IQF/lJYt9jbEBWlDTTqAeggBcDsy3Ua9wTWE

# fZV3F8S/IVTZghP+TmdmWOjzW2XTc9q3uyTr6beiLAkfwYoOkjQwsM8j7tFWTtHX

# vDQKeUL3MYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTACEzMAAAI3pB13SYKcdwYAAQAAAjcwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqG

# SIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgud10dj6k0TrT

# exE4mNo0h8ZaBnBeWe4VNSLlmlJhl60wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHk

# MIG9BCBQT0oArWPGTDfOHeKTKAbqzK9WDbGwLQrUj33wter19TCBmDCBgKR+MHwx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p

# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACN6Qdd0mCnHcGAAEAAAI3

# MCIEIAYtFeyAZz4M6rNeKubVrxAbM4gbvE05mSE7VXz016atMA0GCSqGSIb3DQEB

# CwUABIICAHkQ881bRVUdyRLdJ3jjtQ8ORITql0CG+fOVl9feIDA+8b9yf2PQR6j6

# /jEk4HUmmcAoXwk7B122ngXJXaDKVPCi3edJTDMUCivieg75Kh2IgSK3MkTielQi

# ha6uBi3lpqXjeA91RK8gHWw5GyulByTKBc+Y8NGS9jSvQL9fczRtS8n3XabXwWcU

# wGlJUocIvjJAEsz2DtWkSGWxiPlHG13cB0/FnSwNmsUIBbuo7mWs9vLk/6o565MO

# yw1Ul6A963YV00ClFQBP+GLTluY5B0tKB5l39JdpITjvmFvr01FWoQyOsVYQYt0F

# f5YzdCNHTskbdOa2V7Hdklyl86PziXFQD59ywHTySLViCwpZTsCe5HRodm+bL69N

# X0FHX5wktvupyZtAoVlIp8N1SmdC/qdu4kxSpHZGzvX3tDCUWX4ErVgwbdRwloKY

# GexBsi42tomCEmwpfhM35pst70zaj8CDc9gmPHewX1ZPrRadIAjhnzzR8O3qkzYw

# +EtwJzlectDdS1tlIA0SNtnv0gb29SQdnfjDzdBeUHl3eH7Ma1q4Syb9eZxoX4DF

# L8memUrCdT1BUlwb6LttldK4zNv3EZlNDtWZMKvRkFZrVUGX48Q0nlzlZ3ZA+c7o

# tDQ3/M5IophGg4IhN/Yt2rvYkL5xElSUkMiJCbhoP+ms/ilEtGeZ

# SIG # End signature block