Avm.Authoring

0.8.0

Engines/ManagedFiles/Merge-AvmFileLine.ps1

                                function Get-AvmManagedLineSpecFileName {

    <#

    .SYNOPSIS

        The sentinel file name that carries a line-managed-file spec inside a

        managed-files overlay directory.

    .DESCRIPTION

        The spec lives beside the overlay content (in 'root' and each group

        overlay) so it stacks per repository group exactly like the files

        themselves. It is tooling metadata, not synced content, so

        Add-AvmManagedFilesFromDir filters it out of the managed-files map the

        same way it filters '.gitkeep'.

    #>

    [OutputType([string])]

    param()

    return '.avm-managed-lines.json'

}

function Merge-AvmFileLine {

    <#

    .SYNOPSIS

        Line-level merge: ensure every required line is present and every removed

        line is absent, preserving all other existing lines and their order.

    .DESCRIPTION

        Pure function (no I/O). Matching is exact on the trimmed line text and

        case-sensitive. Required lines that are already present are left in place;

        genuinely missing ones are appended at the end in declaration order.

        Every occurrence of a removed line is deleted. Blank lines are never

        removed. The operation is idempotent: re-running over its own output

        reports no change.

        A line supplied in both Required and Removed is a contradiction and

        throws, so a bad spec fails loudly rather than resolving silently.

    .OUTPUTS

        pscustomobject with Lines (string[]), Added (string[]),

        Removed (string[]), and Changed (bool).

    #>

    [CmdletBinding()]

    [OutputType([pscustomobject])]

    param(

        [string[]] $ExistingLine = @(),

        [string[]] $Required = @(),

        [string[]] $Removed = @()

    )

    Set-StrictMode -Version 3.0

    $existing = @($ExistingLine)

    $required = @($Required)

    $removed = @($Removed)

    $removedSet = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::Ordinal)

    foreach ($item in $removed) {

        if ($null -eq $item) { continue }

        $trimmed = ([string]$item).Trim()

        if ($trimmed.Length -eq 0) { continue }

        [void]$removedSet.Add($trimmed)

    }

    foreach ($item in $required) {

        if ($null -eq $item) { continue }

        $trimmed = ([string]$item).Trim()

        if ($removedSet.Contains($trimmed)) {

            throw [System.ArgumentException]::new(

                "Line '$trimmed' appears in both 'required' and 'removed'; a managed-line spec entry cannot require and remove the same line.")

        }

    }

    $kept = New-Object System.Collections.Generic.List[string]

    $removedLines = New-Object System.Collections.Generic.List[string]

    $presentTrimmed = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::Ordinal)

    foreach ($line in $existing) {

        $value = if ($null -eq $line) { '' } else { [string]$line }

        $trimmed = $value.Trim()

        if ($trimmed.Length -gt 0 -and $removedSet.Contains($trimmed)) {

            $removedLines.Add($value)

            continue

        }

        $kept.Add($value)

        if ($trimmed.Length -gt 0) { [void]$presentTrimmed.Add($trimmed) }

    }

    $addedLines = New-Object System.Collections.Generic.List[string]

    foreach ($item in $required) {

        if ($null -eq $item) { continue }

        $value = [string]$item

        $trimmed = $value.Trim()

        if ($trimmed.Length -eq 0) { continue }

        if ($presentTrimmed.Contains($trimmed)) { continue }

        $kept.Add($value)

        $addedLines.Add($value)

        [void]$presentTrimmed.Add($trimmed)

    }

    return [pscustomobject][ordered]@{

        Lines   = $kept.ToArray()

        Added   = $addedLines.ToArray()

        Removed = $removedLines.ToArray()

        Changed = (($addedLines.Count -gt 0) -or ($removedLines.Count -gt 0))

    }

}

function Get-AvmManagedLineSpec {

    <#

    .SYNOPSIS

        Collect and stack the line-managed-file spec across a repository's

        managed-file groups.

    .DESCRIPTION

        Reads one '<base>/<group>/.avm-managed-lines.json' per file group, in

        the same order Build-AvmManagedFilesMap applies the groups. Each spec is

        a flat JSON map of forward-slash relative path ->

        { required: [...], removed: [...] }.

        Entries stack per line with last-writer-wins: a later group that

        requires a line cancels an earlier group that removed it, and vice

        versa, mirroring how later group files win over earlier ones. Within a

        single spec file a line in both 'required' and 'removed' is a

        contradiction and throws.

    .OUTPUTS

        An ordered hashtable keyed by relative path; each value is a

        pscustomobject with Required (string[]) and Removed (string[]).

    #>

    [CmdletBinding()]

    [OutputType([System.Collections.Specialized.OrderedDictionary])]

    param(

        [Parameter(Mandatory)]

        [string] $BaseDir,

        [string[]] $FileGroups = @()

    )

    Set-StrictMode -Version 3.0

    $specFileName = Get-AvmManagedLineSpecFileName

    $dirs = New-Object System.Collections.Generic.List[string]

    foreach ($fileGroup in $FileGroups) {

        if ([string]::IsNullOrWhiteSpace($fileGroup)) { continue }

        $dirs.Add((Join-Path $BaseDir $fileGroup))

    }

    $spec = [ordered]@{}

    foreach ($dir in $dirs) {

        $specFile = Join-Path $dir $specFileName

        if (-not (Test-Path -LiteralPath $specFile -PathType Leaf)) { continue }

        $raw = Get-Content -LiteralPath $specFile -Raw

        if ([string]::IsNullOrWhiteSpace($raw)) { continue }

        try {

            $parsed = $raw | ConvertFrom-Json

        }

        catch {

            throw [System.InvalidOperationException]::new(

                "Managed-line spec '$specFile' is not valid JSON: $($_.Exception.Message)")

        }

        if ($null -eq $parsed) { continue }

        foreach ($property in $parsed.PSObject.Properties) {

            $targetPath = ($property.Name -replace '\\', '/').Trim()

            if ([string]::IsNullOrWhiteSpace($targetPath)) { continue }

            $entry = $property.Value

            if ($null -eq $entry) { continue }

            $required = @()

            $removed = @()

            if ($entry.PSObject.Properties.Name -contains 'required' -and $entry.required) {

                $required = @($entry.required)

            }

            if ($entry.PSObject.Properties.Name -contains 'removed' -and $entry.removed) {

                $removed = @($entry.removed)

            }

            $fileRequired = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::Ordinal)

            foreach ($r in $required) {

                if ($null -eq $r) { continue }

                $t = ([string]$r).Trim()

                if ($t.Length -gt 0) { [void]$fileRequired.Add($t) }

            }

            foreach ($r in $removed) {

                if ($null -eq $r) { continue }

                $t = ([string]$r).Trim()

                if ($t.Length -gt 0 -and $fileRequired.Contains($t)) {

                    throw [System.InvalidOperationException]::new(

                        "Managed-line spec '$specFile' lists line '$t' for '$targetPath' in both 'required' and 'removed'.")

                }

            }

            if (-not $spec.Contains($targetPath)) {

                $spec[$targetPath] = [pscustomobject]@{

                    Required = (New-Object System.Collections.Generic.List[string])

                    Removed  = (New-Object System.Collections.Generic.List[string])

                }

            }

            $bucket = $spec[$targetPath]

            foreach ($r in $required) {

                if ($null -eq $r) { continue }

                $value = [string]$r

                $trimmed = $value.Trim()

                if ($trimmed.Length -eq 0) { continue }

                for ($i = $bucket.Removed.Count - 1; $i -ge 0; $i--) {

                    if ($bucket.Removed[$i].Trim() -ceq $trimmed) { $bucket.Removed.RemoveAt($i) }

                }

                if (-not ($bucket.Required | Where-Object { $_.Trim() -ceq $trimmed })) {

                    $bucket.Required.Add($value)

                }

            }

            foreach ($r in $removed) {

                if ($null -eq $r) { continue }

                $value = [string]$r

                $trimmed = $value.Trim()

                if ($trimmed.Length -eq 0) { continue }

                for ($i = $bucket.Required.Count - 1; $i -ge 0; $i--) {

                    if ($bucket.Required[$i].Trim() -ceq $trimmed) { $bucket.Required.RemoveAt($i) }

                }

                if (-not ($bucket.Removed | Where-Object { $_.Trim() -ceq $trimmed })) {

                    $bucket.Removed.Add($value)

                }

            }

        }

    }

    $result = [ordered]@{}

    foreach ($key in $spec.Keys) {

        $result[$key] = [pscustomobject]@{

            Required = $spec[$key].Required.ToArray()

            Removed  = $spec[$key].Removed.ToArray()

        }

    }

    return $result

}

function Get-AvmManagedLinePlan {

    <#

    .SYNOPSIS

        Compute the per-file line-merge plan for a resolved line-managed-file

        spec against a working tree, without writing anything.

    .DESCRIPTION

        For each spec path it reads the current file (if any), detects the

        dominant line ending, and computes the merged content via

        Merge-AvmFileLine. A missing file is treated as empty so required lines

        create it (new files use LF); an existing file keeps its own line ending.

        All content is read and written as UTF-8 without a BOM.

    .OUTPUTS

        An array of pscustomobject, one per spec path, with Path, Full, Existed,

        Changed, AddedLines, RemovedLines, and NewText.

    #>

    [CmdletBinding()]

    [OutputType([pscustomobject[]])]

    param(

        [Parameter(Mandatory)]

        [string] $Root,

        [Parameter(Mandatory)]

        [System.Collections.Specialized.OrderedDictionary] $Spec

    )

    Set-StrictMode -Version 3.0

    $utf8NoBom = [System.Text.UTF8Encoding]::new($false)

    $plans = New-Object System.Collections.Generic.List[object]

    foreach ($targetPath in $Spec.Keys) {

        $entry = $Spec[$targetPath]

        $full = Join-Path $Root ($targetPath.Replace('/', [System.IO.Path]::DirectorySeparatorChar))

        $existed = Test-Path -LiteralPath $full -PathType Leaf

        $newline = "`n"

        $existingLines = @()

        if ($existed) {

            $text = $utf8NoBom.GetString([System.IO.File]::ReadAllBytes($full))

            if ($text.Length -gt 0 -and $text[0] -eq [char]0xFEFF) { $text = $text.Substring(1) }

            if ($text.Contains("`r`n")) { $newline = "`r`n" }

            $existingLines = @([regex]::Split($text, "`r`n|`n|`r"))

            if ($existingLines.Count -gt 0 -and $existingLines[-1] -eq '') {

                if ($existingLines.Count -eq 1) {

                    $existingLines = @()

                }

                else {

                    $existingLines = @($existingLines[0..($existingLines.Count - 2)])

                }

            }

        }

        $merge = Merge-AvmFileLine -ExistingLine $existingLines -Required $entry.Required -Removed $entry.Removed

        $newText = ''

        if ($merge.Lines.Count -gt 0) { $newText = ($merge.Lines -join $newline) + $newline }

        $plans.Add([pscustomobject][ordered]@{

                Path         = $targetPath

                Full         = $full

                Existed      = $existed

                Changed      = $merge.Changed

                AddedLines   = $merge.Added

                RemovedLines = $merge.Removed

                NewText      = $newText

            })

    }

    return $plans.ToArray()

}

# SIG # Begin signature block

# MIInKAYJKoZIhvcNAQcCoIInGTCCJxUCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCMYZhRUEccU6G7

# zHgXs/F2cgGDTgPAKEoO8hzkLmqf4KCCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# 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

# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnEMIIZwAIBATBuMFcxCzAJBgNVBAYTAlVT

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv

# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w

# DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ

# KoZIhvcNAQkEMSIEIJ3/15dGqAMKFV2mk58jxbjuTeJ1SWAfYJVbHZZgqziqMEIG

# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAY1vLZ2z8tvH2Cmin

# dQfHyPnt1kVGxKWtLEj4mJbx8RqRUHIdLsJ1bgMbF3fNAs5Q0rv2u0an5zQoAV0V

# 0vovm7WPtEjzEC49NrO1iQNCOfKIaFt0gxatSSVrZjNFRseNXkgqQhWjLuqQJmzU

# lFs+P0eEKtYeYf8KHuIwa0IcloegLmQR8b2iXr8GER8hdAWy0X6u+sQ4GmD7Whxl

# C6+2G77P/tIDDbbBvXsLjg3zEfya+GnhrKdcyQu4coTX+8IZLBAt9lOyFK6y3fL6

# tv4RbQBa8evSpIpWv08lt9ReUV6T5e6zez8/tYiJb6B3lHLGB12jIgbeZ4xAr+CM

# 2JZBNqGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20w

# ghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9

# MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCD8qBmxMsP5fjzS

# SOAb43D6hNZFvMz8Bj7C0OFNUij+WQIGal+CJ2NkGBMyMDI2MDgxMTIxMTUxOS44

# NzFaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw

# JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTIwMC0wNUUwLUQ5NDcxJTAjBgNVBAMT

# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgIT

# MwAAAiNP2WAkU8/+KwABAAACIzANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjAyMTkxOTM5NTdaFw0yNzA1MTcxOTM5NTda

# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046OTIwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCK

# 6Q2nk5WUdKzSCSafp+UjUARsWxHKS63rJhFC/zSabFumTBuaJ0QNrmqevub5Db7f

# Sj5qtwwKnjIO92+HXF67192fujL7DFot5WEj/AtEZ/XrzFHimKlN1h6gEQwP5I67

# wizaPW5ZzSBNpaLBg5oHvASPOZtwdNUoZ+DQKF3hJl1KZuoIlVK+qi7cLjgak6s5

# oOZcRCMrKnuC3aoVa6wRDbYvKUuj7rkFx9KO0PsHJ/k+LnZMggRheh4AVdawyh+o

# OzKPjlQGUNfSeWUgym2U9CLa8tt0mQX4DxDz6+ram50gj1oAfyQ6TQ7r96PADFOK

# BgaU7+cpHnaZG89dTegQ6ydBRGIycOw1dRX2eKDRRzziK3cn0WaIm/7OeGsyQKjI

# zEQuUTDv0Jj/9zQ7truLOOpJD98BJVOK7je84Sz2hb3HvUST7j1j2N8peD6olkpF

# HR/1Z8Jz4F+mkrUF7MmPAirYHRzunbIg3HrDMNwFYN7yBkDA4/VMo9CY0y9oGUoq

# 2yjbCwTibz9VYl93nB3QQiTCT9nW3M+TOWB+PMrZpExq1BSHmKPzIqehKqrUDoM3

# 3PK+dEKwpYLET6uXq4HuQRMXWT//sPubUnQAaaUMfQhAZSy23HtxwtN3eK9+T4wC

# av2wQFt57eUOwUW5/DCzMF9tua5He1hNvgcAXaiG1wIDAQABo4IBSTCCAUUwHQYD

# VR0OBBYEFNbAh89v29nPY9bwQb1QYCzxVgeXMB8GA1UdIwQYMBaAFJ+nFV0AXmJd

# g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El

# MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt

# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0l

# AQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUA

# A4ICAQCHQwe7z5tp4NZwAf1cB+4c9J4svw3P6WqGBMxtqznS6DdzUzStXHCaPZhM

# 41g1iKHNnmcnLjwLujOEaNjhSnUDiAZqQjW5ZapOBxgc7Egghh9k+r78qWAe3rJ4

# QohBbhSGdZtKivTRaeRqmnhy8+ThrKhzCeEwaarXJimZwSpdQQUDbheWHeyAxASq

# ultd5KO0m/UFvO03tfepqGXA4tCg/WGECwKqOjJzpRAfPIB6y1HyVrk+vmL5rpEb

# TwwLOtX7WxFGG8+cYLk9HjaDkxraA/HYlKQRx1sdza+w/gulLwgOnByRJKF2rr8M

# 7FNIlwoi6ywFpaNc8A7HewaGjgw/tfcE260I1XekGluANI9HnONOYWlI7BKBQbWE

# 2teo6vsQ1Vg8B8rTZSePVdmXL1PPqqs3KVdFKM5kYocPCDM+6VL32IV96sESf2T7

# DjxanpCg2D2UYj4Z1i7cy8U1LLDGg55KWs4af2RRBjH2MulHgAmW5obKxiZCDQjR

# aroJ2XElXUhigE9BzvhCFbT/HDY2vpVpl5HnSpcCSxmL5i5lIT/xbAQMI7Luh75X

# rm+IslfFWOGOGMlCp+24qEJEglXEP7xwsolNdBNndXihhyIefVGlI1DR7xGELiJr

# k8ifVWYo9XEbEXv/lbvp6F2R2UsnweWckvq0y1HWnLHDqH6dPjCCB3EwggVZoAMC

# AQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m

# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIy

# NVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9

# DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2

# Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N

# 7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXc

# ag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJ

# j361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjk

# lqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37Zy

# L9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M

# 269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLX

# pyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLU

# HMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode

# 2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEA

# ATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYE

# FJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEB

# MEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# RG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEE

# AYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB

# /zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEug

# SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N

# aWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG

# AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jv

# b0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt

# 4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsP

# MeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++

# Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9

# QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2

# wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aR

# AfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5z

# bcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nx

# t67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3

# Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+AN

# uOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/Z

# cGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCB

# yzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMc

# TWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBU

# U1MgRVNOOjkyMDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1T

# dGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQA4RWFs+kTiZnoZiAj1BtYj8zCN

# aqCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3

# DQEBCwUAAgUA7iWtKzAiGA8yMDI2MDgxMTE0MTYxMVoYDzIwMjYwODEyMTQxNjEx

# WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDuJa0rAgEAMAcCAQACAgU/MAcCAQAC

# AhHlMAoCBQDuJv6rAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKg

# CjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAB6DmF0v

# rHWOPS6AglIiq+8VhA3pQ20wEK5UZg/L6XBzqENE7hWnM1o9rXh5lHw1yKGzcP9Z

# mr20wcj6cj5PM9m6hdnbWQzTfBWCo64UdvsNzRC+EprWp2ydCd4HhH0lJ0bRcroQ

# 4RvkrlpdbggSMu+CaFD7Ek44+uOBbOKQHyc3hOZbhYAG4viWTdLrA40W4YlbuZj9

# FTSpu3//O9JEA85LxbM5K/Jzphd6gNR2vGDaDvaF1dNPgZsZl50vEM6RIvDQjDoD

# uLjSuKMVLN6YLwR53ghc94rOzyEJUd7D1kcDQva4cKd+Z6BmMf2SK3ujob7yXpZF

# Di/62GWOuZrD6fQxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UE

# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z

# b2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQ

# Q0EgMjAxMAITMwAAAiNP2WAkU8/+KwABAAACIzANBglghkgBZQMEAgEFAKCCAUow

# GgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCA5fgZO

# ZHT1MbEG2jlKZiQErmQHG5me2U4JVu8eND4QaTCB+gYLKoZIhvcNAQkQAi8xgeow

# gecwgeQwgb0EIJbwMywRbvcGiynjnwjAqcaD47yYvebKZRAvtEAR5u6zMIGYMIGA

# pH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIjT9lgJFPP/isA

# AQAAAiMwIgQg5ZRVzDV1Hw1JQ20MhJ3wCVw7cjGF0pbFmxIWGjnyjAswDQYJKoZI

# hvcNAQELBQAEggIAMcr6NbMmbpehZTRybraB9G87RQSd7xpvJf+JOuN4Ga0q7hF6

# 73qiKjsHesDpOcCjo5H9EhEoe98xqEdd04kSM1PZRKLfWA5Zye5WP3SBoTSH+LzE

# ehiWHSXM0995ngt/ovBAQX6dp3leBhTonTFwPbeo33OQd+EqWpjW5tGtICP44P1b

# c86Z7UgOi5+Dc0u3eeGb3x1JvnbpAU0SYgB/clcfI4O8QE/68oAflolagIyMvq+D

# 7gNN7j62/gMcnXwXrqSPi0C7BmtlQGWvrPG1DzlG6NW22rCmMUsZ27NdT0RF5Wal

# DOrZ8TBJaDd6N+gQ1kXy1Y++RjZrXF+l6fRDGVLaU5LtmkLIwHu6PEX/DioqXJe0

# lcEhcVyw+duLuoKABIuWHTd7Pkb4P5dmJXnnGbKHBY6mpbgI03paijSBqUTnzDIA

# XPoyyCq/z2pgxG87qm2n1OIMorz3nsyxpgQ3uk9sFQWaf+sidCSm/eawBAUb9uYk

# OHiW67uqmL/OK+WjDFoV4lBIq2yofBw6Z1VWxCkqVeP3SV20XA1YbrG4UG7Z7HBT

# c6DX5G4St3mFzSR7OrrVK2mhgej4tIHjGtnCkeJ+mA66+8LVicbVKbsFeCb7ViSO

# Qk19aUe7DiijV9aK971YUMEBXuaeaRuzkFSERbqrIrI5/7NINLUE/HCirqw=

# SIG # End signature block