Add Kansas LIEAP regular heating assistance

changelog.d/ks-liheap.added.md

@@ -0,0 +1 @@
+Kansas LIEAP (Low Income Energy Assistance Program) heating benefit: eligibility, countable income, and the FY2025-FY2026 benefit matrices. Self-employment income is approximated using existing net-income inputs without an additional expense deduction.

policyengine_us/parameters/gov/states/ks/dcf/liheap/eligibility/fpg_rate.yaml

@@ -0,0 +1,17 @@
+description: Kansas limits countable income to this multiple of the federal poverty guidelines under the Low Income Energy Assistance Program.
+values:
+  2024-10-01: 1.5
+
+metadata:
+  unit: /1
+  period: year
+  label: Kansas LIEAP federal poverty guideline rate
+  reference:
+    - title: KEESM 13360 Income Eligibility, October 2024 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13360 Income Eligibility, January 2026 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm
+    - title: Kansas LIHEAP FY2026 State Plan, Section 2.1 (eligibility threshold 150.00% of the HHS poverty guidelines)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/KS_Plan_2026.pdf#page=8
+    - title: Kansas LIHEAP FY2025 State Plan, Section 2.1 (eligibility threshold 150.00% of the HHS poverty guidelines)
+      href: https://liheapch.acf.gov/docs/2025/state-plans/KS_Plan_2025.pdf#page=8

policyengine_us/parameters/gov/states/ks/dcf/liheap/eligibility/fpg_year_lag.yaml

@@ -0,0 +1,18 @@
+description: Kansas uses federal poverty guidelines from this many years before the modeled heating season for the income limit under the Low Income Energy Assistance Program.
+# Verified for FY2025 and FY2026: their limits use the 2024 and 2025
+# guidelines, respectively. This is a relative year selection, not a fixed
+# guideline year. Earlier and later Kansas policy remains unverified.
+values:
+  2024-10-01: 1
+
+metadata:
+  unit: year
+  period: year
+  label: Kansas LIEAP federal poverty guideline year lag
+  reference:
+    - title: KEESM 13362 Income Guidelines, October 2024 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13362 Income Guidelines, January 2026 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm
+    - title: HHS poverty guidelines, 2024 and 2025
+      href: https://aspe.hhs.gov/topics/poverty-economic-mobility/poverty-guidelines/prior-hhs-poverty-guidelines-federal-register-references

policyengine_us/parameters/gov/states/ks/dcf/liheap/eligibility/max_table_size.yaml

@@ -0,0 +1,13 @@
+description: Kansas sets income limits through this household size, with an increment for each additional person, under the Low Income Energy Assistance Program.
+values:
+  2024-10-01: 8
+
+metadata:
+  unit: person
+  period: year
+  label: Kansas LIEAP maximum tabulated household size
+  reference:
+    - title: KEESM 13360-13362, October 2024 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13360-13362, January 2026 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/eligibility/rounding_increment.yaml

@@ -0,0 +1,24 @@
+description: Kansas sets monthly income limits in increments of this amount under the Low Income Energy Assistance Program.
+# Precision inferred from the published tables, not an express rounding rule:
+# FY2025 retains cents and exactly matches 150% of the 2024 guidelines.
+# FY2026 matches nearest-dollar rounding of 150% of the 2025 guidelines,
+# including a separately rounded $688 increment for each person beyond eight.
+# The July 2025 KEESM edition is the first to carry the FY2026 limits; the
+# 2025-10-01 date matches the federal program year and the FY2026 matrix.
+# Kansas LIEAP variables are annual and read the value in force on January 1,
+# so any date from 2025-01-02 through 2026-01-01 gives the same result.
+values:
+  2024-10-01: 0.01
+  2025-10-01: 1
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Kansas LIEAP monthly income limit rounding increment
+  reference:
+    - title: KEESM 13362 Income Guidelines, October 2024 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13362 Income Guidelines, July 2025 edition (first edition with the FY2026 limits of $1,956 to $6,769 and the $688 increment)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo07-25/Robo_07_01_25/keesm13360.htm
+    - title: KEESM 13362 Income Guidelines, January 2026 edition
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/income/earned_income_min_age.yaml

@@ -0,0 +1,21 @@
+description: Kansas excludes the earned income of household members below this age under the Low Income Energy Assistance Program.
+values:
+  2024-10-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: Kansas LIEAP earned income minimum age
+  reference:
+    - title: Kansas LIHEAP FY2026 State Plan, Section 1.9 (earned income of a child under the age of 18 is not counted)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/KS_Plan_2026.pdf#page=7
+    - title: Kansas LIHEAP FY2025 State Plan, Section 1.9 (earned income of a child under the age of 18 is not counted)
+      href: https://liheapch.acf.gov/docs/2025/state-plans/KS_Plan_2025.pdf#page=6
+    - title: KEESM 13361 Exempt Income, October 2024 edition (earned income of child household members under age 18 is exempt)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13361 Exempt Income, January 2026 edition (earned income of child household members under age 18 is exempt)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm
+    - title: KEESM 13320 Household Definition, October 2024 edition (a member who is or turns eighteen in the month of application has countable income)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13300.htm
+    - title: KEESM 13320 Household Definition, January 2026 edition (a member who is or turns eighteen in the month of application has countable income)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13300.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/income/interest_income_min_age.yaml

@@ -0,0 +1,13 @@
+description: Kansas excludes the interest income of household members below this age under the Low Income Energy Assistance Program.
+values:
+  2024-10-01: 18
+
+metadata:
+  unit: year
+  period: year
+  label: Kansas LIEAP minimum age for countable interest
+  reference:
+    - title: KEESM 13361 Exempt Income, October 2024 edition (interest accrued from the interest-bearing accounts of children under 18 is exempt)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13361 Exempt Income, January 2026 edition (interest accrued from the interest-bearing accounts of children under 18 is exempt)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/income/regular_interest_dividend_exemption.yaml

@@ -0,0 +1,17 @@
+description: Kansas excludes recurring interest and dividends not exceeding this monthly amount under the Low Income Energy Assistance Program.
+# Above this amount the full amount counts.
+values:
+  2024-10-01: 50
+  2025-10-01: 0
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Kansas LIEAP recurring interest and dividend exemption
+  reference:
+    - title: KEESM 13361 Exempt Income, October 2024 edition (interest and dividend income not exceeding $50 per month is exempt; if in excess the full amount is counted)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13361 Exempt Income, July 2025 edition (first edition with the FY2026 rule; only irregular, unpredictable interest and dividends under $30 in a quarter are exempt)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo07-25/Robo_07_01_25/keesm13360.htm
+    - title: KEESM 13361 Exempt Income, January 2026 edition (only irregular, unpredictable interest and dividends under $30 in a quarter are exempt)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/income/sources/earned.yaml

@@ -0,0 +1,41 @@
+description: Kansas uses these earned income sources to approximate countable household earnings under the Low Income Energy Assistance Program.
+# Existing net self-employment inputs are used without an additional expense
+# deduction. They approximate KEESM 13360's gross-receipts calculation and do
+# not reproduce its standard deduction or actual-cost election in every case.
+values:
+  2024-10-01:
+    - employment_income
+    - self_employment_income
+    - sstb_self_employment_income
+    - farm_operations_income
+    # KEESM 6300 treats profit from performing services, including managerial
+    # responsibilities, as earned income, and KEESM 6313 bars deducting a loss
+    # from other income, so pass-through business income is floored with the
+    # other business sources.
+    - partnership_s_corp_income
+
+metadata:
+  unit: list
+  period: year
+  label: Kansas LIEAP countable earned income sources
+  reference:
+    - title: KEESM 13360 Income Eligibility, October 2024 edition (countable income includes earnings by adults; self-employment income paragraph)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13360 Income Eligibility, January 2026 edition (countable income includes earnings by adults; self-employment income paragraph)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm
+    - title: KEESM 7122.1 Income Producing Cost Deduction, October 2024 edition (a loss from self-employment cannot be deducted from other income)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm7122.htm
+    - title: KEESM 7122.1 Income Producing Cost Deduction, January 2026 edition (a loss from self-employment cannot be deducted from other income)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm7122.htm
+    - title: Kansas LIHEAP FY2026 State Plan, Section 1.8-1.9, pages 5-6 (gross income; wages, self-employment income, contract income and commissions counted)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/KS_Plan_2026.pdf#page=5
+    - title: Kansas LIHEAP FY2025 State Plan, Section 1.8-1.9, pages 5-6 (gross income; wages, self-employment income, contract income and commissions counted)
+      href: https://liheapch.acf.gov/docs/2025/state-plans/KS_Plan_2025.pdf#page=5
+    - title: KEESM 13320 Household Definition, October 2024 edition (income of all household members living together is used)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13300.htm
+    - title: KEESM 13320 Household Definition, January 2026 edition (income of all household members living together is used)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13300.htm
+    - title: KEESM 6313 Self-Employment, October 2024 edition (a loss from self-employment cannot be deducted from other income)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm6313.htm
+    - title: KEESM 6313 Self-Employment, January 2026 edition (a loss from self-employment cannot be deducted from other income)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm6313.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/income/sources/unearned.yaml

@@ -0,0 +1,51 @@
+description: Kansas uses these unearned income sources to determine gross household income under the Low Income Energy Assistance Program.
+values:
+  2024-10-01:
+    - unemployment_compensation
+    - strike_benefits
+    # SSA benefits are counted gross, including the Medicare deduction.
+    - social_security
+    - ssi
+    - pension_income
+    - general_assistance
+    - ks_tanf
+    - rental_income
+    # KEESM 6313: income from rental property is unearned unless a household
+    # member actively manages it at least 20 hours a week.
+    - farm_rent_income
+    - alimony_income
+    - child_support_received
+    # Plan counts "insurance payments made directly to the insured".
+    - workers_compensation
+    # KEESM 13361 exempts only the incomes it lists; employer disability benefits are not among them.
+    - disability_benefits
+    - veterans_benefits
+    - ks_liheap_countable_interest_dividend_income
+    # KEESM 13360-13361 explicitly count interest except for specific
+    # exemptions; the plan's unchecked combined interest/dividend/royalty
+    # box is not a blanket exclusion. Other irregular receipts and source-
+    # specific exclusions require a direct countable-income input.
+    # Contract or mortgage payments, legal settlements and adoption support
+    # have no model input and also require a direct countable-income input.
+
+metadata:
+  unit: list
+  period: year
+  label: Kansas LIEAP countable unearned income sources
+  reference:
+    - title: Kansas LIHEAP FY2026 State Plan, Section 1.9 (countable income sources)
+      href: https://liheapch.acf.gov/docs/2026/state-plans/KS_Plan_2026.pdf#page=6
+    - title: Kansas LIHEAP FY2025 State Plan, Section 1.9, pages 5-6 (countable income sources)
+      href: https://liheapch.acf.gov/docs/2025/state-plans/KS_Plan_2025.pdf#page=5
+    - title: KEESM 13360-13361, October 2024 edition (countable income and specific exemptions)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13360.htm
+    - title: KEESM 13360-13361, January 2026 edition (countable income and specific exemptions)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13360.htm
+    - title: KEESM 13320 Household Definition, October 2024 edition (income of all household members living together is used)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13300.htm
+    - title: KEESM 13320 Household Definition, January 2026 edition (income of all household members living together is used)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13300.htm
+    - title: KEESM 6313 Self-Employment, October 2024 edition (rental property income is unearned unless actively managed 20 hours a week)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm6313.htm
+    - title: KEESM 6313 Self-Employment, January 2026 edition (rental property income is unearned unless actively managed 20 hours a week)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm6313.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/payment/household_size_group.yaml

@@ -0,0 +1,28 @@
+description: Kansas sets this benefit matrix size group based on the number of countable household members under the Low Income Energy Assistance Program.
+brackets:
+  # Household size 1-4.
+  - threshold:
+      2024-10-01: 0
+    amount:
+      2024-10-01: 1
+  # Household size 5 and over.
+  - threshold:
+      2024-10-01: 5
+    amount:
+      2024-10-01: 2
+
+metadata:
+  type: single_amount
+  threshold_unit: person
+  amount_unit: /1
+  period: year
+  label: Kansas LIEAP household size group
+  reference:
+    - title: Kansas LIEAP FY2026 Benefit Matrix (Household Size 1-4 and Household Size 5 and Over columns)
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/KS_BenefitMatrix_2026.pdf#page=1
+    - title: Kansas LIEAP FY2025 Benefit Matrix
+      href: https://liheapch.acf.gov/docs/2025/benefits-matricies/KS_BenefitMatrix_2025.pdf#page=1
+    - title: KEESM 13330 Citizenship and Alienage Requirements, October 2024 edition (non-citizen members excluded from household size)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13300.htm
+    - title: KEESM 13330 Citizenship and Alienage Requirements, January 2026 edition (non-citizen members excluded from household size)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13300.htm

policyengine_us/parameters/gov/states/ks/dcf/liheap/payment/income_band.yaml

@@ -0,0 +1,34 @@
+description: Kansas sets this benefit matrix income band based on one-month gross countable income under the Low Income Energy Assistance Program.
+brackets:
+  - threshold:
+      2024-10-01: 0
+    amount:
+      2024-10-01: 1
+  - threshold:
+      2024-10-01: 900
+    amount:
+      2024-10-01: 2
+  - threshold:
+      2024-10-01: 1_200
+    amount:
+      2024-10-01: 3
+  - threshold:
+      2024-10-01: 1_700
+    amount:
+      2024-10-01: 4
+
+metadata:
+  type: single_amount
+  threshold_unit: currency-USD
+  amount_unit: /1
+  period: month
+  label: Kansas LIEAP one-month income band
+  reference:
+    - title: Kansas LIEAP FY2026 Benefit Matrix (one-month income rows 0-899, 900-1,199, 1,200-1,699, 1,700 and over)
+      href: https://liheapch.acf.gov/docs/2026/benefits-matricies/KS_BenefitMatrix_2026.pdf#page=1
+    - title: Kansas LIEAP FY2025 Benefit Matrix
+      href: https://liheapch.acf.gov/docs/2025/benefits-matricies/KS_BenefitMatrix_2025.pdf#page=1
+    - title: KEESM 13230 Proof of Information Requirement, October 2024 edition (gross income of the month of application)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo10-24/Robo_10_01_24/keesm13200.htm
+    - title: KEESM 13230 Proof of Information Requirement, January 2026 edition (gross income of the month of application)
+      href: https://content.dcf.ks.gov/ees/KEESM/Robo01-26/Robo_01_01_26/keesm13200.htm