Add Alabama LIHEAP regular heating assistance

changelog.d/al-liheap.added.md

@@ -0,0 +1 @@
+Add Alabama LIHEAP regular heating eligibility and payments, applying the HUD allowance before the supplement and requiring a positive remaining regular grant.

policyengine_us/parameters/gov/states/al/adeca/liheap/eligibility/fpg_rate.yaml

@@ -0,0 +1,10 @@
+description: Alabama limits income to this multiple of the federal poverty guideline under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 1.5
+metadata:
+  unit: /1
+  period: year
+  label: Alabama LIHEAP federal poverty guideline rate
+  reference:
+    - title: Alabama FY2026 LIHEAP State Plan, section 2.1
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AL_Plan_2026.pdf#page=8

policyengine_us/parameters/gov/states/al/adeca/liheap/eligibility/fpg_year_lag.yaml

@@ -0,0 +1,10 @@
+description: Alabama uses federal poverty guidelines from this many years before the benefit year for regular heating assistance under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 1
+metadata:
+  unit: year
+  period: year
+  label: Alabama LIHEAP heating poverty guideline year lag
+  reference:
+    - title: "Alabama FY2026 LIHEAP State Plan (October-April heating season and 2025 guidelines) #page 4,9"
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AL_Plan_2026.pdf#page=4

policyengine_us/parameters/gov/states/al/adeca/liheap/income/earned_income_min_age.yaml

@@ -0,0 +1,10 @@
+description: Alabama excludes the earned income of household members below this age under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 18
+metadata:
+  unit: year
+  period: year
+  label: Alabama LIHEAP earned income minimum age
+  reference:
+    - title: "Alabama FY2026 LIHEAP Policy Manual, Income #page 17-19"
+      href: https://adeca.alabama.gov/wp-content/uploads/FY-2026-LIHEAP-Manual-1.pdf#page=17

policyengine_us/parameters/gov/states/al/adeca/liheap/income/sources/earned.yaml

@@ -0,0 +1,17 @@
+description: Alabama uses these sources as earned income under the Low Income Home Energy Assistance Program.
+# Existing net business inputs approximate net farm and nonfarm income without
+# a separate LIHEAP expense deduction. The formula floors each source at zero.
+values:
+  2025-10-01:
+    - employment_income
+    - self_employment_income
+    - sstb_self_employment_income
+    - farm_operations_income
+    - partnership_s_corp_income
+metadata:
+  unit: list
+  period: year
+  label: Alabama LIHEAP earned income sources
+  reference:
+    - title: "Alabama FY2026 LIHEAP Policy Manual, Income #page 17-19"
+      href: https://adeca.alabama.gov/wp-content/uploads/FY-2026-LIHEAP-Manual-1.pdf#page=17

policyengine_us/parameters/gov/states/al/adeca/liheap/income/sources/unearned.yaml

@@ -0,0 +1,41 @@
+description: Alabama uses these sources as unearned income for members of all ages under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01:
+    # Reported unemployment compensation, or modeled Alabama UI (al_ui) when
+    # none is reported.
+    - total_unemployment_compensation
+    - strike_benefits
+    # Social Security is counted gross; the input does not deduct Medicare
+    # premiums.
+    - social_security
+    - ssi
+    # Page 18 excludes "Foster care benefits", read as board payments, not this SSP.
+    - al_ssp
+    # Military retirement pay is a separate input from the pension inputs that
+    # pension_income adds, so both are listed; a household reports the amount
+    # in one or the other.
+    - pension_income
+    - military_retirement_pay
+    - survivor_benefits
+    - veterans_benefits
+    - disability_benefits
+    - workers_compensation
+    - child_support_received
+    - alimony_income
+    - interest_income
+    - ordinary_dividend_income
+    - rental_income
+    - farm_rent_income
+    - estate_income
+    - railroad_benefits
+    - financial_assistance
+# TANF is counted in the formula through the take-up-gated tanf aggregate.
+# Net gambling winnings are calculated separately using existing winnings and
+# losses inputs. Do not also include the gross winnings here.
+metadata:
+  unit: list
+  period: year
+  label: Alabama LIHEAP unearned income sources
+  reference:
+    - title: "Alabama FY2026 LIHEAP Policy Manual, Income #page 17-19"
+      href: https://adeca.alabama.gov/wp-content/uploads/FY-2026-LIHEAP-Manual-1.pdf#page=17

policyengine_us/parameters/gov/states/al/adeca/liheap/payment/additional_person_amount.yaml

@@ -0,0 +1,10 @@
+description: Alabama provides this additional amount for each household member after the first, up to the payment household size limit, under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 10
+metadata:
+  unit: currency-USD
+  period: year
+  label: Alabama LIHEAP additional person heating payment
+  reference:
+    - title: Alabama FY2026 LIHEAP Policy Manual, Appendix D (current benefit chart)
+      href: https://adeca.alabama.gov/wp-content/uploads/FY-2026-LIHEAP-Manual-1.pdf#page=57

policyengine_us/parameters/gov/states/al/adeca/liheap/payment/base_amount.yaml

@@ -0,0 +1,17 @@
+description: Alabama provides this base payment for a one-person household in the lowest income band, by heating fuel, under the Low Income Home Energy Assistance Program.
+propane:
+  2025-10-01: 500
+natural_gas:
+  2025-10-01: 480
+electricity:
+  2025-10-01: 440
+wood_coal_kerosene:
+  2025-10-01: 400
+metadata:
+  unit: currency-USD
+  period: year
+  label: Alabama LIHEAP base heating payment by fuel
+  propagate_metadata_to_children: true
+  reference:
+    - title: Alabama FY2026 LIHEAP Policy Manual, Appendix D (current benefit chart)
+      href: https://adeca.alabama.gov/wp-content/uploads/FY-2026-LIHEAP-Manual-1.pdf#page=57

policyengine_us/parameters/gov/states/al/adeca/liheap/payment/iija_supplement.yaml

@@ -0,0 +1,19 @@
+description: Alabama provides this Infrastructure Investment and Jobs Act supplement with each regular heating assistance award under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 100
+  # The draft FY2027 plan drops the supplement, and the IIJA appropriation ran
+  # through September 30, 2026.
+  2026-10-01: 0
+metadata:
+  unit: currency-USD
+  period: year
+  label: Alabama LIHEAP IIJA heating supplement
+  reference:
+    - title: Alabama FY2026 LIHEAP State Plan, section 2.5
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AL_Plan_2026.pdf#page=10
+    - title: HHS TAGGS FY2026 Alabama LIHEAP Infrastructure Supplement award 2601ALLIEI
+      href: https://taggs.hhs.gov/Detail/AwardDetail?arg_AwardNum=2601ALLIEI&arg_ProgOfficeCode=31
+    - title: "Alabama draft FY2027 LIHEAP State Plan, section 2.5 (no IIJA supplement) #page 9-10"
+      href: https://adeca.alabama.gov/wp-content/uploads/FY27-LIHEAP-State-Plan.pdf#page=9
+    - title: Infrastructure Investment and Jobs Act, Pub. L. 117-58, Division J, Title VII, 135 Stat. 1412
+      href: https://www.govinfo.gov/content/pkg/PLAW-117publ58/pdf/PLAW-117publ58.pdf#page=984

policyengine_us/parameters/gov/states/al/adeca/liheap/payment/income_band_reduction.yaml

@@ -0,0 +1,18 @@
+description: Alabama sets this reduction from the lowest-band heating payment for each income band under the Low Income Home Energy Assistance Program.
+# These differences reproduce every fuel and household-size cell in Appendix D.
+1:
+  2025-10-01: 0
+2:
+  2025-10-01: 30
+3:
+  2025-10-01: 120
+metadata:
+  unit: currency-USD
+  period: year
+  label: Alabama LIHEAP heating payment reduction by income band
+  breakdown:
+    - range(1, 4)
+  propagate_metadata_to_children: true
+  reference:
+    - title: Alabama FY2026 LIHEAP Policy Manual, Appendix D (current benefit chart)
+      href: https://adeca.alabama.gov/wp-content/uploads/FY-2026-LIHEAP-Manual-1.pdf#page=57

policyengine_us/parameters/gov/states/al/adeca/liheap/payment/maximum_payment_household_size.yaml

@@ -0,0 +1,10 @@
+description: Alabama uses no more than this many household members to determine the regular heating payment under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 4
+metadata:
+  unit: person
+  period: year
+  label: Alabama LIHEAP maximum payment household size
+  reference:
+    - title: Alabama FY2026 LIHEAP State Plan, section 2.5 (households over four receive the four-person payment)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AL_Plan_2026.pdf#page=9

policyengine_us/programs.yaml

@@ -808,8 +808,16 @@ programs:
     category: Benefits
     agency: HHS
     status: partial
-    coverage: DC, Riverside County, MA, IL, IN, KS, KY, MD, MS, NC, NE, NJ, NY, OR, TX
+    coverage: AL, DC, Riverside County, MA, IL, IN, KS, KY, MD, MS, NC, NE, NJ, NY, OR, TX
     state_implementations:
+      - state: AL
+        status: partial
+        name: Alabama LIHEAP
+        full_name: Alabama Low Income Home Energy Assistance Program
+        variable: al_liheap
+        parameter_prefix: gov.states.al.adeca.liheap
+        verified_years: "2026"
+        notes: FY2026 regular heating with the HUD allowance deduction and the funded IIJA supplement. Crisis, cooling, weatherization and equipment assistance are out of scope.
       - state: DC
         status: complete
         name: DC LIHEAP