Add New Hampshire LIHEAP regular heating assistance

changelog.d/nh-liheap-wave2b.added.md

@@ -0,0 +1 @@
+Add New Hampshire Fuel Assistance Program (nh_fap): PY2027 regular heating benefit from the Attachment D matrix with the 60% state median income test and a bedroom-based heating-cost estimate.

policyengine_us/parameters/gov/states/nh/doe/fap/fpg_year_lag.yaml

@@ -0,0 +1,13 @@
+description: New Hampshire uses federal poverty guidelines from this many years before the modeled heating season under the Fuel Assistance Program.
+# The annual model uses the PY2027 starting schedule with 2026 guidelines.
+# The manual's within-season February updates are not separately modeled.
+values:
+  2026-10-01: 1
+
+metadata:
+  unit: year
+  period: year
+  label: New Hampshire FAP federal poverty guideline year lag
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Income Guidelines and Federal Poverty Guideline Updates #page 10,17,74"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=10

policyengine_us/parameters/gov/states/nh/doe/fap/heating_cost/dwelling_factor.yaml

@@ -0,0 +1,17 @@
+description: New Hampshire uses these dwelling energy factors to estimate heating cost under the Fuel Assistance Program.
+SINGLE_FAMILY_OR_MODULAR:
+  2026-10-01: 2_000
+MOBILE_HOME:
+  2026-10-01: 1_800
+APARTMENT_CONDO_OR_DUPLEX:
+  2026-10-01: 1_400
+
+metadata:
+  unit: /1
+  period: year
+  label: New Hampshire FAP dwelling energy factor
+  breakdown:
+    - nh_fap_dwelling_type
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Benefit Determination #page 76-77"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=76

policyengine_us/parameters/gov/states/nh/doe/fap/heating_cost/fuel_cost_per_mbtu.yaml

@@ -0,0 +1,30 @@
+description: New Hampshire uses these fuel costs per million British thermal units to estimate heating cost under the Fuel Assistance Program.
+KEROSENE:
+  2026-10-01: 35.185
+FUEL_OIL:
+  2026-10-01: 28.881
+NATURAL_GAS:
+  2026-10-01: 15
+COAL:
+  2026-10-01: 14.286
+WOOD:
+  2026-10-01: 21.65
+ELECTRICITY:
+  2026-10-01: 64.706
+PROPANE:
+  2026-10-01: 42.497
+# SOLAR takes the electricity row because heating_expense reads a solar
+# home's bill as its grid electricity bill.
+SOLAR:
+  2026-10-01: 64.706
+# Unsupported fuel contributes no estimate, not a legal zero cost.
+UNAVAILABLE:
+  2026-10-01: 0
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: New Hampshire FAP fuel cost per million British thermal units
+  reference:
+    - title: PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Benefit Determination
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=77

policyengine_us/parameters/gov/states/nh/doe/fap/heating_cost/fuel_efficiency.yaml

@@ -0,0 +1,31 @@
+description: New Hampshire uses these fuel efficiency rates to estimate heating cost under the Fuel Assistance Program.
+KEROSENE:
+  2026-10-01: 0.78
+FUEL_OIL:
+  2026-10-01: 0.78
+NATURAL_GAS:
+  2026-10-01: 0.82
+COAL:
+  2026-10-01: 0.75
+# Existing WOOD represents cordwood; pellets and bio-bricks are unobserved.
+WOOD:
+  2026-10-01: 0.63
+ELECTRICITY:
+  2026-10-01: 1
+PROPANE:
+  2026-10-01: 0.78
+# SOLAR takes the electricity row because heating_expense reads a solar
+# home's bill as its grid electricity bill.
+SOLAR:
+  2026-10-01: 1
+# A safe denominator for the zero-cost computational fallback.
+UNAVAILABLE:
+  2026-10-01: 1
+
+metadata:
+  unit: /1
+  period: year
+  label: New Hampshire FAP fuel efficiency rate
+  reference:
+    - title: PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Benefit Determination
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=77

policyengine_us/parameters/gov/states/nh/doe/fap/heating_cost/heating_degree_days.yaml

@@ -0,0 +1,36 @@
+description: New Hampshire uses these agency heating degree days by county to estimate heating cost under the Fuel Assistance Program.
+BELKNAP_COUNTY_NH:
+  2026-10-01: 6_610
+MERRIMACK_COUNTY_NH:
+  2026-10-01: 6_610
+HILLSBOROUGH_COUNTY_NH:
+  2026-10-01: 5_993
+ROCKINGHAM_COUNTY_NH:
+  2026-10-01: 5_993
+STRAFFORD_COUNTY_NH:
+  2026-10-01: 6_061
+CHESHIRE_COUNTY_NH:
+  2026-10-01: 6_588
+SULLIVAN_COUNTY_NH:
+  2026-10-01: 6_588
+CARROLL_COUNTY_NH:
+  2026-10-01: 7_672
+COOS_COUNTY_NH:
+  2026-10-01: 7_672
+GRAFTON_COUNTY_NH:
+  2026-10-01: 7_672
+# Unsupported geography contributes no estimate, not a legal zero cost.
+UNAVAILABLE:
+  2026-10-01: 0
+
+metadata:
+  unit: /1
+  period: year
+  label: New Hampshire FAP agency heating degree days by county
+  reference:
+    - title: PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Benefit Determination
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=77
+    - title: Community Action Partnership of New Hampshire, Agency County Service Areas
+      href: https://www.capnh.org/home-old
+    - title: Community Action Partnership of New Hampshire, Agency County Service Areas (Wayback Machine capture, June 13, 2026)
+      href: https://web.archive.org/web/20260613220254/https://www.capnh.org/home-old

policyengine_us/parameters/gov/states/nh/doe/fap/income/business_sources.yaml

@@ -0,0 +1,18 @@
+description: New Hampshire counts these business income sources under the Fuel Assistance Program.
+# Each source's losses count as zero (page 26), so a loss cannot offset
+# another source.
+values:
+  2026-10-01:
+    - self_employment_income
+    - sstb_self_employment_income
+    - farm_operations_income
+    - partnership_income
+    - s_corp_income
+
+metadata:
+  unit: list
+  period: year
+  label: New Hampshire FAP business income sources
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Self Employment #page 25-28"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=25

policyengine_us/parameters/gov/states/nh/doe/fap/income/investment_disregard.yaml

@@ -0,0 +1,17 @@
+description: New Hampshire excludes this amount of annual interest and dividend income under the Fuel Assistance Program.
+# One $50 exclusion applies to combined interest and dividends per SPM unit,
+# following page 17's allowable expense "$50 of earned interest and/or
+# dividends annually". Page 15 counts "Interest over $50 a year" and
+# "Dividends over $50 a year", and page 16 excludes "the first $50" of each,
+# which would allow up to $100. None of these pages says whether the amount
+# applies per person or per household.
+values:
+  2026-10-01: 50
+
+metadata:
+  unit: currency-USD
+  period: year
+  label: New Hampshire FAP annual investment income exclusion per SPM unit
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Countable and Non-countable Income and Allowable Expenses #page 15-17"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=15

policyengine_us/parameters/gov/states/nh/doe/fap/income/ssi_min_age.yaml

@@ -0,0 +1,11 @@
+description: New Hampshire excludes Supplemental Security Income for people below this age under the Fuel Assistance Program.
+values:
+  2026-10-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: New Hampshire FAP minimum age for countable SSI
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Non-countable Income #page 15-16"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=15

policyengine_us/parameters/gov/states/nh/doe/fap/income/unearned_sources.yaml

@@ -0,0 +1,47 @@
+description: New Hampshire counts these unearned income sources under the Fuel Assistance Program.
+# nh_fap_countable_income adds adult SSI, FANF and interest and dividends
+# above the $50 exclusion to these sources.
+values:
+  2026-10-01:
+    - social_security
+    - pension_income
+    - military_retirement_income
+    - retirement_distributions
+    - railroad_benefits
+    - survivor_benefits
+    - veterans_benefits
+    - total_unemployment_compensation
+    - workers_compensation
+    - disability_benefits
+    - nh_ssp
+    - strike_benefits
+    - financial_assistance
+    - alimony_income
+    - rental_income
+    - farm_rent_income
+    - estate_income
+    - gambling_winnings
+
+# Broad receipts approximate the source's regular payments. Inputs do not
+# identify VA Aid and Attendance, educational VA benefits, special-needs
+# trusts, or irregular injury/insurance payments. Financial assistance lacks
+# the required six-month regularity flag. nh_ssp holds the APTD, ANB and OAA
+# state welfare payments, FANF is included separately once per SPM unit, and
+# RCA has no input. Page 15's state welfare payments are APTD, ANB, FANF, OAA
+# and RCA, and plan item 1.9 leaves General Assistance benefits unchecked, so
+# municipal general assistance (RSA 165) is not counted.
+# Rental inputs are treated as net and nonnegative without reconstructing
+# business expenses. Pension income includes annuities and insurance income.
+# Gambling winnings approximate the taxable gambling and lottery category.
+# Missing taxable grants, adoption subsidies, royalties and tribal receipts
+# are not imputed; balances, capital gains and regular child support received
+# are not counted as income.
+metadata:
+  unit: list
+  period: year
+  label: New Hampshire FAP unearned income sources
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Countable Income, Non-countable Income, and Rental Property Income #page 15-17,23,29"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=15
+    - title: New Hampshire FY2026 LIHEAP State Plan, Section 1.9
+      href: https://liheapch.acf.gov/docs/2026/state-plans/NH_Plan_2026.pdf#page=6

policyengine_us/parameters/gov/states/nh/doe/fap/payment/benefit_multiplier.yaml

@@ -0,0 +1,41 @@
+description: New Hampshire provides this share of the delivered-fuel scheduled benefit under the Fuel Assistance Program.
+# Whole-dollar half-up rounding reproduces all 24 published utility cells.
+# SOLAR takes the electricity row because heating_expense reads a solar
+# home's bill as its grid electricity bill. OTHER has no row on page 77 and
+# no fuel on the application, and UNSPECIFIED names no fuel; zero marks an
+# unsupported amount, not a legal zero benefit.
+UNSPECIFIED:
+  2026-10-01: 0
+ELECTRICITY:
+  2026-10-01: 0.75
+NATURAL_GAS:
+  2026-10-01: 0.75
+FUEL_OIL:
+  2026-10-01: 1
+KEROSENE:
+  2026-10-01: 1
+PROPANE:
+  2026-10-01: 1
+# WOOD also represents pellets and bio-bricks, which share the 1.000
+# multiplier. Winter blend is a heating-oil blend entered as FUEL_OIL or
+# KEROSENE, which share the same multiplier.
+WOOD:
+  2026-10-01: 1
+COAL:
+  2026-10-01: 1
+SOLAR:
+  2026-10-01: 0.75
+OTHER:
+  2026-10-01: 0
+NONE:
+  2026-10-01: 0
+
+metadata:
+  unit: /1
+  period: year
+  label: New Hampshire FAP benefit multiplier
+  breakdown:
+    - heating_type
+  reference:
+    - title: PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Benefit Determination, Fuel Cost, Efficiency, and Benefit Multiplier
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=77

policyengine_us/parameters/gov/states/nh/doe/fap/payment/delivered_benefit.yaml

@@ -0,0 +1,63 @@
+description: New Hampshire provides this annual delivered-fuel scheduled benefit by heating cost band and income band under the Fuel Assistance Program.
+DD:
+  A:
+    2026-10-01: 750
+  B:
+    2026-10-01: 650
+  C:
+    2026-10-01: 550
+  D:
+    2026-10-01: 500
+  E:
+    2026-10-01: 440
+  F:
+    2026-10-01: 400
+CC:
+  A:
+    2026-10-01: 1_460
+  B:
+    2026-10-01: 1_270
+  C:
+    2026-10-01: 1_150
+  D:
+    2026-10-01: 950
+  E:
+    2026-10-01: 730
+  F:
+    2026-10-01: 525
+BB:
+  A:
+    2026-10-01: 2_350
+  B:
+    2026-10-01: 2_040
+  C:
+    2026-10-01: 1_720
+  D:
+    2026-10-01: 1_410
+  E:
+    2026-10-01: 1_100
+  F:
+    2026-10-01: 800
+AA:
+  A:
+    2026-10-01: 2_500
+  B:
+    2026-10-01: 2_150
+  C:
+    2026-10-01: 1_825
+  D:
+    2026-10-01: 1_500
+  E:
+    2026-10-01: 1_200
+  F:
+    2026-10-01: 825
+
+# The operative PY2027 matrix supersedes inconsistent illustrative amounts
+# in the manual's older examples. No actual-heating-cost cap is applied.
+metadata:
+  unit: currency-USD
+  period: year
+  label: New Hampshire FAP delivered-fuel scheduled benefit
+  reference:
+    - title: PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Fuel Assistance Program Benefits
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=78

policyengine_us/parameters/gov/states/nh/doe/fap/payment/heating_cost_threshold.yaml

@@ -0,0 +1,17 @@
+description: New Hampshire uses these inclusive lower annual heating cost thresholds for benefit bands above the lowest band under the Fuel Assistance Program.
+CC:
+  2026-10-01: 1_000
+BB:
+  2026-10-01: 1_750
+AA:
+  2026-10-01: 3_500
+
+# Page 78 utility labels overlap at the endpoints; the non-overlapping
+# page 77 Heating Cost Tiers table and delivered schedule establish the tiers.
+metadata:
+  unit: currency-USD
+  period: year
+  label: New Hampshire FAP heating cost band thresholds
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Benefit Determination, Heating Cost Tiers and Benefits #page 76-78"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=76

policyengine_us/parameters/gov/states/nh/doe/fap/payment/income_band_upper_bound.yaml

@@ -0,0 +1,20 @@
+description: New Hampshire assigns these inclusive upper federal poverty guideline shares to the first five income bands under the Fuel Assistance Program.
+A:
+  2026-10-01: 0.75
+B:
+  2026-10-01: 1
+C:
+  2026-10-01: 1.25
+D:
+  2026-10-01: 1.5
+E:
+  2026-10-01: 1.75
+
+# Band F covers income above band E through the separate 60% SMI limit.
+metadata:
+  unit: /1
+  period: year
+  label: New Hampshire FAP income band upper bounds
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Income Guidelines #page 17,74"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=17

policyengine_us/parameters/gov/states/nh/doe/fap/smi_rate.yaml

@@ -0,0 +1,13 @@
+description: New Hampshire limits annual income to this share of state median income under the Fuel Assistance Program.
+values:
+  2026-10-01: 0.6
+
+metadata:
+  unit: /1
+  period: year
+  label: New Hampshire FAP state median income limit rate
+  reference:
+    - title: "PY2027 New Hampshire Fuel Assistance Program Procedures Manual, Income Guidelines #page 17,74"
+      href: https://www.energy.nh.gov/sites/g/files/ehbemt551/files/inline-documents/sonh/fuel-assistance-program-procedures-manual.pdf#page=17
+    - title: New Hampshire FY2026 LIHEAP State Plan, Section 2.1
+      href: https://liheapch.acf.gov/docs/2026/state-plans/NH_Plan_2026.pdf#page=8