Skip to content

Extend Hawaii's TDI contribution back to 2000 - #10771

Draft
MaxGhenis wants to merge 14 commits into
mainfrom
hi-tdi-2003-wage-base
Draft

MaxGhenis wants to merge 14 commits into
mainfrom
hi-tdi-2003-wage-base

Conversation

@MaxGhenis

@MaxGhenis MaxGhenis commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

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 into main, so this one targets main, 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

Year Rounded average Source of the average Statutory base DLIR's published base
2000 27,500 UI base 639.90 none found
2001 28,400 UI base 660.85 none found
2002 29,300 UI base 681.79 none found
2003 30,200 TDI notice (30,184.73) 702.73 702.38

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.

Item TDI column
State average annual wage 30,184.73
Divided by 52 580.48
Multiplied by 1.21: maximum weekly wage base 702.38
Multiplied by 0.5%: maximum weekly deduction 3.51

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-average in source_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:

  • DLIR's homepage in the Internet Archive: every capture from March 2000 to November 2002. None links a notice.
  • Archived files on dlir.state.hi.us named for wages (1999–2005) or for the Disability Compensation Division, TDI, benefits, maximums or disability (1998–2004).
  • The division's archived folders: dcd/ on dlir.state.hi.us has no captures before 2003, and labor/dcd/ on hawaii.gov has none before 2005.
  • The department's older folders, www.state.hi.us/dlir/ (leaving out research and statistics) and hawaii.gov/dlir/, which hold only research, occupational safety and community services pages. Our queries on hawaii.gov/labor/ outside dcd/ failed for 2001 and 2002.
  • Form DC-1, which DLIR kept at the site root before 2003, in its four captures from August 2000 to October 2002. It says the division sets the maximum each year and gives no figure.
  • DLIR's annual reports for FY1999, 2002 and 2003.
  • The TDI chapter of the U.S. Department of Labor's Comparison of State Unemployment Insurance Laws for 2001, 2003 and 2004, which prints no Hawaii wage base.
  • SSA's Annual Statistical Supplement (table 9.C1), and Hawaii's workers' compensation data book and UI annual report.
  • Thirteen web searches, including ones limited to Hawaii newspaper sites and to the sites of the legislature, the Legislative Reference Bureau and the University of Hawaii's repositories.

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

  • HRS 392-43: in Act 30 (1999), the legislature set the 52-week wages test in (b)(1) for disabilities after December 31, 1999. It left (a)'s 0.5% limit and (b)(2)'s 1.21 factor and preceding-year average unchanged, and next amended the section in 2013. Before 2000 the model would need the old wages test, so we start in 2000.
  • HRS 383-61(b): the text in Act 7 (1991) matches today's, a UI base equal to the average rounded to $100. The legislature next amended the section in Act 110 (2007), changing only (c), for 2008 and 2009.
  • The legislature didn't amend HRS 392-3, 392-25 or 383-11 between 2000 and 2006. In Act 212 (2003), section 6, it amended HRS 392-5 from July 1, 2003, renaming the commission-only insurance agents and solicitors that paragraph (15) excludes "insurance producers". The model can't identify those workers in any year, and the act left paragraph (6), on federal service, unchanged.
  • Federal: the IRS cost-of-living table lists the 402(g)(1) limit as $10,000 for 1999, $10,500 for 2000 and 2001, $11,000 for 2002 and $12,000 for 2003 (pages 6 and 7). Catch-up contributions began in 2002, at $1,000 and then $2,000 in 2003, from age 50 under 26 USC 414(v)(5)(A). The regulation's rules apply from 2004 (26 CFR 1.414(v)-1(i)(1)).

What this PR changes

  • Adds 639.90, 660.85, 681.79 and 702.73 for 2000–2003 to maximum_weekly_wage_base.yaml, citing Act 30, the 2003 notice and the trust fund evaluation. The zero now marks the years before 2000.
  • Starts the 0.5% rate in employee_rate.yaml in 2000.
  • Starts the 401(k) and 403(b) deferral exclusions in excluded_payments.yaml in 1999. The model checks the 2000 wages test against 1999 wages, and the deferral variables need the federal limit for that year.
  • Starts the 401(k) elective deferral limit in 1999 and the catch-up in 2002. We set the catch-up age to infinity before 2002, so no one qualifies. The IRA deductions read the same age, and IRA catch-up contributions also began in 2002.
  • Starts us-hi:tdi-wage-base-rounded-average and us-hi:tdi-wages-salary-reductions in source_conflicts/candidates.yaml in 2000, lists this PR on both, and cites the evaluation for the 2000–2002 UI bases.
  • Moves hi_tdi's verified_start_year in programs.yaml to 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:

  • The parameter follows HRS 392-43(b)(2) from the rounded average: the notice's average from 2003, the UI base for 2000–2002.
  • Where a year has both, the UI base equals the notice's average rounded to $100.
  • Each notice follows the formula from the average before rounding, its deduction equals 0.5% of its base, and its base differs from the statutory one by at most $1.18.
  • The Hypothesis tests (bounds, monotonicity in wages, state masking, tax unit totals, previous-year history and the weekly statute) sample every year from 2000.
  • test_contribution_properties always 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.py and test_irmaa_first_modeled_year.py pass all 346 tests, and test_programs_registry.py passes 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

MaxGhenis and others added 7 commits November 6, 2026 06:30
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>
MaxGhenis and others added 7 commits November 10, 2026 23:56
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>
@MaxGhenis MaxGhenis changed the title Add Hawaii's 2003 TDI maximum weekly wage base Extend Hawaii's TDI contribution back to 2000 Nov 11, 2026

This branch has not been deployed

No deployments
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.

1 participant