Add Iowa LIHEAP regular heating assistance

changelog.d/ia-liheap-wave1c.added.md

@@ -0,0 +1 @@
+Add Iowa LIHEAP Regular Assistance (ia_liheap): FY2026 regular heating benefit from the points matrix with the 200% federal poverty guideline income test.

policyengine_us/parameters/gov/states/ia/hhs/liheap/eligibility/fpg_rate.yaml

@@ -0,0 +1,15 @@
+description: Iowa limits annual countable household income to this multiple of the federal poverty guidelines under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 2
+
+metadata:
+  unit: /1
+  period: year
+  label: Iowa LIHEAP federal poverty guideline rate
+  reference:
+    - title: "Iowa LIHEAP FY26 Policy and Procedures Manual, Section 5.10 Eligibility Criteria (income 200% or below of the federal poverty guidelines), Appendix B Poverty Guidelines and Appendix I Payment Matrix (over 200% ineligible) #page 18,89,137"
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=18
+    - title: Iowa LIHEAP FFY2026 Detailed Model Plan, Section 2.1 note (threshold is 200% FPG; the printed 150.00% is an OLDC form limitation)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/IA_Plan_2026.pdf#page=9
+    - title: Iowa HHS Low-Income Home Energy Assistance program page (at or below 200% of the 2025 federal poverty guidelines)
+      href: https://hhs.iowa.gov/programs/programs-and-services/liheap

policyengine_us/parameters/gov/states/ia/hhs/liheap/eligibility/fpg_year_lag.yaml

@@ -0,0 +1,18 @@
+description: Iowa uses federal poverty guidelines from this many years before the modeled heating season for the income limit and poverty-level points under the Low Income Home Energy Assistance Program.
+# Verified for FY26 only: the October 1, 2025 to September 30, 2026 limits
+# ($31,300 for one person plus $11,000 per additional member) equal exactly
+# 200% of the 2025 HHS guideline. Model period 2026 therefore reads the 2025
+# guideline. This is a relative year selection, not a fixed guideline year;
+# earlier and later Iowa policy remains unverified.
+values:
+  2025-10-01: 1
+
+metadata:
+  unit: year
+  period: year
+  label: Iowa LIHEAP federal poverty guideline year lag
+  reference:
+    - title: Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix B Poverty Guidelines (FY26 October 1, 2025, to September 30, 2026 annual gross income table)
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=89
+    - title: Iowa HHS Low-Income Home Energy Assistance program page (200% of the 2025 federal poverty guidelines for October 1, 2025 to September 30, 2026)
+      href: https://hhs.iowa.gov/programs/programs-and-services/liheap

policyengine_us/parameters/gov/states/ia/hhs/liheap/income/countable_min_age.yaml

@@ -0,0 +1,20 @@
+description: Iowa counts the income of household members at or above this age under the Low Income Home Energy Assistance Program.
+# Section 6.20 counts "the gross income of all household members aged 18 and
+# over"; Appendix C records Social Security paid to members under 18 at $0.00
+# and leaves full-time earnings of under-18 members "NOT included as income".
+# Section 6.00 (page 24) states an exception for minors "working full-time";
+# that conflict is resolved in favor of Sections 6.20 and Appendix C and the
+# FFY2026 plan, which leaves "Earned income of a child under the age of 18"
+# unchecked.
+values:
+  2025-10-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: Iowa LIHEAP minimum age for countable income
+  reference:
+    - title: "Iowa LIHEAP FY26 Policy and Procedures Manual, Section 6.00 Income, Section 6.20 Calculating Income (members aged 18 and over), Appendix C Income Earned by HH Members under the age of 18 and Social Security Benefits (only count for members 18 and older) #page 24,26,102,114"
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=24
+    - title: Iowa LIHEAP FFY2026 Detailed Model Plan, Section 1.9 (earned income of a child under the age of 18 not counted)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/IA_Plan_2026.pdf#page=6

policyengine_us/parameters/gov/states/ia/hhs/liheap/income/sources/earned.yaml

@@ -0,0 +1,34 @@
+description: Iowa counts these earned income sources toward gross household income under the Low Income Home Energy Assistance Program.
+# Appendix C counts wages, salaries, tips, commissions, bonuses, severance, PTO
+# and per diem (Employment Income), military pay excluding the housing
+# allowance, self-employment and contract income, and farm income. Appendix C
+# Self-Employment Income has two routes: "Income from a business, less
+# business expenses. Filed Federal tax return required if deducting business
+# expense, otherwise gross income is used. The LIHEAP program does NOT deduct
+# business expenses." Filers are assessed on the return's net business income
+# and non-filers on gross income. The model's net business inputs follow the
+# filer route; the approximations are the per-source zero floor applied in
+# the countable earned income formula (a loss does not offset other income)
+# and the absence of the non-filer gross route.
+values:
+  2025-10-01:
+    - employment_income
+    # Appendix C Military Pay: counted, "excluding housing allowance".
+    - military_basic_pay
+    - self_employment_income
+    - sstb_self_employment_income
+    - partnership_s_corp_income
+    # Appendix C Farm Income: sale of crops, livestock and land rental is
+    # counted (the X is in the Yes column although the code column reads NA).
+    - farm_operations_income
+    - farm_rent_income
+
+metadata:
+  unit: list
+  period: year
+  label: Iowa LIHEAP countable earned income sources
+  reference:
+    - title: "Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix C Income Source Guide, Employment Income, Farm Income, Military Pay and Self-Employment Income rows #page 97-98,108,113"
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=97
+    - title: "Iowa LIHEAP FFY2026 Detailed Model Plan, Sections 1.8-1.9 (gross income; wages, self-employment income, contract income and commissions counted) #page 5-6"
+      href: https://liheapch.acf.gov/docs/2026/state-plans/IA_Plan_2026.pdf#page=5

policyengine_us/parameters/gov/states/ia/hhs/liheap/income/sources/fixed.yaml

@@ -0,0 +1,29 @@
+description: Iowa treats these income sources as fixed income for the fixed-income-only targeting factor under the Low Income Home Energy Assistance Program.
+# Definitions, Fixed Income Household: "A household that receives only one or
+# more of the following income types ... Social Security Administration (SSA)
+# Benefits, Supplemental Security Income (SSI), Social Security Disability
+# Insurance (SSDI), Veterans' Assistance, VA Service-Connected Disability
+# Pension, VA Non-Service-Connected Disability Pension, and pensions. Only mark
+# 'fixed income' when that is the ONLY source(s) of income." Appendix C notes
+# that child support, alimony and variable annuities are not fixed income.
+values:
+  2025-10-01:
+    - social_security
+    - ssi
+    - pension_income
+    # Military retirement pay and survivor benefit payments are pensions.
+    - military_retirement_income
+    # Appendix C defines Pensions as assistance "paid at regular intervals ...
+    # in consideration of past services, age" and labels Form RRB-1099-R
+    # "Annuities or Pensions by the Railroad Retirement Board", so railroad
+    # retirement annuities are pensions in the Definitions' fixed income list.
+    - railroad_benefits
+    - veterans_benefits
+
+metadata:
+  unit: list
+  period: year
+  label: Iowa LIHEAP fixed income sources
+  reference:
+    - title: "Iowa LIHEAP FY26 Policy and Procedures Manual, Definitions, Fixed Income Household, Appendix C Pensions and Railroad Retirement rows, and Appendix I Payment Matrix, Fixed Income Only targeting factor #page 81,109-110,137"
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=81

policyengine_us/parameters/gov/states/ia/hhs/liheap/income/sources/other_recorded.yaml

@@ -0,0 +1,22 @@
+description: Iowa excludes households with these uncounted income sources from the fixed income factor under the Low Income Home Energy Assistance Program.
+# Definitions, Fixed Income Household: "Only mark 'fixed income' when that is
+# the ONLY source(s) of income." Appendix C leaves these rows out of countable
+# income and adds that they are not fixed: Child Support, "Child support is
+# not considered a fixed income source", and FIP, "FIP is not considered fixed
+# income because the household composition is likely to change". Recorded FIP
+# is read from tanf, the take-up-adjusted cash assistance amount (equal to
+# ia_fip for a household that takes up FIP), as in the Oregon, Kentucky and
+# New Jersey LIHEAP income formulas. The AFLAC row (page 90) carries the same
+# note but has no model input.
+values:
+  2025-10-01:
+    - child_support_received
+    - tanf
+
+metadata:
+  unit: list
+  period: year
+  label: Iowa LIHEAP recorded income sources that are neither countable nor fixed
+  reference:
+    - title: "Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix C Income Source Guide, Child Support and FIP (Family Investment Program) rows #page 92,98"
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=92

policyengine_us/parameters/gov/states/ia/hhs/liheap/income/sources/unearned.yaml

@@ -0,0 +1,74 @@
+description: Iowa counts these unearned income sources toward gross household income under the Low Income Home Energy Assistance Program.
+# Not counted (Appendix C, not-counted column; plan Section 1.9 unchecked):
+# FIP (Iowa TANF), child support received, SNAP, WIC, Medicaid, housing
+# assistance and utility allowances, bank-account interest, capital gains,
+# cash gifts, loans, grants and scholarships, jury duty pay, foster care and
+# adoption assistance, inheritances and life insurance, AmeriCorps and VISTA,
+# reimbursements, rebates and tax refunds, in-kind income, short-term
+# disability, VA education and housing allowances, and savings balances.
+# Each source is floored at zero per person in the countable unearned income
+# formula, so a loss in one source (such as a rental loss) does not offset
+# other income.
+values:
+  2025-10-01:
+    # Social Security is counted in the countable unearned income formula, net
+    # of the Medicare Part B premium: Appendix C Social Security Benefits (SSA,
+    # SSI, SSDI) says "Count the net amount as income (gross minus benefits
+    # repaid to SSA)", Section 6.10 and Appendix C use the amount "paid by
+    # check or direct deposit", and plan Section 1.9 checks "Excluding MediCare
+    # deduction". SSA repayments and Part D premiums have no input.
+    # ssi is a monthly variable; the formula sums the twelve months.
+    - ssi
+    - pension_income
+    # Appendix C Pensions and Retirement Income rows: military retirement pay
+    # and survivor benefit payments are pension income.
+    - military_retirement_income
+    # Appendix C IRA and Retirement rows: regular distributions count;
+    # irregular withdrawals are not separable from the model inputs.
+    # retirement_distributions already includes taxable_ira_distributions
+    # (through taxable_retirement_distributions), so IRA distributions are not
+    # listed separately; listing both would count them twice.
+    - retirement_distributions
+    # Appendix C Railroad Retirement: counted; "Tax Statement Form RRB-1099
+    # ... Count box #5 as income" and "RRB-1099-R ... Count box #7 as income".
+    # Railroad retirement annuities are pensions for the fixed income factor
+    # (see sources/fixed.yaml).
+    - railroad_benefits
+    # Appendix C Unemployment: counted; the limited-duration annualization
+    # rule of the Definitions (Annualized Income, page 79) is not modeled.
+    - total_unemployment_compensation
+    - workers_compensation
+    - strike_benefits
+    # Appendix C Disability Insurance: long-term private disability counts,
+    # short-term does not; the model input does not split them.
+    - disability_benefits
+    # Appendix C Veterans Benefits: compensation and pensions count; VA
+    # educational and housing allowances and non-recurring lump sums do not
+    # and are not separable from the model input.
+    - veterans_benefits
+    - alimony_income
+    # Appendix C Rental Income (page 110): "Income received from rental
+    # properties, such as farmland or dwellings." A rental loss is not income
+    # received, so it is floored at zero like the earned sources.
+    - rental_income
+    # Appendix C Interest (Bonds, Investments) is counted while Interest
+    # Bearing Bank Accounts is not; the model input does not split them, so
+    # all interest is counted (documented approximation).
+    - interest_income
+    # Appendix C Dividends: counted; "if the annual combined total earned is
+    # less than $120, ignore the income". The $120 rule is not applied
+    # (documented approximation). ordinary_dividend_income is the canonical
+    # input; dividend_income is a deprecated alias.
+    - ordinary_dividend_income
+    # Appendix C Gambling: taxable gambling winnings count.
+    - gambling_winnings
+
+metadata:
+  unit: list
+  period: year
+  label: Iowa LIHEAP countable unearned income sources
+  reference:
+    - title: "Iowa LIHEAP FY26 Policy and Procedures Manual, Section 6.10 Eligibility Period to Qualify for Assistance and Appendix C Income Source Guide (Alimony, Annuities, Disability Insurance, Dividends, Gambling, Interest, IRA, Pensions, Railroad Retirement, Rental Income, Retirement, Social Security Benefits, Strike Benefits, Unemployment, Veterans Benefits and Workers Compensation rows) #page 25,90-91,94-96,99,103,109-111,114-115,117-119,121"
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=25
+    - title: Iowa LIHEAP FFY2026 Detailed Model Plan, Section 1.9 (countable income sources)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/IA_Plan_2026.pdf#page=6

policyengine_us/parameters/gov/states/ia/hhs/liheap/payment/amount_per_point.yaml

@@ -0,0 +1,13 @@
+description: Iowa pays this amount per payment matrix point under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 40
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Iowa LIHEAP benefit per matrix point
+  reference:
+    - title: Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix I Benefit Maximums, Award Calculation ($40 per point)
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=137
+    - title: Iowa FY2026 Benefit Matrix Heat-Crisis (LIHEAP Clearinghouse copy of Appendix I)
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/IA_BenefitMatrix_Heat-Crisis_2026.pdf#page=1

policyengine_us/parameters/gov/states/ia/hhs/liheap/payment/deliverable_fuel_amount.yaml

@@ -0,0 +1,26 @@
+description: Iowa pays this flat Regular Assistance benefit to households heating primarily with liquid propane or fuel oil under the Low Income Home Energy Assistance Program.
+# Appendix I: "The minimum Regular Assistance benefit for liquid propane and
+# fuel oil LIHEAP customers is $800". Section 11.00: if the matrix benefit "is
+# less than the annual state-set amount for deliverable benefits, the
+# deliverable fuel benefit will be raised to meet the state-set benefit
+# amount". The FY26 public comment draft plan describes it as "a flat amount
+# for deliverable fuel customers that serves as both a minimum and maximum
+# benefit for liquid propane and fuel oil LIHEAP customers. For FY26 that flat
+# amount is $800." The three statements agree numerically for FY26 because the
+# general maximum is also $800. Kerosene follows fuel oil through
+# ia_liheap_fuel_category (an inference; the manual has no kerosene row).
+# The model pays the flat amount only to households that buy the fuel
+# themselves; a household whose heat is included in its rent takes the matrix
+# amount (an inference from Appendix D, page 122; see ia_liheap).
+values:
+  2025-10-01: 800
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Iowa LIHEAP deliverable fuel benefit
+  reference:
+    - title: "Iowa LIHEAP FY26 Policy and Procedures Manual, Section 11.00 Payments (deliverable fuel benefit raised to the state-set amount) and Appendix I Benefit Maximums (minimum benefit for liquid propane and fuel oil customers $800) #page 42,137"
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=42
+    - title: Iowa LIHEAP FFY2026 Public Comment Draft State Plan, Payment Matrix attachment (flat $800 for deliverable fuel customers)
+      href: https://hhs.iowa.gov/media/16690/download?inline#page=48

policyengine_us/parameters/gov/states/ia/hhs/liheap/payment/fuel_points.yaml

@@ -0,0 +1,31 @@
+description: Iowa awards these payment matrix points by primary heating fuel category under the Low Income Home Energy Assistance Program.
+# Appendix I item 3, Fuel/Energy Type: Natural Gas 4, Electric 4, Liquid
+# Propane (LP) 5, Fuel Oil 5, Solid Fuel (Wood/Coal/Corn) 2. The matrix
+# publishes no points for kerosene or other fuels; kerosene is mapped to the
+# fuel oil category in ia_liheap_fuel_category (an inference), and OTHER
+# carries zero points.
+metadata:
+  propagate_metadata_to_children: true
+  unit: /1
+  period: year
+  label: Iowa LIHEAP fuel type points
+  breakdown:
+    - ia_liheap_fuel_category
+  reference:
+    - title: Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix I Benefit Maximums, Regular Assistance Payment Matrix, item 3 Fuel/Energy Type
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=137
+    - title: Iowa FY2026 Benefit Matrix Heat-Crisis (LIHEAP Clearinghouse copy of Appendix I)
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/IA_BenefitMatrix_Heat-Crisis_2026.pdf#page=1
+
+NATURAL_GAS:
+  2025-10-01: 4
+ELECTRICITY:
+  2025-10-01: 4
+PROPANE:
+  2025-10-01: 5
+FUEL_OIL:
+  2025-10-01: 5
+SOLID_FUEL:
+  2025-10-01: 2
+OTHER:
+  2025-10-01: 0

policyengine_us/parameters/gov/states/ia/hhs/liheap/payment/max_benefit.yaml

@@ -0,0 +1,16 @@
+description: Iowa pays at most this Regular Assistance benefit under the Low Income Home Energy Assistance Program.
+# With FY26 values the matrix cannot reach this cap: the largest total is
+# 8 poverty + 5 targeting + 5 fuel = 18 points, or $720. The cap is kept as the
+# published rule; only the flat deliverable fuel amount equals it.
+values:
+  2025-10-01: 800
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Iowa LIHEAP maximum benefit
+  reference:
+    - title: Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix I Benefit Maximums, Award Calculation (maximum benefit $800)
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=137
+    - title: Iowa LIHEAP FFY2026 Detailed Model Plan, Section 2.6 (maximum benefit $800)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/IA_Plan_2026.pdf#page=9

policyengine_us/parameters/gov/states/ia/hhs/liheap/payment/min_benefit.yaml

@@ -0,0 +1,13 @@
+description: Iowa pays at least this Regular Assistance benefit to an approved household under the Low Income Home Energy Assistance Program.
+values:
+  2025-10-01: 80
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: Iowa LIHEAP minimum benefit
+  reference:
+    - title: Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix I Benefit Maximums, Award Calculation (minimum benefit $80)
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=137
+    - title: Iowa LIHEAP FFY2026 Detailed Model Plan, Section 2.6 (minimum benefit $80)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/IA_Plan_2026.pdf#page=9

policyengine_us/parameters/gov/states/ia/hhs/liheap/payment/poverty_points.yaml

@@ -0,0 +1,42 @@
+description: Iowa awards these payment matrix points based on the ratio of annual countable household income to the federal poverty guideline under the Low Income Home Energy Assistance Program.
+# Appendix I prints closed percent bands: 0-75% gives 8, 76-100% gives 6,
+# 101-125% gives 5, 126-200% gives 4, over 200% is ineligible, with the note
+# "Poverty levels of .01% are rounded up to the next percentage". A ratio of
+# exactly 0.75 is 75% (8 points) and 0.7501 rounds up to 76% (6 points), so
+# the bands are keyed at their tops and looked up with right=True; the first
+# threshold is -.inf so that zero income scores the first band. The zero
+# amount above 2.00 is unreachable for eligible households, which the income
+# test already limits to 200%.
+brackets:
+  - threshold:
+      2025-10-01: -.inf
+    amount:
+      2025-10-01: 8
+  - threshold:
+      2025-10-01: 0.75
+    amount:
+      2025-10-01: 6
+  - threshold:
+      2025-10-01: 1
+    amount:
+      2025-10-01: 5
+  - threshold:
+      2025-10-01: 1.25
+    amount:
+      2025-10-01: 4
+  - threshold:
+      2025-10-01: 2
+    amount:
+      2025-10-01: 0
+
+metadata:
+  type: single_amount
+  threshold_unit: /1
+  amount_unit: /1
+  period: year
+  label: Iowa LIHEAP poverty level points
+  reference:
+    - title: Iowa LIHEAP FY26 Policy and Procedures Manual, Appendix I Benefit Maximums, Regular Assistance Payment Matrix, item 1 Poverty Level
+      href: https://hhs.iowa.gov/media/17262/download?inline#page=137
+    - title: Iowa FY2026 Benefit Matrix Heat-Crisis (LIHEAP Clearinghouse copy of Appendix I)
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/IA_BenefitMatrix_Heat-Crisis_2026.pdf#page=1