Repository navigation
Conversation
hi_itemized_deductions picked the reduced amount using the federal 2009 personal exemption phase-out thresholds (250,200 joint, 208,500 head of household, 125,100 separate) instead of Hawaii's 166,800 / 83,400, and returned 0 when medical, investment interest and casualty deductions made up the whole total. Replace hi_reduced_itemized_deductions with hi_itemized_deductions_reduction (worksheet lines 2-10) on Hawaii-owned parameters for the 3% and 80% rates and the excluded deductions. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ions Act 35, SLH 2026 conforms Hawaii to the Internal Revenue Code as of December 31, 2025 without making section 224 (qualified tips) or 170(p) (charitable deduction for non-itemizers) inoperative. Add hi_tip_income_deduction for 2026-2028, phased out on Hawaii AGI and denied to separate filers (224(f)), and give Hawaii non-itemizers the federal 170(p) amount on top of the standard deduction (also restores the 2020 Act 13 and 2021 Act 89 amounts). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… for charitable limits Hawaii kept the 2% miscellaneous itemized deductions for 2018-2025 (it never adopted the section 67(g) suspension); Act 35, SLH 2026 ends them from 2026. Add hi_misc_deduction gated by a Hawaii parameter. The N-11 instructions state the section 170(b) limits as a share of Hawaii AGI, and Act 35 conforms to the 0.5% floor from 2026. Move the federal charitable_deduction formula into a helper that takes the contribution base, unchanged for the federal deduction, and add hi_charitable_deduction on Hawaii AGI. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…s deduction Checks the reduction against an independent restatement of the Total Itemized Deductions Worksheet, its bounds, monotonicity, identical 2025 and 2026 results under Act 35, and the tips deduction's bounds and years. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Oct 6, 2026
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Audits PolicyEngine's Hawaii income tax for taxable years beginning after December 31, 2025 against Act 35, SLH 2026 (H.B. 2329 H.D.1 S.D.1 C.D.1, signed May 26, 2026). Act 35 moves Hawaii's Internal Revenue Code conformity date from December 31, 2024 to December 31, 2025 (HRS 235-2.3(a)), which takes in P.L. 119-21 (OBBBA) except where Hawaii decouples. It also fixes two bugs in Hawaii's overall limitation on itemized deductions (Pease) that predate Act 35 and continue under it.
Sources:
The TY2026 N-11 instructions are not published.
https://files.hawaii.gov/tax/forms/2026/n11ins.pdfand.../2026/n11.pdfreturned 404 on 2026-10-06. TY2026 behaviour here rests on the Act 35 text, the DOTAX announcement and testimony, and the 2025 worksheets.Changes
1. Overall limitation on itemized deductions (Pease): two bugs, every year
HRS 235-2.4 keeps IRC section 68 operative with "the thresholds ... operative for federal tax year 2009". Act 35 rewrites it as subsection (b): section 68 "shall be operative in the form that it existed as of December 31, 2024; provided that the thresholds shall be those that were operative for federal tax year 2009" (CD1 p. 18).
The HD1 testimony's Tax Foundation note (p. 9) asked whether to adopt the OBBBA 2/37 rule instead. The CD1 kept Pease. So for 2026 Hawaii still applies 3% of Hawaii AGI over $166,800 ($83,400 separate), capped at 80% of deductions other than medical, investment interest and casualty losses. This is the 2025 N-11 Total Itemized Deductions Worksheet, and it matches the 2009 Schedule A worksheet (line 6: "$166,800 ($83,400) if married filing separately").
Main pinned two federal parameter dates:
hi_itemized_deductionsreadparameters("2009-01-01").gov.irs.deductions.itemized.limitation.applicable_amount. Those 2009 values (JOINT and SURVIVING_SPOUSE 250,200, HEAD_OF_HOUSEHOLD 208,500, SEPARATE 125,100) are the 2009 personal exemption phase-out thresholds (2009 Form 1040 instructions, PDF p. 37), not the Pease thresholds. So joint, surviving-spouse and head-of-household filers with Hawaii AGI from $166,800 up to those amounts, and separate filers from $83,400 to $125,100, were never limited. Wrong in every year, including 2026.hi_reduced_itemized_deductionsreturned 0 whenever its own test failed. When medical, investment interest and casualty deductions made up the whole total, worksheet line 4 says "Your deduction is not limited", but PE returned $0 of itemized deductions. Wrong in every year.hi_reduced_itemized_deductionsreadparameters("2017-01-01")for the 80% and 3% rates. The values are right for section 68 as of December 31, 2024, but they borrow pinned federal values.The fix replaces
hi_reduced_itemized_deductionswithhi_itemized_deductions_reduction(worksheet lines 2-10).hi_itemized_deductionsbecomes line 11, total minus the reduction. It adds Hawaii-owned parameters undergov.states.hi.tax.income.deductions.itemized.limitation:agi_rate0.03,itemized_deduction_rate0.8, andexcluded_deductions. The existing $166,800 / $83,400threshold.reductionis now used for the gate too; its description said "federal adjusted gross income below this amount", which is corrected.hi_reduced_itemized_deductionsis removed. Nothing outside Hawaii's own tests read it.2. Qualified tips deduction (IRC 224), 2026-2028
Act 35 does not list section 224 as inoperative; it does list 225 (overtime) and 163(h)(4) (car loan interest) (CD1 pp. 7, 21). DOTAX: Hawaii conforms to "IRC section 224, which creates a deduction of up to $25,000 for qualified tips" (Ann. 2026-06 p. 3). Section 63(b) and (d) make it available whether or not the taxpayer itemizes, and section 224(h) ends it after 2028. For TY2025 Hawaii's code is the IRC as of December 31, 2024, so there is no tips deduction.
New
hi_tip_income_deduction, gated bygov.states.hi.tax.income.deductions.tip_income.in_effect(2025 false, 2026 true, 2029 false). It is added inhi_deductionson top of whichever of the itemized or standard deduction applies. It reuses the federal qualified-tips pieces:tip_income × tip_income_deduction_occupation_requirement_met, the $25,000 cap, and the federal phase-out parameters and SSN requirement. It also applies 224(f) (no deduction for married filing separately), which the federal variable does not apply (chip filed).3. Charitable deduction for non-itemizers (IRC 170(p))
Ann. 2026-06 p. 2: Hawaii conforms to "IRC section 170, which reinstates the charitable deduction for individuals who do not itemize". Hawaii also adopted the 2020 version (Act 13, SLH 2020; 2020 N-11 p. 2) and the 2021 version (Act 89, SLH 2021; 2021 N-11 p. 20).
hi_deductionsnow compares itemized deductions with the standard deduction pluscharitable_deduction_for_non_itemizers, gated bygov.states.hi.tax.income.deductions.non_itemizer_charitable.in_effect. The federal amount is $1,000/$2,000 from 2026, $300 ($600 joint in 2021), and zero for 2022-2025.4. Miscellaneous itemized deductions (IRC 67): allowed through 2025, gone from 2026
Before Act 35, HRS 235-2.4(b) made section 67 operative "except that the suspension in section 67(g) shall not be operative". The 2025 N-11 (p. 19, Worksheet A-6 lines 23-29) allows unreimbursed employee expenses, tax preparation fees and similar costs above 2% of Hawaii AGI. Act 35 strikes that exception (CD1 p. 17; Ann. 2026-06 p. 2: Hawaii "will conform to IRC section 67(h), which disallows miscellaneous itemized deductions"). PE never modeled the Hawaii deduction, so 2026 was right only because the deduction was missing, and 2021-2025 was wrong. New
hi_misc_deductionuses the federal misc sources (unreimbursed_business_employee_expenses,tax_preparation_fees) less 2% of Hawaii AGI, gated bygov.states.hi.tax.income.deductions.itemized.misc.in_effect(true from 2021, false from 2026). It is subject to the Pease limitation.5. Charitable deduction limits and the 2026 floor on Hawaii AGI
The N-11 instructions state the section 170(b) limits as shares of Hawaii AGI: "more than 30% of your Hawaii adjusted gross income", and "Hawaii adopted the federal provisions that increases the Hawaii adjusted gross income limitation on cash contributions from 50% to 60%" (2025 N-11 pp. 17-18). Act 35 conforms Hawaii to the section 170(b)(1)(I) 0.5% floor from 2026 (Ann. 2026-06 p. 2: section 170 "imposes a charitable deduction floor"). Hawaii's itemized deductions used the federal
charitable_deduction, which measures both against federal AGI. That matters for retirees, because Hawaii excludes pensions and Social Security.The federal formula moves unchanged into
_charitable_deduction_helpers.charitable_deduction_given_contribution_base.charitable_deductioncalls it withpositive_agi, as before; the federalcharitable_deduction.yaml(15 cases) andcharitable_deduction_for_non_itemizers.yaml(9) pass. Newhi_charitable_deductioncalls it with Hawaii AGI floored at zero and replacescharitable_deductionin Hawaii's itemized sources.Act 35 items checked and left unchanged
...itemized.casualty_loss.non_disaster_losses_allowed. Not duplicated here, and there is no file overlap.hi_taxable_income.yamlCase 5).hi_dependent_care_benefitsreads the federal 129 cap, which is right for 2025 ($5,000) and 2026 ($7,500). A separate-filer bug that predates Act 35 is chipped.TY2025 conformity date. Hawaii's TY2025 code is the IRC as of December 31, 2024, so OBBBA must not reach Hawaii in 2025. No Hawaii variable took an OBBBA change in TY2025. Federal AGI has no OBBBA-driven change in 2025: the
gov.irs.aldlist is unchanged, and tips, overtime, senior and car loan interest are below the line. The charitable floor and the non-itemizer amounts start in 2026, and the new tips gate is false for 2025. A traced check confirms it. Hawaii's 2025 tax was traced for a household that touches every income and deduction input above: 601 variables and 56gov.irsparameters. The only traced federal values that change from 2024 to 2025 are inflation amounts under pre-OBBBA law (excess business loss limit, student loan interest phase-out, 401(k) limits, Social Security wage base, the 151 exemption amount). Write-up and scripts:~/reviews/us-hub/hi-act35/ty2025_check.md.Methodology choices (for the reviewer)
hi_agi; Indiana's conformity variable instead reuses the federal amount. This matters only above $150,000 ($300,000 joint) and when Hawaii AGI differs from federal AGI. The TY2026 N-11 may settle it.Invariants (property tests:
tests/core/test_hi_itemized_deduction_limitation_properties.py)For every input:
hi_itemized_deductions_reductionequals an independent restatement of worksheet lines 1-10 ($166,800 / $83,400, 3%, 80%, section 68(c) exclusions), andhi_itemized_deductionsequals line 11.hi_tip_income_deduction≤ min($25,000, qualified tips). The deduction never rises with Hawaii AGI, is 0 for separate filers, and is 0 in 2025 and 2029.Invariant 1 is a differential test against a hand restatement. The charitable helper is now a single implementation, so the federal and Hawaii deductions cannot drift apart.
Hypothesis, 5 derandomized batches of 20-60 tax units, each one vectorized simulation per year, plus seeded grids. CI cost: the file goes in the Rest "core" group. Measured locally on macOS at load average ~70, so this is not a Linux CI figure: 2.0 s of test time, 18 s for the pytest process including import, and 1.12 GB peak RSS for the file alone.
Tests
Every new or changed YAML file fails on main (verified against upstream/main
9eab717e56in a separate worktree; output in~/reviews/us-hub/hi-act35/fails_on_main_all.txt):hi_itemized_deductions.yamlhi_itemized_deductions_reduction.yaml(renamed fromhi_reduced_itemized_deductions.yaml)hi_deductions.yamlhi_tip_income_deduction.yaml,hi_charitable_deduction.yaml,hi_misc_deduction.yamlhi_total_itemized_deductions2025 with misc: 0 vs 4,500.hi_taxable_income.yamlLocked run (
~/reviews/us-hub/scripts/heavy_run.sh, ata4e95d6e38; log~/reviews/us-hub/hi-act35/locked_run_1.log): the Hawaii test folder viatest_batched.py --mode per-subdir --workers 1, 518 passed in 3 batches; the 47 non-Hawaii YAML files that mention charitable deductions (list incharity_tests.txt), 8 per process, 287 passed;tests/core/test_itemized_deduction_limitation_properties.py, 8 passed. The newtest_hi_itemized_deduction_limitation_properties.pypassed 3 of 3 separately.Impact on example households (main → this branch)
Script:
~/reviews/us-hub/hi-act35/examples.py. No microsimulation was run for this PR.Not in this PR (follow-up chips filed)
applicable_amountvalues.axiom: us-hi/statutes/235-2/4 TheAxiomFoundation/rulespec-us#1521 queued (casualty, HRS 235-2.4(l), renumbered (k) by Act 35); the Pease (235-2.4(b)), 67, 224, 170(p) and 170(b) contribution-base extension for #1521 is drafted at
~/reviews/us-hub/hi-act35/axiom-1521-extension.md, and posting it publicly awaits Max's go (decision d1039).🤖 Generated with Claude Code