Add Arkansas LIHEAP regular heating assistance

changelog.d/ar-liheap.added.md

@@ -0,0 +1 @@
+Add Arkansas LIHEAP income limits, countable income, and regular heating payment tables.

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/earned_disregard.yaml

@@ -0,0 +1,13 @@
+description: Arkansas excludes this share of earned income under the Low Income Home Energy Assistance Program.
+values:
+  2024-10-01: 0.2
+
+metadata:
+  unit: /1
+  period: year
+  label: Arkansas LIHEAP earned income disregard
+  reference:
+    - title: Arkansas FY2026 State Plan, Section 1.8
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AR_Plan_2026.pdf#page=5
+    - title: Arkansas FY2025 State Plan, Section 1.8
+      href: https://liheapch.acf.gov/docs/2025/state-plans/AR_Plan_2025.pdf#page=5

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/earned_minimum_age.yaml

@@ -0,0 +1,21 @@
+description: Arkansas excludes the earned income of household members younger than this age under the Low Income Home Energy Assistance Program.
+# Application Section III (FY2025 form R 01/FY2025 and current form R 11/2025)
+# requests work income only from members 18 and older, and the accepted plans
+# leave a child's earnings unchecked. Full-time students of any age are
+# excluded in the formula.
+values:
+  2024-10-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: Arkansas LIHEAP earned income minimum age
+  reference:
+    - title: Arkansas LIHEAP application, section III
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/fillable_aeo-9495_liheap-long-application.pdf#page=2
+    - title: Arkansas LIHEAP application AEO 9495 R 01/FY2025, Section III (Wayback capture)
+      href: https://web.archive.org/web/20250104155015/https://www.adeq.state.ar.us/energy/assistance/pdfs/fillable_aeo-9495_liheap-long-application.pdf#page=2
+    - title: Arkansas FY2026 LIHEAP State Plan, section 1.9
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AR_Plan_2026.pdf#page=6
+    - title: Arkansas FY2025 LIHEAP State Plan, section 1.9
+      href: https://liheapch.acf.gov/docs/2025/state-plans/AR_Plan_2025.pdf#page=6

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/interest_disregard.yaml

@@ -0,0 +1,18 @@
+description: Arkansas excludes this monthly amount of each member's interest from countable income under the Low Income Home Energy Assistance Program.
+# Manual Appendix F (page 137) counts interest only as the "amount over
+# $200.00". Unearned income is what is received in the month before application
+# (Section 4.7, page 41; Appendix E, pages 129-130, converts other frequencies
+# to monthly), so the amount is monthly. The manual does not say whose $200 it
+# is; applying it to each recipient is a chosen reading, and a household-wide
+# $200 would count more. Plan Section 1.9 (page 6) counts "Interest, dividends,
+# or royalties" with no threshold; the manual is followed.
+values:
+  2024-10-01: 200
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Arkansas LIHEAP interest income disregard
+  reference:
+    - title: Arkansas LIHEAP draft manual FY2025, Appendix F, Interest
+      href: https://liheapch.acf.gov/sites/default/files/webfiles/docs/2025/manuals/AR_Manual%5Bdraft%5D_2025.pdf#page=137

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/limit/additional_member_amount.yaml

@@ -0,0 +1,17 @@
+description: Arkansas sets this amount as the monthly income limit increase per additional household member under the Low Income Home Energy Assistance Program.
+# The charts print these amounts for each member above the largest published
+# size. Half-up rounding of 150% of the FY2025 guideline increment ($672.50)
+# would give $673, so the printed amounts are stored rather than derived.
+values:
+  2024-10-01: 672
+  2025-10-01: 688
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Arkansas LIHEAP additional member income limit amount
+  reference:
+    - title: Arkansas FY2026 Income Eligibility Chart, additional-person instruction
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2026.pdf
+    - title: Arkansas FY2025 Income Eligibility Chart, additional-person instruction
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2025.pdf

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/limit/fpg_rate.yaml

@@ -0,0 +1,17 @@
+description: Arkansas limits countable income to this multiple of the federal poverty guideline for households above the state median income size limit under the Low Income Home Energy Assistance Program.
+values:
+  2024-10-01: 1.5
+
+metadata:
+  unit: /1
+  period: year
+  label: Arkansas LIHEAP federal poverty guideline rate
+  reference:
+    - title: Arkansas FY2026 State Plan, Section 2.1
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AR_Plan_2026.pdf#page=9
+    - title: Arkansas FY2026 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2026.pdf
+    - title: Arkansas FY2025 State Plan, Section 2.1
+      href: https://liheapch.acf.gov/docs/2025/state-plans/AR_Plan_2025.pdf#page=8
+    - title: Arkansas FY2025 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2025.pdf

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/limit/fpg_year_lag.yaml

@@ -0,0 +1,16 @@
+description: Arkansas uses the federal poverty guideline from this many years before the benefit year under the Low Income Home Energy Assistance Program.
+# The FY2025 and FY2026 published thresholds match the 2024 and 2025 federal
+# poverty guidelines. Other years use their corresponding guideline year but
+# are unverified.
+values:
+  2024-10-01: 1
+
+metadata:
+  unit: year
+  period: year
+  label: Arkansas LIHEAP federal poverty guideline year lag
+  reference:
+    - title: Arkansas FY2026 Income Eligibility Chart, poverty guideline rows reproduced by the 2025 federal poverty guidelines
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2026.pdf
+    - title: Arkansas FY2025 Income Eligibility Chart, poverty guideline rows reproduced by the 2024 federal poverty guidelines
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2025.pdf

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/limit/max_table_size.yaml

@@ -0,0 +1,13 @@
+description: Arkansas sets income limits through this household size, with a fixed monthly amount for each additional member, under the Low Income Home Energy Assistance Program.
+values:
+  2024-10-01: 20
+
+metadata:
+  unit: person
+  period: year
+  label: Arkansas LIHEAP maximum published income limit household size
+  reference:
+    - title: Arkansas FY2026 Income Eligibility Chart, additional-person instruction
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2026.pdf
+    - title: Arkansas FY2025 Income Eligibility Chart, additional-person instruction
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2025.pdf

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/limit/rounding_increment.yaml

@@ -0,0 +1,16 @@
+description: Arkansas uses this increment to round monthly income limits under the Low Income Home Energy Assistance Program.
+# Half-up rounding of the monthly base limit reproduces every FY2025 and FY2026
+# row for sizes 1 to 20. This is a reconciled numerical pattern, not an express
+# rounding instruction.
+values:
+  2024-10-01: 1
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Arkansas LIHEAP monthly income limit rounding increment
+  reference:
+    - title: Arkansas FY2026 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2026.pdf
+    - title: Arkansas FY2025 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2025.pdf

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/limit/smi_max_size.yaml

@@ -0,0 +1,21 @@
+description: Arkansas uses state median income for households up to this size under the Low Income Home Energy Assistance Program.
+values:
+  # FY2025 plan Section 2.1: sizes 1-6 use state median income, size 7 and up
+  # use the HHS poverty guidelines.
+  2024-10-01: 6
+  # FY2026 plan Section 2.1: sizes 1-7 use state median income.
+  2025-10-01: 7
+
+metadata:
+  unit: person
+  period: year
+  label: Arkansas LIHEAP maximum state median income household size
+  reference:
+    - title: Arkansas FY2026 State Plan, Section 2.1
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AR_Plan_2026.pdf#page=9
+    - title: Arkansas FY2026 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2026.pdf
+    - title: Arkansas FY2025 State Plan, Section 2.1
+      href: https://liheapch.acf.gov/docs/2025/state-plans/AR_Plan_2025.pdf#page=8
+    - title: Arkansas FY2025 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2025.pdf

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/limit/smi_rate.yaml

@@ -0,0 +1,17 @@
+description: Arkansas limits countable income to this share of state median income for households within the state median income size limit under the Low Income Home Energy Assistance Program.
+values:
+  2024-10-01: 0.6
+
+metadata:
+  unit: /1
+  period: year
+  label: Arkansas LIHEAP state median income rate
+  reference:
+    - title: Arkansas FY2026 State Plan, Section 2.1
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AR_Plan_2026.pdf#page=9
+    - title: Arkansas FY2026 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2026.pdf
+    - title: Arkansas FY2025 State Plan, Section 2.1
+      href: https://liheapch.acf.gov/docs/2025/state-plans/AR_Plan_2025.pdf#page=8
+    - title: Arkansas FY2025 Income Eligibility Chart
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Eligibility-Chart_2025.pdf

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/sources/earned.yaml

@@ -0,0 +1,32 @@
+description: Arkansas uses these sources as earned income under the Low Income Home Energy Assistance Program.
+# Existing net business income approximates gross receipts; no additional
+# business-expense deduction or new gross-receipts input is modeled.
+# Active and passive partnership income cannot be separated by existing inputs.
+values:
+  2024-10-01:
+    - employment_income
+    - self_employment_income
+    - sstb_self_employment_income
+    - farm_operations_income
+    - partnership_s_corp_income
+    # Manual Appendix F (page 141) treats rental property as a self-employment
+    # enterprise, so rental income, including farm rent, takes the earned
+    # disregard. Plan Section 1.8 (page 5) subtracts 20% from work income only
+    # and Section 1.9 (page 6) lists rental income as its own item; the manual
+    # is followed.
+    - rental_income
+    - farm_rent_income
+
+metadata:
+  unit: list
+  period: year
+  label: Arkansas LIHEAP earned income sources
+  reference:
+    - title: Arkansas FY2026 State Plan, Section 1.9
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AR_Plan_2026.pdf#page=6
+    - title: "Arkansas FY2025 State Plan, Section 1.9 #page 5-6"
+      href: https://liheapch.acf.gov/docs/2025/state-plans/AR_Plan_2025.pdf#page=5
+    - title: Arkansas LIHEAP Application, Section III Household Income
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/fillable_aeo-9495_liheap-long-application.pdf#page=2
+    - title: Arkansas LIHEAP draft manual FY2025, Appendix F, Rental property
+      href: https://liheapch.acf.gov/sites/default/files/webfiles/docs/2025/manuals/AR_Manual%5Bdraft%5D_2025.pdf#page=141

policyengine_us/parameters/gov/states/ar/ee/aeo/liheap/income/sources/unearned.yaml

@@ -0,0 +1,54 @@
+description: Arkansas uses these sources as unearned income under the Low Income Home Energy Assistance Program.
+# Each source is floored at zero in the income formula, so a loss in one source
+# cannot offset other income. The formula also counts Social Security and
+# railroad retirement net of the Medicare Part B premium, interest above the
+# monthly disregard, and TEA. Rental income is in the earned list.
+# Where the plan and the FY2025 draft manual differ, the manual is followed.
+# Counted loans, jury duty, royalties and foster care receipts lack
+# sufficiently specific inputs and are not represented here.
+values:
+  2024-10-01:
+    - total_unemployment_compensation
+    - strike_benefits
+    - ssi
+    # 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 (manual Appendix F, page 141).
+    - pension_income
+    - military_retirement_pay
+    # Non-Social-Security survivor receipts.
+    - survivor_benefits
+    - alimony_income
+    - child_support_received
+    - ordinary_dividend_income
+    - veterans_benefits
+    # Cash gifts from friends and relatives outside the household.
+    - financial_assistance
+    # Manual Appendices E (page 130) and F (page 144) and the application
+    # (page 2) count workers' compensation; plan Section 1.9 leaves "Insurance
+    # payments made directly to the insured" unchecked.
+    - workers_compensation
+    # Manual Appendix F (page 135) counts all gaming or gambling winnings. Plan
+    # Section 1.9 (page 7) counts lottery winnings as the only one-time lump
+    # sum, and manual page 138 excludes nonrecurring lump sums; the Appendix F
+    # row is followed.
+    - gambling_winnings
+    # Manual Appendix F (page 132) counts capital gains and excludes capital
+    # losses. Plan Section 1.9 (page 7) counts no one-time lump sum other than
+    # lottery winnings, and manual page 138 excludes nonrecurring lump sums,
+    # including the sale of personal property; the Appendix F row is followed.
+    - capital_gains
+
+metadata:
+  unit: list
+  period: year
+  label: Arkansas LIHEAP unearned income sources
+  reference:
+    - title: "Arkansas FY2026 State Plan, Section 1.9 #page 6-7"
+      href: https://liheapch.acf.gov/docs/2026/state-plans/AR_Plan_2026.pdf#page=6
+    - title: "Arkansas FY2025 State Plan, Section 1.9 #page 5-7"
+      href: https://liheapch.acf.gov/docs/2025/state-plans/AR_Plan_2025.pdf#page=5
+    - title: "Arkansas LIHEAP draft manual FY2025, Appendices E and F #page 130-133,135,138,140-141,143-144"
+      href: https://liheapch.acf.gov/sites/default/files/webfiles/docs/2025/manuals/AR_Manual%5Bdraft%5D_2025.pdf#page=130
+    - title: Arkansas LIHEAP Application, Section III Household Income
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/fillable_aeo-9495_liheap-long-application.pdf#page=2

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

@@ -0,0 +1,26 @@
+description: Arkansas uses these household size group boundaries for the regular heating benefit under the Low Income Home Energy Assistance Program.
+brackets:
+  - threshold:
+      2024-10-01: 0
+    amount:
+      2024-10-01: 1
+  - threshold:
+      2024-10-01: 3
+    amount:
+      2024-10-01: 2
+  - threshold:
+      2024-10-01: 5
+    amount:
+      2024-10-01: 3
+
+metadata:
+  type: single_amount
+  threshold_unit: person
+  amount_unit: /1
+  period: year
+  label: Arkansas LIHEAP payment household size group
+  reference:
+    - title: Arkansas FY2026 Benefits Matrix, household size columns common to all fuel schedules
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Benefit-Matix_2026_Electric.pdf#page=1
+    - title: Arkansas FY2025 Benefits Matrix, household size columns common to all fuel schedules
+      href: https://www.adeq.state.ar.us/energy/assistance/pdfs/LIHEAP_Benefit-Matix_2025_Electric.pdf#page=1