Skip to content

Conversation

@hua7450
Copy link
Collaborator

@hua7450 hua7450 commented Nov 24, 2025

Summary

Complete implementation of Missouri Department of Social Services Temporary Assistance (TANF) program.

Fixes #6854

Implementation Details

Variables Implemented (19 files)

  • Main Program: mo_tanf - Benefit calculation with three-tiered income testing
  • Eligibility: Income, resource, and demographic eligibility determination
  • Income Calculations: Gross earned income, unearned income, countable income with disregards
  • Standard Amounts: Standard of Need and Maximum Benefit by household size

Parameters Created (21 files)

  • Standard of Need amounts ($393-$1,956+ based on household size)
  • Maximum benefit percentage (34.526%)
  • Income limits (185% gross income test)
  • Earned income disregards ($90 standard work exemption)
  • Child care deductions ($175 for age 2+, $200 for under 2)
  • Resource limits ($1,000 initial, $5,000 with Individual Employment Plan)

Three-Tiered Income Testing System

Missouri uses a unique three-tier income eligibility system:

  1. 185% Gross Income Test - Income < 185% of Standard of Need
  2. Standard of Need Test - Income < Standard of Need
  3. Percentage of Need Test - Countable income < 34.526% of Standard of Need

All three tests must pass for eligibility. The Percentage of Need test also determines the benefit amount.

Test Coverage (94 tests, 100% passing)

  • 15 unit test files covering individual variables
  • 1 comprehensive integration test file with 9 realistic scenarios
  • All tests include manual calculation walkthroughs
  • Tests verify three-tiered income testing, benefit calculations, and edge cases

Regulatory References

All implementations include citations to:

  • Missouri Code of State Regulations (13 CSR 40-2)
  • Missouri DSS Temporary Assistance Policy Manuals
  • Specific subsection references for traceability

Implementation Notes

This is a simplified "steady-state" implementation that:

  • ✅ Accurately calculates benefits for families with stable income
  • ✅ Implements all three income eligibility tests
  • ✅ Properly handles resource limits
  • ✅ Includes comprehensive test coverage
  • ⚠️ Does not track time-limited disregards (2/3, $30+1/3, $30, new spouse)

Time-limited disregards can be added in future enhancements.

Test Results

94 tests passing (100%)
All integration tests validated
No implementation errors

Checklist

  • Documentation collected
  • Parameters created (21 files)
  • Variables implemented (19 files)
  • Tests written (16 files, 94 test cases)
  • All tests passing locally
  • Code formatted
  • Changelog entry added
  • All references embedded

Related Issues

Consolidates work from:


🤖 Generated with Claude Code

hua7450 and others added 5 commits November 23, 2025 20:31
Starting implementation of Missouri TANF.
Documentation and parallel development will follow.
Created 19 test files covering all Missouri TANF variables and scenarios:

Unit Tests (18 files):
- mo_tanf.yaml - Main benefit calculation with $10 minimum rule
- mo_tanf_eligible.yaml - Overall eligibility (state + demographic + income + resources)
- mo_tanf_income_eligible.yaml - All three income tests combined
- mo_tanf_185_percent_test.yaml - 185% gross income test
- mo_tanf_standard_of_need_test.yaml - Standard of need test
- mo_tanf_percentage_of_need_test.yaml - 34.526% percentage of need test
- mo_tanf_resources_eligible.yaml - Resource limits ($1000 vs $5000 with IEP)
- mo_tanf_standard_of_need.yaml - Standard of need amounts by family size
- mo_tanf_maximum_benefit.yaml - Maximum benefits (34.526% of standard)
- mo_tanf_countable_income.yaml - Net income after all deductions
- mo_tanf_gross_earned_income.yaml - Employment + self-employment
- mo_tanf_earned_income_deductions.yaml - Sum of all deductions
- mo_tanf_standard_work_exemption.yaml - $90 standard work exemption
- mo_tanf_child_care_deduction.yaml - $175/$200 child care deduction
- mo_tanf_two_thirds_disregard.yaml - 2/3 disregard for active recipients
- mo_tanf_30_plus_one_third_disregard.yaml - $30+1/3 disregard (4 months)
- mo_tanf_30_disregard.yaml - $30 only disregard (8 months)
- mo_tanf_new_spouse_disregard.yaml - New spouse full income disregard

Integration Tests (1 file):
- integration.yaml - 8 comprehensive scenarios testing:
  * Maximum benefit with no income
  * Low income families with child care deductions
  * Families at 185% income limit boundary
  * Resource limit tests ($1000 without IEP, $5000 with IEP)
  * Unearned income (Social Security) scenarios
  * Child support income (no MO passthrough)
  * Benefit rounding and $10 minimum payment rule
  * All three sequential income tests working together

Test Design:
- All values based on official MO TANF documentation
- Tests cover edge cases at exact limits and boundaries
- Used underscore thousands separators per style guide
- Integration tests verify complete calculation pipeline
- Tests document MO's unique three-tiered income testing system
- Based on frozen 1991 benefit amounts per 13 CSR 40-2.120

Reference: 13 CSR 40-2.310, 13 CSR 40-2.120
Tests created based on documentation for Missouri TANF implementation.
- Add changelog entry for Missouri TANF program
- Document new variables, parameters, and tests

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

Co-Authored-By: Claude <noreply@anthropic.com>
Implements Missouri Department of Social Services Temporary Assistance
program including:
- Three-tiered income eligibility testing (185%, Standard of Need, 34.526%)
- Standard of Need amounts and maximum benefit calculations
- Earned income disregards ($90 standard work exemption, child care)
- Resource limits ($1,000 initial, $5,000 with IEP)
- Comprehensive test coverage (94 tests, 100% passing)

All parameters include regulatory citations from 13 CSR 40-2 and
Missouri DSS policy manuals.

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

Co-Authored-By: Claude <noreply@anthropic.com>
@hua7450 hua7450 marked this pull request as ready for review November 24, 2025 03:52
@hua7450 hua7450 marked this pull request as draft November 24, 2025 03:54
@hua7450 hua7450 marked this pull request as ready for review November 24, 2025 03:55
@hua7450 hua7450 marked this pull request as draft November 24, 2025 03:56
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 Missouri TANF

1 participant