Add Iowa TANF Program

[llennemann]

Summary

Work in progress implementation of Iowa TANF (Family Investment Program).

Closes #7163

Status

• Documentation collected
• Parameters created
• Variables implemented
• Tests written
• CI passing

---

This is a draft PR created automatically. Implementation work is in progress.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (d08239b) to head (71eb6ba).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##              main     #7171    +/-   ##
==========================================
  Coverage   100.00%   100.00%            
==========================================
  Files            1         9     +8     
  Lines           10       132   +122     
==========================================
+ Hits            10       132   +122     

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.

[llennemann]

Dates for parameters values in Iowa TANF payment values 2017, 2018, 2019 #6645.

@hua7450 Should I add Iowa TANF to the state level aggregation level? in tanf.py
Also, for the immigration check, the Iowa State TANF plan states that "Each member of the eligible group must be a citizen or qualified alien." Does the immigration eligibility look right to you?

[PavelMakarchuk]

PR Review - Iowa Family Investment Program (FIP/TANF) Implementation

🔴 Critical Issues (Must Fix Before Merge)

None identified. The implementation correctly follows Iowa Administrative Code regulations.

---

🟡 Should Address

1. Missing Dedicated Test Files

Two variables with formulas lack dedicated unit test files:

• ia_fip_resource_eligible - Only tested indirectly via ia_fip_eligible.yaml
• ia_fip_countable_earned_income - Only tested indirectly via ia_fip_countable_income.yaml

Action: Create dedicated test files for these variables.

2. Missing Boundary Tests at Exact Thresholds

The implementation uses <= and < comparisons that need boundary testing:

Threshold	Current Tests	Missing Test
Applicant resource limit ($2,000)	Above limit only	Exactly $2,000, exactly $2,001
Recipient resource limit ($5,000)	Above limit only	Exactly $5,000, exactly $5,001
185% gross income limit	Above limit only	Exactly at threshold
Net income = standard of need	Above only	Exactly equal (should fail with <)
Countable = payment standard	Above only	Exactly equal (should fail with <)

3. Reference Format Issues

Several parameter files have inline comments in href fields:

# Current (unconventional):
href: https://hhs.iowa.gov/media/17445/download?inline#page=7 # (3)

# Should be:
- title: Iowa TANF State Plan 2025, Section (3)
  href: https://hhs.iowa.gov/media/17445/download?inline#page=7

Files affected: work_incentive_disregard.yaml, max_unit_size.yaml, payment_standard/*.yaml, resources/*.yaml

4. Missing Page Anchors on PDF References

Files: resources/applicant_limit.yaml, resources/recipient_limit.yaml

• IAC PDF links missing #page=XX anchors

5. Description Typo

File: need_standard/additional.yaml

• "families larger than than the max" → "families larger than the max"

---

🟢 Suggestions

1. Family size 11+ value verification: The large family integration test doesn't explicitly verify the calculated payment/need standard values. Add tests that verify $865 + $87 = $952/month for size 11.

2. Period consistency: ia_fip_payment_standard.py and ia_fip_standard_of_need.py use period for spm_unit_size - consider period.this_year for consistency with count variables.

3. Cliff effect test: Add an integration test showing benefit dropping to $0 at the exact payment standard threshold.

---

✅ What's Implemented Correctly

Component	Verification
Three-step income eligibility	✓ Gross (185% SoN) → Net (< SoN) → Countable (< PS)
20% earned income deduction	✓ Applied to all earned income
58% work incentive disregard	✓ Applied after 20% deduction
Applicant vs recipient distinction	✓ Different tests and resource limits
Need standard (sizes 1-10)	✓ $365-$1,724/month + $173/additional
Payment standard (sizes 1-10)	✓ $183-$865/month + $87/additional
Resource limits	✓ $2,000 applicant, $5,000 recipient
Benefit formula	✓ max(payment_standard - countable, 0)
No hard-coded values	✓ All values from parameters
Variable naming	✓ All use ia_fip_* prefix
Pattern usage	✓ Correct adds, add(), max_(), where()
Federal eligibility reuse	✓ Uses is_demographic_tanf_eligible

---

Validation Summary

Check	Result
Regulatory Accuracy	✅ Implementation matches IAC 441-41
Reference Quality	⚠️ Minor format issues (inline comments, missing anchors)
Code Patterns	⚠️ Missing 2 dedicated test files
Test Coverage	⚠️ Missing boundary tests at exact thresholds
CI Status	✅ All checks passing

---

Three-Step Income Eligibility Verified

The implementation correctly handles Iowa's unique three-step income test:

1. Gross Income Test: gross_income ≤ 185% × standard_of_need
2. Net Income Test (applicants only): (gross - 20%) < standard_of_need
3. Countable Income Test: (gross × 0.80 × 0.42) + unearned < payment_standard

Recipients skip Test 2, applicants must pass all three.

---

Test Coverage: 68 Tests Passing

File	Tests
ia_fip.yaml	11
ia_fip_countable_income.yaml	8
ia_fip_eligible.yaml	8
ia_fip_gross_income.yaml	6
ia_fip_income_eligible.yaml	11
ia_fip_payment_standard.yaml	8
ia_fip_standard_of_need.yaml	8
integration.yaml	8

---

Manual Calculation Verification

Scenario 2 (Family of 2, $800/month earned):

• Standard of need: $719/month
• Payment standard: $361/month
• Gross income limit: $719 × 1.85 = $1,330.15

Test 1: $800 ≤ $1,330.15 ✓
Test 2: $800 × 0.80 = $640 < $719 ✓
Test 3: $640 × 0.42 = $268.80 < $361 ✓
Benefit: $361 - $268.80 = $92.20 ✓

---

Next Steps

To auto-fix issues: /fix-pr 7171

Or address manually:

1. Create ia_fip_resource_eligible.yaml and ia_fip_countable_earned_income.yaml test files
2. Add boundary tests at exact resource and income thresholds
3. Move inline comments from href fields to title fields
4. Fix "than than" typo in need_standard/additional.yaml

---

🤖 Generated with Claude Code - Complete Review Plugin