Add Virginia EAP cooling assistance electric bill payment

changelog.d/va-liheap-cooling.added.md

@@ -0,0 +1 @@
+Add Virginia Energy Assistance Program cooling assistance electric bill payment.

policyengine_us/parameters/gov/hhs/liheap/regular_payments.yaml

@@ -49,6 +49,7 @@ values:
     - tx_ceap  # Texas CEAP
     - ut_heat  # Utah HEAT
     - va_eap  # Virginia EAP
+    - va_eap_cooling  # Virginia EAP cooling
     - vt_liheap  # Vermont Seasonal Fuel Assistance
     - wa_liheap  # Washington LIHEAP
     - wi_wheap  # Wisconsin WHEAP

policyengine_us/parameters/gov/states/va/dss/eap/cooling/electric_bill_maximum.yaml

@@ -0,0 +1,26 @@
+description: Virginia limits cooling assistance electric bill payments to this amount per program year under the Energy Assistance Program.
+# The VDSS Home Office sets this maximum each year. Each value is dated to the
+# start of the federal fiscal year whose summer it covers. VDSS announced $600
+# for 2023; no amount was found for 2024, so 2024 carries the $600 forward. The
+# $365 for 2025 comes from press reports attributed to VDSS; no VDSS notice was
+# found for 2025, 2026 or 2027, so 2026 and 2027 carry the $365 forward. The
+# first value also backfills years before 2023, which are unverified.
+values:
+  2022-10-01: 600
+  2024-10-01: 365
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Virginia EAP cooling assistance electric bill payment maximum
+  reference:
+    - title: "Virginia Energy Assistance Manual, Volume IX, Chapter J.6 Authorizations, J.7.g Payment of Electric Bill and J.8 Cooling Assistance Benefits #page 123,127-129"
+      href: https://www.dss.virginia.gov/media/vdss/benefit-programs/documents/eap/Complete_Manual.pdf#page=123
+    - title: 22VAC40-680-63(C) Eligibility criteria; benefits
+      href: https://law.lis.virginia.gov/admincode/title22/agency40/chapter680/section63/
+    - title: VDSS news release, Cooling Assistance Application Period Underway (July 5, 2023), one-time $600 benefit for electric bills (Wayback Machine copy)
+      href: https://web.archive.org/web/20260413134008/https://dss.virginia.gov/files/division/pa/news_releases/2023/Cooling_Assistance_2023_ENG.pdf#page=1
+    - title: Press report, WYDaily, Cooling assistance available, application period underway (July 20, 2025), VDSS one-time $365 benefit for electric bills
+      href: https://wydaily.com/latest/regional-national/2025/07/20/cooling-assistance-available-application-period-underway/
+    - title: Press report, WRIC on WAVY (July 17, 2025), VDSS one-time $365 benefit for electric bills
+      href: https://digital-release.wavy.com/?p=2780089

policyengine_us/parameters/gov/states/va/dss/eap/cooling/fpg_year_lag.yaml

@@ -0,0 +1,19 @@
+description: Virginia uses federal poverty guidelines from this many years before the cooling season for the cooling assistance income limit under the Energy Assistance Program.
+# Virginia adopts each year's new 150% limits in June. They apply first to that
+# June's cooling assistance and then to heating in the next federal fiscal
+# year, so cooling in the summer of year Y uses the year Y guideline while
+# heating in federal fiscal year Y uses the year Y - 1 guideline. The value is
+# dated at the start of FFY2025, whose June 2025 cooling the matrix note
+# describes.
+values:
+  2024-10-01: 0
+
+metadata:
+  unit: year
+  period: year
+  label: Virginia EAP cooling assistance federal poverty guideline year lag
+  reference:
+    - title: LIHEAP Clearinghouse Virginia FY2026 benefit matrix, income limits note (the 150% limits "were used for Cooling Assistance in June of 2025")
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/VA_BenefitMatrix_2026.pdf#page=1
+    - title: Press report, WYDaily, State cooling assistance program helps residents with summer energy costs (June 15, 2026), 2026 limits of $1,995 a month for one person and $4,125 for four
+      href: https://wydaily.com/latest/2026/06/15/state-cooling-assistance-program-helps-residents-with-summer-energy-costs/

policyengine_us/programs.yaml

@@ -1395,7 +1395,15 @@ programs:
         variable: va_eap
         parameter_prefix: gov.states.va.dss.eap
         verified_years: "2026"
-        notes: FFY2026 Fuel Assistance only, using the latest published (FFY2025) value per point and placeholder fuel-type and energy-burden points until VDSS publishes its survey. Crisis, cooling and weatherization assistance are out of scope.
+        notes: FFY2026 Fuel Assistance only, using the latest published (FFY2025) value per point and placeholder fuel-type and energy-burden points until VDSS publishes its survey. Cooling assistance is the separate Virginia EAP cooling entry; crisis and weatherization assistance are out of scope.
+      - state: VA
+        status: partial
+        name: Virginia EAP cooling
+        full_name: Virginia Energy Assistance Program Cooling Assistance electric bill payment
+        variable: va_eap_cooling
+        parameter_prefix: gov.states.va.dss.eap.cooling
+        verified_years: "2025"
+        notes: Cooling Assistance electric bill payment up to the statewide maximum, $365 for 2025 from press reports and carried forward to 2026 and 2027. Cooling equipment, security deposits, crisis and weatherization assistance are out of scope.
       - state: VT
         status: partial
         name: Vermont Seasonal Fuel Assistance

policyengine_us/tests/policy/baseline/gov/states/va/dss/eap/cooling/va_eap_cooling.yaml

@@ -0,0 +1,200 @@
+# Virginia EAP cooling assistance electric bill payment: the electric bill up
+# to the year's statewide maximum (Complete EAP Manual J.6, J.7.g, J.8). The
+# maximum is $600 for 2023 (VDSS release) and $365 for 2025 (press reports),
+# carried forward to 2026 and 2027. Unless noted, the household is one
+# retiree aged 62 with $18,000 of Social Security, countable income
+# 18,000 - 600 = 17,400, under every year's one-person cooling limit, and a
+# $150 a month ($1,800 a year) electric bill, about the EIA 2024 Virginia
+# average residential bill of $148.77 a month (Electric Sales, Revenue, and
+# Average Price, Table 5A).
+
+- name: Case 1, an eligible retiree receives the 2025 maximum carried into 2026.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 62
+        social_security_retirement: 18_000
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: NATURAL_GAS
+        gas_expense: 900
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+    households:
+      household:
+        members: [person1]
+        state_code: VA
+  output:
+    # min(1,800, 365) = 365.
+    va_eap_cooling_eligible: true
+    va_eap_cooling: 365
+
+- name: Case 2, an eligible retiree receives the 2025 maximum.
+  period: 2025
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 62
+        social_security_retirement: 18_000
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: NATURAL_GAS
+        gas_expense: 900
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+    households:
+      household:
+        members: [person1]
+        state_code: VA
+  output:
+    # 17,400 <= 23,472 (2025 guideline); min(1,800, 365) = 365.
+    va_eap_cooling: 365
+
+- name: Case 3, the 2025 maximum carries forward to 2027.
+  period: 2027
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 62
+        social_security_retirement: 18_000
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: NATURAL_GAS
+        gas_expense: 900
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+    households:
+      household:
+        members: [person1]
+        state_code: VA
+  output:
+    va_eap_cooling: 365
+
+- name: Case 4, the 2023 maximum applies in 2023.
+  period: 2023
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 62
+        social_security_retirement: 18_000
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: NATURAL_GAS
+        gas_expense: 900
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+    households:
+      household:
+        members: [person1]
+        state_code: VA
+  output:
+    # 17,400 <= 21,864 (floor(14,580 x 1.5 / 12) = 1,822 x 12);
+    # min(1,800, 600) = 600.
+    va_eap_cooling: 600
+
+- name: Case 5, a bill below the maximum is paid in full.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 62
+        social_security_retirement: 18_000
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: NATURAL_GAS
+        gas_expense: 900
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 240
+    households:
+      household:
+        members: [person1]
+        state_code: VA
+  output:
+    # min(240, 365) = 240.
+    va_eap_cooling: 240
+
+- name: Case 6, income over the cooling limit receives nothing.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 62
+        social_security_retirement: 30_000
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: NATURAL_GAS
+        gas_expense: 900
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+    households:
+      household:
+        members: [person1]
+        state_code: VA
+  output:
+    # 30,000 - 600 = 29,400 > 23,940.
+    va_eap_cooling: 0
+
+- name: Case 7, a household without a separate cooling cost receives nothing.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 62
+        social_security_retirement: 18_000
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: NATURAL_GAS
+        gas_expense: 900
+        has_cooling_expense: false
+        pre_subsidy_electricity_expense: 1_800
+    households:
+      household:
+        members: [person1]
+        state_code: VA
+  output:
+    va_eap_cooling: 0
+
+# The Fairfax County retiree of the heating integration tests (Social Security
+# 11,736, countable 11,736 - 600 = 11,136, gas heat, 103 points x 4.531665 =
+# 466.76) also has a cooling cost and the $1,800 electric bill. Cooling pays
+# min(1,800, 365) = 365. The national LIHEAP total is 466.76 + 365 = 831.76.
+- name: Case 8, a retiree receives both the heating and the cooling payment.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    people:
+      head:
+        age: 65
+        social_security_retirement: 11_736
+        ssi: 0
+    spm_units:
+      spm_unit:
+        members: [head]
+        heating_type: NATURAL_GAS
+        gas_expense: 1_200
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+    households:
+      household:
+        members: [head]
+        state_code: VA
+        county: FAIRFAX_COUNTY_VA
+  output:
+    va_eap: 466.76
+    va_eap_cooling: 365
+    liheap: 831.76