Repository navigation
Conversation
HRS 392-43 lets an employer withhold half the cost of coverage, up to 0.5% of weekly wages, and caps those wages at a maximum weekly wage base the Director publishes each year. Model the contribution at that limit from the published 2004-2026 wage bases, and add it to employee_state_payroll_tax so it reaches employee_payroll_tax and household net income. HRS 392-3 takes its wage exclusions from HRS 383-11, the same list Hawaii unemployment tax uses, so wages start from payroll_tax_gross_wages. That variable raised a TypeError before 2010 because the FICA pre-tax list started in 2010, so the list now applies to every year. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The contribution read the federal payroll wage base, which rests on federal rules Hawaii did not enact. Hawaii's text leaves out what an employer pays to medical and retirement plans, including salary reductions, and lists no dependent care payment. Build wages from those two sections, record the reading as a source-conflict candidate with short excerpts, and restore the shared FICA list's start date, which only the federal base needed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Leave military basic pay out of Hawaii wages under HRS 392-5(6), let the wages test pass on the previous year's weeks and hours, and take retirement deferrals out from 2004. Extend the federal elective deferral and catch-up limits back to 2004 from the IRS table, which also corrects 2015-2017 to $18,000. Add the program to programs.yaml, split the source-conflict regulation captures by page, and update the Hawaii marginal rate case for the contribution. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Main's #10285 rewrote the documentation of employee_state_payroll_tax. The resolution keeps its text and lists Hawaii TDI with New York's contributions, which the employer is authorized but not required to collect. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
HRS 392-43(a) permits the employer to withhold the contribution without requiring it, like New York's PFL and DBL. Following main's #10285, the employee amount is the 0.5% limit times state_payroll_premium_deduction_share, which defaults to 1. Hawaii joins the programs whose employer cost the model doesn't hold, in the documentation of employee_state_payroll_tax, employer_additional_state_payroll_tax and the share input, and in the share invariants test. Three YAML cases cover a share of 0.5, 0 and 1.5. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
DLIR's Disability Compensation Division published a $702.38 maximum weekly wage base for 2003 (notice dated December 15, 2002): the State average annual wage of $30,184.73 / 52 * 1.21 under HRS 392-43(b)(2), with a $3.51 maximum weekly deduction. - Add 702.38 for 2003 to the wage base and start the 0.5% rate and the deferral exclusions in 2003. - Extend the federal 401(k) elective deferral limit ($12,000), catch-up ($2,000) and catch-up age (50) back to 2003 from the IRS cost-of-living table, and cite 26 USC 414(v)(5)(A) for the age test. - Add 2003 to the stored notice table, add 2003 YAML cases, move the zero-boundary cases to 2002, and move hi_tdi's verified_start_year to 2003. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The previous-year route of hi_temporary_disability_insurance_qualified now also needs that year's wages, less the payments the Hawaii wage definition leaves out, to reach the $400 minimum, so a prior year of active-duty pay or self-employment no longer passes. The route reads employment_income_before_lsr, so it calculates no labor supply response for the earlier year, and before 2015 it reads only values provided for that year. Also: - describe the model's two military_basic_pay conventions in the Hawaii wage; - describe Hawaii's lesser-of limit in the deduction share input; - add federal limit cases for each year from 2004 to 2018 in which the 402(g)(1) or 414(v) amount changes and no case existed; - make the backdating-floor probe scan the parameter tree; - cite IRC 3306 in the source-conflict candidate and narrow its handbook claim; - enter previous-year pay in YAML as employment_income_before_lsr, because the YAML runner builds its simulation without Simulation's input move. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Main now models the Minnesota Paid Leave employer premium (#10294), so the conflicts keep Hawaii in the lists of states whose employer cost is not modeled and drop Minnesota from them. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # policyengine_us/tests/policy/baseline/gov/irs/income/taxable_income/adjusted_gross_income/above_the_line_deductions/retirement/k401_catch_up_limit.yaml # policyengine_us/tests/policy/baseline/household/expense/retirement/elective_deferral_limit.yaml
HRS 392-43(b)(2) sets the maximum weekly wage base from the State's average annual wage as HRS 383-61(b) determines it, and 383-61(b) rounds that average to the nearest hundred dollars. DLIR's TDI notices apply 1.21 / 52 to the average before rounding, so each published base differs from the statutory one by up to $1.15. Follow the statute: each year's base is the notice's average rounded to $100, times 1.21 / 52, rounded once to the cent (2026: 64,500 * 1.21 / 52 = 1,500.87, where DLIR publishes 1,500.21). Record the choice as source conflict us-hi:tdi-wage-base-rounded-average in source_conflicts/candidates.yaml with excerpts of both sections and the 2026 notice, and update the YAML cases, the Python property tests and the changelog to the statutory bases. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
#10677's previous-year route nets the payments excluded_payments.yaml lists for the previous year. This branch starts the deferral exclusions in 2003, so a 2004 simulation now takes a provided 2003 401(k) deferral out of 2003 wages. Two 2004 cases cover it: one fails the $400 minimum and one passes at exactly $400. Also: - pin a 2003 batch in test_contribution_properties with wages above the annual cap and just over it, so the scanned notice's year always runs capped; - say in excluded_payments.yaml that 2003 is the first year the model holds the federal limit, not the first year of the limit; - note on the 2002 wages case why the model keeps deferrals that HRS 383-11 left out. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
#10677 now stores the statutory base: the average annual wage rounded to $100 under HRS 383-61(b), times 1.21, divided by 52, rounded once to the cent. Move 2003 to the same reading: 702.73, so the capped 2003 case expects 36,541.96 of wages and a 182.71 contribution. NOTICES keeps DLIR's published 2003 figures, and us-hi:tdi-wage-base-rounded-average now runs from 2003. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
HRS 392-43(b)(2) sets the maximum weekly wage base from the average annual wage that HRS 383-61(b) rounds to $100. No DLIR TDI notice survives for 2000-2002, so those years take the rounded average from DLIR's unemployment insurance taxable wage base, which 383-61(b) set at that figure: 639.90, 660.85 and 681.79. Act 30 (1999) set the 52-week wages test from 2000, so 2000 is the floor. The federal 401(k) elective deferral limit now starts in 1999, the year the 2000 wages test looks back to, and the catch-up starts in 2002. The Hawaii deferral exclusions start in 1999 with it. A new test checks that the unemployment insurance base equals each TDI notice's average rounded to $100 in every year with both figures. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
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.
Extends Hawaii's employee temporary disability insurance (TDI) contribution back to 2000, the first year of the 52-week wages test that the model applies. Under HRS 392-43(b)(2), each year's maximum weekly wage base equals 1.21 / 52 of the State average annual wage, which the Department of Labor and Industrial Relations (DLIR) computes under HRS 383-61(b) and rounds to $100. We read the statute the same way for 2004–2026 in #10677.
For 2003, we take the average from DLIR's TDI notice. We found no notice for 2000–2002, so we take the rounded average for those years from DLIR's unemployment insurance (UI) taxable wage base, which the legislature set equal to it in HRS 383-61(b). We also extend the federal 401(k) limits back to 1999. Under HRS 383-11, the model leaves 401(k) and 403(b) deferrals out of Hawaii's TDI wages, and the deferral variables cap them at those limits.
This PR stacks on PolicyEngine/policyengine-us#10677 at head
c1e0406d83, so merge that first. PR CI runs only on PRs intomain, so this one targetsmain, and its diff shows #10677's commits until #10677 merges.axiom: TheAxiomFoundation/rulespec-us#2052 queued, now with 2000–2003 and the federal limits from 1999 (HRS 392-43, 392-3, 392-5 and 383-11 with DLIR's yearly notices and UI bases; 26 USC 402(g) and 414(v)). Missing corpus text still blocks the signed encoder.
Wage bases
We multiply each rounded average by 1.21 / 52 and round once to the cent: 27,500 × 1.21 ÷ 52 = 639.90.
The 2003 notice
DLIR's Disability Compensation Division dated the 2003 notice December 15, 2002, and the department's homepage linked it by January 22, 2003. DLIR posted the notice as a scanned page with no text layer, so we transcribed the figures below from the image.
DLIR applies HRS 392-43(b)(2) to the unrounded average, and its figures hold whether it rounds to the cent after dividing by 52 or only at the end: 580.48 × 1.21 = 702.3808, and 30,184.73 ÷ 52 × 1.21 ≈ 702.3754. The deduction equals 0.5% of the base to the nearest cent. Under the notice's footnote, an employer may withhold at most 0.5% of weekly wages, up to $3.51.
The 2003 UI base, $30,200, equals the notice's average rounded to $100 (trust fund evaluation, Appendix B). The parameter holds 30,200 × 1.21 ÷ 52 = $702.73, which exceeds the notice's base by $0.35. In #10677 we record the conflict between the statute and DLIR's notices as
us-hi:tdi-wage-base-rounded-averageinsource_conflicts/candidates.yaml, and here we extend that entry to 2000.2000–2002 from the UI base
DLIR's December 2019 trust fund evaluation lists the UI taxable wage base by year (Appendix B): $27,500 for 2000, $28,400 for 2001 and $29,300 for 2002. Under HRS 383-61(b), the UI base in those years equaled the average annual wage rounded to $100, the figure the TDI formula starts from. The section's exceptions covered 1988, 1991 and 2008–2011.
The UI base for a year and the TDI base for that year start from the same average. In every year from 2003 to 2026 apart from 2008–2011, when the legislature set the UI base separately in 383-61(c), the UI base equals the TDI notice's average rounded to $100. A new test checks that for each of those 20 years.
We found no TDI notice for 2000, 2001 or 2002. We searched:
dcd/on dlir.state.hi.us has no captures before 2003, andlabor/dcd/on hawaii.gov has none before 2005.dcd/failed for 2001 and 2002.We haven't searched newspaper legal notices on microfilm or printed payroll guides from those years, or asked DLIR for its records.
Law in 2000–2003
What this PR changes
maximum_weekly_wage_base.yaml, citing Act 30, the 2003 notice and the trust fund evaluation. The zero now marks the years before 2000.employee_rate.yamlin 2000.excluded_payments.yamlin 1999. The model checks the 2000 wages test against 1999 wages, and the deferral variables need the federal limit for that year.us-hi:tdi-wage-base-rounded-averageandus-hi:tdi-wages-salary-reductionsinsource_conflicts/candidates.yamlin 2000, lists this PR on both, and cites the evaluation for the 2000–2002 UI bases.hi_tdi'sverified_start_yearinprograms.yamlto 2000.For example, a Hawaii worker earning $50,000 now contributes $166.37 in 2000, $171.82 in 2001, $177.27 in 2002 and $182.71 in 2003, instead of zero (0.5% × 52 × each base). When the model checks the 52-week test against the previous year, it subtracts a 401(k) or 403(b) deferral entered for that year from that year's wages, now from 1999 on. In 2004, the model now nets a 2003 deferral, and results for 2005 and later stay the same.
Invariants
The invariants #10677 states now cover 2000–2003:
test_contribution_propertiesalways runs pinned 2000 and 2003 batches with wages above the annual cap and just over it.Tests
The Hawaii YAML files add the capped contribution for each year from 2000 to 2003, a deferral cut to the 2003 limit, the 2002 and 2003 catch-ups, and a 2001 case with no catch-up. Four cases take a deferral entered for the previous year out of that year's wages, for a short 2000 and a short 2004. In each year, one worker falls under the $400 minimum and one meets it. The first-year deferral case moves from 2004 to 2000, the no-contribution case moves to 1999, and the case that keeps deferrals in wages moves to 1998. Twelve federal cases check the limits for 1999, 2000, 2002 and 2003 and the catch-up from 2001 to 2003.
The two Hawaii files and the two federal files pass all 137 cases locally.
test_hi_temporary_disability_insurance.py,code_health/test_source_conflicts.py,test_payroll_contributions.py,test_state_payroll_premium_deduction_share_invariants.pyandtest_irmaa_first_modeled_year.pypass all 346 tests, andtest_programs_registry.pypasses with its 10 standing skips.The Hawaii module's 76 tests took 67 seconds in pytest locally on a loaded macOS host, with a peak of 1.7 GB of memory. The 2000–2002 work adds one pinned five-worker batch, about 1.4 seconds, and 23 cases that read parameters only. We didn't time the earlier head on the same host.
🤖 Generated with Claude Code