Skip to content

Conversation

@hua7450
Copy link
Collaborator

@hua7450 hua7450 commented Dec 28, 2025

Summary

Implements Hawaii's Temporary Assistance for Needy Families (TANF) program.

Closes #7047

Regulatory Authority

Income Eligibility Tests

Gross Income Test

  • Threshold: 185% of Standard of Need (SON)
  • SON = 100% of 2006 Hawaii Federal Poverty Level (frozen since July 2007)
Household Size SON (Monthly) Gross Limit (185%)
1 $939 $1,737
2 $1,265 $2,340
3 $1,590 $2,941
4 $1,916 $3,544
5 $2,242 $4,147

Source: Hawaii TANF State Plan Section 10.1 (page 19)

Income Deductions & Exemptions

Applied to earned income only, in this order:

  1. 20% Standard Deduction
  2. $200 Flat Rate Deduction
  3. 55% Earned Income Disregard (months 1-24)

Source: Hawaii TANF State Plan Section 10.2.1 (page 19)

Dependent Care Deduction

  • Full-time (32+ hrs/week): $175 per child
  • Part-time (<32 hrs/week): $165 per child

Source: Hawaii TANF State Plan Section 10.2.2 (page 20)

Income Standards

Standard of Assistance (SOA) = 48% of Standard of Need

Household Size SON SOA (48%)
1 $939 $450.72
2 $1,265 $607.20
3 $1,590 $763.20
4 $1,916 $919.68
5 $2,242 $1,076.16

Source: Hawaii TANF State Plan Section 11.1 (page 22)

Benefit Calculation

Benefit = Standard of Assistance - Countable Income
  • Benefit floored at $0
  • NOTE: SOA is reduced by 20% after the family receives their initial two full months of benefits for mandatory work-required households. This reduction cannot be modeled as PolicyEngine cannot track cumulative months of benefit receipt.

Source: Hawaii TANF State Plan Section 11.1 (page 22)

Implementation Notes

  • Simplified approach: Uses federal baseline for demographic eligibility and gross income sources
  • Asset test: Disregarded since April 2013
  • Non-simulatable rules: 60-month lifetime limit, EIDR tier based on months (55% for months 1-24, 36% after), 20% SOA reduction after 2 months

Test Coverage

  • 73 tests covering eligibility, income calculations, and benefit amounts
  • Integration tests validate complete benefit calculation pipeline

Example Calculation

Family of 2 with $1,500 monthly earned income:

Step Calculation Amount
Gross Earned Income $1,500
20% Standard Deduction $1,500 × 0.20 -$300
After Standard $1,200
Flat Rate Deduction -$200
After Flat $1,000
55% EIDR $1,000 × 0.55 -$550
Countable Earned $450
SOA (size 2) $607.20
Benefit $607.20 - $450 $157.20

🤖 Generated with Claude Code

hua7450 and others added 2 commits December 28, 2025 14:38
Starting implementation of Hawaii TANF program.
Documentation and parallel development will follow.

Closes PolicyEngine#7047
Implements Hawaii's Temporary Assistance for Needy Families (TANF)
program including:

- Income eligibility (185% of Standard of Need based on 2006 FPL)
- Earned income deductions (20% standard, $200 flat, 55% EIDR)
- Benefit calculation (Standard of Assistance - countable income)
- Integration tests validating complete benefit calculation pipeline

Closes PolicyEngine#7047

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@codecov
Copy link

codecov bot commented Dec 28, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (fd6b2c5) to head (50f4942).
⚠️ Report is 68 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main     #7048   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           11         9    -2     
  Lines          146       127   -19     
=========================================
- Hits           146       127   -19     
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 Sentry.
📢 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.

@hua7450 hua7450 marked this pull request as ready for review December 29, 2025 18:08
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.

Implement Hawaii TANF

1 participant