Add Arkansas LIHEAP summer regular cooling assistance

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

@@ -0,0 +1 @@
+Add Arkansas LIHEAP summer regular cooling assistance.

changelog.d/ar-liheap-cooling.fixed.md

@@ -0,0 +1 @@
+Stop Arkansas LIHEAP income limits at the federal maximum, the greater of HHS's 60% state median income amount and 150% of the poverty guideline.

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

@@ -4,6 +4,7 @@ values:
     - ak_hap  # Alaska Heating Assistance Program
     - al_liheap  # Alabama LIHEAP
     - ar_liheap  # Arkansas LIHEAP
+    - ar_liheap_cooling  # Arkansas LIHEAP cooling
     - az_liheap  # Arizona LIHEAP
     # California's three components are exclusive by eligibility, so their sum is its single regular payment.
     - ca_liheap_utility_heating  # California HEAP utility heating

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/payment/household_size_group.yaml

@@ -1,4 +1,4 @@
-description: Arkansas uses these household size group boundaries for the regular heating benefit under the Low Income Home Energy Assistance Program.
+description: Arkansas uses these household size group boundaries for the winter and summer regular benefits under the Low Income Home Energy Assistance Program.
 brackets:
   - threshold:
       2024-10-01: 0

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/payment/income_band.yaml

@@ -1,4 +1,4 @@
-description: Arkansas uses these monthly countable income band boundaries for the regular heating benefit under the Low Income Home Energy Assistance Program.
+description: Arkansas uses these monthly countable income band boundaries for the winter and summer regular benefits under the Low Income Home Energy Assistance Program.
 # Published lower bounds are inclusive and apply to monthly countable income
 # rounded to the nearest whole dollar. Bands with one threshold entry apply in
 # both FY2025 and FY2026; the top five lower bounds changed in FY2026.

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/payment/matrix/electricity.yaml

@@ -1,4 +1,4 @@
-description: Arkansas provides this regular heating benefit for households using electricity under the Low Income Home Energy Assistance Program.
+description: Arkansas provides this regular benefit for households heating with electricity in winter and for every household in summer under the Low Income Home Energy Assistance Program.
 # Cells with one entry apply in both FY2025 and FY2026.
 
 1:
@@ -340,3 +340,5 @@ metadata:
       href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Benefit-Matix_2026_Electric.pdf#page=1
     - title: "Arkansas FY2025 Benefits Matrix, Electricity #page 1-2"
       href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Benefit-Matix_2025_Electric.pdf#page=1
+    - title: Arkansas FFY 2025 LIHEAP Policy and Procedures Manual, Section 6.1
+      href: https://liheapch.acf.gov/docs/2025/manuals/AR_Manual_2025.pdf#page=78

policyengine_us/programs.yaml

@@ -1061,7 +1061,15 @@ programs:
         full_name: Arkansas Low Income Home Energy Assistance Program
         variable: ar_liheap
         parameter_prefix: gov.states.ar.ee.aeo.liheap
-        notes: FY2025-FY2026 regular heating matrices and income limits are checked; income rules follow the FFY 2025 manual (no FY2026 manual was found), and other years are unverified. Crisis, cooling, weatherization and equipment assistance are out of scope.
+        notes: FY2025-FY2026 regular heating matrices and income limits are checked; income rules follow the FFY 2025 manual (no FY2026 manual was found), and other years are unverified. Summer cooling is the separate Arkansas LIHEAP cooling entry; crisis, weatherization and equipment assistance are out of scope.
+      - state: AR
+        status: partial
+        name: Arkansas LIHEAP cooling
+        full_name: Arkansas Low Income Home Energy Assistance Program summer regular cooling assistance
+        variable: ar_liheap_cooling
+        parameter_prefix: gov.states.ar.ee.aeo.liheap
+        verified_years: "2025-2026"
+        notes: FY2025-FY2026 summer regular benefit from the Electricity matrix, paid once per summer on the electric bill or, for unsubsidized renters, through utilities included in rent; the planned FY2027 increase has no posted matrix. Summer crisis and equipment are out of scope.
       - state: AZ
         status: partial
         name: Arizona LIHEAP

policyengine_us/tests/policy/baseline/gov/states/ar/ee/aeo/liheap/ar_liheap.yaml

@@ -32,7 +32,7 @@
   output:
     ar_liheap_household_size: 2
     ar_liheap_countable_income: 4_800
-    ar_liheap_income_limit: 36_840
+    ar_liheap_income_limit: 36_834
     ar_liheap_matrix_amount: 227
     ar_liheap: 227
 
@@ -120,7 +120,8 @@
   output:
     ar_liheap: [308, 0]
 
-# FY2025: wages 21000x0.8=16800, MCI 1400; size-one limit 2251 (x12=27012).
+# FY2025: wages 21000x0.8=16800, MCI 1400; size-one limit 27011 (chart 2251 x12=27012, stopped at
+# HHS's FY2025 60% state median income amount).
 # FFY2025 electric row 1390-1449 pays 91 for 1&2 (the FY2026 row pays 88).
 - name: Case 6, FY2025 electric grant for a one person household.
   period: 2025
@@ -144,7 +145,7 @@
   output:
     ar_liheap_household_size: 1
     ar_liheap_countable_income: 16_800
-    ar_liheap_income_limit: 27_012
+    ar_liheap_income_limit: 27_011
     ar_liheap_eligible: true
     ar_liheap_matrix_amount: 91
     ar_liheap: 91
@@ -187,6 +188,7 @@
     ar_liheap: 64
 
 # Boundary: FY2025 size 7 uses 150% FPG, 47340x1.5/12=5917.50 -> 5918 (x12=71016); 60% SMI would be 5844.
+# The federal maximum, 150% of the 2024 guideline (47340x1.5=71010), stops the limit at 71010.
 # Wages (50000+38500)x0.8=70800, MCI 5900, so eligible; FFY2025 electric 5140-Max pays 60 for 5&up.
 - name: Case 8, FY2025 seven person household between the SMI and FPG limits is paid.
   period: 2025
@@ -235,13 +237,13 @@
   output:
     ar_liheap_household_size: 7
     ar_liheap_countable_income: 70_800
-    ar_liheap_income_limit: 71_016
+    ar_liheap_income_limit: 71_010
     ar_liheap_eligible: true
     ar_liheap_matrix_amount: 60
     ar_liheap: 60
 
 # FY2025 Medicare-net Social Security (plan 1.9 p6; manual 4.7.2 p59): 2025 Part B 185x12=2220;
-# 26400-2220=24180, MCI 2015; size-one limit 27012; FFY2025 gas 2010-2129 pays 73 for 1&2.
+# 26400-2220=24180, MCI 2015; size-one limit 27011; FFY2025 gas 2010-2129 pays 73 for 1&2.
 - name: Case 9, FY2025 Social Security net of the Part B premium sets the gas grant.
   period: 2025
   input:
@@ -265,7 +267,7 @@
   output:
     ar_liheap_household_size: 1
     ar_liheap_countable_income: 24_180
-    ar_liheap_income_limit: 27_012
+    ar_liheap_income_limit: 27_011
     ar_liheap_eligible: true
     ar_liheap_matrix_amount: 73
     ar_liheap: 73
@@ -484,7 +486,7 @@
 
 # Current application section III excludes under-18 earnings whether or not the member
 # attends school, so countable income is 0. The FY2026 natural gas matrix awards 308 at
-# zero income for size two (limit 3_070 x 12 = 36_840).
+# zero income for size two (limit 36_834, HHS's 60% state median income amount).
 - name: Case 17, age 17 nonstudent earnings determine the final heating award.
   period: 2026
   input:
@@ -511,13 +513,13 @@
         state_code: AR
   output:
     ar_liheap_countable_income: 0
-    ar_liheap_income_limit: 36_840
+    ar_liheap_income_limit: 36_834
     ar_liheap_eligible: true
     ar_liheap: 308
 
 # At 18, a member who is not in high school (manual section 4.7, p56) or college
 # reports work income: wages 48_000 x 0.8 = 38_400 exceed the two-person FY2026 limit
-# 36_840, so no grant is paid.
+# 36_834, so no grant is paid.
 - name: Case 18, age 18 nonstudent earnings determine the final heating award.
   period: 2026
   input:
@@ -545,7 +547,7 @@
         state_code: AR
   output:
     ar_liheap_countable_income: 38_400
-    ar_liheap_income_limit: 36_840
+    ar_liheap_income_limit: 36_834
     ar_liheap_eligible: false
     ar_liheap: 0
 

policyengine_us/tests/policy/baseline/gov/states/ar/ee/aeo/liheap/cooling/ar_liheap_cooling.yaml

@@ -0,0 +1,160 @@
+# Arkansas summer regular (cooling) benefit: FFY 2025 manual section 6.1 (p78) uses the
+# Electricity matrix "for both Winter and Summer Regular Assistance". Wages are full time
+# at the $11.00 Arkansas minimum wage: 11 x 40 x 52 = 22_880. The 20% earned disregard
+# gives 22_880 x 0.8 = 18_304; MCI 1_525.33 rounds to 1_525 (x12 = 18_300). The $1,800
+# electric bill shows that the household pays its own electric bill, which the summer grant
+# pays; the bill does not change the grant. TEA is pinned to 0, as in the heating tests.
+
+# FY2026: size three uses the 3&4 column; the size-three limit is 45_501, HHS's 60% state
+# median income amount, which is below the chart's 3_792 x 12 = 45_504.
+# Electric row 1510-1569 pays 114 for 3&4.
+- name: Case 1, a minimum wage parent with two children receives the 3 and 4 person summer grant.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 32
+        immigration_status: CITIZEN
+        ssi: 0
+        employment_income_before_lsr: 22_880
+      person2:
+        age: 9
+        immigration_status: CITIZEN
+        ssi: 0
+      person3:
+        age: 6
+        immigration_status: CITIZEN
+        ssi: 0
+    spm_units:
+      spm_unit:
+        members: [person1, person2, person3]
+        heating_type: NATURAL_GAS
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+        ar_tea: 0
+    households:
+      household:
+        members: [person1, person2, person3]
+        state_code: AR
+  output:
+    ar_liheap_household_size: 3
+    ar_liheap_countable_income: 18_300
+    ar_liheap_income_limit: 45_501
+    ar_liheap_cooling_eligible: true
+    ar_liheap_cooling: 114
+
+# FY2026: zero income falls in the 0-69 row; size five uses the 5 & UP column, which pays
+# the 344 maximum (plan section 3.6, p13). The size-five limit is 5_236 x 12 = 62_832.
+- name: Case 2, a five person household with no income receives the maximum summer grant.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 40
+        immigration_status: CITIZEN
+        ssi: 0
+      person2:
+        age: 39
+        immigration_status: CITIZEN
+        ssi: 0
+      person3:
+        age: 12
+        immigration_status: CITIZEN
+        ssi: 0
+      person4:
+        age: 8
+        immigration_status: CITIZEN
+        ssi: 0
+      person5:
+        age: 4
+        immigration_status: CITIZEN
+        ssi: 0
+    spm_units:
+      spm_unit:
+        members: [person1, person2, person3, person4, person5]
+        heating_type: PROPANE
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 2_400
+        ar_tea: 0
+    households:
+      household:
+        members: [person1, person2, person3, person4, person5]
+        state_code: AR
+  output:
+    ar_liheap_household_size: 5
+    ar_liheap_countable_income: 0
+    ar_liheap_income_limit: 62_832
+    ar_liheap_cooling: 344
+
+# Boundary: printed lower bounds are inclusive. MCI 69 (828 / 12) is the top of the 0-69
+# row, which pays 242 for 1&2; MCI 70 (840 / 12) starts the 70-129 row, which pays 233.
+- name: Case 3, the band top and the next band start set the one person summer grant.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    state_code: [AR, AR]
+    age: [30, 30]
+    immigration_status: [CITIZEN, CITIZEN]
+    ssi: [0, 0]
+    heating_type: [ELECTRICITY, ELECTRICITY]
+    has_cooling_expense: [true, true]
+    pre_subsidy_electricity_expense: [1_800, 1_800]
+    ar_liheap_countable_income: [828, 840]
+  output:
+    ar_liheap_cooling: [242, 233]
+
+# FY2025: MCI 1_525 (x12 = 18_300) is within the 27_011 size-one limit. The FFY 2025
+# electric row 1,510-1,569 pays 84 for 1&2 (the FY2026 row pays 77). With electric heat
+# the winter grant reads the same cell, so the household receives 84 in each season, and
+# the national LIHEAP total is 84 + 84 = 168.
+- name: Case 4, FY2025 summer grant for a one person household with electric heat.
+  period: 2025
+  absolute_error_margin: 0.01
+  input:
+    people:
+      person1:
+        age: 45
+        immigration_status: CITIZEN
+        ssi: 0
+        employment_income_before_lsr: 22_880
+    spm_units:
+      spm_unit:
+        members: [person1]
+        heating_type: ELECTRICITY
+        has_cooling_expense: true
+        pre_subsidy_electricity_expense: 1_800
+        ar_tea: 0
+    households:
+      household:
+        members: [person1]
+        state_code: AR
+  output:
+    ar_liheap_countable_income: 18_300
+    ar_liheap_income_limit: 27_011
+    ar_liheap_cooling_eligible: true
+    ar_liheap_cooling: 84
+    ar_liheap: 84
+    liheap: 168
+
+# The summer program pays electric benefits only (manual section 2.1, p29), so the heating
+# fuel does not matter: gas heat and no heat both receive the FY2026 1&2 cell for MCI
+# 1_525 (row 1510-1569), 77.
+- name: Case 5, the summer grant does not depend on the heating fuel.
+  period: 2026
+  absolute_error_margin: 0.01
+  input:
+    state_code: [AR, AR]
+    age: [45, 45]
+    immigration_status: [CITIZEN, CITIZEN]
+    ssi: [0, 0]
+    ar_tea: [0, 0]
+    employment_income_before_lsr: [22_880, 22_880]
+    heating_type: [NATURAL_GAS, NONE]
+    has_cooling_expense: [true, true]
+    pre_subsidy_electricity_expense: [1_800, 1_800]
+  output:
+    ar_liheap_countable_income: [18_300, 18_300]
+    ar_liheap_cooling_eligible: [true, true]
+    ar_liheap_cooling: [77, 77]