Skip to content

Count missing income sources and decomposed premiums in Michigan household resources - #11183

Merged
DTrim99 merged 2 commits into
mainfrom
mi-household-resources-sources
Nov 21, 2026
Merged

DTrim99 merged 2 commits into
mainfrom
mi-household-resources-sources

Conversation

@DTrim99

@DTrim99 DTrim99 commented Nov 19, 2026

Copy link
Copy Markdown
Collaborator

Part of #10812 (state credit income audit).

What was wrong

Michigan total household resources (mi_household_resources), which the homestead property tax credit (MI-1040CR) and the home heating credit (MI-1040CR-7) both use, left out six income sources the form counts. Line 31 (health insurance premiums) read only the direct health_insurance_premiums input, so premiums in the decomposed inputs never came off. That includes survey premiums and the modeled Medicare Part B premium.

MCL 206.510(1) defines income as federal AGI "plus all income specifically excluded or exempt from the computations of the federal adjusted gross income", and lets a person deduct "the amount that person paid in premiums in the tax year for that insurance plan for the person's family".

What changes

Each new list entry in gov.states.mi.tax.income.household_resources is cited from the 2025 MI-1040 book (page 26 and page 32) and the matching MI-1040CR-7 lines (2025 CR-7 book, pages 8 and 9). The 2022 book has the same wording.

Source added MI-1040CR line (CR-7 line) Rule
taxable_retirement_distributions 18 (21) "Enter all annuity, retirement, pension and individual retirement account (IRA) benefits. This should be the taxable amount shown on your U.S. Form 1099-R"
taxable_roth_conversions 18 (21) "amounts rolled over into a Roth IRA must be included to the extent included in AGI"
military_retirement_income 18 (21), via line 26 (29) "Veterans receiving retirement benefits should enter the benefits on line 18". Part of #10890
survivor_benefits 18 (21) or 25 (28) survivor annuities are retirement benefits; line 25 counts "Death benefits paid by or on behalf of an employer". Federal gross income leaves survivor_benefits out, but MCL 206.510(1) adds excluded income
debt_relief 20 (23) and 25 (28) line 20: "forgiveness of debt to the extent included in federal AGI"; line 25: "Forgiveness of debt to the extent not included in federal AGI". Page 26: "Forgiveness of debt, even if excluded from AGI". So it counts in full
dependent_care_employer_benefits 25 (28) "Reimbursement from dependent care and/or medical care spending accounts" (also page 26). irs_employment_income drops all of W-2 box 10, both the IRC 129 exclusion and the taxable part, so the whole amount is added back once

Line 31 now reads medical_expense_health_insurance_premiums instead of health_insurance_premiums. It uses a nonzero direct input. Otherwise it uses the decomposed inputs: health_insurance_premiums_without_medicare_part_b plus the modeled Part B premium the person pays, net of Medicare Savings Program and Medicaid buy-in coverage. Pretax payroll premiums stay out, which matches page 33: "Do not include ... amounts paid by an employer with pre-tax payroll contributions".

The line-21 netting comment still holds and now covers modeled Part B premiums. MCL 206.510(1)(h) excludes "Amounts deducted from monthly social security or railroad retirement benefits for medicare premiums", and line 21 says such premiums "should be deducted". The model enters gross benefits on line 21 and the premium on line 31, so the premium comes off once either way. A Part B premium billed to the enrollee instead of withheld is medical insurance on line 31.

The self-employed health insurance overlap logic is unchanged. Its medical part takes premiums only from the direct input, which is what line 31 holds whenever that input is nonzero. I updated the comments to say so.

Who is affected

These are Michigan homestead property tax credit and home heating credit claimants. Both credits are refundable.

  • Lower credits: claimants or spouses with taxable IRA, 401(k), 403(b), SEP or Keogh distributions, taxable Roth conversions, military retired pay or SBP annuities, non-Social Security survivor benefits, forgiven debt, or employer dependent care benefits. Their household resources rise.
  • Higher credits: claimants whose premiums sit only in the decomposed premium input (the survey-populated one). Also Medicare Part B enrollees who pay their own premium, meaning no Medicare Savings Program or SSI buy-in pays it. Their household resources fall. A senior with income above the program limits now has the 2025 standard premium of $2,220 subtracted.

Tests

Moved from #10812 into mi/tax/income/mi_household_resources.yaml: all 7 Michigan cases (IRA/401(k), military retired pay, Roth conversion, forgiven debt, employer dependent care, survivor benefits, premiums without Part B). I dropped the "Main:" framing and kept the arithmetic. One change: the IRA and military cases used age: 68. A 68-year-old now has the Part B premium on line 31, so I set the age to 64 to keep each case about line 18; the expected values are unchanged. The military case notes #10890, per the review.

Added:

  • Dependent care benefits at the IRC 129 cap ($5,000, all excluded) and $1 above it ($1 taxable, back in AGI): household resources are $60,000 in both, so the taxable part isn't counted twice. These set employment_income_before_lsr, because Michigan FIP reads pre-LSR wages, and wages set through employment_income would hand the family a FIP grant.
  • A direct premium input replaces the decomposed one ($2,000, not $3,200).
  • A 70-year-old with $30,000 of Social Security pays the $2,220 Part B premium, so resources are $27,780. With $12,000 of Social Security, a Medicare Savings Program pays the premium, so resources stay $12,000.
  • mi_homestead_property_tax_credit_eligible.yaml: $60,000 of wages plus $11,500 of IRA distributions is exactly the $71,500 limit and eligible; $11,501 is above it and ineligible.

Existing test changed:

  • homestead_property_tax/integration.yaml, the case formerly named "2025 household resources above line 33 limit, ineligible". The 65-year-old Medicare enrollee now has the 2025 Part B premium on line 31. The countable income for the Medicare Savings Programs is $6,087 a month, far above the limits. Values:

    • household resources: 73,288 → 71,068 (73,288 − 2,220)
    • eligible: false → true (71,068 is within $71,500)
    • credit: 0 → 1,900

    I worked the credit out by hand in the comment. Table A gives $1,900, and the Table B phase-out leaves 10%, or $190. Worksheet 5 (rent 62,436 − 40% × 71,068 = 34,008.80) is larger, so the credit is the $1,900 maximum. Worksheet 5's line E takes "the larger of line A or line D" and goes to line 44 without a further phase-out (2025 book, page 34). I renamed the case and added the pre-alternate and alternate amounts as outputs. The $71,500 limit is still covered by the existing direct-input cases and the new IRA cases.

Not in this PR

The other Michigan rows in the audit:

  • illicit_income, which is in federal gross income but not on the list (line 20)
  • section_911_excluded_income, the foreign earned income exclusion (RAB 2015-18)
  • Rows where the statute and the form read two ways: the nontaxable part of pensions, Social Security and SSI received for dependents, pre-2019 alimony only, and state and city income tax refunds
  • Rows with no input to model: the excluded gain on the sale of a residence, Roth distributions above contributions, foster care payments, inheritances and life insurance proceeds, and scholarships

Line 31 also says premiums must be reduced by the federal premium tax credit. I didn't check how the decomposed premium input relates to the PTC.

Tested on Modal: run w1-mi-c, 262/262 passed (253 YAML files: every Michigan test, every partner test, and the other test files that set a Michigan household; plus 9 Python files: the four Michigan household resources property tests, the premium input contract, source conflicts, military retirement readers, reference URLs and parameter YAML keys).

🤖 Generated with Claude Code

@codecov

codecov Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (8999568) to head (48156dc).
⚠️ Report is 273 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main    #11183   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            1         1           
  Lines           24        51   +27     
  Branches         0         6    +6     
=========================================
+ Hits            24        51   +27     
Flag Coverage Δ
unittests 100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@DTrim99
DTrim99 requested a review from hua7450 November 20, 2026 01:14

@hua7450 hua7450 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, David. All six new sources and the line 31 change match MCL 206.508 and 206.510, the 2025 MI-1040 book and the MI-1040CR-7 book. Each counts for the claimant and spouse only, and none is counted twice: dependent care benefits restore the full box 10 amount once, and the retirement, Roth conversion, debt relief and survivor inputs are disjoint. The Part B premium nets Medicare Savings Program and Medicaid coverage with no cycle. Every consumer, from homestead eligibility and the exemption through Tables A and B, Worksheet 5 and both heating credits, uses the same definition, so no threshold changes. The integration case keeps main's inputs. One fix before I approve.

Before merge

  1. Duplicate reference entries in household_resources.yaml (lines 109-116). The PR adds a second entry for the 2025 MI-1040 book at #page=32, but the existing entry already cites page 32 ("#page 26-27,31-32"). It also gives the CR-7 book two entries, one for #page=8 and one for #page=9. Repo style is one entry per source: drop the new MI-1040 entry, adding page 33 to the existing title if line 31 should be cited, and merge the CR-7 pair into one entry titled "... #page 8-9" with href #page=8. The cited pages themselves are correct.

Optional

  • Line 18 comment. It now quotes "the taxable amount on Form 1099-R" directly above pension_income, which also counts tax-exempt pensions under 206.510(1). Behavior is unchanged from main. One line saying which reading the code follows would help, and the statute-versus-form rows the PR body defers could go into the register.
  • Premium tax credit (follow-up). Book page 33 says line 31 premiums are reduced by the premium tax credit, and the model doesn't net aca_ptc. This was already true on main, and no input in this PR is shown wrong by it.

DTrim99 and others added 2 commits November 20, 2026 16:19
Michigan total household resources, used by the homestead property tax
credit and the home heating credit, now count taxable IRA, 401(k), 403(b),
SEP and Keogh distributions, taxable Roth conversions, military retired pay
and survivor annuities, other survivor benefits, forgiven debt and employer
dependent care benefits (2025 MI-1040 book, pages 26 and 32). Line 31 now
subtracts medical_expense_health_insurance_premiums, so premiums in the
decomposed inputs and the Medicare Part B premium the enrollee pays come off.

Moves the Michigan cases from the state credit income audit (#10812) into
the household resources tests and adds edge cases.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…usehold resources

Merge the duplicate MI-1040 Book and MI-1040CR-7 Book reference entries
into one entry per source document, with page ranges in the titles.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@DTrim99
DTrim99 force-pushed the mi-household-resources-sources branch from 63e68aa to 48156dc Compare November 20, 2026 21:19
@DTrim99

DTrim99 commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator Author

Thanks, Ziming. Fixed in 48156dc, rebased on main.

Fixed (your "Before merge" item)

  1. One reference entry per source in household_resources.yaml.
    • MI-1040 book: the new entry at #page=32 is gone. The existing title now ends #page 26-27,31-33, with the link still on page 26. I added page 33 because line 31 starts at the foot of page 32 and continues on page 33. Page 33 has the rest of the premium list and "Do not include any insurance premiums deducted on lines 21 or 30", which is what keeps the Part B premiums from being counted twice.
    • MI-1040CR-7 book: the two entries are now one, titled "... lines 21, 23, 28 and 29 #page 8-9", with the link on page 8. Lines 21 and 23 start on page 8, and line 23 runs onto page 9 along with lines 28 and 29.

Skipped (optional, not in this round): the line 18 comment on which reading the code follows, and the premium tax credit netting, which can be a follow-up.

Verification:

  • Only the reference block changed. The MI household resources tests and the homestead property tax credit directory pass locally (176).
  • An independent check confirmed the cited pages against the PDFs.

@DTrim99
DTrim99 requested a review from hua7450 November 20, 2026 21:19

@hua7450 hua7450 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, David. household_resources.yaml now has one entry per source: the 2025 MI-1040 book as "#page 26-27,31-33" and the CR-7 book as "#page 8-9", each linked to its first page. Page 33 belongs there, since line 31 starts at the foot of page 32 and continues onto page 33. Nothing else changed in the PR's diff. Approving.

@DTrim99
DTrim99 merged commit 0266d6a into main Nov 21, 2026
41 checks passed
@DTrim99
DTrim99 deleted the mi-household-resources-sources branch November 21, 2026 01:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants