Add Hawaii Optional State Supplementation (OSS)

[mattunrath]

Summary

Implements Hawaii Optional State Supplementation (OSS) — a federally-administered state supplement for SSI recipients residing in qualifying care facilities.

Hawaii provides monthly state supplement payments that vary by living arrangement type and marital status.

Regulatory Authority

• SSA POMS SI SF01415.200 — Hawaii Optional State Supplementation overview
• SSA POMS SI SF01415.210 — Hawaii OSS current living arrangements
• SSA POMS SI 01415.057 — January 2025 payment levels
• SSA POMS SI 01415.055 — January 2023 payment levels

Benefit Details (January 2025)

Individual Payment Amounts (State Supplement Only)

Living Arrangement	OS Code	Monthly Amount	Annual Amount
Community Care Foster Family Home	B	$784	$9,408
Domiciliary Care I (≤5 residents)	H	$784	$9,408
Domiciliary Care II (6+ residents)	I	$892	$10,704
Medicaid Institution	D	$45	$540

Couple Payment Amounts (State Supplement Only, per person)

Living Arrangement	OS Code	Monthly (couple total)	Per Person/Month	Per Person/Year
Community Care Foster Family Home	B	$1,905	$952.50	$11,430
Domiciliary Care I (≤5 residents)	H	$1,905	$952.50	$11,430
Domiciliary Care II (6+ residents)	I	$2,121	$1,060.50	$12,726
Medicaid Institution	D	$90	$45.00	$540

Eligibility Criteria

• Receiving SSI benefits
• Residing in a qualifying Hawaii care facility (OS codes B, D, H, or I)
• Federally administered — no separate state application required

Files Added

• parameters/gov/states/hi/dhs/oss/payment/individual/amount.yaml
• parameters/gov/states/hi/dhs/oss/payment/couple/amount.yaml
• variables/gov/states/hi/dhs/oss/hi_oss.py
• variables/gov/states/hi/dhs/oss/hi_oss_eligible.py
• variables/gov/states/hi/dhs/oss/hi_oss_living_arrangement.py
• variables/gov/states/hi/dhs/oss/hi_oss_payment_amount.py
• tests/policy/baseline/gov/states/hi/dhs/oss/hi_oss.yaml (10 tests)

Test Coverage

• Individual in community care ($9,408/yr)
• Individual in domiciliary care I ($9,408/yr)
• Individual in domiciliary care II ($10,704/yr)
• Individual in Medicaid institution ($540/yr)
• Not in qualifying facility → $0
• No SSI → $0
• Non-Hawaii resident → $0
• Married couple in community care (couple rate)
• Married couple in Medicaid institution (couple rate)
• 2023 rate verification ($651.90/mo → $7,822.80/yr)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (63a7861) to head (3494b52).
⚠️ Report is 6 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #7735   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            5         4    -1     
  Lines           69        58   -11     
  Branches         2         0    -2     
=========================================
- Hits            69        58   -11     

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.