Add Oklahoma TANF program

[hua7450]

Summary

Implements Oklahoma Temporary Assistance for Needy Families (TANF) program.

Closes #6927

---

Oklahoma TANF Income Rules

Regulatory Authority

• OAC 340:10-3 (Subchapter 3 - Financial Eligibility)
• OKDHS Appendix C-1, Schedule IX (Payment Standards)

---

1. INCOME ELIGIBILITY TESTS

Gross Income Test

• Limit: 185% of the State Standard of Need
• Definition: "Monthly gross income" = total earned + unearned income of all members whose income is considered, prior to exemptions
• Child support: Must be included in gross income determination
• Consequence: When gross income ≥ limit, application is denied or case is closed

Source: OAC 340:10-3-27 - Monthly Maximum Gross Income

Net Income Test

After passing the gross income test, countable income (after disregards/exemptions) must be below the Payment Standard

---

2. INCOME DEDUCTIONS & EXEMPTIONS

A. Work-Related Expense Deduction

Employment Status	Deduction
30+ hours/week	$240
<30 hours/week	$120

Source: OAC 340:10-3-33 - Work-Related Expense Deductions

B. Earned Income Disregard

After subtracting work expense: 50% of remaining earned income is disregarded.

Eligibility cap: Combined monthly earned income must not exceed $2,064 to qualify for the EID.

Source: OAC 340:10-3-31.1 - Earned Income Disregard

C. Dependent Care Expense Deduction

Dependent Age	Maximum Deduction
Under age 2	$200/month
Age 2+ or incapacitated adults	$175/month

Source: OAC 340:10-3-33 - Work-Related Expense Deductions

---

3. INCOME STANDARDS BY FAMILY SIZE

Family Size	State Standard of Need	Max Gross Income (185%)	Payment Standard
1	$398	$736	$180
2	$499	$923	$225
3	$645	$1,193	$292
4	$798	$1,476	$361
5	$933	$1,726	$422
6	$1,068	$1,975	$483
7	$1,203	$2,225	$544
8	$1,323	$2,447	$598
9+	$1,436	$2,656	$650

Source: OKDHS Appendix C-1, Schedule IX - Payment Standards

---

4. BENEFIT CALCULATION

Formula:

Benefit = Payment Standard − Countable Income

Where Countable Income =

Gross Unearned Income + (Gross Earned Income − Work Expense − 50% of Remainder)

Calculation Steps:

1. Determine gross earned income
2. Subtract work expense deduction ($120 or $240)
3. Subtract 50% of remaining earned income
4. Add gross unearned income = Countable Income
5. Subtract countable income from Payment Standard = Benefit

Minimum/Maximum Benefit

• Minimum: $10 (benefits <$10 are not issued)
• Maximum: 9-person payment standard ($650)

Source: OAC 340:10-3-59 - Assistance Benefits

---

🤖 Generated with Claude Code

[codecov]

Codecov Report

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

Additional details and impacted files

@@             Coverage Diff             @@
##             main     #6928      +/-   ##
===========================================
+ Coverage   98.21%   100.00%   +1.78%     
===========================================
  Files           7        11       +4     
  Lines         112       155      +43     
  Branches        1         0       -1     
===========================================
+ Hits          110       155      +45     
+ Misses          1         0       -1     
+ Partials        1         0       -1     

Flag	Coverage Δ
unittests	100.00% <100.00%> (+1.78%)	⬆️

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.

[PavelMakarchuk]

📋 PR Review - Oklahoma TANF Implementation

✅ CI Status

Check	Status
Check version	✅ Pass
Full Suite - Non-Structural YAML (Other)	✅ Pass
Full Suite - Non-Structural YAML (States)	✅ Pass
Full Suite - Structural YAML & Python	✅ Pass
Full Suite - Structural YAML (Heavy)	✅ Pass
Lint	✅ Pass
Quick Feedback	✅ Pass
Codecov	✅ Pass
Check uv.lock freshness	❌ Fail

---

🟢 Approval Recommended

This is a well-structured, comprehensive implementation of Oklahoma TANF that correctly follows state regulations. After thorough validation against OAC 340 regulations, the implementation is accurate.

---

✅ Validation Summary

Check	Result	Notes
Implementation Patterns	✅ Good	All values from parameters, proper vectorization
Reference Quality	✅ Good	All parameters cite OAC regulations with title+href
Parameter Values	✅ Verified	Values match OKDHS Schedule IX
Test Coverage	✅ Excellent	9 test files with unit and integration tests
Naming Conventions	✅ Good	All variables use ok_tanf_ prefix
Legal Compliance	✅ Verified	Cross-checked against OAC 340:10-3 regulations

---

📜 Legal Verification

Verified against authoritative sources:

Rule	Source	Implementation
Gross income limit = 185% of Need Standard	OAC 340:10-3-27	✅ Correct
Work expense: $120 (<30 hrs), $240 (30+ hrs)	OAC 340:10-3-33	✅ Correct
50% earned income disregard	OAC 340:10-3-31.1	✅ Correct
EID cap of $2,064	OAC 340:10-3-31.1	✅ Correct
Dependent care: $200 (<2 yrs), $175 (2+ yrs)	OAC 340:10-3-33(b)	✅ Correct
Minimum benefit: $10	OAC 340:10-3-59	✅ Correct
Resource limit: $1,000	OAC 340:10-3-5	✅ Correct

---

🔴 Critical Issue (Must Fix)

1. CI Failure - uv.lock freshness check

The uv.lock file needs to be regenerated:

uv lock
git add uv.lock
git commit -m "Update uv.lock"
git push

---

🟡 Suggestions (Optional Improvements)

1. Consider documenting unimplemented features

The code notes that the "Children Only" payment schedule is not implemented. Consider adding a TODO or tracking issue for this:

# TODO: Implement Children Only schedule (Schedule IX-B) for cases 
# where no adult is in the assistance unit. See OKDHS Appendix C-1.

2. 100% EID for first 3 months not implemented

The code correctly notes this limitation in ok_tanf_countable_earned_income.py:

NOTE: OAC 340:10-3-31.1 also provides a 3-month EID period where 100% of earned income is excluded. This applies once per rolling 12-month period when a recipient obtains employment. This 100% disregard is not currently implemented.

This is acceptable for initial implementation. Consider adding a GitHub issue to track this enhancement.

---

📊 Implementation Quality

Good Patterns Used:

• ✅ All numeric values from parameters (no hard-coding)
• ✅ Proper p = parameters(period).gov.states.ok.dhs.tanf pattern
• ✅ Correct use of where, max_, min_ for vectorization
• ✅ defined_for = StateCode.OK on all variables
• ✅ Proper entity usage (SPMUnit for household-level, Person for individual)
• ✅ Clear regulatory references in variable docstrings

Test Coverage:

• ✅ Unit tests for each variable
• ✅ Integration tests with realistic family scenarios
• ✅ Edge cases tested (minimum benefit, EID cap, etc.)
• ✅ Comments explaining calculations step-by-step

---

✅ Files Reviewed

Category	Files	Status
Variables	11	✅ Good
Parameters	10	✅ Good
Tests	9	✅ Good

---

🚀 Next Steps

1. Required: Run uv lock to fix CI failure
2. Optional: Create issues for unimplemented features (Children Only schedule, 100% EID period)

---

Verdict: APPROVE after fixing the uv.lock CI failure.

---

🤖 Automated review by Claude

[PavelMakarchuk]

@hua7450 I actually think the first 3 months disregard is relevant, wyt?

[hua7450]

@hua7450 I actually think the first 3 months disregard is relevant, wyt?

It adds a layer of complexity, have to make a yearly variable while all other variables are monthly. And it give confusing test result for a family is only eligible for the first 3 months, then become ineligible.

[PavelMakarchuk]

@hua7450 I actually think the first 3 months disregard is relevant, wyt?

It adds a layer of complexity, have to make a yearly variable while all other variables are monthly. And it give confusing test result for a family is only eligible for the first 3 months, then become ineligible.

can you file an issue? And then update uv.lock and merge?